@kernlang/express 3.1.6 → 3.1.7

package/dist/express-route.js

@@ -0,0 +1,269 @@
+import { getChildren, getFirstChild, getProps } from '@kernlang/core';
+import { buildSchema, resolveMiddlewareUsage } from './express-middleware.js';
+import { generatePortableHandlerExpress } from './express-portable.js';
+import { generateSpawnCode, generateStreamSetup, generateStreamWrap, generateTimerCode } from './express-stream.js';
+import { analyzeRouteCapabilities, HTTP_METHODS } from './express-types.js';
+import { buildPathParamsType, derivePathParams, escapeSingleQuotes, extractRequiredKeyTypes, indentBlock, routeFileBase, routeRegisterName, } from './express-utils.js';
+export function buildRouteArtifact(routeNode, routeIndex, middlewareArtifacts, sourceMap, securityLevel) {
+    const props = getProps(routeNode);
+    const method = String(props.method || 'get').toLowerCase();
+    const normalizedMethod = HTTP_METHODS.has(method) ? method : 'get';
+    const path = String(props.path || '/');
+    const fileBase = routeFileBase(normalizedMethod, path, routeIndex);
+    const registerName = routeRegisterName(normalizedMethod, path);
+    const schema = buildSchema(getFirstChild(routeNode, 'schema'));
+    const caps = analyzeRouteCapabilities(routeNode);
+    // Portable route children: derive, guard, respond, branch, each, collect
+    const deriveNodes = getChildren(routeNode, 'derive');
+    const guardNodes = getChildren(routeNode, 'guard');
+    const respondNode = getFirstChild(routeNode, 'respond');
+    const branchNodes = getChildren(routeNode, 'branch');
+    const eachNodes = getChildren(routeNode, 'each');
+    const collectNodes = getChildren(routeNode, 'collect');
+    const effectNodes = getChildren(routeNode, 'effect');
+    const hasPortableNodes = deriveNodes.length > 0 ||
+        guardNodes.length > 0 ||
+        !!respondNode ||
+        branchNodes.length > 0 ||
+        eachNodes.length > 0 ||
+        collectNodes.length > 0 ||
+        effectNodes.length > 0;
+    // Get handler code — priority: stream handler > timer handler > route handler > portable > 501
+    const handlerNode = caps.hasStream
+        ? getFirstChild(caps.streamNode, 'handler')
+        : caps.hasTimer
+            ? null // timer owns its own handler, don't look at route level
+            : getFirstChild(routeNode, 'handler');
+    const routeHandlerNode = getFirstChild(routeNode, 'handler');
+    const handlerProps = handlerNode ? getProps(handlerNode) : {};
+    const routeHandlerCode = routeHandlerNode ? String(getProps(routeHandlerNode).code || '') : '';
+    const handlerCode = typeof handlerProps.code === 'string'
+        ? String(handlerProps.code)
+        : caps.hasStream || caps.hasTimer || hasPortableNodes
+            ? ''
+            : `res.status(501).json({ error: 'Route handler not implemented' });`;
+    const routeMiddleware = getChildren(routeNode, 'middleware');
+    const routeImports = new Set();
+    const middlewareInvocations = [];
+    let needsExpressDefaultImport = false;
+    for (const middlewareNode of routeMiddleware) {
+        // Handle v3 bare-word middleware list: middleware names=["rateLimit","cors"]
+        const mwProps = getProps(middlewareNode);
+        const mwNames = mwProps.names;
+        if (mwNames && Array.isArray(mwNames)) {
+            for (const mwName of mwNames) {
+                const syntheticNode = { type: 'middleware', props: { name: mwName }, children: [] };
+                const mwUsage = resolveMiddlewareUsage(syntheticNode, middlewareArtifacts, '../', securityLevel);
+                if (mwUsage.importLine)
+                    routeImports.add(mwUsage.importLine);
+                if (mwUsage.invocation.startsWith('express.json('))
+                    needsExpressDefaultImport = true;
+                middlewareInvocations.push(mwUsage.invocation);
+            }
+            continue;
+        }
+        const usage = resolveMiddlewareUsage(middlewareNode, middlewareArtifacts, '../', securityLevel);
+        if (usage.importLine)
+            routeImports.add(usage.importLine);
+        if (usage.invocation.startsWith('express.json('))
+            needsExpressDefaultImport = true;
+        middlewareInvocations.push(usage.invocation);
+    }
+    // v3 route children: auth, validate
+    const authNode = getFirstChild(routeNode, 'auth');
+    if (authNode) {
+        const authMode = String(getProps(authNode).mode || 'required');
+        middlewareInvocations.unshift(authMode === 'optional' ? 'authOptional' : 'authRequired');
+    }
+    const validateNode = getFirstChild(routeNode, 'validate');
+    if (validateNode) {
+        const validateSchema = String(getProps(validateNode).schema || '');
+        if (validateSchema) {
+            middlewareInvocations.push(`validate(${validateSchema})`);
+        }
+    }
+    // v3 route children: params (query params with types and defaults)
+    const paramsNodes = getChildren(routeNode, 'params');
+    const queryParams = [];
+    for (const paramNode of paramsNodes) {
+        const items = getProps(paramNode).items;
+        if (items)
+            queryParams.push(...items);
+    }
+    // v3 route children: error (HTTP error contract)
+    const errorNodes = getChildren(routeNode, 'error').filter((n) => typeof getProps(n).status === 'number');
+    const errorResponses = errorNodes.map((n) => ({
+        status: getProps(n).status,
+        message: String(getProps(n).message || 'Error'),
+    }));
+    const paramsType = schema.params || buildPathParamsType(path) || 'Record<string, never>';
+    const queryType = schema.query || 'Record<string, never>';
+    const bodyType = schema.body || 'Record<string, never>';
+    const responseType = schema.response || 'unknown';
+    const requestType = `Request<RouteParams, ResponseBody, RequestBody, RequestQuery>`;
+    const validationLines = [];
+    // Params and query arrive as strings in Express — only check existence, not typeof.
+    // Body comes from JSON parsing and has real types — check both existence and typeof.
+    const requiredParamKeys = (schema.params
+        ? extractRequiredKeyTypes(schema.params)
+        : derivePathParams(path).map((k) => ({ key: k, type: 'any' }))).map((k) => ({ ...k, type: 'any' }));
+    const requiredBodyKeys = schema.body ? extractRequiredKeyTypes(schema.body) : [];
+    const requiredQueryKeys = (schema.query ? extractRequiredKeyTypes(schema.query) : []).map((k) => ({
+        ...k,
+        type: 'any',
+    }));
+    function formatFieldSpec(fields) {
+        return `[${fields.map((f) => `{ key: '${escapeSingleQuotes(f.key)}', type: '${f.type}' }`).join(', ')}]`;
+    }
+    if (requiredParamKeys.length > 0) {
+        validationLines.push(`assertRequiredFields('params', req.params, ${formatFieldSpec(requiredParamKeys)});`);
+    }
+    if (requiredBodyKeys.length > 0) {
+        validationLines.push(`assertRequiredFields('body', req.body, ${formatFieldSpec(requiredBodyKeys)});`);
+    }
+    if (requiredQueryKeys.length > 0) {
+        validationLines.push(`assertRequiredFields('query', req.query, ${formatFieldSpec(requiredQueryKeys)});`);
+    }
+    const lines = [];
+    if (needsExpressDefaultImport) {
+        lines.push(`import express, { type Express, type NextFunction, type Request, type Response } from 'express';`);
+    }
+    else {
+        lines.push(`import { type Express, type NextFunction, type Request, type Response } from 'express';`);
+    }
+    if (caps.needsChildProcess) {
+        lines.push(`import { spawn } from 'node:child_process';`);
+    }
+    for (const routeImport of [...routeImports].sort()) {
+        lines.push(routeImport);
+    }
+    lines.push('');
+    lines.push(`type RouteParams = ${paramsType};`);
+    lines.push(`type RequestQuery = ${queryType};`);
+    lines.push(`type RequestBody = ${bodyType};`);
+    lines.push(`type ResponseBody = ${responseType};`);
+    if (validationLines.length > 0) {
+        lines.push('');
+        lines.push(`function assertRequiredFields(label: string, value: unknown, fields: Array<{ key: string; type: string }>): void {`);
+        lines.push(`  if (typeof value !== 'object' || value === null) {`);
+        lines.push(`    throw new Error(\`Invalid \${label}: expected object payload\`);`);
+        lines.push('  }');
+        lines.push(`  const obj = value as Record<string, unknown>;`);
+        lines.push(`  for (const { key, type } of fields) {`);
+        lines.push(`    if (!(key in obj)) {`);
+        lines.push(`      throw new Error(\`Invalid \${label}: missing \${key}\`);`);
+        lines.push('    }');
+        lines.push(`    if (type !== 'any' && typeof obj[key] !== type) {`);
+        lines.push(`      throw new Error(\`Invalid \${label}: \${key} must be \${type}, got \${typeof obj[key]}\`);`);
+        lines.push('    }');
+        lines.push('  }');
+        lines.push('}');
+    }
+    lines.push('');
+    lines.push(`export function ${registerName}(app: Express): void {`);
+    lines.push(`  app.${normalizedMethod}('${escapeSingleQuotes(path)}', ${middlewareInvocations.length > 0 ? `${middlewareInvocations.join(', ')}, ` : ''}async (req: ${requestType}, res: Response, next: NextFunction) => {`);
+    // Schema validation — always runs first, before stream/timer
+    if (validationLines.length > 0) {
+        lines.push('    try {');
+        for (const validationLine of validationLines) {
+            lines.push(`      ${validationLine}`);
+        }
+        lines.push('    } catch (err) {');
+        lines.push('      return res.status(400).json({ error: err instanceof Error ? err.message : String(err) } as any);');
+        lines.push('    }');
+        lines.push('');
+    }
+    // v3 query params — extract with safe type coercion and defaults
+    if (queryParams.length > 0) {
+        for (const qp of queryParams) {
+            if (qp.default !== undefined) {
+                if (qp.type === 'number') {
+                    lines.push(`    const ${qp.name} = req.query.${qp.name} !== undefined ? Number(req.query.${qp.name}) : ${qp.default};`);
+                }
+                else if (qp.type === 'boolean') {
+                    lines.push(`    const ${qp.name} = req.query.${qp.name} !== undefined ? req.query.${qp.name} === 'true' : ${qp.default};`);
+                }
+                else {
+                    lines.push(`    const ${qp.name} = typeof req.query.${qp.name} === 'string' ? req.query.${qp.name} : ${qp.default};`);
+                }
+            }
+            else {
+                if (qp.type === 'number') {
+                    lines.push(`    const ${qp.name} = req.query.${qp.name} !== undefined ? Number(req.query.${qp.name}) : undefined;`);
+                }
+                else if (qp.type === 'boolean') {
+                    lines.push(`    const ${qp.name} = req.query.${qp.name} !== undefined ? req.query.${qp.name} === 'true' : undefined;`);
+                }
+                else {
+                    lines.push(`    const ${qp.name} = typeof req.query.${qp.name} === 'string' ? req.query.${qp.name} as string : undefined;`);
+                }
+            }
+        }
+        lines.push('');
+    }
+    // v3 error responses — JSDoc contract
+    if (errorResponses.length > 0) {
+        lines.push('    // Error contract:');
+        for (const er of errorResponses) {
+            lines.push(`    // ${er.status} — ${er.message}`);
+        }
+        lines.push('');
+    }
+    // Request-scoped AbortController (if any async capability)
+    if (caps.needsAbortController) {
+        lines.push('    const ac = new AbortController();');
+        lines.push("    req.on('close', () => ac.abort());");
+        lines.push('');
+    }
+    if (caps.hasStream) {
+        // SSE route — validate first, then stream
+        lines.push(...generateStreamSetup('    '));
+        lines.push('');
+        const streamHandlerLines = handlerCode
+            .split('\n')
+            .map((l) => l.trim())
+            .filter(Boolean);
+        // If spawn inside stream, generate spawn code
+        if (caps.hasSpawn && caps.spawnNode) {
+            const spawnLines = generateSpawnCode(caps.spawnNode, '');
+            streamHandlerLines.push(...spawnLines);
+        }
+        lines.push(...generateStreamWrap(streamHandlerLines, caps.hasSpawn, '    '));
+    }
+    else if (caps.hasTimer && caps.timerNode) {
+        // Timer route — wrap handler in timeout
+        lines.push(...generateTimerCode(caps.timerNode, routeHandlerCode, '    '));
+    }
+    else {
+        // Standard route — try/catch → next(error)
+        lines.push('    try {');
+        // Phase 1-3: Portable handler — derive → guard → handler → respond
+        if (hasPortableNodes) {
+            lines.push(...generatePortableHandlerExpress(routeNode, '      ', path));
+        }
+        else {
+            lines.push(...indentBlock(handlerCode, '      '));
+        }
+        lines.push('    } catch (error) {');
+        lines.push('      next(error);');
+        lines.push('    }');
+    }
+    lines.push('  });');
+    lines.push('}');
+    sourceMap.push({
+        irLine: routeNode.loc?.line || 0,
+        irCol: routeNode.loc?.col || 1,
+        outLine: 1,
+        outCol: 1,
+    });
+    return {
+        registerName,
+        fileBase,
+        artifact: {
+            path: `routes/${fileBase}.ts`,
+            content: lines.join('\n'),
+            type: 'route',
+        },
+    };
+}
+//# sourceMappingURL=express-route.js.map

