@trii/types 2.10.679 → 2.10.681

package/dist/Conversations/Conversation.d.ts

@@ -4,10 +4,13 @@ import { GroupInfo } from "./Groups/Group";
 import { Channels } from "../Common/index";
 import { IContactAddress, IContactInfo } from "../Contacts/contacts";
 import { IEnding } from "./Ending";
+import { ChatType } from "../Chats/Chat";
 export interface IConversation {
     id: string;
     spaceId: string;
     version: number;
+    /** @deprecated Use assignment.owner. */
+    type: ChatType;
     /**only for Front-End */
     chatName: string;
     chatImage: string;
@@ -21,6 +24,8 @@ export interface IConversation {
     status: ConversationStatus;
     priority: 'low' | 'normal' | 'high' | 'urgent';
     assignment: ConversationAssignmentSnapshot;
+    /** @deprecated Use owner and assignment.*/
+    assignedTo?: ConversationAssigned;
     sla: {
         status: 'none' | 'running' | 'warning' | 'breached' | 'met';
         deadlineAt?: Date;
@@ -36,7 +41,13 @@ export interface IConversation {
     lastAgentActivityAt?: Date;
     labels: ILabel[];
     pinned: boolean;
+    /** @deprecated A transfer is represented by an event and the resulting current state. */
+    transferBy?: string;
+    /** @deprecated A transfer is represented by an event and the resulting current state. */
+    transferTo?: ConversationAssigned;
     expired: boolean;
+    /** @deprecated Expiration does not own a separate assignment snapshot.*/
+    expiredAssignedTo: ConversationAssigned;
     participants: UserInfo[];
     archived: boolean;
     spam: boolean;

package/dist/Conversations/Sla.d.ts

@@ -0,0 +1,141 @@
+import type { ISchedule } from '../Common/Schedules/Schedules';
+import type { ConversationEventType, ConversationStatus, ID } from './Conversation';
+import type { OutboxEvent } from './Outbox';
+export declare const CONVERSATION_SLA_POLICIES_COLLECTION = "conversation_sla_policies";
+export declare const CONVERSATION_SLA_CYCLES_COLLECTION = "conversation_sla_cycles";
+export declare const CONVERSATION_SLA_EVENTS_COLLECTION = "conversation_sla_events";
+export type ConversationSlaMetric = 'first_response' | 'next_response' | 'assignment' | 'acceptance' | 'resolution';
+/**
+ * continuous counts natural elapsed time, including nights and holidays.
+ * schedule counts only ranges allowed by the referenced customer ISchedule.
+ */
+export type ConversationSlaTimeCalculation = {
+    mode: 'continuous';
+    scheduleId?: never;
+} | {
+    mode: 'schedule';
+    scheduleId: Exclude<ISchedule['id'], null>;
+};
+export interface ConversationSlaWarningThreshold {
+    id: ID;
+    percentage: number;
+}
+export interface ConversationSlaTarget {
+    metric: ConversationSlaMetric;
+    durationSeconds: number;
+    warningThresholds: ConversationSlaWarningThreshold[];
+}
+export type ConversationSlaResumeBehavior = 'continue' | 'restart' | 'recalculate';
+export type ConversationSlaReopenBehavior = 'preserve' | 'restart' | 'recalculate' | 'do_not_start';
+export interface ConversationSlaClockBehavior {
+    pauseOnStatuses: ConversationStatus[];
+    onResume: ConversationSlaResumeBehavior;
+    onReopen: ConversationSlaReopenBehavior;
+}
+/**
+ * Immutable, versioned policy referenced by ConversationQueue.sla.
+ * Editing a published policy creates a new version.
+ */
+export interface ConversationSlaPolicy {
+    id: ID;
+    spaceId: ID;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    version: number;
+    timeCalculation: ConversationSlaTimeCalculation;
+    targets: ConversationSlaTarget[];
+    clockBehavior: ConversationSlaClockBehavior;
+    createdAt: Date;
+    createdByUserId?: ID;
+    updatedAt: Date;
+    updatedByUserId?: ID;
+}
+export type ConversationSlaClockAction = 'start' | 'evaluate' | 'pause' | 'resume' | 'complete' | 'recalculate' | 'cancel';
+export type ConversationSlaClockReason = 'conversation_created' | 'conversation_enqueued' | 'customer_message' | 'agent_response' | 'assignment_changed' | 'status_changed' | 'queue_transfer' | 'conversation_reopened' | 'deadline_due' | 'policy_override';
+/**
+ * Idempotent input for the conversation-sla-worker.
+ * policyId/policyVersion identify the immutable policy snapshot to apply.
+ */
+export interface SlaClockCommand {
+    commandId: ID;
+    sourceEventId: ID;
+    spaceId: ID;
+    conversationId: ID;
+    expectedConversationVersion: number;
+    action: ConversationSlaClockAction;
+    reason: ConversationSlaClockReason;
+    metric?: ConversationSlaMetric;
+    policyId: ID;
+    policyVersion: number;
+    queueId?: ID;
+    occurredAt: Date;
+    requestedAt: Date;
+}
+export type ConversationSlaCycleStatus = 'running' | 'paused' | 'met' | 'breached' | 'cancelled';
+export interface ConversationSlaPausePeriod {
+    startedAt: Date;
+    endedAt?: Date;
+    reason: ConversationSlaClockReason;
+    sourceEventId: ID;
+}
+/**
+ * Durable metric cycle. The target and time calculation are copied from the
+ * selected policy version so later policy edits cannot alter active history.
+ */
+export interface ConversationSlaCycle {
+    id: ID;
+    spaceId: ID;
+    conversationId: ID;
+    metric: ConversationSlaMetric;
+    sequence: number;
+    status: ConversationSlaCycleStatus;
+    policyId: ID;
+    policyVersion: number;
+    timeCalculation: ConversationSlaTimeCalculation;
+    target: ConversationSlaTarget;
+    startedAt: Date;
+    deadlineAt?: Date;
+    nextWarningAt?: Date;
+    pausedAt?: Date;
+    completedAt?: Date;
+    breachedAt?: Date;
+    cancelledAt?: Date;
+    elapsedSeconds: number;
+    pausedSeconds: number;
+    pausePeriods: ConversationSlaPausePeriod[];
+    startedByEventId: ID;
+    completedByEventId?: ID;
+    version: number;
+    updatedAt: Date;
+}
+export type ConversationSlaEventType = Extract<ConversationEventType, 'sla_started' | 'sla_paused' | 'sla_resumed' | 'sla_warning' | 'sla_breached' | 'sla_met' | 'sla_overridden'>;
+/**
+ * Immutable SLA event. Corrections are represented by a later event.
+ */
+export interface ConversationSlaEvent {
+    eventId: ID;
+    sourceEventId: ID;
+    type: ConversationSlaEventType;
+    schemaVersion: 1;
+    spaceId: ID;
+    conversationId: ID;
+    conversationVersion: number;
+    cycleId: ID;
+    metric: ConversationSlaMetric;
+    policyId: ID;
+    policyVersion: number;
+    status: ConversationSlaCycleStatus;
+    deadlineAt?: Date;
+    warningThresholdId?: ID;
+    reason: ConversationSlaClockReason;
+    correlationId: ID;
+    causationId: ID;
+    occurredAt: Date;
+    recordedAt: Date;
+}
+export type ConversationSlaOutboxEvent = OutboxEvent<ConversationSlaEvent> & {
+    aggregateType: 'conversation';
+    eventType: `conversation.${ConversationSlaEventType}`;
+    schemaVersion: 1;
+};

package/dist/Conversations/Sla.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONVERSATION_SLA_EVENTS_COLLECTION = exports.CONVERSATION_SLA_CYCLES_COLLECTION = exports.CONVERSATION_SLA_POLICIES_COLLECTION = void 0;
+exports.CONVERSATION_SLA_POLICIES_COLLECTION = 'conversation_sla_policies';
+exports.CONVERSATION_SLA_CYCLES_COLLECTION = 'conversation_sla_cycles';
+exports.CONVERSATION_SLA_EVENTS_COLLECTION = 'conversation_sla_events';

package/dist/Conversations/index.d.ts

@@ -17,4 +17,5 @@ export * from './DashBoard/dashboardMessages';
 export * from './Survey';
 export * from './Queue';
 export * from './Routing';
+export * from './Sla';
 export * from './Transfer';

package/dist/Conversations/index.js

@@ -56,4 +56,5 @@ __exportStar(require("./DashBoard/dashboardMessages"), exports);
 __exportStar(require("./Survey"), exports);
 __exportStar(require("./Queue"), exports);
 __exportStar(require("./Routing"), exports);
+__exportStar(require("./Sla"), exports);
 __exportStar(require("./Transfer"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trii/types",
-  "version": "2.10.679",
+  "version": "2.10.681",
   "description": "Types definitions for Trii projects - ",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",