@venizia/ignis 0.1.1-8 → 0.1.1

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

@@ -1,148 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractRelationalDataSource = void 0;
-const datasources_1 = require("../../../base/datasources");
-const filter_1 = require("../../../connectors/postgres/repositories/dialect/filter");
-const inversion_1 = require("../../../helpers/inversion");
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-/** SQL branch root: connector, pool, transactions. */
-class AbstractRelationalDataSource extends datasources_1.AbstractDataSource {
-    /**
-     * Builds the driver class named by `@datasource({ driver })` over the client `configure()`
-     * assigned, then wires the connector from it. Idempotent and lazy.
-     */
-    wireDriverFromMetadata() {
-        if (this.connector) {
-            return;
-        }
-        if (this.driver) {
-            this.connector = this.driver.createConnector({ schema: this.getSchema() });
-            return;
-        }
-        if (!this.client) {
-            throw (0, ignis_helpers_1.getError)({
-                message: `[${this.constructor.name}][wireDriverFromMetadata] No driver and no client | Assign this.client in configure(), or wire a custom driver with useDriver()`,
-            });
-        }
-        const DriverClass = this.resolveDriverClass();
-        this.useDriver({ driver: new DriverClass({ client: this.client }) });
-    }
-    /** Reads the driver CLASS named by `@datasource({ driver })`. Rejects a driver-name string
-     * (untyped JS callers) - a string carries no module into the bundle. */
-    resolveDriverClass() {
-        const metadata = inversion_1.MetadataRegistry.getInstance().getDataSourceMetadata({
-            target: this.constructor,
-        });
-        const driver = metadata?.driver;
-        if (typeof driver !== 'function') {
-            throw (0, ignis_helpers_1.getError)({
-                message: `[${this.constructor.name}][resolveDriverClass] @datasource({ driver }) must name a driver CLASS | Got: ${String(driver)} | Use \`@datasource({ driver: NodePostgresDriver })\` with \`import { NodePostgresDriver } from '@venizia/ignis/postgres/node-postgres'\`, or wire a custom driver with useDriver()`,
-            });
-        }
-        return driver;
-    }
-    resolveDriver() {
-        this.wireDriverFromMetadata();
-        return this.driver;
-    }
-    /** Assigns `this.driver` AND builds `this.connector` in one step - a driver without its connector
-     * would silently bypass the driver on pooled queries. `schema` defaults to `getSchema()`. */
-    useDriver(opts) {
-        this.driver = opts.driver;
-        this.connector = opts.driver.createConnector({ schema: opts.schema ?? this.getSchema() });
-    }
-    /** Wires the driver on first use, so a `configure()` that only builds `this.client` is enough. */
-    getConnector() {
-        this.wireDriverFromMetadata();
-        return this.connector;
-    }
-    /** Raw driver client (`pg.Pool` / `Sql`). Reads the configured client directly when no driver is
-     * resolved yet; 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;
-    }
+exports.AbstractPostgresDataSource = void 0;
+const query_dialect_1 = require("../../../connectors/postgres/repositories/dialect/query-dialect");
+const executor_1 = require("../../../connectors/postgres/repositories/executor");
+const datasources_1 = require("../../../connectors/relational/datasources");
+/**
+ * Postgres branch root: supplies the Postgres dialect and executor on top of the engine-neutral
+ * `BaseRelationalDataSource`. The BEGIN statement stays abstract - `BasePostgresDataSource`
+ * supplies it.
+ */
+class AbstractPostgresDataSource extends datasources_1.BaseRelationalDataSource {
     getQueryDialect() {
-        AbstractRelationalDataSource.queryDialect ??= new filter_1.FilterBuilder();
-        return AbstractRelationalDataSource.queryDialect;
-    }
-    /** Soft-evicts the pool after a secret rotation: builds pool + driver + connector against the
-     * rotated credentials without touching live fields, swaps atomically, then drains the old pool.
-     * On failure the live state is restored, any half-built pool drained, and the error rethrown. */
-    async onSecretRotated(opts) {
-        const logger = this.logger.for(this.onSecretRotated.name);
-        const oldClient = this.getClient();
-        // Snapshot so a failed rebuild restores the datasource verbatim. `settings` is copied because
-        // rotation mutates it in place; the live client stays untouched, keeping the old pool serving.
-        const savedClient = this.client;
-        const savedSettings = { ...this.settings };
-        // Rotation takes effect only through this.settings + configure(); a configure() that builds its
-        // pool from a hard-coded connection string or reads Envs directly rebuilds with stale credentials.
-        Object.assign(this.settings, this.mapSecretToSettings({ secret: opts.secret }));
-        // configure() overwrites this.client with the freshly-built pool; capture it into a local and
-        // immediately restore the old client so the live driver/connector stay on the old pool until the
-        // swap. The old client keeps serving throughout - the live fields are never nulled.
-        let newClient;
-        try {
-            await this.configure();
-            newClient = this.client;
-        }
-        catch (error) {
-            const halfBuilt = this.client;
-            this.client = savedClient;
-            Object.assign(this.settings, savedSettings);
-            if (halfBuilt && halfBuilt !== savedClient && typeof halfBuilt.end === 'function') {
-                await halfBuilt.end();
-            }
-            logger.error('Secret rotation failed in configure(); kept old pool | key: %s', opts.key);
-            throw error;
-        }
-        this.client = savedClient;
-        // Wire a driver + connector over the new pool into locals, still without touching live state.
-        let newDriver;
-        let newConnector;
-        try {
-            const DriverClass = this.resolveDriverClass();
-            newDriver = new DriverClass({ client: newClient });
-            newConnector = newDriver.createConnector({ schema: this.getSchema() });
-        }
-        catch (error) {
-            Object.assign(this.settings, savedSettings);
-            if (newClient && typeof newClient.end === 'function') {
-                await newClient.end();
-            }
-            logger.error('Secret rotation failed while wiring driver; kept old pool | key: %s', opts.key);
-            throw error;
-        }
-        // New pool fully built: commit the live fields to it in one synchronous step (no null window),
-        // then soft-evict the old pool so its in-flight transactions can finish.
-        this.client = newClient;
-        this.driver = newDriver;
-        this.connector = newConnector;
-        if (oldClient && typeof oldClient.end === 'function') {
-            await oldClient.end();
-            logger.info('Old pool drained after secret rotation | key: %s', opts.key);
-        }
+        AbstractPostgresDataSource.queryDialect ??= new query_dialect_1.PostgresQueryDialect();
+        return AbstractPostgresDataSource.queryDialect;
     }
-    /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */
-    mapSecretToSettings(opts) {
-        const { username, password } = opts.secret;
-        const mapped = {};
-        if (username !== undefined) {
-            mapped.user = username;
-        }
-        if (password !== undefined) {
-            mapped.password = password;
-        }
-        return mapped;
+    getQueryExecutor() {
+        AbstractPostgresDataSource.queryExecutor ??= new executor_1.PostgresQueryExecutor();
+        return AbstractPostgresDataSource.queryExecutor;
     }
 }
-exports.AbstractRelationalDataSource = AbstractRelationalDataSource;
+exports.AbstractPostgresDataSource = AbstractPostgresDataSource;
 //# sourceMappingURL=abstract.js.map

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":";;;AACA,oDAAwD;AAGxD,8EAAkF;AAClF,mDAAuD;AAEvD,0DAAkD;AASlD,sDAAsD;AACtD,MAAsB,4BAMpB,SAAQ,gCAAyD;IAUjE;;;OAGG;IACO,sBAAsB;QAC9B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC3E,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,iIAAiI;aACpK,CAAC,CAAC;QACL,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9C,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;4EACwE;IAC9D,kBAAkB;QAC1B,MAAM,QAAQ,GAAG,4BAAgB,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC;YACpE,MAAM,EAAE,IAAI,CAAC,WAAW;SACzB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAM,CAAC;QAEhC,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,iFAAiF,MAAM,CAAC,MAAM,CAAC,sLAAsL;aACxT,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAA2C,CAAC;IACrD,CAAC;IAES,aAAa;QACrB,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,MAAmC,CAAC;IAClD,CAAC;IAED;iGAC6F;IACnF,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,kGAAkG;IAClG,YAAY;QACV,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;yFACqF;IACrF,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;IAED;;qGAEiG;IACjG,KAAK,CAAC,eAAe,CAAC,IAAqD;QACzE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAa,CAAC;QAE9C,8FAA8F;QAC9F,+FAA+F;QAC/F,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,MAAM,aAAa,GAAG,EAAE,GAAI,IAAI,CAAC,QAAsB,EAAE,CAAC;QAE1D,gGAAgG;QAChG,mGAAmG;QACnG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAqB,EAAE,IAAI,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAE7F,8FAA8F;QAC9F,iGAAiG;QACjG,oFAAoF;QACpF,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACvB,SAAS,GAAG,IAAI,CAAC,MAAgB,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,MAAiB,CAAC;YACzC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;YAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAqB,EAAE,aAAa,CAAC,CAAC;YACzD,IAAI,SAAS,IAAI,SAAS,KAAK,WAAW,IAAI,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;gBAClF,MAAO,SAAqB,CAAC,GAAG,EAAE,CAAC;YACrC,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,gEAAgE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACzF,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAE1B,8FAA8F;QAC9F,IAAI,SAAoC,CAAC;QACzC,IAAI,YAA0C,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC9C,SAAS,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,SAAoB,EAAE,CAAC,CAAC;YAC9D,YAAY,GAAG,SAAS,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAqB,EAAE,aAAa,CAAC,CAAC;YACzD,IAAI,SAAS,IAAI,OAAQ,SAAqB,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;gBAClE,MAAO,SAAqB,CAAC,GAAG,EAAE,CAAC;YACrC,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,qEAAqE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9F,MAAM,KAAK,CAAC;QACd,CAAC;QAED,+FAA+F;QAC/F,yEAAyE;QACzE,IAAI,CAAC,MAAM,GAAG,SAAoB,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,YAAuB,CAAC;QAEzC,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,iGAAiG;IACvF,mBAAmB,CAAC,IAAwC;QACpE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3C,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;QACzB,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC7B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAjLD,oEAiLC"}
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/abstract.ts"],"names":[],"mappings":";;;AAEA,4FAAgG;AAChG,0EAAoF;AACpF,qEAA+E;AAK/E;;;;GAIG;AACH,MAAsB,0BAKpB,SAAQ,sCAMT;IAIU,eAAe;QACtB,0BAA0B,CAAC,YAAY,KAAK,IAAI,oCAAoB,EAAE,CAAC;QACvE,OAAO,0BAA0B,CAAC,YAAY,CAAC;IACjD,CAAC;IAEQ,gBAAgB;QACvB,0BAA0B,CAAC,aAAa,KAAK,IAAI,gCAAqB,EAAE,CAAC;QACzE,OAAO,0BAA0B,CAAC,aAEjC,CAAC;IACJ,CAAC;CACF;AA1BD,gEA0BC"}

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

@@ -1,21 +1,15 @@
 import type { TAnyDataSourceSchema } from '../../../base/datasources';
 import type { Pool } from 'pg';
-import { AbstractRelationalDataSource } from './abstract';
+import { AbstractPostgresDataSource } from './abstract';
 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 = {}, Client = Pool> extends AbstractRelationalDataSource<Settings, Schema, ConfigurableOptions, Client> {
-    constructor(opts: {
-        name: string;
-        config: Settings;
-        schema?: Schema;
-    });
-    /** Auto-discovers schema from repositories if not manually provided. */
-    getSchema(): Schema;
-    protected discoverSchema(): Schema;
-    hasDiscoverableModels(): boolean;
-    getCapabilities(): {
-        transactions: boolean;
-    };
+/**
+ * Postgres's half of the transaction seam: supplies the BEGIN statement the inherited
+ * `beginTransaction()` delegates to, then attaches `isolationLevel` - a Postgres-only field the
+ * neutral `IRelationalTransaction` has no concept of.
+ */
+export declare abstract class BasePostgresDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = Pool> extends AbstractPostgresDataSource<Settings, Schema, ConfigurableOptions, Client> {
+    private resolveIsolationLevel;
+    protected buildBeginStatement(opts?: IDatabaseTransactionOptions): string;
     beginTransaction(opts?: IDatabaseTransactionOptions): Promise<IDatabaseTransaction<Schema>>;
 }
 //# sourceMappingURL=base.d.ts.map

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":"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;CA0EzC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,2BAA2B,EAAmB,MAAM,UAAU,CAAC;AAGnG;;;;GAIG;AACH,8BAAsB,sBAAsB,CAC1C,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,IAAI,CACb,SAAQ,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC;IACjF,OAAO,CAAC,qBAAqB;cAIV,mBAAmB,CAAC,IAAI,CAAC,EAAE,2BAA2B,GAAG,MAAM;IAOnE,gBAAgB,CAC7B,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;CAUzC"}

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

@@ -1,116 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseRelationalDataSource = void 0;
-const inversion_1 = require("../../../helpers/inversion");
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
+exports.BasePostgresDataSource = void 0;
 const abstract_1 = require("./abstract");
 const common_1 = require("./common");
-/** Base DataSource with schema auto-discovery from registered repositories. */
-class BaseRelationalDataSource extends abstract_1.AbstractRelationalDataSource {
-    constructor(opts) {
-        super({ scope: opts.name });
-        this.name = opts.name;
-        this.settings = opts.config;
-        if (opts.schema) {
-            this.schema = opts.schema;
-        }
+/**
+ * Postgres's half of the transaction seam: supplies the BEGIN statement the inherited
+ * `beginTransaction()` delegates to, then attaches `isolationLevel` - a Postgres-only field the
+ * neutral `IRelationalTransaction` has no concept of.
+ */
+class BasePostgresDataSource extends abstract_1.AbstractPostgresDataSource {
+    resolveIsolationLevel(opts) {
+        return opts?.isolationLevel ?? common_1.IsolationLevels.READ_COMMITTED;
     }
-    /** Auto-discovers schema from repositories if not manually provided. */
-    getSchema() {
-        if (!this.schema) {
-            this.schema = this.discoverSchema();
-        }
-        return this.schema;
-    }
-    discoverSchema() {
-        const registry = inversion_1.MetadataRegistry.getInstance();
-        const metadata = registry.getDataSourceMetadata({ target: this.constructor });
-        if (metadata?.autoDiscovery === false) {
-            this.logger.for(this.discoverSchema.name).debug('Auto-discovery disabled for %s', this.name);
-            return {};
-        }
-        const { schema, relations } = registry.buildSchema({
-            dataSource: this.constructor,
-        });
-        const models = Object.keys(schema);
-        this.logger
-            .for(this.discoverSchema.name)
-            .debug('Detected model(s) | Name: %s | Count: %s | Models: %j', this.name, models.length, models);
-        // buildSchema() is shared by every connector so it returns Record<string, unknown>; narrow
-        // it back to the real Drizzle schema shape here.
-        return { ...schema, ...relations };
-    }
-    hasDiscoverableModels() {
-        const registry = inversion_1.MetadataRegistry.getInstance();
-        return registry.hasModels({ dataSource: this.constructor });
-    }
-    getCapabilities() {
-        return { transactions: true };
+    buildBeginStatement(opts) {
+        // `isolationLevel` comes from the IsolationLevels const-class, never user input, and must be
+        // interpolated: `ISOLATION LEVEL $1` is not valid SQL, and postgres-js tagged templates would
+        // bind it as a parameter.
+        return `BEGIN TRANSACTION ISOLATION LEVEL ${this.resolveIsolationLevel(opts)}`;
     }
     async beginTransaction(opts) {
-        const driver = 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}`,
-            });
-        }
-        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, not pooled
-         * (the session may still hold an open transaction the next borrower would inherit), and the
-         * error rethrown - a caller must never believe a failed COMMIT succeeded. */
-        const finish = async (finishOpts) => {
-            const { statement, verb } = finishOpts;
-            if (!isActive) {
-                // After a FAILED commit/rollback the transaction is already torn down, so a rollback is
-                // satisfied by construction - throwing 'already ended' would replace the caller's original
-                // error in the canonical `catch { await tx.rollback(); throw error; }`.
-                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: connection.connector,
-            get isActive() {
-                return isActive;
-            },
-            commit: () => finish({ statement: 'COMMIT', verb: 'commit' }),
-            rollback: () => finish({ statement: 'ROLLBACK', verb: 'rollback' }),
+        const transaction = await super.beginTransaction(opts);
+        // Annotated so `TIsolationLevel` survives fresh-object-literal widening back to `string`.
+        const patch = {
+            isolationLevel: this.resolveIsolationLevel(opts),
         };
+        return Object.assign(transaction, patch);
     }
 }
-exports.BaseRelationalDataSource = BaseRelationalDataSource;
+exports.BasePostgresDataSource = BasePostgresDataSource;
 //# sourceMappingURL=base.js.map

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":";;;AAGA,yCAAwD;AAExD,qCAA2C;AAE3C;;;;GAIG;AACH,MAAsB,sBAKpB,SAAQ,qCAAyE;IACzE,qBAAqB,CAAC,IAAkC;QAC9D,OAAO,IAAI,EAAE,cAAc,IAAI,wBAAe,CAAC,cAAc,CAAC;IAChE,CAAC;IAEkB,mBAAmB,CAAC,IAAkC;QACvE,6FAA6F;QAC7F,8FAA8F;QAC9F,0BAA0B;QAC1B,OAAO,qCAAqC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;IACjF,CAAC;IAEQ,KAAK,CAAC,gBAAgB,CAC7B,IAAkC;QAElC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEvD,0FAA0F;QAC1F,MAAM,KAAK,GAAwC;YACjD,cAAc,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC;SACjD,CAAC;QAEF,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AA7BD,wDA6BC"}

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

@@ -1,5 +1,8 @@
 import type { ITransaction } from '../../../../base/datasources';
 import type { IDatabaseTransaction } from './types';
-/** Narrows the neutral `ITransaction` to the postgres-flavored `IDatabaseTransaction` handle before accessing `.connector`. */
+/**
+ * Narrows the neutral `ITransaction` to the Postgres handle before accessing `.connector`. The
+ * runtime check is the neutral guard's; only the narrowed type differs.
+ */
 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,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"}
+{"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;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,aAAa,YAAY,GAAG,SAAS,KACpC,WAAW,IAAI,oBAEjB,CAAC"}

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

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isDatabaseTransaction = void 0;
-/** Narrows the neutral `ITransaction` to the postgres-flavored `IDatabaseTransaction` handle before accessing `.connector`. */
+const common_1 = require("../../../../connectors/relational/datasources/common");
+/**
+ * Narrows the neutral `ITransaction` to the Postgres handle before accessing `.connector`. The
+ * runtime check is the neutral guard's; only the narrowed type differs.
+ */
 const isDatabaseTransaction = (transaction) => {
-    return transaction !== undefined && 'connector' in transaction;
+    return (0, common_1.isRelationalTransaction)(transaction);
 };
 exports.isDatabaseTransaction = isDatabaseTransaction;
 //# sourceMappingURL=guards.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../../../src/connectors/postgres/datasources/common/guards.ts"],"names":[],"mappings":";;;AAGA,+HAA+H;AACxH,MAAM,qBAAqB,GAAG,CACnC,WAAqC,EACA,EAAE;IACvC,OAAO,WAAW,KAAK,SAAS,IAAI,WAAW,IAAI,WAAW,CAAC;AACjE,CAAC,CAAC;AAJW,QAAA,qBAAqB,yBAIhC"}
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../../../src/connectors/postgres/datasources/common/guards.ts"],"names":[],"mappings":";;;AACA,uEAAqF;AAGrF;;;GAGG;AACI,MAAM,qBAAqB,GAAG,CACnC,WAAqC,EACA,EAAE;IACvC,OAAO,IAAA,gCAAuB,EAAC,WAAW,CAAC,CAAC;AAC9C,CAAC,CAAC;AAJW,QAAA,qBAAqB,yBAIhC"}

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

@@ -1,12 +1,15 @@
-import type { AbstractDataSource, ITransaction, ITransactionOptions, TAnyDataSourceSchema } from '../../../../base/datasources';
+import type { TAnyDataSourceSchema } from '../../../../base/datasources';
 import type { IRelationalQueryDialect } from '../../../../connectors/postgres/repositories/common';
-import type { TConstValue, ValueOrPromise } from '@venizia/ignis-helpers';
+import type { IRelationalDataSource, IRelationalTransaction, TRelationalTransactionOptions } from '../../../../connectors/relational/datasources/common';
+import type { TConstValue } 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`, differing only in the query-result HKT - the real shared base, not a cast. */
+/**
+ * Drizzle connector for any Postgres driver: `NodePgDatabase` and `PostgresJsDatabase` both extend
+ * `PgDatabase`, differing only in the query-result HKT.
+ */
 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>>;
@@ -21,32 +24,22 @@ export declare class IsolationLevels {
     static isValid(value: string): boolean;
 }
 export type TIsolationLevel = TConstValue<typeof IsolationLevels>;
-/** Postgres transaction options - adds a typed `isolationLevel` on top of the neutral,
- * string-only `ITransactionOptions`. */
-export interface IDatabaseTransactionOptions extends ITransactionOptions {
+/** Postgres transaction options: a typed `isolationLevel` on top of the string-only neutral one. */
+export interface IDatabaseTransactionOptions extends TRelationalTransactionOptions {
     isolationLevel?: TIsolationLevel;
 }
-export interface IDatabaseTransaction<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> extends ITransaction {
-    /** Bound to the transaction's own connection, whichever driver acquired it. */
-    connector: TRelationalConnector<Schema>;
+/**
+ * Postgres narrowing: pins the transaction's connector to a `PgDatabase` and requires a resolved
+ * isolation level. `connector`, `commit()` and `rollback()` come from `IRelationalTransaction`.
+ */
+export interface IDatabaseTransaction<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> extends IRelationalTransaction<TRelationalConnector<Schema>> {
     isolationLevel: TIsolationLevel;
-    /** Throws if COMMIT fails, per {@link ITransaction.commit}. On failure the connection is discarded
-     * where the driver supports it (node-postgres `release(error)`); postgres-js has no destroy
-     * semantics, so a poisoned connection returns to its pool. */
-    commit(): Promise<void>;
-    /** Throws if ROLLBACK fails (same connection-discard caveat as {@link commit}) - but is a silent
-     * no-op after the transaction already ended BY FAILURE, keeping
-     * `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 = {}, Client = Pool> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {
-    connector: TRelationalConnector<Schema>;
-    getConnectionString(): ValueOrPromise<string>;
-    getConnector(): TRelationalConnector<Schema>;
-    /** Raw driver client escape: `pg.Pool` today, postgres-js `Sql` once a driver supplies it. */
-    getClient(): Client;
+/**
+ * Postgres narrowing of `IRelationalDataSource`: pins the connector to `PgDatabase` and narrows
+ * `beginTransaction` to the isolation-level-aware `IDatabaseTransaction`.
+ */
+export interface IPostgresDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = Pool> extends IRelationalDataSource<Settings, Schema, ConfigurableOptions, Client, TRelationalConnector<Schema>> {
     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":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/postgres/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAC9B,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,IAClE,UAAU,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAEnD,wGAAwG;AACxG,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,wFAAwF;AACxF,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,IAC5F,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;AAEzC,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,oGAAoG;AACpG,MAAM,WAAW,2BAA4B,SAAQ,6BAA6B;IAChF,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB,CACnC,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,CAC1D,SAAQ,sBAAsB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5D,cAAc,EAAE,eAAe,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAClC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,IAAI,CACb,SAAQ,qBAAqB,CAC7B,QAAQ,EACR,MAAM,EACN,mBAAmB,EACnB,MAAM,EACN,oBAAoB,CAAC,MAAM,CAAC,CAC7B;IACC,eAAe,IAAI,uBAAuB,CAAC;IAC3C,gBAAgB,CAAC,IAAI,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;CAC7F"}

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":";;;AAiCA,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":";;;AAmCA,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/datasources/index.d.ts

@@ -1,6 +1,5 @@
 export * from './abstract';
 export * from './base';
 export * from './common';
-export { AbstractRelationalDataSource as AbstractPostgresDataSource } from './abstract';
-export { BaseRelationalDataSource as BasePostgresDataSource, BaseRelationalDataSource as BaseDataSource, } from './base';
+export { BasePostgresDataSource as BaseDataSource } from './base';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,4BAA4B,IAAI,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EACL,wBAAwB,IAAI,sBAAsB,EAClD,wBAAwB,IAAI,cAAc,GAC3C,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AAMzB,OAAO,EAAE,sBAAsB,IAAI,cAAc,EAAE,MAAM,QAAQ,CAAC"}

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

@@ -14,14 +14,14 @@ 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 });
-exports.BaseDataSource = exports.BasePostgresDataSource = exports.AbstractPostgresDataSource = void 0;
+exports.BaseDataSource = void 0;
 __exportStar(require("./abstract"), exports);
 __exportStar(require("./base"), exports);
 __exportStar(require("./common"), exports);
-// Compatibility aliases - same classes, historical public names kept for existing apps.
-var abstract_1 = require("./abstract");
-Object.defineProperty(exports, "AbstractPostgresDataSource", { enumerable: true, get: function () { return abstract_1.AbstractRelationalDataSource; } });
+// `AbstractRelationalDataSource` / `BaseRelationalDataSource` are deliberately NOT aliased here:
+// the engine-neutral classes own those names, so re-exporting these would publish two different
+// classes under one name across sibling sub-paths. The neutral ones live at
+// `@venizia/ignis/relational`.
 var base_1 = require("./base");
-Object.defineProperty(exports, "BasePostgresDataSource", { enumerable: true, get: function () { return base_1.BaseRelationalDataSource; } });
-Object.defineProperty(exports, "BaseDataSource", { enumerable: true, get: function () { return base_1.BaseRelationalDataSource; } });
+Object.defineProperty(exports, "BaseDataSource", { enumerable: true, get: function () { return base_1.BasePostgresDataSource; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AAEzB,wFAAwF;AACxF,uCAAwF;AAA/E,sHAAA,4BAA4B,OAA8B;AACnE,+BAGgB;AAFd,8GAAA,wBAAwB,OAA0B;AAClD,sGAAA,wBAAwB,OAAkB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AAEzB,iGAAiG;AACjG,gGAAgG;AAChG,4EAA4E;AAC5E,+BAA+B;AAC/B,+BAAkE;AAAzD,sGAAA,sBAAsB,OAAkB"}

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

@@ -1,43 +1,13 @@
 import type { TAnyDataSourceSchema } from '../../../base/datasources';
 import type { TRelationalConnector } from '../../../connectors/postgres/datasources/common';
-/** Neutral result of a raw statement. Each driver maps its native shape (pg `rowCount`,
- * postgres-js `count`) at its own boundary - callers 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) - never
-     * parameterized, `BEGIN ... ISOLATION LEVEL $1` is not valid SQL. Use `connector` for rows. */
-    execute(opts: {
-        statement: string;
-    }): Promise<IStatementResult>;
-    /** Returns the connection. `destroy` discards instead of pooling - required after a failed
-     * COMMIT/ROLLBACK, when the next borrower would inherit an open transaction. A driver that
-     * cannot destroy must say so in its own docs. */
-    release(opts?: {
-        destroy?: boolean;
-    }): void;
-}
-/** Owns connection acquisition and raw control statements - the only two places hard-wired to a
- * client library. `configure()` stays app-written: 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>;
-}
+import type { IRelationalConnection, IRelationalDriver } from '../../../connectors/relational/drivers';
+export type { IStatementResult } from '../../../connectors/relational/drivers';
+/**
+ * Postgres narrowing: the neutral `IRelationalConnection<TConnector>` is parameterized by the
+ * connector type, not by `Schema`. Aliased rather than re-exported so callers keep writing
+ * `TRelationalConnection<Schema>` and getting `connector: TRelationalConnector<Schema>`.
+ */
+export type TRelationalConnection<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> = IRelationalConnection<TRelationalConnector<Schema>>;
+/** Postgres narrowing: the connector is always a `PgDatabase`. */
+export type TRelationalDriver<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, Client = unknown> = IRelationalDriver<TRelationalConnector<Schema>, Client>;
 //# sourceMappingURL=driver.d.ts.map

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

@@ -1 +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;uFACuF;AACvF,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;mGAC+F;IAC/F,OAAO,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhE;;qDAEiD;IACjD,OAAO,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7C;AAED;qGACqG;AACrG,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"}
+{"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;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEhG,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,CAAC,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,IAC1F,qBAAqB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;AAEtD,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,CAC3B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,MAAM,GAAG,OAAO,IACd,iBAAiB,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC"}