grm-shared-library 1.1.192 → 1.1.194

package/dist/esm/modules/alert-dispatch/utils/alert-dispatch.util.js

@@ -0,0 +1,78 @@
+import { isFreeUserTier } from '../../entitlement/utils/entitlement.util';
+import { IncidentDispatchScope } from '../enums/incident-dispatch-scope.enum';
+/**
+ * Whether an incident reaches the provider control room - live map, live list,
+ * kanban, operator assignment and operator notifications.
+ *
+ * Two independent reasons keep an alert out, and this is the single place both
+ * are expressed so no consumer can honour one and forget the other:
+ *
+ *   1. the reporter is a Free user, so the provider was never entitled to it;
+ *   2. the reporter explicitly unchecked the provider option ("Marked Ignore").
+ *
+ * A missing flag counts as dispatched: incidents written before this feature
+ * existed, and every operator-created record, keep their original behaviour.
+ */
+export function reachesControlRoom(incident) {
+    if (!incident)
+        return true;
+    if (isFreeUserTier(incident.entitlementTier))
+        return false;
+    return incident.notifyServiceProvider !== false;
+}
+/** Whether the reporter's guardians should be pulled in and notified. */
+export function reachesGuardians(incident) {
+    return !incident || incident.notifyGuardians !== false;
+}
+/**
+ * Whether the reporter deliberately withheld this alert from the provider, as
+ * opposed to never having been entitled to send it. Only the former belongs in
+ * the "Marked Ignore" admin list; a Free user's alert belongs in
+ * "Incident List - Free Users".
+ */
+export function isMarkedIgnore(incident) {
+    if (!incident)
+        return false;
+    return incident.notifyServiceProvider === false && !isFreeUserTier(incident.entitlementTier);
+}
+/**
+ * Applies dispatch policy to what the client asked for.
+ *
+ * The client's checkboxes are an intent, never the decision: a Free user's
+ * provider option is unchecked and read-only in the app, and this is what makes
+ * that true even for a caller that ignores the UI. Anything the client omits
+ * defaults to "notify", so existing callers (web admin, older app builds) are
+ * unaffected.
+ *
+ * Returns resolved flags only - it deliberately does not reject the
+ * both-off combination, so callers can decide whether that is a validation
+ * error (the SOS path) or simply nobody to notify.
+ */
+export function resolveIncidentAlertDispatch(request) {
+    const applies = request.applies !== false;
+    if (!applies) {
+        return { notifyServiceProvider: true, notifyGuardians: true };
+    }
+    const notifyGuardians = request.notifyGuardians !== false;
+    const notifyServiceProvider = isFreeUserTier(request.tier)
+        ? false
+        : request.notifyServiceProvider !== false;
+    return { notifyServiceProvider, notifyGuardians };
+}
+/** True when an alert would reach nobody at all. */
+export function reachesNobody(dispatch) {
+    return (dispatch === null || dispatch === void 0 ? void 0 : dispatch.notifyServiceProvider) === false && (dispatch === null || dispatch === void 0 ? void 0 : dispatch.notifyGuardians) === false;
+}
+/**
+ * Parses a client-supplied dispatch scope. Unknown/absent values fall back to
+ * `ALL` so an unrecognised query string never silently hides incidents.
+ */
+export function parseIncidentDispatchScope(value) {
+    if (!value)
+        return IncidentDispatchScope.ALL;
+    const normalized = value.trim().toUpperCase();
+    return Object.values(IncidentDispatchScope).includes(normalized)
+        ? normalized
+        : IncidentDispatchScope.ALL;
+}
+//# sourceMappingURL=alert-dispatch.util.js.map

package/dist/esm/modules/alert-dispatch/utils/alert-dispatch.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-dispatch.util.js","sourceRoot":"","sources":["../../../../../src/modules/alert-dispatch/utils/alert-dispatch.util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAG9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAC9B,QAA+F;IAE/F,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,QAAQ,CAAC,qBAAqB,KAAK,KAAK,CAAC;AACpD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,QAA+B;IAC5D,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,eAAe,KAAK,KAAK,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC1B,QAA+F;IAE/F,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,QAAQ,CAAC,qBAAqB,KAAK,KAAK,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AACjG,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAA6B;IACtE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC;IAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC;IAC1D,MAAM,qBAAqB,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC;QACtD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,OAAO,CAAC,qBAAqB,KAAK,KAAK,CAAC;IAE9C,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,CAAC;AACtD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,QAA+B;IACzD,OAAO,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,qBAAqB,MAAK,KAAK,IAAI,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,eAAe,MAAK,KAAK,CAAC;AAC5F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAqB;IAC5D,IAAI,CAAC,KAAK;QAAE,OAAO,qBAAqB,CAAC,GAAG,CAAC;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAQ,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAc,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1E,CAAC,CAAE,UAAoC;QACvC,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC;AACpC,CAAC"}

