clarion-shared-types 1.0.84 → 1.0.85

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

@@ -6,17 +6,25 @@ exports.IncidentDispatchScope = void 0;
  * 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.
+ *   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 "Incident List - Marked Ignore" admin
- *                 view.
+ *                 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 - the control room asks for
- * `ENTITLED` + `DISPATCHED`, "Marked Ignore" asks for `ENTITLED` + `SUPPRESSED`,
- * and "Free Users" asks for `FREE` on the entitlement dimension alone.
+ * 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) {

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

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

@@ -3,9 +3,12 @@ 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");
 /**
@@ -15,9 +18,11 @@ const incident_dispatch_scope_enum_1 = require("../enums/incident-dispatch-scope
  * 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").
+ *   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.
  */
@@ -33,15 +38,36 @@ 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".
+ * 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) {
-    if (!incident)
-        return false;
-    return incident.notifyServiceProvider === false && !(0, entitlement_util_1.isFreeUserTier)(incident.entitlementTier);
+    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.
@@ -52,20 +78,29 @@ function isMarkedIgnore(incident) {
  * 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.
+ * 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 };
+        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
-        : request.notifyServiceProvider !== false;
-    return { notifyServiceProvider, notifyGuardians };
+        : notifyServiceProviderRequested;
+    return { notifyServiceProvider, notifyGuardians, notifyServiceProviderRequested };
 }
 /** True when an alert would reach nobody at all. */
 function reachesNobody(dispatch) {

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

@@ -1 +1 @@
-{"version":3,"file":"alert-dispatch.util.js","sourceRoot":"","sources":["../../../../../src/modules/alert-dispatch/utils/alert-dispatch.util.ts"],"names":[],"mappings":";;AAkBA,gDAMC;AAGD,4CAEC;AAQD,wCAKC;AAeD,oEAaC;AAGD,sCAEC;AAMD,gEAMC;AAtFD,+EAA0E;AAC1E,wFAA8E;AAG9E;;;;;;;;;;;;GAYG;AACH,SAAgB,kBAAkB,CAC9B,QAA+F;IAE/F,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;;;;;GAKG;AACH,SAAgB,cAAc,CAC1B,QAA+F;IAE/F,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,QAAQ,CAAC,qBAAqB,KAAK,KAAK,IAAI,CAAC,IAAA,iCAAc,EAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AACjG,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,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,IAAA,iCAAc,EAAC,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,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"}
+{"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/esm/modules/alert-dispatch/enums/incident-dispatch-scope.enum.js

@@ -3,17 +3,25 @@
  * 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.
+ *   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 "Incident List - Marked Ignore" admin
- *                 view.
+ *                 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 - the control room asks for
- * `ENTITLED` + `DISPATCHED`, "Marked Ignore" asks for `ENTITLED` + `SUPPRESSED`,
- * and "Free Users" asks for `FREE` on the entitlement dimension alone.
+ * 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) {

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

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

@@ -1,3 +1,4 @@
+import { EntitlementDecisionReason } from '../../entitlement/enums/entitlement-decision-reason.enum';
 import { isFreeUserTier } from '../../entitlement/utils/entitlement.util';
 import { IncidentDispatchScope } from '../enums/incident-dispatch-scope.enum';
 /**
@@ -7,9 +8,11 @@ import { IncidentDispatchScope } from '../enums/incident-dispatch-scope.enum';
  * 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").
+ *   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.
  */
@@ -25,15 +28,36 @@ 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".
+ * 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) {
-    if (!incident)
-        return false;
-    return incident.notifyServiceProvider === false && !isFreeUserTier(incident.entitlementTier);
+    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.
@@ -44,20 +68,29 @@ export function isMarkedIgnore(incident) {
  * 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.
+ * 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 };
+        return {
+            notifyServiceProvider: true,
+            notifyGuardians: true,
+            notifyServiceProviderRequested: true,
+        };
     }
     const notifyGuardians = request.notifyGuardians !== false;
+    const notifyServiceProviderRequested = request.notifyServiceProvider !== false;
     const notifyServiceProvider = isFreeUserTier(request.tier)
         ? false
-        : request.notifyServiceProvider !== false;
-    return { notifyServiceProvider, notifyGuardians };
+        : notifyServiceProviderRequested;
+    return { notifyServiceProvider, notifyGuardians, notifyServiceProviderRequested };
 }
 /** True when an alert would reach nobody at all. */
 export function reachesNobody(dispatch) {

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

@@ -1 +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"}
+{"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/types/modules/alert-dispatch/enums/incident-dispatch-scope.enum.d.ts

@@ -3,17 +3,25 @@
  * 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.
+ *   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 "Incident List - Marked Ignore" admin
- *                 view.
+ *                 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 - the control room asks for
- * `ENTITLED` + `DISPATCHED`, "Marked Ignore" asks for `ENTITLED` + `SUPPRESSED`,
- * and "Free Users" asks for `FREE` on the entitlement dimension alone.
+ * 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",

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

@@ -20,6 +20,19 @@ export interface IncidentAlertDispatch {
      * 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 {

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

@@ -1,6 +1,13 @@
+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.
@@ -8,26 +15,43 @@ import { AlertDispatchRequest, IncidentAlertDispatch } from '../interfaces/alert
  * 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").
+ *   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 & {
-    entitlementTier?: IncidentEntitlementTier | string | null;
-}): boolean;
+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, 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".
+ * 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 & {
-    entitlementTier?: IncidentEntitlementTier | string | null;
-}): boolean;
+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.
  *
@@ -37,9 +61,13 @@ export declare function isMarkedIgnore(incident: IncidentAlertDispatch & {
  * 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.
+ * 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. */

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/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;
@@ -52,6 +53,14 @@ 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
@@ -62,6 +71,12 @@ export interface Incident {
      */
     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": "clarion-shared-types",
-  "version": "1.0.84",
+  "version": "1.0.85",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",