Samet Digital : Oracle Common [Component]

 ▗▄▖ ▗▄▄▖  ▗▄▖  ▗▄▄▖▗▖   ▗▄▄▄▖     ▗▄▄▖ ▗▄▖ ▗▖  ▗▖▗▖  ▗▖ ▗▄▖ ▗▖  ▗▖
▐▌ ▐▌▐▌ ▐▌▐▌ ▐▌▐▌   ▐▌   ▐▌       ▐▌   ▐▌ ▐▌▐▛▚▞▜▌▐▛▚▞▜▌▐▌ ▐▌▐▛▚▖▐▌
▐▌ ▐▌▐▛▀▚▖▐▛▀▜▌▐▌   ▐▌   ▐▛▀▀▘    ▐▌   ▐▌ ▐▌▐▌  ▐▌▐▌  ▐▌▐▌ ▐▌▐▌ ▝▜▌
▝▚▄▞▘▐▌ ▐▌▐▌ ▐▌▝▚▄▄▖▐▙▄▄▖▐▙▄▄▖    ▝▚▄▄▖▝▚▄▞▘▐▌  ▐▌▐▌  ▐▌▝▚▄▞▘▐▌  ▐▌

• EN: It should be used by another oracle based component, don't use directly!
• TR: Bu bileşeni sadece oracle'a bağlanan başka bir bileşen kullanmalıdır, direkt kullanmayınız.

Usage

• EN: How to add into your project?
• TR: Projene nasıl eklersin?

npm i @samet-digital/oracle-common

Environments

@see Config

| Name | Type | Default | Required | |----------------------------------|---------|---------------------------------------------|----------| | ORA_USER | string | fake_user | false | | ORA_PASS | string | fake_pass | false | | ORA_HOST | string | localhost | false | | ORA_PORT | integer | 1521 | false | | ORA_SID | boolean | fake_sid | false | | ORA_DIR | string | C://projects/samet-digital/instant-client | false | | ORA_ACQUIRE_CONNECTION_TIMEOUT | integer | 10_000 | false | | ORA_USE_NULL_AS_DEFAULT | boolean | true | false | | ORA_POOL_MIN | integer | 2 | false | | ORA_POOL_MAX | integer | 10 | false | | ORA_POOL_IDLE_TIMEOUT_MILLIS | integer | 60_000 | false |

Contents

• oracleCommonConfig : Oracle connection defaults
• oracleClient : Oracle client for connection

Development

You can start to develop on it

Step 1

• EN: Go to your project folder
• TR: Bilgisayarında proje klasörüne git

# Windows
cd C:\\projects\samet-digital

# Mac
cd /Users/{user}/projects/samet-digital

Step 2

• EN: Clone the project
• TR: Projeyi bilgisiyarına çek

git clone https://github.com/samet-digital/oracle-common.git -b development

Dependencies

| Name | Vendor | Info | |--------------------------------------------------------|---------------|---------------------| | base-common | Samet Digital | Utility | | oracledb | Oracle | Oracle connection |

Commands

# Collects all dependencies
npm i

# Builds project dist (TS -> JS, src -> dist)
npm run build

# Publishes component on http://npmjs.com/
npm run publish:public

# Clears `dist` and `coverage` folders
npm run clear

# Clear `node_modules` folder
npm run clear:nm

# Validates lint for only errors @see (./eslint.config.mjs) for rules
npm run lint

# Validates lint with warnings
npm run lint:verbose

# Runs test cases
npm run test

# Exports coverage report, @see (./coverage/lcov-report/index.html)
npm run coverage

# Finds outdated/legacy dependencies
npm outdated

Standards

+ language: TS 
+ lint: eslint
+ inspections: intelli-j code inspections
+ ddd: domain driven development
+ edd: exception driven development
! tdd: test driven development
+ ldd: log driven development
+ ddd: document driven development

History

| Date | Developer | Info | Ticket | |------------|----------------|--------------|----------------| | 2025-08-12 | Mustafa Yelmer | Created | ~~none~~ | | 2025-08-14 | Mustafa Yelmer | Documented | ~~none~~ |