@servicelabsco/nestjs-utility-services 3.0.4 → 3.0.6

package/dist/{auth/jobs → system/subscribers}/index.js

@@ -14,5 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./session.identifier.job"), exports);
+__exportStar(require("./client.credential.subscriber"), exports);
+__exportStar(require("./code.fix.script.subscriber"), exports);
+__exportStar(require("./material.view.subscriber"), exports);
+__exportStar(require("./property.subscriber"), exports);
+__exportStar(require("./recurring.query.subscriber"), exports);
+__exportStar(require("./scheduled.event.subscriber"), exports);
 //# sourceMappingURL=index.js.map

package/dist/system/subscribers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/system/subscribers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAAA,+DAA6C;AAAA,6DAA2C;AAAA,wDAAsC;AAAA,+DAA6C;AAAA,+DAA4C"}

package/dist/system/subscribers/material.view.subscriber.d.ts

@@ -0,0 +1,11 @@
+import { DataSource, InsertEvent, UpdateEvent } from 'typeorm';
+import { CommonSubscriber } from '../../common/libraries/common.subscriber';
+import { MaterialViewEntity } from '../entities/material.view.entity';
+export declare class MaterialViewSubscriber extends CommonSubscriber<MaterialViewEntity> {
+    private readonly dataSource;
+    constructor(dataSource: DataSource);
+    listenTo(): typeof MaterialViewEntity;
+    beforeInsert(event: InsertEvent<MaterialViewEntity>): Promise<void>;
+    beforeUpdate(event: UpdateEvent<MaterialViewEntity>): Promise<void>;
+    private validateTiming;
+}

package/dist/system/subscribers/material.view.subscriber.js

@@ -0,0 +1,53 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaterialViewSubscriber = void 0;
+const date_fns_1 = require("date-fns");
+const typeorm_1 = require("typeorm");
+const form_exception_1 = require("../../common/exceptions/form.exception");
+const common_subscriber_1 = require("../../common/libraries/common.subscriber");
+const platform_utility_1 = require("../../common/libraries/platform.utility");
+const material_view_entity_1 = require("../entities/material.view.entity");
+let MaterialViewSubscriber = class MaterialViewSubscriber extends common_subscriber_1.CommonSubscriber {
+    constructor(dataSource) {
+        super();
+        this.dataSource = dataSource;
+        dataSource.subscribers.push(this);
+    }
+    listenTo() {
+        return material_view_entity_1.MaterialViewEntity;
+    }
+    async beforeInsert(event) {
+        event.entity.attributes = {
+            ...event.entity.attributes,
+            ...{},
+        };
+        this.validateTiming(event.entity?.timing);
+        if (!event.entity.last_scheduled_time)
+            event.entity.last_scheduled_time = (0, date_fns_1.subMinutes)(new Date(), 15);
+    }
+    async beforeUpdate(event) {
+        this.validateTiming(event.entity?.timing);
+        if (!event.entity.last_scheduled_time)
+            event.entity.last_scheduled_time = (0, date_fns_1.subMinutes)(new Date(), 15);
+    }
+    validateTiming(timing) {
+        if (timing && !platform_utility_1.PlatformUtility.isValidCronExpression(timing)) {
+            throw new form_exception_1.FormException({ column: 'timing', err: `Invalid cron expression: ${timing}` });
+        }
+    }
+};
+exports.MaterialViewSubscriber = MaterialViewSubscriber;
+exports.MaterialViewSubscriber = MaterialViewSubscriber = __decorate([
+    (0, typeorm_1.EventSubscriber)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource])
+], MaterialViewSubscriber);
+//# sourceMappingURL=material.view.subscriber.js.map

