@flusys/nestjs-core 1.0.0-rc → 2.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,38 +165,31 @@ 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'){
         _faker.faker.setDefaultRefDate(new Date());

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

@@ -39,24 +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;
     },
@@ -70,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-runner.js

@@ -58,6 +58,12 @@ let SeedRunner = class SeedRunner {
    */ 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
@@ -122,13 +128,7 @@ let SeedRunner = class SeedRunner {
             if (!entity) {
                 throw new Error(`Entity ${entityName} not found`);
             }
-            // Get seeder (custom or generic)
-            let seeder;
-            if (this.customSeeders.has(entityName)) {
-                seeder = this.customSeeders.get(entityName);
-            } else {
-                seeder = new GenericSeeder(queryRunner.manager.connection, entity, this.dataGenerator, entityInfo, options.batchSize);
-            }
+            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);
@@ -200,13 +200,7 @@ let SeedRunner = class SeedRunner {
                 if (!entity) {
                     throw new Error(`Entity ${entityName} not found`);
                 }
-                // Use custom seeder if available, otherwise generic
-                let seeder;
-                if (this.customSeeders.has(entityName)) {
-                    seeder = this.customSeeders.get(entityName);
-                } else {
-                    seeder = new GenericSeeder(this.dataSource, entity, this.dataGenerator, this.entityReader.getEntityInfo(entityName));
-                }
+                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) {

package/docs/docs.config.d.ts

@@ -14,6 +14,11 @@ export interface IQueryParameterExclusion {
     method?: string;
     parameters: string[];
 }
+export interface IExampleExclusion {
+    pathPattern: string;
+    method?: string;
+    examples: string[];
+}
 export interface IModuleSwaggerOptions {
     modules?: Type<unknown>[];
     title: string;
@@ -25,5 +30,7 @@ export interface IModuleSwaggerOptions {
     excludeTags?: string[];
     excludeSchemaProperties?: ISchemaPropertyExclusion[];
     excludeQueryParameters?: IQueryParameterExclusion[];
+    excludeExamples?: IExampleExclusion[];
 }
 export declare function setupModuleSwaggerDocs(app: INestApplication, configs: IModuleSwaggerOptions[]): void;
+export declare function setupSwaggerDocs(app: INestApplication, ...modules: IModuleSwaggerOptions[]): void;

package/docs/index.d.ts

@@ -1,2 +1 @@
 export * from './docs.config';
-export * from './docs.setup';