grm-shared-library 1.1.191 → 1.1.193

package/dist/cjs/modules/system-user/services/system-user.service.js

@@ -0,0 +1,60 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var SystemUserService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemUserService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const system_user_const_1 = require("../constants/system-user.const");
+const system_user_util_1 = require("../utils/system-user.util");
+/**
+ * Single source of truth for the platform system user id inside a service.
+ *
+ * Resolution happens once, on module init, so a mis-set `SYSTEM_USER_ID`
+ * fails the pod's startup probe instead of surfacing later as records stamped
+ * with a user id that clarion-authentication cannot resolve.
+ *
+ * @example
+ * constructor(private readonly systemUser: SystemUserService) {}
+ * ...
+ * const actorId = userContext?.userId ?? this.systemUser.id;
+ */
+let SystemUserService = SystemUserService_1 = class SystemUserService {
+    constructor(configService) {
+        this.configService = configService;
+        this.logger = new common_1.Logger(SystemUserService_1.name);
+        this.resolvedId = null;
+    }
+    onModuleInit() {
+        this.resolvedId = (0, system_user_util_1.resolveSystemUserId)(this.configService, {
+            onLegacyKeyUsed: (key) => this.logger.warn(`Resolved the system user id from deprecated env key "${key}". ` +
+                `Set ${system_user_const_1.SYSTEM_USER_ID_ENV_KEY} instead — legacy keys will be removed.`),
+        });
+        this.logger.log(`System user id resolved to ${this.resolvedId}`);
+    }
+    /**
+     * The system user id. Throws if read before module init completed, which
+     * only happens if a provider resolves it inside its own constructor.
+     */
+    get id() {
+        if (this.resolvedId === null) {
+            // Resolve on demand so constructor-time reads still work.
+            this.resolvedId = (0, system_user_util_1.resolveSystemUserId)(this.configService);
+        }
+        return this.resolvedId;
+    }
+};
+exports.SystemUserService = SystemUserService;
+exports.SystemUserService = SystemUserService = SystemUserService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_1.ConfigService])
+], SystemUserService);
+//# sourceMappingURL=system-user.service.js.map

package/dist/cjs/modules/system-user/services/system-user.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-user.service.js","sourceRoot":"","sources":["../../../../../src/modules/system-user/services/system-user.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAkE;AAClE,2CAA+C;AAC/C,sEAAwE;AACxE,gEAAgE;AAEhE;;;;;;;;;;;GAWG;AAEI,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAI1B,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;QAHxC,WAAM,GAAG,IAAI,eAAM,CAAC,mBAAiB,CAAC,IAAI,CAAC,CAAC;QACrD,eAAU,GAAkB,IAAI,CAAC;IAEoB,CAAC;IAE9D,YAAY;QACR,IAAI,CAAC,UAAU,GAAG,IAAA,sCAAmB,EAAC,IAAI,CAAC,aAAa,EAAE;YACtD,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CACZ,wDAAwD,GAAG,KAAK;gBAChE,OAAO,0CAAsB,yCAAyC,CACzE;SACR,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,IAAI,EAAE;QACF,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC3B,0DAA0D;YAC1D,IAAI,CAAC,UAAU,GAAG,IAAA,sCAAmB,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;CACJ,CAAA;AA5BY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAKmC,sBAAa;GAJhD,iBAAiB,CA4B7B"}

package/dist/cjs/modules/system-user/system-user.module.js

@@ -0,0 +1,33 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemUserModule = void 0;
+const common_1 = require("@nestjs/common");
+const system_user_service_1 = require("./services/system-user.service");
+/**
+ * Global module exposing {@link SystemUserService} to every provider in the
+ * host application. Import once in the service's root `AppModule`:
+ *
+ * @example
+ * @Module({ imports: [ConfigModule.forRoot({ ... }), SystemUserModule] })
+ * export class AppModule {}
+ *
+ * Requires `ConfigModule` to be global (the convention across clarion
+ * services) or otherwise available where this module is imported.
+ */
+let SystemUserModule = class SystemUserModule {
+};
+exports.SystemUserModule = SystemUserModule;
+exports.SystemUserModule = SystemUserModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [system_user_service_1.SystemUserService],
+        exports: [system_user_service_1.SystemUserService],
+    })
+], SystemUserModule);
+//# sourceMappingURL=system-user.module.js.map

