@flusys/nestjs-core 1.1.0 → 1.2.0-rc.1

package/cjs/seeders/field-patterns.js

@@ -1,176 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get AUDIT_FIELDS () {
-        return AUDIT_FIELDS;
-    },
-    get BOOLEAN_KEYWORDS () {
-        return BOOLEAN_KEYWORDS;
-    },
-    get IDENTITY_FIELDS () {
-        return IDENTITY_FIELDS;
-    },
-    get SYSTEM_FIELDS () {
-        return SYSTEM_FIELDS;
-    },
-    get detectFieldPattern () {
-        return detectFieldPattern;
-    },
-    get detectTypeCategory () {
-        return detectTypeCategory;
-    },
-    get getStringLengthCategory () {
-        return getStringLengthCategory;
-    },
-    get getTokenLength () {
-        return getTokenLength;
-    },
-    get isSystemField () {
-        return isSystemField;
-    }
-});
-const SYSTEM_FIELDS = [
-    'id',
-    'createdAt',
-    'updatedAt',
-    'deletedAt',
-    'createdById',
-    'updatedById',
-    'deletedById'
-];
-const AUDIT_FIELDS = [
-    'createdbyid',
-    'updatedbyid',
-    'deletedbyid'
-];
-const IDENTITY_FIELDS = [
-    'id',
-    'createdat',
-    'updatedat',
-    'deletedat'
-];
-const BOOLEAN_KEYWORDS = [
-    'verified',
-    'active',
-    'enabled',
-    'public',
-    'readonly',
-    'valid'
-];
-function detectFieldPattern(column) {
-    const nameLower = column.propertyName.toLowerCase();
-    const typeLower = column.type.toLowerCase();
-    // Identity fields (skip)
-    if (IDENTITY_FIELDS.includes(nameLower)) return 'skip';
-    // Audit fields (null)
-    if (AUDIT_FIELDS.includes(nameLower)) return 'null';
-    // Boolean fields with specific keywords
-    if ((typeLower === 'boolean' || typeLower === 'bool') && BOOLEAN_KEYWORDS.some((k)=>nameLower.includes(k))) {
-        return 'boolean';
-    }
-    // Token fields
-    if (nameLower.includes('token')) return 'token';
-    // Name fields
-    if (nameLower.includes('firstname')) return 'firstName';
-    if (nameLower.includes('lastname')) return 'lastName';
-    if (nameLower.includes('fullname') || nameLower === 'name') return 'fullName';
-    // Contact fields
-    if (nameLower.includes('email') && typeLower !== 'boolean') return 'email';
-    if (nameLower.includes('phone') || nameLower.includes('mobile')) return 'phone';
-    // Location fields
-    if (nameLower.includes('address')) return 'address';
-    if (nameLower.includes('street')) return 'street';
-    if (nameLower.includes('city')) return 'city';
-    if (nameLower.includes('state')) return 'state';
-    if (nameLower.includes('country')) return 'country';
-    if (nameLower.includes('zipcode') || nameLower.includes('postalcode')) return 'zipCode';
-    // URL/Web fields
-    if (nameLower.includes('url') || nameLower.includes('website')) return 'url';
-    if (nameLower.includes('domain')) return 'domain';
-    if (nameLower.includes('slug')) return 'slug';
-    // Text fields
-    if (nameLower.includes('description')) return 'description';
-    if (nameLower.includes('summary')) return 'summary';
-    if (nameLower.includes('content')) return 'content';
-    if (nameLower.includes('title')) return 'title';
-    // User fields
-    if (nameLower.includes('username')) return 'username';
-    if (nameLower.includes('password')) return 'password';
-    // Boolean status fields (fallback)
-    if (nameLower.includes('isactive') || nameLower.includes('isenabled') || nameLower.includes('ispublic') || nameLower.includes('isverified')) {
-        return 'boolean';
-    }
-    // Date fields
-    if (nameLower.includes('birthdate') || nameLower.includes('dateofbirth')) return 'birthdate';
-    if (nameLower.includes('expiresat') || nameLower.includes('expirydate')) return 'futureDate';
-    if (nameLower.includes('verifiedat')) return 'recentDateOrNull';
-    // Serial/Order fields
-    if (nameLower.includes('serial') || nameLower.includes('order')) return 'serial';
-    // Company
-    if (nameLower.includes('company') && !nameLower.includes('id')) return 'company';
-    // Email provider type
-    if (nameLower === 'provider' || nameLower === 'emailprovider') return 'emailProvider';
-    // Form access type
-    if (nameLower === 'accesstype' || nameLower === 'access_type') return 'formAccessType';
-    return undefined;
-}
-function detectTypeCategory(type) {
-    const typeLower = type.toLowerCase();
-    if ([
-        'varchar',
-        'character varying',
-        'text',
-        'string'
-    ].includes(typeLower)) return 'string';
-    if ([
-        'int',
-        'integer',
-        'smallint',
-        'bigint'
-    ].includes(typeLower)) return 'integer';
-    if ([
-        'decimal',
-        'numeric',
-        'float',
-        'double',
-        'real'
-    ].includes(typeLower)) return 'decimal';
-    if ([
-        'boolean',
-        'bool'
-    ].includes(typeLower)) return 'boolean';
-    if (typeLower === 'date') return 'date';
-    if ([
-        'timestamp',
-        'datetime'
-    ].includes(typeLower)) return 'timestamp';
-    if (typeLower === 'time') return 'time';
-    if (typeLower === 'uuid') return 'uuid';
-    if ([
-        'json',
-        'jsonb'
-    ].includes(typeLower)) return 'json';
-    if (typeLower === 'array') return 'array';
-    return 'unknown';
-}
-function getStringLengthCategory(length) {
-    const maxLength = typeof length === 'number' ? length : 255;
-    if (maxLength <= 50) return 'word';
-    if (maxLength <= 255) return 'sentence';
-    return 'paragraph';
-}
-function isSystemField(fieldName) {
-    return SYSTEM_FIELDS.includes(fieldName);
-}
-function getTokenLength(column) {
-    const maxLength = typeof column.length === 'number' ? column.length : 64;
-    return Math.min(maxLength, 32);
-}

