@tearleads/client-sdk 0.0.0-stage → 0.1.11

package/internal/validators/jsonSchema.js

@@ -0,0 +1,295 @@
+import { z } from "zod";
+import { constrainNativeNumber, preserveDiscriminatedUnionEncoding, preserveTypeUnionEncoding, } from "./jsonSchemaEncoding.js";
+const jsonSchemaViewRegistry = z.registry();
+const jsonSchemaViews = new Map();
+const supportedJsonWireSchemaTypes = new Set([
+    "array",
+    "boolean",
+    "custom",
+    "literal",
+    "never",
+    "null",
+    "nullable",
+    "number",
+    "object",
+    "optional",
+    "record",
+    "string",
+    "unknown",
+    "union",
+]);
+const forbiddenJsonWireSchemaTypes = new Set([
+    "catch",
+    "default",
+    "file",
+    "lazy",
+    "pipe",
+    "prefault",
+    "promise",
+    "readonly",
+    "success",
+    "transform",
+]);
+const nativeMinLengthWhen = Reflect.get(z.minLength(0)._zod.def, "when");
+const nativeMinLengthWhenSource = typeof nativeMinLengthWhen === "function"
+    ? Function.prototype.toString.call(nativeMinLengthWhen)
+    : undefined;
+let nextJsonSchemaViewId = 0;
+function registerProjection(runtimeSchema, projection) {
+    const key = String(nextJsonSchemaViewId);
+    nextJsonSchemaViewId += 1;
+    jsonSchemaViews.set(key, projection);
+    jsonSchemaViewRegistry.add(runtimeSchema, { key });
+    return runtimeSchema;
+}
+/**
+ * Associates an identity-preserving runtime schema with a structurally
+ * equivalent schema that Zod can project to JSON Schema. Zod carries custom
+ * registry entries across schema clones, but projection rejects inherited
+ * views until the clone is registered explicitly.
+ */
+export function registerJsonSchemaView(runtimeSchema, viewSchema) {
+    return registerProjection(runtimeSchema, {
+        kind: "zod",
+        schema: viewSchema,
+    });
+}
+export function registerJsonSchemaFragment(runtimeSchema, jsonSchema) {
+    return registerProjection(runtimeSchema, {
+        kind: "fragment",
+        schema: jsonSchema,
+    });
+}
+/**
+ * Explicitly retains an inherited structural view after adding runtime-only
+ * refinements and records the operation-level refinement ids that document the
+ * gap. An unacknowledged custom refinement makes projection fail.
+ */
+export function registerJsonSchemaRuntimeRefinements(runtimeSchema, runtimeRefinements) {
+    if (!hasCustomRefinement(runtimeSchema)) {
+        throw new Error("Runtime refinement metadata requires a custom check");
+    }
+    const view = jsonSchemaViewRegistry.get(runtimeSchema);
+    const projection = view && jsonSchemaViews.get(view.key);
+    if (projection === undefined) {
+        throw new Error("Runtime refinements require a registered JSON Schema view");
+    }
+    const ids = Array.from(new Set([
+        ...(projection.runtimeRefinementIds ?? []),
+        ...runtimeRefinements.map((refinement) => refinement.id),
+    ]));
+    if (ids.length === 0) {
+        throw new Error("Runtime refinements require at least one refinement id");
+    }
+    return registerProjection(runtimeSchema, projection.kind === "zod"
+        ? {
+            kind: "zod",
+            runtimeRefinementIds: ids,
+            schema: projection.schema,
+        }
+        : {
+            kind: "fragment",
+            runtimeRefinementIds: ids,
+            schema: projection.schema,
+        });
+}
+function replaceJsonSchema(target, replacement) {
+    for (const key of Object.keys(target)) {
+        Reflect.deleteProperty(target, key);
+    }
+    Object.assign(target, replacement);
+}
+function needsJsonSchemaView(schema) {
+    const definition = schema._zod.def;
+    return (definition.type === "custom" ||
+        (definition.type === "string" &&
+            Reflect.get(definition, "format") !== undefined) ||
+        hasCheckRequiringView(schema));
+}
+function hasCustomRefinement(schema) {
+    return (schema._zod.def.checks?.some((check) => check._zod.def.check === "custom") ?? false);
+}
+function hasValueOverwrite(schema) {
+    return (schema._zod.def.checks?.some((check) => check._zod.def.check === "overwrite") ?? false);
+}
+function hasCheckRequiringView(schema) {
+    return (schema._zod.def.checks?.some((check) => !isNativelyProjectedCheck(check._zod.def)) ?? false);
+}
+function isNativelyProjectedCheck(definition) {
+    const when = Reflect.get(definition, "when");
+    if (definition.check === "greater_than") {
+        const value = Reflect.get(definition, "value");
+        return (when === undefined && typeof value === "number" && Number.isFinite(value));
+    }
+    if (definition.check !== "min_length") {
+        return false;
+    }
+    const minimum = Reflect.get(definition, "minimum");
+    return (Number.isInteger(minimum) &&
+        minimum >= 0 &&
+        (when === undefined ||
+            (typeof when === "function" &&
+                Function.prototype.toString.call(when) === nativeMinLengthWhenSource)));
+}
+function isJsonLiteral(value) {
+    return (value === null ||
+        typeof value === "string" ||
+        typeof value === "boolean" ||
+        (typeof value === "number" && Number.isFinite(value)));
+}
+function isReflectable(value) {
+    return ((typeof value === "object" && value !== null) || typeof value === "function");
+}
+function isZodSchema(value) {
+    if (!isReflectable(value)) {
+        return false;
+    }
+    const internals = Reflect.get(value, "_zod");
+    if (!isReflectable(internals)) {
+        return false;
+    }
+    const definition = Reflect.get(internals, "def");
+    return (isReflectable(definition) &&
+        typeof Reflect.get(definition, "type") === "string");
+}
+function assertNestedJsonWireSchemas(value, location, seenSchemas, seenValues) {
+    if (isZodSchema(value)) {
+        assertJsonWireSchema(value, location, seenSchemas, seenValues);
+        return;
+    }
+    if (typeof value !== "object" || value === null || seenValues.has(value)) {
+        return;
+    }
+    seenValues.add(value);
+    for (const key of Reflect.ownKeys(value)) {
+        const descriptor = Reflect.getOwnPropertyDescriptor(value, key);
+        if (descriptor === undefined) {
+            continue;
+        }
+        const nestedValue = "value" in descriptor ? descriptor.value : Reflect.get(value, key);
+        assertNestedJsonWireSchemas(nestedValue, `${location}.${String(key)}`, seenSchemas, seenValues);
+    }
+}
+function assertJsonWireSchema(schema, location, seenSchemas, seenValues) {
+    if (seenSchemas.has(schema)) {
+        return;
+    }
+    seenSchemas.add(schema);
+    const definition = schema._zod.def;
+    if (Reflect.get(definition, "coerce") === true) {
+        throw new Error(`JSON wire schemas must not coerce values at ${location}`);
+    }
+    if (Reflect.get(definition, "normalize") === true) {
+        throw new Error(`JSON wire schemas must not normalize values at ${location}`);
+    }
+    if (hasValueOverwrite(schema)) {
+        throw new Error(`JSON wire schemas must not overwrite values at ${location}`);
+    }
+    if (definition.type === "pipe" && jsonSchemaViewRegistry.has(schema)) {
+        // A direct view explicitly describes the pipe's wire input. Its input
+        // remains subject to every fail-closed wire-schema check.
+        const inputSchema = Reflect.get(definition, "in");
+        if (!isZodSchema(inputSchema)) {
+            throw new Error(`Registered input transform is invalid at ${location}`);
+        }
+        assertJsonWireSchema(inputSchema, `${location}.input`, seenSchemas, seenValues);
+        return;
+    }
+    if (forbiddenJsonWireSchemaTypes.has(definition.type)) {
+        throw new Error(`JSON wire schemas must not use ${definition.type} at ${location}`);
+    }
+    if (!supportedJsonWireSchemaTypes.has(definition.type)) {
+        throw new Error(`Unsupported JSON wire schema type ${definition.type} at ${location}`);
+    }
+    if (definition.type === "literal" &&
+        Array.from(schema._zod.values ?? []).some((value) => !isJsonLiteral(value))) {
+        throw new Error(`JSON wire literals must be JSON values at ${location}`);
+    }
+    assertNestedJsonWireSchemas(definition, location, seenSchemas, seenValues);
+}
+function assertJsonWireSchemaRoot(schema) {
+    assertJsonWireSchema(schema, "root", new Set(), new WeakSet());
+}
+function projectionJsonSchema(projection, resolving, runtimeRefinementIds) {
+    if (projection.kind === "fragment") {
+        return projection.schema;
+    }
+    return projectJsonSchema(projection.schema, resolving, runtimeRefinementIds);
+}
+function applyRegisteredView(context, view, resolving, runtimeRefinementIds) {
+    if (view === undefined) {
+        return false;
+    }
+    const projection = jsonSchemaViews.get(view.key);
+    if (projection === undefined) {
+        throw new Error(`Unknown JSON Schema view ${view.key}`);
+    }
+    for (const id of projection.runtimeRefinementIds ?? []) {
+        runtimeRefinementIds.add(id);
+    }
+    replaceJsonSchema(context.jsonSchema, projectionJsonSchema(projection, resolving, runtimeRefinementIds));
+    return true;
+}
+function overrideJsonSchema(context, resolving, runtimeRefinementIds) {
+    const location = context.path.join(".") || "root";
+    const view = jsonSchemaViewRegistry.get(context.zodSchema);
+    const hasDirectView = jsonSchemaViewRegistry.has(context.zodSchema);
+    if (hasCustomRefinement(context.zodSchema) && !hasDirectView) {
+        throw new Error(`Missing direct JSON Schema view for refinement at ${location}`);
+    }
+    if (view !== undefined && !hasDirectView) {
+        throw new Error(`Inherited JSON Schema view must be registered directly at ${location}`);
+    }
+    if (applyRegisteredView(context, view, resolving, runtimeRefinementIds)) {
+        return;
+    }
+    if (hasCheckRequiringView(context.zodSchema)) {
+        throw new Error(`Missing direct JSON Schema view for check at ${location}`);
+    }
+    if (needsJsonSchemaView(context.zodSchema)) {
+        throw new Error(`Missing JSON Schema view for ${context.zodSchema._zod.def.type} at ${location}`);
+    }
+    constrainNativeNumber(context.zodSchema, context.jsonSchema);
+    // Existing root discriminated unions use oneOf; nested ones use anyOf.
+    if (context.path.length > 0) {
+        preserveDiscriminatedUnionEncoding(context.zodSchema, context.jsonSchema);
+    }
+}
+function projectJsonSchema(schema, resolving, runtimeRefinementIds) {
+    assertJsonWireSchemaRoot(schema);
+    if (resolving.has(schema)) {
+        throw new Error("JSON Schema views must not form a cycle");
+    }
+    resolving.add(schema);
+    try {
+        const result = z.toJSONSchema(schema, {
+            io: "input",
+            unrepresentable: "any",
+            override(context) {
+                overrideJsonSchema(context, resolving, runtimeRefinementIds);
+            },
+        });
+        Reflect.deleteProperty(result, "$schema");
+        preserveTypeUnionEncoding(result);
+        return result;
+    }
+    finally {
+        resolving.delete(schema);
+    }
+}
+/**
+ * Projects a runtime schema to JSON Schema 2020-12. Intentional custom
+ * validators must register a structural view; unrepresentable schemas fail
+ * closed instead of becoming unconstrained output.
+ */
+export function toJsonSchema(schema) {
+    return toJsonSchemaProjection(schema).jsonSchema;
+}
+export function toJsonSchemaProjection(schema) {
+    const runtimeRefinementIds = new Set();
+    return {
+        jsonSchema: projectJsonSchema(schema, new Set(), runtimeRefinementIds),
+        runtimeRefinementIds: [...runtimeRefinementIds].sort(),
+    };
+}
+//# sourceMappingURL=jsonSchema.js.map

