@servicelabsco/nestjs-utility-services 3.0.8 → 3.0.10

package/CHANGELOG.md

@@ -1,5 +1,90 @@
 # Changelog
 
+## 3.0.9
+
+### Added
+
+- **`@CacheMethod()` — cache an async method's result through `CacheService` in one line.**
+  Replaces the hand-written get → miss → load → set block:
+
+  ```ts
+  @CacheMethod({ key: (identifier: string) => `inbound.webhook.${identifier}.key`, ttlMinutes: 10 })
+  protected async identifyWebhook(identifier: string): Promise<InboundWebhookEntity | null> {
+      return InboundWebhookEntity.findOne({ where: { identifier } });
+  }
+  ```
+
+  - hit → the cached value is returned without running the method (`0` / `false` / `''` count
+    as hits); an optional `hydrate: (raw) => MyEntity.create(raw)` restores class instances,
+    since cached values round-trip through JSON;
+  - miss → the method runs and a non-null result is cached for `ttlMinutes`; `null` /
+    `undefined` is not cached;
+  - `key` receives the method's arguments (type-checked against them) with `this` bound to the
+    instance; keys are the same strings `CacheService.get/set/delete` take, so existing
+    hand-written caches keep their entries and `cacheService.delete(key)` evicts;
+  - `CacheService` installs itself as the store (`CacheMethod.useCache(this)`), so the decorator
+    works on DI services and plain `new`-ed library classes alike. Without it (unit tests, apps
+    without `CacheService`) the method runs uncached; a failed cache write is logged and the
+    fresh result returned.
+
+- **`@WhenColumnUpdated()` — the `isColumnUpdated` guard of a `CommonJob` database-event
+  handler as a decorator.**
+
+  ```ts
+  @WhenColumnUpdated(['active', 'deleted_at'])
+  async refreshCacheKey(evt: DatabaseEventDto<ClientCredentialEntity>) {
+      await this.clientCredentialService.setCredentialCache(evt.entity.identifier);
+  }
+  ```
+
+  - runs for inserts and for updates touching any listed column (exactly `isColumnUpdated`);
+    otherwise skipped, resolving to `undefined`; all arguments are forwarded;
+  - compile-time checked: only on `CommonJob` methods whose first parameter is a
+    `DatabaseEventDto<Entity>`, and every column must be a property of `Entity` (a typo fails
+    with `unknownColumns: "<name>"`); the `CommonJob` requirement is also enforced at class
+    definition.
+  - `ClientCredentialJob.refreshCacheKey` uses it.
+
+- **`@WhenNewRecord()` — the `isNewRecord` guard as a decorator.** The method runs only for a
+  newly created record (no / empty `databaseEntity`); updates resolve to `undefined`. Same
+  compile-time and class-definition checks as `@WhenColumnUpdated()` (`CommonJob` methods,
+  first parameter a `DatabaseEventDto`). `ClientCredentialJob.setKey` uses it.
+
+### Changed
+
+- **nu no longer ships generated registry files.** `LocalPropertyService` stops registering entities
+  from `config/entity.constants.ts`, and that file plus `platformUtility/` and
+  `system/services/es6.jobs.service.ts` (`Es6JobsService`) are gone: `PlatformRegistryService`
+  (3.0.8) derives the same entity and job hashes from TypeORM metadata and the Nest container.
+  `PlatformUtility.getEntity` / `getJob` / `getService` and `setEntities` / `setJobs` /
+  `setServices` are unchanged, so consumers that still register explicitly keep working.
+- Generated with `@servicelabsco/slabs-dev-cli` ≥ 1.0.14, which stops emitting these files for any
+  repo on nu ≥ 3.0.8 and always emits the core `controllers` / `entities` / `jobs` / `services` /
+  `subscribers` keys in `es6.classes.ts`.
+
+### Fixed
+
+- **`CommonSubscriber` no longer reports equal-but-differently-typed values as updated columns.**
+  TypeORM's `updatedColumns` normalises timestamps and json but compares everything else with
+  `===`; the re-check now compares by column type, reading the `ColumnMetadata` TypeORM passes
+  (no per-column `findColumnWithPropertyName` scan or `type.toString()`):
+  - decimals (`float`, `numeric`, `decimal`, `real`, ...) by value, rounded to `scale` when set —
+    `'12.50'` vs `12.5`, float noise below the scale; a `float` without a scale compared exactly
+    (previously `10 ** undefined` = `NaN`, so it was never normalised);
+  - integers (`Number`, `int`, `bigint`, ...) by value, BigInt-safe — `'5'` vs `5`, pg `bigint`
+    strings;
+  - booleans by the literals Postgres accepts — `'false'` / `'f'` / `0` vs `false`, `'yes'` / `1`
+    vs `true` (previously `'false'` counted as changed); an unrecognised value stays changed;
+  - `date` columns by calendar date — an ISO string or `Date` vs the stored `YYYY-MM-DD`.
+
+  Backward compatible: `float`, `Number` and `Boolean` columns (the types normalised before) keep
+  the `value || 0` / `value || false` rule exactly (`null` / `''` / `NaN` equal `0` / `false`);
+  newly normalised types treat `null` as distinct, and exact types beyond double precision are
+  compared as text. A differential run of old vs new over 3,336 value pairs across every column
+  type found no case where a column the old code treated as unchanged is now reported; every
+  difference is an equal value in another form. Any other column TypeORM reports (text,
+  timestamps, json, ...) is kept as before.
+
 ## 3.0.8
 
 ### Changed