package/dist/cjs/modules/system-user/system-user.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-user.module.js","sourceRoot":"","sources":["../../../../src/modules/system-user/system-user.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,wEAAmE;AAEnE;;;;;;;;;;GAUG;AAMI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAI,CAAA;AAApB,4CAAgB;2BAAhB,gBAAgB;IAL5B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACJ,SAAS,EAAE,CAAC,uCAAiB,CAAC;QAC9B,OAAO,EAAE,CAAC,uCAAiB,CAAC;KAC/B,CAAC;GACW,gBAAgB,CAAI"}

package/dist/cjs/modules/system-user/utils/system-user.util.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSystemUserId = parseSystemUserId;
+exports.resolveSystemUserId = resolveSystemUserId;
+const system_user_const_1 = require("../constants/system-user.const");
+/**
+ * Parses a raw environment value into a usable user id.
+ *
+ * Returns `null` for anything that is not a positive integer — including
+ * `'0'`, `'-1'`, `'abc'` and the empty string — so that a typo'd ConfigMap
+ * entry surfaces as a clear failure rather than silently stamping user `0`
+ * onto production records.
+ */
+function parseSystemUserId(raw) {
+    if (raw === null || raw === undefined) {
+        return null;
+    }
+    const text = String(raw).trim();
+    if (!text || !/^\d+$/.test(text)) {
+        return null;
+    }
+    const parsed = Number(text);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
+}
+/**
+ * Resolves the platform system user id from the environment.
+ *
+ * Precedence: {@link SYSTEM_USER_ID_ENV_KEY} → each legacy key in order →
+ * `options.fallback`. Throws when nothing resolves and no fallback is given,
+ * which is the intended behaviour at startup: a service that stamps records
+ * with the system user should refuse to boot rather than write a wrong id.
+ *
+ * @example
+ * // In a Nest provider that already injects ConfigService:
+ * this.systemUserId = resolveSystemUserId(this.configService);
+ */
+function resolveSystemUserId(source, options = {}) {
+    const { legacyKeys = system_user_const_1.LEGACY_SYSTEM_USER_ID_ENV_KEYS, fallback, onLegacyKeyUsed } = options;
+    const canonical = parseSystemUserId(source.get(system_user_const_1.SYSTEM_USER_ID_ENV_KEY));
+    if (canonical !== null) {
+        return canonical;
+    }
+    for (const key of legacyKeys) {
+        const legacy = parseSystemUserId(source.get(key));
+        if (legacy !== null) {
+            onLegacyKeyUsed === null || onLegacyKeyUsed === void 0 ? void 0 : onLegacyKeyUsed(key);
+            return legacy;
+        }
+    }
+    if (fallback !== undefined) {
+        return fallback;
+    }
+    throw new Error(`${system_user_const_1.SYSTEM_USER_ID_ENV_KEY} is not set to a positive integer. ` +
+        `Set it to the id of the platform system user in clarion-authentication ` +
+        `(checked legacy keys: ${legacyKeys.length ? legacyKeys.join(', ') : 'none'}).`);
+}
+//# sourceMappingURL=system-user.util.js.map

package/dist/cjs/modules/system-user/utils/system-user.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-user.util.js","sourceRoot":"","sources":["../../../../../src/modules/system-user/utils/system-user.util.ts"],"names":[],"mappings":";;AA8BA,8CAYC;AAcD,kDA4BC;AAnFD,sEAAwG;AAqBxG;;;;;;;GAOG;AACH,SAAgB,iBAAiB,CAAC,GAAY;IAC1C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,mBAAmB,CAC/B,MAA2B,EAC3B,UAAsC,EAAE;IAExC,MAAM,EAAE,UAAU,GAAG,kDAA8B,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAE3F,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,0CAAsB,CAAC,CAAC,CAAC;IACxE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClB,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAG,GAAG,CAAC,CAAC;YACvB,OAAO,MAAM,CAAC;QAClB,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,KAAK,CACX,GAAG,0CAAsB,qCAAqC;QAC9D,yEAAyE;QACzE,yBAAyB,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAClF,CAAC;AACN,CAAC"}

package/dist/esm/index.js

@@ -20,6 +20,8 @@ export * from './modules/chat/index';
 export * from './modules/country/index';
 export * from './modules/phone/index';
 export * from './modules/tracking/index';
