@antelopejs/postgres 0.0.1-stage → 0.2.0

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

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

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

@@ -0,0 +1,3 @@
+import type { ClientBase } from "pg";
+import type { ActualTable } from "./ddl";
+export declare function ReadTable(client: ClientBase, schemaName: string, tableName: string): Promise<ActualTable>;

package/dist/implementations/database/introspect.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadTable = ReadTable;
+const COLUMNS_SQL = `
+  SELECT a.attname AS name, format_type(a.atttypid, a.atttypmod) AS type
+  FROM pg_attribute a
+  JOIN pg_class c ON c.oid = a.attrelid
+  JOIN pg_namespace n ON n.oid = c.relnamespace
+  WHERE n.nspname = $1 AND c.relname = $2 AND c.relkind = 'r'
+    AND a.attnum > 0 AND NOT a.attisdropped
+  ORDER BY a.attnum`;
+const INDEXES_SQL = `
+  SELECT c.relname AS name, obj_description(c.oid, 'pg_class') AS signature,
+    i.indisvalid AS valid
+  FROM pg_index i
+  JOIN pg_class c ON c.oid = i.indexrelid
+  JOIN pg_class t ON t.oid = i.indrelid
+  JOIN pg_namespace n ON n.oid = t.relnamespace
+  WHERE n.nspname = $1 AND t.relname = $2 AND NOT i.indisprimary`;
+function ReadIndex(row) {
+    return {
+        name: row.name,
+        signature: row.signature ?? undefined,
+        valid: row.valid,
+    };
+}
+async function ReadTable(client, schemaName, tableName) {
+    const target = [schemaName, tableName];
+    const columns = await client.query(COLUMNS_SQL, target);
+    if (columns.rows.length === 0) {
+        return { columns: [], indexes: [] };
+    }
+    const indexes = await client.query(INDEXES_SQL, target);
+    return { columns: columns.rows, indexes: indexes.rows.map(ReadIndex) };
+}
+//# sourceMappingURL=introspect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.js","sourceRoot":"","sources":["../../../src/implementations/database/introspect.ts"],"names":[],"mappings":";;AAkDA,8BAYC;AAlDD,MAAM,WAAW,GAAG;;;;;;;oBAOA,CAAC;AAErB,MAAM,WAAW,GAAG;;;;;;;iEAO6C,CAAC;AAElE,SAAS,SAAS,CAAC,GAAa;IAC9B,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;QACrC,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC;AACJ,CAAC;AAcM,KAAK,UAAU,SAAS,CAC7B,MAAkB,EAClB,UAAkB,EAClB,SAAiB;IAEjB,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAY,WAAW,EAAE,MAAM,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAW,WAAW,EAAE,MAAM,CAAC,CAAC;IAClE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;AACzE,CAAC"}

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

@@ -0,0 +1,29 @@
+import { type Compiled } from "./sql";
+export declare function TextArray(names: readonly string[]): string;
+export declare const OBJECT_TYPEOF = "object";
+export declare const ARRAY_TYPEOF = "array";
+export declare function GuardJson(value: Compiled, expected: string, body: string): string;
+type ColumnRendering = (column: string) => string;
+export interface HeldValue {
+    value: string;
+    column: string;
+    alias: string;
+    select: ColumnRendering;
+    guard: ColumnRendering;
+}
+export declare function HeldOnce(held: HeldValue): string;
+export declare const VALUE_COLUMN = "value";
+export declare const ORDINAL_COLUMN = "ord";
+export declare const EMPTY_ARRAY = "'[]'::jsonb";
+export declare function WalkColumn(alias: string, name: string): string;
+export declare function Collected(order: string | undefined, target: string, distinct?: boolean): string;
+export interface ElementWalk {
+    func: string;
+    json: string;
+    alias: string;
+    columns: readonly string[];
+    aggregate: string;
+    predicate?: string;
+}
+export declare function Walk(walk: ElementWalk): string;
+export {};