package/README.md

@@ -149,10 +149,13 @@ yarn m:rev              # revert last
 **Commit helper:** `yarn save` → `commit.sh` (pull, optional build / `syncClassess`,
 format, commit message with JIRA id from branch name).
 
-**Publish:** regenerate barrels (`slnu` / `scan.index`), `yarn build`, then publish.
-`prepublishOnly` requires `dist/index.js` and `dist/index.d.ts`. Prefer
-`npm publish --otp=…` if Yarn’s publish + 2FA mis-reports success; npm may stage
-versions for malware scanning for a few minutes before they appear on the site.
+**Publish:** regenerate barrels (`slnu` / `scan.index`), `yarn build`, then
+`yarn publish:npm -- --otp=…` (preferred) or `npm publish --otp=…`.
+`prepublishOnly` checks `dist/index.js` / `dist/index.d.ts`. **`postpublish` /
+`yarn wait:npm`** polls until `dist-tags.latest` matches `package.json`. Full
+CLI + wait output is written under **`logs/publish/`** (gitignored); open
+`logs/publish/latest.log` when debugging a sticky or false publish. Tunables:
+`NPM_WAIT_TIMEOUT_MS` / `NPM_WAIT_INTERVAL_MS`.
 
 ---
 

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

@@ -30,10 +30,12 @@ import { SocialService } from './services/social.service';
 import { UserService } from './services/user.service';
 declare const es6Classes: {
     controllers: (typeof AdminAuthController | typeof SocialController | typeof UserController)[];
-    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)[];
+    dtos: (typeof UserRolesAccessObjectDto | typeof PermissionAssignmentDto | typeof RoleAssignmentDto | typeof UserLoginDto | typeof SessionIdentifierAttributesDto | typeof CreateUserDto | typeof OfflineUserDto | typeof UpdateUserDto)[];
+    entities: (typeof CreatorEntity | typeof UserReferralEntity | typeof DeviceTokenEntity | typeof RefreshTokenEntity | typeof SessionIdentifierEntity | typeof SocialIdentityEntity | typeof CountryEntity)[];
     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,8 +58,10 @@ 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: [],
 };
 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,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"}
+{"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,CAAC,8BAAa,EAAE,0BAAW,EAAE,yCAAkB,EAAE,2CAAmB,EAAE,+CAAqB,EAAE,8BAAa,EAAE,0BAAW,CAAC;IAClI,WAAW,EAAE,EAAE;CAClB,CAAC;AAEF,kBAAe,UAAU,CAAC"}

package/dist/common/decorators/cache.method.decorator.d.ts