+export * from './modules/entitlement/index';
+export * from './modules/system-user/index';
 // Interfaces
 export * from './interfaces/server-message';
 export * from './interfaces/i-request-with-user';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AAEzC,aAAa;AACb,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,YAAY;AACZ,cAAc,0BAA0B,CAAC;AAEzC,QAAQ;AACR,cAAc,eAAe,CAAC;AAE9B,YAAY;AACZ,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uDAAuD,CAAC;AAEtE,aAAa;AACb,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAE5C,aAAa;AACb,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,YAAY;AACZ,cAAc,0BAA0B,CAAC;AAEzC,QAAQ;AACR,cAAc,eAAe,CAAC;AAE9B,YAAY;AACZ,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uDAAuD,CAAC;AAEtE,aAAa;AACb,cAAc,oBAAoB,CAAC"}

package/dist/esm/modules/entitlement/constants/entitlement-defaults.const.js

@@ -0,0 +1,17 @@
+/**
+ * Platform defaults for the premium trial. A deployment overrides these with
+ * `BILLING_TRIAL_*` environment variables, and an organization can override them
+ * again through its billing config - so these are the last fallback, not policy.
+ */
+export const PREMIUM_TRIAL_DEFAULTS = {
+    /** Alerts a trial user may raise as if they were premium. */
+    MAX_INCIDENTS: 2,
+    /** Days the trial window stays open from enrolment. */
+    DURATION_DAYS: 30,
+};
+/**
+ * Header used to carry a caller-supplied idempotency key on entitlement
+ * mutations. Kept here so producer and consumer cannot drift.
+ */
+export const ENTITLEMENT_IDEMPOTENCY_HEADER = 'x-entitlement-idempotency-key';
+//# sourceMappingURL=entitlement-defaults.const.js.map

package/dist/esm/modules/entitlement/constants/entitlement-defaults.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement-defaults.const.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/constants/entitlement-defaults.const.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,6DAA6D;IAC7D,aAAa,EAAE,CAAC;IAChB,uDAAuD;IACvD,aAAa,EAAE,EAAE;CACX,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,+BAA+B,CAAC"}

package/dist/esm/modules/entitlement/dtos/consume-trial-alert.dto.js

@@ -0,0 +1,49 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsInt, IsOptional, IsPositive } from 'class-validator';
+import { Type } from 'class-transformer';
+/**
+ * Records that one trial alert was spent. `incidentId` is the idempotency key:
+ * replaying the same incident never double-counts, so the caller can retry
+ * freely after a transient failure.
+ */
+export class ConsumeTrialAlertDto {
+}
+__decorate([
+    ApiProperty({ description: 'User the trial belongs to', example: 42 }),
+    Type(() => Number),
+    IsInt(),
+    IsPositive(),
+    __metadata("design:type", Number)
+], ConsumeTrialAlertDto.prototype, "userId", void 0);
+__decorate([
+    ApiProperty({ description: 'Organization the trial is scoped to', example: 2 }),
+    Type(() => Number),
+    IsInt(),
+    IsPositive(),
+    __metadata("design:type", Number)
+], ConsumeTrialAlertDto.prototype, "organizationId", void 0);
+__decorate([
+    ApiProperty({ description: 'Incident that consumed the alert - the idempotency key', example: 9931 }),
+    Type(() => Number),
+    IsInt(),
+    IsPositive(),
+    __metadata("design:type", Number)
+], ConsumeTrialAlertDto.prototype, "incidentId", void 0);
+__decorate([
+    ApiPropertyOptional({ description: 'Incident type of the consuming incident', example: 7 }),
+    Type(() => Number),
+    IsInt(),
+    IsPositive(),
+    IsOptional(),
+    __metadata("design:type", Number)
+], ConsumeTrialAlertDto.prototype, "incidentTypeId", void 0);
+//# sourceMappingURL=consume-trial-alert.dto.js.map

package/dist/esm/modules/entitlement/dtos/consume-trial-alert.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consume-trial-alert.dto.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/dtos/consume-trial-alert.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;CAyBhC;AApBG;IAJC,WAAW,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACtE,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,UAAU,EAAE;;oDACG;AAMhB;IAJC,WAAW,CAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC/E,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,UAAU,EAAE;;4DACW;AAMxB;IAJC,WAAW,CAAC,EAAE,WAAW,EAAE,wDAAwD,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrG,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,UAAU,EAAE;;wDACO;AAOpB;IALC,mBAAmB,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC3F,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,UAAU,EAAE;IACZ,UAAU,EAAE;;4DACW"}

