clarion-shared-types 1.0.99 → 1.0.101

package/dist/cjs/modules/alert-intake/enums/alert-intake.enum.js

@@ -7,7 +7,7 @@
  * app is sent to.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AlertIntakeRejectionReason = exports.AlertIntakeWebhookVerification = exports.AlertIntakeRouteMatch = exports.AlertIntakeEmergencyPolicy = exports.AlertIntakeSecretSource = exports.AlertIntakeProvider = exports.AlertIntakeChannel = void 0;
+exports.AlertIntakeScreeningDecision = exports.AlertIntakeScreeningStatus = exports.AlertIntakeScreeningSource = exports.AlertIntakeScreeningReason = exports.AlertIntakeMessageState = exports.AlertIntakeRejectionReason = exports.AlertIntakeWebhookVerification = exports.AlertIntakeRouteMatch = exports.AlertIntakeEmergencyPolicy = exports.AlertIntakeSecretSource = exports.AlertIntakeProvider = exports.AlertIntakeChannel = void 0;
 /** The channel a message arrived on. */
 var AlertIntakeChannel;
 (function (AlertIntakeChannel) {
@@ -94,4 +94,76 @@ var AlertIntakeRejectionReason;
     AlertIntakeRejectionReason["ORGANIZATION_INACTIVE"] = "ORGANIZATION_INACTIVE";
     AlertIntakeRejectionReason["RATE_LIMITED"] = "RATE_LIMITED";
 })(AlertIntakeRejectionReason || (exports.AlertIntakeRejectionReason = AlertIntakeRejectionReason = {}));
+/**
+ * Where a stored message stands, as an operator reads it. Derived from the pipeline's
+ * processing status, retry schedule and rejection reason - not stored.
+ *
+ *   QUEUED     waiting for, or being worked on by, the pipeline
+ *   RAISED     became an incident
+ *   RETRYING   failed; another attempt is scheduled
+ *   PARKED     failed and will not be retried on its own: it ran out of attempts, or it
+ *              has a `rejectionReason` (no organization, organization inactive)
+ *   DUPLICATE  the same sender repeating themselves; not raised
+ *   FILTERED   screened out as not a report (a greeting, a link, an advert); held for review
+ */
+var AlertIntakeMessageState;
+(function (AlertIntakeMessageState) {
+    AlertIntakeMessageState["QUEUED"] = "QUEUED";
+    AlertIntakeMessageState["RAISED"] = "RAISED";
+    AlertIntakeMessageState["RETRYING"] = "RETRYING";
+    AlertIntakeMessageState["PARKED"] = "PARKED";
+    AlertIntakeMessageState["DUPLICATE"] = "DUPLICATE";
+    AlertIntakeMessageState["FILTERED"] = "FILTERED";
+})(AlertIntakeMessageState || (exports.AlertIntakeMessageState = AlertIntakeMessageState = {}));
+/**
+ * Why a message was screened out instead of raised. Everything that arrives on a
+ * connection is kept: a screened message waits for a person to raise it or dismiss it.
+ *
+ *   EMPTY                nothing to read: no text, no file, no location
+ *   SYSTEM_EVENT         a notice from the channel itself (WhatsApp "changed number")
+ *   UNSUPPORTED_CONTENT  something the channel could not deliver, a reaction or a sticker
+ *   GREETING             a greeting or pleasantry and nothing else ("Hi", "How are you?")
+ *   LINK_ONLY            a link and nothing else (a forwarded post or video)
+ *   SPAM                 an advert, a promotion, a chain message, a scam
+ *   OFF_TOPIC            reports nothing the organization handles (chat, unrelated questions)
+ *   TEST                 someone testing the number
+ */
+var AlertIntakeScreeningReason;
+(function (AlertIntakeScreeningReason) {
+    AlertIntakeScreeningReason["EMPTY"] = "EMPTY";
+    AlertIntakeScreeningReason["SYSTEM_EVENT"] = "SYSTEM_EVENT";
+    AlertIntakeScreeningReason["UNSUPPORTED_CONTENT"] = "UNSUPPORTED_CONTENT";
+    AlertIntakeScreeningReason["GREETING"] = "GREETING";
+    AlertIntakeScreeningReason["LINK_ONLY"] = "LINK_ONLY";
+    AlertIntakeScreeningReason["SPAM"] = "SPAM";
+    AlertIntakeScreeningReason["OFF_TOPIC"] = "OFF_TOPIC";
+    AlertIntakeScreeningReason["TEST"] = "TEST";
+})(AlertIntakeScreeningReason || (exports.AlertIntakeScreeningReason = AlertIntakeScreeningReason = {}));
+/** What decided a message was not a report: a fixed rule, or the AI screening model. */
+var AlertIntakeScreeningSource;
+(function (AlertIntakeScreeningSource) {
+    AlertIntakeScreeningSource["RULE"] = "RULE";
+    AlertIntakeScreeningSource["AI"] = "AI";
+})(AlertIntakeScreeningSource || (exports.AlertIntakeScreeningSource = AlertIntakeScreeningSource = {}));
+/**
+ * A screened message, from a reviewer's side.
+ *
+ *   PENDING_REVIEW  screened out; nobody has looked at it yet
+ *   ELEVATED        a person decided it IS a report: it was raised as an incident
+ *   DISMISSED       a person confirmed it is not a report
+ */
+var AlertIntakeScreeningStatus;
+(function (AlertIntakeScreeningStatus) {
+    AlertIntakeScreeningStatus["PENDING_REVIEW"] = "PENDING_REVIEW";
+    AlertIntakeScreeningStatus["ELEVATED"] = "ELEVATED";
+    AlertIntakeScreeningStatus["DISMISSED"] = "DISMISSED";
+})(AlertIntakeScreeningStatus || (exports.AlertIntakeScreeningStatus = AlertIntakeScreeningStatus = {}));
+/** A reviewer's decision on screened messages. */
+var AlertIntakeScreeningDecision;
+(function (AlertIntakeScreeningDecision) {
+    /** Raise it as an incident (or a grievance, for a grievance desk) after all. */
+    AlertIntakeScreeningDecision["ELEVATE"] = "ELEVATE";
+    /** Confirm it is not a report. */
+    AlertIntakeScreeningDecision["DISMISS"] = "DISMISS";
+})(AlertIntakeScreeningDecision || (exports.AlertIntakeScreeningDecision = AlertIntakeScreeningDecision = {}));
 //# sourceMappingURL=alert-intake.enum.js.map

