@uql/core 3.7.13 → 3.8.1

package/dist/migrate/builder/migrationBuilder.js

@@ -0,0 +1,326 @@
+/**
+ * Migration Builder
+ *
+ * The main builder class for defining type-safe migrations.
+ * Records operations and generates SQL via the SchemaGenerator.
+ */
+import { ColumnBuilder } from './columnBuilder.js';
+import { TableBuilder } from './tableBuilder.js';
+/**
+ * Builder for altering a table.
+ * Delegates to MigrationBuilder methods.
+ */
+class AlterTableBuilder {
+    tableName;
+    migrationBuilder;
+    constructor(tableName, migrationBuilder) {
+        this.tableName = tableName;
+        this.migrationBuilder = migrationBuilder;
+    }
+    addColumn(name, callback) {
+        const builder = new ColumnBuilder(name, { category: 'string' });
+        callback(builder);
+        this.migrationBuilder.recordOperationSync({
+            type: 'addColumn',
+            tableName: this.tableName,
+            column: builder.build(),
+        });
+        return this;
+    }
+    dropColumn(name) {
+        this.migrationBuilder.recordOperationSync({
+            type: 'dropColumn',
+            tableName: this.tableName,
+            columnName: name,
+        });
+        return this;
+    }
+    renameColumn(oldName, newName) {
+        this.migrationBuilder.recordOperationSync({
+            type: 'renameColumn',
+            tableName: this.tableName,
+            oldName,
+            newName,
+        });
+        return this;
+    }
+    alterColumn(name, callback) {
+        const builder = new ColumnBuilder(name, { category: 'string' });
+        callback(builder);
+        this.migrationBuilder.recordOperationSync({
+            type: 'alterColumn',
+            tableName: this.tableName,
+            columnName: name,
+            changes: builder.build(),
+        });
+        return this;
+    }
+    addIndex(columns, options) {
+        const indexName = options?.name ?? `idx_${this.tableName}_${columns.join('_')}`;
+        this.migrationBuilder.recordOperationSync({
+            type: 'createIndex',
+            tableName: this.tableName,
+            index: {
+                name: indexName,
+                columns,
+                unique: options?.unique ?? false,
+            },
+        });
+        return this;
+    }
+    dropIndex(name) {
+        this.migrationBuilder.recordOperationSync({
+            type: 'dropIndex',
+            tableName: this.tableName,
+            indexName: name,
+        });
+        return this;
+    }
+    addForeignKey(columns, target, options) {
+        this.migrationBuilder.recordOperationSync({
+            type: 'addForeignKey',
+            tableName: this.tableName,
+            foreignKey: {
+                name: options?.name,
+                columns,
+                referencesTable: target.table,
+                referencesColumns: target.columns,
+                onDelete: options?.onDelete ?? 'NO ACTION',
+                onUpdate: options?.onUpdate ?? 'NO ACTION',
+            },
+        });
+        return this;
+    }
+    dropForeignKey(name) {
+        this.migrationBuilder.recordOperationSync({
+            type: 'dropForeignKey',
+            tableName: this.tableName,
+            constraintName: name,
+        });
+        return this;
+    }
+}
+/**
+ * Main migration builder with fluent API.
+ * Records operations and optionally executes them via a querier.
+ */
+export class MigrationBuilder {
+    operations = [];
+    querier;
+    sqlGenerator;
+    dryRun;
+    constructor(querier, sqlGenerator, options = {}) {
+        this.querier = querier;
+        this.sqlGenerator = sqlGenerator;
+        this.dryRun = options.dryRun ?? false;
+    }
+    // ============================================================================
+    // Table Operations
+    // ============================================================================
+    async createTable(name, callback) {
+        const builder = new TableBuilder(name);
+        callback(builder);
+        await this.recordOperation({
+            type: 'createTable',
+            table: builder.build(),
+        });
+    }
+    async dropTable(name, options = {}) {
+        await this.recordOperation({
+            type: 'dropTable',
+            tableName: name,
+            ifExists: options.ifExists,
+            cascade: options.cascade,
+        });
+    }
+    async renameTable(oldName, newName) {
+        await this.recordOperation({
+            type: 'renameTable',
+            oldName,
+            newName,
+        });
+    }
+    async alterTable(name, callback) {
+        const builder = new AlterTableBuilder(name, this);
+        callback(builder);
+        // AlterTableBuilder calls migrationBuilder methods directly, so we don't need to do anything else here
+    }
+    // ============================================================================
+    // Column Operations
+    // ============================================================================
+    async addColumn(tableName, columnName, callback) {
+        // Create a generic column builder, the callback will configure the type
+        const builder = new ColumnBuilder(columnName, { category: 'string' });
+        callback(builder);
+        await this.recordOperation({
+            type: 'addColumn',
+            tableName,
+            column: builder.build(),
+        });
+    }
+    async dropColumn(tableName, columnName) {
+        await this.recordOperation({
+            type: 'dropColumn',
+            tableName,
+            columnName,
+        });
+    }
+    async alterColumn(tableName, columnName, callback) {
+        const builder = new ColumnBuilder(columnName, { category: 'string' });
+        callback(builder);
+        await this.recordOperation({
+            type: 'alterColumn',
+            tableName,
+            columnName,
+            changes: builder.build(),
+        });
+    }
+    async renameColumn(tableName, oldName, newName) {
+        await this.recordOperation({
+            type: 'renameColumn',
+            tableName,
+            oldName,
+            newName,
+        });
+    }
+    // ============================================================================
+    // Index Operations
+    // ============================================================================
+    async createIndex(tableName, columns, options = {}) {
+        const indexName = options.name ?? `idx_${tableName}_${columns.join('_')}`;
+        await this.recordOperation({
+            type: 'createIndex',
+            tableName,
+            index: {
+                name: indexName,
+                columns,
+                unique: options.unique ?? false,
+                where: options.where,
+            },
+        });
+    }
+    async dropIndex(tableName, indexName) {
+        await this.recordOperation({
+            type: 'dropIndex',
+            tableName,
+            indexName,
+        });
+    }
+    // ============================================================================
+    // Foreign Key Operations
+    // ============================================================================
+    async addForeignKey(tableName, columns, target, options = {}) {
+        await this.recordOperation({
+            type: 'addForeignKey',
+            tableName,
+            foreignKey: {
+                name: options.name,
+                columns,
+                referencesTable: target.table,
+                referencesColumns: target.columns,
+                onDelete: options.onDelete ?? 'NO ACTION',
+                onUpdate: options.onUpdate ?? 'NO ACTION',
+            },
+        });
+    }
+    async dropForeignKey(tableName, constraintName) {
+        await this.recordOperation({
+            type: 'dropForeignKey',
+            tableName,
+            constraintName,
+        });
+    }
+    // ============================================================================
+    // Raw SQL
+    // ============================================================================
+    async raw(sql) {
+        const operation = {
+            type: 'raw',
+            sql,
+        };
+        this.operations.push(operation);
+        if (!this.dryRun && this.querier) {
+            await this.querier.run(sql);
+        }
+    }
+    // ============================================================================
+    // Operation Access
+    // ============================================================================
+    getOperations() {
+        return [...this.operations];
+    }
+    /**
+     * Internal method to record an operation and optionally execute it.
+     * @internal
+     */
+    async recordOperation(operation) {
+        this.operations.push(operation);
+        await this.execute(operation);
+    }
+    /**
+     * Internal method to record an operation synchronously (for builders).
+     * @internal
+     */
+    recordOperationSync(operation) {
+        this.operations.push(operation);
+        // We can't await execution here, but typically builders are used in dry-run or
+        // the execution is handled separately. For now, we fire and forget the execute
+        // or just don't execute if it's from a sync builder.
+        // In our case, createDryRunBuilder sets dryRun: true, so execute does nothing.
+        void this.execute(operation);
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    async execute(operation) {
+        if (this.dryRun || !this.querier || !this.sqlGenerator) {
+            return;
+        }
+        const sql = this.operationToSql(operation);
+        if (sql) {
+            await this.querier.run(sql);
+        }
+    }
+    operationToSql(operation) {
+        if (!this.sqlGenerator)
+            return undefined;
+        switch (operation.type) {
+            case 'createTable':
+                return this.sqlGenerator.generateCreateTableFromDefinition(operation.table);
+            case 'dropTable':
+                return this.sqlGenerator.generateDropTableSql(operation.tableName, {
+                    ifExists: operation.ifExists,
+                    cascade: operation.cascade,
+                });
+            case 'renameTable':
+                return this.sqlGenerator.generateRenameTableSql(operation.oldName, operation.newName);
+            case 'addColumn':
+                return this.sqlGenerator.generateAddColumnSql(operation.tableName, operation.column);
+            case 'dropColumn':
+                return this.sqlGenerator.generateDropColumnSql(operation.tableName, operation.columnName);
+            case 'renameColumn':
+                return this.sqlGenerator.generateRenameColumnSql(operation.tableName, operation.oldName, operation.newName);
+            case 'alterColumn':
+                return this.sqlGenerator.generateAlterColumnSql(operation.tableName, operation.columnName, operation.changes);
+            case 'createIndex':
+                return this.sqlGenerator.generateCreateIndexSql(operation.tableName, operation.index);
+            case 'dropIndex':
+                return this.sqlGenerator.generateDropIndexSql(operation.tableName, operation.indexName);
+            case 'addForeignKey':
+                return this.sqlGenerator.generateAddForeignKeySql(operation.tableName, operation.foreignKey);
+            case 'dropForeignKey':
+                return this.sqlGenerator.generateDropForeignKeySql(operation.tableName, operation.constraintName);
+            case 'raw':
+                return operation.sql;
+            default:
+                return undefined;
+        }
+    }
+}
+/**
+ * Create a migration builder for dry-run (recording only).
+ */
+export function createDryRunBuilder() {
+    return new MigrationBuilder(undefined, undefined, { dryRun: true });
+}
+//# sourceMappingURL=migrationBuilder.js.map

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

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

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

@@ -0,0 +1,51 @@
+/**
+ * Table Builder
+ *
+ * Fluent API for defining tables in migrations.
+ */
+import type { BaseColumnOptions, DecimalColumnOptions, IColumnBuilder, ITableBuilder, ITableForeignKeyBuilder, StringColumnOptions, TableDefinition, VectorColumnOptions } from './types.js';
+/**
+ * Builder for table definitions with a fluent API.
+ */
+export declare class TableBuilder implements ITableBuilder {
+    private _name;
+    private _columnBuilders;
+    private _primaryKey?;
+    private _indexes;
+    private _foreignKeyBuilders;
+    private _comment?;
+    constructor(name: string);
+    id(name?: string, options?: BaseColumnOptions): IColumnBuilder;
+    integer(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    smallint(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    bigint(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    float(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    double(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    decimal(name: string, options?: DecimalColumnOptions): IColumnBuilder;
+    string(name: string, options?: StringColumnOptions): IColumnBuilder;
+    char(name: string, options?: StringColumnOptions): IColumnBuilder;
+    text(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    boolean(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    date(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    time(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    timestamp(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    timestamptz(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    json(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    jsonb(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    uuid(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    blob(name: string, options?: BaseColumnOptions): IColumnBuilder;
+    vector(name: string, options?: VectorColumnOptions): IColumnBuilder;
+    createdAt(): IColumnBuilder;
+    updatedAt(): IColumnBuilder;
+    timestamps(): void;
+    primaryKey(columns: string[]): this;
+    unique(columns: string[], name?: string): this;
+    index(columns: string[], name?: string): this;
+    foreignKey(columns: string[]): ITableForeignKeyBuilder;
+    comment(text: string): this;
+    /**
+     * Build the table definition.
+     */
+    build(): TableDefinition;
+}
+//# sourceMappingURL=tableBuilder.d.ts.map

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

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

package/dist/migrate/builder/tableBuilder.js

@@ -0,0 +1,278 @@
+/**
+ * Table Builder
+ *
+ * Fluent API for defining tables in migrations.
+ */
+import { ColumnBuilder } from './columnBuilder.js';
+import { t } from './expressions.js';
+/**
+ * Builder for table-level foreign keys.
+ */
+class TableForeignKeyBuilder {
+    _columns;
+    _referencesTable;
+    _referencesColumns = [];
+    _onDelete = 'NO ACTION';
+    _onUpdate = 'NO ACTION';
+    _name;
+    constructor(columns, _parent) {
+        this._columns = columns;
+    }
+    references(table, columns) {
+        this._referencesTable = table;
+        this._referencesColumns = columns;
+        return this;
+    }
+    onDelete(action) {
+        this._onDelete = action;
+        return this;
+    }
+    onUpdate(action) {
+        this._onUpdate = action;
+        return this;
+    }
+    name(name) {
+        this._name = name;
+        return this;
+    }
+    /**
+     * Build the foreign key definition.
+     */
+    build() {
+        if (!this._referencesTable)
+            return undefined;
+        return {
+            name: this._name,
+            columns: this._columns,
+            referencesTable: this._referencesTable,
+            referencesColumns: this._referencesColumns,
+            onDelete: this._onDelete,
+            onUpdate: this._onUpdate,
+        };
+    }
+}
+/**
+ * Builder for table definitions with a fluent API.
+ */
+export class TableBuilder {
+    _name;
+    _columnBuilders = [];
+    _primaryKey;
+    _indexes = [];
+    _foreignKeyBuilders = [];
+    _comment;
+    constructor(name) {
+        this._name = name;
+    }
+    // ============================================================================
+    // Numeric Types
+    // ============================================================================
+    id(name = 'id', options = {}) {
+        const col = new ColumnBuilder(name, { category: 'integer' }, { ...options, primaryKey: true, autoIncrement: true });
+        this._columnBuilders.push(col);
+        return col;
+    }
+    integer(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'integer' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    smallint(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'integer', size: 'small' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    bigint(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'integer', size: 'big' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    float(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'float' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    double(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'float', size: 'big' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    decimal(name, options = {}) {
+        const { precision, scale, ...rest } = options;
+        const col = new ColumnBuilder(name, { category: 'decimal', precision, scale }, rest);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    // ============================================================================
+    // String Types
+    // ============================================================================
+    string(name, options = {}) {
+        const { length = 255, ...rest } = options;
+        const col = new ColumnBuilder(name, { category: 'string', length }, rest);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    char(name, options = {}) {
+        const { length = 1, ...rest } = options;
+        const col = new ColumnBuilder(name, { category: 'string', length }, rest);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    text(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'string' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    // ============================================================================
+    // Boolean
+    // ============================================================================
+    boolean(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'boolean' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    // ============================================================================
+    // Date/Time Types
+    // ============================================================================
+    date(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'date' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    time(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'time' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    timestamp(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'timestamp' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    timestamptz(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'timestamp', withTimezone: true }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    // ============================================================================
+    // JSON Types
+    // ============================================================================
+    json(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'json' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    jsonb(name, options = {}) {
+        // JSONB is the same category, dialect handles the difference
+        const col = new ColumnBuilder(name, { category: 'json' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    // ============================================================================
+    // Other Types
+    // ============================================================================
+    uuid(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'uuid' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    blob(name, options = {}) {
+        const col = new ColumnBuilder(name, { category: 'blob' }, options);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    vector(name, options = {}) {
+        const { dimensions, ...rest } = options;
+        const col = new ColumnBuilder(name, { category: 'vector', length: dimensions }, rest);
+        this._columnBuilders.push(col);
+        return col;
+    }
+    // ============================================================================
+    // Convenience Methods
+    // ============================================================================
+    createdAt() {
+        const col = new ColumnBuilder('createdAt', { category: 'timestamp' }, { defaultValue: t.now() });
+        this._columnBuilders.push(col);
+        return col;
+    }
+    updatedAt() {
+        const col = new ColumnBuilder('updatedAt', { category: 'timestamp' }, { defaultValue: t.now() });
+        this._columnBuilders.push(col);
+        return col;
+    }
+    timestamps() {
+        this.createdAt();
+        this.updatedAt();
+    }
+    // ============================================================================
+    // Indexes & Constraints
+    // ============================================================================
+    primaryKey(columns) {
+        this._primaryKey = columns;
+        return this;
+    }
+    unique(columns, name) {
+        const indexName = name ?? `uq_${this._name}_${columns.join('_')}`;
+        this._indexes.push({
+            name: indexName,
+            columns,
+            unique: true,
+        });
+        return this;
+    }
+    index(columns, name) {
+        const indexName = name ?? `idx_${this._name}_${columns.join('_')}`;
+        this._indexes.push({
+            name: indexName,
+            columns,
+            unique: false,
+        });
+        return this;
+    }
+    foreignKey(columns) {
+        const fk = new TableForeignKeyBuilder(columns, this);
+        this._foreignKeyBuilders.push(fk);
+        return fk;
+    }
+    // ============================================================================
+    // Utilities
+    // ============================================================================
+    comment(text) {
+        this._comment = text;
+        return this;
+    }
+    /**
+     * Build the table definition.
+     */
+    build() {
+        // Build all columns from builders
+        const columns = this._columnBuilders.map((cb) => cb.build());
+        // Collect column-level indexes
+        for (const col of columns) {
+            if (col.index) {
+                const indexName = typeof col.index === 'string' ? col.index : `idx_${this._name}_${col.name}`;
+                // Only add if not already in table-level indexes
+                if (!this._indexes.some((idx) => idx.name === indexName)) {
+                    this._indexes.push({
+                        name: indexName,
+                        columns: [col.name],
+                        unique: col.unique,
+                    });
+                }
+            }
+        }
+        // Build foreign keys
+        const foreignKeys = this._foreignKeyBuilders
+            .map((fk) => fk.build())
+            .filter((fk) => fk !== undefined);
+        return {
+            name: this._name,
+            columns,
+            primaryKey: this._primaryKey,
+            indexes: this._indexes,
+            foreignKeys,
+            comment: this._comment,
+        };
+    }
+}
+//# sourceMappingURL=tableBuilder.js.map