grm-shared-library 1.1.221 → 1.1.223

package/dist/cjs/modules/safety/dtos/safety-internal.dto.js

@@ -0,0 +1,179 @@
+"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.ClassifyIncidentTypesDto = exports.SignalSafetyCheckWorkflowDto = exports.StartSafetyCheckWorkflowDto = exports.CreateSafetyAlertIncidentDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const guardian_audience_dto_1 = require("../../alert-dispatch/dtos/guardian-audience.dto");
+const safety_enums_1 = require("../enums/safety-enums");
+const safety_check_dto_1 = require("./safety-check.dto");
+const safety_alert_context_dto_1 = require("./safety-alert-context.dto");
+const trim = ({ value }) => (typeof value === 'string' ? value.trim() : value);
+/**
+ * clarion-safety -> clarion-incident: raise the SOS for a safety feature.
+ *
+ * Internal only (never proxied by the gateway) and token-protected. Idempotent on
+ * (feature, originReferenceId): a retry - from a workflow, the sweeper, or a user
+ * pressing twice - returns the incident the first call created.
+ *
+ * clarion-incident builds the incident itself: the reporter from the user's
+ * account, the Safety Alerts category and type from the organization's system
+ * rows, and entitlement/dispatch through the same pipeline as every SOS. The
+ * caller cannot choose a type, a class or an entitlement tier.
+ */
+class CreateSafetyAlertIncidentDto {
+}
+exports.CreateSafetyAlertIncidentDto = CreateSafetyAlertIncidentDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: safety_enums_1.SafetyFeature }),
+    (0, class_validator_1.IsEnum)(safety_enums_1.SafetyFeature),
+    __metadata("design:type", String)
+], CreateSafetyAlertIncidentDto.prototype, "feature", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'The safety record that raised it (a Safety Check id)', format: 'uuid' }),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], CreateSafetyAlertIncidentDto.prototype, "originReferenceId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: safety_enums_1.SafetyCheckSosTrigger }),
+    (0, class_validator_1.IsEnum)(safety_enums_1.SafetyCheckSosTrigger),
+    __metadata("design:type", String)
+], CreateSafetyAlertIncidentDto.prototype, "trigger", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], CreateSafetyAlertIncidentDto.prototype, "organizationId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'The user in danger - the reporter of the SOS' }),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], CreateSafetyAlertIncidentDto.prototype, "userId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'The brand the user signed in through (IncidentAppId value)', example: 'G4S' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(50),
+    __metadata("design:type", String)
+], CreateSafetyAlertIncidentDto.prototype, "appId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsPositive)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], CreateSafetyAlertIncidentDto.prototype, "controlCentreId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ type: safety_check_dto_1.SafetyCheckLocationDto, description: 'Last known position, when there is one' }),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => safety_check_dto_1.SafetyCheckLocationDto),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", safety_check_dto_1.SafetyCheckLocationDto)
+], CreateSafetyAlertIncidentDto.prototype, "location", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'What the user asked for. Entitlement at raise time decides what happens.' }),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateSafetyAlertIncidentDto.prototype, "notifyServiceProvider", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: guardian_audience_dto_1.GuardianAudienceDto, description: 'Exactly the guardians the user selected' }),
+    (0, class_validator_1.IsNotEmptyObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => guardian_audience_dto_1.GuardianAudienceDto),
+    __metadata("design:type", guardian_audience_dto_1.GuardianAudienceDto)
+], CreateSafetyAlertIncidentDto.prototype, "guardianAudience", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'The private trip recorded during the check; it becomes the incident trip', format: 'uuid' }),
+    (0, class_validator_1.IsUUID)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], CreateSafetyAlertIncidentDto.prototype, "tripId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ maxLength: 500 }),
+    (0, class_transformer_1.Transform)(trim),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], CreateSafetyAlertIncidentDto.prototype, "description", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        format: 'uuid',
+        description: 'An existing clarion-chat conversation (Follow Me) the incident adopts instead of creating one, so its history carries over',
+    }),
+    (0, class_validator_1.IsUUID)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], CreateSafetyAlertIncidentDto.prototype, "conversationId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ type: safety_alert_context_dto_1.SafetyAlertContextDto, description: 'What responders see about why the SOS was raised' }),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => safety_alert_context_dto_1.SafetyAlertContextDto),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", safety_alert_context_dto_1.SafetyAlertContextDto)
+], CreateSafetyAlertIncidentDto.prototype, "context", void 0);
+/** clarion-safety -> clarion-workflow-manager: start the durable timer. Idempotent per check. */
+class StartSafetyCheckWorkflowDto {
+}
+exports.StartSafetyCheckWorkflowDto = StartSafetyCheckWorkflowDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ format: 'uuid' }),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], StartSafetyCheckWorkflowDto.prototype, "safetyCheckId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'When the workflow should first call advance (ISO 8601)' }),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], StartSafetyCheckWorkflowDto.prototype, "firstWakeAt", void 0);
+/**
+ * clarion-safety -> clarion-workflow-manager: something changed. Purely an
+ * optimisation - a lost signal only means the workflow wakes at its previous
+ * time and asks clarion-safety, which answers with the truth.
+ */
+class SignalSafetyCheckWorkflowDto {
+}
+exports.SignalSafetyCheckWorkflowDto = SignalSafetyCheckWorkflowDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'The check is over; the workflow may finish.' }),
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Boolean)
+], SignalSafetyCheckWorkflowDto.prototype, "done", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'New wake time (after an extension)' }),
+    (0, class_validator_1.IsDateString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], SignalSafetyCheckWorkflowDto.prototype, "nextWakeAt", void 0);
+/**
+ * clarion-billing -> clarion-incident: which of these incident type ids are
+ * platform-managed system types (the Safety SOS types). Billing refuses to put
+ * those in a package, whatever the admin UI shows.
+ */
+class ClassifyIncidentTypesDto {
+}
+exports.ClassifyIncidentTypesDto = ClassifyIncidentTypesDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: [Number] }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(500),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)({ each: true }),
+    (0, class_validator_1.IsPositive)({ each: true }),
+    __metadata("design:type", Array)
+], ClassifyIncidentTypesDto.prototype, "ids", void 0);
+//# sourceMappingURL=safety-internal.dto.js.map

