uql-orm 0.1.0

package/dist/migrate/introspection/sqliteIntrospector.js

@@ -0,0 +1,180 @@
+import { AbstractSqlSchemaIntrospector } from './abstractSqlSchemaIntrospector.js';
+/**
+ * SQLite schema introspector
+ */
+export class SqliteSchemaIntrospector extends AbstractSqlSchemaIntrospector {
+    pool;
+    constructor(pool) {
+        super('sqlite');
+        this.pool = pool;
+    }
+    // ============================================================================
+    // SQL Queries (dialect-specific)
+    // ============================================================================
+    getTableNamesQuery() {
+        return /*sql*/ `
+      SELECT name
+      FROM sqlite_master
+      WHERE type = 'table'
+        AND name NOT LIKE 'sqlite_%'
+      ORDER BY name
+    `;
+    }
+    tableExistsQuery() {
+        return /*sql*/ `
+      SELECT COUNT(*) as count
+      FROM sqlite_master
+      WHERE type = 'table'
+        AND name = ?
+    `;
+    }
+    parseTableExistsResult(results) {
+        const row = results[0];
+        if (row?.count !== undefined) {
+            return (this.toNumber(row.count) ?? 0) > 0;
+        }
+        return false;
+    }
+    // SQLite uses PRAGMA which doesn't use parameterized queries in the same way
+    getColumnsQuery(tableName) {
+        return `PRAGMA table_info(${this.escapeId(tableName)})`;
+    }
+    getIndexesQuery(tableName) {
+        return `PRAGMA index_list(${this.escapeId(tableName)})`;
+    }
+    getForeignKeysQuery(tableName) {
+        return `PRAGMA foreign_key_list(${this.escapeId(tableName)})`;
+    }
+    getPrimaryKeyQuery(tableName) {
+        return `PRAGMA table_info(${this.escapeId(tableName)})`;
+    }
+    getColumnsParams(_tableName) {
+        return [];
+    }
+    getIndexesParams(_tableName) {
+        return [];
+    }
+    getForeignKeysParams(_tableName) {
+        return [];
+    }
+    getPrimaryKeyParams(_tableName) {
+        return [];
+    }
+    // ============================================================================
+    // Row Mapping (dialect-specific)
+    // ============================================================================
+    mapTableNameRow(row) {
+        return row.name;
+    }
+    async mapColumnsResult(querier, tableName, results) {
+        // Get unique columns from indexes
+        const uniqueColumns = await this.getUniqueColumns(querier, tableName);
+        return results.map((row) => ({
+            name: row.name,
+            type: this.normalizeType(row.type),
+            nullable: row.notnull === 0,
+            defaultValue: this.parseDefaultValue(row.dflt_value),
+            isPrimaryKey: row.pk > 0,
+            isAutoIncrement: row.pk > 0 && row.type.toUpperCase() === 'INTEGER',
+            isUnique: uniqueColumns.has(row.name),
+            length: this.extractLength(row.type),
+            precision: undefined,
+            scale: undefined,
+            comment: undefined, // SQLite doesn't support column comments
+        }));
+    }
+    async mapIndexesResult(querier, _tableName, results) {
+        const indexSchemas = [];
+        for (const index of results) {
+            const columns = await querier.all(`PRAGMA index_info(${this.escapeId(index.name)})`);
+            // Include user-created indexes ('c') and multi-column unique constraints ('u')
+            // Skip primary key indexes ('pk') and single-column unique constraints
+            const isUserCreated = index.origin === 'c';
+            const isCompositeUnique = index.origin === 'u' && columns.length > 1;
+            if (isUserCreated || isCompositeUnique) {
+                indexSchemas.push({
+                    name: index.name,
+                    columns: columns.map((c) => c.name),
+                    unique: Boolean(index.unique),
+                });
+            }
+        }
+        return indexSchemas;
+    }
+    async mapForeignKeysResult(_querier, tableName, results) {
+        // Group by id to handle composite foreign keys
+        const grouped = new Map();
+        for (const row of results) {
+            const id = row.id;
+            const existing = grouped.get(id) ?? [];
+            existing.push(row);
+            grouped.set(id, existing);
+        }
+        return Array.from(grouped.entries()).map(([id, rows]) => {
+            const first = rows[0];
+            return {
+                name: `fk_${tableName}_${id}`,
+                columns: rows.map((r) => r.from),
+                referencedTable: first.table,
+                referencedColumns: rows.map((r) => r.to),
+                onDelete: this.normalizeReferentialAction(first.on_delete),
+                onUpdate: this.normalizeReferentialAction(first.on_update),
+            };
+        });
+    }
+    mapPrimaryKeyResult(results) {
+        const pkColumns = results.filter((r) => r.pk > 0).sort((a, b) => a.pk - b.pk);
+        if (pkColumns.length === 0) {
+            return undefined;
+        }
+        return pkColumns.map((r) => r.name);
+    }
+    // ============================================================================
+    // SQLite-specific helpers
+    // ============================================================================
+    async getUniqueColumns(querier, tableName) {
+        const results = await querier.all(`PRAGMA index_list(${this.escapeId(tableName)})`);
+        const uniqueColumns = new Set();
+        for (const index of results) {
+            if (index.unique) {
+                const indexInfo = await querier.all(`PRAGMA index_info(${this.escapeId(index.name)})`);
+                // Only single-column unique constraints
+                if (indexInfo.length === 1) {
+                    uniqueColumns.add(indexInfo[0].name);
+                }
+            }
+        }
+        return uniqueColumns;
+    }
+    normalizeType(type) {
+        // Extract base type without length/precision
+        const match = type.match(/^([A-Za-z]+)/);
+        return match ? match[1].toUpperCase() : type.toUpperCase();
+    }
+    extractLength(type) {
+        const match = type.match(/\((\d+)\)/);
+        return match ? Number.parseInt(match[1], 10) : undefined;
+    }
+    parseDefaultValue(defaultValue) {
+        if (defaultValue === null) {
+            return undefined;
+        }
+        if (defaultValue === 'NULL') {
+            return null;
+        }
+        if (defaultValue === 'CURRENT_TIMESTAMP' || defaultValue === 'CURRENT_DATE' || defaultValue === 'CURRENT_TIME') {
+            return defaultValue;
+        }
+        if (/^'.*'$/.test(defaultValue)) {
+            return defaultValue.slice(1, -1);
+        }
+        if (/^-?\d+$/.test(defaultValue)) {
+            return Number.parseInt(defaultValue, 10);
+        }
+        if (/^-?\d+\.\d+$/.test(defaultValue)) {
+            return Number.parseFloat(defaultValue);
+        }
+        return defaultValue;
+    }
+}
+//# sourceMappingURL=sqliteIntrospector.js.map

