clarion-shared-types 1.0.84 → 1.0.86

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/esm/modules/partner/enums/partner-enums.js

@@ -0,0 +1,125 @@
+/**
+ * Frontend mirrors of the partner enums in grm-shared-library.
+ *
+ * Kept in ONE file rather than one per enum: the admin's partner screens import
+ * most of them together, and the set only means anything as a whole. The values
+ * are byte-identical to the backend's, because they travel over the wire as
+ * strings and any drift would show up as a silently unstyled chip rather than a
+ * compile error.
+ */
+/** The third-party partner behind a partnership. */
+export var PartnerProviderCode;
+(function (PartnerProviderCode) {
+    PartnerProviderCode["RESCUE_CO"] = "RESCUE_CO";
+    PartnerProviderCode["AAR"] = "AAR";
+    PartnerProviderCode["ST_JOHN"] = "ST_JOHN";
+    PartnerProviderCode["GENERIC_REST"] = "GENERIC_REST";
+})(PartnerProviderCode || (PartnerProviderCode = {}));
+/** A class of emergency service a partner can be asked to provide. */
+export var PartnerServiceCapability;
+(function (PartnerServiceCapability) {
+    PartnerServiceCapability["AMBULANCE"] = "AMBULANCE";
+    PartnerServiceCapability["MEDICAL_EVACUATION"] = "MEDICAL_EVACUATION";
+    PartnerServiceCapability["FIRE_RESPONSE"] = "FIRE_RESPONSE";
+    PartnerServiceCapability["SECURITY_RESPONSE"] = "SECURITY_RESPONSE";
+    PartnerServiceCapability["ROADSIDE_ASSISTANCE"] = "ROADSIDE_ASSISTANCE";
+    PartnerServiceCapability["TOWING"] = "TOWING";
+    PartnerServiceCapability["OTHER"] = "OTHER";
+})(PartnerServiceCapability || (PartnerServiceCapability = {}));
+/** How an incident a partnership covers reaches the partner. */
+export var PartnerRoutingMode;
+(function (PartnerRoutingMode) {
+    /** Sent as soon as the incident is created. */
+    PartnerRoutingMode["AUTO"] = "AUTO";
+    /** Held until an operator confirms it. */
+    PartnerRoutingMode["MANUAL"] = "MANUAL";
+    /** Configuration kept, nothing routed. */
+    PartnerRoutingMode["DISABLED"] = "DISABLED";
+})(PartnerRoutingMode || (PartnerRoutingMode = {}));
+/** Which of a partner's environments a partnership points at. */
+export var PartnerIntegrationEnvironment;
+(function (PartnerIntegrationEnvironment) {
+    PartnerIntegrationEnvironment["SANDBOX"] = "SANDBOX";
+    PartnerIntegrationEnvironment["PRODUCTION"] = "PRODUCTION";
+})(PartnerIntegrationEnvironment || (PartnerIntegrationEnvironment = {}));
+/** Last known health of a partnership's connection. Advisory only. */
+export var PartnerIntegrationStatus;
+(function (PartnerIntegrationStatus) {
+    PartnerIntegrationStatus["UNKNOWN"] = "UNKNOWN";
+    PartnerIntegrationStatus["HEALTHY"] = "HEALTHY";
+    PartnerIntegrationStatus["DEGRADED"] = "DEGRADED";
+    PartnerIntegrationStatus["UNREACHABLE"] = "UNREACHABLE";
+})(PartnerIntegrationStatus || (PartnerIntegrationStatus = {}));
+/** What a coverage rule matches an incident on. */
+export var PartnerCoverageMatchType;
+(function (PartnerCoverageMatchType) {
+    PartnerCoverageMatchType["ALL"] = "ALL";
+    PartnerCoverageMatchType["INCIDENT_TYPE"] = "INCIDENT_TYPE";
+    PartnerCoverageMatchType["INCIDENT_CATEGORY"] = "INCIDENT_CATEGORY";
+    PartnerCoverageMatchType["EMERGENCY_TYPE"] = "EMERGENCY_TYPE";
+})(PartnerCoverageMatchType || (PartnerCoverageMatchType = {}));
+/** Lifecycle of one incident's routing to one partner. */
+export var PartnerDispatchStatus;
+(function (PartnerDispatchStatus) {
+    PartnerDispatchStatus["PENDING_APPROVAL"] = "PENDING_APPROVAL";
+    PartnerDispatchStatus["QUEUED"] = "QUEUED";
+    PartnerDispatchStatus["SENDING"] = "SENDING";
+    PartnerDispatchStatus["SENT"] = "SENT";
+    PartnerDispatchStatus["ACKNOWLEDGED"] = "ACKNOWLEDGED";
+    PartnerDispatchStatus["FAILED"] = "FAILED";
+    PartnerDispatchStatus["REJECTED"] = "REJECTED";
+    PartnerDispatchStatus["CANCELLED"] = "CANCELLED";
+    PartnerDispatchStatus["EXPIRED"] = "EXPIRED";
+})(PartnerDispatchStatus || (PartnerDispatchStatus = {}));
+/** Why a dispatch did not reach its partner. */
+export var PartnerDispatchFailureReason;
+(function (PartnerDispatchFailureReason) {
+    PartnerDispatchFailureReason["INVALID_PAYLOAD"] = "INVALID_PAYLOAD";
+    PartnerDispatchFailureReason["MISSING_REQUIRED_FIELD"] = "MISSING_REQUIRED_FIELD";
+    PartnerDispatchFailureReason["AUTHENTICATION_FAILED"] = "AUTHENTICATION_FAILED";
+    PartnerDispatchFailureReason["FEATURE_NOT_ENABLED"] = "FEATURE_NOT_ENABLED";
+    PartnerDispatchFailureReason["PROVIDER_REJECTED"] = "PROVIDER_REJECTED";
+    PartnerDispatchFailureReason["ADAPTER_NOT_SUPPORTED"] = "ADAPTER_NOT_SUPPORTED";
+    PartnerDispatchFailureReason["INTEGRATION_DISABLED"] = "INTEGRATION_DISABLED";
+    PartnerDispatchFailureReason["CREDENTIAL_UNAVAILABLE"] = "CREDENTIAL_UNAVAILABLE";
+    PartnerDispatchFailureReason["RATE_LIMITED"] = "RATE_LIMITED";
+    PartnerDispatchFailureReason["PROVIDER_UNAVAILABLE"] = "PROVIDER_UNAVAILABLE";
+    PartnerDispatchFailureReason["TIMEOUT"] = "TIMEOUT";
+    PartnerDispatchFailureReason["MAX_ATTEMPTS_EXCEEDED"] = "MAX_ATTEMPTS_EXCEEDED";
+    PartnerDispatchFailureReason["UNKNOWN"] = "UNKNOWN";
+})(PartnerDispatchFailureReason || (PartnerDispatchFailureReason = {}));
+/** How the location attached to a dispatch was obtained. */
+export var PartnerLocationProvider;
+(function (PartnerLocationProvider) {
+    PartnerLocationProvider["GPS"] = "GPS";
+    PartnerLocationProvider["NETWORK"] = "NETWORK";
+    PartnerLocationProvider["FUSED"] = "FUSED";
+})(PartnerLocationProvider || (PartnerLocationProvider = {}));
+/** The outbound partner call an attempt record describes. */
+export var PartnerAdapterOperation;
+(function (PartnerAdapterOperation) {
+    PartnerAdapterOperation["AUTHENTICATE"] = "AUTHENTICATE";
+    PartnerAdapterOperation["HEALTH_CHECK"] = "HEALTH_CHECK";
+    PartnerAdapterOperation["DISPATCH"] = "DISPATCH";
+})(PartnerAdapterOperation || (PartnerAdapterOperation = {}));
+/** The incident-side summary of third-party routing, stored on the incident row. */
+export var IncidentPartnerRoutingStatus;
+(function (IncidentPartnerRoutingStatus) {
+    IncidentPartnerRoutingStatus["NOT_ROUTED"] = "NOT_ROUTED";
+    IncidentPartnerRoutingStatus["PENDING"] = "PENDING";
+    IncidentPartnerRoutingStatus["AWAITING_APPROVAL"] = "AWAITING_APPROVAL";
+    IncidentPartnerRoutingStatus["ROUTED"] = "ROUTED";
+    IncidentPartnerRoutingStatus["PARTIALLY_ROUTED"] = "PARTIALLY_ROUTED";
+    IncidentPartnerRoutingStatus["FAILED"] = "FAILED";
+    IncidentPartnerRoutingStatus["DECLINED"] = "DECLINED";
+})(IncidentPartnerRoutingStatus || (IncidentPartnerRoutingStatus = {}));
+/** List filter for the admin's partner-routing incident views. */
+export var PartnerDispatchScope;
+(function (PartnerDispatchScope) {
+    PartnerDispatchScope["ALL"] = "ALL";
+    PartnerDispatchScope["ROUTED"] = "ROUTED";
+    PartnerDispatchScope["AWAITING_APPROVAL"] = "AWAITING_APPROVAL";
+    PartnerDispatchScope["FAILED"] = "FAILED";
+    PartnerDispatchScope["NOT_ROUTED"] = "NOT_ROUTED";
+})(PartnerDispatchScope || (PartnerDispatchScope = {}));
+//# sourceMappingURL=partner-enums.js.map

