@zintrust/core 0.1.1 → 0.1.3

package/src/performance/Optimizer.js

@@ -5,7 +5,37 @@
 import { Logger } from '../config/logger';
 import { ErrorFactory } from '../exceptions/ZintrustError';
 import { fs } from '../node-singletons/index.js';
-import * as path from 'node:path';
+import * as path from '../node-singletons/path';
+const GENERATION_CACHE_STATE_SYMBOL = Symbol.for('zintrust:GenerationCacheState');
+function isUnrefableTimer(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    return 'unref' in value && typeof value.unref === 'function';
+}
+function deleteFileNonBlocking(filePath) {
+    try {
+        const anyFs = fs;
+        if (typeof anyFs.promises?.unlink === 'function') {
+            void anyFs.promises.unlink(filePath).catch((err) => {
+                const maybeErr = err;
+                if (maybeErr.code === 'ENOENT')
+                    return;
+                Logger.error(`Failed to delete cache file: ${filePath} (${err instanceof Error ? err.message : String(err)})`);
+            });
+            return;
+        }
+        if (typeof anyFs.unlink === 'function') {
+            anyFs.unlink(filePath, (err) => {
+                if (err && err.code !== 'ENOENT') {
+                    Logger.error(`Failed to delete cache file: ${filePath} (${err.message})`);
+                }
+            });
+        }
+    }
+    catch (err) {
+        Logger.error(`Failed to schedule cache file deletion: ${filePath} (${err instanceof Error ? err.message : String(err)})`);
+    }
+}
 /**
  * Generation Cache - Cache generated code to avoid re-generating identical code
  * Sealed namespace for immutability
@@ -14,82 +44,127 @@ export const GenerationCache = Object.freeze({
     /**
      * Create a new generation cache instance
      */
-    create(cacheDir = path.join(process.cwd(), '.gen-cache'), ttlMs = 3600000) {
-        const state = {
-            cache: new Map(),
-            cacheDir,
-            ttlMs,
-        };
-        // Initialize
-        loadFromDisk(state);
-        // Active cleanup every 10 minutes
-        state.cleanupInterval = setInterval(() => {
-            const now = Date.now();
-            for (const [key, entry] of state.cache.entries()) {
-                if (now - entry.timestamp > state.ttlMs) {
-                    state.cache.delete(key);
-                    // Also try to delete from disk
-                    const file = path.join(state.cacheDir, `${key}.json`);
-                    if (fs.existsSync(file)) {
-                        fs.unlinkSync(file);
-                    }
-                }
-            }
-        }, 600000);
-        return {
-            /**
-             * Get from cache
-             */
-            get(type, params) {
-                const key = getCacheKey(type, params);
-                const entry = state.cache.get(key);
-                if (entry === undefined)
-                    return null;
-                // Check TTL
-                if (Date.now() - entry.timestamp > state.ttlMs) {
-                    state.cache.delete(key);
-                    const file = path.join(state.cacheDir, `${key}.json`);
-                    if (fs.existsSync(file)) {
-                        fs.unlinkSync(file);
-                    }
-                    return null;
-                }
-                return entry.code;
-            },
-            /**
-             * Set in cache
-             */
-            set(type, params, code) {
-                const key = getCacheKey(type, params);
-                state.cache.set(key, {
-                    code,
-                    timestamp: Date.now(),
-                });
-            },
-            /**
-             * Save cache to disk
-             */
-            save() {
-                saveCacheToDisk(state);
-            },
-            /**
-             * Clear cache
-             */
-            clear() {
-                if (state.cleanupInterval) {
-                    clearInterval(state.cleanupInterval);
-                }
-                clearCache(state);
-            },
-            /**
-             * Get cache statistics
-             */
-            getStats() {
-                return getCacheStats(state);
-            },
-        };
+    create(cacheDir = path.join(process.cwd(), '.gen-cache'), ttlMs = 3600000, maxEntries = 1000) {
+        const state = createCacheState(cacheDir, ttlMs, maxEntries);
+        initializeCacheState(state);
+        startCacheCleanup(state);
+        const instance = createCacheInstance(state);
+        attachCacheStateForTests(instance, state);
+        return instance;
     },
 });
