grm-shared-library 1.1.236 → 1.1.237

package/dist/cjs/modules/dispatch/dtos/update-response-unit-dispatch-status.dto.js

@@ -0,0 +1,41 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateResponseUnitDispatchStatusDto = exports.SETTABLE_RESPONSE_UNIT_DISPATCH_STATUSES = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const response_unit_dispatch_defaults_const_1 = require("../constants/response-unit-dispatch-defaults.const");
+const response_unit_dispatch_status_enum_1 = require("../enums/response-unit-dispatch-status.enum");
+/** Every status a dispatch can be MOVED to (DISPATCHED is only ever its first). */
+exports.SETTABLE_RESPONSE_UNIT_DISPATCH_STATUSES = [
+    response_unit_dispatch_status_enum_1.ResponseUnitDispatchStatus.ACKNOWLEDGED,
+    response_unit_dispatch_status_enum_1.ResponseUnitDispatchStatus.EN_ROUTE,
+    response_unit_dispatch_status_enum_1.ResponseUnitDispatchStatus.ON_SCENE,
+    response_unit_dispatch_status_enum_1.ResponseUnitDispatchStatus.COMPLETED,
+    response_unit_dispatch_status_enum_1.ResponseUnitDispatchStatus.CANCELLED,
+];
+/** `POST /incidents/:id/response-unit-dispatches/:dispatchId/status`. */
+class UpdateResponseUnitDispatchStatusDto {
+}
+exports.UpdateResponseUnitDispatchStatusDto = UpdateResponseUnitDispatchStatusDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: exports.SETTABLE_RESPONSE_UNIT_DISPATCH_STATUSES, example: response_unit_dispatch_status_enum_1.ResponseUnitDispatchStatus.ON_SCENE }),
+    (0, class_validator_1.IsIn)(exports.SETTABLE_RESPONSE_UNIT_DISPATCH_STATUSES),
+    __metadata("design:type", String)
+], UpdateResponseUnitDispatchStatusDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ maxLength: response_unit_dispatch_defaults_const_1.RESPONSE_UNIT_DISPATCH_FIELD_LIMITS.statusReason }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(response_unit_dispatch_defaults_const_1.RESPONSE_UNIT_DISPATCH_FIELD_LIMITS.statusReason),
+    __metadata("design:type", String)
+], UpdateResponseUnitDispatchStatusDto.prototype, "reason", void 0);
+//# sourceMappingURL=update-response-unit-dispatch-status.dto.js.map

package/dist/cjs/modules/dispatch/dtos/update-response-unit-dispatch-status.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-response-unit-dispatch-status.dto.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/dtos/update-response-unit-dispatch-status.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAAwE;AACxE,8GAAyG;AACzG,oGAAyF;AAEzF,mFAAmF;AACtE,QAAA,wCAAwC,GAA0C;IAC3F,+DAA0B,CAAC,YAAY;IACvC,+DAA0B,CAAC,QAAQ;IACnC,+DAA0B,CAAC,QAAQ;IACnC,+DAA0B,CAAC,SAAS;IACpC,+DAA0B,CAAC,SAAS;CACvC,CAAC;AAEF,yEAAyE;AACzE,MAAa,mCAAmC;CAW/C;AAXD,kFAWC;AARG;IAFC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,gDAAwC,EAAE,OAAO,EAAE,+DAA0B,CAAC,QAAQ,EAAE,CAAC;IAC7G,IAAA,sBAAI,EAAC,gDAAwE,CAAC;;mEAC3C;AAOpC;IAJC,IAAA,6BAAmB,EAAC,EAAE,SAAS,EAAE,2EAAmC,CAAC,YAAY,EAAE,CAAC;IACpF,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,2EAAmC,CAAC,YAAY,CAAC;;mEAC5C"}

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IncidentDispatchBlocker = void 0;
+/** Why an INCIDENT cannot take a response-unit dispatch, whatever unit is chosen. */
+var IncidentDispatchBlocker;
+(function (IncidentDispatchBlocker) {
+    /** Resolved, closed, unresolved or archived. */
+    IncidentDispatchBlocker["INCIDENT_ENDED"] = "INCIDENT_ENDED";
+    /** A grievance, not an emergency. */
+    IncidentDispatchBlocker["NOT_AN_EMERGENCY_INCIDENT"] = "NOT_AN_EMERGENCY_INCIDENT";
+    /**
+     * The incident does not reach the control room: the reporter was not
+     * entitled to a provider response, or declined one. Sending a unit IS the
+     * provider response, so the rule that keeps the alert off the control room's
+     * screens also keeps it from being dispatched - see `reachesControlRoom`.
+     */
+    IncidentDispatchBlocker["PROVIDER_RESPONSE_NOT_REQUESTED"] = "PROVIDER_RESPONSE_NOT_REQUESTED";
+    /** Response-unit dispatch is switched off platform-wide. */
+    IncidentDispatchBlocker["DISPATCH_DISABLED"] = "DISPATCH_DISABLED";
+})(IncidentDispatchBlocker || (exports.IncidentDispatchBlocker = IncidentDispatchBlocker = {}));
+//# sourceMappingURL=incident-dispatch-blocker.enum.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"incident-dispatch-blocker.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/incident-dispatch-blocker.enum.ts"],"names":[],"mappings":";;;AAAA,qFAAqF;AACrF,IAAY,uBAcX;AAdD,WAAY,uBAAuB;IAC/B,gDAAgD;IAChD,4DAAiC,CAAA;IACjC,qCAAqC;IACrC,kFAAuD,CAAA;IACvD;;;;;OAKG;IACH,8FAAmE,CAAA;IACnE,4DAA4D;IAC5D,kEAAuC,CAAA;AAC3C,CAAC,EAdW,uBAAuB,uCAAvB,uBAAuB,QAclC"}

