@opencxh/domain 1.279.0 → 1.281.0

package/dist/entities/activity/index.d.ts

@@ -3,6 +3,7 @@ export * from './catalog';
 export * from './descriptor';
 export * from './preview';
 export * from './resolve';
+export * from './resource-activity';
 export * from './seen';
 export * from './timestamp';
 export * from './types';

package/dist/entities/activity/resource-activity.d.ts

@@ -0,0 +1,33 @@
+import { ReactionSummary } from '../reaction/types';
+/**
+ * A feed row that hangs on something other than an interaction — a work item, a contact.
+ *
+ * Comms' `Activity` requires `interactionId` everywhere, so every other feed mirrors it minus the
+ * interaction fields. This is that mirror once, as a type only: each app keeps its own entity.
+ * The shape is what `wakesAssignment` and `buildTriggerVars` read structurally.
+ */
+export interface ResourceActivity<TType extends string, TPayload> {
+    id: string;
+    organizationId: string;
+    type: TType;
+    author: {
+        type: "user" | "system" | "app";
+        id?: string;
+        name: string;
+    };
+    /**
+     * Always `"internal"`. Never `"inbound"`: rule 1 of `wakesAssignment` treats inbound as
+     * "the customer answered" and would wake every waiting assignment on the row's subject.
+     */
+    direction: "internal";
+    /** The activity this one answers — same one-level thread as comms' `BaseActivity.parentId`. */
+    parentId?: string;
+    payload: TPayload;
+    /**
+     * The emoji on this row, as the list route projects them. Read-only and never stored on the
+     * row — see `BaseActivity.reactions` and the generic store in the communication app.
+     */
+    reactions?: ReactionSummary[];
+    createdAt?: number;
+    updatedAt?: number;
+}

package/dist/entities/activity/types.d.ts

@@ -5,7 +5,7 @@ import { ReactionSummary } from '../reaction/types';
 export type CallStatus = "new" | "connecting" | "ringing" | "connected" | "held" | "ended" | "failed";
 export type CallDirection = "inbound" | "outbound";
 export type CallType = "audio" | "video" | "data" | "screen-share";