package/internal/validators/jsonSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSchema.js","sourceRoot":"","sources":["jsonSchema.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport {\n  constrainNativeNumber,\n  preserveDiscriminatedUnionEncoding,\n  preserveTypeUnionEncoding,\n} from \"./jsonSchemaEncoding\";\n\ninterface JsonSchemaView {\n  readonly key: string;\n}\n\ninterface RuntimeRefinementProjection {\n  readonly runtimeRefinementIds?: readonly string[];\n}\n\ninterface RuntimeRefinementReference {\n  readonly id: string;\n}\n\ntype JsonSchemaProjection = (\n  | {\n      readonly kind: \"fragment\";\n      readonly schema: z.core.JSONSchema.BaseSchema;\n    }\n  | {\n      readonly kind: \"zod\";\n      readonly schema: z.core.$ZodType;\n    }\n) &\n  RuntimeRefinementProjection;\n\nconst jsonSchemaViewRegistry = z.registry<JsonSchemaView>();\nconst jsonSchemaViews = new Map<string, JsonSchemaProjection>();\nconst supportedJsonWireSchemaTypes = new Set([\n  \"array\",\n  \"boolean\",\n  \"custom\",\n  \"literal\",\n  \"never\",\n  \"null\",\n  \"nullable\",\n  \"number\",\n  \"object\",\n  \"optional\",\n  \"record\",\n  \"string\",\n  \"unknown\",\n  \"union\",\n]);\nconst forbiddenJsonWireSchemaTypes = new Set([\n  \"catch\",\n  \"default\",\n  \"file\",\n  \"lazy\",\n  \"pipe\",\n  \"prefault\",\n  \"promise\",\n  \"readonly\",\n  \"success\",\n  \"transform\",\n]);\nconst nativeMinLengthWhen = Reflect.get(z.minLength(0)._zod.def, \"when\");\nconst nativeMinLengthWhenSource =\n  typeof nativeMinLengthWhen === \"function\"\n    ? Function.prototype.toString.call(nativeMinLengthWhen)\n    : undefined;\nlet nextJsonSchemaViewId = 0;\n\nfunction registerProjection<RuntimeSchema extends z.ZodType>(\n  runtimeSchema: RuntimeSchema,\n  projection: JsonSchemaProjection,\n): RuntimeSchema;\nfunction registerProjection(\n  runtimeSchema: z.ZodType,\n  projection: JsonSchemaProjection,\n): z.ZodType {\n  const key = String(nextJsonSchemaViewId);\n  nextJsonSchemaViewId += 1;\n  jsonSchemaViews.set(key, projection);\n  jsonSchemaViewRegistry.add(runtimeSchema, { key });\n  return runtimeSchema;\n}\n\n/**\n * Associates an identity-preserving runtime schema with a structurally\n * equivalent schema that Zod can project to JSON Schema. Zod carries custom\n * registry entries across schema clones, but projection rejects inherited\n * views until the clone is registered explicitly.\n */\nexport function registerJsonSchemaView<RuntimeSchema extends z.ZodType>(\n  runtimeSchema: RuntimeSchema,\n  viewSchema: z.core.$ZodType,\n): RuntimeSchema {\n  return registerProjection(runtimeSchema, {\n    kind: \"zod\",\n    schema: viewSchema,\n  });\n}\n\nexport function registerJsonSchemaFragment<RuntimeSchema extends z.ZodType>(\n  runtimeSchema: RuntimeSchema,\n  jsonSchema: z.core.JSONSchema.BaseSchema,\n): RuntimeSchema {\n  return registerProjection(runtimeSchema, {\n    kind: \"fragment\",\n    schema: jsonSchema,\n  });\n}\n\n/**\n * Explicitly retains an inherited structural view after adding runtime-only\n * refinements and records the operation-level refinement ids that document the\n * gap. An unacknowledged custom refinement makes projection fail.\n */\nexport function registerJsonSchemaRuntimeRefinements<\n  RuntimeSchema extends z.ZodType,\n>(\n  runtimeSchema: RuntimeSchema,\n  runtimeRefinements: readonly RuntimeRefinementReference[],\n): RuntimeSchema {\n  if (!hasCustomRefinement(runtimeSchema)) {\n    throw new Error(\"Runtime refinement metadata requires a custom check\");\n  }\n\n  const view = jsonSchemaViewRegistry.get(runtimeSchema);\n  const projection = view && jsonSchemaViews.get(view.key);\n  if (projection === undefined) {\n    throw new Error(\n      \"Runtime refinements require a registered JSON Schema view\",\n    );\n  }\n\n  const ids = Array.from(\n    new Set([\n      ...(projection.runtimeRefinementIds ?? []),\n      ...runtimeRefinements.map((refinement) => refinement.id),\n    ]),\n  );\n  if (ids.length === 0) {\n    throw new Error(\"Runtime refinements require at least one refinement id\");\n  }\n\n  return registerProjection(\n    runtimeSchema,\n    projection.kind === \"zod\"\n      ? {\n          kind: \"zod\",\n          runtimeRefinementIds: ids,\n          schema: projection.schema,\n        }\n      : {\n          kind: \"fragment\",\n          runtimeRefinementIds: ids,\n          schema: projection.schema,\n        },\n  );\n}\n\nfunction replaceJsonSchema(\n  target: z.core.JSONSchema.BaseSchema,\n  replacement: z.core.JSONSchema.BaseSchema,\n): void {\n  for (const key of Object.keys(target)) {\n    Reflect.deleteProperty(target, key);\n  }\n\n  Object.assign(target, replacement);\n}\n\nfunction needsJsonSchemaView(schema: z.core.$ZodType): boolean {\n  const definition = schema._zod.def;\n  return (\n    definition.type === \"custom\" ||\n    (definition.type === \"string\" &&\n      Reflect.get(definition, \"format\") !== undefined) ||\n    hasCheckRequiringView(schema)\n  );\n}\n\nfunction hasCustomRefinement(schema: z.core.$ZodType): boolean {\n  return (\n    schema._zod.def.checks?.some(\n      (check) => check._zod.def.check === \"custom\",\n    ) ?? false\n  );\n}\n\nfunction hasValueOverwrite(schema: z.core.$ZodType): boolean {\n  return (\n    schema._zod.def.checks?.some(\n      (check) => check._zod.def.check === \"overwrite\",\n    ) ?? false\n  );\n}\n\nfunction hasCheckRequiringView(schema: z.core.$ZodType): boolean {\n  return (\n    schema._zod.def.checks?.some(\n      (check) => !isNativelyProjectedCheck(check._zod.def),\n    ) ?? false\n  );\n}\n\nfunction isNativelyProjectedCheck(definition: z.core.$ZodCheckDef): boolean {\n  const when = Reflect.get(definition, \"when\");\n  if (definition.check === \"greater_than\") {\n    const value = Reflect.get(definition, \"value\");\n    return (\n      when === undefined && typeof value === \"number\" && Number.isFinite(value)\n    );\n  }\n  if (definition.check !== \"min_length\") {\n    return false;\n  }\n\n  const minimum = Reflect.get(definition, \"minimum\");\n  return (\n    Number.isInteger(minimum) &&\n    minimum >= 0 &&\n    (when === undefined ||\n      (typeof when === \"function\" &&\n        Function.prototype.toString.call(when) === nativeMinLengthWhenSource))\n  );\n}\n\nfunction isJsonLiteral(value: unknown): boolean {\n  return (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"boolean\" ||\n    (typeof value === \"number\" && Number.isFinite(value))\n  );\n}\n\nfunction isReflectable(value: unknown): value is object {\n  return (\n    (typeof value === \"object\" && value !== null) || typeof value === \"function\"\n  );\n}\n\nfunction isZodSchema(value: unknown): value is z.core.$ZodType {\n  if (!isReflectable(value)) {\n    return false;\n  }\n\n  const internals = Reflect.get(value, \"_zod\");\n  if (!isReflectable(internals)) {\n    return false;\n  }\n\n  const definition = Reflect.get(internals, \"def\");\n  return (\n    isReflectable(definition) &&\n    typeof Reflect.get(definition, \"type\") === \"string\"\n  );\n}\n\nfunction assertNestedJsonWireSchemas(\n  value: unknown,\n  location: string,\n  seenSchemas: Set<z.core.$ZodType>,\n  seenValues: WeakSet<object>,\n): void {\n  if (isZodSchema(value)) {\n    assertJsonWireSchema(value, location, seenSchemas, seenValues);\n    return;\n  }\n  if (typeof value !== \"object\" || value === null || seenValues.has(value)) {\n    return;\n  }\n\n  seenValues.add(value);\n  for (const key of Reflect.ownKeys(value)) {\n    const descriptor = Reflect.getOwnPropertyDescriptor(value, key);\n    if (descriptor === undefined) {\n      continue;\n    }\n    const nestedValue =\n      \"value\" in descriptor ? descriptor.value : Reflect.get(value, key);\n    assertNestedJsonWireSchemas(\n      nestedValue,\n      `${location}.${String(key)}`,\n      seenSchemas,\n      seenValues,\n    );\n  }\n}\n\nfunction assertJsonWireSchema(\n  schema: z.core.$ZodType,\n  location: string,\n  seenSchemas: Set<z.core.$ZodType>,\n  seenValues: WeakSet<object>,\n): void {\n  if (seenSchemas.has(schema)) {\n    return;\n  }\n  seenSchemas.add(schema);\n\n  const definition = schema._zod.def;\n  if (Reflect.get(definition, \"coerce\") === true) {\n    throw new Error(`JSON wire schemas must not coerce values at ${location}`);\n  }\n  if (Reflect.get(definition, \"normalize\") === true) {\n    throw new Error(\n      `JSON wire schemas must not normalize values at ${location}`,\n    );\n  }\n  if (hasValueOverwrite(schema)) {\n    throw new Error(\n      `JSON wire schemas must not overwrite values at ${location}`,\n    );\n  }\n  if (definition.type === \"pipe\" && jsonSchemaViewRegistry.has(schema)) {\n    // A direct view explicitly describes the pipe's wire input. Its input\n    // remains subject to every fail-closed wire-schema check.\n    const inputSchema = Reflect.get(definition, \"in\");\n    if (!isZodSchema(inputSchema)) {\n      throw new Error(`Registered input transform is invalid at ${location}`);\n    }\n    assertJsonWireSchema(\n      inputSchema,\n      `${location}.input`,\n      seenSchemas,\n      seenValues,\n    );\n    return;\n  }\n  if (forbiddenJsonWireSchemaTypes.has(definition.type)) {\n    throw new Error(\n      `JSON wire schemas must not use ${definition.type} at ${location}`,\n    );\n  }\n  if (!supportedJsonWireSchemaTypes.has(definition.type)) {\n    throw new Error(\n      `Unsupported JSON wire schema type ${definition.type} at ${location}`,\n    );\n  }\n  if (\n    definition.type === \"literal\" &&\n    Array.from(schema._zod.values ?? []).some((value) => !isJsonLiteral(value))\n  ) {\n    throw new Error(`JSON wire literals must be JSON values at ${location}`);\n  }\n\n  assertNestedJsonWireSchemas(definition, location, seenSchemas, seenValues);\n}\n\nfunction assertJsonWireSchemaRoot(schema: z.core.$ZodType): void {\n  assertJsonWireSchema(schema, \"root\", new Set(), new WeakSet());\n}\n\ninterface JsonSchemaOverrideContext {\n  readonly jsonSchema: z.core.JSONSchema.BaseSchema;\n  readonly path: readonly (number | string)[];\n  readonly zodSchema: z.core.$ZodType;\n}\n\nfunction projectionJsonSchema(\n  projection: JsonSchemaProjection,\n  resolving: Set<z.core.$ZodType>,\n  runtimeRefinementIds: Set<string>,\n): z.core.JSONSchema.BaseSchema {\n  if (projection.kind === \"fragment\") {\n    return projection.schema;\n  }\n  return projectJsonSchema(projection.schema, resolving, runtimeRefinementIds);\n}\n\nfunction applyRegisteredView(\n  context: JsonSchemaOverrideContext,\n  view: JsonSchemaView | undefined,\n  resolving: Set<z.core.$ZodType>,\n  runtimeRefinementIds: Set<string>,\n): boolean {\n  if (view === undefined) {\n    return false;\n  }\n\n  const projection = jsonSchemaViews.get(view.key);\n  if (projection === undefined) {\n    throw new Error(`Unknown JSON Schema view ${view.key}`);\n  }\n  for (const id of projection.runtimeRefinementIds ?? []) {\n    runtimeRefinementIds.add(id);\n  }\n  replaceJsonSchema(\n    context.jsonSchema,\n    projectionJsonSchema(projection, resolving, runtimeRefinementIds),\n  );\n  return true;\n}\n\nfunction overrideJsonSchema(\n  context: JsonSchemaOverrideContext,\n  resolving: Set<z.core.$ZodType>,\n  runtimeRefinementIds: Set<string>,\n): void {\n  const location = context.path.join(\".\") || \"root\";\n  const view = jsonSchemaViewRegistry.get(context.zodSchema);\n  const hasDirectView = jsonSchemaViewRegistry.has(context.zodSchema);\n  if (hasCustomRefinement(context.zodSchema) && !hasDirectView) {\n    throw new Error(\n      `Missing direct JSON Schema view for refinement at ${location}`,\n    );\n  }\n  if (view !== undefined && !hasDirectView) {\n    throw new Error(\n      `Inherited JSON Schema view must be registered directly at ${location}`,\n    );\n  }\n  if (applyRegisteredView(context, view, resolving, runtimeRefinementIds)) {\n    return;\n  }\n  if (hasCheckRequiringView(context.zodSchema)) {\n    throw new Error(`Missing direct JSON Schema view for check at ${location}`);\n  }\n  if (needsJsonSchemaView(context.zodSchema)) {\n    throw new Error(\n      `Missing JSON Schema view for ${context.zodSchema._zod.def.type} at ${location}`,\n    );\n  }\n  constrainNativeNumber(context.zodSchema, context.jsonSchema);\n  // Existing root discriminated unions use oneOf; nested ones use anyOf.\n  if (context.path.length > 0) {\n    preserveDiscriminatedUnionEncoding(context.zodSchema, context.jsonSchema);\n  }\n}\n\nfunction projectJsonSchema(\n  schema: z.core.$ZodType,\n  resolving: Set<z.core.$ZodType>,\n  runtimeRefinementIds: Set<string>,\n): z.core.JSONSchema.BaseSchema {\n  assertJsonWireSchemaRoot(schema);\n  if (resolving.has(schema)) {\n    throw new Error(\"JSON Schema views must not form a cycle\");\n  }\n\n  resolving.add(schema);\n  try {\n    const result = z.toJSONSchema(schema, {\n      io: \"input\",\n      unrepresentable: \"any\",\n      override(context) {\n        overrideJsonSchema(context, resolving, runtimeRefinementIds);\n      },\n    });\n\n    Reflect.deleteProperty(result, \"$schema\");\n    preserveTypeUnionEncoding(result);\n    return result;\n  } finally {\n    resolving.delete(schema);\n  }\n}\n\n/**\n * Projects a runtime schema to JSON Schema 2020-12. Intentional custom\n * validators must register a structural view; unrepresentable schemas fail\n * closed instead of becoming unconstrained output.\n */\nexport function toJsonSchema(\n  schema: z.core.$ZodType,\n): z.core.JSONSchema.BaseSchema {\n  return toJsonSchemaProjection(schema).jsonSchema;\n}\n\ninterface JsonSchemaProjectionResult {\n  readonly jsonSchema: z.core.JSONSchema.BaseSchema;\n  readonly runtimeRefinementIds: readonly string[];\n}\n\nexport function toJsonSchemaProjection(\n  schema: z.core.$ZodType,\n): JsonSchemaProjectionResult {\n  const runtimeRefinementIds = new Set<string>();\n  return {\n    jsonSchema: projectJsonSchema(schema, new Set(), runtimeRefinementIds),\n    runtimeRefinementIds: [...runtimeRefinementIds].sort(),\n  };\n}\n"]}

