@kuratchi/js 0.0.1 → 0.0.3

package/dist/create.js

@@ -14,10 +14,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';
     }
 }
 // ── Prompt Helpers ──────────────────────────────────────────
@@ -43,6 +43,7 @@ function confirm(question, defaultYes = true) {
 }
 export async function create(projectName, flags = []) {
     const autoYes = flags.includes('--yes') || flags.includes('-y');
+    const forceDO = flags.includes('--do');
     console.log('\nâš¡ Create a new KuratchiJS project\n');
     // Project name
     const name = projectName || (autoYes ? 'my-kuratchi-app' : await ask('Project name', 'my-kuratchi-app'));
@@ -59,14 +60,20 @@ export async function create(projectName, flags = []) {
     // Feature selection
     const ui = autoYes ? true : await confirm('Include @kuratchi/ui theme?');
     const orm = autoYes ? true : await confirm('Include @kuratchi/orm with D1?');
-    const auth = autoYes ? true : (orm ? await confirm('Include @kuratchi/auth (credentials login)?') : false);
-    if (auth && !orm) {
+    const enableDO = forceDO || (autoYes ? false : await confirm('Include Durable Objects (SQLite-backed DO)?', false));
+    const effectiveOrm = orm || enableDO;
+    const auth = autoYes ? true : (effectiveOrm ? await confirm('Include @kuratchi/auth (credentials login)?') : false);
+    if (enableDO && !orm) {
+        console.log('  ℹ DO uses @kuratchi/orm internally — enabling ORM.');
+    }
+    if (auth && !effectiveOrm) {
         console.log('  ℹ Auth requires ORM — enabling ORM automatically');
     }
     console.log();
     console.log(`  Project:  ${name}`);
     console.log(`  UI:       ${ui ? '✓' : '—'}`);
-    console.log(`  ORM:      ${orm ? '✓' : '—'}`);
+    console.log(`  D1 ORM:   ${orm ? '✓' : '—'}`);
+    console.log(`  DO:       ${enableDO ? '✓' : '—'}`);
     console.log(`  Auth:     ${auth ? '✓' : '—'}`);
     console.log();
     if (!autoYes) {
@@ -82,7 +89,7 @@ export async function create(projectName, flags = []) {
     const monorepoRoot = detectMonorepo(targetDir);
     const isMonorepo = !!monorepoRoot;
     // Scaffold files
-    const opts = { name, ui, orm, auth, monorepo: isMonorepo, monorepoRoot, projectDir: targetDir };
+    const opts = { name, ui, orm, do: enableDO, auth, monorepo: isMonorepo, monorepoRoot, projectDir: targetDir };
     scaffold(targetDir, opts);
     // ── Post-scaffold setup ─────────────────────────────────────
     console.log();
@@ -118,7 +125,7 @@ export async function create(projectName, flags = []) {
     // 4. Build routes
     step('Building routes...');
     if (isMonorepo && monorepoRoot) {
-        const cliPath = path.join(monorepoRoot, 'packages', 'KuratchiJS', 'src', 'cli.ts');
+        const cliPath = path.join(monorepoRoot, 'packages', 'kuratchi-js', 'src', 'cli.ts');
         if (fs.existsSync(cliPath)) {
             run(`bun run --bun ${cliPath} build`, targetDir);
         }
@@ -156,7 +163,7 @@ function detectMonorepo(targetDir) {
     // Walk up from target to find a workspace root with packages/kuratchi-js
     let dir = path.dirname(targetDir);
     for (let i = 0; i < 5; i++) {
-        if (fs.existsSync(path.join(dir, 'packages', 'KuratchiJS', 'package.json'))) {
+        if (fs.existsSync(path.join(dir, 'packages', 'kuratchi-js', 'package.json'))) {
             return dir;
         }
         const parent = path.dirname(dir);
@@ -175,14 +182,21 @@ function patchWranglerDbId(dir, dbId) {
 // ── Scaffold ────────────────────────────────────────────────
 function scaffold(dir, opts) {
     const { name, ui, orm, auth } = opts;
+    const enableDO = opts.do;
     // Create directory structure
     const dirs = [
         '',
         'src',
         'src/routes',
     ];
+    if (orm || enableDO) {
+        dirs.push('src/schemas');
+    }
     if (orm) {
-        dirs.push('src/database', 'src/schemas');
+        dirs.push('src/database');
+    }
+    if (enableDO) {
+        dirs.push('src/server', 'src/routes/notes');
     }
     if (auth) {
         dirs.push('src/routes/auth', 'src/routes/auth/login', 'src/routes/auth/signup', 'src/routes/admin');
@@ -196,7 +210,6 @@ function scaffold(dir, opts) {
     write(dir, 'kuratchi.config.ts', genConfig(opts));
     write(dir, 'tsconfig.json', genTsConfig());
     write(dir, '.gitignore', genGitIgnore());
-    write(dir, 'src/index.ts', genWorkerEntry(opts));
     write(dir, 'src/routes/layout.html', genLayout(opts));
     write(dir, 'src/routes/page.html', genLandingPage(opts));
     if (orm) {
@@ -204,6 +217,12 @@ function scaffold(dir, opts) {
         write(dir, 'src/database/items.ts', genItemsCrud());
         write(dir, 'src/routes/items/page.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());
+    }
     if (auth) {
         write(dir, '.dev.vars', genDevVars());
         write(dir, 'src/database/auth.ts', genAuthFunctions());
@@ -235,7 +254,7 @@ function genPackageJson(opts) {
     let devScript = 'kuratchi dev';
     let buildScript = 'kuratchi build';
     if (opts.monorepo && opts.monorepoRoot) {
-        const cliAbs = path.join(opts.monorepoRoot, 'packages', 'KuratchiJS', 'src', 'cli.ts');
+        const cliAbs = path.join(opts.monorepoRoot, 'packages', 'kuratchi-js', 'src', 'cli.ts');
         const relCli = path.relative(opts.projectDir, cliAbs).replace(/\\/g, '/');
         devScript = `bun run --bun ${relCli} dev`;
         buildScript = `bun run --bun ${relCli} build`;
@@ -259,7 +278,7 @@ function genPackageJson(opts) {
 function genWrangler(opts) {
     const config = {
         name: opts.name,
-        main: 'src/index.ts',
+        main: '.kuratchi/worker.js',
         compatibility_date: new Date().toISOString().split('T')[0],
         compatibility_flags: ['nodejs_compat'],
     };
@@ -272,6 +291,14 @@ function genWrangler(opts) {
             },
         ];
     }
+    if (opts.do) {
+        config.durable_objects = {
+            bindings: [{ name: 'NOTES_DO', class_name: 'NotesDO' }],
+        };
+        config.migrations = [
+            { tag: 'v1', new_sqlite_classes: ['NotesDO'] },
+        ];
+    }
     return JSON.stringify(config, null, 2) + '\n';
 }
 function genConfig(opts) {
@@ -280,7 +307,7 @@ function genConfig(opts) {
     if (opts.ui) {
         lines.push(`import { kuratchiUiConfig } from '@kuratchi/ui/adapter';`);
     }
-    if (opts.orm) {
+    if (opts.orm || opts.do) {
         lines.push(`import { kuratchiOrmConfig } from '@kuratchi/orm/adapter';`);
     }
     if (opts.auth) {
@@ -289,6 +316,9 @@ function genConfig(opts) {
     if (opts.orm) {
         lines.push(`import { appSchema } from './src/schemas/app';`);
     }
+    if (opts.do) {
+        lines.push(`import { notesSchema } from './src/schemas/notes';`);
+    }
     lines.push('');
     lines.push('export default defineConfig({');
     // UI
@@ -297,14 +327,23 @@ function genConfig(opts) {
         lines.push("    theme: 'default',");
         lines.push('  }),');
     }
-    // ORM
-    if (opts.orm) {
+    // ORM (D1 + DO databases combined into a single kuratchiOrmConfig call)
+    if (opts.orm || opts.do) {
         lines.push('  orm: kuratchiOrmConfig({');
         lines.push('    databases: {');
-        lines.push('      DB: { schema: appSchema },');
+        if (opts.orm)
+            lines.push("      DB: { schema: appSchema },");
+        if (opts.do)
+            lines.push("      NOTES_DO: { schema: notesSchema, type: 'do' },");
         lines.push('    }');
         lines.push('  }),');
     }
+    // Durable Objects
+    if (opts.do) {
+        lines.push('  durableObjects: {');
+        lines.push("    NOTES_DO: { className: 'NotesDO' },");
+        lines.push('  },');
+    }
     // Auth
     if (opts.auth) {
         lines.push('  auth: kuratchiAuthConfig({');
@@ -341,13 +380,112 @@ worker-configuration.d.ts
 dist/
 `;
 }
-function genWorkerEntry(opts) {
-    return `export { default } from "../.kuratchi/routes.js";\n`;
+// ── Durable Object templates ──────────────────────────────────────────────────
+function genNotesSchema() {
+    return `import type { SchemaDsl } from '@kuratchi/orm';
+
+export const notesSchema: SchemaDsl = {
+  name: 'notes',
+  version: 1,
+  tables: {
+    notes: {
+      id: 'integer primary key',
+      title: 'text not null',
+      created_at: 'text not null default now',
+    },
+  },
+};
+
+export interface Note {
+  id: number;
+  title: string;
+  created_at: string;
+}
+`;
+}
+function genNotesDoHandler() {
+    return `import { kuratchiDO } from '${FRAMEWORK_PACKAGE_NAME}';
+import type { Note } from '../schemas/notes';
+
+export default class NotesDO extends kuratchiDO {
+  static binding = 'NOTES_DO';
+
+  async getNotes(): Promise<Note[]> {
+    return (await this.db.notes.orderBy({ created_at: 'desc' }).many()).data ?? [];
+  }
+
+  async addNote(title: string): Promise<void> {
+    await this.db.notes.insert({ title });
+  }
+
+  async deleteNote(id: number): Promise<void> {
+    await this.db.notes.delete({ id });
+  }
+}
+`;
+}
+function genNotesDb() {
+    return `import { env } from 'cloudflare:workers';
+import type { Note } from '../schemas/notes';
+
+function getStub() {
+  return (env as any).NOTES_DO.get((env as any).NOTES_DO.idFromName('global'));
+}
+
+export async function getNotes(): Promise<Note[]> {
+  return getStub().getNotes();
+}
+
+export async function addNote(formData: FormData): Promise<void> {
+  const title = String(formData.get('title') || '').trim();
+  if (!title) throw new Error('Note is required');
+  await getStub().addNote(title);
+}
+
+export async function deleteNote(id: number): Promise<void> {
+  await getStub().deleteNote(Number(id));
+}
+`;
+}
+function genNotesPage() {
+    return `<script>
+  import { getNotes, addNote, deleteNote } from '$database/notes';
+
+  const notes = await getNotes();
+</script>
+
+<header>
+  <div>
+    <h1>Notes</h1>
+    <p>Backed by a Cloudflare Durable Object with SQLite storage</p>
+  </div>
+</header>
+
+<form action={addNote} method="POST">
+  <input type="text" name="title" placeholder="New note..." required />
+  <button type="submit">Add</button>
+</form>
+
+if (notes.length === 0) {
+  <p style="opacity: 0.6">No notes yet.</p>
+} else {
+  <section>
+    for (const note of notes) {
+      <article>
+        <span>{note.title}</span>
+        <button data-action="deleteNote" data-args={JSON.stringify([note.id])}>Remove</button>
+      </article>
+    }
+  </section>
+}
+`;
 }
 function genLayout(opts) {
     const navLinks = ['      <a href="/">Home</a>'];
     if (opts.orm)
         navLinks.push('      <a href="/items">Items</a>');
+    if (opts.do)
+        navLinks.push('      <a href="/notes">Notes (DO)</a>');
     if (opts.auth)
         navLinks.push('      <a href="/admin">Admin</a>');
     return `<!DOCTYPE html>

package/dist/index.d.ts

@@ -1,13 +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 { getEnv, getCtx, getRequest, getLocals, getParams, getParam, redirect, goto, setBreadcrumbs, getBreadcrumbs, breadcrumbsHome, breadcrumbsPrev, breadcrumbsNext, breadcrumbsCurrent, buildDefaultBreadcrumbs, } from './runtime/context.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,12 +1,13 @@
 /**
- * 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 { getEnv, getCtx, getRequest, getLocals, getParams, getParam, redirect, goto, setBreadcrumbs, getBreadcrumbs, breadcrumbsHome, breadcrumbsPrev, breadcrumbsNext, breadcrumbsCurrent, buildDefaultBreadcrumbs, } from './runtime/context.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

package/dist/runtime/context.d.ts

@@ -14,13 +14,6 @@ export interface BreadcrumbItem {
 }
 /** Called by the framework at the start of each request */
 export declare function __setRequestContext(ctx: any, request: Request): void;
-/**
- * @deprecated Use `import { env } from 'cloudflare:workers'` instead.
- * Kept for backward compatibility — delegates to the native env import.
- */
-export declare function getEnv<T = any>(): T;
-/** @internal — called by compiler to stash env ref for getEnv() compat */
-export declare function __setEnvCompat(env: any): void;
 /** Get the execution context (waitUntil, passThroughOnException) */
 export declare function getCtx(): ExecutionContext;
 /** Get the current request */

package/dist/runtime/context.js

@@ -22,17 +22,6 @@ export function __setRequestContext(ctx, request) {
         get locals() { return __locals; },
     };
 }
-/**
- * @deprecated Use `import { env } from 'cloudflare:workers'` instead.
- * Kept for backward compatibility — delegates to the native env import.
- */
-export function getEnv() {
-    return globalThis.__cloudflare_env__;
-}
-/** @internal — called by compiler to stash env ref for getEnv() compat */
-export function __setEnvCompat(env) {
-    globalThis.__cloudflare_env__ = env;
-}
 /** Get the execution context (waitUntil, passThroughOnException) */
 export function getCtx() {
     if (!__ctx)

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 { getEnv, getCtx, getRequest, getLocals, getParams, getParam, redirect, goto, setBreadcrumbs, getBreadcrumbs, breadcrumbsHome, breadcrumbsPrev, breadcrumbsNext, breadcrumbsCurrent, buildDefaultBreadcrumbs, } from './context.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,7 +1,8 @@
 export { createApp } from './app.js';
 export { defineConfig } from './config.js';
+export { defineRuntime } from './runtime.js';
 export { Router, filePathToPattern } from './router.js';
-export { getEnv, getCtx, getRequest, getLocals, getParams, getParam, redirect, goto, setBreadcrumbs, getBreadcrumbs, breadcrumbsHome, breadcrumbsPrev, breadcrumbsNext, breadcrumbsCurrent, buildDefaultBreadcrumbs, } from './context.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, 
 // Compatibility aliases

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.1",
+    "version":  "0.0.3",
     "description":  "A thin, Cloudflare Workers-native web framework with Svelte-inspired syntax",
     "type":  "module",
     "main":  "./dist/index.js",
@@ -43,8 +43,4 @@
                             "@types/node":  "^24.4.0",
                             "typescript":  "^5.8.0"
                         }
-}
-
-
-
-
+}