@amqp-contract/zod 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Benoit Travers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,79 @@
+# @amqp-contract/zod
+
+Zod integration for amqp-contract. This package provides a schema converter for AsyncAPI generation and declares peer dependencies for [Zod](https://zod.dev/) compatibility with amqp-contract.
+
+## Installation
+
+```bash
+npm install @amqp-contract/contract @amqp-contract/zod zod
+# or
+pnpm add @amqp-contract/contract @amqp-contract/zod zod
+# or
+yarn add @amqp-contract/contract @amqp-contract/zod zod
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { z } from 'zod';
+import {
+  defineContract,
+  defineExchange,
+  defineQueue,
+  definePublisher,
+  defineConsumer,
+} from '@amqp-contract/contract';
+
+// Define your schemas using Zod
+const orderSchema = z.object({
+  orderId: z.string(),
+  amount: z.number(),
+});
+
+// Define your contract
+const contract = defineContract({
+  exchanges: {
+    orders: defineExchange('orders', 'topic', { durable: true }),
+  },
+  queues: {
+    orderProcessing: defineQueue('order-processing', { durable: true }),
+  },
+  publishers: {
+    orderCreated: definePublisher('orders', orderSchema),
+  },
+  consumers: {
+    processOrder: defineConsumer('order-processing', orderSchema),
+  },
+});
+```
+
+### AsyncAPI Generation
+
+```typescript
+import { zodToJsonSchema } from '@amqp-contract/zod';
+import { generateAsyncAPI } from '@amqp-contract/asyncapi';
+
+// Convert Zod schemas to JSON Schema for AsyncAPI
+const jsonSchema = zodToJsonSchema(orderSchema);
+
+// Generate AsyncAPI specification
+const asyncAPISpec = generateAsyncAPI(contract, {
+  info: {
+    title: 'My API',
+    version: '1.0.0',
+  },
+});
+```
+
+## Features
+
+- **Type Safety**: Full TypeScript support with type inference from Zod schemas
+- **Standard Schema**: Uses the Standard Schema specification for interoperability
+- **AsyncAPI Support**: Provides `zodToJsonSchema` converter for AsyncAPI generation
+- **Peer Dependency Management**: Declares compatible Zod versions as peer dependencies
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,51 @@
+
+//#region src/schema-converter.ts
+/**
+* Convert a Zod schema to JSON Schema (AsyncAPI format)
+*
+* This converter specifically handles Zod schemas and converts them
+* to JSON Schema format compatible with AsyncAPI.
+*/
+function zodToJsonSchema(schema) {
+	if (typeof schema !== "object" || schema === null) return { type: "object" };
+	const schemaType = schema["type"];
+	const def = schema["def"];
+	if (schemaType === "object") {
+		const shape = def?.["shape"];
+		if (!shape) return { type: "object" };
+		const properties = {};
+		const required = [];
+		for (const [key, value] of Object.entries(shape)) {
+			properties[key] = zodToJsonSchema(value);
+			if (value?.["type"] !== "optional") required.push(key);
+		}
+		const result = {
+			type: "object",
+			properties
+		};
+		if (required.length > 0) result.required = required;
+		return result;
+	}
+	if (schemaType === "string") return { type: "string" };
+	if (schemaType === "number") return { type: "number" };
+	if (schemaType === "boolean") return { type: "boolean" };
+	if (schemaType === "array") {
+		const element = def?.["element"];
+		return {
+			type: "array",
+			items: element ? zodToJsonSchema(element) : { type: "object" }
+		};
+	}
+	if (schemaType === "optional") {
+		const innerType = def?.["innerType"];
+		return innerType ? zodToJsonSchema(innerType) : { type: "object" };
+	}
+	if (schemaType === "enum" || schemaType === "nativeEnum") return {
+		type: "string",
+		enum: def?.["values"] || []
+	};
+	return { type: "object" };
+}
+
+//#endregion
+exports.zodToJsonSchema = zodToJsonSchema;

package/dist/index.d.cts

@@ -0,0 +1,14 @@
+import { AsyncAPISchema } from "@amqp-contract/asyncapi";
+
+//#region src/schema-converter.d.ts
+
+/**
+ * Convert a Zod schema to JSON Schema (AsyncAPI format)
+ *
+ * This converter specifically handles Zod schemas and converts them
+ * to JSON Schema format compatible with AsyncAPI.
+ */
+declare function zodToJsonSchema(schema: Record<string, unknown>): AsyncAPISchema;
+//#endregion
+export { zodToJsonSchema };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/schema-converter.ts"],"sourcesContent":[],"mappings":";;;;;;AAQA;;;;iBAAgB,eAAA,SAAwB,0BAA0B"}

package/dist/index.d.mts

@@ -0,0 +1,14 @@
+import { AsyncAPISchema } from "@amqp-contract/asyncapi";
+
+//#region src/schema-converter.d.ts
+
+/**
+ * Convert a Zod schema to JSON Schema (AsyncAPI format)
+ *
+ * This converter specifically handles Zod schemas and converts them
+ * to JSON Schema format compatible with AsyncAPI.
+ */
+declare function zodToJsonSchema(schema: Record<string, unknown>): AsyncAPISchema;
+//#endregion
+export { zodToJsonSchema };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schema-converter.ts"],"sourcesContent":[],"mappings":";;;;;;AAQA;;;;iBAAgB,eAAA,SAAwB,0BAA0B"}

package/dist/index.mjs

@@ -0,0 +1,51 @@
+//#region src/schema-converter.ts
+/**
+* Convert a Zod schema to JSON Schema (AsyncAPI format)
+*
+* This converter specifically handles Zod schemas and converts them
+* to JSON Schema format compatible with AsyncAPI.
+*/
+function zodToJsonSchema(schema) {
+	if (typeof schema !== "object" || schema === null) return { type: "object" };
+	const schemaType = schema["type"];
+	const def = schema["def"];
+	if (schemaType === "object") {
+		const shape = def?.["shape"];
+		if (!shape) return { type: "object" };
+		const properties = {};
+		const required = [];
+		for (const [key, value] of Object.entries(shape)) {
+			properties[key] = zodToJsonSchema(value);
+			if (value?.["type"] !== "optional") required.push(key);
+		}
+		const result = {
+			type: "object",
+			properties
+		};
+		if (required.length > 0) result.required = required;
+		return result;
+	}
+	if (schemaType === "string") return { type: "string" };
+	if (schemaType === "number") return { type: "number" };
+	if (schemaType === "boolean") return { type: "boolean" };
+	if (schemaType === "array") {
+		const element = def?.["element"];
+		return {
+			type: "array",
+			items: element ? zodToJsonSchema(element) : { type: "object" }
+		};
+	}
+	if (schemaType === "optional") {
+		const innerType = def?.["innerType"];
+		return innerType ? zodToJsonSchema(innerType) : { type: "object" };
+	}
+	if (schemaType === "enum" || schemaType === "nativeEnum") return {
+		type: "string",
+		enum: def?.["values"] || []
+	};
+	return { type: "object" };
+}
+
+//#endregion
+export { zodToJsonSchema };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["properties: Record<string, AsyncAPISchema>","required: string[]","result: AsyncAPISchema"],"sources":["../src/schema-converter.ts"],"sourcesContent":["import type { AsyncAPISchema } from \"@amqp-contract/asyncapi\";\n\n/**\n * Convert a Zod schema to JSON Schema (AsyncAPI format)\n *\n * This converter specifically handles Zod schemas and converts them\n * to JSON Schema format compatible with AsyncAPI.\n */\nexport function zodToJsonSchema(schema: Record<string, unknown>): AsyncAPISchema {\n  // Handle Zod structure\n  if (typeof schema !== \"object\" || schema === null) {\n    return { type: \"object\" };\n  }\n\n  // Get the schema type - Zod 4.x uses `type` at top level\n  const schemaType = schema[\"type\"];\n  const def = schema[\"def\"] as Record<string, unknown> | undefined;\n\n  // Handle different Zod types based on the type field\n  if (schemaType === \"object\") {\n    // For Zod objects, shape is in def.shape\n    const shape = def?.[\"shape\"] as Record<string, unknown> | undefined;\n    if (!shape) {\n      return { type: \"object\" };\n    }\n\n    const properties: Record<string, AsyncAPISchema> = {};\n    const required: string[] = [];\n\n    for (const [key, value] of Object.entries(shape)) {\n      properties[key] = zodToJsonSchema(value as Record<string, unknown>);\n\n      // Check if optional - optional schemas have type \"optional\"\n      const valueType = (value as Record<string, unknown>)?.[\"type\"];\n      if (valueType !== \"optional\") {\n        required.push(key);\n      }\n    }\n\n    const result: AsyncAPISchema = {\n      type: \"object\",\n      properties,\n    };\n\n    if (required.length > 0) {\n      result.required = required;\n    }\n\n    return result;\n  }\n\n  if (schemaType === \"string\") {\n    return { type: \"string\" };\n  }\n\n  if (schemaType === \"number\") {\n    return { type: \"number\" };\n  }\n\n  if (schemaType === \"boolean\") {\n    return { type: \"boolean\" };\n  }\n\n  if (schemaType === \"array\") {\n    // For arrays, the element type is in def.element\n    const element = def?.[\"element\"] as Record<string, unknown> | undefined;\n    return {\n      type: \"array\",\n      items: element ? zodToJsonSchema(element) : { type: \"object\" },\n    };\n  }\n\n  if (schemaType === \"optional\") {\n    // For optional types, get the inner type\n    const innerType = def?.[\"innerType\"] as Record<string, unknown> | undefined;\n    return innerType ? zodToJsonSchema(innerType) : { type: \"object\" };\n  }\n\n  if (schemaType === \"enum\" || schemaType === \"nativeEnum\") {\n    // For enums, values are in def.values\n    const values = def?.[\"values\"] as unknown[] | undefined;\n    return {\n      type: \"string\",\n      enum: values || [],\n    };\n  }\n\n  // Default fallback\n  return { type: \"object\" };\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,gBAAgB,QAAiD;AAE/E,KAAI,OAAO,WAAW,YAAY,WAAW,KAC3C,QAAO,EAAE,MAAM,UAAU;CAI3B,MAAM,aAAa,OAAO;CAC1B,MAAM,MAAM,OAAO;AAGnB,KAAI,eAAe,UAAU;EAE3B,MAAM,QAAQ,MAAM;AACpB,MAAI,CAAC,MACH,QAAO,EAAE,MAAM,UAAU;EAG3B,MAAMA,aAA6C,EAAE;EACrD,MAAMC,WAAqB,EAAE;AAE7B,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,EAAE;AAChD,cAAW,OAAO,gBAAgB,MAAiC;AAInE,OADmB,QAAoC,YACrC,WAChB,UAAS,KAAK,IAAI;;EAItB,MAAMC,SAAyB;GAC7B,MAAM;GACN;GACD;AAED,MAAI,SAAS,SAAS,EACpB,QAAO,WAAW;AAGpB,SAAO;;AAGT,KAAI,eAAe,SACjB,QAAO,EAAE,MAAM,UAAU;AAG3B,KAAI,eAAe,SACjB,QAAO,EAAE,MAAM,UAAU;AAG3B,KAAI,eAAe,UACjB,QAAO,EAAE,MAAM,WAAW;AAG5B,KAAI,eAAe,SAAS;EAE1B,MAAM,UAAU,MAAM;AACtB,SAAO;GACL,MAAM;GACN,OAAO,UAAU,gBAAgB,QAAQ,GAAG,EAAE,MAAM,UAAU;GAC/D;;AAGH,KAAI,eAAe,YAAY;EAE7B,MAAM,YAAY,MAAM;AACxB,SAAO,YAAY,gBAAgB,UAAU,GAAG,EAAE,MAAM,UAAU;;AAGpE,KAAI,eAAe,UAAU,eAAe,aAG1C,QAAO;EACL,MAAM;EACN,MAHa,MAAM,aAGH,EAAE;EACnB;AAIH,QAAO,EAAE,MAAM,UAAU"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@amqp-contract/zod",
+  "version": "0.0.1",
+  "description": "Zod integration for amqp-contract",
+  "keywords": [
+    "amqp",
+    "typescript",
+    "contract",
+    "rabbitmq",
+    "zod"
+  ],
+  "homepage": "https://github.com/btravers/amqp-contract#readme",
+  "bugs": {
+    "url": "https://github.com/btravers/amqp-contract/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/btravers/amqp-contract.git",
+    "directory": "packages/zod"
+  },
+  "license": "MIT",
+  "author": "Benoit TRAVERS <benoit.travers.fr@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@amqp-contract/asyncapi": "0.0.1",
+    "@amqp-contract/contract": "0.0.1"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "4.0.15",
+    "tsdown": "0.17.2",
+    "typescript": "5.9.3",
+    "vitest": "4.0.15",
+    "zod": "4.1.13",
+    "@amqp-contract/tsconfig": "0.0.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.23.0 || ^4.0.0"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsdown src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}