@servicelabsco/nestjs-utility-services 3.0.6 → 3.0.7

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 3.0.7
+
+### Fixed
+
+- **`@SubscribeFor` jobs run for subclass entities again.** `DispatcherSubscriber` looked jobs up
+  by the saved entity's exact class, so when a consuming app saved its own subclass of a platform
+  entity (e.g. `LocalEmailMessageEntity extends EmailMessageEntity`), the jobs bound to the parent
+  were silently skipped. The pre-3.0 per-entity subscribers fired for subclasses because TypeORM's
+  `listenTo()` matches them. The dispatcher now walks the saved class's prototype chain: parent-bound
+  jobs run first, then the subclass's own; a job bound to several classes on the chain runs once.
+  Consumers that worked around this by binding a parent's job to the subclass can drop the extra
+  `@SubscribeFor`.
+
 ## 3.0.6
 
 ### Changed

package/dist/auth/auth.module.js

@@ -22,8 +22,8 @@ exports.AuthModule = AuthModule;
 exports.AuthModule = AuthModule = __decorate([
     (0, common_1.Module)({
         imports: [typeorm_1.TypeOrmModule.forFeature(es6_classes_1.default.entities), jwt_1.JwtModule.register(jwtConfig), (0, common_1.forwardRef)(() => platform_utility_module_1.PlatformUtilityModule)],
-        providers: [...es6_classes_1.default.services, ...es6_classes_1.default.jobs],
-        exports: [...es6_classes_1.default.services, ...es6_classes_1.default.jobs],
+        providers: es6_classes_1.default.services,
+        exports: es6_classes_1.default.services,
     })
 ], AuthModule);
 //# sourceMappingURL=auth.module.js.map

