clarion-shared-types 1.0.105 → 1.0.106

package/dist/esm/modules/safety/constants/safety-taxonomy.const.js

@@ -0,0 +1,14 @@
+import { SafetyIncidentCategoryCode, SafetyIncidentTypeCode } from '../enums/safety-enums';
+/**
+ * Names of the platform-managed Safety Alerts category and types, as
+ * clarion-incident provisions them for every organization. The admin shows these
+ * rows read-only (they carry `isSystem: true`).
+ */
+export const SAFETY_ALERTS_TAXONOMY_NAMES = {
+    category: { code: SafetyIncidentCategoryCode.SAFETY_ALERTS, name: 'Safety Alerts' },
+    types: [
+        { code: SafetyIncidentTypeCode.SAFETY_CHECK_SOS, name: 'Safety Check SOS' },
+        { code: SafetyIncidentTypeCode.FOLLOW_ME_SOS, name: 'Follow Me SOS' },
+    ],
+};
+//# sourceMappingURL=safety-taxonomy.const.js.map

package/dist/esm/modules/safety/constants/safety-taxonomy.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-taxonomy.const.js","sourceRoot":"","sources":["../../../../../src/modules/safety/constants/safety-taxonomy.const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE3F;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,0BAA0B,CAAC,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE;IACnF,KAAK,EAAE;QACH,EAAE,IAAI,EAAE,sBAAsB,CAAC,gBAAgB,EAAE,IAAI,EAAE,kBAAkB,EAAE;QAC3E,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE;KACxE;CACK,CAAC"}

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

@@ -0,0 +1,92 @@
+/**
+ * Frontend mirrors of the Safety enums in grm-shared-library.
+ *
+ * Kept in ONE file: the admin's Safety Features screens import them together.
+ * Values are byte-identical to the backend's, because they travel over the wire
+ * as strings and any drift would show up as a silently unstyled chip rather than
+ * a compile error (safety-display.spec.ts pins them).
+ */
+/** Lifecycle of one Safety Check. See the backend enum for what each state means. */
+export 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 || (SafetyCheckStatus = {}));
+/** Why a Safety Check raised an SOS. */
+export var SafetyCheckSosTrigger;
+(function (SafetyCheckSosTrigger) {
+    SafetyCheckSosTrigger["MISSED_CHECK_IN"] = "MISSED_CHECK_IN";
+    SafetyCheckSosTrigger["USER_REQUESTED"] = "USER_REQUESTED";
+})(SafetyCheckSosTrigger || (SafetyCheckSosTrigger = {}));
+/** Who caused a Safety Check transition. */
+export var SafetyCheckActorType;
+(function (SafetyCheckActorType) {
+    SafetyCheckActorType["USER"] = "USER";
+    SafetyCheckActorType["WORKFLOW"] = "WORKFLOW";
+    SafetyCheckActorType["RECONCILER"] = "RECONCILER";
+    SafetyCheckActorType["SYSTEM"] = "SYSTEM";
+})(SafetyCheckActorType || (SafetyCheckActorType = {}));
+/** Audit trail entries. Never carries a location. */
+export 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 || (SafetyCheckAuditEventType = {}));
+/** The safety features that can raise an incident. */
+export var SafetyFeature;
+(function (SafetyFeature) {
+    SafetyFeature["SAFETY_CHECK"] = "SAFETY_CHECK";
+    SafetyFeature["FOLLOW_ME"] = "FOLLOW_ME";
+})(SafetyFeature || (SafetyFeature = {}));
+/** Stable code of the incident category every organization receives. */
+export var SafetyIncidentCategoryCode;
+(function (SafetyIncidentCategoryCode) {
+    SafetyIncidentCategoryCode["SAFETY_ALERTS"] = "SAFETY_ALERTS";
+})(SafetyIncidentCategoryCode || (SafetyIncidentCategoryCode = {}));
+/** Stable codes of the incident types inside the Safety Alerts category. */
+export var SafetyIncidentTypeCode;
+(function (SafetyIncidentTypeCode) {
+    SafetyIncidentTypeCode["SAFETY_CHECK_SOS"] = "SAFETY_CHECK_SOS";
+    SafetyIncidentTypeCode["FOLLOW_ME_SOS"] = "FOLLOW_ME_SOS";
+})(SafetyIncidentTypeCode || (SafetyIncidentTypeCode = {}));
+/** Machine-readable `code` on errors clarion-safety returns. */
+export 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 || (SafetyCheckErrorCode = {}));
+//# sourceMappingURL=safety-enums.js.map