package/dist/migrate/introspection/sqliteIntrospector.js.map

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

package/dist/migrate/migrator.d.ts

@@ -0,0 +1,176 @@
+import type { Dialect, LoggingOptions, Migration, MigrationDefinition, MigrationResult, MigrationStorage, MigratorOptions, MongoQuerier, NamingStrategy, Querier, QuerierPool, SchemaDiff, SchemaGenerator, SchemaIntrospector, Type } from '../type/index.js';
+import { LoggerWrapper } from '../util/index.js';
+import type { IMigrationBuilder } from './builder/types.js';
+/**
+ * Main class for managing database migrations
+ */
+export declare class Migrator {
+    private readonly pool;
+    readonly storage: MigrationStorage;
+    readonly migrationsPath: string;
+    private _logger;
+    get logger(): LoggerWrapper;
+    set logger(value: LoggingOptions);
+    private readonly _entities?;
+    get entities(): Type<unknown>[];
+    readonly dialect: Dialect;
+    schemaGenerator?: SchemaGenerator;
+    schemaIntrospector?: SchemaIntrospector;
+    constructor(pool: QuerierPool, options?: MigratorOptions);
+    /**
+     * Set the schema generator for DDL operations
+     */
+    setSchemaGenerator(generator: SchemaGenerator): void;
+    protected createIntrospector(): SchemaIntrospector | undefined;
+    protected createGenerator(namingStrategy?: NamingStrategy): SchemaGenerator | undefined;
+    /**
+     * Get the SQL dialect
+     */
+    getDialect(): Dialect;
+    /**
+     * Get all discovered migrations from the migrations directory
+     */
+    getMigrations(): Promise<Migration[]>;
+    /**
+     * Get list of pending migrations (not yet executed)
+     */
+    pending(): Promise<Migration[]>;
+    /**
+     * Get list of executed migrations
+     */
+    executed(): Promise<string[]>;
+    /**
+     * Run all pending migrations
+     */
+    up(options?: {
+        to?: string;
+        step?: number;
+    }): Promise<MigrationResult[]>;
+    /**
+     * Rollback migrations
+     */
+    down(options?: {
+        to?: string;
+        step?: number;
+    }): Promise<MigrationResult[]>;
+    /**
+     * Run a single migration within a transaction
+     */
+    runMigration(migration: Migration, direction: 'up' | 'down'): Promise<MigrationResult>;
+    /**
+     * Generate a new migration file
+     */
+    generate(name: string): Promise<string>;
+    /**
+     * Generate a migration based on entity schema differences
+     */
+    generateFromEntities(name: string): Promise<string>;
+    /**
+     * Get all schema differences between entities and database
+     */
+    getDiffs(): Promise<SchemaDiff[]>;
+    findEntityForTable(tableName: string): Type<unknown> | undefined;
+    /**
+     * Sync schema directly (for development only - not for production!)
+     */
+    sync(options?: {
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Drops and recreates all tables (Development only!)
+     */
+    syncForce(): Promise<void>;
+    /**
+     * Safely synchronizes the schema by only adding missing tables and columns.
+     */
+    autoSync(options?: {
+        safe?: boolean;
+        drop?: boolean;
+        logging?: boolean;
+    }): Promise<void>;
+    protected filterDiff(diff: SchemaDiff, options: {
+        safe?: boolean;
+        drop?: boolean;
+    }): SchemaDiff;
+    executeSyncStatements(statements: string[], options: {
+        logging?: boolean;
+    }): Promise<void>;
+    executeMongoSyncStatements(statements: string[], options: {
+        logging?: boolean;
+    }, querier: MongoQuerier): Promise<void>;
+    executeSqlSyncStatements(statements: string[], options: {
+        logging?: boolean;
+    }, querier: Querier): Promise<void>;
+    /**
+     * Get migration status
+     */
+    status(): Promise<{
+        pending: string[];
+        executed: string[];
+    }>;
+    /**
+     * Get migration files from the migrations directory
+     */
+    getMigrationFiles(): Promise<string[]>;
+    /**
+     * Load a migration from a file
+     */
+    loadMigration(fileName: string): Promise<Migration | undefined>;
+    /**
+     * Check if an object is a valid migration
+     */
+    isMigration(obj: unknown): obj is MigrationDefinition;
+    /**
+     * Extract migration name from filename
+     */
+    getMigrationName(fileName: string): string;
+    /**
+     * Generate timestamp string for migration names
+     */
+    protected getTimestamp(): string;
+    /**
+     * Convert a string to a slug for filenames
+     */
+    protected slugify(text: string): string;
+    /**
+     * Generate migration file content
+     */
+    protected generateMigrationContent(name: string): string;
+    /**
+     * Generate migration file content with SQL statements
+     */
+    protected generateMigrationContentWithStatements(name: string, upStatements: string[], downStatements: string[]): string;
+}
+/**
+ * Helper function to define a migration with proper typing
+ */
+export declare function defineMigration(migration: MigrationDefinition): MigrationDefinition;
+/**
+ * Migration definition that uses the type-safe builder API.
+ */
+export interface BuilderMigrationDefinition {
+    readonly name?: string;
+    readonly up: (builder: IMigrationBuilder) => Promise<void>;
+    readonly down: (builder: IMigrationBuilder) => Promise<void>;
+}
+/**
+ * Define a migration using the type-safe builder API.
+ *
+ * @example
+ * ```ts
+ * export default defineBuilderMigration({
+ *   async up(m) {
+ *     await m.createTable('users', (table) => {
+ *       table.id();
+ *       table.string('email', 255).unique();
+ *       table.timestamps();
+ *     });
+ *   },
+ *   async down(m) {
+ *     await m.dropTable('users');
+ *   }
+ * });
+ * ```
+ */
+export declare function defineBuilderMigration(migration: BuilderMigrationDefinition): BuilderMigrationDefinition;
+//# sourceMappingURL=migrator.d.ts.map

package/dist/migrate/migrator.d.ts.map

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