@owlmeans/postgres-resource 0.1.15

package/build/types.d.ts

@@ -0,0 +1,273 @@
+import type { DbLocker, ListCriteria, ListOptions, MigrationRegistry, MigrationStage, Resource, ResourceDbService, ResourceLocker, ResourceRecord } from '@owlmeans/resource';
+import type { AnySchema } from 'ajv';
+import type { Pool, PoolClient, QueryResultRow } from 'pg';
+import type { NodePgDatabase } from 'drizzle-orm/node-postgres';
+import type { PgAutoSync, PgIndexMethod, PgReferentialAction } from './consts.js';
+/**
+ * The handle {@link PostgresDbService.db} resolves to. Carries the pool alongside the
+ * query builder because structure reconciliation, advisory locking and custom SQL all
+ * need a raw session that Drizzle doesn't expose.
+ */
+export interface PostgresDb {
+    /** Drizzle bound to this config alias' pool. */
+    drizzle: NodePgDatabase<Record<string, never>>;
+    pool: Pool;
+    /** The Postgres SCHEMA — i.e. `service.name(alias)`, layer suffixed. */
+    schema: string;
+    /** The Postgres DATABASE — i.e. `config.meta.database`. Never layer suffixed. */
+    database: string;
+}
+export interface PostgresDbService extends ResourceDbService<PostgresDb, Pool>, DbLocker<ResourceRecord> {
+    /** Fully qualified `"schema"."table"` of a registered postgres resource. */
+    qualify: (resourceAlias: string, configAlias?: string) => string;
+    /** Parameterised query straight on the pool — `$1` style placeholders, values never interpolated. */
+    query: <Row extends QueryResultRow = QueryResultRow>(text: string, params?: unknown[], configAlias?: string) => Promise<Row[]>;
+    transaction: <R>(fn: (tx: PostgresTx) => Promise<R>, configAlias?: string) => Promise<R>;
+    /**
+     * Work held back until every resource has initialized — foreign keys whose target table
+     * belongs to a resource whose own `init()` may not have run yet. Drained by the Loading
+     * middleware `appendPostgres` registers.
+     */
+    defer: (configAlias: string, task: () => Promise<void>) => void;
+    /** Run every task {@link defer} has queued for a config alias, then clear the queue. */
+    drain: (configAlias?: string) => Promise<void>;
+}
+/** `DbConfig.meta` shape this package understands. */
+export interface PostgresMeta {
+    /** Postgres DATABASE. Falls back to the connection user, per libpq. */
+    database?: string;
+    /** Structure reconciliation policy. Defaults to {@link PgAutoSync.Full}. */
+    autoSync?: PgAutoSync | `${PgAutoSync}`;
+    /** Passed straight to `pg.Pool`. */
+    ssl?: boolean | Record<string, unknown>;
+    max?: number;
+    idleTimeoutMillis?: number;
+    connectionTimeoutMillis?: number;
+    statementTimeoutMillis?: number;
+    /** Attempts of the `SELECT 1` readiness probe. */
+    retries?: number;
+    retryDelayMillis?: number;
+    /** Whole connection string — wins over host/user/secret when present. */
+    url?: string;
+}
+/** Transaction scoped façade handed to migrations and {@link PostgresResource.transaction}. */
+export interface PostgresTx {
+    client: PoolClient;
+    /** `{{alias}}` placeholders resolved against the context, `$1..$n` bound. */
+    query: <Row extends QueryResultRow = QueryResultRow>(text: string, params?: unknown[]) => Promise<Row[]>;
+    queryOne: <Row extends QueryResultRow = QueryResultRow>(text: string, params?: unknown[]) => Promise<Row | null>;
+    /** Returns the affected row count. */
+    execute: (text: string, params?: unknown[]) => Promise<number>;
+    /** Fully qualified identifier of a registered resource; omit for the owning resource. */
+    ref: (resourceAlias?: string) => string;
+}
+export interface PostgresResource<T extends ResourceRecord> extends Resource<T>, ResourceLocker<T> {
+    /** Physical table name override. Defaults to the resource alias, sanitized. */
+    name?: string;
+    /** The AJV schema — single source of truth for the table structure. */
+    schema?: AnySchema;
+    /** Compiled table specification. Available once `init()` has run. */
+    table: TableSpec;
+    /** The Drizzle runtime table built from {@link table}. */
+    entity: PgRuntimeTable;
+    migrations: MigrationRegistry<PostgresTx>;
+    db: () => Promise<PostgresDb>;
+    client: () => Promise<Pool>;
+    /** Declare an index the JSON schema can't express. Chainable. */
+    index: <Type extends PostgresResource<T>>(name: string, spec: PgIndexSpec) => Type;
+    /** Register a code migration. Chainable. */
+    migration: <Type extends PostgresResource<T>>(name: string, apply: (tx: PostgresTx) => Promise<void>, stage?: MigrationStage) => Type;
+    getDefaults: () => Partial<T>;
+    /** Raw rows, no marshalling. */
+    query: <Row extends QueryResultRow = QueryResultRow>(text: string, params?: unknown[]) => Promise<Row[]>;
+    queryOne: <Row extends QueryResultRow = QueryResultRow>(text: string, params?: unknown[]) => Promise<Row | null>;
+    /** Returns the affected row count. */
+    execute: (text: string, params?: unknown[]) => Promise<number>;
+    /** Rows marshalled back into `T` through the table spec. */
+    select: <Type extends T>(text: string, params?: unknown[]) => Promise<Type[]>;
+    selectOne: <Type extends T>(text: string, params?: unknown[]) => Promise<Type | null>;
+    /** Fully qualified `"schema"."table"`; pass an alias to reference another resource. */
+    ref: (resourceAlias?: string) => string;
+    transaction: <R>(fn: (tx: PostgresTx) => Promise<R>) => Promise<R>;
+    /** Create with a caller supplied id — `create()` refuses one, mirroring mongo. */
+    insert: <Type extends T>(record: Partial<Type>) => Promise<Type>;
+    /** `INSERT ... ON CONFLICT (...) DO UPDATE`. Defaults to conflicting on the primary key. */
+    upsert: <Type extends T>(record: Partial<Type>, conflict?: string[]) => Promise<Type>;
+    /** Merge semantics — `update()` replaces the whole record, mirroring mongo's `replaceOne`. */
+    patch: <Type extends T>(record: Partial<Type>, opts?: string | {
+        field?: string;
+    }) => Promise<Type>;
+    /** Bulk delete by criteria. Returns the deleted row count. */
+    purge: (criteria: ListCriteria) => Promise<number>;
+    count: (criteria?: ListCriteria | ListOptions) => Promise<number>;
+}
+/** Compiled, database ready description of a resource's table. */
+export interface TableSpec {
+    alias: string;
+    /** Postgres namespace. */
+    schema: string;
+    /** Physical table name. */
+    table: string;
+    /** `"schema"."table"` — already quoted. */
+    qualified: string;
+    columns: ColumnSpec[];
+    byProperty: Record<string, ColumnSpec>;
+    byColumn: Record<string, ColumnSpec>;
+    /** Column names. */
+    primaryKey: string[];
+    uniques: PgUniqueSpec[];
+    checks: PgCheckSpec[];
+    indexes: PgIndexSpec[];
+    references: PgReferenceSpec[];
+    /** Columns reconciliation must never touch. */
+    unmanaged: string[];
+    autoSync: boolean;
+    comment?: string;
+}
+export interface ColumnSpec {
+    /** JSON schema property name. */
+    property: string;
+    /** Physical column name. */
+    column: string;
+    /** Canonical `format_type` spelling, e.g. `character varying(320)`. */
+    sqlType: string;
+    jsonType: ColumnJsonType;
+    notNull: boolean;
+    primaryKey: boolean;
+    defaultLiteral?: string | number | boolean | null;
+    /** Raw SQL default expression, e.g. `now()`. */
+    defaultRaw?: string;
+    /** `secure: true` in the JSON schema — the stored value is ciphertext. */
+    secure: boolean;
+    /** Value has to be `JSON.stringify`d on the way in. */
+    jsonb: boolean;
+    /** Postgres array column. */
+    array: boolean;
+    /** `USING` expression for `ALTER COLUMN ... TYPE`. */
+    using?: string;
+    managed: boolean;
+    comment?: string;
+}
+export type ColumnJsonType = 'string' | 'number' | 'integer' | 'bigint' | 'boolean' | 'object' | 'array' | 'date' | 'binary' | 'unknown';
+/** Per-property `pg` keyword vocabulary. */
+export interface PgPropertyOverride {
+    column?: string;
+    /** Raw Postgres type — wins over everything inferred from the JSON schema. */
+    type?: string;
+    length?: number;
+    precision?: number;
+    scale?: number;
+    nullable?: boolean;
+    default?: string | number | boolean | null;
+    defaultRaw?: string;
+    primaryKey?: boolean;
+    unique?: boolean | string;
+    index?: boolean | PgIndexSpec | PgIndexSpec[];
+    references?: PgReferenceSpec;
+    jsonb?: boolean;
+    array?: boolean;
+    /** `{{col}}` expands to the quoted column name. */
+    check?: string;
+    using?: string;
+    /** `false` puts the column outside reconciliation's authority. */
+    managed?: boolean;
+    comment?: string;
+}
+/** Root level `pg` keyword vocabulary. */
+export interface PgRootOverride {
+    table?: string;
+    schema?: string;
+    /** Property names forming a composite primary key. */
+    primaryKey?: string[];
+    unique?: PgUniqueSpec[];
+    indexes?: PgIndexSpec[];
+    checks?: PgCheckSpec[];
+    /** Physical column names reconciliation must leave alone. */
+    unmanaged?: string[];
+    autoSync?: boolean;
+    comment?: string;
+}
+export interface PgIndexSpec {
+    name?: string;
+    /** Property names — mapped to physical columns at compile time. */
+    columns?: string | string[];
+    /** Raw expression index. Wins over `columns`. */
+    expression?: string;
+    unique?: boolean;
+    method?: PgIndexMethod | `${PgIndexMethod}`;
+    /** Partial index predicate. */
+    where?: string;
+}
+export interface PgUniqueSpec {
+    name?: string;
+    /** Property names. */
+    columns: string[];
+}
+export interface PgCheckSpec {
+    name?: string;
+    expression: string;
+}
+export interface PgReferenceSpec {
+    /** Local property holding the key. Filled in by the compiler. */
+    property?: string;
+    /** Resolve the target table from a registered resource alias... */
+    resource?: string;
+    /** ...or name it directly. */
+    table?: string;
+    schema?: string;
+    /** Target column. Defaults to `id`. */
+    column?: string;
+    name?: string;
+    onDelete?: PgReferentialAction | `${PgReferentialAction}`;
+    onUpdate?: PgReferentialAction | `${PgReferentialAction}`;
+}
+/**
+ * The Drizzle table object. Deliberately opaque — tables are built at runtime from JSON
+ * schemas, so Drizzle's compile time inference has nothing to infer from and every
+ * column would be `any` anyway. Cast it at the call site when you need the typed builder.
+ */
+export type PgRuntimeTable = Record<string, any>;
+/** One column as Postgres currently reports it. */
+export interface LiveColumn {
+    name: string;
+    /** `format_type` output — directly comparable with {@link ColumnSpec.sqlType}. */
+    type: string;
+    notNull: boolean;
+    defaultExpr: string | null;
+    identity: string;
+    generated: string;
+    ordinal: number;
+}
+export interface LiveIndex {
+    name: string;
+    definition: string;
+}
+export interface LiveConstraint {
+    name: string;
+    /** `p` primary, `u` unique, `f` foreign, `c` check. */
+    type: string;
+    definition: string;
+}
+export interface LiveTable {
+    exists: boolean;
+    columns: LiveColumn[];
+    indexes: LiveIndex[];
+    constraints: LiveConstraint[];
+}
+/** One reconciliation step, kept separate from its SQL so it can be logged and explained. */
+export interface DdlStatement {
+    kind: DdlKind;
+    /** What the statement touches — column, index or constraint name. */
+    target: string;
+    sql: string;
+    /** True when applying this loses data. */
+    destructive?: boolean;
+    /** Rows that would be affected, sampled immediately before a destructive step. */
+    affected?: number;
+}
+export type DdlKind = 'create-schema' | 'create-table' | 'add-column' | 'set-default' | 'backfill' | 'alter-type' | 'set-not-null' | 'drop-not-null' | 'drop-constraint' | 'add-constraint' | 'drop-index' | 'create-index' | 'add-foreign-key' | 'drop-column' | 'comment';
+export interface DdlPlan {
+    fresh: boolean;
+    statements: DdlStatement[];
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

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

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/build/utils/criteria.d.ts

@@ -0,0 +1,24 @@
+import type { ListCriteria, ListSort } from '@owlmeans/resource';
+import type { SQL } from 'drizzle-orm';
+import type { PgRuntimeTable, TableSpec } from '../types.js';
+/**
+ * Translate `ListCriteria` into a WHERE clause.
+ *
+ * An unknown key raises rather than being skipped: a typo silently widening a query to
+ * the whole table is the failure mode worth being loud about.
+ *
+ * @throws {UnsupportedArgumentError}
+ */
+export declare const criteriaToSql: (criteria: ListCriteria | undefined, spec: TableSpec, table: PgRuntimeTable) => SQL | undefined;
+/**
+ * Translate `ListPager.sort` into ORDER BY. `[field, true]` is descending, matching the
+ * `order ? -1 : 1` mapping mongo uses.
+ *
+ * The primary key is always appended as a tiebreak. Postgres has no implicit row order, so
+ * paginating on a non-unique sort key silently duplicates and skips rows between pages —
+ * a difference from mongo that would otherwise surface as a data bug rather than an error.
+ *
+ * @throws {UnsupportedArgumentError}
+ */
+export declare const sortToSql: (sort: ListSort[] | undefined, spec: TableSpec, table: PgRuntimeTable) => SQL[];
+//# sourceMappingURL=criteria.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"criteria.d.ts","sourceRoot":"","sources":["../../src/utils/criteria.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAEhE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAEtC,OAAO,KAAK,EAAc,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAqHxE;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,YAAY,GAAG,SAAS,EAAE,MAAM,SAAS,EAAE,OAAO,cAAc,KACzE,GAAG,GAAG,SAIR,CAAA;AAuED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GACpB,MAAM,QAAQ,EAAE,GAAG,SAAS,EAAE,MAAM,SAAS,EAAE,OAAO,cAAc,KACnE,GAAG,EA0BL,CAAA"}

package/build/utils/criteria.js

@@ -0,0 +1,209 @@
+import { UnsupportedArgumentError } from '@owlmeans/resource';
+import { and, asc, desc, or, sql } from 'drizzle-orm';
+const COMPARISON = {
+    $eq: '=', $ne: '<>', $gt: '>', $gte: '>=', $lt: '<', $lte: '<='
+};
+const columnRef = (table, column) => sql `${table[column.property]}`;
+const value = (raw, column) => {
+    if (column.jsonb && raw != null && typeof raw !== 'string') {
+        return sql `${JSON.stringify(raw)}`;
+    }
+    return sql `${raw}`;
+};
+const inList = (table, column, values, negate) => {
+    const present = values.filter(entry => entry != null);
+    const hasNull = present.length !== values.length;
+    if (present.length < 1) {
+        /** Postgres rejects an empty `IN ()`, and an empty set matches nothing (or everything, negated). */
+        return hasNull
+            ? sql `${columnRef(table, column)} IS ${negate ? sql `NOT` : sql ``} NULL`
+            : negate ? sql `TRUE` : sql `FALSE`;
+    }
+    const list = sql.join(present.map(entry => value(entry, column)), sql `, `);
+    const membership = negate
+        ? sql `${columnRef(table, column)} NOT IN (${list})`
+        : sql `${columnRef(table, column)} IN (${list})`;
+    if (!hasNull) {
+        return membership;
+    }
+    /**
+     * `IN` never matches NULL, so `{ $in: [null, 'x'] }` — a real shape in this codebase —
+     * has to be widened explicitly or the null branch silently disappears.
+     */
+    return negate
+        ? sql `(${membership} AND ${columnRef(table, column)} IS NOT NULL)`
+        : sql `(${membership} OR ${columnRef(table, column)} IS NULL)`;
+};
+const operators = (table, column, spec) => {
+    const conditions = [];
+    for (const [operator, operand] of Object.entries(spec)) {
+        if (operator in COMPARISON) {
+            conditions.push(operand == null
+                ? sql `${columnRef(table, column)} IS ${operator === '$ne' ? sql `NOT` : sql ``} NULL`
+                : sql `${columnRef(table, column)} ${sql.raw(COMPARISON[operator])} ${value(operand, column)}`);
+            continue;
+        }
+        switch (operator) {
+            case '$in':
+            case '$nin':
+                conditions.push(inList(table, column, Array.isArray(operand) ? operand : [operand], operator === '$nin'));
+                break;
+            case '$exists':
+                conditions.push(operand === false
+                    ? sql `${columnRef(table, column)} IS NULL`
+                    : sql `${columnRef(table, column)} IS NOT NULL`);
+                break;
+            case '$null':
+                conditions.push(operand === false
+                    ? sql `${columnRef(table, column)} IS NOT NULL`
+                    : sql `${columnRef(table, column)} IS NULL`);
+                break;
+            case '$like':
+                conditions.push(sql `${columnRef(table, column)} LIKE ${operand}`);
+                break;
+            case '$ilike':
+                conditions.push(sql `${columnRef(table, column)} ILIKE ${operand}`);
+                break;
+            case '$regex':
+                conditions.push(sql `${columnRef(table, column)} ~ ${operand}`);
+                break;
+            case '$startsWith':
+                conditions.push(sql `${columnRef(table, column)} LIKE ${`${escapeLike(`${operand}`)}%`}`);
+                break;
+            case '$endsWith':
+                conditions.push(sql `${columnRef(table, column)} LIKE ${`%${escapeLike(`${operand}`)}`}`);
+                break;
+            case '$between': {
+                if (!Array.isArray(operand) || operand.length !== 2) {
+                    throw new UnsupportedArgumentError(`criteria:$between:${column.property}`);
+                }
+                conditions.push(sql `${columnRef(table, column)} BETWEEN ${value(operand[0], column)} AND ${value(operand[1], column)}`);
+                break;
+            }
+            case '$contains':
+                conditions.push(sql `${columnRef(table, column)} @> ${value(operand, column)}`);
+                break;
+            case '$contained':
+                conditions.push(sql `${columnRef(table, column)} <@ ${value(operand, column)}`);
+                break;
+            case '$overlaps':
+                conditions.push(sql `${columnRef(table, column)} && ${value(operand, column)}`);
+                break;
+            default:
+                throw new UnsupportedArgumentError(`criteria-operator:${operator}`);
+        }
+    }
+    return conditions;
+};
+const escapeLike = (value) => value.replace(/[\\%_]/g, match => `\\${match}`);
+const isOperatorSpec = (value) => value != null && typeof value === 'object' && !Array.isArray(value) && !(value instanceof Date)
+    && Object.keys(value).some(key => key.startsWith('$'));
+/**
+ * Translate `ListCriteria` into a WHERE clause.
+ *
+ * An unknown key raises rather than being skipped: a typo silently widening a query to
+ * the whole table is the failure mode worth being loud about.
+ *
+ * @throws {UnsupportedArgumentError}
+ */
+export const criteriaToSql = (criteria, spec, table) => {
+    const conditions = build(criteria, spec, table);
+    return conditions.length > 0 ? and(...conditions) : undefined;
+};
+const build = (criteria, spec, table) => {
+    const conditions = [];
+    for (const [key, raw] of Object.entries(criteria ?? {})) {
+        if (raw === undefined) {
+            continue;
+        }
+        if (key === '$and' || key === '$or') {
+            const parts = (Array.isArray(raw) ? raw : [raw])
+                .map(entry => and(...build(entry, spec, table)))
+                .filter((entry) => entry != null);
+            if (parts.length > 0) {
+                const combined = key === '$and' ? and(...parts) : or(...parts);
+                if (combined != null) {
+                    conditions.push(combined);
+                }
+            }
+            continue;
+        }
+        if (key === '$not') {
+            const inner = and(...build(raw, spec, table));
+            if (inner != null) {
+                conditions.push(sql `NOT (${inner})`);
+            }
+            continue;
+        }
+        /** `profile.city` reaches into a jsonb column rather than naming a column. */
+        const [head, ...path] = key.split('.');
+        const column = spec.byProperty[head];
+        if (column == null) {
+            throw new UnsupportedArgumentError(`criteria:${key}`);
+        }
+        if (path.length > 0) {
+            if (!column.jsonb) {
+                throw new UnsupportedArgumentError(`criteria-path:${key}`);
+            }
+            conditions.push(sql `${columnRef(table, column)} #>> ${`{${path.join(',')}}`} = ${`${raw}`}`);
+            continue;
+        }
+        if (raw === null) {
+            conditions.push(sql `${columnRef(table, column)} IS NULL`);
+            continue;
+        }
+        if (isOperatorSpec(raw)) {
+            conditions.push(...operators(table, column, raw));
+            continue;
+        }
+        if (Array.isArray(raw)) {
+            /**
+             * A bare array means `IN` for a relational store, which is overwhelmingly the intent.
+             * Exact array equality against a `text[]` column stays available as `{ $eq: [...] }`.
+             */
+            conditions.push(inList(table, column, raw, false));
+            continue;
+        }
+        if (column.jsonb && typeof raw === 'object') {
+            conditions.push(sql `${columnRef(table, column)} @> ${JSON.stringify(raw)}`);
+            continue;
+        }
+        conditions.push(sql `${columnRef(table, column)} = ${value(raw, column)}`);
+    }
+    return conditions;
+};
+/**
+ * Translate `ListPager.sort` into ORDER BY. `[field, true]` is descending, matching the
+ * `order ? -1 : 1` mapping mongo uses.
+ *
+ * The primary key is always appended as a tiebreak. Postgres has no implicit row order, so
+ * paginating on a non-unique sort key silently duplicates and skips rows between pages —
+ * a difference from mongo that would otherwise surface as a data bug rather than an error.
+ *
+ * @throws {UnsupportedArgumentError}
+ */
+export const sortToSql = (sort, spec, table) => {
+    const order = [];
+    const seen = [];
+    for (const entry of sort ?? []) {
+        /** Both `ListSort` forms are handled explicitly — destructuring a plain string yields characters. */
+        const [property, descending] = typeof entry === 'string' ? [entry, false] : [entry[0], entry[1] === true];
+        const column = spec.byProperty[property];
+        if (column == null) {
+            throw new UnsupportedArgumentError(`sort:${property}`);
+        }
+        seen.push(column.column);
+        order.push(descending ? desc(table[column.property]) : asc(table[column.property]));
+    }
+    for (const key of spec.primaryKey) {
+        if (seen.includes(key)) {
+            continue;
+        }
+        const column = spec.byColumn[key];
+        if (column != null) {
+            order.push(asc(table[column.property]));
+        }
+    }
+    return order;
+};
+//# sourceMappingURL=criteria.js.map

package/build/utils/criteria.js.map

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

package/build/utils/diff.d.ts

@@ -0,0 +1,24 @@
+import type { BasicContext } from '@owlmeans/context';
+import type { DdlPlan, DdlStatement, LiveTable, TableSpec } from '../types.js';
+/**
+ * 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 declare const planForeignKeys: (spec: TableSpec, context?: BasicContext<any>) => DdlStatement[];
+/**
+ * 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 declare const planSync: (spec: TableSpec, live: LiveTable, additive?: boolean) => DdlPlan;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAKrD,OAAO,KAAK,EACE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAiC,SAAS,EACvF,MAAM,aAAa,CAAA;AAqDpB;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,SAAS,EAAE,UAAU,YAAY,CAAC,GAAG,CAAC,KAC3C,YAAY,EAwCb,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,GACnB,MAAM,SAAS,EAAE,MAAM,SAAS,EAAE,WAAU,OAAe,KAC1D,OAuNF,CAAA"}