@warlock.js/cascade 4.0.174 → 4.1.2

package/esm/migration/column-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-helpers.mjs","names":[],"sources":["../../../../../../@warlock.js/cascade/src/migration/column-helpers.ts"],"sourcesContent":["import { ColumnBuilder } from \"./column-builder\";\n\n/**\n * A no-op migration sink used by standalone column helpers.\n *\n * When column helpers are used in `Migration.create()` / `Migration.alter()`,\n * the builder is constructed without a real migration context. The actual\n * operations are dequeued from the ColumnBuilder's definition and replayed\n * onto the real migration instance at execution time.\n *\n * Index and FK operations queued on this sink are collected and transferred\n * to the real migration by the factory methods.\n */\nclass DetachedMigrationSink {\n  /** Pending indexes registered via .unique() / .index() on a helper column. */\n  public readonly pendingIndexes: { columns: string[]; unique?: boolean }[] = [];\n\n  /** Pending FK definitions registered via .references() on a helper column. */\n  public readonly pendingForeignKeys: object[] = [];\n\n  /** Pending Vector index definitions registered via .vectorIndex() on a helper column. */\n  public readonly pendingVectorIndexes: {\n    column: string;\n    options: import(\"../contracts/migration-driver.contract\").VectorIndexOptions;\n  }[] = [];\n\n  public addPendingIndex(index: { columns: string[]; unique?: boolean }): void {\n    this.pendingIndexes.push(index);\n  }\n\n  public addForeignKeyOperation(fk: object): void {\n    this.pendingForeignKeys.push(fk);\n  }\n\n  public addPendingVectorIndex(\n    column: string,\n    options: Omit<import(\"../contracts/migration-driver.contract\").VectorIndexOptions, \"column\">,\n  ): void {\n    this.pendingVectorIndexes.push({ column, options: options as any });\n  }\n}\n\n/**\n * A `ColumnBuilder` that carries its own detached sink so it can be\n * constructed outside of a migration class and later merged in.\n */\nexport class DetachedColumnBuilder extends ColumnBuilder {\n  public readonly sink: DetachedMigrationSink;\n\n  public constructor(\n    type: ConstructorParameters<typeof ColumnBuilder>[2],\n    name: string,\n    options: ConstructorParameters<typeof ColumnBuilder>[3] = {},\n  ) {\n    const sink = new DetachedMigrationSink();\n    super(sink as any, name, type, options);\n    this.sink = sink;\n  }\n}\n\n// ============================================================================\n// STRING HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: string / varchar.\n *\n * @example\n * ```typescript\n * import { Migration, string } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   username: string(50).unique(),\n * });\n * ```\n */\nexport function string(length = 255): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"string\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: fixed-length CHAR.\n *\n * @example\n * ```typescript\n * code: char(3) // CHAR(3)\n * ```\n */\nexport function char(length: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"char\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: TEXT (unlimited length).\n *\n * @example\n * ```typescript\n * import { Migration, text } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   bio: text().nullable(),\n * });\n * ```\n */\nexport function text(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"text\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MEDIUMTEXT.\n */\nexport function mediumText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"mediumText\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: LONGTEXT.\n */\nexport function longText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"longText\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NUMERIC HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: INTEGER.\n *\n * @example\n * ```typescript\n * age: integer().unsigned()\n * ```\n */\nexport function integer(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"integer\", \"__placeholder__\");\n}\n\n/** Alias for `integer()`. */\nexport const int = integer;\n\n/**\n * Standalone column helper: SMALLINT.\n */\nexport function smallInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"smallInteger\", \"__placeholder__\");\n}\n\n/** Alias for `smallInteger()`. */\nexport const smallInt = smallInteger;\n\n/**\n * Standalone column helper: TINYINT.\n */\nexport function tinyInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"tinyInteger\", \"__placeholder__\");\n}\n\n/** Alias for `tinyInteger()`. */\nexport const tinyInt = tinyInteger;\n\n/**\n * Standalone column helper: BIGINT.\n */\nexport function bigInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"bigInteger\", \"__placeholder__\");\n}\n\n/** Alias for `bigInteger()`. */\nexport const bigInt = bigInteger;\n\n/**\n * Standalone column helper: FLOAT.\n */\nexport function float(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"float\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DOUBLE.\n */\nexport function double(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"double\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DECIMAL.\n *\n * @example\n * ```typescript\n * price: decimal(10, 2) // DECIMAL(10,2)\n * ```\n */\nexport function decimal(precision = 8, scale = 2): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"decimal\", \"__placeholder__\", { precision, scale });\n}\n\n// ============================================================================\n// BOOLEAN HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: BOOLEAN.\n *\n * Named `boolCol` to avoid collision with the TypeScript / JS `boolean` primitive.\n *\n * @example\n * ```typescript\n * is_active: boolCol().default(true)\n * ```\n */\nexport function boolCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"boolean\", \"__placeholder__\");\n}\n\n/** Alias for `boolCol()`. */\nexport { boolCol as bool };\n\n// ============================================================================\n// DATE / TIME HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: DATE.\n */\nexport function date(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"date\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DATETIME.\n */\nexport function dateTime(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"dateTime\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIMESTAMP.\n *\n * @example\n * ```typescript\n * started_at: timestamp().default(\"NOW()\")\n * ```\n */\nexport function timestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"timestamp\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIME.\n */\nexport function time(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"time\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: YEAR.\n */\nexport function year(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"year\", \"__placeholder__\");\n}\n\n// ============================================================================\n// JSON & BINARY HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: JSON.\n *\n * Named `jsonCol` to avoid collision with the TS/JSON built-in names.\n * Use `json()` is fine for most cases though — this alias exists for clarity.\n *\n * @example\n * ```typescript\n * metadata: json().nullable()\n * ```\n */\nexport function json(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Alias for `json()`. Named `objectCol` to avoid collision with TS `object` type.\n */\nexport function objectCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: BINARY / BLOB.\n */\nexport function binary(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n/**\n * Alias for `binary()`. Named `blobCol` to avoid collision with the Web `Blob` API.\n */\nexport function blobCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n// ============================================================================\n// IDENTIFIER HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: UUID.\n *\n * @example\n * ```typescript\n * import { Migration, uuid } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(Chat, {\n *   organization_id: uuid().references(Organization).onDelete(\"cascade\"),\n * });\n * ```\n */\nexport function uuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"uuid\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: ULID.\n */\nexport function ulid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ulid\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NETWORK HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: IP address.\n */\nexport function ipAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ipAddress\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MAC address.\n */\nexport function macAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"macAddress\", \"__placeholder__\");\n}\n\n// ============================================================================\n// SPATIAL HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: geo point.\n */\nexport function point(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"point\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: polygon.\n */\nexport function polygon(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"polygon\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: line string.\n */\nexport function lineString(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"lineString\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: generic geometry.\n */\nexport function geometry(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"geometry\", \"__placeholder__\");\n}\n\n// ============================================================================\n// AI / ML HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: vector (for AI embeddings).\n *\n * @param dimensions - Embedding size (e.g. 1536 for text-embedding-3-small)\n *\n * @example\n * ```typescript\n * embedding: vector(1536)\n * ```\n */\nexport function vector(dimensions: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"vector\", \"__placeholder__\", { dimensions });\n}\n\n// ============================================================================\n// ENUM & SET HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: ENUM.\n *\n * @example\n * ```typescript\n * status: enumCol([\"active\", \"inactive\", \"pending\"])\n * ```\n */\nexport function enumCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"enum\", \"__placeholder__\", { values });\n}\n\n/**\n * Standalone column helper: SET (multiple values).\n */\nexport function setCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"set\", \"__placeholder__\", { values });\n}\n\n// ============================================================================\n// POSTGRESQL ARRAY HELPERS\n// ============================================================================\n\n/** Standalone helper: INTEGER[] */\nexport function arrayInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: BIGINT[] */\nexport function arrayBigInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBigInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: REAL[] */\nexport function arrayFloat(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayFloat\", \"__placeholder__\");\n}\n\n/** Standalone helper: DECIMAL[] */\nexport function arrayDecimal(precision?: number, scale?: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDecimal\", \"__placeholder__\", { precision, scale });\n}\n\n/** Standalone helper: BOOLEAN[] */\nexport function arrayBoolean(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBoolean\", \"__placeholder__\");\n}\n\n/** Standalone helper: TEXT[] */\nexport function arrayText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayText\", \"__placeholder__\");\n}\n\n/** Standalone helper: DATE[] */\nexport function arrayDate(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDate\", \"__placeholder__\");\n}\n\n/** Standalone helper: TIMESTAMPTZ[] */\nexport function arrayTimestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayTimestamp\", \"__placeholder__\");\n}\n\n/** Standalone helper: UUID[] */\nexport function arrayUuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayUuid\", \"__placeholder__\");\n}\n\n/** Standalone helper: JSONB[] */\nexport function arrayJson(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayJson\", \"__placeholder__\");\n}\n"],"mappings":"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"}

package/esm/migration/foreign-key-builder.d.mts

@@ -0,0 +1,106 @@
+import { ForeignKeyDefinition } from "../contracts/migration-driver.contract.mjs";
+
+//#region ../../@warlock.js/cascade/src/migration/foreign-key-builder.d.ts
+/**
+ * Reference to the Migration type to avoid circular imports.
+ */
+type MigrationLike = {
+  addForeignKeyOperation(fk: ForeignKeyDefinition): void;
+};
+/**
+ * Fluent builder for foreign key constraints.
+ *
+ * Allows building foreign key definitions with a chainable API.
+ * SQL-only feature; NoSQL drivers ignore foreign keys.
+ *
+ * The operation is pushed when `.references()` is called using a mutable
+ * reference — subsequent `.onDelete()` / `.onUpdate()` calls mutate the
+ * same definition already queued in pendingOperations.
+ *
+ * @example
+ * ```typescript
+ * this.foreign("user_id")
+ *   .references("users", "id")
+ *   .onDelete("cascade")
+ *   .onUpdate("cascade");
+ * ```
+ */
+declare class ForeignKeyBuilder {
+  private readonly migration;
+  /** Mutable foreign key definition being accumulated */
+  private readonly definition;
+  /**
+   * Create a new foreign key builder.
+   *
+   * @param migration - Parent migration instance
+   * @param column - Local column name that will reference another table
+   */
+  constructor(migration: MigrationLike, column: string);
+  /**
+   * Set the constraint name.
+   *
+   * @param name - Constraint name (auto-generated if not provided)
+   * @returns This builder for chaining
+   */
+  name(name: string): this;
+  /**
+   * Set the referenced table and column, and register the foreign key operation.
+   *
+   * Pushes the operation immediately using a mutable reference — any
+   * `.onDelete()` / `.onUpdate()` calls after this will mutate the same
+   * definition already queued in pendingOperations.
+   *
+   * @param table - Referenced table name
+   * @param column - Referenced column name (default: "id")
+   * @returns This builder for chaining
+   *
+   * @example
+   * ```typescript
+   * this.foreign("user_id").references("users", "id");
+   * this.foreign("category_id").references("categories"); // defaults to "id"
+   * ```
+   */
+  references(table: string, column?: string): this;
+  /**
+   * Set the ON DELETE action.
+   *
+   * @param action - Action to take when referenced row is deleted
+   * @returns This builder for chaining
+   *
+   * @example
+   * ```typescript
+   * this.foreign("user_id")
+   *   .references("users")
+   *   .onDelete("cascade"); // Delete child when parent is deleted
+   * ```
+   */
+  onDelete(action: ForeignKeyDefinition["onDelete"]): this;
+  /**
+   * Set the ON UPDATE action.
+   *
+   * @param action - Action to take when referenced row's key is updated
+   * @returns This builder for chaining
+   *
+   * @example
+   * ```typescript
+   * this.foreign("user_id")
+   *   .references("users")
+   *   .onUpdate("cascade"); // Update child when parent key changes
+   * ```
+   */
+  onUpdate(action: ForeignKeyDefinition["onUpdate"]): this;
+  /**
+   * Shorthand for `.onDelete("cascade").onUpdate("cascade")`.
+   *
+   * @returns This builder for chaining
+   *
+   * @example
+   * ```typescript
+   * this.foreign("user_id").references("users").cascadeAll();
+   * ```
+   */
+  cascadeAll(): this;
+}
+//#endregion
+export { ForeignKeyBuilder };
+//# sourceMappingURL=foreign-key-builder.d.mts.map

package/esm/migration/foreign-key-builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-key-builder.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/migration/foreign-key-builder.ts"],"mappings":";;;;;AAAmF;KAK9E,aAAA;EACH,sBAAA,CAAuB,EAAA,EAAI,oBAAoB;AAAA;;;;;AAAA;AAiCjD;;;;;;;;;;;;;cAAa,iBAAA;EAAA,iBAWQ,SAAA;EAkBP;EAAA,iBA3BK,UAAA;EAiDC;;;;;;cAxCC,SAAA,EAAW,aAAA,EAC5B,MAAA;EA6Ec;;;AAeC;;;EA3EV,IAAA,CAAK,IAAA;;;;;;;;;;;;;;;;;;EAsBL,UAAA,CAAW,KAAA,UAAe,MAAA;;;;;;;;;;;;;;EAoB1B,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;;EAkBjB,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;EAejB,UAAA,CAAA;AAAA"}

package/esm/migration/foreign-key-builder.mjs

@@ -0,0 +1,126 @@
+//#region ../../@warlock.js/cascade/src/migration/foreign-key-builder.ts
+/**
+* Fluent builder for foreign key constraints.
+*
+* Allows building foreign key definitions with a chainable API.
+* SQL-only feature; NoSQL drivers ignore foreign keys.
+*
+* The operation is pushed when `.references()` is called using a mutable
+* reference — subsequent `.onDelete()` / `.onUpdate()` calls mutate the
+* same definition already queued in pendingOperations.
+*
+* @example
+* ```typescript
+* this.foreign("user_id")
+*   .references("users", "id")
+*   .onDelete("cascade")
+*   .onUpdate("cascade");
+* ```
+*/
+var ForeignKeyBuilder = class {
+	migration;
+	/** Mutable foreign key definition being accumulated */
+	definition;
+	/**
+	* Create a new foreign key builder.
+	*
+	* @param migration - Parent migration instance
+	* @param column - Local column name that will reference another table
+	*/
+	constructor(migration, column) {
+		this.migration = migration;
+		this.definition = {
+			column,
+			referencesTable: "",
+			referencesColumn: "id",
+			onDelete: "restrict",
+			onUpdate: "restrict"
+		};
+	}
+	/**
+	* Set the constraint name.
+	*
+	* @param name - Constraint name (auto-generated if not provided)
+	* @returns This builder for chaining
+	*/
+	name(name) {
+		this.definition.name = name;
+		return this;
+	}
+	/**
+	* Set the referenced table and column, and register the foreign key operation.
+	*
+	* Pushes the operation immediately using a mutable reference — any
+	* `.onDelete()` / `.onUpdate()` calls after this will mutate the same
+	* definition already queued in pendingOperations.
+	*
+	* @param table - Referenced table name
+	* @param column - Referenced column name (default: "id")
+	* @returns This builder for chaining
+	*
+	* @example
+	* ```typescript
+	* this.foreign("user_id").references("users", "id");
+	* this.foreign("category_id").references("categories"); // defaults to "id"
+	* ```
+	*/
+	references(table, column = "id") {
+		this.definition.referencesTable = table;
+		this.definition.referencesColumn = column;
+		this.migration.addForeignKeyOperation(this.definition);
+		return this;
+	}
+	/**
+	* Set the ON DELETE action.
+	*
+	* @param action - Action to take when referenced row is deleted
+	* @returns This builder for chaining
+	*
+	* @example
+	* ```typescript
+	* this.foreign("user_id")
+	*   .references("users")
+	*   .onDelete("cascade"); // Delete child when parent is deleted
+	* ```
+	*/
+	onDelete(action) {
+		this.definition.onDelete = action;
+		return this;
+	}
+	/**
+	* Set the ON UPDATE action.
+	*
+	* @param action - Action to take when referenced row's key is updated
+	* @returns This builder for chaining
+	*
+	* @example
+	* ```typescript
+	* this.foreign("user_id")
+	*   .references("users")
+	*   .onUpdate("cascade"); // Update child when parent key changes
+	* ```
+	*/
+	onUpdate(action) {
+		this.definition.onUpdate = action;
+		return this;
+	}
+	/**
+	* Shorthand for `.onDelete("cascade").onUpdate("cascade")`.
+	*
+	* @returns This builder for chaining
+	*
+	* @example
+	* ```typescript
+	* this.foreign("user_id").references("users").cascadeAll();
+	* ```
+	*/
+	cascadeAll() {
+		this.definition.onDelete = "cascade";
+		this.definition.onUpdate = "cascade";
+		return this;
+	}
+};
+
+//#endregion
+export { ForeignKeyBuilder };
+//# sourceMappingURL=foreign-key-builder.mjs.map

package/esm/migration/foreign-key-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-key-builder.mjs","names":[],"sources":["../../../../../../@warlock.js/cascade/src/migration/foreign-key-builder.ts"],"sourcesContent":["import type { ForeignKeyDefinition } from \"../contracts/migration-driver.contract\";\n\n/**\n * Reference to the Migration type to avoid circular imports.\n */\ntype MigrationLike = {\n  addForeignKeyOperation(fk: ForeignKeyDefinition): void;\n};\n\n/**\n * Mutable foreign key definition being built.\n */\ninterface MutableForeignKeyDefinition {\n  name?: string;\n  column: string;\n  referencesTable: string;\n  referencesColumn: string;\n  onDelete: ForeignKeyDefinition[\"onDelete\"];\n  onUpdate: ForeignKeyDefinition[\"onUpdate\"];\n}\n\n/**\n * Fluent builder for foreign key constraints.\n *\n * Allows building foreign key definitions with a chainable API.\n * SQL-only feature; NoSQL drivers ignore foreign keys.\n *\n * The operation is pushed when `.references()` is called using a mutable\n * reference — subsequent `.onDelete()` / `.onUpdate()` calls mutate the\n * same definition already queued in pendingOperations.\n *\n * @example\n * ```typescript\n * this.foreign(\"user_id\")\n *   .references(\"users\", \"id\")\n *   .onDelete(\"cascade\")\n *   .onUpdate(\"cascade\");\n * ```\n */\nexport class ForeignKeyBuilder {\n  /** Mutable foreign key definition being accumulated */\n  private readonly definition: MutableForeignKeyDefinition;\n\n  /**\n   * Create a new foreign key builder.\n   *\n   * @param migration - Parent migration instance\n   * @param column - Local column name that will reference another table\n   */\n  public constructor(\n    private readonly migration: MigrationLike,\n    column: string,\n  ) {\n    this.definition = {\n      column,\n      referencesTable: \"\",\n      referencesColumn: \"id\",\n      onDelete: \"restrict\",\n      onUpdate: \"restrict\",\n    };\n  }\n\n  /**\n   * Set the constraint name.\n   *\n   * @param name - Constraint name (auto-generated if not provided)\n   * @returns This builder for chaining\n   */\n  public name(name: string): this {\n    this.definition.name = name;\n    return this;\n  }\n\n  /**\n   * Set the referenced table and column, and register the foreign key operation.\n   *\n   * Pushes the operation immediately using a mutable reference — any\n   * `.onDelete()` / `.onUpdate()` calls after this will mutate the same\n   * definition already queued in pendingOperations.\n   *\n   * @param table - Referenced table name\n   * @param column - Referenced column name (default: \"id\")\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\", \"id\");\n   * this.foreign(\"category_id\").references(\"categories\"); // defaults to \"id\"\n   * ```\n   */\n  public references(table: string, column = \"id\"): this {\n    this.definition.referencesTable = table;\n    this.definition.referencesColumn = column;\n    this.migration.addForeignKeyOperation(this.definition as ForeignKeyDefinition);\n    return this;\n  }\n\n  /**\n   * Set the ON DELETE action.\n   *\n   * @param action - Action to take when referenced row is deleted\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onDelete(\"cascade\"); // Delete child when parent is deleted\n   * ```\n   */\n  public onDelete(action: ForeignKeyDefinition[\"onDelete\"]): this {\n    this.definition.onDelete = action;\n    return this;\n  }\n\n  /**\n   * Set the ON UPDATE action.\n   *\n   * @param action - Action to take when referenced row's key is updated\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onUpdate(\"cascade\"); // Update child when parent key changes\n   * ```\n   */\n  public onUpdate(action: ForeignKeyDefinition[\"onUpdate\"]): this {\n    this.definition.onUpdate = action;\n    return this;\n  }\n\n  /**\n   * Shorthand for `.onDelete(\"cascade\").onUpdate(\"cascade\")`.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\").cascadeAll();\n   * ```\n   */\n  public cascadeAll(): this {\n    this.definition.onDelete = \"cascade\";\n    this.definition.onUpdate = \"cascade\";\n    return this;\n  }\n\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAuCA,IAAa,oBAAb,MAA+B;CAWV;;CATnB,AAAiB;;;;;;;CAQjB,AAAO,YACL,AAAiB,WACjB,QACA;EAFiB;EAGjB,KAAK,aAAa;GAChB;GACA,iBAAiB;GACjB,kBAAkB;GAClB,UAAU;GACV,UAAU;EACZ;CACF;;;;;;;CAQA,AAAO,KAAK,MAAoB;EAC9B,KAAK,WAAW,OAAO;EACvB,OAAO;CACT;;;;;;;;;;;;;;;;;;CAmBA,AAAO,WAAW,OAAe,SAAS,MAAY;EACpD,KAAK,WAAW,kBAAkB;EAClC,KAAK,WAAW,mBAAmB;EACnC,KAAK,UAAU,uBAAuB,KAAK,UAAkC;EAC7E,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;CAYA,AAAO,aAAmB;EACxB,KAAK,WAAW,WAAW;EAC3B,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;AAEF"}

package/esm/migration/index.d.mts

@@ -0,0 +1,6 @@
+import { ColumnBuilder } from "./column-builder.mjs";
+import { DetachedColumnBuilder, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, bigInt, bigInteger, binary, blobCol, boolCol, char, date, dateTime, decimal, double, enumCol, float, geometry, int, integer, ipAddress, json, lineString, longText, macAddress, mediumText, objectCol, point, polygon, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, ulid, uuid, vector, year } from "./column-helpers.mjs";
+import { ForeignKeyBuilder } from "./foreign-key-builder.mjs";
+import { AlterSchema, ColumnMap, IndexEntry, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, OperationType, PendingOperation, UniqueEntry, migrate } from "./migration.mjs";
+import { MigrationRecord, MigrationResult, MigrationRunnerOptions, MigrationStatus, PendingMigration, RollbackOptions, RunMigrationsOptions } from "./types.mjs";
+import { MigrationRunner, migrationRunner } from "./migration-runner.mjs";

package/esm/migration/index.mjs

@@ -0,0 +1,7 @@
+import { ColumnBuilder } from "./column-builder.mjs";
+import { ForeignKeyBuilder } from "./foreign-key-builder.mjs";
+import { DetachedColumnBuilder, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, bigInt, bigInteger, binary, blobCol, boolCol, char, date, dateTime, decimal, double, enumCol, float, geometry, int, integer, ipAddress, json, lineString, longText, macAddress, mediumText, objectCol, point, polygon, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, ulid, uuid, vector, year } from "./column-helpers.mjs";
+import { Migration, migrate } from "./migration.mjs";
+import { MigrationRunner, migrationRunner } from "./migration-runner.mjs";
+
+export {  };

package/esm/migration/migration-runner.d.mts

@@ -0,0 +1,279 @@
+import { Migration } from "./migration.mjs";
+import { DataSource } from "../data-source/data-source.mjs";
+import { MigrationRecord, MigrationResult } from "./types.mjs";
+
+//#region ../../@warlock.js/cascade/src/migration/migration-runner.d.ts
+/**
+ * Migration class type with static name property.
+ */
+type MigrationClass = (new () => Migration) & {
+  migrationName: string;
+  createdAt?: string;
+};
+/**
+ * Options for migration execution.
+ */
+type ExecuteOptions = {
+  /** Run in dry-run mode (no actual changes) */readonly dryRun?: boolean; /** Record to migrations table (default: true for batch, false for single) */
+  readonly record?: boolean;
+};
+/**
+ * Migration runner that executes migrations.
+ *
+ * This is a pure executor - it doesn't discover migrations.
+ * Discovery is handled by the framework (e.g., @warlock.js/core CLI).
+ *
+ * The migration name is read from the static `name` property on the class,
+ * which should be set by the CLI after importing:
+ *
+ * @example
+ * ```typescript
+ * // In CLI after importing:
+ * const { default: MigrationClass } = await import("./create-users.migration.ts");
+ * MigrationClass.migrationName ??= "create-users";
+ *
+ * // Then register or execute:
+ * runner.register(MigrationClass);
+ * // or
+ * await runner.execute(MigrationClass);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Simple direct execution
+ * await runner.execute(CreateUsersTable);
+ * await runner.rollback(CreateUsersTable);
+ *
+ * // Registry pattern for batch operations
+ * runner.register(CreateUsersTable);
+ * runner.register(AddEmailIndex);
+ * await runner.runAll();
+ * await runner.rollbackAll();
+ * ```
+ */
+declare class MigrationRunner {
+  /** Registered migrations */
+  readonly migrations: MigrationClass[];
+  /** Data source to use */
+  private dataSource?;
+  /** Cached migration driver */
+  private cachedMigrationDriver?;
+  /** Table name for tracking migrations */
+  private readonly migrationsTable;
+  /** Whether to log operations */
+  private readonly verbose;
+  /**
+   * Create a new migration runner.
+   *
+   * @param options - Runner options
+   */
+  constructor(options?: {
+    dataSource?: DataSource;
+    migrationsTable?: string;
+    verbose?: boolean;
+  });
+  /**
+   * Set the data source.
+   */
+  setDataSource(dataSource: DataSource): this;
+  /**
+   * Get the data source.
+   */
+  private getDataSource;
+  /**
+   * Get the migration driver.
+   */
+  private getMigrationDriver;
+  /**
+   * Register a migration.
+   *
+   * The migration name is read from `MigrationClass.migrationName`.
+   *
+   * @param MigrationClass - Migration class (must have static `name` set)
+   * @param createdAt - Optional timestamp for ordering
+   * @returns This runner for chaining
+   *
+   * @example
+   * ```typescript
+   * CreateUsersTable.migrationName = "2024-01-15_create-users";
+   * runner.register(CreateUsersTable);
+   * ```
+   */
+  register(MigrationClass: MigrationClass): this;
+  /**
+   * Register multiple migrations.
+   *
+   * @param migrations - Array of migration classes
+   * @returns This runner for chaining
+   */
+  registerMany(migrations: MigrationClass[]): this;
+  /**
+   * Clear all registered migrations.
+   */
+  clear(): this;
+  /**
+   * Get all registered migration names.
+   */
+  getRegisteredNames(): string[];
+  /**
+   * Execute a single migration's up() method.
+   *
+   * @param MigrationClass - Migration class to execute
+   * @param options - Execution options
+   * @returns Migration result
+   *
+   * @example
+   * ```typescript
+   * await runner.execute(CreateUsersTable);
+   * await runner.execute(AddEmailIndex, { dryRun: true });
+   * ```
+   */
+  run(MigrationClass: MigrationClass, options?: ExecuteOptions): Promise<MigrationResult>;
+  /**
+   * Execute a single migration's down() method.
+   *
+   * @param MigrationClass - Migration class to rollback
+   * @param options - Execution options
+   * @returns Migration result
+   *
+   * @example
+   * ```typescript
+   * await runner.rollback(CreateUsersTable);
+   * ```
+   */
+  rollback(MigrationClass: MigrationClass, options?: ExecuteOptions): Promise<MigrationResult>;
+  /**
+   * Run all pending registered migrations.
+   *
+   * Only runs migrations not already in the migrations table.
+   *
+   * @param options - Execution options
+   * @returns Results for each migration
+   *
+   * @example
+   * ```typescript
+   * runner.register(CreateUsersTable);
+   * runner.register(AddEmailIndex);
+   * const results = await runner.runAll();
+   * ```
+   */
+  runAll(options?: ExecuteOptions): Promise<MigrationResult[]>;
+  /**
+   * Export migrations as phase-ordered SQL files in database/sql/ directory.
+   * By default, it exports all registered migrations. Use `pendingOnly: true` to export only pending ones.
+   */
+  exportSQL(options?: {
+    pendingOnly?: boolean;
+    compact?: boolean;
+  }): Promise<void>;
+  /**
+   * Rollback the last batch of migrations.
+   *
+   * @param options - Execution options
+   * @returns Results for each migration
+   */
+  rollbackLast(options?: ExecuteOptions): Promise<MigrationResult[]>;
+  /**
+   * Rollback N batches of migrations.
+   *
+   * @param batches - Number of batches to rollback
+   * @param options - Execution options
+   * @returns Results for each migration
+   */
+  rollbackBatches(batches: number, options?: ExecuteOptions): Promise<MigrationResult[]>;
+  /**
+   * Rollback all executed migrations.
+   *
+   * @param options - Execution options
+   * @returns Results for each migration
+   */
+  rollbackAll(options?: ExecuteOptions): Promise<MigrationResult[]>;
+  /**
+   * Reset and re-run: rollback all then run all.
+   *
+   * @param options - Execution options
+   * @returns Combined results
+   */
+  fresh(options?: ExecuteOptions): Promise<MigrationResult[]>;
+  /**
+   * Get status of all registered migrations.
+   */
+  status(): Promise<Array<{
+    name: string;
+    table: string;
+    executed: boolean;
+    batch: number | null;
+  }>>;
+  /**
+   * Check whether a database extension is available and inform the developer
+   * if it is not installed.
+   *
+   * Does NOT throw — execution proceeds normally. If the extension is truly
+   * missing, the database will surface its own error with full context already
+   * displayed to the developer.
+   *
+   * @example
+   * await this.informIfExtensionMissing("vector");
+   */
+  private informIfExtensionMissing;
+  /**
+   * Run a single migration.
+   */
+  private runMigration;
+  /**
+   * Create, configure, and return a ready-to-use migration instance.
+   *
+   * Centralises the repeated "new + setDriver + setMigrationDefaults" boilerplate
+   * that all batch/single execution paths need.
+   *
+   * @internal
+   */
+  private createMigrationInstance;
+  /**
+   * Format an ordered array of TaggedSQL into a human-readable SQL file string.
+   *
+   * Consecutive statements that belong to the same (phase, migration) group share
+   * a single block comment at the top, avoiding the noisy per-statement repetition.
+   *
+   * Example output:
+   * ```sql
+   * /* Phase 3 [create-users] *\/
+   * ALTER TABLE "users" ADD COLUMN "name" TEXT NOT NULL;
+   * ALTER TABLE "users" ADD COLUMN "email" TEXT NOT NULL;
+   *
+   * /* Phase 4 [create-users] *\/
+   * CREATE UNIQUE INDEX ...;
+   * ```
+   *
+   * @internal
+   */
+  private formatSQLForExport;
+  /**
+   * Get pending (not executed) registered migrations.
+   */
+  private getPendingMigrations;
+  /**
+   * Get migrations to rollback.
+   */
+  private getMigrationsToRollback;
+  /**
+   * Get executed migration records.
+   */
+  getExecutedMigrations(): Promise<MigrationRecord[]>;
+  /**
+   * Record a migration.
+   */
+  private recordMigration;
+  /**
+   * Remove a migration record.
+   */
+  private removeMigrationRecord;
+  /**
+   * Get next batch number.
+   */
+  private getNextBatchNumber;
+}
+declare const migrationRunner: MigrationRunner;
+//#endregion
+export { MigrationRunner, migrationRunner };
+//# sourceMappingURL=migration-runner.d.mts.map

package/esm/migration/migration-runner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-runner.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/migration/migration-runner.ts"],"mappings":";;;;;;;AAS2E;KAKtE,cAAA,cAA4B,SAAS;EACxC,aAAA;EACA,SAAA;AAAA;;;;KAgBG,cAAA;EAAA,uDAEM,MAAA;WAEA,MAAM;AAAA;AAsHjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,cAAa,eAAA;EAg1B2B;EAAA,SA90BtB,UAAA,EAAY,cAAA;EA80BiB;EAAA,QA30BrC,UAAA;EAHoB;EAAA,QAMpB,qBAAA;EAAA;EAAA,iBAGS,eAAA;EAGA;EAAA,iBAAA,OAAA;EASb;;;;;cADF,OAAA;IACE,UAAA,GAAa,UAAA;IACb,eAAA;IACA,OAAA;EAAA;EA4DG;;;EA7CA,aAAA,CAAc,UAAA,EAAY,UAAA;EAmED;;;EAAA,QA1DxB,aAAA;EAiGK;;;EAAA,QAvFL,kBAAA;EAyFN;;;;;;;;;;;;;;;EA/DK,QAAA,CAAS,cAAA,EAAgB,cAAA;EAuSE;;;;;;EAjR3B,YAAA,CAAa,UAAA,EAAY,cAAA;EA+VyB;;;EArVlD,KAAA,CAAA;EAkWI;;;EA1VJ,kBAAA,CAAA;EAqYM;;;;;;;;;;;;;EAhXA,GAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EA8YP;;;;;;;;;;;;EA3XS,QAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EA0sBG;;;AAQkB;AAOlC;;;;AAAoD;;;;;;;EA/rBrC,MAAA,CAAO,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;EAuL9C,SAAA,CAAU,OAAA;IAAW,WAAA;IAAuB,OAAA;EAAA,IAA2B,OAAA;;;;;;;EA8EvE,YAAA,CAAa,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;;EAWpD,eAAA,CACX,OAAA,UACA,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;;;;;;;EA0CE,WAAA,CAAY,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;EAiBnD,KAAA,CAAM,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;EAa7C,MAAA,CAAA,GAAU,OAAA,CACrB,KAAA;IACE,IAAA;IACA,KAAA;IACA,QAAA;IACA,KAAA;EAAA;;;;;;;;;;;;UAkCU,wBAAA;;;;UAwCA,YAAA;;;;;;;;;UAoIN,uBAAA;;;;;;;;;;;;;;;;;;;UAyBA,kBAAA;;;;UAqCM,oBAAA;;;;UAWA,uBAAA;;;;EAoBD,qBAAA,CAAA,GAAyB,OAAA,CAAQ,eAAA;;;;UAmBhC,eAAA;;;;UAkBA,qBAAA;;;;UAQA,kBAAA;AAAA;AAAA,cAOH,eAAA,EAAe,eAAwB"}