@venizia/ignis-connectors 0.2.0-0

package/dist/cjs/relational/core/repositories/dialect/internal/json-utils.d.ts

@@ -0,0 +1,30 @@
+/** Regex for validating JSON path components (identifiers, kebab-case, array indices). */
+export declare const JSON_PATH_PATTERN: RegExp;
+export declare const isJsonPath: (opts: {
+    key: string;
+}) => boolean;
+export declare const parseJsonPath: (opts: {
+    key: string;
+}) => {
+    columnName: string;
+    path: string[];
+};
+/** @throws Error if any path component is invalid. */
+export declare const validateJsonPathComponents: (opts: {
+    path: string[];
+    tableName: string;
+    methodName: string;
+}) => void;
+/**
+ * @throws Error if the column is not a JSON column. Names no engine type: `jsonb` is unreachable
+ * off Postgres.
+ */
+export declare const validateJsonColumnType: (opts: {
+    column: {
+        dataType: string;
+    };
+    columnName: string;
+    tableName: string;
+    methodName: string;
+}) => void;
+//# sourceMappingURL=json-utils.d.ts.map

package/dist/cjs/relational/core/repositories/dialect/internal/json-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-utils.d.ts","sourceRoot":"","sources":["../../../../../../../src/relational/core/repositories/dialect/internal/json-utils.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,QAAoC,CAAC;AAEnE,eAAO,MAAM,UAAU,GAAI,MAAM;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAG,OAElD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAIzF,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,0BAA0B,GAAI,MAAM;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,KAAG,IAUH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAC3C,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,KAAG,IASH,CAAC"}

package/dist/cjs/relational/core/repositories/dialect/internal/json-utils.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateJsonColumnType = exports.validateJsonPathComponents = exports.parseJsonPath = exports.isJsonPath = exports.JSON_PATH_PATTERN = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+/** Regex for validating JSON path components (identifiers, kebab-case, array indices). */
+exports.JSON_PATH_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_-]*$|^\d+$/;
+const isJsonPath = (opts) => {
+    return opts.key.includes('.') || opts.key.includes('[');
+};
+exports.isJsonPath = isJsonPath;
+const parseJsonPath = (opts) => {
+    const parts = opts.key.split(/[.[\]]+/).filter(Boolean);
+    const [columnName = opts.key, ...path] = parts;
+    return { columnName, path };
+};
+exports.parseJsonPath = parseJsonPath;
+/** @throws Error if any path component is invalid. */
+const validateJsonPathComponents = (opts) => {
+    const { path, tableName, methodName } = opts;
+    for (const part of path) {
+        if (!exports.JSON_PATH_PATTERN.test(part)) {
+            throw (0, core_1.getError)({
+                message: `[${methodName}] Table: ${tableName} | Invalid JSON path component: '${part}'`,
+            });
+        }
+    }
+};
+exports.validateJsonPathComponents = validateJsonPathComponents;
+/**
+ * @throws Error if the column is not a JSON column. Names no engine type: `jsonb` is unreachable
+ * off Postgres.
+ */
+const validateJsonColumnType = (opts) => {
+    const { column, columnName, tableName, methodName } = opts;
+    const dataType = column.dataType.toLowerCase();
+    if (dataType !== 'json' && dataType !== 'jsonb') {
+        throw (0, core_1.getError)({
+            message: `[${methodName}] Table: ${tableName} | Column '${columnName}' is not a JSON column | dataType: '${column.dataType}'`,
+        });
+    }
+};
+exports.validateJsonColumnType = validateJsonColumnType;
+//# sourceMappingURL=json-utils.js.map