package/dist/auth/auth.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.module.js","sourceRoot":"","sources":["../../src/auth/auth.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAoD;AACpD,qCAAwC;AACxC,wFAAmF;AACnF,gEAAuC;AACvC,kDAAmD;AACnD,6CAAgD;AAOzC,IAAM,UAAU,GAAhB,MAAM,UAAU;CAAG,CAAA;AAAb,gCAAU;qBAAV,UAAU;IALtB,IAAA,eAAM,EAAC;QACJ,OAAO,EAAE,CAAC,uBAAa,CAAC,UAAU,CAAC,qBAAU,CAAC,QAAQ,CAAC,EAAE,eAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,+CAAqB,CAAC,CAAC;QAChI,SAAS,EAAE,CAAC,GAAG,qBAAU,CAAC,QAAQ,EAAE,GAAG,qBAAU,CAAC,IAAI,CAAC;QACvD,OAAO,EAAE,CAAC,GAAG,qBAAU,CAAC,QAAQ,EAAE,GAAG,qBAAU,CAAC,IAAI,CAAC;KACxD,CAAC;GACW,UAAU,CAAG"}
+{"version":3,"file":"auth.module.js","sourceRoot":"","sources":["../../src/auth/auth.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAoD;AACpD,qCAAwC;AACxC,wFAAmF;AACnF,gEAAuC;AACvC,kDAAmD;AACnD,6CAAgD;AAOzC,IAAM,UAAU,GAAhB,MAAM,UAAU;CAAG,CAAA;AAAb,gCAAU;qBAAV,UAAU;IALtB,IAAA,eAAM,EAAC;QACJ,OAAO,EAAE,CAAC,uBAAa,CAAC,UAAU,CAAC,qBAAU,CAAC,QAAQ,CAAC,EAAE,eAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,+CAAqB,CAAC,CAAC;QAChI,SAAS,EAAE,qBAAU,CAAC,QAAQ;QAC9B,OAAO,EAAE,qBAAU,CAAC,QAAQ;KAC/B,CAAC;GACW,UAAU,CAAG"}

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

@@ -33,9 +33,7 @@ declare const es6Classes: {
     dtos: (typeof UserRolesAccessObjectDto | typeof SessionIdentifierAttributesDto | typeof PermissionAssignmentDto | typeof RoleAssignmentDto | typeof UserLoginDto | typeof CreateUserDto | typeof OfflineUserDto | typeof UpdateUserDto)[];
     entities: (typeof CreatorEntity | typeof CountryEntity | typeof UserReferralEntity | typeof DeviceTokenEntity | typeof RefreshTokenEntity | typeof SessionIdentifierEntity | typeof SocialIdentityEntity)[];
     interfaces: any[];
-    jobs: any[];
     middlewares: (typeof BasicAuthMiddleware | typeof ClientConnectMiddleware | typeof InternalMiddleware | typeof JwtMiddleware | typeof RestrictedMiddleware)[];
     services: (typeof AccessService | typeof RefreshTokenService | typeof UserService | typeof AuthService | typeof DeviceTokenService | typeof SocialIdentityService | typeof SocialService)[];
-    subscribers: any[];
 };
 export default es6Classes;

package/dist/auth/es6.classes.js

@@ -58,18 +58,8 @@ const es6Classes = {
         user_referral_entity_1.UserReferralEntity,
     ],
     interfaces: [],
-    jobs: [],
     middlewares: [basic_auth_middleware_1.BasicAuthMiddleware, client_connect_middleware_1.ClientConnectMiddleware, internal_middleware_1.InternalMiddleware, jwt_middleware_1.JwtMiddleware, restricted_middleware_1.RestrictedMiddleware],
-    services: [
-        access_service_1.AccessService,
-        auth_service_1.AuthService,
-        device_token_service_1.DeviceTokenService,
-        refresh_token_service_1.RefreshTokenService,
-        social_identity_service_1.SocialIdentityService,
-        social_service_1.SocialService,
-        user_service_1.UserService,
-    ],
-    subscribers: [],
+    services: [access_service_1.AccessService, auth_service_1.AuthService, device_token_service_1.DeviceTokenService, refresh_token_service_1.RefreshTokenService, social_identity_service_1.SocialIdentityService, social_service_1.SocialService, user_service_1.UserService],
 };
 exports.default = es6Classes;
 //# sourceMappingURL=es6.classes.js.map

package/dist/auth/es6.classes.js.map