package/dist/cjs/modules/safety/dtos/safety-internal.dto.js.map

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

package/dist/cjs/modules/safety/enums/follow-me.enums.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FollowMeErrorCode = exports.FollowMePushAction = exports.FollowMeRealtimeEventType = exports.FollowMeEventType = exports.FollowMeAuditEventType = exports.FollowMeTrackingHealth = exports.FollowMeSafetyEventType = exports.FollowMePromptStatus = exports.FollowMeSafetyTrigger = exports.FollowMeRouteKind = exports.FollowMeWaypointKind = exports.FollowMeTransportMode = exports.FollowMeParticipantKind = exports.FollowMeParticipantStatus = exports.FollowMeStatus = void 0;
+/**
+ * Lifecycle of one Follow Me session. clarion-safety is the only writer; every
+ * transition is validated against FOLLOW_ME_TRANSITIONS and applied as a
+ * conditional update, exactly as a Safety Check is.
+ *
+ *   CREATED        accepted and persisted; the trip, the timer and the guardian
+ *                  requests are being set up. Already counts as live.
+ *   ACTIVE         the journey is being shared and monitored.
+ *   PROMPTING      a safety prompt is open (see FollowMePromptStatus); an SOS is
+ *                  raised if it is not answered.
+ *   ARRIVED        the destination was reached. Terminal, successful.
+ *   SOS_TRIGGERED  an SOS was raised - a prompt went unanswered or the user
+ *                  asked for one. Follow Me is over; the recorded trip goes on as
+ *                  the incident's trip and followers move to the SOS view.
+ *   STOPPED        the user ended it. Terminal.
+ *   EXPIRED        the chosen duration ran out before arrival. Terminal; never
+ *                  raises an SOS by itself. Deferred while a prompt is open.
+ *   CANCELLED      ended by the platform rather than the user (e.g. sign-out).
+ *   FAILED         the SOS could not be raised because clarion-incident refused
+ *                  it outright. Terminal; the user and guardians are told to act.
+ *
+ * Deliberately NOT a status: whether live sharing is healthy. That is
+ * FollowMeTrackingHealth, derived from when the last location arrived - a
+ * session with a flat battery is still a session.
+ */
+var FollowMeStatus;
+(function (FollowMeStatus) {
+    FollowMeStatus["CREATED"] = "CREATED";
+    FollowMeStatus["ACTIVE"] = "ACTIVE";
+    FollowMeStatus["PROMPTING"] = "PROMPTING";
+    FollowMeStatus["ARRIVED"] = "ARRIVED";
+    FollowMeStatus["SOS_TRIGGERED"] = "SOS_TRIGGERED";
+    FollowMeStatus["STOPPED"] = "STOPPED";
+    FollowMeStatus["EXPIRED"] = "EXPIRED";
+    FollowMeStatus["CANCELLED"] = "CANCELLED";
+    FollowMeStatus["FAILED"] = "FAILED";
+})(FollowMeStatus || (exports.FollowMeStatus = FollowMeStatus = {}));
+/**
+ * One guardian's relationship to a session - separate from the session's own
+ * state. A guardian stopping following never ends the session.
+ *
+ *   PENDING            asked, not yet answered.
+ *   ACCEPTED           following (whether they are looking right now is
+ *                      presence, not state).
+ *   DECLINED           said no. May still accept while the session is live.
+ *   STOPPED_FOLLOWING  followed, then stopped. May follow again while live.
+ *   EXPIRED            the session ended; every open participation ends with it.
+ */
+var FollowMeParticipantStatus;
+(function (FollowMeParticipantStatus) {
+    FollowMeParticipantStatus["PENDING"] = "PENDING";
+    FollowMeParticipantStatus["ACCEPTED"] = "ACCEPTED";
+    FollowMeParticipantStatus["DECLINED"] = "DECLINED";
+    FollowMeParticipantStatus["STOPPED_FOLLOWING"] = "STOPPED_FOLLOWING";
+    FollowMeParticipantStatus["EXPIRED"] = "EXPIRED";
+})(FollowMeParticipantStatus || (exports.FollowMeParticipantStatus = FollowMeParticipantStatus = {}));
+/** Who a participant is. App guardians sign in; external guardians hold a link. */
+var FollowMeParticipantKind;
+(function (FollowMeParticipantKind) {
+    FollowMeParticipantKind["SYSTEM_GUARDIAN"] = "SYSTEM_GUARDIAN";
+    FollowMeParticipantKind["EXTERNAL_GUARDIAN"] = "EXTERNAL_GUARDIAN";
+})(FollowMeParticipantKind || (exports.FollowMeParticipantKind = FollowMeParticipantKind = {}));
+var FollowMeTransportMode;
+(function (FollowMeTransportMode) {
+    FollowMeTransportMode["WALK"] = "WALK";
+    FollowMeTransportMode["DRIVE"] = "DRIVE";
+    FollowMeTransportMode["TWO_WHEELER"] = "TWO_WHEELER";
+    FollowMeTransportMode["PUBLIC_TRANSPORT"] = "PUBLIC_TRANSPORT";
+    /** A taxi or ride-hail: routed as driving, monitored as a vehicle. */
+    FollowMeTransportMode["RIDE_SERVICE"] = "RIDE_SERVICE";
+})(FollowMeTransportMode || (exports.FollowMeTransportMode = FollowMeTransportMode = {}));
+var FollowMeWaypointKind;
+(function (FollowMeWaypointKind) {
+    FollowMeWaypointKind["START"] = "START";
+    FollowMeWaypointKind["STOP"] = "STOP";
+    FollowMeWaypointKind["DESTINATION"] = "DESTINATION";
+})(FollowMeWaypointKind || (exports.FollowMeWaypointKind = FollowMeWaypointKind = {}));
+/** A route is never replaced silently: the plan and every recalculation are kept. */
+var FollowMeRouteKind;
+(function (FollowMeRouteKind) {
+    FollowMeRouteKind["ORIGINAL"] = "ORIGINAL";
+    FollowMeRouteKind["RECALCULATED"] = "RECALCULATED";
+})(FollowMeRouteKind || (exports.FollowMeRouteKind = FollowMeRouteKind = {}));
+/** What made Follow Me ask the user whether they are safe. */
+var FollowMeSafetyTrigger;
+(function (FollowMeSafetyTrigger) {
+    FollowMeSafetyTrigger["CRASH_SUSPECTED"] = "CRASH_SUSPECTED";
+    FollowMeSafetyTrigger["ROUTE_DEVIATION"] = "ROUTE_DEVIATION";
+    FollowMeSafetyTrigger["PROLONGED_STOP"] = "PROLONGED_STOP";
+    FollowMeSafetyTrigger["ETA_OVERDUE"] = "ETA_OVERDUE";
+})(FollowMeSafetyTrigger || (exports.FollowMeSafetyTrigger = FollowMeSafetyTrigger = {}));
+var FollowMePromptStatus;
+(function (FollowMePromptStatus) {
+    FollowMePromptStatus["ACTIVE"] = "ACTIVE";
+    FollowMePromptStatus["CONFIRMED_OK"] = "CONFIRMED_OK";
+    /** Unanswered - the SOS followed. */
+    FollowMePromptStatus["EXPIRED"] = "EXPIRED";
+    /** Closed without an answer for another reason: the session ended, or the user pressed SOS. */
+    FollowMePromptStatus["CANCELLED"] = "CANCELLED";
+})(FollowMePromptStatus || (exports.FollowMePromptStatus = FollowMePromptStatus = {}));
+/**
+ * What the monitors observed (follow_me_safety_events). Evidence, not decisions:
+ * most of these never become a prompt.
+ */
+var FollowMeSafetyEventType;
+(function (FollowMeSafetyEventType) {
+    FollowMeSafetyEventType["OFF_ROUTE_SUSPECTED"] = "OFF_ROUTE_SUSPECTED";
+    FollowMeSafetyEventType["BACK_ON_ROUTE"] = "BACK_ON_ROUTE";
+    FollowMeSafetyEventType["ROUTE_RECALCULATED"] = "ROUTE_RECALCULATED";
+    FollowMeSafetyEventType["DEVIATION_CONFIRMED"] = "DEVIATION_CONFIRMED";
+    FollowMeSafetyEventType["PROLONGED_STOP_DETECTED"] = "PROLONGED_STOP_DETECTED";
+    FollowMeSafetyEventType["STOP_DEFERRED_FOR_TRAFFIC"] = "STOP_DEFERRED_FOR_TRAFFIC";
+    FollowMeSafetyEventType["ETA_RECALCULATED"] = "ETA_RECALCULATED";
+    FollowMeSafetyEventType["ETA_OVERDUE_DETECTED"] = "ETA_OVERDUE_DETECTED";
+    FollowMeSafetyEventType["CRASH_REPORTED"] = "CRASH_REPORTED";
+    FollowMeSafetyEventType["CRASH_REJECTED"] = "CRASH_REJECTED";
+    FollowMeSafetyEventType["ARRIVAL_DETECTED"] = "ARRIVAL_DETECTED";
+    FollowMeSafetyEventType["TRACKING_STALE"] = "TRACKING_STALE";
+    FollowMeSafetyEventType["TRACKING_RESTORED"] = "TRACKING_RESTORED";
+})(FollowMeSafetyEventType || (exports.FollowMeSafetyEventType = FollowMeSafetyEventType = {}));
+/** Is the session's live location actually live? Derived from lastLocationAt. */
+var FollowMeTrackingHealth;
+(function (FollowMeTrackingHealth) {
+    FollowMeTrackingHealth["LIVE"] = "LIVE";
+    /** Nothing for a while - show "last seen N min ago", never "live". */
+    FollowMeTrackingHealth["STALE"] = "STALE";
+    /** No location has arrived yet. */
+    FollowMeTrackingHealth["NO_SIGNAL"] = "NO_SIGNAL";
+})(FollowMeTrackingHealth || (exports.FollowMeTrackingHealth = FollowMeTrackingHealth = {}));
+/** Audit trail (follow_me_audit_events). Never carries a location or a token. */
+var FollowMeAuditEventType;
+(function (FollowMeAuditEventType) {
+    FollowMeAuditEventType["CREATED"] = "CREATED";
+    FollowMeAuditEventType["ACTIVATED"] = "ACTIVATED";
+    FollowMeAuditEventType["TRACKING_STARTED"] = "TRACKING_STARTED";
+    FollowMeAuditEventType["TRACKING_UNAVAILABLE"] = "TRACKING_UNAVAILABLE";
+    FollowMeAuditEventType["WORKFLOW_STARTED"] = "WORKFLOW_STARTED";
+    FollowMeAuditEventType["WORKFLOW_START_FAILED"] = "WORKFLOW_START_FAILED";
+    FollowMeAuditEventType["CHAT_CREATED"] = "CHAT_CREATED";
+    FollowMeAuditEventType["GUARDIAN_INVITED"] = "GUARDIAN_INVITED";
+    FollowMeAuditEventType["GUARDIAN_ACCEPTED"] = "GUARDIAN_ACCEPTED";
+    FollowMeAuditEventType["GUARDIAN_DECLINED"] = "GUARDIAN_DECLINED";
+    FollowMeAuditEventType["GUARDIAN_STOPPED_FOLLOWING"] = "GUARDIAN_STOPPED_FOLLOWING";
+    FollowMeAuditEventType["EXTERNAL_LINK_ISSUED"] = "EXTERNAL_LINK_ISSUED";
+    FollowMeAuditEventType["EXTERNAL_LINK_USED"] = "EXTERNAL_LINK_USED";
+    FollowMeAuditEventType["ROUTE_RECALCULATED"] = "ROUTE_RECALCULATED";
+    FollowMeAuditEventType["PROMPT_STARTED"] = "PROMPT_STARTED";
+    FollowMeAuditEventType["PROMPT_CONFIRMED"] = "PROMPT_CONFIRMED";
+    FollowMeAuditEventType["PROMPT_EXPIRED"] = "PROMPT_EXPIRED";
+    FollowMeAuditEventType["PROMPT_CANCELLED"] = "PROMPT_CANCELLED";
+    FollowMeAuditEventType["SOS_TRIGGERED"] = "SOS_TRIGGERED";
+    FollowMeAuditEventType["SOS_INCIDENT_CREATED"] = "SOS_INCIDENT_CREATED";
+    FollowMeAuditEventType["SOS_INCIDENT_RETRY"] = "SOS_INCIDENT_RETRY";
+    FollowMeAuditEventType["SOS_FAILED"] = "SOS_FAILED";
+    FollowMeAuditEventType["ARRIVED"] = "ARRIVED";
+    FollowMeAuditEventType["STOPPED"] = "STOPPED";
+    FollowMeAuditEventType["EXPIRED"] = "EXPIRED";
+    FollowMeAuditEventType["CANCELLED"] = "CANCELLED";
+})(FollowMeAuditEventType || (exports.FollowMeAuditEventType = FollowMeAuditEventType = {}));
+/** Kafka event types (the `eventType` of FollowMeEvent), one topic each. */
+var FollowMeEventType;
+(function (FollowMeEventType) {
+    FollowMeEventType["STARTED"] = "FOLLOW_ME_STARTED";
+    FollowMeEventType["GUARDIAN_RESPONDED"] = "FOLLOW_ME_GUARDIAN_RESPONDED";
+    FollowMeEventType["PROMPTING"] = "FOLLOW_ME_PROMPTING";
+    FollowMeEventType["SOS_TRIGGERED"] = "FOLLOW_ME_SOS_TRIGGERED";
+    FollowMeEventType["ENDED"] = "FOLLOW_ME_ENDED";
+})(FollowMeEventType || (exports.FollowMeEventType = FollowMeEventType = {}));
+/** Socket.IO `safety.event` types for Follow Me (FollowMeRealtimeEnvelope.type). */
+var FollowMeRealtimeEventType;
+(function (FollowMeRealtimeEventType) {
+    FollowMeRealtimeEventType["STARTED"] = "FOLLOW_ME_STARTED";
+    FollowMeRealtimeEventType["REQUEST"] = "FOLLOW_ME_REQUEST";
+    FollowMeRealtimeEventType["GUARDIAN_ACCEPTED"] = "FOLLOW_ME_GUARDIAN_ACCEPTED";
+    FollowMeRealtimeEventType["GUARDIAN_DECLINED"] = "FOLLOW_ME_GUARDIAN_DECLINED";
+    FollowMeRealtimeEventType["GUARDIAN_STOPPED_FOLLOWING"] = "FOLLOW_ME_GUARDIAN_STOPPED_FOLLOWING";
+    FollowMeRealtimeEventType["LOCATION_UPDATED"] = "FOLLOW_ME_LOCATION_UPDATED";
+    FollowMeRealtimeEventType["ROUTE_UPDATED"] = "FOLLOW_ME_ROUTE_UPDATED";
+    FollowMeRealtimeEventType["ETA_UPDATED"] = "FOLLOW_ME_ETA_UPDATED";
+    FollowMeRealtimeEventType["SAFETY_EVENT"] = "FOLLOW_ME_SAFETY_EVENT";
+    FollowMeRealtimeEventType["PROMPT_STARTED"] = "FOLLOW_ME_PROMPT_STARTED";
+    FollowMeRealtimeEventType["PROMPT_CONFIRMED"] = "FOLLOW_ME_PROMPT_CONFIRMED";
+    FollowMeRealtimeEventType["SOS_TRIGGERED"] = "FOLLOW_ME_SOS_TRIGGERED";
+    FollowMeRealtimeEventType["ARRIVED"] = "FOLLOW_ME_ARRIVED";
+    FollowMeRealtimeEventType["STOPPED"] = "FOLLOW_ME_STOPPED";
+    FollowMeRealtimeEventType["EXPIRED"] = "FOLLOW_ME_EXPIRED";
+    FollowMeRealtimeEventType["ENDED"] = "FOLLOW_ME_ENDED";
+    FollowMeRealtimeEventType["PROVIDER_UPDATED"] = "FOLLOW_ME_PROVIDER_UPDATED";
+})(FollowMeRealtimeEventType || (exports.FollowMeRealtimeEventType = FollowMeRealtimeEventType = {}));
+/**
+ * Push `data.action` / `data.type` values for Follow Me (allow-listed by the
+ * app's notification_deep_link_coordinator.dart - changing one breaks installed
+ * apps).
+ */
+var FollowMePushAction;
+(function (FollowMePushAction) {
+    /** To a guardian: somebody asked you to follow their journey. */
+    FollowMePushAction["FOLLOW_ME_REQUEST"] = "FOLLOW_ME_REQUEST";
+    /** To the user: a guardian accepted or declined. */
+    FollowMePushAction["FOLLOW_ME_GUARDIAN_RESPONDED"] = "FOLLOW_ME_GUARDIAN_RESPONDED";
+    /** To the user: confirm you are safe. */
+    FollowMePushAction["FOLLOW_ME_PROMPT"] = "FOLLOW_ME_PROMPT";
+    /** To the user and followers: an SOS was raised from Follow Me. */
+    FollowMePushAction["FOLLOW_ME_SOS_TRIGGERED"] = "FOLLOW_ME_SOS_TRIGGERED";
+    /** To followers (and the user when it ended without them): Follow Me ended. */
+    FollowMePushAction["FOLLOW_ME_ENDED"] = "FOLLOW_ME_ENDED";
+})(FollowMePushAction || (exports.FollowMePushAction = FollowMePushAction = {}));
+/** Machine-readable `code` on every Follow Me error. */
+var FollowMeErrorCode;
+(function (FollowMeErrorCode) {
+    FollowMeErrorCode["NOT_FOUND"] = "FOLLOW_ME_NOT_FOUND";
+    FollowMeErrorCode["ALREADY_ACTIVE"] = "FOLLOW_ME_ALREADY_ACTIVE";
+    FollowMeErrorCode["ALREADY_ENDED"] = "FOLLOW_ME_ENDED";
+    FollowMeErrorCode["SOS_ALREADY_TRIGGERED"] = "FOLLOW_ME_SOS_ALREADY_TRIGGERED";
+    FollowMeErrorCode["INVALID_TRANSITION"] = "FOLLOW_ME_INVALID_TRANSITION";
+    FollowMeErrorCode["INVALID_DURATION"] = "FOLLOW_ME_INVALID_DURATION";
+    FollowMeErrorCode["ROUTE_EXCEEDS_MAX_DURATION"] = "FOLLOW_ME_ROUTE_EXCEEDS_MAX_DURATION";
+    FollowMeErrorCode["ROUTE_INVALID"] = "FOLLOW_ME_ROUTE_INVALID";
+    FollowMeErrorCode["ROUTE_EXPIRED"] = "FOLLOW_ME_ROUTE_EXPIRED";
+    FollowMeErrorCode["ROUTING_UNAVAILABLE"] = "FOLLOW_ME_ROUTING_UNAVAILABLE";
+    FollowMeErrorCode["INVALID_REASON"] = "FOLLOW_ME_INVALID_REASON";
+    FollowMeErrorCode["CUSTOM_REASON_REQUIRED"] = "FOLLOW_ME_CUSTOM_REASON_REQUIRED";
+    FollowMeErrorCode["GUARDIAN_NOT_FOUND"] = "FOLLOW_ME_GUARDIAN_NOT_FOUND";
+    FollowMeErrorCode["GUARDIANS_UNAVAILABLE"] = "FOLLOW_ME_GUARDIANS_UNAVAILABLE";
+    FollowMeErrorCode["NO_RECIPIENTS"] = "FOLLOW_ME_NO_RECIPIENTS";
+    FollowMeErrorCode["SERVICE_PROVIDER_NOT_ENTITLED"] = "FOLLOW_ME_SERVICE_PROVIDER_NOT_ENTITLED";
+    FollowMeErrorCode["PROMPT_NOT_ACTIVE"] = "FOLLOW_ME_PROMPT_NOT_ACTIVE";
+    FollowMeErrorCode["TRACKING_CLOSED"] = "FOLLOW_ME_TRACKING_CLOSED";
+    FollowMeErrorCode["NOT_A_PARTICIPANT"] = "FOLLOW_ME_NOT_A_PARTICIPANT";
+    FollowMeErrorCode["ACCESS_EXPIRED"] = "FOLLOW_ME_ACCESS_EXPIRED";
+    FollowMeErrorCode["LOCATION_NOT_SHARED"] = "FOLLOW_ME_LOCATION_NOT_SHARED";
+    FollowMeErrorCode["RATE_LIMITED"] = "FOLLOW_ME_RATE_LIMITED";
+})(FollowMeErrorCode || (exports.FollowMeErrorCode = FollowMeErrorCode = {}));
+//# sourceMappingURL=follow-me.enums.js.map