package/dist/cjs/relational/core/repositories/dialect/internal/json-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-utils.js","sourceRoot":"","sources":["../../../../../../../src/relational/core/repositories/dialect/internal/json-utils.ts"],"names":[],"mappings":";;;AAAA,sDAAuD;AAEvD,0FAA0F;AAC7E,QAAA,iBAAiB,GAAG,iCAAiC,CAAC;AAE5D,MAAM,UAAU,GAAG,CAAC,IAAqB,EAAW,EAAE;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC,CAAC;AAFW,QAAA,UAAU,cAErB;AAEK,MAAM,aAAa,GAAG,CAAC,IAAqB,EAA0C,EAAE;IAC7F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IAC/C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAC9B,CAAC,CAAC;AAJW,QAAA,aAAa,iBAIxB;AAEF,sDAAsD;AAC/C,MAAM,0BAA0B,GAAG,CAAC,IAI1C,EAAQ,EAAE;IACT,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,yBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,UAAU,YAAY,SAAS,oCAAoC,IAAI,GAAG;aACxF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAdW,QAAA,0BAA0B,8BAcrC;AAEF;;;GAGG;AACI,MAAM,sBAAsB,GAAG,CAAC,IAKtC,EAAQ,EAAE;IACT,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAE3D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChD,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,IAAI,UAAU,YAAY,SAAS,cAAc,UAAU,uCAAuC,MAAM,CAAC,QAAQ,GAAG;SAC9H,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAdW,QAAA,sBAAsB,0BAcjC"}

package/dist/cjs/relational/core/repositories/dialect/relation.d.ts

@@ -0,0 +1,11 @@
+import type { TTableSchemaWithId } from '../../../../relational/core/models/common';
+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, {}>;
+};
+//# sourceMappingURL=relation.d.ts.map

package/dist/cjs/relational/core/repositories/dialect/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/dialect/relation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,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"}

package/dist/cjs/relational/core/repositories/dialect/relation.js

@@ -0,0 +1,43 @@
+"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 ignis_kernel_1 = require("@venizia/ignis-kernel");
+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 ignis_kernel_1.RelationTypes.ONE: {
+                        curr[name] = one(schema, Object.assign({}, { relationName: name }, metadata));
+                        break;
+                    }
+                    case ignis_kernel_1.RelationTypes.MANY: {
+                        curr[name] = many(schema, Object.assign({}, { relationName: name }, metadata));
+                        break;
+                    }
+                    default: {
+                        break;
+                    }
+                }
+                return curr;
+            }, {});
+        }),
+    };
+};
+exports.createRelations = createRelations;
+//# sourceMappingURL=relation.js.map

package/dist/cjs/relational/core/repositories/dialect/relation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/dialect/relation.ts"],"names":[],"mappings":";;;AAAA,yKAAyK;AACzK,wDAAsD;AAEtD,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,4BAAa,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,4BAAa,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"}

package/dist/cjs/relational/core/repositories/dialect/update.d.ts

@@ -0,0 +1,38 @@
+import type { TTableSchemaWithId } from '../../../../relational/core/models/common';
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { SQL } from 'drizzle-orm';
+import type { ITransformedUpdateData } from '../common';
+/**
+ * Splits `data` into plain columns and JSON-path writes, validating every JSON key before any of it
+ * becomes SQL. That validation is why this is a base and not a copied skeleton: an engine composing
+ * through `sql.raw` is injectable the moment it forgets `validateJsonPathComponents`.
+ *
+ * Subclasses supply only the JSON composition: `jsonb_set` on Postgres, `json_set` on SQLite.
+ */
+export declare abstract class RelationalUpdateBuilder extends BaseHelper {
+    /**
+     * Wraps `target` so the value lands at `path`. Called once per path, each call receiving the
+     * expression built so far, so two paths on one column nest instead of discarding each other.
+     */
+    protected abstract composeJsonSet(opts: {
+        target: SQL;
+        path: string[];
+        value: any;
+    }): SQL;
+    /** Separates regular fields from JSON path updates and builds the SQL expressions. */
+    transform<Schema extends TTableSchemaWithId>(opts: {
+        tableName: string;
+        schema: Schema;
+        data: Record<string, any>;
+    }): ITransformedUpdateData;
+    /** Combines regular fields and JSON expressions into the final payload for Drizzle's `.set()`. */
+    toUpdateData(opts: {
+        transformed: ITransformedUpdateData;
+    }): Record<string, any>;
+    /**
+     * Resolves a JSON-path key to its schema PROPERTY name plus the validated path. The property
+     * is what `jsonExpressions` is keyed by, while the emitted SQL quotes the DB column.
+     */
+    private resolveJsonTarget;
+}
+//# sourceMappingURL=update.d.ts.map