package/dist/implementations/database/jsonb.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMPTY_ARRAY = exports.ORDINAL_COLUMN = exports.VALUE_COLUMN = exports.ARRAY_TYPEOF = exports.OBJECT_TYPEOF = void 0;
+exports.TextArray = TextArray;
+exports.GuardJson = GuardJson;
+exports.HeldOnce = HeldOnce;
+exports.WalkColumn = WalkColumn;
+exports.Collected = Collected;
+exports.Walk = Walk;
+const node_assert_1 = __importDefault(require("node:assert"));
+const types_1 = require("./types");
+const sql_1 = require("./sql");
+function TextArray(names) {
+    const literals = names.map(sql_1.QuoteLiteral);
+    return `array[${literals.join(", ")}]::${(0, types_1.PhysicalType)(types_1.TEXT)}[]`;
+}
+exports.OBJECT_TYPEOF = "object";
+exports.ARRAY_TYPEOF = "array";
+function GuardJson(value, expected, body) {
+    return `(CASE WHEN jsonb_typeof(${value.sql}) = '${expected}' THEN ${body} END)`;
+}
+function HeldOnce(held) {
+    const relation = (0, sql_1.QuoteIdentifier)(held.alias);
+    const column = (0, sql_1.QualifiedColumn)(held.alias, held.column);
+    const source = `(SELECT ${held.value} AS ${(0, sql_1.QuoteIdentifier)(held.column)})`;
+    const selected = held.select(column);
+    return `(SELECT ${selected} FROM ${source} AS ${relation} WHERE ${held.guard(column)})`;
+}
+exports.VALUE_COLUMN = "value";
+exports.ORDINAL_COLUMN = "ord";
+exports.EMPTY_ARRAY = "'[]'::jsonb";
+const ORDINALITY = "WITH ORDINALITY";
+function WalkColumn(alias, name) {
+    return (0, sql_1.QualifiedColumn)(alias, name);
+}
+function Collected(order, target, distinct = false) {
+    (0, node_assert_1.default)(!distinct || order === undefined, "A collected aggregate orders its elements or dedups them, never both");
+    const deduped = distinct ? "DISTINCT " : "";
+    const ordered = order === undefined ? "" : ` ORDER BY ${order}`;
+    return `COALESCE(jsonb_agg(${deduped}${target}${ordered}), ${exports.EMPTY_ARRAY})`;
+}
+function Walk(walk) {
+    const columns = [...walk.columns, exports.ORDINAL_COLUMN]
+        .map(sql_1.QuoteIdentifier)
+        .join(", ");
+    const relation = `${(0, sql_1.QuoteIdentifier)(walk.alias)}(${columns})`;
+    const source = `${walk.func}(${walk.json}) ${ORDINALITY} AS ${relation}`;
+    const where = walk.predicate ? ` WHERE ${walk.predicate}` : "";
+    return `(SELECT ${walk.aggregate} FROM ${source}${where})`;
+}
+//# sourceMappingURL=jsonb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonb.js","sourceRoot":"","sources":["../../../src/implementations/database/jsonb.ts"],"names":[],"mappings":";;;;;;AAWA,8BAGC;AAOD,8BAMC;AA4BD,4BAMC;AAgBD,gCAEC;AAyBD,8BAYC;AAoBD,oBAQC;AAhJD,8DAAiC;AAEjC,mCAA6C;AAC7C,+BAKe;AAGf,SAAgB,SAAS,CAAC,KAAwB;IAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,kBAAY,CAAC,CAAC;IACzC,OAAO,SAAS,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAA,oBAAY,EAAC,YAAI,CAAC,IAAI,CAAC;AAClE,CAAC;AAGY,QAAA,aAAa,GAAG,QAAQ,CAAC;AACzB,QAAA,YAAY,GAAG,OAAO,CAAC;AAGpC,SAAgB,SAAS,CACvB,KAAe,EACf,QAAgB,EAChB,IAAY;IAEZ,OAAO,2BAA2B,KAAK,CAAC,GAAG,QAAQ,QAAQ,UAAU,IAAI,OAAO,CAAC;AACnF,CAAC;AA4BD,SAAgB,QAAQ,CAAC,IAAe;IACtC,MAAM,QAAQ,GAAG,IAAA,qBAAe,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAA,qBAAe,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,WAAW,IAAI,CAAC,KAAK,OAAO,IAAA,qBAAe,EAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;IAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,WAAW,QAAQ,SAAS,MAAM,OAAO,QAAQ,UAAU,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;AAC1F,CAAC;AAEY,QAAA,YAAY,GAAG,OAAO,CAAC;AACvB,QAAA,cAAc,GAAG,KAAK,CAAC;AAUvB,QAAA,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAErC,SAAgB,UAAU,CAAC,KAAa,EAAE,IAAY;IACpD,OAAO,IAAA,qBAAe,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAyBD,SAAgB,SAAS,CACvB,KAAyB,EACzB,MAAc,EACd,QAAQ,GAAG,KAAK;IAEhB,IAAA,qBAAM,EACJ,CAAC,QAAQ,IAAI,KAAK,KAAK,SAAS,EAChC,sEAAsE,CACvE,CAAC;IACF,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,EAAE,CAAC;IAChE,OAAO,sBAAsB,OAAO,GAAG,MAAM,GAAG,OAAO,MAAM,mBAAW,GAAG,CAAC;AAC9E,CAAC;AAoBD,SAAgB,IAAI,CAAC,IAAiB;IACpC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,sBAAc,CAAC;SAC9C,GAAG,CAAC,qBAAe,CAAC;SACpB,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,QAAQ,GAAG,GAAG,IAAA,qBAAe,EAAC,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,GAAG,CAAC;IAC9D,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,OAAO,QAAQ,EAAE,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,OAAO,WAAW,IAAI,CAAC,SAAS,SAAS,MAAM,GAAG,KAAK,GAAG,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,3 @@
+export type ChangeSubscriber = (target?: string) => void;
+export declare function SubscribeToChanges(subscriber: ChangeSubscriber): () => void;
+export declare function EnsureListening(): Promise<void>;

