@antelopejs/postgres 0.0.1-stage → 0.2.0

package/dist/implementations/database/writes-insert.d.ts

@@ -0,0 +1,2 @@
+import { type WriteCompiler } from "./writes-shared";
+export declare const InsertWrite: WriteCompiler;

package/dist/implementations/database/writes-insert.js

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InsertWrite = void 0;
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_crypto_1 = require("node:crypto");
+const types_1 = require("./types");
+const stage_1 = require("./stage");
+const ddl_1 = require("./ddl");
+const sql_1 = require("./sql");
+const fields_1 = require("./fields");
+const utils_1 = require("./utils");
+const payload_1 = require("./payload");
+const writes_shared_1 = require("./writes-shared");
+const EXCLUDED_ROW = "EXCLUDED";
+const INSERTED = { id: payload_1.ID_AS_KEY };
+const SIGNATURE_SEPARATOR = ",";
+const SINGLE_GROUP = 1;
+const GROUP_PREFIX = "g";
+const GROUP_RESULT = "SELECT 1";
+function Excluded(column) {
+    return `${EXCLUDED_ROW}.${(0, sql_1.QuoteIdentifier)(column)}`;
+}
+const EXCLUDED_EXTRA = Excluded(utils_1.EXTRA_COLUMN);
+const CONFLICT_MODES = {
+    update: { everyColumn: false, extra: (0, writes_shared_1.MergeExtra)(EXCLUDED_EXTRA) },
+    replace: { everyColumn: true, extra: EXCLUDED_EXTRA },
+};
+function ConflictModeOf(stage) {
+    const conflict = stage.options?.conflict;
+    if (conflict === undefined || conflict === null) {
+        return undefined;
+    }
+    (0, node_assert_1.default)(typeof conflict === "string" && Object.hasOwn(CONFLICT_MODES, conflict), `The '${stage.stage}' stage takes a conflict mode of ${Object.keys(CONFLICT_MODES).join(" or ")}, received ${JSON.stringify(conflict)}`);
+    return CONFLICT_MODES[conflict];
+}
+function Documents(stage) {
+    const argument = stage.args[stage_1.FIRST_OPERAND];
+    const list = Array.isArray(argument) ? argument : [argument];
+    return list.map((entry, position) => {
+        const document = (0, writes_shared_1.AsDocument)(entry);
+        (0, node_assert_1.default)(document, `The '${stage.stage}' stage takes documents, and the one at position ${position} is ${(0, writes_shared_1.DescribeKind)(entry)}`);
+        return document;
+    });
+}
+function SuppliedId(document) {
+    const supplied = Object.hasOwn(document, utils_1.ID_COLUMN)
+        ? document[utils_1.ID_COLUMN]
+        : undefined;
+    if ((0, payload_1.NoIdSupplied)(supplied)) {
+        return undefined;
+    }
+    (0, node_assert_1.default)(typeof supplied === "string", `An inserted document's '${utils_1.ID_COLUMN}' must be a string, received ${typeof supplied}`);
+    return supplied;
+}
+function InsertRowOf(document, shape, context) {
+    const supplied = SuppliedId(document);
+    const id = supplied ?? (0, node_crypto_1.randomUUID)();
+    const generated = supplied === undefined ? (0, sql_1.Param)(context.params, id, types_1.TEXT) : undefined;
+    const split = (0, payload_1.SplitPayload)(document, shape, context, INSERTED);
+    const values = (0, payload_1.MembersByColumn)(split);
+    const key = generated ?? values.get(utils_1.ID_COLUMN);
+    (0, node_assert_1.default)(key, `An inserted row is keyed by the '${utils_1.ID_COLUMN}' its payload supplied or by the one generated for it`);
+    values.delete(utils_1.ID_COLUMN);
+    return { id, key, values, extra: split.extra };
+}
+function BatchColumns(shape, rows) {
+    return (0, fields_1.DeclaredColumns)(shape).filter((column) => rows.some((row) => row.values.has(column)));
+}
+function RowTuple(row, columns, instance) {
+    const declared = columns.map((column) => row.values.get(column)?.sql ?? writes_shared_1.NULL_VALUE);
+    const values = (0, fields_1.PhysicalOrder)(row.key.sql, instance, declared, row.extra?.sql ?? writes_shared_1.EMPTY_EXTRA);
+    return `(${values.join(", ")})`;
+}
+function ConflictClause(columns, mode) {
+    if (!mode) {
+        return "";
+    }
+    const assignments = columns.map((column) => (0, writes_shared_1.Assignment)(column, Excluded(column)));
+    assignments.push((0, writes_shared_1.Assignment)(utils_1.EXTRA_COLUMN, mode.extra));
+    return ` ON CONFLICT (${ddl_1.PRIMARY_KEY_LIST}) DO UPDATE SET ${assignments.join(", ")}`;
+}
+function InsertInto(origin, columns) {
+    const named = (0, fields_1.PhysicalOrder)(utils_1.ID_COLUMN, utils_1.INSTANCE_COLUMN, columns, utils_1.EXTRA_COLUMN).map((column) => (0, sql_1.QuoteIdentifier)(column));
+    return `INSERT INTO ${(0, writes_shared_1.WriteTable)(origin)} (${named.join(", ")})`;
+}
+function GroupStatement(plan, rows) {
+    const shape = plan.origin.shape;
+    const columns = plan.mode?.everyColumn
+        ? (0, fields_1.DeclaredColumns)(shape)
+        : BatchColumns(shape, rows);
+    const tuples = rows.map((row) => RowTuple(row, columns, plan.instance));
+    return `${InsertInto(plan.origin, columns)} VALUES ${tuples.join(", ")}${ConflictClause(columns, plan.mode)}`;
+}
+function RowGroups(plan, rows) {
+    if (!plan.mode || plan.mode.everyColumn) {
+        return [rows];
+    }
+    const groups = new Map();
+    for (const row of rows) {
+        const signature = BatchColumns(plan.origin.shape, [row]).join(SIGNATURE_SEPARATOR);
+        const group = groups.get(signature);
+        if (group) {
+            group.push(row);
+            continue;
+        }
+        groups.set(signature, [row]);
+    }
+    return [...groups.values()];
+}
+function OneStatement(statements) {
+    if (statements.length === SINGLE_GROUP) {
+        return statements[0];
+    }
+    const named = statements.map((statement, index) => `${(0, sql_1.QuoteIdentifier)(`${GROUP_PREFIX}${index}`)} AS (${statement})`);
+    return `WITH ${named.join(", ")} ${GROUP_RESULT}`;
+}
+const InsertWrite = (target, stage, context) => {
+    const instance = (0, writes_shared_1.RequireInstance)(target, stage);
+    const documents = Documents(stage);
+    if (documents.length === 0) {
+        return { sql: "", ids: [] };
+    }
+    const plan = {
+        origin: target.origin,
+        mode: ConflictModeOf(stage),
+        instance: instance.sql,
+    };
+    const rows = documents.map((document) => InsertRowOf(document, target.origin.shape, context));
+    const statements = RowGroups(plan, rows).map((group) => GroupStatement(plan, group));
+    return { sql: OneStatement(statements), ids: rows.map((row) => row.id) };
+};
+exports.InsertWrite = InsertWrite;
+//# sourceMappingURL=writes-insert.js.map

