@amqp-contract/core 0.2.0

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,90 @@
+# @amqp-contract/core
+
+Core utilities for AMQP setup and management in amqp-contract. This package provides centralized functionality for establishing AMQP topology (exchanges, queues, and bindings) from contract definitions.
+
+## Installation
+
+```bash
+npm install @amqp-contract/core
+# or
+pnpm add @amqp-contract/core
+# or
+yarn add @amqp-contract/core
+```
+
+## Usage
+
+The core package exports a `setupInfra` function that handles the creation of all AMQP resources defined in a contract.
+
+```typescript
+import { connect } from "amqplib";
+import { setupInfra } from "@amqp-contract/core";
+import {
+  defineContract,
+  defineExchange,
+  defineQueue,
+  defineQueueBinding,
+} from "@amqp-contract/contract";
+
+// Define resources
+const ordersExchange = defineExchange("orders", "topic", { durable: true });
+const orderProcessingQueue = defineQueue("order-processing", { durable: true });
+
+// Define your contract
+const contract = defineContract({
+  exchanges: {
+    orders: ordersExchange,
+  },
+  queues: {
+    orderProcessing: orderProcessingQueue,
+  },
+  bindings: {
+    orderBinding: defineQueueBinding(orderProcessingQueue, ordersExchange, {
+      routingKey: "order.created",
+    }),
+  },
+});
+
+// Setup AMQP resources
+const connection = await connect("amqp://localhost");
+const channel = await connection.createChannel();
+
+await setupInfra(channel, contract);
+```
+
+## API
+
+### `setupInfra(channel: Channel, contract: ContractDefinition): Promise<void>`
+
+Sets up all AMQP resources defined in the contract:
+
+- **Exchanges**: Creates all exchanges with their configurations
+- **Queues**: Creates all queues with their configurations
+- **Bindings**: Creates all bindings (queue-to-exchange and exchange-to-exchange)
+
+#### Parameters
+
+- `channel`: AMQP channel to use for setup
+- `contract`: Contract definition containing exchanges, queues, and bindings
+
+#### Returns
+
+A Promise that resolves when all resources are created.
+
+## Features
+
+- ✅ Type-safe contract setup
+- ✅ Supports all exchange types (topic, direct, fanout)
+- ✅ Handles both queue-to-exchange and exchange-to-exchange bindings
+- ✅ Passes custom arguments to AMQP resources
+- ✅ Used internally by `@amqp-contract/client` and `@amqp-contract/worker`
+
+## Related Packages
+
+- [@amqp-contract/contract](../contract) - Contract definition builders
+- [@amqp-contract/client](../client) - Type-safe AMQP client
+- [@amqp-contract/worker](../worker) - Type-safe AMQP worker
+
+## License
+
+MIT © Benoit TRAVERS

package/dist/index.cjs

@@ -0,0 +1,30 @@
+
+//#region src/setup.ts
+/**
+* Setup AMQP resources (exchanges, queues, bindings) for a contract
+* This function is used by both client and worker to establish the AMQP topology
+*
+* @param channel - AMQP channel to use for setup
+* @param contract - Contract definition containing exchanges, queues, and bindings
+*/
+async function setupInfra(channel, contract) {
+	if (contract.exchanges) await Promise.all(Object.values(contract.exchanges).map((exchange) => channel.assertExchange(exchange.name, exchange.type, {
+		durable: exchange.durable,
+		autoDelete: exchange.autoDelete,
+		internal: exchange.internal,
+		arguments: exchange.arguments
+	})));
+	if (contract.queues) await Promise.all(Object.values(contract.queues).map((queue) => channel.assertQueue(queue.name, {
+		durable: queue.durable,
+		exclusive: queue.exclusive,
+		autoDelete: queue.autoDelete,
+		arguments: queue.arguments
+	})));
+	if (contract.bindings) await Promise.all(Object.values(contract.bindings).map((binding) => {
+		if (binding.type === "queue") return channel.bindQueue(binding.queue.name, binding.exchange.name, binding.routingKey ?? "", binding.arguments);
+		return channel.bindExchange(binding.destination.name, binding.source.name, binding.routingKey ?? "", binding.arguments);
+	}));
+}
+
+//#endregion
+exports.setupInfra = setupInfra;

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+import { Channel } from "amqplib";
+import { ContractDefinition } from "@amqp-contract/contract";
+
+//#region src/setup.d.ts
+
+/**
+ * Setup AMQP resources (exchanges, queues, bindings) for a contract
+ * This function is used by both client and worker to establish the AMQP topology
+ *
+ * @param channel - AMQP channel to use for setup
+ * @param contract - Contract definition containing exchanges, queues, and bindings
+ */
+declare function setupInfra(channel: Channel, contract: ContractDefinition): Promise<void>;
+//#endregion
+export { setupInfra };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/setup.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;;;;;iBAAsB,UAAA,UAAoB,mBAAmB,qBAAqB"}

package/dist/index.d.mts

@@ -0,0 +1,16 @@
+import { Channel } from "amqplib";
+import { ContractDefinition } from "@amqp-contract/contract";
+
+//#region src/setup.d.ts
+
+/**
+ * Setup AMQP resources (exchanges, queues, bindings) for a contract
+ * This function is used by both client and worker to establish the AMQP topology
+ *
+ * @param channel - AMQP channel to use for setup
+ * @param contract - Contract definition containing exchanges, queues, and bindings
+ */
+declare function setupInfra(channel: Channel, contract: ContractDefinition): Promise<void>;
+//#endregion
+export { setupInfra };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/setup.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;;;;;iBAAsB,UAAA,UAAoB,mBAAmB,qBAAqB"}

