@zintrust/core 0.1.40 → 0.1.41

package/bin/zintrust-main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgFH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CzC;AAED,OAAO,EAAE,CAAC"}
+{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuGH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CzC;AAED,OAAO,EAAE,CAAC"}

package/bin/zintrust-main.js

@@ -50,6 +50,27 @@ const printFancyVersion = (version) => {
 const shouldDebugArgs = (rawArgs) => {
     return process.env['ZINTRUST_CLI_DEBUG_ARGS'] === '1' && rawArgs.includes('--verbose');
 };
+const normalizeProxyTargetArgs = (args) => {
+    if (args.length < 2 || args[0] !== 'proxy')
+        return args;
+    const target = args[1];
+    if (!target || target.startsWith('-') || target.includes(':'))
+        return args;
+    const normalized = target.trim().toLowerCase();
+    const aliases = {
+        redis: 'redis',
+        red: 'red',
+        smtp: 'smtp',
+        mysql: 'mysql',
+        postgres: 'postgres',
+        mongodb: 'mongodb',
+        sqlserver: 'sqlserver',
+    };
+    const mappedTarget = aliases[normalized];
+    if (!mappedTarget)
+        return args;
+    return [`proxy:${mappedTarget}`, ...args.slice(2)];
+};
 const handleCliFatal = async (error, context) => {
     try {
         const { Logger } = await import('../src/config/logger.js');
@@ -102,7 +123,7 @@ export async function run() {
                 // ignore
             }
         }
-        await cli.run(args);
+        await cli.run(normalizeProxyTargetArgs(args));
     }
     catch (error) {
         await handleCliFatal(error, 'CLI execution failed');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -33,11 +33,15 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "bcrypt": "^6.0.0",
+    "bcryptjs": "^3.0.3",
+    "bullmq": "^5.67.3",
     "chalk": "^5.6.2",
-    "commander": "^14.0.2",
+    "commander": "^14.0.3",
     "inquirer": "^13.2.2",
-    "jsonwebtoken": "^9.0.3"
+    "jsonwebtoken": "^9.0.3",
+    "@zintrust/workers": "^0.1.31",
+    "mysql2": "^3.16.3",
+    "pg": "^8.18.0"
   },
   "overrides": {
     "node-forge": "1.3.3",

package/public/error-pages/404.html

@@ -13,7 +13,7 @@
         <div id="header-actions">
           <div id="toggle-theme-container">
             <input type="checkbox" id="toggle-theme-checkbox" />
-            <label id="toggle-theme-label" for="toggle-theme-checkbox">
+            <span id="toggle-theme-label" for="toggle-theme-checkbox">
               <span id="light-theme-indicator" title="Light mode">
                 <svg
                   xmlns="http://www.w3.org/2000/svg"
@@ -51,7 +51,7 @@
                   <path d="M12 3h.393a7.5 7.5 0 0 0 7.92 12.446A9 9 0 1 1 12 2.992z"></path>
                 </svg>
               </span>
-            </label>
+            </span>
           </div>
         </div>
       </header>

package/src/auth/Auth.js

@@ -1,5 +1,5 @@
 // TEMPLATE_START
-import * as bcrypt from 'bcrypt';
+import bcrypt from 'bcryptjs';
 import jwt from 'jsonwebtoken';
 const { sign, verify } = jwt;
 export const Auth = Object.freeze({

package/src/boot/Application.d.ts

@@ -2,22 +2,7 @@
  * Application - Framework core entry point
  * Handles application lifecycle, booting, and environment
  */
-import type { IServiceContainer } from '../container/ServiceContainer';
-import type { IMiddlewareStack } from '../middleware/MiddlewareStack';
-import { type IRouter } from '../routes/Router';
-export interface IApplication {
-    boot(): Promise<void>;
-    shutdown(): Promise<void>;
-    isBooted(): boolean;
-    isDevelopment(): boolean;
-    isProduction(): boolean;
-    isTesting(): boolean;
-    getEnvironment(): string;
-    getRouter(): IRouter;
-    getContainer(): IServiceContainer;
-    getMiddlewareStack(): IMiddlewareStack;
-    getBasePath(): string;
-}
+import type { IApplication } from './registry/type';
 /**
  * Application Factory
  */

package/src/boot/Application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../../src/boot/Application.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAOrE,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,qBAAqB,CAAC;AAK3D,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,IAAI,OAAO,CAAC;IACpB,aAAa,IAAI,OAAO,CAAC;IACzB,YAAY,IAAI,OAAO,CAAC;IACxB,SAAS,IAAI,OAAO,CAAC;IACrB,cAAc,IAAI,MAAM,CAAC;IACzB,SAAS,IAAI,OAAO,CAAC;IACrB,YAAY,IAAI,iBAAiB,CAAC;IAClC,kBAAkB,IAAI,gBAAgB,CAAC;IACvC,WAAW,IAAI,MAAM,CAAC;CACvB;AAicD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM,GAAG,YAAY;EA0CvC,CAAC;AAEH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../../src/boot/Application.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,YAAY,EAAkC,MAAM,gBAAgB,CAAC;AA2DnF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM,GAAG,YAAY;EA0CvC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/src/boot/Application.js

@@ -2,19 +2,11 @@
  * Application - Framework core entry point
  * Handles application lifecycle, booting, and environment
  */
-import { appConfig, cacheConfig, databaseConfig, queueConfig, storageConfig } from '../config/index.js';
+import { appConfig } from '../config/index.js';
 import { ServiceContainer } from '../container/ServiceContainer.js';
-import { StartupHealthChecks } from '../health/StartupHealthChecks.js';
 import { MiddlewareStack } from '../middleware/MiddlewareStack.js';
-import broadcastConfig from '../config/broadcast.js';
-import { FeatureFlags } from '../config/features.js';
-import { Logger } from '../config/logger.js';
-import notificationConfig from '../config/notification.js';
-import { StartupConfigValidator } from '../config/StartupConfigValidator.js';
 import { Router } from '../routes/Router.js';
-import * as path from '../node-singletons/path.js';
-import { pathToFileURL } from '../node-singletons/url.js';
-import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';
+import { createLifecycle, registerFrameworkShutdownHooks } from './registry/runtime.js';
 const ShutdownManager = Object.freeze({
     create() {
         const hooks = [];
@@ -56,286 +48,6 @@ const registerCoreInstances = (params) => {
     params.container.singleton('container', params.container);
     params.container.singleton('shutdownManager', params.shutdownManager);
 };
-/**
- * Helper: Register ConnectionManager shutdown hook
- */
-const registerConnectionManagerHook = (shutdownManager) => {
-    shutdownManager.add(async () => {
-        try {
-            const mod = await import('../orm/ConnectionManager.js');
-            await mod.ConnectionManager.shutdownIfInitialized();
-        }
-        catch {
-            /* ignore import failures in restrictive runtimes */
-        }
-    });
-};
-/**
- * Helper: Register Worker management system shutdown hook
- */
-const registerWorkerShutdownHook = async (shutdownManager) => {
-    // Ensure worker management system is asked to shutdown BEFORE databases are reset.
-    // This prevents workers from trying to access DB connections that have already
-    // been closed by subsequent shutdown hooks.
-    shutdownManager.add(async () => {
-        try {
-            const mod = (await import('@zintrust/workers'));
-            const isShuttingDown = typeof mod.WorkerShutdown.isShuttingDown === 'function'
-                ? mod.WorkerShutdown.isShuttingDown()
-                : (mod.WorkerShutdown.getShutdownState?.().isShuttingDown ?? false);
-            const completedAt = mod.WorkerShutdown.getShutdownState?.().completedAt ?? null;
-            if (isShuttingDown || completedAt !== null)
-                return;
-            await mod.WorkerShutdown.shutdown({
-                signal: 'APP_SHUTDOWN',
-                timeout: 5000,
-                forceExit: false,
-            });
-        }
-        catch {
-            /* ignore import failures in restrictive runtimes */
-        }
-    });
-    return Promise.resolve(); // NOSONAR
-};
-/**
- * Helper: Register Database reset hook
- */
-const registerDatabaseResetHook = (shutdownManager) => {
-    shutdownManager.add(async () => {
-        try {
-            const mod = await import('../orm/Database.js');
-            mod.resetDatabase();
-        }
-        catch {
-            /* ignore import failures in restrictive runtimes */
-        }
-    });
-};
-/**
- * Helper: Register generic reset hook for modules with reset() method
- */
-const registerResetHook = (shutdownManager, modulePath, exportName) => {
-    shutdownManager.add(async () => {
-        try {
-            const mod = (await import(modulePath));
-            const resetModule = mod[exportName];
-            if (resetModule?.reset) {
-                resetModule.reset();
-            }
-        }
-        catch {
-            /* ignore import failures in restrictive runtimes */
-        }
-    });
-};
-/**
- * Helper: Register FileLogWriter flush hook
- */
-const registerFileLogFlushHook = (shutdownManager) => {
-    shutdownManager.add(async () => {
-        try {
-            const mod = await import('../config/FileLogWriter.js');
-            mod.FileLogWriter.flush();
-        }
-        catch {
-            /* ignore import failures in restrictive runtimes */
-        }
-    });
-};
-const registerFrameworkShutdownHooks = (shutdownManager) => {
-    // Register framework-level shutdown hooks for long-lived resources
-    registerConnectionManagerHook(shutdownManager);
-    // Ensure worker management system is asked to shutdown BEFORE databases are reset
-    void registerWorkerShutdownHook(shutdownManager);
-    // Database and cache reset
-    registerDatabaseResetHook(shutdownManager);
-    registerResetHook(shutdownManager, '@cache/Cache', 'Cache');
-    // File logging
-    registerFileLogFlushHook(shutdownManager);
-    // Registry resets
-    registerResetHook(shutdownManager, '@broadcast/BroadcastRegistry', 'BroadcastRegistry');
-    registerResetHook(shutdownManager, '@storage/StorageDiskRegistry', 'StorageDiskRegistry');
-    registerResetHook(shutdownManager, '@notification/NotificationChannelRegistry', 'NotificationChannelRegistry');
-    registerResetHook(shutdownManager, '@mail/MailDriverRegistry', 'MailDriverRegistry');
-    registerResetHook(shutdownManager, '@tools/queue/Queue', 'Queue');
-};
-const tryImportRoutesFromAppBase = async (resolvedBasePath) => {
-    if (resolvedBasePath === '')
-        return undefined;
-    const candidates = [
-        // Dev (tsx)
-        path.join(resolvedBasePath, 'routes', 'api.ts'),
-        // Production build output
-        path.join(resolvedBasePath, 'dist', 'routes', 'api.js'),
-        // Fallback (in case someone transpiles without /dist)
-        path.join(resolvedBasePath, 'routes', 'api.js'),
-    ];
-    for (const candidate of candidates) {
-        try {
-            const url = pathToFileURL(candidate).href;
-            // Intentionally sequential to find the first working candidates
-            // eslint-disable-next-line no-await-in-loop
-            return (await import(url));
-        }
-        catch {
-            // keep trying
-        }
-    }
-    return undefined;
-};
-const registerRoutes = async (resolvedBasePath, router) => {
-    try {
-        const mod = await tryImportRoutesFromAppBase(resolvedBasePath);
-        if (typeof mod?.registerRoutes === 'function') {
-            mod.registerRoutes(router);
-        }
-        else {
-            const frameworkRoutes = await tryImportOptional('@routes/api');
-            if (typeof frameworkRoutes?.registerRoutes === 'function') {
-                frameworkRoutes.registerRoutes(router);
-            }
-            else {
-                Logger.warn('No app routes found and framework routes are unavailable. Ensure routes/api.ts exists in the project.');
-            }
-        }
-        // Always register core framework routes (health, metrics, doc) after app routes
-        // This ensures app can override but core routes always exist
-        const { registerCoreRoutes } = await import('../routes/CoreRoutes.js');
-        registerCoreRoutes(router);
-    }
-    catch (error) {
-        Logger.error('Failed to register routes:', error);
-    }
-};
-const initializeArtifactDirectories = async (resolvedBasePath) => {
-    if (resolvedBasePath === '')
-        return;
-    if (typeof process === 'undefined')
-        return;
-    let nodeFs;
-    try {
-        nodeFs = await import('../node-singletons/fs.js');
-    }
-    catch {
-        return;
-    }
-    const dirs = ['logs', 'storage', 'tmp'];
-    for (const dir of dirs) {
-        const fullPath = path.join(resolvedBasePath, dir);
-        try {
-            if (!nodeFs.existsSync(fullPath)) {
-                nodeFs.mkdirSync(fullPath, { recursive: true });
-                Logger.info(`✓ Created directory: ${dir}`);
-            }
-        }
-        catch (error) {
-            Logger.warn(`Failed to create ${dir} directory`, error);
-        }
-    }
-};
-const tryImportOptional = async (modulePath) => {
-    try {
-        return (await import(modulePath));
-    }
-    catch {
-        return undefined;
-    }
-};
-const isCompiledJsModule = () => {
-    // When running from dist, this module is compiled to .js and Node ESM resolution
-    // requires explicit file extensions for relative imports.
-    return import.meta.url.endsWith('.js');
-};
-const dbLoader = async () => {
-    const db = await tryImportOptional(isCompiledJsModule()
-        ? '../orm/DatabaseRuntimeRegistration.js'
-        : '../orm/DatabaseRuntimeRegistration');
-    db?.registerDatabasesFromRuntimeConfig?.(databaseConfig);
-};
-const queuesLoader = async () => {
-    const queues = await tryImportOptional(isCompiledJsModule()
-        ? '../tools/queue/QueueRuntimeRegistration.js'
-        : '../tools/queue/QueueRuntimeRegistration');
-    queues?.registerQueuesFromRuntimeConfig?.(queueConfig);
-};
-const cachesLoader = async () => {
-    const caches = await tryImportOptional(isCompiledJsModule()
-        ? '../cache/CacheRuntimeRegistration.js'
-        : '../cache/CacheRuntimeRegistration');
-    caches?.registerCachesFromRuntimeConfig?.(cacheConfig);
-};
-const registerFromRuntimeConfig = async () => {
-    await dbLoader();
-    await queuesLoader();
-    await cachesLoader();
-    const broadcasters = await tryImportOptional(isCompiledJsModule()
-        ? '../tools/broadcast/BroadcastRuntimeRegistration.js'
-        : '../tools/broadcast/BroadcastRuntimeRegistration');
-    broadcasters?.registerBroadcastersFromRuntimeConfig?.({
-        default: broadcastConfig.default,
-        drivers: broadcastConfig.drivers,
-    });
-    const disks = await tryImportOptional(isCompiledJsModule()
-        ? '../tools/storage/StorageRuntimeRegistration.js'
-        : '../tools/storage/StorageRuntimeRegistration');
-    disks?.registerDisksFromRuntimeConfig?.(storageConfig);
-    const notifications = await tryImportOptional(isCompiledJsModule()
-        ? '../tools/notification/NotificationRuntimeRegistration.js'
-        : '../tools/notification/NotificationRuntimeRegistration');
-    notifications?.registerNotificationChannelsFromRuntimeConfig?.({
-        default: notificationConfig.default,
-        drivers: notificationConfig.drivers,
-    });
-};
-const createLifecycle = (params) => {
-    const boot = async () => {
-        if (params.getBooted())
-            return;
-        Logger.info(`🚀 Booting ZinTrust Application in ${params.environment} mode...`);
-        StartupConfigValidator.assertValid();
-        // Preload project-owned config overrides that must be available synchronously.
-        await StartupConfigFileRegistry.preload([
-            StartupConfigFile.Middleware,
-            StartupConfigFile.Cache,
-            StartupConfigFile.Database,
-            StartupConfigFile.Queue,
-            StartupConfigFile.Storage,
-            StartupConfigFile.Mail,
-            StartupConfigFile.Broadcast,
-            StartupConfigFile.Notification,
-        ]);
-        FeatureFlags.initialize();
-        await StartupHealthChecks.assertHealthy();
-        await registerFromRuntimeConfig();
-        await initializeArtifactDirectories(params.resolvedBasePath);
-        await registerRoutes(params.resolvedBasePath, params.router);
-        // Register service providers
-        // Bootstrap services
-        Logger.info('✅ Application booted successfully');
-        params.setBooted(true);
-    };
-    const shutdown = async () => {
-        Logger.info('🛑 Shutting down application...');
-        try {
-            await params.shutdownManager.run();
-        }
-        catch (error) {
-            Logger.error('Shutdown hook failed:', error);
-        }
-        // Ensure FileLogWriter.flush is attempted even if dynamic registration failed.
-        try {
-            const fileLogWriter = await tryImportOptional('@config/FileLogWriter');
-            fileLogWriter?.FileLogWriter?.flush?.();
-        }
-        catch {
-            /* best-effort */
-        }
-        params.setBooted(false);
-        Logger.info('✅ Application shut down successfully');
-    };
-    return { boot, shutdown };
-};
 /**
  * Application Factory
  */

package/src/boot/Server.d.ts

@@ -2,9 +2,9 @@
  * Server - HTTP Server implementation
  * Uses Node.js built-in HTTP server with no external dependencies
  */
-import type { IApplication } from './Application';
 import type { IKernel } from '../http/Kernel';
 import * as http from '../node-singletons/http';
+import type { IApplication } from './registry/type';
 export interface IServer {
     listen(): Promise<void>;
     close(): Promise<void>;

package/src/boot/Server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Server.d.ts","sourceRoot":"","sources":["../../../src/boot/Server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAG9C,MAAM,WAAW,OAAO;IACtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC;CAC9B;AAkED;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;gBACS,YAAY,SAAS,MAAM,SAAS,MAAM,WAAU,OAAO,GAAG,IAAI,GAAU,OAAO;EA4D/F,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Server.d.ts","sourceRoot":"","sources":["../../../src/boot/Server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,OAAO;IACtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC;CAC9B;AAkED;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;gBACS,YAAY,SAAS,MAAM,SAAS,MAAM,WAAU,OAAO,GAAG,IAAI,GAAU,OAAO;EA4D/F,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/src/boot/bootstrap.js

@@ -9,6 +9,7 @@ import { appConfig } from '../config/app.js';
 import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
+import { loadWorkersModule } from '../runtime/WorkersModule.js';
 let appInstance;
 let serverInstance;
 let isShuttingDown = false;
@@ -101,9 +102,10 @@ const gracefulShutdown = async (signal) => {
         forceExitTimer.unref?.();
         await withTimeout((async () => {
             // Shutdown worker management system FIRST (before database closes)
-            if (appConfig.detectRuntime() === 'nodejs' || appConfig.detectRuntime() === 'lambda') {
+            if ((appConfig.detectRuntime() === 'nodejs' || appConfig.detectRuntime() === 'lambda') &&
+                appConfig.dockerWorker === false) {
                 try {
-                    const workers = await import('@zintrust/workers');
+                    const workers = await loadWorkersModule();
                     const workerBudgetMs = Math.min(15000, remainingMs());
                     await withTimeout(workers.WorkerShutdown.shutdown({
                         signal,
@@ -137,10 +139,16 @@ const gracefulShutdown = async (signal) => {
     }
 };
 async function useWorkerStarter() {
+    // Check if workers are enabled in this environment
+    const workerEnabled = Env.getBool('WORKER_ENABLED', true);
+    if (!workerEnabled || appConfig.dockerWorker === true) {
+        Logger.info('Workers disabled in this runtime (WORKER_ENABLED=false && DOCKER_WORKER=true), skipping worker management initialization');
+        return;
+    }
     // Initialize worker management system
     let workerInit = null;
     try {
-        const workers = await import('@zintrust/workers');
+        const workers = await loadWorkersModule();
         if (workers?.WorkerInit !== undefined) {
             workerInit = workers.WorkerInit;
             await workers.WorkerInit.initialize({
@@ -199,12 +207,22 @@ const BootstrapFunctions = Object.freeze({
             Logger.info(`ZinTrust documentation at http://${host}:${port}/doc`);
             // Start schedules for long-running runtimes (Node.js / Fargate)
             await startSchedulesIfNeeded(app);
-            if (appConfig.detectRuntime() === 'nodejs' || appConfig.detectRuntime() === 'lambda') {
+            if (appConfig.dockerWorker === false &&
+                (appConfig.detectRuntime() === 'nodejs' || appConfig.detectRuntime() === 'lambda')) {
                 await useWorkerStarter();
             }
         }
         catch (error) {
-            Logger.error('Failed to bootstrap application:', error);
+            try {
+                Logger.error('Failed to bootstrap application:', error);
+            }
+            catch {
+                // best-effort logging
+            }
+            Logger.debug('[bootstrap] start: failed', {
+                message: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
             logBootstrapErrorDetails(error);
             process.exit(1);
         }

package/src/boot/registry/registerRoute.d.ts

@@ -0,0 +1,6 @@
+import type { IRouter } from '../../routes/Router';
+export declare const isCompiledJsModule: () => boolean;
+export declare const tryImportOptional: <T>(modulePath: string) => Promise<T | undefined>;
+export declare const tryImportOptionalR: <T>(modulePath: string) => Promise<T | undefined>;
+export declare const registerMasterRoutes: (resolvedBasePath: string, router: IRouter) => Promise<void>;
+//# sourceMappingURL=registerRoute.d.ts.map

package/src/boot/registry/registerRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerRoute.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/registerRoute.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQnD,eAAO,MAAM,kBAAkB,QAAO,OAKrC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,CAAC,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAMpF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,CAAC,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAOrF,CAAC;AAkEF,eAAO,MAAM,oBAAoB,GAC/B,kBAAkB,MAAM,EACxB,QAAQ,OAAO,KACd,OAAO,CAAC,IAAI,CAmBd,CAAC"}

package/src/boot/registry/registerRoute.js

@@ -0,0 +1,96 @@
+import { appConfig } from '../../config/index.js';
+import Logger from '../../config/logger.js';
+import * as path from '../../node-singletons/path.js';
+import { pathToFileURL } from '../../node-singletons/url.js';
+import { detectRuntime } from '../../runtime/detectRuntime.js';
+const isCloudflare = detectRuntime().isCloudflare;
+export const isCompiledJsModule = () => {
+    // When running from dist, this module is compiled to .js and Node ESM resolution
+    // requires explicit file extensions for relative imports.
+    const metaUrl = typeof import.meta?.url === 'string' ? import.meta.url : '';
+    return metaUrl.endsWith('.js');
+};
+export const tryImportOptional = async (modulePath) => {
+    try {
+        return (await import(modulePath));
+    }
+    catch {
+        return undefined;
+    }
+};
+export const tryImportOptionalR = async (modulePath) => {
+    try {
+        return (await import(modulePath));
+    }
+    catch (error) {
+        Logger.error(`Error importing module ${modulePath}:`, error);
+        return undefined;
+    }
+};
+const tryImportRoutesFromAppBase = async (resolvedBasePath) => {
+    if (resolvedBasePath === '')
+        return undefined;
+    const routeCandidates = appConfig.isDevelopment()
+        ? [
+            path.join(resolvedBasePath, 'routes', 'api.ts'),
+            path.join(resolvedBasePath, 'routes', 'api.js'),
+        ]
+        : [
+            path.join(resolvedBasePath, 'routes', 'api.js'),
+            path.join(resolvedBasePath, 'dist', 'routes', 'api.js'),
+            path.join(resolvedBasePath, 'routes', 'api.ts'),
+            path.join(resolvedBasePath, 'dist', 'routes', 'api.ts'),
+        ];
+    for (const routePath of routeCandidates) {
+        try {
+            const url = pathToFileURL(routePath).href;
+            // eslint-disable-next-line no-await-in-loop
+            return (await import(url));
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return undefined;
+};
+const registerAppRoutes = async (resolvedBasePath, router) => {
+    const mod = await tryImportRoutesFromAppBase(resolvedBasePath);
+    if (mod && typeof mod.registerRoutes === 'function') {
+        mod.registerRoutes(router);
+    }
+};
+const registerFrameworkRoutes = async (resolvedBasePath, router) => {
+    const frameworkRoutes = await tryImportRoutesFromAppBase(resolvedBasePath);
+    if (frameworkRoutes && typeof frameworkRoutes.registerRoutes === 'function') {
+        frameworkRoutes.registerRoutes(router);
+    }
+};
+const registerGlobalRoutes = (router) => {
+    const globalRoutes = globalThis.__zintrustRoutes;
+    if (globalRoutes && typeof globalRoutes.registerRoutes === 'function') {
+        globalRoutes.registerRoutes(router);
+    }
+    else {
+        Logger.warn('No app routes found and framework routes are unavailable. Ensure routes/api.ts exists in the project.');
+    }
+};
+export const registerMasterRoutes = async (resolvedBasePath, router) => {
+    try {
+        if (isCloudflare) {
+            registerGlobalRoutes(router);
+        }
+        if (!isCloudflare) {
+            await registerAppRoutes(resolvedBasePath, router);
+        }
+        if (router.routes.length === 0) {
+            await registerFrameworkRoutes(resolvedBasePath, router);
+        }
+        // Always register core framework routes (health, metrics, doc) after app routes
+        // This ensures app can override but core routes always exist
+        const { registerCoreRoutes } = await import('../../routes/CoreRoutes.js');
+        registerCoreRoutes(router);
+    }
+    catch (error) {
+        Logger.error('Failed to register routes:', error);
+    }
+};

package/src/boot/registry/runtime.d.ts

@@ -0,0 +1,15 @@
+import type { IShutdownManager } from './type';
+import type { IRouter } from '../../index.js';
+export declare const registerFrameworkShutdownHooks: (shutdownManager: IShutdownManager) => void;
+export declare const createLifecycle: (params: {
+    environment: string;
+    resolvedBasePath: string;
+    router: IRouter;
+    shutdownManager: IShutdownManager;
+    getBooted: () => boolean;
+    setBooted: (value: boolean) => void;
+}) => {
+    boot: () => Promise<void>;
+    shutdown: () => Promise<void>;
+};
+//# sourceMappingURL=runtime.d.ts.map

package/src/boot/registry/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA+I9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA4BlF,CAAC;AA+KF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAsE7D,CAAC"}