@zintrust/core 0.1.19 → 0.1.20

package/src/routing/errorPages.js

@@ -0,0 +1,103 @@
+/**
+ * Error Pages Static Assets
+ * Serves /error-pages/* assets (CSS/JS/SVG/etc) used by HTML error templates.
+ */
+import { HTTP_HEADERS, MIME_TYPES } from '../config/constants.js';
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+import * as fs from '../node-singletons/fs.js';
+import * as path from '../node-singletons/path.js';
+import { MIME_TYPES_MAP, resolveSafePath, tryDecodeURIComponent } from './common.js';
+import { getPublicRoot } from './publicRoot.js';
+import { Router } from './Router.js';
+const servePublicRootFile = (relativePath, response, contentType) => {
+    const publicRoot = getPublicRoot();
+    const filePath = path.join(publicRoot, relativePath);
+    try {
+        if (!fs.existsSync(filePath) || fs.statSync(filePath).isDirectory()) {
+            response.setStatus(404);
+            response.setHeader(HTTP_HEADERS.CONTENT_TYPE, MIME_TYPES.TEXT);
+            response.send('Not Found');
+            return;
+        }
+        const content = fs.readFileSync(filePath);
+        response.setStatus(200);
+        response.setHeader(HTTP_HEADERS.CONTENT_TYPE, contentType);
+        response.send(content);
+        return;
+    }
+    catch (error) {
+        ErrorFactory.createTryCatchError(`Error serving public file ${filePath}`, error);
+        response.setStatus(500);
+        response.setHeader(HTTP_HEADERS.CONTENT_TYPE, MIME_TYPES.TEXT);
+        response.send('Internal Server Error');
+        return;
+    }
+};
+export const serveErrorPagesFile = (urlPath, response) => {
+    if (urlPath === '/error-pages' || urlPath === '/error-pages/') {
+        response.setStatus(404);
+        response.setHeader(HTTP_HEADERS.CONTENT_TYPE, MIME_TYPES.TEXT);
+        response.send('Not Found');
+        return true;
+    }
+    if (!urlPath.startsWith('/error-pages/'))
+        return false;
+    const publicRoot = getPublicRoot();
+    const baseDir = path.join(publicRoot, 'error-pages');
+    const rawRelative = urlPath.slice('/error-pages/'.length);
+    const normalizedRelative = tryDecodeURIComponent(rawRelative).replaceAll('\\', '/');
+    const filePath = resolveSafePath(baseDir, normalizedRelative);
+    if (filePath === undefined) {
+        response.setStatus(404);
+        response.setHeader(HTTP_HEADERS.CONTENT_TYPE, MIME_TYPES.TEXT);
+        response.send('Not Found');
+        return true;
+    }
+    try {
+        if (fs.existsSync(filePath) && fs.statSync(filePath).isDirectory()) {
+            response.setStatus(404);
+            response.setHeader(HTTP_HEADERS.CONTENT_TYPE, MIME_TYPES.TEXT);
+            response.send('Not Found');
+            return true;
+        }
+        if (!fs.existsSync(filePath)) {
+            response.setStatus(404);
+            response.setHeader(HTTP_HEADERS.CONTENT_TYPE, MIME_TYPES.TEXT);
+            response.send('Not Found');
+            return true;
+        }
+        const ext = path.extname(filePath).toLowerCase();
+        const contentType = MIME_TYPES_MAP[ext] || 'application/octet-stream';
+        const content = fs.readFileSync(filePath);
+        response.setStatus(200);
+        response.setHeader(HTTP_HEADERS.CONTENT_TYPE, contentType);
+        response.send(content);
+        return true;
+    }
+    catch (error) {
+        ErrorFactory.createTryCatchError(`Error serving error-pages file ${filePath}`, error);
+        response.setStatus(500);
+        response.setHeader(HTTP_HEADERS.CONTENT_TYPE, MIME_TYPES.TEXT);
+        response.send('Internal Server Error');
+        return true;
+    }
+};
+const handleErrorPagesRequest = (req, res) => {
+    const urlPath = req.getPath();
+    if (serveErrorPagesFile(urlPath, res))
+        return;
+    res.setStatus(404);
+    res.setHeader(HTTP_HEADERS.CONTENT_TYPE, MIME_TYPES.TEXT);
+    res.send('Not Found');
+};
+const handleZintrustSvgRequest = (_req, res) => {
+    servePublicRootFile('zintrust.svg', res, MIME_TYPES.SVG);
+};
+export const registerErrorPagesRoutes = (router) => {
+    Router.get(router, '/error-pages', handleErrorPagesRequest);
+    Router.get(router, '/error-pages/', handleErrorPagesRequest);
+    Router.get(router, '/error-pages/:path*', handleErrorPagesRequest);
+    // Used by the HTML error templates (logo in footer).
+    Router.get(router, '/zintrust.svg', handleZintrustSvgRequest);
+};
+export default { registerErrorPagesRoutes, serveErrorPagesFile };