package/dist/esm/modules/entitlement/dtos/evaluate-entitlement.dto.js

@@ -0,0 +1,51 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsBoolean, IsInt, IsOptional, IsPositive } from 'class-validator';
+import { Type } from 'class-transformer';
+/**
+ * Service-to-service entitlement question. Sent by clarion-incident before an
+ * incident of class `Incident` is created, and by any other service that needs
+ * to know whether a user may reach the provider control room.
+ */
+export class EvaluateEntitlementDto {
+}
+__decorate([
+    ApiProperty({ description: 'User whose premium standing is being evaluated', example: 42 }),
+    Type(() => Number),
+    IsInt(),
+    IsPositive(),
+    __metadata("design:type", Number)
+], EvaluateEntitlementDto.prototype, "userId", void 0);
+__decorate([
+    ApiProperty({ description: 'Organization (service provider) the entitlement is scoped to', example: 2 }),
+    Type(() => Number),
+    IsInt(),
+    IsPositive(),
+    __metadata("design:type", Number)
+], EvaluateEntitlementDto.prototype, "organizationId", void 0);
+__decorate([
+    ApiPropertyOptional({ description: 'Incident type the alert is for. Omit to ask about premium standing in general.', example: 7 }),
+    Type(() => Number),
+    IsInt(),
+    IsPositive(),
+    IsOptional(),
+    __metadata("design:type", Number)
+], EvaluateEntitlementDto.prototype, "incidentTypeId", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Whether a first-time user with no subscription may be lazily enrolled into the premium trial. Defaults to true.',
+        example: true,
+    }),
+    IsBoolean(),
+    IsOptional(),
+    __metadata("design:type", Boolean)
+], EvaluateEntitlementDto.prototype, "autoEnrollTrial", void 0);
+//# sourceMappingURL=evaluate-entitlement.dto.js.map

package/dist/esm/modules/entitlement/dtos/evaluate-entitlement.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-entitlement.dto.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/dtos/evaluate-entitlement.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;CA2BlC;AAtBG;IAJC,WAAW,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC3F,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,UAAU,EAAE;;sDACG;AAMhB;IAJC,WAAW,CAAC,EAAE,WAAW,EAAE,8DAA8D,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACxG,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,UAAU,EAAE;;8DACW;AAOxB;IALC,mBAAmB,CAAC,EAAE,WAAW,EAAE,gFAAgF,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAClI,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,UAAU,EAAE;IACZ,UAAU,EAAE;;8DACW;AAQxB;IANC,mBAAmB,CAAC;QACjB,WAAW,EAAE,iHAAiH;QAC9H,OAAO,EAAE,IAAI;KAChB,CAAC;IACD,SAAS,EAAE;IACX,UAAU,EAAE;;+DACa"}

package/dist/esm/modules/entitlement/dtos/grant-premium-trial.dto.js

@@ -0,0 +1,53 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsInt, IsOptional, IsPositive, IsString, MaxLength, Min } from 'class-validator';
+import { Type } from 'class-transformer';
+/** Operator-initiated trial grant (or extension of an existing trial). */
+export class GrantPremiumTrialDto {
+}
+__decorate([
+    ApiProperty({ example: 42 }),
+    Type(() => Number),
+    IsInt(),
+    IsPositive(),
+    __metadata("design:type", Number)
+], GrantPremiumTrialDto.prototype, "userId", void 0);
+__decorate([
+    ApiProperty({ example: 2 }),
+    Type(() => Number),
+    IsInt(),
+    IsPositive(),
+    __metadata("design:type", Number)
+], GrantPremiumTrialDto.prototype, "organizationId", void 0);
+__decorate([
+    ApiPropertyOptional({ description: 'Alerts the trial grants. Falls back to the configured default (2).', example: 2 }),
+    Type(() => Number),
+    IsInt(),
+    Min(1),
+    IsOptional(),
+    __metadata("design:type", Number)
+], GrantPremiumTrialDto.prototype, "maxIncidents", void 0);
+__decorate([
+    ApiPropertyOptional({ description: 'Trial length in days. Falls back to the configured default (30).', example: 30 }),
+    Type(() => Number),
+    IsInt(),
+    Min(1),
+    IsOptional(),
+    __metadata("design:type", Number)
+], GrantPremiumTrialDto.prototype, "durationDays", void 0);
+__decorate([
+    ApiPropertyOptional({ description: 'Free-text audit note', example: 'Goodwill extension after failed payment' }),
+    IsString(),
+    MaxLength(500),
+    IsOptional(),
+    __metadata("design:type", String)
+], GrantPremiumTrialDto.prototype, "reason", void 0);
+//# sourceMappingURL=grant-premium-trial.dto.js.map

