grm-shared-library 1.1.193 → 1.1.195

package/dist/cjs/index.js

@@ -37,6 +37,7 @@ __exportStar(require("./modules/country/index"), exports);
 __exportStar(require("./modules/phone/index"), exports);
 __exportStar(require("./modules/tracking/index"), exports);
 __exportStar(require("./modules/entitlement/index"), exports);
+__exportStar(require("./modules/alert-dispatch/index"), exports);
 __exportStar(require("./modules/system-user/index"), exports);
 // Interfaces
 __exportStar(require("./interfaces/server-message"), exports);

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,UAAU;AACV,uDAAqC;AACrC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,uDAAqC;AACrC,iEAA+C;AAC/C,wDAAsC;AACtC,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,mEAAiD;AACjD,+DAA6C;AAC7C,uDAAqC;AACrC,0DAAwC;AACxC,wDAAsC;AACtC,2DAAyC;AACzC,8DAA4C;AAC5C,8DAA4C;AAE5C,aAAa;AACb,8DAA4C;AAC5C,mEAAiD;AACjD,8DAA4C;AAC5C,2DAAyC;AACzC,0DAAwC;AAExC,YAAY;AACZ,2DAAyC;AAEzC,QAAQ;AACR,gDAA8B;AAE9B,YAAY;AACZ,+DAA6C;AAC7C,wFAAsE;AAEtE,aAAa;AACb,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,UAAU;AACV,uDAAqC;AACrC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,uDAAqC;AACrC,iEAA+C;AAC/C,wDAAsC;AACtC,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,mEAAiD;AACjD,+DAA6C;AAC7C,uDAAqC;AACrC,0DAAwC;AACxC,wDAAsC;AACtC,2DAAyC;AACzC,8DAA4C;AAC5C,iEAA+C;AAC/C,8DAA4C;AAE5C,aAAa;AACb,8DAA4C;AAC5C,mEAAiD;AACjD,8DAA4C;AAC5C,2DAAyC;AACzC,0DAAwC;AAExC,YAAY;AACZ,2DAAyC;AAEzC,QAAQ;AACR,gDAA8B;AAE9B,YAAY;AACZ,+DAA6C;AAC7C,wFAAsE;AAEtE,aAAa;AACb,qDAAmC"}

package/dist/cjs/modules/alert-dispatch/enums/incident-dispatch-scope.enum.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IncidentDispatchScope = void 0;
+/**
+ * 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 reporter asked the provider 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 "Marked Ignore" admin views.
+ *
+ * Both read what the reporter ASKED FOR, not what they got. Entitlement can
+ * close the provider channel on its own, and an operator looking at a
+ * "Marked Ignore" list wants the alerts somebody chose to withhold - not the
+ * ones billing withheld for them.
+ *
+ * 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 into the admin's operator views:
+ *
+ *   Incidents (list/map/kanban)        ENTITLED       + DISPATCHED
+ *   Incident List - Marked Ignore      ENTITLED       + SUPPRESSED
+ *   Incident List - Uncovered Types    UNCOVERED_TYPE + DISPATCHED
+ *   Uncovered Types - Marked Ignore    UNCOVERED_TYPE + SUPPRESSED
+ *   Incident List - Free Users         FREE
+ */
+var IncidentDispatchScope;
+(function (IncidentDispatchScope) {
+    IncidentDispatchScope["ALL"] = "ALL";
+    IncidentDispatchScope["DISPATCHED"] = "DISPATCHED";
+    IncidentDispatchScope["SUPPRESSED"] = "SUPPRESSED";
+})(IncidentDispatchScope || (exports.IncidentDispatchScope = IncidentDispatchScope = {}));
+//# sourceMappingURL=incident-dispatch-scope.enum.js.map