package/dist/esm/modules/incident/dtos/incident/create-incident.dto.js

@@ -263,4 +263,22 @@ __decorate([
     IsNotEmpty(),
     __metadata("design:type", Number)
 ], CreateIncidentDto.prototype, "organizationId", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: "Whether the service provider's control room should be alerted. Defaults to true.",
+        example: true
+    }),
+    IsBoolean(),
+    IsOptional(),
+    __metadata("design:type", Boolean)
+], CreateIncidentDto.prototype, "notifyServiceProvider", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: "Whether the reporter's guardians should be alerted and added to the incident chat. Defaults to true.",
+        example: true
+    }),
+    IsBoolean(),
+    IsOptional(),
+    __metadata("design:type", Boolean)
+], CreateIncidentDto.prototype, "notifyGuardians", void 0);
 //# sourceMappingURL=create-incident.dto.js.map

package/dist/esm/modules/incident/dtos/incident/create-incident.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-incident.dto.js","sourceRoot":"","sources":["../../../../../../src/modules/incident/dtos/incident/create-incident.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-incident.dto.js","sourceRoot":"","sources":["../../../../../../src/modules/incident/dtos/incident/create-incident.dto.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/incident/dtos/incident/incident.dto.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { IsArray, IsDateString, IsNotEmpty, IsNumber, IsOptional, ValidateNested } from "class-validator";
+import { IsArray, IsDateString, IsEnum, IsNotEmpty, IsNumber, IsOptional, ValidateNested } from "class-validator";
 import { ApiProperty, ApiPropertyOptional, OmitType } from "@nestjs/swagger";
 import { CreateIncidentDto } from "./create-incident.dto";
 import { Type } from "class-transformer";
@@ -18,6 +18,7 @@ import { IncidentAssignmentDto } from "../assignment/incident-assignment.dto";
 import { IncidentResponseUnitAssignmentDto } from "../response-unit-assignment/update-incident-response-unit-assignment.dto";
 import { IncidentReporterDto } from "../reporter/incident-reporter.dto";
 import { IncidentStatusDetailsDto } from "./incident-status-details.dto";
+import { IncidentEntitlementTier } from "../../../entitlement/enums/incident-entitlement-tier.enum";
 export class IncidentDto extends OmitType(CreateIncidentDto, ['reporter', 'statusDetails']) {
 }
 __decorate([
@@ -120,4 +121,14 @@ __decorate([
     IsNotEmpty(),
     __metadata("design:type", String)
 ], IncidentDto.prototype, "updatedAt", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'Premium entitlement tier stamped on the incident at creation',
+        enum: IncidentEntitlementTier,
+        example: IncidentEntitlementTier.PREMIUM
+    }),
+    IsEnum(IncidentEntitlementTier),
+    IsOptional(),
+    __metadata("design:type", String)
+], IncidentDto.prototype, "entitlementTier", void 0);
 //# sourceMappingURL=incident.dto.js.map