package/dist/system/subscribers/material.view.subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.view.subscriber.js","sourceRoot":"","sources":["../../../src/system/subscribers/material.view.subscriber.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,uCAAsC;AACtC,qCAAgF;AAChF,2EAAuE;AACvE,gFAA4E;AAC5E,8EAA0E;AAC1E,2EAAsE;AAO/D,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,oCAAoC;IAC5E,YAA6B,UAAsB;QAC/C,KAAK,EAAE,CAAC;QADiB,eAAU,GAAV,UAAU,CAAY;QAE/C,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ;QACJ,OAAO,yCAAkB,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAsC;QACrD,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG;YACtB,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU;YAC1B,GAAG,EAAE;SACR,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,mBAAmB;YAAE,KAAK,CAAC,MAAM,CAAC,mBAAmB,GAAG,IAAA,qBAAU,EAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAsC;QACrD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,mBAAmB;YAAE,KAAK,CAAC,MAAM,CAAC,mBAAmB,GAAG,IAAA,qBAAU,EAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACzG,CAAC;IAEO,cAAc,CAAC,MAAiC;QACpD,IAAI,MAAM,IAAI,CAAC,kCAAe,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,8BAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,4BAA4B,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7F,CAAC;IACL,CAAC;CACJ,CAAA;AAhCY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,yBAAe,GAAE;qCAE2B,oBAAU;GAD1C,sBAAsB,CAgClC"}

package/dist/system/subscribers/property.subscriber.d.ts

@@ -0,0 +1,10 @@
+import { DataSource, InsertEvent, UpdateEvent } from 'typeorm';
+import { CommonSubscriber } from '../../common/libraries/common.subscriber';
+import { PropertyEntity } from '../entities/property.entity';
+export declare class PropertySubscriber extends CommonSubscriber<PropertyEntity> {
+    private readonly dataSource;
+    constructor(dataSource: DataSource);
+    listenTo(): typeof PropertyEntity;
+    beforeInsert(event: InsertEvent<PropertyEntity>): Promise<void>;
+    beforeUpdate(evt: UpdateEvent<PropertyEntity>): Promise<void>;
+}

package/dist/{auth/subscribers/session.identifier.subscriber.js → system/subscribers/property.subscriber.js}

@@ -9,32 +9,32 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionIdentifierSubscriber = void 0;
+exports.PropertySubscriber = void 0;
 const typeorm_1 = require("typeorm");
 const common_subscriber_1 = require("../../common/libraries/common.subscriber");
