nestjs-array-provider 1.0.0

package/README.md

@@ -0,0 +1,65 @@
+# nestjs-array-provider
+
+A tiny utility to collect multiple NestJS providers into an injectable array. Useful for plugin, strategy, and registry patterns.
+
+## Installation
+
+```bash
+npm install nestjs-array-provider
+```
+
+## Usage
+
+```typescript
+import { arrayProvider } from 'nestjs-array-provider';
+
+// 1. Define a token
+const PAYMENT_PROVIDERS = Symbol('PAYMENT_PROVIDERS');
+
+// 2. Register in your module
+@Module({
+  providers: [
+    DirectProvider,
+    HitPayProvider,
+    arrayProvider<PaymentProvider>(PAYMENT_PROVIDERS, [
+      DirectProvider,
+      HitPayProvider,
+    ]),
+    PaymentService,
+  ],
+})
+export class PaymentModule {}
+
+// 3. Inject the array
+@Injectable()
+export class PaymentService {
+  constructor(
+    @Inject(PAYMENT_PROVIDERS)
+    private readonly providers: PaymentProvider[],
+  ) {}
+
+  charge(amount: number) {
+    // Use all registered providers
+    return this.providers.map((p) => p.charge(amount));
+  }
+}
+```
+
+## API
+
+### `arrayProvider<T>(token, providers): Provider`
+
+| Parameter   | Type              | Description                                      |
+| ----------- | ----------------- | ------------------------------------------------ |
+| `token`     | `InjectionToken`  | The injection token to provide the array under    |
+| `providers` | `Type<T>[]`       | Array of classes to collect into the injected array |
+
+Returns a NestJS `Provider` that resolves each class and provides them as a `T[]`.
+
+## Why?
+
+NestJS doesn't have a built-in way to inject all implementations of an interface as an array. The common workaround involves verbose boilerplate with `useFactory` and manual `inject` lists. `arrayProvider` wraps that pattern into a single, type-safe call.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { InjectionToken, Provider, Type } from '@nestjs/common';
+/**
+ * Creates a NestJS provider that injects multiple services and provides them as an array.
+ *
+ * This is useful for implementing plugin/strategy patterns where you want to collect
+ * all implementations of an interface and inject them as an array.
+ *
+ * @example
+ * // Define a token:
+ * const PAYMENT_PROVIDERS = Symbol('PAYMENT_PROVIDERS');
+ *
+ * // In your module:
+ * @Module({
+ *   providers: [
+ *     DirectProvider,
+ *     HitPayProvider,
+ *     arrayProvider<PaymentProvider>(PAYMENT_PROVIDERS, [DirectProvider, HitPayProvider]),
+ *     PaymentProviderRegistry,
+ *   ],
+ * })
+ *
+ * // In your service:
+ * constructor(
+ *   @Inject(PAYMENT_PROVIDERS)
+ *   private readonly providers: PaymentProvider[],
+ * ) {}
+ */
+export declare function arrayProvider<T>(token: InjectionToken, providers: Type<T>[]): Provider;

package/dist/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrayProvider = arrayProvider;
+/**
+ * Creates a NestJS provider that injects multiple services and provides them as an array.
+ *
+ * This is useful for implementing plugin/strategy patterns where you want to collect
+ * all implementations of an interface and inject them as an array.
+ *
+ * @example
+ * // Define a token:
+ * const PAYMENT_PROVIDERS = Symbol('PAYMENT_PROVIDERS');
+ *
+ * // In your module:
+ * @Module({
+ *   providers: [
+ *     DirectProvider,
+ *     HitPayProvider,
+ *     arrayProvider<PaymentProvider>(PAYMENT_PROVIDERS, [DirectProvider, HitPayProvider]),
+ *     PaymentProviderRegistry,
+ *   ],
+ * })
+ *
+ * // In your service:
+ * constructor(
+ *   @Inject(PAYMENT_PROVIDERS)
+ *   private readonly providers: PaymentProvider[],
+ * ) {}
+ */
+function arrayProvider(token, providers) {
+    return {
+        provide: token,
+        useFactory: (...instances) => instances,
+        inject: providers,
+    };
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "nestjs-array-provider",
+  "version": "1.0.0",
+  "description": "Create NestJS providers that inject multiple services as an array. Useful for plugin/strategy patterns.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "jest"
+  },
+  "keywords": [
+    "nestjs",
+    "array",
+    "provider",
+    "dependency-injection",
+    "plugin-pattern",
+    "strategy-pattern"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@nestjs/common": ">=8.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@nestjs/testing": "^10.0.0",
+    "@types/jest": "^29.5.0",
+    "jest": "^29.7.0",
+    "reflect-metadata": "^0.2.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  }
+}