uql-orm 0.9.5 → 0.10.2

package/dist/migrate/codegen/migrationCodeGenerator.js

@@ -0,0 +1,356 @@
+/**
+ * Migration Code Generator
+ *
+ * Generates TypeScript migration code from SchemaDiff.
+ * This enables auto-generating migrations from entity changes.
+ */
+/**
+ * Generates TypeScript migration code from schema diffs.
+ */
+export class MigrationCodeGenerator {
+    indent;
+    includeComments;
+    constructor(options = {}) {
+        this.indent = options.indent ?? '  ';
+        this.includeComments = options.includeComments ?? true;
+    }
+    /**
+     * Generate migration code from a single SchemaDiff.
+     */
+    generate(diff) {
+        const description = this.generateDescription(diff);
+        if (diff.type === 'create') {
+            return {
+                up: this.generateCreateTable(diff),
+                down: this.generateDropTable(diff.tableName),
+                description,
+            };
+        }
+        if (diff.type === 'drop') {
+            return {
+                up: this.generateDropTable(diff.tableName),
+                down: '// Cannot auto-generate: original table structure unknown',
+                description,
+            };
+        }
+        // alter
+        return {
+            up: this.generateAlterUp(diff),
+            down: this.generateAlterDown(diff),
+            description,
+        };
+    }
+    /**
+     * Generate migration code from multiple diffs.
+     */
+    generateAll(diffs) {
+        const ups = [];
+        const downs = [];
+        const descriptions = [];
+        for (const diff of diffs) {
+            const result = this.generate(diff);
+            ups.push(result.up);
+            downs.push(result.down);
+            descriptions.push(result.description);
+        }
+        return {
+            up: ups.join('\n\n'),
+            down: downs.reverse().join('\n\n'), // Reverse for correct rollback order
+            description: descriptions.join('; '),
+        };
+    }
+    /**
+     * Generate a complete migration file template.
+     */
+    generateFile(diffs, name) {
+        const { up, down, description } = this.generateAll(diffs);
+        const timestamp = new Date()
+            .toISOString()
+            .replace(/[-:T.Z]/g, '')
+            .slice(0, 14);
+        const migrationName = name ?? `migration_${timestamp}`;
+        return `/**
+ * Migration: ${migrationName}
+ * ${description}
+ *
+ * Generated at: ${new Date().toISOString()}
+ */
+
+import type { IMigrationBuilder } from 'uql-orm';
+
+export async function up(builder: IMigrationBuilder): Promise<void> {
+${this.indentBlock(up, 1)}
+}
+
+export async function down(builder: IMigrationBuilder): Promise<void> {
+${this.indentBlock(down, 1)}
+}
+`;
+    }
+    // ===========================================================================
+    // Private: Code Generation
+    // ===========================================================================
+    generateCreateTable(diff) {
+        const columns = diff.columnsToAdd ?? [];
+        const lines = [];
+        lines.push(`await builder.createTable('${diff.tableName}', (table) => {`);
+        for (const col of columns) {
+            lines.push(`${this.indent}${this.generateColumnCall(col)};`);
+        }
+        // Add indexes if any
+        for (const idx of diff.indexesToAdd ?? []) {
+            lines.push(`${this.indent}${this.generateIndexCall(idx)};`);
+        }
+        lines.push('});');
+        return lines.join('\n');
+    }
+    generateDropTable(tableName) {
+        return `await builder.dropTable('${tableName}');`;
+    }
+    generateAlterUp(diff) {
+        const lines = [];
+        // Add columns
+        for (const col of diff.columnsToAdd ?? []) {
+            lines.push(this.generateAddColumn(diff.tableName, col));
+        }
+        // Alter columns
+        for (const { to } of diff.columnsToAlter ?? []) {
+            lines.push(this.generateAlterColumn(diff.tableName, to));
+        }
+        // Drop columns
+        for (const colName of diff.columnsToDrop ?? []) {
+            lines.push(`await builder.dropColumn('${diff.tableName}', '${colName}');`);
+        }
+        // Add indexes
+        for (const idx of diff.indexesToAdd ?? []) {
+            lines.push(this.generateCreateIndex(diff.tableName, idx));
+        }
+        // Drop indexes
+        for (const idxName of diff.indexesToDrop ?? []) {
+            lines.push(`await builder.dropIndex('${diff.tableName}', '${idxName}');`);
+        }
+        // Add foreign keys
+        for (const fk of diff.foreignKeysToAdd ?? []) {
+            lines.push(this.generateAddForeignKey(diff.tableName, fk));
+        }
+        // Drop foreign keys
+        for (const fkName of diff.foreignKeysToDrop ?? []) {
+            lines.push(`await builder.dropForeignKey('${diff.tableName}', '${fkName}');`);
+        }
+        return lines.join('\n');
+    }
+    generateAlterDown(diff) {
+        const lines = [];
+        // Reverse: drop added columns
+        for (const col of diff.columnsToAdd ?? []) {
+            lines.push(`await builder.dropColumn('${diff.tableName}', '${col.name}');`);
+        }
+        // Reverse: restore altered columns
+        for (const { from } of diff.columnsToAlter ?? []) {
+            lines.push(this.generateAlterColumn(diff.tableName, from));
+        }
+        // Reverse: re-add dropped columns (if we have the schema)
+        // Note: This requires the original column definition
+        if (diff.columnsToDrop?.length) {
+            lines.push(`// TODO: Re-add dropped columns: ${diff.columnsToDrop.join(', ')}`);
+        }
+        // Reverse: drop added indexes
+        for (const idx of diff.indexesToAdd ?? []) {
+            lines.push(`await builder.dropIndex('${diff.tableName}', '${idx.name}');`);
+        }
+        // Reverse: re-add dropped indexes
+        if (diff.indexesToDrop?.length) {
+            lines.push(`// TODO: Re-add dropped indexes: ${diff.indexesToDrop.join(', ')}`);
+        }
+        // Reverse: drop added foreign keys
+        for (const fk of diff.foreignKeysToAdd ?? []) {
+            if (fk.name) {
+                lines.push(`await builder.dropForeignKey('${diff.tableName}', '${fk.name}');`);
+            }
+        }
+        // Reverse: re-add dropped foreign keys
+        if (diff.foreignKeysToDrop?.length) {
+            lines.push(`// TODO: Re-add dropped foreign keys: ${diff.foreignKeysToDrop.join(', ')}`);
+        }
+        return lines.join('\n');
+    }
+    generateAddColumn(tableName, col) {
+        const options = this.generateColumnOptions(col);
+        return `await builder.addColumn('${tableName}', '${col.name}', (col) => col${options});`;
+    }
+    generateAlterColumn(tableName, col) {
+        const options = this.generateColumnOptions(col);
+        return `await builder.alterColumn('${tableName}', '${col.name}', (col) => col${options});`;
+    }
+    generateCreateIndex(tableName, idx) {
+        const cols = idx.columns.map((c) => `'${c}'`).join(', ');
+        const opts = [];
+        if (idx.name)
+            opts.push(`name: '${idx.name}'`);
+        if (idx.unique)
+            opts.push('unique: true');
+        const optsStr = opts.length ? `, { ${opts.join(', ')} }` : '';
+        return `await builder.createIndex('${tableName}', [${cols}]${optsStr});`;
+    }
+    generateAddForeignKey(tableName, fk) {
+        const cols = fk.columns.map((c) => `'${c}'`).join(', ');
+        const refCols = fk.referencedColumns.map((c) => `'${c}'`).join(', ');
+        const opts = [];
+        if (fk.name)
+            opts.push(`name: '${fk.name}'`);
+        if (fk.onDelete && fk.onDelete !== 'NO ACTION')
+            opts.push(`onDelete: '${fk.onDelete}'`);
+        if (fk.onUpdate && fk.onUpdate !== 'NO ACTION')
+            opts.push(`onUpdate: '${fk.onUpdate}'`);
+        const optsStr = opts.length ? `, { ${opts.join(', ')} }` : '';
+        return `await builder.addForeignKey('${tableName}', [${cols}], { table: '${fk.referencedTable}', columns: [${refCols}] }${optsStr});`;
+    }
+    // ===========================================================================
+    // Private: Column Call Generation
+    // ===========================================================================
+    generateColumnCall(col) {
+        const method = this.getColumnMethod(col);
+        const options = this.generateColumnOptionsObject(col);
+        return `table.${method}('${col.name}'${options})`;
+    }
+    generateIndexCall(idx) {
+        const cols = idx.columns.map((c) => `'${c}'`).join(', ');
+        if (idx.unique) {
+            return `table.unique([${cols}], '${idx.name}')`;
+        }
+        return `table.index([${cols}], '${idx.name}')`;
+    }
+    getColumnMethod(col) {
+        const type = col.type;
+        // Check for auto-increment primary key → id()
+        if (col.isPrimaryKey && col.isAutoIncrement) {
+            return 'id';
+        }
+        // Map type string to method name
+        const typeMap = {
+            integer: 'integer',
+            int: 'integer',
+            bigint: 'bigint',
+            smallint: 'smallint',
+            float: 'float',
+            double: 'double',
+            decimal: 'decimal',
+            numeric: 'decimal',
+            varchar: 'string',
+            char: 'char',
+            text: 'text',
+            boolean: 'boolean',
+            bool: 'boolean',
+            date: 'date',
+            time: 'time',
+            timestamp: 'timestamp',
+            timestamptz: 'timestamptz',
+            json: 'json',
+            jsonb: 'jsonb',
+            uuid: 'uuid',
+            blob: 'blob',
+            bytea: 'blob',
+            vector: 'vector',
+        };
+        const lowerType = type.toLowerCase().replace(/\(.*\)/, ''); // Remove (255) etc
+        return typeMap[lowerType] ?? 'string';
+    }
+    generateColumnOptionsObject(col) {
+        const opts = [];
+        // Type-specific options
+        if (col.length !== undefined && col.length !== 255) {
+            opts.push(`length: ${col.length}`);
+        }
+        if (col.precision !== undefined) {
+            opts.push(`precision: ${col.precision}`);
+        }
+        if (col.scale !== undefined) {
+            opts.push(`scale: ${col.scale}`);
+        }
+        // Common options (only include non-defaults)
+        if (col.nullable) {
+            opts.push('nullable: true');
+        }
+        if (col.isUnique && !col.isPrimaryKey) {
+            opts.push('unique: true');
+        }
+        if (col.isPrimaryKey && !col.isAutoIncrement) {
+            opts.push('primaryKey: true');
+        }
+        if (col.defaultValue !== undefined) {
+            opts.push(`defaultValue: ${this.formatValue(col.defaultValue)}`);
+        }
+        if (opts.length === 0)
+            return '';
+        return `, { ${opts.join(', ')} }`;
+    }
+    generateColumnOptions(col) {
+        const parts = [];
+        if (!col.nullable) {
+            parts.push('.notNullable()');
+        }
+        if (col.isUnique) {
+            parts.push('.unique()');
+        }
+        if (col.defaultValue !== undefined) {
+            parts.push(`.defaultValue(${this.formatValue(col.defaultValue)})`);
+        }
+        return parts.join('');
+    }
+    formatValue(value) {
+        if (value === null)
+            return 'null';
+        if (typeof value === 'string') {
+            // Check for SQL expressions
+            if (value.toUpperCase().includes('CURRENT_TIMESTAMP') ||
+                value.includes('()') ||
+                value.toUpperCase().includes('NOW')) {
+                return `t.raw('${value}')`;
+            }
+            return `'${value.replace(/'/g, "\\'")}'`;
+        }
+        if (typeof value === 'boolean')
+            return String(value);
+        if (typeof value === 'number')
+            return String(value);
+        return JSON.stringify(value);
+    }
+    // ===========================================================================
+    // Private: Utilities
+    // ===========================================================================
+    generateDescription(diff) {
+        const parts = [];
+        if (diff.type === 'create') {
+            parts.push(`Create table '${diff.tableName}'`);
+        }
+        else if (diff.type === 'drop') {
+            parts.push(`Drop table '${diff.tableName}'`);
+        }
+        else {
+            if (diff.columnsToAdd?.length) {
+                parts.push(`Add ${diff.columnsToAdd.length} column(s)`);
+            }
+            if (diff.columnsToAlter?.length) {
+                parts.push(`Alter ${diff.columnsToAlter.length} column(s)`);
+            }
+            if (diff.columnsToDrop?.length) {
+                parts.push(`Drop ${diff.columnsToDrop.length} column(s)`);
+            }
+        }
+        return parts.join(', ') || `Alter table '${diff.tableName}'`;
+    }
+    indentBlock(code, level) {
+        const prefix = this.indent.repeat(level);
+        return code
+            .split('\n')
+            .map((line) => (line.trim() ? prefix + line : line))
+            .join('\n');
+    }
+}
+/**
+ * Factory function to create a MigrationCodeGenerator.
+ */
+export function createMigrationCodeGenerator(options) {
+    return new MigrationCodeGenerator(options);
+}
+//# sourceMappingURL=migrationCodeGenerator.js.map