+function createCacheState(cacheDir, ttlMs, maxEntries) {
+    return {
+        cache: new Map(),
+        cacheDir,
+        ttlMs,
+        maxEntries,
+    };
+}
+function initializeCacheState(state) {
+    loadFromDisk(state);
+}
+function startCacheCleanup(state) {
+    // Active cleanup every 10 minutes
+    state.cleanupInterval = setInterval(() => {
+        const now = Date.now();
+        for (const [key, entry] of state.cache.entries()) {
+            if (now - entry.timestamp > state.ttlMs) {
+                state.cache.delete(key);
+                const file = path.join(state.cacheDir, `${key}.json`);
+                deleteFileNonBlocking(file);
+            }
+        }
+        // Enforce maxEntries by evicting oldest keys
+        if (state.maxEntries !== undefined) {
+            while (state.cache.size > state.maxEntries) {
+                const oldestKey = state.cache.keys().next().value;
+                if (oldestKey === undefined)
+                    break;
+                state.cache.delete(oldestKey);
+                const file = path.join(state.cacheDir, `${oldestKey}.json`);
+                deleteFileNonBlocking(file);
+            }
+        }
+    }, 600000);
+    // Node: allow process to exit; other runtimes may not support unref()
+    if (isUnrefableTimer(state.cleanupInterval)) {
+        state.cleanupInterval.unref();
+    }
+}
+function createCacheInstance(state) {
+    return {
+        /**
+         * Get from cache
+         */
+        get(type, params) {
+            const key = getCacheKey(type, params);
+            const entry = state.cache.get(key);
+            if (entry === undefined)
+                return null;
+            // Check TTL
+            if (Date.now() - entry.timestamp > state.ttlMs) {
+                state.cache.delete(key);
+                const file = path.join(state.cacheDir, `${key}.json`);
+                deleteFileNonBlocking(file);
+                return null;
+            }
+            return entry.code;
+        },
+        /**
+         * Set in cache
+         */
+        set(type, params, code) {
+            const key = getCacheKey(type, params);
+            // If key already exists, delete first so insertion order updates for LRU
+            if (state.cache.has(key))
+                state.cache.delete(key);
+            state.cache.set(key, {
+                code,
+                timestamp: Date.now(),
+            });
+            // Enforce maxEntries immediately
+            if (state.maxEntries !== undefined) {
+                while (state.cache.size > state.maxEntries) {
+                    const oldest = state.cache.keys().next().value;
+                    if (oldest === undefined)
+                        break;
+                    state.cache.delete(oldest);
+                    const file = path.join(state.cacheDir, `${oldest}.json`);
+                    deleteFileNonBlocking(file);
+                }
+            }
+        },
+        /**
+         * Save cache to disk
+         */
+        save() {
+            saveCacheToDisk(state);
+        },
+        /**
+         * Clear cache
+         */
+        clear() {
+            if (state.cleanupInterval) {
+                clearInterval(state.cleanupInterval);
+                state.cleanupInterval = undefined;
+            }
+            clearCache(state);
+        },
+        /**
+         * Get cache statistics
+         */
+        getStats() {
+            return getCacheStats(state);
+        },
+    };
+}
+function attachCacheStateForTests(instance, state) {
+    Object.defineProperty(instance, GENERATION_CACHE_STATE_SYMBOL, {
+        value: state,
+        enumerable: false,
+    });
+}
 /**
  * Save cache to disk
  */

package/src/performance/establish-baseline.js

@@ -2,11 +2,11 @@
  * Establish Performance Baseline
  * Run all code generator benchmarks and save baseline metrics
  */
+import { esmFilePath } from '../common/index';
 import { Logger } from '../config/logger';
 import { fs } from '../node-singletons/index.js';
-import { fileURLToPath } from '../node-singletons/url';
+import * as path from '../node-singletons/path';
 import { CodeGenerationBenchmark } from './CodeGenerationBenchmark';
-import * as path from 'node:path';
 /**
  * Run baseline and save results
  */
