@kuratchi/js 0.0.1 → 0.0.3

package/dist/compiler/index.js

@@ -17,10 +17,10 @@ function getFrameworkPackageName() {
     try {
         const raw = fs.readFileSync(new URL('../../package.json', import.meta.url), 'utf-8');
         const parsed = JSON.parse(raw);
-        return parsed.name || 'KuratchiJS';
+        return parsed.name || '@kuratchi/js';
     }
     catch {
-        return 'KuratchiJS';
+        return '@kuratchi/js';
     }
 }
 function compactInlineJs(source) {
@@ -36,7 +36,9 @@ function compactInlineJs(source) {
  *
  * The generated module exports { app } — an object with a fetch() method
  * that handles routing, load functions, form actions, and rendering.
- * The project's src/index.ts imports this and re-exports it as the Worker default.
+ * Returns the path to .kuratchi/worker.js — the stable wrangler entry point that
+ * re-exports everything from routes.js (default fetch handler + named DO class exports).
+ * No src/index.ts is needed in user projects.
  */
 export function compile(options) {
     const { projectDir } = options;
@@ -182,8 +184,8 @@ export function compile(options) {
   function by(sel, root){ return Array.prototype.slice.call((root || document).querySelectorAll(sel)); }
   var __refreshSeq = Object.create(null);
   function syncGroup(group){
-    var items = by('[data-select-item="' + group + '"]');
-    var masters = by('[data-select-all="' + group + '"]');
+    var items = by('[data-select-item]').filter(function(el){ return el.getAttribute('data-select-item') === group; });
+    var masters = by('[data-select-all]').filter(function(el){ return el.getAttribute('data-select-all') === group; });
     if(!items.length || !masters.length) return;
     var all = items.every(function(i){ return !!i.checked; });
     var any = items.some(function(i){ return !!i.checked; });
@@ -306,6 +308,7 @@ export function compile(options) {
       if(g && !g.hasAttribute('data-as') && !g.hasAttribute('data-action')){
         var getUrl = g.getAttribute('data-get');
         if(getUrl){
+          if(/^[a-z][a-z0-9+\-.]*:/i.test(getUrl) && !/^https?:/i.test(getUrl)) return;
           e.preventDefault();
           location.assign(getUrl);
           return;
@@ -446,7 +449,7 @@ export function compile(options) {
     if(!t || !t.getAttribute) return;
     var gAll = t.getAttribute('data-select-all');
     if(gAll){
-      by('[data-select-item="' + gAll + '"]').forEach(function(i){ i.checked = !!t.checked; });
+      by('[data-select-item]').filter(function(i){ return i.getAttribute('data-select-item') === gAll; }).forEach(function(i){ i.checked = !!t.checked; });
       syncGroup(gAll);
       return;
     }
@@ -528,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)
         : [];
@@ -864,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,
@@ -879,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');
@@ -887,7 +896,28 @@ export function compile(options) {
         fs.mkdirSync(outDir, { recursive: true });
     }
     writeIfChanged(outFile, output);
-    return outFile;
+    // Generate .kuratchi/worker.js — the stable wrangler entry point.
+    // routes.js already exports the default fetch handler and all named DO classes;
+    // 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'));
+    return workerFile;
 }
 // ── Helpers ─────────────────────────────────────────────────────────────
 /**
@@ -1127,7 +1157,7 @@ function buildRouteObject(opts) {
             body = [body, queryLines.join('\n')].filter(Boolean).join('\n');
         }
         // Rewrite imported function calls: fnName( → __mN.fnName(
-        // No env injection — server functions use getEnv() from the framework context
+        // Rewrite imported function calls to use the module namespace
         for (const [fnName, moduleId] of Object.entries(fnToModule)) {
             if (!/^[A-Za-z_$][\w$]*$/.test(fnName))
                 continue;
@@ -1350,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 [];
@@ -1650,7 +1763,10 @@ function generateRoutesModule(opts) {
         .map(([status, fn]) => fn)
         .join('\n\n');
     // Resolve path to the framework's context module from the output directory
-    const contextImport = `import { __setRequestContext, __setEnvCompat, __esc, __setLocal, __getLocals, buildDefaultBreadcrumbs as __buildDefaultBreadcrumbs } from '${RUNTIME_CONTEXT_IMPORT}';`;
+    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) {
@@ -1916,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 ──────────────────────────────────────────────────────
 
@@ -2060,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);
-    __setEnvCompat(this.env);
-${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?.[__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 = route.actions?.[actionName] || __layoutActions[actionName];
-      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 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)$/, '');
+}