@warlock.js/cascade 4.0.131 → 4.0.133

package/cjs/migration/column-builder.d.ts

@@ -1,4 +1,4 @@
-import type { ColumnDefinition, ColumnType } from "../contracts/migration-driver.contract";
+import type { ColumnDefinition, ColumnType, ForeignKeyDefinition } from "../contracts/migration-driver.contract";
 /**
  * Reference to the Migration type to avoid circular imports.
  * The actual type is injected at runtime.
@@ -8,6 +8,7 @@ type MigrationLike = {
         columns: string[];
         unique?: boolean;
     }): void;
+    addForeignKeyOperation(fk: ForeignKeyDefinition): void;
 };
 /**
  * Fluent builder for defining column properties.
@@ -35,6 +36,10 @@ export declare class ColumnBuilder {
     private readonly migration;
     /** Mutable column definition being accumulated */
     private readonly definition;
+    /** Mutable foreign key definition, set when .references() is called */
+    private fkDefinition?;
+    /** Temporary storage for generated expression before .stored() or .virtual() is called */
+    private generatedExpression?;
     /**
      * Create a new column builder.
      *
@@ -76,6 +81,32 @@ export declare class ColumnBuilder {
      * ```
      */
     default(value: unknown): this;
+    /**
+     * Set default value to the current timestamp.
+     *
+     * Database-agnostic. Generates NOW() / CURRENT_TIMESTAMP / GETDATE() based on driver.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.timestamp("created_at").useCurrent();
+     * ```
+     */
+    useCurrent(): this;
+    /**
+     * Set column to update to current timestamp on row update.
+     *
+     * MySQL only. Other databases ignore this.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.timestamp("updated_at").useCurrent().useCurrentOnUpdate();
+     * ```
+     */
+    useCurrentOnUpdate(): this;
     /**
      * Add unique constraint/index on this column.
      *
@@ -154,6 +185,175 @@ export declare class ColumnBuilder {
      * ```
      */
     comment(text: string): this;