package/dist/express-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-route.js","sourceRoot":"","sources":["../src/express-route.ts"],"names":[],"mappings":"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"}

package/dist/express-stream.d.ts

@@ -0,0 +1,5 @@
+import type { IRNode } from '@kernlang/core';
+export declare function generateStreamSetup(indent: string): string[];
+export declare function generateStreamWrap(handlerLines: string[], hasSpawn: boolean, indent: string): string[];
+export declare function generateSpawnCode(spawnNode: IRNode, indent: string): string[];
+export declare function generateTimerCode(timerNode: IRNode, handlerCode: string, indent: string): string[];

package/dist/express-stream.js

@@ -0,0 +1,191 @@
+import { getChildren, getFirstChild, getProps } from '@kernlang/core';
+import { escapeSingleQuotes } from './express-utils.js';
+// ── SSE stream code generator ────────────────────────────────────────────
+export function generateStreamSetup(indent) {
+    return [
+        `${indent}res.writeHead(200, {`,
+        `${indent}  'Content-Type': 'text/event-stream',`,
+        `${indent}  'Cache-Control': 'no-cache',`,
+        `${indent}  'Connection': 'keep-alive',`,
+        `${indent}});`,
+        `${indent}res.flushHeaders();`,
+        `${indent}`,
+        `${indent}const emit = (data: unknown, event?: string) => {`,
+        `${indent}  if (res.writableEnded) return;`,
+        `${indent}  if (event) res.write(\`event: \${event}\\n\`);`,
+        `${indent}  res.write(\`data: \${JSON.stringify(data)}\\n\\n\`);`,
+        `${indent}};`,
+        `${indent}`,
+        `${indent}// SSE heartbeat — keeps proxies/browsers from killing the connection`,
+        `${indent}const heartbeat = setInterval(() => {`,
+        `${indent}  if (res.writableEnded) { clearInterval(heartbeat); return; }`,
+        `${indent}  res.write(': keep-alive\\n\\n');`,
+        `${indent}}, 15000);`,
+    ];
+}
+export function generateStreamWrap(handlerLines, hasSpawn, indent) {
+    const lines = [];
+    // Await the async IIFE so Express doesn't return before stream completes
+    lines.push(`${indent}await (async () => {`);
+    lines.push(`${indent}  try {`);
+    if (hasSpawn) {
+        // Wrap spawn in a Promise so we await child completion before closing stream
+        lines.push(`${indent}    await new Promise<void>((resolveStream, rejectStream) => {`);
+        lines.push(...handlerLines.map((l) => `${indent}      ${l}`));
+        // The spawn's on('close') handler should call resolveStream()
+        lines.push(`${indent}    });`);
+    }
+    else {
+        lines.push(...handlerLines.map((l) => `${indent}    ${l}`));
+    }
+    lines.push(`${indent}  } catch (err) {`);
+    lines.push(`${indent}    emit({ type: 'error', error: err instanceof Error ? err.message : String(err) });`);
+    lines.push(`${indent}  } finally {`);
+    lines.push(`${indent}    clearInterval(heartbeat);`);
+    lines.push(`${indent}    if (!res.writableEnded) {`);
+    lines.push(`${indent}      res.write(\`data: \${JSON.stringify('[DONE]')}\\n\\n\`);`);
+    lines.push(`${indent}      res.end();`);
+    lines.push(`${indent}    }`);
+    lines.push(`${indent}  }`);
+    lines.push(`${indent}})();`);
+    return lines;
+}
+// ── Spawn code generator ─────────────────────────────────────────────────
+export function generateSpawnCode(spawnNode, indent) {
+    const p = getProps(spawnNode);
+    const binary = String(p.binary || 'echo');
+    const args = p.args;
+    const timeoutSec = Number(p.timeout) || 0;
+    const lines = [];
+    // Validate: binary must be static (security: no dynamic binary)
+    if (binary.includes('{{') || binary.includes('req.')) {
+        lines.push(`${indent}// ERROR: Dynamic binary is not allowed for security. Use a static binary name.`);
+        lines.push(`${indent}res.status(500).json({ error: 'Dynamic binary not allowed' });`);
+        return lines;
+    }
+    const argsExpr = args || '[]';
+    lines.push(`${indent}const child = spawn('${escapeSingleQuotes(binary)}', ${argsExpr}, {`);
+    lines.push(`${indent}  stdio: ['pipe', 'pipe', 'pipe'],`);
+    lines.push(`${indent}  shell: false,`);
+    // Env vars
+    const envNodes = getChildren(spawnNode, 'env');
+    if (envNodes.length > 0) {
+        const envPairs = envNodes
+            .map((e) => {
+            const ep = getProps(e);
+            const entries = Object.entries(ep).filter(([k]) => k !== 'styles' && k !== 'pseudoStyles' && k !== 'themeRefs');
+            return entries.map(([k, v]) => `${k}: '${String(v)}'`).join(', ');
+        })
+            .join(', ');
+        lines.push(`${indent}  env: { ...process.env, ${envPairs} },`);
+    }
+    lines.push(`${indent}});`);
+    // stdin handling — only end if no stdin prop
+    if (!p.stdin) {
+        lines.push(`${indent}child.stdin.end();`);
+    }
+    lines.push(`${indent}let errorText = '';`);
+    // Timeout with SIGTERM → SIGKILL escalation
+    lines.push(`${indent}let childExited = false;`);
+    lines.push(`${indent}child.on('exit', () => { childExited = true; });`);
+    if (timeoutSec > 0) {
+        lines.push(`${indent}const spawnTimer = setTimeout(() => {`);
+        lines.push(`${indent}  child.kill('SIGTERM');`);
+        lines.push(`${indent}  setTimeout(() => { if (!childExited) child.kill('SIGKILL'); }, 3000);`);
+        lines.push(`${indent}}, ${timeoutSec * 1000});`);
+    }
+    // Abort on request close — SIGTERM then force SIGKILL + resolve after 5s
+    lines.push(`${indent}ac.signal.addEventListener('abort', () => {`);
+    lines.push(`${indent}  if (!childExited) {`);
+    lines.push(`${indent}    child.kill('SIGTERM');`);
+    lines.push(`${indent}    setTimeout(() => {`);
+    lines.push(`${indent}      if (!childExited) child.kill('SIGKILL');`);
+    lines.push(`${indent}      if (typeof resolveStream === 'function') resolveStream();`);
+    lines.push(`${indent}    }, 5000);`);
+    lines.push(`${indent}  }`);
+    lines.push(`${indent}});`);
+    // Event handlers from child nodes
+    const onNodes = getChildren(spawnNode, 'on');
+    let hasCloseHandler = false;
+    for (const onNode of onNodes) {
+        const onProps = getProps(onNode);
+        const event = String(onProps.name || onProps.event || '');
+        const handlerChild = getFirstChild(onNode, 'handler');
+        const code = handlerChild ? String(getProps(handlerChild).code || '') : '';
+        if (event === 'stdout') {
+            lines.push(`${indent}child.stdout.on('data', (chunk: Buffer) => {`);
+            lines.push(...code.split('\n').map((l) => `${indent}  ${l.trim()}`));
+            lines.push(`${indent}});`);
+        }
+        else if (event === 'stderr') {
+            lines.push(`${indent}child.stderr.on('data', (chunk: Buffer) => {`);
+            lines.push(...code.split('\n').map((l) => `${indent}  ${l.trim()}`));
+            lines.push(`${indent}});`);
+        }
+        else if (event === 'close') {
+            hasCloseHandler = true;
+            lines.push(`${indent}child.on('close', (code: number | null) => {`);
+            if (timeoutSec > 0)
+                lines.push(`${indent}  clearTimeout(spawnTimer);`);
+            lines.push(...code.split('\n').map((l) => `${indent}  ${l.trim()}`));
+            // Resolve the stream promise so finally block runs AFTER child exits
+            lines.push(`${indent}  if (typeof resolveStream === 'function') resolveStream();`);
+            lines.push(`${indent}});`);
+        }
+        else if (event === 'timeout') {
+            // Handled via the timer killed branch
+        }
+    }
+    // Default close handler if none specified — ensures stream promise resolves
+    if (!hasCloseHandler) {
+        lines.push(`${indent}child.on('close', (code: number | null) => {`);
+        if (timeoutSec > 0)
+            lines.push(`${indent}  clearTimeout(spawnTimer);`);
+        lines.push(`${indent}  if (typeof resolveStream === 'function') resolveStream();`);
+        lines.push(`${indent}});`);
+    }
+    // Catch spawn errors (binary not found)
+    lines.push(`${indent}child.on('error', (err: Error) => {`);
+    lines.push(`${indent}  emit({ type: 'error', error: err.message });`);
+    lines.push(`${indent}  if (typeof resolveStream === 'function') resolveStream();`);
+    lines.push(`${indent}});`);
+    return lines;
+}
+// ── Timer code generator ─────────────────────────────────────────────────
+export function generateTimerCode(timerNode, handlerCode, indent) {
+    const p = getProps(timerNode);
+    const timeoutSec = Number(Object.values(p).find((v) => typeof v === 'string' && !Number.isNaN(Number(v))) || p.timeout || 15);
+    const handlerChild = getFirstChild(timerNode, 'handler');
+    const timerHandlerCode = handlerChild ? String(getProps(handlerChild).code || '') : '';
+    const onTimeoutNode = (timerNode.children || []).find((c) => c.type === 'on' && (getProps(c).name === 'timeout' || getProps(c).event === 'timeout'));
+    const timeoutHandler = onTimeoutNode ? getFirstChild(onTimeoutNode, 'handler') : undefined;
+    const timeoutCode = timeoutHandler
+        ? String(getProps(timeoutHandler).code || '')
+        : `res.status(408).json({ error: 'Request timed out' });`;
+    const lines = [];
+    lines.push(`${indent}const timeoutMs = ${timeoutSec * 1000};`);
+    lines.push(`${indent}const timer = setTimeout(() => {`);
+    lines.push(`${indent}  ac.abort();`);
+    lines.push(...timeoutCode.split('\n').map((l) => `${indent}  ${l.trim()}`));
+    lines.push(`${indent}}, timeoutMs);`);
+    lines.push(`${indent}`);
+    lines.push(`${indent}try {`);
+    // Timer handler code (the work to do)
+    if (timerHandlerCode) {
+        lines.push(...timerHandlerCode.split('\n').map((l) => `${indent}  ${l.trim()}`));
+    }
+    // Original route handler code
+    if (handlerCode) {
+        lines.push(...handlerCode.split('\n').map((l) => `${indent}  ${l.trim()}`));
+    }
+    lines.push(`${indent}} catch (err) {`);
+    lines.push(`${indent}  if (!ac.signal.aborted) {`);
+    lines.push(`${indent}    clearTimeout(timer);`);
+    lines.push(`${indent}    throw err;`);
+    lines.push(`${indent}  }`);
+    lines.push(`${indent}} finally {`);
+    lines.push(`${indent}  clearTimeout(timer);`);
+    lines.push(`${indent}}`);
+    return lines;
+}
+//# sourceMappingURL=express-stream.js.map

