@servicelabsco/nestjs-utility-services 3.0.2 → 3.0.4

package/CHANGELOG.md

@@ -1,7 +1,19 @@
 # Changelog
 
+## Unreleased
+
+### Changed
+
+- **`@SubscribeFor` supports multiple jobs per entity.** `SubscriberRegistry` stores
+  `Map<Entity, Job[]>`. `DispatcherSubscriber` fans out `afterInsert`/`afterUpdate` to every
+  bound job (registration order, sequential enqueue). `beforeInsert`/`beforeUpdate` still run on
+  the **first** registered job only. Standalone TypeORM subscribers remain forbidden on entities
+  that already have `@SubscribeFor` job(s). Consuming apps can add e.g. `LocalDocumentJob` with
+  `@SubscribeFor(DocumentEntity)` without wrapping platform `DocumentJob`.
+
 ## 3.0.0 — audit remediation (BREAKING)
 
+
 This is a **major** release. `2.0.15` was published from the `production` branch; `main` had since
 accumulated breaking changes that were sitting under an already-consumed patch version. Everything
 below lands at once.

package/README.md

@@ -39,6 +39,11 @@ checklist (`instrument.ts`, `AppModule`, env vars, workers).
 breaker-by-breaker migration guide (internal auth, SSRF, PDF URLs, scripts, access checks,
 sessions, SES, migrations) and which escape hatches exist.
 
+### `@SubscribeFor` (entity → job bindings)
+
+Multiple jobs may bind the same entity; after-hooks fan out, before-hooks stay on the first job.
+See **[docs/subscribe-for.md](docs/subscribe-for.md)**.
+
 ## Installation
 
 ```bash

package/dist/common/es6.classes.d.ts

@@ -48,7 +48,8 @@ declare const es6Classes: {
     exceptions: (typeof NoLoggedUserException)[];
     libraries: (typeof CommonJob | typeof CachedProperty | typeof GenericIndexParser | typeof GenericShowParser | typeof DataManager | typeof ListManager | typeof RecordManager | typeof ReportDataManager | typeof ReportListManager | {
         register(entity: new (...args: any[]) => any, job: new (...args: any[]) => any): void;
-        entries(): IterableIterator<[new (...args: any[]) => any, new (...args: any[]) => any]>;
+        jobsFor(entity: new (...args: any[]) => any): (new (...args: any[]) => any)[];
+        entries(): IterableIterator<[new (...args: any[]) => any, (new (...args: any[]) => any)[]]>;
         size(): number;
         clear(): void;
     } | typeof BaseMigrationUtility | typeof CommonConsumer | typeof DatabaseEventEvaluator | typeof Money | typeof SeederUtility)[];

package/dist/common/libraries/subscriber.registry.d.ts

@@ -1,7 +1,8 @@
 type ClassRef = new (...args: any[]) => any;
 export declare const SubscriberRegistry: {
     register(entity: ClassRef, job: ClassRef): void;
-    entries(): IterableIterator<[ClassRef, ClassRef]>;
+    jobsFor(entity: ClassRef): ClassRef[];
+    entries(): IterableIterator<[ClassRef, ClassRef[]]>;
     size(): number;
     clear(): void;
 };

package/dist/common/libraries/subscriber.registry.js

@@ -5,13 +5,17 @@ exports.SubscribeFor = SubscribeFor;
 const map = new Map();
 exports.SubscriberRegistry = {
     register(entity, job) {
-        if (map.has(entity)) {
-            const existing = map.get(entity);
-            if (existing === job)
+        const existing = map.get(entity);
+        if (existing) {
+            if (existing.includes(job))
                 return;
-            throw new Error(`SubscribeFor: ${entity.name} is already bound to ${existing.name}; ` + `cannot also bind to ${job.name}.`);
+            existing.push(job);
+            return;
         }
-        map.set(entity, job);
+        map.set(entity, [job]);
+    },
+    jobsFor(entity) {
+        return map.get(entity) ?? [];
     },
     entries() {
         return map.entries();

package/dist/common/libraries/subscriber.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscriber.registry.js","sourceRoot":"","sources":["../../../src/common/libraries/subscriber.registry.ts"],"names":[],"mappings":";;;AA8CA,oCAIC;AAxCD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE7B,QAAA,kBAAkB,GAAG;IAC9B,QAAQ,CAAC,MAAgB,EAAE,GAAa;QACpC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;YAKlC,IAAI,QAAQ,KAAK,GAAG;gBAAE,OAAO;YAC7B,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,IAAI,wBAAwB,QAAQ,CAAC,IAAI,IAAI,GAAG,uBAAuB,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QAChI,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO;QACH,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IACD,IAAI;QACA,OAAO,GAAG,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,KAAK;QACD,GAAG,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;CACJ,CAAC;AAWF,SAAgB,YAAY,CAAC,MAAgB;IACzC,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,0BAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,MAA6B,CAAC,CAAC;IACvE,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"subscriber.registry.js","sourceRoot":"","sources":["../../../src/common/libraries/subscriber.registry.ts"],"names":[],"mappings":";;;AAiEA,oCAIC;AAtDD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAwB,CAAC;AAE/B,QAAA,kBAAkB,GAAG;IAC9B,QAAQ,CAAC,MAAgB,EAAE,GAAa;QACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YAGX,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO;YACnC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO;QACX,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC;IAKD,OAAO,CAAC,MAAgB;QACpB,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IACD,OAAO;QACH,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IACD,IAAI;QACA,OAAO,GAAG,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,KAAK;QACD,GAAG,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;CACJ,CAAC;AAmBF,SAAgB,YAAY,CAAC,MAAgB;IACzC,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,0BAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,MAA6B,CAAC,CAAC;IACvE,CAAC,CAAC;AACN,CAAC"}

package/dist/platformUtility/subscribers/dispatcher.subscriber.js

@@ -24,14 +24,18 @@ let DispatcherSubscriber = class DispatcherSubscriber extends common_subscriber_
         dataSource.subscribers.push(this);
     }
     async onModuleInit() {
-        for (const [entityClass, jobClass] of subscriber_registry_1.SubscriberRegistry.entries()) {
-            const job = this.moduleRef.get(jobClass, { strict: false });
-            if (!job) {
-                throw new Error(`DispatcherSubscriber: failed to resolve job ${jobClass.name} ` +
-                    `for entity ${entityClass.name} via ModuleRef. ` +
-                    `Is the job registered as a provider in its module's es6.classes.ts?`);
+        for (const [entityClass, jobClasses] of subscriber_registry_1.SubscriberRegistry.entries()) {
+            const resolved = [];
+            for (const jobClass of jobClasses) {
+                const job = this.moduleRef.get(jobClass, { strict: false });
+                if (!job) {
+                    throw new Error(`DispatcherSubscriber: failed to resolve job ${jobClass.name} ` +
+                        `for entity ${entityClass.name} via ModuleRef. ` +
+                        `Is the job registered as a provider in its module's es6.classes.ts?`);
+                }
+                resolved.push(job);
             }
-            this.jobs.set(entityClass, job);
+            this.jobs.set(entityClass, resolved);
         }
         this.assertNoConflicts();
     }
