uql-orm 0.1.0

package/dist/schema/schemaASTBuilder.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SchemaAST Builder
+ *
+ * Constructs a SchemaAST from:
+ * - Entity metadata (decorator-based entities)
+ * - Database introspection results (TableSchema[])
+ */
+import type { EntityMeta, FieldOptions, Type } from '../type/index.js';
+import type { NamingStrategy } from '../type/namingStrategy.js';
+import { SchemaAST } from './schemaAST.js';
+import type { ForeignKeyAction } from './types.js';
+/**
+ * Options for building SchemaAST from entities.
+ */
+export interface BuildFromEntitiesOptions {
+    /** Custom table name resolver */
+    resolveTableName?: (entity: Type<unknown>, meta: EntityMeta<unknown>) => string;
+    /** Custom column name resolver */
+    resolveColumnName?: (key: string, field: FieldOptions) => string;
+    /** Naming strategy to use */
+    namingStrategy?: NamingStrategy;
+    /** Default action for foreign key ON DELETE and ON UPDATE clauses */
+    defaultForeignKeyAction?: ForeignKeyAction;
+}
+/**
+ * Builds SchemaAST instances from various sources.
+ */
+export declare class SchemaASTBuilder {
+    private readonly namingStrategy?;
+    private readonly defaultForeignKeyAction;
+    private ast;
+    constructor(namingStrategy?: NamingStrategy | undefined, defaultForeignKeyAction?: ForeignKeyAction);
+    /**
+     * Reset the builder for a new schema.
+     */
+    reset(): this;
+    /**
+     * Get the built AST.
+     */
+    getAST(): SchemaAST;
+    /**
+     * Build AST from entity classes (decorated with @Entity, @Field, etc.)
+     */
+    fromEntities(entities: Type<unknown>[], options?: BuildFromEntitiesOptions): SchemaAST;
+    /**
+     * Add a table from entity metadata.
+     */
+    private addTableFromEntity;
+    /**
+     * Add relationships from entity relation decorators.
+     */
+    private addRelationshipsFromEntity;
+    /**
+     * Add indexes from field options.
+     */
+    private addIndexesFromEntity;
+}
+//# sourceMappingURL=schemaASTBuilder.d.ts.map

package/dist/schema/schemaASTBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaASTBuilder.d.ts","sourceRoot":"","sources":["../../src/schema/schemaASTBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAmB,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAc,gBAAgB,EAAqD,MAAM,YAAY,CAAC;AAGlH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;IAChF,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,MAAM,CAAC;IACjE,6BAA6B;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,qEAAqE;IACrE,uBAAuB,CAAC,EAAE,gBAAgB,CAAC;CAC5C;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IAJ1C,OAAO,CAAC,GAAG,CAAY;gBAGJ,cAAc,CAAC,EAAE,cAAc,YAAA,EAC/B,uBAAuB,GAAE,gBAA6C;IAKzF;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,MAAM,IAAI,SAAS;IAQnB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,SAAS;IA8B1F;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0D1B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0DlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAiE7B"}

package/dist/schema/schemaASTBuilder.js

