@korajs/cli 0.5.0 → 1.0.0-beta.0

package/dist/index.d.cts

@@ -5,7 +5,7 @@ import * as citty from 'citty';
 declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
 type PackageManager = (typeof PACKAGE_MANAGERS)[number];
 /** Available project templates */
-declare const TEMPLATES: readonly ["react-tailwind-sync", "react-tailwind", "react-sync", "react-basic", "tauri-react"];
+declare const TEMPLATES: readonly ["react-tailwind-sync", "react-tailwind", "react-sync", "react-basic", "vue-sync", "vue-basic", "vue-tailwind-sync", "vue-tailwind", "svelte-sync", "svelte-basic", "svelte-tailwind-sync", "svelte-tailwind", "tauri-react"];
 type TemplateName = (typeof TEMPLATES)[number];
 /** Metadata for a project template */
 interface TemplateInfo {
@@ -556,13 +556,13 @@ type DatabaseOption = 'none' | 'sqlite' | 'postgres';
 type DatabaseProviderOption = 'none' | 'local' | 'supabase' | 'neon' | 'railway' | 'vercel-postgres' | 'custom';
 interface TemplateSelectionInput {
     platform: PlatformOption;
+    framework: FrameworkOption;
     tailwind: boolean;
     sync: boolean;
     db: DatabaseOption;
 }
 /**
- * Converts high-level scaffold selections into the currently supported
- * concrete template names.
+ * Converts high-level scaffold selections into a concrete template name.
  */
 declare function determineTemplateFromSelections(input: TemplateSelectionInput): TemplateName;
 declare function isFrameworkValue(value: string): value is FrameworkOption;

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import * as citty from 'citty';
 declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
 type PackageManager = (typeof PACKAGE_MANAGERS)[number];
 /** Available project templates */
-declare const TEMPLATES: readonly ["react-tailwind-sync", "react-tailwind", "react-sync", "react-basic", "tauri-react"];
+declare const TEMPLATES: readonly ["react-tailwind-sync", "react-tailwind", "react-sync", "react-basic", "vue-sync", "vue-basic", "vue-tailwind-sync", "vue-tailwind", "svelte-sync", "svelte-basic", "svelte-tailwind-sync", "svelte-tailwind", "tauri-react"];
 type TemplateName = (typeof TEMPLATES)[number];
 /** Metadata for a project template */
 interface TemplateInfo {
@@ -556,13 +556,13 @@ type DatabaseOption = 'none' | 'sqlite' | 'postgres';
 type DatabaseProviderOption = 'none' | 'local' | 'supabase' | 'neon' | 'railway' | 'vercel-postgres' | 'custom';
 interface TemplateSelectionInput {
     platform: PlatformOption;
+    framework: FrameworkOption;
     tailwind: boolean;
     sync: boolean;
     db: DatabaseOption;
 }
 /**
- * Converts high-level scaffold selections into the currently supported
- * concrete template names.
+ * Converts high-level scaffold selections into a concrete template name.
  */
 declare function determineTemplateFromSelections(input: TemplateSelectionInput): TemplateName;
 declare function isFrameworkValue(value: string): value is FrameworkOption;

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   writeDockerfileArtifact,
   writeFlyTomlArtifact,
   writeRailwayJsonArtifact
-} from "./chunk-SOTZIWIF.js";
+} from "./chunk-EOWLAAIV.js";
 import {
   ClackPromptClient,
   CliError,
@@ -54,7 +54,8 @@ import {
   saveResolvedPreferences,
   shouldSavePreferences,
   validateProjectName
-} from "./chunk-3WNFM3QB.js";
+} from "./chunk-B5YS4STN.js";
+import "./chunk-5NI2FEQL.js";
 export {
   ClackPromptClient,
   CliError,

package/dist/lab-manager-KUDII6BT.js

@@ -0,0 +1,280 @@
+#!/usr/bin/env node
+
+// src/commands/studio/lab-manager.ts
+import { mkdtempSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+import { op as atomicOp, defineSchema, t } from "@korajs/core";
+function defaultLabSchema() {
+  return defineSchema({
+    version: 1,
+    collections: {
+      tasks: {
+        fields: {
+          title: t.string(),
+          assignee: t.string().optional(),
+          priority: t.enum(["low", "medium", "high"]).default("medium"),
+          done: t.boolean().default(false),
+          tags: t.array(t.string()).default([]),
+          points: t.number().default(0)
+        }
+      }
+    }
+  });
+}
+var DEFAULT_CHAOS = {
+  dropRate: 0,
+  duplicateRate: 0,
+  reorderRate: 0,
+  maxLatency: 0
+};
+var FORWARDED_EVENTS = [
+  "operation:created",
+  "operation:applied",
+  "merge:started",
+  "merge:conflict",
+  "merge:completed",
+  "sync:connected",
+  "sync:disconnected",
+  "sync:sent",
+  "sync:received",
+  "sync:apply-failed"
+];
+var MAX_EVENT_BUFFER = 500;
+var LabManager = class {
+  constructor(schema) {
+    this.schema = schema;
+  }
+  schema;
+  devices = /* @__PURE__ */ new Map();
+  server = null;
+  harness = null;
+  tmpDir = null;
+  eventSeq = 0;
+  eventBuffer = [];
+  eventListeners = /* @__PURE__ */ new Set();
+  deviceCounter = 0;
+  /** Load the harness lazily so file-mode Studio never needs @korajs/test. */
+  async loadHarness() {
+    if (this.harness) {
+      return this.harness;
+    }
+    try {
+      const testPkg = await import("@korajs/test");
+      const serverInternal = await import("@korajs/server/internal");
+      this.harness = {
+        TestServer: testPkg.TestServer,
+        TestDevice: testPkg.TestDevice,
+        checkConvergence: testPkg.checkConvergence,
+        ChaosTransport: testPkg.ChaosTransport,
+        createServerTransportPair: serverInternal.createServerTransportPair
+      };
+      return this.harness;
+    } catch (error) {
+      throw new Error(
+        `Kora Studio Lab needs "@korajs/test" and "@korajs/server" installed (pnpm add -D @korajs/test @korajs/server). Underlying error: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  async start(initialDevices = 2) {
+    const harness = await this.loadHarness();
+    this.tmpDir = mkdtempSync(join(tmpdir(), "kora-studio-lab-"));
+    this.server = new harness.TestServer(this.schema);
+    for (let i = 0; i < initialDevices; i++) {
+      await this.addDevice();
+    }
+  }
+  async addDevice(name) {
+    const harness = await this.loadHarness();
+    if (!this.server || !this.tmpDir) {
+      throw new Error("Lab is not started");
+    }
+    const deviceName = name?.trim() || `device-${String.fromCharCode(65 + this.deviceCounter)}`;
+    this.deviceCounter++;
+    if (this.devices.has(deviceName)) {
+      throw new Error(`Device "${deviceName}" already exists`);
+    }
+    const chaos = { ...DEFAULT_CHAOS };
+    const entry = { chaos };
+    const device = new harness.TestDevice({
+      name: deviceName,
+      schema: this.schema,
+      server: this.server,
+      // Read the CURRENT chaos settings each time a connection is made, so
+      // toggling chaos + reconnecting applies it without rebuilding the device.
+      createTransportPair: () => {
+        const pair = harness.createServerTransportPair();
+        const hasChaos = entry.chaos.dropRate > 0 || entry.chaos.duplicateRate > 0 || entry.chaos.reorderRate > 0 || entry.chaos.maxLatency > 0;
+        return {
+          client: hasChaos ? new harness.ChaosTransport(pair.client, { ...entry.chaos }) : pair.client,
+          serverTransport: pair.server
+        };
+      },
+      tmpDir: this.tmpDir
+    });
+    await device.open();
+    const unsubscribes = FORWARDED_EVENTS.map(
+      (type) => device.emitter.on(type, (event) => this.pushEvent(deviceName, type, event))
+    );
+    this.devices.set(deviceName, { device, chaos, unsubscribes });
+    this.pushEvent(deviceName, "lab:device-added", {});
+    return this.deviceState(deviceName);
+  }
+  listDevices() {
+    return [...this.devices.keys()].map((name) => this.deviceState(name));
+  }
+  deviceState(name) {
+    const entry = this.mustGet(name);
+    return {
+      name,
+      nodeId: entry.device.getNodeId(),
+      connected: entry.device.isConnected(),
+      chaos: { ...entry.chaos },
+      dbPath: join(this.tmpDir ?? "", `test-device-${name}.db`),
+      pendingOperations: entry.device.getSyncEngine()?.getStatus().pendingOperations ?? 0
+    };
+  }
+  async connect(name) {
+    await this.mustGet(name).device.sync();
+    this.pushEvent(name, "lab:connected", {});
+  }
+  async disconnect(name) {
+    await this.mustGet(name).device.disconnect();
+    this.pushEvent(name, "lab:disconnected", {});
+  }
+  async sync(name) {
+    await this.mustGet(name).device.sync();
+  }
+  setChaos(name, chaos) {
+    const entry = this.mustGet(name);
+    entry.chaos.dropRate = clamp01(chaos.dropRate ?? entry.chaos.dropRate);
+    entry.chaos.duplicateRate = clamp01(chaos.duplicateRate ?? entry.chaos.duplicateRate);
+    entry.chaos.reorderRate = clamp01(chaos.reorderRate ?? entry.chaos.reorderRate);
+    entry.chaos.maxLatency = Math.max(0, chaos.maxLatency ?? entry.chaos.maxLatency);
+    this.pushEvent(name, "lab:chaos-changed", { ...entry.chaos });
+    return { ...entry.chaos };
+  }
+  async insert(name, collection, data) {
+    return this.mustGet(name).device.collection(collection).insert(data);
+  }
+  async update(name, collection, recordId, data, increments) {
+    const payload = { ...data };
+    for (const [field, delta] of Object.entries(increments ?? {})) {
+      payload[field] = atomicOp.increment(delta);
+    }
+    return this.mustGet(name).device.collection(collection).update(recordId, payload);
+  }
+  async delete(name, collection, recordId) {
+    await this.mustGet(name).device.collection(collection).delete(recordId);
+  }
+  async convergence() {
+    const harness = await this.loadHarness();
+    const devices = [...this.devices.values()].map((e) => e.device);
+    if (devices.length < 2) {
+      return { converged: true, deviceCount: devices.length, differences: [] };
+    }
+    const result = await harness.checkConvergence(devices, this.schema);
+    return {
+      converged: result.converged,
+      deviceCount: devices.length,
+      differences: result.differences.map(
+        (d) => d.description ?? `collection "${d.collection}" differs`
+      )
+    };
+  }
+  serverOperationCount() {
+    return this.server?.getAllOperations().length ?? 0;
+  }
+  getSchema() {
+    return this.schema;
+  }
+  /** Recent events (for initial page load), oldest first. */
+  recentEvents() {
+    return [...this.eventBuffer];
+  }
+  onEvent(listener) {
+    this.eventListeners.add(listener);
+    return () => this.eventListeners.delete(listener);
+  }
+  async close() {
+    for (const [, entry] of this.devices) {
+      for (const unsub of entry.unsubscribes) {
+        unsub();
+      }
+      await entry.device.close().catch(() => {
+      });
+    }
+    this.devices.clear();
+    await this.server?.close().catch(() => {
+    });
+    this.server = null;
+    if (this.tmpDir) {
+      rmSync(this.tmpDir, { recursive: true, force: true });
+      this.tmpDir = null;
+    }
+  }
+  mustGet(name) {
+    const entry = this.devices.get(name);
+    if (!entry) {
+      throw new Error(`Unknown device "${name}"`);
+    }
+    return entry;
+  }
+  pushEvent(device, type, payload) {
+    const event = {
+      seq: ++this.eventSeq,
+      at: Date.now(),
+      device,
+      type,
+      summary: summarizeEvent(type, payload)
+    };
+    this.eventBuffer.push(event);
+    if (this.eventBuffer.length > MAX_EVENT_BUFFER) {
+      this.eventBuffer.shift();
+    }
+    for (const listener of this.eventListeners) {
+      listener(event);
+    }
+  }
+};
+function clamp01(n) {
+  return Math.min(1, Math.max(0, n));
+}
+function summarizeEvent(type, payload) {
+  const op = payload.operation;
+  switch (type) {
+    case "operation:created":
+      return op ? `${op.type} ${op.collection}/${String(op.recordId).slice(0, 8)}\u2026 ${op.data ? JSON.stringify(op.data).slice(0, 60) : ""}` : "operation created";
+    case "operation:applied":
+      return op ? `applied ${op.type} ${op.collection}/${String(op.recordId).slice(0, 8)}\u2026` : "applied";
+    case "merge:conflict":
+      return "merge conflict resolved";
+    case "merge:started":
+      return "merge started";
+    case "merge:completed":
+      return "merge completed";
+    case "sync:sent": {
+      const count = Array.isArray(payload.operations) ? payload.operations.length : 0;
+      return `sent ${count} op(s)`;
+    }
+    case "sync:received": {
+      const count = Array.isArray(payload.operations) ? payload.operations.length : 0;
+      return `received ${count} op(s)`;
+    }
+    case "sync:connected":
+      return "connected to server";
+    case "sync:disconnected":
+      return "disconnected";
+    case "sync:apply-failed":
+      return "APPLY FAILED";
+    case "lab:chaos-changed":
+      return `chaos \u2192 drop ${payload.dropRate} dup ${payload.duplicateRate} reorder ${payload.reorderRate} latency ${payload.maxLatency}ms`;
+    default:
+      return type.replace("lab:", "");
+  }
+}
+export {
+  LabManager,
+  defaultLabSchema
+};
+//# sourceMappingURL=lab-manager-KUDII6BT.js.map

package/dist/lab-manager-KUDII6BT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/studio/lab-manager.ts"],"sourcesContent":["import { mkdtempSync, rmSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\nimport type { Operation, SchemaDefinition } from '@korajs/core'\nimport { op as atomicOp, defineSchema, t } from '@korajs/core'\n\n/**\n * Default Lab schema: covers every merge tier so the Lab can demonstrate the\n * whole system — scalar LWW (title/assignee/priority/done), add-wins arrays\n * (tags), and atomic increment composition (points).\n */\nexport function defaultLabSchema(): SchemaDefinition {\n\treturn defineSchema({\n\t\tversion: 1,\n\t\tcollections: {\n\t\t\ttasks: {\n\t\t\t\tfields: {\n\t\t\t\t\ttitle: t.string(),\n\t\t\t\t\tassignee: t.string().optional(),\n\t\t\t\t\tpriority: t.enum(['low', 'medium', 'high']).default('medium'),\n\t\t\t\t\tdone: t.boolean().default(false),\n\t\t\t\t\ttags: t.array(t.string()).default([]),\n\t\t\t\t\tpoints: t.number().default(0),\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t})\n}\n\n/**\n * Kora Studio Lab: an interactive, in-process multi-device sync laboratory.\n *\n * Every device is a REAL Kora client (its own SQLite store, sync engine, merge\n * pipeline) talking to a REAL sync server over in-memory transports, optionally\n * wrapped in a chaos transport. Nothing is simulated at the data layer, so what\n * the Lab shows is evidence, not illustration: conflicts, convergence, chaos\n * recovery, and atomic-op composition all run the exact code that ships.\n *\n * The Lab only ever touches throwaway databases in a temp directory — it can\n * never write to a user's real data.\n */\n\n/** Per-device chaos settings; applied on the device's NEXT connect. */\nexport interface LabChaosConfig {\n\tdropRate: number\n\tduplicateRate: number\n\treorderRate: number\n\tmaxLatency: number\n}\n\nexport interface LabDeviceState {\n\tname: string\n\tnodeId: string\n\tconnected: boolean\n\tchaos: LabChaosConfig\n\t/** Path of this device's SQLite DB — Studio's readers attach here. */\n\tdbPath: string\n\tpendingOperations: number\n}\n\nexport interface LabEvent {\n\tseq: number\n\tat: number\n\tdevice: string\n\ttype: string\n\tsummary: string\n}\n\nexport interface LabConvergenceReport {\n\tconverged: boolean\n\tdeviceCount: number\n\tdifferences: string[]\n}\n\n/** Structural interfaces for the lazily-imported @korajs/test harness. */\ninterface HarnessDevice {\n\treadonly name: string\n\treadonly emitter: {\n\t\ton(type: string, listener: (event: Record<string, unknown>) => void): () => void\n\t}\n\topen(): Promise<void>\n\tsync(): Promise<void>\n\tdisconnect(): Promise<void>\n\tclose(): Promise<void>\n\tcollection(name: string): {\n\t\tinsert(data: Record<string, unknown>): Promise<Record<string, unknown>>\n\t\tupdate(id: string, data: Record<string, unknown>): Promise<Record<string, unknown>>\n\t\tdelete(id: string): Promise<void>\n\t}\n\tgetNodeId(): string\n\tgetSyncEngine(): { getStatus(): { pendingOperations: number } } | null\n\tisConnected(): boolean\n}\n\ninterface Harness {\n\tTestServer: new (\n\t\tschema: SchemaDefinition,\n\t) => {\n\t\thandleConnection(transport: unknown): string\n\t\tgetAllOperations(): Operation[]\n\t\tgetConnectionCount(): number\n\t\tclose(): Promise<void>\n\t}\n\tTestDevice: new (options: {\n\t\tname: string\n\t\tschema: SchemaDefinition\n\t\tserver: unknown\n\t\tcreateTransportPair: () => { client: unknown; serverTransport: unknown }\n\t\ttmpDir: string\n\t}) => HarnessDevice\n\tcheckConvergence(\n\t\tdevices: unknown[],\n\t\tschema: SchemaDefinition,\n\t): Promise<{\n\t\tconverged: boolean\n\t\tdifferences: Array<{ collection: string; description?: string }>\n\t}>\n\tChaosTransport: new (inner: unknown, config: Record<string, unknown>) => unknown\n\t/** Returns { client, server } — note the property name is `server`. */\n\tcreateServerTransportPair: () => { client: unknown; server: unknown }\n}\n\nconst DEFAULT_CHAOS: LabChaosConfig = {\n\tdropRate: 0,\n\tduplicateRate: 0,\n\treorderRate: 0,\n\tmaxLatency: 0,\n}\n\n/** Event types forwarded into the Lab's live feed. */\nconst FORWARDED_EVENTS = [\n\t'operation:created',\n\t'operation:applied',\n\t'merge:started',\n\t'merge:conflict',\n\t'merge:completed',\n\t'sync:connected',\n\t'sync:disconnected',\n\t'sync:sent',\n\t'sync:received',\n\t'sync:apply-failed',\n] as const\n\nconst MAX_EVENT_BUFFER = 500\n\nexport class LabManager {\n\tprivate readonly devices = new Map<\n\t\tstring,\n\t\t{ device: HarnessDevice; chaos: LabChaosConfig; unsubscribes: Array<() => void> }\n\t>()\n\tprivate server: InstanceType<Harness['TestServer']> | null = null\n\tprivate harness: Harness | null = null\n\tprivate tmpDir: string | null = null\n\tprivate eventSeq = 0\n\tprivate readonly eventBuffer: LabEvent[] = []\n\tprivate readonly eventListeners = new Set<(event: LabEvent) => void>()\n\tprivate deviceCounter = 0\n\n\tconstructor(private readonly schema: SchemaDefinition) {}\n\n\t/** Load the harness lazily so file-mode Studio never needs @korajs/test. */\n\tprivate async loadHarness(): Promise<Harness> {\n\t\tif (this.harness) {\n\t\t\treturn this.harness\n\t\t}\n\t\ttry {\n\t\t\tconst testPkg = (await import('@korajs/test')) as unknown as Record<string, unknown>\n\t\t\tconst serverInternal = (await import('@korajs/server/internal')) as unknown as Record<\n\t\t\t\tstring,\n\t\t\t\tunknown\n\t\t\t>\n\t\t\tthis.harness = {\n\t\t\t\tTestServer: testPkg.TestServer as Harness['TestServer'],\n\t\t\t\tTestDevice: testPkg.TestDevice as Harness['TestDevice'],\n\t\t\t\tcheckConvergence: testPkg.checkConvergence as Harness['checkConvergence'],\n\t\t\t\tChaosTransport: testPkg.ChaosTransport as Harness['ChaosTransport'],\n\t\t\t\tcreateServerTransportPair:\n\t\t\t\t\tserverInternal.createServerTransportPair as Harness['createServerTransportPair'],\n\t\t\t}\n\t\t\treturn this.harness\n\t\t} catch (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`Kora Studio Lab needs \"@korajs/test\" and \"@korajs/server\" installed (pnpm add -D @korajs/test @korajs/server). Underlying error: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t}`,\n\t\t\t)\n\t\t}\n\t}\n\n\tasync start(initialDevices = 2): Promise<void> {\n\t\tconst harness = await this.loadHarness()\n\t\tthis.tmpDir = mkdtempSync(join(tmpdir(), 'kora-studio-lab-'))\n\t\tthis.server = new harness.TestServer(this.schema)\n\t\tfor (let i = 0; i < initialDevices; i++) {\n\t\t\tawait this.addDevice()\n\t\t}\n\t}\n\n\tasync addDevice(name?: string): Promise<LabDeviceState> {\n\t\tconst harness = await this.loadHarness()\n\t\tif (!this.server || !this.tmpDir) {\n\t\t\tthrow new Error('Lab is not started')\n\t\t}\n\t\tconst deviceName = name?.trim() || `device-${String.fromCharCode(65 + this.deviceCounter)}`\n\t\tthis.deviceCounter++\n\t\tif (this.devices.has(deviceName)) {\n\t\t\tthrow new Error(`Device \"${deviceName}\" already exists`)\n\t\t}\n\n\t\tconst chaos: LabChaosConfig = { ...DEFAULT_CHAOS }\n\t\tconst entry = { chaos }\n\t\tconst device = new harness.TestDevice({\n\t\t\tname: deviceName,\n\t\t\tschema: this.schema,\n\t\t\tserver: this.server,\n\t\t\t// Read the CURRENT chaos settings each time a connection is made, so\n\t\t\t// toggling chaos + reconnecting applies it without rebuilding the device.\n\t\t\tcreateTransportPair: () => {\n\t\t\t\tconst pair = harness.createServerTransportPair()\n\t\t\t\tconst hasChaos =\n\t\t\t\t\tentry.chaos.dropRate > 0 ||\n\t\t\t\t\tentry.chaos.duplicateRate > 0 ||\n\t\t\t\t\tentry.chaos.reorderRate > 0 ||\n\t\t\t\t\tentry.chaos.maxLatency > 0\n\t\t\t\treturn {\n\t\t\t\t\tclient: hasChaos\n\t\t\t\t\t\t? new harness.ChaosTransport(pair.client, { ...entry.chaos })\n\t\t\t\t\t\t: pair.client,\n\t\t\t\t\tserverTransport: pair.server,\n\t\t\t\t}\n\t\t\t},\n\t\t\ttmpDir: this.tmpDir,\n\t\t})\n\t\tawait device.open()\n\n\t\tconst unsubscribes = FORWARDED_EVENTS.map((type) =>\n\t\t\tdevice.emitter.on(type, (event) => this.pushEvent(deviceName, type, event)),\n\t\t)\n\n\t\tthis.devices.set(deviceName, { device, chaos, unsubscribes })\n\t\tthis.pushEvent(deviceName, 'lab:device-added', {})\n\t\treturn this.deviceState(deviceName)\n\t}\n\n\tlistDevices(): LabDeviceState[] {\n\t\treturn [...this.devices.keys()].map((name) => this.deviceState(name))\n\t}\n\n\tdeviceState(name: string): LabDeviceState {\n\t\tconst entry = this.mustGet(name)\n\t\treturn {\n\t\t\tname,\n\t\t\tnodeId: entry.device.getNodeId(),\n\t\t\tconnected: entry.device.isConnected(),\n\t\t\tchaos: { ...entry.chaos },\n\t\t\tdbPath: join(this.tmpDir ?? '', `test-device-${name}.db`),\n\t\t\tpendingOperations: entry.device.getSyncEngine()?.getStatus().pendingOperations ?? 0,\n\t\t}\n\t}\n\n\tasync connect(name: string): Promise<void> {\n\t\tawait this.mustGet(name).device.sync()\n\t\tthis.pushEvent(name, 'lab:connected', {})\n\t}\n\n\tasync disconnect(name: string): Promise<void> {\n\t\tawait this.mustGet(name).device.disconnect()\n\t\tthis.pushEvent(name, 'lab:disconnected', {})\n\t}\n\n\tasync sync(name: string): Promise<void> {\n\t\tawait this.mustGet(name).device.sync()\n\t}\n\n\tsetChaos(name: string, chaos: Partial<LabChaosConfig>): LabChaosConfig {\n\t\tconst entry = this.mustGet(name)\n\t\tentry.chaos.dropRate = clamp01(chaos.dropRate ?? entry.chaos.dropRate)\n\t\tentry.chaos.duplicateRate = clamp01(chaos.duplicateRate ?? entry.chaos.duplicateRate)\n\t\tentry.chaos.reorderRate = clamp01(chaos.reorderRate ?? entry.chaos.reorderRate)\n\t\tentry.chaos.maxLatency = Math.max(0, chaos.maxLatency ?? entry.chaos.maxLatency)\n\t\tthis.pushEvent(name, 'lab:chaos-changed', { ...entry.chaos })\n\t\treturn { ...entry.chaos }\n\t}\n\n\tasync insert(\n\t\tname: string,\n\t\tcollection: string,\n\t\tdata: Record<string, unknown>,\n\t): Promise<Record<string, unknown>> {\n\t\treturn this.mustGet(name).device.collection(collection).insert(data)\n\t}\n\n\tasync update(\n\t\tname: string,\n\t\tcollection: string,\n\t\trecordId: string,\n\t\tdata: Record<string, unknown>,\n\t\tincrements?: Record<string, number>,\n\t): Promise<Record<string, unknown>> {\n\t\t// Intent-preserving atomic increments: concurrent increments on two\n\t\t// devices COMPOSE to the sum instead of last-write-wins — the Lab's most\n\t\t// striking demonstration.\n\t\tconst payload: Record<string, unknown> = { ...data }\n\t\tfor (const [field, delta] of Object.entries(increments ?? {})) {\n\t\t\tpayload[field] = atomicOp.increment(delta)\n\t\t}\n\t\treturn this.mustGet(name).device.collection(collection).update(recordId, payload)\n\t}\n\n\tasync delete(name: string, collection: string, recordId: string): Promise<void> {\n\t\tawait this.mustGet(name).device.collection(collection).delete(recordId)\n\t}\n\n\tasync convergence(): Promise<LabConvergenceReport> {\n\t\tconst harness = await this.loadHarness()\n\t\tconst devices = [...this.devices.values()].map((e) => e.device)\n\t\tif (devices.length < 2) {\n\t\t\treturn { converged: true, deviceCount: devices.length, differences: [] }\n\t\t}\n\t\tconst result = await harness.checkConvergence(devices, this.schema)\n\t\treturn {\n\t\t\tconverged: result.converged,\n\t\t\tdeviceCount: devices.length,\n\t\t\tdifferences: result.differences.map(\n\t\t\t\t(d) => d.description ?? `collection \"${d.collection}\" differs`,\n\t\t\t),\n\t\t}\n\t}\n\n\tserverOperationCount(): number {\n\t\treturn this.server?.getAllOperations().length ?? 0\n\t}\n\n\tgetSchema(): SchemaDefinition {\n\t\treturn this.schema\n\t}\n\n\t/** Recent events (for initial page load), oldest first. */\n\trecentEvents(): LabEvent[] {\n\t\treturn [...this.eventBuffer]\n\t}\n\n\tonEvent(listener: (event: LabEvent) => void): () => void {\n\t\tthis.eventListeners.add(listener)\n\t\treturn () => this.eventListeners.delete(listener)\n\t}\n\n\tasync close(): Promise<void> {\n\t\tfor (const [, entry] of this.devices) {\n\t\t\tfor (const unsub of entry.unsubscribes) {\n\t\t\t\tunsub()\n\t\t\t}\n\t\t\tawait entry.device.close().catch(() => {})\n\t\t}\n\t\tthis.devices.clear()\n\t\tawait this.server?.close().catch(() => {})\n\t\tthis.server = null\n\t\tif (this.tmpDir) {\n\t\t\trmSync(this.tmpDir, { recursive: true, force: true })\n\t\t\tthis.tmpDir = null\n\t\t}\n\t}\n\n\tprivate mustGet(name: string): { device: HarnessDevice; chaos: LabChaosConfig } {\n\t\tconst entry = this.devices.get(name)\n\t\tif (!entry) {\n\t\t\tthrow new Error(`Unknown device \"${name}\"`)\n\t\t}\n\t\treturn entry\n\t}\n\n\tprivate pushEvent(device: string, type: string, payload: Record<string, unknown>): void {\n\t\tconst event: LabEvent = {\n\t\t\tseq: ++this.eventSeq,\n\t\t\tat: Date.now(),\n\t\t\tdevice,\n\t\t\ttype,\n\t\t\tsummary: summarizeEvent(type, payload),\n\t\t}\n\t\tthis.eventBuffer.push(event)\n\t\tif (this.eventBuffer.length > MAX_EVENT_BUFFER) {\n\t\t\tthis.eventBuffer.shift()\n\t\t}\n\t\tfor (const listener of this.eventListeners) {\n\t\t\tlistener(event)\n\t\t}\n\t}\n}\n\nfunction clamp01(n: number): number {\n\treturn Math.min(1, Math.max(0, n))\n}\n\nfunction summarizeEvent(type: string, payload: Record<string, unknown>): string {\n\tconst op = payload.operation as\n\t\t| { type?: string; collection?: string; recordId?: string; data?: Record<string, unknown> }\n\t\t| undefined\n\tswitch (type) {\n\t\tcase 'operation:created':\n\t\t\treturn op\n\t\t\t\t? `${op.type} ${op.collection}/${String(op.recordId).slice(0, 8)}… ${op.data ? JSON.stringify(op.data).slice(0, 60) : ''}`\n\t\t\t\t: 'operation created'\n\t\tcase 'operation:applied':\n\t\t\treturn op\n\t\t\t\t? `applied ${op.type} ${op.collection}/${String(op.recordId).slice(0, 8)}…`\n\t\t\t\t: 'applied'\n\t\tcase 'merge:conflict':\n\t\t\treturn 'merge conflict resolved'\n\t\tcase 'merge:started':\n\t\t\treturn 'merge started'\n\t\tcase 'merge:completed':\n\t\t\treturn 'merge completed'\n\t\tcase 'sync:sent': {\n\t\t\tconst count = Array.isArray(payload.operations) ? payload.operations.length : 0\n\t\t\treturn `sent ${count} op(s)`\n\t\t}\n\t\tcase 'sync:received': {\n\t\t\tconst count = Array.isArray(payload.operations) ? payload.operations.length : 0\n\t\t\treturn `received ${count} op(s)`\n\t\t}\n\t\tcase 'sync:connected':\n\t\t\treturn 'connected to server'\n\t\tcase 'sync:disconnected':\n\t\t\treturn 'disconnected'\n\t\tcase 'sync:apply-failed':\n\t\t\treturn 'APPLY FAILED'\n\t\tcase 'lab:chaos-changed':\n\t\t\treturn `chaos → drop ${payload.dropRate} dup ${payload.duplicateRate} reorder ${payload.reorderRate} latency ${payload.maxLatency}ms`\n\t\tdefault:\n\t\t\treturn type.replace('lab:', '')\n\t}\n}\n"],"mappings":"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","names":[]}

package/dist/schema-loader-GGHECMTM.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  loadSchemaDefinition
+} from "./chunk-6C4BHSRA.js";
+import "./chunk-5NI2FEQL.js";
+export {
+  loadSchemaDefinition
+};
+//# sourceMappingURL=schema-loader-GGHECMTM.js.map

package/dist/schema-loader-GGHECMTM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/spectator-manager-E2LH2P54.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+// src/commands/studio/spectator-manager.ts
+import { mkdtempSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+var FORWARDED_EVENTS = [
+  "merge:started",
+  "merge:conflict",
+  "merge:completed",
+  "sync:connected",
+  "sync:disconnected",
+  "sync:received",
+  "sync:apply-failed"
+];
+var MAX_EVENT_BUFFER = 500;
+var SpectatorManager = class {
+  constructor(options) {
+    this.options = options;
+    this.tmpDir = mkdtempSync(join(tmpdir(), "kora-studio-spectator-"));
+    this.dbPath = join(this.tmpDir, "spectator-replica.db");
+  }
+  options;
+  runtime = null;
+  tmpDir = null;
+  connected = false;
+  operationsReceived = 0;
+  lastEventAt = null;
+  eventSeq = 0;
+  eventBuffer = [];
+  eventListeners = /* @__PURE__ */ new Set();
+  dbPath;
+  async start() {
+    let mods;
+    try {
+      mods = {
+        Store: (await import("@korajs/store")).Store,
+        BetterSqlite3Adapter: (await import("@korajs/store/better-sqlite3")).BetterSqlite3Adapter,
+        MergeEngine: (await import("@korajs/merge")).MergeEngine,
+        SyncEngine: (await import("@korajs/sync")).SyncEngine,
+        WebSocketTransport: (await import("@korajs/sync")).WebSocketTransport,
+        testing: await import("korajs/testing"),
+        SimpleEventEmitter: (await import("@korajs/core/internal")).SimpleEventEmitter
+      };
+    } catch (error) {
+      throw new Error(
+        `Spectator mode needs the Kora runtime packages installed (pnpm add -D korajs @korajs/store @korajs/merge @korajs/sync better-sqlite3). Underlying error: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    const emitter = new mods.SimpleEventEmitter();
+    const adapter = new mods.BetterSqlite3Adapter(this.dbPath);
+    const store = new mods.Store({ schema: this.options.schema, adapter, emitter });
+    await store.open();
+    const mergeEngine = new mods.MergeEngine();
+    const pipeline = new mods.testing.ApplyPipeline({ store, mergeEngine, emitter });
+    store.setLocalMutationHandler(pipeline);
+    const unsubscribeAudit = mods.testing.wireAuditPersistence(store, emitter);
+    const syncStore = new mods.testing.MergeAwareSyncStore(store, mergeEngine, emitter);
+    const engine = new mods.SyncEngine({
+      transport: new mods.WebSocketTransport(),
+      store: syncStore,
+      queueStorage: new mods.testing.StoreQueueStorage(adapter),
+      syncState: new mods.testing.StoreSyncStatePersistence(store),
+      config: {
+        url: this.options.url,
+        schemaVersion: this.options.schemaVersion ?? this.options.schema.version,
+        ...this.options.token ? { auth: async () => ({ token: this.options.token }) } : {}
+      },
+      emitter
+    });
+    const unsubscribers = FORWARDED_EVENTS.map(
+      (type) => emitter.on(type, (event) => {
+        this.lastEventAt = Date.now();
+        if (type === "sync:connected") {
+          this.connected = true;
+        }
+        if (type === "sync:disconnected") {
+          this.connected = false;
+        }
+        if (type === "sync:received" && Array.isArray(event.operations)) {
+          this.operationsReceived += event.operations.length;
+        }
+        this.pushEvent(type, event);
+      })
+    );
+    unsubscribers.push(unsubscribeAudit);
+    this.runtime = { store, engine, unsubscribers };
+    await engine.start();
+  }
+  status() {
+    return {
+      url: this.options.url,
+      connected: this.connected,
+      operationsReceived: this.operationsReceived,
+      lastEventAt: this.lastEventAt,
+      dbPath: this.dbPath
+    };
+  }
+  recentEvents() {
+    return [...this.eventBuffer];
+  }
+  onEvent(listener) {
+    this.eventListeners.add(listener);
+    return () => this.eventListeners.delete(listener);
+  }
+  async close() {
+    if (this.runtime) {
+      for (const unsub of this.runtime.unsubscribers) {
+        unsub();
+      }
+      await this.runtime.engine.stop().catch(() => {
+      });
+      await this.runtime.store.close().catch(() => {
+      });
+      this.runtime = null;
+    }
+    if (this.tmpDir) {
+      rmSync(this.tmpDir, { recursive: true, force: true });
+      this.tmpDir = null;
+    }
+  }
+  pushEvent(type, payload) {
+    const summary = type === "sync:received" && Array.isArray(payload.operations) ? `received ${payload.operations.length} op(s)` : type.replace("sync:", "").replace("merge:", "merge ");
+    const event = {
+      seq: ++this.eventSeq,
+      at: Date.now(),
+      type,
+      summary
+    };
+    this.eventBuffer.push(event);
+    if (this.eventBuffer.length > MAX_EVENT_BUFFER) {
+      this.eventBuffer.shift();
+    }
+    for (const listener of this.eventListeners) {
+      listener(event);
+    }
+  }
+};
+export {
+  SpectatorManager
+};
+//# sourceMappingURL=spectator-manager-E2LH2P54.js.map

package/dist/spectator-manager-E2LH2P54.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/studio/spectator-manager.ts"],"sourcesContent":["import { mkdtempSync, rmSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\nimport type { SchemaDefinition } from '@korajs/core'\n\n/**\n * Kora Studio SPECTATOR: live, read-only inspection of a production sync\n * server.\n *\n * The spectator is a REAL Kora client — its own store, merge pipeline, and\n * sync engine — connected to the target server over the real WebSocket\n * protocol. It materializes its own replica into a throwaway database, which\n * every Studio view (records, per-field writers, op log, DAG, time travel,\n * merge audit) then reads. Nothing is simulated: what Studio shows is exactly\n * what any device syncing against that server computes.\n *\n * Read-only by construction: the spectator exposes NO mutation API, so it can\n * never push an operation to the server. It only receives, applies, and\n * observes. The server sees an ordinary client whose version vector starts\n * empty (so it receives the full history — which is what makes production\n * time travel possible) and which never sends operations.\n */\n\nexport interface SpectatorStatus {\n\turl: string\n\tconnected: boolean\n\toperationsReceived: number\n\tlastEventAt: number | null\n\tdbPath: string\n}\n\nexport interface SpectatorEvent {\n\tseq: number\n\tat: number\n\ttype: string\n\tsummary: string\n}\n\nexport interface SpectatorOptions {\n\turl: string\n\tschema: SchemaDefinition\n\t/** Bearer token forwarded through the sync auth handshake. */\n\ttoken?: string\n\t/** Client schema version override. Defaults to schema.version. */\n\tschemaVersion?: number\n}\n\n// NOTE: 'operation:applied' is in the event spec but not yet emitted by the\n// store — received-op counting uses 'sync:received' batches instead.\nconst FORWARDED_EVENTS = [\n\t'merge:started',\n\t'merge:conflict',\n\t'merge:completed',\n\t'sync:connected',\n\t'sync:disconnected',\n\t'sync:received',\n\t'sync:apply-failed',\n] as const\n\nconst MAX_EVENT_BUFFER = 500\n\n/** Structural types for the lazily-imported runtime packages. */\ninterface SpectatorRuntime {\n\tstore: {\n\t\topen(): Promise<void>\n\t\tclose(): Promise<void>\n\t\tsetLocalMutationHandler(handler: unknown): void\n\t}\n\tengine: { start(): Promise<void>; stop(): Promise<void> }\n\tunsubscribers: Array<() => void>\n}\n\nexport class SpectatorManager {\n\tprivate runtime: SpectatorRuntime | null = null\n\tprivate tmpDir: string | null = null\n\tprivate connected = false\n\tprivate operationsReceived = 0\n\tprivate lastEventAt: number | null = null\n\tprivate eventSeq = 0\n\tprivate readonly eventBuffer: SpectatorEvent[] = []\n\tprivate readonly eventListeners = new Set<(event: SpectatorEvent) => void>()\n\treadonly dbPath: string\n\n\tconstructor(private readonly options: SpectatorOptions) {\n\t\tthis.tmpDir = mkdtempSync(join(tmpdir(), 'kora-studio-spectator-'))\n\t\tthis.dbPath = join(this.tmpDir, 'spectator-replica.db')\n\t}\n\n\tasync start(): Promise<void> {\n\t\tlet mods: {\n\t\t\tStore: typeof import('@korajs/store').Store\n\t\t\tBetterSqlite3Adapter: typeof import('@korajs/store/better-sqlite3').BetterSqlite3Adapter\n\t\t\tMergeEngine: typeof import('@korajs/merge').MergeEngine\n\t\t\tSyncEngine: typeof import('@korajs/sync').SyncEngine\n\t\t\tWebSocketTransport: typeof import('@korajs/sync').WebSocketTransport\n\t\t\ttesting: typeof import('korajs/testing')\n\t\t\tSimpleEventEmitter: typeof import('@korajs/core/internal').SimpleEventEmitter\n\t\t}\n\t\ttry {\n\t\t\tmods = {\n\t\t\t\tStore: (await import('@korajs/store')).Store,\n\t\t\t\tBetterSqlite3Adapter: (await import('@korajs/store/better-sqlite3')).BetterSqlite3Adapter,\n\t\t\t\tMergeEngine: (await import('@korajs/merge')).MergeEngine,\n\t\t\t\tSyncEngine: (await import('@korajs/sync')).SyncEngine,\n\t\t\t\tWebSocketTransport: (await import('@korajs/sync')).WebSocketTransport,\n\t\t\t\ttesting: await import('korajs/testing'),\n\t\t\t\tSimpleEventEmitter: (await import('@korajs/core/internal')).SimpleEventEmitter,\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`Spectator mode needs the Kora runtime packages installed (pnpm add -D korajs @korajs/store @korajs/merge @korajs/sync better-sqlite3). Underlying error: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t}`,\n\t\t\t)\n\t\t}\n\n\t\tconst emitter = new mods.SimpleEventEmitter()\n\t\tconst adapter = new mods.BetterSqlite3Adapter(this.dbPath)\n\t\tconst store = new mods.Store({ schema: this.options.schema, adapter, emitter })\n\t\tawait store.open()\n\n\t\tconst mergeEngine = new mods.MergeEngine()\n\t\tconst pipeline = new mods.testing.ApplyPipeline({ store, mergeEngine, emitter })\n\t\tstore.setLocalMutationHandler(pipeline)\n\n\t\t// Production parity: merge decisions persist to the audit trail.\n\t\tconst unsubscribeAudit = mods.testing.wireAuditPersistence(store, emitter)\n\n\t\tconst syncStore = new mods.testing.MergeAwareSyncStore(store, mergeEngine, emitter)\n\t\tconst engine = new mods.SyncEngine({\n\t\t\ttransport: new mods.WebSocketTransport(),\n\t\t\tstore: syncStore,\n\t\t\tqueueStorage: new mods.testing.StoreQueueStorage(adapter),\n\t\t\tsyncState: new mods.testing.StoreSyncStatePersistence(store),\n\t\t\tconfig: {\n\t\t\t\turl: this.options.url,\n\t\t\t\tschemaVersion: this.options.schemaVersion ?? this.options.schema.version,\n\t\t\t\t...(this.options.token\n\t\t\t\t\t? { auth: async () => ({ token: this.options.token as string }) }\n\t\t\t\t\t: {}),\n\t\t\t},\n\t\t\temitter,\n\t\t})\n\n\t\tconst unsubscribers = FORWARDED_EVENTS.map((type) =>\n\t\t\temitter.on(type, (event: Record<string, unknown>) => {\n\t\t\t\tthis.lastEventAt = Date.now()\n\t\t\t\tif (type === 'sync:connected') {\n\t\t\t\t\tthis.connected = true\n\t\t\t\t}\n\t\t\t\tif (type === 'sync:disconnected') {\n\t\t\t\t\tthis.connected = false\n\t\t\t\t}\n\t\t\t\tif (type === 'sync:received' && Array.isArray(event.operations)) {\n\t\t\t\t\tthis.operationsReceived += event.operations.length\n\t\t\t\t}\n\t\t\t\tthis.pushEvent(type, event)\n\t\t\t}),\n\t\t)\n\t\tunsubscribers.push(unsubscribeAudit)\n\n\t\tthis.runtime = { store, engine, unsubscribers }\n\t\tawait engine.start()\n\t}\n\n\tstatus(): SpectatorStatus {\n\t\treturn {\n\t\t\turl: this.options.url,\n\t\t\tconnected: this.connected,\n\t\t\toperationsReceived: this.operationsReceived,\n\t\t\tlastEventAt: this.lastEventAt,\n\t\t\tdbPath: this.dbPath,\n\t\t}\n\t}\n\n\trecentEvents(): SpectatorEvent[] {\n\t\treturn [...this.eventBuffer]\n\t}\n\n\tonEvent(listener: (event: SpectatorEvent) => void): () => void {\n\t\tthis.eventListeners.add(listener)\n\t\treturn () => this.eventListeners.delete(listener)\n\t}\n\n\tasync close(): Promise<void> {\n\t\tif (this.runtime) {\n\t\t\tfor (const unsub of this.runtime.unsubscribers) {\n\t\t\t\tunsub()\n\t\t\t}\n\t\t\tawait this.runtime.engine.stop().catch(() => {})\n\t\t\tawait this.runtime.store.close().catch(() => {})\n\t\t\tthis.runtime = null\n\t\t}\n\t\tif (this.tmpDir) {\n\t\t\trmSync(this.tmpDir, { recursive: true, force: true })\n\t\t\tthis.tmpDir = null\n\t\t}\n\t}\n\n\tprivate pushEvent(type: string, payload: Record<string, unknown>): void {\n\t\tconst summary =\n\t\t\ttype === 'sync:received' && Array.isArray(payload.operations)\n\t\t\t\t? `received ${payload.operations.length} op(s)`\n\t\t\t\t: type.replace('sync:', '').replace('merge:', 'merge ')\n\t\tconst event: SpectatorEvent = {\n\t\t\tseq: ++this.eventSeq,\n\t\t\tat: Date.now(),\n\t\t\ttype,\n\t\t\tsummary,\n\t\t}\n\t\tthis.eventBuffer.push(event)\n\t\tif (this.eventBuffer.length > MAX_EVENT_BUFFER) {\n\t\t\tthis.eventBuffer.shift()\n\t\t}\n\t\tfor (const listener of this.eventListeners) {\n\t\t\tlistener(event)\n\t\t}\n\t}\n}\n"],"mappings":"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","names":[]}