@owlmeans/postgres-resource 0.1.15

package/build/utils/diff.js

@@ -0,0 +1,330 @@
+import { PgIndexMethod } from '../consts.js';
+import { PostgresPlaceholderError } from '../errors.js';
+import { qualify, quoteIdent } from './name.js';
+const literal = (value) => {
+    if (value === null)
+        return 'NULL';
+    if (typeof value === 'number')
+        return `${value}`;
+    if (typeof value === 'boolean')
+        return value ? 'TRUE' : 'FALSE';
+    return `'${value.replace(/'/g, "''")}'`;
+};
+const defaultExpression = (column) => {
+    if (column.defaultRaw != null)
+        return column.defaultRaw;
+    if (column.defaultLiteral !== undefined)
+        return literal(column.defaultLiteral);
+    return undefined;
+};
+/**
+ * Postgres echoes defaults back with an explicit cast — a declared `'active'` comes back
+ * as `'active'::text`. Strip a trailing cast when the literal underneath still matches, so
+ * an unchanged default doesn't look like drift on every boot.
+ */
+const normalizeDefault = (expression) => {
+    if (expression == null)
+        return null;
+    return expression.trim().replace(/::[a-z0-9_ ."\[\]]+$/i, '').trim().toLowerCase();
+};
+const normalizeDefinition = (definition) => definition.replace(/\s+/g, ' ').replace(/ ?, ?/g, ',').trim().toLowerCase();
+const columnList = (columns) => columns.map(quoteIdent).join(', ');
+const indexStatement = (spec, entry) => {
+    const target = entry.expression != null
+        ? `(${entry.expression})`
+        : `(${columnList(entry.columns)})`;
+    const where = entry.where != null ? ` WHERE ${entry.where}` : '';
+    return `CREATE ${entry.unique === true ? 'UNIQUE ' : ''}INDEX ${quoteIdent(entry.name)}`
+        + ` ON ${spec.qualified} USING ${entry.method ?? PgIndexMethod.BTree} ${target}${where}`;
+};
+const columnDefinition = (column) => {
+    const parts = [quoteIdent(column.column), column.sqlType];
+    if (column.notNull)
+        parts.push('NOT NULL');
+    const expression = defaultExpression(column);
+    if (expression != null)
+        parts.push(`DEFAULT ${expression}`);
+    return parts.join(' ');
+};
+/**
+ * Foreign keys are planned separately from the rest of the table, and applied only once
+ * every resource has initialized: a key points at a table another resource owns, and that
+ * resource's own `init()` may not have run yet.
+ *
+ * @throws {PostgresPlaceholderError} when a target can't be resolved.
+ */
+export const planForeignKeys = (spec, context) => spec.references.map(reference => {
+    const column = reference.property != null ? spec.byProperty[reference.property] : undefined;
+    if (column == null) {
+        throw new PostgresPlaceholderError(`fk-unknown-property:${reference.property}`);
+    }
+    let targetSchema = reference.schema ?? spec.schema;
+    let targetTable = reference.table;
+    if (reference.resource != null) {
+        if (context == null) {
+            throw new PostgresPlaceholderError(`fk-no-context:${reference.resource}`);
+        }
+        let target;
+        try {
+            target = context.resource(reference.resource);
+        }
+        catch {
+            throw new PostgresPlaceholderError(`fk-unknown-resource:${reference.resource}`);
+        }
+        if (target.table == null) {
+            throw new PostgresPlaceholderError(`fk-uninitialized:${reference.resource}`);
+        }
+        targetSchema = target.table.schema;
+        targetTable = target.table.table;
+    }
+    if (targetTable == null) {
+        throw new PostgresPlaceholderError(`fk-no-target:${reference.property}`);
+    }
+    const actions = [
+        reference.onDelete != null ? ` ON DELETE ${reference.onDelete}` : '',
+        reference.onUpdate != null ? ` ON UPDATE ${reference.onUpdate}` : ''
+    ].join('');
+    return {
+        kind: 'add-foreign-key',
+        target: reference.name,
+        sql: `ALTER TABLE ${spec.qualified} ADD CONSTRAINT ${quoteIdent(reference.name)}`
+            + ` FOREIGN KEY (${quoteIdent(column.column)})`
+            + ` REFERENCES ${qualify(targetSchema, targetTable)} (${quoteIdent(reference.column)})${actions}`
+    };
+});
+/**
+ * Compare the compiled specification against the live table and produce the ordered DDL
+ * that converges one onto the other.
+ *
+ * Statement order is load bearing:
+ *  - `DROP COLUMN` is last, because a `USING` cast or a backfill may legitimately read a
+ *    column that is about to disappear.
+ *  - A primary key constraint is never dropped: it cascades into every referencing key and
+ *    can't be undone inside the same transaction once dependents exist.
+ *
+ * Foreign keys are not part of the plan at all — see {@link planForeignKeys}.
+ */
+export const planSync = (spec, live, additive = false) => {
+    if (!live.exists) {
+        const constraints = [];
+        if (spec.primaryKey.length > 0) {
+            constraints.push(`CONSTRAINT ${quoteIdent(`${spec.table}_pkey`)} PRIMARY KEY (${columnList(spec.primaryKey)})`);
+        }
+        for (const unique of spec.uniques) {
+            constraints.push(`CONSTRAINT ${quoteIdent(unique.name)} UNIQUE (${columnList(unique.columns)})`);
+        }
+        for (const check of spec.checks) {
+            constraints.push(`CONSTRAINT ${quoteIdent(check.name)} CHECK (${check.expression})`);
+        }
+        const statements = [{
+                kind: 'create-table',
+                target: spec.table,
+                sql: `CREATE TABLE ${spec.qualified} (\n  `
+                    + [...spec.columns.map(columnDefinition), ...constraints].join(',\n  ')
+                    + '\n)'
+            }];
+        for (const entry of spec.indexes) {
+            statements.push({ kind: 'create-index', target: entry.name, sql: indexStatement(spec, entry) });
+        }
+        return { fresh: true, statements };
+    }
+    const statements = [];
+    const byName = {};
+    for (const column of live.columns) {
+        byName[column.name] = column;
+    }
+    const managed = spec.columns.filter(column => column.managed);
+    /** 1. Columns the table doesn't have yet — always added nullable so existing rows survive. */
+    for (const column of managed) {
+        if (byName[column.column] != null) {
+            continue;
+        }
+        const expression = defaultExpression(column);
+        statements.push({
+            kind: 'add-column',
+            target: column.column,
+            sql: `ALTER TABLE ${spec.qualified} ADD COLUMN ${quoteIdent(column.column)} ${column.sqlType}`
+                + (expression != null ? ` DEFAULT ${expression}` : '')
+        });
+        if (column.notNull) {
+            if (expression == null) {
+                statements.push({
+                    kind: 'backfill',
+                    target: column.column,
+                    sql: `UPDATE ${spec.qualified} SET ${quoteIdent(column.column)} = ${fallback(column)}`
+                        + ` WHERE ${quoteIdent(column.column)} IS NULL`
+                });
+            }
+            statements.push({
+                kind: 'set-not-null',
+                target: column.column,
+                sql: `ALTER TABLE ${spec.qualified} ALTER COLUMN ${quoteIdent(column.column)} SET NOT NULL`
+            });
+        }
+    }
+    /** 2-4. Type, nullability and default drift on columns that already exist. */
+    for (const column of managed) {
+        const existing = byName[column.column];
+        if (existing == null) {
+            continue;
+        }
+        if (!additive && existing.type !== column.sqlType) {
+            const using = column.using ?? `${quoteIdent(column.column)}::${column.sqlType}`;
+            statements.push({
+                kind: 'alter-type',
+                target: column.column,
+                sql: `ALTER TABLE ${spec.qualified} ALTER COLUMN ${quoteIdent(column.column)}`
+                    + ` TYPE ${column.sqlType} USING ${using}`
+            });
+        }
+        const expression = defaultExpression(column);
+        if (normalizeDefault(expression) !== normalizeDefault(existing.defaultExpr)) {
+            statements.push(expression != null
+                ? {
+                    kind: 'set-default',
+                    target: column.column,
+                    sql: `ALTER TABLE ${spec.qualified} ALTER COLUMN ${quoteIdent(column.column)}`
+                        + ` SET DEFAULT ${expression}`
+                }
+                : {
+                    kind: 'set-default',
+                    target: column.column,
+                    sql: `ALTER TABLE ${spec.qualified} ALTER COLUMN ${quoteIdent(column.column)} DROP DEFAULT`
+                });
+        }
+        if (column.notNull !== existing.notNull) {
+            if (column.notNull) {
+                statements.push({
+                    kind: 'backfill',
+                    target: column.column,
+                    sql: `UPDATE ${spec.qualified} SET ${quoteIdent(column.column)}`
+                        + ` = ${expression ?? fallback(column)} WHERE ${quoteIdent(column.column)} IS NULL`
+                });
+            }
+            statements.push({
+                kind: column.notNull ? 'set-not-null' : 'drop-not-null',
+                target: column.column,
+                sql: `ALTER TABLE ${spec.qualified} ALTER COLUMN ${quoteIdent(column.column)}`
+                    + ` ${column.notNull ? 'SET' : 'DROP'} NOT NULL`
+            });
+        }
+    }
+    /** 5. Unique and check constraints. Primary keys are deliberately excluded. */
+    const desiredConstraints = {};
+    for (const unique of spec.uniques) {
+        desiredConstraints[unique.name] = `UNIQUE (${columnList(unique.columns)})`;
+    }
+    for (const check of spec.checks) {
+        desiredConstraints[check.name] = `CHECK ((${check.expression}))`;
+    }
+    const liveConstraints = {};
+    for (const constraint of live.constraints) {
+        if (constraint.type === 'p' || constraint.type === 'f') {
+            continue;
+        }
+        liveConstraints[constraint.name] = constraint.definition;
+    }
+    for (const [name, definition] of Object.entries(liveConstraints)) {
+        const desired = desiredConstraints[name];
+        if (desired != null && normalizeDefinition(desired) === normalizeDefinition(definition)) {
+            continue;
+        }
+        if (desired == null && additive) {
+            continue;
+        }
+        if (desired == null && !isGenerated(name, spec)) {
+            /** A constraint nobody declared was added by hand — leave it alone. */
+            continue;
+        }
+        statements.push({
+            kind: 'drop-constraint',
+            target: name,
+            sql: `ALTER TABLE ${spec.qualified} DROP CONSTRAINT ${quoteIdent(name)}`
+        });
+    }
+    for (const [name, definition] of Object.entries(desiredConstraints)) {
+        const existing = liveConstraints[name];
+        if (existing != null && normalizeDefinition(existing) === normalizeDefinition(definition)) {
+            continue;
+        }
+        if (existing != null && additive) {
+            continue;
+        }
+        statements.push({
+            kind: 'add-constraint',
+            target: name,
+            sql: `ALTER TABLE ${spec.qualified} ADD CONSTRAINT ${quoteIdent(name)} ${definition}`
+        });
+    }
+    /** 6. Indexes. Constraint backed indexes are owned by their constraint, not by us. */
+    const constraintBacked = live.constraints.map(constraint => constraint.name);
+    const desiredIndexes = {};
+    for (const entry of spec.indexes) {
+        desiredIndexes[entry.name] = indexStatement(spec, entry);
+    }
+    for (const existing of live.indexes) {
+        if (constraintBacked.includes(existing.name)) {
+            continue;
+        }
+        const desired = desiredIndexes[existing.name];
+        if (desired != null && normalizeDefinition(desired) === normalizeDefinition(existing.definition)) {
+            continue;
+        }
+        if (desired == null && (additive || !isGenerated(existing.name, spec))) {
+            continue;
+        }
+        statements.push({
+            kind: 'drop-index',
+            target: existing.name,
+            sql: `DROP INDEX ${qualify(spec.schema, existing.name)}`
+        });
+    }
+    for (const [name, statement] of Object.entries(desiredIndexes)) {
+        const existing = live.indexes.find(entry => entry.name === name);
+        if (existing != null && normalizeDefinition(existing.definition) === normalizeDefinition(statement)) {
+            continue;
+        }
+        if (constraintBacked.includes(name)) {
+            continue;
+        }
+        statements.push({ kind: 'create-index', target: name, sql: statement });
+    }
+    /** 7. Drops, last and only in full mode. */
+    if (!additive) {
+        const keep = [...managed.map(column => column.column), ...spec.unmanaged];
+        for (const existing of live.columns) {
+            if (keep.includes(existing.name) || existing.generated !== '') {
+                continue;
+            }
+            statements.push({
+                kind: 'drop-column',
+                target: existing.name,
+                destructive: true,
+                sql: `ALTER TABLE ${spec.qualified} DROP COLUMN ${quoteIdent(existing.name)}`
+            });
+        }
+    }
+    return { fresh: false, statements };
+};
+/** A name this package would have generated is a name this package may drop. */
+const isGenerated = (name, spec) => name.startsWith(`${spec.table}_`);
+/** Value used to fill an existing row before a column becomes `NOT NULL`. */
+const fallback = (column) => {
+    if (column.array)
+        return `'{}'::${column.sqlType}`;
+    if (column.jsonb)
+        return `'{}'::jsonb`;
+    switch (column.jsonType) {
+        case 'number':
+        case 'integer':
+        case 'bigint':
+            return '0';
+        case 'boolean':
+            return 'FALSE';
+        case 'date':
+            return 'now()';
+        default:
+            return `''::${column.sqlType}`;
+    }
+};
+//# sourceMappingURL=diff.js.map

package/build/utils/diff.js.map

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

package/build/utils/index.d.ts

@@ -0,0 +1,12 @@
+export * from './criteria.js';
+export * from './diff.js';
+export * from './introspect.js';
+export * from './life-cycle.js';
+export * from './marshal.js';
+export * from './migrations.js';
+export * from './name.js';
+export * from './schema.js';
+export * from './sql.js';
+export * from './sync.js';
+export * from './table.js';
+//# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/build/utils/index.js

@@ -0,0 +1,12 @@
+export * from './criteria.js';
+export * from './diff.js';
+export * from './introspect.js';
+export * from './life-cycle.js';
+export * from './marshal.js';
+export * from './migrations.js';
+export * from './name.js';
+export * from './schema.js';
+export * from './sql.js';
+export * from './sync.js';
+export * from './table.js';
+//# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/build/utils/introspect.d.ts

@@ -0,0 +1,7 @@
+import type { PoolClient } from 'pg';
+import type { LiveTable } from '../types.js';
+/** Read the table exactly as Postgres currently holds it. */
+export declare const introspectTable: (client: PoolClient, schema: string, table: string, qualified: string) => Promise<LiveTable>;
+/** Count the rows a destructive step would lose, so the boot log can say how much. */
+export declare const countNonNull: (client: PoolClient, qualified: string, column: string) => Promise<number>;
+//# sourceMappingURL=introspect.d.ts.map

package/build/utils/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../src/utils/introspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAEpC,OAAO,KAAK,EAAyC,SAAS,EAAE,MAAM,aAAa,CAAA;AAkCnF,6DAA6D;AAC7D,eAAO,MAAM,eAAe,GAC1B,QAAQ,UAAU,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,WAAW,MAAM,KACnE,OAAO,CAAC,SAAS,CA+BnB,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,YAAY,GACvB,QAAQ,UAAU,EAAE,WAAW,MAAM,EAAE,QAAQ,MAAM,KACpD,OAAO,CAAC,MAAM,CAWhB,CAAA"}

package/build/utils/introspect.js

@@ -0,0 +1,70 @@
+/**
+ * `pg_attribute` + `format_type` rather than `information_schema.columns`, because it
+ * returns one canonical type string with the typmod already baked in
+ * (`character varying(320)`). `information_schema` splits the same information across
+ * four columns and reports every array as `ARRAY`, which no comparison can use.
+ */
+const COLUMNS = `
+  SELECT a.attname                            AS name,
+         format_type(a.atttypid, a.atttypmod) AS type,
+         a.attnotnull                         AS not_null,
+         pg_get_expr(d.adbin, d.adrelid)      AS default_expr,
+         a.attidentity                        AS identity,
+         a.attgenerated                       AS generated,
+         a.attnum                             AS ordinal
+    FROM pg_attribute a
+    LEFT JOIN pg_attrdef d ON d.adrelid = a.attrelid AND d.adnum = a.attnum
+   WHERE a.attrelid = to_regclass($1) AND a.attnum > 0 AND NOT a.attisdropped
+   ORDER BY a.attnum
+`;
+const INDEXES = `
+  SELECT indexname AS name, indexdef AS definition
+    FROM pg_indexes
+   WHERE schemaname = $1 AND tablename = $2
+`;
+const CONSTRAINTS = `
+  SELECT c.conname AS name, c.contype AS type, pg_get_constraintdef(c.oid) AS definition
+    FROM pg_constraint c
+   WHERE c.conrelid = to_regclass($1)
+`;
+/** Read the table exactly as Postgres currently holds it. */
+export const introspectTable = async (client, schema, table, qualified) => {
+    const exists = await client.query('SELECT to_regclass($1) IS NOT NULL AS present', [qualified]);
+    if (exists.rows[0]?.present !== true) {
+        return { exists: false, columns: [], indexes: [], constraints: [] };
+    }
+    /**
+     * Sequential, not `Promise.all`: this is one checked out connection, and a connection
+     * runs one statement at a time. Overlapping them only queues them behind each other —
+     * and node-postgres deprecated tolerating it.
+     */
+    const columns = await client.query(COLUMNS, [qualified]);
+    const indexes = await client.query(INDEXES, [schema, table]);
+    const constraints = await client.query(CONSTRAINTS, [qualified]);
+    return {
+        exists: true,
+        columns: columns.rows.map(row => ({
+            name: row.name,
+            type: row.type,
+            notNull: row.not_null,
+            defaultExpr: row.default_expr,
+            identity: row.identity ?? '',
+            generated: row.generated ?? '',
+            ordinal: row.ordinal
+        })),
+        indexes: indexes.rows,
+        constraints: constraints.rows
+    };
+};
+/** Count the rows a destructive step would lose, so the boot log can say how much. */
+export const countNonNull = async (client, qualified, column) => {
+    try {
+        const result = await client.query(`SELECT count(*)::text AS count FROM ${qualified} WHERE "${column.replace(/"/g, '""')}" IS NOT NULL`);
+        return parseInt(result.rows[0]?.count ?? '0', 10);
+    }
+    catch {
+        /** Never let a diagnostic read break reconciliation. */
+        return -1;
+    }
+};
+//# sourceMappingURL=introspect.js.map

package/build/utils/introspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.js","sourceRoot":"","sources":["../../src/utils/introspect.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;CAYf,CAAA;AAED,MAAM,OAAO,GAAG;;;;CAIf,CAAA;AAED,MAAM,WAAW,GAAG;;;;CAInB,CAAA;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,MAAkB,EAAE,MAAc,EAAE,KAAa,EAAE,SAAiB,EAChD,EAAE;IACtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B,+CAA+C,EAAE,CAAC,SAAS,CAAC,CAC7D,CAAA;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAA;IACrE,CAAC;IAED;;;;OAIG;IACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAa,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IACpE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAY,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IACvE,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,KAAK,CAAiB,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IAEhF,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAG,GAAwC,CAAC,QAAQ;YAC3D,WAAW,EAAG,GAAkD,CAAC,YAAY;YAC7E,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;YAC5B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;YAC9B,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,WAAW,EAAE,WAAW,CAAC,IAAI;KAC9B,CAAA;AACH,CAAC,CAAA;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,MAAkB,EAAE,SAAiB,EAAE,MAAc,EACpC,EAAE;IACnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B,uCAAuC,SAAS,WAAW,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CACrG,CAAA;QAED,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;QACxD,OAAO,CAAC,CAAC,CAAA;IACX,CAAC;AACH,CAAC,CAAA"}

package/build/utils/life-cycle.d.ts

@@ -0,0 +1,39 @@
+import type { BasicContext } from '@owlmeans/context';
+import type { DbConfig, MigrationReport, ResourceRecord } from '@owlmeans/resource';
+import type { PgRuntimeTable, PostgresDb, PostgresResource, TableSpec } from '../types.js';
+export interface TableInit {
+    spec: TableSpec;
+    /** The Drizzle table CRUD is built against. */
+    entity: PgRuntimeTable;
+    reports: MigrationReport[];
+}
+/**
+ * Bring a resource's table to the shape its schema declares, then hand back everything the
+ * resource needs to query it. The Postgres counterpart of mongo's `initializeCollection`.
+ *
+ * The whole sequence runs inside a session level advisory lock keyed on the qualified table
+ * name, so replicas booting simultaneously converge one at a time instead of racing each
+ * other's DDL — a race mongo's converge-on-boot leaves open.
+ *
+ * Order is deliberate:
+ *
+ *  1. probe for the table
+ *  2. absent → *baseline* every registered migration; present → run the `pre` ones
+ *  3. reconcile structure against the schema
+ *  4. present → run the `post` migrations
+ *  5. queue foreign keys for after every resource has initialized
+ *
+ * Step 2 is what stops the two mechanisms colliding. On a fresh deployment the table is
+ * created directly to its final shape, so migrations that would have produced that shape
+ * are recorded as satisfied rather than replayed against a table that already matches.
+ */
+export declare const initializeTable: (db: PostgresDb, config: DbConfig, resource: PostgresResource<ResourceRecord>, context: BasicContext<any>, defer: (task: () => Promise<void>) => void) => Promise<TableInit>;
+/**
+ * Add the foreign keys the schema declares, skipping any Postgres already holds.
+ *
+ * Constraints are compared by name only. A key whose *definition* drifted has to be dropped
+ * by hand or in a migration: `ALTER TABLE ... DROP CONSTRAINT` on a foreign key is not a
+ * change worth making on a boot nobody is watching.
+ */
+export declare const applyForeignKeys: (db: PostgresDb, spec: TableSpec, context: BasicContext<any>) => Promise<void>;
+//# sourceMappingURL=life-cycle.d.ts.map

package/build/utils/life-cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"life-cycle.d.ts","sourceRoot":"","sources":["../../src/utils/life-cycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAMnF,OAAO,KAAK,EACV,cAAc,EAAE,UAAU,EAAgB,gBAAgB,EAAE,SAAS,EACtE,MAAM,aAAa,CAAA;AAUpB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAA;IACf,+CAA+C;IAC/C,MAAM,EAAE,cAAc,CAAA;IACtB,OAAO,EAAE,eAAe,EAAE,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,GAC1B,IAAI,UAAU,EAAE,QAAQ,QAAQ,EAAE,UAAU,gBAAgB,CAAC,cAAc,CAAC,EAC5E,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,KACrE,OAAO,CAAC,SAAS,CA0DnB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,IAAI,UAAU,EAAE,MAAM,SAAS,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,KAC1D,OAAO,CAAC,IAAI,CAmBd,CAAA"}

package/build/utils/life-cycle.js

@@ -0,0 +1,119 @@
+import { MigrationStage, runMigrations } from '@owlmeans/resource';
+import { DEF_MIGRATIONS_TABLE, PgAutoSync } from '../consts.js';
+import { getDeclaration } from '../declarations.js';
+import { describePgError, pgErrorToResourceError } from '../errors.js';
+import { planForeignKeys, planSync } from './diff.js';
+import { introspectTable } from './introspect.js';
+import { makeMigrationStore } from './migrations.js';
+import { pgTableName } from './name.js';
+import { schemaToTableSpec } from './schema.js';
+import { refOf, resolvePlaceholders } from './sql.js';
+import { acquireLock, applyPlan, ensureSchema, releaseLock } from './sync.js';
+import { specToTable } from './table.js';
+/**
+ * Bring a resource's table to the shape its schema declares, then hand back everything the
+ * resource needs to query it. The Postgres counterpart of mongo's `initializeCollection`.
+ *
+ * The whole sequence runs inside a session level advisory lock keyed on the qualified table
+ * name, so replicas booting simultaneously converge one at a time instead of racing each
+ * other's DDL — a race mongo's converge-on-boot leaves open.
+ *
+ * Order is deliberate:
+ *
+ *  1. probe for the table
+ *  2. absent → *baseline* every registered migration; present → run the `pre` ones
+ *  3. reconcile structure against the schema
+ *  4. present → run the `post` migrations
+ *  5. queue foreign keys for after every resource has initialized
+ *
+ * Step 2 is what stops the two mechanisms colliding. On a fresh deployment the table is
+ * created directly to its final shape, so migrations that would have produced that shape
+ * are recorded as satisfied rather than replayed against a table that already matches.
+ */
+export const initializeTable = async (db, config, resource, context, defer) => {
+    const declaration = getDeclaration(resource.alias);
+    const meta = (config.meta ?? {});
+    const mode = meta.autoSync ?? PgAutoSync.Full;
+    const spec = schemaToTableSpec(resource.alias, resource.schema ?? declaration.schema, db.schema, pgTableName(config, resource), mode !== PgAutoSync.Off, declaration.indexes);
+    const entity = specToTable(spec);
+    const reports = [];
+    const client = await db.pool.connect();
+    try {
+        await acquireLock(client, spec.qualified);
+        await ensureSchema(client, spec.schema);
+        const resolve = (text) => resolvePlaceholders(text, context, spec);
+        const ref = (alias) => refOf(context, spec, alias);
+        const store = makeMigrationStore(client, spec, DEF_MIGRATIONS_TABLE, resolve, ref);
+        const fresh = !(await introspectTable(client, spec.schema, spec.table, spec.qualified)).exists;
+        reports.push(await runMigrations(resource.alias, declaration.migrations, store, fresh
+            ? { baseline: true }
+            : { stage: MigrationStage.Pre }));
+        if (spec.autoSync) {
+            /** Re-read: a `pre` migration may have reshaped exactly what the diff is about to compare. */
+            const live = await introspectTable(client, spec.schema, spec.table, spec.qualified);
+            const plan = planSync(spec, live, mode === PgAutoSync.Additive);
+            await applyPlan(client, spec, plan);
+        }
+        if (!fresh) {
+            reports.push(await runMigrations(resource.alias, declaration.migrations, store, { stage: MigrationStage.Post }));
+        }
+        for (const report of reports) {
+            if (report.applied.length > 0) {
+                console.log(`@owlmeans/postgres-resource: ${spec.qualified} applied ${report.stage} migrations —`
+                    + ` ${report.applied.join(', ')}`);
+            }
+        }
+    }
+    finally {
+        await releaseLock(client, spec.qualified);
+        client.release();
+    }
+    if (spec.references.length > 0) {
+        defer(async () => { await applyForeignKeys(db, spec, context); });
+    }
+    return { spec, entity, reports };
+};
+/**
+ * Add the foreign keys the schema declares, skipping any Postgres already holds.
+ *
+ * Constraints are compared by name only. A key whose *definition* drifted has to be dropped
+ * by hand or in a migration: `ALTER TABLE ... DROP CONSTRAINT` on a foreign key is not a
+ * change worth making on a boot nobody is watching.
+ */
+export const applyForeignKeys = async (db, spec, context) => {
+    const client = await db.pool.connect();
+    try {
+        const statements = planForeignKeys(spec, context);
+        const live = await introspectTable(client, spec.schema, spec.table, spec.qualified);
+        if (!live.exists) {
+            return;
+        }
+        const present = live.constraints.map(constraint => constraint.name);
+        for (const statement of statements) {
+            if (present.includes(statement.target)) {
+                continue;
+            }
+            await apply(client, spec, statement.sql);
+        }
+    }
+    finally {
+        client.release();
+    }
+};
+const apply = async (client, spec, statement) => {
+    try {
+        await client.query(statement);
+    }
+    catch (error) {
+        const translated = pgErrorToResourceError(error);
+        /**
+         * A foreign key failing means live rows point at nothing. That's a data problem the
+         * boot can't fix, and refusing to start is better than starting with the constraint
+         * quietly missing.
+         */
+        throw Object.assign(translated, {
+            message: `${spec.qualified}: ${describePgError(error)} — statement: ${statement}`
+        });
+    }
+};
+//# sourceMappingURL=life-cycle.js.map

package/build/utils/life-cycle.js.map

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