@servicelabsco/nestjs-utility-services 3.0.7 → 3.0.9

package/CHANGELOG.md

@@ -1,5 +1,135 @@
 # 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
+
+- **The Sentry SDK is only loaded when Sentry is enabled for the process.** Every `@sentry/*`
+  import in the library is now type-only or lazy: calls go through the new `SentrySdk`
+  (`captureException` / `captureMessage` / `getIsolationScope`), which `require`s
+  `@sentry/node` on first use and is a no-op when Sentry is off (no `SENTRY_DSN`, or a worker
+  without `SENTRY_ENABLE_WORKER=true`) — the same outcome as calling an uninitialised SDK.
+  `initSentry()` and `SentryReportingModule.forRoot()` require the SDK only on the enabled path,
+  and `SentryReportingFilter` builds its `SentryGlobalFilter` subclass on first use. Measured in
+  fn-expense-services with Sentry off: **−17 MB heap, −21 MB RSS, 1,581 fewer modules** per
+  process.
+- Specs that assert Sentry calls either set a file-scoped test DSN or mock `SentrySdk` directly.
+
+### Added
+
+- **`PlatformRegistryService` — hash registries derived from the container, not generated files.**
+  `PlatformUtility.getEntity` / `getJob` / `getService` fall back to it when a hash was not
+  explicitly registered. The hashes are unchanged, derived by the same conventions `sc` uses:
+  - entity → `md5('<table>:<ClassName>')` from every TypeORM `DataSource`'s metadata;
+  - job → the `super('<hash>')` each `CommonJob` provider already carries (via Nest `DiscoveryService`);
+  - service → the hash carried by the `publicExposed` marker (`@PublicExposed('<hash>')` or
+    `protected publicExposed = '<hash>'`).
+
+  Explicit registrations (`entity.constants.ts`, `es6.jobs.service.ts`, `es6.service.ts`,
+  `set*`) still win, so consumers keep working unchanged and can drop those generated files once
+  `sc` stops producing them. Two classes on one entity hash (same table + class name): the
+  most-derived wins when one extends the other; unrelated ones keep the first and are logged.
+  Indexes are built lazily on first lookup (rebuilt on a miss until the app has bootstrapped) and
+  hold references only.
+- `PublicExposed(exposed)` / `CommonService.publicExposed` accept the service hash as well as a
+  boolean; new `PublicExposed.hashOf()` (reads the class's own decorator, so a subclass does not
+  inherit its parent's hash). Preferred form for exposed services:
+  `@PublicExposed('<md5(module:ClassName)>')` in place of `protected publicExposed = true`.
+  nu's own `EmithookMailService` / `PdfService` are migrated, so nu's generated
+  `platformUtility/services/es6.service.ts` (`Es6Service`) is gone — both still resolve by the same hash.
+
+- **Opt-in Sentry reporting for queue workers.** Set `SENTRY_ENABLE_WORKER=true` (exact value) on a
+  worker process and `initSentry()` initialises the SDK there too, with the same redacting options
+  as the API. Workers still report nothing by default. New `isSentryWorkerEnabled()` /
+  `SentryBootstrap.isWorkerEnabled()`. Consumers should import their `instrument.ts` from
+  `worker.ts` as well; it stays a no-op without the flag. See
+  [docs/sentry-reporting.md](docs/sentry-reporting.md) §5.
+
 ## 3.0.7
 
 ### Fixed

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/auth/services/device.token.service.js

@@ -1,48 +1,15 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
 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 __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var DeviceTokenService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeviceTokenService = void 0;
 const common_1 = require("@nestjs/common");
-const Sentry = __importStar(require("@sentry/node"));
+const sentry_sdk_1 = require("../../common/libraries/sentry.sdk");
 const class_transformer_1 = require("class-transformer");
 const auth_1 = require("../../common/libraries/auth");
 const operation_exception_1 = require("../../common/exceptions/operation.exception");
@@ -68,7 +35,7 @@ let DeviceTokenService = DeviceTokenService_1 = class DeviceTokenService {
         }
         const message = lastError instanceof Error ? lastError.message : String(lastError);
         global.console.error(`setDeviceToken failed after ${DeviceTokenService_1.MAX_SAVE_ATTEMPTS} attempts (token=${body?.token}): ${message}`);
-        Sentry.captureException(lastError, {
+        sentry_sdk_1.SentrySdk.captureException(lastError, {
             level: 'error',
             tags: { service: 'DeviceTokenService' },
             extra: { token: body?.token, attempts: DeviceTokenService_1.MAX_SAVE_ATTEMPTS },

package/dist/auth/services/device.token.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"device.token.service.js","sourceRoot":"","sources":["../../../src/auth/services/device.token.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"device.token.service.js","sourceRoot":"","sources":["../../../src/auth/services/device.token.service.ts"],"names":[],"mappings":"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"}

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/public.exposed.decorator.d.ts

@@ -1,6 +1,7 @@
 import 'reflect-metadata';
-export declare function PublicExposed(exposed?: boolean): ClassDecorator;
+export declare function PublicExposed(exposed?: boolean | string): ClassDecorator;
 export declare namespace PublicExposed {
     var isPublic: (target: any) => boolean;
+    var hashOf: (target: any) => string | undefined;
 }
 export { PublicExposed as PublicExposedDecorator };

package/dist/common/decorators/public.exposed.decorator.js

@@ -4,20 +4,35 @@ exports.PublicExposed = PublicExposed;
 exports.PublicExposedDecorator = PublicExposed;
 require("reflect-metadata");
 const PUBLIC_EXPOSED_METADATA = 'slnu:public_exposed';
+const SERVICE_HASH_PATTERN = /^[0-9a-f]{32}$/;
 function PublicExposed(exposed = true) {
     return (target) => {
         Reflect.defineMetadata(PUBLIC_EXPOSED_METADATA, exposed, target);
         target.prototype.publicExposed = exposed;
     };
 }
-PublicExposed.isPublic = (target) => {
+const markerOf = (target) => {
     if (target === null || target === undefined)
-        return false;
+        return undefined;
     const constructor = typeof target === 'function' ? target : target.constructor;
-    if (constructor && Reflect.getMetadata(PUBLIC_EXPOSED_METADATA, constructor) === true) {
-        return true;
-    }
+    const metadata = constructor ? Reflect.getMetadata(PUBLIC_EXPOSED_METADATA, constructor) : undefined;
+    if (metadata !== undefined && metadata !== false)
+        return metadata;
     const flagHolder = typeof target === 'function' ? target.prototype : target;
-    return flagHolder?.publicExposed === true;
+    return flagHolder?.publicExposed;
+};
+PublicExposed.isPublic = (target) => {
+    const marker = markerOf(target);
+    return marker === true || (typeof marker === 'string' && SERVICE_HASH_PATTERN.test(marker));
+};
+PublicExposed.hashOf = (target) => {
+    if (target === null || target === undefined)
+        return undefined;
+    const constructor = typeof target === 'function' ? target : target.constructor;
+    const decorated = constructor ? Reflect.getOwnMetadata(PUBLIC_EXPOSED_METADATA, constructor) : undefined;
+    const holder = typeof target === 'function' ? target.prototype : target;
+    const legacy = holder && Object.prototype.hasOwnProperty.call(holder, 'publicExposed') ? holder.publicExposed : undefined;
+    const marker = decorated !== undefined ? decorated : legacy;
+    return typeof marker === 'string' && SERVICE_HASH_PATTERN.test(marker) ? marker : undefined;
 };
 //# sourceMappingURL=public.exposed.decorator.js.map

package/dist/common/decorators/public.exposed.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.exposed.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/public.exposed.decorator.ts"],"names":[],"mappings":";;AA6BA,sCASC;AA6ByB,+CAAsB;AAnEhD,4BAA0B;AAM1B,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAuBtD,SAAgB,aAAa,CAAC,OAAO,GAAG,IAAI;IACxC,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAKhE,MAAc,CAAC,SAAS,CAAC,aAAa,GAAG,OAAO,CAAC;IACtD,CAAC,CAAC;AACN,CAAC;AAYD,aAAa,CAAC,QAAQ,GAAG,CAAC,MAAW,EAAW,EAAE;IAC9C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAE1D,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;IAE/E,IAAI,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC;QACpF,OAAO,IAAI,CAAC;IAChB,CAAC;IAID,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IAE5E,OAAO,UAAU,EAAE,aAAa,KAAK,IAAI,CAAC;AAC9C,CAAC,CAAC"}
+{"version":3,"file":"public.exposed.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/public.exposed.decorator.ts"],"names":[],"mappings":";;AAoCA,sCASC;AAkEyB,+CAAsB;AA/GhD,4BAA0B;AAM1B,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAGtD,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AA2B9C,SAAgB,aAAa,CAAC,UAA4B,IAAI;IAC1D,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAKhE,MAAc,CAAC,SAAS,CAAC,aAAa,GAAG,OAAO,CAAC;IACtD,CAAC,CAAC;AACN,CAAC;AAOD,MAAM,QAAQ,GAAG,CAAC,MAAW,EAAW,EAAE;IACtC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE9D,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;IAC/E,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrG,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC;IAElE,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IAE5E,OAAO,UAAU,EAAE,aAAa,CAAC;AACrC,CAAC,CAAC;AAYF,aAAa,CAAC,QAAQ,GAAG,CAAC,MAAW,EAAW,EAAE;IAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,OAAO,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAChG,CAAC,CAAC;AAeF,aAAa,CAAC,MAAM,GAAG,CAAC,MAAW,EAAsB,EAAE;IACvD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE9D,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;IAC/E,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAKzG,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1H,MAAM,MAAM,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IAE5D,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAChG,CAAC,CAAC"}

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,9 +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)[];
@@ -53,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");
@@ -65,11 +68,13 @@ const report_data_manager_1 = require("./libraries/report.data.manager");
 const report_list_manager_1 = require("./libraries/report.list.manager");
 const reverse_migration_utility_1 = require("./libraries/reverse.migration.utility");
 const seeder_utility_1 = require("./libraries/seeder.utility");
+const sentry_sdk_1 = require("./libraries/sentry.sdk");
 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,
@@ -93,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,
@@ -102,6 +108,8 @@ const es6Classes = {
         subscription_exception_1.SubscriptionException,
         too_many_attempts_exception_1.TooManyAttemptsException,
     ],
+    interfaces: [],
+    jobs: [],
     libraries: [
         auth_1.Auth,
         base_migration_utility_1.BaseMigrationUtility,
@@ -136,8 +144,11 @@ const es6Classes = {
         report_list_manager_1.ReportListManager,
         reverse_migration_utility_1.ReverseMigrationUtility,
         seeder_utility_1.SeederUtility,
+        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,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,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,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/index.d.ts

@@ -3,5 +3,6 @@ export * from './constants';
 export * from './decorators';
 export * from './dtos';
 export * from './exceptions';
+export * from './interfaces';
 export * from './libraries';
 export * from './common.module';

package/dist/common/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./constants"), exports);
 __exportStar(require("./decorators"), exports);
 __exportStar(require("./dtos"), exports);
 __exportStar(require("./exceptions"), exports);
+__exportStar(require("./interfaces"), exports);
 __exportStar(require("./libraries"), exports);
 __exportStar(require("./common.module"), exports);
 //# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAAA,8CAA4B;AAAA,+CAA6B;AAAA,yCAAuB;AAAA,+CAA6B;AAAA,8CAA4B;AAAA,kDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAAA,8CAA4B;AAAA,+CAA6B;AAAA,yCAAuB;AAAA,+CAA6B;AAAA,+CAA6B;AAAA,8CAA4B;AAAA,kDAA+B"}

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

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

package/dist/common/interfaces/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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

@@ -0,0 +1 @@
+{"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>;
+}