+    /**
+     * Add a CHECK constraint scoped to this column.
+     *
+     * @param expression - SQL CHECK expression (can reference the column by name)
+     * @param name - Constraint name (defaults to `check_<column>`)
+     * @returns This builder for chaining
+     */
+    check(expression: string, name?: string): this;
+    /**
+     * Position this column after another column.
+     *
+     * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.
+     *
+     * @param columnName - Column to position after
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("middle_name").after("first_name");
+     * ```
+     */
+    after(columnName: string): this;
+    /**
+     * Position this column as the first column in the table.
+     *
+     * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("id").primary().first();
+     * ```
+     */
+    first(): this;
+    /**
+     * Declare a foreign key constraint on this column.
+     *
+     * Pushes an `addForeignKey` operation immediately using a mutable reference —
+     * subsequent `.on()`, `.onDelete()`, `.onUpdate()` calls mutate the same
+     * definition that is already queued, so no `.add()` terminator is needed.
+     *
+     * Referenced column defaults to `"id"` — use `.on()` to override.
+     *
+     * @param table - Referenced table name
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users");
+     * this.integer("user_id").references("users").on("custom_id").onDelete("cascade");
+     * ```
+     */
+    references(table: string): this;
+    /**
+     * Set the referenced column for the foreign key.
+     *
+     * Only meaningful after `.references()`. Defaults to `"id"` if omitted.
+     *
+     * @param column - Referenced column name
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users").on("custom_id");
+     * ```
+     */
+    on(column: string): this;
+    /**
+     * Set the ON DELETE action for the foreign key.
+     *
+     * Only meaningful after `.references()`.
+     *
+     * @param action - Action when the referenced row is deleted
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users").onDelete("cascade");
+     * ```
+     */
+    onDelete(action: ForeignKeyDefinition["onDelete"]): this;
+    /**
+     * Set the ON UPDATE action for the foreign key.
+     *
+     * Only meaningful after `.references()`.
+     *
+     * @param action - Action when the referenced row's key is updated
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users").onUpdate("cascade");
+     * ```
+     */
+    onUpdate(action: ForeignKeyDefinition["onUpdate"]): this;
+    /**
+     * Shorthand for `.onDelete("cascade").onUpdate("cascade")`.
+     *
+     * Only meaningful after `.references()`.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users").cascadeAll();
+     * ```
+     */
+    cascadeAll(): this;
+    /**
+     * Mark this column definition as a modification of an existing column.
+     *
+     * Pushes a `modifyColumn` operation instead of `addColumn`.
+     * This method breaks the builder chain and returns the parent migration.
+     *
+     * @returns The parent migration instance (breaks builder chain)
+     *
+     * @example
+     * ```typescript
+     * // Make email nullable
+     * this.string("email").nullable().change();
+     *
+     * // Increase length
+     * this.string("name", 255).change();
+     *
+     * // Change type
+     * this.text("description").change();
+     * ```
+     */
+    change(): unknown;
+    /**
+     * Mark this column as a generated column with the given SQL expression.
+     *
+     * Must be followed by `.stored()` or `.virtual()` to specify storage type.
+     *
+     * PostgreSQL: GENERATED ALWAYS AS (...) STORED
+     * MySQL: GENERATED ALWAYS AS (...) STORED | VIRTUAL
+     *
+     * @param expression - SQL expression to compute the value
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("full_name")
+     *   .generatedAs("CONCAT(first_name, ' ', last_name)")
+     *   .stored();
+     *
+     * this.decimal("price_with_tax")
+     *   .generatedAs("price * 1.2")
+     *   .virtual();
+     * ```
+     */
+    generatedAs(expression: string): this;
+    /**
+     * Mark the generated column as stored (computed and persisted to disk).
+     *
+     * Must be called after `.generatedAs()`.
+     *
+     * @returns This builder for chaining
+     */
+    stored(): this;
+    /**
+     * Mark the generated column as virtual (computed on read, not stored).
+     *
+     * Must be called after `.generatedAs()`. Not supported by PostgreSQL.
+     *
+     * @returns This builder for chaining
+     */
+    virtual(): this;
     /**
      * Get the built column definition.
      *

package/cjs/migration/column-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-builder.d.ts","sourceRoot":"","sources":["../../src/migration/column-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAE3F;;;GAGG;AACH,KAAK,aAAa,GAAG;IACnB,eAAe,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACvE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IAatB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAZ5B,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAE9C;;;;;;;OAOG;gBAEgB,SAAS,EAAE,aAAa,EACzC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,OAAO,CACd,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC,CAC9E;IAcR;;;;;;;;;OASG;IACI,QAAQ,IAAI,IAAI;IAKvB;;;;;;OAMG;IACI,WAAW,IAAI,IAAI;IAS1B;;;;;;;;;;;OAWG;IACI,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IASpC;;;;;;;;;;;OAWG;IACI,MAAM,IAAI,IAAI;IAQrB;;;;;;;;;;;OAWG;IACI,KAAK,IAAI,IAAI;IAWpB;;;;;;;;;OASG;IACI,OAAO,IAAI,IAAI;IAKtB;;;;;;;;;;;;OAYG;IACI,aAAa,IAAI,IAAI;IAS5B;;;;;;;;;;;OAWG;IACI,QAAQ,IAAI,IAAI;IASvB;;;;;;;;;;;;OAYG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASlC;;;;;;OAMG;IACI,aAAa,IAAI,gBAAgB;CAGzC"}
+{"version":3,"file":"column-builder.d.ts","sourceRoot":"","sources":["../../src/migration/column-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEjH;;;GAGG;AACH,KAAK,aAAa,GAAG;IACnB,eAAe,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACtE,sBAAsB,CAAC,EAAE,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACxD,CAAC;AAcF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IAmBtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAlB5B,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAE9C,uEAAuE;IACvE,OAAO,CAAC,YAAY,CAAC,CAA8B;IAEnD,0FAA0F;IAC1F,OAAO,CAAC,mBAAmB,CAAC,CAAS;IAErC;;;;;;;OAOG;gBAEgB,SAAS,EAAE,aAAa,EACzC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,OAAO,CACd,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC,CAC9E;IAcR;;;;;;;;;OASG;IACI,QAAQ,IAAI,IAAI;IAKvB;;;;;;OAMG;IACI,WAAW,IAAI,IAAI;IAS1B;;;;;;;;;;;OAWG;IACI,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAKpC;;;;;;;;;;;OAWG;IACI,UAAU,IAAI,IAAI;IAKzB;;;;;;;;;;;OAWG;IACI,kBAAkB,IAAI,IAAI;IASjC;;;;;;;;;;;OAWG;IACI,MAAM,IAAI,IAAI;IAQrB;;;;;;;;;;;OAWG;IACI,KAAK,IAAI,IAAI;IAWpB;;;;;;;;;OASG;IACI,OAAO,IAAI,IAAI;IAKtB;;;;;;;;;;;;OAYG;IACI,aAAa,IAAI,IAAI;IAS5B;;;;;;;;;;;OAWG;IACI,QAAQ,IAAI,IAAI;IASvB;;;;;;;;;;;;OAYG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASlC;;;;;;OAMG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAYrD;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKtC;;;;;;;;;;;OAWG;IACI,KAAK,IAAI,IAAI;IASpB;;;;;;;;;;;;;;;;;OAiBG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAYtC;;;;;;;;;;;;OAYG;IACI,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,IAAI;IAO/D;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,IAAI;IAO/D;;;;;;;;;;;OAWG;IACI,UAAU,IAAI,IAAI;IAYzB;;;;;;;;;;;;;;;;;;;OAmBG;IACI,MAAM,IAAI,OAAO;IAsBxB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAK5C;;;;;;OAMG;IACI,MAAM,IAAI,IAAI;IAUrB;;;;;;OAMG;IACI,OAAO,IAAI,IAAI;IActB;;;;;;OAMG;IACI,aAAa,IAAI,gBAAgB;CAGzC"}

package/cjs/migration/column-builder.js

@@ -24,6 +24,10 @@ class ColumnBuilder {
     migration;
     /** Mutable column definition being accumulated */
     definition;