package/dist/esm/modules/entitlement/dtos/grant-premium-trial.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant-premium-trial.dto.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/dtos/grant-premium-trial.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,0EAA0E;AAC1E,MAAM,OAAO,oBAAoB;CAgChC;AA3BG;IAJC,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,UAAU,EAAE;;oDACG;AAMhB;IAJC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC3B,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,UAAU,EAAE;;4DACW;AAOxB;IALC,mBAAmB,CAAC,EAAE,WAAW,EAAE,oEAAoE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACtH,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,GAAG,CAAC,CAAC,CAAC;IACN,UAAU,EAAE;;0DACS;AAOtB;IALC,mBAAmB,CAAC,EAAE,WAAW,EAAE,kEAAkE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACrH,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,KAAK,EAAE;IACP,GAAG,CAAC,CAAC,CAAC;IACN,UAAU,EAAE;;0DACS;AAMtB;IAJC,mBAAmB,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;IAChH,QAAQ,EAAE;IACV,SAAS,CAAC,GAAG,CAAC;IACd,UAAU,EAAE;;oDACG"}

package/dist/esm/modules/entitlement/dtos/revoke-premium-trial.dto.js

@@ -0,0 +1,22 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsOptional, IsString, MaxLength } from 'class-validator';
+/** Operator-initiated trial revocation. */
+export class RevokePremiumTrialDto {
+}
+__decorate([
+    ApiPropertyOptional({ description: 'Free-text audit note', example: 'Repeated test alerts' }),
+    IsString(),
+    MaxLength(500),
+    IsOptional(),
+    __metadata("design:type", String)
+], RevokePremiumTrialDto.prototype, "reason", void 0);
+//# sourceMappingURL=revoke-premium-trial.dto.js.map

package/dist/esm/modules/entitlement/dtos/revoke-premium-trial.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revoke-premium-trial.dto.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/dtos/revoke-premium-trial.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAElE,2CAA2C;AAC3C,MAAM,OAAO,qBAAqB;CAMjC;AADG;IAJC,mBAAmB,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAC7F,QAAQ,EAAE;IACV,SAAS,CAAC,GAAG,CAAC;IACd,UAAU,EAAE;;qDACG"}

package/dist/esm/modules/entitlement/enums/entitlement-decision-reason.enum.js

@@ -0,0 +1,31 @@
+/**
+ * Why an entitlement evaluation produced its tier. Persisted in the incident
+ * entitlement snapshot for audit/support and surfaced to the mobile client so it
+ * can pick the right subscription banner without a second round trip.
+ */
+export var EntitlementDecisionReason;
+(function (EntitlementDecisionReason) {
+    /** An active subscription entitlement covers the requested incident type. */
+    EntitlementDecisionReason["ACTIVE_SUBSCRIPTION"] = "ACTIVE_SUBSCRIPTION";
+    /** No subscription, but an active premium trial with alerts remaining. */
+    EntitlementDecisionReason["ACTIVE_TRIAL"] = "ACTIVE_TRIAL";
+    /** The user has never held a subscription or trial for this organization. */
+    EntitlementDecisionReason["NO_ENTITLEMENT"] = "NO_ENTITLEMENT";
+    /** An entitlement exists but its package does not cover this incident type. */
+    EntitlementDecisionReason["INCIDENT_TYPE_NOT_COVERED"] = "INCIDENT_TYPE_NOT_COVERED";
+    /** The user's subscription lapsed — drives the "renew" banner on mobile. */
+    EntitlementDecisionReason["SUBSCRIPTION_EXPIRED"] = "SUBSCRIPTION_EXPIRED";
+    /** The trial period is still open but every trial alert has been used. */
+    EntitlementDecisionReason["TRIAL_EXHAUSTED"] = "TRIAL_EXHAUSTED";
+    /** The trial window elapsed. */
+    EntitlementDecisionReason["TRIAL_EXPIRED"] = "TRIAL_EXPIRED";
+    /** The trial was revoked by an operator. */
+    EntitlementDecisionReason["TRIAL_REVOKED"] = "TRIAL_REVOKED";
+    /** Trials are switched off for this organization/deployment. */
+    EntitlementDecisionReason["TRIAL_DISABLED"] = "TRIAL_DISABLED";
+    /** Entitlement does not gate this record (e.g. grievance class). */
+    EntitlementDecisionReason["NOT_APPLICABLE"] = "NOT_APPLICABLE";
+    /** Billing could not be reached; the configured fail-open/closed default applied. */
+    EntitlementDecisionReason["EVALUATION_UNAVAILABLE"] = "EVALUATION_UNAVAILABLE";
+})(EntitlementDecisionReason || (EntitlementDecisionReason = {}));
+//# sourceMappingURL=entitlement-decision-reason.enum.js.map