package/dist/esm/modules/partner/enums/partner-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partner-enums.js","sourceRoot":"","sources":["../../../../../src/modules/partner/enums/partner-enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oDAAoD;AACpD,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC3B,8CAAuB,CAAA;IACvB,kCAAW,CAAA;IACX,0CAAmB,CAAA;IACnB,oDAA6B,CAAA;AACjC,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AAED,sEAAsE;AACtE,MAAM,CAAN,IAAY,wBAQX;AARD,WAAY,wBAAwB;IAChC,mDAAuB,CAAA;IACvB,qEAAyC,CAAA;IACzC,2DAA+B,CAAA;IAC/B,mEAAuC,CAAA;IACvC,uEAA2C,CAAA;IAC3C,6CAAiB,CAAA;IACjB,2CAAe,CAAA;AACnB,CAAC,EARW,wBAAwB,KAAxB,wBAAwB,QAQnC;AAED,gEAAgE;AAChE,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC1B,+CAA+C;IAC/C,mCAAa,CAAA;IACb,0CAA0C;IAC1C,uCAAiB,CAAA;IACjB,0CAA0C;IAC1C,2CAAqB,CAAA;AACzB,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B;AAED,iEAAiE;AACjE,MAAM,CAAN,IAAY,6BAGX;AAHD,WAAY,6BAA6B;IACrC,oDAAmB,CAAA;IACnB,0DAAyB,CAAA;AAC7B,CAAC,EAHW,6BAA6B,KAA7B,6BAA6B,QAGxC;AAED,sEAAsE;AACtE,MAAM,CAAN,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAChC,+CAAmB,CAAA;IACnB,+CAAmB,CAAA;IACnB,iDAAqB,CAAA;IACrB,uDAA2B,CAAA;AAC/B,CAAC,EALW,wBAAwB,KAAxB,wBAAwB,QAKnC;AAED,mDAAmD;AACnD,MAAM,CAAN,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAChC,uCAAW,CAAA;IACX,2DAA+B,CAAA;IAC/B,mEAAuC,CAAA;IACvC,6DAAiC,CAAA;AACrC,CAAC,EALW,wBAAwB,KAAxB,wBAAwB,QAKnC;AAED,0DAA0D;AAC1D,MAAM,CAAN,IAAY,qBAUX;AAVD,WAAY,qBAAqB;IAC7B,8DAAqC,CAAA;IACrC,0CAAiB,CAAA;IACjB,4CAAmB,CAAA;IACnB,sCAAa,CAAA;IACb,sDAA6B,CAAA;IAC7B,0CAAiB,CAAA;IACjB,8CAAqB,CAAA;IACrB,gDAAuB,CAAA;IACvB,4CAAmB,CAAA;AACvB,CAAC,EAVW,qBAAqB,KAArB,qBAAqB,QAUhC;AAED,gDAAgD;AAChD,MAAM,CAAN,IAAY,4BAcX;AAdD,WAAY,4BAA4B;IACpC,mEAAmC,CAAA;IACnC,iFAAiD,CAAA;IACjD,+EAA+C,CAAA;IAC/C,2EAA2C,CAAA;IAC3C,uEAAuC,CAAA;IACvC,+EAA+C,CAAA;IAC/C,6EAA6C,CAAA;IAC7C,iFAAiD,CAAA;IACjD,6DAA6B,CAAA;IAC7B,6EAA6C,CAAA;IAC7C,mDAAmB,CAAA;IACnB,+EAA+C,CAAA;IAC/C,mDAAmB,CAAA;AACvB,CAAC,EAdW,4BAA4B,KAA5B,4BAA4B,QAcvC;AAED,4DAA4D;AAC5D,MAAM,CAAN,IAAY,uBAIX;AAJD,WAAY,uBAAuB;IAC/B,sCAAW,CAAA;IACX,8CAAmB,CAAA;IACnB,0CAAe,CAAA;AACnB,CAAC,EAJW,uBAAuB,KAAvB,uBAAuB,QAIlC;AAED,6DAA6D;AAC7D,MAAM,CAAN,IAAY,uBAIX;AAJD,WAAY,uBAAuB;IAC/B,wDAA6B,CAAA;IAC7B,wDAA6B,CAAA;IAC7B,gDAAqB,CAAA;AACzB,CAAC,EAJW,uBAAuB,KAAvB,uBAAuB,QAIlC;AAED,oFAAoF;AACpF,MAAM,CAAN,IAAY,4BAQX;AARD,WAAY,4BAA4B;IACpC,yDAAyB,CAAA;IACzB,mDAAmB,CAAA;IACnB,uEAAuC,CAAA;IACvC,iDAAiB,CAAA;IACjB,qEAAqC,CAAA;IACrC,iDAAiB,CAAA;IACjB,qDAAqB,CAAA;AACzB,CAAC,EARW,4BAA4B,KAA5B,4BAA4B,QAQvC;AAED,kEAAkE;AAClE,MAAM,CAAN,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,mCAAW,CAAA;IACX,yCAAiB,CAAA;IACjB,+DAAuC,CAAA;IACvC,yCAAiB,CAAA;IACjB,iDAAyB,CAAA;AAC7B,CAAC,EANW,oBAAoB,KAApB,oBAAoB,QAM/B"}

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

