@instruments/materialgraph 0.33.0 → 0.36.0

package/validation.js

@@ -1,117 +0,0 @@
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-/** A `z.object({…})`. */
-export const requireRecord = (value, what, fail) => {
-    if (!isRecord(value)) {
-        throw fail(`${what} is not a JSON object`);
-    }
-    return value;
-};
-/** A `z.string()`. */
-export const requireString = (value, what, fail) => {
-    if (typeof value !== "string") {
-        throw fail(`${what} is not a string`);
-    }
-    return value;
-};
-/** A `z.string().optional()`: absent is fine, present-but-wrong is not. */
-export const requireOptionalString = (value, what, fail) => {
-    if (value === undefined) {
-        return;
-    }
-    requireString(value, what, fail);
-};
-/** A `z.string().nullable()`. */
-export const requireNullableString = (value, what, fail) => {
-    if (value === null) {
-        return null;
-    }
-    return requireString(value, what, fail);
-};
-/** A `z.boolean()`. */
-export const requireBoolean = (value, what, fail) => {
-    if (typeof value !== "boolean") {
-        throw fail(`${what} is not a boolean`);
-    }
-    return value;
-};
-/** A `z.boolean().optional()`. */
-export const requireOptionalBoolean = (value, what, fail) => {
-    if (value === undefined) {
-        return;
-    }
-    requireBoolean(value, what, fail);
-};
-/**
- * A `z.number()`. Zod 4 rejects `NaN` AND `±Infinity` for it, and `1e999` parses
- * out of JSON as `Infinity`, so finiteness is a reachable check.
- */
-export const requireNumber = (value, what, fail) => {
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw fail(`${what} is not a finite number`);
-    }
-    return value;
-};
-/** A `z.enum([…])` — CLOSED, exactly like the canonical member list. */
-export const requireEnum = (value, allowed, what, fail) => {
-    const text = requireString(value, what, fail);
-    if (!allowed.includes(text)) {
-        throw fail(`${what} is not one of ${allowed.join(" | ")} (${text})`);
-    }
-    return text;
-};
-/** A `z.array(…)`. */
-export const requireArray = (value, what, fail) => {
-    if (!Array.isArray(value)) {
-        throw fail(`${what} is not an array`);
-    }
-    return value;
-};
-/**
- * A `z.json()` — a JSON value, recursively: `string | number | boolean | null`,
- * an array of them, or an object of them, at ANY depth.
- *
- * WHY THIS EXISTS, given it can never fire over the wire. Every SDK response
- * has already been through `JSON.parse`, so a `Date`, `bigint`, `undefined`, or
- * function CANNOT be present by construction — this check is unreachable in
- * practice. It is here for PARITY: the canonical `sourceImageAnalysisResultSchema`
- * uses `z.json()` precisely because those four break differently on the way to
- * `jsonb` (a `bigint` throws in `JSON.stringify`, an `undefined` is silently
- * dropped, and a `Date` round-trips as an ISO *string* — a different type read
- * back than written). The mirror has to reject what the schema rejects or the
- * parity test is lying. Do not delete this as dead code.
- */
-const requireJsonValue = (value, what, fail) => {
-    if (value === null) {
-        return null;
-    }
-    if (typeof value === "string" || typeof value === "boolean") {
-        return value;
-    }
-    if (typeof value === "number") {
-        // `z.json()`'s number leaf rejects NaN and ±Infinity, and `1e999` parses out
-        // of JSON as `Infinity` — so finiteness IS reachable, unlike the rest.
-        if (!Number.isFinite(value)) {
-            throw fail(`${what} is not a finite number`);
-        }
-        return value;
-    }
-    if (Array.isArray(value)) {
-        return value.map((item, index) => requireJsonValue(item, `${what}[${index}]`, fail));
-    }
-    if (isRecord(value)) {
-        // A PLAIN object only. `isRecord` alone is not enough: it answers true for a
-        // `Date`, a `Map`, and any class instance, none of which have own enumerable
-        // entries — so recursing over them would silently accept them as `{}` while
-        // `z.json()` rejects them outright. A `Date` reaching `jsonb` is exactly the
-        // failure this check exists to stop.
-        const prototype = Object.getPrototypeOf(value);
-        if (prototype !== Object.prototype && prototype !== null) {
-            throw fail(`${what} is not a JSON value`);
-        }
-        return Object.fromEntries(Object.entries(value).map(([key, item]) => [
-            key,
-            requireJsonValue(item, `${what}.${key}`, fail),
-        ]));
-    }
-    throw fail(`${what} is not a JSON value`);
-};