package/dist/cjs/modules/alert-intake/enums/alert-intake.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"alert-intake.enum.js","sourceRoot":"","sources":["../../../../../src/modules/alert-intake/enums/alert-intake.enum.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,wCAAwC;AACxC,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,iCAAW,CAAA;IACX,2CAAqB,CAAA;IACrB,qCAAe,CAAA;AACnB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED;;;;;;;;GAQG;AACH,IAAY,mBAaX;AAbD,WAAY,mBAAmB;IAC3B,MAAM;IACN,wDAAiC,CAAA;IACjC,wCAAiB,CAAA;IACjB,wCAAiB,CAAA;IACjB,uFAAuF;IACvF,kDAA2B,CAAA;IAC3B,WAAW;IACX,wDAAiC,CAAA;IACjC,QAAQ;IACR,oCAAa,CAAA;IACb,iGAAiG;IACjG,sDAA+B,CAAA;AACnC,CAAC,EAbW,mBAAmB,mCAAnB,mBAAmB,QAa9B;AAED;;;;;;;;;;GAUG;AACH,IAAY,uBAGX;AAHD,WAAY,uBAAuB;IAC/B,kDAAuB,CAAA;IACvB,gEAAqC,CAAA;AACzC,CAAC,EAHW,uBAAuB,uCAAvB,uBAAuB,QAGlC;AAED;;;;GAIG;AACH,IAAY,0BAIX;AAJD,WAAY,0BAA0B;IAClC,2CAAa,CAAA;IACb,mEAAqC,CAAA;IACrC,2EAA6C,CAAA;AACjD,CAAC,EAJW,0BAA0B,0CAA1B,0BAA0B,QAIrC;AAED,qEAAqE;AACrE,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC7B,oFAAoF;IACpF,4CAAmB,CAAA;IACnB,qEAAqE;IACrE,4CAAmB,CAAA;AACvB,CAAC,EALW,qBAAqB,qCAArB,qBAAqB,QAKhC;AAED,gEAAgE;AAChE,IAAY,8BAOX;AAPD,WAAY,8BAA8B;IACtC,8EAA8E;IAC9E,2DAAyB,CAAA;IACzB,gFAAgF;IAChF,+EAA6C,CAAA;IAC7C,mFAAmF;IACnF,mEAAiC,CAAA;AACrC,CAAC,EAPW,8BAA8B,8CAA9B,8BAA8B,QAOzC;AAED,yFAAyF;AACzF,IAAY,0BAOX;AAPD,WAAY,0BAA0B;IAClC,uEAAyC,CAAA;IACzC,yEAA2C,CAAA;IAC3C,yEAA2C,CAAA;IAC3C,iEAAmC,CAAA;IACnC,6EAA+C,CAAA;IAC/C,2DAA6B,CAAA;AACjC,CAAC,EAPW,0BAA0B,0CAA1B,0BAA0B,QAOrC"}
+{"version":3,"file":"alert-intake.enum.js","sourceRoot":"","sources":["../../../../../src/modules/alert-intake/enums/alert-intake.enum.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/alert-intake/enums/alert-intake.enum.js

@@ -91,4 +91,76 @@ export var AlertIntakeRejectionReason;
     AlertIntakeRejectionReason["ORGANIZATION_INACTIVE"] = "ORGANIZATION_INACTIVE";
     AlertIntakeRejectionReason["RATE_LIMITED"] = "RATE_LIMITED";
 })(AlertIntakeRejectionReason || (AlertIntakeRejectionReason = {}));