package/dist/cjs/modules/alert-dispatch/enums/incident-dispatch-scope.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-dispatch-scope.enum.js","sourceRoot":"","sources":["../../../../../src/modules/alert-dispatch/enums/incident-dispatch-scope.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC7B,oCAAW,CAAA;IACX,kDAAyB,CAAA;IACzB,kDAAyB,CAAA;AAC7B,CAAC,EAJW,qBAAqB,qCAArB,qBAAqB,QAIhC"}

package/dist/cjs/modules/alert-dispatch/index.js

@@ -0,0 +1,23 @@
+"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 });
+// Enums
+__exportStar(require("./enums/incident-dispatch-scope.enum"), exports);
+// Interfaces
+__exportStar(require("./interfaces/alert-dispatch"), exports);
+// Utilities
+__exportStar(require("./utils/alert-dispatch.util"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/alert-dispatch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/alert-dispatch/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,uEAAqD;AAErD,aAAa;AACb,8DAA4C;AAE5C,YAAY;AACZ,8DAA4C"}

package/dist/cjs/modules/alert-dispatch/interfaces/alert-dispatch.js

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

package/dist/cjs/modules/alert-dispatch/interfaces/alert-dispatch.js.map

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

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

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reachesControlRoom = reachesControlRoom;
+exports.reachesGuardians = reachesGuardians;
+exports.isMarkedIgnore = isMarkedIgnore;
+exports.isUncoveredIncidentType = isUncoveredIncidentType;
+exports.isUnentitledReporter = isUnentitledReporter;
+exports.resolveIncidentAlertDispatch = resolveIncidentAlertDispatch;
+exports.reachesNobody = reachesNobody;
+exports.parseIncidentDispatchScope = parseIncidentDispatchScope;
+const entitlement_decision_reason_enum_1 = require("../../entitlement/enums/entitlement-decision-reason.enum");
+const entitlement_util_1 = require("../../entitlement/utils/entitlement.util");
+const incident_dispatch_scope_enum_1 = require("../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 was not entitled to send it (no subscription, or one that
+ *      does not cover this incident type), so the provider was never asked;
+ *   2. the reporter explicitly unchecked the provider option.
+ *
+ * Reads `notifyServiceProvider`, the resolved OUTCOME - never the request.
+ * A missing flag counts as dispatched: incidents written before this feature
+ * existed, and every operator-created record, keep their original behaviour.
+ */
+function reachesControlRoom(incident) {
+    if (!incident)
+        return true;
+    if ((0, entitlement_util_1.isFreeUserTier)(incident.entitlementTier))
+        return false;
+    return incident.notifyServiceProvider !== false;
+}
+/** Whether the reporter's guardians should be pulled in and notified. */
+function reachesGuardians(incident) {
+    return !incident || incident.notifyGuardians !== false;
+}
+/**
+ * Whether the reporter deliberately withheld this alert from the provider.
+ *
+ * Reads the REQUEST, not the outcome. An alert entitlement withheld is not an
+ * alert somebody chose to withhold, and only the second belongs in a
+ * "Marked Ignore" view - a free user never had the option to decline, so their
+ * alert is not "marked ignore" however the resolved flag ended up.
+ *
+ * Independent of entitlement, so it holds equally for a subscriber who declined
+ * on a covered type and one who declined on a type their package excludes.
+ * Which of the two Marked Ignore lists they land in is decided by pairing this
+ * with the entitlement scope.
+ */
+function isMarkedIgnore(incident) {
+    return (incident === null || incident === void 0 ? void 0 : incident.notifyServiceProviderRequested) === false;
+}
+/**
+ * Whether the reporter pays for cover, but not for the incident type they
+ * raised. Distinct from having no entitlement at all: this is a paying customer
+ * finding a gap in their package, not someone to upsell from scratch.
+ */
+function isUncoveredIncidentType(incident) {
+    return (incident === null || incident === void 0 ? void 0 : incident.entitlementReason) === entitlement_decision_reason_enum_1.EntitlementDecisionReason.INCIDENT_TYPE_NOT_COVERED;
+}
+/**
+ * Whether the reporter had no entitlement whatsoever - never subscribed,
+ * lapsed, or a spent/expired trial. Deliberately excludes the uncovered-type
+ * case, which carries the same FREE tier but is a different conversation.
+ */
+function isUnentitledReporter(incident) {
+    return (0, entitlement_util_1.isFreeUserTier)(incident === null || incident === void 0 ? void 0 : incident.entitlementTier) && !isUncoveredIncidentType(incident);
+}
+/**
+ * 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 both what was asked for and what will happen, because the two diverge
+ * exactly when entitlement overrides the reporter - and that difference is what
+ * the admin's Marked Ignore views are built on.
+ *
+ * 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.
+ */
+function resolveIncidentAlertDispatch(request) {
+    const applies = request.applies !== false;
+    if (!applies) {
+        return {
+            notifyServiceProvider: true,
+            notifyGuardians: true,
+            notifyServiceProviderRequested: true,
+        };
+    }
+    const notifyGuardians = request.notifyGuardians !== false;
+    const notifyServiceProviderRequested = request.notifyServiceProvider !== false;
+    const notifyServiceProvider = (0, entitlement_util_1.isFreeUserTier)(request.tier)
+        ? false
+        : notifyServiceProviderRequested;
+    return { notifyServiceProvider, notifyGuardians, notifyServiceProviderRequested };
+}
+/** True when an alert would reach nobody at all. */
+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.
+ */
+function parseIncidentDispatchScope(value) {
+    if (!value)
+        return incident_dispatch_scope_enum_1.IncidentDispatchScope.ALL;
+    const normalized = value.trim().toUpperCase();
+    return Object.values(incident_dispatch_scope_enum_1.IncidentDispatchScope).includes(normalized)
+        ? normalized
+        : incident_dispatch_scope_enum_1.IncidentDispatchScope.ALL;
+}
+//# sourceMappingURL=alert-dispatch.util.js.map

package/dist/cjs/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":";;AA4BA,gDAMC;AAGD,4CAEC;AAeD,wCAIC;AAOD,0DAEC;AAOD,oDAEC;AAmBD,oEAoBC;AAGD,sCAEC;AAMD,gEAMC;AApID,+GAAqG;AAErG,+EAA0E;AAC1E,wFAA8E;AAU9E;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAC9B,QAA0D;IAE1D,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,IAAA,iCAAc,EAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,QAAQ,CAAC,qBAAqB,KAAK,KAAK,CAAC;AACpD,CAAC;AAED,yEAAyE;AACzE,SAAgB,gBAAgB,CAAC,QAA+B;IAC5D,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,eAAe,KAAK,KAAK,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,cAAc,CAC1B,QAAmE;IAEnE,OAAO,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,8BAA8B,MAAK,KAAK,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,QAAkC;IACtE,OAAO,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,iBAAiB,MAAK,4DAAyB,CAAC,yBAAyB,CAAC;AAC/F,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,QAAkC;IACnE,OAAO,IAAA,iCAAc,EAAC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,eAAe,CAAC,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3F,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,4BAA4B,CACxC,OAA6B;IAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC;IAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO;YACH,qBAAqB,EAAE,IAAI;YAC3B,eAAe,EAAE,IAAI;YACrB,8BAA8B,EAAE,IAAI;SACvC,CAAC;IACN,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC;IAC1D,MAAM,8BAA8B,GAAG,OAAO,CAAC,qBAAqB,KAAK,KAAK,CAAC;IAC/E,MAAM,qBAAqB,GAAG,IAAA,iCAAc,EAAC,OAAO,CAAC,IAAI,CAAC;QACtD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,8BAA8B,CAAC;IAErC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,8BAA8B,EAAE,CAAC;AACtF,CAAC;AAED,oDAAoD;AACpD,SAAgB,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,SAAgB,0BAA0B,CAAC,KAAqB;IAC5D,IAAI,CAAC,KAAK;QAAE,OAAO,oDAAqB,CAAC,GAAG,CAAC;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAQ,MAAM,CAAC,MAAM,CAAC,oDAAqB,CAAc,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1E,CAAC,CAAE,UAAoC;QACvC,CAAC,CAAC,oDAAqB,CAAC,GAAG,CAAC;AACpC,CAAC"}

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

@@ -4,16 +4,27 @@ exports.IncidentEntitlementScope = void 0;
 /**
  * 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.
+ *   ALL             — no entitlement filter (default; preserves legacy behaviour).
+ *   ENTITLED        — everything except incidents the reporter was not entitled
+ *                     to send. Used by the primary admin list, map and kanban.
+ *   FREE            — reporters with no entitlement at all: never subscribed,
+ *                     lapsed, or a spent/expired trial. Backs
+ *                     "Incident List - Free Users".
+ *   UNCOVERED_TYPE  — reporters who DO pay, but whose package excludes the
+ *                     incident type they raised. Backs
+ *                     "Incident List - Uncovered Types".
+ *
+ * The last two both carry tier FREE, because that is what billing stamps in
+ * either case, but they are very different situations for an operator: one is
+ * an upsell, the other is a paying customer discovering a gap in their cover.
+ * `FREE` therefore excludes uncovered-type incidents rather than absorbing
+ * them, so the three scopes partition the data with no overlap and no gaps.
  */
 var IncidentEntitlementScope;
 (function (IncidentEntitlementScope) {
     IncidentEntitlementScope["ALL"] = "ALL";
     IncidentEntitlementScope["ENTITLED"] = "ENTITLED";
     IncidentEntitlementScope["FREE"] = "FREE";
+    IncidentEntitlementScope["UNCOVERED_TYPE"] = "UNCOVERED_TYPE";
 })(IncidentEntitlementScope || (exports.IncidentEntitlementScope = IncidentEntitlementScope = {}));
 //# sourceMappingURL=incident-entitlement-scope.enum.js.map

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

@@ -1 +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,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAChC,uCAAW,CAAA;IACX,iDAAqB,CAAA;IACrB,yCAAa,CAAA;AACjB,CAAC,EAJW,wBAAwB,wCAAxB,wBAAwB,QAInC"}
+{"version":3,"file":"incident-entitlement-scope.enum.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/enums/incident-entitlement-scope.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAChC,uCAAW,CAAA;IACX,iDAAqB,CAAA;IACrB,yCAAa,CAAA;IACb,6DAAiC,CAAA;AACrC,CAAC,EALW,wBAAwB,wCAAxB,wBAAwB,QAKnC"}

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

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

package/dist/cjs/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/cjs/modules/incident/dtos/incident/incident.dto.js

@@ -21,6 +21,7 @@ const incident_assignment_dto_1 = require("../assignment/incident-assignment.dto
 const update_incident_response_unit_assignment_dto_1 = require("../response-unit-assignment/update-incident-response-unit-assignment.dto");
 const incident_reporter_dto_1 = require("../reporter/incident-reporter.dto");
 const incident_status_details_dto_1 = require("./incident-status-details.dto");
+const incident_entitlement_tier_enum_1 = require("../../../entitlement/enums/incident-entitlement-tier.enum");
 class IncidentDto extends (0, swagger_1.OmitType)(create_incident_dto_1.CreateIncidentDto, ['reporter', 'statusDetails']) {
 }
 exports.IncidentDto = IncidentDto;
@@ -124,4 +125,14 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], IncidentDto.prototype, "updatedAt", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Premium entitlement tier stamped on the incident at creation',
+        enum: incident_entitlement_tier_enum_1.IncidentEntitlementTier,
+        example: incident_entitlement_tier_enum_1.IncidentEntitlementTier.PREMIUM
+    }),
+    (0, class_validator_1.IsEnum)(incident_entitlement_tier_enum_1.IncidentEntitlementTier),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], IncidentDto.prototype, "entitlementTier", void 0);
 //# sourceMappingURL=incident.dto.js.map