package/dist/esm/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;;;;;;;GAOG;AAEH,qFAAqF;AACrF,MAAM,CAAN,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,KAAjB,iBAAiB,QAU5B;AAED,wCAAwC;AACxC,MAAM,CAAN,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC7B,4DAAmC,CAAA;IACnC,0DAAiC,CAAA;AACrC,CAAC,EAHW,qBAAqB,KAArB,qBAAqB,QAGhC;AAED,4CAA4C;AAC5C,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC5B,qCAAa,CAAA;IACb,6CAAqB,CAAA;IACrB,iDAAyB,CAAA;IACzB,yCAAiB,CAAA;AACrB,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B;AAED,qDAAqD;AACrD,MAAM,CAAN,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,KAAzB,yBAAyB,QAiBpC;AAED,sDAAsD;AACtD,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACrB,8CAA6B,CAAA;IAC7B,wCAAuB,CAAA;AAC3B,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,wEAAwE;AACxE,MAAM,CAAN,IAAY,0BAEX;AAFD,WAAY,0BAA0B;IAClC,6DAA+B,CAAA;AACnC,CAAC,EAFW,0BAA0B,KAA1B,0BAA0B,QAErC;AAED,4EAA4E;AAC5E,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAC9B,+DAAqC,CAAA;IACrC,yDAA+B,CAAA;AACnC,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC;AAED,gEAAgE;AAChE,MAAM,CAAN,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,KAApB,oBAAoB,QAgB/B"}

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

@@ -0,0 +1,10 @@
+// Enums
+export * from './enums/safety-enums';
+// Constants
+export * from './constants/safety-check-limits.const';
+export * from './constants/safety-taxonomy.const';
+// Interfaces / DTOs
+export * from './interfaces/safety-check.dto';
+// Utilities
+export * from './utils/safety-display.util';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/safety/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,sBAAsB,CAAC;AAErC,YAAY;AACZ,cAAc,uCAAuC,CAAC;AACtD,cAAc,mCAAmC,CAAC;AAElD,oBAAoB;AACpB,cAAc,+BAA+B,CAAC;AAE9C,YAAY;AACZ,cAAc,6BAA6B,CAAC"}

package/dist/esm/modules/safety/interfaces/safety-check.dto.js

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

package/dist/esm/modules/safety/interfaces/safety-check.dto.js.map

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

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