@@ -0,0 +1,11 @@
+import type { MethodCacheInterface } from '../interfaces/method.cache.interface';
+export interface CacheMethodOptions<A extends any[] = any[], R = any> {
+    key: (this: any, ...args: A) => string;
+    ttlMinutes: number;
+    hydrate?: (raw: any) => R;
+}
+export declare function CacheMethod<A extends any[], R>(options: CacheMethodOptions<A, R>): (_target: object, _propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(...args: A) => Promise<R>>) => TypedPropertyDescriptor<(...args: A) => Promise<R>>;
+export declare namespace CacheMethod {
+    var useCache: (cache?: MethodCacheInterface) => void;
+}
+export { CacheMethod as CacheMethodDecorator };

package/dist/common/decorators/cache.method.decorator.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheMethod = CacheMethod;
+exports.CacheMethodDecorator = CacheMethod;
+const custom_logger_1 = require("../libraries/custom.logger");
+let store;
+function CacheMethod(options) {
+    if (!(options.ttlMinutes > 0))
+        throw new Error(`@CacheMethod: ttlMinutes must be > 0, got ${options.ttlMinutes}`);
+    return (_target, _propertyKey, descriptor) => {
+        const original = descriptor.value;
+        descriptor.value = async function (...args) {
+            const cache = store;
+            if (!cache)
+                return original.apply(this, args);
+            const key = options.key.apply(this, args);
+            const cached = await cache.get(key, null);
+            if (cached !== null && cached !== undefined)
+                return options.hydrate ? options.hydrate(cached) : cached;
+            const result = await original.apply(this, args);
+            if (result === null || result === undefined)
+                return result;
+            try {
+                await cache.set(key, result, new Date(Date.now() + options.ttlMinutes * 60_000));
+            }
+            catch (error) {
+                custom_logger_1.CustomLogger.error(`@CacheMethod: caching failed for key=${key}; returning uncached result`, error);
+            }
+            return result;
+        };
+        return descriptor;
+    };
+}
+CacheMethod.useCache = (cache) => {
+    store = cache;
+};
+//# sourceMappingURL=cache.method.decorator.js.map

package/dist/common/decorators/cache.method.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.method.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/cache.method.decorator.ts"],"names":[],"mappings":";;AAqDA,kCAiCC;AAauB,2CAAoB;AAnG5C,8DAA0D;AAuB1D,IAAI,KAAuC,CAAC;AA8B5C,SAAgB,WAAW,CAAqB,OAAiC;IAC7E,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAElH,OAAO,CACH,OAAe,EACf,YAA6B,EAC7B,UAA+D,EACZ,EAAE;QACrD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC;QAElC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAsB,GAAG,IAAO;YACpD,MAAM,KAAK,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC,KAAK;gBAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAE9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAE1C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAEvG,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC;YAE3D,IAAI,CAAC;gBACD,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC;YACrF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,4BAAY,CAAC,KAAK,CAAC,wCAAwC,GAAG,6BAA6B,EAAE,KAAK,CAAC,CAAC;YACxG,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC;AAQD,WAAW,CAAC,QAAQ,GAAG,CAAC,KAA4B,EAAQ,EAAE;IAC1D,KAAK,GAAG,KAAK,CAAC;AAClB,CAAC,CAAC"}

package/dist/common/decorators/index.d.ts

@@ -1 +1,4 @@
+export * from './cache.method.decorator';
 export * from './public.exposed.decorator';
+export * from './when.column.updated.decorator';
+export * from './when.new.record.decorator';

package/dist/common/decorators/index.js

@@ -14,5 +14,8 @@ 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("./cache.method.decorator"), exports);
 __exportStar(require("./public.exposed.decorator"), exports);
+__exportStar(require("./when.column.updated.decorator"), exports);
+__exportStar(require("./when.new.record.decorator"), exports);
 //# sourceMappingURL=index.js.map

package/dist/common/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA0C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AAAA,6DAA2C;AAAA,kEAAgD;AAAA,8DAA2C"}

package/dist/common/decorators/when.column.updated.decorator.d.ts

@@ -0,0 +1,8 @@
+import type { DatabaseEventDto } from '../dtos/database.event.dto';
+import { CommonJob } from '../libraries/common.job';
+type DatabaseEventMethod<E> = (evt: DatabaseEventDto<E>, ...rest: any[]) => Promise<any>;
+type KnownColumns<E, C extends string> = [Exclude<C, keyof E>] extends [never] ? unknown : {
+    unknownColumns: Exclude<C, keyof E>;
+};
+export declare function WhenColumnUpdated<C extends string>(columns: C | C[]): <E>(target: CommonJob, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<DatabaseEventMethod<E>> & KnownColumns<E, C>) => void;
+export { WhenColumnUpdated as WhenColumnUpdatedDecorator };