package/dist/cjs/modules/safety/enums/follow-me.enums.js.map

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

package/dist/cjs/modules/safety/enums/safety-check-status.enum.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafetyCheckStatus = void 0;
+/**
+ * Lifecycle of one Safety Check. clarion-safety is the only writer; every
+ * transition is validated against SAFETY_CHECK_TRANSITIONS
+ * (utils/safety-check-state-machine.ts) and applied as a conditional update, so
+ * two racing writers can never both win.
+ *
+ *   CREATED        accepted and persisted; tracking and the durable timer are
+ *                  still being set up. The user already counts as being in a
+ *                  check (the clock started when it was accepted).
+ *   ACTIVE         running; the user is expected to check in at
+ *                  scheduledCheckInAt.
+ *   PROMPTING      the check-in time has passed and the user is being asked to
+ *                  confirm they are safe. SOS is raised at promptDeadlineAt.
+ *   CHECKED_IN     the user confirmed they are safe. Terminal, successful.
+ *   SOS_TRIGGERED  an SOS was raised - the user missed the check-in or asked for
+ *                  one. Terminal for the check; the incident lives on in
+ *                  clarion-incident. `incidentId` is null until the incident
+ *                  has been created (clarion-safety keeps retrying).
+ *   STOPPED        the user ended the check before it completed. Terminal.
+ *   EXPIRED        the check-in window closed so long ago (a platform outage
+ *                  longer than SAFETY_CHECK_LIMITS.staleSosWindowMinutes) that
+ *                  raising an SOS now would be noise rather than help. Terminal;
+ *                  always an operational alarm.
+ *   CANCELLED      ended by the platform rather than the user (e.g. the account
+ *                  was signed out and the user chose to end it). Terminal.
+ *   FAILED         the SOS could not be raised because clarion-incident refused
+ *                  it outright (a non-retryable error). Terminal; the user is
+ *                  told to call for help and operators are alerted.
+ */
+var SafetyCheckStatus;
+(function (SafetyCheckStatus) {
+    SafetyCheckStatus["CREATED"] = "CREATED";
+    SafetyCheckStatus["ACTIVE"] = "ACTIVE";
+    SafetyCheckStatus["PROMPTING"] = "PROMPTING";
+    SafetyCheckStatus["CHECKED_IN"] = "CHECKED_IN";
+    SafetyCheckStatus["SOS_TRIGGERED"] = "SOS_TRIGGERED";
+    SafetyCheckStatus["STOPPED"] = "STOPPED";
+    SafetyCheckStatus["EXPIRED"] = "EXPIRED";
+    SafetyCheckStatus["CANCELLED"] = "CANCELLED";
+    SafetyCheckStatus["FAILED"] = "FAILED";
+})(SafetyCheckStatus || (exports.SafetyCheckStatus = SafetyCheckStatus = {}));
+//# sourceMappingURL=safety-check-status.enum.js.map