package/cjs/seeders/index.js

@@ -1,85 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get BaseSeeder () {
-        return _baseseeder.BaseSeeder;
-    },
-    get DataGenerator () {
-        return _datagenerator.DataGenerator;
-    },
-    get EntityReader () {
-        return _entityreader.EntityReader;
-    },
-    get IColumnInfo () {
-        return _entityreader.IColumnInfo;
-    },
-    get IEntityInfo () {
-        return _entityreader.IEntityInfo;
-    },
-    get IRelationInfo () {
-        return _entityreader.IRelationInfo;
-    },
-    get ISeedConfig () {
-        return _seedconfig.ISeedConfig;
-    },
-    get ISeedOptions () {
-        return _seedrunner.ISeedOptions;
-    },
-    get ISeedResult () {
-        return _seedrunner.ISeedResult;
-    },
-    get ISeederLogger () {
-        return _seedrunner.ISeederLogger;
-    },
-    get SYSTEM_FIELDS () {
-        return _fieldpatterns.SYSTEM_FIELDS;
-    },
-    get SeedRunner () {
-        return _seedrunner.SeedRunner;
-    },
-    get configureSeedConfig () {
-        return _seedconfig.configureSeedConfig;
-    },
-    get defaultLogger () {
-        return _seedrunner.defaultLogger;
-    },
-    get detectFieldPattern () {
-        return _fieldpatterns.detectFieldPattern;
-    },
-    get detectTypeCategory () {
-        return _fieldpatterns.detectTypeCategory;
-    },
-    get getEntityCount () {
-        return _seedconfig.getEntityCount;
-    },
-    get getSeedingOrder () {
-        return _seedconfig.getSeedingOrder;
-    },
-    get isSystemField () {
-        return _fieldpatterns.isSystemField;
-    },
-    get runSeedCli () {
-        return _cli.runSeedCli;
-    },
-    get seedConfig () {
-        return _seedconfig.seedConfig;
-    },
-    get shouldSkipEntity () {
-        return _seedconfig.shouldSkipEntity;
-    }
-});
-const _baseseeder = require("./base-seeder");
-const _entityreader = require("./entity-reader");
-const _datagenerator = require("./data-generator");
-const _seedrunner = require("./seed-runner");
-const _seedconfig = require("./seed-config");
-const _fieldpatterns = require("./field-patterns");
-const _cli = require("./cli");

