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

package/fesm/migration/migration.runner.js

@@ -4,26 +4,37 @@ 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) {
+function getLabel(tenantId) {
+    return tenantId ? `[${tenantId}]` : '[default]';
+}
+async function withDataSource(config, tenantId, operation) {
+    const { database } = getDatabaseForTenant(config, tenantId);
+    const label = getLabel(tenantId);
+    try {
+        const ds = await initializeDataSource({
+            config,
+            tenantId
+        });
+        const partial = await operation(ds, label);
+        await ds.destroy();
+        return {
+            tenantId,
+            database,
+            success: true,
+            ...partial
+        };
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`${label} ✗ Failed: ${errorMessage}`);
+        return {
+            tenantId,
+            database,
+            success: false,
+            error: errorMessage
+        };
+    }
+}
+export function ensureMigrationsFolder(basePath, tenantId) {
     const folder = getMigrationsFolderPath(basePath, tenantId);
     if (!fs.existsSync(folder)) {
         fs.mkdirSync(folder, {
@@ -33,16 +44,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,24 +74,9 @@ 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) {
-    const { database } = getDatabaseForTenant(config, tenantId);
-    const label = tenantId ? `[${tenantId}]` : '[default]';
-    try {
-        const ds = await initializeDataSource({
-            config,
-            tenantId
-        });
+export async function runMigrations(config, tenantId) {
+    return withDataSource(config, tenantId, async (ds, label)=>{
         const migrations = await ds.runMigrations();
-        await ds.destroy();
         if (migrations.length === 0) {
             console.log(`${label} No pending migrations.`);
         } else {
@@ -97,105 +84,29 @@ function findDatasourcePath() {
             migrations.forEach((m)=>console.log(`   - ${m.name}`));
         }
         return {
-            tenantId,
-            database,
-            success: true,
             migrationsRun: migrations.map((m)=>m.name)
         };
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        console.error(`${label} ✗ Failed: ${errorMessage}`);
-        return {
-            tenantId,
-            database,
-            success: false,
-            error: errorMessage
-        };
-    }
+    });
 }
-/**
- * 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) {
-    const { database } = getDatabaseForTenant(config, tenantId);
-    const label = tenantId ? `[${tenantId}]` : '[default]';
-    try {
-        const ds = await initializeDataSource({
-            config,
-            tenantId
-        });
+export async function revertMigration(config, tenantId) {
+    return withDataSource(config, tenantId, async (ds, label)=>{
         await ds.undoLastMigration();
-        await ds.destroy();
         console.log(`${label} ✓ Reverted!`);
-        return {
-            tenantId,
-            database,
-            success: true
-        };
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        console.error(`${label} ✗ Failed: ${errorMessage}`);
-        return {
-            tenantId,
-            database,
-            success: false,
-            error: errorMessage
-        };
-    }
+        return {};
+    });
 }
-/**
- * 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) {
-    const { database } = getDatabaseForTenant(config, tenantId);
-    const label = tenantId ? `[${tenantId}]` : '[default]';
-    try {
-        const ds = await initializeDataSource({
-            config,
-            tenantId
-        });
+export async function migrationStatus(config, tenantId) {
+    return withDataSource(config, tenantId, async (ds, label)=>{
         const hasPending = await ds.showMigrations();
-        await ds.destroy();
         console.log(`${label} Pending: ${hasPending ? 'Yes' : 'No'}`);
         return {
-            tenantId,
-            database,
-            success: true,
             migrationsRun: [
                 hasPending ? 'Has pending' : 'Up to date'
             ]
         };
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        console.error(`${label} ✗ Failed: ${errorMessage}`);
-        return {
-            tenantId,
-            database,
-            success: false,
-            error: errorMessage
-        };
-    }
+    });
 }
-/**
- * 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/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/index.d.ts

@@ -2,5 +2,4 @@ export * from './interfaces';
 export * from './constants';
 export * from './utils';
 export * from './migration';
-export * from './seeders';
 export * from './config';

package/interfaces/app-config.interfaces.d.ts

@@ -3,6 +3,7 @@ export interface IBootstrapAppConfig {
     databaseMode: DatabaseMode;
     enableCompanyFeature: boolean;
     permissionMode?: 'FULL' | 'RBAC' | 'DIRECT';
+    enableEmailVerification?: boolean;
 }
 export interface IDynamicModuleConfig {
     global?: boolean;

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

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

package/interfaces/database.interface.d.ts

@@ -17,6 +17,7 @@ export interface ITenantDatabaseConfig {
     password?: string;
     database: string;
     enableCompanyFeature?: boolean;
+    enableEmailVerification?: boolean;
     permissionMode?: 'FULL' | 'RBAC' | 'DIRECT';
 }
 export interface IDataSourceBuildOptions {
@@ -30,5 +31,5 @@ export interface IDataSourceBuildOptions {
     migrations: string[];
     migrationsTableName: string;
     synchronize: boolean;
-    namingStrategy?: any;
+    namingStrategy?: unknown;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-core",
-  "version": "1.1.0-beta",
+  "version": "1.2.0-rc.1",
   "description": "Core types, interfaces, and constants for Flusys NestJS packages",
   "main": "cjs/index.js",
   "module": "fesm/index.js",
@@ -61,15 +61,15 @@
     }
   },
   "peerDependencies": {
-    "@faker-js/faker": "^9.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",
-    "@nestjs/swagger": "^7.0.0 || ^11.0.0",
-    "@nestjs/typeorm": "^10.0.0 || ^11.0.0",
-    "dotenv": "^16.0.0",
+    "@faker-js/faker": "^10.0.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/config": "^4.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/swagger": "^11.0.0",
+    "@nestjs/typeorm": "^11.0.0",
+    "dotenv": "^17.0.0",
     "typeorm": "^0.3.0",
-    "typeorm-naming-strategies": "^4.0.0"
+    "typeorm-naming-strategies": "^4.1.0"
   },
   "dependencies": {}
 }

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/base-seeder.js

@@ -1,95 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "BaseSeeder", {
-    enumerable: true,
-    get: function() {
-        return BaseSeeder;
-    }
-});
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-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) {
-        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) {
-        const hasSoftDelete = this.metadata.deleteDateColumn !== undefined;
-        if (hasSoftDelete && !includeDeleted) {
-            return this.repository.count({
-                where: {
-                    deletedAt: null
-                }
-            });
-        }
-        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;
-    }
-    /**
-   * Get entity name for logging
-   */ getEntityName() {
-        return this.metadata.tableName;
-    }
-    /**
-   * Wrap operation in transaction
-   * @param operation Function to execute in transaction
-   */ async withTransaction(operation) {
-        const queryRunner = this.dataSource.createQueryRunner();
-        await queryRunner.connect();
-        await queryRunner.startTransaction();
-        try {
-            const transactionalRepo = queryRunner.manager.getRepository(this.entity);
-            const result = await operation(transactionalRepo);
-            await queryRunner.commitTransaction();
-            return result;
-        } catch (error) {
-            await queryRunner.rollbackTransaction();
-            throw error;
-        } finally{
-            await queryRunner.release();
-        }
-    }
-    constructor(dataSource, entity){
-        _define_property(this, "dataSource", void 0);
-        _define_property(this, "entity", void 0);
-        _define_property(this, "repository", void 0);
-        _define_property(this, "metadata", void 0);
-        this.dataSource = dataSource;
-        this.entity = entity;
-        this.repository = dataSource.getRepository(entity);
-        this.metadata = this.repository.metadata;
-    }
-};