package/dist/esm/modules/entitlement/enums/entitlement-decision-reason.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement-decision-reason.enum.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/enums/entitlement-decision-reason.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,yBAuBX;AAvBD,WAAY,yBAAyB;IACjC,6EAA6E;IAC7E,wEAA2C,CAAA;IAC3C,0EAA0E;IAC1E,0DAA6B,CAAA;IAC7B,6EAA6E;IAC7E,8DAAiC,CAAA;IACjC,+EAA+E;IAC/E,oFAAuD,CAAA;IACvD,4EAA4E;IAC5E,0EAA6C,CAAA;IAC7C,0EAA0E;IAC1E,gEAAmC,CAAA;IACnC,gCAAgC;IAChC,4DAA+B,CAAA;IAC/B,4CAA4C;IAC5C,4DAA+B,CAAA;IAC/B,gEAAgE;IAChE,8DAAiC,CAAA;IACjC,oEAAoE;IACpE,8DAAiC,CAAA;IACjC,qFAAqF;IACrF,8EAAiD,CAAA;AACrD,CAAC,EAvBW,yBAAyB,KAAzB,yBAAyB,QAuBpC"}

package/dist/esm/modules/entitlement/enums/incident-entitlement-scope.enum.js

@@ -0,0 +1,16 @@
+/**
+ * List filter applied to incident queries.
+ *
+ *   ALL       — no entitlement filter (default; preserves legacy behaviour).
+ *   ENTITLED  — everything except Free-user incidents. Used by the primary admin
+ *               incident list, map and kanban views.
+ *   FREE      — only Free-user incidents. Backs the "Incident List - Free Users"
+ *               admin view.
+ */
+export var IncidentEntitlementScope;
+(function (IncidentEntitlementScope) {
+    IncidentEntitlementScope["ALL"] = "ALL";
+    IncidentEntitlementScope["ENTITLED"] = "ENTITLED";
+    IncidentEntitlementScope["FREE"] = "FREE";
+})(IncidentEntitlementScope || (IncidentEntitlementScope = {}));
+//# sourceMappingURL=incident-entitlement-scope.enum.js.map

package/dist/esm/modules/entitlement/enums/incident-entitlement-scope.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-entitlement-scope.enum.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/enums/incident-entitlement-scope.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAChC,uCAAW,CAAA;IACX,iDAAqB,CAAA;IACrB,yCAAa,CAAA;AACjB,CAAC,EAJW,wBAAwB,KAAxB,wBAAwB,QAInC"}

package/dist/esm/modules/entitlement/enums/incident-entitlement-tier.enum.js

