@warlock.js/cascade 4.0.132 → 4.0.134

package/esm/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.
      *
@@ -64,18 +69,65 @@ export declare class ColumnBuilder {
      */
     notNullable(): this;
     /**
-     * Set default value for the column.
+     * Set default value for the column as a raw SQL expression.
+     *
+     * The value will be used as-is in the SQL statement without escaping.
+     * Use this for database functions and expressions.
+     *
+     * @param value - Default value (SQL expression, number, or boolean)
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.uuid("id").default("gen_random_uuid()");
+     * this.timestamp("created_at").default("NOW()");
+     * this.integer("version").default(1);
+     * this.boolean("is_active").default(true);
+     * ```
+     */
+    default(value: string | number | boolean): this;
+    /**
+     * Set default value for the column as a literal string.
+     *
+     * The value will be properly escaped and quoted in the SQL statement.
+     * Use this for literal string values, not SQL expressions.
+     *
+     * @param value - Default string value (will be escaped)
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.text("status").defaultString("active");
+     * this.text("greeting").defaultString("Hello, World!");
+     * ```
+     */
+    defaultString(value: string): 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.
      *
-     * @param value - Default value (can be a literal or expression)
      * @returns This builder for chaining
      *
      * @example
      * ```typescript
-     * this.boolean("isActive").default(true);
-     * this.dateTime("createdAt").default("NOW()");
+     * this.timestamp("updated_at").useCurrent().useCurrentOnUpdate();
      * ```
      */
-    default(value: unknown): this;
+    useCurrentOnUpdate(): this;
     /**
      * Add unique constraint/index on this column.
      *
@@ -154,6 +206,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/esm/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":"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"}

package/esm/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.
      *
@@ -73,19 +77,77 @@ class ColumnBuilder {
     // DEFAULT VALUES
     // ============================================================================
     /**
-     * Set default value for the column.
+     * Set default value for the column as a raw SQL expression.
      *
-     * @param value - Default value (can be a literal or expression)
+     * The value will be used as-is in the SQL statement without escaping.
+     * Use this for database functions and expressions.
+     *
+     * @param value - Default value (SQL expression, number, or boolean)
      * @returns This builder for chaining
      *
      * @example
      * ```typescript
-     * this.boolean("isActive").default(true);
-     * this.dateTime("createdAt").default("NOW()");
+     * this.uuid("id").default("gen_random_uuid()");
+     * this.timestamp("created_at").default("NOW()");
+     * this.integer("version").default(1);
+     * this.boolean("is_active").default(true);
      * ```
      */
     default(value) {
         this.definition.defaultValue = value;
+        this.definition.isRawDefault = true;
+        return this;
+    }
+    /**
+     * Set default value for the column as a literal string.
+     *
+     * The value will be properly escaped and quoted in the SQL statement.
+     * Use this for literal string values, not SQL expressions.
+     *
+     * @param value - Default string value (will be escaped)
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.text("status").defaultString("active");
+     * this.text("greeting").defaultString("Hello, World!");
+     * ```
+     */
+    defaultString(value) {
+        this.definition.defaultValue = value;
+        this.definition.isRawDefault = false;
+        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;
     }
     // ============================================================================
@@ -202,6 +264,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/esm/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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"}