@venizia/ignis 0.1.1-9 → 0.1.1

package/dist/connectors/postgres/repositories/dialect/query-dialect.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresQueryDialect = void 0;
+const filter_1 = require("./filter");
+const update_1 = require("./update");
+/**
+ * The Postgres `IRelationalQueryDialect`: the neutral `FilterBuilder`'s filter translation plus the
+ * Postgres-only JSON-path update composition (`jsonb_set`, `::jsonb` literals) that `UpdateBuilder`
+ * owns. The two stay in separate files so `FilterBuilder` keeps its zero pg-core imports.
+ */
+class PostgresQueryDialect extends filter_1.PostgresFilterBuilder {
+    constructor() {
+        super(...arguments);
+        this._updateBuilder = new update_1.UpdateBuilder();
+    }
+    /** The Postgres update transform, reachable for callers that need the raw builder. */
+    get updateBuilder() {
+        return this._updateBuilder;
+    }
+    transformUpdate(opts) {
+        return this._updateBuilder.transform(opts);
+    }
+    toUpdateData(opts) {
+        return this._updateBuilder.toUpdateData(opts);
+    }
+}
+exports.PostgresQueryDialect = PostgresQueryDialect;
+//# sourceMappingURL=query-dialect.js.map

package/dist/connectors/postgres/repositories/dialect/query-dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dialect.js","sourceRoot":"","sources":["../../../../../src/connectors/postgres/repositories/dialect/query-dialect.ts"],"names":[],"mappings":";;;AAKA,qCAAiD;AACjD,qCAAyC;AAEzC;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,8BAAqB;IAA/D;;QACmB,mBAAc,GAAG,IAAI,sBAAa,EAAE,CAAC;IAkBxD,CAAC;IAhBC,sFAAsF;IACtF,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,eAAe,CAAoC,IAIlD;QACC,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,YAAY,CAAC,IAA6C;QACxD,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;CACF;AAnBD,oDAmBC"}

package/dist/connectors/postgres/repositories/dialect/relation.d.ts

@@ -1,11 +1,2 @@
-import type { TTableSchemaWithId } from '../../../../connectors/postgres/models';
-import type { TRelationConfig } from '../common';
-/** Creates Drizzle ORM relations from a declarative configuration array. */
-export declare const createRelations: <Schema extends TTableSchemaWithId = TTableSchemaWithId>(opts: {
-    source: Schema;
-    relations: Array<TRelationConfig>;
-}) => {
-    definitions: {};
-    relations: import("drizzle-orm").Relations<string, {}>;
-};
+export { createRelations } from '../../../../connectors/relational/repositories/dialect/relation';
 //# sourceMappingURL=relation.d.ts.map

package/dist/connectors/postgres/repositories/dialect/relation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/postgres/repositories/dialect/relation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,4EAA4E;AAC5E,eAAO,MAAM,eAAe,GAAI,MAAM,SAAS,kBAAkB,GAAG,kBAAkB,EAAE,MAAM;IAC5F,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;CACnC;;;CAqCA,CAAC"}
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/postgres/repositories/dialect/relation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAC"}

package/dist/connectors/postgres/repositories/dialect/relation.js

