stream-validate 0.1.0

package/dist/validator.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressiveValidator = void 0;
+const zod_1 = require("zod");
+/**
+ * Navigate a Zod schema to a sub-schema by dot/bracket path.
+ * e.g. path "address.city" on z.object({address: z.object({city: z.string()})})
+ * returns the z.string() schema.
+ * Returns null if the path can't be resolved.
+ */
+function getSubSchema(schema, path) {
+    if (!path)
+        return schema;
+    // Unwrap optional/nullable/default wrappers
+    let s = schema;
+    while (s instanceof zod_1.z.ZodOptional ||
+        s instanceof zod_1.z.ZodNullable ||
+        s instanceof zod_1.z.ZodDefault) {
+        s = s._def.innerType;
+    }
+    const parts = path.replace(/\[(\d+)\]/g, '.$1').split('.');
+    const [head, ...rest] = parts;
+    const restPath = rest.join('.');
+    if (s instanceof zod_1.z.ZodObject) {
+        const shape = s.shape;
+        if (!(head in shape))
+            return null;
+        return getSubSchema(shape[head], restPath);
+    }
+    if (s instanceof zod_1.z.ZodArray) {
+        // head is an array index — recurse into element type
+        return getSubSchema(s._def.type, restPath);
+    }
+    return null;
+}
+/**
+ * Set a value at a dot/bracket path in a nested object (mutates).
+ */
+function setAtPath(obj, path, value) {
+    const parts = path.replace(/\[(\d+)\]/g, '.$1').split('.');
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const k = parts[i];
+        if (cur[k] === undefined || cur[k] === null || typeof cur[k] !== 'object') {
+            cur[k] = {};
+        }
+        cur = cur[k];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+/**
+ * Collect all required field paths from a Zod schema.
+ */
+function collectRequiredPaths(schema, prefix = '') {
+    let s = schema;
+    const isOptional = s instanceof zod_1.z.ZodOptional;
+    while (s instanceof zod_1.z.ZodOptional ||
+        s instanceof zod_1.z.ZodNullable ||
+        s instanceof zod_1.z.ZodDefault) {
+        s = s._def.innerType;
+    }
+    if (s instanceof zod_1.z.ZodObject) {
+        const paths = [];
+        const shape = s.shape;
+        for (const [k, v] of Object.entries(shape)) {
+            const childPaths = collectRequiredPaths(v, prefix ? `${prefix}.${k}` : k);
+            paths.push(...childPaths);
+        }
+        return paths;
+    }
+    // Leaf node
+    if (isOptional)
+        return [];
+    return prefix ? [prefix] : [];
+}
+class ProgressiveValidator {
+    schema;
+    data = {};
+    meta = {};
+    seq = 0;
+    startTime = Date.now();
+    requiredPaths;
+    failedPaths = [];
+    constructor(schema) {
+        this.schema = schema;
+        this.requiredPaths = collectRequiredPaths(schema);
+    }
+    applyField(path, value, options) {
+        const strategy = options?.strategy ?? 'skip';
+        const subSchema = getSubSchema(this.schema, path);
+        let status = 'complete';
+        let validationError;
+        if (subSchema) {
+            const result = subSchema.safeParse(value);
+            if (!result.success) {
+                const message = result.error.errors.map(e => e.message).join('; ');
+                validationError = {
+                    path,
+                    value,
+                    message,
+                    elapsedMs: Date.now() - this.startTime,
+                };
+                status = 'error';
+                this.failedPaths.push(path);
+                if (strategy === 'skip') {
+                    // Don't set the value, mark as error and return
+                    this.meta[path] = 'error';
+                    return { partial: this.buildPartial(), error: validationError };
+                }
+                else if (strategy === 'error') {
+                    this.meta[path] = 'error';
+                    return { partial: this.buildPartial(), error: validationError };
+                }
+                // include-invalid: fall through and set value anyway
+            }
+        }
+        setAtPath(this.data, path, value);
+        this.meta[path] = status;
+        this.seq++;
+        return { partial: this.buildPartial(), error: validationError };
+    }
+    isComplete() {
+        if (this.requiredPaths.length === 0) {
+            // No required paths detected — check if we have any data
+            return Object.keys(this.meta).length > 0;
+        }
+        return this.requiredPaths.every(p => this.meta[p] === 'complete');
+    }
+    getFailedPaths() {
+        return this.failedPaths.slice();
+    }
+    getRequiredPaths() {
+        return this.requiredPaths.slice();
+    }
+    buildPartial() {
+        return {
+            data: this.data,
+            meta: { ...this.meta },
+            isComplete: this.isComplete(),
+            seq: this.seq,
+            elapsedMs: Date.now() - this.startTime,
+        };
+    }
+}
+exports.ProgressiveValidator = ProgressiveValidator;
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "stream-validate",
+  "version": "0.1.0",
+  "description": "Progressive Zod validation for streaming LLM responses",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
+    "eslint": "^10.1.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}