package/dist/cjs/modules/dispatch/enums/response-capability-requirement-source.enum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseCapabilityRequirementSource = void 0;
+/** Where an incident's capability requirement came from. */
+var ResponseCapabilityRequirementSource;
+(function (ResponseCapabilityRequirementSource) {
+    ResponseCapabilityRequirementSource["INCIDENT_TYPE"] = "INCIDENT_TYPE";
+    ResponseCapabilityRequirementSource["INCIDENT_CATEGORY"] = "INCIDENT_CATEGORY";
+    /** Neither the type nor the category names one. */
+    ResponseCapabilityRequirementSource["NONE"] = "NONE";
+})(ResponseCapabilityRequirementSource || (exports.ResponseCapabilityRequirementSource = ResponseCapabilityRequirementSource = {}));
+//# sourceMappingURL=response-capability-requirement-source.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-capability-requirement-source.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-capability-requirement-source.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-capability-requirement-source.enum.ts"],"names":[],"mappings":";;;AAAA,4DAA4D;AAC5D,IAAY,mCAKX;AALD,WAAY,mCAAmC;IAC3C,sEAA+B,CAAA;IAC/B,8EAAuC,CAAA;IACvC,mDAAmD;IACnD,oDAAa,CAAA;AACjB,CAAC,EALW,mCAAmC,mDAAnC,mCAAmC,QAK9C"}

