stream-validate 0.1.0

package/README.md

@@ -0,0 +1,145 @@
+# stream-validate
+
+Progressive Zod validation for streaming LLM responses. Parse and validate JSON incrementally as it arrives chunk-by-chunk, emitting typed partial results as each field completes.
+
+## Install
+
+```bash
+npm install stream-validate zod
+```
+
+## Quick Start — `streamValidate` async generator
+
+```typescript
+import { z } from 'zod'
+import { streamValidate } from 'stream-validate'
+
+const schema = z.object({
+  name: z.string(),
+  age: z.number(),
+  address: z.object({ city: z.string() }),
+})
+
+// Any AsyncIterable<string> — e.g. an LLM streaming response
+async function* llmStream(): AsyncIterable<string> {
+  yield '{"name":"Al'
+  yield 'ice","age":30,"address":{"city":"NYC"}}'
+}
+
+for await (const partial of streamValidate(llmStream(), schema)) {
+  console.log(partial.data)       // DeepPartial<T> — fields filled in as they arrive
+  console.log(partial.meta)       // { "name": "complete", "age": "pending", ... }
+  console.log(partial.isComplete) // true when all required fields are validated
+  console.log(partial.seq)        // monotonically increasing sequence number
+  console.log(partial.elapsedMs)  // ms since validation started
+}
+```
+
+## Push-based API — `createStreamValidator`
+
+```typescript
+import { z } from 'zod'
+import { createStreamValidator } from 'stream-validate'
+
+const schema = z.object({ name: z.string(), score: z.number() })
+
+const validator = createStreamValidator(schema, {
+  validationErrorStrategy: 'skip', // 'skip' | 'include-invalid' | 'error'
+  timeoutMs: 5000,
+  onValidationError: (err) => console.error('Invalid field', err.path, err.message),
+  onParseError: (err) => console.error('Parse error', err.message),
+})
+
+// Subscribe to events
+const unsub = validator.on('partial', (partial) => {
+  console.log('Got partial:', partial.data)
+})
+
+validator.on('complete', (event) => {
+  console.log('Done:', event.isComplete, event.truncated, event.totalMs + 'ms')
+  console.log('Failed paths:', event.failedPaths)
+})
+
+// Push chunks as they arrive
+validator.write('{"name":"Bob"')
+validator.write(',"score":95}')
+validator.end() // flush and emit final complete event
+
+// Inspect current state at any time
+console.log(validator.current?.data)
+
+// Unsubscribe
+unsub()
+
+// Abort mid-stream (emits complete with truncated=true)
+validator.abort()
+```
+
+### Async iterator on validator
+
+```typescript
+const validator = createStreamValidator(schema)
+
+;(async () => {
+  for await (const partial of validator) {
+    console.log(partial.data)
+  }
+})()
+
+validator.write('{"name":"Charlie","score":88}')
+validator.end()
+```
+
+## API
+
+### `streamValidate<T>(stream, schema, options?)`
+
+| Parameter | Type | Description |
+|---|---|---|
+| `stream` | `AsyncIterable<string>` | Source of JSON chunks |
+| `schema` | `z.ZodSchema<T>` | Zod schema to validate against |
+| `options` | `StreamValidatorOptions` | Optional configuration |
+
+Returns `AsyncIterable<ValidatedPartial<T>>`.
+
+### `createStreamValidator<T>(schema, options?)`
+
+Returns a `StreamValidator<T>` with:
+
+- `write(chunk: string)` — push a new chunk
+- `end()` — signal end of stream
+- `abort(error?)` — cancel with truncated=true
+- `on('partial', fn)` — subscribe to partial updates; returns unsubscribe function
+- `on('complete', fn)` — subscribe to final completion event
+- `on('parse-error', fn)` — subscribe to JSON parse errors
+- `on('validation-error', fn)` — subscribe to Zod validation errors
+- `current` — getter for the latest `ValidatedPartial<T>` or `null`
+- `[Symbol.asyncIterator]()` — async iterate over partials
+
+### `StreamValidatorOptions`
+
+```typescript
+interface StreamValidatorOptions {
+  onParseError?: (err: StreamParseError) => void
+  onValidationError?: (err: StreamValidationError) => void
+  validationErrorStrategy?: 'skip' | 'include-invalid' | 'error'
+  timeoutMs?: number
+  signal?: AbortSignal
+}
+```
+
+### `ValidatedPartial<T>`
+
+```typescript
+interface ValidatedPartial<T> {
+  data: DeepPartial<T>    // partial object filled in so far
+  meta: FieldMeta         // per-field status: 'complete' | 'active' | 'pending' | 'error'
+  isComplete: boolean     // true when all required fields validated
+  seq: number             // monotonically increasing
+  elapsedMs: number       // ms since validator created
+}
+```
+
+## License
+
+MIT