package/dist/cjs/modules/safety/enums/safety-check-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-check-status.enum.js","sourceRoot":"","sources":["../../../../../src/modules/safety/enums/safety-check-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,IAAY,iBAUX;AAVD,WAAY,iBAAiB;IACzB,wCAAmB,CAAA;IACnB,sCAAiB,CAAA;IACjB,4CAAuB,CAAA;IACvB,8CAAyB,CAAA;IACzB,oDAA+B,CAAA;IAC/B,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;IACnB,4CAAuB,CAAA;IACvB,sCAAiB,CAAA;AACrB,CAAC,EAVW,iBAAiB,iCAAjB,iBAAiB,QAU5B"}

package/dist/cjs/modules/safety/enums/safety-enums.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafetyPushAction = exports.SafetyCheckEventType = exports.SafetyIncidentTypeCode = exports.SafetyIncidentCategoryCode = exports.SafetyFeature = exports.SafetyCheckAuditEventType = exports.SafetyCheckActorType = exports.SafetyCheckSosTrigger = void 0;
+/**
+ * Why a safety feature raised an SOS. Shared by every safety feature (the name
+ * predates Follow Me).
+ */
+var SafetyCheckSosTrigger;
+(function (SafetyCheckSosTrigger) {
+    /** Safety Check: the prompt countdown ran out without the user confirming they were safe. */
+    SafetyCheckSosTrigger["MISSED_CHECK_IN"] = "MISSED_CHECK_IN";
+    /** The user pressed SOS from a safety feature's screen. */
+    SafetyCheckSosTrigger["USER_REQUESTED"] = "USER_REQUESTED";
+    /** Follow Me: a safety prompt (crash, deviation, stop, overdue) went unanswered. */
+    SafetyCheckSosTrigger["MISSED_SAFETY_PROMPT"] = "MISSED_SAFETY_PROMPT";
+})(SafetyCheckSosTrigger || (exports.SafetyCheckSosTrigger = SafetyCheckSosTrigger = {}));
+/** Who caused a Safety Check transition - recorded on every audit entry. */
+var SafetyCheckActorType;
+(function (SafetyCheckActorType) {
+    SafetyCheckActorType["USER"] = "USER";
+    /** The durable timer in clarion-workflow-manager. */
+    SafetyCheckActorType["WORKFLOW"] = "WORKFLOW";
+    /** clarion-safety's backstop sweeper, acting on an overdue check. */
+    SafetyCheckActorType["RECONCILER"] = "RECONCILER";
+    SafetyCheckActorType["SYSTEM"] = "SYSTEM";
+})(SafetyCheckActorType || (exports.SafetyCheckActorType = SafetyCheckActorType = {}));
+/** Audit trail entries (safety_check_events.eventType). Never carries a location. */
+var SafetyCheckAuditEventType;
+(function (SafetyCheckAuditEventType) {
+    SafetyCheckAuditEventType["CREATED"] = "CREATED";
+    SafetyCheckAuditEventType["ACTIVATED"] = "ACTIVATED";
+    SafetyCheckAuditEventType["TRACKING_STARTED"] = "TRACKING_STARTED";
+    SafetyCheckAuditEventType["TRACKING_UNAVAILABLE"] = "TRACKING_UNAVAILABLE";
+    SafetyCheckAuditEventType["WORKFLOW_STARTED"] = "WORKFLOW_STARTED";
+    SafetyCheckAuditEventType["WORKFLOW_START_FAILED"] = "WORKFLOW_START_FAILED";
+    SafetyCheckAuditEventType["EXTENDED"] = "EXTENDED";
+    SafetyCheckAuditEventType["PROMPT_STARTED"] = "PROMPT_STARTED";
+    SafetyCheckAuditEventType["CHECKED_IN"] = "CHECKED_IN";
+    SafetyCheckAuditEventType["STOPPED"] = "STOPPED";
+    SafetyCheckAuditEventType["CANCELLED"] = "CANCELLED";
+    SafetyCheckAuditEventType["SOS_TRIGGERED"] = "SOS_TRIGGERED";
+    SafetyCheckAuditEventType["SOS_INCIDENT_CREATED"] = "SOS_INCIDENT_CREATED";
+    SafetyCheckAuditEventType["SOS_INCIDENT_RETRY"] = "SOS_INCIDENT_RETRY";
+    SafetyCheckAuditEventType["SOS_FAILED"] = "SOS_FAILED";
+    SafetyCheckAuditEventType["EXPIRED"] = "EXPIRED";
+})(SafetyCheckAuditEventType || (exports.SafetyCheckAuditEventType = SafetyCheckAuditEventType = {}));
+/**
+ * The safety features that can raise an incident. Phase 1 raises only
+ * SAFETY_CHECK; FOLLOW_ME exists because its incident type is provisioned for
+ * every organization from day one.
+ */
+var SafetyFeature;
+(function (SafetyFeature) {
+    SafetyFeature["SAFETY_CHECK"] = "SAFETY_CHECK";
+    SafetyFeature["FOLLOW_ME"] = "FOLLOW_ME";
+})(SafetyFeature || (exports.SafetyFeature = SafetyFeature = {}));
+/** Stable code of the incident category every organization receives. */
+var SafetyIncidentCategoryCode;
+(function (SafetyIncidentCategoryCode) {
+    SafetyIncidentCategoryCode["SAFETY_ALERTS"] = "SAFETY_ALERTS";
+})(SafetyIncidentCategoryCode || (exports.SafetyIncidentCategoryCode = SafetyIncidentCategoryCode = {}));
+/** Stable codes of the incident types inside the Safety Alerts category. */
+var SafetyIncidentTypeCode;
+(function (SafetyIncidentTypeCode) {
+    SafetyIncidentTypeCode["SAFETY_CHECK_SOS"] = "SAFETY_CHECK_SOS";
+    SafetyIncidentTypeCode["FOLLOW_ME_SOS"] = "FOLLOW_ME_SOS";
+})(SafetyIncidentTypeCode || (exports.SafetyIncidentTypeCode = SafetyIncidentTypeCode = {}));
+/**
+ * Kafka event types published by clarion-safety (the `eventType` field of
+ * SafetyCheckEvent). One topic per type, see KAFKA_TOPICS.SAFETY_CHECK_*.
+ */
+var SafetyCheckEventType;
+(function (SafetyCheckEventType) {
+    SafetyCheckEventType["STARTED"] = "SAFETY_CHECK_STARTED";
+    SafetyCheckEventType["PROMPTING"] = "SAFETY_CHECK_PROMPTING";
+    SafetyCheckEventType["ENDED"] = "SAFETY_CHECK_ENDED";
+    SafetyCheckEventType["SOS_TRIGGERED"] = "SAFETY_CHECK_SOS_TRIGGERED";
+})(SafetyCheckEventType || (exports.SafetyCheckEventType = SafetyCheckEventType = {}));
+/**
+ * Push `data.action` / `data.type` values the mobile app routes on. Sent by
+ * clarion-notification; the app allow-lists them in
+ * notification_deep_link_coordinator.dart. Changing a value is a breaking
+ * change to installed apps.
+ */
+var SafetyPushAction;
+(function (SafetyPushAction) {
+    /** To the user: it is time to confirm you are safe. */
+    SafetyPushAction["SAFETY_CHECK_PROMPT"] = "SAFETY_CHECK_PROMPT";
+    /** To the user: an SOS was raised for your Safety Check. */
+    SafetyPushAction["SAFETY_CHECK_SOS_TRIGGERED"] = "SAFETY_CHECK_SOS_TRIGGERED";
+    /** To the user: the Safety Check ended without them (FAILED/EXPIRED/CANCELLED). */
+    SafetyPushAction["SAFETY_CHECK_ENDED"] = "SAFETY_CHECK_ENDED";
+    /** To a guardian: somebody who chose you started a Safety Check. */
+    SafetyPushAction["SAFETY_CHECK_GUARDIAN_STARTED"] = "SAFETY_CHECK_GUARDIAN_STARTED";
+    /** To a guardian: that Safety Check ended safely. */
+    SafetyPushAction["SAFETY_CHECK_GUARDIAN_ENDED"] = "SAFETY_CHECK_GUARDIAN_ENDED";
+})(SafetyPushAction || (exports.SafetyPushAction = SafetyPushAction = {}));
+//# sourceMappingURL=safety-enums.js.map

