uql-orm 0.21.0 → 0.23.0

package/dist/entity/decorator/index-decorator.js

@@ -1,26 +0,0 @@
-import { defineIndex } from '../metadata/definition.js';
-/**
- * Define a composite index on an entity class.
- *
- * @example
- * ```ts
- * @Index(['lastName', 'firstName'], { name: 'idx_users_fullname' })
- * @Entity()
- * export class User {
- *   @Id() id?: number;
- *   @Field() firstName?: string;
- *   @Field() lastName?: string;
- * }
- *
- * // With unique and partial index
- * @Index(['email'], { unique: true })
- * @Index(['status'], { where: "status = 'active'" })
- * @Entity()
- * export class User { ... }
- * ```
- */
-export function Index(columns, options = {}) {
-    return (target) => {
-        defineIndex(target, { ...options, columns });
-    };
-}

package/dist/entity/decorator/index.d.ts

@@ -1,8 +0,0 @@
-export { defineEntity, defineField, defineFilter, defineHook, defineId, defineIndex, defineRelation, getEntities, getMeta, } from '../metadata/definition.js';
-export * from './entity.js';
-export * from './field.js';
-export * from './filter.js';
-export * from './hook.js';
-export * from './id.js';
-export * from './index-decorator.js';
-export * from './relation.js';

package/dist/entity/decorator/index.js

@@ -1,8 +0,0 @@
-export { defineEntity, defineField, defineFilter, defineHook, defineId, defineIndex, defineRelation, getEntities, getMeta, } from '../metadata/definition.js';
-export * from './entity.js';
-export * from './field.js';
-export * from './filter.js';
-export * from './hook.js';
-export * from './id.js';
-export * from './index-decorator.js';
-export * from './relation.js';

package/dist/entity/decorator/relation.d.ts

@@ -1,8 +0,0 @@
-import type { RelationManyToManyOptions, RelationManyToOneOptions, RelationOneToManyOptions, RelationOneToOneOptions, RelationOptions } from '../../type/index.js';
-declare function Relation<E>(opts: RelationOptions<E>): (target: object, key: string) => void;
-type RelationReturn = ReturnType<typeof Relation>;
-export declare function OneToOne<E>(opts?: RelationOneToOneOptions<E>): RelationReturn;
-export declare function ManyToOne<E>(opts?: RelationManyToOneOptions<E>): RelationReturn;
-export declare function OneToMany<E>(opts: RelationOneToManyOptions<E>): RelationReturn;
-export declare function ManyToMany<E>(opts: RelationManyToManyOptions<E>): RelationReturn;
-export {};

package/dist/entity/decorator/relation.js

@@ -1,19 +0,0 @@
-import { defineRelation } from '../metadata/definition.js';
-function Relation(opts) {
-    return (target, key) => {
-        const entity = target.constructor;
-        defineRelation(entity, key, opts);
-    };
-}
-export function OneToOne(opts) {
-    return Relation({ cardinality: '11', ...opts });
-}
-export function ManyToOne(opts) {
-    return Relation({ cardinality: 'm1', ...opts });
-}
-export function OneToMany(opts) {
-    return Relation({ cardinality: '1m', ...opts });
-}
-export function ManyToMany(opts) {
-    return Relation({ cardinality: 'mm', ...opts });
-}

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