-const session_identifier_entity_1 = require("../entities/session.identifier.entity");
-const session_identifier_job_1 = require("../jobs/session.identifier.job");
-let SessionIdentifierSubscriber = class SessionIdentifierSubscriber extends common_subscriber_1.CommonSubscriber {
-    constructor(dataSource, sessionIdentifierJob) {
+const custom_crypt_1 = require("../../common/libraries/custom.crypt");
+const property_entity_1 = require("../entities/property.entity");
+let PropertySubscriber = class PropertySubscriber extends common_subscriber_1.CommonSubscriber {
+    constructor(dataSource) {
         super();
         this.dataSource = dataSource;
-        this.sessionIdentifierJob = sessionIdentifierJob;
         dataSource.subscribers.push(this);
     }
     listenTo() {
-        return session_identifier_entity_1.SessionIdentifierEntity;
+        return property_entity_1.PropertyEntity;
     }
-    async afterInsert(evt) {
-        return this.enqueueDispatch(evt.queryRunner, this.sessionIdentifierJob, this.getEventData(evt));
+    async beforeInsert(event) {
+        if (event.entity.is_encrypted)
+            event.entity.value = custom_crypt_1.CustomCrypt.encrypt(event.entity.value);
     }
-    async afterUpdate(evt) {
-        return this.enqueueDispatch(evt.queryRunner, this.sessionIdentifierJob, this.getEventData(evt));
+    async beforeUpdate(evt) {
+        if (evt.entity.is_encrypted && evt.entity.value !== evt.databaseEntity.value)
+            evt.entity.value = custom_crypt_1.CustomCrypt.encrypt(evt.entity.value);
     }
 };
-exports.SessionIdentifierSubscriber = SessionIdentifierSubscriber;
-exports.SessionIdentifierSubscriber = SessionIdentifierSubscriber = __decorate([
+exports.PropertySubscriber = PropertySubscriber;
+exports.PropertySubscriber = PropertySubscriber = __decorate([
     (0, typeorm_1.EventSubscriber)(),
-    __metadata("design:paramtypes", [typeorm_1.DataSource,
-        session_identifier_job_1.SessionIdentifierJob])
-], SessionIdentifierSubscriber);
-//# sourceMappingURL=session.identifier.subscriber.js.map
+    __metadata("design:paramtypes", [typeorm_1.DataSource])
+], PropertySubscriber);
+//# sourceMappingURL=property.subscriber.js.map

package/dist/system/subscribers/property.subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property.subscriber.js","sourceRoot":"","sources":["../../../src/system/subscribers/property.subscriber.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAAgF;AAChF,gFAA4E;AAC5E,sEAAkE;AAClE,iEAA6D;AAQtD,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,oCAAgC;IACpE,YAA6B,UAAsB;QAC/C,KAAK,EAAE,CAAC;QADiB,eAAU,GAAV,UAAU,CAAY;QAE/C,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ;QACJ,OAAO,gCAAc,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAkC;QACjD,IAAI,KAAK,CAAC,MAAM,CAAC,YAAY;YAAE,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,0BAAW,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChG,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAgC;QAC/C,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,cAAc,CAAC,KAAK;YAAE,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,0BAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3I,CAAC;CACJ,CAAA;AAjBY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,yBAAe,GAAE;qCAE2B,oBAAU;GAD1C,kBAAkB,CAiB9B"}

package/dist/system/subscribers/recurring.query.subscriber.d.ts

@@ -0,0 +1,11 @@
+import { DataSource, InsertEvent, UpdateEvent } from 'typeorm';
+import { CommonSubscriber } from '../../common/libraries/common.subscriber';
+import { RecurringQueryEntity } from '../entities/recurring.query.entity';
+export declare class RecurringQuerySubscriber extends CommonSubscriber<RecurringQueryEntity> {
+    private readonly dataSource;
+    constructor(dataSource: DataSource);
+    listenTo(): typeof RecurringQueryEntity;
+    beforeInsert(event: InsertEvent<RecurringQueryEntity>): Promise<void>;
+    beforeUpdate(event: UpdateEvent<RecurringQueryEntity>): Promise<void>;
+    private validateTiming;
+}

package/dist/system/subscribers/recurring.query.subscriber.js

@@ -0,0 +1,53 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecurringQuerySubscriber = void 0;
+const date_fns_1 = require("date-fns");
+const typeorm_1 = require("typeorm");
+const form_exception_1 = require("../../common/exceptions/form.exception");
+const common_subscriber_1 = require("../../common/libraries/common.subscriber");
+const platform_utility_1 = require("../../common/libraries/platform.utility");
+const recurring_query_entity_1 = require("../entities/recurring.query.entity");
+let RecurringQuerySubscriber = class RecurringQuerySubscriber extends common_subscriber_1.CommonSubscriber {
+    constructor(dataSource) {
+        super();
+        this.dataSource = dataSource;
+        dataSource.subscribers.push(this);
+    }
+    listenTo() {
+        return recurring_query_entity_1.RecurringQueryEntity;
+    }
+    async beforeInsert(event) {
+        event.entity.attributes = {
+            ...event.entity.attributes,
+            ...{},
+        };
+        this.validateTiming(event.entity?.timing);
+        if (!event.entity.last_scheduled_time)
+            event.entity.last_scheduled_time = (0, date_fns_1.subMinutes)(new Date(), 15);
+    }
+    async beforeUpdate(event) {
+        this.validateTiming(event.entity?.timing);
+        if (!event.entity.last_scheduled_time)
+            event.entity.last_scheduled_time = (0, date_fns_1.subMinutes)(new Date(), 15);
+    }
+    validateTiming(timing) {
+        if (timing && !platform_utility_1.PlatformUtility.isValidCronExpression(timing)) {
+            throw new form_exception_1.FormException({ column: 'timing', err: `Invalid cron expression: ${timing}` });
+        }
+    }
+};
+exports.RecurringQuerySubscriber = RecurringQuerySubscriber;
+exports.RecurringQuerySubscriber = RecurringQuerySubscriber = __decorate([
+    (0, typeorm_1.EventSubscriber)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource])
+], RecurringQuerySubscriber);
+//# sourceMappingURL=recurring.query.subscriber.js.map

package/dist/system/subscribers/recurring.query.subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurring.query.subscriber.js","sourceRoot":"","sources":["../../../src/system/subscribers/recurring.query.subscriber.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,uCAAsC;AACtC,qCAAgF;AAChF,2EAAuE;AACvE,gFAA4E;AAC5E,8EAA0E;AAC1E,+EAA0E;AAOnE,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,oCAAsC;IAChF,YAA6B,UAAsB;QAC/C,KAAK,EAAE,CAAC;QADiB,eAAU,GAAV,UAAU,CAAY;QAE/C,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ;QACJ,OAAO,6CAAoB,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAwC;QACvD,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG;YACtB,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU;YAC1B,GAAG,EAAE;SACR,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,mBAAmB;YAAE,KAAK,CAAC,MAAM,CAAC,mBAAmB,GAAG,IAAA,qBAAU,EAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAwC;QACvD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,mBAAmB;YAAE,KAAK,CAAC,MAAM,CAAC,mBAAmB,GAAG,IAAA,qBAAU,EAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACzG,CAAC;IAEO,cAAc,CAAC,MAAiC;QACpD,IAAI,MAAM,IAAI,CAAC,kCAAe,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,8BAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,4BAA4B,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7F,CAAC;IACL,CAAC;CACJ,CAAA;AAhCY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,yBAAe,GAAE;qCAE2B,oBAAU;GAD1C,wBAAwB,CAgCpC"}

package/dist/system/subscribers/scheduled.event.subscriber.d.ts

@@ -0,0 +1,11 @@
+import { DataSource, InsertEvent, UpdateEvent } from 'typeorm';
+import { CommonSubscriber } from '../../common/libraries/common.subscriber';
+import { ScheduledEventEntity } from '../entities/scheduled.event.entity';
+export declare class ScheduledEventSubscriber extends CommonSubscriber<ScheduledEventEntity> {
+    private readonly dataSource;
+    constructor(dataSource: DataSource);
+    listenTo(): typeof ScheduledEventEntity;
+    beforeInsert(event: InsertEvent<ScheduledEventEntity>): Promise<void>;
+    beforeUpdate(event: UpdateEvent<ScheduledEventEntity>): Promise<void>;
+    private validateTiming;
+}

package/dist/system/subscribers/scheduled.event.subscriber.js

@@ -0,0 +1,53 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduledEventSubscriber = void 0;
+const date_fns_1 = require("date-fns");
+const typeorm_1 = require("typeorm");
+const form_exception_1 = require("../../common/exceptions/form.exception");
+const common_subscriber_1 = require("../../common/libraries/common.subscriber");
+const platform_utility_1 = require("../../common/libraries/platform.utility");
+const scheduled_event_entity_1 = require("../entities/scheduled.event.entity");
+let ScheduledEventSubscriber = class ScheduledEventSubscriber extends common_subscriber_1.CommonSubscriber {
+    constructor(dataSource) {
+        super();
+        this.dataSource = dataSource;
+        dataSource.subscribers.push(this);
+    }
+    listenTo() {
+        return scheduled_event_entity_1.ScheduledEventEntity;
+    }
+    async beforeInsert(event) {
+        event.entity.attributes = {
+            ...event.entity.attributes,
+            ...{},
+        };
+        this.validateTiming(event.entity?.timing);
+        if (!event.entity?.last_scheduled_time)
+            event.entity.last_scheduled_time = (0, date_fns_1.subMinutes)(new Date(), 15);
+    }
+    async beforeUpdate(event) {
+        this.validateTiming(event.entity?.timing);
+        if (!event.entity?.last_scheduled_time)
+            event.entity.last_scheduled_time = (0, date_fns_1.subMinutes)(new Date(), 15);
+    }
+    validateTiming(timing) {
+        if (timing && !platform_utility_1.PlatformUtility.isValidCronExpression(timing)) {
+            throw new form_exception_1.FormException({ column: 'timing', err: `Invalid cron expression: ${timing}` });
+        }
+    }
+};
+exports.ScheduledEventSubscriber = ScheduledEventSubscriber;
+exports.ScheduledEventSubscriber = ScheduledEventSubscriber = __decorate([
+    (0, typeorm_1.EventSubscriber)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource])
+], ScheduledEventSubscriber);
+//# sourceMappingURL=scheduled.event.subscriber.js.map