package/dist/cjs/modules/safety/enums/safety-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-enums.js","sourceRoot":"","sources":["../../../../../src/modules/safety/enums/safety-enums.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,qBAOX;AAPD,WAAY,qBAAqB;IAC7B,6FAA6F;IAC7F,4DAAmC,CAAA;IACnC,2DAA2D;IAC3D,0DAAiC,CAAA;IACjC,oFAAoF;IACpF,sEAA6C,CAAA;AACjD,CAAC,EAPW,qBAAqB,qCAArB,qBAAqB,QAOhC;AAED,4EAA4E;AAC5E,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC5B,qCAAa,CAAA;IACb,qDAAqD;IACrD,6CAAqB,CAAA;IACrB,qEAAqE;IACrE,iDAAyB,CAAA;IACzB,yCAAiB,CAAA;AACrB,CAAC,EAPW,oBAAoB,oCAApB,oBAAoB,QAO/B;AAED,qFAAqF;AACrF,IAAY,yBAiBX;AAjBD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;IACnB,oDAAuB,CAAA;IACvB,kEAAqC,CAAA;IACrC,0EAA6C,CAAA;IAC7C,kEAAqC,CAAA;IACrC,4EAA+C,CAAA;IAC/C,kDAAqB,CAAA;IACrB,8DAAiC,CAAA;IACjC,sDAAyB,CAAA;IACzB,gDAAmB,CAAA;IACnB,oDAAuB,CAAA;IACvB,4DAA+B,CAAA;IAC/B,0EAA6C,CAAA;IAC7C,sEAAyC,CAAA;IACzC,sDAAyB,CAAA;IACzB,gDAAmB,CAAA;AACvB,CAAC,EAjBW,yBAAyB,yCAAzB,yBAAyB,QAiBpC;AAED;;;;GAIG;AACH,IAAY,aAGX;AAHD,WAAY,aAAa;IACrB,8CAA6B,CAAA;IAC7B,wCAAuB,CAAA;AAC3B,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAED,wEAAwE;AACxE,IAAY,0BAEX;AAFD,WAAY,0BAA0B;IAClC,6DAA+B,CAAA;AACnC,CAAC,EAFW,0BAA0B,0CAA1B,0BAA0B,QAErC;AAED,4EAA4E;AAC5E,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAC9B,+DAAqC,CAAA;IACrC,yDAA+B,CAAA;AACnC,CAAC,EAHW,sBAAsB,sCAAtB,sBAAsB,QAGjC;AAED;;;GAGG;AACH,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC5B,wDAAgC,CAAA;IAChC,4DAAoC,CAAA;IACpC,oDAA4B,CAAA;IAC5B,oEAA4C,CAAA;AAChD,CAAC,EALW,oBAAoB,oCAApB,oBAAoB,QAK/B;AAED;;;;;GAKG;AACH,IAAY,gBAWX;AAXD,WAAY,gBAAgB;IACxB,uDAAuD;IACvD,+DAA2C,CAAA;IAC3C,4DAA4D;IAC5D,6EAAyD,CAAA;IACzD,mFAAmF;IACnF,6DAAyC,CAAA;IACzC,oEAAoE;IACpE,mFAA+D,CAAA;IAC/D,qDAAqD;IACrD,+EAA2D,CAAA;AAC/D,CAAC,EAXW,gBAAgB,gCAAhB,gBAAgB,QAW3B"}

