chore: compat with zod v4 (#1658)

Guthias · Abdillah · RobertCraigie · web-flow · commit 94569a07ce55 · 2025-09-30T13:15:46.000+01:00
Co-authored-by: Hernawan Faiz Abdillah &lt;hernawan.faiz.abdillah@gmail.com&gt;
Co-authored-by: Robert Craigie &lt;robert@craigie.dev&gt;
diff --git a/examples/parsing-run-tools.ts b/examples/parsing-run-tools.ts
@@ -1,5 +1,5 @@
 import OpenAI from 'openai';
-import z from 'zod';
+import z from 'zod/v3';
 import { zodFunction } from 'openai/helpers/zod';
 
 const Table = z.enum(['orders', 'customers', 'products']);
diff --git a/examples/parsing-stream.ts b/examples/parsing-stream.ts
@@ -1,6 +1,6 @@
 import { zodResponseFormat } from 'openai/helpers/zod';
 import OpenAI from 'openai/index';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const Step = z.object({
   explanation: z.string(),
diff --git a/examples/parsing-tools-stream.ts b/examples/parsing-tools-stream.ts
@@ -1,6 +1,6 @@
 import { zodFunction } from 'openai/helpers/zod';
 import OpenAI from 'openai/index';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const GetWeatherArgs = z.object({
   city: z.string(),
diff --git a/examples/parsing-tools.ts b/examples/parsing-tools.ts
@@ -1,6 +1,6 @@
 import { zodFunction } from 'openai/helpers/zod';
 import OpenAI from 'openai/index';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const Table = z.enum(['orders', 'customers', 'products']);
 
diff --git a/examples/parsing.ts b/examples/parsing.ts
@@ -1,6 +1,6 @@
 import { zodResponseFormat } from 'openai/helpers/zod';
 import OpenAI from 'openai/index';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const Step = z.object({
   explanation: z.string(),
diff --git a/examples/responses/streaming-tools.ts b/examples/responses/streaming-tools.ts
@@ -2,7 +2,7 @@
 
 import { OpenAI } from 'openai';
 import { zodResponsesFunction } from 'openai/helpers/zod';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const Table = z.enum(['orders', 'customers', 'products']);
 const Column = z.enum([
diff --git a/examples/responses/structured-outputs-tools.ts b/examples/responses/structured-outputs-tools.ts
@@ -2,7 +2,7 @@
 
 import { OpenAI } from 'openai';
 import { zodResponsesFunction } from 'openai/helpers/zod';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const Table = z.enum(['orders', 'customers', 'products']);
 const Column = z.enum([
diff --git a/examples/responses/structured-outputs.ts b/examples/responses/structured-outputs.ts
@@ -2,7 +2,7 @@
 
 import { OpenAI } from 'openai';
 import { zodTextFormat } from 'openai/helpers/zod';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const Step = z.object({
   explanation: z.string(),
diff --git a/examples/tool-call-helpers-zod.ts b/examples/tool-call-helpers-zod.ts
@@ -2,7 +2,7 @@
 
 import OpenAI from 'openai';
 import { zodFunction } from 'openai/helpers/zod';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 // gets API Key from environment variable OPENAI_API_KEY
 const openai = new OpenAI();
diff --git a/examples/ui-generation.ts b/examples/ui-generation.ts
@@ -1,5 +1,5 @@
 import OpenAI from 'openai';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 import { zodResponseFormat } from 'openai/helpers/zod';
 
 const openai = new OpenAI();
diff --git a/helpers.md b/helpers.md
@@ -13,7 +13,7 @@ into a JSON schema, send it to the API and parse the response content back using
 ```ts
 import { zodResponseFormat } from 'openai/helpers/zod';
 import OpenAI from 'openai/index';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const Step = z.object({
   explanation: z.string(),
@@ -57,7 +57,7 @@ For example:
 ```ts
 import { zodFunction } from 'openai/helpers/zod';
 import OpenAI from 'openai/index';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const Table = z.enum(['orders', 'customers', 'products']);
 
@@ -630,7 +630,7 @@ assistant's response to make sure it conforms to a schema. Paired with [`zod-to-
 
 ```ts
 import OpenAI from 'openai';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 
 const client = new OpenAI();
diff --git a/package.json b/package.json
@@ -52,7 +52,7 @@
     "tslib": "^2.8.1",
     "typescript": "5.8.3",
     "ws": "^8.18.0",
-    "zod": "^3.23.8",
+    "zod": "^3.25 || ^4.0",
     "typescript-eslint": "8.31.1"
   },
   "bin": {
@@ -76,7 +76,7 @@
   },
   "peerDependencies": {
     "ws": "^8.18.0",
-    "zod": "^3.23.8"
+    "zod": "^3.25 || ^4.0"
   },
   "peerDependenciesMeta": {
     "ws": {
diff --git a/src/_vendor/zod-to-json-schema/Options.ts b/src/_vendor/zod-to-json-schema/Options.ts
@@ -1,4 +1,4 @@
-import { ZodSchema, ZodTypeDef } from 'zod';
+import { ZodSchema, ZodTypeDef } from 'zod/v3';
 import { Refs, Seen } from './Refs';
 import { JsonSchema7Type } from './parseDef';
 
diff --git a/src/_vendor/zod-to-json-schema/Refs.ts b/src/_vendor/zod-to-json-schema/Refs.ts
@@ -1,4 +1,4 @@
-import type { ZodTypeDef } from 'zod';
+import type { ZodTypeDef } from 'zod/v3';
 import { getDefaultOptions, Options, Targets } from './Options';
 import { JsonSchema7Type } from './parseDef';
 import { zodDef } from './util';
diff --git a/src/_vendor/zod-to-json-schema/parseDef.ts b/src/_vendor/zod-to-json-schema/parseDef.ts
@@ -1,4 +1,4 @@
-import { ZodFirstPartyTypeKind, ZodTypeDef } from 'zod';
+import { ZodFirstPartyTypeKind, ZodTypeDef } from 'zod/v3';
 import { JsonSchema7AnyType, parseAnyDef } from './parsers/any';
 import { JsonSchema7ArrayType, parseArrayDef } from './parsers/array';
 import { JsonSchema7BigintType, parseBigintDef } from './parsers/bigint';
diff --git a/src/_vendor/zod-to-json-schema/parsers/array.ts b/src/_vendor/zod-to-json-schema/parsers/array.ts
@@ -1,4 +1,4 @@
-import { ZodArrayDef, ZodFirstPartyTypeKind } from 'zod';
+import { ZodArrayDef, ZodFirstPartyTypeKind } from 'zod/v3';
 import { ErrorMessages, setResponseValueAndErrors } from '../errorMessages';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
diff --git a/src/_vendor/zod-to-json-schema/parsers/bigint.ts b/src/_vendor/zod-to-json-schema/parsers/bigint.ts
@@ -1,4 +1,4 @@
-import { ZodBigIntDef } from 'zod';
+import { ZodBigIntDef } from 'zod/v3';
 import { Refs } from '../Refs';
 import { ErrorMessages, setResponseValueAndErrors } from '../errorMessages';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/branded.ts b/src/_vendor/zod-to-json-schema/parsers/branded.ts
@@ -1,4 +1,4 @@
-import { ZodBrandedDef } from 'zod';
+import { ZodBrandedDef } from 'zod/v3';
 import { parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/catch.ts b/src/_vendor/zod-to-json-schema/parsers/catch.ts
@@ -1,4 +1,4 @@
-import { ZodCatchDef } from 'zod';
+import { ZodCatchDef } from 'zod/v3';
 import { parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/date.ts b/src/_vendor/zod-to-json-schema/parsers/date.ts
@@ -1,4 +1,4 @@
-import { ZodDateDef } from 'zod';
+import { ZodDateDef } from 'zod/v3';
 import { Refs } from '../Refs';
 import { ErrorMessages, setResponseValueAndErrors } from '../errorMessages';
 import { JsonSchema7NumberType } from './number';
diff --git a/src/_vendor/zod-to-json-schema/parsers/default.ts b/src/_vendor/zod-to-json-schema/parsers/default.ts
@@ -1,4 +1,4 @@
-import { ZodDefaultDef } from 'zod';
+import { ZodDefaultDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/effects.ts b/src/_vendor/zod-to-json-schema/parsers/effects.ts
@@ -1,4 +1,4 @@
-import { ZodEffectsDef } from 'zod';
+import { ZodEffectsDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/enum.ts b/src/_vendor/zod-to-json-schema/parsers/enum.ts
@@ -1,4 +1,4 @@
-import { ZodEnumDef } from 'zod';
+import { ZodEnumDef } from 'zod/v3';
 
 export type JsonSchema7EnumType = {
   type: 'string';
diff --git a/src/_vendor/zod-to-json-schema/parsers/intersection.ts b/src/_vendor/zod-to-json-schema/parsers/intersection.ts
@@ -1,4 +1,4 @@
-import { ZodIntersectionDef } from 'zod';
+import { ZodIntersectionDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 import { JsonSchema7StringType } from './string';
diff --git a/src/_vendor/zod-to-json-schema/parsers/literal.ts b/src/_vendor/zod-to-json-schema/parsers/literal.ts
@@ -1,4 +1,4 @@
-import { ZodLiteralDef } from 'zod';
+import { ZodLiteralDef } from 'zod/v3';
 import { Refs } from '../Refs';
 
 export type JsonSchema7LiteralType =
diff --git a/src/_vendor/zod-to-json-schema/parsers/map.ts b/src/_vendor/zod-to-json-schema/parsers/map.ts
@@ -1,4 +1,4 @@
-import { ZodMapDef } from 'zod';
+import { ZodMapDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 import { JsonSchema7RecordType, parseRecordDef } from './record';
diff --git a/src/_vendor/zod-to-json-schema/parsers/nativeEnum.ts b/src/_vendor/zod-to-json-schema/parsers/nativeEnum.ts
@@ -1,4 +1,4 @@
-import { ZodNativeEnumDef } from 'zod';
+import { ZodNativeEnumDef } from 'zod/v3';
 
 export type JsonSchema7NativeEnumType = {
   type: 'string' | 'number' | ['string', 'number'];
diff --git a/src/_vendor/zod-to-json-schema/parsers/nullable.ts b/src/_vendor/zod-to-json-schema/parsers/nullable.ts
@@ -1,4 +1,4 @@
-import { ZodNullableDef } from 'zod';
+import { ZodNullableDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 import { JsonSchema7NullType } from './null';
diff --git a/src/_vendor/zod-to-json-schema/parsers/number.ts b/src/_vendor/zod-to-json-schema/parsers/number.ts
@@ -1,4 +1,4 @@
-import { ZodNumberDef } from 'zod';
+import { ZodNumberDef } from 'zod/v3';
 import { addErrorMessage, ErrorMessages, setResponseValueAndErrors } from '../errorMessages';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/object.ts b/src/_vendor/zod-to-json-schema/parsers/object.ts
@@ -1,4 +1,4 @@
-import { ZodObjectDef } from 'zod';
+import { ZodObjectDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/optional.ts b/src/_vendor/zod-to-json-schema/parsers/optional.ts
@@ -1,4 +1,4 @@
-import { ZodOptionalDef } from 'zod';
+import { ZodOptionalDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/pipeline.ts b/src/_vendor/zod-to-json-schema/parsers/pipeline.ts
@@ -1,4 +1,4 @@
-import { ZodPipelineDef } from 'zod';
+import { ZodPipelineDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 import { JsonSchema7AllOfType } from './intersection';
diff --git a/src/_vendor/zod-to-json-schema/parsers/promise.ts b/src/_vendor/zod-to-json-schema/parsers/promise.ts
@@ -1,4 +1,4 @@
-import { ZodPromiseDef } from 'zod';
+import { ZodPromiseDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/readonly.ts b/src/_vendor/zod-to-json-schema/parsers/readonly.ts
@@ -1,4 +1,4 @@
-import { ZodReadonlyDef } from 'zod';
+import { ZodReadonlyDef } from 'zod/v3';
 import { parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/record.ts b/src/_vendor/zod-to-json-schema/parsers/record.ts
@@ -1,4 +1,4 @@
-import { ZodFirstPartyTypeKind, ZodMapDef, ZodRecordDef, ZodTypeAny } from 'zod';
+import { ZodFirstPartyTypeKind, ZodMapDef, ZodRecordDef, ZodTypeAny } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 import { JsonSchema7EnumType } from './enum';
diff --git a/src/_vendor/zod-to-json-schema/parsers/set.ts b/src/_vendor/zod-to-json-schema/parsers/set.ts
@@ -1,4 +1,4 @@
-import { ZodSetDef } from 'zod';
+import { ZodSetDef } from 'zod/v3';
 import { ErrorMessages, setResponseValueAndErrors } from '../errorMessages';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
diff --git a/src/_vendor/zod-to-json-schema/parsers/string.ts b/src/_vendor/zod-to-json-schema/parsers/string.ts
@@ -1,5 +1,5 @@
 // @ts-nocheck
-import { ZodStringDef } from 'zod';
+import { ZodStringDef } from 'zod/v3';
 import { ErrorMessages, setResponseValueAndErrors } from '../errorMessages';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/tuple.ts b/src/_vendor/zod-to-json-schema/parsers/tuple.ts
@@ -1,4 +1,4 @@
-import { ZodTupleDef, ZodTupleItems, ZodTypeAny } from 'zod';
+import { ZodTupleDef, ZodTupleItems, ZodTypeAny } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/parsers/union.ts b/src/_vendor/zod-to-json-schema/parsers/union.ts
@@ -1,4 +1,4 @@
-import { ZodDiscriminatedUnionDef, ZodLiteralDef, ZodTypeAny, ZodUnionDef } from 'zod';
+import { ZodDiscriminatedUnionDef, ZodLiteralDef, ZodTypeAny, ZodUnionDef } from 'zod/v3';
 import { JsonSchema7Type, parseDef } from '../parseDef';
 import { Refs } from '../Refs';
 
diff --git a/src/_vendor/zod-to-json-schema/util.ts b/src/_vendor/zod-to-json-schema/util.ts
@@ -1,4 +1,4 @@
-import type { ZodSchema, ZodTypeDef } from 'zod';
+import type { ZodSchema, ZodTypeDef } from 'zod/v3';
 
 export const zodDef = (zodSchema: ZodSchema | ZodTypeDef): ZodTypeDef => {
   return '_def' in zodSchema ? zodSchema._def : zodSchema;
diff --git a/src/_vendor/zod-to-json-schema/zodToJsonSchema.ts b/src/_vendor/zod-to-json-schema/zodToJsonSchema.ts
@@ -1,4 +1,4 @@
-import { ZodSchema } from 'zod';
+import { ZodSchema } from 'zod/v3';
 import { Options, Targets } from './Options';
 import { JsonSchema7Type, parseDef } from './parseDef';
 import { getRefs } from './Refs';
diff --git a/src/helpers/zod.ts b/src/helpers/zod.ts
@@ -1,5 +1,5 @@
 import { ResponseFormatJSONSchema } from '../resources/index';
-import type { infer as zodInfer, ZodType } from 'zod';
+import type { infer as zodInfer, ZodType } from 'zod/v3';
 import {
   AutoParseableResponseFormat,
   AutoParseableTextFormat,
diff --git a/tests/helpers/zod.test.ts b/tests/helpers/zod.test.ts
@@ -1,5 +1,5 @@
 import { zodResponseFormat } from 'openai/helpers/zod';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 describe('zodResponseFormat', () => {
   it('does the thing', () => {
diff --git a/tests/lib/ChatCompletionStream.test.ts b/tests/lib/ChatCompletionStream.test.ts
@@ -1,6 +1,6 @@
 import { zodResponseFormat } from 'openai/helpers/zod';
 import { ChatCompletionTokenLogprob } from 'openai/resources';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 import { makeStreamSnapshotRequest } from '../utils/mock-snapshots';
 
 jest.setTimeout(1000 * 30);
diff --git a/tests/lib/parser.test.ts b/tests/lib/parser.test.ts
@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v3';
 import { zodResponseFormat } from 'openai/helpers/zod';
 import { makeSnapshotRequest } from '../utils/mock-snapshots';
 
diff --git a/yarn.lock b/yarn.lock
@@ -3523,7 +3523,7 @@ yocto-queue@^0.1.0:
   resolved "https://registry.yarnpkg.com/yocto-queue/-/yocto-queue-0.1.0.tgz#0294eb3dee05028d31ee1a5fa2c556a6aaf10a1b"
   integrity sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==
 
-zod@^3.23.8:
-  version "3.24.1"
-  resolved "https://registry.yarnpkg.com/zod/-/zod-3.24.1.tgz#27445c912738c8ad1e9de1bea0359fa44d9d35ee"
-  integrity sha512-muH7gBL9sI1nciMZV67X5fTKKBLtwpZ5VBp1vsOQzj1MhrBZ4wlVCm3gedKZWLp0Oyel8sIGfeiz54Su+OVT+A==
+"zod@^3.25 || ^4.0":
+  version "4.1.11"
+  resolved "https://registry.yarnpkg.com/zod/-/zod-4.1.11.tgz#4aab62f76cfd45e6c6166519ba31b2ea019f75f5"
+  integrity sha512-WPsqwxITS2tzx1bzhIKsEs19ABD5vmCVa4xBo2tq/SrV4RNZtfws1EnCWQXM6yh8bD08a1idvkB5MZSBiZsjwg==