package/dist/__tests__/parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parser.test.d.ts.map

package/dist/__tests__/parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/parser.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/parser.test.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const parser_1 = require("../parser");
+(0, vitest_1.describe)('IncrementalJsonParser', () => {
+    (0, vitest_1.it)('parses a simple object fed in 3 chunks', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        const fields = [
+            ...parser.feed('{"na'),
+            ...parser.feed('me":"Al'),
+            ...parser.feed('ice"}'),
+        ];
+        const nameField = fields.find(f => f.path === 'name');
+        (0, vitest_1.expect)(nameField).toBeDefined();
+        (0, vitest_1.expect)(nameField?.value).toBe('Alice');
+    });
+    (0, vitest_1.it)('parses two top-level fields from a single feed', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        const fields = parser.feed('{"a":1,"b":2}');
+        (0, vitest_1.expect)(fields.find(f => f.path === 'a')?.value).toBe(1);
+        (0, vitest_1.expect)(fields.find(f => f.path === 'b')?.value).toBe(2);
+    });
+    (0, vitest_1.it)('parses nested object and emits path for leaf field', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        const fields = parser.feed('{"addr":{"city":"NYC"}}');
+        (0, vitest_1.expect)(fields.find(f => f.path === 'addr.city')?.value).toBe('NYC');
+    });
+    (0, vitest_1.it)('parses boolean and null values', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        const fields = parser.feed('{"flag":true,"empty":null}');
+        (0, vitest_1.expect)(fields.find(f => f.path === 'flag')?.value).toBe(true);
+        (0, vitest_1.expect)(fields.find(f => f.path === 'empty')?.value).toBeNull();
+    });
+    (0, vitest_1.it)('parses numeric values', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        const fields = parser.feed('{"count":42,"ratio":3.14}');
+        (0, vitest_1.expect)(fields.find(f => f.path === 'count')?.value).toBe(42);
+        (0, vitest_1.expect)(fields.find(f => f.path === 'ratio')?.value).toBeCloseTo(3.14);
+    });
+    (0, vitest_1.it)('handles chunk boundary mid-key', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        const f1 = parser.feed('{"foo');
+        (0, vitest_1.expect)(f1).toHaveLength(0); // key incomplete
+        const f2 = parser.feed('":"bar"}');
+        const field = f2.find(f => f.path === 'foo');
+        (0, vitest_1.expect)(field?.value).toBe('bar');
+    });
+    (0, vitest_1.it)('handles chunk boundary mid-value', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        const f1 = parser.feed('{"x":"hel');
+        (0, vitest_1.expect)(f1).toHaveLength(0);
+        const f2 = parser.feed('lo"}');
+        (0, vitest_1.expect)(f2.find(f => f.path === 'x')?.value).toBe('hello');
+    });
+    (0, vitest_1.it)('end() flushes remaining content', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        parser.feed('{"z":99');
+        const fields = parser.end();
+        // After end with a complete-enough buffer
+        // The end() may or may not extract depending on completeness
+        // At minimum it should not throw
+        (0, vitest_1.expect)(Array.isArray(fields)).toBe(true);
+    });
+    (0, vitest_1.it)('emits position > 0 for fields', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        const fields = parser.feed('{"name":"Bob"}');
+        const field = fields.find(f => f.path === 'name');
+        (0, vitest_1.expect)(field).toBeDefined();
+        (0, vitest_1.expect)(field.position).toBeGreaterThan(0);
+    });
+    (0, vitest_1.it)('parses string with escaped quotes', () => {
+        const parser = new parser_1.IncrementalJsonParser();
+        const fields = parser.feed('{"msg":"say \\"hi\\""}');
+        (0, vitest_1.expect)(fields.find(f => f.path === 'msg')?.value).toBe('say "hi"');
+    });
+});
+//# sourceMappingURL=parser.test.js.map

