@amqp-contract/client-nestjs 0.0.1

package/LICENSE

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

package/README.md

@@ -0,0 +1,44 @@
+# @amqp-contract/client-nestjs
+
+NestJS integration for [@amqp-contract/client](../client). Type-safe AMQP message publishing with automatic lifecycle management.
+
+## Installation
+
+```bash
+pnpm add @amqp-contract/client-nestjs @amqp-contract/client @amqp-contract/contract amqplib
+```
+
+## Usage
+
+```typescript
+import { Injectable, Module } from '@nestjs/common';
+import { AmqpClientModule, AmqpClientService } from '@amqp-contract/client-nestjs';
+import { contract } from './contract';
+
+@Module({
+  imports: [
+    AmqpClientModule.forRoot({
+      contract,
+      connection: 'amqp://localhost',
+    }),
+  ],
+})
+export class AppModule {}
+
+@Injectable()
+export class OrderService {
+  constructor(
+    private readonly client: AmqpClientService<typeof contract>,
+  ) {}
+
+  async createOrder(orderId: string, amount: number) {
+    await this.client.publish('orderCreated', { orderId, amount });
+  }
+}
+```
+
+The client automatically connects when the module initializes and cleans up on shutdown.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,91 @@
+let _nestjs_common = require("@nestjs/common");
+let _amqp_contract_client = require("@amqp-contract/client");
+
+//#region \0@oxc-project+runtime@0.103.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+//#region src/client.service.ts
+let AmqpClientService = class AmqpClientService$1 {
+	client = null;
+	constructor(options) {
+		this.options = options;
+	}
+	/**
+	* Initialize the client when the NestJS module starts
+	*/
+	async onModuleInit() {
+		this.client = await _amqp_contract_client.TypedAmqpClient.create({
+			contract: this.options.contract,
+			connection: this.options.connection
+		});
+	}
+	/**
+	* Close the client when the NestJS module is destroyed
+	*/
+	async onModuleDestroy() {
+		if (this.client) {
+			await this.client.close();
+			this.client = null;
+		}
+	}
+	/**
+	* Publish a message using a defined publisher
+	* This method provides type-safe message publishing
+	*/
+	async publish(publisherName, message, options) {
+		if (!this.client) throw new Error("Client not initialized. Create the client using TypedAmqpClient.create() to establish a connection.");
+		return this.client.publish(publisherName, message, options);
+	}
+};
+AmqpClientService = __decorate([
+	(0, _nestjs_common.Injectable)(),
+	__decorateParam(0, (0, _nestjs_common.Inject)(MODULE_OPTIONS_TOKEN)),
+	__decorateMetadata("design:paramtypes", [Object])
+], AmqpClientService);
+
+//#endregion
+//#region src/client.module.ts
+/**
+* ConfigurableModuleBuilder for AMQP client module
+* This creates forRoot and forRootAsync methods automatically
+*/
+const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN } = new _nestjs_common.ConfigurableModuleBuilder().setClassMethodName("forRoot").build();
+let AmqpClientModule = class AmqpClientModule$1 extends ConfigurableModuleClass {};
+AmqpClientModule = __decorate([(0, _nestjs_common.Module)({
+	providers: [AmqpClientService],
+	exports: [AmqpClientService]
+})], AmqpClientModule);
+
+//#endregion
+Object.defineProperty(exports, 'AmqpClientModule', {
+  enumerable: true,
+  get: function () {
+    return AmqpClientModule;
+  }
+});
+Object.defineProperty(exports, 'AmqpClientService', {
+  enumerable: true,
+  get: function () {
+    return AmqpClientService;
+  }
+});

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+import * as _nestjs_common0 from "@nestjs/common";
+import { OnModuleDestroy, OnModuleInit } from "@nestjs/common";
+import { Options } from "amqplib";
+import { ClientInferPublisherInput, ContractDefinition, InferPublisherNames } from "@amqp-contract/contract";
+import { PublishOptions } from "@amqp-contract/client";
+
+//#region src/client.service.d.ts
+/**
+ * Options for creating a NestJS client service
+ */
+interface AmqpClientModuleOptions<TContract extends ContractDefinition> {
+  contract: TContract;
+  connection: string | Options.Connect;
+}
+/**
+ * Type-safe AMQP client service for NestJS
+ * This service integrates @amqp-contract/client with NestJS lifecycle
+ */
+declare class AmqpClientService<TContract extends ContractDefinition> implements OnModuleInit, OnModuleDestroy {
+  private readonly options;
+  private client;
+  constructor(options: AmqpClientModuleOptions<TContract>);
+  /**
+   * Initialize the client when the NestJS module starts
+   */
+  onModuleInit(): Promise<void>;
+  /**
+   * Close the client when the NestJS module is destroyed
+   */
+  onModuleDestroy(): Promise<void>;
+  /**
+   * Publish a message using a defined publisher
+   * This method provides type-safe message publishing
+   */
+  publish<TName extends InferPublisherNames<TContract>>(publisherName: TName, message: ClientInferPublisherInput<TContract, TName>, options?: PublishOptions): Promise<boolean>;
+}
+//#endregion
+//#region src/client.module.d.ts
+/**
+ * ConfigurableModuleBuilder for AMQP client module
+ * This creates forRoot and forRootAsync methods automatically
+ */
+declare const ConfigurableModuleClass: _nestjs_common0.ConfigurableModuleCls<AmqpClientModuleOptions<never>, "forRoot", "create", {}>, MODULE_OPTIONS_TOKEN: string | symbol;
+/**
+ * NestJS module for AMQP client integration
+ * This module provides type-safe AMQP client functionality using @amqp-contract/client
+ * without relying on NestJS decorators (except for dependency injection)
+ */
+declare class AmqpClientModule extends ConfigurableModuleClass {}
+//#endregion
+export { AmqpClientModule, type AmqpClientModuleOptions, AmqpClientService };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/client.service.ts","../src/client.module.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAaiB,UAAA,uBAAuB,CAAA,kBAAmB,kBAAnB,CAAA,CAAA;EAAmB,QAAA,EAC/C,SAD+C;EAC/C,UAAA,EAAA,MAAA,GACW,OAAA,CAAQ,OADnB;;;AAQZ;;;AAQ8B,cAPjB,iBAOiB,CAAA,kBAPmB,kBAOnB,CAAA,YANjB,YAMiB,EANH,eAMG,CAAA;EAMN,iBAAA,OAAA;EAUG,QAAA,MAAA;EAWuB,WAAA,CAAA,OAAA,EA3BpB,uBA2BoB,CA3BI,SA2BJ,CAAA;EAApB;;;EAEoB,YAAA,CAAA,CAAA,EAvB1B,OAuB0B,CAAA,IAAA,CAAA;EAArC;;;EAnCA,eAAA,CAAA,CAAA,EAsBc,OAtBd,CAAA,IAAA,CAAA;EAAc;;;;wBAiCG,oBAAoB,2BAC/B,gBACN,0BAA0B,WAAW,kBACpC,iBACT;ACrDL;;;;;;;cAAe,yBAAuB,eAAA,CAAA,sBAAA;;ADKtC;;;;AAEsC,cCQzB,gBAAA,SAAyB,uBAAA,CDRA"}