package/dist/esm/modules/incident/dtos/incident/incident.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"incident.dto.js","sourceRoot":"","sources":["../../../../../../src/modules/incident/dtos/incident/incident.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"incident.dto.js","sourceRoot":"","sources":["../../../../../../src/modules/incident/dtos/incident/incident.dto.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/system-user/constants/system-user.const.js

@@ -0,0 +1,28 @@
+/**
+ * Canonical environment variable that carries the platform "system user" id.
+ *
+ * The system user is a real row in the clarion-authentication `users` table
+ * that services stamp on records they create or mutate on their own behalf —
+ * i.e. when there is no authenticated human in the request (auto-assignment,
+ * automated status changes, service-to-service document uploads).
+ *
+ * It is deliberately NOT a compile-time constant: it is an environment-specific
+ * database row id, so dev / staging / production each carry their own value.
+ * The library owns the *contract* (key name, parsing, validation, fallback
+ * policy); the deployment owns the *value* (see clarion-deployment configmap).
+ */
+export const SYSTEM_USER_ID_ENV_KEY = 'SYSTEM_USER_ID';
+/**
+ * Per-service keys that predate {@link SYSTEM_USER_ID_ENV_KEY}.
+ *
+ * Still read — in order — when the canonical key is absent, so that a rollback
+ * to an older ConfigMap does not take a service down. Remove once every
+ * environment has been migrated to the canonical key.
+ *
+ * @deprecated Set {@link SYSTEM_USER_ID_ENV_KEY} instead.
+ */
+export const LEGACY_SYSTEM_USER_ID_ENV_KEYS = [
+    'BILLING_DMS_SERVICE_USER_ID',
+    'NEWSFEED_DMS_SERVICE_USER_ID',
+];
+//# sourceMappingURL=system-user.const.js.map

package/dist/esm/modules/system-user/constants/system-user.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-user.const.js","sourceRoot":"","sources":["../../../../../src/modules/system-user/constants/system-user.const.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAsB;IAC7D,6BAA6B;IAC7B,8BAA8B;CACjC,CAAC"}

package/dist/esm/modules/system-user/index.js

@@ -0,0 +1,11 @@
+// Constants
+export * from './constants/system-user.const';
+// Interfaces
+export * from './interfaces/system-user-env-source';
+// Utilities
+export * from './utils/system-user.util';
+// Services
+export * from './services/system-user.service';
+// Module
+export * from './system-user.module';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/system-user/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/system-user/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,cAAc,+BAA+B,CAAC;AAE9C,aAAa;AACb,cAAc,qCAAqC,CAAC;AAEpD,YAAY;AACZ,cAAc,0BAA0B,CAAC;AAEzC,WAAW;AACX,cAAc,gCAAgC,CAAC;AAE/C,SAAS;AACT,cAAc,sBAAsB,CAAC"}

package/dist/esm/modules/system-user/interfaces/system-user-env-source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=system-user-env-source.js.map

package/dist/esm/modules/system-user/interfaces/system-user-env-source.js.map

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

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

@@ -0,0 +1,57 @@
+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;
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { SYSTEM_USER_ID_ENV_KEY } from '../constants/system-user.const';
+import { resolveSystemUserId } from '../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 Logger(SystemUserService_1.name);
+        this.resolvedId = null;
+    }
+    onModuleInit() {
+        this.resolvedId = resolveSystemUserId(this.configService, {
+            onLegacyKeyUsed: (key) => this.logger.warn(`Resolved the system user id from deprecated env key "${key}". ` +
+                `Set ${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 = resolveSystemUserId(this.configService);
+        }
+        return this.resolvedId;
+    }
+};
+SystemUserService = SystemUserService_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [ConfigService])
+], SystemUserService);
+export { SystemUserService };
+//# sourceMappingURL=system-user.service.js.map

package/dist/esm/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,OAAO,EAAE,UAAU,EAAE,MAAM,EAAgB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;;;;;;;;GAWG;AAEI,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAI1B,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;QAHxC,WAAM,GAAG,IAAI,MAAM,CAAC,mBAAiB,CAAC,IAAI,CAAC,CAAC;QACrD,eAAU,GAAkB,IAAI,CAAC;IAEoB,CAAC;IAE9D,YAAY;QACR,IAAI,CAAC,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,aAAa,EAAE;YACtD,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CACZ,wDAAwD,GAAG,KAAK;gBAChE,OAAO,sBAAsB,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,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;CACJ,CAAA;AA5BY,iBAAiB;IAD7B,UAAU,EAAE;qCAKmC,aAAa;GAJhD,iBAAiB,CA4B7B"}

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

@@ -0,0 +1,30 @@
+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;
+};
+import { Global, Module } from '@nestjs/common';
+import { SystemUserService } from './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 {
+};
+SystemUserModule = __decorate([
+    Global(),
+    Module({
+        providers: [SystemUserService],
+        exports: [SystemUserService],
+    })
+], SystemUserModule);
+export { SystemUserModule };
+//# sourceMappingURL=system-user.module.js.map

package/dist/esm/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,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;;;;;;;;;GAUG;AAMI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAI,CAAA;AAApB,gBAAgB;IAL5B,MAAM,EAAE;IACR,MAAM,CAAC;QACJ,SAAS,EAAE,CAAC,iBAAiB,CAAC;QAC9B,OAAO,EAAE,CAAC,iBAAiB,CAAC;KAC/B,CAAC;GACW,gBAAgB,CAAI"}

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

@@ -0,0 +1,53 @@
+import { LEGACY_SYSTEM_USER_ID_ENV_KEYS, SYSTEM_USER_ID_ENV_KEY } from '../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.
+ */
+export 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);
+ */
+export function resolveSystemUserId(source, options = {}) {
+    const { legacyKeys = LEGACY_SYSTEM_USER_ID_ENV_KEYS, fallback, onLegacyKeyUsed } = options;
+    const canonical = parseSystemUserId(source.get(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_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/esm/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":"AACA,OAAO,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAqBxG;;;;;;;GAOG;AACH,MAAM,UAAU,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,MAAM,UAAU,mBAAmB,CAC/B,MAA2B,EAC3B,UAAsC,EAAE;IAExC,MAAM,EAAE,UAAU,GAAG,8BAA8B,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAE3F,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,sBAAsB,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,sBAAsB,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/types/index.d.ts

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

package/dist/types/interfaces/pagination.d.ts

@@ -6,6 +6,7 @@ import { ResponseUnit } from "../modules/response-unit";
 import { User } from "../modules/user";
 import { WebNotification } from "../modules/web-notification";
 import { IncidentEntitlementScope } from "../modules/entitlement/enums/incident-entitlement-scope.enum";
+import { IncidentDispatchScope } from "../modules/alert-dispatch/enums/incident-dispatch-scope.enum";
 export interface CursorPaginatedResponse<T> {
     data: T[];
     nextCursor: string | null;
@@ -26,6 +27,13 @@ export interface PaginationParams {
  */
 export interface IncidentQueryParams extends PaginationParams {
     entitlementScope?: IncidentEntitlementScope;
+    /**
+     * Independent of `entitlementScope`: filters on whether the reporter asked
+     * for the provider to be alerted at all. The control room combines
+     * `ENTITLED` + `DISPATCHED`; the "Incident List - Marked Ignore" view asks
+     * for `ENTITLED` + `SUPPRESSED`. Omitting it applies no dispatch filter.
+     */
+    dispatchScope?: IncidentDispatchScope;
 }
 export interface PaginatedResponse<T> {
     data: T[];

package/dist/types/modules/alert-dispatch/enums/incident-dispatch-scope.enum.d.ts

@@ -0,0 +1,22 @@
+/**
+ * List filter applied to incident queries on the *dispatch* dimension - i.e.
+ * whether the reporter asked for the service provider to be alerted at all.
+ *
+ *   ALL         - no dispatch filter (default; preserves legacy behaviour).
+ *   DISPATCHED  - only incidents the provider was asked to receive. Used by the
+ *                 primary admin incident list, map and kanban views.
+ *   SUPPRESSED  - only incidents the reporter explicitly withheld from the
+ *                 provider. Backs the "Incident List - Marked Ignore" admin
+ *                 view.
+ *
+ * Deliberately separate from {@link IncidentEntitlementScope}: entitlement is a
+ * billing fact about the reporter, dispatch is a choice the reporter made on
+ * this one alert. The two compose - the control room asks for
+ * `ENTITLED` + `DISPATCHED`, "Marked Ignore" asks for `ENTITLED` + `SUPPRESSED`,
+ * and "Free Users" asks for `FREE` on the entitlement dimension alone.
+ */
+export declare enum IncidentDispatchScope {
+    ALL = "ALL",
+    DISPATCHED = "DISPATCHED",
+    SUPPRESSED = "SUPPRESSED"
+}

package/dist/types/modules/alert-dispatch/index.d.ts

@@ -0,0 +1,3 @@
+export * from './enums/incident-dispatch-scope.enum';
+export * from './interfaces/alert-dispatch';
+export * from './utils/alert-dispatch.util';

package/dist/types/modules/alert-dispatch/interfaces/alert-dispatch.d.ts

@@ -0,0 +1,33 @@
+import { IncidentEntitlementTier } from '../../entitlement/enums/incident-entitlement-tier.enum';
+/**
+ * Who an incident's alert was actually dispatched to.
+ *
+ * Both flags are resolved server-side at creation and then stored on the
+ * incident, so every downstream consumer (realtime publisher, notification
+ * service, admin lists, the mobile confirmation dialog) reads one recorded fact
+ * rather than re-deriving policy. `undefined` means "not recorded" and is
+ * always treated as `true`, which is what every incident written before this
+ * existed implicitly did.
+ */
+export interface IncidentAlertDispatch {
+    /**
+     * False when the alert must not reach the provider control room: the
+     * reporter unchecked the option, or they are a Free user who never had it.
+     */
+    notifyServiceProvider?: boolean;
+    /**
+     * False when the reporter's guardians must not be pulled into the incident
+     * chat or notified about the alert.
+     */
+    notifyGuardians?: boolean;
+}
+/** The inputs {@link resolveIncidentAlertDispatch} decides from. */
+export interface AlertDispatchRequest extends IncidentAlertDispatch {
+    /** Entitlement tier already decided for this incident. */
+    tier?: IncidentEntitlementTier | string | null;
+    /**
+     * False for records that predate or sit outside the SOS flow (grievances,
+     * operator-created incidents), which keep both channels on.
+     */
+    applies?: boolean;
+}

package/dist/types/modules/alert-dispatch/utils/alert-dispatch.util.d.ts

@@ -0,0 +1,51 @@
+import { IncidentEntitlementTier } from '../../entitlement/enums/incident-entitlement-tier.enum';
+import { IncidentDispatchScope } from '../enums/incident-dispatch-scope.enum';
+import { AlertDispatchRequest, IncidentAlertDispatch } from '../interfaces/alert-dispatch';
+/**
+ * Whether an incident reaches the provider control room - live map, live list,
+ * kanban, operator assignment and operator notifications.
+ *
+ * Two independent reasons keep an alert out, and this is the single place both
+ * are expressed so no consumer can honour one and forget the other:
+ *
+ *   1. the reporter is a Free user, so the provider was never entitled to it;
+ *   2. the reporter explicitly unchecked the provider option ("Marked Ignore").
+ *
+ * A missing flag counts as dispatched: incidents written before this feature
+ * existed, and every operator-created record, keep their original behaviour.
+ */
+export declare function reachesControlRoom(incident: IncidentAlertDispatch & {
+    entitlementTier?: IncidentEntitlementTier | string | null;
+}): boolean;
+/** Whether the reporter's guardians should be pulled in and notified. */
+export declare function reachesGuardians(incident: IncidentAlertDispatch): boolean;
+/**
+ * Whether the reporter deliberately withheld this alert from the provider, as
+ * opposed to never having been entitled to send it. Only the former belongs in
+ * the "Marked Ignore" admin list; a Free user's alert belongs in
+ * "Incident List - Free Users".
+ */
+export declare function isMarkedIgnore(incident: IncidentAlertDispatch & {
+    entitlementTier?: IncidentEntitlementTier | string | null;
+}): boolean;
+/**
+ * Applies dispatch policy to what the client asked for.
+ *
+ * The client's checkboxes are an intent, never the decision: a Free user's
+ * provider option is unchecked and read-only in the app, and this is what makes
+ * that true even for a caller that ignores the UI. Anything the client omits
+ * defaults to "notify", so existing callers (web admin, older app builds) are
+ * unaffected.
+ *
+ * Returns resolved flags only - it deliberately does not reject the
+ * both-off combination, so callers can decide whether that is a validation
+ * error (the SOS path) or simply nobody to notify.
+ */
+export declare function resolveIncidentAlertDispatch(request: AlertDispatchRequest): Required<IncidentAlertDispatch>;
+/** True when an alert would reach nobody at all. */
+export declare function reachesNobody(dispatch: IncidentAlertDispatch): boolean;
+/**
+ * Parses a client-supplied dispatch scope. Unknown/absent values fall back to
+ * `ALL` so an unrecognised query string never silently hides incidents.
+ */
+export declare function parseIncidentDispatchScope(value?: string | null): IncidentDispatchScope;

package/dist/types/modules/incident/dtos/incident/create-incident.dto.d.ts

@@ -34,4 +34,18 @@ export declare class CreateIncidentDto {
     workflowTaskQueueName: IncidentWorkflowTaskQueueName;
     controlCentreId?: number;
     organizationId: number;
+    /**
+     * Whether the service provider's control room should receive this alert.
+     *
+     * The reporter's choice, not the decision: clarion-incident resolves it
+     * against the reporter's entitlement before storing it (a Free user's option
+     * is always off). Omitting it means "notify", so callers that predate the
+     * option - the web admin, older app builds - are unaffected.
+     */
+    notifyServiceProvider?: boolean;
+    /**
+     * Whether the reporter's guardians should join the incident chat and be
+     * notified. Omitting it means "notify".
+     */
+    notifyGuardians?: boolean;
 }

package/dist/types/modules/incident/dtos/incident/incident.dto.d.ts

@@ -6,6 +6,7 @@ import { IncidentAssignmentDto } from "../assignment/incident-assignment.dto";
 import { IncidentResponseUnitAssignmentDto } from "../response-unit-assignment/update-incident-response-unit-assignment.dto";
 import { IncidentReporterDto } from "../reporter/incident-reporter.dto";
 import { IncidentStatusDetailsDto } from "./incident-status-details.dto";
+import { IncidentEntitlementTier } from "../../../entitlement/enums/incident-entitlement-tier.enum";
 declare const IncidentDto_base: import("@nestjs/common").Type<Omit<CreateIncidentDto, "reporter" | "statusDetails">>;
 export declare class IncidentDto extends IncidentDto_base {
     id: number;
@@ -18,5 +19,12 @@ export declare class IncidentDto extends IncidentDto_base {
     responseUnitAssignments?: IncidentResponseUnitAssignmentDto[];
     createdAt: string;
     updatedAt: string;
+    /**
+     * Premium standing of the reporter when the alert was raised. Server-derived
+     * and read-only; it appears here so Kafka consumers (notably
+     * clarion-notification, which whitelists this DTO) can tell a Free-user
+     * alert from an entitled one without calling back into billing.
+     */
+    entitlementTier?: IncidentEntitlementTier;
 }
 export {};

package/dist/types/modules/incident/intefaces/incident.d.ts

@@ -57,6 +57,15 @@ export interface Incident {
     entitlementTier?: IncidentEntitlementTier;
     /** Point-in-time audit of how `entitlementTier` was decided. */
     entitlementSnapshot?: IncidentEntitlementSnapshot | null;
+    /**
+     * Who the reporter asked to be alerted, resolved against their entitlement
+     * at creation. `false` on the provider flag withholds the incident from the
+     * control room exactly as a Free tier does; `false` on the guardian flag
+     * keeps guardians out of the incident chat and its notifications. Absent on
+     * incidents raised before the options existed, which notified both.
+     */
+    notifyServiceProvider?: boolean;
+    notifyGuardians?: boolean;
     createdAt?: string;
     updatedAt?: string;
     category?: IncidentCategory;

package/dist/types/modules/system-user/constants/system-user.const.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Canonical environment variable that carries the platform "system user" id.
+ *
+ * The system user is a real row in the clarion-authentication `users` table
+ * that services stamp on records they create or mutate on their own behalf —
+ * i.e. when there is no authenticated human in the request (auto-assignment,
+ * automated status changes, service-to-service document uploads).
+ *
+ * It is deliberately NOT a compile-time constant: it is an environment-specific
+ * database row id, so dev / staging / production each carry their own value.
+ * The library owns the *contract* (key name, parsing, validation, fallback
+ * policy); the deployment owns the *value* (see clarion-deployment configmap).
+ */
+export declare const SYSTEM_USER_ID_ENV_KEY = "SYSTEM_USER_ID";
+/**
+ * Per-service keys that predate {@link SYSTEM_USER_ID_ENV_KEY}.
+ *
+ * Still read — in order — when the canonical key is absent, so that a rollback
+ * to an older ConfigMap does not take a service down. Remove once every
+ * environment has been migrated to the canonical key.
+ *
+ * @deprecated Set {@link SYSTEM_USER_ID_ENV_KEY} instead.
+ */
+export declare const LEGACY_SYSTEM_USER_ID_ENV_KEYS: readonly string[];

package/dist/types/modules/system-user/index.d.ts

@@ -0,0 +1,5 @@
+export * from './constants/system-user.const';
+export * from './interfaces/system-user-env-source';
+export * from './utils/system-user.util';
+export * from './services/system-user.service';
+export * from './system-user.module';