@@ -1,43 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createRelations = void 0;
-// Deep import, not the `@/base` barrel: the barrel re-exports applications, forming the init cycle inversion mixins -> this file -> @/base -> applications -> Container.
-const constants_1 = require("../../../../base/repositories/common/constants");
-const drizzle_orm_1 = require("drizzle-orm");
-/** Creates Drizzle ORM relations from a declarative configuration array. */
-const createRelations = (opts) => {
-    const { source, relations } = opts;
-    return {
-        definitions: relations.reduce((curr, def) => {
-            if (!def) {
-                return curr;
-            }
-            curr[def.name] = def;
-            return curr;
-        }, {}),
-        relations: (0, drizzle_orm_1.relations)(source, ({ one, many }) => {
-            return relations.reduce((curr, def) => {
-                if (!def) {
-                    return curr;
-                }
-                const { name, type, schema, metadata } = def;
-                switch (type) {
-                    case constants_1.RelationTypes.ONE: {
-                        curr[name] = one(schema, Object.assign({}, { relationName: name }, metadata));
-                        break;
-                    }
-                    case constants_1.RelationTypes.MANY: {
-                        curr[name] = many(schema, Object.assign({}, { relationName: name }, metadata));
-                        break;
-                    }
-                    default: {
-                        break;
-                    }
-                }
-                return curr;
-            }, {});
-        }),
-    };
-};
-exports.createRelations = createRelations;
+// Deep re-export, never the neutral `../dialect` barrel: `createRelations` is reached from the
+// inversion mixins, and pulling the barrel in reintroduces the init cycle documented at the source.
+var relation_1 = require("../../../../connectors/relational/repositories/dialect/relation");
+Object.defineProperty(exports, "createRelations", { enumerable: true, get: function () { return relation_1.createRelations; } });
 //# sourceMappingURL=relation.js.map

package/dist/connectors/postgres/repositories/dialect/relation.js.map

@@ -1 +1 @@
-{"version":3,"file":"relation.js","sourceRoot":"","sources":["../../../../../src/connectors/postgres/repositories/dialect/relation.ts"],"names":[],"mappings":";;;AAAA,yKAAyK;AACzK,oEAAqE;AAErE,6CAA2D;AAG3D,4EAA4E;AACrE,MAAM,eAAe,GAAG,CAAyD,IAGvF,EAAE,EAAE;IACH,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACnC,OAAO;QACL,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC,EAAE,EAAE,CAAC;QACN,SAAS,EAAE,IAAA,uBAAe,EAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;YACnD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;gBACpC,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;gBAE7C,QAAQ,IAAI,EAAE,CAAC;oBACb,KAAK,yBAAa,CAAC,GAAG,CAAC,CAAC,CAAC;wBACvB,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;wBAC9E,MAAM;oBACR,CAAC;oBACD,KAAK,yBAAa,CAAC,IAAI,CAAC,CAAC,CAAC;wBACxB,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;wBAC/E,MAAM;oBACR,CAAC;oBACD,OAAO,CAAC,CAAC,CAAC;wBACR,MAAM;oBACR,CAAC;gBACH,CAAC;gBAED,OAAO,IAAI,CAAC;YACd,CAAC,EAAE,EAAE,CAAC,CAAC;QACT,CAAC,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AAxCW,QAAA,eAAe,mBAwC1B"}
+{"version":3,"file":"relation.js","sourceRoot":"","sources":["../../../../../src/connectors/postgres/repositories/dialect/relation.ts"],"names":[],"mappings":";;;AAAA,+FAA+F;AAC/F,oGAAoG;AACpG,kFAAwF;AAA/E,2GAAA,eAAe,OAAA"}

package/dist/connectors/postgres/repositories/dialect/update.d.ts

