@servicelabsco/nestjs-utility-services 3.0.8 → 3.0.9

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/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/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;

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

@@ -101,43 +101,129 @@ class CommonSubscriber {
         return name === 'mongodb';
     }
     getUpdatedRecords(event) {
-        const updates = [];
         if (!Array.isArray(event?.updatedColumns))
-            return updates;
-        event.updatedColumns.forEach((column) => {
-            if (updates.indexOf(column.databaseName) === -1 && this.normalizeUpdatedColumns(event, column.databaseName))
-                updates.push(column.databaseName);
-        });
-        return updates.filter((item) => item !== '_id');
-    }
-    normalizeUpdatedColumns(event, column) {
-        const metadata = event.metadata.findColumnWithPropertyName(column);
-        const type = metadata?.type?.toString();
-        if (type === 'float')
-            return this.handleFloatColumn(event, column, metadata.scale);
-        if (type === 'function Number() { [native code] }')
-            return this.handleNumberColumn(event, column);
-        if (type === 'function Boolean() { [native code] }')
-            return this.handleBooleanColumn(event, column);
+            return [];
+        const updates = new Set();
+        for (const column of event.updatedColumns) {
+            const name = column?.databaseName;
+            if (!name || name === '_id' || updates.has(name))
+                continue;
+            if (this.isValueChanged(event, column))
+                updates.add(name);
+        }
+        return [...updates];
+    }
+    isValueChanged(event, column) {
+        if (!event.databaseEntity || !event.entity || typeof column.getEntityValue !== 'function')
+            return true;
+        const before = column.getEntityValue(event.databaseEntity);
+        const after = column.getEntityValue(event.entity);
+        const emptyAsZero = CommonSubscriber.LEGACY_EMPTY_AS_ZERO_TYPES.has(column.type);
+        if (CommonSubscriber.DECIMAL_TYPES.has(column.type))
+            return this.isDecimalChanged(before, after, emptyAsZero, column.scale);
+        if (CommonSubscriber.INTEGER_TYPES.has(column.type))
+            return this.isIntegerChanged(before, after, emptyAsZero);
+        if (CommonSubscriber.BOOLEAN_TYPES.has(column.type))
+            return this.isBooleanChanged(before, after, emptyAsZero);
+        if (column.type === 'date')
+            return this.toDateString(before, column.utc) !== this.toDateString(after, column.utc);
         return true;
     }