+/**
+ * Where a stored message stands, as an operator reads it. Derived from the pipeline's
+ * processing status, retry schedule and rejection reason - not stored.
+ *
+ *   QUEUED     waiting for, or being worked on by, the pipeline
+ *   RAISED     became an incident
+ *   RETRYING   failed; another attempt is scheduled
+ *   PARKED     failed and will not be retried on its own: it ran out of attempts, or it
+ *              has a `rejectionReason` (no organization, organization inactive)
+ *   DUPLICATE  the same sender repeating themselves; not raised
+ *   FILTERED   screened out as not a report (a greeting, a link, an advert); held for review
+ */
+export var AlertIntakeMessageState;
+(function (AlertIntakeMessageState) {
+    AlertIntakeMessageState["QUEUED"] = "QUEUED";
+    AlertIntakeMessageState["RAISED"] = "RAISED";
+    AlertIntakeMessageState["RETRYING"] = "RETRYING";
+    AlertIntakeMessageState["PARKED"] = "PARKED";
+    AlertIntakeMessageState["DUPLICATE"] = "DUPLICATE";
+    AlertIntakeMessageState["FILTERED"] = "FILTERED";
+})(AlertIntakeMessageState || (AlertIntakeMessageState = {}));
+/**
+ * Why a message was screened out instead of raised. Everything that arrives on a
+ * connection is kept: a screened message waits for a person to raise it or dismiss it.
+ *
+ *   EMPTY                nothing to read: no text, no file, no location
+ *   SYSTEM_EVENT         a notice from the channel itself (WhatsApp "changed number")
+ *   UNSUPPORTED_CONTENT  something the channel could not deliver, a reaction or a sticker
+ *   GREETING             a greeting or pleasantry and nothing else ("Hi", "How are you?")
+ *   LINK_ONLY            a link and nothing else (a forwarded post or video)
+ *   SPAM                 an advert, a promotion, a chain message, a scam
+ *   OFF_TOPIC            reports nothing the organization handles (chat, unrelated questions)
+ *   TEST                 someone testing the number
+ */
+export var AlertIntakeScreeningReason;
+(function (AlertIntakeScreeningReason) {
+    AlertIntakeScreeningReason["EMPTY"] = "EMPTY";
+    AlertIntakeScreeningReason["SYSTEM_EVENT"] = "SYSTEM_EVENT";
+    AlertIntakeScreeningReason["UNSUPPORTED_CONTENT"] = "UNSUPPORTED_CONTENT";
+    AlertIntakeScreeningReason["GREETING"] = "GREETING";
+    AlertIntakeScreeningReason["LINK_ONLY"] = "LINK_ONLY";
+    AlertIntakeScreeningReason["SPAM"] = "SPAM";
+    AlertIntakeScreeningReason["OFF_TOPIC"] = "OFF_TOPIC";
+    AlertIntakeScreeningReason["TEST"] = "TEST";
+})(AlertIntakeScreeningReason || (AlertIntakeScreeningReason = {}));
+/** What decided a message was not a report: a fixed rule, or the AI screening model. */
+export var AlertIntakeScreeningSource;
+(function (AlertIntakeScreeningSource) {
+    AlertIntakeScreeningSource["RULE"] = "RULE";
+    AlertIntakeScreeningSource["AI"] = "AI";
+})(AlertIntakeScreeningSource || (AlertIntakeScreeningSource = {}));
+/**
+ * A screened message, from a reviewer's side.
+ *
+ *   PENDING_REVIEW  screened out; nobody has looked at it yet
+ *   ELEVATED        a person decided it IS a report: it was raised as an incident
+ *   DISMISSED       a person confirmed it is not a report
+ */
+export var AlertIntakeScreeningStatus;
+(function (AlertIntakeScreeningStatus) {
+    AlertIntakeScreeningStatus["PENDING_REVIEW"] = "PENDING_REVIEW";
+    AlertIntakeScreeningStatus["ELEVATED"] = "ELEVATED";
+    AlertIntakeScreeningStatus["DISMISSED"] = "DISMISSED";
+})(AlertIntakeScreeningStatus || (AlertIntakeScreeningStatus = {}));
+/** A reviewer's decision on screened messages. */
+export var AlertIntakeScreeningDecision;
+(function (AlertIntakeScreeningDecision) {
+    /** Raise it as an incident (or a grievance, for a grievance desk) after all. */
+    AlertIntakeScreeningDecision["ELEVATE"] = "ELEVATE";
+    /** Confirm it is not a report. */
+    AlertIntakeScreeningDecision["DISMISS"] = "DISMISS";
+})(AlertIntakeScreeningDecision || (AlertIntakeScreeningDecision = {}));
 //# sourceMappingURL=alert-intake.enum.js.map