package/dist/cjs/relational/core/repositories/dialect/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/dialect/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,KAAK,EAAE,sBAAsB,EAAiB,MAAM,WAAW,CAAC;AASvE;;;;;;GAMG;AACH,8BAAsB,uBAAwB,SAAQ,UAAU;IAC9D;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,GAAG,GAAG;IAEzF,sFAAsF;IACtF,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;IA6C1B,kGAAkG;IAClG,YAAY,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,sBAAsB,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAMhF;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAsC1B"}

package/dist/cjs/relational/core/repositories/dialect/update.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelationalUpdateBuilder = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+const drizzle_orm_1 = require("drizzle-orm");
+const common_1 = require("../common");
+const json_utils_1 = require("./internal/json-utils");
+/**
+ * Splits `data` into plain columns and JSON-path writes, validating every JSON key before any of it
+ * becomes SQL. That validation is why this is a base and not a copied skeleton: an engine composing
+ * through `sql.raw` is injectable the moment it forgets `validateJsonPathComponents`.
+ *
+ * Subclasses supply only the JSON composition: `jsonb_set` on Postgres, `json_set` on SQLite.
+ */
+class RelationalUpdateBuilder extends core_1.BaseHelper {
+    /** Separates regular fields from JSON path updates and builds the SQL expressions. */
+    transform(opts) {
+        const { tableName, schema, data } = opts;
+        const columns = common_1.TableColumnCache.get(schema);
+        if (!columns || Object.keys(columns).length === 0) {
+            throw (0, core_1.getError)({
+                message: `[${this.scope}][transform] Table: ${tableName} | Failed to get table columns`,
+            });
+        }
+        const regularFields = {};
+        const jsonExpressions = {};
+        for (const key in data) {
+            const value = data[key];
+            if (value === undefined) {
+                continue;
+            }
+            if (!(0, json_utils_1.isJsonPath)({ key })) {
+                if (!columns[key]) {
+                    throw (0, core_1.getError)({
+                        message: `[${this.scope}][transform] Table: ${tableName} | Column NOT FOUND | key: '${key}'`,
+                    });
+                }
+                regularFields[key] = value;
+                continue;
+            }
+            const { columnName, path } = this.resolveJsonTarget({ key, columns, tableName });
+            // Each path WRAPS the expression built so far. Restarting from the bare
+            // column would make the second path on one column discard the first.
+            jsonExpressions[columnName] = this.composeJsonSet({
+                target: jsonExpressions[columnName] ?? drizzle_orm_1.sql.identifier(columns[columnName].name),
+                path,
+                value,
+            });
+        }
+        return { regularFields, jsonExpressions };
+    }
+    /** Combines regular fields and JSON expressions into the final payload for Drizzle's `.set()`. */
+    toUpdateData(opts) {
+        const { regularFields, jsonExpressions } = opts.transformed;
+        return { ...regularFields, ...jsonExpressions };
+    }
+    /**
+     * Resolves a JSON-path key to its schema PROPERTY name plus the validated path. The property
+     * is what `jsonExpressions` is keyed by, while the emitted SQL quotes the DB column.
+     */
+    resolveJsonTarget(opts) {
+        const { key, columns, tableName } = opts;
+        const parsed = (0, json_utils_1.parseJsonPath)({ key });
+        const column = columns[parsed.columnName];
+        if (!column) {
+            throw (0, core_1.getError)({
+                message: `[${this.scope}][transform] Table: ${tableName} | Column NOT FOUND | key: '${parsed.columnName}'`,
+            });
+        }
+        // `scope` is the concrete subclass name, so both message
+        // forms keep naming the builder that actually ran.
+        (0, json_utils_1.validateJsonColumnType)({
+            column,
+            columnName: parsed.columnName,
+            tableName,
+            methodName: `${this.scope}.transform`,
+        });
+        (0, json_utils_1.validateJsonPathComponents)({
+            path: parsed.path,
+            tableName,
+            methodName: `${this.scope}.transform`,
+        });
+        if (parsed.path.length === 0) {
+            throw (0, core_1.getError)({
+                message: `[${this.scope}][transform] Table: ${tableName} | Empty JSON path for column '${parsed.columnName}'`,
+            });
+        }
+        return parsed;
+    }
+}
+exports.RelationalUpdateBuilder = RelationalUpdateBuilder;
+//# sourceMappingURL=update.js.map

