@zintrust/core 0.1.38 → 0.1.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -36,7 +36,7 @@
     "bcrypt": "^6.0.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
-    "inquirer": "^13.2.1",
+    "inquirer": "^13.2.2",
     "jsonwebtoken": "^9.0.3"
   },
   "overrides": {

package/public/index.html

@@ -424,7 +424,7 @@
             'zin new my-api',
             'cd my-api',
             'zin start',
-            'curl http://localhost:3000/health',
+            'curl http://localhost:7777/health',
             'zin debug',
           ],
         },
@@ -434,7 +434,7 @@
           lines: [
             'docker build -t my-api:latest .',
             'docker run --rm -p 3000:3000 my-api:latest',
-            'curl http://localhost:3000/health',
+            'curl http://localhost:7777/health',
           ],
         },
       };

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;AA8ZD;;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;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"}

package/src/boot/Application.js

@@ -23,10 +23,8 @@ const ShutdownManager = Object.freeze({
                 hooks.push(hook);
             },
             async run() {
-                for (const hook of hooks) {
-                    // eslint-disable-next-line no-await-in-loop
-                    await hook();
-                }
+                // Run hooks in parallel for better performance
+                await Promise.all(hooks.map(async (hook) => hook()));
             },
         });
     },
@@ -58,82 +56,110 @@ const registerCoreInstances = (params) => {
     params.container.singleton('container', params.container);
     params.container.singleton('shutdownManager', params.shutdownManager);
 };
-const registerFrameworkShutdownHooks = (shutdownManager) => {
-    // Register framework-level shutdown hooks for long-lived resources
-    // ConnectionManager may not be initialized; shutdownIfInitialized is safe
-    // Use dynamic import without top-level await to avoid transforming the module into an async module
-    import('../orm/ConnectionManager.js')
-        .then((mod) => {
-        shutdownManager.add(async () => mod.ConnectionManager.shutdownIfInitialized());
-    })
-        .catch(() => {
-        /* ignore import failures in restrictive runtimes */
-    });
-    import('../orm/Database.js')
-        .then((mod) => {
-        shutdownManager.add(() => mod.resetDatabase());
-    })
-        .catch(() => {
-        /* ignore import failures in restrictive runtimes */
-    });
-    import('../cache/Cache.js')
-        .then((mod) => {
-        shutdownManager.add(() => mod.Cache.reset());
-    })
-        .catch(() => {
-        /* ignore import failures in restrictive runtimes */
-    });
-    // Flush file logging streams
-    import('../config/FileLogWriter.js')
-        .then((mod) => {
-        shutdownManager.add(() => mod.FileLogWriter.flush());
-    })
-        .catch(() => {
-        /* ignore import failures in restrictive runtimes */
-    });
-    import('../tools/broadcast/BroadcastRegistry.js')
-        .then((mod) => {
-        shutdownManager.add(() => mod.BroadcastRegistry.reset());
-    })
-        .catch(() => {
-        /* ignore import failures in restrictive runtimes */
-    });
-    import('../tools/storage/StorageDiskRegistry.js')
-        .then((mod) => {
-        shutdownManager.add(() => mod.StorageDiskRegistry.reset());
-    })
-        .catch(() => {
-        /* ignore import failures in restrictive runtimes */
+/**
+ * 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 */
+        }
     });
-    import('../tools/notification/NotificationChannelRegistry.js')
-        .then((mod) => {
-        shutdownManager.add(() => mod.NotificationChannelRegistry.reset());
-    })
-        .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 */
+        }
     });
-    import('../tools/mail/MailDriverRegistry.js')
-        .then((mod) => {
-        shutdownManager.add(() => mod.MailDriverRegistry.reset());
-    })
-        .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 */
+        }
     });
-    import('../tools/queue/Queue.js')
-        .then((mod) => {
-        shutdownManager.add(() => mod.Queue.reset());
-    })
-        .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 */
+        }
     });
-    import('@zintrust/workers')
-        .then((mod) => {
-        shutdownManager.add(async () => mod.WorkerShutdown.shutdown({ signal: 'APP_SHUTDOWN', timeout: 5000, forceExit: false }));
-    })
-        .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;
@@ -148,6 +174,7 @@ const tryImportRoutesFromAppBase = async (resolvedBasePath) => {
     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));
         }

package/src/boot/bootstrap.js