package/cjs/seeders/seed-config.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get configureSeedConfig () {
-        return configureSeedConfig;
-    },
-    get getEntityCount () {
-        return getEntityCount;
-    },
-    get getSeedingOrder () {
-        return getSeedingOrder;
-    },
-    get seedConfig () {
-        return seedConfig;
-    },
-    get shouldSkipEntity () {
-        return shouldSkipEntity;
-    }
-});
-const seedConfig = {
-    counts: {},
-    order: [],
-    skipEntities: [
-        'migrations',
-        'typeorm_metadata',
-        'Migration',
-        'Typeorm_Metadata'
-    ],
-    locale: 'en',
-    respectSoftDelete: true
-};
-function configureSeedConfig(config) {
-    Object.assign(seedConfig, config);
-}
-function getEntityCount(entityName, config = seedConfig) {
-    return config.counts[entityName] || 10;
-}
-function shouldSkipEntity(entityName, config = seedConfig) {
-    return config.skipEntities.some((skip)=>skip.toLowerCase() === entityName.toLowerCase());
-}
-function getSeedingOrder(availableEntities, config = seedConfig) {
-    const ordered = [];
-    for (const entityName of config.order){
-        if (availableEntities.includes(entityName) && !shouldSkipEntity(entityName, config)) {
-            ordered.push(entityName);
-        }
-    }
-    for (const entityName of availableEntities){
-        if (!ordered.includes(entityName) && !shouldSkipEntity(entityName, config)) {
-            ordered.push(entityName);
-        }
-    }
-    return ordered;
-}

package/cjs/seeders/seed-runner.js