@@ -25,7 +25,7 @@ function isMainModuleEsm() {
         const entry = process.argv[1];
         if (entry === undefined || entry === '')
             return false;
-        const currentFilePath = fileURLToPath(new URL(import.meta.url));
+        const currentFilePath = esmFilePath(import.meta.url);
         // Use realpathSync to handle symlinks (common on macOS /var -> /private/var)
         if (!('realpathSync' in fs)) {
             return path.resolve(entry) === path.resolve(currentFilePath);

package/src/runtime/PluginManager.d.ts

@@ -19,7 +19,9 @@ export declare const PluginManager: Readonly<{
     /**
      * Install a plugin
      */
-    install(pluginId: string): Promise<void>;
+    install(pluginId: string, options?: {
+        packageManager?: string;
+    }): Promise<void>;
     /**
      * Uninstall a plugin
      * Note: This does NOT uninstall dependencies to avoid breaking other things,

package/src/runtime/PluginManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginManager.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAQH,OAAO,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAwG3E,eAAO,MAAM,aAAa;IACxB;;OAEG;YACK,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIxC;;OAEG;yBACkB,MAAM,GAAG,MAAM,GAAG,IAAI;IAW3C;;OAEG;0BACyB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoCrD;;OAEG;sBACqB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9C;;;;OAIG;wBACuB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EA2ChD,CAAC"}
+{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginManager.ts"],"names":[],"mappings":"AAEA;;;GAGG;AASH,OAAO,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAoN3E,eAAO,MAAM,aAAa;IACxB;;OAEG;YACK,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIxC;;OAEG;yBACkB,MAAM,GAAG,MAAM,GAAG,IAAI;IAW3C;;OAEG;0BACyB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqCrD;;OAEG;sBACqB,MAAM,YAAY;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BrF;;;;OAIG;wBACuB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EA2ChD,CAAC"}

package/src/runtime/PluginManager.js

@@ -4,15 +4,54 @@
  * Plugin Manager
  * Handles installation and removal of framework plugins.
  */
+import { SpawnUtil } from '../cli/utils/spawn';
+import { esmDirname, resolvePackageManager } from '../common/index';
 import { Logger } from '../config/logger';
 import { ErrorFactory } from '../exceptions/ZintrustError';
 import { execSync } from '../node-singletons/child-process';
-import { fsPromises as fs } from '../node-singletons/fs';
+import { existsSync, fsPromises as fs } from '../node-singletons/fs';
 import * as path from '../node-singletons/path';
-import { fileURLToPath } from '../node-singletons/url';
 import { PluginRegistry } from './PluginRegistry';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const PROJECT_ROOT = path.resolve(__dirname, '../../');
+const __dirname = esmDirname(import.meta.url);
+const MAX_PACKAGE_ROOT_SEARCH_DEPTH = 20;
+function findPackageRoot(startDir) {
+    let current = startDir;
+    for (let i = 0; i < MAX_PACKAGE_ROOT_SEARCH_DEPTH; i++) {
+        if (existsSync(path.join(current, 'package.json')))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    // Fallback to a reasonable default if package.json isn't found.
+    return path.resolve(startDir, '../..');
+}
+function resolveProjectRoot() {
+    const fromEnv = process.env['ZINTRUST_PROJECT_ROOT'];
+    if (fromEnv !== undefined && fromEnv.trim().length > 0)
+        return fromEnv.trim();
+    return process.cwd();
+}
+function resolveTemplateRootOrThrow() {
+    const packageRoot = findPackageRoot(__dirname);
+    const candidates = [
+        // Monorepo/dev layout
+        path.join(packageRoot, 'src', 'templates'),
+        // Packed layout (if templates are shipped without src)
+        path.join(packageRoot, 'templates'),
+        // Common build output layout
+        path.join(packageRoot, 'dist', 'templates'),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    throw ErrorFactory.createNotFoundError('Plugin templates directory not found', {
+        candidates,
+        packageRoot,
+    });
+}
 function isStringRecord(value) {
     if (typeof value !== 'object' || value === null)
         return false;
@@ -40,17 +79,45 @@ function getPluginOrThrow(pluginId) {
     }
     return { resolvedId, plugin: PluginRegistry[resolvedId] };
 }
-function npmInstall(packages, options) {
+async function npmInstall(packages, options) {
     if (packages.length === 0)
         return;
     Logger.info(`Installing ${options.label}: ${packages.join(', ')}...`);
-    const devFlag = options.dev ? '-D ' : '';
+    const projectRoot = options.projectRoot ?? resolveProjectRoot();
+    const pm = options.packageManager ?? resolvePackageManager();
+    let cmd;
+    let args = [];
+    switch (pm) {
+        case 'pnpm':
+            cmd = 'pnpm';
+            args = ['add', ...packages, ...(options.dev ? ['-D'] : [])];
+            break;
+        case 'yarn':
+            cmd = 'yarn';
+            args = ['add', ...packages, ...(options.dev ? ['--dev'] : [])];
+            break;
+        case 'npm':
+        default:
+            cmd = 'npm';
+            args = ['install', ...(options.dev ? ['--save-dev'] : []), ...packages];
+            break;
+    }
     try {
-        const cmd = `npm install ${devFlag}${packages.join(' ')}`; // NOSONAR
-        execSync(cmd, {
-            stdio: 'inherit',
-            cwd: PROJECT_ROOT,
-        });
+        if (pm === 'npm') {
+            // Preserve legacy execSync behavior for npm so integration tests and simple CLI usage behave identically
+            const cmdStr = options.dev
+                ? `npm install -D ${packages.join(' ')}`
+                : `npm install ${packages.join(' ')}`; // NOSONAR
+            execSync(cmdStr, { stdio: 'inherit', cwd: projectRoot });
+        }
+        else {
+            const exit = await SpawnUtil.spawnAndWait({ command: cmd, args, cwd: projectRoot });
+            if (exit !== 0) {
+                throw ErrorFactory.createCliError(`Package manager ${pm} failed to install ${options.label}`, {
+                    exit,
+                });
+            }
+        }
     }
     catch (error) {
         ErrorFactory.createCliError(`Failed to install ${options.label}`, { error });
@@ -58,9 +125,20 @@ function npmInstall(packages, options) {
     }
 }
 async function copyPluginTemplates(plugin) {
+    const templateRoot = resolveTemplateRootOrThrow();
+    const projectRoot = resolveProjectRoot();
     for (const template of plugin.templates) {
-        const sourcePath = path.join(PROJECT_ROOT, 'src/templates', template.source);
-        const destPath = path.join(PROJECT_ROOT, template.destination);
+        const sourcePath = path.join(templateRoot, template.source);
+        const destPath = path.join(projectRoot, template.destination);
+        // Prevent path traversal: resolved destination must be within project root
+        const resolvedDest = path.resolve(destPath);
+        const resolvedProjectRoot = path.resolve(projectRoot);
+        if (!(resolvedDest === resolvedProjectRoot ||
+            resolvedDest.startsWith(resolvedProjectRoot + path.sep))) {
+            throw ErrorFactory.createCliError(`Invalid template destination: ${template.destination}`, {
+                destination: template.destination,
+            });
+        }
         Logger.info(`Copying ${template.source} to ${template.destination}...`);
         try {
             // Ensure destination directory exists
@@ -78,16 +156,25 @@ async function copyPluginTemplates(plugin) {
 function runPostInstall(plugin) {
     if (!plugin.postInstall)
         return;
+    const projectRoot = resolveProjectRoot();
     if (plugin.postInstall.command !== undefined) {
-        Logger.info(`Running post-install command: ${plugin.postInstall.command}...`);
-        try {
-            execSync(plugin.postInstall.command, {
-                stdio: 'inherit',
-                cwd: PROJECT_ROOT,
-            });
+        // Post-install command execution is opt-in. To avoid arbitrary command execution
+        // and reduce supply-chain risk, we only execute when ZINTRUST_ALLOW_POSTINSTALL=1
+        const allow = String(process.env['ZINTRUST_ALLOW_POSTINSTALL'] ?? '').trim() === '1';
+        if (allow) {
+            Logger.info(`Running post-install command: ${plugin.postInstall.command}...`);
+            try {
+                execSync(plugin.postInstall.command, {
+                    stdio: 'inherit',
+                    cwd: projectRoot,
+                });
+            }
+            catch (error) {
+                ErrorFactory.createCliError('Post-install command failed', { error });
+            }
         }
-        catch (error) {
-            ErrorFactory.createCliError('Post-install command failed', { error });
+        else {
+            Logger.info(`Post-install command available but not executed (ZINTRUST_ALLOW_POSTINSTALL!=1): ${plugin.postInstall.command}`);
         }
     }
     if (plugin.postInstall.message !== undefined && plugin.postInstall.message.length > 0) {
@@ -125,14 +212,15 @@ export const PluginManager = Object.freeze({
             throw ErrorFactory.createNotFoundError(`Plugin ${pluginId} not found`, { pluginId });
         }
         const plugin = PluginRegistry[resolvedId];
+        const projectRoot = resolveProjectRoot();
         // Check if the main template file exists in the destination
         // We assume if the first template exists, the plugin is "installed"
         if (plugin.templates.length > 0) {
-            const destPath = path.join(PROJECT_ROOT, plugin.templates[0].destination);
+            const destPath = path.join(projectRoot, plugin.templates[0].destination);
             try {
                 await fs.access(destPath);
                 // Also check if dependencies are in package.json
-                const packageJsonPath = path.join(PROJECT_ROOT, 'package.json');
+                const packageJsonPath = path.join(projectRoot, 'package.json');
                 const packageJsonText = await fs.readFile(packageJsonPath, 'utf-8');
                 const packageJson = parsePackageJsonDeps(packageJsonText);
                 const hasDeps = plugin.dependencies.every((dep) => packageJson.dependencies?.[dep] ?? packageJson.devDependencies?.[dep] ?? '');
@@ -148,15 +236,23 @@ export const PluginManager = Object.freeze({
     /**
      * Install a plugin
      */
-    async install(pluginId) {
+    async install(pluginId, options) {
         const { plugin } = getPluginOrThrow(pluginId);
         Logger.info(`Installing plugin: ${plugin.name}...`);
-        // 1. Install dependencies
-        npmInstall(plugin.dependencies, { dev: false, label: 'dependencies' });
-        npmInstall(plugin.devDependencies, { dev: true, label: 'dev dependencies' });
+        // 1. Install dependencies (use SpawnUtil and support multiple package managers)
+        await npmInstall(plugin.dependencies, {
+            dev: false,
+            label: 'dependencies',
+            packageManager: options?.packageManager,
+        });
+        await npmInstall(plugin.devDependencies, {
+            dev: true,
+            label: 'dev dependencies',
+            packageManager: options?.packageManager,
+        });
         // 2. Copy templates
         await copyPluginTemplates(plugin);
-        // 3. Post-Install
+        // 3. Post-Install (still executed via execSync - opt-in)
         runPostInstall(plugin);
         Logger.info(`✓ Plugin ${plugin.name} installed successfully`);
     },

package/src/runtime/RuntimeDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RuntimeDetector.d.ts","sourceRoot":"","sources":["../../../src/runtime/RuntimeDetector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAyJzF,eAAO,MAAM,eAAe;;;yBA9GF,MAAM;4BAyBD,aAAa,KAAG,cAAc;uCAQnB,MAAM,UAAU,aAAa,KAAG,cAAc;0BAuD7D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EA6BhD,CAAC;AAuFH,eAAO,MAAM,oBAAoB;0BA7EE,eAAe,KAAG,OAAO,CAAC,IAAI,CAAC;wBAwDlC,MAAM,KAAe,OAAO,CAAC,IAAI,CAAC;iCAYhC,IAAI;EAapC,CAAC"}
+{"version":3,"file":"RuntimeDetector.d.ts","sourceRoot":"","sources":["../../../src/runtime/RuntimeDetector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAyJzF,eAAO,MAAM,eAAe;;;yBA9GF,MAAM;4BAyBD,aAAa,KAAG,cAAc;uCAQnB,MAAM,UAAU,aAAa,KAAG,cAAc;0BAuD7D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EA6BhD,CAAC;AA8IH,eAAO,MAAM,oBAAoB;0BAtGE,eAAe,KAAG,OAAO,CAAC,IAAI,CAAC;wBA0DlC,MAAM,KAAe,OAAO,CAAC,IAAI,CAAC;iCAmChC,IAAI;EAapC,CAAC"}

package/src/runtime/RuntimeDetector.js

@@ -1,5 +1,6 @@
 import { Env } from '../config/env';
 import Logger from '../config/logger';
+import { ErrorFactory } from '../exceptions/ZintrustError';
 import { CloudflareAdapter } from './adapters/CloudflareAdapter';
 import { DenoAdapter } from './adapters/DenoAdapter';
 import { FargateAdapter } from './adapters/FargateAdapter';
@@ -134,6 +135,26 @@ export const RuntimeDetector = Object.freeze({
     createAdapterForRuntime,
     getRuntimeInfo,
 });
+const runtimeState = {
+    isShuttingDown: false,
+};
+const withTimeout = async (promise, timeoutMs, label) => {
+    if (timeoutMs <= 0)
+        return promise;
+    let timeoutId;
+    try {
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = globalThis.setTimeout(() => {
+                reject(ErrorFactory.createGeneralError(label, { timeoutMs }));
+            }, timeoutMs);
+        });
+        return await Promise.race([promise, timeoutPromise]);
+    }
+    finally {
+        if (timeoutId !== undefined)
+            globalThis.clearTimeout(timeoutId);
+    }
+};
 /**
  * Application bootstrap factory
  * Creates and configures runtime-appropriate HTTP handler
@@ -150,6 +171,8 @@ const initialize = async (handler) => {
     };
     const runtime = detectRuntime();
     const adapter = createAdapterForRuntime(runtime, config);
+    runtimeState.adapter = adapter;
+    runtimeState.runtime = runtime;
     const logger = adapter.getLogger();
     const runtimeInfo = getRuntimeInfo();
     logger.info('Application initializing', runtimeInfo);
@@ -163,7 +186,7 @@ const initialize = async (handler) => {
             if (serverAdapter.startServer !== undefined) {
                 await serverAdapter.startServer(port, host);
             }
-            break;
+            return;
         }
         case 'deno': {
             const port = Env.PORT;
@@ -172,13 +195,13 @@ const initialize = async (handler) => {
             if (serverAdapter.startServer !== undefined) {
                 await serverAdapter.startServer(port, host);
             }
-            break;
+            return;
         }
         case 'lambda':
         case 'cloudflare':
             // These platforms handle request routing externally
             logger.info('Adapter initialized, ready for events');
-            break;
+            return;
     }
 };
 /**
@@ -187,9 +210,27 @@ const initialize = async (handler) => {
 const shutdown = async (signal = 'SIGTERM') => {
     const logger = createDefaultLogger();
     logger.info(`Received ${signal}, gracefully shutting down...`);
-    // Perform cleanup tasks
-    process.exit(0);
-    return Promise.resolve();
+    if (runtimeState.isShuttingDown) {
+        process.exit(0);
+        return;
+    }
+    runtimeState.isShuttingDown = true;
+    const timeoutMs = Number(Env.SHUTDOWN_TIMEOUT);
+    try {
+        const adapter = runtimeState.adapter;
+        if (typeof adapter?.stop === 'function') {
+            await withTimeout(adapter.stop(), timeoutMs, 'Runtime adapter shutdown timed out');
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        logger.error('Graceful shutdown failed', error);
+        process.exit(1);
+    }
+    finally {
+        // In real runtimes `process.exit(...)` ends execution, but in tests it's mocked.
+        runtimeState.isShuttingDown = false;
+    }
 };
 /**
  * Setup graceful shutdown handlers

package/src/runtime/adapters/CloudflareAdapter.js

@@ -1,7 +1,7 @@
 /**
  * Runtime adapter for Cloudflare Workers
  */
-import { Env } from '../../config/env';
+import { appConfig } from '../../config';
 import { Logger } from '../../config/logger';
 import { createMockHttpObjects, ErrorResponse, HttpResponse, } from '../RuntimeAdapter';
 /**
@@ -101,7 +101,7 @@ async function handleCloudflareRequest(adapter, config, logger, event) {
     }
     catch (error) {
         Logger.error('Cloudflare handler error', error);
-        const errorResponse = ErrorResponse.create(500, 'Internal Server Error', Env.NODE_ENV === 'development' ? { message: error.message } : undefined);
+        const errorResponse = ErrorResponse.create(500, 'Internal Server Error', appConfig.isDevelopment() ? { message: error.message } : undefined);
         return errorResponse.toResponse();
     }
 }

package/src/runtime/adapters/FargateAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FargateAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/FargateAdapter.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,aAAa,EAGb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,eAAe,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,KACjE,MAAM,CAAC;AAEZ,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,GAAG;IAC5E,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CA2DA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc;;EAEzB,CAAC;AAEH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,iBAAgC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgB1F;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAIpD;AAED,wBAAgB,0BAA0B,IAAI,aAAa,CAAC,QAAQ,CAAC,CAUpE"}
+{"version":3,"file":"FargateAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/FargateAdapter.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,aAAa,EAGb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,eAAe,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,KACjE,MAAM,CAAC;AAEZ,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,GAAG;IAC5E,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CA0DA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc;;EAEzB,CAAC;AAEH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,iBAAgC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgB1F;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAIpD;AAED,wBAAgB,0BAA0B,IAAI,aAAa,CAAC,QAAQ,CAAC,CAUpE"}

package/src/runtime/adapters/FargateAdapter.js

@@ -14,10 +14,11 @@ export function createFargateAdapter(config) {
     const state = {};
     return {
         platform: 'fargate',
+        // eslint-disable-next-line @typescript-eslint/require-await
         async handle(_event, _context) {
             // Fargate adapter doesn't handle individual requests
             // Instead, use startServer() to run continuous HTTP server
-            return Promise.reject(ErrorFactory.createConfigError('Fargate adapter requires startServer() method. Use RuntimeDetector for automatic initialization.'));
+            throw ErrorFactory.createConfigError('Fargate adapter requires startServer() method. Use RuntimeDetector for automatic initialization.');
         },
         parseRequest(_event) {
             throw ErrorFactory.createConfigError('Fargate adapter uses native Node.js HTTP server');

package/src/runtime/adapters/LambdaAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LambdaAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/LambdaAdapter.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,aAAa,EAKb,cAAc,EACf,MAAM,yBAAyB,CAAC;AASjC;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;mBACY,aAAa,GAAG,cAAc;EA8D7C,CAAC"}
+{"version":3,"file":"LambdaAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/LambdaAdapter.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,aAAa,EAKb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;mBACY,aAAa,GAAG,cAAc;EA8D7C,CAAC"}

package/src/runtime/adapters/LambdaAdapter.js

@@ -3,8 +3,8 @@
  */
 import { Env } from '../../config/env';
 import { Logger } from '../../config/logger';
+import { IncomingMessage, ServerResponse, } from '../../node-singletons/http';
 import { ErrorResponse, HttpResponse, } from '../RuntimeAdapter';
-import { IncomingMessage, ServerResponse, } from 'node:http';
 /**
  * AWS Lambda adapter for API Gateway and ALB events
  * Converts Lambda events to standard HTTP format for Zintrust framework
@@ -95,7 +95,9 @@ async function handleLambdaRequest(adapter, config, event, _context) {
     }
     catch (error) {
         Logger.error('Lambda handler error', error);
-        const errorResponse = ErrorResponse.create(500, 'Internal Server Error', Env.NODE_ENV === 'development' ? { message: error.message } : undefined);
+        const nodeEnv = typeof Env.NODE_ENV === 'string' && Env.NODE_ENV !== '' ? Env.NODE_ENV : 'development';
+        const includeDetails = nodeEnv === 'development' || nodeEnv === 'dev';
+        const errorResponse = ErrorResponse.create(500, 'Internal Server Error', includeDetails ? { message: error.message } : undefined);
         return errorResponse.toResponse();
     }
 }