@kuratchi/js 0.0.17 → 0.0.19

package/README.md

@@ -42,9 +42,9 @@ For the framework's internal compiler/runtime orchestration and tracked implemen
 Place `.html` files inside `src/routes/`. The file path becomes the URL pattern.
 
 ```
-src/routes/page.html          → /
-src/routes/items/page.html    → /items
-src/routes/blog/[slug]/page.html → /blog/:slug
+src/routes/index.html          → /
+src/routes/items/index.html    → /items
+src/routes/blog/[slug]/index.html → /blog/:slug
 src/routes/layout.html        → shared layout wrapping all routes
 ```
 
@@ -277,7 +277,7 @@ Throw `PageError` from a route's load scope to return the correct HTTP error pag
 ```ts
 import { PageError } from '@kuratchi/js';
 
-// In src/routes/posts/[id]/page.html <script> block:
+// In src/routes/posts/[id]/index.html <script> block:
 const post = await db.posts.findOne({ id: params.id });
 if (!post) throw new PageError(404);
 if (!post.isPublished && !currentUser?.isAdmin) throw new PageError(403);

package/dist/compiler/import-linking.js

@@ -120,7 +120,7 @@ export function linkRouteServerImports(opts) {
                 continue;
             }
             fnToModule[binding.local] = moduleId;
-            if (!routeImportDeclMap.has(binding.local) && !RESERVED_RENDER_VARS.has(binding.local)) {
+            if (!routeImportDeclMap.has(binding.local)) {
                 const accessExpr = binding.imported === 'default' ? `${moduleId}.default` : `${moduleId}.${binding.imported}`;
                 routeImportDeclMap.set(binding.local, `const ${binding.local} = ${accessExpr};`);
             }

package/dist/compiler/index.js

@@ -18,7 +18,7 @@ import { prepareRootLayoutSource } from './root-layout-pipeline.js';
 import { generateRoutesModule as generateRoutesModulePipeline } from './routes-module-pipeline.js';
 import { assembleRouteState } from './route-state-pipeline.js';
 import { createServerModuleCompiler } from './server-module-pipeline.js';
-import { buildWorkerEntrypointSource, resolveRuntimeImportPath as resolveRuntimeImportPathPipeline, } from './worker-output-pipeline.js';
+import { buildCompatEntrypointSource, buildWorkerEntrypointSource, resolveRuntimeImportPath as resolveRuntimeImportPathPipeline, } from './worker-output-pipeline.js';
 import { syncWranglerConfig as syncWranglerConfigPipeline } from './wrangler-sync.js';
 import { filePathToPattern } from '../runtime/router.js';
 import * as fs from 'node:fs';
@@ -220,7 +220,7 @@ export async function compile(options) {
             }));
             continue;
         }
-        // -- Page route (page.html) --
+        // -- Page route (index.html) --
         const source = fileContents.get(fullPath) ?? fs.readFileSync(fullPath, 'utf-8');
         const parsed = parseFile(source, { kind: 'route', filePath: fullPath });
         const routeState = assembleRouteState({
@@ -294,6 +294,7 @@ export async function compile(options) {
         fs.mkdirSync(outDir, { recursive: true });
     }
     writeIfChanged(outFile, output);
+    writeIfChanged(path.join(outDir, 'routes.js'), buildCompatEntrypointSource('./routes.ts'));
     // Generate .kuratchi/worker.ts — the stable wrangler entry point.
     // routes.ts already exports the default fetch handler and all named DO classes;
     // worker.ts explicitly re-exports them so wrangler.jsonc can reference a
@@ -305,6 +306,7 @@ export async function compile(options) {
         doClassNames: doConfig.map((entry) => entry.className),
         workerClassEntries: [...agentConfig, ...containerConfig, ...workflowConfig],
     }));
+    writeIfChanged(path.join(outDir, 'worker.js'), buildCompatEntrypointSource('./worker.ts'));
     // Auto-sync wrangler.jsonc with workflow/container/DO config from kuratchi.config.ts
     syncWranglerConfigPipeline({
         projectDir,

package/dist/compiler/root-layout-pipeline.js

@@ -354,8 +354,18 @@ const BRIDGE_SOURCE = `(function(){
       (function tick(){
         setTimeout(function(){
           fetch(location.pathname + location.search, { headers: { 'x-kuratchi-fragment': pollId } })
-            .then(function(r){ return r.text(); })
+            .then(function(r){
+              if(r.status === 404){
+                // Fragment no longer exists (e.g., item completed and removed from list)
+                // Remove the element and stop polling
+                el.remove();
+                return null;
+              }
+              if(!r.ok) return null;
+              return r.text();
+            })
             .then(function(html){
+              if(html === null) return;
               if(prevHtml !== html){
                 el.innerHTML = html;
                 prevHtml = html;

package/dist/compiler/route-discovery.js

@@ -26,9 +26,9 @@ export function discoverRoutes(routesDir) {
         for (const entry of entries) {
             if (entry.isDirectory()) {
                 const childPrefix = prefix ? `${prefix}/${entry.name}` : entry.name;
-                const pageFile = path.join(dir, entry.name, 'page.html');
+                const pageFile = path.join(dir, entry.name, 'index.html');
                 if (fs.existsSync(pageFile)) {
-                    const routeFile = `${childPrefix}/page.html`;
+                    const routeFile = `${childPrefix}/index.html`;
                     if (!registered.has(routeFile)) {
                         registered.add(routeFile);
                         results.push({ file: routeFile, name: childPrefix, layouts: getLayoutsForPrefix(childPrefix), type: 'page' });
@@ -56,15 +56,15 @@ export function discoverRoutes(routesDir) {
                 }
                 continue;
             }
-            if (entry.name === 'page.html') {
-                const routeFile = prefix ? `${prefix}/page.html` : 'page.html';
+            if (entry.name === 'index.html') {
+                const routeFile = prefix ? `${prefix}/index.html` : 'index.html';
                 if (!registered.has(routeFile)) {
                     registered.add(routeFile);
                     results.push({ file: routeFile, name: prefix || 'index', layouts: getLayoutsForPrefix(prefix), type: 'page' });
                 }
                 continue;
             }
-            if (entry.name.endsWith('.html') && entry.name !== 'page.html') {
+            if (entry.name.endsWith('.html') && entry.name !== 'index.html') {
                 const name = prefix
                     ? `${prefix}/${entry.name.replace('.html', '')}`
                     : entry.name.replace('.html', '');

package/dist/compiler/route-pipeline.js

@@ -94,10 +94,18 @@ export function analyzeRouteBuild(opts) {
     const routeImportDecls = routeImportDeclLines.join('\n');
     const importedBindingNames = new Set(Object.keys(fnToModule));
     const renderScopeActionNames = new Set(parsed.actionFunctions);
+    // Filter out params/breadcrumbs from render prelude since they come from data destructuring
+    const reservedRenderVars = new Set(['params', 'breadcrumbs']);
     const renderImportPrelude = routeImportDeclLines
         .filter((statement) => {
         const declaredName = extractDeclaredConstName(statement);
-        return declaredName ? !renderScopeActionNames.has(declaredName) : true;
+        if (!declaredName)
+            return true;
+        if (renderScopeActionNames.has(declaredName))
+            return false;
+        if (reservedRenderVars.has(declaredName))
+            return false;
+        return true;
     })
         .join('\n');
     let scriptBody = '';

package/dist/compiler/routes-module-feature-blocks.js

@@ -311,10 +311,12 @@ function buildWorkflowStatusRpc(opts) {
     const rpcLines = [];
     rpcLines.push(`\n// Workflow Status RPCs (auto-generated)`);
     rpcLines.push(`const __workflowStatusRpc = {`);
+    const rpcNames = [];
     for (const workflow of opts.workflowConfig) {
         const baseName = workflow.file.split('/').pop()?.replace(/\.workflow\.ts$/, '') || '';
         const camelName = baseName.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
         const rpcName = `${camelName}WorkflowStatus`;
+        rpcNames.push(rpcName);
         rpcLines.push(`  '${rpcName}': async (instanceId) => {`);
         rpcLines.push(`    if (!instanceId) return { status: 'unknown', error: { name: 'Error', message: 'Missing instanceId' } };`);
         rpcLines.push(`    try {`);
@@ -326,5 +328,9 @@ function buildWorkflowStatusRpc(opts) {
         rpcLines.push(`  },`);
     }
     rpcLines.push(`};`);
+    // Export individual functions for use in route templates
+    for (const rpcName of rpcNames) {
+        rpcLines.push(`const ${rpcName} = __workflowStatusRpc['${rpcName}'];`);
+    }
     return rpcLines.join('\n');
 }

package/dist/compiler/worker-output-pipeline.d.ts

@@ -11,3 +11,4 @@ export declare function buildWorkerEntrypointSource(opts: {
     doClassNames: string[];
     workerClassEntries: WorkerClassExportEntry[];
 }): string;
+export declare function buildCompatEntrypointSource(targetFile: string): string;

package/dist/compiler/worker-output-pipeline.js

@@ -35,3 +35,11 @@ export function buildWorkerEntrypointSource(opts) {
         '',
     ].join('\n');
 }
+export function buildCompatEntrypointSource(targetFile) {
+    return [
+        '// Auto-generated by kuratchi — do not edit.',
+        `export { default } from '${targetFile}';`,
+        `export * from '${targetFile}';`,
+        '',
+    ].join('\n');
+}

package/dist/create.js

@@ -211,25 +211,25 @@ function scaffold(dir, opts) {
     write(dir, 'tsconfig.json', genTsConfig());
     write(dir, '.gitignore', genGitIgnore());
     write(dir, 'src/routes/layout.html', genLayout(opts));
-    write(dir, 'src/routes/page.html', genLandingPage(opts));
+    write(dir, 'src/routes/index.html', genLandingPage(opts));
     if (orm) {
         write(dir, 'src/schemas/app.ts', genSchema(opts));
         write(dir, 'src/database/items.ts', genItemsCrud());
-        write(dir, 'src/routes/items/page.html', genItemsPage());
+        write(dir, 'src/routes/items/index.html', genItemsPage());
     }
     if (enableDO) {
         write(dir, 'src/schemas/notes.ts', genNotesSchema());
         write(dir, 'src/server/notes.do.ts', genNotesDoHandler());
         write(dir, 'src/database/notes.ts', genNotesDb());
-        write(dir, 'src/routes/notes/page.html', genNotesPage());
+        write(dir, 'src/routes/notes/index.html', genNotesPage());
     }
     if (auth) {
         write(dir, '.dev.vars', genDevVars());
         write(dir, 'src/database/auth.ts', genAuthFunctions());
         write(dir, 'src/database/admin.ts', genAdminLoader());
-        write(dir, 'src/routes/auth/login/page.html', genLoginPage());
-        write(dir, 'src/routes/auth/signup/page.html', genSignupPage());
-        write(dir, 'src/routes/admin/page.html', genAdminPage());
+        write(dir, 'src/routes/auth/login/index.html', genLoginPage());
+        write(dir, 'src/routes/auth/signup/index.html', genSignupPage());
+        write(dir, 'src/routes/admin/index.html', genAdminPage());
     }
 }
 function write(dir, filePath, content) {
@@ -278,7 +278,7 @@ function genPackageJson(opts) {
 function genWrangler(opts) {
     const config = {
         name: opts.name,
-        main: '.kuratchi/worker.js',
+        main: '.kuratchi/worker.ts',
         compatibility_date: new Date().toISOString().split('T')[0],
         compatibility_flags: ['nodejs_compat'],
     };

package/dist/runtime/security.js

@@ -32,6 +32,7 @@ export function initCsrf(request, cookieName = CSRF_COOKIE_NAME) {
     }
     __setLocal('__csrfToken', token);
     __setLocal('__csrfCookieName', cookieName);
+    __setLocal('__csrfCookieSecure', shouldUseSecureCookie(request));
     return token;
 }
 /**
@@ -94,9 +95,10 @@ export function getCsrfCookieHeader() {
     }
     const token = locals.__csrfToken;
     const cookieName = locals.__csrfCookieName || CSRF_COOKIE_NAME;
+    const secure = locals.__csrfCookieSecure ? '; Secure' : '';
     // SameSite=Lax allows the cookie to be sent on top-level navigations
     // HttpOnly=false so client JS can read it for fetch requests
-    return `${cookieName}=${token}; Path=/; SameSite=Lax; Secure`;
+    return `${cookieName}=${token}; Path=/; SameSite=Lax${secure}`;
 }
 // ── RPC Security ───────────────────────────────────────────────────
 const RPC_NONCE_LENGTH = 16;
@@ -191,6 +193,18 @@ function parseCookies(header) {
     }
     return map;
 }
+function shouldUseSecureCookie(request) {
+    const forwardedProto = request.headers.get('x-forwarded-proto');
+    if (forwardedProto) {
+        return forwardedProto.split(',')[0].trim().toLowerCase() === 'https';
+    }
+    try {
+        return new URL(request.url).protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
 function isSameOrigin(request, url) {
     const fetchSite = request.headers.get('sec-fetch-site');
     if (fetchSite && fetchSite !== 'same-origin' && fetchSite !== 'same-site' && fetchSite !== 'none') {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kuratchi/js",
-    "version": "0.0.17",
+    "version": "0.0.19",
     "description": "A thin, Cloudflare Workers-native web framework with Svelte-inspired syntax",
     "license": "MIT",
     "type": "module",