package/dist/cjs/modules/dispatch/enums/response-unit-capability-match.enum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitCapabilityMatch = void 0;
+/**
+ * How a unit's capabilities compare with what the incident needs.
+ *
+ * UNKNOWN and NOT_SUITED are deliberately different answers: UNKNOWN means
+ * nobody said what the unit does (it ranks below a match but stays
+ * recommendable), NOT_SUITED means somebody did and it is not this. Treating
+ * missing configuration as "not suitable" would hide every unit of an
+ * organization that has not configured capabilities yet.
+ */
+var ResponseUnitCapabilityMatch;
+(function (ResponseUnitCapabilityMatch) {
+    /** The incident needs a capability and the unit has one of them. */
+    ResponseUnitCapabilityMatch["MATCH"] = "MATCH";
+    /** The incident's type and category name no requirement - any unit fits. */
+    ResponseUnitCapabilityMatch["NOT_REQUIRED"] = "NOT_REQUIRED";
+    /** The incident needs a capability; the unit's capabilities are unknown. */
+    ResponseUnitCapabilityMatch["UNKNOWN"] = "UNKNOWN";
+    /** The unit's known capabilities do not include what the incident needs. */
+    ResponseUnitCapabilityMatch["NOT_SUITED"] = "NOT_SUITED";
+})(ResponseUnitCapabilityMatch || (exports.ResponseUnitCapabilityMatch = ResponseUnitCapabilityMatch = {}));
+//# sourceMappingURL=response-unit-capability-match.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-capability-match.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-capability-match.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-capability-match.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,IAAY,2BASX;AATD,WAAY,2BAA2B;IACnC,oEAAoE;IACpE,8CAAe,CAAA;IACf,4EAA4E;IAC5E,4DAA6B,CAAA;IAC7B,4EAA4E;IAC5E,kDAAmB,CAAA;IACnB,4EAA4E;IAC5E,wDAAyB,CAAA;AAC7B,CAAC,EATW,2BAA2B,2CAA3B,2BAA2B,QAStC"}

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-constraint.enum.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitDispatchConstraint = void 0;
+/**
+ * Why a unit cannot be dispatched (a BLOCKER) or, while it can be dispatched by
+ * hand, is not recommended (a CAUTION). One vocabulary for both so the admin
+ * explains either with the same words.
+ */
+var ResponseUnitDispatchConstraint;
+(function (ResponseUnitDispatchConstraint) {
+    // ---- Blockers: the server refuses a dispatch of this unit ----
+    /** Switched off in the organization. */
+    ResponseUnitDispatchConstraint["INACTIVE"] = "INACTIVE";
+    /** Non-operational, off duty, on leave or in training. */
+    ResponseUnitDispatchConstraint["OPERATIONALLY_UNAVAILABLE"] = "OPERATIONALLY_UNAVAILABLE";
+    /** Out on another job (an active dispatch, or a manual Engaged / On Mission status). */
+    ResponseUnitDispatchConstraint["ENGAGED"] = "ENGAGED";
+    /** Already has an active dispatch to THIS incident. */
+    ResponseUnitDispatchConstraint["ALREADY_DISPATCHED"] = "ALREADY_DISPATCHED";
+    /** Belongs to another control centre and cross-control-centre dispatch is off. */
+    ResponseUnitDispatchConstraint["OTHER_CONTROL_CENTRE"] = "OTHER_CONTROL_CENTRE";
+    /** Not suited, and the platform is configured to require a capability match. */
+    ResponseUnitDispatchConstraint["CAPABILITY_REQUIRED"] = "CAPABILITY_REQUIRED";
+    // ---- Cautions: dispatchable by hand, never recommended ----
+    /** Its known capabilities do not include what the incident needs. */
+    ResponseUnitDispatchConstraint["NOT_SUITED"] = "NOT_SUITED";
+    /** No position at all, or the tracking service has it offline. */
+    ResponseUnitDispatchConstraint["NO_LOCATION"] = "NO_LOCATION";
+    /** A stale live fix, and stale positions are configured not to be recommended. */
+    ResponseUnitDispatchConstraint["LOCATION_STALE"] = "LOCATION_STALE";
+    /** Live-tracked, but outside the search radius. */
+    ResponseUnitDispatchConstraint["OUTSIDE_SEARCH_AREA"] = "OUTSIDE_SEARCH_AREA";
+})(ResponseUnitDispatchConstraint || (exports.ResponseUnitDispatchConstraint = ResponseUnitDispatchConstraint = {}));
+//# sourceMappingURL=response-unit-dispatch-constraint.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-constraint.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-dispatch-constraint.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-dispatch-constraint.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,8BAwBX;AAxBD,WAAY,8BAA8B;IACtC,iEAAiE;IACjE,wCAAwC;IACxC,uDAAqB,CAAA;IACrB,0DAA0D;IAC1D,yFAAuD,CAAA;IACvD,wFAAwF;IACxF,qDAAmB,CAAA;IACnB,uDAAuD;IACvD,2EAAyC,CAAA;IACzC,kFAAkF;IAClF,+EAA6C,CAAA;IAC7C,gFAAgF;IAChF,6EAA2C,CAAA;IAE3C,8DAA8D;IAC9D,qEAAqE;IACrE,2DAAyB,CAAA;IACzB,kEAAkE;IAClE,6DAA2B,CAAA;IAC3B,kFAAkF;IAClF,mEAAiC,CAAA;IACjC,mDAAmD;IACnD,6EAA2C,CAAA;AAC/C,CAAC,EAxBW,8BAA8B,8CAA9B,8BAA8B,QAwBzC"}

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-error-code.enum.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitDispatchErrorCode = void 0;
+/**
+ * Machine-readable codes on a refused recommend/dispatch request (the `code` of
+ * the error body), so a client can react without parsing a sentence. A 409 says
+ * "the world changed since you looked - refresh"; other 4xx say "this was never
+ * going to work".
+ */
+var ResponseUnitDispatchErrorCode;
+(function (ResponseUnitDispatchErrorCode) {
+    ResponseUnitDispatchErrorCode["INCIDENT_NOT_DISPATCHABLE"] = "INCIDENT_NOT_DISPATCHABLE";
+    ResponseUnitDispatchErrorCode["RESPONSE_UNIT_NOT_FOUND"] = "RESPONSE_UNIT_NOT_FOUND";
+    ResponseUnitDispatchErrorCode["RESPONSE_UNIT_NOT_DISPATCHABLE"] = "RESPONSE_UNIT_NOT_DISPATCHABLE";
+    /** Another dispatcher got there first - the unit is out on a job. */
+    ResponseUnitDispatchErrorCode["RESPONSE_UNIT_ENGAGED"] = "RESPONSE_UNIT_ENGAGED";
+    ResponseUnitDispatchErrorCode["RESPONSE_UNIT_ALREADY_DISPATCHED"] = "RESPONSE_UNIT_ALREADY_DISPATCHED";
+    /** The same Idempotency-Key was used for a different unit. */
+    ResponseUnitDispatchErrorCode["IDEMPOTENCY_KEY_REUSED"] = "IDEMPOTENCY_KEY_REUSED";
+    ResponseUnitDispatchErrorCode["DISPATCH_NOT_FOUND"] = "DISPATCH_NOT_FOUND";
+    ResponseUnitDispatchErrorCode["INVALID_STATUS_TRANSITION"] = "INVALID_STATUS_TRANSITION";
+    ResponseUnitDispatchErrorCode["NOTIFICATION_NOT_RESENDABLE"] = "NOTIFICATION_NOT_RESENDABLE";
+    /** clarion-organization could not be reached: nothing can be verified, so nothing is sent. */
+    ResponseUnitDispatchErrorCode["ORGANIZATION_UNAVAILABLE"] = "ORGANIZATION_UNAVAILABLE";
+})(ResponseUnitDispatchErrorCode || (exports.ResponseUnitDispatchErrorCode = ResponseUnitDispatchErrorCode = {}));
+//# sourceMappingURL=response-unit-dispatch-error-code.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-error-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-dispatch-error-code.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-dispatch-error-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,6BAcX;AAdD,WAAY,6BAA6B;IACrC,wFAAuD,CAAA;IACvD,oFAAmD,CAAA;IACnD,kGAAiE,CAAA;IACjE,qEAAqE;IACrE,gFAA+C,CAAA;IAC/C,sGAAqE,CAAA;IACrE,8DAA8D;IAC9D,kFAAiD,CAAA;IACjD,0EAAyC,CAAA;IACzC,wFAAuD,CAAA;IACvD,4FAA2D,CAAA;IAC3D,8FAA8F;IAC9F,sFAAqD,CAAA;AACzD,CAAC,EAdW,6BAA6B,6CAA7B,6BAA6B,QAcxC"}

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-notification-failure.enum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitDispatchNotificationFailure = void 0;
+/** Why a dispatch message was not sent. */
+var ResponseUnitDispatchNotificationFailure;
+(function (ResponseUnitDispatchNotificationFailure) {
+    /** The unit has no phone number. */
+    ResponseUnitDispatchNotificationFailure["NO_PHONE_NUMBER"] = "NO_PHONE_NUMBER";
+    /** The number on the unit is not one any provider can send to. */
+    ResponseUnitDispatchNotificationFailure["INVALID_PHONE_NUMBER"] = "INVALID_PHONE_NUMBER";
+    /** Every provider in the country's chain failed. */
+    ResponseUnitDispatchNotificationFailure["PROVIDER_FAILURE"] = "PROVIDER_FAILURE";
+    /** No SMS provider is configured for the number's country. */
+    ResponseUnitDispatchNotificationFailure["NOT_CONFIGURED"] = "NOT_CONFIGURED";
+    /** clarion-notification never answered, so nobody knows. Sending again is the remedy. */
+    ResponseUnitDispatchNotificationFailure["NO_RESPONSE"] = "NO_RESPONSE";
+})(ResponseUnitDispatchNotificationFailure || (exports.ResponseUnitDispatchNotificationFailure = ResponseUnitDispatchNotificationFailure = {}));
+//# sourceMappingURL=response-unit-dispatch-notification-failure.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-notification-failure.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-dispatch-notification-failure.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-dispatch-notification-failure.enum.ts"],"names":[],"mappings":";;;AAAA,2CAA2C;AAC3C,IAAY,uCAWX;AAXD,WAAY,uCAAuC;IAC/C,oCAAoC;IACpC,8EAAmC,CAAA;IACnC,kEAAkE;IAClE,wFAA6C,CAAA;IAC7C,oDAAoD;IACpD,gFAAqC,CAAA;IACrC,8DAA8D;IAC9D,4EAAiC,CAAA;IACjC,yFAAyF;IACzF,sEAA2B,CAAA;AAC/B,CAAC,EAXW,uCAAuC,uDAAvC,uCAAuC,QAWlD"}

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-notification-status.enum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitDispatchNotificationStatus = void 0;
+/** What happened to the message telling the unit it was dispatched. */
+var ResponseUnitDispatchNotificationStatus;
+(function (ResponseUnitDispatchNotificationStatus) {
+    /** Requested from clarion-notification; no answer yet. */
+    ResponseUnitDispatchNotificationStatus["PENDING"] = "PENDING";
+    /** A provider accepted it. (Handset delivery is not tracked by the platform.) */
+    ResponseUnitDispatchNotificationStatus["SENT"] = "SENT";
+    /** Every provider refused or failed; it can be sent again. */
+    ResponseUnitDispatchNotificationStatus["FAILED"] = "FAILED";
+    /** Could never be sent - the unit has no usable phone number. The dispatch stands. */
+    ResponseUnitDispatchNotificationStatus["NOT_POSSIBLE"] = "NOT_POSSIBLE";
+})(ResponseUnitDispatchNotificationStatus || (exports.ResponseUnitDispatchNotificationStatus = ResponseUnitDispatchNotificationStatus = {}));
+//# sourceMappingURL=response-unit-dispatch-notification-status.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-notification-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-dispatch-notification-status.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-dispatch-notification-status.enum.ts"],"names":[],"mappings":";;;AAAA,uEAAuE;AACvE,IAAY,sCASX;AATD,WAAY,sCAAsC;IAC9C,0DAA0D;IAC1D,6DAAmB,CAAA;IACnB,iFAAiF;IACjF,uDAAa,CAAA;IACb,8DAA8D;IAC9D,2DAAiB,CAAA;IACjB,sFAAsF;IACtF,uEAA6B,CAAA;AACjC,CAAC,EATW,sCAAsC,sDAAtC,sCAAsC,QASjD"}

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-status.enum.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitDispatchStatus = void 0;
+/**
+ * Where one response unit is in answering one incident.
+ *
+ * Only DISPATCHED is set by the dispatch command itself. The middle states exist
+ * so the record can be advanced by whoever learns of progress - a dispatcher
+ * relaying a radio call today, the responder app or clarion-workflow later -
+ * without a schema change. Nothing in this platform advances them on a timer:
+ * escalation, reassignment and SLA belong to the workflow layer.
+ *
+ * ACTIVE = DISPATCHED, ACKNOWLEDGED, EN_ROUTE, ON_SCENE. A unit may hold at most
+ * ONE active dispatch across every incident - a partial unique index in
+ * clarion-incident enforces it, which is what stops two dispatchers sending the
+ * same unit to two emergencies.
+ */
+var ResponseUnitDispatchStatus;
+(function (ResponseUnitDispatchStatus) {
+    /** Sent: the command was accepted and the unit was asked to respond. */
+    ResponseUnitDispatchStatus["DISPATCHED"] = "DISPATCHED";
+    /** The unit confirmed it received the job. */
+    ResponseUnitDispatchStatus["ACKNOWLEDGED"] = "ACKNOWLEDGED";
+    /** On the way. */
+    ResponseUnitDispatchStatus["EN_ROUTE"] = "EN_ROUTE";
+    /** Arrived at the incident. */
+    ResponseUnitDispatchStatus["ON_SCENE"] = "ON_SCENE";
+    /** Finished - by the dispatcher, or because the incident itself ended. */
+    ResponseUnitDispatchStatus["COMPLETED"] = "COMPLETED";
+    /** Stood down before finishing. Frees the unit. */
+    ResponseUnitDispatchStatus["CANCELLED"] = "CANCELLED";
+})(ResponseUnitDispatchStatus || (exports.ResponseUnitDispatchStatus = ResponseUnitDispatchStatus = {}));
+//# sourceMappingURL=response-unit-dispatch-status.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-dispatch-status.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-dispatch-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;GAaG;AACH,IAAY,0BAaX;AAbD,WAAY,0BAA0B;IAClC,wEAAwE;IACxE,uDAAyB,CAAA;IACzB,8CAA8C;IAC9C,2DAA6B,CAAA;IAC7B,kBAAkB;IAClB,mDAAqB,CAAA;IACrB,+BAA+B;IAC/B,mDAAqB,CAAA;IACrB,0EAA0E;IAC1E,qDAAuB,CAAA;IACvB,mDAAmD;IACnD,qDAAuB,CAAA;AAC3B,CAAC,EAbW,0BAA0B,0CAA1B,0BAA0B,QAarC"}

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-transition-source.enum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitDispatchTransitionSource = void 0;
+/** Who moved a dispatch to its current status. Recorded for the audit trail. */
+var ResponseUnitDispatchTransitionSource;
+(function (ResponseUnitDispatchTransitionSource) {
+    /** A control-room user, through the admin or the API. */
+    ResponseUnitDispatchTransitionSource["DISPATCHER"] = "DISPATCHER";
+    /** The incident ended (resolved, closed...), so its active dispatches were completed. */
+    ResponseUnitDispatchTransitionSource["INCIDENT_LIFECYCLE"] = "INCIDENT_LIFECYCLE";
+    /** Reserved for the responder app. */
+    ResponseUnitDispatchTransitionSource["RESPONDER"] = "RESPONDER";
+    /** Reserved for clarion-workflow orchestration. */
+    ResponseUnitDispatchTransitionSource["WORKFLOW"] = "WORKFLOW";
+})(ResponseUnitDispatchTransitionSource || (exports.ResponseUnitDispatchTransitionSource = ResponseUnitDispatchTransitionSource = {}));
+//# sourceMappingURL=response-unit-dispatch-transition-source.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-dispatch-transition-source.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-dispatch-transition-source.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-dispatch-transition-source.enum.ts"],"names":[],"mappings":";;;AAAA,gFAAgF;AAChF,IAAY,oCASX;AATD,WAAY,oCAAoC;IAC5C,yDAAyD;IACzD,iEAAyB,CAAA;IACzB,yFAAyF;IACzF,iFAAyC,CAAA;IACzC,sCAAsC;IACtC,+DAAuB,CAAA;IACvB,mDAAmD;IACnD,6DAAqB,CAAA;AACzB,CAAC,EATW,oCAAoC,oDAApC,oCAAoC,QAS/C"}

