@kuratchi/js 0.0.2 → 0.0.3

package/dist/compiler/index.js

@@ -531,6 +531,8 @@ export function compile(options) {
     const authConfig = readAuthConfig(projectDir);
     // Read Durable Object config and discover handler files
     const doConfig = readDoConfig(projectDir);
+    const containerConfig = readWorkerClassConfig(projectDir, 'containers');
+    const workflowConfig = readWorkerClassConfig(projectDir, 'workflows');
     const doHandlers = doConfig.length > 0
         ? discoverDoHandlers(srcDir, doConfig, ormDatabases)
         : [];
@@ -867,6 +869,8 @@ export function compile(options) {
     // Collect only the components that were actually imported by routes
     const compiledComponents = Array.from(compiledComponentCache.values());
     // Generate the routes module
+    const runtimeImportPath = resolveRuntimeImportPath(projectDir);
+    const hasRuntime = !!runtimeImportPath;
     const output = generateRoutesModule({
         projectDir,
         serverImports: allImports,
@@ -882,6 +886,8 @@ export function compile(options) {
         isDev: options.isDev ?? false,
         isLayoutAsync,
         compiledLayoutActions,
+        hasRuntime,
+        runtimeImportPath: runtimeImportPath ?? undefined,
     });
     // Write to .kuratchi/routes.js
     const outFile = options.outFile ?? path.join(projectDir, '.kuratchi', 'routes.js');
@@ -895,10 +901,19 @@ export function compile(options) {
     // worker.js explicitly re-exports them so wrangler.jsonc can reference a
     // stable filename while routes.js is freely regenerated.
     const workerFile = path.join(outDir, 'worker.js');
+    const workerClassExports = [...containerConfig, ...workflowConfig]
+        .map((entry) => {
+        const importPath = toWorkerImportPath(projectDir, outDir, entry.file);
+        if (entry.exportKind === 'default') {
+            return `export { default as ${entry.className} } from '${importPath}';`;
+        }
+        return `export { ${entry.className} } from '${importPath}';`;
+    });
     const workerLines = [
         '// Auto-generated by kuratchi \u2014 do not edit.',
         "export { default } from './routes.js';",
         ...doConfig.map(c => `export { ${c.className} } from './routes.js';`),
+        ...workerClassExports,
         '',
     ];
     writeIfChanged(workerFile, workerLines.join('\n'));
@@ -1365,6 +1380,89 @@ function readDoConfig(projectDir) {
     }
     return entries;
 }
+function readWorkerClassConfig(projectDir, key) {
+    const configPath = path.join(projectDir, 'kuratchi.config.ts');
+    if (!fs.existsSync(configPath))
+        return [];
+    const source = fs.readFileSync(configPath, 'utf-8');
+    const keyIdx = source.search(new RegExp(`\\b${key}\\s*:\\s*\\{`));
+    if (keyIdx === -1)
+        return [];
+    const braceStart = source.indexOf('{', keyIdx);
+    if (braceStart === -1)
+        return [];
+    const body = extractBalancedBody(source, braceStart, '{', '}');
+    if (body == null)
+        return [];
+    const entries = [];
+    const expectedSuffix = key === 'containers' ? '.container' : '.workflow';
+    const allowedExt = /\.(ts|js|mjs|cjs)$/i;
+    const requiredFilePattern = new RegExp(`\\${expectedSuffix}\\.(ts|js|mjs|cjs)$`, 'i');
+    const resolveClassFromFile = (binding, filePath) => {
+        if (!requiredFilePattern.test(filePath)) {
+            throw new Error(`[kuratchi] ${key}.${binding} must reference a file ending in "${expectedSuffix}.ts|js|mjs|cjs". Received: ${filePath}`);
+        }
+        if (!allowedExt.test(filePath)) {
+            throw new Error(`[kuratchi] ${key}.${binding} file must be a TypeScript or JavaScript module. Received: ${filePath}`);
+        }
+        const absPath = path.isAbsolute(filePath) ? filePath : path.join(projectDir, filePath);
+        if (!fs.existsSync(absPath)) {
+            throw new Error(`[kuratchi] ${key}.${binding} file not found: ${filePath}`);
+        }
+        const fileSource = fs.readFileSync(absPath, 'utf-8');
+        const defaultClass = fileSource.match(/export\s+default\s+class\s+(\w+)/);
+        if (defaultClass) {
+            return { className: defaultClass[1], exportKind: 'default' };
+        }
+        const namedClass = fileSource.match(/export\s+class\s+(\w+)/);
+        if (namedClass) {
+            return { className: namedClass[1], exportKind: 'named' };
+        }
+        throw new Error(`[kuratchi] ${key}.${binding} must export a class via "export class X" or "export default class X". File: ${filePath}`);
+    };
+    // Object form:
+    // containers: { WORDPRESS_CONTAINER: { file: 'src/server/containers/wordpress.container.ts', className?: 'WordPressContainer' } }
+    // workflows:  { NEW_SITE_WORKFLOW: { file: 'src/server/workflows/new-site.workflow.ts', className?: 'NewSiteWorkflow' } }
+    const objRegex = /(\w+)\s*:\s*\{([^}]*(?:\{[^}]*\}[^}]*)*)\}/g;
+    let m;
+    while ((m = objRegex.exec(body)) !== null) {
+        const binding = m[1];
+        const entryBody = m[2];
+        const fileMatch = entryBody.match(/file\s*:\s*['"]([^'"]+)['"]/);
+        if (!fileMatch)
+            continue;
+        const inferred = resolveClassFromFile(binding, fileMatch[1]);
+        const classMatch = entryBody.match(/className\s*:\s*['"](\w+)['"]/);
+        const className = classMatch?.[1] ?? inferred.className;
+        entries.push({
+            binding,
+            className,
+            file: fileMatch[1],
+            exportKind: inferred.exportKind,
+        });
+    }
+    // String shorthand:
+    // containers: { WORDPRESS_CONTAINER: 'src/server/containers/wordpress.container.ts' }
+    // workflows:  { NEW_SITE_WORKFLOW: 'src/server/workflows/new-site.workflow.ts' }
+    const foundBindings = new Set(entries.map((e) => e.binding));
+    const pairRegex = /(\w+)\s*:\s*['"]([^'"]+)['"]\s*[,}\n]/g;
+    while ((m = pairRegex.exec(body)) !== null) {
+        const binding = m[1];
+        const file = m[2];
+        if (foundBindings.has(binding))
+            continue;
+        if (binding === 'file' || binding === 'className')
+            continue;
+        const inferred = resolveClassFromFile(binding, file);
+        entries.push({
+            binding,
+            className: inferred.className,
+            file,
+            exportKind: inferred.exportKind,
+        });
+    }
+    return entries;
+}
 function discoverFilesWithSuffix(dir, suffix) {
     if (!fs.existsSync(dir))
         return [];
@@ -1666,6 +1764,9 @@ function generateRoutesModule(opts) {
         .join('\n\n');
     // Resolve path to the framework's context module from the output directory
     const contextImport = `import { __setRequestContext, __esc, __setLocal, __getLocals, buildDefaultBreadcrumbs as __buildDefaultBreadcrumbs } from '${RUNTIME_CONTEXT_IMPORT}';`;
+    const runtimeImport = opts.hasRuntime && opts.runtimeImportPath
+        ? `import __kuratchiRuntime from '${opts.runtimeImportPath}';`
+        : '';
     // Auth session init — thin cookie parsing injected into Worker entry
     let authInit = '';
     if (opts.authConfig && opts.authConfig.sessionEnabled) {
@@ -1931,7 +2032,7 @@ ${initLines.join('\n')}
 ${opts.isDev ? '\nglobalThis.__kuratchi_DEV__ = true;\n' : ''}
 ${workerImport}
 ${contextImport}
-${migrationImports ? migrationImports + '\n' : ''}${authPluginImports ? authPluginImports + '\n' : ''}${doImports ? doImports + '\n' : ''}${opts.serverImports.join('\n')}
+${runtimeImport ? runtimeImport + '\n' : ''}${migrationImports ? migrationImports + '\n' : ''}${authPluginImports ? authPluginImports + '\n' : ''}${doImports ? doImports + '\n' : ''}${opts.serverImports.join('\n')}
 
 // ── Assets ──────────────────────────────────────────────────────
 
@@ -2075,141 +2176,245 @@ ${opts.isLayoutAsync ? 'async ' : ''}function __render(route, data) {
   return __attachCookies(new Response(${opts.isLayoutAsync ? 'await ' : ''}__layout(html), { headers: { 'content-type': 'text/html; charset=utf-8' } }));
 }
 
-// ── Exported Worker entrypoint ──────────────────────────────────
-
-export default class extends WorkerEntrypoint {
-  async fetch(request) {
-    __setRequestContext(this.ctx, request);
-${migrationInit ? '    await __runMigrations();\n' : ''}${authInit ? '    __initAuth(request);\n' : ''}${authPluginInit ? '    __initAuthPlugins();\n' : ''}${doResolverInit ? '    __initDoResolvers();\n' : ''}
-    const url = new URL(request.url);
-${ac?.hasRateLimit ? '\n    // Rate limiting — check before route handlers\n    { const __rlRes = await __checkRL(); if (__rlRes) return __secHeaders(__rlRes); }\n' : ''}${ac?.hasTurnstile ? '    // Turnstile bot protection\n    { const __tsRes = await __checkTS(); if (__tsRes) return __secHeaders(__tsRes); }\n' : ''}${ac?.hasGuards ? '    // Route guards — redirect if not authenticated\n    { const __gRes = __checkGuard(); if (__gRes) return __secHeaders(__gRes); }\n' : ''}
+const __runtimeDef = (typeof __kuratchiRuntime !== 'undefined' && __kuratchiRuntime && typeof __kuratchiRuntime === 'object') ? __kuratchiRuntime : {};
+const __runtimeEntries = Object.entries(__runtimeDef).filter(([, step]) => step && typeof step === 'object');
 
-    // Serve static assets from src/assets/ at /_assets/*
-    if (url.pathname.startsWith('/_assets/')) {
-      const name = url.pathname.slice('/_assets/'.length);
-      const asset = __assets[name];
-      if (asset) {
-        if (request.headers.get('if-none-match') === asset.etag) {
-          return new Response(null, { status: 304 });
-        }
-        return new Response(asset.content, {
-          headers: { 'content-type': asset.mime, 'cache-control': 'public, max-age=31536000, immutable', 'etag': asset.etag }
-        });
-      }
-      return __secHeaders(new Response('Not Found', { status: 404 }));
-    }
+async function __runRuntimeRequest(ctx, next) {
+  let idx = -1;
+  async function __dispatch(i) {
+    if (i <= idx) throw new Error('[kuratchi runtime] next() called multiple times in request phase');
+    idx = i;
+    const entry = __runtimeEntries[i];
+    if (!entry) return next();
+    const [, step] = entry;
+    if (typeof step.request !== 'function') return __dispatch(i + 1);
+    return await step.request(ctx, () => __dispatch(i + 1));
+  }
+  return __dispatch(0);
+}
 
-    const match = __match(url.pathname);
+async function __runRuntimeRoute(ctx, next) {
+  let idx = -1;
+  async function __dispatch(i) {
+    if (i <= idx) throw new Error('[kuratchi runtime] next() called multiple times in route phase');
+    idx = i;
+    const entry = __runtimeEntries[i];
+    if (!entry) return next();
+    const [, step] = entry;
+    if (typeof step.route !== 'function') return __dispatch(i + 1);
+    return await step.route(ctx, () => __dispatch(i + 1));
+  }
+  return __dispatch(0);
+}
 
-    if (!match) {
-      return __secHeaders(new Response(${opts.isLayoutAsync ? 'await ' : ''}__layout(__error(404)), { status: 404, headers: { 'content-type': 'text/html; charset=utf-8' } }));
+async function __runRuntimeResponse(ctx, response) {
+  let out = response;
+  for (const [, step] of __runtimeEntries) {
+    if (typeof step.response !== 'function') continue;
+    out = await step.response(ctx, out);
+    if (!(out instanceof Response)) {
+      throw new Error('[kuratchi runtime] response handlers must return a Response');
     }
+  }
+  return out;
+}
 
-    const route = routes[match.index];
-    __setLocal('params', match.params);
-    const __qFn = request.headers.get('x-kuratchi-query-fn') || '';
-    const __qArgsRaw = request.headers.get('x-kuratchi-query-args') || '[]';
-    let __qArgs = [];
+async function __runRuntimeError(ctx, error) {
+  for (const [name, step] of __runtimeEntries) {
+    if (typeof step.error !== 'function') continue;
     try {
-      const __parsed = JSON.parse(__qArgsRaw);
-      __qArgs = Array.isArray(__parsed) ? __parsed : [];
-    } catch {}
-    __setLocal('__queryOverride', __qFn ? { fn: __qFn, args: __qArgs } : null);
-    if (!__getLocals().__breadcrumbs) {
-      __setLocal('breadcrumbs', __buildDefaultBreadcrumbs(url.pathname, match.params));
+      const handled = await step.error(ctx, error);
+      if (handled instanceof Response) return handled;
+    } catch (hookErr) {
+      console.error('[kuratchi runtime] error handler failed in step', name, hookErr);
     }
+  }
+  return null;
+}
 
-    // RPC call: GET ?_rpc=fnName&_args=[...] → JSON response
-    const __rpcName = url.searchParams.get(‘_rpc’);
-    if (request.method === ‘GET’ && __rpcName && route.rpc && Object.hasOwn(route.rpc, __rpcName)) {
-      if (request.headers.get('x-kuratchi-rpc') !== '1') {
-        return __secHeaders(new Response(JSON.stringify({ ok: false, error: 'Forbidden' }), {
-          status: 403, headers: { 'content-type': 'application/json', 'cache-control': 'no-store' }
-        }));
-      }
-      try {
-        const __rpcArgsStr = url.searchParams.get('_args');
-        let __rpcArgs = [];
-        if (__rpcArgsStr) {
-          const __parsed = JSON.parse(__rpcArgsStr);
-          __rpcArgs = Array.isArray(__parsed) ? __parsed : [];
+// ── Exported Worker entrypoint ──────────────────────────────────
+
+export default class extends WorkerEntrypoint {
+  async fetch(request) {
+    __setRequestContext(this.ctx, request);
+    globalThis.__cloudflare_env__ = __env;
+${migrationInit ? '    await __runMigrations();\n' : ''}${authInit ? '    __initAuth(request);\n' : ''}${authPluginInit ? '    __initAuthPlugins();\n' : ''}${doResolverInit ? '    __initDoResolvers();\n' : ''}
+    const __runtimeCtx = {
+      request,
+      env: __env,
+      ctx: this.ctx,
+      url: new URL(request.url),
+      params: {},
+      locals: __getLocals(),
+    };
+
+    const __coreFetch = async () => {
+      const request = __runtimeCtx.request;
+      const url = __runtimeCtx.url;
+${ac?.hasRateLimit ? '\n      // Rate limiting - check before route handlers\n      { const __rlRes = await __checkRL(); if (__rlRes) return __secHeaders(__rlRes); }\n' : ''}${ac?.hasTurnstile ? '      // Turnstile bot protection\n      { const __tsRes = await __checkTS(); if (__tsRes) return __secHeaders(__tsRes); }\n' : ''}${ac?.hasGuards ? '      // Route guards - redirect if not authenticated\n      { const __gRes = __checkGuard(); if (__gRes) return __secHeaders(__gRes); }\n' : ''}
+
+      // Serve static assets from src/assets/ at /_assets/*
+      if (url.pathname.startsWith('/_assets/')) {
+        const name = url.pathname.slice('/_assets/'.length);
+        const asset = __assets[name];
+        if (asset) {
+          if (request.headers.get('if-none-match') === asset.etag) {
+            return new Response(null, { status: 304 });
+          }
+          return new Response(asset.content, {
+            headers: { 'content-type': asset.mime, 'cache-control': 'public, max-age=31536000, immutable', 'etag': asset.etag }
+          });
         }
-        const __rpcResult = await route.rpc[__rpcName](...__rpcArgs);
-        return __secHeaders(new Response(JSON.stringify({ ok: true, data: __rpcResult }), {
-          headers: { 'content-type': 'application/json', 'cache-control': 'no-store' }
-        }));
-      } catch (err) {
-        console.error('[kuratchi] RPC error:', err);
-        const __errMsg = typeof __kuratchi_DEV__ !== 'undefined' ? err.message : 'Internal Server Error';
-        return __secHeaders(new Response(JSON.stringify({ ok: false, error: __errMsg }), {
-          status: 500, headers: { 'content-type': 'application/json', 'cache-control': 'no-store' }
-        }));
+        return __secHeaders(new Response('Not Found', { status: 404 }));
       }
-    }
 
-    // Form action: POST with hidden _action field in form body
-    if (request.method === 'POST') {
-      if (!__isSameOrigin(request, url)) {
-        return __secHeaders(new Response('Forbidden', { status: 403 }));
+      const match = __match(url.pathname);
+
+      if (!match) {
+        return __secHeaders(new Response(${opts.isLayoutAsync ? 'await ' : ''}__layout(__error(404)), { status: 404, headers: { 'content-type': 'text/html; charset=utf-8' } }));
       }
-      const formData = await request.formData();
-      const actionName = formData.get('_action');
-      const __actionFn = (actionName && route.actions && Object.hasOwn(route.actions, actionName) ? route.actions[actionName] : null)
-        || (actionName && __layoutActions && Object.hasOwn(__layoutActions, actionName) ? __layoutActions[actionName] : null);
-      if (actionName && __actionFn) {
-        // Check if this is a fetch-based action call (onclick) with JSON args
-        const argsStr = formData.get('_args');
-        const isFetchAction = argsStr !== null;
+
+      __runtimeCtx.params = match.params;
+      const route = routes[match.index];
+      __setLocal('params', match.params);
+      const __qFn = request.headers.get('x-kuratchi-query-fn') || '';
+      const __qArgsRaw = request.headers.get('x-kuratchi-query-args') || '[]';
+      let __qArgs = [];
+      try {
+        const __parsed = JSON.parse(__qArgsRaw);
+        __qArgs = Array.isArray(__parsed) ? __parsed : [];
+      } catch {}
+      __setLocal('__queryOverride', __qFn ? { fn: __qFn, args: __qArgs } : null);
+      if (!__getLocals().__breadcrumbs) {
+        __setLocal('breadcrumbs', __buildDefaultBreadcrumbs(url.pathname, match.params));
+      }
+
+      // RPC call: GET ?_rpc=fnName&_args=[...] -> JSON response
+      const __rpcName = url.searchParams.get('_rpc');
+      if (request.method === 'GET' && __rpcName && route.rpc && Object.hasOwn(route.rpc, __rpcName)) {
+        if (request.headers.get('x-kuratchi-rpc') !== '1') {
+          return __secHeaders(new Response(JSON.stringify({ ok: false, error: 'Forbidden' }), {
+            status: 403, headers: { 'content-type': 'application/json', 'cache-control': 'no-store' }
+          }));
+        }
         try {
-          if (isFetchAction) {
-            const __parsed = JSON.parse(argsStr);
-            const args = Array.isArray(__parsed) ? __parsed : [];
-            await __actionFn(...args);
-          } else {
-            await __actionFn(formData);
+          const __rpcArgsStr = url.searchParams.get('_args');
+          let __rpcArgs = [];
+          if (__rpcArgsStr) {
+            const __parsed = JSON.parse(__rpcArgsStr);
+            __rpcArgs = Array.isArray(__parsed) ? __parsed : [];
           }
+          const __rpcResult = await route.rpc[__rpcName](...__rpcArgs);
+          return __secHeaders(new Response(JSON.stringify({ ok: true, data: __rpcResult }), {
+            headers: { 'content-type': 'application/json', 'cache-control': 'no-store' }
+          }));
         } catch (err) {
-          console.error('[kuratchi] Action error:', err);
+          console.error('[kuratchi] RPC error:', err);
+          const __errMsg = typeof __kuratchi_DEV__ !== 'undefined' ? err.message : 'Internal Server Error';
+          return __secHeaders(new Response(JSON.stringify({ ok: false, error: __errMsg }), {
+            status: 500, headers: { 'content-type': 'application/json', 'cache-control': 'no-store' }
+          }));
+        }
+      }
+
+      // Form action: POST with hidden _action field in form body
+      if (request.method === 'POST') {
+        if (!__isSameOrigin(request, url)) {
+          return __secHeaders(new Response('Forbidden', { status: 403 }));
+        }
+        const formData = await request.formData();
+        const actionName = formData.get('_action');
+        const __actionFn = (actionName && route.actions && Object.hasOwn(route.actions, actionName) ? route.actions[actionName] : null)
+          || (actionName && __layoutActions && Object.hasOwn(__layoutActions, actionName) ? __layoutActions[actionName] : null);
+        if (actionName && __actionFn) {
+          // Check if this is a fetch-based action call (onclick) with JSON args
+          const argsStr = formData.get('_args');
+          const isFetchAction = argsStr !== null;
+          try {
+            if (isFetchAction) {
+              const __parsed = JSON.parse(argsStr);
+              const args = Array.isArray(__parsed) ? __parsed : [];
+              await __actionFn(...args);
+            } else {
+              await __actionFn(formData);
+            }
+          } catch (err) {
+            console.error('[kuratchi] Action error:', err);
+            if (isFetchAction) {
+              const __errMsg = typeof __kuratchi_DEV__ !== 'undefined' ? err.message : 'Internal Server Error';
+              return __secHeaders(new Response(JSON.stringify({ ok: false, error: __errMsg }), {
+                status: 500, headers: { 'content-type': 'application/json' }
+              }));
+            }
+            const __loaded = route.load ? await route.load(match.params) : {};
+            const data = (__loaded && typeof __loaded === 'object') ? __loaded : { value: __loaded };
+            data.params = match.params;
+            data.breadcrumbs = __getLocals().__breadcrumbs ?? [];
+            data.__error = (typeof __kuratchi_DEV__ !== 'undefined' && err && err.message) ? err.message : 'Action failed';
+            return ${opts.isLayoutAsync ? 'await ' : ''}__render(route, data);
+          }
+          // Fetch-based actions return lightweight JSON (no page re-render)
           if (isFetchAction) {
-            const __errMsg = typeof __kuratchi_DEV__ !== 'undefined' ? err.message : 'Internal Server Error';
-            return __secHeaders(new Response(JSON.stringify({ ok: false, error: __errMsg }), {
-              status: 500, headers: { 'content-type': 'application/json' }
+            return __attachCookies(new Response(JSON.stringify({ ok: true }), {
+              headers: { 'content-type': 'application/json' }
             }));
           }
-          const __loaded = route.load ? await route.load(match.params) : {};
-          const data = (__loaded && typeof __loaded === 'object') ? __loaded : { value: __loaded };
-          data.params = match.params;
-          data.breadcrumbs = __getLocals().__breadcrumbs ?? [];
-          data.__error = (typeof __kuratchi_DEV__ !== 'undefined' && err && err.message) ? err.message : 'Action failed';
-          return ${opts.isLayoutAsync ? 'await ' : ''}__render(route, data);
-        }
-        // Fetch-based actions return lightweight JSON (no page re-render)
-        if (isFetchAction) {
-          return __attachCookies(new Response(JSON.stringify({ ok: true }), {
-            headers: { 'content-type': 'application/json' }
-          }));
+          // POST-Redirect-GET: redirect to custom target or back to same URL
+          const __locals = __getLocals();
+          const redirectTo = __locals.__redirectTo || url.pathname;
+          const redirectStatus = Number(__locals.__redirectStatus) || 303;
+          return __attachCookies(new Response(null, { status: redirectStatus, headers: { 'location': redirectTo } }));
         }
-        // POST-Redirect-GET: redirect to custom target or back to same URL
-        const __locals = __getLocals();
-        const redirectTo = __locals.__redirectTo || url.pathname;
-        const redirectStatus = Number(__locals.__redirectStatus) || 303;
-        return __attachCookies(new Response(null, { status: redirectStatus, headers: { 'location': redirectTo } }));
       }
-    }
 
-    // GET (or unmatched POST): load + render
+      // GET (or unmatched POST): load + render
+      try {
+        const __loaded = route.load ? await route.load(match.params) : {};
+        const data = (__loaded && typeof __loaded === 'object') ? __loaded : { value: __loaded };
+        data.params = match.params;
+        data.breadcrumbs = __getLocals().__breadcrumbs ?? [];
+        return ${opts.isLayoutAsync ? 'await ' : ''}__render(route, data);
+      } catch (err) {
+        console.error('[kuratchi] Route load/render error:', err);
+        const __errDetail = typeof __kuratchi_DEV__ !== 'undefined' ? err.message : undefined;
+        return __secHeaders(new Response(${opts.isLayoutAsync ? 'await ' : ''}__layout(__error(500, __errDetail)), { status: 500, headers: { 'content-type': 'text/html; charset=utf-8' } }));
+      }
+    };
+
     try {
-      const __loaded = route.load ? await route.load(match.params) : {};
-      const data = (__loaded && typeof __loaded === 'object') ? __loaded : { value: __loaded };
-      data.params = match.params;
-      data.breadcrumbs = __getLocals().__breadcrumbs ?? [];
-      return ${opts.isLayoutAsync ? 'await ' : ''}__render(route, data);
+      const __requestResponse = await __runRuntimeRequest(__runtimeCtx, async () => {
+        return __runRuntimeRoute(__runtimeCtx, __coreFetch);
+      });
+      return await __runRuntimeResponse(__runtimeCtx, __requestResponse);
     } catch (err) {
-      console.error('[kuratchi] Route load/render error:', err);
-      const __errDetail = typeof __kuratchi_DEV__ !== 'undefined' ? err.message : undefined;
-      return __secHeaders(new Response(${opts.isLayoutAsync ? 'await ' : ''}__layout(__error(500, __errDetail)), { status: 500, headers: { 'content-type': 'text/html; charset=utf-8' } }));
+      const __handled = await __runRuntimeError(__runtimeCtx, err);
+      if (__handled) return __secHeaders(__handled);
+      throw err;
     }
   }
 }
 `;
 }
+function resolveRuntimeImportPath(projectDir) {
+    const candidates = [
+        { file: 'src/kuratchi.runtime.ts', importPath: '../src/kuratchi.runtime' },
+        { file: 'src/kuratchi.runtime.js', importPath: '../src/kuratchi.runtime' },
+        { file: 'src/kuratchi.runtime.mjs', importPath: '../src/kuratchi.runtime' },
+        { file: 'kuratchi.runtime.ts', importPath: '../kuratchi.runtime' },
+        { file: 'kuratchi.runtime.js', importPath: '../kuratchi.runtime' },
+        { file: 'kuratchi.runtime.mjs', importPath: '../kuratchi.runtime' },
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(path.join(projectDir, candidate.file))) {
+            return candidate.importPath;
+        }
+    }
+    return null;
+}
+function toWorkerImportPath(projectDir, outDir, filePath) {
+    const absPath = path.isAbsolute(filePath) ? filePath : path.join(projectDir, filePath);
+    let rel = path.relative(outDir, absPath).replace(/\\/g, '/');
+    if (!rel.startsWith('.'))
+        rel = `./${rel}`;
+    return rel.replace(/\.(ts|js|mjs|cjs)$/, '');
+}

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 /**
- * KuratchiJS — Public API
+ * KuratchiJS - Public API
  *
  * A thin, Cloudflare Workers-native web framework with Svelte-inspired syntax.
  */
 export { createApp } from './runtime/app.js';
 export { defineConfig } from './runtime/config.js';
+export { defineRuntime } from './runtime/runtime.js';
 export { getCtx, getRequest, getLocals, getParams, getParam, redirect, goto, setBreadcrumbs, getBreadcrumbs, breadcrumbsHome, breadcrumbsPrev, breadcrumbsNext, breadcrumbsCurrent, buildDefaultBreadcrumbs, } from './runtime/context.js';
 export { kuratchiDO, doRpc } from './runtime/do.js';
 export { extractSubdomainSlug, extractSlugFromPrefix, matchContainerViewPath, rewriteProxyLocationHeader, buildContainerRequest, createContainerEnvVars, startContainer, proxyToContainer, handleContainerRouting, forwardJsonPostToContainerDO, matchSiteViewPath, buildSiteContainerRequest, createWpContainerEnvVars, startSiteContainer, proxyToSiteContainer, } from './runtime/containers.js';
-export type { AppConfig, kuratchiConfig, DatabaseConfig, AuthConfig, RouteContext, RouteModule } from './runtime/types.js';
+export type { AppConfig, kuratchiConfig, DatabaseConfig, AuthConfig, RouteContext, RouteModule, RuntimeContext, RuntimeDefinition, RuntimeStep, RuntimeNext, RuntimeErrorResult, } from './runtime/types.js';
 export type { RpcOf } from './runtime/do.js';
+export { compile } from './compiler/index.js';

package/dist/index.js

@@ -1,13 +1,16 @@
 /**
- * KuratchiJS — Public API
+ * KuratchiJS - Public API
  *
  * A thin, Cloudflare Workers-native web framework with Svelte-inspired syntax.
  */
 // Runtime
 export { createApp } from './runtime/app.js';
 export { defineConfig } from './runtime/config.js';
+export { defineRuntime } from './runtime/runtime.js';
 export { getCtx, getRequest, getLocals, getParams, getParam, redirect, goto, setBreadcrumbs, getBreadcrumbs, breadcrumbsHome, breadcrumbsPrev, breadcrumbsNext, breadcrumbsCurrent, buildDefaultBreadcrumbs, } from './runtime/context.js';
 export { kuratchiDO, doRpc } from './runtime/do.js';
 export { extractSubdomainSlug, extractSlugFromPrefix, matchContainerViewPath, rewriteProxyLocationHeader, buildContainerRequest, createContainerEnvVars, startContainer, proxyToContainer, handleContainerRouting, forwardJsonPostToContainerDO, 
 // Compatibility aliases
 matchSiteViewPath, buildSiteContainerRequest, createWpContainerEnvVars, startSiteContainer, proxyToSiteContainer, } from './runtime/containers.js';
+// Compiler (for build tooling)
+export { compile } from './compiler/index.js';

package/dist/runtime/index.d.ts

@@ -1,8 +1,9 @@
 export { createApp } from './app.js';
 export { defineConfig } from './config.js';
+export { defineRuntime } from './runtime.js';
 export { Router, filePathToPattern } from './router.js';
 export { getCtx, getRequest, getLocals, getParams, getParam, redirect, goto, setBreadcrumbs, getBreadcrumbs, breadcrumbsHome, breadcrumbsPrev, breadcrumbsNext, breadcrumbsCurrent, buildDefaultBreadcrumbs, } from './context.js';
 export { kuratchiDO, doRpc } from './do.js';
 export { extractSubdomainSlug, extractSlugFromPrefix, matchContainerViewPath, rewriteProxyLocationHeader, buildContainerRequest, createContainerEnvVars, startContainer, proxyToContainer, handleContainerRouting, forwardJsonPostToContainerDO, matchSiteViewPath, buildSiteContainerRequest, createWpContainerEnvVars, startSiteContainer, proxyToSiteContainer, } from './containers.js';
-export type { AppConfig, Env, AuthConfig, RouteContext, RouteModule, LayoutModule } from './types.js';
+export type { AppConfig, Env, AuthConfig, RouteContext, RouteModule, LayoutModule, RuntimeContext, RuntimeDefinition, RuntimeStep, RuntimeNext, RuntimeErrorResult, } from './types.js';
 export type { RpcOf } from './do.js';

package/dist/runtime/index.js

@@ -1,5 +1,6 @@
 export { createApp } from './app.js';
 export { defineConfig } from './config.js';
+export { defineRuntime } from './runtime.js';
 export { Router, filePathToPattern } from './router.js';
 export { getCtx, getRequest, getLocals, getParams, getParam, redirect, goto, setBreadcrumbs, getBreadcrumbs, breadcrumbsHome, breadcrumbsPrev, breadcrumbsNext, breadcrumbsCurrent, buildDefaultBreadcrumbs, } from './context.js';
 export { kuratchiDO, doRpc } from './do.js';

package/dist/runtime/runtime.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Runtime extension system
+ */
+import type { Env, RuntimeDefinition } from './types.js';
+export declare function defineRuntime<E extends Env = Env>(runtime: RuntimeDefinition<E>): RuntimeDefinition<E>;

package/dist/runtime/runtime.js

@@ -0,0 +1,6 @@
+/**
+ * Runtime extension system
+ */
+export function defineRuntime(runtime) {
+    return runtime;
+}

package/dist/runtime/types.d.ts

@@ -115,6 +115,20 @@ export interface kuratchiConfig<E extends Env = Env> {
         /** The user field path that identifies the DO stub (e.g. 'user.orgId') */
         stubId?: string;
     }>;
+    /** Container classes exported into the generated worker entry. */
+    containers?: Record<string, string | {
+        /** Relative path from project root. Must end in `.container.ts|js|mjs|cjs`. */
+        file: string;
+        /** Optional override; inferred from exported class in `file` when omitted. */
+        className?: string;
+    }>;
+    /** Workflow classes exported into the generated worker entry. */
+    workflows?: Record<string, string | {
+        /** Relative path from project root. Must end in `.workflow.ts|js|mjs|cjs`. */
+        file: string;
+        /** Optional override; inferred from exported class in `file` when omitted. */
+        className?: string;
+    }>;
 }
 /** Auth configuration for kuratchi.config.ts */
 export interface AuthConfig {
@@ -205,3 +219,21 @@ export interface AuthConfig {
         binding: string;
     };
 }
+/** Runtime pipeline context - shared across runtime step handlers */
+export interface RuntimeContext<E extends Env = Env> {
+    request: Request;
+    env: E;
+    ctx: ExecutionContext;
+    url: URL;
+    params: Record<string, string>;
+    locals: Record<string, any>;
+}
+export type RuntimeNext = () => Promise<Response>;
+export type RuntimeErrorResult = Response | null | undefined | void;
+export interface RuntimeStep<E extends Env = Env> {
+    request?: (ctx: RuntimeContext<E>, next: RuntimeNext) => Promise<Response> | Response;
+    route?: (ctx: RuntimeContext<E>, next: RuntimeNext) => Promise<Response> | Response;
+    response?: (ctx: RuntimeContext<E>, response: Response) => Promise<Response> | Response;
+    error?: (ctx: RuntimeContext<E>, error: unknown) => Promise<RuntimeErrorResult> | RuntimeErrorResult;
+}
+export type RuntimeDefinition<E extends Env = Env> = Record<string, RuntimeStep<E>>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "@kuratchi/js",
-    "version":  "0.0.2",
+    "version":  "0.0.3",
     "description":  "A thin, Cloudflare Workers-native web framework with Svelte-inspired syntax",
     "type":  "module",
     "main":  "./dist/index.js",