package/dist/implementations/database/listener.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscribeToChanges = SubscribeToChanges;
+exports.EnsureListening = EnsureListening;
+const pg_1 = require("pg");
+const logger_1 = require("../../logger");
+const sql_1 = require("./sql");
+const config_1 = require("../../config");
+const changes_1 = require("./changes");
+const connection_1 = require("../../connection");
+const NOTIFICATION = "notification";
+const ERROR = "error";
+const LISTEN = `LISTEN ${(0, sql_1.QuoteIdentifier)(changes_1.CHANGE_CHANNEL)}`;
+const FIRST_BACKOFF_MS = 50;
+const LARGEST_BACKOFF_MS = 5_000;
+const BACKOFF_FACTOR = 2;
+const LISTENER_FAILED = "the PostgreSQL change listener's connection failed and is being re-established";
+const subscribers = new Set();
+let listening;
+let client;
+let backoffMs = FIRST_BACKOFF_MS;
+let retry;
+let isStopped = false;
+function SubscribeToChanges(subscriber) {
+    subscribers.add(subscriber);
+    return () => {
+        subscribers.delete(subscriber);
+    };
+}
+function Announce(target) {
+    for (const subscriber of subscribers) {
+        subscriber(target);
+    }
+}
+function CaughtUp() {
+    Announce();
+}
+function Connected(created) {
+    return created.connect().then(() => {
+        void created.query(LISTEN);
+    });
+}
+function Reconnect() {
+    if (isStopped || retry) {
+        return;
+    }
+    retry = setTimeout(() => {
+        retry = undefined;
+        listening = Establish().then(CaughtUp, () => {
+            backoffMs = Math.min(backoffMs * BACKOFF_FACTOR, LARGEST_BACKOFF_MS);
+            Reconnect();
+        });
+    }, backoffMs);
+    retry.unref();
+}
+function Failed(err) {
+    logger_1.Logger.Warn(LISTENER_FAILED, err);
+    client = undefined;
+    Reconnect();
+}
+async function Establish() {
+    const created = new pg_1.Client({ connectionString: (0, config_1.GetOptions)().url });
+    created.on(ERROR, Failed);
+    created.on(NOTIFICATION, (message) => {
+        Announce(message.payload);
+    });
+    await Connected(created);
+    client = created;
+    backoffMs = FIRST_BACKOFF_MS;
+}
+function EnsureListening() {
+    isStopped = false;
+    if (!listening) {
+        listening = Establish().catch(Failed);
+    }
+    return listening;
+}
+async function StopListening() {
+    isStopped = true;
+    if (retry) {
+        clearTimeout(retry);
+        retry = undefined;
+    }
+    const open = client;
+    client = undefined;
+    listening = undefined;
+    backoffMs = FIRST_BACKOFF_MS;
+    if (open) {
+        await open.end().catch(() => undefined);
+    }
+}
+(0, connection_1.RegisterBeforeDisconnect)(StopListening);
+//# sourceMappingURL=listener.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listener.js","sourceRoot":"","sources":["../../../src/implementations/database/listener.ts"],"names":[],"mappings":";;AAsCA,gDAKC;AAmED,0CAMC;AApHD,2BAA4B;AAE5B,yCAAsC;AACtC,+BAAwC;AACxC,yCAA0C;AAC1C,uCAA2C;AAC3C,iDAA4D;AAW5D,MAAM,YAAY,GAAG,cAAc,CAAC;AACpC,MAAM,KAAK,GAAG,OAAO,CAAC;AAEtB,MAAM,MAAM,GAAG,UAAU,IAAA,qBAAe,EAAC,wBAAc,CAAC,EAAE,CAAC;AAE3D,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACjC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,MAAM,eAAe,GACnB,gFAAgF,CAAC;AAEnF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;AAEhD,IAAI,SAAoC,CAAC;AACzC,IAAI,MAA0B,CAAC;AAC/B,IAAI,SAAS,GAAG,gBAAgB,CAAC;AACjC,IAAI,KAAiC,CAAC;AACtC,IAAI,SAAS,GAAG,KAAK,CAAC;AAGtB,SAAgB,kBAAkB,CAAC,UAA4B;IAC7D,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5B,OAAO,GAAG,EAAE;QACV,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,MAAe;IAC/B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,UAAU,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAGD,SAAS,QAAQ;IACf,QAAQ,EAAE,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACjC,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAGD,SAAS,SAAS;IAChB,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QACtB,KAAK,GAAG,SAAS,CAAC;QAClB,SAAS,GAAG,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;YAC1C,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,cAAc,EAAE,kBAAkB,CAAC,CAAC;YACrE,SAAS,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,SAAS,CAAC,CAAC;IACd,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,GAAY;IAC1B,eAAM,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IAClC,MAAM,GAAG,SAAS,CAAC;IACnB,SAAS,EAAE,CAAC;AACd,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,MAAM,OAAO,GAAG,IAAI,WAAM,CAAC,EAAE,gBAAgB,EAAE,IAAA,mBAAU,GAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;QACnC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,GAAG,OAAO,CAAC;IACjB,SAAS,GAAG,gBAAgB,CAAC;AAC/B,CAAC;AAkBD,SAAgB,eAAe;IAC7B,SAAS,GAAG,KAAK,CAAC;IAClB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,SAAS,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAGD,KAAK,UAAU,aAAa;IAC1B,SAAS,GAAG,IAAI,CAAC;IACjB,IAAI,KAAK,EAAE,CAAC;QACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,GAAG,SAAS,CAAC;IACpB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC;IACpB,MAAM,GAAG,SAAS,CAAC;IACnB,SAAS,GAAG,SAAS,CAAC;IACtB,SAAS,GAAG,gBAAgB,CAAC;IAC7B,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,IAAA,qCAAwB,EAAC,aAAa,CAAC,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { SchemaDefinition } from "@antelopejs/interface-database/schema";
+import type { SchemaShape } from "./fields";
+import { type TablePlan } from "./ddl";
+export declare function EnsureTriggers(schemaId: string, tableId: string): Promise<void>;
+export declare function ConvergeTables(schemaId: string, schema: SchemaDefinition, shape: SchemaShape): Promise<TablePlan[]>;
+export declare function BuildIndexes(schemaId: string, plans: readonly TablePlan[]): Promise<void>;

