@orpc/zod 2.0.0-beta.22 → 2.0.0-beta.24

package/README.md

@@ -44,6 +44,7 @@ You can read the documentation [here](https://orpc.dev).
 
 - [@orpc/publisher](https://www.npmjs.com/package/@orpc/publisher): Pub/Sub with memory, Redis, and Upstash adapters.
 - [@orpc/ratelimit](https://www.npmjs.com/package/@orpc/ratelimit): Rate limiting with memory, Redis, and Upstash adapters.
+- [@orpc/hibernation](https://www.npmjs.com/package/@orpc/hibernation): Leverage Hibernation APIs like [Cloudflare's Hibernation WebSocket](https://developers.cloudflare.com/durable-objects/best-practices/websockets/#durable-objects-hibernation-websocket-api).
 - [@orpc/json-schema](https://www.npmjs.com/package/@orpc/json-schema): Smart coercion for OpenAPI requests.
 
 **Framework & ecosystem integrations**
@@ -114,6 +115,7 @@ Like what we build over at [middleapi](https://github.com/middleapi)? You can he
   </tr>
   <tr>
    <td align="center"><a href="https://github.com/itigoore01?ref=orpc" target="_blank" rel="noopener" title="shota"><img src="https://avatars.githubusercontent.com/u/11831107?u=c976a6dc7e055eb026304c46c99100ed22b0c8e0&amp;v=4" width="139" alt="shota"/><br />shota</a></td>
+   <td align="center"><a href="https://github.com/ellis-driscoll?ref=orpc" target="_blank" rel="noopener" title="Ellis Driscoll"><img src="https://avatars.githubusercontent.com/u/70685966?u=c5f95bc33b5991d9744abe00052542e4a2ed3cb9&amp;v=4" width="139" alt="Ellis Driscoll"/><br />Ellis Driscoll</a></td>
   </tr>
 </table>
 
@@ -139,8 +141,9 @@ Like what we build over at [middleapi](https://github.com/middleapi)? You can he
    <td align="center"><a href="https://github.com/mr-kelly?ref=orpc" target="_blank" rel="noopener" title="Kelly Peilin Chan"><img src="https://avatars.githubusercontent.com/u/520852?u=6b0f7105f694e7b5cacf410a3f04c7044b469dc8&amp;v=4" width="119" alt="Kelly Peilin Chan"/><br />Kelly Peilin Chan</a></td>
   </tr>
   <tr>
+   <td align="center"><a href="https://github.com/guyariely?ref=orpc" target="_blank" rel="noopener" title="Guy Ariely"><img src="https://avatars.githubusercontent.com/u/42813496?u=edb6b7f563bf28e160a290832e7da57c0506f8ca&amp;v=4" width="119" alt="Guy Ariely"/><br />Guy Ariely</a></td>
    <td align="center"><a href="https://github.com/piscis?ref=orpc" target="_blank" rel="noopener" title="Alex"><img src="https://avatars.githubusercontent.com/u/326163?u=b245f368bd940cf51d08c0b6bf55f8257f359437&amp;v=4" width="119" alt="Alex"/><br />Alex</a></td>
-   <td align="center"><a href="https://github.com/finom?ref=orpc" target="_blank" rel="noopener" title="Andrey Gubanov"><img src="https://avatars.githubusercontent.com/u/1082083?u=29e91400dbd4a9c217048a8f59562c4f740498e6&amp;v=4" width="119" alt="Andrey Gubanov"/><br />Andrey Gubanov</a></td>
+   <td align="center"><a href="https://github.com/finom?ref=orpc" target="_blank" rel="noopener" title="Andrey Gubanov"><img src="https://avatars.githubusercontent.com/u/1082083?u=c5f2daf7ebece498e85c83367bb37b4e10e2649d&amp;v=4" width="119" alt="Andrey Gubanov"/><br />Andrey Gubanov</a></td>
   </tr>
 </table>
 

package/dist/index.d.mts

@@ -4,12 +4,30 @@ import { ToJSONSchemaParams, $input, $output } from 'zod/v4/core';
 import * as json_schema_typed from 'json-schema-typed';
 
 interface ZodToJsonSchemaConverterOptions extends Omit<ToJSONSchemaParams, 'target' | 'io'> {
+    /**
+     * Caches conversion results in a WeakMap keyed by the Zod schema instance,
+     * so converting the same schema again is free.
+     *
+     * When enabled, repeated conversions return the same JSON schema object,
+     * so treat returned schemas as immutable.
+     *
+     * @default false
+     */
+    cache?: boolean;
 }
+/**
+ * Converts Zod schemas into JSON Schema using Zod's built-in `toJSONSchema`,
+ * with additional support for types such as `z.bigint()`, `z.date()`, `z.set()`, and `z.map()`.
+ *
+ * @see {@link https://orpc.dev/docs/integrations/zod | Zod Integration}
+ */
 declare class ZodToJsonSchemaConverter implements JsonSchemaConverter {
-    private readonly options;
-    constructor(options?: ZodToJsonSchemaConverterOptions);
+    private readonly toJSONSchemaParams;
+    private readonly cache;
+    constructor({ cache, ...toJSONSchemaParams }?: ZodToJsonSchemaConverterOptions);
     condition(schema: AnySchema | undefined, _direction: JsonSchemaConverterDirection): boolean;
     convert(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
+    private convertUncached;
     private convertZod;
     private getCustomJsonSchema;
 }
@@ -30,6 +48,8 @@ declare class ZodToJsonSchemaConverter implements JsonSchemaConverter {
  *   examples: [{ name: 'John', age: 20 }],
  * })
  * ```
+ *
+ * @see {@link https://orpc.dev/docs/integrations/zod | Zod Integration}
  */
 declare const JSON_SCHEMA_REGISTRY: zod_v4_core.$ZodRegistry<{
     $anchor?: string;
@@ -109,6 +129,8 @@ declare const JSON_SCHEMA_REGISTRY: zod_v4_core.$ZodRegistry<{
  *   examples: [{ name: 'John', age: "20" }],
  * })
  * ```
+ *
+ * @see {@link https://orpc.dev/docs/integrations/zod | Zod Integration}
  */
 declare const JSON_SCHEMA_INPUT_REGISTRY: zod_v4_core.$ZodRegistry<{
     $anchor?: string;
@@ -188,6 +210,8 @@ declare const JSON_SCHEMA_INPUT_REGISTRY: zod_v4_core.$ZodRegistry<{
  *   examples: [{ name: 'John', age: 20 }],
  * })
  * ```
+ *
+ * @see {@link https://orpc.dev/docs/integrations/zod | Zod Integration}
  */
 declare const JSON_SCHEMA_OUTPUT_REGISTRY: zod_v4_core.$ZodRegistry<{
     $anchor?: string;

package/dist/index.d.ts

@@ -4,12 +4,30 @@ import { ToJSONSchemaParams, $input, $output } from 'zod/v4/core';
 import * as json_schema_typed from 'json-schema-typed';
 
 interface ZodToJsonSchemaConverterOptions extends Omit<ToJSONSchemaParams, 'target' | 'io'> {
+    /**
+     * Caches conversion results in a WeakMap keyed by the Zod schema instance,
+     * so converting the same schema again is free.
+     *
+     * When enabled, repeated conversions return the same JSON schema object,
+     * so treat returned schemas as immutable.
+     *
+     * @default false
+     */
+    cache?: boolean;
 }
+/**
+ * Converts Zod schemas into JSON Schema using Zod's built-in `toJSONSchema`,
+ * with additional support for types such as `z.bigint()`, `z.date()`, `z.set()`, and `z.map()`.
+ *
+ * @see {@link https://orpc.dev/docs/integrations/zod | Zod Integration}
+ */
 declare class ZodToJsonSchemaConverter implements JsonSchemaConverter {
-    private readonly options;
-    constructor(options?: ZodToJsonSchemaConverterOptions);
+    private readonly toJSONSchemaParams;
+    private readonly cache;
+    constructor({ cache, ...toJSONSchemaParams }?: ZodToJsonSchemaConverterOptions);
     condition(schema: AnySchema | undefined, _direction: JsonSchemaConverterDirection): boolean;
     convert(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
+    private convertUncached;
     private convertZod;
     private getCustomJsonSchema;
 }
@@ -30,6 +48,8 @@ declare class ZodToJsonSchemaConverter implements JsonSchemaConverter {
  *   examples: [{ name: 'John', age: 20 }],
  * })
  * ```
+ *
+ * @see {@link https://orpc.dev/docs/integrations/zod | Zod Integration}
  */
 declare const JSON_SCHEMA_REGISTRY: zod_v4_core.$ZodRegistry<{
     $anchor?: string;
@@ -109,6 +129,8 @@ declare const JSON_SCHEMA_REGISTRY: zod_v4_core.$ZodRegistry<{
  *   examples: [{ name: 'John', age: "20" }],
  * })
  * ```
+ *
+ * @see {@link https://orpc.dev/docs/integrations/zod | Zod Integration}
  */
 declare const JSON_SCHEMA_INPUT_REGISTRY: zod_v4_core.$ZodRegistry<{
     $anchor?: string;
@@ -188,6 +210,8 @@ declare const JSON_SCHEMA_INPUT_REGISTRY: zod_v4_core.$ZodRegistry<{
  *   examples: [{ name: 'John', age: 20 }],
  * })
  * ```
+ *
+ * @see {@link https://orpc.dev/docs/integrations/zod | Zod Integration}
  */
 declare const JSON_SCHEMA_OUTPUT_REGISTRY: zod_v4_core.$ZodRegistry<{
     $anchor?: string;

package/dist/index.mjs

@@ -6,14 +6,32 @@ const JSON_SCHEMA_INPUT_REGISTRY = registry();
 const JSON_SCHEMA_OUTPUT_REGISTRY = registry();
 
 class ZodToJsonSchemaConverter {
-  constructor(options = {}) {
-    this.options = options;
+  toJSONSchemaParams;
+  cache;
+  constructor({ cache, ...toJSONSchemaParams } = {}) {
+    this.toJSONSchemaParams = toJSONSchemaParams;
+    if (cache) {
+      this.cache = { input: /* @__PURE__ */ new WeakMap(), output: /* @__PURE__ */ new WeakMap() };
+    }
   }
   condition(schema, _direction) {
     return schema?.["~standard"].vendor === "zod";
   }
   convert(schema, direction) {
     const zodSchema = schema;
+    if (this.cache) {
+      const cached = this.cache[direction].get(zodSchema);
+      if (cached) {
+        return cached;
+      }
+    }
+    const result = this.convertUncached(zodSchema, direction);
+    if (this.cache) {
+      this.cache[direction].set(zodSchema, result);
+    }
+    return result;
+  }
+  convertUncached(zodSchema, direction) {
     const jsonSchema = this.convertZod(zodSchema, direction);
     let optional = false;
     try {
@@ -28,7 +46,7 @@ class ZodToJsonSchemaConverter {
   convertZod(schema, direction) {
     const jsonSchema = toJSONSchema(schema, {
       unrepresentable: "any",
-      ...this.options,
+      ...this.toJSONSchemaParams,
       target: "draft-2020-12",
       io: direction,
       override: (ctx) => {
@@ -63,11 +81,11 @@ class ZodToJsonSchemaConverter {
         if (customJsonSchema) {
           Object.assign(ctx.jsonSchema, customJsonSchema);
         }
-        this.options.override?.(ctx);
+        this.toJSONSchemaParams.override?.(ctx);
       }
     });
     const { $schema, ...rest } = jsonSchema;
-    const registry = this.options.metadata ?? globalRegistry;
+    const registry = this.toJSONSchemaParams.metadata ?? globalRegistry;
     const { id } = registry.get(schema) || {};
     if (typeof id === "string" && rest.$ref === void 0) {
       const { $defs = {}, ...restWithoutDefs } = rest;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/zod",
   "type": "module",
-  "version": "2.0.0-beta.22",
+  "version": "2.0.0-beta.24",
   "license": "MIT",
   "homepage": "https://orpc.dev",
   "repository": {
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "json-schema-typed": "^8.0.2",
-    "@orpc/json-schema": "2.0.0-beta.22"
+    "@orpc/json-schema": "2.0.0-beta.24"
   },
   "devDependencies": {
     "zod": "^4.4.3"