package/dist/implementations/database/writes-insert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes-insert.js","sourceRoot":"","sources":["../../../src/implementations/database/writes-insert.ts"],"names":[],"mappings":"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"}

package/dist/implementations/database/writes-shared.d.ts

@@ -0,0 +1,36 @@
+import type { DecodingContext } from "./context";
+import { type QueryStage } from "./utils";
+import type { InstanceScope, RootSelection } from "./selection";
+import { type Compiled } from "./sql";
+import { type Relation, type TableOrigin } from "./relation";
+import { type RowSource } from "./row-source";
+export interface WriteTarget {
+    relation: Relation;
+    origin: TableOrigin;
+    instance: InstanceScope;
+}
+export declare function WriteTargetOf(root: RootSelection, relation: Relation): WriteTarget;
+export interface WriteStatement {
+    sql: string;
+    ids?: string[];
+    validation?: WriteValidation;
+    returnsIds?: boolean;
+}
+export interface WriteValidation {
+    sql: string;
+    params: unknown[];
+    failures: string[];
+}
+export type WriteCompiler = (target: WriteTarget, stage: QueryStage, context: DecodingContext) => WriteStatement;
+export declare const WRITE_ALIAS = "w0";
+export declare const EMPTY_EXTRA = "'{}'::jsonb";
+export declare const NULL_VALUE = "NULL";
+export declare function WriteTable(origin: TableOrigin): string;
+export declare function WriteRowSource(origin: TableOrigin): RowSource;
+export declare function Assignment(column: string, value: string): string;
+export declare const EXISTING_EXTRA: string;
+export declare function MergeExtra(incoming: string): string;
+export declare function DescribeKind(value: unknown): string;
+export declare function AsDocument(value: unknown): Record<string, unknown> | undefined;
+export declare function RequireInstance(target: WriteTarget, stage: QueryStage): Compiled;
+export declare function RefuseCrossInstance(target: WriteTarget, stage: QueryStage): void;