@@ -1,114 +0,0 @@
-/**
- * Entity Merger
- *
- * Merges generated entity code with existing TypeScript entity files.
- * Uses string-based parsing to add new fields with JSDoc comments.
- */
-import type { ColumnNode, RelationshipNode } from '../../schema/types.js';
-/**
- * Options for entity merging.
- */
-export interface EntityMergerOptions {
-    /** Add JSDoc @sync-added comments to new fields */
-    addSyncComments?: boolean;
-    /** Mark removed fields with @deprecated instead of deleting */
-    markRemovedAsDeprecated?: boolean;
-    /** Custom property name transformer */
-    propertyNameTransformer?: (columnName: string) => string;
-}
-/**
- * Represents a field to add to an entity.
- */
-export interface FieldToAdd {
-    column: ColumnNode;
-    propertyName: string;
-    isRelation?: boolean;
-    relation?: RelationshipNode;
-}
-/**
- * Represents a field to mark as deprecated.
- */
-export interface FieldToDeprecate {
-    propertyName: string;
-    reason: string;
-}
-/**
- * Result of entity merge operation.
- */
-export interface MergeResult {
-    /** The merged source code */
-    code: string;
-    /** Number of fields added */
-    fieldsAdded: number;
-    /** Number of fields marked deprecated */
-    fieldsDeprecated: number;
-    /** Whether the file was modified */
-    modified: boolean;
-}
-/**
- * Merges new fields from database schema into existing entity files.
- */
-export declare class EntityMerger {
-    private readonly options;
-    constructor(options?: EntityMergerOptions);
-    /**
-     * Merge new fields into existing entity source code.
-     */
-    merge(existingCode: string, fieldsToAdd: FieldToAdd[], fieldsToDeprecate?: FieldToDeprecate[]): MergeResult;
-    /**
-     * Extract existing property names from entity code.
-     */
-    private extractPropertyNames;
-    /**
-     * Find the position to insert new fields (before the last closing brace).
-     */
-    private findInsertPosition;
-    /**
-     * Count net brace depth change in a line.
-     */
-    private countBraces;
-    /**
-     * Generate code for new fields.
-     */
-    private generateFieldsCode;
-    /**
-     * Generate code for a column field.
-     */
-    private generateColumnField;
-    /**
-     * Generate code for a relation field.
-     */
-    private generateRelationField;
-    /**
-     * Mark a field as deprecated in the source code.
-     */
-    private markFieldAsDeprecated;
-    /**
-     * Build Field decorator options string.
-     */
-    private buildFieldOptions;
-    /**
-     * Format type for description.
-     */
-    private formatTypeDescription;
-    /**
-     * Get relation decorator name.
-     */
-    private getRelationDecoratorName;
-    /**
-     * Default property name transformer (delegates to shared utility).
-     */
-    private defaultPropertyNameTransformer;
-    /**
-     * Convert to PascalCase (delegates to shared utility).
-     */
-    private toPascalCase;
-    /**
-     * Singularize (delegates to shared utility).
-     */
-    private singularize;
-}
-/**
- * Create an EntityMerger instance.
- */
-export declare function createEntityMerger(options?: EntityMergerOptions): EntityMerger;

package/dist/migrate/codegen/entityMerger.js