package/dist/esm/modules/alert-intake/enums/alert-intake.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"alert-intake.enum.js","sourceRoot":"","sources":["../../../../../src/modules/alert-intake/enums/alert-intake.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wCAAwC;AACxC,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,iCAAW,CAAA;IACX,2CAAqB,CAAA;IACrB,qCAAe,CAAA;AACnB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B;AAED;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,mBAaX;AAbD,WAAY,mBAAmB;IAC3B,MAAM;IACN,wDAAiC,CAAA;IACjC,wCAAiB,CAAA;IACjB,wCAAiB,CAAA;IACjB,uFAAuF;IACvF,kDAA2B,CAAA;IAC3B,WAAW;IACX,wDAAiC,CAAA;IACjC,QAAQ;IACR,oCAAa,CAAA;IACb,iGAAiG;IACjG,sDAA+B,CAAA;AACnC,CAAC,EAbW,mBAAmB,KAAnB,mBAAmB,QAa9B;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,uBAGX;AAHD,WAAY,uBAAuB;IAC/B,kDAAuB,CAAA;IACvB,gEAAqC,CAAA;AACzC,CAAC,EAHW,uBAAuB,KAAvB,uBAAuB,QAGlC;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,0BAIX;AAJD,WAAY,0BAA0B;IAClC,2CAAa,CAAA;IACb,mEAAqC,CAAA;IACrC,2EAA6C,CAAA;AACjD,CAAC,EAJW,0BAA0B,KAA1B,0BAA0B,QAIrC;AAED,qEAAqE;AACrE,MAAM,CAAN,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC7B,oFAAoF;IACpF,4CAAmB,CAAA;IACnB,qEAAqE;IACrE,4CAAmB,CAAA;AACvB,CAAC,EALW,qBAAqB,KAArB,qBAAqB,QAKhC;AAED,gEAAgE;AAChE,MAAM,CAAN,IAAY,8BAOX;AAPD,WAAY,8BAA8B;IACtC,8EAA8E;IAC9E,2DAAyB,CAAA;IACzB,gFAAgF;IAChF,+EAA6C,CAAA;IAC7C,mFAAmF;IACnF,mEAAiC,CAAA;AACrC,CAAC,EAPW,8BAA8B,KAA9B,8BAA8B,QAOzC;AAED,yFAAyF;AACzF,MAAM,CAAN,IAAY,0BAOX;AAPD,WAAY,0BAA0B;IAClC,uEAAyC,CAAA;IACzC,yEAA2C,CAAA;IAC3C,yEAA2C,CAAA;IAC3C,iEAAmC,CAAA;IACnC,6EAA+C,CAAA;IAC/C,2DAA6B,CAAA;AACjC,CAAC,EAPW,0BAA0B,KAA1B,0BAA0B,QAOrC"}
+{"version":3,"file":"alert-intake.enum.js","sourceRoot":"","sources":["../../../../../src/modules/alert-intake/enums/alert-intake.enum.ts"],"names":[],"mappings":"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"}

