af-db-ts 1.0.2

package/dist/esm/utils.js

@@ -0,0 +1,31 @@
+/**
+ * Оборачивает строку в одинарные кавычки, если второй аргумент не true
+ */
+export const q = (val, noQuotes) => (noQuotes ? val : `'${val}'`);
+/**
+ * Экранирование одинарной кавычки и символа % для использования строки в SQL запросе
+ * onlySingleQuotes - true - не экранировать %
+ */
+export const mssqlEscape = (str, onlySingleQuotes = false) => {
+    if (str == null) {
+        str = '';
+    }
+    switch (typeof str) {
+        case 'number':
+            str = String(str);
+            break;
+        case 'string':
+            break;
+        case 'boolean':
+            str = str ? '1' : '0';
+            break;
+        default:
+            str = String(str || '');
+    }
+    str = str.replace(/'/g, `''`);
+    if (onlySingleQuotes) {
+        return str;
+    }
+    return str.replace(/%/g, '%%');
+};
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAW,EAAE,QAAkB,EAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;AAE5F;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAQ,EAAE,mBAA4B,KAAK,EAAU,EAAE;IACjF,IAAI,GAAG,IAAI,IAAI,EAAE;QACf,GAAG,GAAG,EAAE,CAAC;KACV;IACD,QAAQ,OAAO,GAAG,EAAE;QAClB,KAAK,QAAQ;YACX,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM;QACR,KAAK,SAAS;YACZ,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACtB,MAAM;QACR;YACE,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;KAC3B;IACD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,IAAI,gBAAgB,EAAE;QACpB,OAAO,GAAG,CAAC;KACZ;IACD,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC,CAAC"}

package/dist/types/db.d.ts

@@ -0,0 +1,39 @@
+import * as sql from 'mssql';
+import { ConnectionPool, IResult } from 'mssql';
+import { IConnectionPools, TGetPoolConnectionOptions } from './interfaces';
+export declare const getFirstConfigId: () => string;
+export declare const getDbConfig: (connectionId: string) => any;
+export declare const pools: IConnectionPools;
+/**
+ * Возвращает пул соединений для БД, соответствующей преданному ID соединения (borf|cep|hr|global)
+ * В случае, если не удается создать пул или открыть соединение, прерывает работу скрипта
+ */
+export declare const getPoolConnection: (connectionId: string, options?: TGetPoolConnectionOptions) => Promise<ConnectionPool | undefined>;
+/**
+ * Закрывает указанные соединения с БД
+ *
+ * poolsToClose - пул или массив пулов
+ * prefix - Префикс в сообщении о закрытии пула (название синхронизации)
+ * noEcho - подавление сообщений о закрытии соединения
+ */
+export declare const closeDbConnections: (poolsToClose: ConnectionPool | ConnectionPool[] | string | string[], prefix?: string, noEcho?: boolean) => Promise<void>;
+/**
+ * Закрывает все соединения с БД
+ *
+ * prefix - Префикс в сообщении о закрытии пула (название синхронизации)
+ * noEcho - подавление сообщений о закрытии соединения
+ */
+export declare const closeAllDbConnections: (prefix?: string, noEcho?: boolean) => Promise<void>;
+/**
+ * Закрывает указанные соединения с БД и прерывает работу скрипта
+ *
+ * poolsToClose - пул или массив пулов
+ * prefix - Префикс в сообщении о закрытии пула (название синхронизации)
+ */
+export declare const closeDbConnectionsAndExit: (poolsToClose: ConnectionPool | ConnectionPool[], prefix?: string) => Promise<never>;
+export declare const Request: (connectionId: string, strSQL: string) => Promise<any>;
+export declare const setLogger: (logger_: any) => void;
+export declare const logSqlError: (err: Error | any, noThrow?: boolean, textSQL?: string, prefix?: string) => void;
+export declare const getPool: (dbId: string, noThrow?: boolean) => Promise<sql.ConnectionPool | undefined>;
+export declare const query: (dbId: string, textSQL: string, noThrow?: boolean, prefix?: string) => Promise<IResult<any> | undefined>;
+//# sourceMappingURL=db.d.ts.map

package/dist/types/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE3E,eAAO,MAAM,gBAAgB,cAA8G,CAAC;AAC5I,eAAO,MAAM,WAAW,iBAAkB,MAAM,QAAgD,CAAC;AAEjG,eAAO,MAAM,KAAK,EAAE,gBAAqB,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,iBAAwB,MAAM,YAAW,yBAAyB,KAAQ,QAAQ,cAAc,GAAG,SAAS,CAmDzI,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,iBAAwB,cAAc,GAAG,cAAc,EAAE,GAAG,MAAM,GAAG,MAAM,EAAE,WAAW,MAAM,WAAW,OAAO,kBAsC9I,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,YAAmB,MAAM,WAAW,OAAO,kBAG5E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,iBAAwB,cAAc,GAAG,cAAc,EAAE,WAAW,MAAM,mBAG/G,CAAC;AAEF,eAAO,MAAM,OAAO,iBAAwB,MAAM,UAAU,MAAM,KAAG,QAAQ,GAAG,CAO/E,CAAC;AAQF,eAAO,MAAM,SAAS,YAAa,GAAG,SAErC,CAAC;AAEF,eAAO,MAAM,WAAW,QAAS,KAAK,GAAG,GAAG,YAAY,OAAO,YAAY,MAAM,WAAW,MAAM,SAWjG,CAAC;AAEF,eAAO,MAAM,OAAO,SAAgB,MAAM,YAAW,OAAO,4CAM3D,CAAC;AAEF,eAAO,MAAM,KAAK,SAAgB,MAAM,WAAW,MAAM,YAAY,OAAO,WAAW,MAAM,KAAG,QAAQ,QAAQ,GAAG,CAAC,GAAG,SAAS,CAc/H,CAAC"}

package/dist/types/get-value-for-sql.d.ts

@@ -0,0 +1,7 @@
+import { IGetValueForSQLArgs } from './interfaces';
+export declare const binToHexString: (value: any) => string | null;
+/**
+ * Возвращает значение, готовое для использования в строке SQL запроса
+ */
+export declare const getValueForSQL: (args: IGetValueForSQLArgs) => string | number | null;
+//# sourceMappingURL=get-value-for-sql.d.ts.map

package/dist/types/get-value-for-sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-value-for-sql.d.ts","sourceRoot":"","sources":["../../src/get-value-for-sql.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAyB,MAAM,cAAc,CAAC;AAI1E,eAAO,MAAM,cAAc,UAAW,GAAG,kBAA6D,CAAC;AAwBvG;;GAEG;AACH,eAAO,MAAM,cAAc,SAAU,mBAAmB,KAAG,MAAM,GAAG,MAAM,GAAG,IA6O5E,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export * as db from './db';
+export { prepareSqlString, correctRecordSchema, getRecordSchema, wrapTransaction, serialize, getRecordValuesForSQL, getSqlSetExpression, getSqlValuesExpression, prepareRecordForSQL, prepareDataForSQL, getRowsAffected, } from './sql';
+export { binToHexString, getValueForSQL, } from './get-value-for-sql';
+export { IDBConfig, IFieldSchema, IGetMergeSQLOptions, TDBRecord, TFieldName, TFieldTypeCorrection, TGetRecordSchemaOptions, TRecordSchema, TRecordSchemaAssoc, TRecordSet, TRecordSetAssoc, TMergeRules, TMergeResult, TRecordKey, TGetPoolConnectionOptions, TGetRecordSchemaResult, IPrepareSqlStringArgs, IGetValueForSQLArgs, IDialect, DateTimeOptionsEx, IPrepareArgs, IPrepareRecordParams, ISchemaItem, IValueForSQLPartialArgs, } from './interfaces';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,UAAU,EACV,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,uBAAuB,GACxB,MAAM,cAAc,CAAC"}

package/dist/types/interfaces.d.ts

@@ -0,0 +1,181 @@
+import { ConnectionPool, IColumnMetadata, ISqlType } from 'mssql';
+import { DateTimeOptions } from 'luxon';
+/**
+ * Имя поля БД
+ */
+export type TFieldName = string;
+/**
+ * Значение ключевого поля записи БД
+ */
+export type TRecordKey = string | number;
+/**
+ * Метаинформация о поле БД
+ */
+export interface IFieldSchema {
+    index?: number;
+    name?: string;
+    length?: number;
+    type?: any;
+    arrayType?: any;
+    scale?: number;
+    precision?: number;
+    nullable?: boolean;
+    caseSensitive?: boolean;
+    identity?: boolean;
+    excludeFromInsert?: boolean;
+    readOnly?: boolean;
+    inputDateFormat?: string;
+    defaultValue?: any;
+    noQuotes?: boolean;
+    escapeOnlySingleQuotes?: boolean;
+}
+/**
+ * Массив объектов с метаинформацией о полях
+ */
+export type TRecordSchema = IFieldSchema[];
+/**
+ * Метаинформацией о полях, проиндексированная именами полей. (sql.recordset.columns)
+ */
+export interface TRecordSchemaAssoc {
+    [fieldName: TFieldName]: IFieldSchema;
+}
+/**
+ * Объект корректировки типов полей. Наименованию поля соответствует новый тип.
+ *
+ * В частности, используется для полей, хранящих знаяения типа json в поле типа varchar(max)
+ * тогда необходимо явно задать тип поля "json". Если имя поля заканчивается на _json, коррекция типа произойдет автоматически.
+ * Также используется для указания входного формата для преобразования строки в тип datetime (свойство inputDateFormat в схеме поля)
+ */
+export interface TFieldTypeCorrection {
+    [fieldName: TFieldName]: IFieldSchema;
+}
+/**
+ * Запись БД. Объект, проиндексированный именами полей. Значения - значения полей
+ */
+export interface TDBRecord {
+    [fieldName: TFieldName]: any;
+}
+/**
+ * Массив записей БД
+ *
+ * _isPreparedForSQL - Признак того, что значения полей подготовлены для использования в строке SQL
+ */
+export type TRecordSet = TDBRecord[] & {
+    _isPreparedForSQL?: boolean;
+};
+/**
+ * Пакет записей БД.
+ * Объект, проиндексированный алиасами. Каждый подобъект содержит TDBRecord.
+ */
+export interface TRecordSetAssoc {
+    [recordKey: TRecordKey]: TDBRecord;
+}
+export interface TMergeResult {
+    total: number;
+    inserted: number;
+    updated: number;
+}
+/**
+ * Метаинформация для формирования инструкции SQL  MERGE
+ */
+export interface TMergeRules {
+    mergeIdentity?: TFieldName[];
+    excludeFromInsert?: TFieldName[];
+    noUpdateIfNull?: boolean;
+    correction?: Function;
+    withClause?: string;
+}
+export interface TGetRecordSchemaOptions {
+    omitFields?: string[];
+    pickFields?: string[];
+    fieldTypeCorrection?: TFieldTypeCorrection;
+    mergeRules?: TMergeRules;
+    noReturnMergeResult?: boolean;
+}
+export interface TGetPoolConnectionOptions {
+    prefix?: string;
+    onError?: 'exit' | 'throw';
+    errorCode?: number;
+}
+export type IDialect = 'mssql' | 'pg';
+interface IDBConfigCommon {
+    dialect: IDialect;
+    port: string | number | null;
+    database: string;
+    user: string;
+    password: string;
+}
+interface IDBConfigMSSQL extends IDBConfigCommon {
+    server: string;
+}
+interface IDBConfigPG extends IDBConfigCommon {
+    host: string;
+}
+export type IDBConfig = IDBConfigMSSQL | IDBConfigPG;
+export interface ISchemaItem {
+    index: number;
+    name: string;
+    length: number;
+    type: (() => ISqlType) | ISqlType;
+    udt?: any;
+    scale?: number | undefined;
+    precision?: number | undefined;
+    nullable: boolean;
+    caseSensitive: boolean;
+    identity: boolean;
+    readOnly: boolean;
+}
+export interface IPrepareSqlStringArgs {
+    value: string | number | null;
+    defaultValue?: string | null | undefined;
+    length?: number;
+    nullable?: boolean | number;
+    noQuotes?: boolean;
+    escapeOnlySingleQuotes?: boolean;
+}
+export interface DateTimeOptionsEx extends DateTimeOptions {
+    correctionMillis: number;
+}
+export interface IValueForSQLPartialArgs {
+    dateTimeOptions?: DateTimeOptionsEx;
+    dialect?: IDialect;
+    escapeOnlySingleQuotes?: boolean;
+    needValidate?: boolean;
+}
+export interface IPrepareRecordParams {
+    addMissingFields?: boolean;
+    addValues4NotNullableFields?: boolean;
+}
+export interface IGetValueForSQLArgs extends IValueForSQLPartialArgs {
+    value: any;
+    fieldSchema: IFieldSchema | string;
+}
+export interface IPrepareArgs extends IValueForSQLPartialArgs, IPrepareRecordParams {
+    recordSchema: TRecordSchema;
+}
+export interface IGetMergeSQLOptions extends IValueForSQLPartialArgs, IPrepareRecordParams {
+    isPrepareForSQL?: boolean;
+}
+export interface TGetRecordSchemaResult {
+    connectionId: string;
+    dbConfig: IDBConfig;
+    schemaAndTable: string;
+    dbSchemaAndTable: string;
+    columns: IColumnMetadata;
+    schemaAssoc: Partial<IColumnMetadata>;
+    schema: ISchemaItem[];
+    fields: string[];
+    insertFields: string[];
+    insertFieldsList: string;
+    withClause: string | undefined;
+    updateFields: string[];
+    mergeIdentity: string[];
+    getMergeSQL: (_packet: TRecordSet, _prepareOptions?: IGetMergeSQLOptions) => string;
+    getInsertSQL: (_packet: TRecordSet, _addOutputInserted?: boolean) => string;
+    getUpdateSQL: (_record: TRecordSet) => string;
+}
+export interface IConnectionPools {
+    [poolId: string]: ConnectionPool;
+}
+export {};
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/types/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/interfaces.ts"],"names":[],"mappings":"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"}

package/dist/types/sql.d.ts

@@ -0,0 +1,56 @@
+import * as sql from 'mssql';
+import { IFieldSchema, IPrepareArgs, IPrepareSqlStringArgs, TDBRecord, TFieldTypeCorrection, TGetRecordSchemaResult, TGetRecordSchemaOptions, TRecordSchema, TRecordSchemaAssoc, TRecordSet } from './interfaces';
+export { sql };
+/**
+ * Подготовка строки для передачи в SQL
+ */
+export declare const prepareSqlString: (args: IPrepareSqlStringArgs) => string | null;
+/**
+ * Корректировка схемы таблицы
+ * Поля с суффиксом _json получают тип "json". Остальные корректировки берутся из fieldTypeCorrection
+ * Например, для полей типа datetime можно передавать свойство inputDateFormat
+ */
+export declare const correctRecordSchema: (recordSchemaAssoc: TRecordSchemaAssoc, fieldTypeCorrection?: TFieldTypeCorrection) => void;
+/**
+ * Подготовка значений записи для использования в SQL
+ *
+ * Все поля записи обрабатываются функцией getValueForSQL
+ */
+export declare const prepareRecordForSQL: (record: TDBRecord, args: IPrepareArgs) => void;
+/**
+ * Подготовка данных для SQL
+ *
+ * Все поля всех записей обрабатываются функцией getValueForSQL
+ */
+export declare const prepareDataForSQL: (recordSet: TRecordSet, args: IPrepareArgs) => void;
+/**
+ * Возвращает рекорд, в котором все значения преобразованы в строки и подготовлены для прямой вставки в SQL
+ * В частности, если значение типа строка, то оно уже заключено в одинарные кавычки
+ */
+export declare const getRecordValuesForSQL: (record: TDBRecord, recordSchema: TRecordSchema) => TDBRecord;
+/**
+ * Возвращает схему полей таблицы БД. Либо в виде объекта, либо в виде массива
+ * Если asArray = true, то вернет TRecordSchema, при этом удалит поля, указанные в omitFields
+ * Иначе вернет TRecordSchemaAssoc
+ */
+export declare const getRecordSchema: (connectionId: string, schemaAndTable: string, options?: TGetRecordSchemaOptions) => Promise<TGetRecordSchemaResult | undefined>;
+/**
+ * Оборачивает инструкции SQL в транзакцию
+ */
+export declare const wrapTransaction: (strSQL: string) => string;
+/**
+ * Возвращает проверенное и серилизованное значение
+ */
+export declare const serialize: (value: any, fieldSchema: IFieldSchema) => string | number | null;
+/**
+ * Возвращает подготовленное выражение SET для использования в UPDATE
+ */
+export declare const getSqlSetExpression: (record: TDBRecord, recordSchema: TRecordSchema) => string;
+/**
+ * Возвращает подготовленное выражение (...поля...) VALUES (...значения...) для использования в INSERT
+ *
+ * addOutputInserted - Если true, добавляется выражение OUTPUT inserted.* перед VALUES
+ */
+export declare const getSqlValuesExpression: (record: TDBRecord, recordSchema: TRecordSchema, addOutputInserted?: boolean) => string;
+export declare const getRowsAffected: (qResult: any) => any;
+//# sourceMappingURL=sql.d.ts.map

package/dist/types/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/sql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAQ7B,OAAO,EACL,YAAY,EAES,YAAY,EACjC,qBAAqB,EAErB,SAAS,EAET,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,UAAU,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,GAAG,EAAE,CAAC;AAEf;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAAU,qBAAqB,KAAG,MAAM,GAAG,IAsBvE,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,sBACX,kBAAkB,wBAEf,oBAAoB,SAgC3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,WAAY,SAAS,QAAQ,YAAY,SAiBxE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,cAAe,UAAU,QAAQ,YAAY,SAQ1E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,WAAY,SAAS,kCAAgC,SAYtF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,iBAEZ,MAAM,kBAEJ,MAAM,YAEb,uBAAuB,KAC/B,QAAQ,sBAAsB,GAAG,SAAS,CA+J5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,WAAY,MAAM,KAAG,MAuBtC,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,SAAS,UAAW,GAAG,eAAe,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,IASnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,WAAY,SAAS,kCAAgC,MASpF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,WAAY,SAAS,mDAAkD,OAAO,KAAW,MAW3H,CAAC;AAEF,eAAO,MAAM,eAAe,YAAa,GAAG,QAAmG,CAAC"}

package/dist/types/utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Оборачивает строку в одинарные кавычки, если второй аргумент не true
+ */
+export declare const q: (val: string, noQuotes?: boolean) => string;
+/**
+ * Экранирование одинарной кавычки и символа % для использования строки в SQL запросе
+ * onlySingleQuotes - true - не экранировать %
+ */
+export declare const mssqlEscape: (str: any, onlySingleQuotes?: boolean) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,CAAC,QAAS,MAAM,aAAa,OAAO,KAAG,MAAuC,CAAC;AAE5F;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAS,GAAG,qBAAoB,OAAO,KAAW,MAqBzE,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "af-db-ts",
+  "version": "1.0.2",
+  "description": "A highly specialized function library",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "author": "Viacheslav Makarov <npmjs@bazilio.ru>",
+  "license": "ISC",
+  "scripts": {
+    "test_": "mocha --require @babel/register 'test/**/**spec.js'",
+    "clean": "shx rm -rf dist/*",
+    "build": "tsc -b tsconfig.json tsconfig.esm.json tsconfig.types.json",
+    "lint": "eslint . --ext .ts ",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "test": "jest --config jest.config.js",
+    "release": "npm run lint:fix && npm run clean && npm run build && npm run test",
+    "cb": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "af-color": "^0.0.8",
+    "af-echo-ts": "^1.0.9",
+    "af-tools-ts": "^1.0.53",
+    "config": "^3.3.9",
+    "lodash": "^4.17.21",
+    "luxon": "^3.4.2",
+    "memory-cache": "^0.2.0",
+    "moment": "^2.29.4",
+    "moment-timezone": "^0.5.43",
+    "mssql": "^9.2.0"
+  },
+  "devDependencies": {
+    "@babel/register": "^7.22.15",
+    "@jest/test-sequencer": "^29.6.4",
+    "@types/config": "^3.3.0",
+    "@types/jest": "^29.5.4",
+    "@types/lodash": "^4.14.197",
+    "@types/luxon": "^3.3.2",
+    "@types/memory-cache": "^0.2.3",
+    "@types/mssql": "^8.1.2",
+    "@types/node": "^20.5.9",
+    "@types/supertest": "^2.0.12",
+    "chai": "^4.3.8",
+    "eslint-config-af-22": "^1.0.13",
+    "jest": "^29.6.4",
+    "mocha": "^10.2.0",
+    "shx": "^0.3.4",
+    "supertest": "^6.3.3",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.2.2"
+  },
+  "np": {
+    "yarn": false,
+    "contents": "."
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/cjs",
+    "dist/esm",
+    "dist/types",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Bazilio-san/af-db-ts.git"
+  },
+  "engines": {
+    "node": ">= 14",
+    "npm": ">= 6.13.4",
+    "yarn": ">= 1.21.1"
+  }
+}