@@ -1,293 +0,0 @@
-/**
- * Entity Merger
- *
- * Merges generated entity code with existing TypeScript entity files.
- * Uses string-based parsing to add new fields with JSDoc comments.
- */
-import { canonicalToColumnType, canonicalToTypeScript } from '../../schema/canonicalType.js';
-import { camelCase, pascalCase, singularize } from '../../util/string.util.js';
-/**
- * Merges new fields from database schema into existing entity files.
- */
-export class EntityMerger {
-    options;
-    constructor(options = {}) {
-        this.options = {
-            addSyncComments: options.addSyncComments ?? true,
-            markRemovedAsDeprecated: options.markRemovedAsDeprecated ?? true,
-            propertyNameTransformer: options.propertyNameTransformer ?? this.defaultPropertyNameTransformer.bind(this),
-        };
-    }
-    /**
-     * Merge new fields into existing entity source code.
-     */
-    merge(existingCode, fieldsToAdd, fieldsToDeprecate = []) {
-        let code = existingCode;
-        let fieldsAdded = 0;
-        let fieldsDeprecated = 0;
-        // Find the existing property names to avoid duplicates
-        const existingProps = this.extractPropertyNames(code);
-        // Filter out fields that already exist
-        const newFields = fieldsToAdd.filter((f) => !existingProps.has(f.propertyName));
-        // Find the position to insert new fields (before closing brace)
-        const insertPosition = this.findInsertPosition(code);
-        if (insertPosition === -1) {
-            return { code, fieldsAdded: 0, fieldsDeprecated: 0, modified: false };
-        }
-        // Generate code for new fields
-        const newFieldsCode = this.generateFieldsCode(newFields);
-        if (newFieldsCode) {
-            // Insert the new fields
-            code = code.slice(0, insertPosition) + newFieldsCode + code.slice(insertPosition);
-            fieldsAdded = newFields.length;
-        }
-        // Mark fields as deprecated
-        if (this.options.markRemovedAsDeprecated) {
-            for (const field of fieldsToDeprecate) {
-                const deprecatedCode = this.markFieldAsDeprecated(code, field);
-                if (deprecatedCode !== code) {
-                    code = deprecatedCode;
-                    fieldsDeprecated++;
-                }
-            }
-        }
-        return {
-            code,
-            fieldsAdded,
-            fieldsDeprecated,
-            modified: fieldsAdded > 0 || fieldsDeprecated > 0,
-        };
-    }
-    /**
-     * Extract existing property names from entity code.
-     */
-    extractPropertyNames(code) {
-        const props = new Set();
-        // Match property declarations: propertyName?: Type;
-        const regex = /^\s*(?:readonly\s+)?(\w+)\s*[?!]?\s*:/gm;
-        let match = regex.exec(code);
-        while (match !== null) {
-            props.add(match[1]);
-            match = regex.exec(code);
-        }
-        return props;
-    }
-    /**
-     * Find the position to insert new fields (before the last closing brace).
-     */
-    findInsertPosition(code) {
-        const lines = code.split('\n');
-        let braceCount = 0;
-        let inClass = false;
-        let lastPropertyLine = -1;
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i];
-            if (line.includes('class ')) {
-                inClass = true;
-            }
-            if (!inClass)
-                continue;
-            braceCount += this.countBraces(line);
-            if (/^\s*(?:@\w+|readonly\s+|\w+\s*[?!]?:)/.test(line)) {
-                lastPropertyLine = i;
-            }
-            if (braceCount !== 0)
-                continue;
-            // Found the closing brace - calculate insertion position
-            const insertLineIndex = lastPropertyLine >= 0 ? lastPropertyLine + 1 : i;
-            let pos = 0;
-            for (let j = 0; j < insertLineIndex; j++) {
-                pos += lines[j].length + 1;
-            }
-            return pos;
-        }
-        return -1;
-    }
-    /**
-     * Count net brace depth change in a line.
-     */
-    countBraces(line) {
-        let count = 0;
-        for (const char of line) {
-            if (char === '{')
-                count++;
-            if (char === '}')
-                count--;
-        }
-        return count;
-    }
-    /**
-     * Generate code for new fields.
-     */
-    generateFieldsCode(fields) {
-        if (fields.length === 0)
-            return '';
-        const lines = [''];
-        for (const field of fields) {
-            if (field.isRelation && field.relation) {
-                lines.push(...this.generateRelationField(field));
-            }
-            else {
-                lines.push(...this.generateColumnField(field));
-            }
-            lines.push('');
-        }
-        return lines.join('\n');
-    }
-    /**
-     * Generate code for a column field.
-     */
-    generateColumnField(field) {
-        const lines = [];
-        const col = field.column;
-        const tsType = canonicalToTypeScript(col.type);
-        // JSDoc comment
-        if (this.options.addSyncComments) {
-            lines.push('  /**');
-            lines.push(`   * @sync-added ${new Date().toISOString().split('T')[0]}`);
-            lines.push(`   * Column discovered in database but not in entity.`);
-            lines.push(`   * Type: ${this.formatTypeDescription(col.type)}, Nullable: ${col.nullable}`);
-            lines.push('   */');
-        }
-        // Decorator
-        if (col.isPrimaryKey) {
-            lines.push(`  @Id()`);
-        }
-        else {
-            const fieldOptions = this.buildFieldOptions(col);
-            lines.push(`  @Field(${fieldOptions})`);
-        }
-        // Property
-        const nullable = col.nullable ? '?' : '';
-        lines.push(`  ${field.propertyName}${nullable}: ${tsType};`);
-        return lines;
-    }
-    /**
-     * Generate code for a relation field.
-     */
-    generateRelationField(field) {
-        const lines = [];
-        const rel = field.relation;
-        if (!rel)
-            return lines;
-        // Determine related table and decorator
-        const isOutgoing = rel.from.columns.some((c) => c.name === field.column.name);
-        const relatedTable = isOutgoing ? rel.to.table : rel.from.table;
-        const decoratorName = this.getRelationDecoratorName(rel.type, !isOutgoing);
-        const relatedClassName = this.toPascalCase(this.singularize(relatedTable.name));
-        // JSDoc comment
-        if (this.options.addSyncComments) {
-            lines.push('  /**');
-            lines.push(`   * @sync-added ${new Date().toISOString().split('T')[0]}`);
-            lines.push(`   * Foreign key relation detected: references "${relatedTable.name}"`);
-            lines.push('   */');
-        }
-        // Decorator
-        lines.push(`  @${decoratorName}({ entity: () => ${relatedClassName} })`);
-        // Property
-        const isArray = decoratorName === 'OneToMany' || decoratorName === 'ManyToMany';
-        const typeStr = isArray ? `Relation<${relatedClassName}[]>` : `Relation<${relatedClassName}>`;
-        lines.push(`  ${field.propertyName}?: ${typeStr};`);
-        return lines;
-    }
-    /**
-     * Mark a field as deprecated in the source code.
-     */
-    markFieldAsDeprecated(code, field) {
-        // Find the property declaration
-        const propRegex = new RegExp(`(^\\s*)(@\\w+.*?\\n\\s*)*?(${field.propertyName}\\s*[?!]?\\s*:)`, 'm');
-        const match = propRegex.exec(code);
-        if (!match)
-            return code;
-        // Check if already has @deprecated
-        const beforeMatch = code.slice(Math.max(0, match.index - 100), match.index);
-        if (beforeMatch.includes('@deprecated'))
-            return code;
-        // Add @deprecated JSDoc
-        const indent = match[1] || '  ';
-        const deprecationComment = [
-            `${indent}/**`,
-            `${indent} * @deprecated ${field.reason}`,
-            `${indent} * @sync-removed ${new Date().toISOString().split('T')[0]}`,
-            `${indent} */`,
-            '',
-        ].join('\n');
-        return code.slice(0, match.index) + deprecationComment + code.slice(match.index);
-    }
-    /**
-     * Build Field decorator options string.
-     */
-    buildFieldOptions(col) {
-        const options = [];
-        const columnType = canonicalToColumnType(col.type);
-        if (columnType) {
-            options.push(`columnType: '${columnType}'`);
-        }
-        if (col.type.length && col.type.category === 'string') {
-            options.push(`length: ${col.type.length}`);
-        }
-        if (col.type.precision !== undefined) {
-            options.push(`precision: ${col.type.precision}`);
-        }
-        if (col.type.scale !== undefined) {
-            options.push(`scale: ${col.type.scale}`);
-        }
-        if (col.nullable) {
-            options.push('nullable: true');
-        }
-        return options.length > 0 ? `{ ${options.join(', ')} }` : '';
-    }
-    /**
-     * Format type for description.
-     */
-    formatTypeDescription(type) {
-        let desc = type.category.toUpperCase();
-        if (type.size)
-            desc = `${type.size.toUpperCase()}${desc}`;
-        if (type.length)
-            desc += `(${type.length})`;
-        if (type.precision) {
-            desc += `(${type.precision}`;
-            if (type.scale)
-                desc += `,${type.scale}`;
-            desc += ')';
-        }
-        return desc;
-    }
-    /**
-     * Get relation decorator name.
-     */
-    getRelationDecoratorName(type, inverse) {
-        if (inverse) {
-            if (type === 'ManyToOne')
-                return 'OneToMany';
-            if (type === 'OneToMany')
-                return 'ManyToOne';
-        }
-        return type;
-    }
-    /**
-     * Default property name transformer (delegates to shared utility).
-     */
-    defaultPropertyNameTransformer(columnName) {
-        return camelCase(columnName);
-    }
-    /**
-     * Convert to PascalCase (delegates to shared utility).
-     */
-    toPascalCase(str) {
-        return pascalCase(str);
-    }
-    /**
-     * Singularize (delegates to shared utility).
-     */
-    singularize(name) {
-        return singularize(name);
-    }
-}
-/**
- * Create an EntityMerger instance.
- */
-export function createEntityMerger(options) {
-    return new EntityMerger(options);
-}

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

