@uql/core 3.7.13 → 3.8.1

package/dist/maria/mariaDialect.js

@@ -2,6 +2,9 @@ import SqlString from 'sqlstring';
 import { AbstractSqlDialect } from '../dialect/index.js';
 import { getMeta } from '../entity/index.js';
 export class MariaDialect extends AbstractSqlDialect {
+    constructor(namingStrategy) {
+        super('mariadb', namingStrategy);
+    }
     addValue(values, value) {
         if (value instanceof Date) {
             values.push(value);

package/dist/maria/mariaDialect.js.map

@@ -1 +1 @@
-{"version":3,"file":"mariaDialect.js","sourceRoot":"","sources":["../../src/maria/mariaDialect.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,MAAM,OAAO,YAAa,SAAQ,kBAAkB;IACzC,QAAQ,CAAC,MAAiB,EAAE,KAAc;QACjD,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAEQ,MAAM,CAAI,GAAiB,EAAE,MAAe,EAAE,OAAgB,EAAE,IAAmB;QAC1F,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC;IAEQ,MAAM,CAAI,GAAiB,EAAE,MAAe,EAAE,aAAoC,EAAE,OAAU;QACrG,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,0BAA0B,CAAC,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;QAC/G,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE3C,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACnC,GAAG,CAAC,MAAM,CAAC,4BAA4B,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACzC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;YAC9D,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;YAC5B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC/B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEQ,MAAM,CAAC,KAAc;QAC5B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;CACF"}
+{"version":3,"file":"mariaDialect.js","sourceRoot":"","sources":["../../src/maria/mariaDialect.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,MAAM,OAAO,YAAa,SAAQ,kBAAkB;IAClD,YAAY,cAA+B;QACzC,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACnC,CAAC;IAEQ,QAAQ,CAAC,MAAiB,EAAE,KAAc;QACjD,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAEQ,MAAM,CAAI,GAAiB,EAAE,MAAe,EAAE,OAAgB,EAAE,IAAmB;QAC1F,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC;IAEQ,MAAM,CAAI,GAAiB,EAAE,MAAe,EAAE,aAAoC,EAAE,OAAU;QACrG,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,0BAA0B,CAAC,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;QAC/G,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE3C,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACnC,GAAG,CAAC,MAAM,CAAC,4BAA4B,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACzC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;YAC9D,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;YAC5B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC/B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEQ,MAAM,CAAC,KAAc;QAC5B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/migrate/builder/columnBuilder.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Column Builder
+ *
+ * Fluent API for defining columns in migrations.
+ */
+import type { CanonicalType, ForeignKeyAction } from '../../schema/types.js';
+import type { BaseColumnOptions, FullColumnDefinition, IColumnBuilder, IForeignKeyBuilder } from './types.js';
+/**
+ * Builder for column definitions with a fluent API.
+ * Columns are NOT NULL by default (safer).
+ */
+export declare class ColumnBuilder implements IColumnBuilder, IForeignKeyBuilder {
+    private _name;
+    private _type;
+    private _nullable;
+    private _defaultValue?;
+    private _primaryKey;
+    private _autoIncrement;
+    private _unique;
+    private _comment?;
+    private _index?;
+    private _foreignKey?;
+    constructor(name: string, type: CanonicalType, options?: BaseColumnOptions);
+    /**
+     * Make the column nullable or not nullable.
+     */
+    nullable(value?: boolean): this;
+    /**
+     * Make the column NOT NULL.
+     */
+    notNullable(): this;
+    /**
+     * Set a default value for the column.
+     */
+    defaultValue(value: unknown): this;
+    /**
+     * Mark as primary key.
+     */
+    primaryKey(): this;
+    /**
+     * Enable auto-increment (for integer types).
+     */
+    autoIncrement(): this;
+    /**
+     * Add a unique constraint.
+     */
+    unique(): this;
+    /**
+     * Add a comment to the column.
+     */
+    comment(text: string): this;
+    /**
+     * Add an index on this column.
+     * @param name - Optional index name. If true, auto-generates name.
+     */
+    index(name?: string): this;
+    /**
+     * Add a foreign key reference.
+     * Returns a ForeignKeyBuilder for additional options.
+     */
+    references(table: string, column?: string): IForeignKeyBuilder;
+    /**
+     * Set ON DELETE action for foreign key.
+     */
+    onDelete(action: ForeignKeyAction): this;
+    /**
+     * Set ON UPDATE action for foreign key.
+     */
+    onUpdate(action: ForeignKeyAction): this;
+    /**
+     * Build and return the column definition.
+     */
+    build(): FullColumnDefinition;
+}
+//# sourceMappingURL=columnBuilder.d.ts.map

package/dist/migrate/builder/columnBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnBuilder.d.ts","sourceRoot":"","sources":["../../../src/migrate/builder/columnBuilder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EACV,iBAAiB,EAEjB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,aAAc,YAAW,cAAc,EAAE,kBAAkB;IACtE,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,aAAa,CAAC,CAAU;IAChC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAC,CAAuB;gBAE/B,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAE,iBAAsB;IAuB9E;;OAEG;IACH,QAAQ,CAAC,KAAK,UAAO,GAAG,IAAI;IAK5B;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAKlC;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1B;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,kBAAkB;IAU5D;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAOxC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAOxC;;OAEG;IACH,KAAK,IAAI,oBAAoB;CAc9B"}

package/dist/migrate/builder/columnBuilder.js

@@ -0,0 +1,149 @@
+/**
+ * Column Builder
+ *
+ * Fluent API for defining columns in migrations.
+ */
+/**
+ * Builder for column definitions with a fluent API.
+ * Columns are NOT NULL by default (safer).
+ */
+export class ColumnBuilder {
+    _name;
+    _type;
+    _nullable;
+    _defaultValue;
+    _primaryKey;
+    _autoIncrement;
+    _unique;
+    _comment;
+    _index;
+    _foreignKey;
+    constructor(name, type, options = {}) {
+        this._name = name;
+        this._type = type;
+        // Apply options with defaults (non-nullable by default)
+        this._nullable = options.nullable ?? false;
+        this._unique = options.unique ?? false;
+        this._primaryKey = options.primaryKey ?? false;
+        this._autoIncrement = options.autoIncrement ?? false;
+        this._defaultValue = options.defaultValue;
+        this._index = options.index;
+        this._comment = options.comment;
+        // Handle inline references option
+        if (options.references) {
+            this._foreignKey = {
+                table: options.references.table,
+                columns: [options.references.column ?? 'id'],
+                onDelete: options.references.onDelete ?? 'NO ACTION',
+                onUpdate: options.references.onUpdate ?? 'NO ACTION',
+            };
+        }
+    }
+    /**
+     * Make the column nullable or not nullable.
+     */
+    nullable(value = true) {
+        this._nullable = value;
+        return this;
+    }
+    /**
+     * Make the column NOT NULL.
+     */
+    notNullable() {
+        this._nullable = false;
+        return this;
+    }
+    /**
+     * Set a default value for the column.
+     */
+    defaultValue(value) {
+        this._defaultValue = value;
+        return this;
+    }
+    /**
+     * Mark as primary key.
+     */
+    primaryKey() {
+        this._primaryKey = true;
+        this._nullable = false;
+        return this;
+    }
+    /**
+     * Enable auto-increment (for integer types).
+     */
+    autoIncrement() {
+        this._autoIncrement = true;
+        return this;
+    }
+    /**
+     * Add a unique constraint.
+     */
+    unique() {
+        this._unique = true;
+        return this;
+    }
+    /**
+     * Add a comment to the column.
+     */
+    comment(text) {
+        this._comment = text;
+        return this;
+    }
+    /**
+     * Add an index on this column.
+     * @param name - Optional index name. If true, auto-generates name.
+     */
+    index(name) {
+        this._index = name ?? true;
+        return this;
+    }
+    /**
+     * Add a foreign key reference.
+     * Returns a ForeignKeyBuilder for additional options.
+     */
+    references(table, column = 'id') {
+        this._foreignKey = {
+            table,
+            columns: [column],
+            onDelete: 'NO ACTION',
+            onUpdate: 'NO ACTION',
+        };
+        return this;
+    }
+    /**
+     * Set ON DELETE action for foreign key.
+     */
+    onDelete(action) {
+        if (this._foreignKey) {
+            this._foreignKey.onDelete = action;
+        }
+        return this;
+    }
+    /**
+     * Set ON UPDATE action for foreign key.
+     */
+    onUpdate(action) {
+        if (this._foreignKey) {
+            this._foreignKey.onUpdate = action;
+        }
+        return this;
+    }
+    /**
+     * Build and return the column definition.
+     */
+    build() {
+        return {
+            name: this._name,
+            type: this._type,
+            nullable: this._nullable,
+            defaultValue: this._defaultValue,
+            primaryKey: this._primaryKey,
+            autoIncrement: this._autoIncrement,
+            unique: this._unique,
+            comment: this._comment,
+            index: this._index,
+            foreignKey: this._foreignKey,
+        };
+    }
+}
+//# sourceMappingURL=columnBuilder.js.map

package/dist/migrate/builder/columnBuilder.js.map

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

package/dist/migrate/builder/expressions.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SQL Expressions
+ *
+ * Type-safe SQL expressions for default values and other uses.
+ * Provides a `t` helper with common expressions.
+ */
+/**
+ * Represents a raw SQL expression (not a literal value).
+ */
+export declare class SqlExpression {
+    readonly sql: string;
+    constructor(sql: string);
+    toString(): string;
+    /**
+     * Check if a value is a SQL expression.
+     */
+    static isExpression(value: unknown): value is SqlExpression;
+}
+/**
+ * Helper object for common SQL expressions.
+ * Use in migrations: `table.timestamp('createdAt').defaultValue(t.now())`
+ */
+export declare const t: {
+    /**
+     * Current timestamp (NOW() or CURRENT_TIMESTAMP depending on dialect).
+     */
+    now(): SqlExpression;
+    /**
+     * Current date (CURRENT_DATE).
+     */
+    currentDate(): SqlExpression;
+    /**
+     * Current time (CURRENT_TIME).
+     */
+    currentTime(): SqlExpression;
+    /**
+     * NULL value.
+     */
+    null(): SqlExpression;
+    /**
+     * Boolean true.
+     */
+    true(): SqlExpression;
+    /**
+     * Boolean false.
+     */
+    false(): SqlExpression;
+    /**
+     * Generate UUID (Postgres: gen_random_uuid(), MySQL: UUID()).
+     */
+    uuid(): SqlExpression;
+    /**
+     * Auto-generate UUID for MySQL.
+     */
+    mysqlUuid(): SqlExpression;
+    /**
+     * Raw SQL expression.
+     * Use for custom expressions not covered by helpers.
+     */
+    raw(sql: string): SqlExpression;
+    /**
+     * String literal with proper escaping.
+     */
+    literal(value: string): SqlExpression;
+    /**
+     * Numeric literal.
+     */
+    number(value: number): SqlExpression;
+    /**
+     * Empty JSON object.
+     */
+    emptyObject(): SqlExpression;
+    /**
+     * Empty JSON array.
+     */
+    emptyArray(): SqlExpression;
+    /**
+     * MySQL: ON UPDATE CURRENT_TIMESTAMP.
+     */
+    onUpdateNow(): SqlExpression;
+};
+/**
+ * Format a default value for SQL.
+ * Handles SqlExpression vs literal values.
+ */
+export declare function formatDefaultValue(value: unknown): string;
+//# sourceMappingURL=expressions.d.ts.map

package/dist/migrate/builder/expressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../../src/migrate/builder/expressions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,aAAa;IACZ,QAAQ,CAAC,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;IAEhC,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa;CAG5D;AAED;;;GAGG;AACH,eAAO,MAAM,CAAC;IACZ;;OAEG;WACI,aAAa;IAIpB;;OAEG;mBACY,aAAa;IAI5B;;OAEG;mBACY,aAAa;IAI5B;;OAEG;YACK,aAAa;IAIrB;;OAEG;YACK,aAAa;IAIrB;;OAEG;aACM,aAAa;IAItB;;OAEG;YACK,aAAa;IAIrB;;OAEG;iBACU,aAAa;IAI1B;;;OAGG;aACM,MAAM,GAAG,aAAa;IAI/B;;OAEG;mBACY,MAAM,GAAG,aAAa;IAMrC;;OAEG;kBACW,MAAM,GAAG,aAAa;IAIpC;;OAEG;mBACY,aAAa;IAI5B;;OAEG;kBACW,aAAa;IAI3B;;OAEG;mBACY,aAAa;CAG7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAkCzD"}

package/dist/migrate/builder/expressions.js

@@ -0,0 +1,150 @@
+/**
+ * SQL Expressions
+ *
+ * Type-safe SQL expressions for default values and other uses.
+ * Provides a `t` helper with common expressions.
+ */
+/**
+ * Represents a raw SQL expression (not a literal value).
+ */
+export class SqlExpression {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    toString() {
+        return this.sql;
+    }
+    /**
+     * Check if a value is a SQL expression.
+     */
+    static isExpression(value) {
+        return value instanceof SqlExpression;
+    }
+}
+/**
+ * Helper object for common SQL expressions.
+ * Use in migrations: `table.timestamp('createdAt').defaultValue(t.now())`
+ */
+export const t = {
+    /**
+     * Current timestamp (NOW() or CURRENT_TIMESTAMP depending on dialect).
+     */
+    now() {
+        return new SqlExpression('CURRENT_TIMESTAMP');
+    },
+    /**
+     * Current date (CURRENT_DATE).
+     */
+    currentDate() {
+        return new SqlExpression('CURRENT_DATE');
+    },
+    /**
+     * Current time (CURRENT_TIME).
+     */
+    currentTime() {
+        return new SqlExpression('CURRENT_TIME');
+    },
+    /**
+     * NULL value.
+     */
+    null() {
+        return new SqlExpression('NULL');
+    },
+    /**
+     * Boolean true.
+     */
+    true() {
+        return new SqlExpression('TRUE');
+    },
+    /**
+     * Boolean false.
+     */
+    false() {
+        return new SqlExpression('FALSE');
+    },
+    /**
+     * Generate UUID (Postgres: gen_random_uuid(), MySQL: UUID()).
+     */
+    uuid() {
+        return new SqlExpression('gen_random_uuid()');
+    },
+    /**
+     * Auto-generate UUID for MySQL.
+     */
+    mysqlUuid() {
+        return new SqlExpression('UUID()');
+    },
+    /**
+     * Raw SQL expression.
+     * Use for custom expressions not covered by helpers.
+     */
+    raw(sql) {
+        return new SqlExpression(sql);
+    },
+    /**
+     * String literal with proper escaping.
+     */
+    literal(value) {
+        // Escape single quotes by doubling them
+        const escaped = value.replace(/'/g, "''");
+        return new SqlExpression(`'${escaped}'`);
+    },
+    /**
+     * Numeric literal.
+     */
+    number(value) {
+        return new SqlExpression(String(value));
+    },
+    /**
+     * Empty JSON object.
+     */
+    emptyObject() {
+        return new SqlExpression("'{}'::jsonb");
+    },
+    /**
+     * Empty JSON array.
+     */
+    emptyArray() {
+        return new SqlExpression("'[]'::jsonb");
+    },
+    /**
+     * MySQL: ON UPDATE CURRENT_TIMESTAMP.
+     */
+    onUpdateNow() {
+        return new SqlExpression('CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP');
+    },
+};
+/**
+ * Format a default value for SQL.
+ * Handles SqlExpression vs literal values.
+ */
+export function formatDefaultValue(value) {
+    if (value === undefined || value === null) {
+        return 'NULL';
+    }
+    if (SqlExpression.isExpression(value)) {
+        return value.sql;
+    }
+    if (typeof value === 'string') {
+        // Escape single quotes
+        const escaped = value.replace(/'/g, "''");
+        return `'${escaped}'`;
+    }
+    if (typeof value === 'number') {
+        return String(value);
+    }
+    if (typeof value === 'boolean') {
+        return value ? 'TRUE' : 'FALSE';
+    }
+    if (value instanceof Date) {
+        return `'${value.toISOString()}'`;
+    }
+    if (typeof value === 'object') {
+        // JSON value
+        const json = JSON.stringify(value).replace(/'/g, "''");
+        return `'${json}'`;
+    }
+    return String(value);
+}
+//# sourceMappingURL=expressions.js.map

package/dist/migrate/builder/expressions.js.map

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

package/dist/migrate/builder/index.d.ts

@@ -0,0 +1,6 @@
+export * from './columnBuilder.js';
+export * from './expressions.js';
+export * from './migrationBuilder.js';
+export * from './tableBuilder.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/migrate/builder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/migrate/builder/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/migrate/builder/index.js

@@ -0,0 +1,6 @@
+export * from './columnBuilder.js';
+export * from './expressions.js';
+export * from './migrationBuilder.js';
+export * from './tableBuilder.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/migrate/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/migrate/builder/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/migrate/builder/migrationBuilder.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Migration Builder
+ *
+ * The main builder class for defining type-safe migrations.
+ * Records operations and generates SQL via the SchemaGenerator.
+ */
+import type { ForeignKeyAction } from '../../schema/types.js';
+import type { SchemaGenerator } from '../../type/migration.js';
+import type { SqlQuerier } from '../../type/querier.js';
+import type { AnyMigrationOperation, IAlterTableBuilder, IColumnBuilder, IMigrationBuilder, ITableBuilder } from './types.js';
+/**
+ * Options for the migration builder.
+ */
+export interface MigrationBuilderOptions {
+    /** Whether to execute SQL immediately or just record operations */
+    dryRun?: boolean;
+}
+/**
+ * Main migration builder with fluent API.
+ * Records operations and optionally executes them via a querier.
+ */
+export declare class MigrationBuilder implements IMigrationBuilder {
+    private operations;
+    private querier?;
+    private sqlGenerator?;
+    private dryRun;
+    constructor(querier?: SqlQuerier, sqlGenerator?: SchemaGenerator, options?: MigrationBuilderOptions);
+    createTable(name: string, callback: (table: ITableBuilder) => void): Promise<void>;
+    dropTable(name: string, options?: {
+        ifExists?: boolean;
+        cascade?: boolean;
+    }): Promise<void>;
+    renameTable(oldName: string, newName: string): Promise<void>;
+    alterTable(name: string, callback: (table: IAlterTableBuilder) => void): Promise<void>;
+    addColumn(tableName: string, columnName: string, callback: (column: IColumnBuilder) => void): Promise<void>;
+    dropColumn(tableName: string, columnName: string): Promise<void>;
+    alterColumn(tableName: string, columnName: string, callback: (column: IColumnBuilder) => void): Promise<void>;
+    renameColumn(tableName: string, oldName: string, newName: string): Promise<void>;
+    createIndex(tableName: string, columns: string[], options?: {
+        name?: string;
+        unique?: boolean;
+        where?: string;
+    }): Promise<void>;
+    dropIndex(tableName: string, indexName: string): Promise<void>;
+    addForeignKey(tableName: string, columns: string[], target: {
+        table: string;
+        columns: string[];
+    }, options?: {
+        name?: string;
+        onDelete?: ForeignKeyAction;
+        onUpdate?: ForeignKeyAction;
+    }): Promise<void>;
+    dropForeignKey(tableName: string, constraintName: string): Promise<void>;
+    raw(sql: string): Promise<void>;
+    getOperations(): AnyMigrationOperation[];
+    /**
+     * Internal method to record an operation and optionally execute it.
+     * @internal
+     */
+    recordOperation(operation: AnyMigrationOperation): Promise<void>;
+    /**
+     * Internal method to record an operation synchronously (for builders).
+     * @internal
+     */
+    recordOperationSync(operation: AnyMigrationOperation): void;
+    private execute;
+    private operationToSql;
+}
+/**
+ * Create a migration builder for dry-run (recording only).
+ */
+export declare function createDryRunBuilder(): MigrationBuilder;
+//# sourceMappingURL=migrationBuilder.d.ts.map

package/dist/migrate/builder/migrationBuilder.d.ts.map

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