package/dist/express-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-stream.js","sourceRoot":"","sources":["../src/express-stream.ts"],"names":[],"mappings":"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"}

package/dist/express-types.d.ts

@@ -0,0 +1,42 @@
+import type { IRNode } from '@kernlang/core';
+export declare const HTTP_METHODS: Set<string>;
+export interface MiddlewareArtifactRef {
+    artifact: import('@kernlang/core').GeneratedArtifact;
+    exportName: string;
+    fileBase: string;
+}
+export interface RouteArtifactRef {
+    artifact: import('@kernlang/core').GeneratedArtifact;
+    registerName: string;
+    fileBase: string;
+}
+export interface SchemaShape {
+    body?: string;
+    params?: string;
+    query?: string;
+    response?: string;
+}
+export interface MiddlewareUsage {
+    importLine?: string;
+    invocation: string;
+}
+export interface RouteCapabilities {
+    hasStream: boolean;
+    hasSpawn: boolean;
+    hasTimer: boolean;
+    streamNode?: IRNode;
+    spawnNode?: IRNode;
+    timerNode?: IRNode;
+    needsAbortController: boolean;
+    needsChildProcess: boolean;
+}
+export declare function analyzeRouteCapabilities(routeNode: IRNode): RouteCapabilities;
+export interface KeyTypeInfo {
+    key: string;
+    type: string;
+}
+export interface CoreArtifactRef {
+    artifact: import('@kernlang/core').GeneratedArtifact;
+    importPath: string;
+    exportNames: string[];
+}