package/src/routing/publicRoot.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Public Root Resolution
+ * Determines where framework/app static assets live (public/ or dist/public).
+ */
+/**
+ * Find the package root directory.
+ */
+export declare const findPackageRoot: (startDir: string) => string;
+/**
+ * Framework public roots (dist/public preferred).
+ */
+export declare const getFrameworkPublicRoots: () => string[];
+/**
+ * Resolve the effective public root.
+ * Prefers app-local `public/` when present; otherwise falls back to framework public roots.
+ */
+export declare const getPublicRoot: () => string;
+//# sourceMappingURL=publicRoot.d.ts.map

package/src/routing/publicRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicRoot.d.ts","sourceRoot":"","sources":["../../../src/routing/publicRoot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,KAAG,MASlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAO,MAAM,EAIhD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAO,MAgBhC,CAAC"}

package/src/routing/publicRoot.js

@@ -0,0 +1,49 @@
+/**
+ * Public Root Resolution
+ * Determines where framework/app static assets live (public/ or dist/public).
+ */
+import { esmDirname } from '../common/index.js';
+import * as fs from '../node-singletons/fs.js';
+import * as path from '../node-singletons/path.js';
+/**
+ * Find the package root directory.
+ */
+export const findPackageRoot = (startDir) => {
+    let current = startDir;
+    for (let i = 0; i < 10; i++) {
+        if (fs.existsSync(path.join(current, 'package.json')))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return startDir;
+};
+/**
+ * Framework public roots (dist/public preferred).
+ */
+export const getFrameworkPublicRoots = () => {
+    const thisDir = esmDirname(import.meta.url);
+    const packageRoot = findPackageRoot(thisDir);
+    return [path.join(packageRoot, 'dist/public'), path.join(packageRoot, 'public')];
+};
+/**
+ * Resolve the effective public root.
+ * Prefers app-local `public/` when present; otherwise falls back to framework public roots.
+ */
+export const getPublicRoot = () => {
+    const appRoots = [path.join(process.cwd(), 'public')];
+    const candidates = [...appRoots, ...getFrameworkPublicRoots()];
+    // Prefer a root that contains an index.html (common for docs + dev portal).
+    const hasIndex = (root) => fs.existsSync(path.join(root, 'index.html'));
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate) && hasIndex(candidate))
+            return candidate;
+    }
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return candidates[0];
+};

package/src/runtime/PluginAutoImports.d.ts

@@ -0,0 +1,21 @@
+type ImportResult = {
+    ok: true;
+    loadedPath: string;
+} | {
+    ok: false;
+    loadedPath?: string;
+    reason: 'not-found' | 'import-failed';
+    errorMessage?: string;
+};
+export declare const PluginAutoImports: Readonly<{
+    /**
+     * Best-effort import of a project's `src/zintrust.plugins.ts` file.
+     *
+     * This file is generated/maintained by `zin plugin install` and contains
+     * side-effect imports (e.g. `@zintrust/db-mysql/register`) which register
+     * adapters/drivers into core registries.
+     */
+    tryImportProjectAutoImports(): Promise<ImportResult>;
+}>;
+export {};
+//# sourceMappingURL=PluginAutoImports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginAutoImports.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginAutoImports.ts"],"names":[],"mappings":"AAMA,KAAK,YAAY,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAmBN,eAAO,MAAM,iBAAiB;IAC5B;;;;;;OAMG;mCACkC,OAAO,CAAC,YAAY,CAAC;EAgC1D,CAAC"}