package/dist/migrate/codegen/migrationCodeGenerator.js.map

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

package/dist/migrate/codegen/migrationFile.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Source code generation for default-export SQL migrations (`SqlQuerier` / `uql-migrate`).
+ */
+export type SqlMigrationModuleOptions = {
+    migrationName: string;
+    createdAt: Date;
+    /** Extra lines in the file header comment (without leading ` * `). */
+    docExtraLines?: string[];
+    /** Indented body inside `async up` (including newlines). */
+    upInner: string;
+    /** Indented body inside `async down` (including newlines). */
+    downInner: string;
+};
+/**
+ * Emit one `await querier.run(...)` line for entity-generated migrations.
+ * Uses `JSON.stringify` so SQL with backticks (SQLite/LibSQL), quotes, `${`, etc. stays valid TS source.
+ */
+export declare function emitSqlRunCall(sql: string): string;
+/** Indented `up`/`down` body: one `await querier.run(...)` per SQL string (entity-generated migrations, #87). */
+export declare function emitSqlRunCalls(statements: string[]): string;
+/** Body for `up` in a manual (empty) migration scaffold. */
+export declare const EMPTY_MANUAL_MIGRATION_UP_INNER = "    // Add your migration logic here.\n    // Use one await querier.run(\"...\") per SQL statement when possible (same style as generate:entities).\n    // Example (Postgres):\n    // await querier.run(\"CREATE TABLE \\\"users\\\" (\\\"id\\\" SERIAL PRIMARY KEY);\");\n";
+/** Body for `down` in a manual (empty) migration scaffold. */
+export declare const EMPTY_MANUAL_MIGRATION_DOWN_INNER = "    // Add your rollback logic here.\n    // await querier.run(\"DROP TABLE IF EXISTS \\\"users\\\";\");\n";
+/**
+ * Full contents of a `export default { async up/down(querier) { ... } }` migration module.
+ */
+export declare function buildSqlQuerierMigrationModule(options: SqlMigrationModuleOptions): string;
+//# sourceMappingURL=migrationFile.d.ts.map

