@venizia/ignis 0.0.10-4 → 0.1.0

package/dist/connectors/postgres/datasources/abstract.js

@@ -2,21 +2,76 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractRelationalDataSource = void 0;
 const datasources_1 = require("../../../base/datasources");
-// Deep import (not the repositories barrel): FilterBuilder -> repositories/common -> datasources
-// barrel closes a module cycle. Instantiated lazily below, never in a static initializer, so the
-// class body references no half-initialized binding at load time.
+const drivers_1 = require("../../../connectors/postgres/drivers");
 const filter_1 = require("../../../connectors/postgres/repositories/dialect/filter");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
 /** SQL branch root: connector, pool, transactions. */
 class AbstractRelationalDataSource extends datasources_1.AbstractDataSource {
+    /**
+     * Adopts a pool-only datasource (no `this.driver` set) into whichever driver matches its client,
+     * once. No warning is logged: the adoption is exact, and a boot-time warning on every legacy
+     * datasource would be noise, not information.
+     *
+     * Async because the concrete driver is imported on demand - see `resolveDatabaseDriver`. The
+     * in-flight promise is cached, not just its result, so concurrent `beginTransaction()` calls
+     * share one driver over one pool instead of each constructing their own.
+     */
+    async resolveDriver() {
+        if (this.driver) {
+            return this.driver;
+        }
+        if (!this.client) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}][resolveDriver] No driver and no client | Assign this.driver in configure()`,
+            });
+        }
+        this.driverResolution ??= (0, drivers_1.resolveDatabaseDriver)({ client: this.client });
+        try {
+            this.driver = await this.driverResolution;
+        }
+        catch (error) {
+            // A rejected resolution must not stay cached: the failure can be transient (module load,
+            // classification against a not-yet-ready client), and a poisoned cache would fail every
+            // later transaction with this stale error forever.
+            this.driverResolution = undefined;
+            this.logger
+                .for(this.resolveDriver.name)
+                .error('Driver resolution failed - will retry on the next call | Error: %s', error);
+            throw error;
+        }
+        return this.driver;
+    }
+    /**
+     * Wires a driver in one step: assigns `this.driver` AND builds `this.connector` from it. The
+     * two-step form (driver set, connector forgotten) yields a datasource whose pooled queries
+     * silently bypass the driver - this helper makes that state unrepresentable. `schema` defaults to
+     * `getSchema()`; pass it explicitly when configure() computes the schema locally.
+     */
+    useDriver(opts) {
+        this.driver = opts.driver;
+        this.connector = opts.driver.createConnector({ schema: opts.schema ?? this.getSchema() });
+    }
     getConnector() {
         return this.connector;
     }
-    /** The relational query dialect (FilterBuilder), obtained by repositories via the datasource -
-     * mirrors the search branch's `getQueryDialect()`. Returns the shared singleton. */
-    getQueryDialect() {
-        if (!AbstractRelationalDataSource.queryDialect) {
-            AbstractRelationalDataSource.queryDialect = new filter_1.FilterBuilder();
+    /**
+     * The raw driver client: `pg.Pool` for node-postgres, `Sql` for postgres-js. Stays synchronous by
+     * reading the configured client directly when no driver has been resolved yet - for a bare client
+     * there is nothing to await. Throws rather than handing back an `undefined` typed as `Client`.
+     */
+    getClient() {
+        if (this.driver) {
+            return this.driver.getClient();
+        }
+        if (!this.client) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}][getClient] No driver and no client | Assign this.driver in configure()`,
+            });
         }
+        return this.client;
+    }
+    getQueryDialect() {
+        AbstractRelationalDataSource.queryDialect ??= new filter_1.FilterBuilder();
         return AbstractRelationalDataSource.queryDialect;
     }
 }