package/dist/types/modules/alert-intake/enums/alert-intake.enum.d.ts

@@ -81,3 +81,70 @@ export declare enum AlertIntakeRejectionReason {
     ORGANIZATION_INACTIVE = "ORGANIZATION_INACTIVE",
     RATE_LIMITED = "RATE_LIMITED"
 }
+/**
+ * Where a stored message stands, as an operator reads it. Derived from the pipeline's
+ * processing status, retry schedule and rejection reason - not stored.
+ *
+ *   QUEUED     waiting for, or being worked on by, the pipeline
+ *   RAISED     became an incident
+ *   RETRYING   failed; another attempt is scheduled
+ *   PARKED     failed and will not be retried on its own: it ran out of attempts, or it
+ *              has a `rejectionReason` (no organization, organization inactive)
+ *   DUPLICATE  the same sender repeating themselves; not raised
+ *   FILTERED   screened out as not a report (a greeting, a link, an advert); held for review
+ */
+export declare enum AlertIntakeMessageState {
+    QUEUED = "QUEUED",
+    RAISED = "RAISED",
+    RETRYING = "RETRYING",
+    PARKED = "PARKED",
+    DUPLICATE = "DUPLICATE",
+    FILTERED = "FILTERED"
+}
+/**
+ * Why a message was screened out instead of raised. Everything that arrives on a
+ * connection is kept: a screened message waits for a person to raise it or dismiss it.
+ *
+ *   EMPTY                nothing to read: no text, no file, no location
+ *   SYSTEM_EVENT         a notice from the channel itself (WhatsApp "changed number")
+ *   UNSUPPORTED_CONTENT  something the channel could not deliver, a reaction or a sticker
+ *   GREETING             a greeting or pleasantry and nothing else ("Hi", "How are you?")
+ *   LINK_ONLY            a link and nothing else (a forwarded post or video)
+ *   SPAM                 an advert, a promotion, a chain message, a scam
+ *   OFF_TOPIC            reports nothing the organization handles (chat, unrelated questions)
+ *   TEST                 someone testing the number
+ */
+export declare enum AlertIntakeScreeningReason {
+    EMPTY = "EMPTY",
+    SYSTEM_EVENT = "SYSTEM_EVENT",
+    UNSUPPORTED_CONTENT = "UNSUPPORTED_CONTENT",
+    GREETING = "GREETING",
+    LINK_ONLY = "LINK_ONLY",
+    SPAM = "SPAM",
+    OFF_TOPIC = "OFF_TOPIC",
+    TEST = "TEST"
+}
+/** What decided a message was not a report: a fixed rule, or the AI screening model. */
+export declare enum AlertIntakeScreeningSource {
+    RULE = "RULE",
+    AI = "AI"
+}
+/**
+ * A screened message, from a reviewer's side.
+ *
+ *   PENDING_REVIEW  screened out; nobody has looked at it yet
+ *   ELEVATED        a person decided it IS a report: it was raised as an incident
+ *   DISMISSED       a person confirmed it is not a report
+ */
+export declare enum AlertIntakeScreeningStatus {
+    PENDING_REVIEW = "PENDING_REVIEW",
+    ELEVATED = "ELEVATED",
+    DISMISSED = "DISMISSED"
+}
+/** A reviewer's decision on screened messages. */
+export declare enum AlertIntakeScreeningDecision {
+    /** Raise it as an incident (or a grievance, for a grievance desk) after all. */
+    ELEVATE = "ELEVATE",
+    /** Confirm it is not a report. */
+    DISMISS = "DISMISS"
+}

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

@@ -1,5 +1,5 @@
 import { CountryCode } from '../../country/enums/country-code.enum';
