zod-openapi 5.0.0-beta.16 → 5.0.0-beta.17

package/README.md

@@ -632,6 +632,40 @@ createDocument({
 });
 ```
 
+#### Path Items
+
+Path Items can also be registered
+
+````typescript
+const pathItem: ZodOpenApiPathItemObject = {
+  id: 'some-path-item',
+  get: {
+    responses: {
+      200: {
+        description: '200 OK',
+        content: {
+          'application/json': {
+            schema: z.object({ a: z.string() }),
+          },
+        },
+      },
+    },
+  },
+};
+
+// or
+
+createDocument({
+  components: {
+    pathItems: {
+      'some-path-item': pathItem,
+    },
+  },
+});
+```
+
+
+
 ### Zod Types
 
 Zod types are composed of two different parts: the input and the output. This library decides which type to create based on if it is used in a request or response context.
@@ -652,7 +686,7 @@ In general, you want to avoid using a registered input schema in an output conte
 const schema = z.object({
   name: z.string(),
 });
-```
+````
 
 Input schemas (request bodies, parameters):
 

package/dist/api.js

@@ -1,4 +1,4 @@
-const require_components = require('./components-D-fOeav1.js');
+const require_components = require('./components-D4JjPRqN.js');
 
 exports.createComponents = require_components.createComponents;
 exports.createRegistry = require_components.createRegistry;

package/dist/api.mjs

@@ -1,3 +1,3 @@
-import { createComponents, createRegistry, isAnyZodType, unwrapZodObject } from "./components-Cy7_OKKg.mjs";
+import { createComponents, createRegistry, isAnyZodType, unwrapZodObject } from "./components-CncTLZvX.mjs";
 
 export { createComponents, createRegistry, isAnyZodType, unwrapZodObject };

package/dist/{components-Cy7_OKKg.mjs → components-CncTLZvX.mjs}

@@ -467,6 +467,7 @@ const createRegistry = (components) => {
 			const meta = globalRegistry.get(parameter);
 			const name = opts?.location?.name ?? meta?.param?.name;
 			const inLocation = opts?.location?.in ?? meta?.param?.in;
+			if (opts?.location?.name && meta?.param?.name || opts?.location?.in && meta?.param?.in) throw new Error(`Parameter at ${path.join(" > ")} has both \`.meta({ param: { name, in } })\` and \`.meta({ param: { location: { in, name } } })\` information`);
 			if (!name || !inLocation) throw new Error(`Parameter at ${path.join(" > ")} is missing \`.meta({ param: { name, in } })\` information`);
 			const schemaObject = registry$1.addSchema(parameter, [
 				...path,
@@ -500,6 +501,7 @@ const createRegistry = (components) => {
 				registry$1.components.parameters.ids.set(id, parameterObject);
 				return ref;
 			}
+			if (opts?.location?.name || opts?.location?.in) return parameterObject;
 			registry$1.components.parameters.seen.set(parameter, parameterObject);
 			return parameterObject;
 		},

package/dist/{components-D-fOeav1.js → components-D4JjPRqN.js}

@@ -490,6 +490,7 @@ const createRegistry = (components) => {
 			const meta = zod_v4_core.globalRegistry.get(parameter);
 			const name = opts?.location?.name ?? meta?.param?.name;
 			const inLocation = opts?.location?.in ?? meta?.param?.in;
+			if (opts?.location?.name && meta?.param?.name || opts?.location?.in && meta?.param?.in) throw new Error(`Parameter at ${path.join(" > ")} has both \`.meta({ param: { name, in } })\` and \`.meta({ param: { location: { in, name } } })\` information`);
 			if (!name || !inLocation) throw new Error(`Parameter at ${path.join(" > ")} is missing \`.meta({ param: { name, in } })\` information`);
 			const schemaObject = registry$1.addSchema(parameter, [
 				...path,
@@ -523,6 +524,7 @@ const createRegistry = (components) => {
 				registry$1.components.parameters.ids.set(id, parameterObject);
 				return ref;
 			}
+			if (opts?.location?.name || opts?.location?.in) return parameterObject;
 			registry$1.components.parameters.seen.set(parameter, parameterObject);
 			return parameterObject;
 		},

package/dist/index.js

@@ -1,4 +1,4 @@
-const require_components = require('./components-D-fOeav1.js');
+const require_components = require('./components-D4JjPRqN.js');
 
 //#region src/create/document.ts
 const createDocument = (zodOpenApiObject, opts = {}) => {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { createComponents, createPaths, createRegistry, createSchema } from "./components-Cy7_OKKg.mjs";
+import { createComponents, createPaths, createRegistry, createSchema } from "./components-CncTLZvX.mjs";
 
 //#region src/create/document.ts
 const createDocument = (zodOpenApiObject, opts = {}) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zod-openapi",
-  "version": "5.0.0-beta.16",
+  "version": "5.0.0-beta.17",
   "description": "Convert Zod Schemas to OpenAPI v3.x documentation",
   "keywords": [
     "typescript",