package/internal/validators/jsonSchemaEncoding.js

@@ -0,0 +1,88 @@
+export function preserveDiscriminatedUnionEncoding(schema, jsonSchema) {
+    // Discriminator values are disjoint, so anyOf retains the established
+    // encoding of nested unions. Keep oneOf for XOR unions, whose branches can overlap.
+    if (schema._zod.def.type === "union" &&
+        typeof Reflect.get(schema._zod.def, "discriminator") === "string" &&
+        jsonSchema.oneOf) {
+        jsonSchema.anyOf = jsonSchema.oneOf;
+        delete jsonSchema.oneOf;
+    }
+}
+const schemaMaps = [
+    "$defs",
+    "properties",
+    "patternProperties",
+    "dependentSchemas",
+];
+const schemaChildren = [
+    "additionalItems",
+    "unevaluatedItems",
+    "prefixItems",
+    "items",
+    "contains",
+    "additionalProperties",
+    "unevaluatedProperties",
+    "propertyNames",
+    "if",
+    "then",
+    "else",
+    "allOf",
+    "anyOf",
+    "oneOf",
+    "not",
+];
+export function preserveTypeUnionEncoding(schema) {
+    // Zod 4.5 compacts these after its override hook. Keep the established
+    // OpenAPI encoding so consumers and compatibility checks see a stable API.
+    if (Array.isArray(schema.type)) {
+        const union = schema.type.map((type) => ({ type }));
+        delete schema.type;
+        if (schema.anyOf) {
+            schema.allOf = [...(schema.allOf ?? []), { anyOf: union }];
+        }
+        else {
+            schema.anyOf = union;
+        }
+    }
+    for (const key of schemaMaps) {
+        const children = schema[key];
+        if (children && typeof children === "object") {
+            for (const child of Object.values(children)) {
+                visitSchema(child);
+            }
+        }
+    }
+    for (const key of schemaChildren) {
+        const child = schema[key];
+        if (Array.isArray(child)) {
+            for (const item of child)
+                visitSchema(item);
+        }
+        else {
+            visitSchema(child);
+        }
+    }
+}
+function visitSchema(value) {
+    if (value && typeof value === "object") {
+        preserveTypeUnionEncoding(value);
+    }
+}
+export function constrainNativeNumber(zodSchema, jsonSchema) {
+    if (zodSchema._zod.def.type !== "number") {
+        return;
+    }
+    const minimum = Reflect.get(jsonSchema, "minimum");
+    if (typeof minimum !== "number" ||
+        !Number.isFinite(minimum) ||
+        minimum < -Number.MAX_VALUE) {
+        Reflect.set(jsonSchema, "minimum", -Number.MAX_VALUE);
+    }
+    const maximum = Reflect.get(jsonSchema, "maximum");
+    if (typeof maximum !== "number" ||
+        !Number.isFinite(maximum) ||
+        maximum > Number.MAX_VALUE) {
+        Reflect.set(jsonSchema, "maximum", Number.MAX_VALUE);
+    }
+}
+//# sourceMappingURL=jsonSchemaEncoding.js.map

