fix(zod): zod to json schema not covert zod description

Author: unnoq

packages/zod/src/converter.test.ts

@@ -389,3 +389,34 @@ describe('with custom json schema', () => {
     })
   })
 })
+
+it('zod description', () => {
+  const schema = z.object({
+    name: z.string().describe('name description'),
+
+    nested: z.object({
+      name: z.string().describe('nested name description'),
+    }),
+  })
+
+  expect(zodToJsonSchema(schema)).toEqual({
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+        description: 'name description',
+      },
+      nested: {
+        type: 'object',
+        properties: {
+          name: {
+            type: 'string',
+            description: 'nested name description',
+          },
+        },
+        required: ['name'],
+      },
+    },
+    required: ['name', 'nested'],
+  })
+})

packages/zod/src/converter.ts

@@ -105,6 +105,13 @@ export interface ZodToJsonSchemaOptions {
    * @internal
    */
   isHandledCustomJSONSchema?: boolean
+
+  /**
+   * Track if current level schema is handled zod description to prevent recursive
+   *
+   * @internal
+   */
+  isHandledZodDescription?: boolean
 }
 
 export function zodToJsonSchema(
@@ -118,6 +125,18 @@ export function zodToJsonSchema(
 
   const schema__ = schema as ZodTypeAny
 
+  if (!options?.isHandledZodDescription && 'description' in schema__._def) {
+    const json = zodToJsonSchema(schema__, {
+      ...options,
+      isHandledZodDescription: true,
+    })
+
+    return {
+      description: schema__._def.description,
+      ...json,
+    }
+  }
+
   if (!options?.isHandledCustomJSONSchema) {
     const customJSONSchema = getCustomJSONSchema(schema__._def, options)