@@ -0,0 +1,24 @@
+/**
+ * Premium entitlement classification stamped on every incident at creation time.
+ *
+ * The tier is derived server-side by clarion-billing and is NEVER accepted from a
+ * client payload. It drives three behaviours across the platform:
+ *
+ *   - `FREE` incidents are not published to the realtime (live-updates) channel,
+ *     are not auto-assigned to operators, and are hidden from the primary
+ *     admin incident list / map / kanban views.
+ *   - `PREMIUM` and `TRIAL` incidents behave exactly as incidents did before
+ *     entitlement enforcement (full provider routing + live updates).
+ *   - `NOT_APPLICABLE` covers everything entitlement does not gate: grievances,
+ *     incidents created before enforcement shipped, and any incident whose
+ *     entitlement could not be attributed to a user. It is treated as entitled
+ *     so historical and non-gated data keeps its existing behaviour.
+ */
+export var IncidentEntitlementTier;
+(function (IncidentEntitlementTier) {
+    IncidentEntitlementTier["PREMIUM"] = "PREMIUM";
+    IncidentEntitlementTier["TRIAL"] = "TRIAL";
+    IncidentEntitlementTier["FREE"] = "FREE";
+    IncidentEntitlementTier["NOT_APPLICABLE"] = "NOT_APPLICABLE";
+})(IncidentEntitlementTier || (IncidentEntitlementTier = {}));
+//# sourceMappingURL=incident-entitlement-tier.enum.js.map

package/dist/esm/modules/entitlement/enums/incident-entitlement-tier.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-entitlement-tier.enum.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/enums/incident-entitlement-tier.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAN,IAAY,uBAKX;AALD,WAAY,uBAAuB;IAC/B,8CAAmB,CAAA;IACnB,0CAAe,CAAA;IACf,wCAAa,CAAA;IACb,4DAAiC,CAAA;AACrC,CAAC,EALW,uBAAuB,KAAvB,uBAAuB,QAKlC"}

package/dist/esm/modules/entitlement/enums/premium-trial-source.enum.js

@@ -0,0 +1,9 @@
+/** How a premium trial came to exist. */
+export var PremiumTrialSource;
+(function (PremiumTrialSource) {
+    /** Created lazily the first time entitlement was evaluated for the user. */
+    PremiumTrialSource["AUTO_ENROLL"] = "AUTO_ENROLL";
+    /** Granted explicitly by an operator/admin. */
+    PremiumTrialSource["MANUAL_GRANT"] = "MANUAL_GRANT";
+})(PremiumTrialSource || (PremiumTrialSource = {}));
+//# sourceMappingURL=premium-trial-source.enum.js.map

package/dist/esm/modules/entitlement/enums/premium-trial-source.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"premium-trial-source.enum.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/enums/premium-trial-source.enum.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC1B,4EAA4E;IAC5E,iDAA2B,CAAA;IAC3B,+CAA+C;IAC/C,mDAA6B,CAAA;AACjC,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}

package/dist/esm/modules/entitlement/enums/premium-trial-status.enum.js

@@ -0,0 +1,15 @@
+/** Lifecycle of a user's premium trial within one organization. */
+export var PremiumTrialStatus;
+(function (PremiumTrialStatus) {
+    /** Within the trial window with at least one alert remaining. */
+    PremiumTrialStatus["ACTIVE"] = "ACTIVE";
+    /** Within the trial window but every allotted alert has been used. */
+    PremiumTrialStatus["EXHAUSTED"] = "EXHAUSTED";
+    /** The trial window elapsed. */
+    PremiumTrialStatus["EXPIRED"] = "EXPIRED";
+    /** Cancelled by an operator before it ran its course. */
+    PremiumTrialStatus["REVOKED"] = "REVOKED";
+    /** Superseded because the user took out a paid subscription. */
+    PremiumTrialStatus["CONVERTED"] = "CONVERTED";
+})(PremiumTrialStatus || (PremiumTrialStatus = {}));
+//# sourceMappingURL=premium-trial-status.enum.js.map

package/dist/esm/modules/entitlement/enums/premium-trial-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"premium-trial-status.enum.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/enums/premium-trial-status.enum.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,CAAN,IAAY,kBAWX;AAXD,WAAY,kBAAkB;IAC1B,iEAAiE;IACjE,uCAAiB,CAAA;IACjB,sEAAsE;IACtE,6CAAuB,CAAA;IACvB,gCAAgC;IAChC,yCAAmB,CAAA;IACnB,yDAAyD;IACzD,yCAAmB,CAAA;IACnB,gEAAgE;IAChE,6CAAuB,CAAA;AAC3B,CAAC,EAXW,kBAAkB,KAAlB,kBAAkB,QAW7B"}

package/dist/esm/modules/entitlement/index.js