package/dist/connectors/postgres/datasources/abstract.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/abstract.ts"],"names":[],"mappings":";;;AAEA,oDAA8E;AAC9E,iGAAiG;AACjG,iGAAiG;AACjG,kEAAkE;AAClE,8EAAkF;AASlF,sDAAsD;AACtD,MAAsB,4BAKpB,SAAQ,gCAAyD;IAkBjE,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;wFACoF;IACpF,eAAe;QACb,IAAI,CAAC,4BAA4B,CAAC,YAAY,EAAE,CAAC;YAC/C,4BAA4B,CAAC,YAAY,GAAG,IAAI,sBAAa,EAAE,CAAC;QAClE,CAAC;QAED,OAAO,4BAA4B,CAAC,YAAY,CAAC;IACnD,CAAC;CACF;AApCD,oEAoCC"}
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/abstract.ts"],"names":[],"mappings":";;;AACA,oDAAwD;AAExD,2DAAsE;AAEtE,8EAAkF;AAElF,0DAAkD;AASlD,sDAAsD;AACtD,MAAsB,4BAMpB,SAAQ,gCAAyD;IAkBjE;;;;;;;;OAQG;IACO,KAAK,CAAC,aAAa;QAC3B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,8EAA8E;aACjH,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,gBAAgB,KAAK,IAAA,+BAAqB,EAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAEjF,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yFAAyF;YACzF,wFAAwF;YACxF,mDAAmD;YACnD,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAClC,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;iBAC5B,KAAK,CAAC,oEAAoE,EAAE,KAAK,CAAC,CAAC;YACtF,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACO,SAAS,CAAC,IAA4D;QAC9E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;IAOD,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAY,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,0EAA0E;aAC7G,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,eAAe;QACb,4BAA4B,CAAC,YAAY,KAAK,IAAI,sBAAa,EAAE,CAAC;QAElE,OAAO,4BAA4B,CAAC,YAAY,CAAC;IACnD,CAAC;CACF;AA1GD,oEA0GC"}

package/dist/connectors/postgres/datasources/base.d.ts

@@ -1,8 +1,9 @@
-import { TAnyDataSourceSchema } from '../../../base/datasources';
+import type { TAnyDataSourceSchema } from '../../../base/datasources';
+import type { Pool } from 'pg';
 import { AbstractRelationalDataSource } from './abstract';
-import { IDatabaseTransaction, IDatabaseTransactionOptions } from './common';
+import type { IDatabaseTransaction, IDatabaseTransactionOptions } from './common';
 /** Base DataSource with schema auto-discovery from registered repositories. */