package/src/db.ts

@@ -0,0 +1,195 @@
+import * as config from 'config';
+import { magenta } from 'af-color';
+import { echo } from 'af-echo-ts';
+import * as sql from 'mssql';
+import { ConnectionPool, IResult } from 'mssql';
+import * as _ from 'lodash';
+import { sleep } from 'af-tools-ts';
+import { IConnectionPools, TGetPoolConnectionOptions } from './interfaces';
+
+export const getFirstConfigId = () => Object.keys(config.get<any>('database') || {}).filter((v) => !['dialect', '_common_'].includes(v))[0];
+export const getDbConfig = (connectionId: string) => config.get<any>(`database.${connectionId}`);
+
+export const pools: IConnectionPools = {};
+
+/**
+ * Возвращает пул соединений для БД, соответствующей преданному ID соединения (borf|cep|hr|global)
+ * В случае, если не удается создать пул или открыть соединение, прерывает работу скрипта
+ */
+export const getPoolConnection = async (connectionId: string, options: TGetPoolConnectionOptions = {}): Promise<ConnectionPool | undefined> => {
+  const { prefix = '', errorCode = 0 } = options;
+  let pool = pools[connectionId];
+  if (pool?.connected) {
+    return pool;
+  }
+  const resume = (errMsg: string) => {
+    if (options.onError === 'exit') {
+      echo.error(prefix, `${errMsg}\nEXIT PROCESS`);
+      process.exit(errorCode);
+    } else {
+      throw new Error(errMsg);
+    }
+  };
+  try {
+    const cfg: any = config.get<any>('database');
+    const namedDbConfig = cfg[connectionId];
+    if (!namedDbConfig) {
+      resume(`Missing configuration for DB id "${connectionId}"`);
+    }
+    const dbConfig = config.util.extendDeep({}, cfg._common_ || {}, cfg[connectionId]);
+    if (pool?.connecting) {
+      const startTs = Date.now();
+      while (pool?.connecting && (Date.now() - startTs < dbConfig.connectionTimeout)) {
+        // eslint-disable-next-line no-await-in-loop
+        await sleep(100);
+      }
+      if (pool?.connected) {
+        return pool;
+      }
+      echo.error(prefix, `Can't connect connectionId "${connectionId}"`);
+    }
+    pool = new sql.ConnectionPool(dbConfig);
+    if (typeof pool !== 'object') {
+      resume(`Can't create connection pool "${connectionId}"`);
+    }
+    pools[connectionId] = pool;
+    // @ts-ignore
+    pool._connectionId = connectionId;
+    pool.on('close', () => {
+      delete pools[connectionId];
+    });
+    pool.on('error', (err) => {
+      echo.error('POOL-ERROR', err);
+    });
+    await pool.connect();
+    return pool;
+  } catch (err) {
+    echo.error(err);
+    resume(`Cant connect to "${connectionId}" db`);
+  }
+};
+
+/**
+ * Закрывает указанные соединения с БД
+ *
+ * poolsToClose - пул или массив пулов
+ * prefix - Префикс в сообщении о закрытии пула (название синхронизации)
+ * noEcho - подавление сообщений о закрытии соединения
+ */
+export const closeDbConnections = async (poolsToClose: ConnectionPool | ConnectionPool[] | string | string[], prefix?: string, noEcho?: boolean) => {
+  if (!Array.isArray(poolsToClose)) {
+    // @ts-ignore
+    poolsToClose = [poolsToClose];
+  }
+  // @ts-ignore
+  for (let i = 0; i < poolsToClose.length; i++) {
+    let pool = poolsToClose[i];
+    let connectionId: string = '';
+    if (pool) {
+      if (typeof pool === 'string') {
+        connectionId = pool;
+        pool = pools[connectionId];
+      } else if (typeof pool === 'object') {
+        // @ts-ignore
+        connectionId = pool._connectionId;
+      }
+      if (connectionId) {
+        delete pools[connectionId];
+      }
+      if (pool && pool.close) {
+        try {
+          // eslint-disable-next-line no-await-in-loop
+          await pool.close();
+          if (!noEcho && connectionId) {
+            const msg = `pool "${connectionId}" closed`;
+            if (prefix) {
+              echo.info(prefix, msg);
+            } else {
+              echo.info(msg);
+            }
+          }
+        } catch (err) {
+          //
+        }
+      }
+    }
+  }
+};
+
+/**
+ * Закрывает все соединения с БД
+ *
+ * prefix - Префикс в сообщении о закрытии пула (название синхронизации)
+ * noEcho - подавление сообщений о закрытии соединения
+ */
+export const closeAllDbConnections = async (prefix?: string, noEcho?: boolean) => {
+  const poolsToClose = _.map(pools, (p) => p);
+  await closeDbConnections(poolsToClose, prefix, noEcho);
+};
+
+/**
+ * Закрывает указанные соединения с БД и прерывает работу скрипта
+ *
+ * poolsToClose - пул или массив пулов
+ * prefix - Префикс в сообщении о закрытии пула (название синхронизации)
+ */
+export const closeDbConnectionsAndExit = async (poolsToClose: ConnectionPool | ConnectionPool[], prefix?: string) => {
+  await closeDbConnections(poolsToClose, prefix);
+  process.exit(0);
+};
+
+export const Request = async (connectionId: string, strSQL: string): Promise<any> => {
+  const pool = await getPoolConnection(connectionId, { onError: 'throw' });
+  const request = new sql.Request(pool);
+  if (strSQL) {
+    return request.query(strSQL);
+  }
+  return request;
+};
+
+interface IAsLogger {
+  error: Function,
+}
+
+let logger: IAsLogger = echo as IAsLogger;
+
+export const setLogger = (logger_: any) => {
+  logger = logger_ as IAsLogger;
+};
+
+export const logSqlError = (err: Error | any, noThrow?: boolean, textSQL?: string, prefix?: string) => {
+  if (prefix) {
+    logger.error(prefix);
+  }
+  if (textSQL) {
+    logger.error(`SQL Error:\n${magenta}${textSQL}`);
+  }
+  logger.error(err);
+  if (!noThrow) {
+    throw err;
+  }
+};
+
+export const getPool = async (dbId: string, noThrow: boolean = false) => {
+  try {
+    return getPoolConnection(dbId);
+  } catch (err) {
+    logSqlError(err, noThrow, `Error while open connection to DB ${dbId}`);
+  }
+};
+
+export const query = async (dbId: string, textSQL: string, noThrow?: boolean, prefix?: string): Promise<IResult<any> | undefined> => {
+  const pool = await getPool(dbId, noThrow);
+  if (!pool?.connected && !pool?.connecting) {
+    await closeDbConnections(dbId);
+    return;
+  }
+  const request = new sql.Request(pool);
+  let res: IResult<any>;
+  try {
+    res = await request.query(textSQL);
+    return res;
+  } catch (err) {
+    logSqlError(err, noThrow, textSQL, prefix);
+  }
+};