@@ -49,15 +53,18 @@ let DispatcherSubscriber = class DispatcherSubscriber extends common_subscriber_
     }
     async routeDispatch(evt) {
         const target = evt.metadata.target;
-        const job = this.jobs.get(target);
-        if (!job)
+        const jobs = this.jobs.get(target);
+        if (!jobs?.length)
             return;
         const data = this.getEventData(evt);
-        return this.enqueueDispatch(evt.queryRunner, job, data);
+        for (const job of jobs) {
+            await this.enqueueDispatch(evt.queryRunner, job, data);
+        }
     }
     async routeBeforeHook(evt, hook) {
         const target = evt.metadata.target;
-        const job = this.jobs.get(target);
+        const jobs = this.jobs.get(target);
+        const job = jobs?.[0];
         if (!job || typeof job[hook] !== 'function')
             return;
         return job[hook](evt);
@@ -73,8 +80,8 @@ let DispatcherSubscriber = class DispatcherSubscriber extends common_subscriber_
             if (listened && this.jobs.has(listened)) {
                 const standaloneName = sub.constructor?.name ?? 'unknown subscriber';
                 throw new Error(`DispatcherSubscriber: ${listened.name} is both decorated with @SubscribeFor ` +
-                    `and has a standalone subscriber (${standaloneName}). Pick one — delete the standalone ` +
-                    `subscriber file, or remove @SubscribeFor from the job.`);
+                    `job(s) and has a standalone subscriber (${standaloneName}). Pick one — delete the standalone ` +
+                    `subscriber file, or remove @SubscribeFor from the job(s).`);
             }
         }
     }