package/dist/system/subscribers/scheduled.event.subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled.event.subscriber.js","sourceRoot":"","sources":["../../../src/system/subscribers/scheduled.event.subscriber.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,uCAAsC;AACtC,qCAAgF;AAChF,2EAAuE;AACvE,gFAA4E;AAC5E,8EAA0E;AAC1E,+EAA0E;AAOnE,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,oCAAsC;IAChF,YAA6B,UAAsB;QAC/C,KAAK,EAAE,CAAC;QADiB,eAAU,GAAV,UAAU,CAAY;QAE/C,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ;QACJ,OAAO,6CAAoB,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAwC;QACvD,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG;YACtB,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU;YAC1B,GAAG,EAAE;SACR,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,mBAAmB;YAAE,KAAK,CAAC,MAAM,CAAC,mBAAmB,GAAG,IAAA,qBAAU,EAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAwC;QACvD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,mBAAmB;YAAE,KAAK,CAAC,MAAM,CAAC,mBAAmB,GAAG,IAAA,qBAAU,EAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1G,CAAC;IAEO,cAAc,CAAC,MAAiC;QACpD,IAAI,MAAM,IAAI,CAAC,kCAAe,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,8BAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,4BAA4B,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7F,CAAC;IACL,CAAC;CACJ,CAAA;AAhCY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,yBAAe,GAAE;qCAE2B,oBAAU;GAD1C,wBAAwB,CAgCpC"}

