@mastra/schema-compat 1.0.0-beta.3 → 1.0.0-beta.5

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @mastra/schema-compat
 
+## 1.0.0-beta.5
+
+### Patch Changes
+
+- Fixed "Transforms cannot be represented in JSON Schema" error when using Zod v4 with structuredOutput ([#11466](https://github.com/mastra-ai/mastra/pull/11466))
+
+  When using schemas with `.optional()`, `.nullable()`, `.default()`, or `.nullish().default("")` patterns with `structuredOutput` and Zod v4, users would encounter an error because OpenAI schema compatibility layer adds transforms that Zod v4's native `toJSONSchema()` cannot handle.
+
+  The fix uses Mastra's transform-safe `zodToJsonSchema` function which gracefully handles transforms by using the `unrepresentable: 'any'` option.
+
+  Also exported `isZodType` utility from `@mastra/schema-compat` and updated it to detect both Zod v3 (`_def`) and Zod v4 (`_zod`) schemas.
+
+- fix(schema-compat): handle undefined values in optional fields for OpenAI compat layers ([#11469](https://github.com/mastra-ai/mastra/pull/11469))
+
+  When a Zod schema has nested objects with `.partial()`, the optional fields would fail validation with "expected string, received undefined" errors. This occurred because the OpenAI schema compat layer converted `.optional()` to `.nullable()`, which only accepts `null` values, not `undefined`.
+
+  Changed `.nullable()` to `.nullish()` so that optional fields now accept both `null` (when explicitly provided by the LLM) and `undefined` (when fields are omitted entirely).
+
+  Fixes #11457
+
+## 1.0.0-beta.4
+
+### Patch Changes
+
+- Fix OpenAI structured output compatibility for fields with `.default()` values ([#11434](https://github.com/mastra-ai/mastra/pull/11434))
+
+  When using Zod schemas with `.default()` fields (e.g., `z.number().default(1)`), OpenAI's structured output API was failing with errors like `Missing '<field>' in required`. This happened because `zod-to-json-schema` doesn't include fields with defaults in the `required` array, but OpenAI requires all properties to be required.
+
+  This fix converts `.default()` fields to `.nullable()` with a transform that returns the default value when `null` is received, ensuring compatibility with OpenAI's strict mode while preserving the original default value semantics.
+
 ## 1.0.0-beta.3
 
 ### Patch Changes

package/dist/index.cjs

@@ -3577,7 +3577,7 @@ function convertZodSchemaToAISDKSchema(zodSchema2, target = "jsonSchema7") {
   });
 }
 function isZodType(value) {
-  return typeof value === "object" && value !== null && "_def" in value && "parse" in value && typeof value.parse === "function" && "safeParse" in value && typeof value.safeParse === "function";
+  return typeof value === "object" && value !== null && ("_def" in value || "_zod" in value) && "parse" in value && typeof value.parse === "function" && "safeParse" in value && typeof value.safeParse === "function";
 }
 function convertSchemaToZod(schema) {
   if (isZodType(schema)) {
@@ -4874,6 +4874,19 @@ var OpenAISchemaCompatLayer = class extends SchemaCompatLayer3 {
         return processedInner.nullable();
       }
       return value;
+    } else if (isDefault(zod.z)(value)) {
+      const innerType = "_def" in value ? value._def.innerType : value._zod?.def?.innerType;
+      const defaultValue = "_def" in value ? value._def.defaultValue : value._zod?.def?.defaultValue;
+      if (innerType) {
+        const processedInner = this.processZodType(innerType);
+        return processedInner.nullable().transform((val) => {
+          if (val === null) {
+            return typeof defaultValue === "function" ? defaultValue() : defaultValue;
+          }
+          return val;
+        });
+      }
+      return value;
     } else if (isObj2(zod.z)(value)) {
       return this.defaultZodObjectHandler(value);
     } else if (isUnion2(zod.z)(value)) {
@@ -4997,6 +5010,7 @@ exports.isObj = isObj;
 exports.isOptional = isOptional;
 exports.isString = isString;
 exports.isUnion = isUnion;
+exports.isZodType = isZodType;
 exports.jsonSchema = jsonSchema;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map