package/internal/validators/jsonSchemaEncoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSchemaEncoding.js","sourceRoot":"","sources":["jsonSchemaEncoding.ts"],"names":[],"mappings":"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","sourcesContent":["import type { z } from \"zod\";\n\ntype JsonSchema = z.core.JSONSchema.BaseSchema;\n\nexport function preserveDiscriminatedUnionEncoding(\n  schema: z.core.$ZodType,\n  jsonSchema: JsonSchema,\n): void {\n  // Discriminator values are disjoint, so anyOf retains the established\n  // encoding of nested unions. Keep oneOf for XOR unions, whose branches can overlap.\n  if (\n    schema._zod.def.type === \"union\" &&\n    typeof Reflect.get(schema._zod.def, \"discriminator\") === \"string\" &&\n    jsonSchema.oneOf\n  ) {\n    jsonSchema.anyOf = jsonSchema.oneOf;\n    delete jsonSchema.oneOf;\n  }\n}\n\nconst schemaMaps = [\n  \"$defs\",\n  \"properties\",\n  \"patternProperties\",\n  \"dependentSchemas\",\n] as const;\nconst schemaChildren = [\n  \"additionalItems\",\n  \"unevaluatedItems\",\n  \"prefixItems\",\n  \"items\",\n  \"contains\",\n  \"additionalProperties\",\n  \"unevaluatedProperties\",\n  \"propertyNames\",\n  \"if\",\n  \"then\",\n  \"else\",\n  \"allOf\",\n  \"anyOf\",\n  \"oneOf\",\n  \"not\",\n] as const;\n\nexport function preserveTypeUnionEncoding(schema: JsonSchema): void {\n  // Zod 4.5 compacts these after its override hook. Keep the established\n  // OpenAPI encoding so consumers and compatibility checks see a stable API.\n  if (Array.isArray(schema.type)) {\n    const union = schema.type.map((type) => ({ type }));\n    delete schema.type;\n    if (schema.anyOf) {\n      schema.allOf = [...(schema.allOf ?? []), { anyOf: union }];\n    } else {\n      schema.anyOf = union;\n    }\n  }\n  for (const key of schemaMaps) {\n    const children = schema[key];\n    if (children && typeof children === \"object\") {\n      for (const child of Object.values(children)) {\n        visitSchema(child);\n      }\n    }\n  }\n  for (const key of schemaChildren) {\n    const child = schema[key];\n    if (Array.isArray(child)) {\n      for (const item of child) visitSchema(item);\n    } else {\n      visitSchema(child);\n    }\n  }\n}\n\nfunction visitSchema(value: JsonSchema | boolean | undefined): void {\n  if (value && typeof value === \"object\") {\n    preserveTypeUnionEncoding(value);\n  }\n}\n\nexport function constrainNativeNumber(\n  zodSchema: z.core.$ZodType,\n  jsonSchema: JsonSchema,\n): void {\n  if (zodSchema._zod.def.type !== \"number\") {\n    return;\n  }\n\n  const minimum = Reflect.get(jsonSchema, \"minimum\");\n  if (\n    typeof minimum !== \"number\" ||\n    !Number.isFinite(minimum) ||\n    minimum < -Number.MAX_VALUE\n  ) {\n    Reflect.set(jsonSchema, \"minimum\", -Number.MAX_VALUE);\n  }\n\n  const maximum = Reflect.get(jsonSchema, \"maximum\");\n  if (\n    typeof maximum !== \"number\" ||\n    !Number.isFinite(maximum) ||\n    maximum > Number.MAX_VALUE\n  ) {\n    Reflect.set(jsonSchema, \"maximum\", Number.MAX_VALUE);\n  }\n}\n"]}