@@ -1,61 +0,0 @@
-/**
- * Migration Code Generator
- *
- * Generates TypeScript migration code from SchemaDiff.
- * This enables auto-generating migrations from entity changes.
- */
-import type { SchemaDiff } from '../../type/index.js';
-export interface MigrationCodeOptions {
-    /** Indentation string (default: 2 spaces) */
-    indent?: string;
-    /** Whether to include comments explaining changes */
-    includeComments?: boolean;
-}
-export interface GeneratedMigration {
-    /** The up migration code */
-    up: string;
-    /** The down migration code */
-    down: string;
-    /** Human-readable description of changes */
-    description: string;
-}
-/**
- * Generates TypeScript migration code from schema diffs.
- */
-export declare class MigrationCodeGenerator {
-    private readonly indent;
-    private readonly includeComments;
-    constructor(options?: MigrationCodeOptions);
-    /**
-     * Generate migration code from a single SchemaDiff.
-     */
-    generate(diff: SchemaDiff): GeneratedMigration;
-    /**
-     * Generate migration code from multiple diffs.
-     */
-    generateAll(diffs: SchemaDiff[]): GeneratedMigration;
-    /**
-     * Generate a complete migration file template.
-     */
-    generateFile(diffs: SchemaDiff[], name?: string): string;
-    private generateCreateTable;
-    private generateDropTable;
-    private generateAlterUp;
-    private generateAlterDown;
-    private generateAddColumn;
-    private generateAlterColumn;
-    private generateCreateIndex;
-    private generateAddForeignKey;
-    private generateColumnCall;
-    private generateIndexCall;
-    private getColumnMethod;
-    private generateColumnOptionsObject;
-    private generateColumnOptions;
-    private formatValue;
-    private generateDescription;
-    private indentBlock;
-}
-/**
- * Factory function to create a MigrationCodeGenerator.
- */
-export declare function createMigrationCodeGenerator(options?: MigrationCodeOptions): MigrationCodeGenerator;