@@ -0,0 +1,11 @@
+// Enums
+export * from './enums/partner-enums';
+// Interfaces / DTOs
+export * from './interfaces/partner-provider.dto';
+export * from './interfaces/partner-integration.dto';
+export * from './interfaces/partner-coverage-rule.dto';
+export * from './interfaces/partner-dispatch.dto';
+export * from './interfaces/incident-partner-routing.dto';
+// Utilities
+export * from './utils/partner-display.util';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/partner/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,uBAAuB,CAAC;AAEtC,oBAAoB;AACpB,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAE1D,YAAY;AACZ,cAAc,8BAA8B,CAAC"}

package/dist/esm/modules/partner/interfaces/incident-partner-routing.dto.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=incident-partner-routing.dto.js.map

package/dist/esm/modules/partner/interfaces/incident-partner-routing.dto.js.map

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

package/dist/esm/modules/partner/interfaces/partner-coverage-rule.dto.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=partner-coverage-rule.dto.js.map

package/dist/esm/modules/partner/interfaces/partner-coverage-rule.dto.js.map

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

package/dist/esm/modules/partner/interfaces/partner-dispatch.dto.js

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

package/dist/esm/modules/partner/interfaces/partner-dispatch.dto.js.map

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

package/dist/esm/modules/partner/interfaces/partner-integration.dto.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=partner-integration.dto.js.map