package/src/runtime/PluginAutoImports.js

@@ -0,0 +1,59 @@
+import { pathToFileURL } from '../node-singletons/url.js';
+import { Logger } from '../config/logger.js';
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+import { existsSync } from '../node-singletons/fs.js';
+import * as path from '../node-singletons/path.js';
+const resolveProjectRoot = () => {
+    const fromEnv = process.env['ZINTRUST_PROJECT_ROOT'];
+    if (typeof fromEnv === 'string' && fromEnv.trim().length > 0)
+        return fromEnv.trim();
+    return process.cwd();
+};
+const getCandidates = (projectRoot) => {
+    return [
+        // Dev (tsx)
+        path.join(projectRoot, 'src', 'zintrust.plugins.ts'),
+        // Production build output (most common)
+        path.join(projectRoot, 'dist', 'src', 'zintrust.plugins.js'),
+        // Fallback (in case someone transpiles without /dist)
+        path.join(projectRoot, 'src', 'zintrust.plugins.js'),
+    ];
+};
+export const PluginAutoImports = Object.freeze({
+    /**
+     * Best-effort import of a project's `src/zintrust.plugins.ts` file.
+     *
+     * This file is generated/maintained by `zin plugin install` and contains
+     * side-effect imports (e.g. `@zintrust/db-mysql/register`) which register
+     * adapters/drivers into core registries.
+     */
+    async tryImportProjectAutoImports() {
+        const projectRoot = resolveProjectRoot();
+        const candidates = getCandidates(projectRoot);
+        for (const candidate of candidates) {
+            if (!existsSync(candidate))
+                continue;
+            try {
+                const url = pathToFileURL(candidate).href;
+                // eslint-disable-next-line no-await-in-loop
+                await import(url);
+                return { ok: true, loadedPath: candidate };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                Logger.warn('[plugins] Failed to import plugin auto-imports', {
+                    candidate,
+                    errorMessage,
+                });
+                // Keep error creation for consistent structure (but do not throw).
+                ErrorFactory.createTryCatchError('Failed to import project plugin auto-imports', {
+                    candidate,
+                    error,
+                });
+                return { ok: false, loadedPath: candidate, reason: 'import-failed', errorMessage };
+            }
+        }
+        Logger.debug('[plugins] No plugin auto-imports file found', { projectRoot, candidates });
+        return { ok: false, reason: 'not-found' };
+    },
+});

package/src/runtime/PluginManager.d.ts