@@ -0,0 +1,18 @@
+// Enums
+export * from './enums/incident-entitlement-tier.enum';
+export * from './enums/incident-entitlement-scope.enum';
+export * from './enums/entitlement-decision-reason.enum';
+export * from './enums/premium-trial-status.enum';
+export * from './enums/premium-trial-source.enum';
+// Interfaces
+export * from './interfaces/entitlement-evaluation';
+// Constants
+export * from './constants/entitlement-defaults.const';
+// DTOs
+export * from './dtos/evaluate-entitlement.dto';
+export * from './dtos/consume-trial-alert.dto';
+export * from './dtos/grant-premium-trial.dto';
+export * from './dtos/revoke-premium-trial.dto';
+// Utilities
+export * from './utils/entitlement.util';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/entitlement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/entitlement/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAElD,aAAa;AACb,cAAc,qCAAqC,CAAC;AAEpD,YAAY;AACZ,cAAc,wCAAwC,CAAC;AAEvD,OAAO;AACP,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAEhD,YAAY;AACZ,cAAc,0BAA0B,CAAC"}

package/dist/esm/modules/entitlement/interfaces/entitlement-evaluation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entitlement-evaluation.js.map

package/dist/esm/modules/entitlement/interfaces/entitlement-evaluation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement-evaluation.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/interfaces/entitlement-evaluation.ts"],"names":[],"mappings":""}

package/dist/esm/modules/entitlement/utils/entitlement.util.js

@@ -0,0 +1,42 @@
+import { IncidentEntitlementScope } from '../enums/incident-entitlement-scope.enum';
+import { IncidentEntitlementTier } from '../enums/incident-entitlement-tier.enum';
+import { PremiumTrialStatus } from '../enums/premium-trial-status.enum';
+/**
+ * Whether a tier reaches the provider control room.
+ *
+ * Everything except `FREE` counts as entitled: `NOT_APPLICABLE` covers
+ * grievances and pre-enforcement incidents, which must keep behaving exactly as
+ * they did before entitlement gating existed.
+ */
+export function isEntitledTier(tier) {
+    return tier !== IncidentEntitlementTier.FREE;
+}
+/** Whether an incident was raised by a Free user (no subscription, no trial). */
+export function isFreeUserTier(tier) {
+    return tier === IncidentEntitlementTier.FREE;
+}
+/** True while the trial still grants premium behaviour. */
+export function isTrialUsable(status) {
+    return status === PremiumTrialStatus.ACTIVE;
+}
+/**
+ * Parses a client-supplied entitlement scope. Unknown/absent values fall back to
+ * `ALL` so an unrecognised query string never silently hides incidents.
+ */
+export function parseIncidentEntitlementScope(value) {
+    if (!value)
+        return IncidentEntitlementScope.ALL;
+    const normalized = value.trim().toUpperCase();
+    return Object.values(IncidentEntitlementScope).includes(normalized)
+        ? normalized
+        : IncidentEntitlementScope.ALL;
+}
+/** Whole days remaining until `expiresAt`, floored at zero. */
+export function trialDaysRemaining(expiresAt, now = new Date()) {
+    const end = expiresAt instanceof Date ? expiresAt : new Date(expiresAt);
+    const ms = end.getTime() - now.getTime();
+    if (!Number.isFinite(ms) || ms <= 0)
+        return 0;
+    return Math.ceil(ms / (24 * 60 * 60 * 1000));
+}
+//# sourceMappingURL=entitlement.util.js.map

package/dist/esm/modules/entitlement/utils/entitlement.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement.util.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/utils/entitlement.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAA8C;IACzE,OAAO,IAAI,KAAK,uBAAuB,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,IAA8C;IACzE,OAAO,IAAI,KAAK,uBAAuB,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,MAA2C;IACrE,OAAO,MAAM,KAAK,kBAAkB,CAAC,MAAM,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CACzC,KAAqB;IAErB,IAAI,CAAC,KAAK;QAAE,OAAO,wBAAwB,CAAC,GAAG,CAAC;IAChD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAQ,MAAM,CAAC,MAAM,CAAC,wBAAwB,CAAc,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC7E,CAAC,CAAE,UAAuC;QAC1C,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC;AACvC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB,CAAC,SAAwB,EAAE,MAAY,IAAI,IAAI,EAAE;IAC/E,MAAM,GAAG,GAAG,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACxE,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC"}