package/dist/esm/modules/partner/interfaces/partner-integration.dto.js.map

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

package/dist/esm/modules/partner/interfaces/partner-provider.dto.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=partner-provider.dto.js.map

package/dist/esm/modules/partner/interfaces/partner-provider.dto.js.map

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

package/dist/esm/modules/partner/utils/partner-display.util.js

@@ -0,0 +1,110 @@
+import { IncidentPartnerRoutingStatus, PartnerCoverageMatchType, PartnerDispatchStatus, PartnerIntegrationStatus, PartnerRoutingMode, PartnerServiceCapability, } from '../enums/partner-enums';
+/**
+ * Human labels for the partner enums.
+ *
+ * Kept in the shared package rather than in the admin app so every screen that
+ * shows a dispatch - the list, the detail drawer, the incident view - names the
+ * same state the same way. An operator reading "Waiting for confirmation" in one
+ * place and "Pending approval" in another would reasonably assume they were
+ * different things.
+ */
+export const PARTNER_DISPATCH_STATUS_LABELS = {
+    [PartnerDispatchStatus.PENDING_APPROVAL]: 'Waiting for confirmation',
+    [PartnerDispatchStatus.QUEUED]: 'Queued',
+    [PartnerDispatchStatus.SENDING]: 'Sending',
+    [PartnerDispatchStatus.SENT]: 'Sent to partner',
+    [PartnerDispatchStatus.ACKNOWLEDGED]: 'Acknowledged by partner',
+    [PartnerDispatchStatus.FAILED]: 'Failed',
+    [PartnerDispatchStatus.REJECTED]: 'Declined',
+    [PartnerDispatchStatus.CANCELLED]: 'Withdrawn',
+    [PartnerDispatchStatus.EXPIRED]: 'Expired',
+};
+export const INCIDENT_PARTNER_ROUTING_STATUS_LABELS = {
+    [IncidentPartnerRoutingStatus.NOT_ROUTED]: 'No partner',
+    [IncidentPartnerRoutingStatus.PENDING]: 'Contacting partner',
+    [IncidentPartnerRoutingStatus.AWAITING_APPROVAL]: 'Waiting for confirmation',
+    [IncidentPartnerRoutingStatus.ROUTED]: 'Partner notified',
+    [IncidentPartnerRoutingStatus.PARTIALLY_ROUTED]: 'Partly notified',
+    [IncidentPartnerRoutingStatus.FAILED]: 'Partner not reached',
+    [IncidentPartnerRoutingStatus.DECLINED]: 'Declined',
+};
+export const PARTNER_ROUTING_MODE_LABELS = {
+    [PartnerRoutingMode.AUTO]: 'Automatic',
+    [PartnerRoutingMode.MANUAL]: 'Needs confirmation',
+    [PartnerRoutingMode.DISABLED]: 'Routing off',
+};
+export const PARTNER_INTEGRATION_STATUS_LABELS = {
+    [PartnerIntegrationStatus.UNKNOWN]: 'Not tested',
+    [PartnerIntegrationStatus.HEALTHY]: 'Healthy',
+    [PartnerIntegrationStatus.DEGRADED]: 'Degraded',
+    [PartnerIntegrationStatus.UNREACHABLE]: 'Unreachable',
+};
+export const PARTNER_CAPABILITY_LABELS = {
+    [PartnerServiceCapability.AMBULANCE]: 'Ambulance',
+    [PartnerServiceCapability.MEDICAL_EVACUATION]: 'Medical evacuation',
+    [PartnerServiceCapability.FIRE_RESPONSE]: 'Fire response',
+    [PartnerServiceCapability.SECURITY_RESPONSE]: 'Security response',
+    [PartnerServiceCapability.ROADSIDE_ASSISTANCE]: 'Roadside assistance',
+    [PartnerServiceCapability.TOWING]: 'Towing',
+    [PartnerServiceCapability.OTHER]: 'Other',
+};
+export const PARTNER_COVERAGE_MATCH_TYPE_LABELS = {
+    [PartnerCoverageMatchType.ALL]: 'Every incident',
+    [PartnerCoverageMatchType.INCIDENT_TYPE]: 'Incident type',
+    [PartnerCoverageMatchType.INCIDENT_CATEGORY]: 'Incident category',
+    [PartnerCoverageMatchType.EMERGENCY_TYPE]: 'Emergency classification',
+};
+/**
+ * Chip family for a dispatch status, matching the admin's existing chip
+ * vocabulary: `success` for anything the partner has, `warn` for anything still
+ * needing a human, `danger` for a failure, `neutral` for a settled non-event.
+ */
+export function partnerDispatchStatusTone(status) {
+    switch (status) {
+        case PartnerDispatchStatus.SENT:
+        case PartnerDispatchStatus.ACKNOWLEDGED:
+            return 'success';
+        case PartnerDispatchStatus.PENDING_APPROVAL:
+        case PartnerDispatchStatus.QUEUED:
+        case PartnerDispatchStatus.SENDING:
+            return 'warn';
+        case PartnerDispatchStatus.FAILED:
+        case PartnerDispatchStatus.EXPIRED:
+            return 'danger';
+        default:
+            return 'neutral';
+    }
+}
+/** The same tone mapping for the incident-level rolled-up status. */
+export function incidentPartnerRoutingTone(status) {
+    switch (status) {
+        case IncidentPartnerRoutingStatus.ROUTED:
+            return 'success';
+        case IncidentPartnerRoutingStatus.PENDING:
+        case IncidentPartnerRoutingStatus.AWAITING_APPROVAL:
+        case IncidentPartnerRoutingStatus.PARTIALLY_ROUTED:
+            return 'warn';
+        case IncidentPartnerRoutingStatus.FAILED:
+            return 'danger';
+        default:
+            return 'neutral';
+    }
+}
+/**
+ * Whether an operator can act on a dispatch, so a table can enable or hide its
+ * buttons without duplicating the backend's transition rules.
+ *
+ * Withdrawing is deliberately impossible once the partner has the emergency:
+ * standing an ambulance down is a phone call to the partner, not a button here.
+ */
+export function partnerDispatchActions(status) {
+    const pending = status === PartnerDispatchStatus.PENDING_APPROVAL;
+    return {
+        canApprove: pending,
+        canReject: pending,
+        canCancel: pending || status === PartnerDispatchStatus.QUEUED,
+        canResend: status === PartnerDispatchStatus.FAILED ||
+            status === PartnerDispatchStatus.EXPIRED,
+    };
+}
+//# sourceMappingURL=partner-display.util.js.map

package/dist/esm/modules/partner/utils/partner-display.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partner-display.util.js","sourceRoot":"","sources":["../../../../../src/modules/partner/utils/partner-display.util.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -19,5 +19,6 @@ export * from './modules/country/index';
 export * from './modules/tracking/index';
 export * from './modules/entitlement/index';
 export * from './modules/alert-dispatch/index';
+export * from './modules/partner/index';
 export * from './modules/common/interfaces/server-message';
 export * from './modules/common/interfaces/pagination';

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. */