package/dist/cjs/relational/core/repositories/dialect/update.js.map

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

package/dist/cjs/relational/core/repositories/index.d.ts

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

package/dist/cjs/relational/core/repositories/index.d.ts.map

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

package/dist/cjs/relational/core/repositories/index.js

@@ -0,0 +1,20 @@
+"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("./common"), exports);
+__exportStar(require("./core"), exports);
+__exportStar(require("./dialect"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/relational/core/repositories/index.js.map

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

package/dist/cjs/relational/postgres/datasources/abstract.d.ts

@@ -0,0 +1,18 @@
+import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';
+import type { IRelationalQueryDialect } from '../../../relational/postgres/repositories/common';
+import { BaseRelationalDataSource } from '../../../relational/core/datasources';
+import type { IRelationalQueryExecutor } from '../../../relational/core/repositories/common';
+import type { Pool } from 'pg';
+import type { TRelationalConnector } from './common';
+/**
+ * Postgres branch root: supplies the Postgres dialect and executor on top of the engine-neutral
+ * `BaseRelationalDataSource`. The BEGIN statement stays abstract - `BasePostgresDataSource`
+ * supplies it.
+ */
+export declare abstract class AbstractPostgresDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = Pool> extends BaseRelationalDataSource<Settings, Schema, ConfigurableOptions, Client, TRelationalConnector<Schema>> {
+    private static queryDialect?;
+    private static queryExecutor?;
+    getQueryDialect(): IRelationalQueryDialect;
+    getQueryExecutor(): IRelationalQueryExecutor<TRelationalConnector<Schema>>;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/cjs/relational/postgres/datasources/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../../src/relational/postgres/datasources/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAGzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACtF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;;;GAIG;AACH,8BAAsB,0BAA0B,CAC9C,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,IAAI,CACb,SAAQ,wBAAwB,CAChC,QAAQ,EACR,MAAM,EACN,mBAAmB,EACnB,MAAM,EACN,oBAAoB,CAAC,MAAM,CAAC,CAC7B;IACC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAA0B;IACtD,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAiD;IAErE,eAAe,IAAI,uBAAuB;IAK1C,gBAAgB,IAAI,wBAAwB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;CAMpF"}

package/dist/cjs/relational/postgres/datasources/abstract.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractPostgresDataSource = void 0;
+const query_dialect_1 = require("../../../relational/postgres/repositories/dialect/query-dialect");
+const executor_1 = require("../../../relational/postgres/repositories/executor");
+const datasources_1 = require("../../../relational/core/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() {
+        AbstractPostgresDataSource.queryDialect ??= new query_dialect_1.PostgresQueryDialect();
+        return AbstractPostgresDataSource.queryDialect;
+    }
+    getQueryExecutor() {
+        AbstractPostgresDataSource.queryExecutor ??= new executor_1.PostgresQueryExecutor();
+        return AbstractPostgresDataSource.queryExecutor;
+    }
+}
+exports.AbstractPostgresDataSource = AbstractPostgresDataSource;
+//# sourceMappingURL=abstract.js.map

package/dist/cjs/relational/postgres/datasources/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/relational/postgres/datasources/abstract.ts"],"names":[],"mappings":";;;AAEA,4FAAgG;AAChG,0EAAoF;AACpF,+DAAyE;AAKzE;;;;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/cjs/relational/postgres/datasources/base.d.ts

@@ -0,0 +1,15 @@
+import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';
+import type { Pool } from 'pg';
+import { AbstractPostgresDataSource } from './abstract';
+import type { IDatabaseTransaction, IDatabaseTransactionOptions } from './common';
+/**
+ * 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/cjs/relational/postgres/datasources/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/relational/postgres/datasources/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,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/cjs/relational/postgres/datasources/base.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePostgresDataSource = void 0;
+const abstract_1 = require("./abstract");
+const common_1 = require("./common");
+/**
+ * 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;
+    }
+    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 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.BasePostgresDataSource = BasePostgresDataSource;
+//# sourceMappingURL=base.js.map

package/dist/cjs/relational/postgres/datasources/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/relational/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/cjs/relational/postgres/datasources/common/guards.d.ts

@@ -0,0 +1,8 @@
+import type { ITransaction } from '@venizia/ignis-kernel';
+import type { IDatabaseTransaction } from './types';
+/**
+ * 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/cjs/relational/postgres/datasources/common/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/postgres/datasources/common/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,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/cjs/relational/postgres/datasources/common/guards.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDatabaseTransaction = void 0;
+const common_1 = require("../../../../relational/core/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 (0, common_1.isRelationalTransaction)(transaction);
+};
+exports.isDatabaseTransaction = isDatabaseTransaction;
+//# sourceMappingURL=guards.js.map

package/dist/cjs/relational/postgres/datasources/common/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../../../../src/relational/postgres/datasources/common/guards.ts"],"names":[],"mappings":";;;AACA,iEAA+E;AAG/E;;;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/cjs/relational/postgres/datasources/common/index.d.ts

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

package/dist/cjs/relational/postgres/datasources/common/index.d.ts.map

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

package/dist/cjs/relational/postgres/datasources/common/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("./guards"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/relational/postgres/datasources/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/relational/postgres/datasources/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB"}

package/dist/cjs/relational/postgres/datasources/common/types.d.ts

@@ -0,0 +1,46 @@
+import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';
+import type { IRelationalQueryDialect } from '../../../../relational/postgres/repositories/common';
+import type { IRelationalDataSource, IRelationalTransaction, TRelationalTransactionOptions } from '../../../../relational/core/datasources/common';
+import type { TConstValue } from '@venizia/ignis-helpers/common';
+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.
+ */
+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>>;
+/** @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> = TRelationalConnector<DataSourceSchema>;
+export declare class IsolationLevels {
+    static readonly READ_COMMITTED = "READ COMMITTED";
+    static readonly REPEATABLE_READ = "REPEATABLE READ";
+    static readonly SERIALIZABLE = "SERIALIZABLE";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TIsolationLevel = TConstValue<typeof IsolationLevels>;
+/** Postgres transaction options: a typed `isolationLevel` on top of the string-only neutral one. */
+export interface IDatabaseTransactionOptions extends TRelationalTransactionOptions {
+    isolationLevel?: TIsolationLevel;
+}
+/**
+ * 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;
+}
+/**
+ * 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>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/relational/postgres/datasources/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/postgres/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,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/cjs/relational/postgres/datasources/common/types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsolationLevels = void 0;
+class IsolationLevels {
+    static { this.READ_COMMITTED = 'READ COMMITTED'; }
+    static { this.REPEATABLE_READ = 'REPEATABLE READ'; }
+    static { this.SERIALIZABLE = 'SERIALIZABLE'; }
+    static { this.SCHEME_SET = new Set([
+        this.READ_COMMITTED,
+        this.REPEATABLE_READ,
+        this.SERIALIZABLE,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.IsolationLevels = IsolationLevels;
+//# sourceMappingURL=types.js.map

package/dist/cjs/relational/postgres/datasources/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/relational/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/cjs/relational/postgres/datasources/index.d.ts

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

package/dist/cjs/relational/postgres/datasources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/relational/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/cjs/relational/postgres/datasources/index.js

@@ -0,0 +1,27 @@
+"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 });
+exports.BaseDataSource = void 0;
+__exportStar(require("./abstract"), exports);
+__exportStar(require("./base"), exports);
+__exportStar(require("./common"), exports);
+// `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-connectors/relational`.
+var base_1 = require("./base");
+Object.defineProperty(exports, "BaseDataSource", { enumerable: true, get: function () { return base_1.BasePostgresDataSource; } });
+//# sourceMappingURL=index.js.map