@cosmicdrift/kumiko-headless 0.158.2 → 0.160.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.158.2",
+  "version": "0.160.0",
   "description": "Headless UI logic for Kumiko — Dispatcher contract, Form-Controller, View-Model, Nav-Resolver. Plattform- und React-frei; jeder Renderer (renderer, renderer-web, renderer-native, …) komponiert darauf.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -36,7 +36,7 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.158.2",
+    "@cosmicdrift/kumiko-framework": "0.160.0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
   },

package/src/dispatcher/__tests__/contract.test.ts

@@ -60,6 +60,9 @@ function createFakeDispatcher(options?: {
       return result;
     },
     statusStore,
+    async *stream() {
+      // streams unsupported in the sync fake — empty generator
+    },
     pendingWrites: () => pendingWritesStore,
     pendingFiles: () => pendingFilesStore,
     setStatus(next) {

package/src/dispatcher/index.ts

@@ -9,6 +9,7 @@ export type {
   PendingWrite,
   QueryOpts,
   QueryResult,
+  StreamOpts,
   WriteOpts,
   WriteResult,
 } from "./types";

package/src/dispatcher/types.ts

@@ -149,6 +149,10 @@ export type QueryOpts = {
   readonly signal?: AbortSignal;
 };
 
+export type StreamOpts = {
+  readonly signal?: AbortSignal;
+};
+
 // ---------------------------------------------------------------------------
 // The contract
 // ---------------------------------------------------------------------------
@@ -173,6 +177,17 @@ export type Dispatcher = {
 
   batch(commands: readonly Command[], opts?: WriteOpts): Promise<BatchResult>;
 
+  // Dispatcher-driven SSE (`POST /api/stream`, #1380/#1382). Yields one
+  // value per `chunk` frame. Terminal `done` ends the generator; terminal
+  // `error` rejects with a DispatcherError (thrown). Heartbeat `ping`
+  // frames are swallowed. Abort via opts.signal cancels the fetch and
+  // rejects with code `aborted`.
+  stream<TChunk = unknown>(
+    type: string,
+    payload: unknown,
+    opts?: StreamOpts,
+  ): AsyncGenerator<TChunk, void, undefined>;
+
   // --- Status ---
 
   // Subscribe/Emit-Store für Online/Offline/Syncing-Transitions. Konsumenten

package/src/form/__tests__/submit.test.ts

@@ -21,6 +21,7 @@ function makeDispatcher(response?: WriteResult): Dispatcher & {
     async batch() {
       return { isSuccess: true, results: [] };
     },
+    async *stream() {},
     statusStore: createStore("online"),
     pendingWrites: () => [],
     pendingFiles: () => [],
@@ -166,6 +167,7 @@ describe("createFormController — submit()", () => {
         return { isSuccess: true as const, results: [] };
       },
       statusStore: createStore("online"),
+      async *stream() {},
       pendingWrites: () => [],
       pendingFiles: () => [],
     };
@@ -269,6 +271,7 @@ describe("createFormController — submit()", () => {
         return { isSuccess: true as const, results: [] };
       },
       statusStore: createStore("online"),
+      async *stream() {},
       pendingWrites: () => [],
       pendingFiles: () => [],
     };

package/src/index.ts

@@ -34,6 +34,7 @@ export type {
   PendingWrite,
   QueryOpts,
   QueryResult,
+  StreamOpts,
   WriteOpts,
   WriteResult,
 } from "./dispatcher";