@trii/types 2.10.680 → 2.10.682

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

@@ -25,11 +25,57 @@ export interface ConversationSlaTarget {
     durationSeconds: number;
     warningThresholds: ConversationSlaWarningThreshold[];
 }
+/**
+ * Threshold received by the SLA policy write API.
+ *
+ * Existing thresholds keep their id. New thresholds may omit it so the
+ * backend can assign the canonical identifier returned in
+ * ConversationSlaPolicy.
+ */
+export interface ConversationSlaWarningThresholdInput {
+    id?: ID;
+    percentage: number;
+}
+/**
+ * Target received by the SLA policy write API.
+ * durationSeconds is stored as seconds regardless of the unit used by the UI.
+ */
+export interface ConversationSlaTargetInput {
+    metric: ConversationSlaMetric;
+    durationSeconds: number;
+    warningThresholds: ConversationSlaWarningThresholdInput[];
+}
 export type ConversationSlaResumeBehavior = 'continue' | 'restart' | 'recalculate';
 export type ConversationSlaReopenBehavior = 'preserve' | 'restart' | 'recalculate' | 'do_not_start';
 export interface ConversationSlaClockBehavior {
+    /**
+     * Conversation statuses that pause every running SLA cycle.
+     *
+     * Entering one of these statuses pauses the clock. Leaving all of them
+     * resumes it according to onResume. An empty array means that conversation
+     * status changes never pause the SLA clock.
+     */
     pauseOnStatuses: ConversationStatus[];
+    /**
+     * Behavior applied when the conversation leaves the last status included
+     * in pauseOnStatuses.
+     *
+     * continue: keeps the current cycle and its consumed/remaining time.
+     * restart: resets the current cycle from the resume timestamp.
+     * recalculate: keeps the applied policy snapshot and recalculates the
+     * schedule-derived warnings/deadline. It does not select another policy
+     * version.
+     */
     onResume: ConversationSlaResumeBehavior;
+    /**
+     * Behavior applied when a resolved/finalized conversation is reopened.
+     * Reopening is independent from resuming a status-paused clock.
+     *
+     * preserve: preserves the previous cycle state.
+     * restart: starts a new cycle from the reopen timestamp.
+     * recalculate: recalculates the cycle using the applied policy snapshot.
+     * do_not_start: does not start an SLA cycle because of the reopen action.
+     */
     onReopen: ConversationSlaReopenBehavior;
 }
 /**
@@ -51,6 +97,46 @@ export interface ConversationSlaPolicy {
     updatedAt: Date;
     updatedByUserId?: ID;
 }
+/**
+ * Editable definition sent by clients.
+ *
+ * It intentionally excludes policy id/version and audit fields controlled by
+ * the backend. targets is full-replacement: omitted metrics are disabled in
+ * the newly published policy version.
+ */
+export interface ConversationSlaPolicyDefinitionInput {
+    name: string;
+    description?: string;
+    enabled: boolean;
+    timeCalculation: ConversationSlaTimeCalculation;
+    targets: ConversationSlaTargetInput[];
+    clockBehavior: ConversationSlaClockBehavior;
+}
+/**
+ * Creates the first immutable version of an SLA policy.
+ *
+ * commandId provides idempotency for retries. The authenticated backend
+ * context supplies createdByUserId and the audit timestamps.
+ */
+export interface CreateConversationSlaPolicyRequest {
+    commandId: ID;
+    spaceId: ID;
+    definition: ConversationSlaPolicyDefinitionInput;
+}
+/**
+ * Publishes a new immutable version of an existing SLA policy.
+ *
+ * expectedVersion implements optimistic concurrency. The backend rejects the
+ * request when another version was published after the client loaded it.
+ * version, updatedAt and updatedByUserId are always assigned by the backend.
+ */
+export interface PublishConversationSlaPolicyVersionRequest {
+    commandId: ID;
+    spaceId: ID;
+    policyId: ID;
+    expectedVersion: number;
+    definition: ConversationSlaPolicyDefinitionInput;
+}
 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';
 /**

package/package.json

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