@@ -1 +1 @@
-{"version":3,"file":"es6.classes.js","sourceRoot":"","sources":["../../src/auth/es6.classes.ts"],"names":[],"mappings":";;AAAA,+EAA0E;AAC1E,uEAAmE;AACnE,mEAA+D;AAC/D,4DAAuD;AACvD,8DAAyD;AACzD,gFAA2E;AAC3E,oEAA+D;AAC/D,gGAA0F;AAC1F,4DAAuD;AACvD,4DAAuD;AACvD,oEAA+D;AAC/D,0DAAqD;AACrD,sFAA+E;AAC/E,8DAA0D;AAC1D,8DAA0D;AAC1D,wEAAmE;AACnE,0EAAqE;AACrE,oFAA+E;AAC/E,8EAAyE;AACzE,wDAAoD;AACpD,0EAAqE;AACrE,+EAA0E;AAC1E,uFAAkF;AAClF,2EAAuE;AACvE,iEAA6D;AAC7D,+EAA2E;AAC3E,8DAA0D;AAC1D,0DAAsD;AACtD,0EAAqE;AACrE,4EAAuE;AACvE,gFAA2E;AAC3E,8DAA0D;AAC1D,0DAAsD;AAEtD,MAAM,UAAU,GAAG;IACf,WAAW,EAAE,CAAC,2CAAmB,EAAE,oCAAgB,EAAE,gCAAc,CAAC;IACpE,IAAI,EAAE;QACF,+BAAa;QACb,iCAAc;QACd,mDAAuB;QACvB,uCAAiB;QACjB,kEAA8B;QAC9B,+BAAa;QACb,+BAAa;QACb,uCAAiB;QACjB,6BAAY;QACZ,uDAAwB;KAC3B;IACD,QAAQ,EAAE;QACN,8BAAa;QACb,8BAAa;QACb,uCAAiB;QACjB,yCAAkB;QAClB,mDAAuB;QACvB,6CAAoB;QACpB,wBAAU;QACV,yCAAkB;KACrB;IACD,UAAU,EAAE,EAAE;IACd,IAAI,EAAE,EAAE;IACR,WAAW,EAAE,CAAC,2CAAmB,EAAE,mDAAuB,EAAE,wCAAkB,EAAE,8BAAa,EAAE,4CAAoB,CAAC;IACpH,QAAQ,EAAE;QACN,8BAAa;QACb,0BAAW;QACX,yCAAkB;QAClB,2CAAmB;QACnB,+CAAqB;QACrB,8BAAa;QACb,0BAAW;KACd;IACD,WAAW,EAAE,EAAE;CAClB,CAAC;AAEF,kBAAe,UAAU,CAAC"}
+{"version":3,"file":"es6.classes.js","sourceRoot":"","sources":["../../src/auth/es6.classes.ts"],"names":[],"mappings":";;AAAA,+EAA0E;AAC1E,uEAAmE;AACnE,mEAA+D;AAC/D,4DAAuD;AACvD,8DAAyD;AACzD,gFAA2E;AAC3E,oEAA+D;AAC/D,gGAA0F;AAC1F,4DAAuD;AACvD,4DAAuD;AACvD,oEAA+D;AAC/D,0DAAqD;AACrD,sFAA+E;AAC/E,8DAA0D;AAC1D,8DAA0D;AAC1D,wEAAmE;AACnE,0EAAqE;AACrE,oFAA+E;AAC/E,8EAAyE;AACzE,wDAAoD;AACpD,0EAAqE;AACrE,+EAA0E;AAC1E,uFAAkF;AAClF,2EAAuE;AACvE,iEAA6D;AAC7D,+EAA2E;AAC3E,8DAA0D;AAC1D,0DAAsD;AACtD,0EAAqE;AACrE,4EAAuE;AACvE,gFAA2E;AAC3E,8DAA0D;AAC1D,0DAAsD;AAEtD,MAAM,UAAU,GAAG;IACf,WAAW,EAAE,CAAC,2CAAmB,EAAE,oCAAgB,EAAE,gCAAc,CAAC;IACpE,IAAI,EAAE;QACF,+BAAa;QACb,iCAAc;QACd,mDAAuB;QACvB,uCAAiB;QACjB,kEAA8B;QAC9B,+BAAa;QACb,+BAAa;QACb,uCAAiB;QACjB,6BAAY;QACZ,uDAAwB;KAC3B;IACD,QAAQ,EAAE;QACN,8BAAa;QACb,8BAAa;QACb,uCAAiB;QACjB,yCAAkB;QAClB,mDAAuB;QACvB,6CAAoB;QACpB,wBAAU;QACV,yCAAkB;KACrB;IACD,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,CAAC,2CAAmB,EAAE,mDAAuB,EAAE,wCAAkB,EAAE,8BAAa,EAAE,4CAAoB,CAAC;IACpH,QAAQ,EAAE,CAAC,8BAAa,EAAE,0BAAW,EAAE,yCAAkB,EAAE,2CAAmB,EAAE,+CAAqB,EAAE,8BAAa,EAAE,0BAAW,CAAC;CACrI,CAAC;AAEF,kBAAe,UAAU,CAAC"}

package/dist/platformUtility/subscribers/dispatcher.subscriber.d.ts

@@ -6,10 +6,13 @@ export declare class DispatcherSubscriber extends CommonSubscriber<any> implemen
     private readonly dataSource;
     private readonly moduleRef;
     private readonly jobs;