-export declare abstract class BaseRelationalDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}> extends AbstractRelationalDataSource<Settings, Schema, ConfigurableOptions> {
+export declare abstract class BaseRelationalDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = Pool> extends AbstractRelationalDataSource<Settings, Schema, ConfigurableOptions, Client> {
     constructor(opts: {
         name: string;
         config: Settings;

package/dist/connectors/postgres/datasources/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/base.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAG5B,MAAM,UAAU,CAAC;AAElB,+EAA+E;AAC/E,8BAAsB,wBAAwB,CAC5C,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC;gBAC/D,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAWrE,wEAAwE;IAC/D,SAAS,IAAI,MAAM;IAO5B,SAAS,CAAC,cAAc,IAAI,MAAM;IA4BlC,qBAAqB,IAAI,OAAO;IAKvB,eAAe;;;IAIT,gBAAgB,CAC7B,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;CAoDzC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/base.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,2BAA2B,EAAmB,MAAM,UAAU,CAAC;AAGnG,+EAA+E;AAC/E,8BAAsB,wBAAwB,CAC5C,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,IAAI,CACb,SAAQ,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC;gBACvE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAWrE,wEAAwE;IAC/D,SAAS,IAAI,MAAM;IAO5B,SAAS,CAAC,cAAc,IAAI,MAAM;IA4BlC,qBAAqB,IAAI,OAAO;IAKvB,eAAe;;;IAIT,gBAAgB,CAC7B,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;CA6EzC"}

package/dist/connectors/postgres/datasources/base.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseRelationalDataSource = void 0;
 const inversion_1 = require("../../../helpers/inversion");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const node_postgres_1 = require("drizzle-orm/node-postgres");
 const abstract_1 = require("./abstract");
 const common_1 = require("./common");
 /** Base DataSource with schema auto-discovery from registered repositories. */
@@ -49,51 +48,70 @@ class BaseRelationalDataSource extends abstract_1.AbstractRelationalDataSource {
         return { transactions: true };
     }
     async beginTransaction(opts) {
-        if (!this.pool) {
-            throw (0, ignis_helpers_1.getError)({
-                message: `[${this.constructor.name}][beginTransaction] Pool not initialized. Set this.pool in configure().`,
+        const driver = await this.resolveDriver();
+        const connection = await driver.acquire({ schema: this.getSchema() });
+        const isolationLevel = opts?.isolationLevel ?? common_1.IsolationLevels.READ_COMMITTED;
+        // `isolationLevel` comes from the IsolationLevels const-class, never from user input. It must be
+        // interpolated: `BEGIN TRANSACTION ISOLATION LEVEL $1` is not valid SQL, and postgres-js tagged
+        // templates would bind it as a query parameter.
+        try {
+            await connection.execute({
+                statement: `BEGIN TRANSACTION ISOLATION LEVEL ${isolationLevel}`,
             });
         }
-        const client = await this.pool.connect();
-        const isolationLevel = opts?.isolationLevel ?? common_1.IsolationLevels.READ_COMMITTED;
-        await client.query(`BEGIN TRANSACTION ISOLATION LEVEL ${isolationLevel}`);
+        catch (error) {
+            this.logger.for('beginTransaction').error('Failed to BEGIN transaction | Error: %s', error);
+            // The connection was checked out but no caller ever receives a handle to release it - leaking
+            // here exhausts the pool under repeated BEGIN failures. Destroyed rather than pooled: the
+            // session state after a failed BEGIN is unknown.
+            connection.release({ destroy: true });
+            throw error;
+        }
         let isActive = true;
+        let isEndedByFailure = false;
+        /**
+         * Ends the transaction with `statement`. On failure the connection is discarded rather than
+         * pooled - the session may still hold an open transaction that the next borrower would inherit
+         * - and the error is rethrown, because a caller must never believe a failed COMMIT succeeded.
+         */
+        const finish = async (finishOpts) => {
+            const { statement, verb } = finishOpts;
+            if (!isActive) {
+                // The canonical caller pattern is `catch { await tx.rollback(); throw error; }`. After a
+                // FAILED commit/rollback the transaction is already torn down - nothing committed, the
+                // connection destroyed - so a rollback request is satisfied by construction. Throwing
+                // 'already ended' here would replace the caller's original error in every such catch block.
+                if (isEndedByFailure && verb === 'rollback') {
+                    this.logger
+                        .for(verb)
+                        .debug('Rollback after a failure-ended transaction - no-op, already torn down');
+                    return;
+                }
+                throw (0, ignis_helpers_1.getError)({ message: `[Transaction][${verb}] Transaction already ended` });
+            }
+            // Flipped BEFORE the await, not after: two concurrent finish() calls (commit racing rollback)
+            // would otherwise both pass the guard, issue two control statements, and double-release the
+            // same physical connection.
+            isActive = false;
+            try {
+                await connection.execute({ statement });
+            }
+            catch (error) {
+                this.logger.for(verb).error('Failed to %s transaction | Error: %s', statement, error);
+                isEndedByFailure = true;
+                connection.release({ destroy: true });
+                throw error;
+            }
+            connection.release();
+        };
         return {
             isolationLevel,
-            connector: (0, node_postgres_1.drizzle)({ client, schema: this.schema }),
+            connector: connection.connector,
             get isActive() {
                 return isActive;
             },
-            commit: async () => {
-                if (!isActive) {
-                    throw (0, ignis_helpers_1.getError)({ message: '[Transaction][commit] Transaction already ended' });
-                }
-                try {
-                    await client.query('COMMIT');
-                }
-                catch (error) {
-                    this.logger.for('commit').error('Failed to COMMIT transaction | Error: %s', error);
-                }
-                finally {
-                    isActive = false;
-                    client.release();
-                }
-            },
-            rollback: async () => {
-                if (!isActive) {
-                    throw (0, ignis_helpers_1.getError)({ message: '[Transaction][rollback] Transaction already ended' });
-                }
-                try {
-                    await client.query('ROLLBACK');
-                }
-                catch (error) {
-                    this.logger.for('rollback').error('Failed to ROLLBACK transaction | Error: %s', error);
-                }
-                finally {
-                    isActive = false;
-                    client.release();
-                }
-            },
+            commit: () => finish({ statement: 'COMMIT', verb: 'commit' }),
+            rollback: () => finish({ statement: 'ROLLBACK', verb: 'rollback' }),
         };
     }
 }

package/dist/connectors/postgres/datasources/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/base.ts"],"names":[],"mappings":"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"}

package/dist/connectors/postgres/datasources/common/guards.d.ts

@@ -1,5 +1,5 @@
-import { ITransaction } from '../../../../base/datasources';
-import { IDatabaseTransaction } from './types';
+import type { ITransaction } from '../../../../base/datasources';
+import type { IDatabaseTransaction } from './types';
 /** Narrows the neutral `ITransaction` to the postgres-flavored `IDatabaseTransaction` handle before accessing `.connector`. */
 export declare const isDatabaseTransaction: (transaction: ITransaction | undefined) => transaction is IDatabaseTransaction;
 //# sourceMappingURL=guards.d.ts.map

package/dist/connectors/postgres/datasources/common/guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/postgres/datasources/common/guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,+HAA+H;AAC/H,eAAO,MAAM,qBAAqB,GAChC,aAAa,YAAY,GAAG,SAAS,KACpC,WAAW,IAAI,oBAEjB,CAAC"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/postgres/datasources/common/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,+HAA+H;AAC/H,eAAO,MAAM,qBAAqB,GAChC,aAAa,YAAY,GAAG,SAAS,KACpC,WAAW,IAAI,oBAEjB,CAAC"}

package/dist/connectors/postgres/datasources/common/types.d.ts

@@ -1,13 +1,21 @@
-import { AbstractDataSource, ITransaction, ITransactionOptions, TAnyDataSourceSchema } from '../../../../base/datasources';
-import { TConstValue, ValueOrPromise } from '@venizia/ignis-helpers';
-import { NodePgClient, type drizzle as nodePostgresConnector } from 'drizzle-orm/node-postgres';
-import type { PoolClient } from 'pg';
+import type { AbstractDataSource, ITransaction, ITransactionOptions, TAnyDataSourceSchema } from '../../../../base/datasources';
 import type { IRelationalQueryDialect } from '../../../../connectors/postgres/repositories/common';
+import type { TConstValue, ValueOrPromise } from '@venizia/ignis-helpers';
+import type { NodePgClient } from 'drizzle-orm/node-postgres';
+import { type drizzle as nodePostgresConnector } from 'drizzle-orm/node-postgres';
+import type { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
+import type { Pool, PoolClient } from 'pg';
+/**
+ * Drizzle connector for ANY Postgres driver. `NodePgDatabase` and `PostgresJsDatabase` both extend
+ * `PgDatabase<TQueryResult, TFullSchema>`, differing only in the query-result HKT, so this is the
+ * real shared base - not a cast. It is what lets `beginTransaction()` hold no driver-specific code.
+ */
+export type TRelationalConnector<DataSourceSchema extends TAnyDataSourceSchema = TAnyDataSourceSchema> = PgDatabase<PgQueryResultHKT, DataSourceSchema>;
+/** @deprecated Compat alias. Prefer `TRelationalConnector`, which every Drizzle pg driver satisfies. */
 export type TNodePostgresConnector<DataSourceSchema extends TAnyDataSourceSchema = TAnyDataSourceSchema, Client extends NodePgClient = NodePgClient> = ReturnType<typeof nodePostgresConnector<DataSourceSchema, Client>>;
-/** Uses PoolClient specifically for transaction isolation. */
+/** @deprecated Compat alias. Uses PoolClient specifically for transaction isolation. */
 export type TNodePostgresTransactionConnector<DataSourceSchema extends TAnyDataSourceSchema = TAnyDataSourceSchema> = ReturnType<typeof nodePostgresConnector<DataSourceSchema, PoolClient>>;
-export type TAnyConnector<DataSourceSchema extends TAnyDataSourceSchema = TAnyDataSourceSchema> = TNodePostgresConnector<DataSourceSchema> | TNodePostgresTransactionConnector<DataSourceSchema>;
-/** PostgreSQL transaction isolation levels. */
+export type TAnyConnector<DataSourceSchema extends TAnyDataSourceSchema = TAnyDataSourceSchema> = TRelationalConnector<DataSourceSchema>;
 export declare class IsolationLevels {
     static readonly READ_COMMITTED = "READ COMMITTED";
     static readonly REPEATABLE_READ = "REPEATABLE READ";
@@ -22,17 +30,31 @@ export interface IDatabaseTransactionOptions extends ITransactionOptions {
     isolationLevel?: TIsolationLevel;
 }
 export interface IDatabaseTransaction<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> extends ITransaction {
-    connector: TNodePostgresTransactionConnector<Schema>;
+    /** Bound to the transaction's own connection, whichever driver acquired it. */
+    connector: TRelationalConnector<Schema>;
     isolationLevel: TIsolationLevel;
+    /**
+     * Throws if COMMIT fails, per {@link ITransaction.commit}. On failure the connection is discarded
+     * rather than pooled, where the driver supports it: node-postgres destroys it via
+     * `release(error)`; postgres-js has no destroy semantics, so a poisoned connection returns to its
+     * pool.
+     */
     commit(): Promise<void>;
+    /**
+     * Throws if ROLLBACK fails, with the same connection-discard caveat as {@link commit} - but is a
+     * silent no-op after the transaction already ended BY FAILURE, per {@link ITransaction.rollback}.
+     * That keeps `catch (error) { await transaction.rollback(); throw error; }` safe.
+     */
     rollback(): Promise<void>;
 }
 /** SQL-branch contract: connection string, Drizzle connector, transactions. Extends
  * `AbstractDataSource` itself (not just `IDataSource`) so repositories can narrow safely. */
-export interface IPostgresDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {
-    connector: TNodePostgresConnector<Schema>;
+export interface IPostgresDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = Pool> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {
+    connector: TRelationalConnector<Schema>;
     getConnectionString(): ValueOrPromise<string>;
-    getConnector(): TNodePostgresConnector<Schema>;
+    getConnector(): TRelationalConnector<Schema>;
+    /** Raw driver client escape: `pg.Pool` today, postgres-js `Sql` once a driver supplies it. */
+    getClient(): Client;
     getQueryDialect(): IRelationalQueryDialect;
     beginTransaction(opts?: IDatabaseTransactionOptions): Promise<IDatabaseTransaction<Schema>>;
 }

package/dist/connectors/postgres/datasources/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/postgres/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,KAAK,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEzF,MAAM,MAAM,sBAAsB,CAChC,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,EACpE,MAAM,SAAS,YAAY,GAAG,YAAY,IACxC,UAAU,CAAC,OAAO,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE,8DAA8D;AAC9D,MAAM,MAAM,iCAAiC,CAC3C,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,IAClE,UAAU,CAAC,OAAO,qBAAqB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC;AAE3E,MAAM,MAAM,aAAa,CAAC,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,IAC1F,sBAAsB,CAAC,gBAAgB,CAAC,GACxC,iCAAiC,CAAC,gBAAgB,CAAC,CAAC;AAExD,+CAA+C;AAC/C,qBAAa,eAAe;IAC1B,MAAM,CAAC,QAAQ,CAAC,cAAc,oBAAoB;IAClD,MAAM,CAAC,QAAQ,CAAC,eAAe,qBAAqB;IACpD,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAkB;IAE9C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAIvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC;AAElE;wCACwC;AACxC,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB,CACnC,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,CAC1D,SAAQ,YAAY;IACpB,SAAS,EAAE,iCAAiC,CAAC,MAAM,CAAC,CAAC;IACrD,cAAc,EAAE,eAAe,CAAC;IAEhC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;6FAC6F;AAC7F,MAAM,WAAW,mBAAmB,CAClC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC;IACjE,SAAS,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE1C,mBAAmB,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9C,YAAY,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/C,eAAe,IAAI,uBAAuB,CAAC;IAC3C,gBAAgB,CAAC,IAAI,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;CAC7F"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/postgres/datasources/common/types.ts"],"names":[],"mappings":"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"}

package/dist/connectors/postgres/datasources/common/types.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IsolationLevels = void 0;
-/** PostgreSQL transaction isolation levels. */
 class IsolationLevels {
     static { this.READ_COMMITTED = 'READ COMMITTED'; }
     static { this.REPEATABLE_READ = 'REPEATABLE READ'; }

package/dist/connectors/postgres/datasources/common/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/connectors/postgres/datasources/common/types.ts"],"names":[],"mappings":";;;AAyBA,+CAA+C;AAC/C,MAAa,eAAe;aACV,mBAAc,GAAG,gBAAgB,CAAC;aAClC,oBAAe,GAAG,iBAAiB,CAAC;aACpC,iBAAY,GAAG,cAAc,CAAC;aAE9B,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,eAAe;QACpB,IAAI,CAAC,YAAY;KAClB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAbH,0CAcC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/connectors/postgres/datasources/common/types.ts"],"names":[],"mappings":";;;AAoCA,MAAa,eAAe;aACV,mBAAc,GAAG,gBAAgB,CAAC;aAClC,oBAAe,GAAG,iBAAiB,CAAC;aACpC,iBAAY,GAAG,cAAc,CAAC;aAE9B,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,eAAe;QACpB,IAAI,CAAC,YAAY;KAClB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAbH,0CAcC"}

package/dist/connectors/postgres/drivers/driver.d.ts

@@ -0,0 +1,55 @@
+import type { TAnyDataSourceSchema } from '../../../base/datasources';
+import type { TRelationalConnector } from '../../../connectors/postgres/datasources/common';
+/**
+ * The neutral result of a raw statement. The drivers disagree on their native shape (pg returns
+ * `{ rows, rowCount }`; postgres-js returns an array carrying `count`), so each driver maps its own
+ * shape to this one at the boundary - the one place that knows it statically. Callers never see a
+ * driver-specific result and never sniff shapes at runtime.
+ */
+export interface IStatementResult {
+    /**
+     * Rows affected by the statement - the same `count` the repository verbs return. `0` for control
+     * statements (BEGIN / COMMIT / SET LOCAL).
+     */
+    count: number;
+}
+/** One dedicated physical connection, held for the lifetime of a single explicit transaction. */
+export interface IRelationalConnection<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> {
+    /** Drizzle bound to THIS connection, not to the pool. */
+    connector: TRelationalConnector<Schema>;
+    /**
+     * Runs a control statement verbatim: BEGIN / COMMIT / ROLLBACK / SET LOCAL. The statement is built
+     * by the caller and never parameterized - `BEGIN TRANSACTION ISOLATION LEVEL $1` is not valid SQL.
+     * Use `connector` for anything that returns rows.
+     */
+    execute(opts: {
+        statement: string;
+    }): Promise<IStatementResult>;
+    /**
+     * Returns the connection. `destroy` discards it instead of pooling it - required after a failed
+     * COMMIT or ROLLBACK, when the session may still hold an open transaction that the next borrower
+     * would inherit. A driver that cannot destroy must say so in its own docs rather than pretend.
+     */
+    release(opts?: {
+        destroy?: boolean;
+    }): void;
+}
+/**
+ * Owns connection acquisition and the raw control statements - the only two places `connectors/
+ * postgres/` was hard-wired to `pg`. `configure()` stays app-written: connection config varies per
+ * deployment, and the framework never builds the driver for you.
+ */
+export interface IRelationalDriver<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, Client = unknown> {
+    /** Pooled connector - what `configure()` assigns to `this.connector`. */
+    createConnector(opts: {
+        schema: Schema;
+    }): TRelationalConnector<Schema>;
+    /** Checks out a dedicated connection for an explicit transaction. */
+    acquire(opts: {
+        schema: Schema;
+    }): Promise<IRelationalConnection<Schema>>;
+    /** Raw client escape: `pg.Pool` for node-postgres, `Sql` for postgres-js. */
+    getClient(): Client;
+    end(): Promise<void>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/connectors/postgres/drivers/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/drivers/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAErF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iGAAiG;AACjG,MAAM,WAAW,qBAAqB,CAAC,MAAM,SAAS,oBAAoB,GAAG,oBAAoB;IAC/F,yDAAyD;IACzD,SAAS,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAExC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhE;;;;OAIG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAChC,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,MAAM,GAAG,OAAO;IAEhB,yEAAyE;IACzE,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAExE,qEAAqE;IACrE,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1E,6EAA6E;IAC7E,SAAS,IAAI,MAAM,CAAC;IAEpB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB"}

package/dist/connectors/postgres/drivers/driver.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=driver.js.map

package/dist/connectors/postgres/drivers/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/drivers/driver.ts"],"names":[],"mappings":""}

package/dist/connectors/postgres/drivers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './driver';
+export * from './resolve';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/postgres/drivers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/drivers/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/connectors/postgres/drivers/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./driver"), exports);
+__exportStar(require("./resolve"), exports);
+//# sourceMappingURL=index.js.map

package/dist/connectors/postgres/drivers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/drivers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B"}

package/dist/connectors/postgres/drivers/node-postgres.d.ts

@@ -0,0 +1,24 @@
+import type { TAnyDataSourceSchema } from '../../../base/datasources';
+import type { TRelationalConnector } from '../../../connectors/postgres/datasources/common';
+import type { Pool } from 'pg';
+import type { IRelationalConnection, IRelationalDriver } from './driver';
+/**
+ * `pool` is supplied by the app's `configure()`, because Postgres connection config (credentials,
+ * SSL, secrets manager, env) varies per deployment.
+ */
+export declare class NodePostgresDriver<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> implements IRelationalDriver<Schema, Pool> {
+    private readonly pool;
+    constructor(opts: {
+        pool: Pool;
+    });
+    createConnector(opts: {
+        schema: Schema;
+    }): TRelationalConnector<Schema>;
+    /** A dedicated `PoolClient`, so BEGIN and COMMIT land on the same backend. */
+    acquire(opts: {
+        schema: Schema;
+    }): Promise<IRelationalConnection<Schema>>;
+    getClient(): Pool;
+    end(): Promise<void>;
+}
+//# sourceMappingURL=node-postgres.d.ts.map

package/dist/connectors/postgres/drivers/node-postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-postgres.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/drivers/node-postgres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAGrF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEzE;;;GAGG;AACH,qBAAa,kBAAkB,CAC7B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,CAC1D,YAAW,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;gBAEhB,IAAI,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE;IAIhC,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAIvE,8EAA8E;IACxE,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IA2C/E,SAAS,IAAI,IAAI;IAIjB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrB"}

package/dist/connectors/postgres/drivers/node-postgres.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodePostgresDriver = void 0;
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const node_postgres_1 = require("drizzle-orm/node-postgres");
+/**
+ * `pool` is supplied by the app's `configure()`, because Postgres connection config (credentials,
+ * SSL, secrets manager, env) varies per deployment.
+ */
+class NodePostgresDriver {
+    constructor(opts) {
+        this.pool = opts.pool;
+    }
+    createConnector(opts) {
+        return (0, node_postgres_1.drizzle)({ client: this.pool, schema: opts.schema });
+    }
+    /** A dedicated `PoolClient`, so BEGIN and COMMIT land on the same backend. */
+    async acquire(opts) {
+        const client = await this.pool.connect();
+        // A bare `pg.Client` also has `connect()`, but it resolves to nothing - it IS the connection,
+        // not a pool. Named here, at the misconfiguration, instead of as a null-deref inside drizzle.
+        if (!client) {
+            throw (0, ignis_helpers_1.getError)({
+                message: '[NodePostgresDriver][acquire] pool.connect() returned no client | A pg Pool is required - a bare pg.Client is not a pool',
+            });
+        }
+        // The connection is already checked OUT of the pool. Anything that throws between here and the
+        // caller's `release()` - a malformed discovered schema, a drizzle mismatch - would strand it,
+        // and every later beginTransaction() would strand another until the pool is exhausted.
+        let connector;
+        try {
+            connector = (0, node_postgres_1.drizzle)({ client, schema: opts.schema });
+        }
+        catch (error) {
+            client.release();
+            throw error;
+        }
+        return {
+            connector,
+            // pg's native shape is `{ rows, rowCount }`; `rowCount` is null for statements that affect no
+            // rows by definition (e.g. DDL). Mapped to the neutral result HERE, where the shape is known
+            // statically - callers never see a pg type.
+            execute: async (executeOpts) => {
+                const result = await client.query(executeOpts.statement);
+                return { count: result.rowCount ?? 0 };
+            },
+            // pg destroys the connection when `release()` receives a truthy argument, rather than handing
+            // it back to the pool. That is what a failed COMMIT or ROLLBACK needs: the session may still
+            // hold an open transaction, and the next borrower would inherit it.
+            release: (releaseOpts) => {
+                client.release(releaseOpts?.destroy === true);
+            },
+        };
+    }
+    getClient() {
+        return this.pool;
+    }
+    end() {
+        return this.pool.end();
+    }
+}
+exports.NodePostgresDriver = NodePostgresDriver;
+//# sourceMappingURL=node-postgres.js.map

package/dist/connectors/postgres/drivers/node-postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-postgres.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/drivers/node-postgres.ts"],"names":[],"mappings":";;;AAEA,0DAAkD;AAClD,6DAAoD;AAIpD;;;GAGG;AACH,MAAa,kBAAkB;IAK7B,YAAY,IAAoB;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,eAAe,CAAC,IAAwB;QACtC,OAAO,IAAA,uBAAO,EAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAiC,CAAC;IAC7F,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,OAAO,CAAC,IAAwB;QACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAEzC,8FAA8F;QAC9F,8FAA8F;QAC9F,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EACL,0HAA0H;aAC7H,CAAC,CAAC;QACL,CAAC;QAED,+FAA+F;QAC/F,8FAA8F;QAC9F,uFAAuF;QACvF,IAAI,SAAuC,CAAC;QAC5C,IAAI,CAAC;YACH,SAAS,GAAG,IAAA,uBAAO,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAiC,CAAC;QACvF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO;YACL,SAAS;YAET,8FAA8F;YAC9F,6FAA6F;YAC7F,4CAA4C;YAC5C,OAAO,EAAE,KAAK,EAAE,WAAkC,EAAE,EAAE;gBACpD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBACzD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACzC,CAAC;YAED,8FAA8F;YAC9F,6FAA6F;YAC7F,oEAAoE;YACpE,OAAO,EAAE,CAAC,WAAmC,EAAE,EAAE;gBAC/C,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC;YAChD,CAAC;SACF,CAAC;IACJ,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,CAAC;CACF;AAhED,gDAgEC"}

package/dist/connectors/postgres/drivers/postgres-js.d.ts

@@ -0,0 +1,25 @@
+import type { TAnyDataSourceSchema } from '../../../base/datasources';
+import type { TRelationalConnector } from '../../../connectors/postgres/datasources/common';
+import type { Sql } from 'postgres';
+import type { IRelationalConnection, IRelationalDriver } from './driver';
+/**
+ * The postgres-js driver. `client` is supplied by the app's `configure()`, exactly as `pool` is for
+ * node-postgres. Requires `postgres >= 3.4.0`: that is the release that added `sql.reserve()`, and
+ * without a reserved connection a transaction's BEGIN and COMMIT could land on different backends.
+ */
+export declare class PostgresJsDriver<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> implements IRelationalDriver<Schema, Sql> {
+    private readonly client;
+    constructor(opts: {
+        client: Sql;
+    });
+    createConnector(opts: {
+        schema: Schema;
+    }): TRelationalConnector<Schema>;
+    /** A dedicated `ReservedSql`, so BEGIN and COMMIT land on the same backend. */
+    acquire(opts: {
+        schema: Schema;
+    }): Promise<IRelationalConnection<Schema>>;
+    getClient(): Sql;
+    end(): Promise<void>;
+}
+//# sourceMappingURL=postgres-js.d.ts.map

package/dist/connectors/postgres/drivers/postgres-js.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-js.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/drivers/postgres-js.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAGrF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEzE;;;;GAIG;AACH,qBAAa,gBAAgB,CAC3B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,CAC1D,YAAW,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAM;gBAEjB,IAAI,EAAE;QAAE,MAAM,EAAE,GAAG,CAAA;KAAE;IAIjC,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAIvE,+EAA+E;IACzE,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IA6C/E,SAAS,IAAI,GAAG;IAIhB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrB"}