package/dist/index.mjs

@@ -0,0 +1,30 @@
+//#region src/setup.ts
+/**
+* Setup AMQP resources (exchanges, queues, bindings) for a contract
+* This function is used by both client and worker to establish the AMQP topology
+*
+* @param channel - AMQP channel to use for setup
+* @param contract - Contract definition containing exchanges, queues, and bindings
+*/
+async function setupInfra(channel, contract) {
+	if (contract.exchanges) await Promise.all(Object.values(contract.exchanges).map((exchange) => channel.assertExchange(exchange.name, exchange.type, {
+		durable: exchange.durable,
+		autoDelete: exchange.autoDelete,
+		internal: exchange.internal,
+		arguments: exchange.arguments
+	})));
+	if (contract.queues) await Promise.all(Object.values(contract.queues).map((queue) => channel.assertQueue(queue.name, {
+		durable: queue.durable,
+		exclusive: queue.exclusive,
+		autoDelete: queue.autoDelete,
+		arguments: queue.arguments
+	})));
+	if (contract.bindings) await Promise.all(Object.values(contract.bindings).map((binding) => {
+		if (binding.type === "queue") return channel.bindQueue(binding.queue.name, binding.exchange.name, binding.routingKey ?? "", binding.arguments);
+		return channel.bindExchange(binding.destination.name, binding.source.name, binding.routingKey ?? "", binding.arguments);
+	}));
+}
+
+//#endregion
+export { setupInfra };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/setup.ts"],"sourcesContent":["import type { Channel } from \"amqplib\";\nimport type { ContractDefinition } from \"@amqp-contract/contract\";\n\n/**\n * Setup AMQP resources (exchanges, queues, bindings) for a contract\n * This function is used by both client and worker to establish the AMQP topology\n *\n * @param channel - AMQP channel to use for setup\n * @param contract - Contract definition containing exchanges, queues, and bindings\n */\nexport async function setupInfra(channel: Channel, contract: ContractDefinition): Promise<void> {\n  // Setup exchanges\n  if (contract.exchanges) {\n    await Promise.all(\n      Object.values(contract.exchanges).map((exchange) =>\n        channel.assertExchange(exchange.name, exchange.type, {\n          durable: exchange.durable,\n          autoDelete: exchange.autoDelete,\n          internal: exchange.internal,\n          arguments: exchange.arguments,\n        }),\n      ),\n    );\n  }\n\n  // Setup queues\n  if (contract.queues) {\n    await Promise.all(\n      Object.values(contract.queues).map((queue) =>\n        channel.assertQueue(queue.name, {\n          durable: queue.durable,\n          exclusive: queue.exclusive,\n          autoDelete: queue.autoDelete,\n          arguments: queue.arguments,\n        }),\n      ),\n    );\n  }\n\n  // Setup bindings\n  if (contract.bindings) {\n    await Promise.all(\n      Object.values(contract.bindings).map((binding) => {\n        if (binding.type === \"queue\") {\n          return channel.bindQueue(\n            binding.queue.name,\n            binding.exchange.name,\n            binding.routingKey ?? \"\",\n            binding.arguments,\n          );\n        }\n\n        return channel.bindExchange(\n          binding.destination.name,\n          binding.source.name,\n          binding.routingKey ?? \"\",\n          binding.arguments,\n        );\n      }),\n    );\n  }\n}\n"],"mappings":";;;;;;;;AAUA,eAAsB,WAAW,SAAkB,UAA6C;AAE9F,KAAI,SAAS,UACX,OAAM,QAAQ,IACZ,OAAO,OAAO,SAAS,UAAU,CAAC,KAAK,aACrC,QAAQ,eAAe,SAAS,MAAM,SAAS,MAAM;EACnD,SAAS,SAAS;EAClB,YAAY,SAAS;EACrB,UAAU,SAAS;EACnB,WAAW,SAAS;EACrB,CAAC,CACH,CACF;AAIH,KAAI,SAAS,OACX,OAAM,QAAQ,IACZ,OAAO,OAAO,SAAS,OAAO,CAAC,KAAK,UAClC,QAAQ,YAAY,MAAM,MAAM;EAC9B,SAAS,MAAM;EACf,WAAW,MAAM;EACjB,YAAY,MAAM;EAClB,WAAW,MAAM;EAClB,CAAC,CACH,CACF;AAIH,KAAI,SAAS,SACX,OAAM,QAAQ,IACZ,OAAO,OAAO,SAAS,SAAS,CAAC,KAAK,YAAY;AAChD,MAAI,QAAQ,SAAS,QACnB,QAAO,QAAQ,UACb,QAAQ,MAAM,MACd,QAAQ,SAAS,MACjB,QAAQ,cAAc,IACtB,QAAQ,UACT;AAGH,SAAO,QAAQ,aACb,QAAQ,YAAY,MACpB,QAAQ,OAAO,MACf,QAAQ,cAAc,IACtB,QAAQ,UACT;GACD,CACH"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@amqp-contract/core",
+  "version": "0.2.0",
+  "description": "Core utilities for AMQP setup and management in amqp-contract",
+  "keywords": [
+    "amqp",
+    "contract",
+    "core",
+    "rabbitmq",
+    "typescript"
+  ],
+  "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/core"
+  },
+  "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/contract": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/amqplib": "0.10.8",
+    "@vitest/coverage-v8": "4.0.16",
+    "amqplib": "0.10.9",
+    "tsdown": "0.18.2",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16",
+    "@amqp-contract/tsconfig": "0.0.0"
+  },
+  "peerDependencies": {
+    "amqplib": ">=0.10.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"
+  }
+}