@@ -1,8 +1,4 @@
-/**
- * Plugin Manager
- * Handles installation and removal of framework plugins.
- */
-import { PluginDefinition } from './PluginRegistry';
+import type { PluginDefinition } from './PluginRegistry';
 export declare const PluginManager: Readonly<{
     /**
      * List all available plugins

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;AASH,OAAO,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AA6Q3E,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;IA0DrD;;OAEG;sBACqB,MAAM,YAAY;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrF;;;;OAIG;wBACuB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EA2ChD,CAAC"}
+{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginManager.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AA0R/D,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;IA0DrD;;OAEG;sBACqB,MAAM,YAAY;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrF;;;;OAIG;wBACuB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EA2ChD,CAAC"}

package/src/runtime/PluginManager.js

@@ -1,14 +1,13 @@
 /* eslint-disable @typescript-eslint/require-await */
-/* eslint-disable no-await-in-loop */
 /**
  * Plugin Manager
  * Handles installation and removal of framework plugins.
  */
+import { execSync } from '../node-singletons/child-process.js';
 import { SpawnUtil } from '../cli/utils/spawn.js';
 import { esmDirname, resolvePackageManager } from '../common/index.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
-import { execSync } from '../node-singletons/child-process.js';
 import { existsSync, fsPromises as fs } from '../node-singletons/fs.js';
 import * as path from '../node-singletons/path.js';
 import { PluginRegistry } from './PluginRegistry.js';
@@ -88,6 +87,21 @@ async function npmInstall(packages, options) {
     Logger.info(`Installing ${options.label}: ${packages.join(', ')}...`);
     const projectRoot = options.projectRoot ?? resolveProjectRoot();
     const pm = options.packageManager ?? resolvePackageManager();
+    // Legacy behavior: npm uses execSync in this framework.
+    // This keeps behavior predictable for CI/test environments and matches existing unit tests.
+    if (pm === 'npm') {
+        const cmd = options.dev
+            ? `npm install -D ${packages.join(' ')}`
+            : `npm install ${packages.join(' ')}`;
+        try {
+            execSync(cmd, { cwd: projectRoot, stdio: 'inherit' });
+            return;
+        }
+        catch (error) {
+            ErrorFactory.createCliError(`Failed to install ${options.label}`, { error });
+            throw error;
+        }
+    }
     let cmd;
     let args = [];
     switch (pm) {
@@ -106,20 +120,12 @@ async function npmInstall(packages, options) {
             break;
     }
     try {
-        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,
-                });
-            }
+        // Use async spawn for all package managers to avoid blocking event loop
+        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) {
@@ -130,7 +136,8 @@ async function npmInstall(packages, options) {
 async function copyPluginTemplates(plugin) {
     const templateRoot = resolveTemplateRootOrThrow();
     const projectRoot = resolveProjectRoot();
-    for (const template of plugin.templates) {
+    // Parallelize file operations using Promise.all
+    await Promise.all(plugin.templates.map(async (template) => {
         const sourcePath = path.join(templateRoot, template.source);
         const destPath = path.join(projectRoot, template.destination);
         // Prevent path traversal: resolved destination must be within project root
@@ -154,7 +161,7 @@ async function copyPluginTemplates(plugin) {
             ErrorFactory.createCliError(`Failed to copy template ${template.source}`, { error });
             throw error;
         }
-    }
+    }));
 }
 async function ensurePluginAutoImports(plugin) {
     const rawImports = plugin.autoImports;

package/src/runtime/RuntimeDetector.d.ts

@@ -1,4 +1,4 @@
-import { AdapterConfig, RuntimeAdapter, ZintrustHandler } from './RuntimeAdapter';
+import type { AdapterConfig, RuntimeAdapter, ZintrustHandler } from './RuntimeAdapter';
 export declare const RuntimeDetector: Readonly<{
     RUNTIME_VAR: "RUNTIME";
     AUTO: "auto";

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

@@ -1 +1 @@
-{"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;AAkKzF,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"}
+{"version":3,"file":"RuntimeDetector.d.ts","sourceRoot":"","sources":["../../../src/runtime/RuntimeDetector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAkK9F,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/adapters/CloudflareAdapter.d.ts

@@ -1,4 +1,4 @@
-import { AdapterConfig, RuntimeAdapter } from '../RuntimeAdapter';
+import type { AdapterConfig, RuntimeAdapter } from '../RuntimeAdapter';
 /**
  * Cloudflare Workers adapter for Cloudflare's edge compute platform
  * Uses fetch API and handles D1 database, KV storage bindings

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

@@ -1 +1 @@
-{"version":3,"file":"CloudflareAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/CloudflareAdapter.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,aAAa,EAMb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;mBACY,aAAa,GAAG,cAAc;IAoD7C;;;OAGG;qBACc,OAAO;IAKxB;;;OAGG;qBACc,MAAM,GAAG,OAAO;EAIjC,CAAC;AA4IH;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACjC,EAAE,CAAC,EAAE;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH"}
+{"version":3,"file":"CloudflareAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/CloudflareAdapter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EAGb,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAOjD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;mBACY,aAAa,GAAG,cAAc;IAoD7C;;;OAGG;qBACc,OAAO;IAKxB;;;OAGG;qBACc,MAAM,GAAG,OAAO;EAIjC,CAAC;AA4IH;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACjC,EAAE,CAAC,EAAE;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH"}

package/src/runtime/adapters/CloudflareAdapter.js

@@ -3,7 +3,7 @@
  */
 import { appConfig } from '../../config/index.js';
 import { Logger } from '../../config/logger.js';
-import { createMockHttpObjects, ErrorResponse, HttpResponse, } from '../RuntimeAdapter.js';
+import { createMockHttpObjects, ErrorResponse, HttpResponse } from '../RuntimeAdapter.js';
 /**
  * Cloudflare Workers adapter for Cloudflare's edge compute platform
  * Uses fetch API and handles D1 database, KV storage bindings

package/src/runtime/adapters/DenoAdapter.d.ts

@@ -1,4 +1,4 @@
-import { AdapterConfig, RuntimeAdapter } from '../RuntimeAdapter';
+import type { AdapterConfig, RuntimeAdapter } from '../RuntimeAdapter';
 /**
  * Deno runtime adapter for Deno Deploy and edge compute environments
  * Sealed namespace for immutability

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

@@ -1 +1 @@
-{"version":3,"file":"DenoAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/DenoAdapter.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,aAAa,EAKb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;mBACY,aAAa,GAAG,cAAc,GAAG;QAC9C,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1D;IAwDD;;OAEG;yBAEQ,cAAc,SACjB,MAAM,SACN,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;aACY,OAAO,CAAC,OAAO,CAAC;IAK/B;;OAEG;mBACY,MAAM,iBAAiB,MAAM,GAAG,MAAM;IAKrD;;OAEG;2BACoB,OAAO;EAI9B,CAAC"}
+{"version":3,"file":"DenoAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/DenoAdapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EAGb,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAMjD;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;mBACY,aAAa,GAAG,cAAc,GAAG;QAC9C,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1D;IAwDD;;OAEG;yBAEQ,cAAc,SACjB,MAAM,SACN,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;aACY,OAAO,CAAC,OAAO,CAAC;IAK/B;;OAEG;mBACY,MAAM,iBAAiB,MAAM,GAAG,MAAM;IAKrD;;OAEG;2BACoB,OAAO;EAI9B,CAAC"}

package/src/runtime/adapters/DenoAdapter.js

@@ -2,7 +2,7 @@
  * Runtime adapter for Deno
  */
 import Logger from '../../config/logger.js';
-import { createMockHttpObjects, ErrorResponse, } from '../RuntimeAdapter.js';
+import { createMockHttpObjects, ErrorResponse } from '../RuntimeAdapter.js';
 /**
  * Deno runtime adapter for Deno Deploy and edge compute environments
  * Sealed namespace for immutability

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

@@ -1,4 +1,4 @@
-import { AdapterConfig, RuntimeAdapter } from '../RuntimeAdapter';
+import type { AdapterConfig, RuntimeAdapter } from '../RuntimeAdapter';
 /**
  * AWS Lambda adapter for API Gateway and ALB events
  * Converts Lambda events to standard HTTP format for Zintrust framework

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":"AAYA,OAAO,EACL,aAAa,EAKb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;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,KAAK,EACV,aAAa,EAGb,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAMjD;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;mBACY,aAAa,GAAG,cAAc;EA8D7C,CAAC"}

package/src/runtime/adapters/LambdaAdapter.js

@@ -4,7 +4,7 @@
 import { Env } from '../../config/env.js';
 import { Logger } from '../../config/logger.js';
 import { IncomingMessage, ServerResponse, } from '../../node-singletons/http.js';
-import { ErrorResponse, HttpResponse, } from '../RuntimeAdapter.js';
+import { ErrorResponse, HttpResponse } from '../RuntimeAdapter.js';
 /**
  * AWS Lambda adapter for API Gateway and ALB events
  * Converts Lambda events to standard HTTP format for Zintrust framework

package/src/runtime/adapters/NodeServerAdapter.d.ts

@@ -1,4 +1,4 @@
-import { AdapterConfig, RuntimeAdapter } from '../RuntimeAdapter';
+import type { AdapterConfig, RuntimeAdapter } from '../RuntimeAdapter';
 /**
  * Node.js HTTP Server adapter for standard containers and traditional servers
  * Uses Node.js built-in HTTP server for maximum compatibility

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

@@ -1 +1 @@
-{"version":3,"file":"NodeServerAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/NodeServerAdapter.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,aAAa,EAGb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;mBACY,aAAa,GAAG,cAAc,GAAG;QAC9C,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KACvB;EAoED,CAAC"}
+{"version":3,"file":"NodeServerAdapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/NodeServerAdapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EAGb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;mBACY,aAAa,GAAG,cAAc,GAAG;QAC9C,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KACvB;EAoED,CAAC"}

package/src/runtime/getKernel.d.ts

@@ -0,0 +1,9 @@
+import type { IKernel } from '../http/Kernel';
+export declare function getKernel(): Promise<IKernel>;
+/**
+ * Test-only helper.
+ *
+ * Allows unit tests to reset the singleton between cases without leaking state.
+ */
+export declare function __resetKernelForTests(): void;
+//# sourceMappingURL=getKernel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getKernel.d.ts","sourceRoot":"","sources":["../../../src/runtime/getKernel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAK5C,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAkBlD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/src/runtime/getKernel.js

@@ -0,0 +1,27 @@
+import { Application } from '../boot/Application.js';
+import { Kernel } from '../http/Kernel.js';
+let kernelPromise = null;
+export async function getKernel() {
+    if (kernelPromise !== null) {
+        return kernelPromise;
+    }
+    const initialize = async () => {
+        const app = Application.create();
+        await app.boot();
+        return Kernel.create(app.getRouter(), app.getContainer());
+    };
+    kernelPromise = initialize().catch((error) => {
+        // Allow retry on subsequent calls if initialization fails.
+        kernelPromise = null;
+        throw error;
+    });
+    return kernelPromise;
+}
+/**
+ * Test-only helper.
+ *
+ * Allows unit tests to reset the singleton between cases without leaking state.
+ */
+export function __resetKernelForTests() {
+    kernelPromise = null;
+}

package/src/scripts/TemplateImportsCheck.js

@@ -1,5 +1,6 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import ts from 'typescript';
 const TEMPLATES_ROOT = path.resolve(process.cwd(), 'src/templates');
 const bannedPrefixes = [
     '@exceptions/',
@@ -79,6 +80,29 @@ function checkFile(filePath) {
     }
     return offenses;
 }
+function looksLikeTypeScriptTemplate(text) {
+    // Only attempt TS parsing when the template appears to contain TS module syntax.
+    // Many templates are not TS (markdown/env/etc.) and should not be validated this way.
+    return /\b(import|export)\b/.test(text);
+}
+function getTypeScriptSyntaxErrors(filePath) {
+    const text = fs.readFileSync(filePath, 'utf8');
+    if (!looksLikeTypeScriptTemplate(text))
+        return [];
+    const sourceFile = ts.createSourceFile(filePath, text, ts.ScriptTarget.ESNext, true, ts.ScriptKind.TS);
+    const diagnostics = sourceFile
+        .parseDiagnostics;
+    if (!diagnostics || diagnostics.length === 0)
+        return [];
+    const out = [];
+    for (const d of diagnostics) {
+        const message = ts.flattenDiagnosticMessageText(d.messageText, '\n');
+        const pos = typeof d.start === 'number' ? d.start : 0;
+        const { line } = sourceFile.getLineAndCharacterOfPosition(pos);
+        out.push({ line: line + 1, message });
+    }
+    return out;
+}
 function main() {
     if (!fs.existsSync(TEMPLATES_ROOT)) {
         process.stderr.write(`Templates root not found: ${TEMPLATES_ROOT}\n`);
@@ -86,6 +110,7 @@ function main() {
     }
     const files = listFilesRecursive(TEMPLATES_ROOT).filter(isTemplateFile);
     const allOffenses = [];
+    const allSyntaxErrors = [];
     for (const file of files) {
         const offenses = checkFile(file);
         for (const o of offenses) {
@@ -96,6 +121,21 @@ function main() {
                 text: o.text,
             });
         }
+        const syntaxErrors = getTypeScriptSyntaxErrors(file);
+        for (const e of syntaxErrors) {
+            allSyntaxErrors.push({
+                file: path.relative(process.cwd(), file),
+                line: e.line,
+                message: e.message,
+            });
+        }
+    }
+    if (allSyntaxErrors.length > 0) {
+        process.stderr.write('Template syntax check failed. TypeScript parse errors found:\n');
+        for (const e of allSyntaxErrors) {
+            process.stderr.write(`- ${e.file}:${e.line} -> ${e.message}\n`);
+        }
+        process.exit(1);
     }
     if (allOffenses.length > 0) {
         process.stderr.write('Template import check failed. Disallowed import specifiers found:\n');