@amqp-contract/client 0.0.2 → 0.0.5

package/README.md

@@ -2,6 +2,8 @@
 
 Type-safe AMQP client for publishing messages using amqp-contract.
 
+📖 **[Full documentation →](https://btravers.github.io/amqp-contract/api/client)**
+
 ## Installation
 
 ```bash
@@ -11,16 +13,15 @@ pnpm add @amqp-contract/client amqplib
 ## Usage
 
 ```typescript
-import { createClient } from '@amqp-contract/client';
+import { TypedAmqpClient } from '@amqp-contract/client';
 import { connect } from 'amqplib';
 import { contract } from './contract';
 
 // Connect to RabbitMQ
 const connection = await connect('amqp://localhost');
 
-// Create client from contract
-const client = createClient(contract);
-await client.connect(connection);
+// Create client from contract (automatically connects)
+const client = await TypedAmqpClient.create({ contract, connection });
 
 // Publish message with type safety
 await client.publish('orderCreated', {
@@ -34,19 +35,20 @@ await client.close();
 
 ## API
 
-### `createClient(contract)`
+### `TypedAmqpClient.create(options)`
 
-Create a type-safe AMQP client from a contract.
+Create a type-safe AMQP client from a contract. Automatically connects to RabbitMQ.
 
-### `AmqpClient.connect(connection)`
+**Parameters:**
 
-Connect to an AMQP broker and set up all exchanges, queues, and bindings defined in the contract.
+- `options.contract` - Contract definition
+- `options.connection` - amqplib Connection object
 
-### `AmqpClient.publish(publisherName, message, options?)`
+### `TypedAmqpClient.publish(publisherName, message, options?)`
 
 Publish a message using a defined publisher. The message will be validated against the schema and type-checked at compile time.
 
-### `AmqpClient.close()`
+### `TypedAmqpClient.close()`
 
 Close the channel and connection.
 

package/dist/index.cjs

@@ -3,37 +3,26 @@
 /**
 * Type-safe AMQP client for publishing messages
 */
-var AmqpClient = class {
+var TypedAmqpClient = class TypedAmqpClient {
 	channel = null;
-	connection = null;
-	constructor(contract) {
+	constructor(contract, connection) {
 		this.contract = contract;
+		this.connection = connection;
 	}
 	/**
-	* Connect to AMQP broker
+	* Create a type-safe AMQP client from a contract
+	* The client will automatically connect to the 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, {
-			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, {
-			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);
+	static async create(options) {
+		const client = new TypedAmqpClient(options.contract, options.connection);
+		await client.init();
+		return client;
 	}
 	/**
 	* Publish a message using a defined publisher
 	*/
 	async publish(publisherName, message, options) {
-		if (!this.channel) throw new Error("Client not connected. Call connect() first.");
+		if (!this.channel) throw new Error("Client not initialized. Create the client using TypedAmqpClient.create() to establish a connection.");
 		const publishers = this.contract.publishers;
 		if (!publishers) throw new Error("No publishers defined in contract");
 		const publisher = publishers[publisherName];
@@ -50,23 +39,29 @@ var AmqpClient = class {
 	* Close the connection
 	*/
 	async close() {
-		if (this.channel) {
-			await this.channel.close();
-			this.channel = null;
-		}
-		if (this.connection) {
-			await this.connection.close();
-			this.connection = null;
-		}
+		if (this.channel) await this.channel.close();
+		await this.connection.close();
+	}
+	/**
+	* Connect to AMQP broker
+	*/
+	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) 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) for (const binding of Object.values(this.contract.bindings)) await this.channel.bindQueue(binding.queue, binding.exchange, binding.routingKey ?? "", binding.arguments);
 	}
 };
-/**
-* Create a type-safe AMQP client from a contract
-*/
-function createClient(contract) {
-	return new AmqpClient(contract);
-}
 
 //#endregion
-exports.AmqpClient = AmqpClient;
-exports.createClient = createClient;
+exports.TypedAmqpClient = TypedAmqpClient;

package/dist/index.d.cts

@@ -3,6 +3,13 @@ import { ClientInferPublisherInput, ContractDefinition, InferPublisherNames } fr
 
 //#region src/client.d.ts
 
+/**
+ * Options for creating a client
+ */
+interface CreateClientOptions<TContract extends ContractDefinition> {
+  contract: TContract;
+  connection: ChannelModel;
+}
 /**
  * Options for publishing a message
  */
@@ -13,15 +20,16 @@ interface PublishOptions {
 /**
  * Type-safe AMQP client for publishing messages
  */
-declare class AmqpClient<TContract extends ContractDefinition> {
+declare class TypedAmqpClient<TContract extends ContractDefinition> {
   private readonly contract;
+  private readonly connection;
   private channel;
-  private connection;
-  constructor(contract: TContract);
+  private constructor();
   /**
-   * Connect to AMQP broker
+   * Create a type-safe AMQP client from a contract
+   * The client will automatically connect to the AMQP broker
    */
-  connect(connection: ChannelModel): Promise<void>;
+  static create<TContract extends ContractDefinition>(options: CreateClientOptions<TContract>): Promise<TypedAmqpClient<TContract>>;
   /**
    * Publish a message using a defined publisher
    */
@@ -30,11 +38,11 @@ declare class AmqpClient<TContract extends ContractDefinition> {
    * Close the connection
    */
   close(): Promise<void>;
+  /**
+   * Connect to AMQP broker
+   */
+  private init;
 }
-/**
- * Create a type-safe AMQP client from a contract
- */
-declare function createClient<TContract extends ContractDefinition>(contract: TContract): AmqpClient<TContract>;
 //#endregion
-export { AmqpClient, type PublishOptions, createClient };
+export { type CreateClientOptions, type PublishOptions, TypedAmqpClient };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAQa,UARI,cAAA,CAQM;EAAmB,UAAA,CAAA,EAAA,MAAA;EAID,OAAA,CAAA,EAV7B,OAAA,CAAQ,OAUqB;;;;;AAkDtB,cAtDN,UAsDM,CAAA,kBAtDuB,kBAsDvB,CAAA,CAAA;EACoB,iBAAA,QAAA;EAAW,QAAA,OAAA;EAArC,QAAA,UAAA;EACC,WAAA,CAAA,QAAA,EApD2B,SAoD3B;EACT;;;EA8DW,OAAA,CAAA,UAAY,EA9GA,YA8GA,CAAA,EA9Ge,OA8Gf,CAAA,IAAA,CAAA;EAAmB;;;EAE5C,OAAA,CAAA,cApE2B,mBAoE3B,CApE+C,SAoE/C,CAAA,CAAA,CAAA,aAAA,EAnEgB,KAmEhB,EAAA,OAAA,EAlEU,yBAkEV,CAlEoC,SAkEpC,EAlE+C,KAkE/C,CAAA,EAAA,OAAA,CAAA,EAjEW,cAiEX,CAAA,EAhEE,OAgEF,CAAA,OAAA,CAAA;EAAU;;;WAjBI;;;;;iBAeD,+BAA+B,8BACnC,YACT,WAAW"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAAuD,UAAtC,mBAAsC,CAAA,kBAAA,kBAAA,CAAA,CAAA;EAC3C,QAAA,EAAA,SAAA;EACE,UAAA,EAAA,YAAA;;AAMd;AAQA;;AAYwC,UApBvB,cAAA,CAoBuB;EACP,UAAA,CAAA,EAAA,MAAA;EAApB,OAAA,CAAA,EAnBD,OAAA,CAAQ,OAmBP;;;;;AAUiB,cAvBjB,eAuBiB,CAAA,kBAvBiB,kBAuBjB,CAAA,CAAA;EACX,iBAAA,QAAA;EACoB,iBAAA,UAAA;EAAW,QAAA,OAAA;EAArC,QAAA,WAAA,CAAA;EACC;;;;kCAd0B,6BAC3B,oBAAoB,aAC5B,QAAQ,gBAAgB;;;;wBASC,oBAAoB,2BAC/B,gBACN,0BAA0B,WAAW,kBACpC,iBACT;;;;WAiDY"}

package/dist/index.d.mts

@@ -3,6 +3,13 @@ import { ClientInferPublisherInput, ContractDefinition, InferPublisherNames } fr
 
 //#region src/client.d.ts
 
+/**
+ * Options for creating a client
+ */
+interface CreateClientOptions<TContract extends ContractDefinition> {
+  contract: TContract;
+  connection: ChannelModel;
+}
 /**
  * Options for publishing a message
  */
@@ -13,15 +20,16 @@ interface PublishOptions {
 /**
  * Type-safe AMQP client for publishing messages
  */
-declare class AmqpClient<TContract extends ContractDefinition> {
+declare class TypedAmqpClient<TContract extends ContractDefinition> {
   private readonly contract;
+  private readonly connection;
   private channel;
-  private connection;
-  constructor(contract: TContract);
+  private constructor();
   /**
-   * Connect to AMQP broker
+   * Create a type-safe AMQP client from a contract
+   * The client will automatically connect to the AMQP broker
    */
-  connect(connection: ChannelModel): Promise<void>;
+  static create<TContract extends ContractDefinition>(options: CreateClientOptions<TContract>): Promise<TypedAmqpClient<TContract>>;
   /**
    * Publish a message using a defined publisher
    */
@@ -30,11 +38,11 @@ declare class AmqpClient<TContract extends ContractDefinition> {
    * Close the connection
    */
   close(): Promise<void>;
+  /**
+   * Connect to AMQP broker
+   */
+  private init;
 }
-/**
- * Create a type-safe AMQP client from a contract
- */
-declare function createClient<TContract extends ContractDefinition>(contract: TContract): AmqpClient<TContract>;
 //#endregion
-export { AmqpClient, type PublishOptions, createClient };
+export { type CreateClientOptions, type PublishOptions, TypedAmqpClient };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAQa,UARI,cAAA,CAQM;EAAmB,UAAA,CAAA,EAAA,MAAA;EAID,OAAA,CAAA,EAV7B,OAAA,CAAQ,OAUqB;;;;;AAkDtB,cAtDN,UAsDM,CAAA,kBAtDuB,kBAsDvB,CAAA,CAAA;EACoB,iBAAA,QAAA;EAAW,QAAA,OAAA;EAArC,QAAA,UAAA;EACC,WAAA,CAAA,QAAA,EApD2B,SAoD3B;EACT;;;EA8DW,OAAA,CAAA,UAAY,EA9GA,YA8GA,CAAA,EA9Ge,OA8Gf,CAAA,IAAA,CAAA;EAAmB;;;EAE5C,OAAA,CAAA,cApE2B,mBAoE3B,CApE+C,SAoE/C,CAAA,CAAA,CAAA,aAAA,EAnEgB,KAmEhB,EAAA,OAAA,EAlEU,yBAkEV,CAlEoC,SAkEpC,EAlE+C,KAkE/C,CAAA,EAAA,OAAA,CAAA,EAjEW,cAiEX,CAAA,EAhEE,OAgEF,CAAA,OAAA,CAAA;EAAU;;;WAjBI;;;;;iBAeD,+BAA+B,8BACnC,YACT,WAAW"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAAuD,UAAtC,mBAAsC,CAAA,kBAAA,kBAAA,CAAA,CAAA;EAC3C,QAAA,EAAA,SAAA;EACE,UAAA,EAAA,YAAA;;AAMd;AAQA;;AAYwC,UApBvB,cAAA,CAoBuB;EACP,UAAA,CAAA,EAAA,MAAA;EAApB,OAAA,CAAA,EAnBD,OAAA,CAAQ,OAmBP;;;;;AAUiB,cAvBjB,eAuBiB,CAAA,kBAvBiB,kBAuBjB,CAAA,CAAA;EACX,iBAAA,QAAA;EACoB,iBAAA,UAAA;EAAW,QAAA,OAAA;EAArC,QAAA,WAAA,CAAA;EACC;;;;kCAd0B,6BAC3B,oBAAoB,aAC5B,QAAQ,gBAAgB;;;;wBASC,oBAAoB,2BAC/B,gBACN,0BAA0B,WAAW,kBACpC,iBACT;;;;WAiDY"}

package/dist/index.mjs

@@ -2,37 +2,26 @@
 /**
 * Type-safe AMQP client for publishing messages
 */
-var AmqpClient = class {
+var TypedAmqpClient = class TypedAmqpClient {
 	channel = null;
-	connection = null;
-	constructor(contract) {
+	constructor(contract, connection) {
 		this.contract = contract;
+		this.connection = connection;
 	}
 	/**
-	* Connect to AMQP broker
+	* Create a type-safe AMQP client from a contract
+	* The client will automatically connect to the 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, {
-			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, {
-			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);
+	static async create(options) {
+		const client = new TypedAmqpClient(options.contract, options.connection);
+		await client.init();
+		return client;
 	}
 	/**
 	* Publish a message using a defined publisher
 	*/
 	async publish(publisherName, message, options) {
-		if (!this.channel) throw new Error("Client not connected. Call connect() first.");
+		if (!this.channel) throw new Error("Client not initialized. Create the client using TypedAmqpClient.create() to establish a connection.");
 		const publishers = this.contract.publishers;
 		if (!publishers) throw new Error("No publishers defined in contract");
 		const publisher = publishers[publisherName];
@@ -49,23 +38,30 @@ var AmqpClient = class {
 	* Close the connection
 	*/
 	async close() {
-		if (this.channel) {
-			await this.channel.close();
-			this.channel = null;
-		}
-		if (this.connection) {
-			await this.connection.close();
-			this.connection = null;
-		}
+		if (this.channel) await this.channel.close();
+		await this.connection.close();
+	}
+	/**
+	* Connect to AMQP broker
+	*/
+	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) 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) for (const binding of Object.values(this.contract.bindings)) await this.channel.bindQueue(binding.queue, binding.exchange, binding.routingKey ?? "", binding.arguments);
 	}
 };
-/**
-* Create a type-safe AMQP client from a contract
-*/
-function createClient(contract) {
-	return new AmqpClient(contract);
-}
 
 //#endregion
-export { AmqpClient, createClient };
+export { TypedAmqpClient };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["contract: TContract"],"sources":["../src/client.ts"],"sourcesContent":["import type { Channel, ChannelModel, Options } from \"amqplib\";\nimport type {\n  ClientInferPublisherInput,\n  ContractDefinition,\n  InferPublisherNames,\n} from \"@amqp-contract/contract\";\n\n/**\n * Options for publishing a message\n */\nexport interface PublishOptions {\n  routingKey?: string;\n  options?: Options.Publish;\n}\n\n/**\n * Type-safe AMQP client for publishing messages\n */\nexport class AmqpClient<TContract extends ContractDefinition> {\n  private channel: Channel | null = null;\n  private connection: ChannelModel | null = null;\n\n  constructor(private readonly contract: TContract) {}\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   * Publish a message using a defined publisher\n   */\n  async publish<TName extends InferPublisherNames<TContract>>(\n    publisherName: TName,\n    message: ClientInferPublisherInput<TContract, TName>,\n    options?: PublishOptions,\n  ): Promise<boolean> {\n    if (!this.channel) {\n      throw new Error(\"Client not connected. Call connect() first.\");\n    }\n\n    const publishers = this.contract.publishers as Record<string, unknown>;\n    if (!publishers) {\n      throw new Error(\"No publishers defined in contract\");\n    }\n\n    const publisher = publishers[publisherName as string];\n    if (!publisher || typeof publisher !== \"object\") {\n      throw new Error(`Publisher \"${String(publisherName)}\" not found in contract`);\n    }\n\n    const publisherDef = publisher as {\n      exchange: string;\n      routingKey?: string;\n      message: { \"~standard\": { validate: (value: unknown) => unknown } };\n    };\n\n    // Validate message using schema\n    const validation = publisherDef.message[\"~standard\"].validate(message);\n    if (\n      typeof validation === \"object\" &&\n      validation !== null &&\n      \"issues\" in validation &&\n      validation.issues\n    ) {\n      throw new Error(`Message validation failed: ${JSON.stringify(validation.issues)}`);\n    }\n\n    const validatedMessage =\n      typeof validation === \"object\" && validation !== null && \"value\" in validation\n        ? validation.value\n        : message;\n\n    // Publish message\n    const routingKey = options?.routingKey ?? publisherDef.routingKey ?? \"\";\n    const content = Buffer.from(JSON.stringify(validatedMessage));\n\n    return this.channel.publish(publisherDef.exchange, routingKey, content, options?.options);\n  }\n\n  /**\n   * Close the connection\n   */\n  async close(): Promise<void> {\n    if (this.channel) {\n      await this.channel.close();\n      this.channel = null;\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 client from a contract\n */\nexport function createClient<TContract extends ContractDefinition>(\n  contract: TContract,\n): AmqpClient<TContract> {\n  return new AmqpClient(contract);\n}\n"],"mappings":";;;;AAkBA,IAAa,aAAb,MAA8D;CAC5D,AAAQ,UAA0B;CAClC,AAAQ,aAAkC;CAE1C,YAAY,AAAiBA,UAAqB;EAArB;;;;;CAK7B,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,QACJ,eACA,SACA,SACkB;AAClB,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MAAM,8CAA8C;EAGhE,MAAM,aAAa,KAAK,SAAS;AACjC,MAAI,CAAC,WACH,OAAM,IAAI,MAAM,oCAAoC;EAGtD,MAAM,YAAY,WAAW;AAC7B,MAAI,CAAC,aAAa,OAAO,cAAc,SACrC,OAAM,IAAI,MAAM,cAAc,OAAO,cAAc,CAAC,yBAAyB;EAG/E,MAAM,eAAe;EAOrB,MAAM,aAAa,aAAa,QAAQ,aAAa,SAAS,QAAQ;AACtE,MACE,OAAO,eAAe,YACtB,eAAe,QACf,YAAY,cACZ,WAAW,OAEX,OAAM,IAAI,MAAM,8BAA8B,KAAK,UAAU,WAAW,OAAO,GAAG;EAGpF,MAAM,mBACJ,OAAO,eAAe,YAAY,eAAe,QAAQ,WAAW,aAChE,WAAW,QACX;EAGN,MAAM,aAAa,SAAS,cAAc,aAAa,cAAc;EACrE,MAAM,UAAU,OAAO,KAAK,KAAK,UAAU,iBAAiB,CAAC;AAE7D,SAAO,KAAK,QAAQ,QAAQ,aAAa,UAAU,YAAY,SAAS,SAAS,QAAQ;;;;;CAM3F,MAAM,QAAuB;AAC3B,MAAI,KAAK,SAAS;AAChB,SAAM,KAAK,QAAQ,OAAO;AAC1B,QAAK,UAAU;;AAEjB,MAAI,KAAK,YAAY;AACnB,SAAO,KAAK,WAAqD,OAAO;AACxE,QAAK,aAAa;;;;;;;AAQxB,SAAgB,aACd,UACuB;AACvB,QAAO,IAAI,WAAW,SAAS"}
+{"version":3,"file":"index.mjs","names":["contract: TContract","connection: ChannelModel"],"sources":["../src/client.ts"],"sourcesContent":["import type { Channel, ChannelModel, Options } from \"amqplib\";\nimport type {\n  ClientInferPublisherInput,\n  ContractDefinition,\n  InferPublisherNames,\n} from \"@amqp-contract/contract\";\n\n/**\n * Options for creating a client\n */\nexport interface CreateClientOptions<TContract extends ContractDefinition> {\n  contract: TContract;\n  connection: ChannelModel;\n}\n\n/**\n * Options for publishing a message\n */\nexport interface PublishOptions {\n  routingKey?: string;\n  options?: Options.Publish;\n}\n\n/**\n * Type-safe AMQP client for publishing messages\n */\nexport class TypedAmqpClient<TContract extends ContractDefinition> {\n  private channel: Channel | null = null;\n\n  private constructor(\n    private readonly contract: TContract,\n    private readonly connection: ChannelModel,\n  ) {}\n\n  /**\n   * Create a type-safe AMQP client from a contract\n   * The client will automatically connect to the AMQP broker\n   */\n  static async create<TContract extends ContractDefinition>(\n    options: CreateClientOptions<TContract>,\n  ): Promise<TypedAmqpClient<TContract>> {\n    const client = new TypedAmqpClient(options.contract, options.connection);\n    await client.init();\n    return client;\n  }\n\n  /**\n   * Publish a message using a defined publisher\n   */\n  async publish<TName extends InferPublisherNames<TContract>>(\n    publisherName: TName,\n    message: ClientInferPublisherInput<TContract, TName>,\n    options?: PublishOptions,\n  ): Promise<boolean> {\n    if (!this.channel) {\n      throw new Error(\n        \"Client not initialized. Create the client using TypedAmqpClient.create() to establish a connection.\",\n      );\n    }\n\n    const publishers = this.contract.publishers as Record<string, unknown>;\n    if (!publishers) {\n      throw new Error(\"No publishers defined in contract\");\n    }\n\n    const publisher = publishers[publisherName as string];\n    if (!publisher || typeof publisher !== \"object\") {\n      throw new Error(`Publisher \"${String(publisherName)}\" not found in contract`);\n    }\n\n    const publisherDef = publisher as {\n      exchange: string;\n      routingKey?: string;\n      message: { \"~standard\": { validate: (value: unknown) => unknown } };\n    };\n\n    // Validate message using schema\n    const validation = publisherDef.message[\"~standard\"].validate(message);\n    if (\n      typeof validation === \"object\" &&\n      validation !== null &&\n      \"issues\" in validation &&\n      validation.issues\n    ) {\n      throw new Error(`Message validation failed: ${JSON.stringify(validation.issues)}`);\n    }\n\n    const validatedMessage =\n      typeof validation === \"object\" && validation !== null && \"value\" in validation\n        ? validation.value\n        : message;\n\n    // Publish message\n    const routingKey = options?.routingKey ?? publisherDef.routingKey ?? \"\";\n    const content = Buffer.from(JSON.stringify(validatedMessage));\n\n    return this.channel.publish(publisherDef.exchange, routingKey, content, options?.options);\n  }\n\n  /**\n   * Close the connection\n   */\n  async close(): Promise<void> {\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"],"mappings":";;;;AA0BA,IAAa,kBAAb,MAAa,gBAAsD;CACjE,AAAQ,UAA0B;CAElC,AAAQ,YACN,AAAiBA,UACjB,AAAiBC,YACjB;EAFiB;EACA;;;;;;CAOnB,aAAa,OACX,SACqC;EACrC,MAAM,SAAS,IAAI,gBAAgB,QAAQ,UAAU,QAAQ,WAAW;AACxE,QAAM,OAAO,MAAM;AACnB,SAAO;;;;;CAMT,MAAM,QACJ,eACA,SACA,SACkB;AAClB,MAAI,CAAC,KAAK,QACR,OAAM,IAAI,MACR,sGACD;EAGH,MAAM,aAAa,KAAK,SAAS;AACjC,MAAI,CAAC,WACH,OAAM,IAAI,MAAM,oCAAoC;EAGtD,MAAM,YAAY,WAAW;AAC7B,MAAI,CAAC,aAAa,OAAO,cAAc,SACrC,OAAM,IAAI,MAAM,cAAc,OAAO,cAAc,CAAC,yBAAyB;EAG/E,MAAM,eAAe;EAOrB,MAAM,aAAa,aAAa,QAAQ,aAAa,SAAS,QAAQ;AACtE,MACE,OAAO,eAAe,YACtB,eAAe,QACf,YAAY,cACZ,WAAW,OAEX,OAAM,IAAI,MAAM,8BAA8B,KAAK,UAAU,WAAW,OAAO,GAAG;EAGpF,MAAM,mBACJ,OAAO,eAAe,YAAY,eAAe,QAAQ,WAAW,aAChE,WAAW,QACX;EAGN,MAAM,aAAa,SAAS,cAAc,aAAa,cAAc;EACrE,MAAM,UAAU,OAAO,KAAK,KAAK,UAAU,iBAAiB,CAAC;AAE7D,SAAO,KAAK,QAAQ,QAAQ,aAAa,UAAU,YAAY,SAAS,SAAS,QAAQ;;;;;CAM3F,MAAM,QAAuB;AAC3B,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amqp-contract/client",
-  "version": "0.0.2",
+  "version": "0.0.5",
   "description": "Client utilities for publishing 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,7 @@
     "typescript": "5.9.3",
     "vitest": "4.0.16",
     "zod": "4.2.1",
+    "@amqp-contract/testing": "0.0.5",
     "@amqp-contract/tsconfig": "0.0.0"
   },
   "peerDependencies": {
@@ -60,8 +61,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"
   }
 }