package/internal/validators/operation/apiVersion.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Response header naming the API build that served the response: the number of
+ * commits on the default branch the executable was built from. The default
+ * branch only ever gains squash-merged commits, so a later deploy always carries
+ * a larger number and clients can compare two values without a lookup table.
+ */
+export declare const apiVersionHeaderName = "X-Tearleads-Api-Version";
+/** A positive decimal integer without leading zeros, or null for anything else. */
+export declare function parseApiVersion(value: string | null): number | null;

package/internal/validators/operation/apiVersion.js

@@ -0,0 +1,16 @@
+/**
+ * Response header naming the API build that served the response: the number of
+ * commits on the default branch the executable was built from. The default
+ * branch only ever gains squash-merged commits, so a later deploy always carries
+ * a larger number and clients can compare two values without a lookup table.
+ */
+export const apiVersionHeaderName = "X-Tearleads-Api-Version";
+/** A positive decimal integer without leading zeros, or null for anything else. */
+export function parseApiVersion(value) {
+    if (value === null || !/^[1-9]\d*$/u.test(value)) {
+        return null;
+    }
+    const version = Number(value);
+    return Number.isSafeInteger(version) ? version : null;
+}
+//# sourceMappingURL=apiVersion.js.map

package/internal/validators/operation/apiVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiVersion.js","sourceRoot":"","sources":["apiVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAE9D,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC","sourcesContent":["/**\n * Response header naming the API build that served the response: the number of\n * commits on the default branch the executable was built from. The default\n * branch only ever gains squash-merged commits, so a later deploy always carries\n * a larger number and clients can compare two values without a lookup table.\n */\nexport const apiVersionHeaderName = \"X-Tearleads-Api-Version\";\n\n/** A positive decimal integer without leading zeros, or null for anything else. */\nexport function parseApiVersion(value: string | null): number | null {\n  if (value === null || !/^[1-9]\\d*$/u.test(value)) {\n    return null;\n  }\n  const version = Number(value);\n  return Number.isSafeInteger(version) ? version : null;\n}\n"]}