@kortyx/stream 0.5.2 → 0.6.1

package/dist/browser.js

@@ -19,8 +19,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/browser.ts
 var browser_exports = {};
 __export(browser_exports, {
+  applyStructuredChunk: () => applyStructuredChunk,
   consumeStream: () => consumeStream,
+  createStructuredStreamAccumulator: () => createStructuredStreamAccumulator,
   readStream: () => readStream,
+  reduceStructuredChunks: () => reduceStructuredChunks,
   streamFromRoute: () => streamFromRoute
 });
 module.exports = __toCommonJS(browser_exports);
@@ -124,10 +127,197 @@ async function* streamFromRoute(args) {
   }
   yield* readStream(response.body);
 }
+
+// src/structured/apply-structured-chunk.ts
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isArrayIndex = (value) => /^\d+$/.test(value);
+var describeValue = (value) => {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "array";
+  return typeof value;
+};
+var parsePath = (path) => {
+  if (path.length === 0) {
+    throw new Error(
+      "Structured chunk path must be a non-empty dot-separated string."
+    );
+  }
+  const parts = path.split(".");
+  if (parts.some((part) => part.length === 0)) {
+    throw new Error(
+      `Structured chunk path "${path}" must not contain empty segments.`
+    );
+  }
+  return parts;
+};
+var cloneContainerForPart = (args) => {
+  const expected = isArrayIndex(args.part) ? "array" : "object";
+  const location = args.traversed.length === 0 ? "<root>" : args.traversed.join(".");
+  if (args.current === void 0) {
+    return expected === "array" ? [] : {};
+  }
+  if (expected === "array") {
+    if (Array.isArray(args.current)) return [...args.current];
+    throw new Error(
+      `Structured path conflict at ${location} for "${args.path}": expected array container, received ${describeValue(args.current)}.`
+    );
+  }
+  if (isPlainObject(args.current)) return { ...args.current };
+  throw new Error(
+    `Structured path conflict at ${location} for "${args.path}": expected object container, received ${describeValue(args.current)}.`
+  );
+};
+var updateByParts = (args) => {
+  const traversed = args.traversed ?? [];
+  const [part, ...rest] = args.parts;
+  if (part === void 0) {
+    return args.updateLeaf(args.input);
+  }
+  const container = cloneContainerForPart({
+    current: args.input,
+    part,
+    path: args.path,
+    traversed
+  });
+  const currentChild = Array.isArray(container) ? container[Number(part)] : container[part];
+  const nextChild = rest.length === 0 ? args.updateLeaf(currentChild) : updateByParts({
+    input: currentChild,
+    parts: rest,
+    path: args.path,
+    updateLeaf: args.updateLeaf,
+    traversed: [...traversed, part]
+  });
+  if (Array.isArray(container)) {
+    container[Number(part)] = nextChild;
+  } else {
+    container[part] = nextChild;
+  }
+  return container;
+};
+function applyStructuredChunk(current, chunk) {
+  if (current && current.streamId !== chunk.streamId) {
+    throw new Error(
+      `Structured chunk streamId mismatch: expected ${current.streamId}, received ${chunk.streamId}.`
+    );
+  }
+  if (current?.status === "done") {
+    throw new Error(
+      `Structured stream ${chunk.streamId} already completed with a final chunk.`
+    );
+  }
+  const nextBase = {
+    streamId: chunk.streamId,
+    dataType: chunk.dataType,
+    status: chunk.kind === "final" ? "done" : "streaming",
+    ...chunk.node ? { node: chunk.node } : {},
+    ...chunk.id ? { id: chunk.id } : {},
+    ...chunk.schemaId ? { schemaId: chunk.schemaId } : {},
+    ...chunk.schemaVersion ? { schemaVersion: chunk.schemaVersion } : {}
+  };
+  if (chunk.kind === "final") {
+    return {
+      ...nextBase,
+      data: chunk.data
+    };
+  }
+  const path = chunk.path;
+  const pathParts = parsePath(path);
+  const previousData = current?.data;
+  if (chunk.kind === "set") {
+    return {
+      ...nextBase,
+      data: updateByParts({
+        input: previousData,
+        parts: pathParts,
+        path,
+        updateLeaf: () => chunk.value
+      })
+    };
+  }
+  if (chunk.kind === "append") {
+    return {
+      ...nextBase,
+      data: updateByParts({
+        input: previousData,
+        parts: pathParts,
+        path,
+        updateLeaf: (existing) => {
+          if (existing === void 0) return [...chunk.items];
+          if (!Array.isArray(existing)) {
+            throw new Error(
+              `Structured append requires path "${path}" to target an array, received ${describeValue(existing)}.`
+            );
+          }
+          return [...existing, ...chunk.items];
+        }
+      })
+    };
+  }
+  return {
+    ...nextBase,
+    data: updateByParts({
+      input: previousData,
+      parts: pathParts,
+      path,
+      updateLeaf: (existing) => {
+        if (existing === void 0) return chunk.delta;
+        if (typeof existing !== "string") {
+          throw new Error(
+            `Structured text-delta requires path "${path}" to target a string, received ${describeValue(existing)}.`
+          );
+        }
+        return existing + chunk.delta;
+      }
+    })
+  };
+}
+function reduceStructuredChunks(chunks) {
+  return chunks.reduce(
+    (acc, chunk) => {
+      acc[chunk.streamId] = applyStructuredChunk(acc[chunk.streamId], chunk);
+      return acc;
+    },
+    {}
+  );
+}
+
+// src/structured/structured-stream-accumulator.ts
+var isStructuredDataChunk = (chunk) => chunk.type === "structured-data";
+function createStructuredStreamAccumulator(initialChunks = []) {
+  const states = /* @__PURE__ */ new Map();
+  const apply = (chunk) => {
+    const nextState = applyStructuredChunk(states.get(chunk.streamId), chunk);
+    states.set(chunk.streamId, nextState);
+    return nextState;
+  };
+  for (const chunk of initialChunks) {
+    apply(chunk);
+  }
+  return {
+    apply,
+    applyStreamChunk: (chunk) => {
+      if (!isStructuredDataChunk(chunk)) return void 0;
+      return apply(chunk);
+    },
+    get: (streamId) => states.get(streamId),
+    has: (streamId) => states.has(streamId),
+    delete: (streamId) => states.delete(streamId),
+    clear: () => {
+      states.clear();
+    },
+    size: () => states.size,
+    entries: () => Array.from(states.entries()),
+    values: () => Array.from(states.values()),
+    toRecord: () => Object.fromEntries(states.entries())
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  applyStructuredChunk,
   consumeStream,
+  createStructuredStreamAccumulator,
   readStream,
+  reduceStructuredChunks,
   streamFromRoute
 });
 //# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/browser.ts","../src/client/consume-stream.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 type { ConsumeStreamHandlers } from \"./client/consume-stream\";\nexport { consumeStream } from \"./client/consume-stream\";\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","import type { StreamChunk } from \"../types/stream-chunk\";\n\nexport interface ConsumeStreamHandlers {\n  onChunk?: (\n    chunk: StreamChunk,\n  ) => void | boolean | Promise<boolean | undefined>;\n  onDone?: () => void | Promise<void>;\n  onError?: (error: Error, chunk?: StreamChunk) => void | Promise<void>;\n}\n\nconst toError = (value: unknown): Error =>\n  value instanceof Error ? value : new Error(String(value));\n\n/**\n * Consume a stream of StreamChunk events with callback handlers.\n * Returns when a `done` chunk is seen, the stream ends, or `onChunk` returns `false`.\n */\nexport async function consumeStream(\n  stream: AsyncIterable<StreamChunk>,\n  handlers: ConsumeStreamHandlers = {},\n): Promise<void> {\n  let doneCalled = false;\n\n  const callDone = async () => {\n    if (doneCalled) return;\n    doneCalled = true;\n    await handlers.onDone?.();\n  };\n\n  try {\n    for await (const chunk of stream) {\n      const shouldContinue = await handlers.onChunk?.(chunk);\n\n      if (chunk.type === \"error\") {\n        await handlers.onError?.(\n          new Error(chunk.message || \"Stream error.\"),\n          chunk,\n        );\n      }\n\n      if (chunk.type === \"done\" || shouldContinue === false) {\n        await callDone();\n        return;\n      }\n    }\n\n    await callDone();\n  } catch (error) {\n    const normalized = toError(error);\n    await handlers.onError?.(normalized);\n    throw normalized;\n  }\n}\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":"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","names":[]}