package/dist/implementations/database/migrate.js

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnsureTriggers = EnsureTriggers;
+exports.ConvergeTables = ConvergeTables;
+exports.BuildIndexes = BuildIndexes;
+const pg_1 = require("pg");
+const logger_1 = require("../../logger");
+const introspect_1 = require("./introspect");
+const identifier_1 = require("./identifier");
+const utils_1 = require("./utils");
+const instances_1 = require("./instances");
+const config_1 = require("../../config");
+const changes_1 = require("./changes");
+const connection_1 = require("../../connection");
+const ddl_1 = require("./ddl");
+const DUPLICATE_OBJECT_CODES = new Set(["23505", "42P06", "42P07", "42710"]);
+const CONVERGENCE_RETRIES = 2;
+const BEGIN = "BEGIN";
+const COMMIT = "COMMIT";
+const ROLLBACK = "ROLLBACK";
+const UNLIMITED_STATEMENT_TIMEOUT = "SET LOCAL statement_timeout = 0";
+const TRANSACTION_PROLOGUE = [BEGIN, UNLIMITED_STATEMENT_TIMEOUT];
+const TABLES_LOCK_NAMESPACE = "antelopejs:converge:tables:";
+const INDEXES_LOCK_NAMESPACE = "antelopejs:converge:indexes:";
+const TABLES_LOCK_SQL = "SELECT pg_advisory_xact_lock(hashtextextended($1, 0))";
+const TRY_INDEXES_LOCK_SQL = "SELECT pg_try_advisory_lock(hashtextextended($1, 0)) AS locked";
+const INDEXES_UNLOCK_SQL = "SELECT pg_advisory_unlock(hashtextextended($1, 0))";
+const CANCEL_BACKEND_SQL = "SELECT pg_cancel_backend($1)";
+const BACKEND_PID_SQL = "SELECT pg_backend_pid() AS pid";
+const UNLIMITED_SESSION_STATEMENT_TIMEOUT = "SET statement_timeout = 0";
+const RESTORE_SESSION_STATEMENT_TIMEOUT = "RESET statement_timeout";
+const INDEX_BUILD_STOPPED = new Error("PostgreSQL index build stopped: the adapter is disconnecting");
+const ABORTED_TRANSACTION = new Error("PostgreSQL client discarded: its migration transaction could not be rolled back");
+const BOOTSTRAP_STATEMENTS = [
+    ...instances_1.REGISTRY_STATEMENTS,
+    ...changes_1.CHANGE_LOG_STATEMENTS,
+];
+const MEMO_SEPARATOR = "\u0000";
+const NOTHING_TO_CONVERGE = 0;
+const warned = new Set();
+let registryReady;
+let registryFor;
+const triggersReady = new Map();
+const indexBuilds = new Set();
+const indexPhases = new Set();
+function IsDuplicateObject(err) {
+    if (err instanceof pg_1.DatabaseError) {
+        return err.code !== undefined && DUPLICATE_OBJECT_CODES.has(err.code);
+    }
+    return err instanceof Error && IsDuplicateObject(err.cause);
+}
+async function RetryOnDuplicateObject(work) {
+    for (let remaining = CONVERGENCE_RETRIES; remaining > 0; remaining--) {
+        try {
+            return await work();
+        }
+        catch (err) {
+            if (!IsDuplicateObject(err)) {
+                throw err;
+            }
+        }
+    }
+    return work();
+}
+function Describe(cause) {
+    return cause instanceof Error ? cause.message : String(cause);
+}
+function MigrationError(schemaName, statement, cause) {
+    return new Error(`Migrating schema '${schemaName}' failed on statement: ${statement} — ${Describe(cause)}`, { cause });
+}
+async function RunEach(client, schemaName, statements) {
+    for (const statement of statements) {
+        try {
+            await client.query(statement);
+        }
+        catch (err) {
+            throw MigrationError(schemaName, statement, err);
+        }
+    }
+}
+async function Rollback(client) {
+    try {
+        await client.query(ROLLBACK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function InTransaction(schemaName, work) {
+    const client = await (0, connection_1.AcquireClient)();
+    try {
+        await RunEach(client, schemaName, TRANSACTION_PROLOGUE);
+        await work(client);
+        await RunEach(client, schemaName, [COMMIT]);
+    }
+    catch (err) {
+        const rolledBack = await Rollback(client);
+        client.release(rolledBack ? undefined : ABORTED_TRANSACTION);
+        throw err;
+    }
+    client.release();
+}
+async function Apply(schemaName, statements) {
+    if (statements.length === 0) {
+        return;
+    }
+    await InTransaction(schemaName, (client) => RunEach(client, schemaName, statements));
+}
+function EnsureRegistry() {
+    const pool = (0, connection_1.GetPool)();
+    if (registryReady && registryFor === pool) {
+        return registryReady;
+    }
+    triggersReady.clear();
+    const pending = RetryOnDuplicateObject(() => Apply(utils_1.REGISTRY_SCHEMA, BOOTSTRAP_STATEMENTS)).catch((err) => {
+        if (registryReady === pending) {
+            registryReady = undefined;
+            registryFor = undefined;
+        }
+        throw err;
+    });
+    registryReady = pending;
+    registryFor = pool;
+    return pending;
+}
+async function InstallTriggers(schemaId, tableId) {
+    await EnsureRegistry();
+    await Apply((0, identifier_1.SchemaName)(schemaId), (0, changes_1.TriggerStatements)(schemaId, tableId));
+}
+function EnsureTriggers(schemaId, tableId) {
+    const key = `${schemaId}${MEMO_SEPARATOR}${tableId}`;
+    const known = triggersReady.get(key);
+    if (known) {
+        return known;
+    }
+    const pending = InstallTriggers(schemaId, tableId).catch((err) => {
+        if (triggersReady.get(key) === pending) {
+            triggersReady.delete(key);
+        }
+        throw err;
+    });
+    triggersReady.set(key, pending);
+    return pending;
+}
+function WarnOnce(warnings) {
+    for (const warning of warnings) {
+        if (warned.has(warning)) {
+            continue;
+        }
+        warned.add(warning);
+        logger_1.Logger.Warn(warning);
+    }
+}
+function SeedStatements(schemaName) {
+    return [(0, ddl_1.CreateSchemaSql)(schemaName)];
+}
+async function PlanSchema(client, schemaName, plans, mode) {
+    const merged = {
+        statements: SeedStatements(schemaName),
+        warnings: [],
+    };
+    for (const plan of plans) {
+        const actual = await (0, introspect_1.ReadTable)(client, schemaName, plan.table);
+        const table = (0, ddl_1.PlanTable)(schemaName, plan, actual, mode);
+        merged.statements.push(...table.statements);
+        merged.warnings.push(...table.warnings);
+    }
+    return merged;
+}
+function ReportConvergence(schemaName, changed) {
+    if (changed <= NOTHING_TO_CONVERGE) {
+        return;
+    }
+    logger_1.Logger.Info(`converged schema '${schemaName}' in ${changed} statements`);
+}
+function ReportIndexBuilds(schemaName, applied) {
+    if (applied <= NOTHING_TO_CONVERGE) {
+        return;
+    }
+    logger_1.Logger.Info(`converged the indexes of schema '${schemaName}' in ${applied} statements`);
+}
+function LockKey(namespace, schemaName) {
+    return [`${namespace}${schemaName}`];
+}
+function ConvergeTablesLocked(schemaName, plans) {
+    const baseline = SeedStatements(schemaName).length;
+    return InTransaction(schemaName, async (client) => {
+        await client.query(TABLES_LOCK_SQL, LockKey(TABLES_LOCK_NAMESPACE, schemaName));
+        const mode = (0, config_1.GetOptions)().migrations;
+        const changes = await PlanSchema(client, schemaName, plans, mode);
+        await RunEach(client, schemaName, changes.statements);
+        ReportConvergence(schemaName, changes.statements.length - baseline);
+        WarnOnce(changes.warnings);
+    });
+}
+async function ConvergeTables(schemaId, schema, shape) {
+    const schemaName = (0, identifier_1.SchemaName)(schemaId);
+    const plans = (0, ddl_1.BuildSchemaPlan)(schema, shape);
+    await EnsureRegistry();
+    await RetryOnDuplicateObject(() => ConvergeTablesLocked(schemaName, plans));
+    return plans;
+}
+async function PlanIndexPhase(client, schemaName, plans) {
+    const statements = [];
+    for (const plan of plans) {
+        const actual = await (0, introspect_1.ReadTable)(client, schemaName, plan.table);
+        statements.push(...(0, ddl_1.PlanIndexStatements)(schemaName, plan, actual));
+    }
+    return statements;
+}
+async function RunIndexStatements(build, schemaName, statements) {
+    for (const statement of statements) {
+        if (build.isStopping) {
+            throw INDEX_BUILD_STOPPED;
+        }
+        await RunEach(build.client, schemaName, [statement]);
+    }
+}
+async function TryIndexesLock(client, key) {
+    const result = await client.query(TRY_INDEXES_LOCK_SQL, [...key]);
+    return result.rows[0].locked;
+}
+async function BuildIndexesLocked(build, schemaName, plans) {
+    const { client } = build;
+    const key = LockKey(INDEXES_LOCK_NAMESPACE, schemaName);
+    await client.query(UNLIMITED_SESSION_STATEMENT_TIMEOUT);
+    if (await TryIndexesLock(client, key)) {
+        const statements = await PlanIndexPhase(client, schemaName, plans);
+        await RunIndexStatements(build, schemaName, statements);
+        await client.query(INDEXES_UNLOCK_SQL, key);
+        ReportIndexBuilds(schemaName, statements.length);
+    }
+    await client.query(RESTORE_SESSION_STATEMENT_TIMEOUT);
+}
+function AsError(cause) {
+    return cause instanceof Error ? cause : new Error(Describe(cause));
+}
+async function BackendPid(client) {
+    const result = await client.query(BACKEND_PID_SQL);
+    return result.rows[0].pid;
+}
+async function RunIndexPhase(schemaName, plans) {
+    const client = await (0, connection_1.AcquireClient)();
+    const build = { client, pid: 0, isStopping: false };
+    indexBuilds.add(build);
+    try {
+        build.pid = await BackendPid(client);
+        await BuildIndexesLocked(build, schemaName, plans);
+    }
+    catch (err) {
+        client.release(AsError(err));
+        if (build.isStopping) {
+            return;
+        }
+        throw err;
+    }
+    finally {
+        indexBuilds.delete(build);
+    }
+    client.release();
+}
+function ReportIndexFailure(schemaName, err) {
+    logger_1.Logger.Error(`Building the indexes of schema '${schemaName}' failed; the next registration retries it`, err);
+}
+function BuildIndexes(schemaId, plans) {
+    const schemaName = (0, identifier_1.SchemaName)(schemaId);
+    const phase = RunIndexPhase(schemaName, plans).catch((err) => ReportIndexFailure(schemaName, err));
+    indexPhases.add(phase);
+    void phase.finally(() => indexPhases.delete(phase));
+    return phase;
+}
+async function StopIndexBuilds() {
+    const running = [...indexBuilds];
+    for (const build of running) {
+        build.isStopping = true;
+    }
+    await Promise.allSettled(running.map((build) => (0, connection_1.Query)(CANCEL_BACKEND_SQL, [build.pid])));
+    await Promise.allSettled(indexPhases);
+}
+(0, connection_1.RegisterBeforeDisconnect)(StopIndexBuilds);
+//# sourceMappingURL=migrate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/implementations/database/migrate.ts"],"names":[],"mappings":";;AAgPA,wCAiBC;AAkGD,wCAUC;AAkHD,oCAWC;AA1eD,2BAA+D;AAG/D,yCAAsC;AACtC,6CAAyC;AACzC,6CAA0C;AAC1C,mCAA0C;AAE1C,2CAAkD;AAClD,yCAA8D;AAC9D,uCAAqE;AACrE,iDAK0B;AAC1B,+BAMe;AAEf,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC7E,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,MAAM,KAAK,GAAG,OAAO,CAAC;AACtB,MAAM,MAAM,GAAG,QAAQ,CAAC;AACxB,MAAM,QAAQ,GAAG,UAAU,CAAC;AAC5B,MAAM,2BAA2B,GAAG,iCAAiC,CAAC;AACtE,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC;AAElE,MAAM,qBAAqB,GAAG,6BAA6B,CAAC;AAC5D,MAAM,sBAAsB,GAAG,8BAA8B,CAAC;AAC9D,MAAM,eAAe,GAAG,uDAAuD,CAAC;AAChF,MAAM,oBAAoB,GACxB,gEAAgE,CAAC;AACnE,MAAM,kBAAkB,GAAG,oDAAoD,CAAC;AAChF,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAC1D,MAAM,eAAe,GAAG,gCAAgC,CAAC;AACzD,MAAM,mCAAmC,GAAG,2BAA2B,CAAC;AACxE,MAAM,iCAAiC,GAAG,yBAAyB,CAAC;AAuBpE,MAAM,mBAAmB,GAAG,IAAI,KAAK,CACnC,8DAA8D,CAC/D,CAAC;AAEF,MAAM,mBAAmB,GAAG,IAAI,KAAK,CACnC,iFAAiF,CAClF,CAAC;AAMF,MAAM,oBAAoB,GAAsB;IAC9C,GAAG,+BAAmB;IACtB,GAAG,+BAAqB;CACzB,CAAC;AAGF,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEhC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;AACjC,IAAI,aAAwC,CAAC;AAC7C,IAAI,WAA6B,CAAC;AAClC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyB,CAAC;AACvD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAc,CAAC;AAC1C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiB,CAAC;AAE7C,SAAS,iBAAiB,CAAC,GAAY;IACrC,IAAI,GAAG,YAAY,kBAAa,EAAE,CAAC;QACjC,OAAO,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,GAAG,YAAY,KAAK,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAMD,KAAK,UAAU,sBAAsB,CAAI,IAAsB;IAC7D,KAAK,IAAI,SAAS,GAAG,mBAAmB,EAAE,SAAS,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;QACrE,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,cAAc,CACrB,UAAkB,EAClB,SAAiB,EACjB,KAAc;IAEd,OAAO,IAAI,KAAK,CACd,qBAAqB,UAAU,0BAA0B,SAAS,MAAM,QAAQ,CAAC,KAAK,CAAC,EAAE,EACzF,EAAE,KAAK,EAAE,CACV,CAAC;AACJ,CAAC;AAGD,KAAK,UAAU,OAAO,CACpB,MAAkB,EAClB,UAAkB,EAClB,UAA6B;IAE7B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,MAAkB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAMD,KAAK,UAAU,aAAa,CAC1B,UAAkB,EAClB,IAA2C;IAE3C,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAa,GAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC;QACxD,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,MAAM,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAC7D,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,KAAK,CAClB,UAAkB,EAClB,UAA6B;IAE7B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IACD,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CACzC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,IAAA,oBAAO,GAAE,CAAC;IACvB,IAAI,aAAa,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,MAAM,OAAO,GAAkB,sBAAsB,CAAC,GAAG,EAAE,CACzD,KAAK,CAAC,uBAAe,EAAE,oBAAoB,CAAC,CAC7C,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACd,IAAI,aAAa,KAAK,OAAO,EAAE,CAAC;YAC9B,aAAa,GAAG,SAAS,CAAC;YAC1B,WAAW,GAAG,SAAS,CAAC;QAC1B,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;IACH,aAAa,GAAG,OAAO,CAAC;IACxB,WAAW,GAAG,IAAI,CAAC;IACnB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,QAAgB,EAChB,OAAe;IAEf,MAAM,cAAc,EAAE,CAAC;IACvB,MAAM,KAAK,CAAC,IAAA,uBAAU,EAAC,QAAQ,CAAC,EAAE,IAAA,2BAAiB,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1E,CAAC;AAuBD,SAAgB,cAAc,CAC5B,QAAgB,EAChB,OAAe;IAEf,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,cAAc,GAAG,OAAO,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACxE,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC;YACvC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;IACH,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,QAA2B;IAC3C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpB,eAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAGD,SAAS,cAAc,CAAC,UAAkB;IACxC,OAAO,CAAC,IAAA,qBAAe,EAAC,UAAU,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,MAAkB,EAClB,UAAkB,EAClB,KAA2B,EAC3B,IAAmB;IAEnB,MAAM,MAAM,GAAkB;QAC5B,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;QACtC,QAAQ,EAAE,EAAE;KACb,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAS,EAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAA,eAAS,EAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,SAAS,iBAAiB,CAAC,UAAkB,EAAE,OAAe;IAC5D,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;QACnC,OAAO;IACT,CAAC;IACD,eAAM,CAAC,IAAI,CAAC,qBAAqB,UAAU,QAAQ,OAAO,aAAa,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,iBAAiB,CAAC,UAAkB,EAAE,OAAe;IAC5D,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;QACnC,OAAO;IACT,CAAC;IACD,eAAM,CAAC,IAAI,CACT,oCAAoC,UAAU,QAAQ,OAAO,aAAa,CAC3E,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,SAAiB,EAAE,UAAkB;IACpD,OAAO,CAAC,GAAG,SAAS,GAAG,UAAU,EAAE,CAAC,CAAC;AACvC,CAAC;AAGD,SAAS,oBAAoB,CAC3B,UAAkB,EAClB,KAA2B;IAE3B,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IACnD,OAAO,aAAa,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAChD,MAAM,MAAM,CAAC,KAAK,CAChB,eAAe,EACf,OAAO,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAC3C,CAAC;QACF,MAAM,IAAI,GAAG,IAAA,mBAAU,GAAE,CAAC,UAAU,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACtD,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;QACpE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAoBM,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,MAAwB,EACxB,KAAkB;IAElB,MAAM,UAAU,GAAG,IAAA,uBAAU,EAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,IAAA,qBAAe,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,cAAc,EAAE,CAAC;IACvB,MAAM,sBAAsB,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAkB,EAClB,UAAkB,EAClB,KAA2B;IAE3B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAS,EAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,UAAU,CAAC,IAAI,CAAC,GAAG,IAAA,yBAAmB,EAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAGD,KAAK,UAAU,kBAAkB,CAC/B,KAAiB,EACjB,UAAkB,EAClB,UAA6B;IAE7B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,mBAAmB,CAAC;QAC5B,CAAC;QACD,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAkB,EAClB,GAAsB;IAEtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAU,oBAAoB,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/B,CAAC;AAGD,KAAK,UAAU,kBAAkB,CAC/B,KAAiB,EACjB,UAAkB,EAClB,KAA2B;IAE3B,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACzB,MAAM,GAAG,GAAG,OAAO,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACxD,IAAI,MAAM,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QACnE,MAAM,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QACxD,MAAM,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QAC5C,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,MAAkB;IAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAS,eAAe,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5B,CAAC;AAMD,KAAK,UAAU,aAAa,CAC1B,UAAkB,EAClB,KAA2B;IAE3B,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAa,GAAE,CAAC;IACrC,MAAM,KAAK,GAAe,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAChE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,IAAI,CAAC;QACH,KAAK,CAAC,GAAG,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAkB,EAAE,GAAY;IAC1D,eAAM,CAAC,KAAK,CACV,mCAAmC,UAAU,4CAA4C,EACzF,GAAG,CACJ,CAAC;AACJ,CAAC;AAmBD,SAAgB,YAAY,CAC1B,QAAgB,EAChB,KAA2B;IAE3B,MAAM,UAAU,GAAG,IAAA,uBAAU,EAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,CACpE,kBAAkB,CAAC,UAAU,EAAE,GAAG,CAAC,CACpC,CAAC;IACF,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,KAAK,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC;AACf,CAAC;AAGD,KAAK,UAAU,eAAe;IAC5B,MAAM,OAAO,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;IAC1B,CAAC;IACD,MAAM,OAAO,CAAC,UAAU,CACtB,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,kBAAK,EAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAC/D,CAAC;IACF,MAAM,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED,IAAA,qCAAwB,EAAC,eAAe,CAAC,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { Compiled } from "./sql";
+import type { DecodingContext } from "./context";
+import type { TableShape } from "./fields";
+interface PayloadMember {
+    column: string;
+    value: Compiled;
+}
+export interface PayloadSplit {
+    members: PayloadMember[];
+    cleared: string[];
+    extra?: Compiled;
+    removed: string[];
+    identity?: Compiled;
+}
+export declare function MembersByColumn(split: PayloadSplit): Map<string, Compiled>;
+export type IdDisposition = (split: PayloadSplit, value: Compiled) => void;
+export declare const ID_AS_KEY: IdDisposition;
+export declare const ID_AS_ASSERTION: IdDisposition;
+export interface PayloadOptions {
+    id: IdDisposition;
+}
+export declare function NoIdSupplied(value: unknown): boolean;
+export declare function SplitPayload(document: Record<string, unknown>, shape: TableShape, context: DecodingContext, options: PayloadOptions): PayloadSplit;
+export {};