package/dist/cjs/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/index.js

@@ -21,6 +21,7 @@ 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';
 // Interfaces
 export * from './interfaces/server-message';

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;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"}
+{"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,gCAAgC,CAAC;AAC/C,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/alert-dispatch/enums/incident-dispatch-scope.enum.js

@@ -0,0 +1,32 @@
+/**
+ * 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 reporter asked the provider 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 "Marked Ignore" admin views.
+ *
+ * Both read what the reporter ASKED FOR, not what they got. Entitlement can
+ * close the provider channel on its own, and an operator looking at a
+ * "Marked Ignore" list wants the alerts somebody chose to withhold - not the
+ * ones billing withheld for them.
+ *
+ * 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 into the admin's operator views:
+ *
+ *   Incidents (list/map/kanban)        ENTITLED       + DISPATCHED
+ *   Incident List - Marked Ignore      ENTITLED       + SUPPRESSED
+ *   Incident List - Uncovered Types    UNCOVERED_TYPE + DISPATCHED
+ *   Uncovered Types - Marked Ignore    UNCOVERED_TYPE + SUPPRESSED
+ *   Incident List - Free Users         FREE
+ */
+export var IncidentDispatchScope;
+(function (IncidentDispatchScope) {
+    IncidentDispatchScope["ALL"] = "ALL";
+    IncidentDispatchScope["DISPATCHED"] = "DISPATCHED";
+    IncidentDispatchScope["SUPPRESSED"] = "SUPPRESSED";
+})(IncidentDispatchScope || (IncidentDispatchScope = {}));
+//# sourceMappingURL=incident-dispatch-scope.enum.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"incident-dispatch-scope.enum.js","sourceRoot":"","sources":["../../../../../src/modules/alert-dispatch/enums/incident-dispatch-scope.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAN,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC7B,oCAAW,CAAA;IACX,kDAAyB,CAAA;IACzB,kDAAyB,CAAA;AAC7B,CAAC,EAJW,qBAAqB,KAArB,qBAAqB,QAIhC"}

package/dist/esm/modules/alert-dispatch/index.js

@@ -0,0 +1,7 @@
+// Enums
+export * from './enums/incident-dispatch-scope.enum';
+// Interfaces
+export * from './interfaces/alert-dispatch';
+// Utilities
+export * from './utils/alert-dispatch.util';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/alert-dispatch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/alert-dispatch/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,sCAAsC,CAAC;AAErD,aAAa;AACb,cAAc,6BAA6B,CAAC;AAE5C,YAAY;AACZ,cAAc,6BAA6B,CAAC"}

package/dist/esm/modules/alert-dispatch/interfaces/alert-dispatch.js

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

package/dist/esm/modules/alert-dispatch/interfaces/alert-dispatch.js.map

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

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

@@ -0,0 +1,111 @@
+import { EntitlementDecisionReason } from '../../entitlement/enums/entitlement-decision-reason.enum';
+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 was not entitled to send it (no subscription, or one that
+ *      does not cover this incident type), so the provider was never asked;
+ *   2. the reporter explicitly unchecked the provider option.
+ *
+ * Reads `notifyServiceProvider`, the resolved OUTCOME - never the request.
+ * 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.
+ *
+ * Reads the REQUEST, not the outcome. An alert entitlement withheld is not an
+ * alert somebody chose to withhold, and only the second belongs in a
+ * "Marked Ignore" view - a free user never had the option to decline, so their
+ * alert is not "marked ignore" however the resolved flag ended up.
+ *
+ * Independent of entitlement, so it holds equally for a subscriber who declined
+ * on a covered type and one who declined on a type their package excludes.
+ * Which of the two Marked Ignore lists they land in is decided by pairing this
+ * with the entitlement scope.
+ */
+export function isMarkedIgnore(incident) {
+    return (incident === null || incident === void 0 ? void 0 : incident.notifyServiceProviderRequested) === false;
+}
+/**
+ * Whether the reporter pays for cover, but not for the incident type they
+ * raised. Distinct from having no entitlement at all: this is a paying customer
+ * finding a gap in their package, not someone to upsell from scratch.
+ */
+export function isUncoveredIncidentType(incident) {
+    return (incident === null || incident === void 0 ? void 0 : incident.entitlementReason) === EntitlementDecisionReason.INCIDENT_TYPE_NOT_COVERED;
+}
+/**
+ * Whether the reporter had no entitlement whatsoever - never subscribed,
+ * lapsed, or a spent/expired trial. Deliberately excludes the uncovered-type
+ * case, which carries the same FREE tier but is a different conversation.
+ */
+export function isUnentitledReporter(incident) {
+    return isFreeUserTier(incident === null || incident === void 0 ? void 0 : incident.entitlementTier) && !isUncoveredIncidentType(incident);
+}
+/**
+ * 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 both what was asked for and what will happen, because the two diverge
+ * exactly when entitlement overrides the reporter - and that difference is what
+ * the admin's Marked Ignore views are built on.
+ *
+ * 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,
+            notifyServiceProviderRequested: true,
+        };
+    }
+    const notifyGuardians = request.notifyGuardians !== false;
+    const notifyServiceProviderRequested = request.notifyServiceProvider !== false;
+    const notifyServiceProvider = isFreeUserTier(request.tier)
+        ? false
+        : notifyServiceProviderRequested;
+    return { notifyServiceProvider, notifyGuardians, notifyServiceProviderRequested };
+}
+/** 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":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0DAA0D,CAAC;AAErG,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAU9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAC9B,QAA0D;IAE1D,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;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC1B,QAAmE;IAEnE,OAAO,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,8BAA8B,MAAK,KAAK,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkC;IACtE,OAAO,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,iBAAiB,MAAK,yBAAyB,CAAC,yBAAyB,CAAC;AAC/F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAkC;IACnE,OAAO,cAAc,CAAC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,eAAe,CAAC,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3F,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,4BAA4B,CACxC,OAA6B;IAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC;IAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO;YACH,qBAAqB,EAAE,IAAI;YAC3B,eAAe,EAAE,IAAI;YACrB,8BAA8B,EAAE,IAAI;SACvC,CAAC;IACN,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC;IAC1D,MAAM,8BAA8B,GAAG,OAAO,CAAC,qBAAqB,KAAK,KAAK,CAAC;IAC/E,MAAM,qBAAqB,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC;QACtD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,8BAA8B,CAAC;IAErC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,8BAA8B,EAAE,CAAC;AACtF,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/entitlement/enums/incident-entitlement-scope.enum.js

@@ -1,16 +1,27 @@
 /**
  * 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.
+ *   ALL             — no entitlement filter (default; preserves legacy behaviour).
+ *   ENTITLED        — everything except incidents the reporter was not entitled
+ *                     to send. Used by the primary admin list, map and kanban.
+ *   FREE            — reporters with no entitlement at all: never subscribed,
+ *                     lapsed, or a spent/expired trial. Backs
+ *                     "Incident List - Free Users".
+ *   UNCOVERED_TYPE  — reporters who DO pay, but whose package excludes the
+ *                     incident type they raised. Backs
+ *                     "Incident List - Uncovered Types".
+ *
+ * The last two both carry tier FREE, because that is what billing stamps in
+ * either case, but they are very different situations for an operator: one is
+ * an upsell, the other is a paying customer discovering a gap in their cover.
+ * `FREE` therefore excludes uncovered-type incidents rather than absorbing
+ * them, so the three scopes partition the data with no overlap and no gaps.
  */
 export var IncidentEntitlementScope;
 (function (IncidentEntitlementScope) {
     IncidentEntitlementScope["ALL"] = "ALL";
     IncidentEntitlementScope["ENTITLED"] = "ENTITLED";
     IncidentEntitlementScope["FREE"] = "FREE";
+    IncidentEntitlementScope["UNCOVERED_TYPE"] = "UNCOVERED_TYPE";
 })(IncidentEntitlementScope || (IncidentEntitlementScope = {}));
 //# sourceMappingURL=incident-entitlement-scope.enum.js.map

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

@@ -1 +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"}
+{"version":3,"file":"incident-entitlement-scope.enum.js","sourceRoot":"","sources":["../../../../../src/modules/entitlement/enums/incident-entitlement-scope.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAN,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAChC,uCAAW,CAAA;IACX,iDAAqB,CAAA;IACrB,yCAAa,CAAA;IACb,6DAAiC,CAAA;AACrC,CAAC,EALW,wBAAwB,KAAxB,wBAAwB,QAKnC"}

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/types/index.d.ts

@@ -20,6 +20,7 @@ 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';

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,30 @@
+/**
+ * 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 reporter asked the provider 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 "Marked Ignore" admin views.
+ *
+ * Both read what the reporter ASKED FOR, not what they got. Entitlement can
+ * close the provider channel on its own, and an operator looking at a
+ * "Marked Ignore" list wants the alerts somebody chose to withhold - not the
+ * ones billing withheld for them.
+ *
+ * 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 into the admin's operator views:
+ *
+ *   Incidents (list/map/kanban)        ENTITLED       + DISPATCHED
+ *   Incident List - Marked Ignore      ENTITLED       + SUPPRESSED
+ *   Incident List - Uncovered Types    UNCOVERED_TYPE + DISPATCHED
+ *   Uncovered Types - Marked Ignore    UNCOVERED_TYPE + SUPPRESSED
+ *   Incident List - Free Users         FREE
+ */
+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,46 @@
+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;
+    /**
+     * What the reporter actually asked for, before entitlement had its say.
+     *
+     * Kept apart from `notifyServiceProvider` because that one records the
+     * OUTCOME, and once entitlement forces it false the reporter's own choice
+     * is no longer recoverable from it. The distinction is the whole basis of
+     * the "Marked Ignore" views: an alert billing withheld is not an alert
+     * somebody chose to withhold.
+     *
+     * Absent on incidents raised before the option existed, and on records the
+     * option does not govern - both of which count as "did not withhold".
+     */
+    notifyServiceProviderRequested?: 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,79 @@
+import { EntitlementDecisionReason } from '../../entitlement/enums/entitlement-decision-reason.enum';
+import { IncidentEntitlementTier } from '../../entitlement/enums/incident-entitlement-tier.enum';
+import { IncidentDispatchScope } from '../enums/incident-dispatch-scope.enum';
+import { AlertDispatchRequest, IncidentAlertDispatch } from '../interfaces/alert-dispatch';
+/** The two entitlement facts an incident carries, as the helpers below read them. */
+export interface IncidentEntitlementFacts {
+    entitlementTier?: IncidentEntitlementTier | string | null;
+    /** Promoted out of the entitlement snapshot so it can be filtered and indexed. */
+    entitlementReason?: EntitlementDecisionReason | string | null;
+}
+/**
+ * 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 was not entitled to send it (no subscription, or one that
+ *      does not cover this incident type), so the provider was never asked;
+ *   2. the reporter explicitly unchecked the provider option.
+ *
+ * Reads `notifyServiceProvider`, the resolved OUTCOME - never the request.
+ * 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 & IncidentEntitlementFacts): 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.
+ *
+ * Reads the REQUEST, not the outcome. An alert entitlement withheld is not an
+ * alert somebody chose to withhold, and only the second belongs in a
+ * "Marked Ignore" view - a free user never had the option to decline, so their
+ * alert is not "marked ignore" however the resolved flag ended up.
+ *
+ * Independent of entitlement, so it holds equally for a subscriber who declined
+ * on a covered type and one who declined on a type their package excludes.
+ * Which of the two Marked Ignore lists they land in is decided by pairing this
+ * with the entitlement scope.
+ */
+export declare function isMarkedIgnore(incident: IncidentAlertDispatch & Partial<IncidentEntitlementFacts>): boolean;
+/**
+ * Whether the reporter pays for cover, but not for the incident type they
+ * raised. Distinct from having no entitlement at all: this is a paying customer
+ * finding a gap in their package, not someone to upsell from scratch.
+ */
+export declare function isUncoveredIncidentType(incident: IncidentEntitlementFacts): boolean;
+/**
+ * Whether the reporter had no entitlement whatsoever - never subscribed,
+ * lapsed, or a spent/expired trial. Deliberately excludes the uncovered-type
+ * case, which carries the same FREE tier but is a different conversation.
+ */
+export declare function isUnentitledReporter(incident: IncidentEntitlementFacts): 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 both what was asked for and what will happen, because the two diverge
+ * exactly when entitlement overrides the reporter - and that difference is what
+ * the admin's Marked Ignore views are built on.
+ *
+ * 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/entitlement/enums/incident-entitlement-scope.enum.d.ts

@@ -1,14 +1,25 @@
 /**
  * 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.
+ *   ALL             — no entitlement filter (default; preserves legacy behaviour).
+ *   ENTITLED        — everything except incidents the reporter was not entitled
+ *                     to send. Used by the primary admin list, map and kanban.
+ *   FREE            — reporters with no entitlement at all: never subscribed,
+ *                     lapsed, or a spent/expired trial. Backs
+ *                     "Incident List - Free Users".
+ *   UNCOVERED_TYPE  — reporters who DO pay, but whose package excludes the
+ *                     incident type they raised. Backs
+ *                     "Incident List - Uncovered Types".
+ *
+ * The last two both carry tier FREE, because that is what billing stamps in
+ * either case, but they are very different situations for an operator: one is
+ * an upsell, the other is a paying customer discovering a gap in their cover.
+ * `FREE` therefore excludes uncovered-type incidents rather than absorbing
+ * them, so the three scopes partition the data with no overlap and no gaps.
  */
 export declare enum IncidentEntitlementScope {
     ALL = "ALL",
     ENTITLED = "ENTITLED",
-    FREE = "FREE"
+    FREE = "FREE",
+    UNCOVERED_TYPE = "UNCOVERED_TYPE"
 }

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

@@ -16,6 +16,7 @@ import { IncidentReport } from "./incident-report";
 import { IncidentEmergencyType } from "../enums/incident-emergency-type.enum";
 import { IncidentEntitlementSnapshot } from "../../entitlement/interfaces/entitlement-evaluation";
 import { IncidentEntitlementTier } from "../../entitlement/enums/incident-entitlement-tier.enum";
+import { EntitlementDecisionReason } from "../../entitlement/enums/entitlement-decision-reason.enum";
 export interface Incident {
     id?: number;
     appId: IncidentAppId;
@@ -57,6 +58,29 @@ export interface Incident {
     entitlementTier?: IncidentEntitlementTier;
     /** Point-in-time audit of how `entitlementTier` was decided. */
     entitlementSnapshot?: IncidentEntitlementSnapshot | null;
+    /**
+     * Why `entitlementTier` came out the way it did, promoted out of the
+     * snapshot so it can be filtered and indexed. It is what separates a
+     * reporter with no entitlement at all from a paying one whose package
+     * excludes the incident type they raised - both carry tier FREE, but they
+     * are different conversations and get their own admin views.
+     */
+    entitlementReason?: EntitlementDecisionReason;
+    /**
+     * 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;
+    /**
+     * What the reporter asked for before entitlement had its say. The
+     * "Marked Ignore" views read this rather than the outcome above: an alert
+     * billing withheld is not an alert somebody chose to withhold.
+     */
+    notifyServiceProviderRequested?: boolean;
     createdAt?: string;
     updatedAt?: string;
     category?: IncidentCategory;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grm-shared-library",
-  "version": "1.1.193",
+  "version": "1.1.195",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",