package/dist/platformUtility/subscribers/dispatcher.subscriber.js.map

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.subscriber.js","sourceRoot":"","sources":["../../../src/platformUtility/subscribers/dispatcher.subscriber.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA0D;AAC1D,uCAAyC;AACzC,qCAAgF;AAChF,gFAA4E;AAC5E,oFAAgF;AAsBzE,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,oCAAqB;IAG3D,YACqB,UAAsB,EACtB,SAAoB;QAErC,KAAK,EAAE,CAAC;QAHS,eAAU,GAAV,UAAU,CAAY;QACtB,cAAS,GAAT,SAAS,CAAW;QAJxB,SAAI,GAAG,IAAI,GAAG,EAAgD,CAAC;QAO5E,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,YAAY;QACd,KAAK,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,wCAAkB,CAAC,OAAO,EAAE,EAAE,CAAC;YACjE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAgC,CAAC;YAClG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACP,MAAM,IAAI,KAAK,CACX,+CAA+C,QAAQ,CAAC,IAAI,GAAG;oBAC3D,cAAc,WAAW,CAAC,IAAI,kBAAkB;oBAChD,qEAAqE,CAC5E,CAAC;YACN,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAMD,KAAK,CAAC,YAAY,CAAC,GAAqB;QACpC,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAqB;QACpC,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC;IAMD,KAAK,CAAC,WAAW,CAAC,GAAqB;QACnC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAqB;QACnC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,GAAwC;QAChE,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAqC,CAAC;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,GAAwC,EAAE,IAAqC;QACzG,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAqC,CAAC;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,UAAU;YAAE,OAAO;QAEpD,OAAO,GAAG,CAAC,IAAI,CAAE,CAAC,GAAU,CAAC,CAAC;IAClC,CAAC;IAEO,iBAAiB;QACrB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,GAAG,KAAK,IAAI;gBAAE,SAAS;YAC3B,MAAM,QAAQ,GAAI,GAAW,CAAC,QAAQ,CAAC;YACvC,IAAI,OAAO,QAAQ,KAAK,UAAU;gBAAE,SAAS;YAE7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,MAAM,cAAc,GAAI,GAAW,CAAC,WAAW,EAAE,IAAI,IAAI,oBAAoB,CAAC;gBAC9E,MAAM,IAAI,KAAK,CACX,yBAAyB,QAAQ,CAAC,IAAI,wCAAwC;oBAC1E,oCAAoC,cAAc,sCAAsC;oBACxF,wDAAwD,CAC/D,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;CACJ,CAAA;AApFY,oDAAoB;+BAApB,oBAAoB;IAFhC,IAAA,mBAAU,GAAE;IACZ,IAAA,yBAAe,GAAE;qCAKmB,oBAAU;QACX,gBAAS;GALhC,oBAAoB,CAoFhC"}
+{"version":3,"file":"dispatcher.subscriber.js","sourceRoot":"","sources":["../../../src/platformUtility/subscribers/dispatcher.subscriber.ts"],"names":[],"mappings":"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"}

package/docs/subscribe-for.md

@@ -0,0 +1,39 @@
+# `@SubscribeFor` — multi-job entity bindings
+
+`@SubscribeFor(EntityClass)` binds a `CommonJob` (or subclass) to TypeORM
+insert/update events for that entity. `DispatcherSubscriber` routes those
+events; you do **not** need a standalone `*.subscriber.ts` for pure
+after-persist side effects.
+
+## Multiple jobs per entity
+
+More than one job may decorate the same entity. Typical pattern: keep the
+platform job (e.g. `DocumentJob`) and add an app-local job for tenant-specific
+side effects.
+
+```ts
+import { Injectable } from '@nestjs/common';
+import { CommonJob, DatabaseEventDto, DocumentEntity, SubscribeFor } from '@servicelabsco/nestjs-utility-services';
+
+@SubscribeFor(DocumentEntity)
+@Injectable()
+export class LocalDocumentJob extends CommonJob {
+    async handle(evt: DatabaseEventDto<DocumentEntity>) {
+        // app-local side effects — do not wrap DocumentJob.handle
+    }
+}
+```
+
+Register `LocalDocumentJob` as a Nest provider (your module’s `es6.classes` /
+providers). Each job keeps its own BullMQ hash / queue identity.
+
+### Behaviour
+
+| Hook | Behaviour |
+| --- | --- |
+| `afterInsert` / `afterUpdate` | Fan-out to **all** bound jobs, registration order (sequential enqueue). |
+| `beforeInsert` / `beforeUpdate` | **First** registered job only (single owner for pre-persist mutation). |
+| Standalone `CommonSubscriber` on the same entity | Still **throws at boot** — pick `@SubscribeFor` **or** a standalone subscriber, not both. |
+
+Platform modules usually load before the app, so NU’s job is typically first in
+the list when both bind the same entity.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicelabsco/nestjs-utility-services",
-    "version": "3.0.2",
+    "version": "3.0.4",
     "description": "NestJS generic packages to support development",
     "author": "Hemant Kumar Sah <hemantanshu@gmail.com>",
     "license": "MIT",
@@ -12,7 +12,8 @@
         "CHANGELOG.md",
         "LICENSE",
         "docs/sentry-reporting.md",
-        "docs/upgrade-3.0-backward-compatibility.md"
+        "docs/upgrade-3.0-backward-compatibility.md",
+        "docs/subscribe-for.md"
     ],
     "types": "dist/index.d.ts",
     "scripts": {

package/.vscode/settings.json

@@ -1,13 +0,0 @@
-{
-    "javascript.preferences.importModuleSpecifier": "relative",
-    // "javascript.preferences.importModuleSpecifierEnding": "minimal",
-    "javascript.preferences.quoteStyle": "single",
-    "path-intellisense.absolutePathToWorkspace": false,
-    "workbench.editor.limit.enabled": true,
-    "workbench.editor.limit.value": 5,
-    "git.ignoreLimitWarning": true,
-    "sonarlint.connectedMode.project": {
-        "connectionId": "https-sq-servicelabs-co",
-        "projectKey": "servicelabsco_nestjs-utility-services_AYbKa4hwTzQzhdLPPxIE"
-    }
-}