vv-db-connection 0.0.0-stage → 1.0.2

package/distjs/src/db/adapters/mssql.js

@@ -0,0 +1,155 @@
+import sql from 'mssql';
+import { mapPlaceholders } from '../placeholders.js';
+// Converts :name placeholders to @name for mssql named parameters. A colon inside a
+// string literal, a quoted identifier or a comment is left as it is.
+function buildMssqlQuery(query) {
+    return mapPlaceholders(query, (name) => `@${name}`);
+}
+function toSchema(columns) {
+    return Object.values(columns).map((col) => ({
+        name: col.name,
+        kind: 'unknown',
+        len: col.length,
+        scale: col.scale,
+        precision: col.precision,
+    }));
+}
+function buildPoolConfig(p) {
+    const base = {
+        server: p.server,
+        port: p.port ?? 1433,
+        ...(p.database ? { database: p.database } : {}),
+        options: {
+            trustServerCertificate: p.trustServerCertificate ?? false,
+            encrypt: p.encrypt ?? false,
+        },
+    };
+    if (p.auth.kind === 'ntlm') {
+        return { ...base, authentication: { type: 'ntlm', options: { domain: p.auth.domain, userName: p.auth.user, password: p.auth.password } } };
+    }
+    return { ...base, user: p.auth.user, password: p.auth.password };
+}
+export class MssqlAdapter {
+    p;
+    constructor(p) {
+        this.p = p;
+    }
+    kind() { return 'mssql'; }
+    title() { return `${this.p.server}:${this.p.port || 'DEFAULT'} [${this.p.database ?? 'default'}]`; }
+    user() {
+        if (this.p.auth.kind === 'ntlm')
+            return `${this.p.auth.domain}\\${this.p.auth.user}`;
+        return this.p.auth.user;
+    }
+    versionQuery() { return 'SELECT @@VERSION AS ver'; }
+    pingQuery() { return 'SELECT 1 AS p'; }
+    async execStream(query, params, callback, signal) {
+        const pool = await new sql.ConnectionPool(buildPoolConfig(this.p)).connect();
+        if (signal?.aborted) {
+            try {
+                await pool.close();
+            }
+            catch { }
+            return;
+        }
+        return new Promise((resolve) => {
+            const request = pool.request();
+            request.stream = true;
+            for (const p of params) {
+                request.input(p.name, p.value);
+            }
+            let error;
+            let done = false;
+            const onAbort = () => {
+                if (done)
+                    return;
+                done = true;
+                try {
+                    request.cancel();
+                }
+                catch { }
+                void pool.close().catch(() => { });
+                resolve();
+            };
+            signal?.addEventListener('abort', onAbort);
+            request.on('recordset', (columns) => {
+                if (!done)
+                    callback({ kind: 'schema', schema: toSchema(columns) });
+            });
+            request.on('row', (row) => {
+                if (!done)
+                    callback({ kind: 'row', row });
+            });
+            request.on('error', (err) => {
+                error = String(err);
+            });
+            request.on('done', async () => {
+                if (done)
+                    return;
+                done = true;
+                signal?.removeEventListener('abort', onAbort);
+                try {
+                    await pool.close();
+                }
+                catch { }
+                callback({ kind: 'finish', error });
+                resolve();
+            });
+            request.query(buildMssqlQuery(query));
+        });
+    }
+    async execTxDynamic(cb, timeoutMs) {
+        const pool = await new sql.ConnectionPool(buildPoolConfig(this.p)).connect();
+        const txWork = async () => {
+            const tx = new sql.Transaction(pool);
+            try {
+                await tx.begin();
+                const exec = (query, params) => {
+                    const req = new sql.Request(tx);
+                    const q = buildMssqlQuery(query);
+                    for (const p of params)
+                        req.input(p.name, p.value);
+                    return new Promise((resolve, reject) => {
+                        const onUncaught = (err) => reject(err);
+                        process.once('uncaughtException', onUncaught);
+                        req.query(q)
+                            .then((res) => { process.removeListener('uncaughtException', onUncaught); resolve({ rows: (res.recordset ?? []) }); })
+                            .catch((err) => { process.removeListener('uncaughtException', onUncaught); reject(err); });
+                    });
+                };
+                await cb(exec);
+                await tx.commit();
+                return { ok: true, result: undefined };
+            }
+            catch (err) {
+                try {
+                    await tx.rollback();
+                }
+                catch { }
+                return { ok: false, error: String(err) };
+            }
+            finally {
+                try {
+                    await pool.close();
+                }
+                catch { }
+            }
+        };
+        if (!timeoutMs)
+            return txWork();
+        let timer;
+        const timeoutPromise = new Promise((resolve) => {
+            timer = setTimeout(() => {
+                void pool.close().catch(() => { });
+                resolve({ ok: false, error: 'TIMEOUT' });
+            }, timeoutMs);
+        });
+        try {
+            return await Promise.race([txWork(), timeoutPromise]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=mssql.js.map

package/distjs/src/db/adapters/mssql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mssql.js","sourceRoot":"","sources":["../../../../src/db/adapters/mssql.ts"],"names":[],"mappings":"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","sourcesContent":["import sql from 'mssql'\nimport type { IDbAdapter, TDbCol, TDbParam, TDbStreamEvent, TDbTxCb, TDbTxResult } from '../types'\nimport type { TConnMssql } from '../connection'\nimport type { TResult } from '../../tresult'\nimport { mapPlaceholders } from '../placeholders'\n\n// Converts :name placeholders to @name for mssql named parameters. A colon inside a\n// string literal, a quoted identifier or a comment is left as it is.\nfunction buildMssqlQuery(query: string): string {\n\treturn mapPlaceholders(query, (name) => `@${name}`)\n}\n\nfunction toSchema(columns: Record<string, any>): TDbCol[] {\n\treturn Object.values(columns).map((col) => ({\n\t\tname:      col.name,\n\t\tkind:      'unknown',\n\t\tlen:       col.length,\n\t\tscale:     col.scale,\n\t\tprecision: col.precision,\n\t}))\n}\n\nfunction buildPoolConfig(p: TConnMssql): sql.config {\n\tconst base: sql.config = {\n\t\tserver:   p.server,\n\t\tport:     p.port ?? 1433,\n\t\t...(p.database ? { database: p.database } : {}),\n\t\toptions: {\n\t\t\ttrustServerCertificate: p.trustServerCertificate ?? false,\n\t\t\tencrypt:                p.encrypt ?? false,\n\t\t},\n\t}\n\tif (p.auth.kind === 'ntlm') {\n\t\treturn { ...base, authentication: { type: 'ntlm', options: { domain: p.auth.domain, userName: p.auth.user, password: p.auth.password } } }\n\t}\n\treturn { ...base, user: p.auth.user, password: p.auth.password }\n}\n\nexport class MssqlAdapter implements IDbAdapter {\n\tconstructor(private readonly p: TConnMssql) {}\n\n\tkind(): 'mssql' { return 'mssql' }\n\ttitle(): string { return `${this.p.server}:${this.p.port || 'DEFAULT'} [${this.p.database ?? 'default'}]` }\n\tuser(): string {\n\t\tif (this.p.auth.kind === 'ntlm') return `${this.p.auth.domain}\\\\${this.p.auth.user}`\n\t\treturn this.p.auth.user\n\t}\n\tversionQuery(): string { return 'SELECT @@VERSION AS ver' }\n\tpingQuery(): string { return 'SELECT 1 AS p' }\n\n\tasync execStream(query: string, params: TDbParam[], callback: (event: TDbStreamEvent) => void, signal?: AbortSignal): Promise<void> {\n\t\tconst pool = await new sql.ConnectionPool(buildPoolConfig(this.p)).connect()\n\t\tif (signal?.aborted) {\n\t\t\ttry { await pool.close() } catch {}\n\t\t\treturn\n\t\t}\n\n\t\treturn new Promise<void>((resolve) => {\n\t\t\tconst request = pool.request()\n\t\t\trequest.stream = true\n\t\t\tfor (const p of params) {\n\t\t\t\trequest.input(p.name, p.value)\n\t\t\t}\n\n\t\t\tlet error: string | undefined\n\t\t\tlet done = false\n\n\t\t\tconst onAbort = (): void => {\n\t\t\t\tif (done) return\n\t\t\t\tdone = true\n\t\t\t\ttry { request.cancel() } catch {}\n\t\t\t\tvoid pool.close().catch(() => {})\n\t\t\t\tresolve()\n\t\t\t}\n\t\t\tsignal?.addEventListener('abort', onAbort)\n\n\t\t\trequest.on('recordset', (columns: Record<string, unknown>) => {\n\t\t\t\tif (!done) callback({ kind: 'schema', schema: toSchema(columns) })\n\t\t\t})\n\t\t\trequest.on('row', (row: object) => {\n\t\t\t\tif (!done) callback({ kind: 'row', row })\n\t\t\t})\n\t\t\trequest.on('error', (err: Error) => {\n\t\t\t\terror = String(err)\n\t\t\t})\n\t\t\trequest.on('done', async () => {\n\t\t\t\tif (done) return\n\t\t\t\tdone = true\n\t\t\t\tsignal?.removeEventListener('abort', onAbort)\n\t\t\t\ttry { await pool.close() } catch {}\n\t\t\t\tcallback({ kind: 'finish', error })\n\t\t\t\tresolve()\n\t\t\t})\n\n\t\t\trequest.query(buildMssqlQuery(query))\n\t\t})\n\t}\n\n\tasync execTxDynamic(cb: TDbTxCb, timeoutMs?: number): Promise<TResult<void>> {\n\t\tconst pool = await new sql.ConnectionPool(buildPoolConfig(this.p)).connect()\n\t\tconst txWork = async (): Promise<TResult<void>> => {\n\t\t\tconst tx = new sql.Transaction(pool)\n\t\t\ttry {\n\t\t\t\tawait tx.begin()\n\t\t\t\tconst exec = (query: string, params: TDbParam[]): Promise<TDbTxResult> => {\n\t\t\t\t\tconst req = new sql.Request(tx)\n\t\t\t\t\tconst q = buildMssqlQuery(query)\n\t\t\t\t\tfor (const p of params) req.input(p.name, p.value)\n\t\t\t\t\treturn new Promise<TDbTxResult>((resolve, reject) => {\n\t\t\t\t\t\tconst onUncaught = (err: Error) => reject(err)\n\t\t\t\t\t\tprocess.once('uncaughtException', onUncaught)\n\t\t\t\t\t\treq.query(q)\n\t\t\t\t\t\t\t.then((res) => { process.removeListener('uncaughtException', onUncaught); resolve({ rows: (res.recordset ?? []) as Record<string, unknown>[] }) })\n\t\t\t\t\t\t\t.catch((err) => { process.removeListener('uncaughtException', onUncaught); reject(err) })\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\tawait cb(exec)\n\t\t\t\tawait tx.commit()\n\t\t\t\treturn { ok: true, result: undefined }\n\t\t\t} catch (err) {\n\t\t\t\ttry { await tx.rollback() } catch {}\n\t\t\t\treturn { ok: false, error: String(err) }\n\t\t\t} finally {\n\t\t\t\ttry { await pool.close() } catch {}\n\t\t\t}\n\t\t}\n\t\tif (!timeoutMs) return txWork()\n\t\tlet timer: ReturnType<typeof setTimeout> | undefined\n\t\tconst timeoutPromise = new Promise<TResult<void>>((resolve) => {\n\t\t\ttimer = setTimeout(() => {\n\t\t\t\tvoid pool.close().catch(() => {})\n\t\t\t\tresolve({ ok: false, error: 'TIMEOUT' })\n\t\t\t}, timeoutMs)\n\t\t})\n\t\ttry {\n\t\t\treturn await Promise.race([txWork(), timeoutPromise])\n\t\t} finally {\n\t\t\tclearTimeout(timer)\n\t\t}\n\t}\n}\n"]}

package/distjs/src/db/adapters/ora.d.ts

@@ -0,0 +1,15 @@
+import type { IDbAdapter, TDbParam, TDbStreamEvent, TDbTxCb } from '../types.js';
+import type { TConnOra } from '../connection.js';
+import type { TResult } from '../../tresult.js';
+export declare class OraAdapter implements IDbAdapter {
+    private readonly p;
+    constructor(p: TConnOra);
+    kind(): 'ora';
+    title(): string;
+    user(): string;
+    versionQuery(): string;
+    pingQuery(): string;
+    private _connParams;
+    execStream(query: string, params: TDbParam[], callback: (event: TDbStreamEvent) => void, signal?: AbortSignal): Promise<void>;
+    execTxDynamic(cb: TDbTxCb, timeoutMs?: number): Promise<TResult<void>>;
+}

package/distjs/src/db/adapters/ora.js

@@ -0,0 +1,137 @@
+import oracledb from 'oracledb';
+function toSchema(meta) {
+    return meta.map((m) => ({
+        name: m.name,
+        kind: 'unknown',
+        len: m.byteSize,
+        scale: m.scale,
+        precision: m.precision,
+    }));
+}
+export class OraAdapter {
+    p;
+    constructor(p) {
+        this.p = p;
+    }
+    kind() { return 'ora'; }
+    title() { return `${this.p.host}:${this.p.port || 'DEFAULT'} [${this.p.service}]`; }
+    user() { return this.p.user; }
+    versionQuery() { return 'SELECT banner AS ver FROM v$version WHERE rownum = 1'; }
+    pingQuery() { return 'SELECT 1 AS p FROM dual'; }
+    _connParams() {
+        const privilegeMap = {
+            SYSDBA: oracledb.SYSDBA,
+            SYSOPER: oracledb.SYSOPER,
+            SYSASM: oracledb.SYSASM,
+            SYSBACKUP: oracledb.SYSBACKUP,
+            SYSDG: oracledb.SYSDG,
+            SYSKM: oracledb.SYSKM,
+            SYSRAC: oracledb.SYSRAC,
+        };
+        return {
+            connectString: `${this.p.host}:${this.p.port ?? 1521}/${this.p.service}`,
+            user: this.p.user,
+            password: this.p.password,
+            ...(this.p.privilege && { privilege: privilegeMap[this.p.privilege] }),
+        };
+    }
+    async execStream(query, params, callback, signal) {
+        const conn = await oracledb.getConnection(this._connParams());
+        let onAbort;
+        try {
+            const binds = {};
+            for (const p of params) {
+                binds[p.name] = p.value;
+            }
+            const stream = conn.queryStream(query, binds, { outFormat: oracledb.OUT_FORMAT_OBJECT });
+            await new Promise((resolve) => {
+                let done = false;
+                const finish = (error) => {
+                    if (done)
+                        return;
+                    done = true;
+                    callback({ kind: 'finish', error });
+                    resolve();
+                };
+                stream.on('metadata', (meta) => {
+                    callback({ kind: 'schema', schema: toSchema(meta) });
+                });
+                stream.on('data', (row) => {
+                    callback({ kind: 'row', row });
+                });
+                stream.on('error', (err) => finish(String(err)));
+                stream.on('end', () => finish());
+                // break() interrupts the call running on the server; the stream is destroyed
+                // in case the server does not answer even that.
+                onAbort = () => {
+                    void conn.break().catch(() => { });
+                    stream.destroy();
+                    finish(String(signal?.reason ?? 'aborted'));
+                };
+                if (signal?.aborted)
+                    onAbort();
+                else
+                    signal?.addEventListener('abort', onAbort);
+            });
+        }
+        finally {
+            if (onAbort)
+                signal?.removeEventListener('abort', onAbort);
+            try {
+                await conn.close();
+            }
+            catch { }
+        }
+    }
+    async execTxDynamic(cb, timeoutMs) {
+        const conn = await oracledb.getConnection(this._connParams());
+        const txWork = async () => {
+            try {
+                const exec = (query, params) => {
+                    const binds = {};
+                    for (const p of params)
+                        binds[p.name] = p.value;
+                    return new Promise((resolve, reject) => {
+                        const onUncaught = (err) => reject(err);
+                        process.once('uncaughtException', onUncaught);
+                        conn.execute(query, binds, { autoCommit: false, outFormat: oracledb.OUT_FORMAT_OBJECT })
+                            .then((res) => { process.removeListener('uncaughtException', onUncaught); resolve({ rows: (res.rows ?? []) }); })
+                            .catch((err) => { process.removeListener('uncaughtException', onUncaught); reject(err); });
+                    });
+                };
+                await cb(exec);
+                await conn.commit();
+                return { ok: true, result: undefined };
+            }
+            catch (err) {
+                try {
+                    await conn.rollback();
+                }
+                catch { }
+                return { ok: false, error: String(err) };
+            }
+            finally {
+                try {
+                    await conn.close();
+                }
+                catch { }
+            }
+        };
+        if (!timeoutMs)
+            return txWork();
+        let timer;
+        const timeoutPromise = new Promise((resolve) => {
+            timer = setTimeout(() => {
+                void conn.close().catch(() => { });
+                resolve({ ok: false, error: 'TIMEOUT' });
+            }, timeoutMs);
+        });
+        try {
+            return await Promise.race([txWork(), timeoutPromise]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=ora.js.map

package/distjs/src/db/adapters/ora.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ora.js","sourceRoot":"","sources":["../../../../src/db/adapters/ora.ts"],"names":[],"mappings":"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","sourcesContent":["import oracledb from 'oracledb'\nimport type { IDbAdapter, TDbCol, TDbParam, TDbStreamEvent, TDbTxCb, TDbTxResult } from '../types'\nimport type { TConnOra } from '../connection'\nimport type { TResult } from '../../tresult'\n\ntype OraMetadata = { name: string; dbTypeName: string; byteSize?: number; scale?: number; precision?: number }\n\nfunction toSchema(meta: OraMetadata[]): TDbCol[] {\n\treturn meta.map((m) => ({\n\t\tname:      m.name,\n\t\tkind:      'unknown',\n\t\tlen:       m.byteSize,\n\t\tscale:     m.scale,\n\t\tprecision: m.precision,\n\t}))\n}\n\nexport class OraAdapter implements IDbAdapter {\n\tconstructor(private readonly p: TConnOra) {}\n\n\tkind(): 'ora' { return 'ora' }\n\ttitle(): string { return `${this.p.host}:${this.p.port || 'DEFAULT'} [${this.p.service}]` }\n\tuser(): string { return this.p.user }\n\tversionQuery(): string { return 'SELECT banner AS ver FROM v$version WHERE rownum = 1' }\n\tpingQuery(): string { return 'SELECT 1 AS p FROM dual' }\n\n\tprivate _connParams() {\n\t\tconst privilegeMap: Record<string, number> = {\n\t\t\tSYSDBA:    oracledb.SYSDBA,\n\t\t\tSYSOPER:   oracledb.SYSOPER,\n\t\t\tSYSASM:    oracledb.SYSASM,\n\t\t\tSYSBACKUP: oracledb.SYSBACKUP,\n\t\t\tSYSDG:     oracledb.SYSDG,\n\t\t\tSYSKM:     oracledb.SYSKM,\n\t\t\tSYSRAC:    oracledb.SYSRAC,\n\t\t}\n\t\treturn {\n\t\t\tconnectString: `${this.p.host}:${this.p.port ?? 1521}/${this.p.service}`,\n\t\t\tuser:      this.p.user,\n\t\t\tpassword:  this.p.password,\n\t\t\t...(this.p.privilege && { privilege: privilegeMap[this.p.privilege] }),\n\t\t}\n\t}\n\n\tasync execStream(query: string, params: TDbParam[], callback: (event: TDbStreamEvent) => void, signal?: AbortSignal): Promise<void> {\n\t\tconst conn = await oracledb.getConnection(this._connParams())\n\t\tlet onAbort: (() => void) | undefined\n\t\ttry {\n\t\t\ttype OraBindValue = oracledb.BindParameter | string | number | bigint | Date | Buffer | null | undefined\n\t\t\tconst binds: Record<string, OraBindValue> = {}\n\t\t\tfor (const p of params) {\n\t\t\t\tbinds[p.name] = p.value as OraBindValue\n\t\t\t}\n\t\t\tconst stream = conn.queryStream(query, binds, { outFormat: oracledb.OUT_FORMAT_OBJECT })\n\t\t\tawait new Promise<void>((resolve) => {\n\t\t\t\tlet done = false\n\t\t\t\tconst finish = (error?: string) => {\n\t\t\t\t\tif (done) return\n\t\t\t\t\tdone = true\n\t\t\t\t\tcallback({ kind: 'finish', error })\n\t\t\t\t\tresolve()\n\t\t\t\t}\n\t\t\t\tstream.on('metadata', (meta: OraMetadata[]) => {\n\t\t\t\t\tcallback({ kind: 'schema', schema: toSchema(meta) })\n\t\t\t\t})\n\t\t\t\tstream.on('data', (row: object) => {\n\t\t\t\t\tcallback({ kind: 'row', row })\n\t\t\t\t})\n\t\t\t\tstream.on('error', (err: Error) => finish(String(err)))\n\t\t\t\tstream.on('end', () => finish())\n\t\t\t\t// break() interrupts the call running on the server; the stream is destroyed\n\t\t\t\t// in case the server does not answer even that.\n\t\t\t\tonAbort = () => {\n\t\t\t\t\tvoid conn.break().catch(() => {})\n\t\t\t\t\tstream.destroy()\n\t\t\t\t\tfinish(String(signal?.reason ?? 'aborted'))\n\t\t\t\t}\n\t\t\t\tif (signal?.aborted) onAbort()\n\t\t\t\telse signal?.addEventListener('abort', onAbort)\n\t\t\t})\n\t\t} finally {\n\t\t\tif (onAbort) signal?.removeEventListener('abort', onAbort)\n\t\t\ttry { await conn.close() } catch {}\n\t\t}\n\t}\n\n\tasync execTxDynamic(cb: TDbTxCb, timeoutMs?: number): Promise<TResult<void>> {\n\t\tconst conn = await oracledb.getConnection(this._connParams())\n\t\tconst txWork = async (): Promise<TResult<void>> => {\n\t\t\ttry {\n\t\t\t\tconst exec = (query: string, params: TDbParam[]): Promise<TDbTxResult> => {\n\t\t\t\t\ttype OraBindValue = oracledb.BindParameter | string | number | bigint | Date | Buffer | null | undefined\n\t\t\t\t\tconst binds: Record<string, OraBindValue> = {}\n\t\t\t\t\tfor (const p of params) binds[p.name] = p.value as OraBindValue\n\t\t\t\t\treturn new Promise<TDbTxResult>((resolve, reject) => {\n\t\t\t\t\t\tconst onUncaught = (err: Error) => reject(err)\n\t\t\t\t\t\tprocess.once('uncaughtException', onUncaught)\n\t\t\t\t\t\tconn.execute<Record<string, unknown>>(query, binds, { autoCommit: false, outFormat: oracledb.OUT_FORMAT_OBJECT })\n\t\t\t\t\t\t\t.then((res) => { process.removeListener('uncaughtException', onUncaught); resolve({ rows: (res.rows ?? []) as Record<string, unknown>[] }) })\n\t\t\t\t\t\t\t.catch((err) => { process.removeListener('uncaughtException', onUncaught); reject(err) })\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\tawait cb(exec)\n\t\t\t\tawait conn.commit()\n\t\t\t\treturn { ok: true, result: undefined }\n\t\t\t} catch (err) {\n\t\t\t\ttry { await conn.rollback() } catch {}\n\t\t\t\treturn { ok: false, error: String(err) }\n\t\t\t} finally {\n\t\t\t\ttry { await conn.close() } catch {}\n\t\t\t}\n\t\t}\n\t\tif (!timeoutMs) return txWork()\n\t\tlet timer: ReturnType<typeof setTimeout> | undefined\n\t\tconst timeoutPromise = new Promise<TResult<void>>((resolve) => {\n\t\t\ttimer = setTimeout(() => {\n\t\t\t\tvoid conn.close().catch(() => {})\n\t\t\t\tresolve({ ok: false, error: 'TIMEOUT' })\n\t\t\t}, timeoutMs)\n\t\t})\n\t\ttry {\n\t\t\treturn await Promise.race([txWork(), timeoutPromise])\n\t\t} finally {\n\t\t\tclearTimeout(timer)\n\t\t}\n\t}\n}\n"]}

package/distjs/src/db/adapters/pg.d.ts

@@ -0,0 +1,16 @@
+import type { IDbAdapter, TDbParam, TDbStreamEvent, TDbTxCb } from '../types.js';
+import type { TConnPg } from '../connection.js';
+import type { TResult } from '../../tresult.js';
+export declare class PgAdapter implements IDbAdapter {
+    private readonly p;
+    constructor(p: TConnPg);
+    kind(): 'pg';
+    title(): string;
+    user(): string;
+    versionQuery(): string;
+    pingQuery(): string;
+    private _clientConfig;
+    private _cancelBackend;
+    execStream(query: string, params: TDbParam[], callback: (event: TDbStreamEvent) => void, signal?: AbortSignal): Promise<void>;
+    execTxDynamic(cb: TDbTxCb, timeoutMs?: number): Promise<TResult<void>>;
+}

package/distjs/src/db/adapters/pg.js

@@ -0,0 +1,153 @@
+import { Client } from 'pg';
+import { mapPlaceholders } from '../placeholders.js';
+function toSchema(fields) {
+    return fields.map((f) => ({ name: f.name, kind: 'unknown' }));
+}
+// Converts :name placeholders to $1, $2, ... and collects values.
+// Same :name used multiple times maps to the same $N. A colon inside a string literal, a
+// quoted identifier or a comment is left as it is.
+function buildQuery(query, params) {
+    const nameToIndex = new Map();
+    const values = [];
+    const text = mapPlaceholders(query, (name) => {
+        if (!nameToIndex.has(name)) {
+            const found = params.find((p) => p.name === name);
+            if (!found)
+                throw new Error(`pg: param not found: ${name}`);
+            values.push(found.value);
+            nameToIndex.set(name, values.length);
+        }
+        return `$${nameToIndex.get(name)}`;
+    });
+    return { text, values };
+}
+export class PgAdapter {
+    p;
+    constructor(p) {
+        this.p = p;
+    }
+    kind() { return 'pg'; }
+    title() { return `${this.p.host}:${this.p.port || 'DEFAULT'} [${this.p.database}]`; }
+    user() { return this.p.user; }
+    versionQuery() { return 'SELECT version() AS ver'; }
+    pingQuery() { return 'SELECT 1 AS p'; }
+    _clientConfig() {
+        return {
+            host: this.p.host,
+            port: this.p.port ?? 5432,
+            database: this.p.database,
+            user: this.p.user,
+            password: this.p.password,
+            ssl: this.p.ssl ? { rejectUnauthorized: false } : undefined,
+            options: '-c client_encoding=UTF8',
+        };
+    }
+    // A backend does not notice its client is gone until it has something to send, so a
+    // query cut off on our side would go on to its very end on the server. It is cancelled
+    // from a connection of its own; a server that does not answer that either is given up
+    // on after a while - this runs in the background and nobody waits for it.
+    _cancelBackend(pid) {
+        const c = new Client({ ...this._clientConfig(), connectionTimeoutMillis: 30_000, query_timeout: 30_000 });
+        c.on('error', () => { });
+        void c.connect()
+            .then(() => c.query('SELECT pg_cancel_backend($1)', [pid]))
+            .catch(() => { })
+            .finally(() => { void c.end().catch(() => { }); });
+    }
+    async execStream(query, params, callback, signal) {
+        const client = new Client(this._clientConfig());
+        // The socket is destroyed rather than ended: a graceful end waits for a server
+        // that may be the very thing that stopped answering. The query then fails, and the
+        // client also emits "error" - with nobody listening that would be thrown.
+        client.on('error', () => { });
+        const onAbort = () => {
+            const internals = client;
+            if (internals.processID)
+                this._cancelBackend(internals.processID);
+            try {
+                internals.connection?.stream?.destroy();
+            }
+            catch { }
+        };
+        signal?.addEventListener('abort', onAbort);
+        try {
+            await client.connect();
+            const { text, values } = buildQuery(query, params);
+            const result = await client.query({ text, values });
+            callback({ kind: 'schema', schema: toSchema(result.fields) });
+            for (const row of result.rows) {
+                callback({ kind: 'row', row });
+            }
+            callback({ kind: 'finish' });
+        }
+        catch (err) {
+            callback({ kind: 'finish', error: String(err) });
+        }
+        finally {
+            signal?.removeEventListener('abort', onAbort);
+            try {
+                await client.end();
+            }
+            catch { }
+        }
+    }
+    async execTxDynamic(cb, timeoutMs) {
+        const client = new Client({
+            host: this.p.host,
+            port: this.p.port ?? 5432,
+            database: this.p.database,
+            user: this.p.user,
+            password: this.p.password,
+            ssl: this.p.ssl ? { rejectUnauthorized: false } : undefined,
+            options: '-c client_encoding=UTF8',
+        });
+        const txWork = async () => {
+            try {
+                await client.connect();
+                await client.query('BEGIN');
+                const exec = (query, params) => {
+                    const { text, values } = buildQuery(query, params);
+                    return new Promise((resolve, reject) => {
+                        const onUncaught = (err) => reject(err);
+                        process.once('uncaughtException', onUncaught);
+                        client.query({ text, values })
+                            .then((res) => { process.removeListener('uncaughtException', onUncaught); resolve({ rows: res.rows }); })
+                            .catch((err) => { process.removeListener('uncaughtException', onUncaught); reject(err); });
+                    });
+                };
+                await cb(exec);
+                await client.query('COMMIT');
+                return { ok: true, result: undefined };
+            }
+            catch (err) {
+                try {
+                    await client.query('ROLLBACK');
+                }
+                catch { }
+                return { ok: false, error: String(err) };
+            }
+            finally {
+                try {
+                    await client.end();
+                }
+                catch { }
+            }
+        };
+        if (!timeoutMs)
+            return txWork();
+        let timer;
+        const timeoutPromise = new Promise((resolve) => {
+            timer = setTimeout(() => {
+                void client.end().catch(() => { });
+                resolve({ ok: false, error: 'TIMEOUT' });
+            }, timeoutMs);
+        });
+        try {
+            return await Promise.race([txWork(), timeoutPromise]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=pg.js.map

package/distjs/src/db/adapters/pg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.js","sourceRoot":"","sources":["../../../../src/db/adapters/pg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,IAAI,CAAA;AAI1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,SAAS,QAAQ,CAAC,MAAkB;IACnC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;AAC9D,CAAC;AAED,kEAAkE;AAClE,yFAAyF;AACzF,mDAAmD;AACnD,SAAS,UAAU,CAAC,KAAa,EAAE,MAAkB;IACpD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC7C,MAAM,MAAM,GAAc,EAAE,CAAA;IAC5B,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;QAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;YACjD,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAA;YAC3D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YACxB,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACrC,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAA;IACnC,CAAC,CAAC,CAAA;IACF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACxB,CAAC;AAED,MAAM,OAAO,SAAS;IACQ,CAAC;IAA9B,YAA6B,CAAU;iBAAV,CAAC;IAAY,CAAC;IAE3C,IAAI,KAAW,OAAO,IAAI,CAAA,CAAC,CAAC;IAC5B,KAAK,KAAa,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAA,CAAC,CAAC;IAC5F,IAAI,KAAa,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA,CAAC,CAAC;IACrC,YAAY,KAAa,OAAO,yBAAyB,CAAA,CAAC,CAAC;IAC3D,SAAS,KAAa,OAAO,eAAe,CAAA,CAAC,CAAC;IAEtC,aAAa;QACpB,OAAO;YACN,IAAI,EAAM,IAAI,CAAC,CAAC,CAAC,IAAI;YACrB,IAAI,EAAM,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI;YAC7B,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ;YACzB,IAAI,EAAM,IAAI,CAAC,CAAC,CAAC,IAAI;YACrB,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ;YACzB,GAAG,EAAO,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;YAChE,OAAO,EAAG,yBAAyB;SACnC,CAAA;IACF,CAAC;IAED,oFAAoF;IACpF,uFAAuF;IACvF,sFAAsF;IACtF,0EAA0E;IAClE,cAAc,CAAC,GAAW;QACjC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,uBAAuB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAA;QACzG,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACvB,KAAK,CAAC,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;aAC1D,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;aACf,OAAO,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,MAAkB,EAAE,QAAyC,EAAE,MAAoB;QAClH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAA;QAC/C,+EAA+E;QAC/E,mFAAmF;QACnF,0EAA0E;QAC1E,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC5B,MAAM,OAAO,GAAG,GAAS,EAAE;YAC1B,MAAM,SAAS,GAAG,MAA0F,CAAA;YAC5G,IAAI,SAAS,CAAC,SAAS;gBAAE,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;YACjE,IAAI,CAAC;gBAAC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACzD,CAAC,CAAA;QACD,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC1C,IAAI,CAAC;YACJ,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;YACtB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;YACnD,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAC7D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC/B,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;YAC/B,CAAC;YACD,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACjD,CAAC;gBAAS,CAAC;YACV,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC7C,IAAI,CAAC;gBAAC,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACpC,CAAC;IACF,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAW,EAAE,SAAkB;QAClD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;YACzB,IAAI,EAAM,IAAI,CAAC,CAAC,CAAC,IAAI;YACrB,IAAI,EAAM,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI;YAC7B,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ;YACzB,IAAI,EAAM,IAAI,CAAC,CAAC,CAAC,IAAI;YACrB,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ;YACzB,GAAG,EAAO,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;YAChE,OAAO,EAAG,yBAAyB;SACnC,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,KAAK,IAA4B,EAAE;YACjD,IAAI,CAAC;gBACJ,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;gBACtB,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;gBAC3B,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,MAAkB,EAAwB,EAAE;oBACxE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;oBAClD,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;wBACnD,MAAM,UAAU,GAAG,CAAC,GAAU,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;wBAC9C,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAA;wBAC7C,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;6BAC5B,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAiC,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC;6BACpI,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;oBAC3F,CAAC,CAAC,CAAA;gBACH,CAAC,CAAA;gBACD,MAAM,EAAE,CAAC,IAAI,CAAC,CAAA;gBACd,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;gBAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,IAAI,CAAC;oBAAC,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;gBAC/C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;YACzC,CAAC;oBAAS,CAAC;gBACV,IAAI,CAAC;oBAAC,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YACpC,CAAC;QACF,CAAC,CAAA;QACD,IAAI,CAAC,SAAS;YAAE,OAAO,MAAM,EAAE,CAAA;QAC/B,IAAI,KAAgD,CAAA;QACpD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;YAC7D,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACvB,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;gBACjC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YACzC,CAAC,EAAE,SAAS,CAAC,CAAA;QACd,CAAC,CAAC,CAAA;QACF,IAAI,CAAC;YACJ,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAA;QACtD,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAA;QACpB,CAAC;IACF,CAAC;CACD","sourcesContent":["import { Client, type FieldDef } from 'pg'\nimport type { IDbAdapter, TDbCol, TDbParam, TDbStreamEvent, TDbTxCb, TDbTxResult } from '../types'\nimport type { TConnPg } from '../connection'\nimport type { TResult } from '../../tresult'\nimport { mapPlaceholders } from '../placeholders'\n\nfunction toSchema(fields: FieldDef[]): TDbCol[] {\n\treturn fields.map((f) => ({ name: f.name, kind: 'unknown' }))\n}\n\n// Converts :name placeholders to $1, $2, ... and collects values.\n// Same :name used multiple times maps to the same $N. A colon inside a string literal, a\n// quoted identifier or a comment is left as it is.\nfunction buildQuery(query: string, params: TDbParam[]): { text: string; values: unknown[] } {\n\tconst nameToIndex = new Map<string, number>()\n\tconst values: unknown[] = []\n\tconst text = mapPlaceholders(query, (name) => {\n\t\tif (!nameToIndex.has(name)) {\n\t\t\tconst found = params.find((p) => p.name === name)\n\t\t\tif (!found) throw new Error(`pg: param not found: ${name}`)\n\t\t\tvalues.push(found.value)\n\t\t\tnameToIndex.set(name, values.length)\n\t\t}\n\t\treturn `$${nameToIndex.get(name)}`\n\t})\n\treturn { text, values }\n}\n\nexport class PgAdapter implements IDbAdapter {\n\tconstructor(private readonly p: TConnPg) {}\n\n\tkind(): 'pg' { return 'pg' }\n\ttitle(): string { return `${this.p.host}:${this.p.port || 'DEFAULT'} [${this.p.database}]` }\n\tuser(): string { return this.p.user }\n\tversionQuery(): string { return 'SELECT version() AS ver' }\n\tpingQuery(): string { return 'SELECT 1 AS p' }\n\n\tprivate _clientConfig() {\n\t\treturn {\n\t\t\thost:     this.p.host,\n\t\t\tport:     this.p.port ?? 5432,\n\t\t\tdatabase: this.p.database,\n\t\t\tuser:     this.p.user,\n\t\t\tpassword: this.p.password,\n\t\t\tssl:      this.p.ssl ? { rejectUnauthorized: false } : undefined,\n\t\t\toptions:  '-c client_encoding=UTF8',\n\t\t}\n\t}\n\n\t// A backend does not notice its client is gone until it has something to send, so a\n\t// query cut off on our side would go on to its very end on the server. It is cancelled\n\t// from a connection of its own; a server that does not answer that either is given up\n\t// on after a while - this runs in the background and nobody waits for it.\n\tprivate _cancelBackend(pid: number): void {\n\t\tconst c = new Client({ ...this._clientConfig(), connectionTimeoutMillis: 30_000, query_timeout: 30_000 })\n\t\tc.on('error', () => {})\n\t\tvoid c.connect()\n\t\t\t.then(() => c.query('SELECT pg_cancel_backend($1)', [pid]))\n\t\t\t.catch(() => {})\n\t\t\t.finally(() => { void c.end().catch(() => {}) })\n\t}\n\n\tasync execStream(query: string, params: TDbParam[], callback: (event: TDbStreamEvent) => void, signal?: AbortSignal): Promise<void> {\n\t\tconst client = new Client(this._clientConfig())\n\t\t// The socket is destroyed rather than ended: a graceful end waits for a server\n\t\t// that may be the very thing that stopped answering. The query then fails, and the\n\t\t// client also emits \"error\" - with nobody listening that would be thrown.\n\t\tclient.on('error', () => {})\n\t\tconst onAbort = (): void => {\n\t\t\tconst internals = client as unknown as { processID?: number; connection?: { stream?: { destroy(): void } } }\n\t\t\tif (internals.processID) this._cancelBackend(internals.processID)\n\t\t\ttry { internals.connection?.stream?.destroy() } catch {}\n\t\t}\n\t\tsignal?.addEventListener('abort', onAbort)\n\t\ttry {\n\t\t\tawait client.connect()\n\t\t\tconst { text, values } = buildQuery(query, params)\n\t\t\tconst result = await client.query({ text, values })\n\t\t\tcallback({ kind: 'schema', schema: toSchema(result.fields) })\n\t\t\tfor (const row of result.rows) {\n\t\t\t\tcallback({ kind: 'row', row })\n\t\t\t}\n\t\t\tcallback({ kind: 'finish' })\n\t\t} catch (err) {\n\t\t\tcallback({ kind: 'finish', error: String(err) })\n\t\t} finally {\n\t\t\tsignal?.removeEventListener('abort', onAbort)\n\t\t\ttry { await client.end() } catch {}\n\t\t}\n\t}\n\n\tasync execTxDynamic(cb: TDbTxCb, timeoutMs?: number): Promise<TResult<void>> {\n\t\tconst client = new Client({\n\t\t\thost:     this.p.host,\n\t\t\tport:     this.p.port ?? 5432,\n\t\t\tdatabase: this.p.database,\n\t\t\tuser:     this.p.user,\n\t\t\tpassword: this.p.password,\n\t\t\tssl:      this.p.ssl ? { rejectUnauthorized: false } : undefined,\n\t\t\toptions:  '-c client_encoding=UTF8',\n\t\t})\n\t\tconst txWork = async (): Promise<TResult<void>> => {\n\t\t\ttry {\n\t\t\t\tawait client.connect()\n\t\t\t\tawait client.query('BEGIN')\n\t\t\t\tconst exec = (query: string, params: TDbParam[]): Promise<TDbTxResult> => {\n\t\t\t\t\tconst { text, values } = buildQuery(query, params)\n\t\t\t\t\treturn new Promise<TDbTxResult>((resolve, reject) => {\n\t\t\t\t\t\tconst onUncaught = (err: Error) => reject(err)\n\t\t\t\t\t\tprocess.once('uncaughtException', onUncaught)\n\t\t\t\t\t\tclient.query({ text, values })\n\t\t\t\t\t\t\t.then((res) => { process.removeListener('uncaughtException', onUncaught); resolve({ rows: res.rows as Record<string, unknown>[] }) })\n\t\t\t\t\t\t\t.catch((err) => { process.removeListener('uncaughtException', onUncaught); reject(err) })\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\tawait cb(exec)\n\t\t\t\tawait client.query('COMMIT')\n\t\t\t\treturn { ok: true, result: undefined }\n\t\t\t} catch (err) {\n\t\t\t\ttry { await client.query('ROLLBACK') } catch {}\n\t\t\t\treturn { ok: false, error: String(err) }\n\t\t\t} finally {\n\t\t\t\ttry { await client.end() } catch {}\n\t\t\t}\n\t\t}\n\t\tif (!timeoutMs) return txWork()\n\t\tlet timer: ReturnType<typeof setTimeout> | undefined\n\t\tconst timeoutPromise = new Promise<TResult<void>>((resolve) => {\n\t\t\ttimer = setTimeout(() => {\n\t\t\t\tvoid client.end().catch(() => {})\n\t\t\t\tresolve({ ok: false, error: 'TIMEOUT' })\n\t\t\t}, timeoutMs)\n\t\t})\n\t\ttry {\n\t\t\treturn await Promise.race([txWork(), timeoutPromise])\n\t\t} finally {\n\t\t\tclearTimeout(timer)\n\t\t}\n\t}\n}\n"]}

package/distjs/src/db/connection.d.ts

@@ -0,0 +1,49 @@
+export type TMssqlAuth = {
+    kind: 'mssql';
+    user: string;
+    password: string;
+} | {
+    kind: 'ntlm';
+    domain: string;
+    user: string;
+    password: string;
+};
+export type TConnMssql = {
+    kind: 'mssql';
+    server: string;
+    port?: number;
+    database?: string;
+    auth: TMssqlAuth;
+    trustServerCertificate?: boolean;
+    encrypt?: boolean;
+};
+export type TConnPg = {
+    kind: 'pg';
+    host: string;
+    port?: number;
+    database: string;
+    user: string;
+    password: string;
+    ssl?: boolean;
+};
+export type TOraPrivilege = 'SYSDBA' | 'SYSOPER' | 'SYSASM' | 'SYSBACKUP' | 'SYSDG' | 'SYSKM' | 'SYSRAC';
+export type TConnOra = {
+    kind: 'ora';
+    host: string;
+    port?: number;
+    service: string;
+    user: string;
+    password: string;
+    privilege?: TOraPrivilege;
+};
+export type TConnFb = {
+    kind: 'fb';
+    host: string;
+    port?: number;
+    database: string;
+    user: string;
+    password: string;
+    charset?: 'UTF8' | 'WIN1251';
+};
+export type TConnectionParam = TConnMssql | TConnOra | TConnPg | TConnFb;
+export type TDbKind = TConnectionParam['kind'];

package/distjs/src/db/connection.js

@@ -0,0 +1,5 @@
+// Connection settings for the supported databases. The package owns these types —
+// it does not depend on vv-config-conn, so a consumer passes the connection as a
+// plain object and its schema lives here.
+export {};
+//# sourceMappingURL=connection.js.map

package/distjs/src/db/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/db/connection.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,iFAAiF;AACjF,0CAA0C","sourcesContent":["// Connection settings for the supported databases. The package owns these types —\n// it does not depend on vv-config-conn, so a consumer passes the connection as a\n// plain object and its schema lives here.\n\nexport type TMssqlAuth =\n\t| { kind: 'mssql'; user: string; password: string }\n\t| { kind: 'ntlm'; domain: string; user: string; password: string }\n\nexport type TConnMssql = {\n\tkind: 'mssql'\n\tserver: string\n\tport?: number\n\tdatabase?: string\n\tauth: TMssqlAuth\n\ttrustServerCertificate?: boolean\n\tencrypt?: boolean\n}\n\nexport type TConnPg = {\n\tkind: 'pg'\n\thost: string\n\tport?: number\n\tdatabase: string\n\tuser: string\n\tpassword: string\n\tssl?: boolean\n}\n\nexport type TOraPrivilege = 'SYSDBA' | 'SYSOPER' | 'SYSASM' | 'SYSBACKUP' | 'SYSDG' | 'SYSKM' | 'SYSRAC'\n\nexport type TConnOra = {\n\tkind: 'ora'\n\thost: string\n\tport?: number\n\tservice: string\n\tuser: string\n\tpassword: string\n\tprivilege?: TOraPrivilege\n}\n\nexport type TConnFb = {\n\tkind: 'fb'\n\thost: string\n\tport?: number\n\tdatabase: string\n\tuser: string\n\tpassword: string\n\tcharset?: 'UTF8' | 'WIN1251'\n}\n\n// The discriminated union over all supported connections; its \"kind\" is the single\n// source for the list of databases this package talks to.\nexport type TConnectionParam = TConnMssql | TConnOra | TConnPg | TConnFb\nexport type TDbKind = TConnectionParam['kind']\n"]}

package/distjs/src/db/index.d.ts

@@ -0,0 +1,16 @@
+import type { TResult } from '../tresult.js';
+import type { TConnectionParam } from './connection.js';
+import type { TDbParam, TDbRes, TDbStreamEvent, TDbTxCb } from './types.js';
+export declare class DbConnection {
+    private _adapter;
+    constructor(connection: TConnectionParam);
+    exec(query: string, params: TDbParam[]): Promise<TResult<TDbRes[]>>;
+    execStream(query: string, params: TDbParam[], callback: (event: TDbStreamEvent) => void): Promise<void>;
+    version(): Promise<TResult<string>>;
+    kind(): 'pg' | 'mssql' | 'ora' | 'fb';
+    title(): string;
+    user(): string;
+    execTxDynamic(cb: TDbTxCb, timeoutMs?: number): Promise<TResult<void>>;
+    ping(): Promise<TResult<null>>;
+}
+export declare function createDbConnection(connection: TConnectionParam): DbConnection;