-    handleFloatColumn(event, column, scale) {
-        const original = event.databaseEntity[column] || 0;
-        const updated = event.entity[column] || 0;
-        const factor = Math.pow(10, scale);
-        const originalRounded = Math.round(original * factor) / factor;
-        const updatedRounded = Math.round(updated * factor) / factor;
-        return originalRounded !== updatedRounded;
+    isDecimalChanged(before, after, emptyAsZero, scale) {
+        if (emptyAsZero) {
+            before = before || 0;
+            after = after || 0;
+        }
+        else if (this.isEmpty(before) || this.isEmpty(after))
+            return before !== after;
+        const a = this.toNumber(before);
+        const b = this.toNumber(after);
+        if (Number.isNaN(a) || Number.isNaN(b))
+            return before !== after;
+        const factor = scale === undefined || scale === null ? 1 : 10 ** scale;
+        const scaledA = a * factor;
+        const scaledB = b * factor;
+        if (!emptyAsZero && (Math.abs(scaledA) > Number.MAX_SAFE_INTEGER || Math.abs(scaledB) > Number.MAX_SAFE_INTEGER)) {
+            return String(before).trim() !== String(after).trim();
+        }
+        if (factor === 1 && (scale === undefined || scale === null))
+            return a !== b;
+        return Math.round(scaledA) !== Math.round(scaledB);
+    }
+    isIntegerChanged(before, after, emptyAsZero) {
+        if (emptyAsZero) {
+            before = before || 0;
+            after = after || 0;
+        }
+        else if (this.isEmpty(before) || this.isEmpty(after))
+            return before !== after;
+        const a = this.toBigInt(before);
+        const b = this.toBigInt(after);
+        if (a !== undefined && b !== undefined)
+            return a !== b;
+        return this.isDecimalChanged(before, after, emptyAsZero);
+    }
+    isBooleanChanged(before, after, emptyAsZero) {
+        if (emptyAsZero) {
+            before = before || false;
+            after = after || false;
+        }
+        else if (this.isEmpty(before) || this.isEmpty(after))
+            return before !== after;
+        const a = this.toBoolean(before);
+        const b = this.toBoolean(after);
+        if (a === undefined || b === undefined)
+            return before !== after;
+        return a !== b;
+    }
+    isEmpty(value) {
+        return value === null || value === undefined;
+    }
+    toNumber(value) {
+        if (typeof value === 'number')
+            return value;
+        if (typeof value === 'string')
+            return value.trim() === '' ? NaN : Number(value);
+        if (typeof value === 'bigint' || typeof value === 'boolean')
+            return Number(value);
+        return NaN;
     }
-    handleNumberColumn(event, column) {
-        const original = event.databaseEntity[column] || 0;
-        const updated = event.entity[column] || 0;
-        return original !== updated;
+    toBigInt(value) {
+        if (typeof value === 'bigint')
+            return value;
+        if (typeof value === 'number')
+            return Number.isInteger(value) ? BigInt(value) : undefined;
+        if (typeof value === 'string' && /^\s*-?\d+\s*$/.test(value))
+            return BigInt(value.trim());
+        return undefined;
     }
-    handleBooleanColumn(event, column) {
-        const original = event.databaseEntity[column] || false;
-        const updated = event.entity[column] || false;
-        return original !== updated;
+    toBoolean(value) {
+        if (typeof value === 'boolean')
+            return value;
+        if (value === 1 || value === 0)
+            return value === 1;
+        if (typeof value === 'string') {
+            const literal = value.trim().toLowerCase();
+            if (CommonSubscriber.TRUE_LITERALS.has(literal))
+                return true;
+            if (CommonSubscriber.FALSE_LITERALS.has(literal))
+                return false;
+        }
+        return undefined;
+    }
+    toDateString(value, utc) {
+        if (this.isEmpty(value))
+            return null;
+        if (value instanceof Date) {
+            if (Number.isNaN(value.getTime()))
+                return String(value);
+            const year = utc ? value.getUTCFullYear() : value.getFullYear();
+            const month = (utc ? value.getUTCMonth() : value.getMonth()) + 1;
+            const day = utc ? value.getUTCDate() : value.getDate();
+            return `${String(year).padStart(4, '0')}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`;
+        }
+        const text = String(value).trim();
+        return /^\d{4}-\d{2}-\d{2}/.exec(text)?.[0] ?? text;
     }
     async afterRemove(_event) {
     }
@@ -166,4 +252,19 @@ class CommonSubscriber {
     }
 }
 exports.CommonSubscriber = CommonSubscriber;
+CommonSubscriber.DECIMAL_TYPES = new Set([
+    'float',
+    'float4',
+    'float8',
+    'double precision',
+    'real',
+    'decimal',
+    'numeric',
+    'money',
+]);
+CommonSubscriber.INTEGER_TYPES = new Set([Number, 'int', 'int2', 'int4', 'int8', 'integer', 'smallint', 'bigint']);
+CommonSubscriber.BOOLEAN_TYPES = new Set([Boolean, 'boolean', 'bool']);
+CommonSubscriber.LEGACY_EMPTY_AS_ZERO_TYPES = new Set(['float', Number, Boolean]);
+CommonSubscriber.TRUE_LITERALS = new Set(['t', 'true', 'y', 'yes', 'on', '1']);
+CommonSubscriber.FALSE_LITERALS = new Set(['f', 'false', 'n', 'no', 'off', '0']);
 //# sourceMappingURL=common.subscriber.js.map