@@ -1,25 +1,22 @@
-import type { TTableSchemaWithId } from '../../../../connectors/postgres/models';
-import { BaseHelper } from '@venizia/ignis-helpers';
-import type { ITransformedUpdateData } from '../common';
-/** Transforms update data to support nested JSON path updates via chained jsonb_set calls. */
-export declare class UpdateBuilder extends BaseHelper {
+import { RelationalUpdateBuilder } from '../../../../connectors/relational/repositories/dialect';
+import type { SQL } from 'drizzle-orm';
+/**
+ * Composes nested JSON path updates as chained `jsonb_set` calls.
+ * The neutral base owns the split and the path validation.
+ */
+export declare class UpdateBuilder extends RelationalUpdateBuilder {
     constructor();
-    /** Separates regular fields from JSON path updates and builds SQL expressions. */
-    transform<Schema extends TTableSchemaWithId>(opts: {
-        tableName: string;
-        schema: Schema;
-        data: Record<string, any>;
-    }): ITransformedUpdateData;
-    /** Combines regular fields and JSON expressions into final update data for Drizzle's .set(). */
-    toUpdateData(opts: {
-        transformed: ITransformedUpdateData;
-    }): Record<string, any>;
-    private getColumns;
-    /** Groups JSON path updates by target column for chaining jsonb_set calls. */
-    private groupUpdatesByColumn;
-    /** Builds chained jsonb_set calls for multiple path updates on same column. */
-    private buildChainedJsonbSet;
-    /** Serializes a JavaScript value to PostgreSQL JSONB literal. */
+    /**
+     * The path and the value are RAW, not bound: `jsonb_set` takes a `text[]` and a `jsonb`, and a
+     * bound parameter arrives as untyped text. Safe only because the base has already run every path
+     * component through `validateJsonPathComponents`, whose pattern admits no quote.
+     */
+    protected composeJsonSet(opts: {
+        target: SQL;
+        path: string[];
+        value: any;
+    }): SQL;
+    /** Serializes a JavaScript value to a PostgreSQL JSONB literal. */
     private serializeJsonValue;
 }
 //# sourceMappingURL=update.d.ts.map

package/dist/connectors/postgres/repositories/dialect/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/postgres/repositories/dialect/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,UAAU,EAAY,MAAM,wBAAwB,CAAC;AAG9D,OAAO,KAAK,EAAE,sBAAsB,EAAiB,MAAM,WAAW,CAAC;AAoBvE,8FAA8F;AAC9F,qBAAa,aAAc,SAAQ,UAAU;;IAI3C,kFAAkF;IAClF,SAAS,CAAC,MAAM,SAAS,kBAAkB,EAAE,IAAI,EAAE;QACjD,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC3B,GAAG,sBAAsB;IAwF1B,gGAAgG;IAChG,YAAY,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,sBAAsB,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAKhF,OAAO,CAAC,UAAU;IAIlB,8EAA8E;IAC9E,OAAO,CAAC,oBAAoB;IAsB5B,+EAA+E;IAC/E,OAAO,CAAC,oBAAoB;IAkB5B,iEAAiE;IACjE,OAAO,CAAC,kBAAkB;CAQ3B"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/postgres/repositories/dialect/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGvC;;;GAGG;AACH,qBAAa,aAAc,SAAQ,uBAAuB;;IAKxD;;;;OAIG;cACgB,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,GAAG,GAAG;IASzF,mEAAmE;IACnE,OAAO,CAAC,kBAAkB;CAS3B"}

package/dist/connectors/postgres/repositories/dialect/update.js

@@ -1,124 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateBuilder = void 0;
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const dialect_1 = require("../../../../connectors/relational/repositories/dialect");
 const drizzle_orm_1 = require("drizzle-orm");