+{"version":3,"sources":["../src/browser.ts","../src/client/consume-stream.ts","../src/client/read-stream.ts","../src/client/stream-from-route.ts","../src/structured/apply-structured-chunk.ts","../src/structured/structured-stream-accumulator.ts"],"sourcesContent":["// Browser-safe exports for client bundles.\n// Keep this file free of Node-only imports (fs, path, etc).\n\nexport type { ConsumeStreamHandlers } from \"./client/consume-stream\";\nexport { consumeStream } from \"./client/consume-stream\";\nexport { readStream } from \"./client/read-stream\";\nexport type { StreamFromRouteArgs } from \"./client/stream-from-route\";\nexport { streamFromRoute } from \"./client/stream-from-route\";\nexport * from \"./structured/apply-structured-chunk\";\nexport * from \"./structured/structured-stream-accumulator\";\nexport type { StreamChunk } from \"./types/stream-chunk\";\nexport type { StructuredDataChunk } from \"./types/structured-data\";\n","import type { StreamChunk } from \"../types/stream-chunk\";\n\nexport interface ConsumeStreamHandlers {\n  onChunk?: (\n    chunk: StreamChunk,\n  ) => undefined | boolean | Promise<boolean | undefined>;\n  onDone?: () => void | Promise<void>;\n  onError?: (error: Error, chunk?: StreamChunk) => void | Promise<void>;\n}\n\nconst toError = (value: unknown): Error =>\n  value instanceof Error ? value : new Error(String(value));\n\n/**\n * Consume a stream of StreamChunk events with callback handlers.\n * Returns when a `done` chunk is seen, the stream ends, or `onChunk` returns `false`.\n */\nexport async function consumeStream(\n  stream: AsyncIterable<StreamChunk>,\n  handlers: ConsumeStreamHandlers = {},\n): Promise<void> {\n  let doneCalled = false;\n\n  const callDone = async () => {\n    if (doneCalled) return;\n    doneCalled = true;\n    await handlers.onDone?.();\n  };\n\n  try {\n    for await (const chunk of stream) {\n      const shouldContinue = await handlers.onChunk?.(chunk);\n\n      if (chunk.type === \"error\") {\n        await handlers.onError?.(\n          new Error(chunk.message || \"Stream error.\"),\n          chunk,\n        );\n      }\n\n      if (chunk.type === \"done\" || shouldContinue === false) {\n        await callDone();\n        return;\n      }\n    }\n\n    await callDone();\n  } catch (error) {\n    const normalized = toError(error);\n    await handlers.onError?.(normalized);\n    throw normalized;\n  }\n}\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","import type { StructuredDataChunk } from \"../types/structured-data\";\n\nexport type StructuredStreamState<TData = unknown> = {\n  streamId: string;\n  dataType: string;\n  status: \"streaming\" | \"done\";\n  data: TData;\n  node?: string;\n  id?: string;\n  schemaId?: string;\n  schemaVersion?: string;\n};\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst isArrayIndex = (value: string): boolean => /^\\d+$/.test(value);\n\nconst describeValue = (value: unknown): string => {\n  if (value === null) return \"null\";\n  if (Array.isArray(value)) return \"array\";\n  return typeof value;\n};\n\nconst parsePath = (path: string): string[] => {\n  if (path.length === 0) {\n    throw new Error(\n      \"Structured chunk path must be a non-empty dot-separated string.\",\n    );\n  }\n\n  const parts = path.split(\".\");\n  if (parts.some((part) => part.length === 0)) {\n    throw new Error(\n      `Structured chunk path \"${path}\" must not contain empty segments.`,\n    );\n  }\n\n  return parts;\n};\n\nconst cloneContainerForPart = (args: {\n  current: unknown;\n  part: string;\n  path: string;\n  traversed: string[];\n}): Record<string, unknown> | unknown[] => {\n  const expected = isArrayIndex(args.part) ? \"array\" : \"object\";\n  const location =\n    args.traversed.length === 0 ? \"<root>\" : args.traversed.join(\".\");\n\n  if (args.current === undefined) {\n    return expected === \"array\" ? [] : {};\n  }\n\n  if (expected === \"array\") {\n    if (Array.isArray(args.current)) return [...args.current];\n    throw new Error(\n      `Structured path conflict at ${location} for \"${args.path}\": expected array container, received ${describeValue(args.current)}.`,\n    );\n  }\n\n  if (isPlainObject(args.current)) return { ...args.current };\n\n  throw new Error(\n    `Structured path conflict at ${location} for \"${args.path}\": expected object container, received ${describeValue(args.current)}.`,\n  );\n};\n\nconst updateByParts = (args: {\n  input: unknown;\n  parts: string[];\n  path: string;\n  updateLeaf: (current: unknown) => unknown;\n  traversed?: string[];\n}): unknown => {\n  const traversed = args.traversed ?? [];\n  const [part, ...rest] = args.parts;\n  if (part === undefined) {\n    return args.updateLeaf(args.input);\n  }\n\n  const container = cloneContainerForPart({\n    current: args.input,\n    part,\n    path: args.path,\n    traversed,\n  });\n\n  const currentChild = Array.isArray(container)\n    ? container[Number(part)]\n    : container[part];\n  const nextChild =\n    rest.length === 0\n      ? args.updateLeaf(currentChild)\n      : updateByParts({\n          input: currentChild,\n          parts: rest,\n          path: args.path,\n          updateLeaf: args.updateLeaf,\n          traversed: [...traversed, part],\n        });\n\n  if (Array.isArray(container)) {\n    container[Number(part)] = nextChild;\n  } else {\n    container[part] = nextChild;\n  }\n\n  return container;\n};\n\nexport function applyStructuredChunk<TData = unknown>(\n  current: StructuredStreamState<TData> | undefined,\n  chunk: StructuredDataChunk,\n): StructuredStreamState<TData> {\n  if (current && current.streamId !== chunk.streamId) {\n    throw new Error(\n      `Structured chunk streamId mismatch: expected ${current.streamId}, received ${chunk.streamId}.`,\n    );\n  }\n\n  if (current?.status === \"done\") {\n    throw new Error(\n      `Structured stream ${chunk.streamId} already completed with a final chunk.`,\n    );\n  }\n\n  const nextBase = {\n    streamId: chunk.streamId,\n    dataType: chunk.dataType,\n    status: chunk.kind === \"final\" ? (\"done\" as const) : (\"streaming\" as const),\n    ...(chunk.node ? { node: chunk.node } : {}),\n    ...(chunk.id ? { id: chunk.id } : {}),\n    ...(chunk.schemaId ? { schemaId: chunk.schemaId } : {}),\n    ...(chunk.schemaVersion ? { schemaVersion: chunk.schemaVersion } : {}),\n  };\n\n  if (chunk.kind === \"final\") {\n    return {\n      ...nextBase,\n      data: chunk.data as TData,\n    };\n  }\n\n  const path = chunk.path;\n  const pathParts = parsePath(path);\n  const previousData = current?.data;\n\n  if (chunk.kind === \"set\") {\n    return {\n      ...nextBase,\n      data: updateByParts({\n        input: previousData,\n        parts: pathParts,\n        path,\n        updateLeaf: () => chunk.value,\n      }) as TData,\n    };\n  }\n\n  if (chunk.kind === \"append\") {\n    return {\n      ...nextBase,\n      data: updateByParts({\n        input: previousData,\n        parts: pathParts,\n        path,\n        updateLeaf: (existing) => {\n          if (existing === undefined) return [...chunk.items];\n          if (!Array.isArray(existing)) {\n            throw new Error(\n              `Structured append requires path \"${path}\" to target an array, received ${describeValue(existing)}.`,\n            );\n          }\n          return [...existing, ...chunk.items];\n        },\n      }) as TData,\n    };\n  }\n\n  return {\n    ...nextBase,\n    data: updateByParts({\n      input: previousData,\n      parts: pathParts,\n      path,\n      updateLeaf: (existing) => {\n        if (existing === undefined) return chunk.delta;\n        if (typeof existing !== \"string\") {\n          throw new Error(\n            `Structured text-delta requires path \"${path}\" to target a string, received ${describeValue(existing)}.`,\n          );\n        }\n        return existing + chunk.delta;\n      },\n    }) as TData,\n  };\n}\n\nexport function reduceStructuredChunks<TData = unknown>(\n  chunks: StructuredDataChunk[],\n): Record<string, StructuredStreamState<TData>> {\n  return chunks.reduce<Record<string, StructuredStreamState<TData>>>(\n    (acc, chunk) => {\n      acc[chunk.streamId] = applyStructuredChunk(acc[chunk.streamId], chunk);\n      return acc;\n    },\n    {},\n  );\n}\n","import type { StreamChunk } from \"../types/stream-chunk\";\nimport type { StructuredDataChunk } from \"../types/structured-data\";\nimport {\n  applyStructuredChunk,\n  type StructuredStreamState,\n} from \"./apply-structured-chunk\";\n\nexport type StructuredStreamAccumulator<TData = unknown> = {\n  apply: (chunk: StructuredDataChunk) => StructuredStreamState<TData>;\n  applyStreamChunk: (\n    chunk: StreamChunk,\n  ) => StructuredStreamState<TData> | undefined;\n  get: (streamId: string) => StructuredStreamState<TData> | undefined;\n  has: (streamId: string) => boolean;\n  delete: (streamId: string) => boolean;\n  clear: () => void;\n  size: () => number;\n  entries: () => Array<[string, StructuredStreamState<TData>]>;\n  values: () => StructuredStreamState<TData>[];\n  toRecord: () => Record<string, StructuredStreamState<TData>>;\n};\n\nconst isStructuredDataChunk = (\n  chunk: StreamChunk,\n): chunk is StructuredDataChunk => chunk.type === \"structured-data\";\n\nexport function createStructuredStreamAccumulator<TData = unknown>(\n  initialChunks: Iterable<StructuredDataChunk> = [],\n): StructuredStreamAccumulator<TData> {\n  const states = new Map<string, StructuredStreamState<TData>>();\n\n  const apply = (chunk: StructuredDataChunk): StructuredStreamState<TData> => {\n    const nextState = applyStructuredChunk(states.get(chunk.streamId), chunk);\n    states.set(chunk.streamId, nextState);\n    return nextState;\n  };\n\n  for (const chunk of initialChunks) {\n    apply(chunk);\n  }\n\n  return {\n    apply,\n    applyStreamChunk: (chunk) => {\n      if (!isStructuredDataChunk(chunk)) return undefined;\n      return apply(chunk);\n    },\n    get: (streamId) => states.get(streamId),\n    has: (streamId) => states.has(streamId),\n    delete: (streamId) => states.delete(streamId),\n    clear: () => {\n      states.clear();\n    },\n    size: () => states.size,\n    entries: () => Array.from(states.entries()),\n    values: () => Array.from(states.values()),\n    toRecord: () => Object.fromEntries(states.entries()),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,22 +1,11 @@
-import { S as StreamChunk } from './browser-ojdAqLMO.js';
-export { C as ConsumeStreamHandlers, a as StreamChunkSchema, b as StreamFromRouteArgs, c as consumeStream, r as readStream, s as streamFromRoute } from './browser-ojdAqLMO.js';
+import { S as StreamChunk, a as StructuredDataChunk } from './browser-DBfCMmkm.js';
+export { C as ConsumeStreamHandlers, b as StreamChunkSchema, c as StreamFromRouteArgs, d as StructuredDataChunkSchema, e as StructuredStreamAccumulator, f as StructuredStreamState, g as applyStructuredChunk, h as consumeStream, i as createStructuredStreamAccumulator, r as readStream, j as reduceStructuredChunks, s as streamFromRoute } from './browser-DBfCMmkm.js';
 import 'zod';
 
-type StructuredStreamChunk = {
-    type: "structured-data";
-    data: unknown;
-    dataType?: string;
-    mode?: "final" | "patch" | "snapshot";
-    schemaId?: string;
-    schemaVersion?: string;
-    id?: string;
-    opId?: string;
-    node?: string;
-};
 interface BufferedStreamResult {
     chunks: StreamChunk[];
     text: string;
-    structured: StructuredStreamChunk[];
+    structured: StructuredDataChunk[];
 }
 /**
  * Derive convenient buffered fields from raw chunks.
@@ -51,4 +40,4 @@ declare function createStreamResponse(stream: AsyncIterable<StreamChunk>): Respo
  */
 declare function toSSE(stream: AsyncIterable<StreamChunk>): Response;
 
-export { type BufferedStreamResult, STREAM_HEADERS, StreamChunk, type StructuredStreamChunk, collectBufferedStream, collectStream, createStreamResponse, summarizeStreamChunks, toSSE };
+export { type BufferedStreamResult, STREAM_HEADERS, StreamChunk, StructuredDataChunk, collectBufferedStream, collectStream, createStreamResponse, summarizeStreamChunks, toSSE };