package/dist/common/decorators/when.column.updated.decorator.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhenColumnUpdated = WhenColumnUpdated;
+exports.WhenColumnUpdatedDecorator = WhenColumnUpdated;
+const common_job_1 = require("../libraries/common.job");
+function WhenColumnUpdated(columns) {
+    const list = Array.isArray(columns) ? columns : [columns];
+    if (!list.length)
+        throw new Error('@WhenColumnUpdated: pass at least one column');
+    return (target, propertyKey, descriptor) => {
+        if (!(target instanceof common_job_1.CommonJob)) {
+            throw new Error(`@WhenColumnUpdated: ${String(propertyKey)} must be a method of a CommonJob subclass`);
+        }
+        const original = descriptor.value;
+        descriptor.value = async function (evt, ...rest) {
+            if (!this['isColumnUpdated'](evt, list))
+                return undefined;
+            return original.apply(this, [evt, ...rest]);
+        };
+    };
+}
+//# sourceMappingURL=when.column.updated.decorator.js.map

package/dist/common/decorators/when.column.updated.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"when.column.updated.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/when.column.updated.decorator.ts"],"names":[],"mappings":";;AAuCA,8CAqBC;AAG6B,uDAA0B;AA9DxD,wDAAoD;AAsCpD,SAAgB,iBAAiB,CAAmB,OAAgB;IAChE,MAAM,IAAI,GAAa,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAElF,OAAO,CACH,MAAiB,EACjB,WAA4B,EAC5B,UAAgF,EAC5E,EAAE;QACN,IAAI,CAAC,CAAC,MAAM,YAAY,sBAAS,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,WAAW,CAAC,2CAA2C,CAAC,CAAC;QAC3G,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC;QAElC,UAAU,CAAC,KAAK,GAAG,KAAK,WAA4B,GAAwB,EAAE,GAAG,IAAW;YACxF,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YAE1D,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}

package/dist/common/decorators/when.new.record.decorator.d.ts

@@ -0,0 +1,5 @@
+import type { DatabaseEventDto } from '../dtos/database.event.dto';
+import { CommonJob } from '../libraries/common.job';
+type DatabaseEventMethod<E> = (evt: DatabaseEventDto<E>, ...rest: any[]) => Promise<any>;
+export declare function WhenNewRecord(): <E>(target: CommonJob, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<DatabaseEventMethod<E>>) => void;
+export { WhenNewRecord as WhenNewRecordDecorator };

package/dist/common/decorators/when.new.record.decorator.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhenNewRecord = WhenNewRecord;
+exports.WhenNewRecordDecorator = WhenNewRecord;
+const common_job_1 = require("../libraries/common.job");
+function WhenNewRecord() {
+    return (target, propertyKey, descriptor) => {
+        if (!(target instanceof common_job_1.CommonJob)) {
+            throw new Error(`@WhenNewRecord: ${String(propertyKey)} must be a method of a CommonJob subclass`);
+        }
+        const original = descriptor.value;
+        descriptor.value = async function (evt, ...rest) {
+            if (!this['isNewRecord'](evt))
+                return undefined;
+            return original.apply(this, [evt, ...rest]);
+        };
+    };
+}
+//# sourceMappingURL=when.new.record.decorator.js.map

package/dist/common/decorators/when.new.record.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"when.new.record.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/when.new.record.decorator.ts"],"names":[],"mappings":";;AA6BA,sCAcC;AAGyB,+CAAsB;AA7ChD,wDAAoD;AA4BpD,SAAgB,aAAa;IACzB,OAAO,CAAI,MAAiB,EAAE,WAA4B,EAAE,UAA2D,EAAQ,EAAE;QAC7H,IAAI,CAAC,CAAC,MAAM,YAAY,sBAAS,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,WAAW,CAAC,2CAA2C,CAAC,CAAC;QACvG,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC;QAElC,UAAU,CAAC,KAAK,GAAG,KAAK,WAA4B,GAAwB,EAAE,GAAG,IAAW;YACxF,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAC;YAEhD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}

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

