@qorejs/qore 1.0.6 → 2.0.0

package/MIGRATION.md

@@ -0,0 +1,124 @@
+# Qore Migration Notes
+
+## `1.x` -> `2.0.0`
+
+Qore 2 narrows the default entrypoint to the stream runtime. This is a breaking
+import-path change; stream accumulation and lifecycle behavior are preserved.
+
+```ts
+// 1.x
+import { stream, signal, h, mount, createOpenAI, createSSEResponse } from '@qorejs/qore';
+
+// 2.x
+import { stream } from '@qorejs/qore';
+import { signal } from '@qorejs/qore/signals';
+import { h, mount } from '@qorejs/qore/dom';
+import { createOpenAI } from '@qorejs/qore/providers';
+import { createSSEResponse } from '@qorejs/qore/server';
+```
+
+| Previous root exports | New import |
+| --- | --- |
+| `signal`, `computed`, `effect`, `batch`, `untrack`, `isSignal`, `createRoot`, `onCleanup`; `Signal`, `ComputedSignal`, effect types | `@qorejs/qore/signals` |
+| `h`, `text`, `fragment`, `dynamic`, `show`, `list`, `mount`, `renderResponse`, `createApp`, DOM guards and DOM types | `@qorejs/qore/dom` |
+| All vendor/generic provider factories, metadata helpers and provider types | `@qorejs/qore/providers` |
+| `createSSEResponse`, `CreateSSEResponseOptions`, `SSEFrame` | `@qorejs/qore/server` |
+| Stream/response APIs, inspection, `ReadonlySignal`, `SubscribeOptions`, shared utilities | remain at `@qorejs/qore` |
+
+React hooks now ship in the same package:
+
+```tsx
+import { useQoreStream, useQoreSignalSelector } from '@qorejs/qore/react';
+```
+
+Install React 18.2+ in React applications. React is an optional peer and is not
+required when using only the core, DOM, signals, providers or server entrypoints.
+The separate `@qorejs/react` package is not required. If migrating repository-local
+usage of that unpublished package, replace its imports with `@qorejs/qore/react`.
+
+Use your host framework's lifecycle to unsubscribe observers and abort streams
+owned by the component. The managed React hook does this automatically. Observing
+an externally owned stream with the snapshot hook does not abort it on unmount.
+
+The internal signal engine and optional DOM behavior are retained. This release
+does not remove the underlying reactive implementation, add Qore DOM SSR/hydration,
+or change total history retention. `maxItems` bounds collection values only.
+
+
+This document tracks the public migration surface for `@qorejs/qore`.
+
+## `0.7.x` -> `0.8.x`
+
+### Runtime and Packaging
+
+- The package is now TypeScript-first in `src/` and publishes compiled output from `dist/src`.
+- The public DOM aliases were normalized around standard DOM types while keeping legacy `Global*` aliases available.
+- The release pipeline now treats package smoke, browser regression, and dist-sync checks as release gates.
+
+### Stream Runtime
+
+- `QoreStream` lifecycle state is exposed through read-only signals.
+- `status`, `error`, `chunks`, `startedAt`, and `finishedAt` should now be treated as immutable views.
+- If user code was mutating these fields directly, it must move to runtime APIs like `abort()` or a new stream instance.
+
+### Scheduling
+
+- `effect(...)` scheduling is now an explicit part of the runtime surface.
+- Supported scheduler modes:
+  - `sync`
+  - `microtask`
+  - `raf`
+  - custom scheduler function
+
+## `0.8.x` -> `0.9.0`
+
+### New Stable Runtime Surface
+
+The following public APIs were added and are intended to remain on the stable track:
+
+- `createRoot(...)`
+- `onCleanup(...)`
+- `createSSEResponse(...)`
+- `collectProviderMetadata(...)`
+- `mergeProviderMetadata(...)`
+- `extractOpenAIMetadata(...)`
+- `extractAnthropicMetadata(...)`
+- `extractOpenRouterMetadata(...)`
+- `extractDeepSeekMetadata(...)`
+- `extractOllamaMetadata(...)`
+
+### Stream Composition
+
+Qore now exposes a broader orchestration layer:
+
+- `stream.merge(...)`
+- `stream.concat(...)`
+- `stream.pipe(...)`
+- `stream.race(...)`
+- `stream.retryable(...)`
+- `stream.switchMap(...)`
+
+If earlier code implemented these patterns manually around `for await...of` loops, it can usually simplify into the built-in stream helpers.
+
+### Browser Boundary
+
+The DOM layer is explicitly browser-only in the `0.9.x` line.
+
+- `signal`, `stream`, providers, and server helpers work in Node and the browser
+- `h`, `text`, `dynamic`, `list`, `mount`, and `createApp(...).mount(...)` require a browser-like `document`
+- `assertCanUseDOM(...)` and `canUseDOM()` are the supported guards for branching
+
+### SSR and Hydration
+
+There is no stable SSR or hydration support in `0.9.x`.
+
+If an integration previously assumed partial SSR support, it should treat that assumption as unsupported and move DOM entrypoints behind a browser/runtime guard.
+
+## `1.0.0-rc`
+
+Expected RC rules:
+
+- no casual public API additions
+- no silent semantics changes in stream lifecycle behavior
+- no ambiguous SSR or hydration claims
+- any public API surface change must update the frozen API snapshot and release notes intentionally

