fix(#178): handle $ref in response object

.changeset/quick-jeans-hope.md

@@ -0,0 +1,5 @@
+---
+"openapi-zod-client": minor
+---
+
+handle $ref in responses object

lib/src/getZodiosEndpointDefinitionList.ts

@@ -281,7 +281,9 @@ export const getZodiosEndpointDefinitionList = (doc: OpenAPIObject, options?: Te
             }
 
             for (const statusCode in operation.responses) {
-                const responseItem = operation.responses[statusCode] as ResponseObject;
+                const responseItem = (
+                    isReferenceObject(operation.responses[statusCode]) ? ctx.resolver.getSchemaByRef(operation.responses[statusCode].$ref) : operation.responses[statusCode]
+                ) as ResponseObject;
 
                 const mediaTypes = Object.keys(responseItem.content ?? {});
                 const matchingMediaType = mediaTypes.find(isMediaTypeAllowed);

lib/tests/resolve-ref-responses.test.ts

@@ -0,0 +1,59 @@
+import { getZodiosEndpointDefinitionList } from "../src";
+import { expect, test } from "vitest";
+
+test("resolve-ref-responses", () => {
+    // Without the refiner function passed.
+    expect(
+        getZodiosEndpointDefinitionList({
+            openapi: "3.0.3",
+            info: { version: "1", title: "Example API" },
+            paths: {
+                "/": {
+                    get: {
+                        operationId: "getExample",
+                        responses: {
+                            "200": {
+                                $ref: "#/components/responses/ExampleResponse"
+                            },
+                        },
+                    },
+                },
+            },
+            components: {
+                responses: {
+                    ExampleResponse: {
+                        description: "example response",
+                        content: { "application/json": { schema: { type: "string" } } },
+                    }
+                }
+            },
+        })
+    ).toMatchInlineSnapshot(`
+      {
+          "deepDependencyGraph": {},
+          "endpoints": [
+              {
+                  "description": undefined,
+                  "errors": [],
+                  "method": "get",
+                  "parameters": [],
+                  "path": "/",
+                  "requestFormat": "json",
+                  "response": "z.string()",
+              },
+          ],
+          "issues": {
+              "ignoredFallbackResponse": [],
+              "ignoredGenericError": [],
+          },
+          "refsDependencyGraph": {},
+          "resolver": {
+              "getSchemaByRef": [Function],
+              "resolveRef": [Function],
+              "resolveSchemaName": [Function],
+          },
+          "schemaByName": {},
+          "zodSchemaByName": {},
+      }
+    `);
+});