@danceroutine/tango-migrations 0.1.0 → 1.0.0

package/dist/builder/contracts/ColumnSpec.d.ts

@@ -1,3 +1,4 @@
+import type { TrustedSqlFragment } from '@danceroutine/tango-core';
 import type { ColumnType } from './ColumnType';
 import type { DeleteReferentialAction } from './DeleteReferentialAction';
 import type { UpdateReferentialAction } from './UpdateReferentialAction';
@@ -5,7 +6,7 @@ export interface ColumnSpec {
     name: string;
     type: ColumnType;
     notNull?: boolean;
-    default?: string | {
+    default?: TrustedSqlFragment | {
         now: true;
     } | null;
     primaryKey?: boolean;

package/dist/builder/contracts/UpdateReferentialAction.d.ts

@@ -1,2 +1,2 @@
 import type { InternalReferentialAction } from '../../domain/internal/InternalReferentialAction';
-export type UpdateReferentialAction = InternalReferentialAction.CASCADE | InternalReferentialAction.RESTRICT | InternalReferentialAction.NO_ACTION;
+export type UpdateReferentialAction = Extract<InternalReferentialAction, 'CASCADE' | 'RESTRICT' | 'NO_ACTION'>;

package/dist/builder/index.js

@@ -1,6 +1,6 @@
-import { CollectingBuilder } from "../CollectingBuilder-C6qnwyrb.js";
-import "../InternalOperationKind-BPVoOQwD.js";
-import "../InternalColumnType-_YAz7RqI.js";
-import { OpBuilder, applyFieldType, contracts_exports, ops_exports, runtime_exports } from "../builder-Dtk8oP_Y.js";
+import { CollectingBuilder } from "../CollectingBuilder--4fqDQdE.js";
+import "../InternalOperationKind-Bt6Weuon.js";
+import "../InternalColumnType-G9zV9StN.js";
+import { OpBuilder, applyFieldType, contracts_exports, ops_exports, runtime_exports } from "../builder-xJ-Bq2pk.js";
 
 export { CollectingBuilder, OpBuilder, applyFieldType, contracts_exports as contracts, OpBuilder as op, ops_exports as ops, runtime_exports as runtime };

package/dist/builder/ops/OpBuilder.d.ts

@@ -1,27 +1,45 @@
+import type { TrustedSqlFragment } from '@danceroutine/tango-core';
 import type { CustomMigrationOperation, ForeignKeyCreate, ForeignKeyDrop, ForeignKeyValidate, IndexCreate, IndexDrop, TableCreate, TableDrop, ColumnAdd, ColumnDrop, ColumnAlter, ColumnRename } from '../../domain/MigrationOperation';
 import type { ColumnSpec } from '../contracts/ColumnSpec';
 import type { ColumnType } from '../contracts/ColumnType';
 import type { DeleteReferentialAction } from '../contracts/DeleteReferentialAction';
 import type { UpdateReferentialAction } from '../contracts/UpdateReferentialAction';
+/**
+ * Fluent builder for column specifications used by table operations.
+ */
 declare class ColumnBuilder {
     static readonly BRAND: "tango.migrations.column_builder";
-    private spec;
     readonly __tangoBrand: typeof ColumnBuilder.BRAND;
+    private spec;
     constructor(name: string);
     static isColumnBuilder(value: unknown): value is ColumnBuilder;
+    /** Set column type to serial/auto-increment. */
     serial(): ColumnBuilder;
+    /** Set column type to integer. */
     int(): ColumnBuilder;
+    /** Set column type to bigint. */
     bigint(): ColumnBuilder;
+    /** Set column type to text. */
     text(): ColumnBuilder;
+    /** Set column type to boolean. */
     bool(): ColumnBuilder;
+    /** Set column type to timestamptz. */
     timestamptz(): ColumnBuilder;
+    /** Set column type to JSONB. */
     jsonb(): ColumnBuilder;
+    /** Set column type to UUID. */
     uuid(): ColumnBuilder;
+    /** Mark column as NOT NULL. */
     notNull(): ColumnBuilder;
+    /** Set default to current timestamp. */
     defaultNow(): ColumnBuilder;
-    default(v: string | null): ColumnBuilder;
+    /** Set reviewed raw SQL default expression. */
+    default(v: TrustedSqlFragment | null): ColumnBuilder;
+    /** Mark column as part of primary key. */
     primaryKey(): ColumnBuilder;
+    /** Mark column as unique. */
     unique(): ColumnBuilder;
+    /** Configure foreign key reference metadata. */
     references(table: string, column: string, opts?: {
         onDelete?: DeleteReferentialAction;
         onUpdate?: UpdateReferentialAction;
@@ -40,27 +58,39 @@ type TableOperationBuilder = {
     alterColumn(name: string, to: Partial<ColumnSpec>): ColumnAlter;
     renameColumn(from: string, to: string): ColumnRename;
 };
+/**
+ * Static factory for migration operations.
+ */
 export declare class OpBuilder {
     static readonly BRAND: "tango.migrations.op_builder";
-    readonly __tangoBrand: typeof OpBuilder.BRAND;
-    private static customOperations;
-    static isOpBuilder(value: unknown): value is OpBuilder;
-    static table(table: string): TableOperationBuilder;
     static index: {
+        /** Build an index create operation. */
         create(p: {
             name: string;
             table: string;
             on: string[];
             unique?: boolean;
-            where?: string;
+            where?: TrustedSqlFragment;
             concurrently?: boolean;
         }): IndexCreate;
+        /** Build an index drop operation. */
         drop(p: {
             name: string;
             table: string;
             concurrently?: boolean;
         }): IndexDrop;
     };
+    private static customOperations;
+    readonly __tangoBrand: typeof OpBuilder.BRAND;
+    /**
+     * Narrow an unknown value to the shared migration operation builder type.
+     */
+    static isOpBuilder(value: unknown): value is OpBuilder;
+    /**
+     * Build table-scoped migration operations.
+     */
+    static table(table: string): TableOperationBuilder;
+    /** Build a foreign key create operation. */
     static foreignKey(p: {
         table: string;
         name?: string;
@@ -73,16 +103,27 @@ export declare class OpBuilder {
         onUpdate?: string;
         notValid?: boolean;
     }): ForeignKeyCreate;
+    /** Build a foreign key validation operation. */
     static foreignKeyValidate(p: {
         table: string;
         name: string;
     }): ForeignKeyValidate;
+    /** Build a foreign key drop operation. */
     static foreignKeyDrop(p: {
         table: string;
         name: string;
     }): ForeignKeyDrop;
+    /**
+     * Register a custom migration operation builder.
+     */
     static registerCustomOperation<TName extends string, TArgs extends object>(name: TName, builder: (args: TArgs) => CustomMigrationOperation<TName, TArgs>): void;
+    /**
+     * Resolve a previously registered custom operation builder.
+     */
     static getCustomOperation<TName extends string, TArgs extends object>(name: TName): ((args: TArgs) => CustomMigrationOperation<TName, TArgs>) | undefined;
 }
+/**
+ * Apply a domain field type to a column builder.
+ */
 export declare function applyFieldType(builder: ColumnBuilder, fieldType: ColumnType): ColumnBuilder;
 export {};

package/dist/builder/runtime/CollectingBuilder.d.ts

@@ -1,21 +1,39 @@
 import type { Builder } from '../contracts/Builder';
 import type { MigrationOperation } from '../../domain/MigrationOperation';
 import type { MigrationMode } from '../../domain/MigrationMode';
+/**
+ * In-memory builder that collects migration operations and data callbacks.
+ */
 export declare class CollectingBuilder implements Builder {
     static readonly BRAND: "tango.migrations.collecting_builder";
-    private mode?;
     readonly __tangoBrand: typeof CollectingBuilder.BRAND;
     ops: MigrationOperation[];
     dataFns: Array<(ctx: {
         query(sql: string, params?: readonly unknown[]): Promise<void>;
     }) => Promise<void>>;
+    private mode?;
+    /**
+     * Narrow an unknown value to the in-memory builder used during migration collection.
+     */
     static isCollectingBuilder(value: unknown): value is CollectingBuilder;
+    /**
+     * Append schema operations to the collection.
+     */
     run(...ops: MigrationOperation[]): void;
+    /**
+     * Register a data migration callback.
+     */
     data(fn: (ctx: {
         query(sql: string, params?: readonly unknown[]): Promise<void>;
     }) => Promise<void>): void;
+    /**
+     * Set execution options for the migration.
+     */
     options(o: {
         mode?: MigrationMode;
     }): void;
+    /**
+     * Get the currently configured migration mode.
+     */
     getMode(): MigrationMode | undefined;
 }

package/dist/{builder-Dtk8oP_Y.js → builder-xJ-Bq2pk.js}

@@ -1,7 +1,7 @@
 import { __export } from "./chunk-BkvOhyD0.js";
-import { CollectingBuilder } from "./CollectingBuilder-C6qnwyrb.js";
-import { InternalOperationKind } from "./InternalOperationKind-BPVoOQwD.js";
-import { InternalColumnType } from "./InternalColumnType-_YAz7RqI.js";
+import { CollectingBuilder } from "./CollectingBuilder--4fqDQdE.js";
+import { InternalOperationKind } from "./InternalOperationKind-Bt6Weuon.js";
+import { InternalColumnType } from "./InternalColumnType-G9zV9StN.js";
 
 //#region src/builder/contracts/index.ts
 var contracts_exports = {};
@@ -10,66 +10,80 @@ var contracts_exports = {};
 //#region src/builder/ops/OpBuilder.ts
 var ColumnBuilder = class ColumnBuilder {
 	static BRAND = "tango.migrations.column_builder";
-	spec = {};
 	__tangoBrand = ColumnBuilder.BRAND;
+	spec = {};
 	constructor(name) {
 		this.spec.name = name;
 	}
 	static isColumnBuilder(value) {
 		return typeof value === "object" && value !== null && value.__tangoBrand === ColumnBuilder.BRAND;
 	}
+	/** Set column type to serial/auto-increment. */
 	serial() {
 		this.spec.type = InternalColumnType.SERIAL;
 		return this;
 	}
+	/** Set column type to integer. */
 	int() {
 		this.spec.type = InternalColumnType.INT;
 		return this;
 	}
+	/** Set column type to bigint. */
 	bigint() {
 		this.spec.type = InternalColumnType.BIGINT;
 		return this;
 	}
+	/** Set column type to text. */
 	text() {
 		this.spec.type = InternalColumnType.TEXT;
 		return this;
 	}
+	/** Set column type to boolean. */
 	bool() {
 		this.spec.type = InternalColumnType.BOOL;
 		return this;
 	}
+	/** Set column type to timestamptz. */
 	timestamptz() {
 		this.spec.type = InternalColumnType.TIMESTAMPTZ;
 		return this;
 	}
+	/** Set column type to JSONB. */
 	jsonb() {
 		this.spec.type = InternalColumnType.JSONB;
 		return this;
 	}
+	/** Set column type to UUID. */
 	uuid() {
 		this.spec.type = InternalColumnType.UUID;
 		return this;
 	}
+	/** Mark column as NOT NULL. */
 	notNull() {
 		this.spec.notNull = true;
 		return this;
 	}
+	/** Set default to current timestamp. */
 	defaultNow() {
 		this.spec.default = { now: true };
 		return this;
 	}
+	/** Set reviewed raw SQL default expression. */
 	default(v) {
 		this.spec.default = v;
 		return this;
 	}
+	/** Mark column as part of primary key. */
 	primaryKey() {
 		this.spec.primaryKey = true;
 		return this;
 	}
+	/** Mark column as unique. */
 	unique() {
 		this.spec.unique = true;
 		return this;
 	}
+	/** Configure foreign key reference metadata. */
 	references(table, column, opts) {
 		this.spec.references = {
 			table,
@@ -85,11 +99,31 @@ var ColumnBuilder = class ColumnBuilder {
 };
 var OpBuilder = class OpBuilder {
 	static BRAND = "tango.migrations.op_builder";
-	__tangoBrand = OpBuilder.BRAND;
+	static index = {
+		create(p) {
+			return {
+				kind: InternalOperationKind.INDEX_CREATE,
+				...p
+			};
+		},
+		drop(p) {
+			return {
+				kind: InternalOperationKind.INDEX_DROP,
+				...p
+			};
+		}
+	};
 	static customOperations = new Map();
+	__tangoBrand = OpBuilder.BRAND;
+	/**
+	* Narrow an unknown value to the shared migration operation builder type.
+	*/
 	static isOpBuilder(value) {
 		return typeof value === "object" && value !== null && value.__tangoBrand === OpBuilder.BRAND;
 	}
+	/**
+	* Build table-scoped migration operations.
+	*/
 	static table(table) {
 		return {
 			create(def) {
@@ -142,20 +176,7 @@ var OpBuilder = class OpBuilder {
 			}
 		};
 	}
-	static index = {
-		create(p) {
-			return {
-				kind: InternalOperationKind.INDEX_CREATE,
-				...p
-			};
-		},
-		drop(p) {
-			return {
-				kind: InternalOperationKind.INDEX_DROP,
-				...p
-			};
-		}
-	};
+	/** Build a foreign key create operation. */
 	static foreignKey(p) {
 		return {
 			kind: InternalOperationKind.FK_CREATE,
@@ -169,21 +190,29 @@ var OpBuilder = class OpBuilder {
 			notValid: p.notValid
 		};
 	}
+	/** Build a foreign key validation operation. */
 	static foreignKeyValidate(p) {
 		return {
 			kind: InternalOperationKind.FK_VALIDATE,
 			...p
 		};
 	}
+	/** Build a foreign key drop operation. */
 	static foreignKeyDrop(p) {
 		return {
 			kind: InternalOperationKind.FK_DROP,
 			...p
 		};
 	}
+	/**
+	* Register a custom migration operation builder.
+	*/
 	static registerCustomOperation(name, builder) {
 		this.customOperations.set(name, builder);
 	}
+	/**
+	* Resolve a previously registered custom operation builder.
+	*/
 	static getCustomOperation(name) {
 		return this.customOperations.get(name);
 	}
@@ -198,9 +227,10 @@ function applyFieldType(builder, fieldType) {
 		case InternalColumnType.TIMESTAMPTZ: return builder.timestamptz();
 		case InternalColumnType.JSONB: return builder.jsonb();
 		case InternalColumnType.UUID: return builder.uuid();
-		default:
+		default: {
 			const exhaustive = fieldType;
 			throw new Error(`Unsupported field type: ${exhaustive}`);
+		}
 	}
 }
 
@@ -233,4 +263,4 @@ __export(builder_exports, {
 
 //#endregion
 export { OpBuilder, applyFieldType, builder_exports, contracts_exports, ops_exports, runtime_exports };
-//# sourceMappingURL=builder-Dtk8oP_Y.js.map
+//# sourceMappingURL=builder-xJ-Bq2pk.js.map

package/dist/builder-xJ-Bq2pk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-xJ-Bq2pk.js","names":["name: string","value: unknown","v: TrustedSqlFragment | null","table: string","column: string","opts?: {\n            onDelete?: DeleteReferentialAction;\n            onUpdate?: UpdateReferentialAction;\n        }","p: {\n            name: string;\n            table: string;\n            on: string[];\n            unique?: boolean;\n            where?: TrustedSqlFragment;\n            concurrently?: boolean;\n        }","p: { name: string; table: string; concurrently?: boolean }","def: (cols: { add: (name: string, cb: (b: ColumnBuilder) => ColumnBuilder) => void }) => void","columns: ColumnSpec[]","opts?: { cascade?: boolean }","cb: (b: ColumnBuilder) => ColumnBuilder","to: Partial<ColumnSpec>","from: string","to: string","p: {\n        table: string;\n        name?: string;\n        columns: string[];\n        references: { table: string; columns: string[] };\n        onDelete?: string;\n        onUpdate?: string;\n        notValid?: boolean;\n    }","p: { table: string; name: string }","name: TName","builder: (args: TArgs) => CustomMigrationOperation<TName, TArgs>","builder: ColumnBuilder","fieldType: ColumnType","exhaustive: never"],"sources":["../src/builder/contracts/index.ts","../src/builder/ops/OpBuilder.ts","../src/builder/ops/index.ts","../src/builder/runtime/index.ts","../src/builder/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { Builder } from './Builder';\nexport type { ColumnSpec } from './ColumnSpec';\nexport type { ColumnType } from './ColumnType';\nexport type { DeleteReferentialAction } from './DeleteReferentialAction';\nexport type { UpdateReferentialAction } from './UpdateReferentialAction';\n","import type { TrustedSqlFragment } from '@danceroutine/tango-core';\nimport type {\n    CustomMigrationOperation,\n    ForeignKeyCreate,\n    ForeignKeyDrop,\n    ForeignKeyValidate,\n    IndexCreate,\n    IndexDrop,\n    TableCreate,\n    TableDrop,\n    ColumnAdd,\n    ColumnDrop,\n    ColumnAlter,\n    ColumnRename,\n} from '../../domain/MigrationOperation';\nimport type { ColumnSpec } from '../contracts/ColumnSpec';\nimport type { ColumnType } from '../contracts/ColumnType';\nimport { InternalColumnType } from '../../domain/internal/InternalColumnType';\nimport type { DeleteReferentialAction } from '../contracts/DeleteReferentialAction';\nimport type { UpdateReferentialAction } from '../contracts/UpdateReferentialAction';\nimport { InternalOperationKind } from '../../domain/internal/InternalOperationKind';\n\n/**\n * Fluent builder for column specifications used by table operations.\n */\nclass ColumnBuilder {\n    static readonly BRAND = 'tango.migrations.column_builder' as const;\n    readonly __tangoBrand: typeof ColumnBuilder.BRAND = ColumnBuilder.BRAND;\n    private spec: Partial<ColumnSpec> = {};\n\n    constructor(name: string) {\n        this.spec.name = name;\n    }\n\n    static isColumnBuilder(value: unknown): value is ColumnBuilder {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === ColumnBuilder.BRAND\n        );\n    }\n\n    /** Set column type to serial/auto-increment. */\n    serial(): ColumnBuilder {\n        this.spec.type = InternalColumnType.SERIAL;\n        return this;\n    }\n    /** Set column type to integer. */\n    int(): ColumnBuilder {\n        this.spec.type = InternalColumnType.INT;\n        return this;\n    }\n    /** Set column type to bigint. */\n    bigint(): ColumnBuilder {\n        this.spec.type = InternalColumnType.BIGINT;\n        return this;\n    }\n    /** Set column type to text. */\n    text(): ColumnBuilder {\n        this.spec.type = InternalColumnType.TEXT;\n        return this;\n    }\n    /** Set column type to boolean. */\n    bool(): ColumnBuilder {\n        this.spec.type = InternalColumnType.BOOL;\n        return this;\n    }\n    /** Set column type to timestamptz. */\n    timestamptz(): ColumnBuilder {\n        this.spec.type = InternalColumnType.TIMESTAMPTZ;\n        return this;\n    }\n    /** Set column type to JSONB. */\n    jsonb(): ColumnBuilder {\n        this.spec.type = InternalColumnType.JSONB;\n        return this;\n    }\n    /** Set column type to UUID. */\n    uuid(): ColumnBuilder {\n        this.spec.type = InternalColumnType.UUID;\n        return this;\n    }\n\n    /** Mark column as NOT NULL. */\n    notNull(): ColumnBuilder {\n        this.spec.notNull = true;\n        return this;\n    }\n    /** Set default to current timestamp. */\n    defaultNow(): ColumnBuilder {\n        this.spec.default = { now: true };\n        return this;\n    }\n    /** Set reviewed raw SQL default expression. */\n    default(v: TrustedSqlFragment | null): ColumnBuilder {\n        this.spec.default = v;\n        return this;\n    }\n    /** Mark column as part of primary key. */\n    primaryKey(): ColumnBuilder {\n        this.spec.primaryKey = true;\n        return this;\n    }\n    /** Mark column as unique. */\n    unique(): ColumnBuilder {\n        this.spec.unique = true;\n        return this;\n    }\n    /** Configure foreign key reference metadata. */\n    references(\n        table: string,\n        column: string,\n        opts?: {\n            onDelete?: DeleteReferentialAction;\n            onUpdate?: UpdateReferentialAction;\n        }\n    ): ColumnBuilder {\n        this.spec.references = {\n            table,\n            column,\n            onDelete: opts?.onDelete,\n            onUpdate: opts?.onUpdate,\n        };\n        return this;\n    }\n\n    _done(): ColumnSpec {\n        return this.spec as ColumnSpec;\n    }\n}\n\ntype TableOperationBuilder = {\n    create(def: (cols: { add: (name: string, cb: (b: ColumnBuilder) => ColumnBuilder) => void }) => void): TableCreate;\n    drop(opts?: { cascade?: boolean }): TableDrop;\n    addColumn(name: string, cb: (b: ColumnBuilder) => ColumnBuilder): ColumnAdd;\n    dropColumn(name: string): ColumnDrop;\n    alterColumn(name: string, to: Partial<ColumnSpec>): ColumnAlter;\n    renameColumn(from: string, to: string): ColumnRename;\n};\n\n/**\n * Static factory for migration operations.\n */\nexport class OpBuilder {\n    static readonly BRAND = 'tango.migrations.op_builder' as const;\n    static index = {\n        /** Build an index create operation. */\n        create(p: {\n            name: string;\n            table: string;\n            on: string[];\n            unique?: boolean;\n            where?: TrustedSqlFragment;\n            concurrently?: boolean;\n        }): IndexCreate {\n            return { kind: InternalOperationKind.INDEX_CREATE, ...p };\n        },\n        /** Build an index drop operation. */\n        drop(p: { name: string; table: string; concurrently?: boolean }): IndexDrop {\n            return { kind: InternalOperationKind.INDEX_DROP, ...p };\n        },\n    };\n    private static customOperations = new Map<string, (args: Record<string, unknown>) => CustomMigrationOperation>();\n    readonly __tangoBrand: typeof OpBuilder.BRAND = OpBuilder.BRAND;\n\n    /**\n     * Narrow an unknown value to the shared migration operation builder type.\n     */\n    static isOpBuilder(value: unknown): value is OpBuilder {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === OpBuilder.BRAND\n        );\n    }\n\n    /**\n     * Build table-scoped migration operations.\n     */\n    static table(table: string): TableOperationBuilder {\n        return {\n            create(\n                def: (cols: { add: (name: string, cb: (b: ColumnBuilder) => ColumnBuilder) => void }) => void\n            ): TableCreate {\n                const columns: ColumnSpec[] = [];\n                def({\n                    add(name, cb) {\n                        columns.push(cb(new ColumnBuilder(name))._done());\n                    },\n                });\n                return { kind: InternalOperationKind.TABLE_CREATE, table, columns };\n            },\n            drop(opts?: { cascade?: boolean }): TableDrop {\n                return { kind: InternalOperationKind.TABLE_DROP, table, cascade: opts?.cascade };\n            },\n            addColumn(name: string, cb: (b: ColumnBuilder) => ColumnBuilder): ColumnAdd {\n                return { kind: InternalOperationKind.COLUMN_ADD, table, column: cb(new ColumnBuilder(name))._done() };\n            },\n            dropColumn(name: string): ColumnDrop {\n                return { kind: InternalOperationKind.COLUMN_DROP, table, column: name };\n            },\n            alterColumn(name: string, to: Partial<ColumnSpec>): ColumnAlter {\n                return { kind: InternalOperationKind.COLUMN_ALTER, table, column: name, to };\n            },\n            renameColumn(from: string, to: string): ColumnRename {\n                return { kind: InternalOperationKind.COLUMN_RENAME, table, from, to };\n            },\n        };\n    }\n\n    /** Build a foreign key create operation. */\n    static foreignKey(p: {\n        table: string;\n        name?: string;\n        columns: string[];\n        references: { table: string; columns: string[] };\n        onDelete?: string;\n        onUpdate?: string;\n        notValid?: boolean;\n    }): ForeignKeyCreate {\n        return {\n            kind: InternalOperationKind.FK_CREATE,\n            table: p.table,\n            name: p.name,\n            columns: p.columns,\n            refTable: p.references.table,\n            refColumns: p.references.columns,\n            onDelete: p.onDelete,\n            onUpdate: p.onUpdate,\n            notValid: p.notValid,\n        };\n    }\n\n    /** Build a foreign key validation operation. */\n    static foreignKeyValidate(p: { table: string; name: string }): ForeignKeyValidate {\n        return { kind: InternalOperationKind.FK_VALIDATE, ...p };\n    }\n\n    /** Build a foreign key drop operation. */\n    static foreignKeyDrop(p: { table: string; name: string }): ForeignKeyDrop {\n        return { kind: InternalOperationKind.FK_DROP, ...p };\n    }\n\n    /**\n     * Register a custom migration operation builder.\n     */\n    static registerCustomOperation<TName extends string, TArgs extends object>(\n        name: TName,\n        builder: (args: TArgs) => CustomMigrationOperation<TName, TArgs>\n    ): void {\n        this.customOperations.set(name, builder as (args: Record<string, unknown>) => CustomMigrationOperation);\n    }\n\n    /**\n     * Resolve a previously registered custom operation builder.\n     */\n    static getCustomOperation<TName extends string, TArgs extends object>(\n        name: TName\n    ): ((args: TArgs) => CustomMigrationOperation<TName, TArgs>) | undefined {\n        return this.customOperations.get(name) as ((args: TArgs) => CustomMigrationOperation<TName, TArgs>) | undefined;\n    }\n}\n\n/**\n * Apply a domain field type to a column builder.\n */\nexport function applyFieldType(builder: ColumnBuilder, fieldType: ColumnType): ColumnBuilder {\n    switch (fieldType) {\n        case InternalColumnType.SERIAL:\n            return builder.serial();\n        case InternalColumnType.INT:\n            return builder.int();\n        case InternalColumnType.BIGINT:\n            return builder.bigint();\n        case InternalColumnType.TEXT:\n            return builder.text();\n        case InternalColumnType.BOOL:\n            return builder.bool();\n        case InternalColumnType.TIMESTAMPTZ:\n            return builder.timestamptz();\n        case InternalColumnType.JSONB:\n            return builder.jsonb();\n        case InternalColumnType.UUID:\n            return builder.uuid();\n        default: {\n            const exhaustive: never = fieldType;\n            throw new Error(`Unsupported field type: ${exhaustive}`);\n        }\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { OpBuilder, OpBuilder as op, applyFieldType } from './OpBuilder';\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { CollectingBuilder } from './CollectingBuilder';\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as contracts from './contracts/index';\nexport * as ops from './ops/index';\nexport * as runtime from './runtime/index';\n\nexport type {\n    Builder,\n    ColumnSpec,\n    ColumnType,\n    DeleteReferentialAction,\n    UpdateReferentialAction,\n} from './contracts/index';\nexport { OpBuilder, op, applyFieldType } from './ops/index';\nexport { CollectingBuilder } from './runtime/index';\n"],"mappings":"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"}