package/README.md

@@ -20,42 +20,45 @@ npm i @qorejs/qore
 ## 30-Second Demo
 
 ```js
-import { createSSEResponse, h, mount, stream, text } from '@qorejs/qore';
-
-// Server: expose your provider as SSE.
-export function handler() {
-  return createSSEResponse(async function* () {
-    yield 'stream';
-    yield ' = ';
-    yield 'signal';
-  }());
-}
+import { stream } from '@qorejs/qore';
 
-// Browser: consume the stream as one reactive value.
-const answer = stream(fetch('/api/chat').then((response) => response.body));
+const answer = stream(['stream', ' = ', 'signal']);
+const unsubscribe = answer.subscribe((value) => console.log(value));
 
-mount('#app', () =>
-  h('main', {}, text(() => answer()))
-);
+await answer.ready;
+console.log(answer(), answer.status());
+unsubscribe();
 ```
 
-`answer` is a readonly signal and an async iterable. The UI reads `answer()`, and Qore updates only the DOM node that depends on it.
+`answer` is a readonly signal and an async iterable. Use `answer()` or
+`answer.peek()` to read its current value, and `answer.subscribe(...)` to observe
+updates. Your UI framework owns rendering and component lifecycle.
 
-## Why Qore
+## Package Entrypoints
 
-React/Vercel AI SDK:
+Qore 2 separates the stream runtime from optional integrations. These are explicit
+subpath imports within one versioned package; importing the core does not load
+React, the DOM renderer, or provider adapters.
 
-```text
-Token -> Hook state -> Component render -> Reconcile
-```
+| Import | Purpose |
+| --- | --- |
+| `@qorejs/qore` | streams, response lifecycle, readonly contracts, inspection |
+| `@qorejs/qore/react` | React hooks; requires React 18.2+ |
+| `@qorejs/qore/dom` | optional standalone browser renderer |
+| `@qorejs/qore/signals` | optional mutable signals, effects and ownership scopes |
+| `@qorejs/qore/providers` | provider protocol adapters for trusted runtimes |
+| `@qorejs/qore/server` | server-side SSE response helper |
 
-Qore:
+Upgrading from 1.x requires moving imports: see [migration notes](./MIGRATION.md).
+The internal reactive engine remains shared with the optional integrations; this
+release narrows the public core without rewriting stream scheduling semantics.
 
-```text
-Token -> Stream signal -> Text node
-```
+## Why Qore
 
-That is the core difference. Qore is not trying to be another AI SDK. It is the runtime layer that makes streamed data reactive.
+Qore brings accumulation, events, cancellation, errors and backpressure into one
+stream lifecycle. Existing frameworks can consume that state through their own
+renderers. React subscriptions still render React components; direct text-node
+updates apply specifically to the optional DOM renderer.
 
 ## Event Streams
 
