@zmdb/migrations 1.0.0-beta.1

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+import { type ChangeOp, type ExtensionType, type MigrationDialect, type ReferentialAction, type SchemaSnapshot, type SchemaObjectOperation, type SqlDialect, type TableOptions } from '@zmdb/sql';
+import { ddlType, type DdlSqlType } from '@zmdb/sql/schema-objects';
+export { type ChangeOp, type ColumnSnapshot, type ExtensionSnapshot, type ExtensionType, type ForeignKeySnapshot, type ReferentialAction, type SchemaSnapshot, type TableOptions, type TableSnapshot, } from '@zmdb/sql';
+export { type MigrationDialect, type SchemaObjectOperation } from '@zmdb/sql';
+export { ddlType };
+export type { DdlSqlType };
+export { down, downTo, driverMigrationConnection, ensureVersionTable, rollbackTo, status, up } from './runner.js';
+export type { AppliedMigration, Migration, MigrationConnection, MigrationDriver, MigrationRunOptions, MigrationStatus, MigrationTableOptions, } from './runner.js';
+export type { MigrationProject } from './project.js';
+export declare function emitSchemaObject(operation: SchemaObjectOperation, target: SqlDialect | MigrationDialect): readonly string[];
+/**
+ * The slice of a schema a snapshot reads.
+ *
+ * Declared structurally so callers can supply the required snapshot data.
+ * `CoreSchema` satisfies this shape. Migrations also depends on
+ * `@zmdb/schema/naming` for canonical names.
+ */
+export interface SnapshotableSchema {
+    readonly table: string;
+    readonly primaryKey: readonly string[];
+    readonly columns: Readonly<Record<string, {
+        readonly type: string | ExtensionType;
+        readonly flags: {
+            readonly nullable: boolean;
+            readonly primaryKey?: boolean | undefined;
+            readonly length?: number | undefined;
+            readonly unique?: boolean | undefined;
+        };
+        readonly references?: {
+            readonly target: string;
+        };
+    }>>;
+    readonly ir?: {
+        readonly table: string;
+        readonly physicalTable?: string;
+        readonly columns: readonly {
+            readonly name: string;
+            readonly physicalName?: string;
+            readonly references?: string;
+            readonly onDelete?: ReferentialAction;
+            readonly onUpdate?: ReferentialAction;
+        }[];
+        readonly foreignKeys?: readonly {
+            readonly columns: readonly string[];
+            readonly targetTable: string;
+            readonly targetColumns: readonly string[];
+        }[];
+        readonly tableOptions?: TableOptions;
+    };
+}
+export declare function snapshot(schemas: readonly SnapshotableSchema[]): SchemaSnapshot;
+export declare const CHANGE_PHASES: readonly [readonly ["create_extension"], readonly ["drop_foreign_key"], readonly ["drop_table"], readonly ["create_table", "add_column"], readonly ["alter_column_type", "alter_primary_key"], readonly ["drop_column"], readonly ["add_foreign_key"]];
+export interface DiffOptions {
+    readonly dialect?: SqlDialect | undefined;
+}
+export interface MigrationPlan {
+    readonly operations: readonly ChangeOp[];
+    readonly up: readonly string[];
+    readonly down: readonly string[];
+}
+export interface MigrationPlanDialect {
+    readonly dialect: SqlDialect;
+    emitUp(operation: ChangeOp): string;
+    emitDown(operation: ChangeOp): string;
+}
+export declare function diff(prev: SchemaSnapshot, next: SchemaSnapshot, options?: DiffOptions): readonly ChangeOp[];
+export declare function planMigration(previous: SchemaSnapshot, next: SchemaSnapshot, database: MigrationPlanDialect): MigrationPlan;
+export declare function emitUp(operation: ChangeOp, target: SqlDialect | MigrationDialect): string;
+export declare function emitDown(operation: ChangeOp, target: SqlDialect | MigrationDialect): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,350 @@
+// Migrations (#41–#44): snapshot a set of schemas, diff two snapshots into
+// change ops, and emit up/down DDL per dialect. Deterministic throughout —
+// tables and columns are sorted by name so a snapshot is byte-stable.
+import { UnsupportedFeatureError, dialectName, } from '@zmdb/sql';
+import { ddlType } from '@zmdb/sql/schema-objects';
+export {} from '@zmdb/sql';
+export {} from '@zmdb/sql';
+export { ddlType };
+export { down, downTo, driverMigrationConnection, ensureVersionTable, rollbackTo, status, up } from './runner.js';
+function migrationsOf(target) {
+    return 'migrations' in target ? target.migrations : target;
+}
+export function emitSchemaObject(operation, target) {
+    return migrationsOf(target).emitSchemaObject(operation);
+}
+function generatedForeignKeyName(table, columns) {
+    const name = `${table}_${columns.join('_')}_fkey`;
+    if (name.length > 63) {
+        throw new TypeError(`generated foreign key name "${name}" is ${name.length} characters long; PostgreSQL's limit is 63, ` +
+            'so give the table or columns shorter names');
+    }
+    return name;
+}
+function referencedTarget(target) {
+    const separator = target.indexOf('.');
+    if (separator <= 0 || separator !== target.lastIndexOf('.') || separator === target.length - 1) {
+        throw new TypeError(`foreign key target "${target}" must be written as "table.column"`);
+    }
+    return { table: target.slice(0, separator), column: target.slice(separator + 1) };
+}
+function physicalColumn(schema, declared) {
+    const column = schema.ir?.columns.find(candidate => candidate.name === declared);
+    return column?.physicalName ?? declared;
+}
+function physicalTarget(target, schemasByDeclaredTable) {
+    const declared = referencedTarget(target);
+    const schema = schemasByDeclaredTable.get(declared.table);
+    return schema === undefined
+        ? declared
+        : {
+            table: schema.table,
+            column: physicalColumn(schema, declared.column),
+        };
+}
+function physicalTableOptions(schema) {
+    const options = schema.ir?.tableOptions;
+    if (options === undefined)
+        return undefined;
+    return {
+        ...(options.shardKey === undefined
+            ? {}
+            : { shardKey: options.shardKey.map(column => physicalColumn(schema, column)) }),
+        ...(options.sortKey === undefined
+            ? {}
+            : { sortKey: options.sortKey.map(column => physicalColumn(schema, column)) }),
+        ...(options.rowstore === undefined ? {} : { rowstore: options.rowstore }),
+    };
+}
+export function snapshot(schemas) {
+    const schemasByDeclaredTable = new Map(schemas.map(schema => [schema.ir?.table ?? schema.table, schema]));
+    const extensions = new Map();
+    const tables = schemas
+        .map(schema => {
+        const irColumns = new Map(schema.ir?.columns.flatMap(column => [
+            [column.name, column],
+            [column.physicalName ?? column.name, column],
+        ]) ?? []);
+        const columns = Object.entries(schema.columns)
+            .map(([name, meta]) => {
+            if (typeof meta.type !== 'string') {
+                extensions.set(meta.type.extension, { name: meta.type.extension });
+            }
+            const ir = irColumns.get(name);
+            return {
+                name: ir?.physicalName ?? name,
+                type: meta.type,
+                nullable: meta.flags.nullable,
+                primaryKey: meta.flags.primaryKey === true,
+                // Written only when there is one, so columns that are not `varchar` do not
+                // acquire a meaningless field in the version-1 snapshot.
+                ...(meta.flags.length === undefined ? {} : { length: meta.flags.length }),
+                ...(meta.flags.unique === true ? { unique: true } : {}),
+            };
+        })
+            .toSorted((a, b) => a.name.localeCompare(b.name));
+        const foreignKeys = [];
+        for (const [name, meta] of Object.entries(schema.columns)) {
+            if (meta.references === undefined)
+                continue;
+            const target = physicalTarget(meta.references.target, schemasByDeclaredTable);
+            const ir = irColumns.get(name);
+            const localName = ir?.physicalName ?? name;
+            foreignKeys.push({
+                name: generatedForeignKeyName(schema.table, [localName]),
+                columns: [localName],
+                targetTable: target.table,
+                targetColumns: [target.column],
+                onDelete: ir?.onDelete ?? 'no action',
+                onUpdate: ir?.onUpdate ?? 'no action',
+            });
+        }
+        for (const foreignKey of schema.ir?.foreignKeys ?? []) {
+            const localColumns = foreignKey.columns.map(column => physicalColumn(schema, column));
+            const targetSchema = schemasByDeclaredTable.get(foreignKey.targetTable);
+            foreignKeys.push({
+                name: generatedForeignKeyName(schema.table, localColumns),
+                columns: localColumns,
+                targetTable: targetSchema?.table ?? foreignKey.targetTable,
+                targetColumns: targetSchema === undefined
+                    ? foreignKey.targetColumns
+                    : foreignKey.targetColumns.map(column => physicalColumn(targetSchema, column)),
+                onDelete: 'no action',
+                onUpdate: 'no action',
+            });
+        }
+        const tableOptions = physicalTableOptions(schema);
+        return {
+            name: schema.table,
+            columns,
+            primaryKey: schema.primaryKey.map(column => physicalColumn(schema, column)),
+            foreignKeys: foreignKeys.toSorted((a, b) => a.name.localeCompare(b.name)),
+            ...(tableOptions === undefined ? {} : { tableOptions }),
+        };
+    })
+        .toSorted((a, b) => a.name.localeCompare(b.name));
+    return {
+        version: 1,
+        tables,
+        extensions: [...extensions.values()].toSorted((a, b) => a.name.localeCompare(b.name)),
+    };
+}
+function sameType(previous, next) {
+    if (typeof previous === 'string' || typeof next === 'string')
+        return previous === next;
+    if (previous.extension !== next.extension || previous.name !== next.name)
+        return false;
+    const previousArgs = previous.args ?? [];
+    const nextArgs = next.args ?? [];
+    return previousArgs.length === nextArgs.length && previousArgs.every((value, index) => value === nextArgs[index]);
+}
+export const CHANGE_PHASES = [
+    ['create_extension'],
+    ['drop_foreign_key'],
+    ['drop_table'],
+    ['create_table', 'add_column'],
+    ['alter_column_type', 'alter_primary_key'],
+    ['drop_column'],
+    ['add_foreign_key'],
+];
+const CHANGE_PHASE = new Map(CHANGE_PHASES.flatMap((kinds, phase) => kinds.map(kind => [kind, phase])));
+function orderChanges(ops) {
+    const phaseOf = (kind) => {
+        const phase = CHANGE_PHASE.get(kind);
+        if (phase === undefined)
+            throw new Error(`change kind "${kind}" has no migration phase`);
+        return phase;
+    };
+    return ops.toSorted((left, right) => phaseOf(left.kind) - phaseOf(right.kind));
+}
+function sameSequence(previous, next) {
+    return previous.length === next.length && previous.every((value, index) => value === next[index]);
+}
+function sameTableOptions(previous, next) {
+    if (previous?.rowstore !== next?.rowstore)
+        return false;
+    return (sameSequence(previous?.shardKey ?? [], next?.shardKey ?? []) &&
+        sameSequence(previous?.sortKey ?? [], next?.sortKey ?? []));
+}
+function foreignKeysOf(table) {
+    // Stored snapshots written before referential actions landed have no field.
+    // Reading them as [] lets the first post-upgrade diff add the declared constraints
+    // instead of failing while loading the migration history.
+    return table.foreignKeys ?? [];
+}
+function foreignKeyIdentity(foreignKey) {
+    return JSON.stringify([foreignKey.columns, foreignKey.targetTable, foreignKey.targetColumns]);
+}
+function sameForeignKeyActions(previous, next) {
+    return previous.onDelete === next.onDelete && previous.onUpdate === next.onUpdate;
+}
+function diffForeignKeys(table, previous, next, ops) {
+    const unmatchedPrevious = new Map(previous.map(foreignKey => [foreignKeyIdentity(foreignKey), foreignKey]));
+    for (const foreignKey of next) {
+        const identity = foreignKeyIdentity(foreignKey);
+        const before = unmatchedPrevious.get(identity);
+        if (before === undefined) {
+            ops.push({ kind: 'add_foreign_key', table, fk: foreignKey });
+            continue;
+        }
+        unmatchedPrevious.delete(identity);
+        if (sameForeignKeyActions(before, foreignKey))
+            continue;
+        ops.push({ kind: 'drop_foreign_key', table, name: before.name });
+        ops.push({ kind: 'add_foreign_key', table, fk: foreignKey });
+    }
+    for (const foreignKey of unmatchedPrevious.values()) {
+        ops.push({ kind: 'drop_foreign_key', table, name: foreignKey.name });
+    }
+}
+function createdTablesInOrder(previous, next, dialect) {
+    const created = new Map(next.filter(table => !previous.has(table.name)).map(table => [table.name, table]));
+    const dependencies = new Map();
+    const dependants = new Map();
+    for (const table of created.values()) {
+        const targets = new Set(foreignKeysOf(table)
+            .map(foreignKey => foreignKey.targetTable)
+            .filter(target => target !== table.name && created.has(target)));
+        dependencies.set(table.name, targets);
+        for (const target of targets) {
+            const children = dependants.get(target) ?? new Set();
+            children.add(table.name);
+            dependants.set(target, children);
+        }
+    }
+    const ready = [...created.keys()]
+        .filter(name => dependencies.get(name)?.size === 0)
+        .toSorted((left, right) => left.localeCompare(right));
+    const ordered = [];
+    while (ready.length > 0) {
+        const name = ready.shift();
+        if (name === undefined)
+            break;
+        const table = created.get(name);
+        if (table !== undefined)
+            ordered.push(table);
+        for (const child of dependants.get(name) ?? []) {
+            const remaining = dependencies.get(child);
+            remaining?.delete(name);
+            if (remaining?.size === 0) {
+                ready.push(child);
+                ready.sort((left, right) => left.localeCompare(right));
+            }
+        }
+    }
+    if (ordered.length === created.size)
+        return ordered;
+    const orderedNames = new Set(ordered.map(table => table.name));
+    const cyclic = [...created.keys()]
+        .filter(name => !orderedNames.has(name))
+        .toSorted((left, right) => left.localeCompare(right));
+    if (dialect?.migrations.foreignKeyMode === 'inline') {
+        const databaseName = dialectName(dialect);
+        throw new UnsupportedFeatureError(`creating mutually-referencing tables ${cyclic.map(tableName => `"${tableName}"`).join(', ')}`, databaseName, `${databaseName} cannot create the mutually-referencing tables ${cyclic
+            .map(tableName => `"${tableName}"`)
+            .join(' and ')}; ` +
+            'their foreign keys must be inline, so neither table can be created before the other — ' +
+            'use a hand-written table rebuild or remove the cycle');
+    }
+    return [...ordered, ...cyclic.map(name => created.get(name)).filter(table => table !== undefined)];
+}
+export function diff(prev, next, options = {}) {
+    const selectedDialect = options.dialect;
+    const ops = [];
+    const prevTables = new Map(prev.tables.map(t => [t.name, t]));
+    const nextTables = new Map(next.tables.map(t => [t.name, t]));
+    const prevExtensions = new Set(prev.extensions.map(extension => extension.name));
+    for (const extension of next.extensions) {
+        if (!prevExtensions.has(extension.name)) {
+            ops.push({
+                kind: 'create_extension',
+                name: extension.name,
+                ...(extension.schema === undefined ? {} : { schema: extension.schema }),
+            });
+        }
+    }
+    // Dropped tables.
+    for (const t of prev.tables) {
+        if (!nextTables.has(t.name))
+            ops.push({ kind: 'drop_table', table: t.name });
+    }
+    // Column-level and foreign-key diffs on tables that already exist.
+    for (const t of next.tables) {
+        const before = prevTables.get(t.name);
+        if (!before)
+            continue;
+        if (!sameTableOptions(before.tableOptions, t.tableOptions)) {
+            const target = selectedDialect === undefined ? 'the selected migration dialect' : dialectName(selectedDialect);
+            throw new UnsupportedFeatureError('table options change', target, `${target} cannot alter the shard key, sort key, or rowstore setting of "${t.name}"; ` +
+                'create a replacement table and copy the data');
+        }
+        const beforeCols = new Map(before.columns.map(c => [c.name, c]));
+        const afterCols = new Map(t.columns.map(c => [c.name, c]));
+        for (const c of before.columns) {
+            if (!afterCols.has(c.name))
+                ops.push({ kind: 'drop_column', table: t.name, column: c.name });
+        }
+        for (const c of t.columns) {
+            const bc = beforeCols.get(c.name);
+            if (!bc) {
+                ops.push({ kind: 'add_column', table: t.name, column: c });
+            }
+            else if (!sameType(bc.type, c.type)) {
+                ops.push({
+                    kind: 'alter_column_type',
+                    table: t.name,
+                    column: c.name,
+                    from: bc.type,
+                    to: c.type,
+                    fromNullable: bc.nullable,
+                    toNullable: c.nullable,
+                });
+            }
+        }
+        if (!sameSequence(before.primaryKey, t.primaryKey)) {
+            ops.push({ kind: 'alter_primary_key', table: t.name, from: before.primaryKey, to: t.primaryKey });
+        }
+        diffForeignKeys(t.name, foreignKeysOf(before), foreignKeysOf(t), ops);
+    }
+    // Created tables are target-before-child for inline constraints. Deferred
+    // strategies get the same deterministic order before their ALTER statements.
+    for (const table of createdTablesInOrder(prevTables, next.tables, selectedDialect)) {
+        const foreignKeys = foreignKeysOf(table);
+        ops.push({
+            kind: 'create_table',
+            table: table.name,
+            columns: table.columns,
+            primaryKey: table.primaryKey,
+            foreignKeys,
+            ...(table.tableOptions === undefined ? {} : { tableOptions: table.tableOptions }),
+        });
+        if (selectedDialect?.migrations.foreignKeyMode !== 'inline') {
+            for (const foreignKey of foreignKeys) {
+                ops.push({ kind: 'add_foreign_key', table: table.name, fk: foreignKey });
+            }
+        }
+    }
+    const operations = orderChanges(ops);
+    selectedDialect?.migrations.validatePlan({
+        before: prev,
+        after: next,
+        operations,
+    });
+    return operations;
+}
+export function planMigration(previous, next, database) {
+    const operations = diff(previous, next, { dialect: database.dialect });
+    return {
+        operations,
+        up: operations.map(operation => database.emitUp(operation)),
+        down: operations.toReversed().map(operation => database.emitDown(operation)),
+    };
+}
+// Database packages own every DDL spelling; this package only delegates the planned operation.
+export function emitUp(operation, target) {
+    return migrationsOf(target).emitUp(operation);
+}
+export function emitDown(operation, target) {
+    return migrationsOf(target).emitDown(operation);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/introspect/common.d.ts

@@ -0,0 +1,26 @@
+import { type CatalogSelection, type CatalogWarning, type CompiledQuery, type ReferentialAction } from '@zmdb/sql';
+export { type CatalogColumnSnapshot, type CatalogForeignKeySnapshot, type CatalogIndexColumn, type CatalogIndexSnapshot, type CatalogSchemaSnapshot, type CatalogSelection, type CatalogTableSnapshot, type CatalogWarning, type IntrospectionDriver, type Introspector, type IntrospectOptions, type ReferentialAction, } from '@zmdb/sql';
+export { normalizeDriftSnapshot } from './drift.js';
+export declare class CatalogRowError extends TypeError {
+    readonly catalog: string;
+    readonly row: number;
+    readonly field: string;
+    readonly expected: string;
+    constructor(catalog: string, row: number, field: string, expected: string, value: unknown);
+}
+export declare function textField(row: Readonly<Record<string, unknown>>, field: string, catalog: string, index: number): string;
+export declare function nullableTextField(row: Readonly<Record<string, unknown>>, field: string, catalog: string, index: number): string | null;
+export declare function integerField(row: Readonly<Record<string, unknown>>, field: string, catalog: string, index: number): number;
+export declare function nullableIntegerField(row: Readonly<Record<string, unknown>>, field: string, catalog: string, index: number): number | null;
+export declare function flagField(row: Readonly<Record<string, unknown>>, field: string, catalog: string, index: number): boolean;
+export declare function booleanField(row: Readonly<Record<string, unknown>>, field: string, catalog: string, index: number): boolean;
+export declare function query(text: string, parameters?: readonly unknown[]): CompiledQuery;
+export declare function tableSelected(name: string, selection: CatalogSelection): boolean;
+export declare function action(value: string, catalog: string, row: number, field: string): ReferentialAction;
+export declare function deterministicForeignKeyName(table: string, columns: readonly string[]): string;
+export declare function sortByName<T extends {
+    readonly name: string;
+}>(values: readonly T[]): readonly T[];
+export declare function sortWarnings(values: readonly CatalogWarning[]): readonly CatalogWarning[];
+export declare function splitSqlList(value: string): readonly string[];
+//# sourceMappingURL=common.d.ts.map

package/dist/introspect/common.d.ts.map

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

package/dist/introspect/common.js

@@ -0,0 +1,155 @@
+import {} from '@zmdb/sql';
+export {} from '@zmdb/sql';
+export { normalizeDriftSnapshot } from './drift.js';
+export class CatalogRowError extends TypeError {
+    catalog;
+    row;
+    field;
+    expected;
+    constructor(catalog, row, field, expected, value) {
+        super(`${catalog} row ${String(row)} field "${field}" must be ${expected}; received ${describeValue(value)}`);
+        this.name = 'CatalogRowError';
+        this.catalog = catalog;
+        this.row = row;
+        this.field = field;
+        this.expected = expected;
+    }
+}
+function describeValue(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'an array';
+    return typeof value;
+}
+function valueAt(row, field) {
+    return Reflect.get(row, field);
+}
+export function textField(row, field, catalog, index) {
+    const value = valueAt(row, field);
+    if (typeof value !== 'string')
+        throw new CatalogRowError(catalog, index, field, 'a string', value);
+    return value;
+}
+export function nullableTextField(row, field, catalog, index) {
+    const value = valueAt(row, field);
+    if (value === null)
+        return null;
+    if (typeof value !== 'string') {
+        throw new CatalogRowError(catalog, index, field, 'a string or null', value);
+    }
+    return value;
+}
+export function integerField(row, field, catalog, index) {
+    const value = valueAt(row, field);
+    if (typeof value === 'number' && Number.isSafeInteger(value))
+        return value;
+    if (typeof value === 'string' && /^-?\d+$/.test(value)) {
+        const parsed = Number(value);
+        if (Number.isSafeInteger(parsed))
+            return parsed;
+    }
+    throw new CatalogRowError(catalog, index, field, 'a safe integer or decimal integer string', value);
+}
+export function nullableIntegerField(row, field, catalog, index) {
+    const value = valueAt(row, field);
+    if (value === null)
+        return null;
+    return integerField(row, field, catalog, index);
+}
+export function flagField(row, field, catalog, index) {
+    const value = integerField(row, field, catalog, index);
+    if (value === 0)
+        return false;
+    if (value === 1)
+        return true;
+    throw new CatalogRowError(catalog, index, field, '0 or 1', valueAt(row, field));
+}
+export function booleanField(row, field, catalog, index) {
+    const value = valueAt(row, field);
+    if (typeof value === 'boolean')
+        return value;
+    throw new CatalogRowError(catalog, index, field, 'a boolean', value);
+}
+export function query(text, parameters = []) {
+    return { text, parameters };
+}
+function globExpression(glob) {
+    let source = '^';
+    for (const character of glob) {
+        if (character === '*')
+            source += '.*';
+        else if (character === '?')
+            source += '.';
+        else
+            source += character.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
+    }
+    return new RegExp(`${source}$`);
+}
+function matchesAny(name, globs) {
+    return globs.some(glob => globExpression(glob).test(name));
+}
+export function tableSelected(name, selection) {
+    const include = selection.include;
+    if (include !== undefined && include.length > 0 && !matchesAny(name, include))
+        return false;
+    const exclude = selection.exclude ?? ['_zmdb_migrations'];
+    return !matchesAny(name, exclude);
+}
+export function action(value, catalog, row, field) {
+    const normalized = value.toLowerCase().replaceAll('_', ' ');
+    switch (normalized) {
+        case 'no action':
+        case 'restrict':
+        case 'cascade':
+        case 'set null':
+        case 'set default':
+            return normalized;
+        default:
+            throw new CatalogRowError(catalog, row, field, 'a referential action', value);
+    }
+}
+export function deterministicForeignKeyName(table, columns) {
+    return `${table}_${columns.join('_')}_fkey`;
+}
+export function sortByName(values) {
+    return values.toSorted((left, right) => left.name.localeCompare(right.name));
+}
+export function sortWarnings(values) {
+    return values.toSorted((left, right) => left.table.localeCompare(right.table) ||
+        (left.column ?? '').localeCompare(right.column ?? '') ||
+        left.reason.localeCompare(right.reason));
+}
+export function splitSqlList(value) {
+    const parts = [];
+    let start = 0;
+    let depth = 0;
+    let quote;
+    for (let index = 0; index < value.length; index += 1) {
+        const character = value[index];
+        if (quote !== undefined) {
+            if (character === quote) {
+                if (value[index + 1] === quote)
+                    index += 1;
+                else
+                    quote = undefined;
+            }
+            continue;
+        }
+        if (character === "'" || character === '"' || character === '`') {
+            quote = character;
+            continue;
+        }
+        if (character === '(')
+            depth += 1;
+        else if (character === ')')
+            depth -= 1;
+        else if (character === ',' && depth === 0) {
+            parts.push(value.slice(start, index).trim());
+            start = index + 1;
+        }
+    }
+    parts.push(value.slice(start).trim());
+    return parts;
+}
+//# sourceMappingURL=common.js.map