@kuratchi/js 0.0.21 → 0.0.22

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/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,6 +1,6 @@
 {
     "name": "@kuratchi/js",
-    "version": "0.0.21",
+    "version": "0.0.22",
     "description": "A thin, Cloudflare Workers-native web framework with Svelte-inspired syntax",
     "license": "MIT",
     "type": "module",