@@ -0,0 +1,89 @@
+import { SafetyCheckActorType, SafetyCheckAuditEventType, SafetyCheckSosTrigger, SafetyCheckStatus, } from '../enums/safety-enums';
+/**
+ * Human labels for the Safety enums, kept here so every screen that shows a
+ * Safety Check names the same state the same way.
+ */
+export const SAFETY_CHECK_STATUS_LABELS = {
+    [SafetyCheckStatus.CREATED]: 'Starting',
+    [SafetyCheckStatus.ACTIVE]: 'In progress',
+    [SafetyCheckStatus.PROMPTING]: 'Awaiting check-in',
+    [SafetyCheckStatus.CHECKED_IN]: 'Checked in',
+    [SafetyCheckStatus.SOS_TRIGGERED]: 'SOS raised',
+    [SafetyCheckStatus.STOPPED]: 'Stopped',
+    [SafetyCheckStatus.EXPIRED]: 'Expired',
+    [SafetyCheckStatus.CANCELLED]: 'Cancelled',
+    [SafetyCheckStatus.FAILED]: 'SOS failed',
+};
+export const SAFETY_CHECK_SOS_TRIGGER_LABELS = {
+    [SafetyCheckSosTrigger.MISSED_CHECK_IN]: 'Missed check-in',
+    [SafetyCheckSosTrigger.USER_REQUESTED]: 'Requested by user',
+};
+export const SAFETY_CHECK_ACTOR_TYPE_LABELS = {
+    [SafetyCheckActorType.USER]: 'User',
+    [SafetyCheckActorType.WORKFLOW]: 'Timer',
+    [SafetyCheckActorType.RECONCILER]: 'Recovery sweep',
+    [SafetyCheckActorType.SYSTEM]: 'System',
+};
+export const SAFETY_CHECK_AUDIT_EVENT_LABELS = {
+    [SafetyCheckAuditEventType.CREATED]: 'Safety Check requested',
+    [SafetyCheckAuditEventType.ACTIVATED]: 'Safety Check started',
+    [SafetyCheckAuditEventType.TRACKING_STARTED]: 'Private location tracking started',
+    [SafetyCheckAuditEventType.TRACKING_UNAVAILABLE]: 'Location tracking unavailable',
+    [SafetyCheckAuditEventType.WORKFLOW_STARTED]: 'Check-in timer scheduled',
+    [SafetyCheckAuditEventType.WORKFLOW_START_FAILED]: 'Check-in timer could not be scheduled',
+    [SafetyCheckAuditEventType.EXTENDED]: 'Extended',
+    [SafetyCheckAuditEventType.PROMPT_STARTED]: 'Check-in prompt shown',
+    [SafetyCheckAuditEventType.CHECKED_IN]: 'User checked in',
+    [SafetyCheckAuditEventType.STOPPED]: 'Stopped by user',
+    [SafetyCheckAuditEventType.CANCELLED]: 'Cancelled',
+    [SafetyCheckAuditEventType.SOS_TRIGGERED]: 'SOS triggered',
+    [SafetyCheckAuditEventType.SOS_INCIDENT_CREATED]: 'SOS incident created',
+    [SafetyCheckAuditEventType.SOS_INCIDENT_RETRY]: 'SOS incident creation retried',
+    [SafetyCheckAuditEventType.SOS_FAILED]: 'SOS could not be raised',
+    [SafetyCheckAuditEventType.EXPIRED]: 'Expired without SOS',
+};
+export function safetyCheckStatusTone(status) {
+    switch (status) {
+        case SafetyCheckStatus.CHECKED_IN:
+            return 'success';
+        case SafetyCheckStatus.CREATED:
+        case SafetyCheckStatus.ACTIVE:
+            return 'info';
+        case SafetyCheckStatus.PROMPTING:
+            return 'warn';
+        case SafetyCheckStatus.SOS_TRIGGERED:
+        case SafetyCheckStatus.FAILED:
+        case SafetyCheckStatus.EXPIRED:
+            return 'danger';
+        default:
+            return 'neutral';
+    }
+}
+/** Whether the check is still running (the user is "in" it). */
+export function isOpenSafetyCheck(status) {
+    return (status === SafetyCheckStatus.CREATED ||
+        status === SafetyCheckStatus.ACTIVE ||
+        status === SafetyCheckStatus.PROMPTING);
+}
+/** "15 min", "2 h", "1 h 30 min", "24 h". */
+export function formatSafetyCheckDuration(minutes) {
+    if (minutes === null || minutes === undefined || !Number.isFinite(minutes) || minutes < 0)
+        return '—';
+    const whole = Math.round(minutes);
+    const hours = Math.floor(whole / 60);
+    const rest = whole % 60;
+    if (hours === 0)
+        return `${rest} min`;
+    if (rest === 0)
+        return `${hours} h`;
+    return `${hours} h ${rest} min`;
+}
+/** A distance in metres as the admin shows it. */
+export function formatSafetyTripDistance(metres) {
+    if (metres === null || metres === undefined || !Number.isFinite(metres) || metres < 0)
+        return '—';
+    if (metres < 1000)
+        return `${Math.round(metres)} m`;
+    return `${(metres / 1000).toFixed(1)} km`;
+}
+//# sourceMappingURL=safety-display.util.js.map

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

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

package/dist/types/index.d.ts

@@ -22,5 +22,6 @@ export * from './modules/alert-dispatch/index';
 export * from './modules/alert-intake/index';
 export * from './modules/partner/index';
 export * from './modules/support/index';
+export * from './modules/safety/index';
 export * from './modules/common/interfaces/server-message';
 export * from './modules/common/interfaces/pagination';

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Which of a reporter's guardians an alert is for. Mirrors grm-shared-library.
+ *
+ * Absent means EVERY guardian (the behaviour of a plain SOS). Present means
+ * exactly these guardians: a Safety Check's SOS goes only to the guardians the
+ * user ticked when they started it. App-user guardians are identified by user id,
+ * external contacts by their E.164 phone number.
+ */
+export interface GuardianAudience {
+    systemGuardianUserIds: number[];
+    externalGuardianPhoneNumbers: string[];
+}

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