+    private readonly jobsByTarget;
+    private initialized;
     constructor(dataSource: DataSource, moduleRef: ModuleRef);
     onModuleInit(): Promise<void>;
     private warnIgnoredPrePersistHooks;
     afterInsert(evt: InsertEvent<any>): Promise<any>;
     afterUpdate(evt: UpdateEvent<any>): Promise<any>;
     private routeDispatch;
+    private jobsFor;
 }

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

@@ -55,6 +55,8 @@ let DispatcherSubscriber = class DispatcherSubscriber extends common_subscriber_
         this.dataSource = dataSource;
         this.moduleRef = moduleRef;
         this.jobs = new Map();
+        this.jobsByTarget = new Map();
+        this.initialized = false;
         dataSource.subscribers.push(this);
     }
     async onModuleInit() {
@@ -72,6 +74,8 @@ let DispatcherSubscriber = class DispatcherSubscriber extends common_subscriber_
             }
             this.jobs.set(entityClass, resolved);
         }
+        this.jobsByTarget.clear();
+        this.initialized = true;
     }
     warnIgnoredPrePersistHooks(job, jobClass, entityClass) {
         const hooks = ['beforeInsert', 'beforeUpdate'].filter((hook) => typeof job?.[hook] === 'function');
@@ -89,15 +93,33 @@ let DispatcherSubscriber = class DispatcherSubscriber extends common_subscriber_
         return this.routeDispatch(evt);
     }
     async routeDispatch(evt) {
-        const target = evt.metadata.target;
-        const jobs = this.jobs.get(target);
-        if (!jobs?.length)
+        const jobs = this.jobsFor(evt.metadata.target);
+        if (!jobs.length)
             return;
         const data = this.getEventData(evt);
         for (const job of jobs) {
             await this.enqueueDispatch(evt.queryRunner, job, data);
         }
     }
+    jobsFor(target) {
+        const cached = this.jobsByTarget.get(target);
+        if (cached)
+            return cached;
+        const lineage = [];
+        for (let cls = target; typeof cls === 'function' && cls !== Function.prototype; cls = Object.getPrototypeOf(cls)) {
+            lineage.unshift(cls);
+        }
+        const jobs = [];
+        for (const cls of lineage) {
+            for (const job of this.jobs.get(cls) ?? []) {
+                if (!jobs.includes(job))
+                    jobs.push(job);
+            }
+        }
+        if (this.initialized)
+            this.jobsByTarget.set(target, jobs);
+        return jobs;
+    }
 };
 exports.DispatcherSubscriber = DispatcherSubscriber;
 exports.DispatcherSubscriber = DispatcherSubscriber = __decorate([

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":"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"}
+{"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

@@ -170,6 +170,7 @@ other job.
 | `afterInsert` / `afterUpdate` | Fan-out to **all** `@SubscribeFor` jobs for that entity (registration order, sequential enqueue). |
 | `beforeInsert` / `beforeUpdate` | **Only** on standalone `CommonSubscriber`s. Never routed to jobs. |
 | Standalone subscriber + `@SubscribeFor` | Allowed. Mutation on subscriber; post-persist via dispatcher. |
+| Saving a subclass entity (e.g. `LocalEmailMessageEntity extends EmailMessageEntity`) | Runs the jobs bound to the subclass **and** to every entity it extends (parents first), like TypeORM `listenTo()`. A job bound to several classes on the chain runs once. Saving the parent never runs subclass-only jobs. |
 | Transactional saves | Dispatch is buffered until commit (see `CommonSubscriber` / dispatcher); rolled back on rollback. |
 
 Platform modules usually register before the app, so NU’s job is typically

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicelabsco/nestjs-utility-services",
-    "version": "3.0.6",
+    "version": "3.0.7",
     "description": "NestJS generic packages to support development",
     "author": "Hemant Kumar Sah <hemantanshu@gmail.com>",
     "license": "MIT",