@@ -103,9 +103,7 @@ const gracefulShutdown = async (signal) => {
             // Shutdown worker management system FIRST (before database closes)
             if (appConfig.detectRuntime() === 'nodejs' || appConfig.detectRuntime() === 'lambda') {
                 try {
-                    const { createRequire } = await import('../node-singletons/module.js');
-                    const require = createRequire(import.meta.url);
-                    const workers = require('@zintrust/workers');
+                    const workers = await import('@zintrust/workers');
                     const workerBudgetMs = Math.min(15000, remainingMs());
                     await withTimeout(workers.WorkerShutdown.shutdown({
                         signal,
@@ -142,9 +140,7 @@ async function useWorkerStarter() {
     // Initialize worker management system
     let workerInit = null;
     try {
-        const { createRequire } = await import('../node-singletons/module.js');
-        const require = createRequire(import.meta.url);
-        const workers = require('@zintrust/workers');
+        const workers = await import('@zintrust/workers');
         if (workers?.WorkerInit !== undefined) {
             workerInit = workers.WorkerInit;
             await workers.WorkerInit.initialize({

package/src/cli/PromptHelper.js

@@ -59,7 +59,7 @@ export const PromptHelper = Object.freeze({
                 default: defaultDb,
             },
         ]);
-        return answer.database;
+        return answer['database'];
     },
     /**
      * Ask for port number
@@ -134,7 +134,7 @@ export const PromptHelper = Object.freeze({
                 default: defaultChoice,
             },
         ]);
-        return answer.choice;
+        return answer['choice'];
     },
     /**
      * Get text input

package/src/cli/commands/MigrateWorkerCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MigrateWorkerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateWorkerCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmKrE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAUtB,CAAC"}
+{"version":3,"file":"MigrateWorkerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateWorkerCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqKrE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAUtB,CAAC"}

package/src/cli/commands/MigrateWorkerCommand.js

@@ -82,7 +82,7 @@ const runForConnection = async (conn, options, cmd, interactive) => {
         return;
     if (!DatabaseAdapterRegistry.has(conn.driver)) {
         cmd.warn(`Missing adapter for driver: ${conn.driver}`);
-        cmd.warn('Install via `zin plugin install adapter:postgres` (or `zin add db:postgres`).');
+        cmd.warn(`Install via 'zin plugin install adapter:${conn.driver}' (or 'zin add db:${conn.driver}').`);
     }
     const ormConfig = mapConnectionToOrmConfig(conn);
     const db = Database.create(ormConfig);

package/src/cli/commands/StartCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqavF,eAAO,MAAM,YAAY;cACb,YAAY;EAyBtB,CAAC"}
+{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAobvF,eAAO,MAAM,YAAY;cACb,YAAY;EAyBtB,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -21,12 +21,12 @@ const normalizeMode = (value) => {
     return 'development';
 };
 const resolveModeFromAppMode = () => {
-    const raw = readEnvString('APP_MODE').trim();
+    const raw = readEnvString('NODE_ENV').trim();
     const normalized = raw.toLowerCase();
     if (normalized === 'production' || normalized === 'pro' || normalized === 'prod') {
         return 'production';
     }
-    // Per spec: any other APP_MODE is treated as development.
+    // Per spec: any other NODE_ENV is treated as development.
     return 'development';
 };
 const resolveMode = (options) => {
@@ -159,12 +159,24 @@ const resolveNodeDevCommand = (cwd, packageJson) => {
 };
 const resolveNodeProdCommand = (cwd) => {
     const compiledBoot = path.join(cwd, 'dist/src/boot/bootstrap.js');
+    const runFromSourceEnv = process.env['ZINTRUST_RUN_FROM_SOURCE'] ?? '';
+    const runFromSource = runFromSourceEnv === '1' || runFromSourceEnv.toLowerCase() === 'true';
     let compiled;
-    if (existsSync(compiledBoot)) {
+    if (existsSync(compiledBoot) && !runFromSource) {
         compiled = 'dist/src/boot/bootstrap.js';
     }
+    // If compiled app isn't available (or the env forces running from source),
+    // fall back to running the source entry with `tsx` so developers can test
+    // core files with production semantics without building.
     if (compiled === undefined) {
-        throw ErrorFactory.createCliError("Error: Compiled app not found at dist/src/boot/bootstrap.js Run 'npm run build' first.");
+        const bootstrap = resolveBootstrapEntryTs(cwd);
+        if (bootstrap !== undefined) {
+            return { command: 'tsx', args: [bootstrap] };
+        }
+        if (existsSync(path.join(cwd, 'src/index.ts'))) {
+            return { command: 'tsx', args: ['src/index.ts'] };
+        }
+        throw ErrorFactory.createCliError("Error: Compiled app not found at dist/src/boot/bootstrap.js. Run 'npm run build' first or set ZINTRUST_RUN_FROM_SOURCE=1 to run source in production.");
     }
     return { command: 'node', args: [compiled] };
 };

package/src/cli/utils/EnvFileLoader.d.ts

@@ -1,3 +1,4 @@
+type node_env = 'development' | 'production' | 'testing';
 type LoadOptions = {
     cwd?: string;
     overrideExisting?: boolean;
@@ -7,7 +8,7 @@ type LoadState = {
     mode?: string;
 };
 type CliOverrides = {
-    nodeEnv?: 'development' | 'production' | 'testing';
+    nodeEnv?: node_env;
     port?: number;
     runtime?: string;
 };

package/src/cli/utils/EnvFileLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnvFileLoader.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/EnvFileLoader.ts"],"names":[],"mappings":"AAgHA,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAsFF,eAAO,MAAM,aAAa;qBA7DH,WAAW,KAAQ,SAAS;wBA8B1B,SAAS;mCAEI,YAAY,KAAG,IAAI;oBA2BpC,SAAS;EAO5B,CAAC"}
+{"version":3,"file":"EnvFileLoader.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/EnvFileLoader.ts"],"names":[],"mappings":"AAQA,KAAK,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAoGzD,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA2FF,eAAO,MAAM,aAAa;qBAlEH,WAAW,KAAQ,SAAS;wBAmC1B,SAAS;mCAEI,YAAY,KAAG,IAAI;oBA2BpC,SAAS;EAO5B,CAAC"}

package/src/cli/utils/EnvFileLoader.js

@@ -5,9 +5,9 @@ const normalizeAppMode = (value) => {
     if (normalized === 'production' || normalized === 'pro' || normalized === 'prod')
         return 'production';
     if (normalized === 'dev' || normalized === 'development')
-        return 'dev';
+        return 'development';
     // Per spec: any other value is treated as development.
-    return 'dev';
+    return 'development';
 };
 const stripInlineComment = (value) => {
     let inSingle = false;
@@ -69,10 +69,6 @@ const applyToProcessEnv = (values, overrideExisting) => {
     if (typeof process.env['PORT'] !== 'string' && typeof process.env['APP_PORT'] === 'string') {
         process.env['PORT'] = process.env['APP_PORT'];
     }
-    if (typeof process.env['NODE_ENV'] !== 'string' && typeof process.env['APP_MODE'] === 'string') {
-        const mode = normalizeAppMode(process.env['APP_MODE']);
-        process.env['NODE_ENV'] = mode === 'production' ? 'production' : 'development';
-    }
 };
 const readEnvFileIfExists = (cwd, filename) => {
     const fullPath = join(cwd, filename);
@@ -82,11 +78,11 @@ const readEnvFileIfExists = (cwd, filename) => {
     return parseEnvFile(raw);
 };
 const resolveAppMode = (cwd) => {
-    const existing = process.env['APP_MODE'];
+    const existing = process.env['NODE_ENV'];
     if (typeof existing === 'string' && existing.trim() !== '')
         return normalizeAppMode(existing);
     const fromDotEnv = readEnvFileIfExists(cwd, '.env');
-    const value = fromDotEnv?.['APP_MODE'];
+    const value = fromDotEnv?.['NODE_ENV'];
     if (typeof value === 'string' && value.trim() !== '')
         return normalizeAppMode(value);
     return undefined;
@@ -132,6 +128,10 @@ const load = (options = {}) => {
         // .env is primary: overlays only fill missing values and never override base.
         applyToProcessEnv(parsed, baseApplied ? false : overrideExisting);
     }
+    // Set NODE_ENV to the normalized mode if we have one (after applying files)
+    if (mode !== undefined) {
+        process.env['NODE_ENV'] = mode;
+    }
     cached = { loadedFiles: files, mode };
     return cached;
 };

package/src/cli/utils/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/spawn.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA8BD,eAAO,MAAM,SAAS;wBACM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;EAwE7D,CAAC"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/spawn.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA8BD,eAAO,MAAM,SAAS;wBACM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;EA+E7D,CAAC"}

package/src/cli/utils/spawn.js

@@ -58,12 +58,21 @@ export const SpawnUtil = Object.freeze({
                 throw wrapped;
             }
         };
-        const onSigint = () => forwardSignal('SIGINT');
-        const onSigterm = () => forwardSignal('SIGTERM');
-        if (forwardSignals) {
-            process.on('SIGINT', onSigint);
-            process.on('SIGTERM', onSigterm);
-        }
+        const onSigint = () => {
+            if (forwardSignals) {
+                forwardSignal('SIGINT');
+            }
+            // If not forwarding, handle to prevent the parent from exiting before the child
+            // finishes its graceful shutdown (child receives SIGINT directly in TTY).
+        };
+        const onSigterm = () => {
+            if (forwardSignals) {
+                forwardSignal('SIGTERM');
+            }
+            // Same rationale as SIGINT: keep parent alive while waiting for child to exit.
+        };
+        process.on('SIGINT', onSigint);
+        process.on('SIGTERM', onSigterm);
         try {
             const result = await new Promise((resolve, reject) => {
                 child.once('error', (error) => {
@@ -83,10 +92,8 @@ export const SpawnUtil = Object.freeze({
             throw ErrorFactory.createTryCatchError('Failed to spawn child process', error);
         }
         finally {
-            if (forwardSignals) {
-                process.off('SIGINT', onSigint);
-                process.off('SIGTERM', onSigterm);
-            }
+            process.off('SIGINT', onSigint);
+            process.off('SIGTERM', onSigterm);
         }
     },
 });

package/src/cli/workers/QueueWorkRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueueWorkRunner.d.ts","sourceRoot":"","sources":["../../../../src/cli/workers/QueueWorkRunner.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,CAAC;AAoBzD,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA0QF,eAAO,MAAM,eAAe;iBACP,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;qBAuCzD,OAAO,GAAG,aAAa;EAUxC,CAAC;AAEH,eAAe,eAAe,CAAC"}
+{"version":3,"file":"QueueWorkRunner.d.ts","sourceRoot":"","sources":["../../../../src/cli/workers/QueueWorkRunner.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,CAAC;AAoBzD,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA0QF,eAAO,MAAM,eAAe;iBACP,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;qBAuCzD,OAAO,GAAG,aAAa;EAUxC,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/src/cli/workers/QueueWorkRunner.js

@@ -52,23 +52,23 @@ let lockProviderCache = null;
 const getLockProviderForQueue = () => {
     if (lockProviderCache)
         return lockProviderCache;
-    const providerName = Env.get('QUEUE_LOCK_PROVIDER', ZintrustLang.REDIS).trim();
+    const providerDrive = queueConfig.default;
     const prefix = resolveLockPrefix();
     const defaultTtl = Env.getInt('QUEUE_DEFAULT_DEDUP_TTL', ZintrustLang.ZINTRUST_LOCKS_TTL);
-    const existing = getLockProvider(providerName);
+    const existing = getLockProvider(providerDrive);
     if (existing) {
         lockProviderCache = existing;
         return existing;
     }
     const provider = createLockProvider({
-        type: providerName === ZintrustLang.REDIS ? ZintrustLang.REDIS : ZintrustLang.MEMORY,
+        type: providerDrive === ZintrustLang.REDIS ? ZintrustLang.REDIS : ZintrustLang.MEMORY,
         prefix: prefix.length > 0 ? prefix : ZintrustLang.ZINTRUST_LOCKS_PREFIX,
         defaultTtl,
     });
-    registerLockProvider(providerName, provider);
+    registerLockProvider(providerDrive, provider);
     // Also register under the literal memory name to ensure callers that expect
     // a 'memory'-named provider (tests or other runtime code) can find it.
-    if (providerName !== ZintrustLang.MEMORY) {
+    if (providerDrive !== ZintrustLang.MEMORY) {
         try {
             registerLockProvider(ZintrustLang.MEMORY, provider);
         }

package/src/common/ExternalServiceUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExternalServiceUtils.d.ts","sourceRoot":"","sources":["../../../src/common/ExternalServiceUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,iBAAa,KAAG,MAS1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,MAAM,EAAE,KACjB,IAWF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,KAEjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAU,KAAK,MAAM,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,QAAQ,CAcnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,SAAS,OAAO,EAChB,OAAO,CAAC,EACR,QAAQ,MAAM,KACb;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAY9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;iBACU,MAAM;IAMnB;;OAEG;oBACa,MAAM;IAItB;;OAEG;8BACuB,MAAM,GAAG,OAAO;IAI1C;;OAEG;gCAEO,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,eACpD,MAAM,UACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IAYjC;;OAEG;+BAEO,WAAW,GAAG,WAAW,eACpB,MAAM,SACZ,KAAK,UACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CASlC,CAAC"}
+{"version":3,"file":"ExternalServiceUtils.d.ts","sourceRoot":"","sources":["../../../src/common/ExternalServiceUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,iBAAa,KAAG,MAe1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,MAAM,EAAE,KACjB,IAWF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,KAEjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAU,KAAK,MAAM,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,QAAQ,CAcnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,SAAS,OAAO,EAChB,OAAO,CAAC,EACR,QAAQ,MAAM,KACb;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAY9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;iBACU,MAAM;IAMnB;;OAEG;oBACa,MAAM;IAItB;;OAEG;8BACuB,MAAM,GAAG,OAAO;IAI1C;;OAEG;gCAEO,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,eACpD,MAAM,UACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IAYjC;;OAEG;+BAEO,WAAW,GAAG,WAAW,eACpB,MAAM,SACZ,KAAK,UACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CASlC,CAAC"}

package/src/common/ExternalServiceUtils.js

@@ -11,14 +11,19 @@ import { ErrorFactory } from '../exceptions/ZintrustError.js';
 export const readEnvString = (key, fallback = '') => {
     const anyEnv = Env;
     const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get(key, '') : '';
-    if (typeof fromEnv === 'string' && fromEnv.trim() !== '')
+    if (typeof fromEnv === 'string' && fromEnv.trim() !== '') {
         return fromEnv;
+    }
+    const getEnv = anyEnv[key];
+    if (typeof getEnv === 'string' && getEnv.trim() !== '') {
+        return getEnv;
+    }
     if (typeof process !== 'undefined') {
         const raw = process.env?.[key];
         if (typeof raw === 'string')
             return raw;
     }
-    return fromEnv ?? fallback;
+    return fallback;
 };
 /**
  * Validate required parameters for external service calls

package/src/config/env.d.ts

@@ -86,12 +86,17 @@ export declare const Env: Readonly<{
     ENABLE_MICROSERVICES: boolean;
     TOKEN_TTL: number;
     TOKEN_LENGTH: number;
+    CSRF_STORE: string;
+    CSRF_DRIVER: string;
+    CSRF_REDIS_DB: number;
     ENCRYPTION_CIPHER: string;
     ENVIRONMENT: string;
     REQUEST_TIMEOUT: number;
     APP_TIMEZONE: string;
     MAX_BODY_SIZE: number;
     SHUTDOWN_TIMEOUT: number;
+    SSE_HEARTBEAT_INTERVAL: number;
+    SSE_SNAPSHOT_INTERVAL: number;
     LOG_LEVEL: "debug" | "info" | "warn" | "error";
     LOG_FORMAT: string;
     LOG_CHANNEL: string;

package/src/config/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/config/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD,eAAO,MAAM,cAAc,QAAO,WAAW,GAAG,SAAwB,CAAC;AAEzE,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAKzE,CAAC;AAGF,eAAO,MAAM,GAAG,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,MAGxD,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,MAM3D,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,MAM7D,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,eAAe,OAAO,KAAG,OAK7D,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAO,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAKjE,CAAC;AAGF,eAAO,MAAM,GAAG;eApCS,MAAM,iBAAiB,MAAM,KAAG,MAAM;kBAKnC,MAAM,iBAAiB,MAAM,KAAG,MAAM;mBAgBrC,MAAM,iBAAiB,OAAO,KAAG,OAAO;oBARvC,MAAM,iBAAiB,MAAM,KAAG,MAAM;cA+BtB,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA6GpB,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmExF,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/config/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD,eAAO,MAAM,cAAc,QAAO,WAAW,GAAG,SAAwB,CAAC;AAEzE,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAKzE,CAAC;AAGF,eAAO,MAAM,GAAG,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,MAGxD,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,MAM3D,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,MAM7D,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,eAAe,OAAO,KAAG,OAK7D,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAO,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAKjE,CAAC;AAGF,eAAO,MAAM,GAAG;eApCS,MAAM,iBAAiB,MAAM,KAAG,MAAM;kBAKnC,MAAM,iBAAiB,MAAM,KAAG,MAAM;mBAgBrC,MAAM,iBAAiB,OAAO,KAAG,OAAO;oBARvC,MAAM,iBAAiB,MAAM,KAAG,MAAM;cA+BtB,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAoHpB,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmExF,CAAC"}

package/src/config/env.js

@@ -145,6 +145,9 @@ export const Env = Object.freeze({
     ENABLE_MICROSERVICES: getBool('ENABLE_MICROSERVICES', false),
     TOKEN_TTL: getInt('TOKEN_TTL', 3600000),
     TOKEN_LENGTH: getInt('TOKEN_LENGTH', 32),
+    CSRF_STORE: get('CSRF_STORE', ''),
+    CSRF_DRIVER: get('CSRF_DRIVER', ''),
+    CSRF_REDIS_DB: getInt('CSRF_REDIS_DB', 1),
     // Encryption interop
     ENCRYPTION_CIPHER: get('ENCRYPTION_CIPHER', ''),
     // Deployment
@@ -153,6 +156,9 @@ export const Env = Object.freeze({
     APP_TIMEZONE: get('APP_TIMEZONE', 'UTC'),
     MAX_BODY_SIZE: getInt('MAX_BODY_SIZE', 10485760),
     SHUTDOWN_TIMEOUT: getInt('SHUTDOWN_TIMEOUT', 10000),
+    // SSE
+    SSE_HEARTBEAT_INTERVAL: getInt('SSE_HEARTBEAT_INTERVAL', 15000),
+    SSE_SNAPSHOT_INTERVAL: getInt('SSE_SNAPSHOT_INTERVAL', 5000),
     // Logging
     LOG_LEVEL: get('LOG_LEVEL', getDefaultLogLevel()),
     LOG_FORMAT: get('LOG_FORMAT', 'text'),
@@ -187,7 +193,7 @@ export const Env = Object.freeze({
     // Template/Misc
     TEMPLATE_COPYRIGHT: get('TEMPLATE_COPYRIGHT', '© 2025 ZinTrust Framework. All rights reserved.'),
     SERVICE_NAME: get('SERVICE_NAME', ''),
-    APP_MODE: get('APP_MODE', ''),
+    APP_MODE: get('APP_MODE', get('NODE_ENV', 'development')),
     APP_PORT: getInt('APP_PORT', 3000),
     RUNTIME: get('RUNTIME', ''),
     // Paths (safely constructed for Node.js environments)

package/src/config/index.d.ts

@@ -217,7 +217,7 @@ export declare const config: Readonly<{
     readonly queue: {
         default: import("./type").QueueDriverName;
         drivers: import("./type").QueueDriversConfig;
-        getDriver: (this: import("./type").QueueConfigWithDrivers) => import("./type").QueueDriversConfig[import("./type").QueueDriverName];
+        getDriver: (driverConfig: import("./type").QueueConfigWithDrivers) => import("./type").QueueDriversConfig[import("./type").QueueDriverName];
         failed: {
             database: string;
             table: string;

package/src/config/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/config/logger.ts"],"names":[],"mappings":"AAQA,UAAU,OAAO;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClE;AA4VD,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,MAAM,EAAE,CAYtD,CAAC;AAEF,eAAO,MAAM,MAAM;qBAzJQ,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAsBjD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAoBhD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;qBAoB/C,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;qBA0BjD,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;yBAmDrC,OAAO,CAAC,MAAM,EAAE,CAAC;mBArBtB,MAAM,KAAG,OAAO;EA2ChD,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/config/logger.ts"],"names":[],"mappings":"AASA,UAAU,OAAO;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClE;AAiYD,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,MAAM,EAAE,CAYtD,CAAC;AAEF,eAAO,MAAM,MAAM;qBA5JQ,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAqBjD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAqBhD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;qBAqB/C,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;qBA2BjD,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;yBAoDrC,OAAO,CAAC,MAAM,EAAE,CAAC;mBArBtB,MAAM,KAAG,OAAO;EA2ChD,CAAC;AAEH,eAAe,MAAM,CAAC"}