@@ -1,5 +1,7 @@
 import { RedisIoAdapter } from './adapters/redis.io.adapter';
+import { CacheMethodDecorator } from './decorators/cache.method.decorator';
 import { PublicExposedDecorator } from './decorators/public.exposed.decorator';
+import { WhenColumnUpdatedDecorator } from './decorators/when.column.updated.decorator';
 import { AggregationParamDto } from './dtos/aggregation.param.dto';
 import { CaptureRecordIndexDto } from './dtos/capture.record.index.dto';
 import { CaptureRecordShowDto } from './dtos/capture.record.show.dto';
@@ -43,10 +45,13 @@ declare const es6Classes: {
         DEFAULT_ADMIN: number;
         INTERNAL: number;
     })[];
-    decorators: (typeof PublicExposedDecorator)[];
+    controllers: any[];
+    decorators: (typeof CacheMethodDecorator | typeof PublicExposedDecorator | typeof WhenColumnUpdatedDecorator)[];
     dtos: (typeof MetaDataDto | typeof DatabaseEventDto | typeof LayoutColumnDbDto | typeof GenericIndexParamDto | typeof RecordDataManagerDto | typeof RecordTabDto | typeof AggregationParamDto | typeof GroupParamDto | typeof ReportBodyDto | typeof ReportDataManagerDto | typeof CaptureRecordIndexDto | typeof CaptureRecordShowDto | typeof ForeignMigrationDto | typeof GenericShowParamDto | typeof IndexColumnDto | typeof JsonFieldConditionDto | typeof KeyValueParamDto | typeof RenameColumnDto)[];
+    entities: any[];
     exceptions: (typeof NoLoggedUserException)[];
     interfaces: any[];
+    jobs: any[];
     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;
         jobsFor(entity: new (...args: any[]) => any): (new (...args: any[]) => any)[];
@@ -54,5 +59,7 @@ declare const es6Classes: {
         size(): number;
         clear(): void;
     } | typeof BaseMigrationUtility | typeof CommonConsumer | typeof DatabaseEventEvaluator | typeof Money | typeof SeederUtility)[];
+    services: any[];
+    subscribers: any[];
 };
 export default es6Classes;

package/dist/common/es6.classes.js

@@ -3,7 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const redis_io_adapter_1 = require("./adapters/redis.io.adapter");
 const role_constants_1 = require("./constants/role.constants");
 const user_constants_1 = require("./constants/user.constants");
+const cache_method_decorator_1 = require("./decorators/cache.method.decorator");
 const public_exposed_decorator_1 = require("./decorators/public.exposed.decorator");
+const when_column_updated_decorator_1 = require("./decorators/when.column.updated.decorator");
+const when_new_record_decorator_1 = require("./decorators/when.new.record.decorator");
 const aggregation_param_dto_1 = require("./dtos/aggregation.param.dto");
 const capture_record_index_dto_1 = require("./dtos/capture.record.index.dto");
 const capture_record_show_dto_1 = require("./dtos/capture.record.show.dto");
