@flusys/nestjs-core 1.0.0-beta → 1.0.0-rc

package/README.md

@@ -1,7 +1,7 @@
 # Core Package Guide
 
 > **Package:** `@flusys/nestjs-core`
-> **Type:** Pure TypeScript utilities (Zero NestJS dependencies)
+> **Type:** Foundation utilities for configuration, database, migrations, and seeders
 
 Foundation layer providing type-safe configuration, database utilities, migration CLI, seeders, and Swagger setup.
 
@@ -15,7 +15,7 @@ nestjs-core/src/
 │   └── database.constants.ts    # MODULE_OPTIONS, DEFAULT_TENANT_HEADER
 ├── interfaces/
 │   ├── app-config.interfaces.ts # IBootstrapAppConfig, IDynamicModuleConfig
-│   ├── base-entity.interface.ts # IBaseEntity, ISoftDeletable, ITimestampable
+│   ├── base-entity.interface.ts # IBaseEntity, ISoftDeletable, ITimestampable, IOrderable, IMetadata, ICompanyOwned
 │   ├── database.interface.ts    # IDatabaseConfig, ITenantDatabaseConfig
 │   └── migration.interface.ts   # IMigrationConfig, IMigrationResult
 ├── utils/
@@ -74,6 +74,14 @@ interface IBootstrapAppConfig {
   enableCompanyFeature: boolean;
   permissionMode?: 'FULL' | 'RBAC' | 'DIRECT';
 }
+
+interface ICompanyOwned {
+  companyId?: string | null;
+}
+
+interface IMetadata {
+  metadata?: Record<string, any> | null;
+}
 ```
 
 ## Migration CLI
@@ -100,6 +108,23 @@ npm run seed:clear
 npm run seed:status
 ```
 
+### Seed Configuration
+
+```typescript
+import { configureSeedConfig, seedConfig } from '@flusys/nestjs-core/seeders';
+
+// Configure before running seeders
+configureSeedConfig({
+  counts: { User: 50, Product: 100 },
+  order: ['User', 'Product', 'Order'],
+  skipEntities: ['migrations', 'typeorm_metadata'],
+  locale: 'en',
+  respectSoftDelete: true,
+});
+```
+
+### Custom Seeders
+
 ```typescript
 import { BaseSeeder, SeedRunner } from '@flusys/nestjs-core/seeders';
 
@@ -124,6 +149,10 @@ await runner.runAll({ count: 50, clear: true });
 ```typescript
 import { setupSwaggerDocs, setupModuleSwaggerDocs } from '@flusys/nestjs-core/docs';
 