package/dist/migrate/codegen/migrationFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrationFile.d.ts","sourceRoot":"","sources":["../../../src/migrate/codegen/migrationFile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,iHAAiH;AACjH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAE5D;AAED,4DAA4D;AAC5D,eAAO,MAAM,+BAA+B,kRAI3C,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,iCAAiC,+GAE7C,CAAC;AAEF;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAoBzF"}

package/dist/migrate/codegen/migrationFile.js

@@ -0,0 +1,48 @@
+/**
+ * Source code generation for default-export SQL migrations (`SqlQuerier` / `uql-migrate`).
+ */
+/**
+ * Emit one `await querier.run(...)` line for entity-generated migrations.
+ * Uses `JSON.stringify` so SQL with backticks (SQLite/LibSQL), quotes, `${`, etc. stays valid TS source.
+ */
+export function emitSqlRunCall(sql) {
+    return /*ts*/ `    await querier.run(${JSON.stringify(sql)});`;
+}
+/** Indented `up`/`down` body: one `await querier.run(...)` per SQL string (entity-generated migrations, #87). */
+export function emitSqlRunCalls(statements) {
+    return statements.map(emitSqlRunCall).join('\n');
+}
+/** Body for `up` in a manual (empty) migration scaffold. */
+export const EMPTY_MANUAL_MIGRATION_UP_INNER = `    // Add your migration logic here.
+    // Use one await querier.run("...") per SQL statement when possible (same style as generate:entities).
+    // Example (Postgres):
+    // await querier.run("CREATE TABLE \\"users\\" (\\"id\\" SERIAL PRIMARY KEY);");
+`;
+/** Body for `down` in a manual (empty) migration scaffold. */
+export const EMPTY_MANUAL_MIGRATION_DOWN_INNER = `    // Add your rollback logic here.
+    // await querier.run("DROP TABLE IF EXISTS \\"users\\";");
+`;
+/**
+ * Full contents of a `export default { async up/down(querier) { ... } }` migration module.
+ */
+export function buildSqlQuerierMigrationModule(options) {
+    const iso = options.createdAt.toISOString();
+    const extra = options.docExtraLines?.map((line) => `\n * ${line}`).join('') ?? '';
+    return /*ts*/ `import type { SqlQuerier } from 'uql-orm/migrate';
+
+/**
+ * Migration: ${options.migrationName}
+ * Created: ${iso}${extra}
+ */
+export default {
+  async up(querier: SqlQuerier): Promise<void> {
+${options.upInner}
+  },
+
+  async down(querier: SqlQuerier): Promise<void> {
+${options.downInner}
+  },
+};
+`;
+}
+//# sourceMappingURL=migrationFile.js.map