package/dist/cjs/modules/safety/enums/safety-error-code.enum.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafetyCheckErrorCode = void 0;
+/**
+ * Machine-readable `code` on every error clarion-safety returns, so the app can
+ * react (e.g. adopt the check a duplicate start collided with) without parsing
+ * the human message.
+ */
+var SafetyCheckErrorCode;
+(function (SafetyCheckErrorCode) {
+    SafetyCheckErrorCode["NOT_FOUND"] = "SAFETY_CHECK_NOT_FOUND";
+    SafetyCheckErrorCode["ALREADY_ACTIVE"] = "SAFETY_CHECK_ALREADY_ACTIVE";
+    SafetyCheckErrorCode["ALREADY_ENDED"] = "SAFETY_CHECK_ENDED";
+    SafetyCheckErrorCode["SOS_ALREADY_TRIGGERED"] = "SAFETY_CHECK_SOS_ALREADY_TRIGGERED";
+    SafetyCheckErrorCode["INVALID_TRANSITION"] = "SAFETY_CHECK_INVALID_TRANSITION";
+    SafetyCheckErrorCode["INVALID_DURATION"] = "SAFETY_CHECK_INVALID_DURATION";
+    SafetyCheckErrorCode["MAX_DURATION_EXCEEDED"] = "SAFETY_CHECK_MAX_DURATION_EXCEEDED";
+    SafetyCheckErrorCode["INVALID_REASON"] = "SAFETY_CHECK_INVALID_REASON";
+    SafetyCheckErrorCode["CUSTOM_REASON_REQUIRED"] = "SAFETY_CHECK_CUSTOM_REASON_REQUIRED";
+    SafetyCheckErrorCode["GUARDIAN_NOT_FOUND"] = "SAFETY_CHECK_GUARDIAN_NOT_FOUND";
+    SafetyCheckErrorCode["GUARDIANS_UNAVAILABLE"] = "SAFETY_CHECK_GUARDIANS_UNAVAILABLE";
+    SafetyCheckErrorCode["NO_SOS_RECIPIENTS"] = "SAFETY_CHECK_NO_SOS_RECIPIENTS";
+    SafetyCheckErrorCode["SERVICE_PROVIDER_NOT_ENTITLED"] = "SAFETY_CHECK_SERVICE_PROVIDER_NOT_ENTITLED";
+    SafetyCheckErrorCode["TRACKING_CLOSED"] = "SAFETY_CHECK_TRACKING_CLOSED";
+    SafetyCheckErrorCode["RATE_LIMITED"] = "SAFETY_CHECK_RATE_LIMITED";
+})(SafetyCheckErrorCode || (exports.SafetyCheckErrorCode = SafetyCheckErrorCode = {}));
+//# sourceMappingURL=safety-error-code.enum.js.map

package/dist/cjs/modules/safety/enums/safety-error-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-error-code.enum.js","sourceRoot":"","sources":["../../../../../src/modules/safety/enums/safety-error-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,oBAgBX;AAhBD,WAAY,oBAAoB;IAC5B,4DAAoC,CAAA;IACpC,sEAA8C,CAAA;IAC9C,4DAAoC,CAAA;IACpC,oFAA4D,CAAA;IAC5D,8EAAsD,CAAA;IACtD,0EAAkD,CAAA;IAClD,oFAA4D,CAAA;IAC5D,sEAA8C,CAAA;IAC9C,sFAA8D,CAAA;IAC9D,8EAAsD,CAAA;IACtD,oFAA4D,CAAA;IAC5D,4EAAoD,CAAA;IACpD,oGAA4E,CAAA;IAC5E,wEAAgD,CAAA;IAChD,kEAA0C,CAAA;AAC9C,CAAC,EAhBW,oBAAoB,oCAApB,oBAAoB,QAgB/B"}