package/dist/implementations/database/writes-shared.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXISTING_EXTRA = exports.NULL_VALUE = exports.EMPTY_EXTRA = exports.WRITE_ALIAS = void 0;
+exports.WriteTargetOf = WriteTargetOf;
+exports.WriteTable = WriteTable;
+exports.WriteRowSource = WriteRowSource;
+exports.Assignment = Assignment;
+exports.MergeExtra = MergeExtra;
+exports.DescribeKind = DescribeKind;
+exports.AsDocument = AsDocument;
+exports.RequireInstance = RequireInstance;
+exports.RefuseCrossInstance = RefuseCrossInstance;
+const node_assert_1 = __importDefault(require("node:assert"));
+const schema_1 = require("@antelopejs/interface-database/schema");
+const identifier_1 = require("./identifier");
+const utils_1 = require("./utils");
+const sql_1 = require("./sql");
+const relation_1 = require("./relation");
+const row_source_1 = require("./row-source");
+function WriteTargetOf(root, relation) {
+    return {
+        relation,
+        origin: (0, relation_1.RequireOrigin)(relation),
+        instance: root.instance,
+    };
+}
+exports.WRITE_ALIAS = "w0";
+exports.EMPTY_EXTRA = "'{}'::jsonb";
+exports.NULL_VALUE = "NULL";
+function WriteTable(origin) {
+    const table = (0, identifier_1.TableReference)(origin.schemaId, origin.tableId);
+    return `${table} AS ${(0, sql_1.QuoteIdentifier)(exports.WRITE_ALIAS)}`;
+}
+function WriteRowSource(origin) {
+    return new row_source_1.ColumnRowSource((0, row_source_1.AliasedColumns)(exports.WRITE_ALIAS), origin.shape);
+}
+function Assignment(column, value) {
+    return `${(0, sql_1.QuoteIdentifier)(column)} = ${value}`;
+}
+exports.EXISTING_EXTRA = `COALESCE(${(0, sql_1.QualifiedColumn)(exports.WRITE_ALIAS, utils_1.EXTRA_COLUMN)}, ${exports.EMPTY_EXTRA})`;
+function MergeExtra(incoming) {
+    return `(${exports.EXISTING_EXTRA} || ${incoming})`;
+}
+function DescribeKind(value) {
+    return Array.isArray(value) ? "an array" : `a ${typeof value}`;
+}
+function AsDocument(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+function RequireInstance(target, stage) {
+    const scope = target.instance;
+    (0, node_assert_1.default)(scope !== schema_1.CROSS_INSTANCE, `The '${stage.stage}' stage cannot write under CROSS_INSTANCE: name the instance the rows belong to, or omit the instance id for the default one`);
+    return scope;
+}
+function RefuseCrossInstance(target, stage) {
+    RequireInstance(target, stage);
+}
+//# sourceMappingURL=writes-shared.js.map

package/dist/implementations/database/writes-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes-shared.js","sourceRoot":"","sources":["../../../src/implementations/database/writes-shared.ts"],"names":[],"mappings":";;;;;;AAgCA,sCASC;AA6DD,gCAGC;AAWD,wCAEC;AAQD,gCAEC;AAsBD,gCAEC;AAGD,oCAEC;AAWD,gCAOC;AAaD,0CAUC;AAGD,kDAKC;AA9MD,8DAAiC;AACjC,kEAAuE;AAEvE,6CAA8C;AAE9C,mCAAwD;AAExD,+BAAwE;AACxE,yCAA4E;AAC5E,6CAA+E;AAuB/E,SAAgB,aAAa,CAC3B,IAAmB,EACnB,QAAkB;IAElB,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,IAAA,wBAAa,EAAC,QAAQ,CAAC;QAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAkDY,QAAA,WAAW,GAAG,IAAI,CAAC;AACnB,QAAA,WAAW,GAAG,aAAa,CAAC;AAC5B,QAAA,UAAU,GAAG,MAAM,CAAC;AASjC,SAAgB,UAAU,CAAC,MAAmB;IAC5C,MAAM,KAAK,GAAG,IAAA,2BAAc,EAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9D,OAAO,GAAG,KAAK,OAAO,IAAA,qBAAe,EAAC,mBAAW,CAAC,EAAE,CAAC;AACvD,CAAC;AAWD,SAAgB,cAAc,CAAC,MAAmB;IAChD,OAAO,IAAI,4BAAe,CAAC,IAAA,2BAAc,EAAC,mBAAW,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAQD,SAAgB,UAAU,CAAC,MAAc,EAAE,KAAa;IACtD,OAAO,GAAG,IAAA,qBAAe,EAAC,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC;AACjD,CAAC;AAaY,QAAA,cAAc,GAAG,YAAY,IAAA,qBAAe,EAAC,mBAAW,EAAE,oBAAY,CAAC,KAAK,mBAAW,GAAG,CAAC;AASxG,SAAgB,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,sBAAc,OAAO,QAAQ,GAAG,CAAC;AAC9C,CAAC;AAGD,SAAgB,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,KAAK,EAAE,CAAC;AACjE,CAAC;AAWD,SAAgB,UAAU,CACxB,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAaD,SAAgB,eAAe,CAC7B,MAAmB,EACnB,KAAiB;IAEjB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC9B,IAAA,qBAAM,EACJ,KAAK,KAAK,uBAAc,EACxB,QAAQ,KAAK,CAAC,KAAK,8HAA8H,CAClJ,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAGD,SAAgB,mBAAmB,CACjC,MAAmB,EACnB,KAAiB;IAEjB,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/dist/implementations/database/writes.d.ts

@@ -0,0 +1,16 @@
+import type { QueryStage } from "./utils";
+import type { DecodingContext } from "./context";
+import type { WriteCompiler, WriteStatement, WriteTarget } from "./writes-shared";
+interface WriteSpec {
+    compile: WriteCompiler;
+    readsRelation: boolean;
+}
+export type WriteSpecMap = Record<string, WriteSpec>;
+export interface WriteSplit {
+    pipeline: QueryStage[];
+    write?: QueryStage;
+}
+export declare const WRITE_STAGES: WriteSpecMap;
+export declare function SplitWrite(stages: QueryStage[]): WriteSplit;
+export declare function CompileWrite(target: WriteTarget, stage: QueryStage, context: DecodingContext): WriteStatement;
+export {};

package/dist/implementations/database/writes.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WRITE_STAGES = void 0;
+exports.SplitWrite = SplitWrite;
+exports.CompileWrite = CompileWrite;
+const node_assert_1 = __importDefault(require("node:assert"));
+const writes_insert_1 = require("./writes-insert");
+const external_writes_1 = require("./external-writes");
+const writes_atomic_1 = require("./writes-atomic");
+const writes_identity_1 = require("./writes-identity");
+exports.WRITE_STAGES = {
+    [writes_atomic_1.ATOMIC_MUTATION]: { compile: writes_atomic_1.AtomicWrite, readsRelation: false },
+    insert: { compile: writes_insert_1.InsertWrite, readsRelation: false },
+    update: { compile: writes_identity_1.UpdateWrite, readsRelation: true },
+    replace: { compile: writes_identity_1.ReplaceWrite, readsRelation: true },
+    delete: { compile: writes_identity_1.DeleteWrite, readsRelation: true },
+};
+function RefuseWrites(stages) {
+    for (const stage of stages) {
+        (0, node_assert_1.default)(!Object.hasOwn(exports.WRITE_STAGES, stage.stage), `The '${stage.stage}' stage writes and can only be the last stage of a query`);
+    }
+}
+function RefuseDiscardedStages(write, spec, pipeline) {
+    if (spec.readsRelation || pipeline.length === 0) {
+        return;
+    }
+    const discarded = pipeline.map((stage) => `'${stage.stage}'`).join(", ");
+    throw new Error(`The '${write.stage}' stage does not read the rows it is applied to, so every stage before it would be discarded: ${discarded}`);
+}
+function SplitWrite(stages) {
+    const last = stages[stages.length - 1];
+    if (!last || !Object.hasOwn(exports.WRITE_STAGES, last.stage)) {
+        RefuseWrites(stages);
+        return { pipeline: stages };
+    }
+    const pipeline = stages.slice(0, -1);
+    RefuseWrites(pipeline);
+    RefuseDiscardedStages(last, exports.WRITE_STAGES[last.stage], pipeline);
+    return { pipeline, write: last };
+}
+function CompileWrite(target, stage, context) {
+    (0, node_assert_1.default)(Object.hasOwn(exports.WRITE_STAGES, stage.stage), `Unsupported write stage '${stage.stage}'`);
+    if ((0, external_writes_1.IsExternalTarget)(target)) {
+        (0, node_assert_1.default)(Object.hasOwn(external_writes_1.EXTERNAL_WRITES, stage.stage), `The '${stage.stage}' stage is not supported on an external relation`);
+        return external_writes_1.EXTERNAL_WRITES[stage.stage](target, stage, context);
+    }
+    return exports.WRITE_STAGES[stage.stage].compile(target, stage, context);
+}
+//# sourceMappingURL=writes.js.map

package/dist/implementations/database/writes.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { type Options } from "./config";
+export type { MigrationMode, Mode, Options } from "./config";
+export declare function construct(options?: Options): Promise<void>;
+export declare function destroy(): Promise<void>;

package/dist/index.js

@@ -0,0 +1,52 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.construct = construct;
+exports.destroy = destroy;
+const interface_core_1 = require("@antelopejs/interface-core");
+const config_1 = require("./config");
+const connection_1 = require("./connection");
+async function construct(options) {
+    await (0, connection_1.Connect)(options);
+    if (!(0, config_1.IsExternal)()) {
+        (await Promise.resolve().then(() => __importStar(require("./implementations/database/reaper")))).StartReaper();
+    }
+    void (0, interface_core_1.ImplementInterface)(await Promise.resolve().then(() => __importStar(require("@antelopejs/interface-database/query"))), await Promise.resolve().then(() => __importStar(require("./implementations/database/query"))));
+    void (0, interface_core_1.ImplementInterface)(await Promise.resolve().then(() => __importStar(require("@antelopejs/interface-database/schema"))), await Promise.resolve().then(() => __importStar(require("./implementations/database/schema"))));
+}
+async function destroy() {
+    await (0, connection_1.Disconnect)();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,8BAcC;AAED,0BAEC;AAzBD,+DAAgE;AAEhE,qCAAoD;AACpD,6CAAmD;AAI5C,KAAK,UAAU,SAAS,CAAC,OAAiB;IAC/C,MAAM,IAAA,oBAAO,EAAC,OAAO,CAAC,CAAC;IACvB,IAAI,CAAC,IAAA,mBAAU,GAAE,EAAE,CAAC;QAClB,CAAC,wDAAa,mCAAmC,GAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpE,CAAC;IAED,KAAK,IAAA,mCAAkB,EACrB,wDAAa,sCAAsC,GAAC,EACpD,wDAAa,kCAAkC,GAAC,CACjD,CAAC;IACF,KAAK,IAAA,mCAAkB,EACrB,wDAAa,uCAAuC,GAAC,EACrD,wDAAa,mCAAmC,GAAC,CAClD,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,OAAO;IAC3B,MAAM,IAAA,uBAAU,GAAE,CAAC;AACrB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,2 @@
+import { Logging } from "@antelopejs/interface-core/logging";
+export declare const Logger: Logging.Channel;

package/dist/logger.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const logging_1 = require("@antelopejs/interface-core/logging");
+exports.Logger = new logging_1.Logging.Channel("postgres");
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;AAAA,gEAA6D;AAEhD,QAAA,MAAM,GAAG,IAAI,iBAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC"}

package/dist/test/antelope.test.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("@antelopejs/interface-core/config").ConfigInput;
+export default _default;

package/dist/test/antelope.test.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const pg_1 = require("pg");
+const config_1 = require("@antelopejs/interface-core/config");
+const postgresql_1 = require("@testcontainers/postgresql");
+const fixture_1 = require("../test-external/fixture");
+const POSTGRES_IMAGE = "postgres:18-alpine";
+const TEST_DATABASE = "antelopejs_test";
+const EXTERNAL_MODE = "external";
+let container;
+function moduleConfig(config) {
+    return { modules: { local: { config } } };
+}
+async function OwnerUrl() {
+    if (process.env.PG_TEST_URL) {
+        return process.env.PG_TEST_URL;
+    }
+    container = await new postgresql_1.PostgreSqlContainer(POSTGRES_IMAGE)
+        .withDatabase(TEST_DATABASE)
+        .start();
+    return container.getConnectionUri();
+}
+async function Run(url, statements) {
+    const client = new pg_1.Client({ connectionString: url });
+    await client.connect();
+    try {
+        for (const statement of statements) {
+            await client.query(statement);
+        }
+    }
+    finally {
+        await client.end();
+    }
+}
+function WithDatabase(url, database, user) {
+    const target = new URL(url);
+    target.pathname = `/${database}`;
+    if (user) {
+        target.username = user;
+        target.password = fixture_1.READER_PASSWORD;
+    }
+    return target.toString();
+}
+async function ClientDatabase(ownerUrl) {
+    await Run(ownerUrl, [
+        `DROP DATABASE IF EXISTS ${fixture_1.CLIENT_DATABASE}`,
+        `CREATE DATABASE ${fixture_1.CLIENT_DATABASE}`,
+        `DO $$ BEGIN
+       IF NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = '${fixture_1.CLIENT_ROLE}') THEN
+         CREATE ROLE ${fixture_1.CLIENT_ROLE} LOGIN PASSWORD '${fixture_1.READER_PASSWORD}';
+       END IF;
+     END $$`,
+    ]);
+    const clientOwnerUrl = WithDatabase(ownerUrl, fixture_1.CLIENT_DATABASE);
+    await Run(clientOwnerUrl, [
+        ...fixture_1.FIXTURE,
+        ...(0, fixture_1.ReaderGrants)(fixture_1.CLIENT_ROLE),
+        ...(0, fixture_1.WriterGrants)(fixture_1.CLIENT_ROLE),
+    ]);
+    process.env.PG_TEST_CLIENT_OWNER_URL = clientOwnerUrl;
+    return WithDatabase(ownerUrl, fixture_1.CLIENT_DATABASE, fixture_1.CLIENT_ROLE);
+}
+exports.default = (0, config_1.defineConfig)({
+    name: "postgres-test",
+    cacheFolder: ".antelope/cache",
+    modules: {
+        local: {
+            source: { type: "local", path: "." },
+        },
+    },
+    test: {
+        folder: "dist/test",
+        async setup() {
+            const url = await OwnerUrl();
+            if (process.env.PG_TEST_MODE !== EXTERNAL_MODE) {
+                return moduleConfig({ url });
+            }
+            return moduleConfig({
+                url: await ClientDatabase(url),
+                mode: EXTERNAL_MODE,
+            });
+        },
+        async cleanup() {
+            await container?.stop();
+        },
+    },
+});
+//# sourceMappingURL=antelope.test.js.map

package/dist/test/antelope.test.js.map

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

package/dist/test/atomic.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/atomic.test.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const schema_1 = require("@antelopejs/interface-database/schema");
+const schema = new schema_1.Schema("atomic_results", {
+    records: { fields: { value: "string" }, indexes: {} },
+    declared: {
+        fields: { revision: "string", value: "string", updatedAt: "date" },
+        indexes: {},
+    },
+});
+const table = schema.instance("tenant").table("records");
+const ID = "one";
+const update = {
+    type: "update",
+    revisionField: "revision",
+    expectedRevision: "old",
+    nextRevision: "fresh",
+    patch: { value: "after", details: { kept: true } },
+};
+async function Seed(document = {}) {
+    await table.insert({ _id: ID, value: "before", ...document });
+}
+describe("atomic mutation results and scope", () => {
+    beforeEach(async () => {
+        await table.delete();
+    });
+    it("persists inserted overflow revisions and replaces nested fields as a whole", async () => {
+        await Seed({ revision: "old", details: { removed: true } });
+        (0, chai_1.expect)((await table.get(ID))?.revision).to.equal("old");
+        (0, chai_1.expect)(await table.atomicMutation(ID, update)).to.equal("applied");
+        (0, chai_1.expect)(await table.get(ID)).to.include({
+            revision: "fresh",
+            value: "after",
+        });
+        const rows = await table.filter((row) => row.key("revision").eq("fresh"));
+        (0, chai_1.expect)(rows).to.have.length(1);
+        (0, chai_1.expect)(rows[0].revision).to.equal("fresh");
+        (0, chai_1.expect)(rows[0].details).to.deep.equal({ kept: true });
+    });
+    it("bootstraps absent overflow revisions but not stored null or an absent row", async () => {
+        const request = {
+            ...update,
+            expectedRevision: { kind: "missing" },
+        };
+        (0, chai_1.expect)(await table.atomicMutation(ID, request)).to.equal("not-applied");
+        await Seed({ revision: null });
+        (0, chai_1.expect)(await table.atomicMutation(ID, request)).to.equal("not-applied");
+        await table.get(ID).update({ revision: undefined });
+        (0, chai_1.expect)(await table.atomicMutation(ID, request)).to.equal("applied");
+        (0, chai_1.expect)((await table.get(ID))?.revision).to.equal("fresh");
+    });
+    it("rejects missing-revision bootstrap on declared columns", async () => {
+        try {
+            await schema
+                .instance()
+                .table("declared")
+                .atomicMutation(ID, {
+                ...update,
+                expectedRevision: { kind: "missing" },
+            });
+            chai_1.expect.fail("expected unsupported bootstrap");
+        }
+        catch (error) {
+            (0, chai_1.expect)(String(error)).to.include("Missing revision bootstrap is unsupported");
+        }
+    });
+    it("supports the default instance and refuses cross-instance mutation", async () => {
+        const defaults = schema.instance().table("records");
+        await defaults.delete();
+        await defaults.insert({ _id: ID, revision: "old" });
+        (0, chai_1.expect)(await defaults.atomicMutation(ID, update)).to.equal("applied");
+        (0, chai_1.expect)(() => schema
+            .instance(schema_1.CROSS_INSTANCE)
+            .table("records")
+            .atomicMutation(ID, update)).to.throw();
+    });
+});
+describe("atomic scalar equality deletes", () => {
+    beforeEach(async () => {
+        await table.delete();
+    });
+    it("compares declared dates by instant and leaves a changed date untouched", async () => {
+        const declared = schema.instance().table("declared");
+        await declared.delete();
+        const updatedAt = new Date("2026-01-05T10:00:00+02:00");
+        await declared.insert({ _id: ID, updatedAt });
+        (0, chai_1.expect)(await declared.atomicMutation(ID, {
+            type: "deleteIfEqual",
+            field: "updatedAt",
+            expectedValue: new Date("2026-01-05T08:00:01Z"),
+        })).to.equal("not-applied");
+        (0, chai_1.expect)(await declared.atomicMutation(ID, {
+            type: "deleteIfEqual",
+            field: "updatedAt",
+            expectedValue: new Date("2026-01-05T08:00:00Z"),
+        })).to.equal("applied");
+    });
+    it("preserves scalar types in overflow equality and ignores missing fields", async () => {
+        await Seed({ attempts: 7, active: true });
+        (0, chai_1.expect)(await table.atomicMutation(ID, {
+            type: "deleteIfEqual",
+            field: "updatedAt",
+            expectedValue: new Date(),
+        })).to.equal("not-applied");
+        (0, chai_1.expect)(await table.atomicMutation(ID, {
+            type: "deleteIfEqual",
+            field: "attempts",
+            expectedValue: "7",
+        })).to.equal("not-applied");
+        (0, chai_1.expect)(await table.atomicMutation(ID, {
+            type: "deleteIfEqual",
+            field: "active",
+            expectedValue: false,
+        })).to.equal("not-applied");
+        (0, chai_1.expect)(await table.atomicMutation(ID, {
+            type: "deleteIfEqual",
+            field: "attempts",
+            expectedValue: 7,
+        })).to.equal("applied");
+    });
+    it("matches dates stored in overflow by the native insert compiler", async () => {
+        const updatedAt = new Date("2026-02-12T03:04:05Z");
+        await Seed({ updatedAt });
+        (0, chai_1.expect)(await table.atomicMutation(ID, {
+            type: "deleteIfEqual",
+            field: "updatedAt",
+            expectedValue: updatedAt,
+        })).to.equal("applied");
+    });
+});
+//# sourceMappingURL=atomic.test.js.map