@flusys/nestjs-core 1.0.0-beta → 1.0.0

package/cjs/seeders/data-generator.js

@@ -9,27 +9,23 @@ Object.defineProperty(exports, "DataGenerator", {
     }
 });
 const _faker = require("@faker-js/faker");
+const _fieldpatterns = require("./field-patterns");
 let DataGenerator = class DataGenerator {
     /**
    * Generate value for a single column based on its metadata
    */ generateValue(column) {
-        // Skip generated fields
-        if (column.isGenerated) {
-            return undefined;
-        }
+        if (column.isGenerated) return undefined;
         // Handle nullable fields (50% chance of null)
-        if (column.isNullable && _faker.faker.datatype.boolean()) {
-            return null;
-        }
+        if (column.isNullable && _faker.faker.datatype.boolean()) return null;
         // Check for enum
         if (column.enum && column.enum.length > 0) {
             return _faker.faker.helpers.arrayElement(column.enum);
         }
-        // Generate based on column name pattern
-        const nameLower = column.propertyName.toLowerCase();
-        const value = this.generateByName(nameLower, column);
-        if (value !== undefined) {
-            return value;
+        // Generate based on field pattern
+        const pattern = (0, _fieldpatterns.detectFieldPattern)(column);
+        if (pattern) {
+            const value = this.generateByPattern(pattern, column);
+            if (value !== undefined) return value;
         }
         // Generate based on column type
         return this.generateByType(column);
@@ -47,143 +43,108 @@ let DataGenerator = class DataGenerator {
         return entity;
     }
     /**
-   * Generate value based on column name patterns
-   */ generateByName(nameLower, column) {
-        // Identity fields (skip, handled by database)
-        if ([
-            'id',
-            'createdat',
-            'updatedat',
-            'deletedat'
-        ].includes(nameLower)) {
-            return undefined;
-        }
-        // Audit fields (skip, handled by interceptors)
-        if ([
-            'createdbyid',
-            'updatedbyid',
-            'deletedbyid'
-        ].includes(nameLower)) {
-            return null;
-        }
-        // Name fields
-        if (nameLower.includes('firstname')) return _faker.faker.person.firstName();
-        if (nameLower.includes('lastname')) return _faker.faker.person.lastName();
-        if (nameLower.includes('fullname') || nameLower === 'name') {
-            return _faker.faker.person.fullName();
-        }
-        // Contact fields
-        if (nameLower.includes('email')) return _faker.faker.internet.email().toLowerCase();
-        if (nameLower.includes('phone')) return _faker.faker.phone.number();
-        if (nameLower.includes('mobile')) return _faker.faker.phone.number();
-        // Location fields
-        if (nameLower.includes('address')) return _faker.faker.location.streetAddress();
-        if (nameLower.includes('street')) return _faker.faker.location.street();
-        if (nameLower.includes('city')) return _faker.faker.location.city();
-        if (nameLower.includes('state')) return _faker.faker.location.state();
-        if (nameLower.includes('country')) return _faker.faker.location.country();
-        if (nameLower.includes('zipcode') || nameLower.includes('postalcode')) {
-            return _faker.faker.location.zipCode();
-        }
-        // URL/Web fields
-        if (nameLower.includes('url')) return _faker.faker.internet.url();
-        if (nameLower.includes('website')) return _faker.faker.internet.url();
-        if (nameLower.includes('domain')) return _faker.faker.internet.domainName();
-        if (nameLower.includes('slug')) {
-            return _faker.faker.helpers.slugify(_faker.faker.lorem.words(3)).toLowerCase();
-        }
-        // Text fields
-        if (nameLower.includes('description')) return _faker.faker.lorem.paragraph();
-        if (nameLower.includes('summary')) return _faker.faker.lorem.sentence();
-        if (nameLower.includes('content')) return _faker.faker.lorem.paragraphs(3);
-        if (nameLower.includes('title')) return _faker.faker.lorem.sentence();
-        // User fields
-        if (nameLower.includes('username')) return _faker.faker.internet.username();
-        if (nameLower.includes('password')) return '$2b$12$dummy.hashed.password.value'; // Dummy bcrypt hash
-        // Status/Active fields
-        if (nameLower.includes('isactive')) return _faker.faker.datatype.boolean();
-        if (nameLower.includes('isenabled')) return _faker.faker.datatype.boolean();
-        if (nameLower.includes('ispublic')) return _faker.faker.datatype.boolean();
-        if (nameLower.includes('isverified')) return _faker.faker.datatype.boolean();
-        // Date fields
-        if (nameLower.includes('birthdate') || nameLower.includes('dateofbirth')) {
-            return _faker.faker.date.birthdate({
-                min: 18,
-                max: 80,
-                mode: 'age'
-            });
-        }
-        if (nameLower.includes('expiresat') || nameLower.includes('expirydate')) {
-            return _faker.faker.date.future();
-        }
-        if (nameLower.includes('verifiedat')) {
-            return _faker.faker.datatype.boolean() ? _faker.faker.date.recent() : null;
-        }
-        // Serial/Order fields
-        if (nameLower.includes('serial') || nameLower.includes('order')) {
-            return _faker.faker.number.int({
-                min: 1,
-                max: 100
-            });
-        }
-        // Company/Organization
-        if (nameLower.includes('company') && !nameLower.includes('id')) {
-            return _faker.faker.company.name();
+   * Generate value based on detected field pattern
+   */ generateByPattern(pattern, column) {
+        switch(pattern){
+            case 'skip':
+                return undefined;
+            case 'null':
+                return null;
+            case 'boolean':
+                return _faker.faker.datatype.boolean();
+            case 'token':
+                return _faker.faker.string.alphanumeric((0, _fieldpatterns.getTokenLength)(column));
+            case 'firstName':
+                return _faker.faker.person.firstName();
+            case 'lastName':
+                return _faker.faker.person.lastName();
+            case 'fullName':
+                return _faker.faker.person.fullName();
+            case 'email':
+                return _faker.faker.internet.email().toLowerCase();
+            case 'phone':
+                return _faker.faker.phone.number();
+            case 'address':
+                return _faker.faker.location.streetAddress();
+            case 'street':
+                return _faker.faker.location.street();
+            case 'city':
+                return _faker.faker.location.city();
+            case 'state':
+                return _faker.faker.location.state();
+            case 'country':
+                return _faker.faker.location.country();
+            case 'zipCode':
+                return _faker.faker.location.zipCode();
+            case 'url':
+                return _faker.faker.internet.url();
+            case 'domain':
+                return _faker.faker.internet.domainName();
+            case 'slug':
+                return _faker.faker.helpers.slugify(_faker.faker.lorem.words(3)).toLowerCase();
+            case 'description':
+                return _faker.faker.lorem.paragraph();
+            case 'summary':
+                return _faker.faker.lorem.sentence();
+            case 'content':
+                return _faker.faker.lorem.paragraphs(3);
+            case 'title':
+                return _faker.faker.lorem.sentence();
+            case 'username':
+                return _faker.faker.internet.username();
+            case 'password':
+                return '$2b$12$dummy.hashed.password.value';
+            case 'birthdate':
+                return _faker.faker.date.birthdate({
+                    min: 18,
+                    max: 80,
+                    mode: 'age'
+                });
+            case 'futureDate':
+                return _faker.faker.date.future();
+            case 'recentDateOrNull':
+                return _faker.faker.datatype.boolean() ? _faker.faker.date.recent() : null;
+            case 'serial':
+                return _faker.faker.number.int({
+                    min: 1,
+                    max: 100
+                });
+            case 'company':
+                return _faker.faker.company.name();
+            default:
+                return undefined;
         }
-        return undefined;
     }
     /**
    * Generate value based on column type
    */ generateByType(column) {
-        const type = column.type.toLowerCase();
-        switch(type){
-            // String types
-            case 'varchar':
-            case 'character varying':
-            case 'text':
+        const category = (0, _fieldpatterns.detectTypeCategory)(column.type);
+        switch(category){
             case 'string':
                 return this.generateString(column);
-            // Number types
-            case 'int':
             case 'integer':
-            case 'smallint':
-            case 'bigint':
                 return _faker.faker.number.int({
                     min: 1,
                     max: 1000
                 });
             case 'decimal':
-            case 'numeric':
-            case 'float':
-            case 'double':
-            case 'real':
                 return _faker.faker.number.float({
                     min: 0,
                     max: 10000,
                     fractionDigits: column.scale || 2
                 });
-            // Boolean
             case 'boolean':
-            case 'bool':
                 return _faker.faker.datatype.boolean();
-            // Date/Time
             case 'date':
-                return _faker.faker.date.recent({
-                    days: 30
-                });
             case 'timestamp':
-            case 'datetime':
                 return _faker.faker.date.recent({
                     days: 30
                 });
             case 'time':
                 return _faker.faker.date.recent().toTimeString().split(' ')[0];
-            // UUID
             case 'uuid':
                 return _faker.faker.string.uuid();
-            // JSON
             case 'json':
-            case 'jsonb':
                 return {
                     key1: _faker.faker.lorem.word(),
                     key2: _faker.faker.number.int({
@@ -191,13 +152,11 @@ let DataGenerator = class DataGenerator {
                         max: 100
                     })
                 };
-            // Array
             case 'array':
                 return [
                     _faker.faker.lorem.word(),
                     _faker.faker.lorem.word()
                 ];
-            // Default
             default:
                 return _faker.faker.lorem.word();
         }
@@ -206,42 +165,37 @@ let DataGenerator = class DataGenerator {
    * Generate string value respecting length constraints
    */ generateString(column) {
         const maxLength = typeof column.length === 'number' ? column.length : 255;
-        if (maxLength <= 50) {
-            return _faker.faker.lorem.word().substring(0, maxLength);
-        } else if (maxLength <= 255) {
-            return _faker.faker.lorem.sentence().substring(0, maxLength);
-        } else {
-            return _faker.faker.lorem.paragraph().substring(0, maxLength);
+        const category = (0, _fieldpatterns.getStringLengthCategory)(column.length);
+        switch(category){
+            case 'word':
+                return _faker.faker.lorem.word().substring(0, maxLength);
+            case 'sentence':
+                return _faker.faker.lorem.sentence().substring(0, maxLength);
+            case 'paragraph':
+                return _faker.faker.lorem.paragraph().substring(0, maxLength);
         }
     }
     /**
    * Generate related entity ID (for foreign keys)
-   * @param relatedEntities Array of entities to pick from
    */ generateRelationId(relatedEntities) {
-        if (relatedEntities.length === 0) {
-            return null;
-        }
+        if (relatedEntities.length === 0) return null;
         return _faker.faker.helpers.arrayElement(relatedEntities).id;
     }
     /**
    * Generate multiple related entity IDs (for many-to-many)
-   * @param relatedEntities Array of entities to pick from
-   * @param min Minimum number of relations
-   * @param max Maximum number of relations
    */ generateRelationIds(relatedEntities, min = 1, max = 3) {
-        if (relatedEntities.length === 0) {
-            return [];
-        }
+        if (relatedEntities.length === 0) return [];
         const count = _faker.faker.number.int({
             min,
             max: Math.min(max, relatedEntities.length)
         });
-        const selected = _faker.faker.helpers.arrayElements(relatedEntities, count);
-        return selected.map((e)=>e.id);
+        return _faker.faker.helpers.arrayElements(relatedEntities, count).map((e)=>e.id);
     }
     constructor(locale = 'en'){
-    // Note: faker v8+ uses faker.locale instead of setLocale
-    // For v8+: faker.locale = locale;
-    // Locale is set globally, not needed for basic usage
+        _faker.faker.setDefaultRefDate(new Date());
+        if (locale !== 'en') {
+            // @ts-expect-error - faker locale property access
+            _faker.faker.locale = locale;
+        }
     }
 };

package/cjs/seeders/entity-reader.js

@@ -53,23 +53,6 @@ let EntityReader = class EntityReader {
         return this.topologicalSort(graph);
     }
     /**
-   * Check if entity has required columns populated
-   * Used to determine if entity is ready for seeding
-   */ hasRequiredDependencies(entityName, dataSource) {
-        const info = this.getEntityInfo(entityName);
-        for (const relation of info.relations){
-            if (!relation.isNullable && relation.type === 'many-to-one') {
-                const targetRepo = dataSource.getRepository(relation.targetEntity);
-                if (targetRepo) {
-                    // Check if target entity has data
-                    // Note: This is a simplified check, actual implementation may need async
-                    return true;
-                }
-            }
-        }
-        return true;
-    }
-    /**
    * Find entity metadata by name or table name
    */ findEntityMetadata(entityName) {
         return this.getAllEntities().find((e)=>e.name === entityName || e.tableName === entityName);

package/cjs/seeders/field-patterns.js

@@ -0,0 +1,172 @@
+"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';
+    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,8 +1,4 @@
-/**
- * Seed System Exports
- *
- * Public API for seed data generation system.
- */ "use strict";
+"use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
@@ -43,21 +39,33 @@ _export(exports, {
     get ISeederLogger () {
         return _seedrunner.ISeederLogger;
     },
+    get SYSTEM_FIELDS () {
+        return _fieldpatterns.SYSTEM_FIELDS;
+    },
     get SeedRunner () {
         return _seedrunner.SeedRunner;
     },
-    get TemplateGenerator () {
-        return _templategenerator.TemplateGenerator;
+    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;
     },
@@ -71,7 +79,7 @@ _export(exports, {
 const _baseseeder = require("./base-seeder");
 const _entityreader = require("./entity-reader");
 const _datagenerator = require("./data-generator");
-const _templategenerator = require("./template-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,9 +1,4 @@
-/**
- * Seed Configuration
- *
- * Configuration for seed data generation.
- * Customize record counts, seeding order, and behavior.
- */ "use strict";
+"use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
@@ -14,6 +9,9 @@ function _export(target, all) {
     });
 }
 _export(exports, {
+    get configureSeedConfig () {
+        return configureSeedConfig;
+    },
     get getEntityCount () {
         return getEntityCount;
     },
@@ -28,55 +26,20 @@ _export(exports, {
     }
 });
 const seedConfig = {
-    // Default record counts per entity
-    counts: {
-        // Auth entities
-        Company: 10,
-        CompanyBranch: 25,
-        User: 50,
-        // IAM entities
-        Role: 8,
-        Permission: 45,
-        Action: 30,
-        Menu: 20,
-        UserIAMPermission: 50,
-        UserCompanyPermission: 100,
-        // Storage entities
-        StorageConfig: 5,
-        Folder: 20,
-        FileManager: 100
-    },
-    // Entity seeding order (respects FK constraints)
-    // Parent entities must come before child entities
-    order: [
-        // Auth - foundational
-        'Company',
-        'CompanyBranch',
-        'User',
-        // IAM - permissions system
-        'Action',
-        'Role',
-        'Permission',
-        'Menu',
-        'UserIAMPermission',
-        'UserCompanyPermission',
-        // Storage - file system
-        'StorageConfig',
-        'Folder',
-        'FileManager'
-    ],
-    // Skip these entities (system tables, migrations)
+    counts: {},
+    order: [],
     skipEntities: [
         'migrations',
         'typeorm_metadata',
         'Migration',
         'Typeorm_Metadata'
     ],
-    // Faker locale (en, ar, es, fr, de, etc.)
     locale: 'en',
-    // Respect soft delete when clearing data
     respectSoftDelete: true
 };
+function configureSeedConfig(config) {
+    Object.assign(seedConfig, config);
+}
 function getEntityCount(entityName, config = seedConfig) {
     return config.counts[entityName] || 10;
 }
@@ -85,13 +48,11 @@ function shouldSkipEntity(entityName, config = seedConfig) {
 }
 function getSeedingOrder(availableEntities, config = seedConfig) {
     const ordered = [];
-    // Add entities in configured order
     for (const entityName of config.order){
         if (availableEntities.includes(entityName) && !shouldSkipEntity(entityName, config)) {
             ordered.push(entityName);
         }
     }
-    // Add remaining entities not in order configuration
     for (const entityName of availableEntities){
         if (!ordered.includes(entityName) && !shouldSkipEntity(entityName, config)) {
             ordered.push(entityName);