package/dist/cjs/modules/dispatch/enums/response-unit-distance-basis.enum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitDistanceBasis = void 0;
+/** What a candidate's distance (and duration, when present) measures. */
+var ResponseUnitDistanceBasis;
+(function (ResponseUnitDistanceBasis) {
+    /** Great-circle distance. Always available, never a duration. */
+    ResponseUnitDistanceBasis["STRAIGHT_LINE"] = "STRAIGHT_LINE";
+    /** A road route from clarion-gis (Google Routes), with a travel time. */
+    ResponseUnitDistanceBasis["ROAD_ROUTE"] = "ROAD_ROUTE";
+})(ResponseUnitDistanceBasis || (exports.ResponseUnitDistanceBasis = ResponseUnitDistanceBasis = {}));
+//# sourceMappingURL=response-unit-distance-basis.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-distance-basis.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-distance-basis.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-distance-basis.enum.ts"],"names":[],"mappings":";;;AAAA,yEAAyE;AACzE,IAAY,yBAKX;AALD,WAAY,yBAAyB;IACjC,iEAAiE;IACjE,4DAA+B,CAAA;IAC/B,yEAAyE;IACzE,sDAAyB,CAAA;AAC7B,CAAC,EALW,yBAAyB,yCAAzB,yBAAyB,QAKpC"}