-const common_1 = require("../common");
-const json_utils_1 = require("./internal/json-utils");
-/** Transforms update data to support nested JSON path updates via chained jsonb_set calls. */
-class UpdateBuilder extends ignis_helpers_1.BaseHelper {
+/**
+ * Composes nested JSON path updates as chained `jsonb_set` calls.
+ * The neutral base owns the split and the path validation.
+ */
+class UpdateBuilder extends dialect_1.RelationalUpdateBuilder {
     constructor() {
         super({ scope: UpdateBuilder.name });
     }
-    /** Separates regular fields from JSON path updates and builds SQL expressions. */
-    transform(opts) {
-        const { tableName, schema, data } = opts;
-        const columns = this.getColumns(schema);
-        if (!columns || Object.keys(columns).length === 0) {
-            throw (0, ignis_helpers_1.getError)({
-                message: `[UpdateBuilder][transform] Table: ${tableName} | Failed to get table columns`,
-            });
-        }
-        const regularFields = {};
-        const jsonPathUpdates = [];
-        for (const key in data) {
-            const value = data[key];
-            if (value === undefined) {
-                continue;
-            }
-            const isRegularField = !(0, json_utils_1.isJsonPath)({ key });
-            if (isRegularField && !columns[key]) {
-                throw (0, ignis_helpers_1.getError)({
-                    message: `[UpdateBuilder][transform] Table: ${tableName} | Column NOT FOUND | key: '${key}'`,
-                });
-            }
-            if (isRegularField) {
-                regularFields[key] = value;
-                continue;
-            }
-            const parsed = (0, json_utils_1.parseJsonPath)({ key });
-            const column = columns[parsed.columnName];
-            if (!column) {
-                throw (0, ignis_helpers_1.getError)({
-                    message: `[UpdateBuilder][transform] Table: ${tableName} | Column NOT FOUND | key: '${parsed.columnName}'`,
-                });
-            }
-            (0, json_utils_1.validateJsonColumnType)({
-                column,
-                columnName: parsed.columnName,
-                tableName,
-                methodName: 'UpdateBuilder.transform',
-            });
-            (0, json_utils_1.validateJsonPathComponents)({
-                path: parsed.path,
-                tableName,
-                methodName: 'UpdateBuilder.transform',
-            });
-            if (parsed.path.length === 0) {
-                throw (0, ignis_helpers_1.getError)({
-                    message: `[UpdateBuilder][transform] Table: ${tableName} | Empty JSON path for column '${parsed.columnName}'`,
-                });
-            }
-            jsonPathUpdates.push({
-                columnName: parsed.columnName,
-                path: parsed.path,
-                value,
-            });
-        }
-        if (jsonPathUpdates.length === 0) {
-            return { regularFields, jsonExpressions: {} };
-        }
-        const groupedByColumn = this.groupUpdatesByColumn({
-            jsonPathUpdates,
-            columns,
-        });
-        const jsonExpressions = {};
-        for (const [columnName, columnUpdates] of groupedByColumn) {
-            jsonExpressions[columnName] = this.buildChainedJsonbSet({
-                column: columnUpdates.column,
-                updates: columnUpdates.updates,
-            });
-        }
-        return { regularFields, jsonExpressions };
-    }
-    /** Combines regular fields and JSON expressions into final update data for Drizzle's .set(). */
-    toUpdateData(opts) {
-        const { regularFields, jsonExpressions } = opts.transformed;
-        return { ...regularFields, ...jsonExpressions };
-    }
-    getColumns(schema) {
-        return (0, common_1.getCachedColumns)(schema);
-    }
-    /** Groups JSON path updates by target column for chaining jsonb_set calls. */
-    groupUpdatesByColumn(opts) {
-        const grouped = new Map();
-        for (const update of opts.jsonPathUpdates) {
-            if (!grouped.has(update.columnName)) {
-                grouped.set(update.columnName, {
-                    column: opts.columns[update.columnName],
-                    updates: [],
-                });
-            }
-            grouped.get(update.columnName).updates.push({
-                path: update.path,
-                value: update.value,
-            });
-        }
-        return grouped;
-    }
-    /** Builds chained jsonb_set calls for multiple path updates on same column. */
-    buildChainedJsonbSet(opts) {
-        const { column, updates } = opts;
-        const columnName = column.name;
-        let expression = `"${columnName}"`;
-        for (const update of updates) {
-            const pathLiteral = `'{${update.path.join(',')}}'`;
-            const valueLiteral = this.serializeJsonValue(update.value);
-            expression = `jsonb_set(${expression}, ${pathLiteral}, ${valueLiteral}, true)`;
-        }
-        return drizzle_orm_1.sql.raw(expression);
+    /**
+     * The path and the value are RAW, not bound: `jsonb_set` takes a `text[]` and a `jsonb`, and a
+     * bound parameter arrives as untyped text. Safe only because the base has already run every path
+     * component through `validateJsonPathComponents`, whose pattern admits no quote.
+     */
+    composeJsonSet(opts) {
+        const { target, path, value } = opts;
+        const pathLiteral = drizzle_orm_1.sql.raw(`'{${path.join(',')}}'`);
+        const valueLiteral = drizzle_orm_1.sql.raw(this.serializeJsonValue(value));
+        return (0, drizzle_orm_1.sql) `jsonb_set(${target}, ${pathLiteral}, ${valueLiteral}, true)`;
     }
-    /** Serializes a JavaScript value to PostgreSQL JSONB literal. */
+    /** Serializes a JavaScript value to a PostgreSQL JSONB literal. */
     serializeJsonValue(value) {
         if (value === null) {
             return "'null'::jsonb";

package/dist/connectors/postgres/repositories/dialect/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../../src/connectors/postgres/repositories/dialect/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../../src/connectors/postgres/repositories/dialect/update.ts"],"names":[],"mappings":";;;AAAA,0EAAuF;AAEvF,6CAAkC;AAElC;;;GAGG;AACH,MAAa,aAAc,SAAQ,iCAAuB;IACxD;QACE,KAAK,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACgB,cAAc,CAAC,IAAiD;QACjF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAErC,MAAM,WAAW,GAAG,iBAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,iBAAG,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;QAE7D,OAAO,IAAA,iBAAG,EAAA,aAAa,MAAM,KAAK,WAAW,KAAK,YAAY,SAAS,CAAC;IAC1E,CAAC;IAED,mEAAmE;IAC3D,kBAAkB,CAAC,KAAU;QACnC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE7D,OAAO,IAAI,UAAU,UAAU,CAAC;IAClC,CAAC;CACF;AA7BD,sCA6BC"}

package/dist/connectors/postgres/repositories/executor.d.ts

@@ -0,0 +1,31 @@
+import type { ICountOptions, IInsertOptions, IRelationalQueryExecutor, IRelationalQueryOptions, IRemoveOptions, ISelectOptions, IUpdateOptions, IWriteResult } from '../../../connectors/relational/repositories/common';
+import type { TRelationalConnector } from '../../../connectors/postgres/datasources';
+import type { TNullable } from '@venizia/ignis-helpers';
+/**
+ * Translates already-built SQL fragments (`where`, `orderBy`, projections) to Drizzle Core calls.
+ * Filter-to-SQL compilation is dialect work and stays in the repository tier.
+ *
+ * The `rows as Array<R>` every write verb ends in is convention, not proof: Drizzle infers
+ * `returning()`'s row type from the table schema, not from the caller-chosen R.
+ */
+export declare class PostgresQueryExecutor implements IRelationalQueryExecutor<TRelationalConnector> {
+    select<R>(opts: ISelectOptions<TRelationalConnector>): Promise<Array<R>>;
+    count(opts: ICountOptions<TRelationalConnector>): Promise<number>;
+    findMany<R>(opts: IRelationalQueryOptions<TRelationalConnector>): Promise<Array<R>>;
+    findFirst<R>(opts: IRelationalQueryOptions<TRelationalConnector>): Promise<TNullable<R>>;
+    insert<R>(opts: IInsertOptions<TRelationalConnector>): Promise<IWriteResult<R>>;
+    update<R>(opts: IUpdateOptions<TRelationalConnector>): Promise<IWriteResult<R>>;
+    remove<R>(opts: IRemoveOptions<TRelationalConnector>): Promise<IWriteResult<R>>;
+    /**
+     * Gets the Drizzle relational-query interface, validating schema registration. The error wording
+     * names the entity and lists the available keys, and a test asserts it word for word.
+     */
+    private getQueryInterface;
+    /**
+     * Rows affected by a write executed without RETURNING. Reads `pg`'s `rowCount`, postgres-js's
+     * `count` or PGlite's `affectedRows` off the raw driver result - engine knowledge the shared
+     * repository tier must not hold.
+     */
+    private readAffectedRowCount;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/connectors/postgres/repositories/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/repositories/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACb,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKjE;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,wBAAwB,CAAC,oBAAoB,CAAC;IACpF,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAqCxE,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,uBAAuB,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAQnF,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,uBAAuB,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAYxF,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAa/E,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAgB/E,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAarF;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;CA6C7B"}

package/dist/connectors/postgres/repositories/executor.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresQueryExecutor = void 0;
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const omit_1 = __importDefault(require("lodash/omit"));
+/**
+ * Translates already-built SQL fragments (`where`, `orderBy`, projections) to Drizzle Core calls.
+ * Filter-to-SQL compilation is dialect work and stays in the repository tier.
+ *
+ * The `rows as Array<R>` every write verb ends in is convention, not proof: Drizzle infers
+ * `returning()`'s row type from the table schema, not from the caller-chosen R.
+ */
+class PostgresQueryExecutor {
+    async select(opts) {
+        const { connector, table, columns, where, orderBy, limit, offset, lock } = opts;
+        // Drizzle's `.from()` needs the concrete `PgTable` type, not the generic bound.
+        const pgTable = table;
+        let query = columns
+            ? connector
+                .select(columns)
+                .from(pgTable)
+                .$dynamic()
+            : connector.select().from(pgTable).$dynamic();
+        if (where) {
+            query = query.where(where);
+        }
+        if (orderBy && orderBy.length > 0) {
+            query = query.orderBy(...orderBy);
+        }
+        if (limit !== undefined) {
+            query = query.limit(limit);
+        }
+        if (offset !== undefined) {
+            query = query.offset(offset);
+        }
+        // `$dynamic()` infers its row type from the table schema, not from the caller-chosen R.
+        if (lock) {
+            return query.for(lock.strength, lock.config);
+        }
+        return query;
+    }
+    async count(opts) {
+        const { connector, table, where } = opts;
+        return connector.$count(table, where);
+    }
+    async findMany(opts) {
+        const queryInterface = this.getQueryInterface(opts);
+        // Drizzle's relational result (`PgRelationalQuery<{[x: string]: any}[]>`) does not overlap the
+        // caller-chosen R enough for a direct assertion.
+        return queryInterface.findMany(opts.query);
+    }
+    async findFirst(opts) {
+        const queryInterface = this.getQueryInterface(opts);
+        // Drizzle's `findFirst` config type structurally forbids `limit` - it always fetches one row.
+        // This is the only place that knows that, so the strip happens here whatever the caller passed.
+        const queryOptions = (0, omit_1.default)(opts.query, ['limit']);
+        const result = await queryInterface.findFirst(queryOptions);
+        // Same drizzle-relational-query-versus-caller-generic boundary as `findMany` above.
+        return (result ?? null);
+    }
+    async insert(opts) {
+        const { connector, table, values, returning, shouldReturn } = opts;
+        const query = connector.insert(table).values(values);
+        if (!shouldReturn) {
+            const result = await query;
+            return { count: this.readAffectedRowCount({ result }), rows: [] };
+        }
+        const rows = returning ? await query.returning(returning) : await query.returning();
+        return { count: rows.length, rows: rows };
+    }
+    async update(opts) {
+        const { connector, table, data, where, returning, shouldReturn } = opts;
+        const query = connector
+            .update(table)
+            .set(data)
+            .where(where);
+        if (!shouldReturn) {
+            const result = await query;
+            return { count: this.readAffectedRowCount({ result }), rows: [] };
+        }
+        const rows = returning ? await query.returning(returning) : await query.returning();
+        return { count: rows.length, rows: rows };
+    }
+    async remove(opts) {
+        const { connector, table, where, returning, shouldReturn } = opts;
+        const query = connector.delete(table).where(where);
+        if (!shouldReturn) {
+            const result = await query;
+            return { count: this.readAffectedRowCount({ result }), rows: [] };
+        }
+        const rows = returning ? await query.returning(returning) : await query.returning();
+        return { count: rows.length, rows: rows };
+    }
+    /**
+     * Gets the Drizzle relational-query interface, validating schema registration. The error wording
+     * names the entity and lists the available keys, and a test asserts it word for word.
+     */
+    getQueryInterface(opts) {
+        const { connector, entityName } = opts;
+        const scope = opts.scope ?? this.constructor.name;
+        if (!connector.query) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${scope}] Connector query interface not available | Ensure datasource is properly configured with schema`,
+            });
+        }
+        const queryInterface = connector.query[entityName];
+        if (!queryInterface) {
+            const availableKeys = Object.keys(connector.query);
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${scope}] Schema key mismatch | Entity name '${entityName}' not found in connector.query | Available keys: [${availableKeys.join(', ')}] | Ensure the model's TABLE_NAME matches the schema registration key`,
+            });
+        }
+        return queryInterface;
+    }
+    /**
+     * Rows affected by a write executed without RETURNING. Reads `pg`'s `rowCount`, postgres-js's
+     * `count` or PGlite's `affectedRows` off the raw driver result - engine knowledge the shared
+     * repository tier must not hold.
+     */
+    readAffectedRowCount(opts) {
+        const { result } = opts;
+        // Drizzle resolves some statements to nothing at all; that counts as zero rows.
+        if (result === null || result === undefined) {
+            return 0;
+        }
+        if (typeof result !== 'object') {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[readAffectedRowCount] Unrecognized driver result | expected pg.QueryResult, postgres-js RowList or a PGlite Results | got: ${typeof result}`,
+            });
+        }
+        const { rowCount, count, affectedRows } = result;
+        // node-postgres. `rowCount` is null for statements
+        // that affect no rows by definition (e.g. DDL).
+        if (typeof rowCount === 'number') {
+            return rowCount;
+        }
+        if (rowCount === null) {
+            return 0;
+        }
+        // postgres-js.
+        if (typeof count === 'number') {
+            return count;
+        }
+        // PGlite - it carries no `rowCount` at all, so without this
+        // branch every write with `shouldReturn: false` throws.
+        if (typeof affectedRows === 'number') {
+            return affectedRows;
+        }
+        throw (0, ignis_helpers_1.getError)({
+            message: `[readAffectedRowCount] Unrecognized driver result | expected 'rowCount' (node-postgres), 'count' (postgres-js) or 'affectedRows' (PGlite) | got keys: ${Object.keys(result).join(', ')}`,
+        });
+    }
+}
+exports.PostgresQueryExecutor = PostgresQueryExecutor;
+//# sourceMappingURL=executor.js.map

package/dist/connectors/postgres/repositories/executor.js.map

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

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

@@ -1,4 +1,5 @@
 export * from './common';
 export * from './core';
 export * from './dialect';
+export * from './executor';
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -17,4 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common"), exports);
 __exportStar(require("./core"), exports);
 __exportStar(require("./dialect"), exports);
+// `getQueryExecutor()` is a required member of `IRelationalDataSource`, so an application with a
+// hand-rolled datasource needs this class from the public barrel, not a deep internal path.
+__exportStar(require("./executor"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/repositories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB;AACvB,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/postgres/repositories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB;AACvB,4CAA0B;AAC1B,iGAAiG;AACjG,4FAA4F;AAC5F,6CAA2B"}

package/dist/connectors/relational/datasources/abstract.d.ts

@@ -0,0 +1,71 @@
+import type { TAnyDataSourceSchema } from '../../../base/datasources';
+import { AbstractDataSource } from '../../../base/datasources';
+import type { IRelationalDriver } from '../../../connectors/relational/drivers';
+import type { IRelationalDataSource, IRelationalTransaction, TRelationalTransactionOptions } from '../../../connectors/relational/datasources/common';
+import type { IRelationalQueryDialect, IRelationalQueryExecutor } from '../../../connectors/relational/repositories/common';
+import type { AnyObject, TClass, ValueOrPromise } from '@venizia/ignis-helpers';
+/**
+ * SQL branch root: connector, pool, transactions. Engine-neutral - dialect and executor are
+ * declared abstract here and supplied by each engine branch.
+ *
+ * `mapSecretToSettings` is a driver-config convention, not Postgres SQL, so it belongs on this
+ * neutral base - do not move it down into `connectors/postgres`.
+ */
+export declare abstract class AbstractRelationalDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = unknown, TConnector = unknown> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> implements IRelationalDataSource<Settings, Schema, ConfigurableOptions, Client, TConnector> {
+    connector: TConnector;
+    protected client?: Client;
+    protected driver?: IRelationalDriver<TConnector>;
+    /**
+     * Lazy and idempotent: builds the driver named by `@datasource({ driver })` over the client
+     * `configure()` assigned, then the connector from it.
+     */
+    protected wireDriverFromMetadata(): void;
+    /**
+     * Rejects a driver-name string from untyped JS
+     * callers: a string carries no module into the bundle.
+     */
+    protected resolveDriverClass(): TClass<IRelationalDriver<TConnector>>;
+    protected resolveDriver(): IRelationalDriver<TConnector>;
+    /**
+     * Assigns `this.driver` AND builds `this.connector` in one step - a
+     * driver without its connector is silently bypassed on pooled queries.
+     */
+    protected useDriver(opts: {
+        driver: IRelationalDriver<TConnector>;
+        schema?: Schema;
+    }): void;
+    abstract getConnectionString(): ValueOrPromise<string>;
+    abstract beginTransaction(opts?: TRelationalTransactionOptions): Promise<IRelationalTransaction<TConnector>>;
+    /** Wires the driver on first use, so a `configure()` that only builds `this.client` is enough. */
+    getConnector(): TConnector;
+    /**
+     * Raw driver client (`pg.Pool` / `Sql`). Throws rather
+     * than handing back an `undefined` typed as `Client`.
+     */
+    getClient(): Client;
+    abstract getQueryDialect(): IRelationalQueryDialect;
+    abstract getQueryExecutor(): IRelationalQueryExecutor<TConnector>;
+    /**
+     * Soft-evicts the pool after a secret rotation: rebuilds against the rotated credentials without
+     * touching live fields, swaps atomically, then drains the old pool. On failure live state is
+     * restored, any half-built pool drained, and the error rethrown.
+     */
+    onSecretRotated(opts: {
+        key: string;
+        secret: Record<string, string>;
+    }): Promise<void>;
+    /**
+     * Shuts a client down by whichever verb its engine spells it with -
+     * `pg.Pool` and postgres.js have `end()`, PGlite and libsql only `close()`.
+     * Probed rather than type-tested: this tier must not name an engine, and a
+     * client left undrained keeps a WASM instance or file handle alive forever.
+     */
+    protected drainClient(opts: {
+        client: unknown;
+    }): Promise<boolean>;
+    /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */
+    protected mapSecretToSettings(opts: {
+        secret: Record<string, string>;
+    }): AnyObject;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/connectors/relational/datasources/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/connectors/relational/datasources/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,6CAA6C,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzF;;;;;;GAMG;AACH,8BAAsB,4BAA4B,CAChD,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,OAAO,EAChB,UAAU,GAAG,OAAO,CAEpB,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAChE,YAAW,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,CAAC;IAE3F,SAAS,EAAE,UAAU,CAAC;IAEtB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEjD;;;OAGG;IACH,SAAS,CAAC,sBAAsB,IAAI,IAAI;IAoBxC;;;OAGG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAerE,SAAS,CAAC,aAAa,IAAI,iBAAiB,CAAC,UAAU,CAAC;IAKxD;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAK3F,QAAQ,CAAC,mBAAmB,IAAI,cAAc,CAAC,MAAM,CAAC;aACpC,gBAAgB,CAChC,IAAI,CAAC,EAAE,6BAA6B,GACnC,OAAO,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE9C,kGAAkG;IAClG,YAAY,IAAI,UAAU;IAK1B;;;OAGG;IACH,SAAS,IAAI,MAAM;IAcnB,QAAQ,CAAC,eAAe,IAAI,uBAAuB;IACnD,QAAQ,CAAC,gBAAgB,IAAI,wBAAwB,CAAC,UAAU,CAAC;IAEjE;;;;OAIG;IACG,eAAe,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8D3F;;;;;OAKG;cACa,WAAW,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBxE,iGAAiG;IACjG,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS;CAanF"}