package/dist/express-types.js

@@ -0,0 +1,22 @@
+import { getFirstChild } from '@kernlang/core';
+export const HTTP_METHODS = new Set(['get', 'post', 'put', 'delete', 'patch']);
+export function analyzeRouteCapabilities(routeNode) {
+    const streamNode = getFirstChild(routeNode, 'stream');
+    // spawn must be inside stream (for SSE output), not standalone on route
+    const spawnNode = streamNode ? getFirstChild(streamNode, 'spawn') : undefined;
+    const timerNode = getFirstChild(routeNode, 'timer');
+    const hasStream = !!streamNode;
+    const hasSpawn = !!spawnNode;
+    const hasTimer = !!timerNode;
+    return {
+        hasStream,
+        hasSpawn,
+        hasTimer,
+        streamNode,
+        spawnNode,
+        timerNode,
+        needsAbortController: hasStream || hasSpawn || hasTimer,
+        needsChildProcess: hasSpawn,
+    };
+}
+//# sourceMappingURL=express-types.js.map

package/dist/express-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-types.js","sourceRoot":"","sources":["../src/express-types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAuC/E,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,wEAAwE;IACxE,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC;IAC/B,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC;IAC7B,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC;IAE7B,OAAO;QACL,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,SAAS;QACT,SAAS;QACT,oBAAoB,EAAE,SAAS,IAAI,QAAQ,IAAI,QAAQ;QACvD,iBAAiB,EAAE,QAAQ;KAC5B,CAAC;AACJ,CAAC"}

package/dist/express-utils.d.ts

@@ -0,0 +1,18 @@
+import type { IRNode } from '@kernlang/core';
+import type { KeyTypeInfo } from './express-types.js';
+export declare function generateRespondExpress(respondNode: IRNode, indent: string): string[];
+export declare function pascalCase(value: string): string;
+export declare function slugify(value: string): string;
+export declare function escapeSingleQuotes(value: string): string;
+export declare function indentBlock(code: string, indent: string): string[];
+export declare function splitTopLevel(value: string): string[];
+/** Map TS/KERN schema types to JS typeof categories for runtime validation. */
+export declare function toTypeofCategory(tsType: string): string | undefined;
+export declare function extractRequiredKeys(schemaType: string): string[];
+export declare function extractRequiredKeyTypes(schemaType: string): KeyTypeInfo[];
+export declare function derivePathParams(path: string): string[];
+export declare function buildPathParamsType(path: string): string | undefined;
+export declare function findServerNode(root: IRNode): IRNode | undefined;
+export declare function routeFileBase(method: string, path: string, index: number): string;
+export declare function routeRegisterName(method: string, path: string): string;
+export declare function middlewareExportName(node: IRNode): string;