package/dist/cjs/modules/dispatch/enums/response-unit-location-freshness.enum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitLocationFreshness = void 0;
+/**
+ * How far a candidate's position can be trusted.
+ *
+ * Not a new set of thresholds: CURRENT and STALE are clarion-response-tracking's
+ * own ONLINE / STALE status, which it evaluates against each provider
+ * connection's configured staleAfterSeconds / offlineAfterSeconds. A unit the
+ * tracking service calls OFFLINE has no usable position here (UNKNOWN).
+ */
+var ResponseUnitLocationFreshness;
+(function (ResponseUnitLocationFreshness) {
+    /** A live fix within the provider's stale threshold. */
+    ResponseUnitLocationFreshness["CURRENT"] = "CURRENT";
+    /** A live fix older than the stale threshold but not yet offline. */
+    ResponseUnitLocationFreshness["STALE"] = "STALE";
+    /** No live fix that can be relied on: offline, never tracked, or base-only. */
+    ResponseUnitLocationFreshness["UNKNOWN"] = "UNKNOWN";
+})(ResponseUnitLocationFreshness || (exports.ResponseUnitLocationFreshness = ResponseUnitLocationFreshness = {}));
+//# sourceMappingURL=response-unit-location-freshness.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-location-freshness.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-location-freshness.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-location-freshness.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,IAAY,6BAOX;AAPD,WAAY,6BAA6B;IACrC,wDAAwD;IACxD,oDAAmB,CAAA;IACnB,qEAAqE;IACrE,gDAAe,CAAA;IACf,+EAA+E;IAC/E,oDAAmB,CAAA;AACvB,CAAC,EAPW,6BAA6B,6CAA7B,6BAA6B,QAOxC"}