@@ -69,22 +72,49 @@ const text = events.select('text', {
   reduce: (current, event) => current + event.text
 });
 const tools = events.select('tool_call');
-const status = events.select('status');
+const status = events.select('status', { maxItems: 20 });
 const diff = events.select('diff');
 ```
 
-Each selected stream is still a signal and an async iterable. A timeline can render every event, while a markdown pane can bind only to `text()`. The runnable shape is captured in [`examples/agent-event-stream.ts`](./examples/agent-event-stream.ts).
+Each selected stream is still a signal and an async iterable. A timeline can render every event, while a markdown pane can bind only to `text()`. Use `maxItems` on the full timeline or selected timelines when an agent can run for minutes. The runnable shape is captured in [`examples/agent-event-stream.ts`](./examples/agent-event-stream.ts), with focused examples for [`streaming-markdown-diff`](./examples/streaming-markdown-diff.ts) and [`server-sse-to-qore-client`](./examples/server-sse-to-qore-client.ts).
 
+## Structured Output
 
-## React Adapter
+Structured AI output should also flow through the same runtime path:
+
+```ts
+const result = stream.json<{ title: string; items: string[] }>(provider.chat(prompt));
+
+result(); // null until valid JSON is available, then the parsed object
+```
 
-Qore can be used inside React without replacing your UI stack. The release-ready adapter lives in [`packages/react`](./packages/react) and subscribes to Qore streams through React's external store contract, so the stream remains the source of truth while React renders the view.
+For line-delimited event streams, use the same idea per line:
+
+```ts
+const events = stream.ndjson<{ type: string; value: unknown }>(fetch('/api/events').then((r) => r.body));
+
+events(); // accumulated structured events
+```
+
+Use `validate` when you want a typed guard before publishing parsed output into UI state. Invalid JSON or NDJSON fails through the normal stream lifecycle instead of becoming hidden glue code.
+
+For long-running feeds, bound only the signal window while keeping the stream lifecycle and async iteration intact:
+
+```ts
+const timeline = stream.ndjson(agent.events(), { maxItems: 200 });
+```
+
+
+## React Adapter
 
-> Status: `@qorejs/react` is release-ready in this repository, but npm publishing is still waiting on `@qorejs/react` package access for the `@qorejs` scope. The adapter smoke test passes; the package will be announced as published only after npm accepts it.
+The React adapter ships at `@qorejs/qore/react` in the core package. Install
+React in your application; it is an optional peer dependency for Qore. The adapter
+uses React's external store contract and owns cancellation on unmount or dependency
+changes. The separate `@qorejs/react` package is not required.
 
 ```tsx
 import { stream } from '@qorejs/qore';
