@amqp-contract/client 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,12 @@
 # @amqp-contract/client
 
-Type-safe AMQP client for publishing messages using amqp-contract with explicit error handling via `Result` types.
+**Type-safe AMQP client for publishing messages using amqp-contract with explicit error handling via `Result` types.**
+
+[![CI](https://github.com/btravers/amqp-contract/actions/workflows/ci.yml/badge.svg)](https://github.com/btravers/amqp-contract/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@amqp-contract/client.svg?logo=npm)](https://www.npmjs.com/package/@amqp-contract/client)
+[![npm downloads](https://img.shields.io/npm/dm/@amqp-contract/client.svg)](https://www.npmjs.com/package/@amqp-contract/client)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 📖 **[Full documentation →](https://btravers.github.io/amqp-contract/api/client)**
 
@@ -16,14 +22,22 @@ pnpm add @amqp-contract/client
 import { TypedAmqpClient } from '@amqp-contract/client';
 import { contract } from './contract';
 
-// Create client from contract (automatically connects)
-const client = await TypedAmqpClient.create({
+// Create client from contract (automatically connects and waits for connection)
+const clientResult = await TypedAmqpClient.create({
   contract,
-  connection: 'amqp://localhost'
+  urls: ['amqp://localhost']
 });
 
+// Handle connection errors
+if (clientResult.isError()) {
+  console.error('Failed to create client:', clientResult.error);
+  throw clientResult.error; // or handle appropriately
+}
+
+const client = clientResult.get();
+
 // Publish message with explicit error handling
-const result = client.publish('orderCreated', {
+const result = await client.publish('orderCreated', {
   orderId: 'ORD-123',
   amount: 99.99,
 });
@@ -60,16 +74,31 @@ publish(): Result<boolean, TechnicalError | MessageValidationError>
 
 ### `TypedAmqpClient.create(options)`
 
-Create a type-safe AMQP client from a contract. Automatically connects to RabbitMQ.
+Create a type-safe AMQP client from a contract. Automatically connects to RabbitMQ and waits for the connection to be ready.
 
 **Parameters:**
 
 - `options.contract` - Contract definition
-- `options.connection` - AMQP connection URL (string) or connection options (Options.Connect)
+- `options.urls` - Array of AMQP connection URLs (e.g., `['amqp://localhost']`)
+- `options.connectionOptions` - Optional connection manager options
 
-**Returns:** `Promise<TypedAmqpClient>`
+**Returns:** `Future<Result<TypedAmqpClient, TechnicalError>>`
 
-**Throws:** Connection errors (programming errors)
+The method returns a Future that resolves to a Result. You must:
+
+1. Await the Future to get the Result
+2. Check if the Result is Ok or Error
+3. Extract the client using `.get()` if successful
+
+**Example:**
+
+```typescript
+const clientResult = await TypedAmqpClient.create({ contract, urls: ['amqp://localhost'] });
+if (clientResult.isError()) {
+  throw clientResult.error; // Handle connection error
+}
+const client = clientResult.get();
+```
 
 ### `TypedAmqpClient.publish(publisherName, message, options?)`
 
@@ -107,6 +136,10 @@ Close the channel and connection.
 
 **Returns:** `Promise<void>`
 
+## Documentation
+
+📖 **[Read the full documentation →](https://btravers.github.io/amqp-contract)**
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -1,6 +1,5 @@
-let amqplib = require("amqplib");
-let _amqp_contract_core = require("@amqp-contract/core");
 let _swan_io_boxed = require("@swan-io/boxed");
+let _amqp_contract_core = require("@amqp-contract/core");
 
 //#region src/errors.ts
 /**
@@ -43,61 +42,56 @@ var MessageValidationError = class extends ClientError {
 * Type-safe AMQP client for publishing messages
 */
 var TypedAmqpClient = class TypedAmqpClient {
-	channel = null;
-	connection = null;
-	constructor(contract, connectionOptions) {
+	constructor(contract, amqpClient) {
 		this.contract = contract;
-		this.connectionOptions = connectionOptions;
+		this.amqpClient = amqpClient;
 	}
 	/**
-	* Create a type-safe AMQP client from a contract
-	* The client will automatically connect to the AMQP broker
+	* Create a type-safe AMQP client from a contract.
+	*
+	* Connection management (including automatic reconnection) is handled internally
+	* by amqp-connection-manager via the {@link AmqpClient}. The client establishes
+	* infrastructure asynchronously in the background once the connection is ready.
 	*/
-	static async create(options) {
-		const client = new TypedAmqpClient(options.contract, options.connection);
-		await client.init();
-		return client;
+	static create({ contract, urls, connectionOptions }) {
+		const client = new TypedAmqpClient(contract, new _amqp_contract_core.AmqpClient(contract, {
+			urls,
+			connectionOptions
+		}));
+		return client.waitForConnectionReady().mapOk(() => client);
 	}
 	/**
 	* Publish a message using a defined publisher
 	* Returns Result.Ok(true) on success, or Result.Error with specific error on failure
 	*/
 	publish(publisherName, message, options) {
-		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");
+		if (!publishers) return _swan_io_boxed.Future.value(_swan_io_boxed.Result.Error(new TechnicalError("No publishers defined in contract")));
 		const publisher = publishers[publisherName];
-		if (!publisher || typeof publisher !== "object") throw new Error(`Publisher "${String(publisherName)}" not found in contract`);
-		const publisherDef = publisher;
-		const validation = publisherDef.message.payload["~standard"].validate(message);
-		if (typeof validation === "object" && validation !== null && "issues" in validation && validation.issues) return _swan_io_boxed.Result.Error(new MessageValidationError(String(publisherName), validation.issues));
-		const validatedMessage = typeof validation === "object" && validation !== null && "value" in validation ? validation.value : message;
-		const routingKey = options?.routingKey ?? publisherDef.routingKey ?? "";
-		const content = Buffer.from(JSON.stringify(validatedMessage));
-		const published = this.channel.publish(publisherDef.exchange.name, routingKey, content, options?.options);
-		if (!published) return _swan_io_boxed.Result.Error(new TechnicalError(`Failed to publish message for publisher "${String(publisherName)}": Channel rejected the message (buffer full or other channel issue)`));
-		return _swan_io_boxed.Result.Ok(published);
+		if (!publisher) return _swan_io_boxed.Future.value(_swan_io_boxed.Result.Error(new TechnicalError(`Publisher "${String(publisherName)}" not found in contract`)));
+		const validateMessage = () => {
+			const validationResult = publisher.message.payload["~standard"].validate(message);
+			return _swan_io_boxed.Future.fromPromise(validationResult instanceof Promise ? validationResult : Promise.resolve(validationResult)).mapError((error) => new TechnicalError(`Validation failed`, error)).mapOkToResult((validation) => {
+				if (validation.issues) return _swan_io_boxed.Result.Error(new MessageValidationError(String(publisherName), validation.issues));
+				return _swan_io_boxed.Result.Ok(validation.value);
+			});
+		};
+		const publishMessage = (validatedMessage) => {
+			return _swan_io_boxed.Future.fromPromise(this.amqpClient.channel.publish(publisher.exchange.name, publisher.routingKey ?? "", validatedMessage, options)).mapError((error) => new TechnicalError(`Failed to publish message`, error)).mapOkToResult((published) => {
+				if (!published) return _swan_io_boxed.Result.Error(new TechnicalError(`Failed to publish message for publisher "${String(publisherName)}": Channel rejected the message (buffer full or other channel issue)`));
+				return _swan_io_boxed.Result.Ok(published);
+			});
+		};
+		return validateMessage().flatMapOk((validatedMessage) => publishMessage(validatedMessage));
 	}
 	/**
 	* Close the channel and connection
 	*/
-	async close() {
-		if (this.channel) {
-			await this.channel.close();
-			this.channel = null;
-		}
-		if (this.connection) {
-			await this.connection.close();
-			this.connection = null;
-		}
+	close() {
+		return _swan_io_boxed.Future.fromPromise(this.amqpClient.close()).mapError((error) => new TechnicalError("Failed to close AMQP connection", error)).mapOk(() => void 0);
 	}
-	/**
-	* Connect to AMQP broker
-	*/
-	async init() {
-		this.connection = await (0, amqplib.connect)(this.connectionOptions);
-		this.channel = await this.connection.createChannel();
-		await (0, _amqp_contract_core.setupInfra)(this.channel, this.contract);
+	waitForConnectionReady() {
+		return _swan_io_boxed.Future.fromPromise(this.amqpClient.channel.waitForConnect()).mapError((error) => new TechnicalError("Failed to wait for connection ready", error));
 	}
 };
 

package/dist/index.d.cts

@@ -1,6 +1,8 @@
 import { Options } from "amqplib";
-import { ClientInferPublisherInput, ContractDefinition, InferPublisherNames } from "@amqp-contract/contract";
-import { Result } from "@swan-io/boxed";
+import { ContractDefinition, InferPublisherNames, PublisherDefinition } from "@amqp-contract/contract";
+import { Future, Result } from "@swan-io/boxed";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { AmqpConnectionManagerOptions, ConnectionUrl } from "amqp-connection-manager";
 
 //#region src/errors.d.ts
 /**
@@ -26,49 +28,67 @@ declare class MessageValidationError extends ClientError {
   constructor(publisherName: string, issues: unknown);
 }
 //#endregion
+//#region src/types.d.ts
+/**
+ * Infer the TypeScript type from a schema
+ */
+type InferSchemaInput<TSchema extends StandardSchemaV1> = TSchema extends StandardSchemaV1<infer TInput> ? TInput : never;
+/**
+ * Infer publisher message input type
+ */
+type PublisherInferInput<TPublisher extends PublisherDefinition> = InferSchemaInput<TPublisher["message"]["payload"]>;
+/**
+ * Infer all publishers from contract
+ */
+type InferPublishers<TContract extends ContractDefinition> = NonNullable<TContract["publishers"]>;
+/**
+ * Get specific publisher definition from contract
+ */
+type InferPublisher<TContract extends ContractDefinition, TName extends InferPublisherNames<TContract>> = InferPublishers<TContract>[TName];
+/**
+ * Infer publisher input type (message payload) for a specific publisher in a contract
+ */
+type ClientInferPublisherInput<TContract extends ContractDefinition, TName extends InferPublisherNames<TContract>> = PublisherInferInput<InferPublisher<TContract, TName>>;
+//#endregion
 //#region src/client.d.ts
 /**
  * Options for creating a client
  */
-interface CreateClientOptions<TContract extends ContractDefinition> {
+type CreateClientOptions<TContract extends ContractDefinition> = {
   contract: TContract;
-  connection: string | Options.Connect;
-}
-/**
- * Options for publishing a message
- */
-interface PublishOptions {
-  routingKey?: string;
-  options?: Options.Publish;
-}
+  urls: ConnectionUrl[];
+  connectionOptions?: AmqpConnectionManagerOptions | undefined;
+};
 /**
  * Type-safe AMQP client for publishing messages
  */
 declare class TypedAmqpClient<TContract extends ContractDefinition> {
   private readonly contract;
-  private readonly connectionOptions;
-  private channel;
-  private connection;
+  private readonly amqpClient;
   private constructor();
   /**
-   * Create a type-safe AMQP client from a contract
-   * The client will automatically connect to the AMQP broker
+   * Create a type-safe AMQP client from a contract.
+   *
+   * Connection management (including automatic reconnection) is handled internally
+   * by amqp-connection-manager via the {@link AmqpClient}. The client establishes
+   * infrastructure asynchronously in the background once the connection is ready.
    */
-  static create<TContract extends ContractDefinition>(options: CreateClientOptions<TContract>): Promise<TypedAmqpClient<TContract>>;
+  static create<TContract extends ContractDefinition>({
+    contract,
+    urls,
+    connectionOptions
+  }: CreateClientOptions<TContract>): Future<Result<TypedAmqpClient<TContract>, TechnicalError>>;
   /**
    * Publish a message using a defined publisher
    * Returns Result.Ok(true) on success, or Result.Error with specific error on failure
    */
-  publish<TName extends InferPublisherNames<TContract>>(publisherName: TName, message: ClientInferPublisherInput<TContract, TName>, options?: PublishOptions): Result<boolean, TechnicalError | MessageValidationError>;
+  publish<TName extends InferPublisherNames<TContract>>(publisherName: TName, message: ClientInferPublisherInput<TContract, TName>, options?: Options.Publish): Future<Result<boolean, TechnicalError | MessageValidationError>>;
   /**
    * Close the channel and connection
    */
-  close(): Promise<void>;
-  /**
-   * Connect to AMQP broker
-   */
-  private init;
+  close(): Future<Result<void, TechnicalError>>;
+  private waitForConnectionReady;
 }
 //#endregion
-export { type CreateClientOptions, MessageValidationError, type PublishOptions, TechnicalError, TypedAmqpClient };
+export { type ClientInferPublisherInput, type CreateClientOptions, MessageValidationError, TechnicalError, TypedAmqpClient };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;;uBAGe,WAAA,SAAoB,KAAA;;;AAkBnC;AAaA;;;cAba,cAAA,SAAuB,WAAA;ECPnB,SAAA,KAAA,CAAA,EAAA,OAAmB,GAAA,SAAA;EAAmB,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,OAAA,GAAA,SAAA;;;;AAQvD;AAQa,cDIA,sBAAA,SAA+B,WAAA,CCJhB;EAAmB,SAAA,aAAA,EAAA,MAAA;EAaP,SAAA,MAAA,EAAA,OAAA;EACP,WAAA,CAAA,aAAA,EAAA,MAAA,EAAA,MAAA,EAAA,OAAA;;;;;;ADvBjC;AAaa,UCpBI,mBDoBmB,CAAA,kBCpBmB,kBDoBA,CAAA,CAAA;YCnB3C;uBACW,OAAA,CAAQ;;AAF/B;;;AAEuB,UAMN,cAAA,CANc;EAAO,UAAA,CAAA,EAAA,MAAA;EAMrB,OAAA,CAAA,EAEL,OAAA,CAAQ,OAFW;AAQ/B;;;;AAca,cAdA,eAcA,CAAA,kBAdkC,kBAclC,CAAA,CAAA;EACgB,iBAAA,QAAA;EAAhB,iBAAA,iBAAA;EAAR,QAAA,OAAA;EAUuC,QAAA,UAAA;EAApB,QAAA,WAAA,CAAA;EACL;;;;EAEL,OAAA,MAAA,CAAA,kBAf0B,kBAe1B,CAAA,CAAA,OAAA,EAdD,mBAcC,CAdmB,SAcnB,CAAA,CAAA,EAbT,OAaS,CAbD,eAaC,CAbe,SAaf,CAAA,CAAA;EACO;;;;EAgEG,OAAA,CAAA,cApEA,mBAoEA,CApEoB,SAoEpB,CAAA,CAAA,CAAA,aAAA,EAnEL,KAmEK,EAAA,OAAA,EAlEX,yBAkEW,CAlEe,SAkEf,EAlE0B,KAkE1B,CAAA,EAAA,OAAA,CAAA,EAjEV,cAiEU,CAAA,EAhEnB,MAgEmB,CAAA,OAAA,EAhEH,cAgEG,GAhEc,sBAgEd,CAAA;;;;WAAP"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/types.ts","../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;uBAGe,WAAA,SAAoB,KAAA;;;;;AAkBnC;AAaA;cAba,cAAA,SAAuB,WAAA;;;AChBH;;;;AAMC,cDuBrB,sBAAA,SAA+B,WAAA,CCvBV;EAK7B,SAAA,aAAmB,EAAA,MAAA;EAAoB,SAAA,MAAA,EAAA,OAAA;EAC1C,WAAA,CAAA,aAAA,EAAA,MAAA,EAAA,MAAA,EAAA,OAAA;;;;;;;KAPG,iCAAiC,oBACpC,gBAAgB;;;ADUlB;AAaA,KClBK,mBDkBQ,CAAA,mBClB+B,mBDkBW,CAAA,GClBY,gBDkBZ,CCjBrD,UDiBqD,CAAA,SAAA,CAAA,CAAA,SAAA,CAAA,CAAA;;;;AC7BtB,KAkB5B,eAbA,CAAA,kBAakC,kBAblB,CAAA,GAawC,WAbxC,CAaoD,SAbpD,CAAA,YAAA,CAAA,CAAA;;;;KAkBhB,cAjB6B,CAAA,kBAkBd,kBAlBc,EAAA,cAmBlB,mBAnBkB,CAmBE,SAnBF,CAAA,CAAA,GAoB9B,eApB8B,CAoBd,SApBc,CAAA,CAoBH,KApBG,CAAA;AAAA;;;AAKiC,KAoBvD,yBApBuD,CAAA,kBAqB/C,kBArB+C,EAAA,cAsBnD,mBAtBmD,CAsB/B,SAtB+B,CAAA,CAAA,GAuB/D,mBAvB+D,CAuB3C,cAvB2C,CAuB5B,SAvB4B,EAuBjB,KAvBiB,CAAA,CAAA;;;;;ADKnE;AAaa,KEvBD,mBFuBwB,CAAA,kBEvBc,kBFuBK,CAAA,GAAA;YEtB3C;QACJ;sBACc;ADTW,CAAA;;;;AAMC,cCSrB,eDTqB,CAAA,kBCSa,kBDTb,CAAA,CAAA;EAK7B,iBAAA,QAAmB;EAAoB,iBAAA,UAAA;EAC1C,QAAA,WAAA,CAAA;EADiE;;AAAgB;;;;;EAY9E,OAAA,MAAA,CAAA,kBCK6B,kBDLf,CAAA,CAAA;IAAA,QAAA;IAAA,IAAA;IAAA;EAAA,CAAA,ECSd,mBDTc,CCSM,SDTN,CAAA,CAAA,ECSmB,MDTnB,CCS0B,MDT1B,CCSiC,eDTjC,CCSiD,SDTjD,CAAA,ECS6D,cDT7D,CAAA,CAAA;EACC;;;;EAEhB,OAAA,CAAA,cCmBoB,mBDnBpB,CCmBwC,SDnBxC,CAAA,CAAA,CAAA,aAAA,ECoBe,KDpBf,EAAA,OAAA,ECqBS,yBDrBT,CCqBmC,SDrBnC,ECqB8C,KDrB9C,CAAA,EAAA,OAAA,CAAA,ECsBU,OAAA,CAAQ,ODtBlB,CAAA,ECuBC,MDvBD,CCuBQ,MDvBR,CAAA,OAAA,ECuBwB,cDvBxB,GCuByC,sBDvBzC,CAAA,CAAA;EAA2B;;AAK/B;EACoB,KAAA,CAAA,CAAA,EC+ET,MD/ES,CC+EF,MD/EE,CAAA,IAAA,EC+EW,cD/EX,CAAA,CAAA;EACgB,QAAA,sBAAA"}

package/dist/index.d.mts

@@ -1,6 +1,8 @@
+import { Future, Result } from "@swan-io/boxed";
 import { Options } from "amqplib";
-import { Result } from "@swan-io/boxed";
-import { ClientInferPublisherInput, ContractDefinition, InferPublisherNames } from "@amqp-contract/contract";
+import { ContractDefinition, InferPublisherNames, PublisherDefinition } from "@amqp-contract/contract";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { AmqpConnectionManagerOptions, ConnectionUrl } from "amqp-connection-manager";
 
 //#region src/errors.d.ts
 /**
@@ -26,49 +28,67 @@ declare class MessageValidationError extends ClientError {
   constructor(publisherName: string, issues: unknown);
 }
 //#endregion
+//#region src/types.d.ts
+/**
+ * Infer the TypeScript type from a schema
+ */
+type InferSchemaInput<TSchema extends StandardSchemaV1> = TSchema extends StandardSchemaV1<infer TInput> ? TInput : never;
+/**
+ * Infer publisher message input type
+ */
+type PublisherInferInput<TPublisher extends PublisherDefinition> = InferSchemaInput<TPublisher["message"]["payload"]>;
+/**
+ * Infer all publishers from contract
+ */
+type InferPublishers<TContract extends ContractDefinition> = NonNullable<TContract["publishers"]>;
+/**
+ * Get specific publisher definition from contract
+ */
+type InferPublisher<TContract extends ContractDefinition, TName extends InferPublisherNames<TContract>> = InferPublishers<TContract>[TName];
+/**
+ * Infer publisher input type (message payload) for a specific publisher in a contract
+ */
+type ClientInferPublisherInput<TContract extends ContractDefinition, TName extends InferPublisherNames<TContract>> = PublisherInferInput<InferPublisher<TContract, TName>>;
+//#endregion
 //#region src/client.d.ts
 /**
  * Options for creating a client
  */
-interface CreateClientOptions<TContract extends ContractDefinition> {
+type CreateClientOptions<TContract extends ContractDefinition> = {
   contract: TContract;
-  connection: string | Options.Connect;
-}
-/**
- * Options for publishing a message
- */
-interface PublishOptions {
-  routingKey?: string;
-  options?: Options.Publish;
-}
+  urls: ConnectionUrl[];
+  connectionOptions?: AmqpConnectionManagerOptions | undefined;
+};
 /**
  * Type-safe AMQP client for publishing messages
  */
 declare class TypedAmqpClient<TContract extends ContractDefinition> {
   private readonly contract;
-  private readonly connectionOptions;
-  private channel;
-  private connection;
+  private readonly amqpClient;
   private constructor();
   /**
-   * Create a type-safe AMQP client from a contract
-   * The client will automatically connect to the AMQP broker
+   * Create a type-safe AMQP client from a contract.
+   *
+   * Connection management (including automatic reconnection) is handled internally
+   * by amqp-connection-manager via the {@link AmqpClient}. The client establishes
+   * infrastructure asynchronously in the background once the connection is ready.
    */
-  static create<TContract extends ContractDefinition>(options: CreateClientOptions<TContract>): Promise<TypedAmqpClient<TContract>>;
+  static create<TContract extends ContractDefinition>({
+    contract,
+    urls,
+    connectionOptions
+  }: CreateClientOptions<TContract>): Future<Result<TypedAmqpClient<TContract>, TechnicalError>>;
   /**
    * Publish a message using a defined publisher
    * Returns Result.Ok(true) on success, or Result.Error with specific error on failure
    */
-  publish<TName extends InferPublisherNames<TContract>>(publisherName: TName, message: ClientInferPublisherInput<TContract, TName>, options?: PublishOptions): Result<boolean, TechnicalError | MessageValidationError>;
+  publish<TName extends InferPublisherNames<TContract>>(publisherName: TName, message: ClientInferPublisherInput<TContract, TName>, options?: Options.Publish): Future<Result<boolean, TechnicalError | MessageValidationError>>;
   /**
    * Close the channel and connection
    */
-  close(): Promise<void>;
-  /**
-   * Connect to AMQP broker
-   */
-  private init;
+  close(): Future<Result<void, TechnicalError>>;
+  private waitForConnectionReady;
 }
 //#endregion
-export { type CreateClientOptions, MessageValidationError, type PublishOptions, TechnicalError, TypedAmqpClient };
+export { type ClientInferPublisherInput, type CreateClientOptions, MessageValidationError, TechnicalError, TypedAmqpClient };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;;uBAGe,WAAA,SAAoB,KAAA;;;AAkBnC;AAaA;;;cAba,cAAA,SAAuB,WAAA;ECPnB,SAAA,KAAA,CAAA,EAAA,OAAmB,GAAA,SAAA;EAAmB,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,OAAA,GAAA,SAAA;;;;AAQvD;AAQa,cDIA,sBAAA,SAA+B,WAAA,CCJhB;EAAmB,SAAA,aAAA,EAAA,MAAA;EAaP,SAAA,MAAA,EAAA,OAAA;EACP,WAAA,CAAA,aAAA,EAAA,MAAA,EAAA,MAAA,EAAA,OAAA;;;;;;ADvBjC;AAaa,UCpBI,mBDoBmB,CAAA,kBCpBmB,kBDoBA,CAAA,CAAA;YCnB3C;uBACW,OAAA,CAAQ;;AAF/B;;;AAEuB,UAMN,cAAA,CANc;EAAO,UAAA,CAAA,EAAA,MAAA;EAMrB,OAAA,CAAA,EAEL,OAAA,CAAQ,OAFW;AAQ/B;;;;AAca,cAdA,eAcA,CAAA,kBAdkC,kBAclC,CAAA,CAAA;EACgB,iBAAA,QAAA;EAAhB,iBAAA,iBAAA;EAAR,QAAA,OAAA;EAUuC,QAAA,UAAA;EAApB,QAAA,WAAA,CAAA;EACL;;;;EAEL,OAAA,MAAA,CAAA,kBAf0B,kBAe1B,CAAA,CAAA,OAAA,EAdD,mBAcC,CAdmB,SAcnB,CAAA,CAAA,EAbT,OAaS,CAbD,eAaC,CAbe,SAaf,CAAA,CAAA;EACO;;;;EAgEG,OAAA,CAAA,cApEA,mBAoEA,CApEoB,SAoEpB,CAAA,CAAA,CAAA,aAAA,EAnEL,KAmEK,EAAA,OAAA,EAlEX,yBAkEW,CAlEe,SAkEf,EAlE0B,KAkE1B,CAAA,EAAA,OAAA,CAAA,EAjEV,cAiEU,CAAA,EAhEnB,MAgEmB,CAAA,OAAA,EAhEH,cAgEG,GAhEc,sBAgEd,CAAA;;;;WAAP"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/types.ts","../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;uBAGe,WAAA,SAAoB,KAAA;;;;;AAkBnC;AAaA;cAba,cAAA,SAAuB,WAAA;;;AChBH;;;;AAMC,cDuBrB,sBAAA,SAA+B,WAAA,CCvBV;EAK7B,SAAA,aAAmB,EAAA,MAAA;EAAoB,SAAA,MAAA,EAAA,OAAA;EAC1C,WAAA,CAAA,aAAA,EAAA,MAAA,EAAA,MAAA,EAAA,OAAA;;;;;;;KAPG,iCAAiC,oBACpC,gBAAgB;;;ADUlB;AAaA,KClBK,mBDkBQ,CAAA,mBClB+B,mBDkBW,CAAA,GClBY,gBDkBZ,CCjBrD,UDiBqD,CAAA,SAAA,CAAA,CAAA,SAAA,CAAA,CAAA;;;;AC7BtB,KAkB5B,eAbA,CAAA,kBAakC,kBAblB,CAAA,GAawC,WAbxC,CAaoD,SAbpD,CAAA,YAAA,CAAA,CAAA;;;;KAkBhB,cAjB6B,CAAA,kBAkBd,kBAlBc,EAAA,cAmBlB,mBAnBkB,CAmBE,SAnBF,CAAA,CAAA,GAoB9B,eApB8B,CAoBd,SApBc,CAAA,CAoBH,KApBG,CAAA;AAAA;;;AAKiC,KAoBvD,yBApBuD,CAAA,kBAqB/C,kBArB+C,EAAA,cAsBnD,mBAtBmD,CAsB/B,SAtB+B,CAAA,CAAA,GAuB/D,mBAvB+D,CAuB3C,cAvB2C,CAuB5B,SAvB4B,EAuBjB,KAvBiB,CAAA,CAAA;;;;;ADKnE;AAaa,KEvBD,mBFuBwB,CAAA,kBEvBc,kBFuBK,CAAA,GAAA;YEtB3C;QACJ;sBACc;ADTW,CAAA;;;;AAMC,cCSrB,eDTqB,CAAA,kBCSa,kBDTb,CAAA,CAAA;EAK7B,iBAAA,QAAmB;EAAoB,iBAAA,UAAA;EAC1C,QAAA,WAAA,CAAA;EADiE;;AAAgB;;;;;EAY9E,OAAA,MAAA,CAAA,kBCK6B,kBDLf,CAAA,CAAA;IAAA,QAAA;IAAA,IAAA;IAAA;EAAA,CAAA,ECSd,mBDTc,CCSM,SDTN,CAAA,CAAA,ECSmB,MDTnB,CCS0B,MDT1B,CCSiC,eDTjC,CCSiD,SDTjD,CAAA,ECS6D,cDT7D,CAAA,CAAA;EACC;;;;EAEhB,OAAA,CAAA,cCmBoB,mBDnBpB,CCmBwC,SDnBxC,CAAA,CAAA,CAAA,aAAA,ECoBe,KDpBf,EAAA,OAAA,ECqBS,yBDrBT,CCqBmC,SDrBnC,ECqB8C,KDrB9C,CAAA,EAAA,OAAA,CAAA,ECsBU,OAAA,CAAQ,ODtBlB,CAAA,ECuBC,MDvBD,CCuBQ,MDvBR,CAAA,OAAA,ECuBwB,cDvBxB,GCuByC,sBDvBzC,CAAA,CAAA;EAA2B;;AAK/B;EACoB,KAAA,CAAA,CAAA,EC+ET,MD/ES,CC+EF,MD/EE,CAAA,IAAA,EC+EW,cD/EX,CAAA,CAAA;EACgB,QAAA,sBAAA"}

package/dist/index.mjs

@@ -1,6 +1,5 @@
-import { connect } from "amqplib";
-import { setupInfra } from "@amqp-contract/core";
-import { Result } from "@swan-io/boxed";
+import { Future, Result } from "@swan-io/boxed";
+import { AmqpClient } from "@amqp-contract/core";
 
 //#region src/errors.ts
 /**
@@ -43,61 +42,56 @@ var MessageValidationError = class extends ClientError {
 * Type-safe AMQP client for publishing messages
 */
 var TypedAmqpClient = class TypedAmqpClient {
-	channel = null;
-	connection = null;
-	constructor(contract, connectionOptions) {
+	constructor(contract, amqpClient) {
 		this.contract = contract;
-		this.connectionOptions = connectionOptions;
+		this.amqpClient = amqpClient;
 	}
 	/**
-	* Create a type-safe AMQP client from a contract
-	* The client will automatically connect to the AMQP broker
+	* Create a type-safe AMQP client from a contract.
+	*
+	* Connection management (including automatic reconnection) is handled internally
+	* by amqp-connection-manager via the {@link AmqpClient}. The client establishes
+	* infrastructure asynchronously in the background once the connection is ready.
 	*/
-	static async create(options) {
-		const client = new TypedAmqpClient(options.contract, options.connection);
-		await client.init();
-		return client;
+	static create({ contract, urls, connectionOptions }) {
+		const client = new TypedAmqpClient(contract, new AmqpClient(contract, {
+			urls,
+			connectionOptions
+		}));
+		return client.waitForConnectionReady().mapOk(() => client);
 	}
 	/**
 	* Publish a message using a defined publisher
 	* Returns Result.Ok(true) on success, or Result.Error with specific error on failure
 	*/
 	publish(publisherName, message, options) {
-		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");
+		if (!publishers) return Future.value(Result.Error(new TechnicalError("No publishers defined in contract")));
 		const publisher = publishers[publisherName];
-		if (!publisher || typeof publisher !== "object") throw new Error(`Publisher "${String(publisherName)}" not found in contract`);
-		const publisherDef = publisher;
-		const validation = publisherDef.message.payload["~standard"].validate(message);
-		if (typeof validation === "object" && validation !== null && "issues" in validation && validation.issues) return Result.Error(new MessageValidationError(String(publisherName), validation.issues));
-		const validatedMessage = typeof validation === "object" && validation !== null && "value" in validation ? validation.value : message;
-		const routingKey = options?.routingKey ?? publisherDef.routingKey ?? "";
-		const content = Buffer.from(JSON.stringify(validatedMessage));
-		const published = this.channel.publish(publisherDef.exchange.name, routingKey, content, options?.options);
-		if (!published) return Result.Error(new TechnicalError(`Failed to publish message for publisher "${String(publisherName)}": Channel rejected the message (buffer full or other channel issue)`));
-		return Result.Ok(published);
+		if (!publisher) return Future.value(Result.Error(new TechnicalError(`Publisher "${String(publisherName)}" not found in contract`)));
+		const validateMessage = () => {
+			const validationResult = publisher.message.payload["~standard"].validate(message);
+			return Future.fromPromise(validationResult instanceof Promise ? validationResult : Promise.resolve(validationResult)).mapError((error) => new TechnicalError(`Validation failed`, error)).mapOkToResult((validation) => {
+				if (validation.issues) return Result.Error(new MessageValidationError(String(publisherName), validation.issues));
+				return Result.Ok(validation.value);
+			});
+		};
+		const publishMessage = (validatedMessage) => {
+			return Future.fromPromise(this.amqpClient.channel.publish(publisher.exchange.name, publisher.routingKey ?? "", validatedMessage, options)).mapError((error) => new TechnicalError(`Failed to publish message`, error)).mapOkToResult((published) => {
+				if (!published) return Result.Error(new TechnicalError(`Failed to publish message for publisher "${String(publisherName)}": Channel rejected the message (buffer full or other channel issue)`));
+				return Result.Ok(published);
+			});
+		};
+		return validateMessage().flatMapOk((validatedMessage) => publishMessage(validatedMessage));
 	}
 	/**
 	* Close the channel and connection
 	*/
-	async close() {
-		if (this.channel) {
-			await this.channel.close();
-			this.channel = null;
-		}
-		if (this.connection) {
-			await this.connection.close();
-			this.connection = null;
-		}
+	close() {
+		return Future.fromPromise(this.amqpClient.close()).mapError((error) => new TechnicalError("Failed to close AMQP connection", error)).mapOk(() => void 0);
 	}
-	/**
-	* Connect to AMQP broker
-	*/
-	async init() {
-		this.connection = await connect(this.connectionOptions);
-		this.channel = await this.connection.createChannel();
-		await setupInfra(this.channel, this.contract);
+	waitForConnectionReady() {
+		return Future.fromPromise(this.amqpClient.channel.waitForConnect()).mapError((error) => new TechnicalError("Failed to wait for connection ready", error));
 	}
 };
 

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["cause?: unknown","publisherName: string","issues: unknown","contract: TContract","connectionOptions: string | Options.Connect"],"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * Base error class for client errors\n */\nabstract class ClientError extends Error {\n  protected constructor(message: string) {\n    super(message);\n    this.name = \"ClientError\";\n    // Node.js specific stack trace capture\n    const ErrorConstructor = Error as unknown as {\n      captureStackTrace?: (target: object, constructor: Function) => void;\n    };\n    if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n      ErrorConstructor.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error for technical/runtime failures that cannot be prevented by TypeScript\n * This includes validation failures and AMQP channel issues\n */\nexport class TechnicalError extends ClientError {\n  constructor(\n    message: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"TechnicalError\";\n  }\n}\n\n/**\n * Error thrown when message validation fails\n */\nexport class MessageValidationError extends ClientError {\n  constructor(\n    public readonly publisherName: string,\n    public readonly issues: unknown,\n  ) {\n    super(`Message validation failed for publisher \"${publisherName}\"`);\n    this.name = \"MessageValidationError\";\n  }\n}\n","import { connect } from \"amqplib\";\nimport type { Channel, ChannelModel, Options } from \"amqplib\";\nimport type {\n  ClientInferPublisherInput,\n  ContractDefinition,\n  InferPublisherNames,\n} from \"@amqp-contract/contract\";\nimport { setupInfra } from \"@amqp-contract/core\";\nimport { Result } from \"@swan-io/boxed\";\nimport { MessageValidationError, TechnicalError } from \"./errors.js\";\n\n/**\n * Options for creating a client\n */\nexport interface CreateClientOptions<TContract extends ContractDefinition> {\n  contract: TContract;\n  connection: string | Options.Connect;\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  private connection: ChannelModel | null = null;\n\n  private constructor(\n    private readonly contract: TContract,\n    private readonly connectionOptions: string | Options.Connect,\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   * Returns Result.Ok(true) on success, or Result.Error with specific error on failure\n   */\n  publish<TName extends InferPublisherNames<TContract>>(\n    publisherName: TName,\n    message: ClientInferPublisherInput<TContract, TName>,\n    options?: PublishOptions,\n  ): Result<boolean, TechnicalError | MessageValidationError> {\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: { name: string; type: string };\n      routingKey?: string;\n      message: { payload: { \"~standard\": { validate: (value: unknown) => unknown } } };\n    };\n\n    // Validate message using schema\n    const validation = publisherDef.message.payload[\"~standard\"].validate(message);\n    if (\n      typeof validation === \"object\" &&\n      validation !== null &&\n      \"issues\" in validation &&\n      validation.issues\n    ) {\n      return Result.Error(new MessageValidationError(String(publisherName), 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    const published = this.channel.publish(\n      publisherDef.exchange.name,\n      routingKey,\n      content,\n      options?.options,\n    );\n\n    if (!published) {\n      return Result.Error(\n        new TechnicalError(\n          `Failed to publish message for publisher \"${String(publisherName)}\": Channel rejected the message (buffer full or other channel issue)`,\n        ),\n      );\n    }\n\n    return Result.Ok(published);\n  }\n\n  /**\n   * Close the channel and 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.close();\n      this.connection = null;\n    }\n  }\n\n  /**\n   * Connect to AMQP broker\n   */\n  private async init(): Promise<void> {\n    this.connection = await connect(this.connectionOptions);\n    this.channel = await this.connection.createChannel();\n\n    // Setup exchanges, queues, and bindings\n    await setupInfra(this.channel, this.contract);\n  }\n}\n"],"mappings":";;;;;;;;AAGA,IAAe,cAAf,cAAmC,MAAM;CACvC,AAAU,YAAY,SAAiB;AACrC,QAAM,QAAQ;AACd,OAAK,OAAO;EAEZ,MAAM,mBAAmB;AAGzB,MAAI,OAAO,iBAAiB,sBAAsB,WAChD,kBAAiB,kBAAkB,MAAM,KAAK,YAAY;;;;;;;AAShE,IAAa,iBAAb,cAAoC,YAAY;CAC9C,YACE,SACA,AAAyBA,OACzB;AACA,QAAM,QAAQ;EAFW;AAGzB,OAAK,OAAO;;;;;;AAOhB,IAAa,yBAAb,cAA4C,YAAY;CACtD,YACE,AAAgBC,eAChB,AAAgBC,QAChB;AACA,QAAM,4CAA4C,cAAc,GAAG;EAHnD;EACA;AAGhB,OAAK,OAAO;;;;;;;;;ACVhB,IAAa,kBAAb,MAAa,gBAAsD;CACjE,AAAQ,UAA0B;CAClC,AAAQ,aAAkC;CAE1C,AAAQ,YACN,AAAiBC,UACjB,AAAiBC,mBACjB;EAFiB;EACA;;;;;;CAOnB,aAAa,OACX,SACqC;EACrC,MAAM,SAAS,IAAI,gBAAgB,QAAQ,UAAU,QAAQ,WAAW;AACxE,QAAM,OAAO,MAAM;AACnB,SAAO;;;;;;CAOT,QACE,eACA,SACA,SAC0D;AAC1D,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,QAAQ,aAAa,SAAS,QAAQ;AAC9E,MACE,OAAO,eAAe,YACtB,eAAe,QACf,YAAY,cACZ,WAAW,OAEX,QAAO,OAAO,MAAM,IAAI,uBAAuB,OAAO,cAAc,EAAE,WAAW,OAAO,CAAC;EAG3F,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;EAE7D,MAAM,YAAY,KAAK,QAAQ,QAC7B,aAAa,SAAS,MACtB,YACA,SACA,SAAS,QACV;AAED,MAAI,CAAC,UACH,QAAO,OAAO,MACZ,IAAI,eACF,4CAA4C,OAAO,cAAc,CAAC,sEACnE,CACF;AAGH,SAAO,OAAO,GAAG,UAAU;;;;;CAM7B,MAAM,QAAuB;AAC3B,MAAI,KAAK,SAAS;AAChB,SAAM,KAAK,QAAQ,OAAO;AAC1B,QAAK,UAAU;;AAEjB,MAAI,KAAK,YAAY;AACnB,SAAM,KAAK,WAAW,OAAO;AAC7B,QAAK,aAAa;;;;;;CAOtB,MAAc,OAAsB;AAClC,OAAK,aAAa,MAAM,QAAQ,KAAK,kBAAkB;AACvD,OAAK,UAAU,MAAM,KAAK,WAAW,eAAe;AAGpD,QAAM,WAAW,KAAK,SAAS,KAAK,SAAS"}
+{"version":3,"file":"index.mjs","names":["cause?: unknown","publisherName: string","issues: unknown","contract: TContract","amqpClient: AmqpClient"],"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * Base error class for client errors\n */\nabstract class ClientError extends Error {\n  protected constructor(message: string) {\n    super(message);\n    this.name = \"ClientError\";\n    // Node.js specific stack trace capture\n    const ErrorConstructor = Error as unknown as {\n      captureStackTrace?: (target: object, constructor: Function) => void;\n    };\n    if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n      ErrorConstructor.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error for technical/runtime failures that cannot be prevented by TypeScript\n * This includes validation failures and AMQP channel issues\n */\nexport class TechnicalError extends ClientError {\n  constructor(\n    message: string,\n    public override readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"TechnicalError\";\n  }\n}\n\n/**\n * Error thrown when message validation fails\n */\nexport class MessageValidationError extends ClientError {\n  constructor(\n    public readonly publisherName: string,\n    public readonly issues: unknown,\n  ) {\n    super(`Message validation failed for publisher \"${publisherName}\"`);\n    this.name = \"MessageValidationError\";\n  }\n}\n","import type { Options } from \"amqplib\";\nimport type { ContractDefinition, InferPublisherNames } from \"@amqp-contract/contract\";\nimport { Future, Result } from \"@swan-io/boxed\";\nimport { MessageValidationError, TechnicalError } from \"./errors.js\";\nimport type { ClientInferPublisherInput } from \"./types.js\";\nimport { AmqpClient } from \"@amqp-contract/core\";\nimport type { AmqpConnectionManagerOptions, ConnectionUrl } from \"amqp-connection-manager\";\n\n/**\n * Options for creating a client\n */\nexport type CreateClientOptions<TContract extends ContractDefinition> = {\n  contract: TContract;\n  urls: ConnectionUrl[];\n  connectionOptions?: AmqpConnectionManagerOptions | undefined;\n};\n\n/**\n * Type-safe AMQP client for publishing messages\n */\nexport class TypedAmqpClient<TContract extends ContractDefinition> {\n  private constructor(\n    private readonly contract: TContract,\n    private readonly amqpClient: AmqpClient,\n  ) {}\n\n  /**\n   * Create a type-safe AMQP client from a contract.\n   *\n   * Connection management (including automatic reconnection) is handled internally\n   * by amqp-connection-manager via the {@link AmqpClient}. The client establishes\n   * infrastructure asynchronously in the background once the connection is ready.\n   */\n  static create<TContract extends ContractDefinition>({\n    contract,\n    urls,\n    connectionOptions,\n  }: CreateClientOptions<TContract>): Future<Result<TypedAmqpClient<TContract>, TechnicalError>> {\n    const client = new TypedAmqpClient(\n      contract,\n      new AmqpClient(contract, { urls, connectionOptions }),\n    );\n\n    return client.waitForConnectionReady().mapOk(() => client);\n  }\n\n  /**\n   * Publish a message using a defined publisher\n   * Returns Result.Ok(true) on success, or Result.Error with specific error on failure\n   */\n  publish<TName extends InferPublisherNames<TContract>>(\n    publisherName: TName,\n    message: ClientInferPublisherInput<TContract, TName>,\n    options?: Options.Publish,\n  ): Future<Result<boolean, TechnicalError | MessageValidationError>> {\n    const publishers = this.contract.publishers;\n    if (!publishers) {\n      return Future.value(Result.Error(new TechnicalError(\"No publishers defined in contract\")));\n    }\n\n    const publisher = publishers[publisherName as string];\n    if (!publisher) {\n      return Future.value(\n        Result.Error(\n          new TechnicalError(`Publisher \"${String(publisherName)}\" not found in contract`),\n        ),\n      );\n    }\n\n    const validateMessage = () => {\n      const validationResult = publisher.message.payload[\"~standard\"].validate(message);\n      return Future.fromPromise(\n        validationResult instanceof Promise ? validationResult : Promise.resolve(validationResult),\n      )\n        .mapError((error) => new TechnicalError(`Validation failed`, error))\n        .mapOkToResult((validation) => {\n          if (validation.issues) {\n            return Result.Error(\n              new MessageValidationError(String(publisherName), validation.issues),\n            );\n          }\n\n          return Result.Ok(validation.value);\n        });\n    };\n\n    const publishMessage = (validatedMessage: unknown) => {\n      return Future.fromPromise(\n        this.amqpClient.channel.publish(\n          publisher.exchange.name,\n          publisher.routingKey ?? \"\",\n          validatedMessage,\n          options,\n        ),\n      )\n        .mapError((error) => new TechnicalError(`Failed to publish message`, error))\n        .mapOkToResult((published) => {\n          if (!published) {\n            return Result.Error(\n              new TechnicalError(\n                `Failed to publish message for publisher \"${String(publisherName)}\": Channel rejected the message (buffer full or other channel issue)`,\n              ),\n            );\n          }\n\n          return Result.Ok(published);\n        });\n    };\n\n    // Validate message using schema\n    return validateMessage().flatMapOk((validatedMessage) => publishMessage(validatedMessage));\n  }\n\n  /**\n   * Close the channel and connection\n   */\n  close(): Future<Result<void, TechnicalError>> {\n    return Future.fromPromise(this.amqpClient.close())\n      .mapError((error) => new TechnicalError(\"Failed to close AMQP connection\", error))\n      .mapOk(() => undefined);\n  }\n\n  private waitForConnectionReady(): Future<Result<void, TechnicalError>> {\n    return Future.fromPromise(this.amqpClient.channel.waitForConnect()).mapError(\n      (error) => new TechnicalError(\"Failed to wait for connection ready\", error),\n    );\n  }\n}\n"],"mappings":";;;;;;;AAGA,IAAe,cAAf,cAAmC,MAAM;CACvC,AAAU,YAAY,SAAiB;AACrC,QAAM,QAAQ;AACd,OAAK,OAAO;EAEZ,MAAM,mBAAmB;AAGzB,MAAI,OAAO,iBAAiB,sBAAsB,WAChD,kBAAiB,kBAAkB,MAAM,KAAK,YAAY;;;;;;;AAShE,IAAa,iBAAb,cAAoC,YAAY;CAC9C,YACE,SACA,AAAyBA,OACzB;AACA,QAAM,QAAQ;EAFW;AAGzB,OAAK,OAAO;;;;;;AAOhB,IAAa,yBAAb,cAA4C,YAAY;CACtD,YACE,AAAgBC,eAChB,AAAgBC,QAChB;AACA,QAAM,4CAA4C,cAAc,GAAG;EAHnD;EACA;AAGhB,OAAK,OAAO;;;;;;;;;ACpBhB,IAAa,kBAAb,MAAa,gBAAsD;CACjE,AAAQ,YACN,AAAiBC,UACjB,AAAiBC,YACjB;EAFiB;EACA;;;;;;;;;CAUnB,OAAO,OAA6C,EAClD,UACA,MACA,qBAC6F;EAC7F,MAAM,SAAS,IAAI,gBACjB,UACA,IAAI,WAAW,UAAU;GAAE;GAAM;GAAmB,CAAC,CACtD;AAED,SAAO,OAAO,wBAAwB,CAAC,YAAY,OAAO;;;;;;CAO5D,QACE,eACA,SACA,SACkE;EAClE,MAAM,aAAa,KAAK,SAAS;AACjC,MAAI,CAAC,WACH,QAAO,OAAO,MAAM,OAAO,MAAM,IAAI,eAAe,oCAAoC,CAAC,CAAC;EAG5F,MAAM,YAAY,WAAW;AAC7B,MAAI,CAAC,UACH,QAAO,OAAO,MACZ,OAAO,MACL,IAAI,eAAe,cAAc,OAAO,cAAc,CAAC,yBAAyB,CACjF,CACF;EAGH,MAAM,wBAAwB;GAC5B,MAAM,mBAAmB,UAAU,QAAQ,QAAQ,aAAa,SAAS,QAAQ;AACjF,UAAO,OAAO,YACZ,4BAA4B,UAAU,mBAAmB,QAAQ,QAAQ,iBAAiB,CAC3F,CACE,UAAU,UAAU,IAAI,eAAe,qBAAqB,MAAM,CAAC,CACnE,eAAe,eAAe;AAC7B,QAAI,WAAW,OACb,QAAO,OAAO,MACZ,IAAI,uBAAuB,OAAO,cAAc,EAAE,WAAW,OAAO,CACrE;AAGH,WAAO,OAAO,GAAG,WAAW,MAAM;KAClC;;EAGN,MAAM,kBAAkB,qBAA8B;AACpD,UAAO,OAAO,YACZ,KAAK,WAAW,QAAQ,QACtB,UAAU,SAAS,MACnB,UAAU,cAAc,IACxB,kBACA,QACD,CACF,CACE,UAAU,UAAU,IAAI,eAAe,6BAA6B,MAAM,CAAC,CAC3E,eAAe,cAAc;AAC5B,QAAI,CAAC,UACH,QAAO,OAAO,MACZ,IAAI,eACF,4CAA4C,OAAO,cAAc,CAAC,sEACnE,CACF;AAGH,WAAO,OAAO,GAAG,UAAU;KAC3B;;AAIN,SAAO,iBAAiB,CAAC,WAAW,qBAAqB,eAAe,iBAAiB,CAAC;;;;;CAM5F,QAA8C;AAC5C,SAAO,OAAO,YAAY,KAAK,WAAW,OAAO,CAAC,CAC/C,UAAU,UAAU,IAAI,eAAe,mCAAmC,MAAM,CAAC,CACjF,YAAY,OAAU;;CAG3B,AAAQ,yBAA+D;AACrE,SAAO,OAAO,YAAY,KAAK,WAAW,QAAQ,gBAAgB,CAAC,CAAC,UACjE,UAAU,IAAI,eAAe,uCAAuC,MAAM,CAC5E"}

package/docs/index.md

@@ -0,0 +1,447 @@
+**@amqp-contract/client**
+
+***
+
+# @amqp-contract/client
+
+## Classes
+
+### MessageValidationError
+
+Defined in: [packages/client/src/errors.ts:35](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/errors.ts#L35)
+
+Error thrown when message validation fails
+
+#### Extends
+
+- `ClientError`
+
+#### Constructors
+
+##### Constructor
+
+```ts
+new MessageValidationError(publisherName, issues): MessageValidationError;
+```
+
+Defined in: [packages/client/src/errors.ts:36](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/errors.ts#L36)
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `publisherName` | `string` |
+| `issues` | `unknown` |
+
+###### Returns
+
+[`MessageValidationError`](#messagevalidationerror)
+
+###### Overrides
+
+```ts
+ClientError.constructor
+```
+
+#### Properties
+
+| Property | Modifier | Type | Description | Inherited from | Defined in |
+| ------ | ------ | ------ | ------ | ------ | ------ |
+| <a id="cause"></a> `cause?` | `public` | `unknown` | - | `ClientError.cause` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es2022.error.d.ts:26 |
+| <a id="issues"></a> `issues` | `readonly` | `unknown` | - | - | [packages/client/src/errors.ts:38](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/errors.ts#L38) |
+| <a id="message"></a> `message` | `public` | `string` | - | `ClientError.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
+| <a id="name"></a> `name` | `public` | `string` | - | `ClientError.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
+| <a id="publishername"></a> `publisherName` | `readonly` | `string` | - | - | [packages/client/src/errors.ts:37](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/errors.ts#L37) |
+| <a id="stack"></a> `stack?` | `public` | `string` | - | `ClientError.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
+| <a id="stacktracelimit"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `ClientError.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.3/node\_modules/@types/node/globals.d.ts:67 |
+
+#### Methods
+
+##### captureStackTrace()
+
+```ts
+static captureStackTrace(targetObject, constructorOpt?): void;
+```
+
+Defined in: node\_modules/.pnpm/@types+node@25.0.3/node\_modules/@types/node/globals.d.ts:51
+
+Creates a `.stack` property on `targetObject`, which when accessed returns
+a string representing the location in the code at which
+`Error.captureStackTrace()` was called.
+
+```js
+const myObject = {};
+Error.captureStackTrace(myObject);
+myObject.stack;  // Similar to `new Error().stack`
+```
+
+The first line of the trace will be prefixed with
+`${myObject.name}: ${myObject.message}`.
+
+The optional `constructorOpt` argument accepts a function. If given, all frames
+above `constructorOpt`, including `constructorOpt`, will be omitted from the
+generated stack trace.
+
+The `constructorOpt` argument is useful for hiding implementation
+details of error generation from the user. For instance:
+
+```js
+function a() {
+  b();
+}
+
+function b() {
+  c();
+}
+
+function c() {
+  // Create an error without stack trace to avoid calculating the stack trace twice.
+  const { stackTraceLimit } = Error;
+  Error.stackTraceLimit = 0;
+  const error = new Error();
+  Error.stackTraceLimit = stackTraceLimit;
+
+  // Capture the stack trace above function b
+  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
+  throw error;
+}
+
+a();
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `targetObject` | `object` |
+| `constructorOpt?` | `Function` |
+
+###### Returns
+
+`void`
+
+###### Inherited from
+
+```ts
+ClientError.captureStackTrace
+```
+
+##### prepareStackTrace()
+
+```ts
+static prepareStackTrace(err, stackTraces): any;
+```
+
+Defined in: node\_modules/.pnpm/@types+node@25.0.3/node\_modules/@types/node/globals.d.ts:55
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `err` | `Error` |
+| `stackTraces` | `CallSite`[] |
+
+###### Returns
+
+`any`
+
+###### See
+
+https://v8.dev/docs/stack-trace-api#customizing-stack-traces
+
+###### Inherited from
+
+```ts
+ClientError.prepareStackTrace
+```
+
+***
+
+### TechnicalError
+
+Defined in: [packages/client/src/errors.ts:22](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/errors.ts#L22)
+
+Error for technical/runtime failures that cannot be prevented by TypeScript
+This includes validation failures and AMQP channel issues
+
+#### Extends
+
+- `ClientError`
+
+#### Constructors
+
+##### Constructor
+
+```ts
+new TechnicalError(message, cause?): TechnicalError;
+```
+
+Defined in: [packages/client/src/errors.ts:23](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/errors.ts#L23)
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `cause?` | `unknown` |
+
+###### Returns
+
+[`TechnicalError`](#technicalerror)
+
+###### Overrides
+
+```ts
+ClientError.constructor
+```
+
+#### Properties
+
+| Property | Modifier | Type | Description | Inherited from | Defined in |
+| ------ | ------ | ------ | ------ | ------ | ------ |
+| <a id="cause-1"></a> `cause?` | `readonly` | `unknown` | - | `ClientError.cause` | [packages/client/src/errors.ts:25](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/errors.ts#L25) |
+| <a id="message-1"></a> `message` | `public` | `string` | - | `ClientError.message` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1077 |
+| <a id="name-1"></a> `name` | `public` | `string` | - | `ClientError.name` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1076 |
+| <a id="stack-1"></a> `stack?` | `public` | `string` | - | `ClientError.stack` | node\_modules/.pnpm/typescript@5.9.3/node\_modules/typescript/lib/lib.es5.d.ts:1078 |
+| <a id="stacktracelimit-1"></a> `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `ClientError.stackTraceLimit` | node\_modules/.pnpm/@types+node@25.0.3/node\_modules/@types/node/globals.d.ts:67 |
+
+#### Methods
+
+##### captureStackTrace()
+
+```ts
+static captureStackTrace(targetObject, constructorOpt?): void;
+```
+
+Defined in: node\_modules/.pnpm/@types+node@25.0.3/node\_modules/@types/node/globals.d.ts:51
+
+Creates a `.stack` property on `targetObject`, which when accessed returns
+a string representing the location in the code at which
+`Error.captureStackTrace()` was called.
+
+```js
+const myObject = {};
+Error.captureStackTrace(myObject);
+myObject.stack;  // Similar to `new Error().stack`
+```
+
+The first line of the trace will be prefixed with
+`${myObject.name}: ${myObject.message}`.
+
+The optional `constructorOpt` argument accepts a function. If given, all frames
+above `constructorOpt`, including `constructorOpt`, will be omitted from the
+generated stack trace.
+
+The `constructorOpt` argument is useful for hiding implementation
+details of error generation from the user. For instance:
+
+```js
+function a() {
+  b();
+}
+
+function b() {
+  c();
+}
+
+function c() {
+  // Create an error without stack trace to avoid calculating the stack trace twice.
+  const { stackTraceLimit } = Error;
+  Error.stackTraceLimit = 0;
+  const error = new Error();
+  Error.stackTraceLimit = stackTraceLimit;
+
+  // Capture the stack trace above function b
+  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
+  throw error;
+}
+
+a();
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `targetObject` | `object` |
+| `constructorOpt?` | `Function` |
+
+###### Returns
+
+`void`
+
+###### Inherited from
+
+```ts
+ClientError.captureStackTrace
+```
+
+##### prepareStackTrace()
+
+```ts
+static prepareStackTrace(err, stackTraces): any;
+```
+
+Defined in: node\_modules/.pnpm/@types+node@25.0.3/node\_modules/@types/node/globals.d.ts:55
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `err` | `Error` |
+| `stackTraces` | `CallSite`[] |
+
+###### Returns
+
+`any`
+
+###### See
+
+https://v8.dev/docs/stack-trace-api#customizing-stack-traces
+
+###### Inherited from
+
+```ts
+ClientError.prepareStackTrace
+```
+
+***
+
+### TypedAmqpClient
+
+Defined in: [packages/client/src/client.ts:21](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/client.ts#L21)
+
+Type-safe AMQP client for publishing messages
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+
+#### Methods
+
+##### close()
+
+```ts
+close(): Future<Result<void, TechnicalError>>;
+```
+
+Defined in: [packages/client/src/client.ts:117](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/client.ts#L117)
+
+Close the channel and connection
+
+###### Returns
+
+`Future`\<`Result`\<`void`, [`TechnicalError`](#technicalerror)\>\>
+
+##### publish()
+
+```ts
+publish<TName>(
+   publisherName, 
+   message, 
+   options?): Future<Result<boolean, 
+  | TechnicalError
+| MessageValidationError>>;
+```
+
+Defined in: [packages/client/src/client.ts:51](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/client.ts#L51)
+
+Publish a message using a defined publisher
+Returns Result.Ok(true) on success, or Result.Error with specific error on failure
+
+###### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TName` *extends* `string` \| `number` \| `symbol` |
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `publisherName` | `TName` |
+| `message` | [`ClientInferPublisherInput`](#clientinferpublisherinput)\<`TContract`, `TName`\> |
+| `options?` | `Publish` |
+
+###### Returns
+
+`Future`\<`Result`\<`boolean`, 
+  \| [`TechnicalError`](#technicalerror)
+  \| [`MessageValidationError`](#messagevalidationerror)\>\>
+
+##### create()
+
+```ts
+static create<TContract>(__namedParameters): Future<Result<TypedAmqpClient<TContract>, TechnicalError>>;
+```
+
+Defined in: [packages/client/src/client.ts:34](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/client.ts#L34)
+
+Create a type-safe AMQP client from a contract.
+
+Connection management (including automatic reconnection) is handled internally
+by amqp-connection-manager via the AmqpClient. The client establishes
+infrastructure asynchronously in the background once the connection is ready.
+
+###### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `__namedParameters` | [`CreateClientOptions`](#createclientoptions)\<`TContract`\> |
+
+###### Returns
+
+`Future`\<`Result`\<[`TypedAmqpClient`](#typedamqpclient)\<`TContract`\>, [`TechnicalError`](#technicalerror)\>\>
+
+## Type Aliases
+
+### ClientInferPublisherInput
+
+```ts
+type ClientInferPublisherInput<TContract, TName> = PublisherInferInput<InferPublisher<TContract, TName>>;
+```
+
+Defined in: [packages/client/src/types.ts:37](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/types.ts#L37)
+
+Infer publisher input type (message payload) for a specific publisher in a contract
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+| `TName` *extends* `InferPublisherNames`\<`TContract`\> |
+
+***
+
+### CreateClientOptions
+
+```ts
+type CreateClientOptions<TContract> = object;
+```
+
+Defined in: [packages/client/src/client.ts:12](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/client.ts#L12)
+
+Options for creating a client
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `TContract` *extends* `ContractDefinition` |
+
+#### Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="connectionoptions"></a> `connectionOptions?` | `AmqpConnectionManagerOptions` | [packages/client/src/client.ts:15](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/client.ts#L15) |
+| <a id="contract"></a> `contract` | `TContract` | [packages/client/src/client.ts:13](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/client.ts#L13) |
+| <a id="urls"></a> `urls` | `ConnectionUrl`[] | [packages/client/src/client.ts:14](https://github.com/btravers/amqp-contract/blob/63bb54252f8a9109544152686427ef223964c15c/packages/client/src/client.ts#L14) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amqp-contract/client",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Client utilities for publishing messages using amqp-contract",
   "keywords": [
     "amqp",
@@ -38,30 +38,34 @@
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "files": [
-    "dist"
+    "dist",
+    "docs"
   ],
   "dependencies": {
+    "@standard-schema/spec": "1.1.0",
     "@swan-io/boxed": "3.2.1",
-    "@amqp-contract/contract": "0.2.0",
-    "@amqp-contract/core": "0.2.0"
+    "@amqp-contract/contract": "0.3.0",
+    "@amqp-contract/core": "0.3.0"
   },
   "devDependencies": {
     "@types/amqplib": "0.10.8",
     "@types/node": "25.0.3",
     "@vitest/coverage-v8": "4.0.16",
+    "amqp-connection-manager": "5.0.0",
     "amqplib": "0.10.9",
     "tsdown": "0.18.2",
+    "typedoc": "0.28.3",
+    "typedoc-plugin-markdown": "4.9.0",
     "typescript": "5.9.3",
     "vitest": "4.0.16",
     "zod": "4.2.1",
-    "@amqp-contract/testing": "0.2.0",
-    "@amqp-contract/tsconfig": "0.0.0"
-  },
-  "peerDependencies": {
-    "amqplib": ">=0.10.0"
+    "@amqp-contract/testing": "0.3.0",
+    "@amqp-contract/tsconfig": "0.0.0",
+    "@amqp-contract/typedoc": "0.0.1"
   },
   "scripts": {
     "build": "tsdown src/index.ts --format cjs,esm --dts --clean",
+    "build:docs": "typedoc",
     "dev": "tsdown src/index.ts --format cjs,esm --dts --watch",
     "test": "vitest run --project unit",
     "test:integration": "vitest run --project integration",