@@ -1,314 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get SeedRunner () {
-        return SeedRunner;
-    },
-    get defaultLogger () {
-        return defaultLogger;
-    }
-});
-const _entityreader = require("./entity-reader");
-const _datagenerator = require("./data-generator");
-const _baseseeder = require("./base-seeder");
-const _seedconfig = require("./seed-config");
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-const defaultLogger = {
-    log: (message)=>console.log(message),
-    error: (message)=>console.error(message)
-};
-let SeedRunner = class SeedRunner {
-    /**
-   * Register a custom seeder for specific entity
-   * Custom seeders take precedence over generic seeders
-   * @param entityName Entity name
-   * @param seeder Custom seeder instance
-   */ registerCustomSeeder(entityName, seeder) {
-        this.customSeeders.set(entityName, seeder);
-    }
-    /**
-   * Unregister a custom seeder
-   * @param entityName Entity name
-   */ unregisterCustomSeeder(entityName) {
-        this.customSeeders.delete(entityName);
-    }
-    /**
-   * Check if entity has custom seeder registered
-   * @param entityName Entity name
-   */ hasCustomSeeder(entityName) {
-        return this.customSeeders.has(entityName);
-    }
-    getSeeder(entityName, entity, dataSource, entityInfo, batchSize) {
-        if (this.customSeeders.has(entityName)) {
-            return this.customSeeders.get(entityName);
-        }
-        return new GenericSeeder(dataSource, entity, this.dataGenerator, entityInfo, batchSize);
-    }
-    /**
-   * Run seeds for all entities
-   * @param options Seeding options
-   * @returns Array of seed results
-   */ async runAll(options = {}) {
-        const results = [];
-        const continueOnError = options.continueOnError ?? true;
-        // Get all entities
-        const allEntities = this.entityReader.getAllEntities();
-        const entityNames = allEntities.map((e)=>e.name).filter((name)=>!(0, _seedconfig.shouldSkipEntity)(name));
-        // Get seeding order
-        const orderedNames = (0, _seedconfig.getSeedingOrder)(entityNames);
-        const mode = options.dryRun ? 'Previewing' : 'Seeding';
-        this.logger.log(`\n🌱 ${mode} ${orderedNames.length} entities...\n`);
-        for(let i = 0; i < orderedNames.length; i++){
-            const entityName = orderedNames[i];
-            // Call progress callback
-            options.onProgress?.(i + 1, orderedNames.length, entityName);
-            const result = await this.runSingle(entityName, options);
-            results.push(result);
-            // Log result
-            if (result.success) {
-                if (result.dryRun) {
-                    this.logger.log(`✓ ${entityName}: ${result.count} records (dry run)`);
-                } else if (result.skipped) {
-                    this.logger.log(`⊘ ${entityName}: skipped (already has data)`);
-                } else {
-                    this.logger.log(`✓ ${entityName}: ${result.count} records`);
-                }
-            } else {
-                this.logger.error(`✗ ${entityName}: ${result.error}`);
-                // Fail-fast if continueOnError is false
-                if (!continueOnError) {
-                    this.logger.error(`\n❌ Seeding failed at ${entityName}, stopping...\n`);
-                    break;
-                }
-            }
-        }
-        const successCount = results.filter((r)=>r.success).length;
-        const failedCount = results.length - successCount;
-        if (failedCount > 0) {
-            this.logger.log(`\n⚠️  Completed with errors: ${successCount}/${results.length} entities seeded (${failedCount} failed)\n`);
-        } else {
-            this.logger.log(`\n✓ Completed: ${successCount}/${results.length} entities seeded\n`);
-        }
-        return results;
-    }
-    /**
-   * Run seed for a single entity
-   * @param entityName Entity name to seed
-   * @param options Seeding options
-   * @returns Seed result
-   */ async runSingle(entityName, options = {}) {
-        const queryRunner = this.dataSource.createQueryRunner();
-        await queryRunner.connect();
-        await queryRunner.startTransaction();
-        try {
-            // Get entity info
-            const entityInfo = this.entityReader.getEntityInfo(entityName);
-            // Find entity target
-            const entity = this.dataSource.entityMetadatas.find((e)=>e.name === entityName)?.target;
-            if (!entity) {
-                throw new Error(`Entity ${entityName} not found`);
-            }
-            const seeder = this.getSeeder(entityName, entity, queryRunner.manager.connection, entityInfo, options.batchSize);
-            // Dry run mode - preview without executing
-            if (options.dryRun) {
-                const count = options.count ?? (0, _seedconfig.getEntityCount)(entityName);
-                await queryRunner.rollbackTransaction();
-                return {
-                    entity: entityName,
-                    success: true,
-                    count,
-                    dryRun: true
-                };
-            }
-            // Skip if exists
-            if (options.skipIfExists) {
-                const existingCount = await seeder.count();
-                if (existingCount > 0) {
-                    await queryRunner.rollbackTransaction();
-                    return {
-                        entity: entityName,
-                        success: true,
-                        count: 0,
-                        skipped: true
-                    };
-                }
-            }
-            // Clear if requested
-            if (options.clear) {
-                await seeder.clear(options.respectSoftDelete ?? _seedconfig.seedConfig.respectSoftDelete);
-            }
-            // Generate data
-            const count = options.count ?? (0, _seedconfig.getEntityCount)(entityName);
-            const entities = await seeder.generate(count);
-            // Commit transaction
-            await queryRunner.commitTransaction();
-            return {
-                entity: entityName,
-                success: true,
-                count: entities.length
-            };
-        } catch (error) {
-            // Rollback on error
-            await queryRunner.rollbackTransaction();
-            return {
-                entity: entityName,
-                success: false,
-                count: 0,
-                error: error instanceof Error ? error.message : String(error)
-            };
-        } finally{
-            await queryRunner.release();
-        }
-    }
-    /**
-   * Clear all seeded data
-   * @param hard If true, hard delete (ignore soft delete)
-   * @param continueOnError If true, continue even if an entity fails (default: true)
-   * @returns Array of clear results
-   */ async clearAll(hard = false, continueOnError = true) {
-        const results = [];
-        // Get all entities
-        const allEntities = this.entityReader.getAllEntities();
-        const entityNames = allEntities.map((e)=>e.name).filter((name)=>!(0, _seedconfig.shouldSkipEntity)(name));
-        // Reverse order for clearing (delete children before parents)
-        const orderedNames = (0, _seedconfig.getSeedingOrder)(entityNames).reverse();
-        const mode = hard ? 'Hard deleting' : 'Clearing';
-        this.logger.log(`\n🗑️  ${mode} ${orderedNames.length} entities...\n`);
-        for (const entityName of orderedNames){
-            try {
-                const entity = this.dataSource.entityMetadatas.find((e)=>e.name === entityName)?.target;
-                if (!entity) {
-                    throw new Error(`Entity ${entityName} not found`);
-                }
-                const seeder = this.getSeeder(entityName, entity, this.dataSource, this.entityReader.getEntityInfo(entityName));
-                const countBefore = await seeder.count(true);
-                // Skip if already empty
-                if (countBefore === 0) {
-                    results.push({
-                        entity: entityName,
-                        success: true,
-                        count: 0
-                    });
-                    this.logger.log(`⊘ ${entityName}: already empty`);
-                    continue;
-                }
-                await seeder.clear(hard);
-                const countAfter = await seeder.count(true);
-                results.push({
-                    entity: entityName,
-                    success: true,
-                    count: countBefore - countAfter
-                });
-                this.logger.log(`✓ ${entityName}: ${countBefore - countAfter} records cleared`);
-            } catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                results.push({
-                    entity: entityName,
-                    success: false,
-                    count: 0,
-                    error: errorMessage
-                });
-                this.logger.error(`✗ ${entityName}: ${errorMessage}`);
-                // Fail-fast if continueOnError is false
-                if (!continueOnError) {
-                    this.logger.error(`\n❌ Clearing failed at ${entityName}, stopping...\n`);
-                    break;
-                }
-            }
-        }
-        const successCount = results.filter((r)=>r.success).length;
-        const failedCount = results.length - successCount;
-        if (failedCount > 0) {
-            this.logger.log(`\n⚠️  Completed with errors: ${successCount}/${results.length} entities cleared (${failedCount} failed)\n`);
-        } else {
-            this.logger.log(`\n✓ Completed: ${successCount}/${results.length} entities cleared\n`);
-        }
-        return results;
-    }
-    /**
-   * Get status for all entities
-   * @returns Array of entity status
-   */ async getStatus() {
-        const allEntities = this.entityReader.getAllEntities();
-        const status = [];
-        for (const metadata of allEntities){
-            if ((0, _seedconfig.shouldSkipEntity)(metadata.name)) {
-                continue;
-            }
-            const repo = this.dataSource.getRepository(metadata.target);
-            const count = await repo.count();
-            const isEmpty = count === 0;
-            const hasSoftDelete = metadata.deleteDateColumn !== undefined;
-            status.push({
-                entity: metadata.name,
-                tableName: metadata.tableName,
-                count,
-                isEmpty,
-                hasSoftDelete
-            });
-        }
-        return status;
-    }
-    constructor(dataSource, logger){
-        _define_property(this, "dataSource", void 0);
-        _define_property(this, "entityReader", void 0);
-        _define_property(this, "dataGenerator", void 0);
-        _define_property(this, "logger", void 0);
-        _define_property(this, "customSeeders", void 0);
-        this.dataSource = dataSource;
-        this.customSeeders = new Map();
-        this.entityReader = new _entityreader.EntityReader(dataSource);
-        this.dataGenerator = new _datagenerator.DataGenerator(_seedconfig.seedConfig.locale);
-        this.logger = logger ?? defaultLogger;
-    }
-};
-/**
- * Generic Seeder Implementation
- *
- * Used by SeedRunner for entities without custom seeders.
- * Generates data based on entity metadata with batch processing support.
- */ let GenericSeeder = class GenericSeeder extends _baseseeder.BaseSeeder {
-    async generate(count) {
-        const allSaved = [];
-        // Process in batches to optimize memory usage for large datasets
-        for(let offset = 0; offset < count; offset += this.batchSize){
-            const currentBatchSize = Math.min(this.batchSize, count - offset);
-            const batch = [];
-            for(let i = 0; i < currentBatchSize; i++){
-                const data = this.generator.generateEntity(this.entityInfo.columns);
-                // TypeORM's create method returns T, but TypeScript needs explicit type assertion
-                const entity = this.repository.create(data);
-                batch.push(entity);
-            }
-            // TypeORM's save method has overloads for T and T[]
-            // We need to explicitly cast to handle the generic type resolution
-            const saved = await this.repository.save(batch);
-            allSaved.push(...saved);
-        }
-        return allSaved;
-    }
-    constructor(dataSource, entity, generator, entityInfo, batchSize){
-        super(dataSource, entity), _define_property(this, "generator", void 0), _define_property(this, "entityInfo", void 0), _define_property(this, "batchSize", void 0), this.generator = generator, this.entityInfo = entityInfo;
-        this.batchSize = batchSize ?? 1000; // Default batch size
-    }
-};