package/dist/index.d.mts

@@ -0,0 +1,52 @@
+import * as _nestjs_common0 from "@nestjs/common";
+import { OnModuleDestroy, OnModuleInit } from "@nestjs/common";
+import { PublishOptions } from "@amqp-contract/client";
+import { Options } from "amqplib";
+import { ClientInferPublisherInput, ContractDefinition, InferPublisherNames } from "@amqp-contract/contract";
+
+//#region src/client.service.d.ts
+/**
+ * Options for creating a NestJS client service
+ */
+interface AmqpClientModuleOptions<TContract extends ContractDefinition> {
+  contract: TContract;
+  connection: string | Options.Connect;
+}
+/**
+ * Type-safe AMQP client service for NestJS
+ * This service integrates @amqp-contract/client with NestJS lifecycle
+ */
+declare class AmqpClientService<TContract extends ContractDefinition> implements OnModuleInit, OnModuleDestroy {
+  private readonly options;
+  private client;
+  constructor(options: AmqpClientModuleOptions<TContract>);
+  /**
+   * Initialize the client when the NestJS module starts
+   */
+  onModuleInit(): Promise<void>;
+  /**
+   * Close the client when the NestJS module is destroyed
+   */
+  onModuleDestroy(): Promise<void>;
+  /**
+   * Publish a message using a defined publisher
+   * This method provides type-safe message publishing
+   */
+  publish<TName extends InferPublisherNames<TContract>>(publisherName: TName, message: ClientInferPublisherInput<TContract, TName>, options?: PublishOptions): Promise<boolean>;
+}
+//#endregion
+//#region src/client.module.d.ts
+/**
+ * ConfigurableModuleBuilder for AMQP client module
+ * This creates forRoot and forRootAsync methods automatically
+ */
+declare const ConfigurableModuleClass: _nestjs_common0.ConfigurableModuleCls<AmqpClientModuleOptions<never>, "forRoot", "create", {}>, MODULE_OPTIONS_TOKEN: string | symbol;
+/**
+ * NestJS module for AMQP client integration
+ * This module provides type-safe AMQP client functionality using @amqp-contract/client
+ * without relying on NestJS decorators (except for dependency injection)
+ */
+declare class AmqpClientModule extends ConfigurableModuleClass {}
+//#endregion
+export { AmqpClientModule, type AmqpClientModuleOptions, AmqpClientService };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/client.service.ts","../src/client.module.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAaiB,UAAA,uBAAuB,CAAA,kBAAmB,kBAAnB,CAAA,CAAA;EAAmB,QAAA,EAC/C,SAD+C;EAC/C,UAAA,EAAA,MAAA,GACW,OAAA,CAAQ,OADnB;;;AAQZ;;;AAQ8B,cAPjB,iBAOiB,CAAA,kBAPmB,kBAOnB,CAAA,YANjB,YAMiB,EANH,eAMG,CAAA;EAMN,iBAAA,OAAA;EAUG,QAAA,MAAA;EAWuB,WAAA,CAAA,OAAA,EA3BpB,uBA2BoB,CA3BI,SA2BJ,CAAA;EAApB;;;EAEoB,YAAA,CAAA,CAAA,EAvB1B,OAuB0B,CAAA,IAAA,CAAA;EAArC;;;EAnCA,eAAA,CAAA,CAAA,EAsBc,OAtBd,CAAA,IAAA,CAAA;EAAc;;;;wBAiCG,oBAAoB,2BAC/B,gBACN,0BAA0B,WAAW,kBACpC,iBACT;ACrDL;;;;;;;cAAe,yBAAuB,eAAA,CAAA,sBAAA;;ADKtC;;;;AAEsC,cCQzB,gBAAA,SAAyB,uBAAA,CDRA"}