package/dist/migrate/codegen/migrationFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrationFile.js","sourceRoot":"","sources":["../../../src/migrate/codegen/migrationFile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,MAAM,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;AACjE,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,eAAe,CAAC,UAAoB;IAClD,OAAO,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;CAI9C,CAAC;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iCAAiC,GAAG;;CAEhD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAkC;IAC/E,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IAElF,OAAO,MAAM,CAAC;;;gBAGA,OAAO,CAAC,aAAa;cACvB,GAAG,GAAG,KAAK;;;;EAIvB,OAAO,CAAC,OAAO;;;;EAIf,OAAO,CAAC,SAAS;;;CAGlB,CAAC;AACF,CAAC"}

package/dist/migrate/codegen/smartRelationDetector.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Smart Relation Detector
+ *
+ * Uses heuristics and schema analysis to detect relationships between tables:
+ * - Explicit foreign keys (highest confidence)
+ * - Junction tables for ManyToMany
+ * - Unique FK columns for OneToOne
+ */
+import type { SchemaAST } from '../../schema/schemaAST.js';
+import type { DetectedRelation } from '../../schema/types.js';
+/**
+ * Configuration for relation detection.
+ */
+export interface RelationDetectorOptions {
+    /** Minimum confidence threshold (0-1) to include in results */
+    minConfidence?: number;
+    /** Custom singularize function */
+    singularize?: (name: string) => string;
+}
+/**
+ * Detects relationships in a SchemaAST using multiple heuristics.
+ */
+export declare class SmartRelationDetector {
+    private readonly ast;
+    private readonly options;
+    constructor(ast: SchemaAST, options?: RelationDetectorOptions);
+    /**
+     * Detect all relationships in the schema.
+     */
+    detectAll(): DetectedRelation[];
+    /**
+     * Detect junction tables that represent ManyToMany relationships.
+     */
+    private detectJunctionTables;
+    /**
+     * Detect relations where unique FK should upgrade to OneToOne.
+     */
+    private detectOneToOneRelations;
+    /**
+     * Default singularize function (delegates to shared utility).
+     */
+    private defaultSingularize;
+}
+/**
+ * Create a SmartRelationDetector for the given AST.
+ */
+export declare function createRelationDetector(ast: SchemaAST, options?: RelationDetectorOptions): SmartRelationDetector;
+//# sourceMappingURL=smartRelationDetector.d.ts.map