package/dist/system/system.module.js

@@ -22,7 +22,7 @@ exports.SystemModule = SystemModule = __decorate([
     (0, common_1.Module)({
         imports: [typeorm_1.TypeOrmModule.forFeature(es6_classes_1.default.entities), (0, common_1.forwardRef)(() => auth_module_1.AuthModule), (0, common_1.forwardRef)(() => platform_utility_module_1.PlatformUtilityModule)],
         controllers: es6_classes_1.default.controllers,
-        providers: [...es6_classes_1.default.services, ...es6_classes_1.default.jobs],
+        providers: [...es6_classes_1.default.services, ...es6_classes_1.default.subscribers, ...es6_classes_1.default.jobs],
         exports: [...es6_classes_1.default.services, ...es6_classes_1.default.jobs],
     })
 ], SystemModule);

package/dist/system/system.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.module.js","sourceRoot":"","sources":["../../src/system/system.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAoD;AACpD,qDAAiD;AACjD,wFAAmF;AACnF,gEAAuC;AACvC,6CAAgD;AAQzC,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IANxB,IAAA,eAAM,EAAC;QACJ,OAAO,EAAE,CAAC,uBAAa,CAAC,UAAU,CAAC,qBAAU,CAAC,QAAQ,CAAC,EAAE,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAU,CAAC,EAAE,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,+CAAqB,CAAC,CAAC;QAC/H,WAAW,EAAE,qBAAU,CAAC,WAAW;QACnC,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,YAAY,CAAG"}
+{"version":3,"file":"system.module.js","sourceRoot":"","sources":["../../src/system/system.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAoD;AACpD,qDAAiD;AACjD,wFAAmF;AACnF,gEAAuC;AACvC,6CAAgD;AAQzC,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IANxB,IAAA,eAAM,EAAC;QACJ,OAAO,EAAE,CAAC,uBAAa,CAAC,UAAU,CAAC,qBAAU,CAAC,QAAQ,CAAC,EAAE,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAU,CAAC,EAAE,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,+CAAqB,CAAC,CAAC;QAC/H,WAAW,EAAE,qBAAU,CAAC,WAAW;QACnC,SAAS,EAAE,CAAC,GAAG,qBAAU,CAAC,QAAQ,EAAE,GAAG,qBAAU,CAAC,WAAW,EAAE,GAAG,qBAAU,CAAC,IAAI,CAAC;QAClF,OAAO,EAAE,CAAC,GAAG,qBAAU,CAAC,QAAQ,EAAE,GAAG,qBAAU,CAAC,IAAI,CAAC;KACxD,CAAC;GACW,YAAY,CAAG"}

package/docs/subscribe-for.md

@@ -1,39 +1,221 @@
-# `@SubscribeFor` — multi-job entity bindings
+# Jobs & subscribers — guide for consuming apps
 
-`@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.
+This package (`@servicelabsco/nestjs-utility-services`, **NU**) owns many
+TypeORM entities and some platform jobs. Downstream apps (Expense, Access,
+etc.) often need extra side effects or pre-persist mutations on those
+entities — or on their own entities.
 
-## Multiple jobs per entity
+This doc is the **contract** for how to do that without fighting NU’s
+dispatcher or double-enqueuing work.
 
-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.
+---
+
+## Mental model
+
+| When | Where it lives | Mechanism |
+| --- | --- | --- |
+| Mutate the row **before** it hits the DB (hash secret, encrypt, validate cron, stamp defaults) | Standalone `*.subscriber.ts` extending `CommonSubscriber` | TypeORM `beforeInsert` / `beforeUpdate` |
+| Run **after** the row is saved (cache refresh, schedule event, sync counts, app-local side effects) | `CommonJob` with `@SubscribeFor(Entity)` | `DispatcherSubscriber` → `delayedDispatch` → `handle(DatabaseEventDto)` |
+| Ad-hoc / cron / webhook work **not** tied to an entity save | Plain `CommonJob` (no `@SubscribeFor`) | Call `job.dispatch(...)` / `delayedDispatch(...)` yourself |
+
+**Jobs are post-persist queue work. Subscribers own pre-persist mutation.**
+`DispatcherSubscriber` never calls job `beforeInsert` / `beforeUpdate`.
+
+```
+  entity.save()
+       │
+       ├─ beforeInsert / beforeUpdate     →  your CommonSubscriber (sync, in-transaction)
+       ├─ SQL INSERT / UPDATE
+       └─ afterInsert / afterUpdate       →  DispatcherSubscriber
+                                              └─ every @SubscribeFor(Entity) job
+                                                   delayedDispatch → BullMQ → handle()
+```
+
+---
+
+## What consuming apps should do
+
+### 1. Extra side effects on an NU entity (most common)
+
+NU already ships a job for many entities (e.g. `DocumentJob`, `PropertyJob`).
+You usually want **another** job for product-specific work — do **not** fork or
+wrap the platform job.
 
 ```ts
 import { Injectable } from '@nestjs/common';
-import { CommonJob, DatabaseEventDto, DocumentEntity, SubscribeFor } from '@servicelabsco/nestjs-utility-services';
+import {
+    CommonJob,
+    DatabaseEventDto,
+    DocumentEntity,
+    SubscribeFor,
+} from '@servicelabsco/nestjs-utility-services';
 
 @SubscribeFor(DocumentEntity)
 @Injectable()
 export class LocalDocumentJob extends CommonJob {
+    constructor(protected readonly queueService: QueueService /* + your deps */) {
+        super('<unique-32-char-md5-hash>'); // must be unique across the whole fleet
+    }
+
     async handle(evt: DatabaseEventDto<DocumentEntity>) {
-        // app-local side effects — do not wrap DocumentJob.handle
+        // tenant / product side effects only
+        // DocumentJob still runs separately via the same dispatcher fan-out
+    }
+}
+```
+
+**Register the job** as a Nest provider in your app module (or your module’s
+`es6.classes.ts` `jobs` array). If it is not in DI, boot fails when
+`DispatcherSubscriber` cannot resolve it.
+
+**Worker:** the process with `BULL_QUEUE_WORKER=true` must load the module that
+provides your job, or the queue will not find a handler for that hash.
+
+### 2. Pre-persist hooks on an NU (or local) entity
+
+Put them on a standalone subscriber. Do **not** put `beforeInsert` /
+`beforeUpdate` on a `@SubscribeFor` job — they will never run via the
+dispatcher.
+
+```ts
+import { DataSource, EventSubscriber, InsertEvent, UpdateEvent } from 'typeorm';
+import { CommonSubscriber } from '@servicelabsco/nestjs-utility-services';
+
+@EventSubscriber()
+export class LocalCredentialSubscriber extends CommonSubscriber<YourEntity> {
+    constructor(private readonly dataSource: DataSource) {
+        super();
+        dataSource.subscribers.push(this); // required so TypeORM sees the instance
+    }
+
+    listenTo() {
+        return YourEntity;
+    }
+
+    async beforeInsert(event: InsertEvent<YourEntity>) {
+        event.entity.secret = hash(event.entity.secret);
+    }
+
+    async beforeUpdate(event: UpdateEvent<YourEntity>) {
+        // …
     }
 }
 ```
 
-Register `LocalDocumentJob` as a Nest provider (your module’s `es6.classes` /
-providers). Each job keeps its own BullMQ hash / queue identity.
+Register the subscriber in your module `providers` (or `es6.classes.subscribers`).
+
+Coexistence with NU’s `@SubscribeFor` job on the same entity is **allowed**.
+Boot will not throw.
+
+### 3. Both mutation + post-persist for the same entity
+
+Use **both** files: subscriber for before*, job with `@SubscribeFor` for after*.
+
+```ts
+// ✅ subscriber — mutation only
+async beforeInsert(e) { e.entity.x = normalize(e.entity.x); }
+
+// ✅ job — @SubscribeFor(Entity), handle() only
+async handle(evt: DatabaseEventDto<Entity>) { await this.refreshCache(evt.entity); }
+```
+
+**Never** call `this.someSubscribeForJob.delayedDispatch(...)` from the
+standalone subscriber for a job that already has `@SubscribeFor` — that
+enqueues the same work twice.
+
+### 4. Your own entity (not from NU)
+
+Same rules:
+
+- Need queue work on insert/update → `@SubscribeFor(YourEntity)` on a `CommonJob`.
+- Need before* → standalone `CommonSubscriber`.
+- Need neither → no subscriber and no `@SubscribeFor` (plain services are enough).
+
+Do **not** create empty jobs that only `return evt.entity` — they still enqueue
+Bull work on every save.
+
+### 5. Manual / scheduled jobs (no entity binding)
+
+Omit `@SubscribeFor`. Dispatch explicitly:
+
+```ts
+await this.myJob.dispatch(payload);
+await this.myJob.delayedDispatch(payload, 5_000);
+```
+
+Keep a stable hash in `super('…')` and register the job in DI + worker like any
+other job.
+
+---
+
+## Wiring checklist (consuming app)
 
-### Behaviour
+1. **Import NU modules** your app needs (`AuthModule`, `SystemModule`,
+   `PlatformUtilityModule`, …) so `DispatcherSubscriber` and platform jobs load.
+2. **Provide** every `@SubscribeFor` job and every standalone subscriber in a
+   Nest module that the API **and** worker import.
+3. **Worker** (`BULL_QUEUE_WORKER=true`) must resolve the same job providers;
+   otherwise jobs enqueue but never run.
+4. **Hash** (`super('…')`) must be unique — collisions break `PlatformUtility.getJob`
+   / Bull routing.
+5. Prefer your app’s `es6.classes.ts` pattern if you use `slnu syncClassess`;
+   otherwise list classes in `@Module({ providers, exports })`.
+
+---
+
+## Behaviour reference
 
 | 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. |
+| `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. |
+| 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
+**first** when multiple jobs bind the same entity.
+
+---
+
+## Anti-patterns
+
+| Don’t | Do instead |
+| --- | --- |
+| Put `beforeInsert` on a `@SubscribeFor` job | Standalone `CommonSubscriber` |
+| `delayedDispatch` the same `@SubscribeFor` job from a subscriber | Let `DispatcherSubscriber` enqueue once |
+| Empty job (`handle` no-op / `return evt.entity`) “for later” | Omit the job until you have real work |
+| Subclass / re-export NU’s job just to add a line of logic | Second `@SubscribeFor` job in your app |
+| Forget to register the job on the worker | Import the same module in `worker` bootstrap |
+| Hand-roll a pass-through subscriber that only calls `entityJob.delayedDispatch` | `@SubscribeFor` on the job |
+
+---
 
-Platform modules usually load before the app, so NU’s job is typically first in
-the list when both bind the same entity.
+## What NU already owns (do not reimplement)
+
+Examples of platform post-persist jobs (non-exhaustive): document/comment count
+sync, property cache refresh, client-credential cache, credential IP cache,
+column/relationship mappers, user-group ACL sync, scheduled / recurring /
+material-view / code-fix scheduling.
+
+Examples of platform **pre-persist** subscribers: property encryption, client
+credential hashing, cron validation + defaults for scheduled events, recurring
+queries, material views, code-fix scripts.
+
+If NU already does the work you need, call its services or rely on its job —
+don’t duplicate with another empty or overlapping job.
+
+---
+
+## Quick decision tree
+
+```
+Need something on entity save?
+├─ Change fields before SQL?
+│    └─ CommonSubscriber + beforeInsert/beforeUpdate
+├─ Side effects after SQL?
+│    ├─ Already covered by an NU @SubscribeFor job?
+│    │    └─ Add your own @SubscribeFor job (fan-out) if product-specific
+│    └─ Else @SubscribeFor on a new CommonJob
+└─ Not tied to a save?
+     └─ CommonJob without @SubscribeFor; dispatch manually
+```

package/package.json

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

package/dist/auth/jobs/index.d.ts

@@ -1 +0,0 @@
-export * from './session.identifier.job';

package/dist/auth/jobs/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/jobs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAwC"}

package/dist/auth/jobs/session.identifier.job.d.ts

@@ -1,9 +0,0 @@
-import { DatabaseEventDto } from '../../common/dtos/database.event.dto';
-import { CommonJob } from '../../common/libraries/common.job';
-import { QueueService } from '../../platformUtility/services/queue.service';
-import { SessionIdentifierEntity } from '../entities/session.identifier.entity';
-export declare class SessionIdentifierJob extends CommonJob {
-    protected readonly queueService: QueueService;
-    constructor(queueService: QueueService);
-    handle(evt: DatabaseEventDto<SessionIdentifierEntity>): Promise<SessionIdentifierEntity>;
-}

package/dist/auth/jobs/session.identifier.job.js

@@ -1,30 +0,0 @@
-"use strict";
-var __decorate = (this && this.__decorate) || function (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;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionIdentifierJob = void 0;
-const common_1 = require("@nestjs/common");
-const common_job_1 = require("../../common/libraries/common.job");
-const queue_service_1 = require("../../platformUtility/services/queue.service");
-let SessionIdentifierJob = class SessionIdentifierJob extends common_job_1.CommonJob {
-    constructor(queueService) {
-        super('29692aaae7ba9e4217568e6c4ba3b36c');
-        this.queueService = queueService;
-    }
-    async handle(evt) {
-        return evt.entity;
-    }
-};
-exports.SessionIdentifierJob = SessionIdentifierJob;
-exports.SessionIdentifierJob = SessionIdentifierJob = __decorate([
-    (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [queue_service_1.QueueService])
-], SessionIdentifierJob);
-//# sourceMappingURL=session.identifier.job.js.map

package/dist/auth/jobs/session.identifier.job.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.identifier.job.js","sourceRoot":"","sources":["../../../src/auth/jobs/session.identifier.job.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAE5C,kEAA8D;AAC9D,gFAA4E;AAGrE,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,sBAAS;IAC/C,YAA+B,YAA0B;QACrD,KAAK,CAAC,kCAAkC,CAAC,CAAC;QADf,iBAAY,GAAZ,YAAY,CAAc;IAEzD,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,GAA8C;QACvD,OAAO,GAAG,CAAC,MAAM,CAAC;IACtB,CAAC;CACJ,CAAA;AAPY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAEoC,4BAAY;GADhD,oBAAoB,CAOhC"}

package/dist/auth/services/es6.jobs.service.d.ts

@@ -1,8 +0,0 @@
-import { SessionIdentifierJob } from '../jobs/session.identifier.job';
-export declare class Es6JobsService {
-    private readonly sessionIdentifierJob;
-    private jobs;
-    constructor(sessionIdentifierJob: SessionIdentifierJob);
-    alignJobs(): void;
-    setJobs(): void;
-}