@kuratchi/js 0.0.20 → 0.0.22

package/dist/create.js

@@ -192,11 +192,11 @@ function scaffold(dir, opts) {
     if (orm || enableDO) {
         dirs.push('src/schemas');
     }
-    if (orm) {
-        dirs.push('src/database');
+    if (orm || enableDO || auth) {
+        dirs.push('src/server');
     }
     if (enableDO) {
-        dirs.push('src/server', 'src/routes/notes');
+        dirs.push('src/routes/notes');
     }
     if (auth) {
         dirs.push('src/routes/auth', 'src/routes/auth/login', 'src/routes/auth/signup', 'src/routes/admin');
@@ -214,19 +214,19 @@ function scaffold(dir, 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/server/items.ts', genItemsCrud());
         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/server/notes.ts', genNotesDb());
         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/server/auth.ts', genAuthFunctions());
+        write(dir, 'src/server/admin.ts', genAdminLoader());
         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());
@@ -449,7 +449,7 @@ export async function deleteNote(id: number): Promise<void> {
 }
 function genNotesPage() {
     return `<script>
-  import { getNotes, addNote, deleteNote } from '$database/notes';
+  import { getNotes, addNote, deleteNote } from '$server/notes';
 
   const notes = await getNotes();
 </script>
@@ -473,7 +473,7 @@ if (notes.length === 0) {
     for (const note of notes) {
       <article>
         <span>{note.title}</span>
-        <button data-action="deleteNote" data-args={JSON.stringify([note.id])}>Remove</button>
+        <button data-post={deleteNote(note.id)} data-refresh="" type="button">Remove</button>
       </article>
     }
   </section>
@@ -631,10 +631,10 @@ ${types}
 `;
 }
 function genItemsCrud() {
-    return `import { env } from 'cloudflare:workers';
-import { kuratchiORM } from '@kuratchi/orm';
-import { redirect } from '${FRAMEWORK_PACKAGE_NAME}';
-import type { Item } from './schemas/app';
+    return `import { env } from 'cloudflare:workers';
+import { kuratchiORM } from '@kuratchi/orm';
+import { redirect } from '${FRAMEWORK_PACKAGE_NAME}';
+import type { Item } from '../schemas/app';
 
 const db = kuratchiORM(() => (env as any).DB);
 
@@ -664,7 +664,7 @@ export async function toggleItem(id: number): Promise<void> {
 }
 function genItemsPage() {
     return `<script>
-  import { getItems, addItem, deleteItem, toggleItem } from '$database/items';
+  import { getItems, addItem, deleteItem, toggleItem } from '$server/items';
   import EmptyState from '@kuratchi/ui/empty-state.html';
 
   const items = await getItems();
@@ -690,10 +690,10 @@ if (items.length === 0) {
       <article>
         <span style={item.done ? 'text-decoration: line-through; opacity: 0.5' : ''}>{item.title}</span>
         <div>
-          <button data-action="toggleItem" data-args={JSON.stringify([item.id])}>
+          <button data-post={toggleItem(item.id)} data-refresh="" type="button">
             {item.done ? '↩' : '✓'}
           </button>
-          <button data-action="deleteItem" data-args={JSON.stringify([item.id])}>✕</button>
+          <button data-post={deleteItem(item.id)} data-refresh="" type="button">✕</button>
         </div>
       </article>
     }
@@ -905,7 +905,7 @@ export async function getAdminData() {
 }
 function genLoginPage() {
     return `<script>
-  import { signIn } from '$database/auth';
+  import { signIn } from '$server/auth';
   import AuthCard from '@kuratchi/ui/auth-card.html';
 </script>
 
@@ -933,7 +933,7 @@ function genLoginPage() {
 }
 function genSignupPage() {
     return `<script>
-  import { signUp } from '$database/auth';
+  import { signUp } from '$server/auth';
   import AuthCard from '@kuratchi/ui/auth-card.html';
 </script>
 
@@ -965,7 +965,7 @@ function genSignupPage() {
 }
 function genAdminPage() {
     return `<script>
-  import { getAdminData, signOut } from '$database/admin';
+  import { getAdminData, signOut } from '$server/admin';
   import Badge from '@kuratchi/ui/badge.html';
   import Card from '@kuratchi/ui/card.html';
   import DataList from '@kuratchi/ui/data-list.html';

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export { SchemaValidationError, schema, } from './runtime/schema.js';
 export { ActionError } from './runtime/action.js';
 export { PageError } from './runtime/page-error.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, RuntimeContext, RuntimeDefinition, RuntimeStep, RuntimeNext, RuntimeErrorResult, } from './runtime/types.js';
+export type { AppConfig, kuratchiConfig, DatabaseConfig, DesktopConfig, DesktopRemoteBindingConfig, DesktopWindowConfig, AuthConfig, RouteContext, RouteModule, RuntimeContext, RuntimeDefinition, RuntimeStep, RuntimeNext, RuntimeErrorResult, } from './runtime/types.js';
 export type { RpcOf } from './runtime/do.js';
 export type { SchemaType, InferSchema } from './runtime/schema.js';
 export { url, pathname, searchParams, headers, method, params, slug } from './runtime/request.js';

package/dist/runtime/context.d.ts

@@ -43,7 +43,9 @@ export declare function getParam(name: string): string | undefined;
  * Throws a redirect signal consumed by the framework's PRG flow.
  */
 export declare function redirect(path: string, status?: number): never;
-/** Backward-compatible alias for redirect() */
+/**
+ * @deprecated Use redirect() instead. This alias will be removed in a future version.
+ */
 export declare function goto(path: string, status?: number): never;
 export declare function setBreadcrumbs(items: BreadcrumbItem[]): void;
 export declare function getBreadcrumbs(): BreadcrumbItem[];

package/dist/runtime/context.js

@@ -104,7 +104,9 @@ export function redirect(path, status = 303) {
     __locals.__redirectStatus = status;
     throw new RedirectError(path, status);
 }
-/** Backward-compatible alias for redirect() */
+/**
+ * @deprecated Use redirect() instead. This alias will be removed in a future version.
+ */
 export function goto(path, status = 303) {
     redirect(path, status);
 }

package/dist/runtime/desktop.d.ts

@@ -0,0 +1,19 @@
+export interface DesktopNotificationPayload {
+    title: string;
+    body?: string;
+}
+export interface DesktopCommandRequest {
+    command: string;
+    workingDirectory?: string;
+    timeoutMs?: number;
+}
+export interface DesktopCommandResult {
+    ok: boolean;
+    error?: string | null;
+    exitCode: number;
+    durationMs: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function showDesktopNotification(payload: DesktopNotificationPayload): Promise<boolean>;
+export declare function runDesktopCommand(request: DesktopCommandRequest): Promise<DesktopCommandResult | null>;

package/dist/runtime/desktop.js

@@ -0,0 +1,82 @@
+import { getRequest } from './context.js';
+function parseCookie(header, name) {
+    if (!header)
+        return null;
+    for (const part of header.split(';')) {
+        const [rawKey, ...rest] = part.split('=');
+        if ((rawKey ?? '').trim() !== name)
+            continue;
+        return rest.join('=').trim() || null;
+    }
+    return null;
+}
+function getDesktopApiOrigin() {
+    const request = getRequest();
+    const headerOrigin = request.headers.get('x-kuratchi-desktop-api-origin')
+        || request.headers.get('x-kuratchi-desktop-origin');
+    if (headerOrigin)
+        return headerOrigin;
+    const cookieOrigin = parseCookie(request.headers.get('cookie'), '__kuratchi_desktop_api');
+    if (!cookieOrigin)
+        return null;
+    try {
+        return decodeURIComponent(cookieOrigin);
+    }
+    catch {
+        return cookieOrigin;
+    }
+}
+export async function showDesktopNotification(payload) {
+    const title = payload.title?.trim();
+    if (!title) {
+        throw new Error('showDesktopNotification requires a title.');
+    }
+    const desktopApiOrigin = getDesktopApiOrigin();
+    if (!desktopApiOrigin) {
+        return false;
+    }
+    const response = await fetch(new URL('/notifications/show', desktopApiOrigin), {
+        method: 'POST',
+        headers: {
+            'content-type': 'application/json',
+        },
+        body: JSON.stringify({
+            title,
+            body: payload.body ?? '',
+        }),
+    });
+    if (response.status === 404) {
+        return false;
+    }
+    if (!response.ok) {
+        console.warn(`[kuratchi] Desktop notification request failed with status ${response.status}.`);
+        return false;
+    }
+    const payloadResult = await response.json().catch(() => null);
+    return payloadResult?.ok === true;
+}
+export async function runDesktopCommand(request) {
+    const command = request.command?.trim();
+    if (!command) {
+        throw new Error('runDesktopCommand requires a command.');
+    }
+    const desktopApiOrigin = getDesktopApiOrigin();
+    if (!desktopApiOrigin) {
+        return null;
+    }
+    const response = await fetch(new URL('/commands/run', desktopApiOrigin), {
+        method: 'POST',
+        headers: {
+            'content-type': 'application/json',
+        },
+        body: JSON.stringify({
+            command,
+            workingDirectory: request.workingDirectory ?? null,
+            timeoutMs: request.timeoutMs ?? 30000,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`[kuratchi] Desktop command request failed with status ${response.status}.`);
+    }
+    return await response.json();
+}

package/dist/runtime/navigation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Navigation helpers for kuratchi routes.
+ * Import via: import { redirect } from 'kuratchi:navigation';
+ *
+ * redirect() is server-side only — works in route scripts, server modules, and form actions.
+ * It throws a RedirectError that the framework catches and converts to a 303 redirect response.
+ */
+export { redirect } from './context.js';

package/dist/runtime/navigation.js

@@ -0,0 +1,8 @@
+/**
+ * Navigation helpers for kuratchi routes.
+ * Import via: import { redirect } from 'kuratchi:navigation';
+ *
+ * redirect() is server-side only — works in route scripts, server modules, and form actions.
+ * It throws a RedirectError that the framework catches and converts to a 303 redirect response.
+ */
+export { redirect } from './context.js';

package/dist/runtime/request.d.ts

@@ -1,3 +1,11 @@
+declare global {
+    namespace App {
+        /** Request-scoped locals set by runtime hooks. Extend in your app.d.ts */
+        interface Locals {
+            [key: string]: unknown;
+        }
+    }
+}
 export declare let url: URL;
 export declare let pathname: string;
 export declare let searchParams: URLSearchParams;
@@ -5,5 +13,25 @@ export declare let headers: Headers;
 export declare let method: string;
 export declare let params: Record<string, string>;
 export declare let slug: string | undefined;
+/**
+ * Get request-scoped locals with full type safety.
+ * Define your Locals type in src/app.d.ts:
+ * ```
+ * declare global {
+ *   namespace App {
+ *     interface Locals {
+ *       userId: number;
+ *       userEmail: string;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare function getLocals(): App.Locals;
+/**
+ * Direct access to request-scoped locals.
+ * Type is inferred from App.Locals declared in your app.d.ts.
+ */
+export declare const locals: App.Locals;
 export declare function __setRequestState(request: Request): void;
 export declare function __setRequestParams(nextParams: Record<string, string> | null | undefined): void;

package/dist/runtime/request.js

@@ -1,3 +1,4 @@
+import { __getLocals } from './context.js';
 export let url = new URL('http://localhost/');
 export let pathname = '/';
 export let searchParams = url.searchParams;
@@ -5,6 +6,49 @@ export let headers = new Headers();
 export let method = 'GET';
 export let params = {};
 export let slug = undefined;
+/**
+ * Get request-scoped locals with full type safety.
+ * Define your Locals type in src/app.d.ts:
+ * ```
+ * declare global {
+ *   namespace App {
+ *     interface Locals {
+ *       userId: number;
+ *       userEmail: string;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export function getLocals() {
+    return __getLocals();
+}
+/**
+ * Direct access to request-scoped locals.
+ * Type is inferred from App.Locals declared in your app.d.ts.
+ */
+export const locals = new Proxy({}, {
+    get(_target, prop) {
+        return __getLocals()[prop];
+    },
+    set(_target, prop, value) {
+        __getLocals()[prop] = value;
+        return true;
+    },
+    has(_target, prop) {
+        return prop in __getLocals();
+    },
+    ownKeys() {
+        return Reflect.ownKeys(__getLocals());
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+        const locals = __getLocals();
+        if (prop in locals) {
+            return { configurable: true, enumerable: true, value: locals[prop] };
+        }
+        return undefined;
+    },
+});
 function __syncDerivedState() {
     pathname = url.pathname;
     searchParams = url.searchParams;

package/dist/runtime/types.d.ts

@@ -78,6 +78,35 @@ export interface DatabaseConfig {
     type?: 'd1' | 'do';
     /** Skip migrations for this database (e.g., in production). Default: false */
     skipMigrations?: boolean;
+    /** Use the deployed Cloudflare resource during local development. */
+    remote?: boolean;
+}
+export interface DesktopWindowConfig {
+    title?: string;
+    width?: number;
+    height?: number;
+}
+export interface DesktopRemoteBindingConfig {
+    type: 'd1' | 'r2';
+    remote?: boolean;
+}
+export interface DesktopConfig {
+    /** Human-readable app name shown by the desktop host. */
+    appName?: string;
+    /** Stable app identifier used by the host/runtime. */
+    appId?: string;
+    /** Initial route loaded by the host. Defaults to '/'. */
+    initialPath?: string;
+    /** Single-window host settings. */
+    window?: DesktopWindowConfig;
+    /** Desktop-native bindings exposed by the host. */
+    bindings?: {
+        notifications?: boolean;
+        files?: boolean;
+        [key: string]: any;
+    };
+    /** Remote Cloudflare bindings the desktop runtime should proxy. */
+    remoteBindings?: Record<string, DesktopRemoteBindingConfig>;
 }
 /**
  * Framework configuration â€" the user-facing config file (kuratchi.config.ts)
@@ -108,6 +137,12 @@ export interface kuratchiConfig<E extends Env = Env> {
     ui?: {
         /** Theme to inject: 'default' uses @kuratchi/ui's built-in theme, or a path to a custom CSS file */
         theme?: 'default' | string;
+        /** Corner radius preference used by the built-in UI helpers. */
+        radius?: 'default' | 'none' | 'full';
+        /** Optional first-party styling library integration. */
+        library?: 'tailwindcss';
+        /** Optional plugin list for the selected UI library. */
+        plugins?: string[];
     };
     /** Auth configuration â€" @kuratchi/auth plugin setup */
     auth?: AuthConfig | Record<string, any>;
@@ -137,6 +172,8 @@ export interface kuratchiConfig<E extends Env = Env> {
         /** DO source files (e.g. ['auth.do.ts', 'sites.do.ts']) */
         files?: string[];
     }>;
+    /** Desktop target configuration consumed by `kuratchi run`. */
+    desktop?: DesktopConfig;
 }
 /** Auth configuration for kuratchi.config.ts */
 export interface AuthConfig {

package/package.json

@@ -1,72 +1,76 @@
-{
-    "name": "@kuratchi/js",
-    "version": "0.0.20",
-    "description": "A thin, Cloudflare Workers-native web framework with Svelte-inspired syntax",
-    "license": "MIT",
-    "type": "module",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "bin": {
-        "kuratchi": "dist/cli.js"
-    },
-    "files": [
-        "dist",
-        "README.md",
-        "LICENSE"
-    ],
-    "scripts": {
-        "build": "tsc -p tsconfig.build.json",
-        "check": "tsc -p tsconfig.build.json --noEmit",
-        "test": "bun test",
-        "test:watch": "bun test --watch",
-        "prepublishOnly": "npm run build"
-    },
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        },
-        "./runtime/context.js": {
-            "types": "./dist/runtime/context.d.ts",
-            "import": "./dist/runtime/context.js"
-        },
-        "./request": {
-            "types": "./dist/runtime/request.d.ts",
-            "import": "./dist/runtime/request.js"
-        },
-        "./runtime/do.js": {
-            "types": "./dist/runtime/do.d.ts",
-            "import": "./dist/runtime/do.js"
-        },
-        "./runtime/schema.js": {
-            "types": "./dist/runtime/schema.d.ts",
-            "import": "./dist/runtime/schema.js"
-        },
-        "./runtime/generated-worker.js": {
-            "types": "./dist/runtime/generated-worker.d.ts",
-            "import": "./dist/runtime/generated-worker.js"
-        },
-        "./compiler": {
-            "types": "./dist/compiler/index.d.ts",
-            "import": "./dist/compiler/index.js"
-        },
-        "./environment": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        },
-        "./package.json": "./package.json"
-    },
-    "engines": {
-        "node": ">=18"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "dependencies": {
-        "typescript": "^5.8.0"
-    },
-    "devDependencies": {
-        "@cloudflare/workers-types": "^4.20260223.0",
-        "@types/node": "^24.4.0"
-    }
-}
+{
+    "name": "@kuratchi/js",
+    "version": "0.0.22",
+    "description": "A thin, Cloudflare Workers-native web framework with Svelte-inspired syntax",
+    "license": "MIT",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "bin": {
+        "kuratchi": "dist/cli.js"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.build.json",
+        "check": "tsc -p tsconfig.build.json --noEmit",
+        "test": "bun test",
+        "test:watch": "bun test --watch",
+        "prepublishOnly": "npm run build"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./runtime/context.js": {
+            "types": "./dist/runtime/context.d.ts",
+            "import": "./dist/runtime/context.js"
+        },
+        "./request": {
+            "types": "./dist/runtime/request.d.ts",
+            "import": "./dist/runtime/request.js"
+        },
+        "./navigation": {
+            "types": "./dist/runtime/navigation.d.ts",
+            "import": "./dist/runtime/navigation.js"
+        },
+        "./runtime/do.js": {
+            "types": "./dist/runtime/do.d.ts",
+            "import": "./dist/runtime/do.js"
+        },
+        "./runtime/schema.js": {
+            "types": "./dist/runtime/schema.d.ts",
+            "import": "./dist/runtime/schema.js"
+        },
+        "./runtime/generated-worker.js": {
+            "types": "./dist/runtime/generated-worker.d.ts",
+            "import": "./dist/runtime/generated-worker.js"
+        },
+        "./compiler": {
+            "types": "./dist/compiler/index.d.ts",
+            "import": "./dist/compiler/index.js"
+        },
+        "./environment": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "dependencies": {
+        "typescript": "^5.8.0"
+    },
+    "devDependencies": {
+        "@cloudflare/workers-types": "^4.20260223.0",
+        "@types/node": "^24.4.0"
+    }
+}