package/dist/cjs/modules/dispatch/enums/response-unit-location-source.enum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitLocationSource = void 0;
+/** Where a candidate's position came from. */
+var ResponseUnitLocationSource;
+(function (ResponseUnitLocationSource) {
+    /** A GPS fix from clarion-response-tracking. */
+    ResponseUnitLocationSource["LIVE"] = "LIVE";
+    /**
+     * The unit's configured base location in clarion-organization - used only
+     * for a unit that is not live-tracked at all, and always labelled as such.
+     */
+    ResponseUnitLocationSource["BASE"] = "BASE";
+    /** No usable position. */
+    ResponseUnitLocationSource["NONE"] = "NONE";
+})(ResponseUnitLocationSource || (exports.ResponseUnitLocationSource = ResponseUnitLocationSource = {}));
+//# sourceMappingURL=response-unit-location-source.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-location-source.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-location-source.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-location-source.enum.ts"],"names":[],"mappings":";;;AAAA,8CAA8C;AAC9C,IAAY,0BAUX;AAVD,WAAY,0BAA0B;IAClC,gDAAgD;IAChD,2CAAa,CAAA;IACb;;;OAGG;IACH,2CAAa,CAAA;IACb,0BAA0B;IAC1B,2CAAa,CAAA;AACjB,CAAC,EAVW,0BAA0B,0CAA1B,0BAA0B,QAUrC"}

package/dist/cjs/modules/dispatch/enums/response-unit-recommendation-reason.enum.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitRecommendationReason = void 0;
+/**
+ * The facts a recommendation rests on, in the order the ranking weighs them.
+ * The admin turns these into the "Recommended because:" lines; the numbers
+ * behind them (distance, age) travel on the candidate itself.
+ */
+var ResponseUnitRecommendationReason;
+(function (ResponseUnitRecommendationReason) {
+    ResponseUnitRecommendationReason["AVAILABLE"] = "AVAILABLE";
+    ResponseUnitRecommendationReason["CAPABILITY_MATCH"] = "CAPABILITY_MATCH";
+    ResponseUnitRecommendationReason["NO_CAPABILITY_REQUIREMENT"] = "NO_CAPABILITY_REQUIREMENT";
+    ResponseUnitRecommendationReason["CAPABILITY_UNKNOWN"] = "CAPABILITY_UNKNOWN";
+    ResponseUnitRecommendationReason["SAME_CONTROL_CENTRE"] = "SAME_CONTROL_CENTRE";
+    ResponseUnitRecommendationReason["OTHER_CONTROL_CENTRE"] = "OTHER_CONTROL_CENTRE";
+    ResponseUnitRecommendationReason["LIVE_LOCATION_CURRENT"] = "LIVE_LOCATION_CURRENT";
+    ResponseUnitRecommendationReason["LIVE_LOCATION_STALE"] = "LIVE_LOCATION_STALE";
+    ResponseUnitRecommendationReason["BASE_LOCATION"] = "BASE_LOCATION";
+    /** Closest of the units that tie on everything above. */
+    ResponseUnitRecommendationReason["NEAREST"] = "NEAREST";
+    /** Quickest by road of the units that tie on everything above. */
+    ResponseUnitRecommendationReason["QUICKEST"] = "QUICKEST";
+})(ResponseUnitRecommendationReason || (exports.ResponseUnitRecommendationReason = ResponseUnitRecommendationReason = {}));
+//# sourceMappingURL=response-unit-recommendation-reason.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-recommendation-reason.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-recommendation-reason.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-recommendation-reason.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,gCAcX;AAdD,WAAY,gCAAgC;IACxC,2DAAuB,CAAA;IACvB,yEAAqC,CAAA;IACrC,2FAAuD,CAAA;IACvD,6EAAyC,CAAA;IACzC,+EAA2C,CAAA;IAC3C,iFAA6C,CAAA;IAC7C,mFAA+C,CAAA;IAC/C,+EAA2C,CAAA;IAC3C,mEAA+B,CAAA;IAC/B,yDAAyD;IACzD,uDAAmB,CAAA;IACnB,kEAAkE;IAClE,yDAAqB,CAAA;AACzB,CAAC,EAdW,gCAAgC,gDAAhC,gCAAgC,QAc3C"}

