@flusys/nestjs-core 7.1.0 → 8.0.0

package/cjs/docs/index.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./docs.config"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

package/cjs/index.js

@@ -1,23 +0,0 @@
-// Interfaces
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./interfaces"), exports);
-_export_star(require("./constants"), exports);
-_export_star(require("./utils"), exports);
-_export_star(require("./migration"), exports);
-_export_star(require("./config"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

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

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});

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

@@ -1,9 +0,0 @@
-/**
- * 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,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});

package/cjs/interfaces/index.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./app-config.interfaces"), exports);
-_export_star(require("./base-entity.interface"), exports);
-_export_star(require("./database.interface"), exports);
-_export_star(require("./migration.interface"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

package/cjs/interfaces/migration.interface.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});

package/cjs/migration/cli.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _migrationcli = require("./migration.cli");
-(0, _migrationcli.runMigrationCli)().catch((err)=>{
-    console.error('CLI Error:', err.message);
-    process.exit(1);
-});

package/cjs/migration/datasource.factory.js

@@ -1,43 +0,0 @@
-"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 createMigrationDataSource () {
-        return createMigrationDataSource;
-    },
-    get initializeDataSource () {
-        return initializeDataSource;
-    }
-});
-const _typeorm = require("typeorm");
-const _typeormnamingstrategies = require("typeorm-naming-strategies");
-const _datasourceconfigbuilder = require("../utils/datasource-config.builder");
-function createMigrationDataSource(options) {
-    const { config, tenantId } = options;
-    const { database, tenant, tenantConfig } = (0, _datasourceconfigbuilder.getDatabaseForTenant)(config, tenantId);
-    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) {
-        console.log(`\n💡 Multi-tenant mode. Available tenants:`);
-        config.tenants.forEach((t)=>console.log(`   - TENANT_ID=${t.id} → ${t.database}`));
-    }
-    const dbConfig = (0, _datasourceconfigbuilder.resolveDatabaseConnection)(config, tenantId);
-    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({
-        ...dsOptions,
-        namingStrategy: new _typeormnamingstrategies.SnakeNamingStrategy()
-    });
-}
-async function initializeDataSource(options) {
-    const ds = createMigrationDataSource(options);
-    await ds.initialize();
-    return ds;
-}

package/cjs/migration/datasource.factory.spec.js

@@ -1,113 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _datasourcefactory = require("./datasource.factory");
-const mockInitialize = jest.fn();
-const dataSourceCtor = jest.fn().mockImplementation((options)=>({
-        options,
-        initialize: mockInitialize
-    }));
-jest.mock('typeorm', ()=>({
-        DataSource: jest.fn().mockImplementation((options)=>dataSourceCtor(options))
-    }));
-jest.mock('typeorm-naming-strategies', ()=>({
-        SnakeNamingStrategy: jest.fn().mockImplementation(()=>({
-                __brand: 'SnakeNamingStrategy'
-            }))
-    }));
-describe('datasource.factory', ()=>{
-    const baseConfig = {
-        defaultDatabaseConfig: {
-            type: 'postgres',
-            host: 'localhost',
-            port: 5432,
-            username: 'root',
-            password: 'pw',
-            database: 'flusys_default'
-        },
-        migrationsPath: 'migrations',
-        entities: [
-            Object
-        ]
-    };
-    beforeEach(()=>{
-        jest.clearAllMocks();
-        mockInitialize.mockResolvedValue(undefined);
-    });
-    describe('createMigrationDataSource', ()=>{
-        it('should build a DataSource with the resolved connection and a snake naming strategy', ()=>{
-            const ds = (0, _datasourcefactory.createMigrationDataSource)({
-                config: baseConfig
-            });
-            expect(dataSourceCtor).toHaveBeenCalledWith(expect.objectContaining({
-                type: 'postgres',
-                host: 'localhost',
-                database: 'flusys_default',
-                synchronize: false,
-                migrations: [
-                    'migrations/default/*{.ts,.js}'
-                ]
-            }));
-            expect(ds.options.namingStrategy).toEqual({
-                __brand: 'SnakeNamingStrategy'
-            });
-        });
-        it('should resolve tenant-specific database and migrations path', ()=>{
-            const config = {
-                ...baseConfig,
-                tenants: [
-                    {
-                        id: 'tenant-a',
-                        database: 'db_a'
-                    }
-                ]
-            };
-            (0, _datasourcefactory.createMigrationDataSource)({
-                config,
-                tenantId: 'tenant-a'
-            });
-            expect(dataSourceCtor).toHaveBeenCalledWith(expect.objectContaining({
-                database: 'db_a',
-                migrations: [
-                    'migrations/tenant-a/*{.ts,.js}'
-                ]
-            }));
-        });
-        it('should resolve entities via an entity resolver function when provided', ()=>{
-            const resolver = jest.fn().mockReturnValue([
-                Number,
-                String
-            ]);
-            const config = {
-                ...baseConfig,
-                entities: resolver
-            };
-            (0, _datasourcefactory.createMigrationDataSource)({
-                config
-            });
-            expect(resolver).toHaveBeenCalled();
-            expect(dataSourceCtor).toHaveBeenCalledWith(expect.objectContaining({
-                entities: [
-                    Number,
-                    String
-                ]
-            }));
-        });
-    });
-    describe('initializeDataSource', ()=>{
-        it('should create and initialize the DataSource', async ()=>{
-            const ds = await (0, _datasourcefactory.initializeDataSource)({
-                config: baseConfig
-            });
-            expect(mockInitialize).toHaveBeenCalledTimes(1);
-            expect(ds).toBeDefined();
-        });
-        it('should propagate initialization errors', async ()=>{
-            mockInitialize.mockRejectedValue(new Error('connection refused'));
-            await expect((0, _datasourcefactory.initializeDataSource)({
-                config: baseConfig
-            })).rejects.toThrow('connection refused');
-        });
-    });
-});

package/cjs/migration/index.js

@@ -1,45 +0,0 @@
-"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 createMigrationDataSource () {
-        return _datasourcefactory.createMigrationDataSource;
-    },
-    get ensureMigrationsFolder () {
-        return _migrationrunner.ensureMigrationsFolder;
-    },
-    get generateMigration () {
-        return _migrationrunner.generateMigration;
-    },
-    get initializeDataSource () {
-        return _datasourcefactory.initializeDataSource;
-    },
-    get migrationStatus () {
-        return _migrationrunner.migrationStatus;
-    },
-    get resetDatabase () {
-        return _migrationrunner.resetDatabase;
-    },
-    get revertMigration () {
-        return _migrationrunner.revertMigration;
-    },
-    get runForAllTenants () {
-        return _migrationrunner.runForAllTenants;
-    },
-    get runMigrationCli () {
-        return _migrationcli.runMigrationCli;
-    },
-    get runMigrations () {
-        return _migrationrunner.runMigrations;
-    }
-});
-const _datasourcefactory = require("./datasource.factory");
-const _migrationcli = require("./migration.cli");
-const _migrationrunner = require("./migration.runner");

package/cjs/migration/migration.cli.js

@@ -1,231 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "runMigrationCli", {
-    enumerable: true,
-    get: function() {
-        return runMigrationCli;
-    }
-});
-const _path = /*#__PURE__*/ _interop_require_wildcard(require("path"));
-const _config = require("../config");
-const _utils = require("../utils");
-const _migrationrunner = require("./migration.runner");
-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;
-}
-function showHelp() {
-    console.log(`
-Migration CLI
-
-Usage:
-  npm run migration <command> [options]
-
-Commands:
-  generate --name=<Name>   Generate migration
-  run                      Run pending migrations
-  revert                   Revert last migration
-  reset                    Drop db, wipe migration files, recreate db, generate + run initial migration (dev only)
-  status                   Show migration status
-  run:all                  Run for all tenants
-  revert:all               Revert for all tenants
-  status:all               Status for all tenants
-
-Options:
-  --config=<path>    Migration config file (default: src/persistence/migration.config.ts)
-  --name=<Name>      Migration name (for generate command)
-  --force            Required to run 'reset' when MODE is not 'dev'
-
-Environment:
-  TENANT_ID          Target tenant (default: uses default database)
-  MIGRATION_CONFIG   Default config path (overrides auto-detection)
-
-Examples:
-  npm run migration generate --name=CreateUsers
-  npm run migration -- generate --name=CreateUsers --config=src/persistence/migration.config.ts
-  TENANT_ID=tenant1 npm run migration run
-  npm run migration run:all
-  npm run migration reset
-`);
-}
-function parseArgs() {
-    const args = process.argv.slice(2);
-    let command;
-    let name;
-    let configPath;
-    let datasourcePath;
-    let force = false;
-    for(let i = 0; i < args.length; i++){
-        const arg = args[i];
-        if (arg.startsWith('--name=')) {
-            name = arg.split('=')[1];
-        } else if (arg.startsWith('--config=')) {
-            configPath = arg.split('=')[1];
-        } else if (arg.startsWith('--datasource=')) {
-            datasourcePath = arg.split('=')[1];
-        } else if (arg === '--force') {
-            force = true;
-        } else if (!arg.startsWith('-') && !command) {
-            command = arg;
-        }
-    }
-    return {
-        command,
-        name,
-        configPath,
-        datasourcePath,
-        force
-    };
-}
-async function loadConfig(configPath) {
-    const absolutePath = _path.isAbsolute(configPath) ? configPath : _path.resolve(process.cwd(), configPath);
-    // Use require() for CommonJS compatibility with ts-node
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const module = require(absolutePath);
-    return module.migrationConfig || module.default?.migrationConfig || module;
-}
-async function runMigrationCli(configOrPath) {
-    const { command, name, configPath: argConfigPath, datasourcePath, force } = parseArgs();
-    const tenantId = _config.envConfig.getTenantId() ?? undefined;
-    // npm passes --name=X as npm_config_name
-    const migrationName = _config.envConfig.tryGetValue('npm_config_name') || _config.envConfig.tryGetValue('MIGRATION_NAME') || name;
-    // Resolve config
-    let config;
-    let dsPath = datasourcePath;
-    if (typeof configOrPath === 'string') {
-        config = await loadConfig(configOrPath);
-        dsPath = dsPath || configOrPath;
-    } else if (configOrPath) {
-        config = configOrPath;
-    } else if (argConfigPath) {
-        config = await loadConfig(argConfigPath);
-        dsPath = dsPath || argConfigPath;
-    } else {
-        // Try paths in order: env var, then common defaults
-        const envConfigPath = _config.envConfig.tryGetValue('MIGRATION_CONFIG');
-        const defaultPaths = [
-            envConfigPath,
-            'src/persistence/migration.config.ts',
-            'src/persistence/migration.config.js',
-            'persistence/migration.config.ts',
-            'persistence/migration.config.js'
-        ].filter(Boolean);
-        let loaded = false;
-        for (const tryPath of defaultPaths){
-            try {
-                config = await loadConfig(tryPath);
-                dsPath = dsPath || tryPath;
-                loaded = true;
-                break;
-            } catch  {
-            // Try next path
-            }
-        }
-        if (!loaded) {
-            console.error('❌ Config not found. Use --config=<path> or set MIGRATION_CONFIG env var');
-            console.error('   Tried paths:', defaultPaths.join(', '));
-            showHelp();
-            process.exit(1);
-        }
-    }
-    if (!command) {
-        showHelp();
-        return;
-    }
-    // Multi-tenant batch commands
-    if (command.endsWith(':all')) {
-        if (config.bootstrapAppConfig?.databaseMode === 'single') {
-            console.error('❌ Multi-tenant mode not enabled');
-            process.exit(1);
-        }
-        const action = command.split(':')[0];
-        const results = await (0, _migrationrunner.runForAllTenants)(config, action);
-        if (results.some((r)=>!r.success)) process.exit(1);
-        return;
-    }
-    // Show target info
-    const { database } = (0, _utils.getDatabaseForTenant)(config, tenantId);
-    const folder = (0, _utils.getMigrationsFolderPath)(config.migrationsPath, tenantId);
-    console.log(`\n📦 Database: ${database}`);
-    console.log(`📁 Migrations: ${_path.relative(process.cwd(), folder)}`);
-    switch(command){
-        case 'generate':
-            if (!migrationName) {
-                console.error('❌ Migration name required. Use --name=<Name>');
-                process.exit(1);
-            }
-            await (0, _migrationrunner.generateMigration)(config, migrationName, tenantId, dsPath);
-            break;
-        case 'run':
-            {
-                const result = await (0, _migrationrunner.runMigrations)(config, tenantId);
-                if (!result.success) process.exit(1);
-                break;
-            }
-        case 'revert':
-            {
-                const result = await (0, _migrationrunner.revertMigration)(config, tenantId);
-                if (!result.success) process.exit(1);
-                break;
-            }
-        case 'reset':
-            {
-                if (_config.envConfig.isProduction() && !force) {
-                    console.error('❌ Refusing to reset database outside dev mode. Pass --force to override.');
-                    process.exit(1);
-                }
-                const result = await (0, _migrationrunner.resetDatabase)(config, tenantId);
-                if (!result.success) process.exit(1);
-                await (0, _migrationrunner.generateMigration)(config, migrationName || 'Init', tenantId, dsPath);
-                const runResult = await (0, _migrationrunner.runMigrations)(config, tenantId);
-                if (!runResult.success) process.exit(1);
-                break;
-            }
-        case 'status':
-            await (0, _migrationrunner.migrationStatus)(config, tenantId);
-            break;
-        default:
-            console.error(`❌ Unknown command: ${command}`);
-            showHelp();
-            process.exit(1);
-    }
-}