package/dist/__tests__/parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.js","sourceRoot":"","sources":["../../src/__tests__/parser.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/stream-validate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stream-validate.test.d.ts.map

package/dist/__tests__/stream-validate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-validate.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/stream-validate.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/stream-validate.test.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const zod_1 = require("zod");
+const stream_validator_1 = require("../stream-validator");
+const stream_validate_1 = require("../stream-validate");
+// Helper: split string into individual characters as async iterable
+async function* charStream(s) {
+    for (const ch of s) {
+        yield ch;
+    }
+}
+// Helper: split string into chunks of given size
+async function* chunkStream(s, size) {
+    for (let i = 0; i < s.length; i += size) {
+        yield s.slice(i, i + size);
+    }
+}
+(0, vitest_1.describe)('createStreamValidator', () => {
+    (0, vitest_1.it)('emits partial events as fields complete', () => {
+        const schema = zod_1.z.object({ name: zod_1.z.string() });
+        const validator = (0, stream_validator_1.createStreamValidator)(schema);
+        const partials = [];
+        validator.on('partial', p => partials.push(p));
+        validator.write('{"name":"Alice"}');
+        validator.end();
+        const namePartial = partials.find(p => p?.data && p.data.name === 'Alice');
+        (0, vitest_1.expect)(namePartial).toBeDefined();
+    });
+    (0, vitest_1.it)('emits complete event after end()', () => {
+        const schema = zod_1.z.object({ x: zod_1.z.number() });
+        const validator = (0, stream_validator_1.createStreamValidator)(schema);
+        const completeEvents = [];
+        validator.on('complete', e => completeEvents.push(e));
+        validator.write('{"x":42}');
+        validator.end();
+        (0, vitest_1.expect)(completeEvents).toHaveLength(1);
+        const evt = completeEvents[0];
+        (0, vitest_1.expect)(evt.truncated).toBe(false);
+    });
+    (0, vitest_1.it)('reports isComplete=true after all required fields are received', () => {
+        const schema = zod_1.z.object({ name: zod_1.z.string(), age: zod_1.z.number() });
+        const validator = (0, stream_validator_1.createStreamValidator)(schema);
+        const partials = [];
+        validator.on('partial', p => partials.push(p));
+        validator.write('{"name":"Bob","age":30}');
+        validator.end();
+        const last = partials[partials.length - 1];
+        (0, vitest_1.expect)(last?.isComplete).toBe(true);
+    });
+    (0, vitest_1.it)('current getter returns latest partial', () => {
+        const schema = zod_1.z.object({ val: zod_1.z.string() });
+        const validator = (0, stream_validator_1.createStreamValidator)(schema);
+        (0, vitest_1.expect)(validator.current).toBeNull();
+        validator.write('{"val":"test"}');
+        (0, vitest_1.expect)(validator.current).not.toBeNull();
+        (0, vitest_1.expect)(validator.current.data.val).toBe('test');
+    });
+    (0, vitest_1.it)('abort() emits complete with truncated=true', () => {
+        const schema = zod_1.z.object({ name: zod_1.z.string() });
+        const validator = (0, stream_validator_1.createStreamValidator)(schema);
+        const completeEvents = [];
+        validator.on('complete', e => completeEvents.push(e));
+        validator.write('{"na');
+        validator.abort();
+        (0, vitest_1.expect)(completeEvents[0]?.truncated).toBe(true);
+    });
+    (0, vitest_1.it)('emits validation-error for wrong type with include-invalid strategy', () => {
+        const schema = zod_1.z.object({ count: zod_1.z.number() });
+        const validationErrors = [];
+        const validator = (0, stream_validator_1.createStreamValidator)(schema, {
+            validationErrorStrategy: 'include-invalid',
+            onValidationError: e => validationErrors.push(e),
+        });
+        validator.write('{"count":"not-a-number"}');
+        validator.end();
+        (0, vitest_1.expect)(validationErrors.length).toBeGreaterThan(0);
+    });
+    (0, vitest_1.it)('invokes onParseError callback for malformed JSON context', () => {
+        // The parser is resilient but we can test the callback is wired
+        const schema = zod_1.z.object({ x: zod_1.z.number() });
+        const onParseError = vitest_1.vi.fn();
+        const validator = (0, stream_validator_1.createStreamValidator)(schema, { onParseError });
+        // Feed valid JSON — no parse error
+        validator.write('{"x":1}');
+        validator.end();
+        (0, vitest_1.expect)(onParseError).not.toHaveBeenCalled();
+    });
+    (0, vitest_1.it)('async iterator yields partials', async () => {
+        const schema = zod_1.z.object({ a: zod_1.z.string(), b: zod_1.z.number() });
+        const validator = (0, stream_validator_1.createStreamValidator)(schema);
+        const results = [];
+        const iterPromise = (async () => {
+            for await (const partial of validator) {
+                results.push(partial);
+            }
+        })();
+        validator.write('{"a":"hello","b":99}');
+        validator.end();
+        await iterPromise;
+        (0, vitest_1.expect)(results.length).toBeGreaterThan(0);
+    });
+    (0, vitest_1.it)('on() returns unsubscribe function', () => {
+        const schema = zod_1.z.object({ x: zod_1.z.string() });
+        const validator = (0, stream_validator_1.createStreamValidator)(schema);
+        const calls = [];
+        const unsub = validator.on('partial', p => calls.push(p));
+        validator.write('{"x":');
+        unsub();
+        validator.write('"hello"}');
+        validator.end();
+        // After unsub, no more events
+        (0, vitest_1.expect)(calls).toHaveLength(0);
+    });
+    (0, vitest_1.it)('timeoutMs causes truncated complete event', async () => {
+        const schema = zod_1.z.object({ slow: zod_1.z.string() });
+        const completeEvents = [];
+        const validator = (0, stream_validator_1.createStreamValidator)(schema, { timeoutMs: 10 });
+        validator.on('complete', e => completeEvents.push(e));
+        // Don't write anything — let timeout fire
+        await new Promise(r => setTimeout(r, 50));
+        (0, vitest_1.expect)(completeEvents[0]?.truncated).toBe(true);
+    });
+});
+(0, vitest_1.describe)('streamValidate', () => {
+    (0, vitest_1.it)('yields partials for single-field schema char by char', async () => {
+        const schema = zod_1.z.object({ name: zod_1.z.string() });
+        const input = '{"name":"Alice"}';
+        const results = [];
+        for await (const partial of (0, stream_validate_1.streamValidate)(charStream(input), schema)) {
+            results.push(partial);
+        }
+        const withName = results.find(r => r.data.name === 'Alice');
+        (0, vitest_1.expect)(withName).toBeDefined();
+    });
+    (0, vitest_1.it)('handles multi-field schema with chunked input', async () => {
+        const schema = zod_1.z.object({ first: zod_1.z.string(), last: zod_1.z.string() });
+        const input = '{"first":"John","last":"Doe"}';
+        const results = [];
+        for await (const partial of (0, stream_validate_1.streamValidate)(chunkStream(input, 5), schema)) {
+            results.push(partial);
+        }
+        const complete = results.find(r => r.isComplete);
+        (0, vitest_1.expect)(complete).toBeDefined();
+    });
+    (0, vitest_1.it)('yields seq numbers that increment', async () => {
+        const schema = zod_1.z.object({ a: zod_1.z.string(), b: zod_1.z.string() });
+        const input = '{"a":"x","b":"y"}';
+        const seqs = [];
+        for await (const partial of (0, stream_validate_1.streamValidate)(charStream(input), schema)) {
+            seqs.push(partial.seq);
+        }
+        // seqs should be non-empty and monotonically increasing
+        (0, vitest_1.expect)(seqs.length).toBeGreaterThan(0);
+        for (let i = 1; i < seqs.length; i++) {
+            (0, vitest_1.expect)(seqs[i]).toBeGreaterThanOrEqual(seqs[i - 1]);
+        }
+    });
+    (0, vitest_1.it)('elapsedMs is a non-negative number', async () => {
+        const schema = zod_1.z.object({ v: zod_1.z.number() });
+        const input = '{"v":7}';
+        for await (const partial of (0, stream_validate_1.streamValidate)(charStream(input), schema)) {
+            (0, vitest_1.expect)(partial.elapsedMs).toBeGreaterThanOrEqual(0);
+        }
+    });
+    (0, vitest_1.it)('meta marks received fields as complete', async () => {
+        const schema = zod_1.z.object({ city: zod_1.z.string() });
+        const input = '{"city":"Paris"}';
+        let lastPartial = null;
+        for await (const partial of (0, stream_validate_1.streamValidate)(charStream(input), schema)) {
+            lastPartial = partial;
+        }
+        (0, vitest_1.expect)(lastPartial?.meta?.city).toBe('complete');
+    });
+    (0, vitest_1.it)('works with nested schema', async () => {
+        const schema = zod_1.z.object({
+            user: zod_1.z.object({
+                name: zod_1.z.string(),
+                age: zod_1.z.number(),
+            }),
+        });
+        const input = '{"user":{"name":"Eve","age":25}}';
+        const results = [];
+        for await (const partial of (0, stream_validate_1.streamValidate)(chunkStream(input, 4), schema)) {
+            results.push(partial);
+        }
+        const withUser = results.find(r => r.data.user?.name === 'Eve');
+        (0, vitest_1.expect)(withUser).toBeDefined();
+    });
+    (0, vitest_1.it)('passes options through to validator', async () => {
+        const schema = zod_1.z.object({ n: zod_1.z.number() });
+        const validationErrors = [];
+        const input = '{"n":"not-a-number"}';
+        for await (const _partial of (0, stream_validate_1.streamValidate)(charStream(input), schema, {
+            validationErrorStrategy: 'include-invalid',
+            onValidationError: e => validationErrors.push(e),
+        })) {
+            // consume
+        }
+        (0, vitest_1.expect)(validationErrors.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=stream-validate.test.js.map

package/dist/__tests__/stream-validate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-validate.test.js","sourceRoot":"","sources":["../../src/__tests__/stream-validate.test.ts"],"names":[],"mappings":"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"}

package/dist/events.d.ts

@@ -0,0 +1,9 @@
+type Listener<T> = (payload: T) => void;
+export declare class TypedEmitter<Events extends Record<string, unknown>> {
+    private listeners;
+    on<K extends keyof Events & string>(event: K, fn: Listener<Events[K]>): () => void;
+    off<K extends keyof Events & string>(event: K, fn: Listener<Events[K]>): void;
+    emit<K extends keyof Events & string>(event: K, payload: Events[K]): void;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AAEvC,qBAAa,YAAY,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,OAAO,CAAC,SAAS,CAAwD;IAEzE,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAMlF,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAO7E,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;CAO1E"}

package/dist/events.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedEmitter = void 0;
+class TypedEmitter {
+    listeners = {};
+    on(event, fn) {
+        if (!this.listeners[event])
+            this.listeners[event] = [];
+        this.listeners[event].push(fn);
+        return () => this.off(event, fn);
+    }
+    off(event, fn) {
+        const arr = this.listeners[event];
+        if (!arr)
+            return;
+        const idx = arr.indexOf(fn);
+        if (idx !== -1)
+            arr.splice(idx, 1);
+    }
+    emit(event, payload) {
+        const arr = this.listeners[event];
+        if (!arr)
+            return;
+        for (const fn of arr.slice()) {
+            fn(payload);
+        }
+    }
+}
+exports.TypedEmitter = TypedEmitter;
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IACf,SAAS,GAAsD,EAAE,CAAA;IAEzE,EAAE,CAAkC,KAAQ,EAAE,EAAuB;QACnE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;QACtD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,EAAuB,CAAC,CAAA;QACpD,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAClC,CAAC;IAED,GAAG,CAAkC,KAAQ,EAAE,EAAuB;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACjC,IAAI,CAAC,GAAG;YAAE,OAAM;QAChB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,EAAuB,CAAC,CAAA;QAChD,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,CAAkC,KAAQ,EAAE,OAAkB;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACjC,IAAI,CAAC,GAAG;YAAE,OAAM;QAChB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;YAC7B,EAAE,CAAC,OAAO,CAAC,CAAA;QACb,CAAC;IACH,CAAC;CACF;AAvBD,oCAuBC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createStreamValidator } from './stream-validator';
+export { streamValidate } from './stream-validate';
+export type { DeepPartial, FieldStatus, FieldMeta, ValidatedPartial, StreamCompletionEvent, StreamValidationError, StreamParseError, StreamValidatorOptions, StreamValidator, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,YAAY,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,GAChB,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamValidate = exports.createStreamValidator = void 0;
+// stream-validate - Progressive Zod validation for streaming LLM responses
+var stream_validator_1 = require("./stream-validator");
+Object.defineProperty(exports, "createStreamValidator", { enumerable: true, get: function () { return stream_validator_1.createStreamValidator; } });
+var stream_validate_1 = require("./stream-validate");
+Object.defineProperty(exports, "streamValidate", { enumerable: true, get: function () { return stream_validate_1.streamValidate; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2EAA2E;AAC3E,uDAA0D;AAAjD,yHAAA,qBAAqB,OAAA;AAC9B,qDAAkD;AAAzC,iHAAA,cAAc,OAAA"}

package/dist/parser.d.ts

@@ -0,0 +1,40 @@
+export interface ParsedField {
+    path: string;
+    value: unknown;
+    position: number;
+}
+/**
+ * Incremental JSON parser that emits ParsedField events as object fields complete.
+ * Uses a buffering + scanning approach: buffer incoming chunks, scan for complete
+ * JSON values using balanced delimiter counting.
+ */
+export declare class IncrementalJsonParser {
+    private buf;
+    private streamPos;
+    private scanPos;
+    feed(chunk: string): ParsedField[];
+    end(): ParsedField[];
+    private insideObject;
+    private scan;
+    private skipWhitespace;
+    /**
+     * Parse a JSON string starting at pos (which must be `"`).
+     * Returns { value, endPos } where endPos is one past the closing `"`, or null if incomplete.
+     */
+    private parseString;
+    /**
+     * Parse any JSON value starting at pos.
+     * Returns { value, endPos } or null if incomplete.
+     */
+    private parseValue;
+    /**
+     * Parse a balanced `{...}` or `[...]` block.
+     */
+    private parseBalanced;
+    /**
+     * Recursively extract leaf fields from a (possibly nested) object/value,
+     * emitting one ParsedField per leaf.
+     */
+    private extractFields;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,OAAO,CAAI;IAEnB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE;IAMlC,GAAG,IAAI,WAAW,EAAE;IAepB,OAAO,CAAC,YAAY,CAAQ;IAE5B,OAAO,CAAC,IAAI;IA4EZ,OAAO,CAAC,cAAc;IAKtB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAqBnB;;;OAGG;IACH,OAAO,CAAC,UAAU;IA+ClB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAkCtB"}