-export type ActivityType = "VOICE_CALL_STARTED" | "VOICE_CALL_ANSWERED" | "VOICE_CALL_HOLD" | "VOICE_CALL_UNHOLD" | "VOICE_CALL_ENDED" | "VOICE_CALL_MISSED" | "VOICE_CALL_VOICEMAIL" | "VIDEO_CALL_STARTED" | "VIDEO_CALL_ANSWERED" | "VIDEO_CALL_HOLD" | "VIDEO_CALL_UNHOLD" | "VIDEO_CALL_ENDED" | "VIDEO_CALL_MISSED" | "EMAIL_RECEIVED" | "EMAIL_SENT" | "CHAT_MESSAGE_SENT" | "CHAT_MESSAGE_RECEIVED" | "CHAT_MEMBER_JOINED" | "CHAT_MEMBER_LEFT" | "CHAT_RENAMED" | "CHAT_CALL_STARTED" | "CHAT_CALL_ENDED" | "CHAT_EVENT" | "AI_MESSAGE_ADDED" | "AI_ACTION_PROPOSED" | "PLAYBOOK_STARTED" | "PLAYBOOK_COMPLETED" | "PLAYBOOK_ESCALATED" | "AGENT_DELEGATED" | "AGENT_ANSWERED" | "MEETING_SCHEDULED" | "MEETING_STARTED" | "MEETING_ENDED" | "MEETING_PARTICIPANT_JOINED" | "MEETING_PARTICIPANT_LEFT" | "COMMENT_ADDED" | "FILE_UPLOADED" | "INTERACTION_CREATED" | "INTERACTION_STATUS_CHANGED" | "INTERACTION_ASSIGNED" | "SLA_BREACHED" | "VOICE_CALL_FAILED" | "VIDEO_CALL_FAILED" | "TRANSCRIPT_ADDED" | "WORK_COMMENT_ADDED" | "WORK_ITEM_ASSIGNED" | "WORK_ITEM_STATUS_CHANGED";
+export type ActivityType = "VOICE_CALL_STARTED" | "VOICE_CALL_ANSWERED" | "VOICE_CALL_HOLD" | "VOICE_CALL_UNHOLD" | "VOICE_CALL_ENDED" | "VOICE_CALL_MISSED" | "VOICE_CALL_VOICEMAIL" | "VIDEO_CALL_STARTED" | "VIDEO_CALL_ANSWERED" | "VIDEO_CALL_HOLD" | "VIDEO_CALL_UNHOLD" | "VIDEO_CALL_ENDED" | "VIDEO_CALL_MISSED" | "EMAIL_RECEIVED" | "EMAIL_SENT" | "CHAT_MESSAGE_SENT" | "CHAT_MESSAGE_RECEIVED" | "CHAT_MEMBER_JOINED" | "CHAT_MEMBER_LEFT" | "CHAT_RENAMED" | "CHAT_CALL_STARTED" | "CHAT_CALL_ENDED" | "CHAT_EVENT" | "AI_MESSAGE_ADDED" | "AI_ACTION_PROPOSED" | "PLAYBOOK_STARTED" | "PLAYBOOK_COMPLETED" | "PLAYBOOK_ESCALATED" | "AGENT_DELEGATED" | "AGENT_ANSWERED" | "MEETING_SCHEDULED" | "MEETING_STARTED" | "MEETING_ENDED" | "MEETING_PARTICIPANT_JOINED" | "MEETING_PARTICIPANT_LEFT" | "COMMENT_ADDED" | "FILE_UPLOADED" | "INTERACTION_CREATED" | "INTERACTION_STATUS_CHANGED" | "INTERACTION_ASSIGNED" | "SLA_BREACHED" | "VOICE_CALL_FAILED" | "VIDEO_CALL_FAILED" | "TRANSCRIPT_ADDED" | "WORK_COMMENT_ADDED" | "WORK_ITEM_ASSIGNED" | "WORK_ITEM_STATUS_CHANGED" | "CRM_NOTE_ADDED" | "CRM_CALL_LOGGED" | "CRM_STAGE_CHANGED";
 export interface Attachment {
     id: string;
     filename: string;

package/dist/entities/analytics/dashboard.d.ts

@@ -20,6 +20,12 @@ export interface DashboardSection {
     metricIds: string[];
     /** Row dimension for bar/table (line/heatmap imply the time axis). */
     groupBy?: DimensionId;
+    /**
+     * column only: stack the series into one bar per period. Only the source can
+     * say its series add up to a whole (answered + missed = offered); two
+     * unrelated counts stacked would draw a total that means nothing.
+     */
+    stacked?: boolean;
 }
 /**
  * A preset dashboard shipped by an owning app (or by analytics for cross-source ones). Discovered like

package/dist/entities/analytics/metric.d.ts

@@ -8,6 +8,11 @@ import { DimensionId } from './dimensions';
  */
 export type MetricValueType = "count" | "duration_ms" | "percent" | "currency";
 export type MetricAggregation = "sum" | "avg" | "rate" | "distinct" | "p50" | "p90" | "min" | "max";
+/**
+ * Which direction of change is good news. `neutral` is for volume: more
+ * conversations is more work, not better work, so its delta stays grey.
+ */
+export type MetricPolarity = "higher" | "lower" | "neutral";
 export interface MetricDefinition {
     /**
      * Globally-unique, app-namespaced id: "<source>.<family>.<name>", e.g. "comms.reply_time.first",
@@ -35,4 +40,6 @@ export interface MetricDefinition {
     description?: string;
     /** Hidden from the picker (e.g. a numerator/denominator base metric of a rate). */
     hidden?: boolean;
+    /** Good direction for a delta. Omitted = the analytics app guesses from id and aggregation. */
+    polarity?: MetricPolarity;
 }

package/dist/entities/crm-activity/index.d.ts

@@ -0,0 +1,43 @@
+import { ResourceActivity } from '../activity/resource-activity';
+import { LifecycleStage } from '../contact/lifecycle';
+/**
+ * The feed under a contact or a company: notes, logged calls, stage changes.
+ *
+ * The work-activity pattern (`entities/work/activity.ts`), keyed on the record's scope key
+ * (`contact:<id>`, `company:<id>`) instead of an item id. The type names are crm's own — reusing
+ * comms' `COMMENT_ADDED` would fire every comms playbook trigger on a crm note.
+ */
+export declare const CRM_NOTE_ADDED = "CRM_NOTE_ADDED";
+/** The scope kind of one feed row, `crm_activity:<id>` — what the reaction store asks about. */
+export declare const CRM_ACTIVITY_SCOPE_KIND = "crm_activity";
+/** A call or meeting that happened outside the system, written down afterwards. */
+export declare const CRM_CALL_LOGGED = "CRM_CALL_LOGGED";
+/** History, not content: written by the update routes, never editable. */
+export declare const CRM_STAGE_CHANGED = "CRM_STAGE_CHANGED";
+export type CrmActivityType = typeof CRM_NOTE_ADDED | typeof CRM_CALL_LOGGED | typeof CRM_STAGE_CHANGED;
+export declare const CRM_CALL_CHANNELS: readonly ["phone", "meeting", "video"];
+export type CrmCallChannel = (typeof CRM_CALL_CHANNELS)[number];
+export declare const CRM_CALL_OUTCOMES: readonly ["callback", "interested", "no_answer", "not_interested"];
+export type CrmCallOutcome = (typeof CRM_CALL_OUTCOMES)[number];
+export interface CrmCall {
+    channel: CrmCallChannel;
+    /** When the call happened, not when it was logged. The timeline sorts on this. */
+    at: number;
+    durationMin?: number;
+    outcome?: CrmCallOutcome;
+}
+export interface CrmActivity extends ResourceActivity<CrmActivityType, {
+    text?: string;
+    html?: string;
+    mentions?: string[];
+    call?: CrmCall;
+    fromStage?: LifecycleStage;
+    toStage?: LifecycleStage;
+}> {
+    /** `contact:<id>` or `company:<id>`. */
+    record: string;
+}
+/** Rows a person wrote, and may therefore edit or delete. A stage row is history. */
+export declare const isAuthoredCrmActivity: (type: string) => boolean;
+/** Where the timeline puts the row: a call at the moment it happened, the rest when written. */
+export declare const crmActivityAt: (activity: CrmActivity) => number;

package/dist/entities/work/activity.d.ts

@@ -1,4 +1,4 @@
-import { ReactionSummary } from '../reaction/types';
+import { ResourceActivity } from '../activity/resource-activity';
 import { WorkStatusCategory } from './types';
 /**
  * The activity feed under a work item.
@@ -22,39 +22,15 @@ export declare const WORK_ITEM_ASSIGNED = "WORK_ITEM_ASSIGNED";
  */
 export declare const WORK_ITEM_STATUS_CHANGED = "WORK_ITEM_STATUS_CHANGED";
 export type WorkActivityType = typeof WORK_COMMENT_ADDED | typeof WORK_ITEM_ASSIGNED | typeof WORK_ITEM_STATUS_CHANGED;
-export interface WorkActivity {
-    id: string;
-    organizationId: string;
-    itemId: string;
-    type: WorkActivityType;
-    author: {
-        type: "user" | "system" | "app";
-        id?: string;
-        name: string;
-    };
-    /**
-     * Always `"internal"`. Never `"inbound"`: rule 1 of `wakesAssignment` treats inbound as
-     * "the customer answered" and would wake every waiting assignment on the item.
-     */
-    direction: "internal";
-    /** The activity this one answers — same one-level thread as comms' `BaseActivity.parentId`. */
-    parentId?: string;
+export interface WorkActivity extends ResourceActivity<WorkActivityType, {
     /** `html` is the composer's markup for a comment; `text` stays the plain reading of it. */
-    payload: {
-        text?: string;
-        html?: string;
-        mentions?: string[];
-        assigneeId?: string;
-        fromStatus?: string;
-        toStatus?: string;
-        toCategory?: WorkStatusCategory;
-    };
-    /**
-     * The emoji on this comment, as the list route projects them. Read-only and never stored
-     * on the row — see `BaseActivity.reactions`, which this mirrors, and the generic store in
-     * the communication app that both read from.
-     */
-    reactions?: ReactionSummary[];
-    createdAt?: number;
-    updatedAt?: number;
+    text?: string;
+    html?: string;
+    mentions?: string[];
+    assigneeId?: string;
+    fromStatus?: string;
+    toStatus?: string;
+    toCategory?: WorkStatusCategory;
+}> {
+    itemId: string;
 }