package/dist/index.mjs

@@ -0,0 +1,81 @@
+import { ConfigurableModuleBuilder, Inject, Injectable, Module } from "@nestjs/common";
+import { TypedAmqpClient } from "@amqp-contract/client";
+
+//#region \0@oxc-project+runtime@0.103.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+//#region src/client.service.ts
+let AmqpClientService = class AmqpClientService$1 {
+	client = null;
+	constructor(options) {
+		this.options = options;
+	}
+	/**
+	* Initialize the client when the NestJS module starts
+	*/
+	async onModuleInit() {
+		this.client = await TypedAmqpClient.create({
+			contract: this.options.contract,
+			connection: this.options.connection
+		});
+	}
+	/**
+	* Close the client when the NestJS module is destroyed
+	*/
+	async onModuleDestroy() {
+		if (this.client) {
+			await this.client.close();
+			this.client = null;
+		}
+	}
+	/**
+	* Publish a message using a defined publisher
+	* This method provides type-safe message publishing
+	*/
+	async publish(publisherName, message, options) {
+		if (!this.client) throw new Error("Client not initialized. Create the client using TypedAmqpClient.create() to establish a connection.");
+		return this.client.publish(publisherName, message, options);
+	}
+};
+AmqpClientService = __decorate([
+	Injectable(),
+	__decorateParam(0, Inject(MODULE_OPTIONS_TOKEN)),
+	__decorateMetadata("design:paramtypes", [Object])
+], AmqpClientService);
+
+//#endregion
+//#region src/client.module.ts
+/**
+* ConfigurableModuleBuilder for AMQP client module
+* This creates forRoot and forRootAsync methods automatically
+*/
+const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN } = new ConfigurableModuleBuilder().setClassMethodName("forRoot").build();
+let AmqpClientModule = class AmqpClientModule$1 extends ConfigurableModuleClass {};
+AmqpClientModule = __decorate([Module({
+	providers: [AmqpClientService],
+	exports: [AmqpClientService]
+})], AmqpClientModule);
+
+//#endregion
+export { AmqpClientModule, AmqpClientService };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["AmqpClientService","options: AmqpClientModuleOptions<TContract>","AmqpClientModule"],"sources":["../src/client.service.ts","../src/client.module.ts"],"sourcesContent":["import { Inject, Injectable, type OnModuleDestroy, type OnModuleInit } from \"@nestjs/common\";\nimport type { Options } from \"amqplib\";\nimport type {\n  ClientInferPublisherInput,\n  ContractDefinition,\n  InferPublisherNames,\n} from \"@amqp-contract/contract\";\nimport { TypedAmqpClient, type PublishOptions } from \"@amqp-contract/client\";\nimport { MODULE_OPTIONS_TOKEN } from \"./client.module.js\";\n\n/**\n * Options for creating a NestJS client service\n */\nexport interface AmqpClientModuleOptions<TContract extends ContractDefinition> {\n  contract: TContract;\n  connection: string | Options.Connect;\n}\n\n/**\n * Type-safe AMQP client service for NestJS\n * This service integrates @amqp-contract/client with NestJS lifecycle\n */\n@Injectable()\nexport class AmqpClientService<TContract extends ContractDefinition>\n  implements OnModuleInit, OnModuleDestroy\n{\n  private client: TypedAmqpClient<TContract> | null = null;\n\n  constructor(\n    @Inject(MODULE_OPTIONS_TOKEN)\n    private readonly options: AmqpClientModuleOptions<TContract>,\n  ) {}\n\n  /**\n   * Initialize the client when the NestJS module starts\n   */\n  async onModuleInit(): Promise<void> {\n    this.client = await TypedAmqpClient.create({\n      contract: this.options.contract,\n      connection: this.options.connection,\n    });\n  }\n\n  /**\n   * Close the client when the NestJS module is destroyed\n   */\n  async onModuleDestroy(): Promise<void> {\n    if (this.client) {\n      await this.client.close();\n      this.client = null;\n    }\n  }\n\n  /**\n   * Publish a message using a defined publisher\n   * This method provides type-safe message publishing\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.client) {\n      throw new Error(\n        \"Client not initialized. Create the client using TypedAmqpClient.create() to establish a connection.\",\n      );\n    }\n\n    return this.client.publish(publisherName, message, options);\n  }\n}\n","import { ConfigurableModuleBuilder, Module } from \"@nestjs/common\";\nimport type { AmqpClientModuleOptions } from \"./client.service.js\";\nimport { AmqpClientService } from \"./client.service.js\";\n\n/**\n * ConfigurableModuleBuilder for AMQP client module\n * This creates forRoot and forRootAsync methods automatically\n */\nexport const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN } = new ConfigurableModuleBuilder<\n  AmqpClientModuleOptions<never>\n>()\n  .setClassMethodName(\"forRoot\")\n  .build();\n\n/**\n * NestJS module for AMQP client integration\n * This module provides type-safe AMQP client functionality using @amqp-contract/client\n * without relying on NestJS decorators (except for dependency injection)\n */\n@Module({\n  providers: [AmqpClientService],\n  exports: [AmqpClientService],\n})\nexport class AmqpClientModule extends ConfigurableModuleClass {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBO,8BAAMA,oBAEb;CACE,AAAQ,SAA4C;CAEpD,YACE,AACiBC,SACjB;EADiB;;;;;CAMnB,MAAM,eAA8B;AAClC,OAAK,SAAS,MAAM,gBAAgB,OAAO;GACzC,UAAU,KAAK,QAAQ;GACvB,YAAY,KAAK,QAAQ;GAC1B,CAAC;;;;;CAMJ,MAAM,kBAAiC;AACrC,MAAI,KAAK,QAAQ;AACf,SAAM,KAAK,OAAO,OAAO;AACzB,QAAK,SAAS;;;;;;;CAQlB,MAAM,QACJ,eACA,SACA,SACkB;AAClB,MAAI,CAAC,KAAK,OACR,OAAM,IAAI,MACR,sGACD;AAGH,SAAO,KAAK,OAAO,QAAQ,eAAe,SAAS,QAAQ;;;;CA9C9D,YAAY;oBAOR,OAAO,qBAAqB;;;;;;;;;;ACrBjC,MAAa,EAAE,yBAAyB,yBAAyB,IAAI,2BAElE,CACA,mBAAmB,UAAU,CAC7B,OAAO;AAWH,6BAAMC,2BAAyB,wBAAwB;+BAJ7D,OAAO;CACN,WAAW,CAAC,kBAAkB;CAC9B,SAAS,CAAC,kBAAkB;CAC7B,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@amqp-contract/client-nestjs",
+  "version": "0.0.1",
+  "description": "NestJS integration for @amqp-contract/client",
+  "keywords": [
+    "amqp",
+    "client",
+    "contract",
+    "nestjs",
+    "rabbitmq",
+    "typescript"
+  ],
+  "homepage": "https://github.com/btravers/amqp-contract#readme",
+  "bugs": {
+    "url": "https://github.com/btravers/amqp-contract/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/btravers/amqp-contract.git",
+    "directory": "packages/client-nestjs"
+  },
+  "license": "MIT",
+  "author": "Benoit TRAVERS <benoit.travers.fr@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@amqp-contract/client": "0.0.6",
+    "@amqp-contract/contract": "0.0.6"
+  },
+  "devDependencies": {
+    "@nestjs/common": "11.0.10",
+    "@types/amqplib": "0.10.8",
+    "@types/node": "25.0.3",
+    "@vitest/coverage-v8": "4.0.16",
+    "amqplib": "0.10.9",
+    "reflect-metadata": "0.2.2",
+    "rxjs": "7.8.1",
+    "tsdown": "0.18.1",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16",
+    "zod": "4.2.1",
+    "@amqp-contract/tsconfig": "0.0.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=11.0.0",
+    "@nestjs/core": ">=11.0.0",
+    "amqplib": ">=0.10.0",
+    "reflect-metadata": ">=0.1.13",
+    "rxjs": ">=7.0.0"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsdown src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run --project unit",
+    "test:watch": "vitest --project unit",
+    "typecheck": "tsc --noEmit"
+  }
+}