@kortyx/stream 0.2.3 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @chatbot-core/types
 
+## [0.3.1](https://github.com/kortyx-io/kortyx/compare/stream-v0.3.0...stream-v0.3.1) (2026-02-17)
+
+
+### Bug Fixes
+
+* **build:** align package tsconfig with shared lib baseline ([48d2b57](https://github.com/kortyx-io/kortyx/commit/48d2b5765fefbb5fcbbe548e749e7b5f51b450b9))
+* **build:** wire tsup for publishable packages ([e7b1b5c](https://github.com/kortyx-io/kortyx/commit/e7b1b5c28af55becffc137233dd92d8953d7cb8e))
+* **dev:** restore tsc watch flow for local workspace ([4305823](https://github.com/kortyx-io/kortyx/commit/430582372cad466bf28af554042aa11bdb8bf027))
+
+## [0.3.0](https://github.com/kortyx-io/kortyx/compare/stream-v0.2.3...stream-v0.3.0) (2026-02-17)
+
+
+### Features
+
+* **kortyx:** add browser-safe chat streaming adapters ([c7eb98e](https://github.com/kortyx-io/kortyx/commit/c7eb98e06781a708c79f143ba725efb69d35709e))
+
 ## [0.2.3](https://github.com/kortyx-io/kortyx/compare/stream-v0.2.2...stream-v0.2.3) (2026-01-25)
 
 

package/dist/{types/stream-chunk.d.ts → browser-2jZhtGOe.d.ts}

@@ -1,5 +1,6 @@
-import { z } from "zod";
-export declare const StreamChunkSchema: z.ZodUnion<[z.ZodObject<{
+import { z } from 'zod';
+
+declare const StreamChunkSchema: z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"session">;
     sessionId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -282,5 +283,20 @@ export declare const StreamChunkSchema: z.ZodUnion<[z.ZodObject<{
     message?: string;
     type?: "error";
 }>]>;
-export type StreamChunk = z.infer<typeof StreamChunkSchema>;
-//# sourceMappingURL=stream-chunk.d.ts.map
+type StreamChunk = z.infer<typeof StreamChunkSchema>;
+
+/**
+ * Reads a server-sent event (SSE) Response body and yields StreamChunk objects.
+ */
+declare function readStream(body: ReadableStream<Uint8Array> | null): AsyncGenerator<StreamChunk, void, void>;
+
+interface StreamFromRouteArgs<TBody = unknown> {
+    endpoint: string;
+    body: TBody;
+    method?: string | undefined;
+    fetchImpl?: typeof fetch;
+    headers?: Record<string, string> | undefined;
+}
+declare function streamFromRoute<TBody = unknown>(args: StreamFromRouteArgs<TBody>): AsyncGenerator<StreamChunk, void, void>;
+
+export { type StreamChunk as S, StreamChunkSchema as a, type StreamFromRouteArgs as b, readStream as r, streamFromRoute as s };

package/dist/browser.d.ts

@@ -0,0 +1,2 @@
+export { S as StreamChunk, b as StreamFromRouteArgs, r as readStream, s as streamFromRoute } from './browser-2jZhtGOe.js';
+import 'zod';

package/dist/browser.js

@@ -0,0 +1,100 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/browser.ts
+var browser_exports = {};
+__export(browser_exports, {
+  readStream: () => readStream,
+  streamFromRoute: () => streamFromRoute
+});
+module.exports = __toCommonJS(browser_exports);
+
+// src/client/read-stream.ts
+async function* readStream(body) {
+  if (!body) return;
+  const reader = body.getReader();
+  const decoder = new TextDecoder("utf-8");
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const parts = buffer.split("\n\n");
+    buffer = parts.pop() ?? "";
+    for (const part of parts) {
+      if (!part.startsWith("data: ")) continue;
+      const payload = part.slice(6);
+      if (payload.trim() === "[DONE]") return;
+      try {
+        yield JSON.parse(payload);
+      } catch (err) {
+        console.warn("Invalid JSON in stream chunk:", payload);
+        console.error(err);
+      }
+    }
+  }
+}
+
+// src/client/stream-from-route.ts
+var toErrorMessage = (error) => error instanceof Error ? error.message : String(error);
+var readErrorMessage = async (response) => {
+  let message = `Request failed (${response.status})`;
+  try {
+    const payload = await response.json();
+    if (payload && typeof payload === "object" && "error" in payload && typeof payload.error === "string") {
+      message = payload.error;
+    }
+  } catch {
+  }
+  return message;
+};
+async function* streamFromRoute(args) {
+  const fetchFn = args.fetchImpl ?? globalThis.fetch;
+  if (!fetchFn) {
+    yield { type: "error", message: "No fetch implementation available." };
+    yield { type: "done" };
+    return;
+  }
+  let response;
+  try {
+    response = await fetchFn(args.endpoint, {
+      method: args.method ?? "POST",
+      headers: {
+        "content-type": "application/json",
+        ...args.headers ?? {}
+      },
+      body: JSON.stringify(args.body)
+    });
+  } catch (error) {
+    yield { type: "error", message: toErrorMessage(error) };
+    yield { type: "done" };
+    return;
+  }
+  if (!response.ok) {
+    yield { type: "error", message: await readErrorMessage(response) };
+    yield { type: "done" };
+    return;
+  }
+  yield* readStream(response.body);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  readStream,
+  streamFromRoute
+});
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser.ts","../src/client/read-stream.ts","../src/client/stream-from-route.ts"],"sourcesContent":["// Browser-safe exports for client bundles.\n// Keep this file free of Node-only imports (fs, path, etc).\n\nexport { readStream } from \"./client/read-stream\";\nexport type { StreamFromRouteArgs } from \"./client/stream-from-route\";\nexport { streamFromRoute } from \"./client/stream-from-route\";\nexport type { StreamChunk } from \"./types/stream-chunk\";\n","// packages/stream/src/client/read-stream.ts\nimport type { StreamChunk } from \"../types/stream-chunk\";\n\n/**\n * Reads a server-sent event (SSE) Response body and yields StreamChunk objects.\n */\nexport async function* readStream(\n  body: ReadableStream<Uint8Array> | null,\n): AsyncGenerator<StreamChunk, void, void> {\n  if (!body) return;\n\n  const reader = body.getReader();\n  const decoder = new TextDecoder(\"utf-8\");\n  let buffer = \"\";\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n\n    buffer += decoder.decode(value, { stream: true });\n    const parts = buffer.split(\"\\n\\n\");\n    buffer = parts.pop() ?? \"\";\n\n    for (const part of parts) {\n      if (!part.startsWith(\"data: \")) continue;\n      const payload = part.slice(6);\n      if (payload.trim() === \"[DONE]\") return;\n      try {\n        yield JSON.parse(payload) as StreamChunk;\n      } catch (err: any) {\n        console.warn(\"Invalid JSON in stream chunk:\", payload);\n        console.error(err);\n      }\n    }\n  }\n}\n","import type { StreamChunk } from \"../types/stream-chunk\";\nimport { readStream } from \"./read-stream\";\n\nexport interface StreamFromRouteArgs<TBody = unknown> {\n  endpoint: string;\n  body: TBody;\n  method?: string | undefined;\n  fetchImpl?: typeof fetch;\n  headers?: Record<string, string> | undefined;\n}\n\nconst toErrorMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n\nconst readErrorMessage = async (response: Response): Promise<string> => {\n  let message = `Request failed (${response.status})`;\n  try {\n    const payload = (await response.json()) as unknown;\n    if (\n      payload &&\n      typeof payload === \"object\" &&\n      \"error\" in payload &&\n      typeof (payload as { error?: unknown }).error === \"string\"\n    ) {\n      message = (payload as { error: string }).error;\n    }\n  } catch {}\n  return message;\n};\n\nexport async function* streamFromRoute<TBody = unknown>(\n  args: StreamFromRouteArgs<TBody>,\n): AsyncGenerator<StreamChunk, void, void> {\n  const fetchFn = args.fetchImpl ?? globalThis.fetch;\n  if (!fetchFn) {\n    yield { type: \"error\", message: \"No fetch implementation available.\" };\n    yield { type: \"done\" };\n    return;\n  }\n\n  let response: Response;\n  try {\n    response = await fetchFn(args.endpoint, {\n      method: args.method ?? \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(args.headers ?? {}),\n      },\n      body: JSON.stringify(args.body),\n    });\n  } catch (error) {\n    yield { type: \"error\", message: toErrorMessage(error) };\n    yield { type: \"done\" };\n    return;\n  }\n\n  if (!response.ok) {\n    yield { type: \"error\", message: await readErrorMessage(response) };\n    yield { type: \"done\" };\n    return;\n  }\n\n  yield* readStream(response.body);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMA,gBAAuB,WACrB,MACyC;AACzC,MAAI,CAAC,KAAM;AAEX,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,UAAU,IAAI,YAAY,OAAO;AACvC,MAAI,SAAS;AAEb,SAAO,MAAM;AACX,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,QAAI,KAAM;AAEV,cAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;AAChD,UAAM,QAAQ,OAAO,MAAM,MAAM;AACjC,aAAS,MAAM,IAAI,KAAK;AAExB,eAAW,QAAQ,OAAO;AACxB,UAAI,CAAC,KAAK,WAAW,QAAQ,EAAG;AAChC,YAAM,UAAU,KAAK,MAAM,CAAC;AAC5B,UAAI,QAAQ,KAAK,MAAM,SAAU;AACjC,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AAAA,MAC1B,SAAS,KAAU;AACjB,gBAAQ,KAAK,iCAAiC,OAAO;AACrD,gBAAQ,MAAM,GAAG;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;;;ACxBA,IAAM,iBAAiB,CAAC,UACtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAEvD,IAAM,mBAAmB,OAAO,aAAwC;AACtE,MAAI,UAAU,mBAAmB,SAAS,MAAM;AAChD,MAAI;AACF,UAAM,UAAW,MAAM,SAAS,KAAK;AACrC,QACE,WACA,OAAO,YAAY,YACnB,WAAW,WACX,OAAQ,QAAgC,UAAU,UAClD;AACA,gBAAW,QAA8B;AAAA,IAC3C;AAAA,EACF,QAAQ;AAAA,EAAC;AACT,SAAO;AACT;AAEA,gBAAuB,gBACrB,MACyC;AACzC,QAAM,UAAU,KAAK,aAAa,WAAW;AAC7C,MAAI,CAAC,SAAS;AACZ,UAAM,EAAE,MAAM,SAAS,SAAS,qCAAqC;AACrE,UAAM,EAAE,MAAM,OAAO;AACrB;AAAA,EACF;AAEA,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,QAAQ,KAAK,UAAU;AAAA,MACtC,QAAQ,KAAK,UAAU;AAAA,MACvB,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAI,KAAK,WAAW,CAAC;AAAA,MACvB;AAAA,MACA,MAAM,KAAK,UAAU,KAAK,IAAI;AAAA,IAChC,CAAC;AAAA,EACH,SAAS,OAAO;AACd,UAAM,EAAE,MAAM,SAAS,SAAS,eAAe,KAAK,EAAE;AACtD,UAAM,EAAE,MAAM,OAAO;AACrB;AAAA,EACF;AAEA,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,EAAE,MAAM,SAAS,SAAS,MAAM,iBAAiB,QAAQ,EAAE;AACjE,UAAM,EAAE,MAAM,OAAO;AACrB;AAAA,EACF;AAEA,SAAO,WAAW,SAAS,IAAI;AACjC;","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,17 @@
-export * from "./client/read-stream";
-export * from "./server/create-stream-response";
-export * from "./types/stream-chunk";
-//# sourceMappingURL=index.d.ts.map
+import { S as StreamChunk } from './browser-2jZhtGOe.js';
+export { a as StreamChunkSchema, b as StreamFromRouteArgs, r as readStream, s as streamFromRoute } from './browser-2jZhtGOe.js';
+import 'zod';
+
+declare const STREAM_HEADERS: {
+    "content-type": string;
+    "cache-control": string;
+    connection: string;
+    "x-accel-buffering": string;
+};
+/**
+ * Turns an AsyncIterable<StreamChunk> into a streamed HTTP Response.
+ * Works in Node, Bun, Cloudflare, Edge, etc.
+ */
+declare function createStreamResponse(stream: AsyncIterable<StreamChunk>): Response;
+
+export { STREAM_HEADERS, StreamChunk, createStreamResponse };

package/dist/index.js

@@ -1,19 +1,264 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  STREAM_HEADERS: () => STREAM_HEADERS,
+  StreamChunkSchema: () => StreamChunkSchema,
+  createStreamResponse: () => createStreamResponse,
+  readStream: () => readStream,
+  streamFromRoute: () => streamFromRoute
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client/read-stream.ts
+async function* readStream(body) {
+  if (!body) return;
+  const reader = body.getReader();
+  const decoder = new TextDecoder("utf-8");
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const parts = buffer.split("\n\n");
+    buffer = parts.pop() ?? "";
+    for (const part of parts) {
+      if (!part.startsWith("data: ")) continue;
+      const payload = part.slice(6);
+      if (payload.trim() === "[DONE]") return;
+      try {
+        yield JSON.parse(payload);
+      } catch (err) {
+        console.warn("Invalid JSON in stream chunk:", payload);
+        console.error(err);
+      }
+    }
+  }
+}
+
+// src/client/stream-from-route.ts
+var toErrorMessage = (error) => error instanceof Error ? error.message : String(error);
+var readErrorMessage = async (response) => {
+  let message = `Request failed (${response.status})`;
+  try {
+    const payload = await response.json();
+    if (payload && typeof payload === "object" && "error" in payload && typeof payload.error === "string") {
+      message = payload.error;
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+  } catch {
+  }
+  return message;
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./client/read-stream"), exports);
-__exportStar(require("./server/create-stream-response"), exports);
-__exportStar(require("./types/stream-chunk"), exports);
+async function* streamFromRoute(args) {
+  const fetchFn = args.fetchImpl ?? globalThis.fetch;
+  if (!fetchFn) {
+    yield { type: "error", message: "No fetch implementation available." };
+    yield { type: "done" };
+    return;
+  }
+  let response;
+  try {
+    response = await fetchFn(args.endpoint, {
+      method: args.method ?? "POST",
+      headers: {
+        "content-type": "application/json",
+        ...args.headers ?? {}
+      },
+      body: JSON.stringify(args.body)
+    });
+  } catch (error) {
+    yield { type: "error", message: toErrorMessage(error) };
+    yield { type: "done" };
+    return;
+  }
+  if (!response.ok) {
+    yield { type: "error", message: await readErrorMessage(response) };
+    yield { type: "done" };
+    return;
+  }
+  yield* readStream(response.body);
+}
+
+// src/server/create-stream-response.ts
+var STREAM_HEADERS = {
+  "content-type": "text/event-stream",
+  "cache-control": "no-cache",
+  connection: "keep-alive",
+  "x-accel-buffering": "no"
+};
+var JsonToSseTransformStream = class extends TransformStream {
+  constructor() {
+    super({
+      transform(part, controller) {
+        controller.enqueue(`data: ${JSON.stringify(part)}
+
+`);
+      },
+      flush(controller) {
+        controller.enqueue("data: [DONE]\n\n");
+      }
+    });
+  }
+};
+function createStreamResponse(stream) {
+  const readable = new ReadableStream({
+    async start(controller) {
+      try {
+        for await (const chunk of stream) {
+          controller.enqueue(chunk);
+        }
+      } catch (err) {
+        controller.enqueue({
+          type: "error",
+          message: String(err?.message ?? err)
+        });
+      } finally {
+        controller.close();
+      }
+    }
+  });
+  return new Response(
+    readable.pipeThrough(new JsonToSseTransformStream()).pipeThrough(new TextEncoderStream()),
+    { headers: STREAM_HEADERS }
+  );
+}
+
+// src/types/stream-chunk.ts
+var import_zod3 = require("zod");
+
+// src/types/structured-data/index.ts
+var import_zod2 = require("zod");
+
+// src/types/structured-data/jobs.ts
+var import_zod = require("zod");
+var JobsStructuredData = import_zod.z.object({
+  jobs: import_zod.z.array(
+    import_zod.z.object({
+      id: import_zod.z.string(),
+      title: import_zod.z.string(),
+      company: import_zod.z.string(),
+      location: import_zod.z.string(),
+      match: import_zod.z.number()
+    })
+  ),
+  reasoning: import_zod.z.string().optional()
+});
+
+// src/types/structured-data/index.ts
+var StructuredDataChunkSchema = import_zod2.z.discriminatedUnion("dataType", [
+  import_zod2.z.object({
+    type: import_zod2.z.literal("structured-data"),
+    dataType: import_zod2.z.literal("jobs"),
+    node: import_zod2.z.string().optional(),
+    data: JobsStructuredData
+  })
+  // Future additions:
+  // z.object({
+  //   type: z.literal("structured-data"),
+  //   dataType: z.literal("profile"),
+  //   node: z.string().optional(),
+  //   data: ProfileStructuredData,
+  // }),
+]);
+
+// src/types/stream-chunk.ts
+var StreamChunkSchema = import_zod3.z.union([
+  import_zod3.z.object({
+    type: import_zod3.z.literal("session"),
+    sessionId: import_zod3.z.string()
+  }),
+  import_zod3.z.object({
+    type: import_zod3.z.literal("status"),
+    message: import_zod3.z.string(),
+    node: import_zod3.z.string().optional()
+  }),
+  import_zod3.z.object({
+    type: import_zod3.z.literal("message"),
+    content: import_zod3.z.string(),
+    node: import_zod3.z.string().optional()
+  }),
+  import_zod3.z.object({
+    type: import_zod3.z.literal("text-start"),
+    node: import_zod3.z.string().optional()
+  }),
+  import_zod3.z.object({
+    type: import_zod3.z.literal("text-delta"),
+    delta: import_zod3.z.string(),
+    node: import_zod3.z.string().optional()
+  }),
+  import_zod3.z.object({
+    type: import_zod3.z.literal("text-end"),
+    node: import_zod3.z.string().optional()
+  }),
+  import_zod3.z.object({
+    type: import_zod3.z.literal("tool-result"),
+    tool: import_zod3.z.string().optional(),
+    node: import_zod3.z.string().optional(),
+    content: import_zod3.z.unknown()
+  }),
+  // Interrupt request chunk (used to render interactive options in UI)
+  import_zod3.z.object({
+    type: import_zod3.z.literal("interrupt"),
+    requestId: import_zod3.z.string(),
+    resumeToken: import_zod3.z.string(),
+    workflow: import_zod3.z.string().optional(),
+    node: import_zod3.z.string().optional(),
+    input: import_zod3.z.discriminatedUnion("kind", [
+      // Text input: question optional, no options
+      import_zod3.z.object({
+        kind: import_zod3.z.literal("text"),
+        multiple: import_zod3.z.boolean(),
+        question: import_zod3.z.string().optional(),
+        options: import_zod3.z.array(import_zod3.z.never()).optional()
+      }),
+      // Choice/multi-choice: question + options required
+      import_zod3.z.object({
+        kind: import_zod3.z.enum(["choice", "multi-choice"]),
+        multiple: import_zod3.z.boolean(),
+        question: import_zod3.z.string(),
+        options: import_zod3.z.array(
+          import_zod3.z.object({
+            id: import_zod3.z.string(),
+            label: import_zod3.z.string(),
+            description: import_zod3.z.string().optional()
+          })
+        )
+      })
+    ]),
+    meta: import_zod3.z.record(import_zod3.z.unknown()).optional()
+  }),
+  StructuredDataChunkSchema,
+  import_zod3.z.object({
+    type: import_zod3.z.literal("transition"),
+    transitionTo: import_zod3.z.string(),
+    payload: import_zod3.z.any().optional()
+  }),
+  import_zod3.z.object({ type: import_zod3.z.literal("done"), data: import_zod3.z.any().optional() }),
+  import_zod3.z.object({ type: import_zod3.z.literal("error"), message: import_zod3.z.string() })
+]);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  STREAM_HEADERS,
+  StreamChunkSchema,
+  createStreamResponse,
+  readStream,
+  streamFromRoute
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client/read-stream.ts","../src/client/stream-from-route.ts","../src/server/create-stream-response.ts","../src/types/stream-chunk.ts","../src/types/structured-data/index.ts","../src/types/structured-data/jobs.ts"],"sourcesContent":["// release-test: 2026-01-22\n// packages/stream/src/index.ts\n\n// client\nexport * from \"./client/read-stream\";\nexport * from \"./client/stream-from-route\";\n\n// server\nexport * from \"./server/create-stream-response\";\nexport * from \"./types/stream-chunk\";\n","// packages/stream/src/client/read-stream.ts\nimport type { StreamChunk } from \"../types/stream-chunk\";\n\n/**\n * Reads a server-sent event (SSE) Response body and yields StreamChunk objects.\n */\nexport async function* readStream(\n  body: ReadableStream<Uint8Array> | null,\n): AsyncGenerator<StreamChunk, void, void> {\n  if (!body) return;\n\n  const reader = body.getReader();\n  const decoder = new TextDecoder(\"utf-8\");\n  let buffer = \"\";\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n\n    buffer += decoder.decode(value, { stream: true });\n    const parts = buffer.split(\"\\n\\n\");\n    buffer = parts.pop() ?? \"\";\n\n    for (const part of parts) {\n      if (!part.startsWith(\"data: \")) continue;\n      const payload = part.slice(6);\n      if (payload.trim() === \"[DONE]\") return;\n      try {\n        yield JSON.parse(payload) as StreamChunk;\n      } catch (err: any) {\n        console.warn(\"Invalid JSON in stream chunk:\", payload);\n        console.error(err);\n      }\n    }\n  }\n}\n","import type { StreamChunk } from \"../types/stream-chunk\";\nimport { readStream } from \"./read-stream\";\n\nexport interface StreamFromRouteArgs<TBody = unknown> {\n  endpoint: string;\n  body: TBody;\n  method?: string | undefined;\n  fetchImpl?: typeof fetch;\n  headers?: Record<string, string> | undefined;\n}\n\nconst toErrorMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n\nconst readErrorMessage = async (response: Response): Promise<string> => {\n  let message = `Request failed (${response.status})`;\n  try {\n    const payload = (await response.json()) as unknown;\n    if (\n      payload &&\n      typeof payload === \"object\" &&\n      \"error\" in payload &&\n      typeof (payload as { error?: unknown }).error === \"string\"\n    ) {\n      message = (payload as { error: string }).error;\n    }\n  } catch {}\n  return message;\n};\n\nexport async function* streamFromRoute<TBody = unknown>(\n  args: StreamFromRouteArgs<TBody>,\n): AsyncGenerator<StreamChunk, void, void> {\n  const fetchFn = args.fetchImpl ?? globalThis.fetch;\n  if (!fetchFn) {\n    yield { type: \"error\", message: \"No fetch implementation available.\" };\n    yield { type: \"done\" };\n    return;\n  }\n\n  let response: Response;\n  try {\n    response = await fetchFn(args.endpoint, {\n      method: args.method ?? \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(args.headers ?? {}),\n      },\n      body: JSON.stringify(args.body),\n    });\n  } catch (error) {\n    yield { type: \"error\", message: toErrorMessage(error) };\n    yield { type: \"done\" };\n    return;\n  }\n\n  if (!response.ok) {\n    yield { type: \"error\", message: await readErrorMessage(response) };\n    yield { type: \"done\" };\n    return;\n  }\n\n  yield* readStream(response.body);\n}\n","// packages/stream/src/server/create-stream-response.ts\nimport type { StreamChunk } from \"../types/stream-chunk\";\n\nexport const STREAM_HEADERS = {\n  \"content-type\": \"text/event-stream\",\n  \"cache-control\": \"no-cache\",\n  connection: \"keep-alive\",\n  \"x-accel-buffering\": \"no\",\n};\n\nclass JsonToSseTransformStream extends TransformStream<unknown, string> {\n  constructor() {\n    super({\n      transform(part, controller) {\n        controller.enqueue(`data: ${JSON.stringify(part)}\\n\\n`);\n      },\n      flush(controller) {\n        controller.enqueue(\"data: [DONE]\\n\\n\");\n      },\n    });\n  }\n}\n\n/**\n * Turns an AsyncIterable<StreamChunk> into a streamed HTTP Response.\n * Works in Node, Bun, Cloudflare, Edge, etc.\n */\nexport function createStreamResponse(\n  stream: AsyncIterable<StreamChunk>,\n): Response {\n  const readable = new ReadableStream<StreamChunk>({\n    async start(controller) {\n      try {\n        for await (const chunk of stream) {\n          controller.enqueue(chunk);\n        }\n      } catch (err: any) {\n        controller.enqueue({\n          type: \"error\",\n          message: String(err?.message ?? err),\n        } as StreamChunk);\n      } finally {\n        controller.close();\n      }\n    },\n  });\n\n  return new Response(\n    readable\n      .pipeThrough(new JsonToSseTransformStream())\n      .pipeThrough(new TextEncoderStream()),\n    { headers: STREAM_HEADERS },\n  );\n}\n","import { z } from \"zod\";\nimport { StructuredDataChunkSchema } from \"./structured-data\";\n\nexport const StreamChunkSchema = z.union([\n  z.object({\n    type: z.literal(\"session\"),\n    sessionId: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"status\"),\n    message: z.string(),\n    node: z.string().optional(),\n  }),\n  z.object({\n    type: z.literal(\"message\"),\n    content: z.string(),\n    node: z.string().optional(),\n  }),\n  z.object({\n    type: z.literal(\"text-start\"),\n    node: z.string().optional(),\n  }),\n  z.object({\n    type: z.literal(\"text-delta\"),\n    delta: z.string(),\n    node: z.string().optional(),\n  }),\n  z.object({\n    type: z.literal(\"text-end\"),\n    node: z.string().optional(),\n  }),\n  z.object({\n    type: z.literal(\"tool-result\"),\n    tool: z.string().optional(),\n    node: z.string().optional(),\n    content: z.unknown(),\n  }),\n  // Interrupt request chunk (used to render interactive options in UI)\n  z.object({\n    type: z.literal(\"interrupt\"),\n    requestId: z.string(),\n    resumeToken: z.string(),\n    workflow: z.string().optional(),\n    node: z.string().optional(),\n    input: z.discriminatedUnion(\"kind\", [\n      // Text input: question optional, no options\n      z.object({\n        kind: z.literal(\"text\"),\n        multiple: z.boolean(),\n        question: z.string().optional(),\n        options: z.array(z.never()).optional(),\n      }),\n      // Choice/multi-choice: question + options required\n      z.object({\n        kind: z.enum([\"choice\", \"multi-choice\"]),\n        multiple: z.boolean(),\n        question: z.string(),\n        options: z.array(\n          z.object({\n            id: z.string(),\n            label: z.string(),\n            description: z.string().optional(),\n          }),\n        ),\n      }),\n    ]),\n    meta: z.record(z.unknown()).optional(),\n  }),\n  StructuredDataChunkSchema,\n  z.object({\n    type: z.literal(\"transition\"),\n    transitionTo: z.string(),\n    payload: z.any().optional(),\n  }),\n  z.object({ type: z.literal(\"done\"), data: z.any().optional() }),\n  z.object({ type: z.literal(\"error\"), message: z.string() }),\n]);\n\nexport type StreamChunk = z.infer<typeof StreamChunkSchema>;\n","import { z } from \"zod\";\nimport { JobsStructuredData } from \"./jobs\";\n// import { ProfileStructuredData } from \"./profile\"; // future use\n\n/**\n * Define all known structured data chunk schemas.\n * Each one discriminates on `dataType` so we can infer its shape.\n */\nexport const StructuredDataChunkSchema = z.discriminatedUnion(\"dataType\", [\n  z.object({\n    type: z.literal(\"structured-data\"),\n    dataType: z.literal(\"jobs\"),\n    node: z.string().optional(),\n    data: JobsStructuredData,\n  }),\n\n  // Future additions:\n  // z.object({\n  //   type: z.literal(\"structured-data\"),\n  //   dataType: z.literal(\"profile\"),\n  //   node: z.string().optional(),\n  //   data: ProfileStructuredData,\n  // }),\n]);\n\nexport type StructuredDataChunk = z.infer<typeof StructuredDataChunkSchema>;\n","import { z } from \"zod\";\n\nexport const JobsStructuredData = z.object({\n  jobs: z.array(\n    z.object({\n      id: z.string(),\n      title: z.string(),\n      company: z.string(),\n      location: z.string(),\n      match: z.number(),\n    }),\n  ),\n  reasoning: z.string().optional(),\n});\n\nexport type JobsStructuredData = z.infer<typeof JobsStructuredData>;\n"],"mappings":"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","names":["import_zod","import_zod"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortyx/stream",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "private": false,
   "description": "Streaming primitives for Kortyx.",
   "keywords": [
@@ -14,7 +14,7 @@
     "kortyx"
   ],
   "license": "Apache-2.0",
-  "homepage": "https://github.com/kortyx-io/kortyx/tree/main/packages/stream#readme",
+  "homepage": "https://kortyx.io/",
   "bugs": {
     "url": "https://github.com/kortyx-io/kortyx/issues"
   },
@@ -25,6 +25,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
     }
   },
   "files": [
@@ -32,24 +36,25 @@
     "README.md",
     "CHANGELOG.md"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsc --watch",
+    "lint": "biome check src",
+    "test": "pnpm -s type-check",
+    "type-check": "tsc --noEmit"
+  },
   "dependencies": {
     "zod": "^3.23.8"
   },
   "devDependencies": {
     "concurrently": "^9.2.0",
     "turbo": "^2.5.4",
-    "typescript": "5.7.2"
+    "typescript": "5.7.2",
+    "tsup": "^8.5.1"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/kortyx-io/kortyx",
+    "url": "https://github.com/kortyx-io/kortyx.git",
     "directory": "packages/stream"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "dev": "tsc --watch",
-    "lint": "biome check src",
-    "test": "pnpm -s type-check",
-    "type-check": "tsc --noEmit"
   }
-}
+}