@@ -0,0 +1,224 @@
+/**
+ * SchemaAST Builder
+ *
+ * Constructs a SchemaAST from:
+ * - Entity metadata (decorator-based entities)
+ * - Database introspection results (TableSchema[])
+ */
+import { getMeta } from '../entity/decorator/definition.js';
+import { fieldOptionsToCanonical } from './canonicalType.js';
+import { SchemaAST } from './schemaAST.js';
+import { DEFAULT_FOREIGN_KEY_ACTION } from './types.js';
+/**
+ * Builds SchemaAST instances from various sources.
+ */
+export class SchemaASTBuilder {
+    namingStrategy;
+    defaultForeignKeyAction;
+    ast;
+    constructor(namingStrategy, defaultForeignKeyAction = DEFAULT_FOREIGN_KEY_ACTION) {
+        this.namingStrategy = namingStrategy;
+        this.defaultForeignKeyAction = defaultForeignKeyAction;
+        this.ast = new SchemaAST();
+    }
+    /**
+     * Reset the builder for a new schema.
+     */
+    reset() {
+        this.ast = new SchemaAST();
+        return this;
+    }
+    /**
+     * Get the built AST.
+     */
+    getAST() {
+        return this.ast;
+    }
+    // ============================================================================
+    // Build from Entities
+    // ============================================================================
+    /**
+     * Build AST from entity classes (decorated with @Entity, @Field, etc.)
+     */
+    fromEntities(entities, options = {}) {
+        this.reset();
+        const namingStrategy = options.namingStrategy ?? this.namingStrategy;
+        const resolveTableName = options.resolveTableName ?? ((e, m) => namingStrategy?.tableName(m.name ?? e.name) ?? m.name ?? e.name);
+        const resolveColumnName = options.resolveColumnName ?? ((k, f) => namingStrategy?.columnName(f.name ?? k) ?? f.name ?? k);
+        // First pass: create all tables and columns
+        for (const entity of entities) {
+            const meta = getMeta(entity);
+            this.addTableFromEntity(entity, meta, resolveTableName, resolveColumnName);
+        }
+        // Second pass: create relationships from relation decorators
+        for (const entity of entities) {
+            const meta = getMeta(entity);
+            this.addRelationshipsFromEntity(entity, meta, resolveTableName, resolveColumnName, options);
+        }
+        // Third pass: create indexes from field options
+        for (const entity of entities) {
+            const meta = getMeta(entity);
+            this.addIndexesFromEntity(entity, meta, resolveTableName, resolveColumnName);
+        }
+        return this.ast;
+    }
+    /**
+     * Add a table from entity metadata.
+     */
+    addTableFromEntity(entity, meta, resolveTableName, resolveColumnName) {
+        const tableName = resolveTableName(entity, meta);
+        const columns = new Map();
+        const primaryKey = [];
+        // Create placeholder table (will be fully initialized below)
+        const table = {
+            name: tableName,
+            columns,
+            primaryKey,
+            indexes: [],
+            schema: this.ast,
+            incomingRelations: [],
+            outgoingRelations: [],
+        };
+        // Add columns from fields
+        const fields = meta.fields;
+        for (const key of Object.keys(fields)) {
+            const field = fields[key];
+            if (!field)
+                continue;
+            // Skip virtual fields
+            if (field.virtual)
+                continue;
+            const columnName = resolveColumnName(key, field);
+            const type = fieldOptionsToCanonical(field, field.type);
+            const column = {
+                name: columnName,
+                type,
+                nullable: field.nullable ?? true,
+                defaultValue: field.defaultValue,
+                isPrimaryKey: key === meta.id,
+                isAutoIncrement: field.autoIncrement ?? (key === meta.id && type.category === 'integer'),
+                isUnique: field.unique ?? false,
+                comment: field.comment,
+                table,
+                referencedBy: [],
+                references: undefined,
+            };
+            columns.set(columnName, column);
+            if (key === meta.id) {
+                primaryKey.push(column);
+            }
+        }
+        this.ast.addTable(table);
+    }
+    /**
+     * Add relationships from entity relation decorators.
+     */
+    addRelationshipsFromEntity(entity, meta, resolveTableName, resolveColumnName, options) {
+        const tableName = resolveTableName(entity, meta);
+        const table = this.ast.getTable(tableName);
+        if (!table)
+            return;
+        const relations = meta.relations;
+        for (const key of Object.keys(relations)) {
+            const relation = relations[key];
+            if (!relation?.entity)
+                continue;
+            const relatedEntity = relation.entity();
+            const relatedMeta = getMeta(relatedEntity);
+            const relatedTableName = resolveTableName(relatedEntity, relatedMeta);
+            const relatedTable = this.ast.getTable(relatedTableName);
+            if (!relatedTable)
+                continue;
+            // Only create FK for owning side (m1 and owner side of 11)
+            if (relation.cardinality === 'm1' || (relation.cardinality === '11' && relation.references)) {
+                const references = relation.references ?? [{ local: `${key}Id`, foreign: relatedMeta.id }];
+                const localPropName = references[0].local;
+                const foreignPropName = references[0].foreign;
+                const localField = meta.fields[localPropName];
+                if (!localField)
+                    continue;
+                const localColName = resolveColumnName(localPropName, localField);
+                const foreignField = relatedMeta.fields[foreignPropName];
+                if (!foreignField)
+                    continue;
+                const foreignColName = resolveColumnName(foreignPropName, foreignField);
+                const localColumn = table.columns.get(localColName);
+                const foreignColumn = relatedTable.columns.get(foreignColName);
+                if (localColumn && foreignColumn) {
+                    const relNode = {
+                        name: `fk_${tableName}_${localColName}`,
+                        type: relation.cardinality === 'm1' ? 'ManyToOne' : 'OneToOne',
+                        from: { table, columns: [localColumn] },
+                        to: { table: relatedTable, columns: [foreignColumn] },
+                        onDelete: options.defaultForeignKeyAction ?? this.defaultForeignKeyAction,
+                        onUpdate: options.defaultForeignKeyAction ?? this.defaultForeignKeyAction,
+                        confidence: 1.0,
+                        inferredFrom: 'entity_decorator',
+                    };
+                    this.ast.addRelationship(relNode);
+                }
+            }
+        }
+    }
+    /**
+     * Add indexes from field options.
+     */
+    addIndexesFromEntity(entity, meta, resolveTableName, resolveColumnName) {
+        const tableName = resolveTableName(entity, meta);
+        const table = this.ast.getTable(tableName);
+        if (!table)
+            return;
+        // 1. Single column indexes from @Field({ index: true })
+        const indexFields = meta.fields;
+        for (const key of Object.keys(indexFields)) {
+            const field = indexFields[key];
+            if (!field?.index)
+                continue;
+            const columnName = resolveColumnName(key, field);
+            const column = table.columns.get(columnName);
+            if (!column)
+                continue;
+            const indexName = typeof field.index === 'string' ? field.index : `idx_${tableName}_${columnName}`;
+            const indexNode = {
+                name: indexName,
+                table,
+                columns: [column],
+                unique: field.unique ?? false,
+                source: 'entity',
+                syncStatus: 'entity_only',
+            };
+            this.ast.addIndex(indexNode);
+        }
+        // 2. Composite indexes from @Index([...])
+        if (meta.indexes) {
+            for (const idxMeta of meta.indexes) {
+                const columns = [];
+                for (const propName of idxMeta.columns) {
+                    const field = meta.fields[propName];
+                    if (!field)
+                        continue;
+                    const colName = resolveColumnName(propName, field);
+                    const column = table.columns.get(colName);
+                    if (column) {
+                        columns.push(column);
+                    }
+                }
+                if (columns.length > 0) {
+                    const indexName = idxMeta.name ?? `idx_${tableName}_${columns.map((c) => c.name).join('_')}`;
+                    const indexNode = {
+                        name: indexName,
+                        table,
+                        columns,
+                        unique: idxMeta.unique ?? false,
+                        type: idxMeta.type,
+                        where: idxMeta.where,
+                        source: 'entity',
+                        syncStatus: 'entity_only',
+                    };
+                    this.ast.addIndex(indexNode);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=schemaASTBuilder.js.map

package/dist/schema/schemaASTBuilder.js.map

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

package/dist/schema/schemaASTDiffer.d.ts

@@ -0,0 +1,84 @@
+/**
+ * SchemaAST Differ
+ *
+ * Compares two SchemaAST instances and produces a detailed diff.
+ * Used for:
+ * - Migration generation (entity vs database)
+ * - Drift detection (expected vs actual)
+ * - Schema synchronization
+ */
+import type { SchemaAST } from './schemaAST.js';
+import type { SchemaDiffResult } from './types.js';
+/**
+ * Options for schema diffing.
+ */
+export interface DiffOptions {
+    /** Compare indexes */
+    compareIndexes?: boolean;
+    /** Compare foreign keys/relationships */
+    compareRelationships?: boolean;
+    /** Ignore case differences in names */
+    ignoreCase?: boolean;
+    /** Tables to exclude from comparison */
+    excludeTables?: string[];
+}
+/**
+ * Compares two SchemaAST instances and produces a detailed diff.
+ */
+export declare class SchemaASTDiffer {
+    /**
+     * Compare two schemas and return the differences.
+     *
+     * @param source - The "expected" or "desired" schema (e.g., from entities)
+     * @param target - The "actual" or "current" schema (e.g., from database)
+     * @param options - Diff options
+     * @returns Detailed diff result
+     */
+    diff(source: SchemaAST, target: SchemaAST, options?: DiffOptions): SchemaDiffResult;
+    /**
+     * Compare two tables and return the differences.
+     */
+    private diffTable;
+    /**
+     * Compare columns between two tables.
+     */
+    private diffTableColumns;
+    /**
+     * Compare indexes between two tables.
+     */
+    private diffTableIndexes;
+    /**
+     * Compare two columns and return the difference.
+     */
+    private diffColumn;
+    /**
+     * Compare two indexes and return the difference.
+     */
+    private diffIndex;
+    /**
+     * Compare relationships at the schema level.
+     */
+    private diffRelationships;
+    /**
+     * Compare two relationships.
+     */
+    private diffRelationship;
+    /**
+     * Generate a unique key for a relationship based on its structure.
+     */
+    private getRelationshipKey;
+    /**
+     * Format a canonical type for display.
+     */
+    private formatType;
+    /**
+     * Normalize default values for comparison.
+     */
+    private normalizeDefault;
+}
+/**
+ * Create a differ and run a comparison.
+ * Convenience function for one-off comparisons.
+ */
+export declare function diffSchemas(source: SchemaAST, target: SchemaAST, options?: DiffOptions): SchemaDiffResult;
+//# sourceMappingURL=schemaASTDiffer.d.ts.map

package/dist/schema/schemaASTDiffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaASTDiffer.d.ts","sourceRoot":"","sources":["../../src/schema/schemaASTDiffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAOV,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAYD;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;;;OAOG;IACH,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,WAAgB,GAAG,gBAAgB;IA2FvF;;OAEG;IACH,OAAO,CAAC,SAAS;IAmBjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwDxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqDxB;;OAEG;IACH,OAAO,CAAC,UAAU;IA2ClB;;OAEG;IACH,OAAO,CAAC,SAAS;IAwCjB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0DzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAWzB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,gBAAgB,CAGzG"}