package/dist/migrate/codegen/smartRelationDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartRelationDetector.d.ts","sourceRoot":"","sources":["../../../src/migrate/codegen/smartRelationDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAI9B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;gBAGzC,GAAG,EAAE,SAAS,EAC/B,OAAO,GAAE,uBAA4B;IAQvC;;OAEG;IACH,SAAS,IAAI,gBAAgB,EAAE;IAiC/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+C5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAG3B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,qBAAqB,CAE/G"}

package/dist/migrate/codegen/smartRelationDetector.js

@@ -0,0 +1,135 @@
+/**
+ * Smart Relation Detector
+ *
+ * Uses heuristics and schema analysis to detect relationships between tables:
+ * - Explicit foreign keys (highest confidence)
+ * - Junction tables for ManyToMany
+ * - Unique FK columns for OneToOne
+ */
+import { singularize } from '../../util/string.util.js';
+/**
+ * Detects relationships in a SchemaAST using multiple heuristics.
+ */
+export class SmartRelationDetector {
+    ast;
+    options;
+    constructor(ast, options = {}) {
+        this.ast = ast;
+        this.options = {
+            minConfidence: options.minConfidence ?? 0.5,
+            singularize: options.singularize ?? this.defaultSingularize.bind(this),
+        };
+    }
+    /**
+     * Detect all relationships in the schema.
+     */
+    detectAll() {
+        const relations = [];
+        // 1. Add explicit FK relationships (confidence: 1.0)
+        for (const rel of this.ast.relationships) {
+            relations.push({
+                type: rel.type,
+                from: {
+                    table: rel.from.table,
+                    columns: rel.from.columns,
+                },
+                to: {
+                    table: rel.to.table,
+                    columns: rel.to.columns,
+                },
+                through: rel.through,
+                confidence: 1.0,
+                source: 'explicit_fk',
+            });
+        }
+        // 2. Detect junction tables (ManyToMany)
+        const junctionRelations = this.detectJunctionTables();
+        relations.push(...junctionRelations);
+        // 3. Detect unique FK -> OneToOne upgrades
+        const oneToOneUpgrades = this.detectOneToOneRelations(relations);
+        relations.push(...oneToOneUpgrades);
+        // Filter by confidence
+        return relations.filter((r) => r.confidence >= this.options.minConfidence);
+    }
+    /**
+     * Detect junction tables that represent ManyToMany relationships.
+     */
+    detectJunctionTables() {
+        const relations = [];
+        for (const table of this.ast.tables.values()) {
+            if (!this.ast.isJunctionTable(table))
+                continue;
+            const outgoingRels = table.outgoingRelations;
+            if (outgoingRels.length !== 2)
+                continue;
+            const [rel1, rel2] = outgoingRels;
+            // Create ManyToMany relation
+            relations.push({
+                type: 'ManyToMany',
+                from: {
+                    table: rel1.to.table,
+                    columns: rel1.to.columns,
+                },
+                to: {
+                    table: rel2.to.table,
+                    columns: rel2.to.columns,
+                },
+                through: table,
+                confidence: 0.95,
+                source: 'junction_table',
+            });
+            // Also create inverse relation
+            relations.push({
+                type: 'ManyToMany',
+                from: {
+                    table: rel2.to.table,
+                    columns: rel2.to.columns,
+                },
+                to: {
+                    table: rel1.to.table,
+                    columns: rel1.to.columns,
+                },
+                through: table,
+                confidence: 0.95,
+                source: 'junction_table',
+            });
+        }
+        return relations;
+    }
+    /**
+     * Detect relations where unique FK should upgrade to OneToOne.
+     */
+    detectOneToOneRelations(existingRelations) {
+        const upgrades = [];
+        for (const rel of existingRelations) {
+            if (rel.source !== 'explicit_fk')
+                continue;
+            const fromCol = rel.from.columns[0];
+            if (fromCol?.isUnique && rel.type === 'ManyToOne') {
+                // Upgrade to OneToOne
+                upgrades.push({
+                    type: 'OneToOne',
+                    from: rel.from,
+                    to: rel.to,
+                    through: rel.through,
+                    confidence: 0.9,
+                    source: 'unique_fk',
+                });
+            }
+        }
+        return upgrades;
+    }
+    /**
+     * Default singularize function (delegates to shared utility).
+     */
+    defaultSingularize(name) {
+        return singularize(name);
+    }
+}
+/**
+ * Create a SmartRelationDetector for the given AST.
+ */
+export function createRelationDetector(ast, options) {
+    return new SmartRelationDetector(ast, options);
+}
+//# sourceMappingURL=smartRelationDetector.js.map

package/dist/migrate/codegen/smartRelationDetector.js.map

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