+// Variadic API for multiple configs
+setupSwaggerDocs(app, authConfig, adminConfig);
+
+// Array API for module docs
 setupModuleSwaggerDocs(app, [
   { title: 'Auth API', path: 'auth/docs', bearerAuth: true },
   { title: 'Admin API', path: 'admin/docs', excludeTags: ['public'] },
@@ -150,7 +179,7 @@ import {
   IDatabaseConfig, ITenantDatabaseConfig, IBootstrapAppConfig,
   IDynamicModuleConfig, IDataSourceServiceOptions,
   IMigrationConfig, IMigrationResult,
-  IBaseEntity, ISoftDeletable, ITimestampable, IOrderable,
+  IBaseEntity, ISoftDeletable, ITimestampable, IOrderable, ICompanyOwned, IMetadata,
 } from '@flusys/nestjs-core';
 
 // Constants
@@ -161,26 +190,31 @@ import { envConfig } from '@flusys/nestjs-core/config';
 
 // Utils
 import {
-  buildDataSourceOptions, getDatabaseForTenant,
-  resolveEntities, getActiveTenants,
+  buildDataSourceOptions, getDatabaseForTenant, resolveEntities,
+  getActiveTenants, getMigrationsFolderPath, getMigrationsGlobPattern,
 } from '@flusys/nestjs-core/utils';
 
 // Migration
 import {
   createMigrationDataSource, initializeDataSource, runMigrationCli,
   generateMigration, runMigrations, revertMigration, migrationStatus,
+  runForAllTenants, ensureMigrationsFolder,
 } from '@flusys/nestjs-core/migration';
 
 // Seeders
 import {
-  BaseSeeder, SeedRunner, EntityReader, DataGenerator,
-  seedConfig, runSeedCli,
+  BaseSeeder, SeedRunner, EntityReader, DataGenerator, TemplateGenerator,
+  seedConfig, ISeedConfig, configureSeedConfig, runSeedCli,
+  getEntityCount, shouldSkipEntity, getSeedingOrder,
+  ISeedResult, ISeedOptions, ISeederLogger, defaultLogger,
+  IEntityInfo, IColumnInfo, IRelationInfo,
 } from '@flusys/nestjs-core/seeders';
 
 // Swagger
 import {
   setupSwaggerDocs, setupModuleSwaggerDocs,
   IModuleSwaggerOptions, ISchemaPropertyExclusion,
+  IQueryParameterExclusion, ISwaggerGlobalHeader,
 } from '@flusys/nestjs-core/docs';
 ```
 
@@ -189,5 +223,8 @@ import {
 - `dotenv` - Environment variable loading
 - `typeorm` - Migration/seeder utilities
 - `@faker-js/faker` - Seed data generation
+- `@nestjs/common`, `@nestjs/swagger` - Swagger documentation setup only
+
+---
 
-**No NestJS dependencies** - Can be used in any TypeScript project.
+**Last Updated:** 2026-02-18

package/cjs/config/env-config.service.js

@@ -85,7 +85,7 @@ let EnvConfigService = class EnvConfigService {
         return this.getValue(key, throwOnMissing).toLowerCase() === 'true';
     }
     getPort() {
-        return this.getNumber('PORT', false);
+        return this.getNumber('PORT', false) || 3000;
     }
     isProduction() {
         return this.getValue('MODE', false).toUpperCase() !== 'DEV';

package/cjs/interfaces/base-entity.interface.js

@@ -1,7 +1,9 @@
 /**
- * Base Entity Interface
- * All entities should implement this for consistency
- */ "use strict";
+ * Entity Contract Interfaces
+ *
+ * These interfaces define the standard fields that entities should have.
+ * Use them as contracts when implementing new entities.
+ */ /** Base entity with UUID, timestamps, and soft delete */ "use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });

package/cjs/interfaces/database.interface.js

@@ -1,6 +1,4 @@
-/**
- * Supported database types
- */ "use strict";
+"use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });

package/cjs/migration/datasource.factory.js

@@ -22,10 +22,9 @@ const _datasourceconfigbuilder = require("../utils/datasource-config.builder");
 function createMigrationDataSource(options) {
     const { config, tenantId } = options;
     const { database, tenant, tenantConfig } = (0, _datasourceconfigbuilder.getDatabaseForTenant)(config, tenantId);
-    // Log target info
     console.log(`\n📦 Database: ${database}${tenant ? ` [${tenant.name}]` : ' [default]'}`);
     console.log(`📁 Migrations: migrations/${tenantId || 'default'}/`);
-    if (config.bootstrapAppConfig?.databaseMode == 'multi-tenant' && !tenantId && config.tenants && config.tenants.length > 0) {
+    if (config.bootstrapAppConfig?.databaseMode === 'multi-tenant' && !tenantId && config.tenants && config.tenants.length > 0) {
         console.log(`\n💡 Multi-tenant mode. Available tenants:`);
         config.tenants.forEach((t)=>console.log(`   - TENANT_ID=${t.id} → ${t.database}`));
     }
@@ -40,7 +39,6 @@ function createMigrationDataSource(options) {
         ...config.defaultDatabaseConfig,
         database
     };
-    // Resolve entities based on tenant config
     const entities = (0, _datasourceconfigbuilder.resolveEntities)(config, tenantConfig);
     const dsOptions = (0, _datasourceconfigbuilder.buildDataSourceOptions)(dbConfig, entities, (0, _datasourceconfigbuilder.getMigrationsGlobPattern)(config.migrationsPath, tenantId), config.migrationsTableName);
     return new _typeorm.DataSource({

package/cjs/migration/index.js

@@ -1,15 +1,3 @@
-/**
- * Migration Module Exports
- *
- * Public API for TypeORM migration management in single and multi-tenant databases.
- *
- * Main exports:
- * - createMigrationDataSource: Create DataSource for migrations
- * - initializeDataSource: Create and initialize DataSource
- * - runMigrationCli: Programmatic CLI execution
- *
- * The CLI entry point is at ./cli.ts (used by npm scripts)
- */ // DataSource factory for migration config files
 "use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true

package/cjs/migration/migration.cli.js

@@ -53,23 +53,7 @@ function _interop_require_wildcard(obj, nodeInterop) {
     }
     return newObj;
 }
-/**
- * Migration CLI Service
- *
- * Handles migration command execution for single and multi-tenant databases.
- *
- * Commands:
- * - generate: Create new migration
- * - run: Execute pending migrations
- * - revert: Rollback last migration
- * - status: Check migration status
- * - run:all/revert:all/status:all: Batch operations for all tenants
- *
- * Configuration:
- * - TENANT_ID: Target tenant (optional, defaults to default database)
- * - --config=<path>: Migration config file path
- * - --datasource=<path>: DataSource file path for TypeORM CLI
- */ function showHelp() {
+function showHelp() {
     console.log(`
 Migration CLI
 

package/cjs/seeders/base-seeder.js

@@ -22,25 +22,15 @@ function _define_property(obj, key, value) {
     return obj;
 }
 let BaseSeeder = class BaseSeeder {
-    /**
-   * Clear all records from the entity table
-   * Respects soft delete if entity has deletedAt column
-   * @param hard If true, perform hard delete (ignore soft delete)
-   */ async clear(hard = false) {
+    async clear(hard = false) {
         const hasSoftDelete = this.metadata.deleteDateColumn !== undefined;
         if (hard || !hasSoftDelete) {
-            // Hard delete - remove all records
             await this.repository.clear();
         } else {
-            // Soft delete - set deletedAt
             await this.repository.createQueryBuilder().softDelete().where('id IS NOT NULL').execute();
         }
     }
-    /**
-   * Get count of existing records
-   * @param includeDeleted If true, count soft-deleted records
-   * @returns Total record count
-   */ async count(includeDeleted = false) {
+    async count(includeDeleted = false) {
         const hasSoftDelete = this.metadata.deleteDateColumn !== undefined;
         if (hasSoftDelete && !includeDeleted) {
             return this.repository.count({
@@ -51,22 +41,13 @@ let BaseSeeder = class BaseSeeder {
         }
         return this.repository.count();
     }
-    /**
-   * Check if entity has any records
-   * @returns True if no records exist
-   */ async isEmpty() {
-        const total = await this.count();
-        return total === 0;
+    async isEmpty() {
+        return await this.count() === 0;
     }
-    /**
-   * Get entity name for logging
-   */ getEntityName() {
+    getEntityName() {
         return this.metadata.tableName;
     }
-    /**
-   * Wrap operation in transaction
-   * @param operation Function to execute in transaction
-   */ async withTransaction(operation) {
+    async withTransaction(operation) {
         const queryRunner = this.dataSource.createQueryRunner();
         await queryRunner.connect();
         await queryRunner.startTransaction();

package/cjs/seeders/data-generator.js

@@ -240,8 +240,10 @@ let DataGenerator = class DataGenerator {
         return selected.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/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
 });
@@ -49,6 +45,9 @@ _export(exports, {
     get TemplateGenerator () {
         return _templategenerator.TemplateGenerator;
     },
+    get configureSeedConfig () {
+        return _seedconfig.configureSeedConfig;
+    },
     get defaultLogger () {
         return _seedrunner.defaultLogger;
     },

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);

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

@@ -12,9 +12,6 @@ _export(exports, {
     get buildDataSourceOptions () {
         return buildDataSourceOptions;
     },
-    get buildTenantDatabaseConfig () {
-        return buildTenantDatabaseConfig;
-    },
     get getActiveTenants () {
         return getActiveTenants;
     },
@@ -70,7 +67,8 @@ function getDatabaseForTenant(config, tenantId) {
     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,
@@ -83,16 +81,6 @@ function resolveEntities(config, tenantConfig) {
     }
     return config.entities;
 }
-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
-    };
-}
 function getActiveTenants(config) {
     return config.tenants || [];
 }

package/fesm/config/env-config.service.js

@@ -34,7 +34,7 @@ let EnvConfigService = class EnvConfigService {
         return this.getValue(key, throwOnMissing).toLowerCase() === 'true';
     }
     getPort() {
-        return this.getNumber('PORT', false);
+        return this.getNumber('PORT', false) || 3000;
     }
     isProduction() {
         return this.getValue('MODE', false).toUpperCase() !== 'DEV';

package/fesm/interfaces/app-config.interfaces.js

@@ -1,3 +1 @@
-/**
- * Async module options - common pattern for NestJS async module registration
- */ export { };
+/** Async module options pattern */ export { };

package/fesm/interfaces/base-entity.interface.js

@@ -1,6 +1,6 @@
 /**
- * Base Entity Interface
- * All entities should implement this for consistency
- */ /**
- * Entity with metadata
- */ export { };
+ * Entity Contract Interfaces
+ *
+ * These interfaces define the standard fields that entities should have.
+ * Use them as contracts when implementing new entities.
+ */ /** Base entity with UUID, timestamps, and soft delete */ /** Entity with company relation (for multi-company support) */ export { };

package/fesm/interfaces/database.interface.js

@@ -1,5 +1 @@
-/**
- * Supported database types
- */ /**
- * DataSource build options for TypeORM
- */ export { };
+export { };

package/fesm/migration/cli.js

@@ -1,24 +1,5 @@
 #!/usr/bin/env node
-/**
- * Migration CLI Entry Point
- *
- * Main executable for running TypeORM migrations via npm scripts.
- *
- * Usage (via package.json scripts):
- * - npm run migration generate --name=CreateUsers
- * - npm run migration run
- * - npm run migration revert
- * - npm run migration status
- * - npm run migration run:all (multi-tenant)
- * - npm run migration revert:all (multi-tenant)
- * - npm run migration status:all (multi-tenant)
- *
- * Environment Variables:
- * - TENANT_ID: Target specific tenant (optional)
- *
- * This file is the executable entry point referenced in package.json.
- * The actual CLI logic is in migration.cli.ts (runMigrationCli function).
- */ import { runMigrationCli } from './migration.cli';
+import { runMigrationCli } from './migration.cli';
 runMigrationCli().catch((err)=>{
     console.error('CLI Error:', err.message);
     process.exit(1);

package/fesm/migration/datasource.factory.js

@@ -1,20 +1,12 @@
 import { DataSource } from 'typeorm';
 import { SnakeNamingStrategy } from 'typeorm-naming-strategies';
 import { buildDataSourceOptions, getDatabaseForTenant, getMigrationsGlobPattern, resolveEntities } from '../utils/datasource-config.builder';
-/**
- * Create a DataSource for migrations
- *
- * @param options - Configuration options
- * @param options.config - Migration configuration
- * @param options.tenantId - Optional tenant ID for multi-tenant mode
- * @returns DataSource instance (not initialized)
- */ export function createMigrationDataSource(options) {
+export function createMigrationDataSource(options) {
     const { config, tenantId } = options;
     const { database, tenant, tenantConfig } = getDatabaseForTenant(config, tenantId);
-    // Log target info
     console.log(`\n📦 Database: ${database}${tenant ? ` [${tenant.name}]` : ' [default]'}`);
     console.log(`📁 Migrations: migrations/${tenantId || 'default'}/`);
-    if (config.bootstrapAppConfig?.databaseMode == 'multi-tenant' && !tenantId && config.tenants && config.tenants.length > 0) {
+    if (config.bootstrapAppConfig?.databaseMode === 'multi-tenant' && !tenantId && config.tenants && config.tenants.length > 0) {
         console.log(`\n💡 Multi-tenant mode. Available tenants:`);
         config.tenants.forEach((t)=>console.log(`   - TENANT_ID=${t.id} → ${t.database}`));
     }
@@ -29,7 +21,6 @@ import { buildDataSourceOptions, getDatabaseForTenant, getMigrationsGlobPattern,
         ...config.defaultDatabaseConfig,
         database
     };
-    // Resolve entities based on tenant config
     const entities = resolveEntities(config, tenantConfig);
     const dsOptions = buildDataSourceOptions(dbConfig, entities, getMigrationsGlobPattern(config.migrationsPath, tenantId), config.migrationsTableName);
     return new DataSource({
@@ -37,15 +28,7 @@ import { buildDataSourceOptions, getDatabaseForTenant, getMigrationsGlobPattern,
         namingStrategy: new SnakeNamingStrategy()
     });
 }
-/**
- * Initialize and return a DataSource
- *
- * Creates a DataSource and initializes the connection.
- * The connection should be destroyed after use with `ds.destroy()`.
- *
- * @param options - Configuration options
- * @returns Initialized DataSource instance
- */ export async function initializeDataSource(options) {
+export async function initializeDataSource(options) {
     const ds = createMigrationDataSource(options);
     await ds.initialize();
     return ds;

package/fesm/migration/index.js

@@ -1,17 +1,3 @@
-/**
- * Migration Module Exports
- *
- * Public API for TypeORM migration management in single and multi-tenant databases.
- *
- * Main exports:
- * - createMigrationDataSource: Create DataSource for migrations
- * - initializeDataSource: Create and initialize DataSource
- * - runMigrationCli: Programmatic CLI execution
- *
- * The CLI entry point is at ./cli.ts (used by npm scripts)
- */ // DataSource factory for migration config files
 export { createMigrationDataSource, initializeDataSource } from './datasource.factory';
-// CLI service for programmatic usage
 export { runMigrationCli } from './migration.cli';
-// Migration runner functions (optional, for advanced usage)
 export { generateMigration, runMigrations, revertMigration, migrationStatus, runForAllTenants, ensureMigrationsFolder } from './migration.runner';

package/fesm/migration/migration.cli.js

@@ -2,23 +2,7 @@ import * as path from 'path';
 import { envConfig } from '../config';
 import { getDatabaseForTenant, getMigrationsFolderPath } from '../utils';
 import { generateMigration, migrationStatus, revertMigration, runForAllTenants, runMigrations } from './migration.runner';
-/**
- * Migration CLI Service
- *
- * Handles migration command execution for single and multi-tenant databases.
- *
- * Commands:
- * - generate: Create new migration
- * - run: Execute pending migrations
- * - revert: Rollback last migration
- * - status: Check migration status
- * - run:all/revert:all/status:all: Batch operations for all tenants
- *
- * Configuration:
- * - TENANT_ID: Target tenant (optional, defaults to default database)
- * - --config=<path>: Migration config file path
- * - --datasource=<path>: DataSource file path for TypeORM CLI
- */ function showHelp() {
+function showHelp() {
     console.log(`
 Migration CLI
 

package/fesm/migration/migration.runner.js

@@ -4,26 +4,7 @@ import * as path from 'path';
 import { envConfig } from '../config';
 import { getActiveTenants, getDatabaseForTenant, getMigrationsFolderPath } from '../utils';
 import { initializeDataSource } from './datasource.factory';
-/**
- * Migration Runner Functions
- *
- * Core functions for executing migration operations.
- * Supports both single and multi-tenant database configurations.
- *
- * Functions:
- * - ensureMigrationsFolder: Create migrations directory
- * - generateMigration: Create new migration file
- * - runMigrations: Execute pending migrations
- * - revertMigration: Rollback last migration
- * - migrationStatus: Check migration status
- * - runForAllTenants: Batch operations for all tenants
- */ /**
- * Ensure migrations folder exists
- *
- * @param basePath - Base migrations path
- * @param tenantId - Optional tenant ID
- * @returns Full path to migrations folder
- */ export function ensureMigrationsFolder(basePath, tenantId) {
+export function ensureMigrationsFolder(basePath, tenantId) {
     const folder = getMigrationsFolderPath(basePath, tenantId);
     if (!fs.existsSync(folder)) {
         fs.mkdirSync(folder, {
@@ -33,16 +14,7 @@ import { initializeDataSource } from './datasource.factory';
     }
     return folder;
 }
-/**
- * Generate a new migration file
- *
- * Uses TypeORM CLI to generate migration based on entity changes.
- *
- * @param config - Migration configuration
- * @param name - Migration name (e.g., "CreateUsers")
- * @param tenantId - Optional tenant ID for multi-tenant mode
- * @param datasourcePath - Optional path to datasource file
- */ export async function generateMigration(config, name, tenantId, datasourcePath) {
+export async function generateMigration(config, name, tenantId, datasourcePath) {
     const label = tenantId ? `[${tenantId}]` : '[default]';
     const folder = ensureMigrationsFolder(config.migrationsPath, tenantId);
     console.log(`${label} Generating migration: ${name}`);
@@ -72,15 +44,7 @@ function findDatasourcePath() {
     }
     throw new Error('Could not find datasource file. Specify with --datasource=<path>');
 }
-/**
- * Run pending migrations
- *
- * Executes all pending migrations for the specified tenant or default database.
- *
- * @param config - Migration configuration
- * @param tenantId - Optional tenant ID for multi-tenant mode
- * @returns Migration result with success status
- */ export async function runMigrations(config, tenantId) {
+export async function runMigrations(config, tenantId) {
     const { database } = getDatabaseForTenant(config, tenantId);
     const label = tenantId ? `[${tenantId}]` : '[default]';
     try {
@@ -113,15 +77,7 @@ function findDatasourcePath() {
         };
     }
 }
-/**
- * Revert last migration
- *
- * Rolls back the most recently executed migration.
- *
- * @param config - Migration configuration
- * @param tenantId - Optional tenant ID for multi-tenant mode
- * @returns Migration result with success status
- */ export async function revertMigration(config, tenantId) {
+export async function revertMigration(config, tenantId) {
     const { database } = getDatabaseForTenant(config, tenantId);
     const label = tenantId ? `[${tenantId}]` : '[default]';
     try {
@@ -148,15 +104,7 @@ function findDatasourcePath() {
         };
     }
 }
-/**
- * Check migration status
- *
- * Shows whether there are pending migrations to run.
- *
- * @param config - Migration configuration
- * @param tenantId - Optional tenant ID for multi-tenant mode
- * @returns Migration result with status information
- */ export async function migrationStatus(config, tenantId) {
+export async function migrationStatus(config, tenantId) {
     const { database } = getDatabaseForTenant(config, tenantId);
     const label = tenantId ? `[${tenantId}]` : '[default]';
     try {
@@ -186,16 +134,7 @@ function findDatasourcePath() {
         };
     }
 }
-/**
- * Run migration command for all tenants
- *
- * Executes the specified command for all active tenants in batch mode.
- * Only works in multi-tenant database mode.
- *
- * @param config - Migration configuration
- * @param command - Command to run: 'run', 'revert', or 'status'
- * @returns Array of migration results for each tenant
- */ export async function runForAllTenants(config, command) {
+export async function runForAllTenants(config, command) {
     const tenants = getActiveTenants(config);
     console.log(`\n🔄 Running '${command}' for ${tenants.length} tenant(s)...\n`);
     const results = [];

package/fesm/seeders/base-seeder.js

@@ -11,51 +11,16 @@ function _define_property(obj, key, value) {
     }
     return obj;
 }
-/**
- * Base Seeder Class
- *
- * Abstract base class for all entity seeders.
- * Provides common methods for data generation, clearing, and counting.
- *
- * Usage:
- * ```typescript
- * export class UserSeeder extends BaseSeeder<User> {
- *   constructor(dataSource: DataSource) {
- *     super(dataSource, User);
- *   }
- *
- *   async generate(count: number): Promise<User[]> {
- *     const users: User[] = [];
- *     for (let i = 0; i < count; i++) {
- *       users.push(this.repository.create({
- *         name: faker.person.fullName(),
- *         email: faker.internet.email(),
- *       }));
- *     }
- *     return this.repository.save(users);
- *   }
- * }
- * ```
- */ export class BaseSeeder {
-    /**
-   * Clear all records from the entity table
-   * Respects soft delete if entity has deletedAt column
-   * @param hard If true, perform hard delete (ignore soft delete)
-   */ async clear(hard = false) {
+export class BaseSeeder {
+    async clear(hard = false) {
         const hasSoftDelete = this.metadata.deleteDateColumn !== undefined;
         if (hard || !hasSoftDelete) {
-            // Hard delete - remove all records
             await this.repository.clear();
         } else {
-            // Soft delete - set deletedAt
             await this.repository.createQueryBuilder().softDelete().where('id IS NOT NULL').execute();
         }
     }
-    /**
-   * Get count of existing records
-   * @param includeDeleted If true, count soft-deleted records
-   * @returns Total record count
-   */ async count(includeDeleted = false) {
+    async count(includeDeleted = false) {
         const hasSoftDelete = this.metadata.deleteDateColumn !== undefined;
         if (hasSoftDelete && !includeDeleted) {
             return this.repository.count({
@@ -66,22 +31,13 @@ function _define_property(obj, key, value) {
         }
         return this.repository.count();
     }
-    /**
-   * Check if entity has any records
-   * @returns True if no records exist
-   */ async isEmpty() {
-        const total = await this.count();
-        return total === 0;
+    async isEmpty() {
+        return await this.count() === 0;
     }
-    /**
-   * Get entity name for logging
-   */ getEntityName() {
+    getEntityName() {
         return this.metadata.tableName;
     }
-    /**
-   * Wrap operation in transaction
-   * @param operation Function to execute in transaction
-   */ async withTransaction(operation) {
+    async withTransaction(operation) {
         const queryRunner = this.dataSource.createQueryRunner();
         await queryRunner.connect();
         await queryRunner.startTransaction();

package/fesm/seeders/data-generator.js

@@ -242,8 +242,10 @@ import { faker } from '@faker-js/faker';
         return selected.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.setDefaultRefDate(new Date());
+        if (locale !== 'en') {
+            // @ts-expect-error - faker locale property access
+            faker.locale = locale;
+        }
     }
 }

package/fesm/seeders/entity-reader.js

@@ -55,23 +55,6 @@ function _define_property(obj, key, value) {
         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/fesm/seeders/index.js

@@ -1,11 +1,7 @@
-/**
- * Seed System Exports
- *
- * Public API for seed data generation system.
- */ export { BaseSeeder } from './base-seeder';
+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 { seedConfig, ISeedConfig, getEntityCount, shouldSkipEntity, getSeedingOrder, configureSeedConfig } from './seed-config';
 export { runSeedCli } from './cli';

package/fesm/seeders/seed-config.js

@@ -1,81 +1,31 @@
-/**
- * Seed Configuration
- *
- * Configuration for seed data generation.
- * Customize record counts, seeding order, and behavior.
- */ /**
- * Default seed configuration
- */ export 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)
+export const seedConfig = {
+    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
 };
-/**
- * Get count for entity (with default fallback)
- */ export function getEntityCount(entityName, config = seedConfig) {
+export function configureSeedConfig(config) {
+    Object.assign(seedConfig, config);
+}
+export function getEntityCount(entityName, config = seedConfig) {
     return config.counts[entityName] || 10;
 }
-/**
- * Check if entity should be skipped
- */ export function shouldSkipEntity(entityName, config = seedConfig) {
+export function shouldSkipEntity(entityName, config = seedConfig) {
     return config.skipEntities.some((skip)=>skip.toLowerCase() === entityName.toLowerCase());
 }
-/**
- * Get seeding order for entities
- */ export function getSeedingOrder(availableEntities, config = seedConfig) {
+export 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);

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-rc",
   "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/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/index.d.ts

@@ -2,6 +2,6 @@ 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 { 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/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[];