@@ -4,5 +4,14 @@ export interface IncidentCategory {
     name: string;
     description?: string;
     organizationId: number;
+    /** Stable code of a platform-managed row (e.g. SAFETY_CHECK_SOS); null for an organization's own. */
+    code?: string | null;
+    /**
+     * Platform-managed (the Safety Alerts category and its types): provisioned for
+     * every organization, hidden from the SOS sheet and package configuration, and
+     * not editable or deletable. Lists include these rows only when asked with
+     * `includeSystem=true`.
+     */
+    isSystem?: boolean;
     types?: IncidentType[];
 }

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

@@ -5,5 +5,14 @@ export interface IncidentType {
     description?: string;
     categoryId?: number;
     organizationId: number;
+    /** Stable code of a platform-managed row (e.g. SAFETY_CHECK_SOS); null for an organization's own. */
+    code?: string | null;
+    /**
+     * Platform-managed (the Safety Alerts category and its types): provisioned for
+     * every organization, hidden from the SOS sheet and package configuration, and
+     * not editable or deletable. Lists include these rows only when asked with
+     * `includeSystem=true`.
+     */
+    isSystem?: boolean;
     category?: IncidentCategory;
 }

package/dist/types/modules/permission/enums/permission-actions.enum.d.ts

@@ -175,6 +175,9 @@ export declare enum PermissionActions {
     REVIEW_ALERT_INTAKE_SCREENED_MESSAGE = "review:alert-intake-screened-message",
     READ_ALERT_INTAKE_ANALYTICS = "read:alert-intake-analytics",
     MANAGE_ALERT_INTAKE_PLATFORM = "manage:alert-intake-platform",
+    USE_SAFETY_CHECK = "use:safety-check",
+    READ_SAFETY_CHECK = "read:safety-check",
+    MANAGE_SAFETY_CHECK_REASON = "manage:safety-check-reason",
     /** @deprecated Retiring: split into the connection / message / screened-message / analytics actions. */
     READ_ALERT_INTAKE = "read:alert-intake",
     /** @deprecated Retiring: split into the connection / message / screened-message / analytics actions. */

package/dist/types/modules/permission/enums/permissions-moudule.enum.d.ts

@@ -12,5 +12,6 @@ export declare enum PermissionsModule {
     NEWSFEED = "Newsfeed",
     SUPPORT = "Support",
     NOTIFICATION = "Notification",
-    ALERT_INTAKE = "Alert Intake"
+    ALERT_INTAKE = "Alert Intake",
+    SAFETY = "Safety"
 }

package/dist/types/modules/role/constants/safety-roles.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The organization roles that curate the Safety Check reasons their app offers.
+ * Mirrors grm-shared-library, where roles.spec.ts asserts each holds
+ * manage:safety-check-reason. Platform-wide reasons are Super-Admin's alone.
+ */
+export declare const SAFETY_MANAGER_ROLES: string[];
+/** Staff who may read Safety Checks: the managers, and a control-centre admin within their control centre. */
+export declare const SAFETY_VIEWER_ROLES: string[];

package/dist/types/modules/role/index.d.ts

@@ -3,3 +3,4 @@ export * from './interfaces/role';
 export * from './constants/roles-by-scope';
 export * from './constants/billing-roles';
 export * from './constants/newsfeed-roles';
+export * from './constants/safety-roles';

package/dist/types/modules/safety/constants/safety-check-limits.const.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The Safety Check limits. Mirrors grm-shared-library, which is what the server
+ * enforces - the admin only displays them.
+ */
+export declare const SAFETY_CHECK_LIMITS: {
+    readonly minDurationMinutes: 1;
+    readonly maxDurationMinutes: number;
+    readonly defaultDurationMinutes: 15;
+    readonly presetDurationsMinutes: readonly number[];
+    readonly minPromptCountdownSeconds: 15;
+    readonly maxPromptCountdownSeconds: number;
+    readonly defaultPromptCountdownSeconds: 60;
+    readonly checkInGraceSeconds: 10;
+    readonly staleSosWindowMinutes: number;
+    readonly customReasonMaxLength: 120;
+    readonly maxTrackPointsPerBatch: 200;
+};
+export declare const SAFETY_CHECK_DEFAULTS: {
+    readonly durationMinutes: 15;
+    readonly promptCountdownSeconds: 60;
+    readonly allGuardiansSelected: true;
+    readonly notifyServiceProvider: true;
+    readonly notifyGuardiansOnStartEnd: true;
+    readonly vibrate: true;
+    readonly alarmSound: true;
+};
+/** States in which the user is "in a Safety Check". */
+export declare const OPEN_SAFETY_CHECK_STATUS_VALUES: readonly string[];
+/** Upper-snake reason code, as the backend validates it. */
+export declare const SAFETY_CHECK_REASON_CODE_PATTERN: RegExp;

package/dist/types/modules/safety/constants/safety-taxonomy.const.d.ts

@@ -0,0 +1,19 @@
+import { SafetyIncidentCategoryCode, SafetyIncidentTypeCode } from '../enums/safety-enums';
+/**
+ * Names of the platform-managed Safety Alerts category and types, as
+ * clarion-incident provisions them for every organization. The admin shows these
+ * rows read-only (they carry `isSystem: true`).
+ */
+export declare const SAFETY_ALERTS_TAXONOMY_NAMES: {
+    readonly category: {
+        readonly code: SafetyIncidentCategoryCode;
+        readonly name: "Safety Alerts";
+    };
+    readonly types: readonly [{
+        readonly code: SafetyIncidentTypeCode.SAFETY_CHECK_SOS;
+        readonly name: "Safety Check SOS";
+    }, {
+        readonly code: SafetyIncidentTypeCode.FOLLOW_ME_SOS;
+        readonly name: "Follow Me SOS";
+    }];
+};

package/dist/types/modules/safety/enums/safety-enums.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Frontend mirrors of the Safety enums in grm-shared-library.
+ *
+ * Kept in ONE file: the admin's Safety Features screens import them together.
+ * Values are byte-identical to the backend's, because they travel over the wire
+ * as strings and any drift would show up as a silently unstyled chip rather than
+ * a compile error (safety-display.spec.ts pins them).
+ */
+/** Lifecycle of one Safety Check. See the backend enum for what each state means. */
+export declare enum SafetyCheckStatus {
+    CREATED = "CREATED",
+    ACTIVE = "ACTIVE",
+    PROMPTING = "PROMPTING",
+    CHECKED_IN = "CHECKED_IN",
+    SOS_TRIGGERED = "SOS_TRIGGERED",
+    STOPPED = "STOPPED",
+    EXPIRED = "EXPIRED",
+    CANCELLED = "CANCELLED",
+    FAILED = "FAILED"
+}
+/** Why a Safety Check raised an SOS. */
+export declare enum SafetyCheckSosTrigger {
+    MISSED_CHECK_IN = "MISSED_CHECK_IN",
+    USER_REQUESTED = "USER_REQUESTED"
+}
+/** Who caused a Safety Check transition. */
+export declare enum SafetyCheckActorType {
+    USER = "USER",
+    WORKFLOW = "WORKFLOW",
+    RECONCILER = "RECONCILER",
+    SYSTEM = "SYSTEM"
+}
+/** Audit trail entries. Never carries a location. */
+export declare enum SafetyCheckAuditEventType {
+    CREATED = "CREATED",
+    ACTIVATED = "ACTIVATED",
+    TRACKING_STARTED = "TRACKING_STARTED",
+    TRACKING_UNAVAILABLE = "TRACKING_UNAVAILABLE",
+    WORKFLOW_STARTED = "WORKFLOW_STARTED",
+    WORKFLOW_START_FAILED = "WORKFLOW_START_FAILED",
+    EXTENDED = "EXTENDED",
+    PROMPT_STARTED = "PROMPT_STARTED",
+    CHECKED_IN = "CHECKED_IN",
+    STOPPED = "STOPPED",
+    CANCELLED = "CANCELLED",
+    SOS_TRIGGERED = "SOS_TRIGGERED",
+    SOS_INCIDENT_CREATED = "SOS_INCIDENT_CREATED",
+    SOS_INCIDENT_RETRY = "SOS_INCIDENT_RETRY",
+    SOS_FAILED = "SOS_FAILED",
+    EXPIRED = "EXPIRED"
+}
+/** The safety features that can raise an incident. */
+export declare enum SafetyFeature {
+    SAFETY_CHECK = "SAFETY_CHECK",
+    FOLLOW_ME = "FOLLOW_ME"
+}
+/** Stable code of the incident category every organization receives. */
+export declare enum SafetyIncidentCategoryCode {
+    SAFETY_ALERTS = "SAFETY_ALERTS"
+}
+/** Stable codes of the incident types inside the Safety Alerts category. */
+export declare enum SafetyIncidentTypeCode {
+    SAFETY_CHECK_SOS = "SAFETY_CHECK_SOS",
+    FOLLOW_ME_SOS = "FOLLOW_ME_SOS"
+}
+/** Machine-readable `code` on errors clarion-safety returns. */
+export declare enum SafetyCheckErrorCode {
+    NOT_FOUND = "SAFETY_CHECK_NOT_FOUND",
+    ALREADY_ACTIVE = "SAFETY_CHECK_ALREADY_ACTIVE",
+    ALREADY_ENDED = "SAFETY_CHECK_ENDED",
+    SOS_ALREADY_TRIGGERED = "SAFETY_CHECK_SOS_ALREADY_TRIGGERED",
+    INVALID_TRANSITION = "SAFETY_CHECK_INVALID_TRANSITION",
+    INVALID_DURATION = "SAFETY_CHECK_INVALID_DURATION",
+    MAX_DURATION_EXCEEDED = "SAFETY_CHECK_MAX_DURATION_EXCEEDED",
+    INVALID_REASON = "SAFETY_CHECK_INVALID_REASON",
+    CUSTOM_REASON_REQUIRED = "SAFETY_CHECK_CUSTOM_REASON_REQUIRED",
+    GUARDIAN_NOT_FOUND = "SAFETY_CHECK_GUARDIAN_NOT_FOUND",
+    GUARDIANS_UNAVAILABLE = "SAFETY_CHECK_GUARDIANS_UNAVAILABLE",
+    NO_SOS_RECIPIENTS = "SAFETY_CHECK_NO_SOS_RECIPIENTS",
+    SERVICE_PROVIDER_NOT_ENTITLED = "SAFETY_CHECK_SERVICE_PROVIDER_NOT_ENTITLED",
+    TRACKING_CLOSED = "SAFETY_CHECK_TRACKING_CLOSED",
+    RATE_LIMITED = "SAFETY_CHECK_RATE_LIMITED"
+}

package/dist/types/modules/safety/index.d.ts

@@ -0,0 +1,5 @@
+export * from './enums/safety-enums';
+export * from './constants/safety-check-limits.const';
+export * from './constants/safety-taxonomy.const';
+export * from './interfaces/safety-check.dto';
+export * from './utils/safety-display.util';

package/dist/types/modules/safety/interfaces/safety-check.dto.d.ts

@@ -0,0 +1,176 @@
+import { GuardianAudience } from '../../alert-dispatch/interfaces/guardian-audience';
+import { SafetyCheckActorType, SafetyCheckAuditEventType, SafetyCheckSosTrigger, SafetyCheckStatus } from '../enums/safety-enums';
+/**
+ * Response shapes of clarion-safety, mirrored from grm-shared-library
+ * (modules/safety/interfaces/safety-check.ts). Timestamps are ISO 8601 strings
+ * from the server clock.
+ */
+/** A reason as the app's dropdown shows it. */
+export interface SafetyCheckReasonView {
+    id: string;
+    code: string;
+    label: string;
+    description: string | null;
+    /** The "Write my own" entry: the user types the reason. */
+    isCustom: boolean;
+    displayOrder: number;
+}
+/** A reason as the admin manages it. */
+export interface SafetyCheckReasonAdminView extends SafetyCheckReasonView {
+    /** Null for a platform-wide reason (Super-Admin only). */
+    organizationId: number | null;
+    /** Null for every country. */
+    countryCode: string | null;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Body of POST /safety/admin/check-reasons. */
+export interface CreateSafetyCheckReasonRequest {
+    code: string;
+    label: string;
+    description?: string;
+    organizationId?: number;
+    countryCode?: string;
+    isCustom?: boolean;
+    active?: boolean;
+    displayOrder?: number;
+}
+/** Body of PATCH /safety/admin/check-reasons/:id. Code, organization and custom-ness are fixed. */
+export interface UpdateSafetyCheckReasonRequest {
+    label?: string;
+    description?: string | null;
+    countryCode?: string | null;
+    active?: boolean;
+    displayOrder?: number;
+}
+/** One Safety Check as its owner sees it. */
+export interface SafetyCheckView {
+    id: string;
+    status: SafetyCheckStatus;
+    reasonId: string | null;
+    reasonCode: string | null;
+    reasonLabel: string;
+    customReason: string | null;
+    durationMinutes: number;
+    extensionCount: number;
+    startedAt: string;
+    scheduledCheckInAt: string;
+    promptCountdownSeconds: number;
+    promptStartedAt: string | null;
+    promptDeadlineAt: string | null;
+    checkedInAt: string | null;
+    endedAt: string | null;
+    guardians: GuardianAudience;
+    notifyGuardiansOnStartEnd: boolean;
+    notifyServiceProviderRequested: boolean;
+    notifyServiceProviderAllowed: boolean;
+    sosTrigger: SafetyCheckSosTrigger | null;
+    sosTriggeredAt: string | null;
+    incidentId: number | null;
+    tripId: string | null;
+    serverTime: string;
+}
+/** What the setup screens need from the server. */
+export interface SafetyCheckStartOptions {
+    limits: {
+        minDurationMinutes: number;
+        maxDurationMinutes: number;
+        presetDurationsMinutes: number[];
+        minPromptCountdownSeconds: number;
+        maxPromptCountdownSeconds: number;
+        customReasonMaxLength: number;
+    };
+    defaults: {
+        durationMinutes: number;
+        promptCountdownSeconds: number;
+        notifyServiceProvider: boolean;
+        notifyGuardiansOnStartEnd: boolean;
+    };
+    serviceProvider: {
+        available: boolean;
+        tier: string | null;
+        degraded: boolean;
+    };
+    serverTime: string;
+}
+/** The recorded trip, WITHOUT coordinates - location is never shown before an SOS. */
+export interface SafetyCheckTripSummary {
+    id: string;
+    status: string;
+    visibility: string;
+    purpose: string;
+    incidentId: number | null;
+    startedAt: string;
+    endedAt: string | null;
+    sharedAt: string | null;
+    distanceMeters: number | null;
+    trackPointCount: number;
+}
+export interface SafetyCheckAuditEntry {
+    id: string;
+    eventType: SafetyCheckAuditEventType;
+    fromStatus: SafetyCheckStatus | null;
+    toStatus: SafetyCheckStatus | null;
+    actorType: SafetyCheckActorType;
+    actorUserId: number | null;
+    /** Identifiers and timings only - never a location or a message body. */
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+}
+/** A row of the admin list. */
+export interface SafetyCheckAdminListItem {
+    id: string;
+    status: SafetyCheckStatus;
+    userId: number;
+    userName: string | null;
+    organizationId: number;
+    controlCentreId: number | null;
+    reasonLabel: string;
+    durationMinutes: number;
+    startedAt: string;
+    scheduledCheckInAt: string;
+    checkedInAt: string | null;
+    endedAt: string | null;
+    sosTrigger: SafetyCheckSosTrigger | null;
+    incidentId: number | null;
+    createdAt: string;
+}
+/** The check as the admin detail view receives it. */
+export interface SafetyCheckAdminView extends SafetyCheckView {
+    userId: number;
+    userName: string | null;
+    userPhoneNumber: string | null;
+    organizationId: number;
+    controlCentreId: number | null;
+    appId: string | null;
+    countryCode: string | null;
+    entitlementTierAtStart: string | null;
+    workflowId: string | null;
+    workflowStartedAt: string | null;
+    trackPointCount: number;
+    lastLocationAt: string | null;
+    sosAttempts: number;
+    sosFailureReason: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** The admin detail view. */
+export interface SafetyCheckAdminDetail {
+    check: SafetyCheckAdminView;
+    events: SafetyCheckAuditEntry[];
+    trip: SafetyCheckTripSummary | null;
+}
+/** Filters for GET /safety/admin/checks. */
+export interface SafetyCheckAdminQuery {
+    page?: number;
+    limit?: number;
+    status?: SafetyCheckStatus;
+    /** Super-admin only. */
+    organizationId?: number;
+    userId?: number;
+    sosOnly?: boolean;
+    from?: string;
+    to?: string;
+    id?: string;
+}