+    /** Mutable foreign key definition, set when .references() is called */
+    fkDefinition;
+    /** Temporary storage for generated expression before .stored() or .virtual() is called */
+    generatedExpression;
     /**
      * Create a new column builder.
      *
@@ -88,6 +92,38 @@ class ColumnBuilder {
         this.definition.defaultValue = value;
         return this;
     }
+    /**
+     * Set default value to the current timestamp.
+     *
+     * Database-agnostic. Generates NOW() / CURRENT_TIMESTAMP / GETDATE() based on driver.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.timestamp("created_at").useCurrent();
+     * ```
+     */
+    useCurrent() {
+        this.definition.defaultValue = { __type: "CURRENT_TIMESTAMP" };
+        return this;
+    }
+    /**
+     * Set column to update to current timestamp on row update.
+     *
+     * MySQL only. Other databases ignore this.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.timestamp("updated_at").useCurrent().useCurrentOnUpdate();
+     * ```
+     */
+    useCurrentOnUpdate() {
+        this.definition.onUpdateCurrent = true;
+        return this;
+    }
     // ============================================================================
     // INDEXES
     // ============================================================================
@@ -202,6 +238,265 @@ class ColumnBuilder {
         return this;
     }
     // ============================================================================
+    // CONSTRAINTS
+    // ============================================================================
+    /**
+     * Add a CHECK constraint scoped to this column.
+     *
+     * @param expression - SQL CHECK expression (can reference the column by name)
+     * @param name - Constraint name (defaults to `check_<column>`)
+     * @returns This builder for chaining
+     */
+    check(expression, name) {
+        this.definition.checkConstraint = {
+            expression,
+            name: name ?? `check_${this.definition.name}`,
+        };
+        return this;
+    }
+    // ============================================================================
+    // COLUMN POSITIONING (MySQL/MariaDB only)
+    // ============================================================================
+    /**
+     * Position this column after another column.
+     *
+     * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.
+     *
+     * @param columnName - Column to position after
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("middle_name").after("first_name");
+     * ```
+     */
+    after(columnName) {
+        this.definition.after = columnName;
+        return this;
+    }
+    /**
+     * Position this column as the first column in the table.
+     *
+     * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("id").primary().first();
+     * ```
+     */
+    first() {
+        this.definition.first = true;
+        return this;
+    }
+    // ============================================================================
+    // FOREIGN KEY
+    // ============================================================================
+    /**
+     * Declare a foreign key constraint on this column.
+     *
+     * Pushes an `addForeignKey` operation immediately using a mutable reference —
+     * subsequent `.on()`, `.onDelete()`, `.onUpdate()` calls mutate the same
+     * definition that is already queued, so no `.add()` terminator is needed.
+     *
+     * Referenced column defaults to `"id"` — use `.on()` to override.
+     *
+     * @param table - Referenced table name
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users");
+     * this.integer("user_id").references("users").on("custom_id").onDelete("cascade");
+     * ```
+     */
+    references(table) {
+        this.fkDefinition = {
+            column: this.definition.name,
+            referencesTable: table,
+            referencesColumn: "id",
+            onDelete: "restrict",
+            onUpdate: "restrict",
+        };
+        this.migration.addForeignKeyOperation(this.fkDefinition);
+        return this;
+    }
+    /**
+     * Set the referenced column for the foreign key.
+     *
+     * Only meaningful after `.references()`. Defaults to `"id"` if omitted.
+     *
+     * @param column - Referenced column name
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users").on("custom_id");
+     * ```
+     */
+    on(column) {
+        if (this.fkDefinition) {
+            this.fkDefinition.referencesColumn = column;
+        }
+        return this;
+    }
+    /**
+     * Set the ON DELETE action for the foreign key.
+     *
+     * Only meaningful after `.references()`.
+     *
+     * @param action - Action when the referenced row is deleted
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users").onDelete("cascade");
+     * ```
+     */
+    onDelete(action) {
+        if (this.fkDefinition) {
+            this.fkDefinition.onDelete = action;
+        }
+        return this;
+    }
+    /**
+     * Set the ON UPDATE action for the foreign key.
+     *
+     * Only meaningful after `.references()`.
+     *
+     * @param action - Action when the referenced row's key is updated
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users").onUpdate("cascade");
+     * ```
+     */
+    onUpdate(action) {
+        if (this.fkDefinition) {
+            this.fkDefinition.onUpdate = action;
+        }
+        return this;
+    }
+    /**
+     * Shorthand for `.onDelete("cascade").onUpdate("cascade")`.
+     *
+     * Only meaningful after `.references()`.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("user_id").references("users").cascadeAll();
+     * ```
+     */
+    cascadeAll() {
+        if (this.fkDefinition) {
+            this.fkDefinition.onDelete = "cascade";
+            this.fkDefinition.onUpdate = "cascade";
+        }
+        return this;
+    }
+    // ============================================================================
+    // COLUMN MODIFICATION
+    // ============================================================================
+    /**
+     * Mark this column definition as a modification of an existing column.
+     *
+     * Pushes a `modifyColumn` operation instead of `addColumn`.
+     * This method breaks the builder chain and returns the parent migration.
+     *
+     * @returns The parent migration instance (breaks builder chain)
+     *
+     * @example
+     * ```typescript
+     * // Make email nullable
+     * this.string("email").nullable().change();
+     *
+     * // Increase length
+     * this.string("name", 255).change();
+     *
+     * // Change type
+     * this.text("description").change();
+     * ```
+     */
+    change() {
+        // Remove the existing addColumn operation that was pushed in the constructor
+        const operations = this.migration.pendingOperations;
+        const lastOp = operations[operations.length - 1];
+        if (lastOp?.type === "addColumn" && lastOp.payload === this.definition) {
+            operations.pop();
+        }
+        // Push modifyColumn instead
+        this.migration.pendingOperations.push({
+            type: "modifyColumn",
+            payload: this.definition,
+        });
+        return this.migration;
+    }
+    // ============================================================================
+    // GENERATED COLUMNS
+    // ============================================================================
+    /**
+     * Mark this column as a generated column with the given SQL expression.
+     *
+     * Must be followed by `.stored()` or `.virtual()` to specify storage type.
+     *
+     * PostgreSQL: GENERATED ALWAYS AS (...) STORED
+     * MySQL: GENERATED ALWAYS AS (...) STORED | VIRTUAL
+     *
+     * @param expression - SQL expression to compute the value
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("full_name")
+     *   .generatedAs("CONCAT(first_name, ' ', last_name)")
+     *   .stored();
+     *
+     * this.decimal("price_with_tax")
+     *   .generatedAs("price * 1.2")
+     *   .virtual();
+     * ```
+     */
+    generatedAs(expression) {
+        this.generatedExpression = expression;
+        return this;
+    }
+    /**
+     * Mark the generated column as stored (computed and persisted to disk).
+     *
+     * Must be called after `.generatedAs()`.
+     *
+     * @returns This builder for chaining
+     */
+    stored() {
+        if (this.generatedExpression) {
+            this.definition.generated = {
+                expression: this.generatedExpression,
+                stored: true,
+            };
+        }
+        return this;
+    }
+    /**
+     * Mark the generated column as virtual (computed on read, not stored).
+     *
+     * Must be called after `.generatedAs()`. Not supported by PostgreSQL.
+     *
+     * @returns This builder for chaining
+     */
+    virtual() {
+        if (this.generatedExpression) {
+            this.definition.generated = {
+                expression: this.generatedExpression,
+                stored: false,
+            };
+        }
+        return this;
+    }
+    // ============================================================================
     // ACCESSOR
     // ============================================================================
     /**

package/cjs/migration/column-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"column-builder.js","sources":["../../src/migration/column-builder.ts"],"sourcesContent":[null],"names":[],"mappings":"aAUA;;;;;;;;;;;;;;;;;;;;;AAqBG;MACU,aAAa,CAAA;AAaL,IAAA,SAAA,CAAA;;AAXF,IAAA,UAAU,CAAmB;AAE9C;;;;;;;AAOG;AACH,IAAA,WAAA,CACmB,SAAwB,EACzC,IAAY,EACZ,IAAgB,EAChB,UAEI,EAAE,EAAA;QALW,IAAS,CAAA,SAAA,GAAT,SAAS,CAAe;QAOzC,IAAI,CAAC,UAAU,GAAG;YAChB,IAAI;YACJ,IAAI;AACJ,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,GAAG,OAAO;SACX,CAAC;KACH;;;;AAMD;;;;;;;;;AASG;IACI,QAAQ,GAAA;AACb,QAAA,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;AAChC,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;AAMG;IACI,WAAW,GAAA;AAChB,QAAA,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,KAAK,CAAC;AACjC,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;;;AAWG;AACI,IAAA,OAAO,CAAC,KAAc,EAAA;AAC3B,QAAA,IAAI,CAAC,UAAU,CAAC,YAAY,GAAG,KAAK,CAAC;AACrC,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;;;AAWG;IACI,MAAM,GAAA;AACX,QAAA,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;AAC7B,YAAA,OAAO,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;AAC/B,YAAA,MAAM,EAAE,IAAI;AACb,SAAA,CAAC,CAAC;AACH,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;;;;;;AAWG;IACI,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;AAC7B,YAAA,OAAO,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;AAChC,SAAA,CAAC,CAAC;AACH,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;AASG;IACI,OAAO,GAAA;AACZ,QAAA,IAAI,CAAC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;AAC/B,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;;;;;;;AAYG;IACI,aAAa,GAAA;AAClB,QAAA,IAAI,CAAC,UAAU,CAAC,aAAa,GAAG,IAAI,CAAC;AACrC,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;;;AAWG;IACI,QAAQ,GAAA;AACb,QAAA,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;AAChC,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;;;;AAYG;AACI,IAAA,OAAO,CAAC,IAAY,EAAA;AACzB,QAAA,IAAI,CAAC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;AAC/B,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;AAMG;IACI,aAAa,GAAA;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;KACxB;AACF"}
+{"version":3,"file":"column-builder.js","sources":["../../src/migration/column-builder.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/cjs/migration/foreign-key-builder.d.ts

@@ -11,13 +11,16 @@ type MigrationLike = {
  * 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")
- *   .add();
+ *   .onUpdate("cascade");
  * ```
  */
 export declare class ForeignKeyBuilder {
@@ -39,7 +42,11 @@ export declare class ForeignKeyBuilder {
      */
     name(name: string): this;
     /**
-     * Set the referenced table and column.
+     * 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")
@@ -91,20 +98,6 @@ export declare class ForeignKeyBuilder {
      * ```
      */
     cascadeAll(): this;
-    /**
-     * Finalize and add the foreign key constraint to the migration.
-     *
-     * This must be called to register the foreign key.
-     *
-     * @example
-     * ```typescript
-     * this.foreign("user_id")
-     *   .references("users")
-     *   .onDelete("cascade")
-     *   .add(); // Required!
-     * ```
-     */
-    add(): void;
 }
 export {};
 //# sourceMappingURL=foreign-key-builder.d.ts.map

package/cjs/migration/foreign-key-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foreign-key-builder.d.ts","sourceRoot":"","sources":["../../src/migration/foreign-key-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF;;GAEG;AACH,KAAK,aAAa,GAAG;IACnB,sBAAsB,CAAC,EAAE,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACxD,CAAC;AAcF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAiB;IAW1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAV5B,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEzD;;;;;OAKG;gBAEgB,SAAS,EAAE,aAAa,EACzC,MAAM,EAAE,MAAM;IAWhB;;;;;OAKG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;;;;;;;;OAYG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,IAAI;IAMrD;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,IAAI;IAK/D;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,IAAI;IAK/D;;;;;;;;;OASG;IACI,UAAU,IAAI,IAAI;IAMzB;;;;;;;;;;;;OAYG;IACI,GAAG,IAAI,IAAI;CAGnB"}
+{"version":3,"file":"foreign-key-builder.d.ts","sourceRoot":"","sources":["../../src/migration/foreign-key-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF;;GAEG;AACH,KAAK,aAAa,GAAG;IACnB,sBAAsB,CAAC,EAAE,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACxD,CAAC;AAcF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,iBAAiB;IAW1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAV5B,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEzD;;;;;OAKG;gBAEgB,SAAS,EAAE,aAAa,EACzC,MAAM,EAAE,MAAM;IAWhB;;;;;OAKG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B;;;;;;;;;;;;;;;;OAgBG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,IAAI;IAOrD;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,IAAI;IAK/D;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,IAAI;IAK/D;;;;;;;;;OASG;IACI,UAAU,IAAI,IAAI;CAM1B"}

package/cjs/migration/foreign-key-builder.js

@@ -4,13 +4,16 @@
  * 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")
- *   .add();
+ *   .onUpdate("cascade");
  * ```
  */
 class ForeignKeyBuilder {
@@ -44,7 +47,11 @@ class ForeignKeyBuilder {
         return this;
     }
     /**
-     * Set the referenced table and column.
+     * 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")
@@ -59,6 +66,7 @@ class ForeignKeyBuilder {
     references(table, column = "id") {
         this.definition.referencesTable = table;
         this.definition.referencesColumn = column;
+        this.migration.addForeignKeyOperation(this.definition);
         return this;
     }
     /**
@@ -110,20 +118,4 @@ class ForeignKeyBuilder {
         this.definition.onUpdate = "cascade";
         return this;
     }
-    /**
-     * Finalize and add the foreign key constraint to the migration.
-     *
-     * This must be called to register the foreign key.
-     *
-     * @example
-     * ```typescript
-     * this.foreign("user_id")
-     *   .references("users")
-     *   .onDelete("cascade")
-     *   .add(); // Required!
-     * ```
-     */
-    add() {
-        this.migration.addForeignKeyOperation(this.definition);
-    }
 }exports.ForeignKeyBuilder=ForeignKeyBuilder;//# sourceMappingURL=foreign-key-builder.js.map