-import { useQoreStream } from '@qorejs/react';
+import { useQoreStream } from '@qorejs/qore/react';
 
 function Answer({ prompt }) {
   const answer = useQoreStream(
@@ -101,7 +131,7 @@ See [React Adapter](./docs/react.md) for lifecycle, status, abort, and signal su
 
 ## Provider Safety
 
-Provider adapters are intended for server-side or trusted runtimes. Do not put `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or any vendor secret in browser code. For browsers, expose your own SSE or NDJSON endpoint and stream that endpoint into Qore.
+Provider adapters are intended for server-side or trusted runtimes. Do not put `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or any vendor secret in browser code. For browsers, expose your own SSE or NDJSON endpoint and stream that endpoint into Qore. See [`examples/server-sse-to-qore-client.ts`](./examples/server-sse-to-qore-client.ts) for the recommended boundary.
 
 ## Inspect Streams
 
@@ -139,14 +169,14 @@ The inspector is zero-dependency and built on the same `__QORE_DEVTOOLS__` hook
 | --- | --- | --- |
 | Node runtime | Supported | `Node >= 18` |
 | Browser runtime | Supported | DOM entrypoints require `document` |
-| Reactive core | Supported | `signal`, `computed`, `effect`, `batch`, `createRoot`, `onCleanup` |
-| Stream runtime | Supported | backpressure, retry, orchestration, async iteration, abort, and DevTools hooks |
-| Provider adapters | Supported | OpenAI, Anthropic, OpenRouter, DeepSeek, Ollama, generic SSE, generic line-stream |
-| Browser DOM layer | Supported | `h`, `text`, `dynamic`, `list`, `mount`, `createApp(...).mount(...)` |
-| React adapter | Release-ready | `packages/react` bridges Qore streams through `useSyncExternalStore`; npm publishing is waiting on scope access |
+| Optional signals | `@qorejs/qore/signals` | `signal`, `computed`, `effect`, `batch`, `createRoot`, `onCleanup` |
+| Stream runtime | Supported | backpressure, bounded collections, retry, orchestration, structured JSON/NDJSON, async iteration, abort, and DevTools hooks |
+| Provider adapters | `@qorejs/qore/providers` | OpenAI, Anthropic, OpenRouter, DeepSeek, Ollama, generic SSE, generic line-stream |
+| Browser DOM layer | `@qorejs/qore/dom` | `h`, `text`, `dynamic`, `list`, `mount`, `createApp(...).mount(...)` |
+| React adapter | `@qorejs/qore/react` | cached external-store snapshots; React owns rendering |
 | Published package maps | Supported | JavaScript source maps and declaration maps ship in `dist/src` |
-| SSR | Not supported | explicit browser-only DOM boundary in `1.0.x` |
-| Hydration | Not supported | deferred until a fully proven implementation exists |
+| SSR | Host framework | React hooks supply server snapshots; the optional DOM renderer is browser-only |
+| Hydration | Host framework | no Qore DOM hydration implementation |
 
 ## Provider Support Matrix
 

package/README.zh-CN.md

@@ -1,8 +1,7 @@
 # Qore
 
-Qore 是一个面向 AI 原生界面的 reactive stream runtime。
-
-它的核心原语是 `stream = signal`：异步流本身也是一条只读 signal，所以 token、tool event、状态、markdown 片段和 diff 都可以直接进入 UI 状态。
+Qore 是面向 AI 原生界面的 reactive stream runtime。核心原语是 `stream = signal`：
+同一条流提供当前值、订阅、异步迭代，以及完成、错误和取消状态。
 
 ## 安装
 
@@ -13,17 +12,30 @@ npm i @qorejs/qore
 ## 最小示例
 
 ```js
-import { h, mount, stream, text } from '@qorejs/qore';
-
-const answer = stream(model.chat('hello'));
+import { stream } from '@qorejs/qore';
 
-mount('#app', () =>
-  h('main', {}, text(() => answer()))
-);
+const answer = stream(['你好', '，Qore']);
+const unsubscribe = answer.subscribe(console.log);
+await answer.ready;
+unsubscribe();
 ```
 
-`answer()` 返回当前累积内容。UI 会随着 stream 更新，且只更新读取这条 signal 的节点。
+## 2.0 的边界
+
+默认入口只提供流运行时。应用继续使用原有框架的组件、渲染和生命周期。
+
+| 入口 | 用途 |
+| --- | --- |
+| `@qorejs/qore` | 流、响应生命周期、只读状态契约、检查工具 |
+| `@qorejs/qore/react` | React hooks，需应用安装 React 18.2+ |
+| `@qorejs/qore/dom` | 可选的独立页面 DOM 渲染器 |
+| `@qorejs/qore/signals` | 可选的 signal、computed、effect 等工具 |
+| `@qorejs/qore/providers` | Provider 协议适配 |
+| `@qorejs/qore/server` | 服务端 SSE 输出 |
 
-## 文档
+这些是同一个 npm 包的独立子入口。只导入核心不会加载 React、DOM 层或 Provider。
+内部响应式引擎仍然保留并共享，流的行为未在这次拆分中重写。
+React 适配器仍通过 React 渲染组件；直接更新文本节点是可选 DOM 层的行为。
 
-主 README 以英文为主。中文文档入口在官网 `/zh/`。
+从 1.x 升级需要调整导入路径，详见 [迁移说明](./MIGRATION.md)。
+完整 API 和示例见 [英文 README](./README.md) 与 [React 文档](./docs/react.md)。

package/dist/src/core/response-types.d.ts

@@ -6,8 +6,12 @@ export type GlobalAbortSignal = typeof globalThis extends {
 } ? T extends {
     prototype: infer P;
 } ? P : unknown : {
-    aborted: boolean;
-    reason?: unknown;
+    readonly aborted: boolean;
+    readonly reason?: unknown;
+    addEventListener(type: 'abort', listener: () => void, options?: {
+        once?: boolean;
+    }): void;
+    removeEventListener(type: 'abort', listener: () => void): void;
 };
 export interface ResponseSnapshot<TChunk = unknown, TValue = unknown> {
     status: ResponseStatus;

package/dist/src/core/response-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-types.d.ts","sourceRoot":"","sources":["../../../src/core/response-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"response-types.d.ts","sourceRoot":"","sources":["../../../src/core/response-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAClG,MAAM,MAAM,iBAAiB,GAAG,OAAO,UAAU,SAAS;IAAE,WAAW,EAAE,MAAM,CAAC,CAAA;CAAE,GAC9E,CAAC,SAAS;IAAE,SAAS,EAAE,MAAM,CAAC,CAAA;CAAE,GAC9B,CAAC,GACD,OAAO,GACT;IACE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1F,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAChE,CAAC;AAEN,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IAClE,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAElF,MAAM,WAAW,qBAAqB,CAAC,MAAM,EAAE,MAAM;IACnD,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB,CAAC,MAAM,EAAE,MAAM;IACpD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB,CAAC,MAAM,EAAE,MAAM;IACrD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,QAAQ,IAAI,MAAM,CAAC;IACnB,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACvC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,qBAAqB,CAAC,MAAM,EAAE,MAAM,IAAI,CAClD,OAAO,EAAE,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5C,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAEtC,MAAM,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,GAAG,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExG,MAAM,WAAW,qBAAqB,CAAC,MAAM,EAAE,MAAM;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACxE;AAED,MAAM,WAAW,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,CAAE,SAAQ,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC;IAC9G,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,QAAQ,IAAI,MAAM,CAAC;IACnB,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACvC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,GAAG,CACD,QAAQ,EAAE,CAAC,OAAO,EAAE,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,EACrF,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,GACnC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvG,QAAQ,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtG,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CAC5E"}

package/dist/src/core/stream-types.d.ts

@@ -30,8 +30,21 @@ export type StreamEventType<TEvent extends StreamEventBase> = TEvent['type'] & s
 export type StreamEventOf<TEvent extends StreamEventBase, TType extends StreamEventType<TEvent>> = Extract<TEvent, {
     type: TType;
 }>;
-export type StreamEventOptions<TEvent extends StreamEventBase> = Omit<StreamOptions<TEvent, TEvent[]>, 'seed' | 'reduce'>;
+export type StreamEventOptions<TEvent extends StreamEventBase> = Omit<StreamCollectionOptions<TEvent>, 'seed' | 'reduce'>;
+export interface StreamCollectionOptions<TChunk> extends StreamOptions<TChunk, TChunk[]> {
+    maxItems?: number;
+}
+export interface StructuredStreamOptions<TValue> extends Omit<StreamOptions<TValue, TValue | null>, 'seed' | 'reduce'> {
+    seed?: TValue | null;
+    parse?: (text: string) => TValue;
+    validate?: (value: unknown) => value is TValue;
+}
+export interface StructuredLineStreamOptions<TValue> extends Omit<StreamCollectionOptions<TValue>, 'reduce'> {
+    parse?: (text: string) => TValue;
+    validate?: (value: unknown) => value is TValue;
+}
 export type StreamSelectOptions<TEvent extends StreamEventBase, TValue> = StreamOptions<TEvent, TValue>;
+export type StreamSelectCollectionOptions<TEvent extends StreamEventBase> = StreamCollectionOptions<TEvent>;
 export interface RetryableStreamOptions<TChunk = unknown, TValue = string> extends StreamOptions<TChunk, TValue> {
     maxRetries?: number;
     backoff?: RetryBackoff;
@@ -69,6 +82,7 @@ export interface QoreStream<TChunk = unknown, TValue = string> extends ReadonlyS
 }
 export interface QoreEventStream<TEvent extends StreamEventBase = StreamEventBase> extends QoreStream<TEvent, TEvent[]> {
     select<TType extends StreamEventType<TEvent>>(type: TType): QoreStream<StreamEventOf<TEvent, TType>, Array<StreamEventOf<TEvent, TType>>>;
+    select<TType extends StreamEventType<TEvent>>(type: TType, options: StreamSelectCollectionOptions<StreamEventOf<TEvent, TType>>): QoreStream<StreamEventOf<TEvent, TType>, Array<StreamEventOf<TEvent, TType>>>;
     select<TType extends StreamEventType<TEvent>, TValue>(type: TType, options: StreamSelectOptions<StreamEventOf<TEvent, TType>, TValue>): QoreStream<StreamEventOf<TEvent, TType>, TValue>;
 }
 export interface StreamFactory {
@@ -78,8 +92,10 @@ export interface StreamFactory {
         delay?: number;
     }): QoreStream<TChunk, TValue>;
     text<TChunk = unknown>(sourceOrSetup: StreamInput<TChunk, string>, options?: StreamOptions<TChunk, string>): QoreStream<TChunk, string>;
-    list<TChunk>(sourceOrSetup: StreamInput<TChunk, TChunk[]>, options?: StreamOptions<TChunk, TChunk[]>): QoreStream<TChunk, TChunk[]>;
+    list<TChunk>(sourceOrSetup: StreamInput<TChunk, TChunk[]>, options?: StreamCollectionOptions<TChunk>): QoreStream<TChunk, TChunk[]>;
     latest<TChunk>(sourceOrSetup: StreamInput<TChunk, TChunk | null>, options?: StreamOptions<TChunk, TChunk | null>): QoreStream<TChunk, TChunk | null>;
+    json<TValue = unknown>(source: SourceLike<string>, options?: StructuredStreamOptions<TValue>): QoreStream<TValue, TValue | null>;
+    ndjson<TValue = unknown>(source: SourceLike<string>, options?: StructuredLineStreamOptions<TValue>): QoreStream<TValue, TValue[]>;
     events<TEvent extends StreamEventBase>(sourceOrSetup: StreamInput<TEvent, TEvent[]>, options?: StreamEventOptions<TEvent>): QoreEventStream<TEvent>;
     withBackpressure<TChunk = unknown, TValue = string>(sourceOrSetup: StreamInput<TChunk, TValue>, backpressure: number | BackpressureOptions, options?: StreamOptions<TChunk, TValue>): QoreStream<TChunk, TValue>;
     paced<TChunk = unknown, TValue = string>(sourceOrSetup: StreamInput<TChunk, TValue>, interval: number, options?: StreamOptions<TChunk, TValue>): QoreStream<TChunk, TValue>;

package/dist/src/core/stream-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-types.d.ts","sourceRoot":"","sources":["../../../src/core/stream-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stream-types.d.ts","sourceRoot":"","sources":["../../../src/core/stream-types.ts"],"names":[],"mappings":"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"}

package/dist/src/core/stream.d.ts

@@ -7,6 +7,6 @@ export declare function from<TChunk, TValue = string>(source: SourceLike<TChunk>
 export declare function mapStream<TInput, TOutput, TValue = string>(source: SourceLike<TInput>, mapper: (chunk: TInput, index: number) => MaybePromise<TOutput>, options?: StreamOptions<TOutput, TValue>): QoreStream<TOutput, TValue>;
 export declare function scanStream<TInput, TOutput>(source: SourceLike<TInput>, reducer: (currentValue: TOutput, chunk: TInput, index: number) => MaybePromise<TOutput>, seed: TOutput, options?: Omit<StreamOptions<TOutput, TOutput>, 'seed' | 'reduce'>): QoreStream<TOutput, TOutput>;
 export { createStream } from './stream-runtime.js';
-export type { BackpressureOptions, QoreEventStream, QoreStream, RetryBackoff, RetryableStreamOptions, StreamController, StreamEventBase, StreamEventOf, StreamEventOptions, StreamEventType, StreamFactory, StreamInput, StreamOptions, StreamSelectOptions, StreamSetup } from './stream-types.js';
+export type { BackpressureOptions, QoreEventStream, QoreStream, RetryBackoff, RetryableStreamOptions, StreamCollectionOptions, StreamController, StreamEventBase, StreamEventOf, StreamEventOptions, StreamEventType, StreamFactory, StreamInput, StreamOptions, StreamSelectCollectionOptions, StreamSelectOptions, StreamSetup, StructuredLineStreamOptions, StructuredStreamOptions } from './stream-types.js';
 export { toAsyncIterable } from './iterable.js';
 //# sourceMappingURL=stream.d.ts.map

package/dist/src/core/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAGV,UAAU,EAOV,aAAa,EAIb,aAAa,EACd,MAAM,mBAAmB,CAAC;AA0Q3B,eAAO,MAAM,MAAM,eAAgB,CAAC;AA0EpC,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAC1C,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAC1B,OAAO,GAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB5B;AAGD,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EACxD,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAC1B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,EAC/D,OAAO,GAAE,aAAa,CAAC,OAAO,EAAE,MAAM,CAAM,GAC3C,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAa7B;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EACxC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAC1B,OAAO,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,EACvF,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAM,GACrE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAmB9B;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAGV,UAAU,EAQV,aAAa,EAKb,aAAa,EAGd,MAAM,mBAAmB,CAAC;AAsX3B,eAAO,MAAM,MAAM,eAAgB,CAAC;AAwIpC,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAC1C,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAC1B,OAAO,GAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB5B;AAGD,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EACxD,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAC1B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,EAC/D,OAAO,GAAE,aAAa,CAAC,OAAO,EAAE,MAAM,CAAM,GAC3C,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAa7B;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EACxC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAC1B,OAAO,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,EACvF,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAM,GACrE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAmB9B;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACX,aAAa,EACb,6BAA6B,EAC7B,mBAAmB,EACnB,WAAW,EACX,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/src/core/stream.js

@@ -18,9 +18,9 @@ streamFactory.text = (sourceOrSetup, options = {}) => createStream(sourceOrSetup
 });
 // Convenience constructor for streams that accumulate every chunk into an array.
 streamFactory.list = (sourceOrSetup, options = {}) => createStream(sourceOrSetup, {
-    seed: [],
-    reduce: (currentValue, chunk) => [...currentValue, chunk],
-    ...options
+    ...options,
+    seed: trimCollection(options.seed ?? [], options.maxItems),
+    reduce: createCollectionReducer(options)
 });
 // Convenience constructor for streams that only expose the latest chunk as current value.
 streamFactory.latest = (sourceOrSetup, options = {}) => createStream(sourceOrSetup, {
@@ -28,10 +28,84 @@ streamFactory.latest = (sourceOrSetup, options = {}) => createStream(sourceOrSet
     reduce: (_, chunk) => chunk,
     ...options
 });
+streamFactory.json = (source, options = {}) => {
+    const { seed = null, parse = JSON.parse, validate, ...streamOptions } = options;
+    return createStream(async (controller) => {
+        let buffer = '';
+        let parsedOnce = false;
+        let lastParsedText = '';
+        let lastParseError = null;
+        for await (const chunk of toAsyncIterable(source)) {
+            if (controller.signal.aborted) {
+                break;
+            }
+            buffer += chunk;
+            const candidateText = buffer.trim();
+            try {
+                const parsed = parseStructuredValue(candidateText, parse, validate);
+                parsedOnce = true;
+                lastParseError = null;
+                if (candidateText !== lastParsedText) {
+                    lastParsedText = candidateText;
+                    await controller.push(parsed);
+                }
+            }
+            catch (error) {
+                lastParseError = error;
+            }
+        }
+        if (!controller.signal.aborted && (!parsedOnce || lastParseError !== null)) {
+            throw lastParseError instanceof Error
+                ? lastParseError
+                : new SyntaxError('Structured stream did not produce valid JSON.');
+        }
+    }, {
+        seed,
+        reduce: (_, chunk) => chunk,
+        ...streamOptions
+    });
+};
+streamFactory.ndjson = (source, options = {}) => {
+    const { seed = [], parse = JSON.parse, validate, maxItems, ...streamOptions } = options;
+    const collectionOptions = maxItems === undefined
+        ? { ...streamOptions, seed }
+        : { ...streamOptions, seed, maxItems };
+    return createStream(async (controller) => {
+        let buffer = '';
+        const publishLine = async (line) => {
+            const text = line.trim();
+            if (text.length === 0) {
+                return;
+            }
+            await controller.push(parseStructuredValue(text, parse, validate));
+        };
+        for await (const chunk of toAsyncIterable(source)) {
+            if (controller.signal.aborted) {
+                break;
+            }
+            buffer += chunk;
+            const lines = buffer.split(/\r?\n/);
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                if (controller.signal.aborted) {
+                    break;
+                }
+                await publishLine(line);
+            }
+        }
+        if (!controller.signal.aborted) {
+            await publishLine(buffer);
+        }
+    }, {
+        ...streamOptions,
+        seed: trimCollection(seed, maxItems),
+        reduce: createCollectionReducer(collectionOptions)
+    });
+};
 streamFactory.events = (sourceOrSetup, options = {}) => attachEventSelectors(createStream(sourceOrSetup, {
+    ...options,
     seed: [],
-    reduce: (currentValue, chunk) => [...currentValue, chunk],
-    ...options
+    reduce: createCollectionReducer(options)
 }));
 // Attach backpressure behavior without changing the reducer semantics.
 streamFactory.withBackpressure = (sourceOrSetup, backpressure, options = {}) => createStream(sourceOrSetup, {
@@ -180,10 +254,13 @@ function attachEventSelectors(events) {
     eventStream.select = function select(type, options) {
         let seen = 0;
         let drain = Promise.resolve();
-        const selectedOptions = options ?? {
-            seed: [],
-            reduce: (currentValue, chunk) => [...currentValue, chunk]
-        };
+        const selectedOptions = isCollectionSelectOptions(options)
+            ? {
+                ...options,
+                seed: trimCollection(options?.seed ?? [], options?.maxItems),
+                reduce: createCollectionReducer(options ?? {})
+            }
+            : options;
         return createStream(async (controller) => {
             const emitFrom = async (chunks) => {
                 while (seen < chunks.length && !controller.signal.aborted) {
@@ -214,6 +291,9 @@ function attachEventSelectors(events) {
     };
     return eventStream;
 }
+function isCollectionSelectOptions(options) {
+    return options === undefined || Array.isArray(options.seed) || 'maxItems' in options;
+}
 async function resolveRetryDelay(backoff, retry, error) {
     if (typeof backoff === 'function') {
         return Math.max(0, await backoff(retry, error));
@@ -227,6 +307,40 @@ async function resolveRetryDelay(backoff, retry, error) {
     }
     return Math.max(0, backoff);
 }
+function parseStructuredValue(text, parse, validate) {
+    const parsed = parse(text);
+    if (validate && !validate(parsed)) {
+        throw new TypeError('Structured stream value failed validation.');
+    }
+    return parsed;
+}
+function createCollectionReducer(options) {
+    return (currentValue, chunk, index) => {
+        const nextValue = options.reduce
+            ? options.reduce(currentValue, chunk, index)
+            : [...currentValue, chunk];
+        return trimCollection(nextValue, options.maxItems);
+    };
+}
+function trimCollection(items, maxItems) {
+    const normalizedMaxItems = normalizeMaxItems(maxItems);
+    if (normalizedMaxItems === null || items.length <= normalizedMaxItems) {
+        return items;
+    }
+    if (normalizedMaxItems === 0) {
+        return [];
+    }
+    return items.slice(items.length - normalizedMaxItems);
+}
+function normalizeMaxItems(maxItems) {
+    if (maxItems === undefined) {
+        return null;
+    }
+    if (!Number.isFinite(maxItems)) {
+        return null;
+    }
+    return Math.max(0, Math.floor(maxItems));
+}
 // Turn any iterable or async iterable into a stream, optionally adding source delay.
 export function from(source, options = {}) {
     const { delay = 0, ...streamOptions } = options;