package/dist/cjs/modules/dispatch/enums/response-unit-recommendation-status.enum.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseUnitRecommendationStatus = void 0;
+/**
+ * The overall answer. NO_UNITS_CONFIGURED and NO_ELIGIBLE_UNITS are different
+ * operational facts and the admin treats them differently: the first hides the
+ * whole dispatch panel (this control room simply has no units), the second is
+ * an alarm (it has units and none can go).
+ */
+var ResponseUnitRecommendationStatus;
+(function (ResponseUnitRecommendationStatus) {
+    /** A unit is recommended. */
+    ResponseUnitRecommendationStatus["RECOMMENDED"] = "RECOMMENDED";
+    /** Some units can be dispatched by hand, but none qualifies for a recommendation. */
+    ResponseUnitRecommendationStatus["NO_RECOMMENDATION"] = "NO_RECOMMENDATION";
+    /** Units exist and none of them can be dispatched. */
+    ResponseUnitRecommendationStatus["NO_ELIGIBLE_UNITS"] = "NO_ELIGIBLE_UNITS";
+    /** The caller's scope holds no response units at all. */
+    ResponseUnitRecommendationStatus["NO_UNITS_CONFIGURED"] = "NO_UNITS_CONFIGURED";
+    /** The incident itself cannot take a dispatch (see the blockers). */
+    ResponseUnitRecommendationStatus["NOT_DISPATCHABLE"] = "NOT_DISPATCHABLE";
+})(ResponseUnitRecommendationStatus || (exports.ResponseUnitRecommendationStatus = ResponseUnitRecommendationStatus = {}));
+//# sourceMappingURL=response-unit-recommendation-status.enum.js.map

package/dist/cjs/modules/dispatch/enums/response-unit-recommendation-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-recommendation-status.enum.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/enums/response-unit-recommendation-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,gCAWX;AAXD,WAAY,gCAAgC;IACxC,6BAA6B;IAC7B,+DAA2B,CAAA;IAC3B,qFAAqF;IACrF,2EAAuC,CAAA;IACvC,sDAAsD;IACtD,2EAAuC,CAAA;IACvC,yDAAyD;IACzD,+EAA2C,CAAA;IAC3C,qEAAqE;IACrE,yEAAqC,CAAA;AACzC,CAAC,EAXW,gCAAgC,gDAAhC,gCAAgC,QAW3C"}

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

