@flusys/nestjs-core 1.0.0-beta → 1.0.0

package/fesm/utils/datasource-config.builder.js

@@ -45,7 +45,8 @@
     const defaultTenantConfig = {
         id: 'default',
         database: config.defaultDatabaseConfig.database || 'default',
-        enableCompanyFeature: config.bootstrapAppConfig?.enableCompanyFeature ?? false
+        enableCompanyFeature: config.bootstrapAppConfig?.enableCompanyFeature ?? false,
+        permissionMode: config.bootstrapAppConfig?.permissionMode ?? 'FULL'
     };
     return {
         database: defaultTenantConfig.database,
@@ -60,18 +61,6 @@
     }
     return config.entities;
 }
-/**
- * Build full database config for a tenant
- */ export function buildTenantDatabaseConfig(baseConfig, tenant) {
-    return {
-        type: baseConfig.type,
-        host: tenant.host ?? baseConfig.host,
-        port: tenant.port ?? baseConfig.port,
-        username: tenant.username ?? baseConfig.username,
-        password: tenant.password ?? baseConfig.password,
-        database: tenant.database
-    };
-}
 /**
  * Get active tenants from config
  */ export function getActiveTenants(config) {

package/interfaces/base-entity.interface.d.ts

@@ -17,3 +17,6 @@ export interface IOrderable {
 export interface IMetadata {
     metadata?: Record<string, any> | null;
 }
+export interface ICompanyOwned {
+    companyId?: string | null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-core",
-  "version": "1.0.0-beta",
+  "version": "1.0.0",
   "description": "Core types, interfaces, and constants for Flusys NestJS packages",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -61,7 +61,7 @@
     }
   },
   "peerDependencies": {
-    "@faker-js/faker": "^9.0.0",
+    "@faker-js/faker": "^10.0.0",
     "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/config": "^3.0.0 || ^4.0.0",
     "@nestjs/core": "^10.0.0 || ^11.0.0",

package/seeders/data-generator.d.ts

@@ -3,7 +3,7 @@ export declare class DataGenerator {
     constructor(locale?: string);
     generateValue(column: IColumnInfo): any;
     generateEntity(columns: IColumnInfo[]): Record<string, any>;
-    private generateByName;
+    private generateByPattern;
     private generateByType;
     private generateString;
     generateRelationId<T extends {

package/seeders/entity-reader.d.ts

@@ -34,7 +34,6 @@ export declare class EntityReader {
     getAllEntities(): EntityMetadata[];
     getEntityInfo(entityName: string): IEntityInfo;
     getSeedingOrder(skipEntities?: string[]): string[];
-    hasRequiredDependencies(entityName: string, dataSource: DataSource): boolean;
     private findEntityMetadata;
     private extractColumns;
     private extractRelations;

package/seeders/field-patterns.d.ts

@@ -0,0 +1,12 @@
+import { IColumnInfo } from './entity-reader';
+export declare const SYSTEM_FIELDS: string[];
+export declare const AUDIT_FIELDS: string[];
+export declare const IDENTITY_FIELDS: string[];
+export declare const BOOLEAN_KEYWORDS: string[];
+export type FieldPatternType = 'skip' | 'null' | 'boolean' | 'token' | 'firstName' | 'lastName' | 'fullName' | 'email' | 'phone' | 'address' | 'street' | 'city' | 'state' | 'country' | 'zipCode' | 'url' | 'domain' | 'slug' | 'description' | 'summary' | 'content' | 'title' | 'username' | 'password' | 'birthdate' | 'futureDate' | 'recentDateOrNull' | 'serial' | 'company';
+export type ColumnTypeCategory = 'string' | 'integer' | 'decimal' | 'boolean' | 'date' | 'timestamp' | 'time' | 'uuid' | 'json' | 'array' | 'unknown';
+export declare function detectFieldPattern(column: IColumnInfo): FieldPatternType | undefined;
+export declare function detectTypeCategory(type: string): ColumnTypeCategory;
+export declare function getStringLengthCategory(length: number | string | undefined): 'word' | 'sentence' | 'paragraph';
+export declare function isSystemField(fieldName: string): boolean;
+export declare function getTokenLength(column: IColumnInfo): number;

package/seeders/index.d.ts

@@ -1,7 +1,7 @@
 export { BaseSeeder } from './base-seeder';
 export { EntityReader, IEntityInfo, IColumnInfo, IRelationInfo } from './entity-reader';
 export { DataGenerator } from './data-generator';
-export { TemplateGenerator } from './template-generator';
-export { SeedRunner, ISeedResult, ISeedOptions, ISeederLogger, defaultLogger, } from './seed-runner';
-export { seedConfig, ISeedConfig, getEntityCount, shouldSkipEntity, getSeedingOrder } from './seed-config';
+export { SeedRunner, ISeedResult, ISeedOptions, ISeederLogger, defaultLogger } from './seed-runner';
+export { seedConfig, ISeedConfig, getEntityCount, shouldSkipEntity, getSeedingOrder, configureSeedConfig } from './seed-config';
+export { SYSTEM_FIELDS, isSystemField, detectFieldPattern, detectTypeCategory } from './field-patterns';
 export { runSeedCli } from './cli';

package/seeders/seed-config.d.ts

@@ -6,6 +6,7 @@ export interface ISeedConfig {
     respectSoftDelete: boolean;
 }
 export declare const seedConfig: ISeedConfig;
+export declare function configureSeedConfig(config: Partial<ISeedConfig>): void;
 export declare function getEntityCount(entityName: string, config?: ISeedConfig): number;
 export declare function shouldSkipEntity(entityName: string, config?: ISeedConfig): boolean;
 export declare function getSeedingOrder(availableEntities: string[], config?: ISeedConfig): string[];

package/seeders/seed-runner.d.ts

@@ -34,6 +34,7 @@ export declare class SeedRunner {
     registerCustomSeeder(entityName: string, seeder: BaseSeeder<any>): void;
     unregisterCustomSeeder(entityName: string): void;
     hasCustomSeeder(entityName: string): boolean;
+    private getSeeder;
     runAll(options?: ISeedOptions): Promise<ISeedResult[]>;
     runSingle(entityName: string, options?: ISeedOptions): Promise<ISeedResult>;
     clearAll(hard?: boolean, continueOnError?: boolean): Promise<ISeedResult[]>;

package/utils/datasource-config.builder.d.ts

@@ -9,5 +9,4 @@ export declare function getDatabaseForTenant(config: IMigrationConfig, tenantId?
     tenantConfig: ITenantDatabaseConfig;
 };
 export declare function resolveEntities(config: IMigrationConfig, tenantConfig?: ITenantDatabaseConfig): any[];
-export declare function buildTenantDatabaseConfig(baseConfig: IDatabaseConfig, tenant: ITenantDatabaseConfig): IDatabaseConfig;
 export declare function getActiveTenants(config: IMigrationConfig): ITenantDatabaseConfig[];

package/cjs/docs/docs.setup.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "setupSwaggerDocs", {
-    enumerable: true,
-    get: function() {
-        return setupSwaggerDocs;
-    }
-});
-const _docsconfig = require("./docs.config");
-function setupSwaggerDocs(app, ...modules) {
-    (0, _docsconfig.setupModuleSwaggerDocs)(app, modules);
-}

package/cjs/seeders/template-generator.js

@@ -1,297 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "TemplateGenerator", {
-    enumerable: true,
-    get: function() {
-        return TemplateGenerator;
-    }
-});
-const _fs = /*#__PURE__*/ _interop_require_wildcard(require("fs"));
-const _path = /*#__PURE__*/ _interop_require_wildcard(require("path"));
-function _getRequireWildcardCache(nodeInterop) {
-    if (typeof WeakMap !== "function") return null;
-    var cacheBabelInterop = new WeakMap();
-    var cacheNodeInterop = new WeakMap();
-    return (_getRequireWildcardCache = function(nodeInterop) {
-        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
-    })(nodeInterop);
-}
-function _interop_require_wildcard(obj, nodeInterop) {
-    if (!nodeInterop && obj && obj.__esModule) {
-        return obj;
-    }
-    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
-        return {
-            default: obj
-        };
-    }
-    var cache = _getRequireWildcardCache(nodeInterop);
-    if (cache && cache.has(obj)) {
-        return cache.get(obj);
-    }
-    var newObj = {
-        __proto__: null
-    };
-    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
-    for(var key in obj){
-        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
-            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
-            if (desc && (desc.get || desc.set)) {
-                Object.defineProperty(newObj, key, desc);
-            } else {
-                newObj[key] = obj[key];
-            }
-        }
-    }
-    newObj.default = obj;
-    if (cache) {
-        cache.set(obj, newObj);
-    }
-    return newObj;
-}
-let TemplateGenerator = class TemplateGenerator {
-    /**
-   * Generate seeder file for an entity
-   * @param entityInfo Entity metadata
-   * @param outputDir Output directory for seeder files
-   */ generateSeederFile(entityInfo, outputDir) {
-        const fileName = this.getSeederFileName(entityInfo.name);
-        const filePath = _path.join(outputDir, fileName);
-        const content = this.generateSeederContent(entityInfo);
-        // Ensure directory exists
-        if (!_fs.existsSync(outputDir)) {
-            _fs.mkdirSync(outputDir, {
-                recursive: true
-            });
-        }
-        // Write file
-        _fs.writeFileSync(filePath, content, 'utf-8');
-        return filePath;
-    }
-    /**
-   * Generate index file that exports all seeders
-   * @param entityInfos Array of entity metadata
-   * @param outputDir Output directory
-   */ generateIndexFile(entityInfos, outputDir) {
-        const indexPath = _path.join(outputDir, 'index.ts');
-        const exports1 = entityInfos.map((info)=>{
-            const className = this.getSeederClassName(info.name);
-            const fileName = this.getSeederFileName(info.name).replace('.ts', '');
-            return `export { ${className} } from './${fileName}';`;
-        }).join('\n');
-        _fs.writeFileSync(indexPath, exports1, 'utf-8');
-        return indexPath;
-    }
-    /**
-   * Generate seeder file content
-   */ generateSeederContent(entityInfo) {
-        const className = this.getSeederClassName(entityInfo.name);
-        const imports = this.generateImports(entityInfo);
-        const classContent = this.generateClass(entityInfo, className);
-        return `${imports}\n\n${classContent}\n`;
-    }
-    /**
-   * Generate import statements
-   */ generateImports(entityInfo) {
-        const imports = [
-            `import { DataSource } from 'typeorm';`,
-            `import { faker } from '@faker-js/faker';`,
-            `import { BaseSeeder } from '@flusys/nestjs-core/seeders/base-seeder';`
-        ];
-        // Add entity import (adjust path as needed)
-        const entityImportPath = this.getEntityImportPath(entityInfo.name);
-        imports.push(`import { ${entityInfo.name} } from '${entityImportPath}';`);
-        // Add relation imports
-        const relationEntities = new Set(entityInfo.relations.map((r)=>r.targetEntity));
-        for (const relEntity of relationEntities){
-            const relPath = this.getEntityImportPath(relEntity);
-            imports.push(`import { ${relEntity} } from '${relPath}';`);
-        }
-        return imports.join('\n');
-    }
-    /**
-   * Generate class content
-   */ generateClass(entityInfo, className) {
-        const generateMethod = this.generateGenerateMethod(entityInfo);
-        const relationMethod = this.generateRelationMethod(entityInfo);
-        return `
-/**
- * ${className}
- *
- * Seeder for ${entityInfo.name} entity.
- * Generates sample data for development/testing.
- */
-export class ${className} extends BaseSeeder<${entityInfo.name}> {
-  constructor(dataSource: DataSource) {
-    super(dataSource, ${entityInfo.name});
-  }
-
-${generateMethod}${relationMethod ? '\n\n' + relationMethod : ''}
-}`.trim();
-    }
-    /**
-   * Generate the generate() method
-   */ generateGenerateMethod(entityInfo) {
-        const fields = this.generateFieldAssignments(entityInfo.columns);
-        return `  /**
-   * Generate sample ${entityInfo.name} data
-   * @param count Number of records to generate
-   * @returns Array of created entities
-   */
-  async generate(count: number = 10): Promise<${entityInfo.name}[]> {
-    const entities: ${entityInfo.name}[] = [];
-
-    for (let i = 0; i < count; i++) {
-      const entity = this.repository.create({
-${fields}
-      });
-
-      entities.push(entity);
-    }
-
-    return this.repository.save(entities);
-  }`;
-    }
-    /**
-   * Generate field assignments for entity creation
-   */ generateFieldAssignments(columns) {
-        const assignments = [];
-        for (const column of columns){
-            // Skip system fields
-            if (this.isSystemField(column.propertyName)) {
-                continue;
-            }
-            // Skip foreign keys (handled in relations method)
-            if (column.propertyName.endsWith('Id')) {
-                continue;
-            }
-            const fakerCall = this.getFakerCall(column);
-            const comment = column.isNullable ? ' // Optional' : ' // Required';
-            assignments.push(`        ${column.propertyName}: ${fakerCall},${comment}`);
-        }
-        return assignments.join('\n');
-    }
-    /**
-   * Generate relation handling method if entity has relations
-   */ generateRelationMethod(entityInfo) {
-        const manyToOneRelations = entityInfo.relations.filter((r)=>r.type === 'many-to-one');
-        if (manyToOneRelations.length === 0) {
-            return null;
-        }
-        const relationParams = manyToOneRelations.map((r)=>`${r.propertyName}s: ${r.targetEntity}[]`).join(', ');
-        const relationAssignments = manyToOneRelations.map((r)=>{
-            return `      const random${r.targetEntity} = faker.helpers.arrayElement(${r.propertyName}s);
-      entity.${r.propertyName}Id = random${r.targetEntity}.id;`;
-        }).join('\n');
-        return `  /**
-   * Generate with related entities
-   * @param ${relationParams}
-   * @param count Number of records to generate
-   */
-  async generateWithRelations(${relationParams}, count: number = 10): Promise<${entityInfo.name}[]> {
-    const entities = await this.generate(count);
-
-    for (const entity of entities) {
-${relationAssignments}
-      await this.repository.save(entity);
-    }
-
-    return entities;
-  }`;
-    }
-    /**
-   * Get faker call for column based on its properties
-   */ getFakerCall(column) {
-        const nameLower = column.propertyName.toLowerCase();
-        // Name fields
-        if (nameLower.includes('firstname')) return 'faker.person.firstName()';
-        if (nameLower.includes('lastname')) return 'faker.person.lastName()';
-        if (nameLower === 'name' || nameLower.includes('fullname')) {
-            return 'faker.person.fullName()';
-        }
-        // Contact
-        if (nameLower.includes('email')) return 'faker.internet.email().toLowerCase()';
-        if (nameLower.includes('phone')) return 'faker.phone.number()';
-        // Text
-        if (nameLower.includes('description')) return 'faker.lorem.paragraph()';
-        if (nameLower.includes('content')) return 'faker.lorem.paragraphs(2)';
-        if (nameLower.includes('title')) return 'faker.lorem.sentence()';
-        // URL/Web
-        if (nameLower.includes('slug')) {
-            return "faker.helpers.slugify(faker.lorem.words(3)).toLowerCase()";
-        }
-        if (nameLower.includes('url')) return 'faker.internet.url()';
-        // Status
-        if (nameLower.includes('isactive') || nameLower.includes('isenabled')) {
-            return 'true';
-        }
-        // Type-based
-        const type = column.type.toLowerCase();
-        if (type.includes('bool')) return 'faker.datatype.boolean()';
-        if (type.includes('int') || type.includes('serial')) {
-            return 'faker.number.int({ min: 1, max: 1000 })';
-        }
-        if (type.includes('decimal') || type.includes('float') || type.includes('numeric')) {
-            return 'faker.number.float({ min: 0, max: 1000, precision: 0.01 })';
-        }
-        if (type.includes('date') || type.includes('timestamp')) {
-            return 'faker.date.recent({ days: 30 })';
-        }
-        if (type.includes('uuid')) return 'faker.string.uuid()';
-        if (type.includes('json')) return '{ key: faker.lorem.word() }';
-        // Default string
-        const maxLength = typeof column.length === 'number' ? column.length : 255;
-        if (maxLength <= 50) {
-            return 'faker.lorem.word()';
-        } else if (maxLength <= 255) {
-            return 'faker.lorem.sentence()';
-        } else {
-            return 'faker.lorem.paragraph()';
-        }
-    }
-    /**
-   * Check if field is a system field (should be skipped)
-   */ isSystemField(fieldName) {
-        const systemFields = [
-            'id',
-            'createdAt',
-            'updatedAt',
-            'deletedAt',
-            'createdById',
-            'updatedById',
-            'deletedById'
-        ];
-        return systemFields.includes(fieldName);
-    }
-    /**
-   * Get seeder class name from entity name
-   */ getSeederClassName(entityName) {
-        return `${entityName}Seeder`;
-    }
-    /**
-   * Get seeder file name from entity name
-   */ getSeederFileName(entityName) {
-        const kebab = entityName.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
-        return `${kebab}.seeder.ts`;
-    }
-    /**
-   * Get entity import path (adjust based on project structure)
-   */ getEntityImportPath(entityName) {
-        // Try to determine module from entity name
-        // This is a simplified approach - adjust based on actual project structure
-        const nameLower = entityName.toLowerCase();
-        if (nameLower.includes('user') || nameLower.includes('company') || nameLower.includes('branch')) {
-            return `@flusys/nestjs-auth/entities`;
-        }
-        if (nameLower.includes('role') || nameLower.includes('permission') || nameLower.includes('action') || nameLower.includes('menu')) {
-            return `@flusys/nestjs-iam/entities`;
-        }
-        if (nameLower.includes('file') || nameLower.includes('folder') || nameLower.includes('storage')) {
-            return `@flusys/nestjs-storage/entities`;
-        }
-        // Default fallback
-        return `@flusys/nestjs-shared/entities`;
-    }
-};

package/docs/docs.setup.d.ts

@@ -1,3 +0,0 @@
-import { INestApplication } from '@nestjs/common';
-import { IModuleSwaggerOptions } from './docs.config';
-export declare function setupSwaggerDocs(app: INestApplication, ...modules: IModuleSwaggerOptions[]): void;

package/fesm/docs/docs.setup.js

@@ -1,4 +0,0 @@
-import { setupModuleSwaggerDocs } from './docs.config';
-export function setupSwaggerDocs(app, ...modules) {
-    setupModuleSwaggerDocs(app, modules);
-}