@@ -70,7 +73,8 @@ const subscriber_registry_1 = require("./libraries/subscriber.registry");
 const es6Classes = {
     adapters: [redis_io_adapter_1.RedisIoAdapter],
     constants: [role_constants_1.RoleConstants, user_constants_1.UserConstants],
-    decorators: [public_exposed_decorator_1.PublicExposedDecorator],
+    controllers: [],
+    decorators: [cache_method_decorator_1.CacheMethodDecorator, public_exposed_decorator_1.PublicExposedDecorator, when_column_updated_decorator_1.WhenColumnUpdatedDecorator, when_new_record_decorator_1.WhenNewRecordDecorator],
     dtos: [
         aggregation_param_dto_1.AggregationParamDto,
         capture_record_index_dto_1.CaptureRecordIndexDto,
@@ -94,6 +98,7 @@ const es6Classes = {
         report_body_dto_1.ReportBodyDto,
         report_data_manager_dto_1.ReportDataManagerDto,
     ],
+    entities: [],
     exceptions: [
         access_exception_1.AccessException,
         form_exception_1.FormException,
@@ -104,6 +109,7 @@ const es6Classes = {
         too_many_attempts_exception_1.TooManyAttemptsException,
     ],
     interfaces: [],
+    jobs: [],
     libraries: [
         auth_1.Auth,
         base_migration_utility_1.BaseMigrationUtility,
@@ -141,6 +147,8 @@ const es6Classes = {
         sentry_sdk_1.SentrySdk,
         subscriber_registry_1.SubscriberRegistry,
     ],
+    services: [],
+    subscribers: [],
 };
 exports.default = es6Classes;
 //# sourceMappingURL=es6.classes.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"es6.classes.js","sourceRoot":"","sources":["../../src/common/es6.classes.ts"],"names":[],"mappings":";;AAAA,kEAA6D;AAC7D,+DAA2D;AAC3D,+DAA2D;AAC3D,oFAA+E;AAC/E,wEAAmE;AACnE,8EAAwE;AACxE,4EAAsE;AACtE,kEAA6D;AAC7D,wEAAmE;AACnE,4EAAsE;AACtE,0EAAoE;AACpE,4DAAuD;AACvD,8DAAyD;AACzD,8DAAyD;AACzD,oFAA8E;AAC9E,8EAAwE;AACxE,oEAA8D;AAC9D,oEAA8D;AAC9D,sEAAgE;AAChE,wDAAmD;AACnD,4EAAsE;AACtE,0DAAqD;AACrD,gEAA2D;AAC3D,4DAAuD;AACvD,4EAAsE;AACtE,oEAAgE;AAChE,gEAA4D;AAC5D,8EAA0E;AAC1E,oFAA8E;AAC9E,0EAAsE;AACtE,gFAA4E;AAC5E,0FAAoF;AACpF,2CAAwC;AACxC,+EAA0E;AAC1E,iEAA6D;AAC7D,2DAAuD;AACvD,iEAA6D;AAC7D,6DAAyD;AACzD,uDAAmD;AACnD,qEAAgE;AAChE,yEAAoE;AACpE,+DAA2D;AAC3D,qEAAiE;AACjE,2DAAuD;AACvD,6DAAyD;AACzD,2DAAuD;AACvD,mFAA8E;AAC9E,qDAAiD;AACjD,uFAAkF;AAClF,mEAA+D;AAC/D,2EAAsE;AACtE,yEAAoE;AACpE,2CAAwC;AACxC,+DAA2D;AAC3D,2DAAuD;AACvD,2DAAuD;AACvD,qEAAiE;AACjE,6CAA0C;AAC1C,mEAA+D;AAC/D,+DAA2D;AAC3D,uEAAkE;AAClE,yEAAoE;AACpE,yEAAoE;AACpE,qFAAgF;AAChF,+DAA2D;AAC3D,uDAAmD;AACnD,yEAAqE;AAErE,MAAM,UAAU,GAAG;IACf,QAAQ,EAAE,CAAC,iCAAc,CAAC;IAC1B,SAAS,EAAE,CAAC,8BAAa,EAAE,8BAAa,CAAC;IACzC,UAAU,EAAE,CAAC,iDAAsB,CAAC;IACpC,IAAI,EAAE;QACF,2CAAmB;QACnB,gDAAqB;QACrB,8CAAoB;QACpB,qCAAgB;QAChB,2CAAmB;QACnB,8CAAoB;QACpB,4CAAmB;QACnB,+BAAa;QACb,iCAAc;QACd,iCAAc;QACd,sDAAwB;QACxB,gDAAqB;QACrB,sCAAgB;QAChB,sCAAgB;QAChB,wCAAiB;QACjB,2BAAW;QACX,8CAAoB;QACpB,6BAAY;QACZ,mCAAe;QACf,+BAAa;QACb,8CAAoB;KACvB;IACD,UAAU,EAAE;QACR,kCAAe;QACf,8BAAa;QACb,4CAAoB;QACpB,gDAAqB;QACrB,wCAAkB;QAClB,8CAAqB;QACrB,sDAAwB;KAC3B;IACD,UAAU,EAAE,EAAE;IACd,SAAS,EAAE;QACP,WAAI;QACJ,6CAAoB;QACpB,gCAAc;QACd,0BAAW;QACX,gCAAc;QACd,4BAAY;QACZ,sBAAS;QACT,mCAAe;QACf,uCAAiB;QACjB,8BAAa;QACb,oCAAgB;QAChB,0BAAW;QACX,4BAAY;QACZ,0BAAW;QACX,iDAAsB;QACtB,oBAAQ;QACR,qDAAwB;QACxB,kCAAe;QACf,yCAAkB;QAClB,uCAAiB;QACjB,WAAI;QACJ,8BAAa;QACb,0BAAW;QACX,0BAAW;QACX,oCAAgB;QAChB,aAAK;QACL,kCAAe;QACf,8BAAa;QACb,qCAAgB;QAChB,uCAAiB;QACjB,uCAAiB;QACjB,mDAAuB;QACvB,8BAAa;QACb,sBAAS;QACT,wCAAkB;KACrB;CACJ,CAAC;AAEF,kBAAe,UAAU,CAAC"}
+{"version":3,"file":"es6.classes.js","sourceRoot":"","sources":["../../src/common/es6.classes.ts"],"names":[],"mappings":"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"}

package/dist/common/interfaces/index.d.ts

@@ -1 +1,3 @@
+export * from './method.cache.interface';
 export * from './platform.registry.resolver.interface';
+export * from './updated.column.interface';

package/dist/common/interfaces/index.js

@@ -14,5 +14,7 @@ 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("./method.cache.interface"), exports);
 __exportStar(require("./platform.registry.resolver.interface"), exports);
+__exportStar(require("./updated.column.interface"), exports);
 //# sourceMappingURL=index.js.map

package/dist/common/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yEAAsD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AAAA,yEAAuD;AAAA,6DAA0C"}

package/dist/common/interfaces/method.cache.interface.d.ts

@@ -0,0 +1,4 @@
+export interface MethodCacheInterface {
+    get(key: string, defaultValue?: any): Promise<any>;
+    set(key: string, value: any, expiresAt?: Date): Promise<any>;
+}

package/dist/common/interfaces/method.cache.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=method.cache.interface.js.map

package/dist/common/interfaces/method.cache.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.cache.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/method.cache.interface.ts"],"names":[],"mappings":""}

package/dist/common/interfaces/platform.registry.resolver.interface.d.ts

@@ -2,4 +2,7 @@ export interface PlatformRegistryResolverInterface {
     entity(hash: string): any;
     job(hash: string): any;
     service(hash: string): any;
+    entityHashes?(): string[];
+    jobHashes?(): string[];
+    serviceHashes?(): string[];
 }

package/dist/common/interfaces/updated.column.interface.d.ts

@@ -0,0 +1,7 @@
+export interface UpdatedColumnInterface {
+    databaseName: string;
+    type: unknown;
+    scale?: number;
+    utc?: boolean;
+    getEntityValue(entity: object): any;
+}

package/dist/common/interfaces/updated.column.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=updated.column.interface.js.map

package/dist/common/interfaces/updated.column.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updated.column.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/updated.column.interface.ts"],"names":[],"mappings":""}

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

@@ -19,11 +19,22 @@ export declare class CommonSubscriber<T> implements EntitySubscriberInterface<T>
     protected getInsertEventData(event: any): DatabaseEventDto<T>;
     private getMetadata;
     private isMongoEntity;
+    private static readonly DECIMAL_TYPES;
+    private static readonly INTEGER_TYPES;
+    private static readonly BOOLEAN_TYPES;
+    private static readonly LEGACY_EMPTY_AS_ZERO_TYPES;
+    private static readonly TRUE_LITERALS;
+    private static readonly FALSE_LITERALS;
     private getUpdatedRecords;
-    private normalizeUpdatedColumns;
-    private handleFloatColumn;
-    private handleNumberColumn;
-    private handleBooleanColumn;
+    private isValueChanged;
+    private isDecimalChanged;
+    private isIntegerChanged;
+    private isBooleanChanged;
+    private isEmpty;
+    private toNumber;
+    private toBigInt;
+    private toBoolean;
+    private toDateString;
     afterRemove(_event: RemoveEvent<T>): Promise<void>;
     isColumnUpdated(event: any, column: any): boolean;
     isNewRecord(event: any): boolean;