clarion-shared-types 1.0.82 → 1.0.83

package/dist/cjs/index.js

@@ -35,6 +35,7 @@ __exportStar(require("./modules/chat/index"), exports);
 __exportStar(require("./modules/country/index"), exports);
 __exportStar(require("./modules/tracking/index"), exports);
 __exportStar(require("./modules/entitlement/index"), exports);
+__exportStar(require("./modules/alert-dispatch/index"), exports);
 // Interfaces
 __exportStar(require("./modules/common/interfaces/server-message"), exports);
 __exportStar(require("./modules/common/interfaces/pagination"), 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,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,mEAAiD;AACjD,+DAA6C;AAC7C,uDAAqC;AACrC,0DAAwC;AACxC,2DAAyC;AACzC,8DAA4C;AAE5C,aAAa;AACb,6EAA2D;AAC3D,yEAAuD"}
+{"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,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,mEAAiD;AACjD,+DAA6C;AAC7C,uDAAqC;AACrC,0DAAwC;AACxC,2DAAyC;AACzC,8DAA4C;AAC5C,iEAA+C;AAE/C,aAAa;AACb,6EAA2D;AAC3D,yEAAuD"}

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

@@ -0,0 +1,27 @@
+"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 provider was asked to receive. Used by the
+ *                 primary admin incident list, map and kanban views.
+ *   SUPPRESSED  - only incidents the reporter explicitly withheld from the
+ *                 provider. Backs the "Incident List - Marked Ignore" admin
+ *                 view.
+ *
+ * Deliberately separate from {@link IncidentEntitlementScope}: entitlement is a
+ * billing fact about the reporter, dispatch is a choice the reporter made on
+ * this one alert. The two compose - the control room asks for
+ * `ENTITLED` + `DISPATCHED`, "Marked Ignore" asks for `ENTITLED` + `SUPPRESSED`,
+ * and "Free Users" asks for `FREE` on the entitlement dimension alone.
+ */
+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;;;;;;;;;;;;;;;;GAgBG;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,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reachesControlRoom = reachesControlRoom;
+exports.reachesGuardians = reachesGuardians;
+exports.isMarkedIgnore = isMarkedIgnore;
+exports.resolveIncidentAlertDispatch = resolveIncidentAlertDispatch;
+exports.reachesNobody = reachesNobody;
+exports.parseIncidentDispatchScope = parseIncidentDispatchScope;
+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 is a Free user, so the provider was never entitled to it;
+ *   2. the reporter explicitly unchecked the provider option ("Marked Ignore").
+ *
+ * A missing flag counts as dispatched: incidents written before this feature
+ * existed, and every operator-created record, keep their original behaviour.
+ */
+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, 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".
+ */
+function isMarkedIgnore(incident) {
+    if (!incident)
+        return false;
+    return incident.notifyServiceProvider === false && !(0, entitlement_util_1.isFreeUserTier)(incident.entitlementTier);
+}
+/**
+ * Applies dispatch policy to what the client asked for.
+ *
+ * The client's checkboxes are an intent, never the decision: a Free user's
+ * provider option is unchecked and read-only in the app, and this is what makes
+ * that true even for a caller that ignores the UI. Anything the client omits
+ * defaults to "notify", so existing callers (web admin, older app builds) are
+ * unaffected.
+ *
+ * Returns resolved flags only - it deliberately does not reject the
+ * both-off combination, so callers can decide whether that is a validation
+ * error (the SOS path) or simply nobody to notify.
+ */
+function resolveIncidentAlertDispatch(request) {
+    const applies = request.applies !== false;
+    if (!applies) {
+        return { notifyServiceProvider: true, notifyGuardians: true };
+    }
+    const notifyGuardians = request.notifyGuardians !== false;
+    const notifyServiceProvider = (0, entitlement_util_1.isFreeUserTier)(request.tier)
+        ? false
+        : request.notifyServiceProvider !== false;
+    return { notifyServiceProvider, notifyGuardians };
+}
+/** 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":";;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"}

package/dist/esm/index.js

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

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,+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,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAE5C,aAAa;AACb,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,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,+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,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAE/C,aAAa;AACb,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC"}

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

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

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

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

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

package/dist/types/index.d.ts

@@ -18,5 +18,6 @@ export * from './modules/chat/index';
 export * from './modules/country/index';
 export * from './modules/tracking/index';
 export * from './modules/entitlement/index';
+export * from './modules/alert-dispatch/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

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

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

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

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

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

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clarion-shared-types",
-  "version": "1.0.82",
+  "version": "1.0.83",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",