@amqp-contract/worker 0.0.2 → 0.0.5

package/README.md

@@ -2,6 +2,8 @@
 
 Type-safe AMQP worker for consuming messages using amqp-contract.
 
+📖 **[Full documentation →](https://btravers.github.io/amqp-contract/api/worker)**
+
 ## Installation
 
 ```bash
@@ -11,59 +13,44 @@ pnpm add @amqp-contract/worker amqplib
 ## Usage
 
 ```typescript
-import { createWorker } from '@amqp-contract/worker';
+import { TypedAmqpWorker } from '@amqp-contract/worker';
 import { connect } from 'amqplib';
 import { contract } from './contract';
 
 // Connect to RabbitMQ
 const connection = await connect('amqp://localhost');
 
-// Create worker from contract with handlers
-const worker = createWorker(contract, {
-  processOrder: async (message) => {
-    console.log('Processing order:', message.orderId);
-    // Your business logic here
+// Create worker from contract with handlers (automatically connects and starts consuming)
+const worker = await TypedAmqpWorker.create({
+  contract,
+  handlers: {
+    processOrder: async (message) => {
+      console.log('Processing order:', message.orderId);
+      // Your business logic here
+    },
   },
+  connection,
 });
 
-await worker.connect(connection);
-
-// Start consuming all consumers
-await worker.consumeAll();
-
-// Or start consuming a specific consumer
-// await worker.consume('processOrder');
+// Worker is already consuming messages
 
-// Stop consuming when needed
-// await worker.stopConsuming();
-
-// Clean up
+// Clean up when needed
 // await worker.close();
 ```
 
 ## API
 
-### `createWorker(contract, handlers)`
-
-Create a type-safe AMQP worker from a contract with message handlers.
-
-### `AmqpWorker.connect(connection)`
-
-Connect to an AMQP broker and set up all exchanges, queues, and bindings defined in the contract.
-
-### `AmqpWorker.consume(consumerName)`
-
-Start consuming messages for a specific consumer.
-
-### `AmqpWorker.consumeAll()`
+### `TypedAmqpWorker.create(options)`
 
-Start consuming messages for all consumers defined in the contract.
+Create a type-safe AMQP worker from a contract with message handlers. Automatically connects and starts consuming all messages.
 
-### `AmqpWorker.stopConsuming()`
+**Parameters:**
 
-Stop consuming messages from all consumers.
+- `options.contract` - Contract definition
+- `options.handlers` - Object with handler functions for each consumer
+- `options.connection` - amqplib Connection object
 
-### `AmqpWorker.close()`
+### `TypedAmqpWorker.close()`
 
 Stop consuming and close the channel and connection.
 

package/dist/index.cjs

@@ -3,39 +3,64 @@
 /**
 * Type-safe AMQP worker for consuming messages
 */
-var AmqpWorker = class {
+var TypedAmqpWorker = class TypedAmqpWorker {
 	channel = null;
-	connection = null;
 	consumerTags = [];
-	constructor(contract, handlers) {
+	constructor(contract, handlers, connection) {
 		this.contract = contract;
 		this.handlers = handlers;
+		this.connection = connection;
+	}
+	/**
+	* Create a type-safe AMQP worker from a contract
+	* The worker will automatically connect and start consuming all messages
+	*/
+	static async create(options) {
+		const worker = new TypedAmqpWorker(options.contract, options.handlers, options.connection);
+		await worker.init();
+		await worker.consumeAll();
+		return worker;
+	}
+	/**
+	* Close the connection
+	*/
+	async close() {
+		await this.stopConsuming();
+		if (this.channel) await this.channel.close();
+		await this.connection.close();
 	}
 	/**
 	* Connect to AMQP broker
 	*/
-	async connect(connection) {
-		this.connection = connection;
-		this.channel = await connection.createChannel();
-		if (this.contract.exchanges && this.channel) for (const exchange of Object.values(this.contract.exchanges)) await this.channel.assertExchange(exchange.name, exchange.type, {
+	async init() {
+		this.channel = await this.connection.createChannel();
+		if (this.contract.exchanges) for (const exchange of Object.values(this.contract.exchanges)) await this.channel.assertExchange(exchange.name, exchange.type, {
 			durable: exchange.durable,
 			autoDelete: exchange.autoDelete,
 			internal: exchange.internal,
 			arguments: exchange.arguments
 		});
-		if (this.contract.queues && this.channel) for (const queue of Object.values(this.contract.queues)) await this.channel.assertQueue(queue.name, {
+		if (this.contract.queues) for (const queue of Object.values(this.contract.queues)) await this.channel.assertQueue(queue.name, {
 			durable: queue.durable,
 			exclusive: queue.exclusive,
 			autoDelete: queue.autoDelete,
 			arguments: queue.arguments
 		});
-		if (this.contract.bindings && this.channel) for (const binding of Object.values(this.contract.bindings)) await this.channel.bindQueue(binding.queue, binding.exchange, binding.routingKey ?? "", binding.arguments);
+		if (this.contract.bindings) for (const binding of Object.values(this.contract.bindings)) await this.channel.bindQueue(binding.queue, binding.exchange, binding.routingKey ?? "", binding.arguments);
+	}
+	/**
+	* Start consuming messages for all consumers
+	*/
+	async consumeAll() {
+		if (!this.contract.consumers) throw new Error("No consumers defined in contract");
+		const consumerNames = Object.keys(this.contract.consumers);
+		for (const consumerName of consumerNames) await this.consume(consumerName);
 	}
 	/**
 	* Start consuming messages for a specific consumer
 	*/
 	async consume(consumerName) {
-		if (!this.channel) throw new Error("Worker not connected. Call connect() first.");
+		if (!this.channel) throw new Error("Worker not initialized. Use TypedAmqpWorker.create() to obtain an initialized worker instance.");
 		const consumers = this.contract.consumers;
 		if (!consumers) throw new Error("No consumers defined in contract");
 		const consumer = consumers[consumerName];
@@ -64,14 +89,6 @@ var AmqpWorker = class {
 		this.consumerTags.push(result.consumerTag);
 	}
 	/**
-	* Start consuming messages for all consumers
-	*/
-	async consumeAll() {
-		if (!this.contract.consumers) throw new Error("No consumers defined in contract");
-		const consumerNames = Object.keys(this.contract.consumers);
-		for (const consumerName of consumerNames) await this.consume(consumerName);
-	}
-	/**
 	* Stop consuming messages
 	*/
 	async stopConsuming() {
@@ -79,28 +96,7 @@ var AmqpWorker = class {
 		for (const tag of this.consumerTags) await this.channel.cancel(tag);
 		this.consumerTags = [];
 	}
-	/**
-	* Close the connection
-	*/
-	async close() {
-		await this.stopConsuming();
-		if (this.channel) {
-			await this.channel.close();
-			this.channel = null;
-		}
-		if (this.connection) {
-			await this.connection.close();
-			this.connection = null;
-		}
-	}
 };
-/**
-* Create a type-safe AMQP worker from a contract
-*/
-function createWorker(contract, handlers) {
-	return new AmqpWorker(contract, handlers);
-}
 
 //#endregion
-exports.AmqpWorker = AmqpWorker;
-exports.createWorker = createWorker;
+exports.TypedAmqpWorker = TypedAmqpWorker;

package/dist/index.d.cts

@@ -1,43 +1,52 @@
 import { ChannelModel } from "amqplib";
-import { ContractDefinition, InferConsumerNames, WorkerInferConsumerHandlers } from "@amqp-contract/contract";
+import { ContractDefinition, WorkerInferConsumerHandlers } from "@amqp-contract/contract";
 
 //#region src/worker.d.ts
 
+/**
+ * Options for creating a worker
+ */
+interface CreateWorkerOptions<TContract extends ContractDefinition> {
+  contract: TContract;
+  handlers: WorkerInferConsumerHandlers<TContract>;
+  connection: ChannelModel;
+}
 /**
  * Type-safe AMQP worker for consuming messages
  */
-declare class AmqpWorker<TContract extends ContractDefinition> {
+declare class TypedAmqpWorker<TContract extends ContractDefinition> {
   private readonly contract;
   private readonly handlers;
+  private readonly connection;
   private channel;
-  private connection;
   private consumerTags;
-  constructor(contract: TContract, handlers: WorkerInferConsumerHandlers<TContract>);
+  private constructor();
   /**
-   * Connect to AMQP broker
+   * Create a type-safe AMQP worker from a contract
+   * The worker will automatically connect and start consuming all messages
    */
-  connect(connection: ChannelModel): Promise<void>;
+  static create<TContract extends ContractDefinition>(options: CreateWorkerOptions<TContract>): Promise<TypedAmqpWorker<TContract>>;
   /**
-   * Start consuming messages for a specific consumer
+   * Close the connection
    */
-  consume<TName extends InferConsumerNames<TContract>>(consumerName: TName): Promise<void>;
+  close(): Promise<void>;
+  /**
+   * Connect to AMQP broker
+   */
+  private init;
   /**
    * Start consuming messages for all consumers
    */
-  consumeAll(): Promise<void>;
+  private consumeAll;
   /**
-   * Stop consuming messages
+   * Start consuming messages for a specific consumer
    */
-  stopConsuming(): Promise<void>;
+  private consume;
   /**
-   * Close the connection
+   * Stop consuming messages
    */
-  close(): Promise<void>;
+  private stopConsuming;
 }
-/**
- * Create a type-safe AMQP worker from a contract
- */
-declare function createWorker<TContract extends ContractDefinition>(contract: TContract, handlers: WorkerInferConsumerHandlers<TContract>): AmqpWorker<TContract>;
 //#endregion
-export { AmqpWorker, createWorker };
+export { type CreateWorkerOptions, TypedAmqpWorker };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/worker.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAA0C,cAA7B,UAA6B,CAAA,kBAAA,kBAAA,CAAA,CAAA;EAMX,iBAAA,QAAA;EAC4B,iBAAA,QAAA;EAA5B,QAAA,OAAA;EAMH,QAAA,UAAA;EAAe,QAAA,YAAA;EA4CM,WAAA,CAAA,QAAA,EAnDlB,SAmDkB,EAAA,QAAA,EAlDlB,2BAkDkB,CAlDU,SAkDV,CAAA;EAAnB;;;EAuFR,OAAA,CAAA,UAAA,EAnIM,YAmIN,CAAA,EAnIqB,OAmIrB,CAAA,IAAA,CAAA;EAeG;;;EAiCT,OAAA,CAAA,cAvIc,kBAuIF,CAvIqB,SAuIrB,CAAA,CAAA,CAAA,YAAA,EAvI+C,KAuI/C,CAAA,EAvIuD,OAuIvD,CAAA,IAAA,CAAA;EAAmB;;;EAEnC,UAAA,CAAA,CAAA,EAlDU,OAkDV,CAAA,IAAA,CAAA;EACE;;;mBApCW;;;;WAeR;;;;;iBAkBD,+BAA+B,8BACnC,qBACA,4BAA4B,aACrC,WAAW"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/worker.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAAuD,UAAtC,mBAAsC,CAAA,kBAAA,kBAAA,CAAA,CAAA;EAC3C,QAAA,EAAA,SAAA;EAC4B,QAAA,EAA5B,2BAA4B,CAAA,SAAA,CAAA;EAA5B,UAAA,EACE,YADF;;;AAOZ;;AAcwC,cAd3B,eAc2B,CAAA,kBAdO,kBAcP,CAAA,CAAA;EACP,iBAAA,QAAA;EAApB,iBAAA,QAAA;EACgB,iBAAA,UAAA;EAAhB,QAAA,OAAA;EAAR,QAAA,YAAA;EAUY,QAAA,WAAA,CAAA;EAAO;;;;kCAZgB,6BAC3B,oBAAoB,aAC5B,QAAQ,gBAAgB;;;;WAUZ"}

package/dist/index.d.mts

@@ -1,43 +1,52 @@
 import { ChannelModel } from "amqplib";
-import { ContractDefinition, InferConsumerNames, WorkerInferConsumerHandlers } from "@amqp-contract/contract";
+import { ContractDefinition, WorkerInferConsumerHandlers } from "@amqp-contract/contract";
 
 //#region src/worker.d.ts
 
+/**
+ * Options for creating a worker
+ */
+interface CreateWorkerOptions<TContract extends ContractDefinition> {
+  contract: TContract;
+  handlers: WorkerInferConsumerHandlers<TContract>;
+  connection: ChannelModel;
+}
 /**
  * Type-safe AMQP worker for consuming messages
  */
-declare class AmqpWorker<TContract extends ContractDefinition> {
+declare class TypedAmqpWorker<TContract extends ContractDefinition> {
   private readonly contract;
   private readonly handlers;
+  private readonly connection;
   private channel;
-  private connection;
   private consumerTags;
-  constructor(contract: TContract, handlers: WorkerInferConsumerHandlers<TContract>);
+  private constructor();
   /**
-   * Connect to AMQP broker
+   * Create a type-safe AMQP worker from a contract
+   * The worker will automatically connect and start consuming all messages
    */
-  connect(connection: ChannelModel): Promise<void>;
+  static create<TContract extends ContractDefinition>(options: CreateWorkerOptions<TContract>): Promise<TypedAmqpWorker<TContract>>;
   /**
-   * Start consuming messages for a specific consumer
+   * Close the connection
    */
-  consume<TName extends InferConsumerNames<TContract>>(consumerName: TName): Promise<void>;
+  close(): Promise<void>;
+  /**
+   * Connect to AMQP broker
+   */
+  private init;
   /**
    * Start consuming messages for all consumers
    */
-  consumeAll(): Promise<void>;
+  private consumeAll;
   /**
-   * Stop consuming messages
+   * Start consuming messages for a specific consumer
    */
-  stopConsuming(): Promise<void>;
+  private consume;
   /**
-   * Close the connection
+   * Stop consuming messages
    */
-  close(): Promise<void>;
+  private stopConsuming;
 }
-/**
- * Create a type-safe AMQP worker from a contract
- */
-declare function createWorker<TContract extends ContractDefinition>(contract: TContract, handlers: WorkerInferConsumerHandlers<TContract>): AmqpWorker<TContract>;
 //#endregion
-export { AmqpWorker, createWorker };
+export { type CreateWorkerOptions, TypedAmqpWorker };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/worker.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAA0C,cAA7B,UAA6B,CAAA,kBAAA,kBAAA,CAAA,CAAA;EAMX,iBAAA,QAAA;EAC4B,iBAAA,QAAA;EAA5B,QAAA,OAAA;EAMH,QAAA,UAAA;EAAe,QAAA,YAAA;EA4CM,WAAA,CAAA,QAAA,EAnDlB,SAmDkB,EAAA,QAAA,EAlDlB,2BAkDkB,CAlDU,SAkDV,CAAA;EAAnB;;;EAuFR,OAAA,CAAA,UAAA,EAnIM,YAmIN,CAAA,EAnIqB,OAmIrB,CAAA,IAAA,CAAA;EAeG;;;EAiCT,OAAA,CAAA,cAvIc,kBAuIF,CAvIqB,SAuIrB,CAAA,CAAA,CAAA,YAAA,EAvI+C,KAuI/C,CAAA,EAvIuD,OAuIvD,CAAA,IAAA,CAAA;EAAmB;;;EAEnC,UAAA,CAAA,CAAA,EAlDU,OAkDV,CAAA,IAAA,CAAA;EACE;;;mBApCW;;;;WAeR;;;;;iBAkBD,+BAA+B,8BACnC,qBACA,4BAA4B,aACrC,WAAW"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/worker.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAAuD,UAAtC,mBAAsC,CAAA,kBAAA,kBAAA,CAAA,CAAA;EAC3C,QAAA,EAAA,SAAA;EAC4B,QAAA,EAA5B,2BAA4B,CAAA,SAAA,CAAA;EAA5B,UAAA,EACE,YADF;;;AAOZ;;AAcwC,cAd3B,eAc2B,CAAA,kBAdO,kBAcP,CAAA,CAAA;EACP,iBAAA,QAAA;EAApB,iBAAA,QAAA;EACgB,iBAAA,UAAA;EAAhB,QAAA,OAAA;EAAR,QAAA,YAAA;EAUY,QAAA,WAAA,CAAA;EAAO;;;;kCAZgB,6BAC3B,oBAAoB,aAC5B,QAAQ,gBAAgB;;;;WAUZ"}

package/dist/index.mjs

@@ -2,39 +2,64 @@
 /**
 * Type-safe AMQP worker for consuming messages
 */
-var AmqpWorker = class {
+var TypedAmqpWorker = class TypedAmqpWorker {
 	channel = null;
-	connection = null;
 	consumerTags = [];
-	constructor(contract, handlers) {
+	constructor(contract, handlers, connection) {
 		this.contract = contract;
 		this.handlers = handlers;
+		this.connection = connection;
+	}
+	/**
+	* Create a type-safe AMQP worker from a contract
+	* The worker will automatically connect and start consuming all messages
+	*/
+	static async create(options) {
+		const worker = new TypedAmqpWorker(options.contract, options.handlers, options.connection);
+		await worker.init();
+		await worker.consumeAll();
+		return worker;
+	}
+	/**
+	* Close the connection
+	*/
+	async close() {
+		await this.stopConsuming();
+		if (this.channel) await this.channel.close();
+		await this.connection.close();
 	}
 	/**
 	* Connect to AMQP broker
 	*/
-	async connect(connection) {
-		this.connection = connection;
-		this.channel = await connection.createChannel();
-		if (this.contract.exchanges && this.channel) for (const exchange of Object.values(this.contract.exchanges)) await this.channel.assertExchange(exchange.name, exchange.type, {
+	async init() {
+		this.channel = await this.connection.createChannel();
+		if (this.contract.exchanges) for (const exchange of Object.values(this.contract.exchanges)) await this.channel.assertExchange(exchange.name, exchange.type, {
 			durable: exchange.durable,
 			autoDelete: exchange.autoDelete,
 			internal: exchange.internal,
 			arguments: exchange.arguments
 		});
-		if (this.contract.queues && this.channel) for (const queue of Object.values(this.contract.queues)) await this.channel.assertQueue(queue.name, {
+		if (this.contract.queues) for (const queue of Object.values(this.contract.queues)) await this.channel.assertQueue(queue.name, {
 			durable: queue.durable,
 			exclusive: queue.exclusive,
 			autoDelete: queue.autoDelete,
 			arguments: queue.arguments
 		});
-		if (this.contract.bindings && this.channel) for (const binding of Object.values(this.contract.bindings)) await this.channel.bindQueue(binding.queue, binding.exchange, binding.routingKey ?? "", binding.arguments);
+		if (this.contract.bindings) for (const binding of Object.values(this.contract.bindings)) await this.channel.bindQueue(binding.queue, binding.exchange, binding.routingKey ?? "", binding.arguments);
+	}
+	/**
+	* Start consuming messages for all consumers
+	*/
+	async consumeAll() {
+		if (!this.contract.consumers) throw new Error("No consumers defined in contract");
+		const consumerNames = Object.keys(this.contract.consumers);
+		for (const consumerName of consumerNames) await this.consume(consumerName);
 	}
 	/**
 	* Start consuming messages for a specific consumer
 	*/
 	async consume(consumerName) {
-		if (!this.channel) throw new Error("Worker not connected. Call connect() first.");
+		if (!this.channel) throw new Error("Worker not initialized. Use TypedAmqpWorker.create() to obtain an initialized worker instance.");
 		const consumers = this.contract.consumers;
 		if (!consumers) throw new Error("No consumers defined in contract");
 		const consumer = consumers[consumerName];
@@ -63,14 +88,6 @@ var AmqpWorker = class {
 		this.consumerTags.push(result.consumerTag);
 	}
 	/**
-	* Start consuming messages for all consumers
-	*/
-	async consumeAll() {
-		if (!this.contract.consumers) throw new Error("No consumers defined in contract");
-		const consumerNames = Object.keys(this.contract.consumers);
-		for (const consumerName of consumerNames) await this.consume(consumerName);
-	}
-	/**
 	* Stop consuming messages
 	*/
 	async stopConsuming() {
@@ -78,28 +95,8 @@ var AmqpWorker = class {
 		for (const tag of this.consumerTags) await this.channel.cancel(tag);
 		this.consumerTags = [];
 	}
-	/**
-	* Close the connection
-	*/
-	async close() {
-		await this.stopConsuming();
-		if (this.channel) {
-			await this.channel.close();
-			this.channel = null;
-		}
-		if (this.connection) {
-			await this.connection.close();
-			this.connection = null;
-		}
-	}
 };
-/**
-* Create a type-safe AMQP worker from a contract
-*/
-function createWorker(contract, handlers) {
-	return new AmqpWorker(contract, handlers);
-}
 
 //#endregion
-export { AmqpWorker, createWorker };
+export { TypedAmqpWorker };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["contract: TContract","handlers: WorkerInferConsumerHandlers<TContract>"],"sources":["../src/worker.ts"],"sourcesContent":["import type { Channel, ChannelModel, ConsumeMessage } from \"amqplib\";\nimport type {\n  ContractDefinition,\n  InferConsumerNames,\n  WorkerInferConsumerHandlers,\n} from \"@amqp-contract/contract\";\n\n/**\n * Type-safe AMQP worker for consuming messages\n */\nexport class AmqpWorker<TContract extends ContractDefinition> {\n  private channel: Channel | null = null;\n  private connection: ChannelModel | null = null;\n  private consumerTags: string[] = [];\n\n  constructor(\n    private readonly contract: TContract,\n    private readonly handlers: WorkerInferConsumerHandlers<TContract>,\n  ) {}\n\n  /**\n   * Connect to AMQP broker\n   */\n  async connect(connection: ChannelModel): Promise<void> {\n    this.connection = connection;\n    this.channel = await connection.createChannel();\n\n    // Setup exchanges\n    if (this.contract.exchanges && this.channel) {\n      for (const exchange of Object.values(this.contract.exchanges)) {\n        await this.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    // Setup queues\n    if (this.contract.queues && this.channel) {\n      for (const queue of Object.values(this.contract.queues)) {\n        await this.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    // Setup bindings\n    if (this.contract.bindings && this.channel) {\n      for (const binding of Object.values(this.contract.bindings)) {\n        await this.channel.bindQueue(\n          binding.queue,\n          binding.exchange,\n          binding.routingKey ?? \"\",\n          binding.arguments,\n        );\n      }\n    }\n  }\n\n  /**\n   * Start consuming messages for a specific consumer\n   */\n  async consume<TName extends InferConsumerNames<TContract>>(consumerName: TName): Promise<void> {\n    if (!this.channel) {\n      throw new Error(\"Worker not connected. Call connect() first.\");\n    }\n\n    const consumers = this.contract.consumers as Record<string, unknown>;\n    if (!consumers) {\n      throw new Error(\"No consumers defined in contract\");\n    }\n\n    const consumer = consumers[consumerName as string];\n    if (!consumer || typeof consumer !== \"object\") {\n      throw new Error(`Consumer \"${String(consumerName)}\" not found in contract`);\n    }\n\n    const consumerDef = consumer as {\n      queue: string;\n      message: { \"~standard\": { validate: (value: unknown) => unknown } };\n      prefetch?: number;\n      noAck?: boolean;\n    };\n\n    const handler = this.handlers[consumerName];\n    if (!handler) {\n      throw new Error(`Handler for \"${String(consumerName)}\" not provided`);\n    }\n\n    // Set prefetch if specified\n    if (consumerDef.prefetch !== undefined) {\n      await this.channel.prefetch(consumerDef.prefetch);\n    }\n\n    // Start consuming\n    const result = await this.channel.consume(\n      consumerDef.queue,\n      async (msg: ConsumeMessage | null) => {\n        if (!msg) {\n          return;\n        }\n\n        try {\n          // Parse message\n          const content = JSON.parse(msg.content.toString());\n\n          // Validate message using schema\n          const validation = consumerDef.message[\"~standard\"].validate(content);\n          if (\n            typeof validation === \"object\" &&\n            validation !== null &&\n            \"issues\" in validation &&\n            validation.issues\n          ) {\n            console.error(\"Message validation failed:\", validation.issues);\n            // Reject message with no requeue\n            this.channel?.nack(msg, false, false);\n            return;\n          }\n\n          const validatedMessage =\n            typeof validation === \"object\" && validation !== null && \"value\" in validation\n              ? validation.value\n              : content;\n\n          // Call handler\n          await handler(validatedMessage);\n\n          // Acknowledge message if not in noAck mode\n          if (!consumerDef.noAck) {\n            this.channel?.ack(msg);\n          }\n        } catch (error) {\n          console.error(\"Error processing message:\", error);\n          // Reject message and requeue\n          this.channel?.nack(msg, false, true);\n        }\n      },\n      {\n        noAck: consumerDef.noAck ?? false,\n      },\n    );\n\n    this.consumerTags.push(result.consumerTag);\n  }\n\n  /**\n   * Start consuming messages for all consumers\n   */\n  async consumeAll(): Promise<void> {\n    if (!this.contract.consumers) {\n      throw new Error(\"No consumers defined in contract\");\n    }\n\n    const consumerNames = Object.keys(this.contract.consumers) as InferConsumerNames<TContract>[];\n\n    for (const consumerName of consumerNames) {\n      await this.consume(consumerName);\n    }\n  }\n\n  /**\n   * Stop consuming messages\n   */\n  async stopConsuming(): Promise<void> {\n    if (!this.channel) {\n      return;\n    }\n\n    for (const tag of this.consumerTags) {\n      await this.channel.cancel(tag);\n    }\n\n    this.consumerTags = [];\n  }\n\n  /**\n   * Close the connection\n   */\n  async close(): Promise<void> {\n    await this.stopConsuming();\n\n    if (this.channel) {\n      await this.channel.close();\n      this.channel = null;\n    }\n\n    if (this.connection) {\n      await (this.connection as unknown as { close(): Promise<void> }).close();\n      this.connection = null;\n    }\n  }\n}\n\n/**\n * Create a type-safe AMQP worker from a contract\n */\nexport function createWorker<TContract extends ContractDefinition>(\n  contract: TContract,\n  handlers: WorkerInferConsumerHandlers<TContract>,\n): AmqpWorker<TContract> {\n  return new AmqpWorker(contract, handlers);\n}\n"],"mappings":";;;;AAUA,IAAa,aAAb,MAA8D;CAC5D,AAAQ,UAA0B;CAClC,AAAQ,aAAkC;CAC1C,AAAQ,eAAyB,EAAE;CAEnC,YACE,AAAiBA,UACjB,AAAiBC,UACjB;EAFiB;EACA;;;;;CAMnB,MAAM,QAAQ,YAAyC;AACrD,OAAK,aAAa;AAClB,OAAK,UAAU,MAAM,WAAW,eAAe;AAG/C,MAAI,KAAK,SAAS,aAAa,KAAK,QAClC,MAAK,MAAM,YAAY,OAAO,OAAO,KAAK,SAAS,UAAU,CAC3D,OAAM,KAAK,QAAQ,eAAe,SAAS,MAAM,SAAS,MAAM;GAC9D,SAAS,SAAS;GAClB,YAAY,SAAS;GACrB,UAAU,SAAS;GACnB,WAAW,SAAS;GACrB,CAAC;AAKN,MAAI,KAAK,SAAS,UAAU,KAAK,QAC/B,MAAK,MAAM,SAAS,OAAO,OAAO,KAAK,SAAS,OAAO,CACrD,OAAM,KAAK,QAAQ,YAAY,MAAM,MAAM;GACzC,SAAS,MAAM;GACf,WAAW,MAAM;GACjB,YAAY,MAAM;GAClB,WAAW,MAAM;GAClB,CAAC;AAKN,MAAI,KAAK,SAAS,YAAY,KAAK,QACjC,MAAK,MAAM,WAAW,OAAO,OAAO,KAAK,SAAS,SAAS,CACzD,OAAM,KAAK,QAAQ,UACjB,QAAQ,OACR,QAAQ,UACR,QAAQ,cAAc,IACtB,QAAQ,UACT;;;;;CAQP,MAAM,QAAqD,cAAoC;AAC7F,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,8CAA8C;EAGhE,MAAM,YAAY,KAAK,SAAS;AAChC,MAAI,CAAC,UACH,OAAM,IAAI,MAAM,mCAAmC;EAGrD,MAAM,WAAW,UAAU;AAC3B,MAAI,CAAC,YAAY,OAAO,aAAa,SACnC,OAAM,IAAI,MAAM,aAAa,OAAO,aAAa,CAAC,yBAAyB;EAG7E,MAAM,cAAc;EAOpB,MAAM,UAAU,KAAK,SAAS;AAC9B,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,gBAAgB,OAAO,aAAa,CAAC,gBAAgB;AAIvE,MAAI,YAAY,aAAa,OAC3B,OAAM,KAAK,QAAQ,SAAS,YAAY,SAAS;EAInD,MAAM,SAAS,MAAM,KAAK,QAAQ,QAChC,YAAY,OACZ,OAAO,QAA+B;AACpC,OAAI,CAAC,IACH;AAGF,OAAI;IAEF,MAAM,UAAU,KAAK,MAAM,IAAI,QAAQ,UAAU,CAAC;IAGlD,MAAM,aAAa,YAAY,QAAQ,aAAa,SAAS,QAAQ;AACrE,QACE,OAAO,eAAe,YACtB,eAAe,QACf,YAAY,cACZ,WAAW,QACX;AACA,aAAQ,MAAM,8BAA8B,WAAW,OAAO;AAE9D,UAAK,SAAS,KAAK,KAAK,OAAO,MAAM;AACrC;;AASF,UAAM,QALJ,OAAO,eAAe,YAAY,eAAe,QAAQ,WAAW,aAChE,WAAW,QACX,QAGyB;AAG/B,QAAI,CAAC,YAAY,MACf,MAAK,SAAS,IAAI,IAAI;YAEjB,OAAO;AACd,YAAQ,MAAM,6BAA6B,MAAM;AAEjD,SAAK,SAAS,KAAK,KAAK,OAAO,KAAK;;KAGxC,EACE,OAAO,YAAY,SAAS,OAC7B,CACF;AAED,OAAK,aAAa,KAAK,OAAO,YAAY;;;;;CAM5C,MAAM,aAA4B;AAChC,MAAI,CAAC,KAAK,SAAS,UACjB,OAAM,IAAI,MAAM,mCAAmC;EAGrD,MAAM,gBAAgB,OAAO,KAAK,KAAK,SAAS,UAAU;AAE1D,OAAK,MAAM,gBAAgB,cACzB,OAAM,KAAK,QAAQ,aAAa;;;;;CAOpC,MAAM,gBAA+B;AACnC,MAAI,CAAC,KAAK,QACR;AAGF,OAAK,MAAM,OAAO,KAAK,aACrB,OAAM,KAAK,QAAQ,OAAO,IAAI;AAGhC,OAAK,eAAe,EAAE;;;;;CAMxB,MAAM,QAAuB;AAC3B,QAAM,KAAK,eAAe;AAE1B,MAAI,KAAK,SAAS;AAChB,SAAM,KAAK,QAAQ,OAAO;AAC1B,QAAK,UAAU;;AAGjB,MAAI,KAAK,YAAY;AACnB,SAAO,KAAK,WAAqD,OAAO;AACxE,QAAK,aAAa;;;;;;;AAQxB,SAAgB,aACd,UACA,UACuB;AACvB,QAAO,IAAI,WAAW,UAAU,SAAS"}
+{"version":3,"file":"index.mjs","names":["contract: TContract","handlers: WorkerInferConsumerHandlers<TContract>","connection: ChannelModel"],"sources":["../src/worker.ts"],"sourcesContent":["import type { Channel, ChannelModel, ConsumeMessage } from \"amqplib\";\nimport type {\n  ContractDefinition,\n  InferConsumerNames,\n  WorkerInferConsumerHandlers,\n} from \"@amqp-contract/contract\";\n\n/**\n * Options for creating a worker\n */\nexport interface CreateWorkerOptions<TContract extends ContractDefinition> {\n  contract: TContract;\n  handlers: WorkerInferConsumerHandlers<TContract>;\n  connection: ChannelModel;\n}\n\n/**\n * Type-safe AMQP worker for consuming messages\n */\nexport class TypedAmqpWorker<TContract extends ContractDefinition> {\n  private channel: Channel | null = null;\n  private consumerTags: string[] = [];\n\n  private constructor(\n    private readonly contract: TContract,\n    private readonly handlers: WorkerInferConsumerHandlers<TContract>,\n    private readonly connection: ChannelModel,\n  ) {}\n\n  /**\n   * Create a type-safe AMQP worker from a contract\n   * The worker will automatically connect and start consuming all messages\n   */\n  static async create<TContract extends ContractDefinition>(\n    options: CreateWorkerOptions<TContract>,\n  ): Promise<TypedAmqpWorker<TContract>> {\n    const worker = new TypedAmqpWorker(options.contract, options.handlers, options.connection);\n    await worker.init();\n    await worker.consumeAll();\n    return worker;\n  }\n\n  /**\n   * Close the connection\n   */\n  async close(): Promise<void> {\n    await this.stopConsuming();\n\n    if (this.channel) {\n      await this.channel.close();\n    }\n\n    await this.connection.close();\n  }\n\n  /**\n   * Connect to AMQP broker\n   */\n  private async init(): Promise<void> {\n    this.channel = await this.connection.createChannel();\n\n    // Setup exchanges\n    if (this.contract.exchanges) {\n      for (const exchange of Object.values(this.contract.exchanges)) {\n        await this.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    // Setup queues\n    if (this.contract.queues) {\n      for (const queue of Object.values(this.contract.queues)) {\n        await this.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    // Setup bindings\n    if (this.contract.bindings) {\n      for (const binding of Object.values(this.contract.bindings)) {\n        await this.channel.bindQueue(\n          binding.queue,\n          binding.exchange,\n          binding.routingKey ?? \"\",\n          binding.arguments,\n        );\n      }\n    }\n  }\n\n  /**\n   * Start consuming messages for all consumers\n   */\n  private async consumeAll(): Promise<void> {\n    if (!this.contract.consumers) {\n      throw new Error(\"No consumers defined in contract\");\n    }\n\n    const consumerNames = Object.keys(this.contract.consumers) as InferConsumerNames<TContract>[];\n\n    for (const consumerName of consumerNames) {\n      await this.consume(consumerName);\n    }\n  }\n\n  /**\n   * Start consuming messages for a specific consumer\n   */\n  private async consume<TName extends InferConsumerNames<TContract>>(\n    consumerName: TName,\n  ): Promise<void> {\n    if (!this.channel) {\n      throw new Error(\n        \"Worker not initialized. Use TypedAmqpWorker.create() to obtain an initialized worker instance.\",\n      );\n    }\n\n    const consumers = this.contract.consumers as Record<string, unknown>;\n    if (!consumers) {\n      throw new Error(\"No consumers defined in contract\");\n    }\n\n    const consumer = consumers[consumerName as string];\n    if (!consumer || typeof consumer !== \"object\") {\n      throw new Error(`Consumer \"${String(consumerName)}\" not found in contract`);\n    }\n\n    const consumerDef = consumer as {\n      queue: string;\n      message: { \"~standard\": { validate: (value: unknown) => unknown } };\n      prefetch?: number;\n      noAck?: boolean;\n    };\n\n    const handler = this.handlers[consumerName];\n    if (!handler) {\n      throw new Error(`Handler for \"${String(consumerName)}\" not provided`);\n    }\n\n    // Set prefetch if specified\n    if (consumerDef.prefetch !== undefined) {\n      await this.channel.prefetch(consumerDef.prefetch);\n    }\n\n    // Start consuming\n    const result = await this.channel.consume(\n      consumerDef.queue,\n      async (msg: ConsumeMessage | null) => {\n        if (!msg) {\n          return;\n        }\n\n        try {\n          // Parse message\n          const content = JSON.parse(msg.content.toString());\n\n          // Validate message using schema\n          const validation = consumerDef.message[\"~standard\"].validate(content);\n          if (\n            typeof validation === \"object\" &&\n            validation !== null &&\n            \"issues\" in validation &&\n            validation.issues\n          ) {\n            console.error(\"Message validation failed:\", validation.issues);\n            // Reject message with no requeue\n            this.channel?.nack(msg, false, false);\n            return;\n          }\n\n          const validatedMessage =\n            typeof validation === \"object\" && validation !== null && \"value\" in validation\n              ? validation.value\n              : content;\n\n          // Call handler\n          await handler(validatedMessage);\n\n          // Acknowledge message if not in noAck mode\n          if (!consumerDef.noAck) {\n            this.channel?.ack(msg);\n          }\n        } catch (error) {\n          console.error(\"Error processing message:\", error);\n          // Reject message and requeue\n          this.channel?.nack(msg, false, true);\n        }\n      },\n      {\n        noAck: consumerDef.noAck ?? false,\n      },\n    );\n\n    this.consumerTags.push(result.consumerTag);\n  }\n\n  /**\n   * Stop consuming messages\n   */\n  private async stopConsuming(): Promise<void> {\n    if (!this.channel) {\n      return;\n    }\n\n    for (const tag of this.consumerTags) {\n      await this.channel.cancel(tag);\n    }\n\n    this.consumerTags = [];\n  }\n}\n"],"mappings":";;;;AAmBA,IAAa,kBAAb,MAAa,gBAAsD;CACjE,AAAQ,UAA0B;CAClC,AAAQ,eAAyB,EAAE;CAEnC,AAAQ,YACN,AAAiBA,UACjB,AAAiBC,UACjB,AAAiBC,YACjB;EAHiB;EACA;EACA;;;;;;CAOnB,aAAa,OACX,SACqC;EACrC,MAAM,SAAS,IAAI,gBAAgB,QAAQ,UAAU,QAAQ,UAAU,QAAQ,WAAW;AAC1F,QAAM,OAAO,MAAM;AACnB,QAAM,OAAO,YAAY;AACzB,SAAO;;;;;CAMT,MAAM,QAAuB;AAC3B,QAAM,KAAK,eAAe;AAE1B,MAAI,KAAK,QACP,OAAM,KAAK,QAAQ,OAAO;AAG5B,QAAM,KAAK,WAAW,OAAO;;;;;CAM/B,MAAc,OAAsB;AAClC,OAAK,UAAU,MAAM,KAAK,WAAW,eAAe;AAGpD,MAAI,KAAK,SAAS,UAChB,MAAK,MAAM,YAAY,OAAO,OAAO,KAAK,SAAS,UAAU,CAC3D,OAAM,KAAK,QAAQ,eAAe,SAAS,MAAM,SAAS,MAAM;GAC9D,SAAS,SAAS;GAClB,YAAY,SAAS;GACrB,UAAU,SAAS;GACnB,WAAW,SAAS;GACrB,CAAC;AAKN,MAAI,KAAK,SAAS,OAChB,MAAK,MAAM,SAAS,OAAO,OAAO,KAAK,SAAS,OAAO,CACrD,OAAM,KAAK,QAAQ,YAAY,MAAM,MAAM;GACzC,SAAS,MAAM;GACf,WAAW,MAAM;GACjB,YAAY,MAAM;GAClB,WAAW,MAAM;GAClB,CAAC;AAKN,MAAI,KAAK,SAAS,SAChB,MAAK,MAAM,WAAW,OAAO,OAAO,KAAK,SAAS,SAAS,CACzD,OAAM,KAAK,QAAQ,UACjB,QAAQ,OACR,QAAQ,UACR,QAAQ,cAAc,IACtB,QAAQ,UACT;;;;;CAQP,MAAc,aAA4B;AACxC,MAAI,CAAC,KAAK,SAAS,UACjB,OAAM,IAAI,MAAM,mCAAmC;EAGrD,MAAM,gBAAgB,OAAO,KAAK,KAAK,SAAS,UAAU;AAE1D,OAAK,MAAM,gBAAgB,cACzB,OAAM,KAAK,QAAQ,aAAa;;;;;CAOpC,MAAc,QACZ,cACe;AACf,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MACR,iGACD;EAGH,MAAM,YAAY,KAAK,SAAS;AAChC,MAAI,CAAC,UACH,OAAM,IAAI,MAAM,mCAAmC;EAGrD,MAAM,WAAW,UAAU;AAC3B,MAAI,CAAC,YAAY,OAAO,aAAa,SACnC,OAAM,IAAI,MAAM,aAAa,OAAO,aAAa,CAAC,yBAAyB;EAG7E,MAAM,cAAc;EAOpB,MAAM,UAAU,KAAK,SAAS;AAC9B,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,gBAAgB,OAAO,aAAa,CAAC,gBAAgB;AAIvE,MAAI,YAAY,aAAa,OAC3B,OAAM,KAAK,QAAQ,SAAS,YAAY,SAAS;EAInD,MAAM,SAAS,MAAM,KAAK,QAAQ,QAChC,YAAY,OACZ,OAAO,QAA+B;AACpC,OAAI,CAAC,IACH;AAGF,OAAI;IAEF,MAAM,UAAU,KAAK,MAAM,IAAI,QAAQ,UAAU,CAAC;IAGlD,MAAM,aAAa,YAAY,QAAQ,aAAa,SAAS,QAAQ;AACrE,QACE,OAAO,eAAe,YACtB,eAAe,QACf,YAAY,cACZ,WAAW,QACX;AACA,aAAQ,MAAM,8BAA8B,WAAW,OAAO;AAE9D,UAAK,SAAS,KAAK,KAAK,OAAO,MAAM;AACrC;;AASF,UAAM,QALJ,OAAO,eAAe,YAAY,eAAe,QAAQ,WAAW,aAChE,WAAW,QACX,QAGyB;AAG/B,QAAI,CAAC,YAAY,MACf,MAAK,SAAS,IAAI,IAAI;YAEjB,OAAO;AACd,YAAQ,MAAM,6BAA6B,MAAM;AAEjD,SAAK,SAAS,KAAK,KAAK,OAAO,KAAK;;KAGxC,EACE,OAAO,YAAY,SAAS,OAC7B,CACF;AAED,OAAK,aAAa,KAAK,OAAO,YAAY;;;;;CAM5C,MAAc,gBAA+B;AAC3C,MAAI,CAAC,KAAK,QACR;AAGF,OAAK,MAAM,OAAO,KAAK,aACrB,OAAM,KAAK,QAAQ,OAAO,IAAI;AAGhC,OAAK,eAAe,EAAE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amqp-contract/worker",
-  "version": "0.0.2",
+  "version": "0.0.5",
   "description": "Worker utilities for consuming messages using amqp-contract",
   "keywords": [
     "amqp",
@@ -41,7 +41,7 @@
     "dist"
   ],
   "dependencies": {
-    "@amqp-contract/contract": "0.0.2"
+    "@amqp-contract/contract": "0.0.5"
   },
   "devDependencies": {
     "@types/amqplib": "0.10.8",
@@ -52,6 +52,8 @@
     "typescript": "5.9.3",
     "vitest": "4.0.16",
     "zod": "4.2.1",
+    "@amqp-contract/client": "0.0.5",
+    "@amqp-contract/testing": "0.0.5",
     "@amqp-contract/tsconfig": "0.0.0"
   },
   "peerDependencies": {
@@ -60,8 +62,9 @@
   "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",
+    "test": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:watch": "vitest --project unit",
     "typecheck": "tsc --noEmit"
   }
 }