@@ -0,0 +1,53 @@
+"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/response-unit-dispatch-status.enum"), exports);
+__exportStar(require("./enums/response-unit-dispatch-transition-source.enum"), exports);
+__exportStar(require("./enums/response-unit-capability-match.enum"), exports);
+__exportStar(require("./enums/response-capability-requirement-source.enum"), exports);
+__exportStar(require("./enums/response-unit-location-source.enum"), exports);
+__exportStar(require("./enums/response-unit-location-freshness.enum"), exports);
+__exportStar(require("./enums/response-unit-distance-basis.enum"), exports);
+__exportStar(require("./enums/response-unit-dispatch-constraint.enum"), exports);
+__exportStar(require("./enums/response-unit-recommendation-reason.enum"), exports);
+__exportStar(require("./enums/response-unit-recommendation-status.enum"), exports);
+__exportStar(require("./enums/incident-dispatch-blocker.enum"), exports);
+__exportStar(require("./enums/response-unit-dispatch-notification-status.enum"), exports);
+__exportStar(require("./enums/response-unit-dispatch-notification-failure.enum"), exports);
+__exportStar(require("./enums/response-unit-dispatch-error-code.enum"), exports);
+// Interfaces
+__exportStar(require("./interfaces/response-unit-dispatch-profile"), exports);
+__exportStar(require("./interfaces/response-unit-proximity"), exports);
+__exportStar(require("./interfaces/response-unit-recommendation"), exports);
+__exportStar(require("./interfaces/incident-response-unit-dispatch"), exports);
+__exportStar(require("./interfaces/response-unit-dispatch-events"), exports);
+// Constants
+__exportStar(require("./constants/response-unit-dispatch-kafka.const"), exports);
+__exportStar(require("./constants/response-unit-dispatch-defaults.const"), exports);
+// DTOs
+__exportStar(require("./dtos/dispatch-response-unit.dto"), exports);
+__exportStar(require("./dtos/update-response-unit-dispatch-status.dto"), exports);
+__exportStar(require("./dtos/response-unit-nearby-query.dto"), exports);
+__exportStar(require("./dtos/response-unit-dispatch-profile-query.dto"), exports);
+__exportStar(require("./dtos/response-unit-dispatch-notification.dto"), exports);
+// Utilities
+__exportStar(require("./utils/response-unit-dispatch-status.util"), exports);
+__exportStar(require("./utils/response-capability-match.util"), exports);
+__exportStar(require("./utils/incident-dispatchability.util"), exports);
+__exportStar(require("./utils/dispatch-geo.util"), exports);
+__exportStar(require("./utils/response-unit-dispatch-event.util"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/dispatch/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,6EAA2D;AAC3D,wFAAsE;AACtE,8EAA4D;AAC5D,sFAAoE;AACpE,6EAA2D;AAC3D,gFAA8D;AAC9D,4EAA0D;AAC1D,iFAA+D;AAC/D,mFAAiE;AACjE,mFAAiE;AACjE,yEAAuD;AACvD,0FAAwE;AACxE,2FAAyE;AACzE,iFAA+D;AAE/D,aAAa;AACb,8EAA4D;AAC5D,uEAAqD;AACrD,4EAA0D;AAC1D,+EAA6D;AAC7D,6EAA2D;AAE3D,YAAY;AACZ,iFAA+D;AAC/D,oFAAkE;AAElE,OAAO;AACP,oEAAkD;AAClD,kFAAgE;AAChE,wEAAsD;AACtD,kFAAgE;AAChE,iFAA+D;AAE/D,YAAY;AACZ,6EAA2D;AAC3D,yEAAuD;AACvD,wEAAsD;AACtD,4DAA0C;AAC1C,4EAA0D"}

package/dist/cjs/modules/dispatch/interfaces/incident-response-unit-dispatch.js

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

package/dist/cjs/modules/dispatch/interfaces/incident-response-unit-dispatch.js.map

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

package/dist/cjs/modules/dispatch/interfaces/response-unit-dispatch-events.js

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

package/dist/cjs/modules/dispatch/interfaces/response-unit-dispatch-events.js.map

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

package/dist/cjs/modules/dispatch/interfaces/response-unit-dispatch-profile.js

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

package/dist/cjs/modules/dispatch/interfaces/response-unit-dispatch-profile.js.map

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

package/dist/cjs/modules/dispatch/interfaces/response-unit-proximity.js

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

package/dist/cjs/modules/dispatch/interfaces/response-unit-proximity.js.map

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

package/dist/cjs/modules/dispatch/interfaces/response-unit-recommendation.js

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

package/dist/cjs/modules/dispatch/interfaces/response-unit-recommendation.js.map

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

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

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.haversineMetres = haversineMetres;
+exports.isUsableCoordinate = isUsableCoordinate;
+exports.readCoordinate = readCoordinate;
+/** Mean Earth radius (IUGG), the value clarion-response-tracking uses too. */
+const EARTH_RADIUS_METRES = 6371008.8;
+const toRadians = (degrees) => (degrees * Math.PI) / 180;
+/** Great-circle distance in metres. */
+function haversineMetres(lat1, lng1, lat2, lng2) {
+    const dLat = toRadians(lat2 - lat1);
+    const dLng = toRadians(lng2 - lng1);
+    const a = Math.sin(dLat / 2) ** 2 +
+        Math.cos(toRadians(lat1)) * Math.cos(toRadians(lat2)) * Math.sin(dLng / 2) ** 2;
+    return 2 * EARTH_RADIUS_METRES * Math.asin(Math.min(1, Math.sqrt(a)));
+}
+/**
+ * A coordinate worth computing a distance from: finite, in range, and not the
+ * (0,0) a form leaves behind when nobody picked a point (Null Island, in the
+ * Gulf of Guinea, is where every unset location in the world quietly sits).
+ */
+function isUsableCoordinate(latitude, longitude) {
+    if (typeof latitude !== 'number' || typeof longitude !== 'number')
+        return false;
+    if (!Number.isFinite(latitude) || !Number.isFinite(longitude))
+        return false;
+    if (latitude < -90 || latitude > 90 || longitude < -180 || longitude > 180)
+        return false;
+    return !(latitude === 0 && longitude === 0);
+}
+/**
+ * Read a {lat,lng} / {latitude,longitude} / {lat,lon} shaped location - the
+ * platform stores all three - as a usable coordinate, or null.
+ */
+function readCoordinate(location) {
+    var _a, _b, _c;
+    if (!location || typeof location !== 'object')
+        return null;
+    const value = location;
+    const latitude = Number((_a = value['latitude']) !== null && _a !== void 0 ? _a : value['lat']);
+    const longitude = Number((_c = (_b = value['longitude']) !== null && _b !== void 0 ? _b : value['lng']) !== null && _c !== void 0 ? _c : value['lon']);
+    return isUsableCoordinate(latitude, longitude) ? { latitude, longitude } : null;
+}
+//# sourceMappingURL=dispatch-geo.util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-geo.util.js","sourceRoot":"","sources":["../../../../../src/modules/dispatch/utils/dispatch-geo.util.ts"],"names":[],"mappings":";;AAMA,0CAOC;AAOD,gDAKC;AAMD,wCAQC;AAvCD,8EAA8E;AAC9E,MAAM,mBAAmB,GAAG,SAAW,CAAC;AAExC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;AAEzE,uCAAuC;AACvC,SAAgB,eAAe,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,IAAY;IAClF,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,GACH,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,QAAiB,EAAE,SAAkB;IACpE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,QAAQ,GAAG,CAAC,EAAE,IAAI,QAAQ,GAAG,EAAE,IAAI,SAAS,GAAG,CAAC,GAAG,IAAI,SAAS,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IACzF,OAAO,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAC1B,QAAiB;;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,KAAK,GAAG,QAAmC,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAA,KAAK,CAAC,UAAU,CAAC,mCAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAA,MAAA,KAAK,CAAC,WAAW,CAAC,mCAAI,KAAK,CAAC,KAAK,CAAC,mCAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7E,OAAO,kBAAkB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC"}