-import { AlertIntakeChannel, AlertIntakeEmergencyPolicy, AlertIntakeProvider, AlertIntakeRouteMatch, AlertIntakeSecretSource, AlertIntakeWebhookVerification } from '../enums/alert-intake.enum';
+import { AlertIntakeChannel, AlertIntakeEmergencyPolicy, AlertIntakeMessageState, AlertIntakeProvider, AlertIntakeRejectionReason, AlertIntakeRouteMatch, AlertIntakeScreeningDecision, AlertIntakeScreeningReason, AlertIntakeScreeningSource, AlertIntakeScreeningStatus, AlertIntakeSecretSource, AlertIntakeWebhookVerification } from '../enums/alert-intake.enum';
 /**
  * Alert intake settings.
  *
@@ -146,6 +146,152 @@ export interface OrganizationAlertIntakeSettings {
     platformFallbacks: AlertIntakePlatformFallback[];
     /** False when the service has no key to encrypt credentials with: only secret references can be used. */
     encryptedSecretsAvailable: boolean;
+    /** What arrived for this organization recently, and what needs someone's attention. */
+    activity?: AlertIntakeActivitySummary;
+}
+/** Counts over the last `windowHours` - except `parked` and `failingConnections`, which are as of now. */
+export interface AlertIntakeActivitySummary {
+    windowHours: number;
+    received: number;
+    raised: number;
+    duplicates: number;
+    retrying: number;
+    /** Waiting for an operator: out of attempts, or held for a reason (no organization, organization inactive). */
+    parked: number;
+    /** Enabled connections whose last attempt failed (a rejected call, a mailbox that could not be read). */
+    failingConnections: number;
+    /** Screened out as not a report, in the window. */
+    screened?: number;
+    /** Screened messages nobody has reviewed yet (as of now). */
+    awaitingReview?: number;
+}
+/** What is kept of a file that came with a message. Never its contents. */
+export interface AlertIntakeMessageAttachment {
+    fileName: string;
+    mimeType: string;
+    size: number;
+    /** True once the file is stored in DMS and linked to the incident. */
+    attached: boolean;
+    /** Why it was not attached, when it was not. */
+    error: string | null;
+}
+/**
+ * A stored message, as an operator sees it in a list. `preview` is the start of the
+ * text; the whole of it is only in the detail.
+ */
+export interface AlertIntakeMessage {
+    id: string;
+    /** Null while no organization has been found for it. */
+    organizationId: number | null;
+    connectionId: string | null;
+    connectionName: string | null;
+    channel: AlertIntakeChannel;
+    /** Phone number, WhatsApp number or email address, as stored. */
+    sender: string | null;
+    senderName: string | null;
+    subject: string | null;
+    preview: string;
+    /** The keyword that routed it, on a platform connection. */
+    routeKeyword: string | null;
+    state: AlertIntakeMessageState;
+    rejectionReason: AlertIntakeRejectionReason | null;
+    /** Why it was screened out, for FILTERED (and for one raised after review). */
+    screeningReason?: AlertIntakeScreeningReason | null;
+    /** The last error, for RETRYING and PARKED. */
+    error: string | null;
+    attempts: number;
+    nextAttemptAt: string | null;
+    /** The incident it raised. */
+    incidentId: number | null;
+    attachmentCount: number;
+    /** When the sender was told their message was received, if they were. */
+    acknowledgedAt: string | null;
+    receivedAt: string;
+    updatedAt: string;
+    /** What the CALLER may do with it now. */
+    actions: {
+        /** Try again: a PARKED message that ran out of attempts, or whose organization is active again. */
+        retry: boolean;
+        /** Raise a message that was taken for a duplicate. */
+        raiseAnyway: boolean;
+        /** Give a message no route claimed to an organization (platform operators). */
+        assign: boolean;
+    };
+}
+export interface AlertIntakeMessageDetail extends AlertIntakeMessage {
+    /** What the incident is raised from (a routing keyword removed). */
+    content: string;
+    /** Exactly as received. */
+    originalContent: string;
+    attachments: AlertIntakeMessageAttachment[];
+    acknowledgementError: string | null;
+}
+export interface AlertIntakeMessagePage {
+    items: AlertIntakeMessage[];
+    total: number;
+    page: number;
+    limit: number;
+}
+/**
+ * A message screened out as not a report, waiting for (or after) a person's review.
+ * Kept in its own table: the review queue. Raising one ("elevate") sends it through the
+ * pipeline without the screening step, and links the incident it becomes.
+ */
+export interface AlertIntakeScreenedMessage {
+    id: string;
+    /** The stored message (see the messages API). */
+    messageId: string;
+    organizationId: number;
+    connectionId: string | null;
+    connectionName: string | null;
+    channel: AlertIntakeChannel;
+    sender: string | null;
+    senderName: string | null;
+    subject: string | null;
+    preview: string;
+    /** ISO 639-1 code of the language it was written in, when known. */
+    language: string | null;
+    /** English translation, when it was written in another language. */
+    translation: string | null;
+    reason: AlertIntakeScreeningReason;
+    /** One sentence, for the reviewer: why it was screened out. */
+    explanation: string;
+    decidedBy: AlertIntakeScreeningSource;
+    /** The screening model's confidence (0-1). Null for a rule. */
+    confidence: number | null;
+    status: AlertIntakeScreeningStatus;
+    reviewedBy: number | null;
+    reviewedAt: string | null;
+    reviewNote: string | null;
+    /** The incident it became, once elevated and raised. */
+    incidentId: number | null;
+    attachmentCount: number;
+    receivedAt: string;
+    screenedAt: string;
+    /** What the CALLER may do with it now. */
+    actions: {
+        elevate: boolean;
+        dismiss: boolean;
+    };
+}
+export interface AlertIntakeScreenedMessageDetail extends AlertIntakeScreenedMessage {
+    /** Exactly as received. */
+    content: string;
+    attachments: AlertIntakeMessageAttachment[];
+}
+export interface AlertIntakeScreenedMessagePage {
+    items: AlertIntakeScreenedMessage[];
+    total: number;
+    page: number;
+    limit: number;
+}
+/** The outcome of a review: which messages changed, and why the others did not. */
+export interface AlertIntakeScreeningReviewResult {
+    updated: string[];
+    skipped: Array<{
+        id: string;
+        reason: string;
+    }>;
 }
 export interface AlertIntakeConnectionTestResult {
     success: boolean;
@@ -200,3 +346,43 @@ export interface UpdateAlertIntakeRoute {
 export type AlertIntakePlatformConnection = AlertIntakeConnection & {
     routes: AlertIntakeRoute[];
 };
+/** Filters for an organization's stored messages (query string). `limit` is at most 100. */
+export interface ListAlertIntakeMessagesQuery {
+    state?: AlertIntakeMessageState;
+    channel?: AlertIntakeChannel;
+    connectionId?: string;
+    reason?: AlertIntakeRejectionReason;
+    page?: number;
+    limit?: number;
+}
+/** Platform operators: every organization's messages, and those no organization has yet. */
+export interface ListPlatformAlertIntakeMessagesQuery extends ListAlertIntakeMessagesQuery {
+    organizationId?: number;
+    /** Only messages no organization has been found for. */
+    unrouted?: boolean;
+}
+/** Platform operators: give a message no route claimed to an organization, and raise it. */
+export interface AssignAlertIntakeMessage {
+    organizationId: number;
+}
+/** Filters for an organization's screened messages (the review queue). `limit` is at most 100. */
+export interface ListAlertIntakeScreenedMessagesQuery {
+    /** Omit for every status. */
+    status?: AlertIntakeScreeningStatus;
+    reason?: AlertIntakeScreeningReason;
+    decidedBy?: AlertIntakeScreeningSource;
+    channel?: AlertIntakeChannel;
+    connectionId?: string;
+    page?: number;
+    limit?: number;
+}
+/**
+ * A reviewer's decision on 1-100 screened messages. ELEVATE raises each as an incident
+ * without screening it again; DISMISS confirms it is not a report.
+ */
+export interface ReviewAlertIntakeScreenedMessages {
+    ids: string[];
+    decision: AlertIntakeScreeningDecision;
+    /** At most 300 characters. */
+    note?: string;
+}

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

@@ -30,6 +30,13 @@ export interface Incident {
     categoryId?: number;
     typeId?: number;
     description?: string;
+    /**
+     * The report as the reporter wrote it, when `description` is its English
+     * translation (messages received by SMS, WhatsApp or email in another language).
+     */
+    originalDescription?: string | null;
+    /** ISO 639-1 code of `originalDescription`'s language, e.g. `sw`. */
+    originalLanguage?: string | null;
     status?: IncidentStatus;
     statusDetails?: IncidentStatusDetails;
     priority?: IncidentPriority;

package/package.json

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