@trii/types 2.10.675 → 2.10.677

package/dist/Conversations/Routing.d.ts

@@ -0,0 +1,163 @@
+interface QueueRoutingPolicyBase {
+    requiredSkills?: string[];
+    optionalSkills?: string[];
+    acceptedChannels: string[];
+    requireActiveParticipation: boolean;
+    requireAvailablePresence: boolean;
+    requireAcceptance: boolean;
+    capacityPolicy: {
+        maxConcurrentByChannel: Record<string, number>;
+        weightByChannel: Record<string, number>;
+    };
+    fallback: {
+        action: 'keep_queued' | 'overflow_queue' | 'assign_supervisor';
+        overflowQueueId?: string;
+        timeoutSeconds?: number;
+    };
+}
+/**
+ * Resolves the ownerUserId of the contact or business associated with the
+ * conversation. The resolved user is still subject to every Queue eligibility
+ * rule.
+ */
+export interface PartyOwnerAssigneeResolver {
+    type: 'party_owner';
+    mode: 'prefer' | 'required';
+}
+export type QueueOwnerAssigneeResolver = PartyOwnerAssigneeResolver;
+export type QueueRoutingPolicy = QueueRoutingPolicyBase & {
+    distributionMode: 'shared';
+    strategy?: never;
+    ownerResolver?: never;
+} | QueueRoutingPolicyBase & {
+    distributionMode: 'manual_pull';
+    strategy?: never;
+    ownerResolver?: never;
+} | QueueRoutingPolicyBase & {
+    distributionMode: 'exclusive';
+    strategy: QueueRoutingStrategy;
+    ownerResolver?: undefined | PartyOwnerAssigneeResolver & {
+        mode: 'prefer';
+    };
+} | QueueRoutingPolicyBase & {
+    distributionMode: 'exclusive';
+    strategy?: never;
+    ownerResolver: PartyOwnerAssigneeResolver & {
+        mode: 'required';
+    };
+};
+export type QueueRoutingConfig = QueueRoutingPolicy & {
+    queueId: string;
+    spaceId: string;
+    version: number;
+    updatedAt: Date;
+};
+export type QueueDistributionMode = 'shared' | 'exclusive' | 'manual_pull';
+export type QueueRoutingStrategy = 'round_robin' | 'least_busy' | 'random' | 'highest_capacity' | 'skills' | 'account_affinity' | 'longest_idle' | 'manual';
+export interface RoutingCandidate {
+    userId: string;
+    queueId: string;
+    authorized: boolean;
+    participating: boolean;
+    available: boolean;
+    channelEligible: boolean;
+    capacityUsed: number;
+    capacityTotal: number;
+    lastAssignedAt?: Date;
+    idleSince?: Date;
+    skills: string[];
+    accountAffinityScore?: number;
+}
+export type RoutingPartyType = 'contact' | 'business';
+/**
+ * Snapshot resolved by the command producer. The routing worker must not read
+ * Contacts again to obtain ownerUserId.
+ */
+export type RoutingPartyContext = {
+    status: 'not_found';
+    partyType: RoutingPartyType;
+    partyId?: string;
+    ownerUserId?: never;
+} | {
+    status: 'without_owner';
+    partyType: RoutingPartyType;
+    partyId: string;
+    ownerUserId?: never;
+} | {
+    status: 'resolved';
+    partyType: RoutingPartyType;
+    partyId: string;
+    ownerUserId: string;
+};
+/**
+ * Idempotent request for routing a queued conversation.
+ *
+ * contact/business ownership is captured in party by the producer so the
+ * routing worker can evaluate it against candidates without another read.
+ */
+export interface RouteConversationCommand {
+    commandId: string;
+    sourceEventId: string;
+    spaceId: string;
+    conversationId: string;
+    queueId: string;
+    expectedConversationVersion: number;
+    queueConfigVersion: number;
+    party: RoutingPartyContext;
+    requestedAt: Date;
+}
+export type RoutingSelectionSource = 'party_owner' | 'strategy' | 'fallback';
+export type PartyOwnerResolutionFailure = 'party_not_found' | 'party_without_owner' | 'owner_user_not_found' | 'not_authorized' | 'not_participating' | 'unavailable' | 'channel_ineligible' | 'capacity_exhausted';
+type FailedPartyOwnerEvaluation = {
+    party: Extract<RoutingPartyContext, {
+        status: 'not_found';
+    }>;
+    outcome: 'party_not_found';
+} | {
+    party: Extract<RoutingPartyContext, {
+        status: 'without_owner';
+    }>;
+    outcome: 'party_without_owner';
+} | {
+    party: Extract<RoutingPartyContext, {
+        status: 'resolved';
+    }>;
+    outcome: Exclude<PartyOwnerResolutionFailure, 'party_not_found' | 'party_without_owner'>;
+};
+export type PartyOwnerAssigneeEvaluation = {
+    type: 'party_owner';
+    mode: PartyOwnerAssigneeResolver['mode'];
+    party: Extract<RoutingPartyContext, {
+        status: 'resolved';
+    }>;
+    outcome: 'selected';
+    nextStep?: never;
+} | FailedPartyOwnerEvaluation & {
+    type: 'party_owner';
+    mode: 'prefer';
+    nextStep: 'strategy';
+} | FailedPartyOwnerEvaluation & {
+    type: 'party_owner';
+    mode: 'required';
+    nextStep: 'fallback';
+};
+export interface RoutingDecision {
+    decisionId: string;
+    spaceId: string;
+    conversationId: string;
+    queueId: string;
+    distributionMode: QueueDistributionMode;
+    strategy?: QueueRoutingStrategy;
+    eligibleUserIds: string[];
+    selectedUserId?: string;
+    selectionSource?: RoutingSelectionSource;
+    ownerEvaluation?: PartyOwnerAssigneeEvaluation;
+    rejected: Array<{
+        userId: string;
+        reasons: string[];
+    }>;
+    queueConfigVersion: number;
+    conversationVersion: number;
+    createdAt: Date;
+}
+export {};

package/dist/Conversations/Routing.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Conversations/Transfer.d.ts

@@ -0,0 +1,73 @@
+import { OutboxEvent } from './Outbox';
+import { AssignmentActorReference, AssignmentStateReference, ConversationAssignmentReason } from './Assignment';
+import { ID } from './Conversation';
+export type TransferConversationReason = Extract<ConversationAssignmentReason, 'manual_transfer' | 'flow_routing' | 'sla_escalation' | 'system_recovery'>;
+export type TransferConversationTarget = {
+    type: 'queue';
+    queueId: ID;
+} | {
+    type: 'user';
+    queueId: ID;
+    userId: ID;
+};
+export interface TransferConversationCommand {
+    commandId: ID;
+    spaceId: ID;
+    conversationId: ID;
+    target: TransferConversationTarget;
+    expectedConversationVersion: number;
+    actor: AssignmentActorReference;
+    reason: TransferConversationReason;
+    requestedAt: Date;
+}
+export type TransferConversationRejectionCode = 'conversation_not_found' | 'target_queue_not_found' | 'target_queue_disabled' | 'target_user_not_found' | 'target_user_not_authorized' | 'target_user_not_available' | 'target_user_has_no_capacity' | 'channel_not_supported' | 'same_queue' | 'same_owner' | 'actor_not_authorized' | 'conversation_not_transferable';
+export type TransferConversationResult = {
+    status: 'transferred';
+    commandId: ID;
+    conversationId: ID;
+    previousVersion: number;
+    conversationVersion: number;
+    previous: AssignmentStateReference;
+    current: AssignmentStateReference;
+    assignmentEventId: ID;
+    outboxEventId: ID;
+} | {
+    status: 'already_applied';
+    commandId: ID;
+    conversationId: ID;
+    conversationVersion: number;
+    assignmentEventId: ID;
+    outboxEventId: ID;
+} | {
+    status: 'version_conflict';
+    commandId: ID;
+    conversationId: ID;
+    expectedVersion: number;
+    currentVersion: number;
+} | {
+    status: 'rejected';
+    commandId: ID;
+    conversationId: ID;
+    code: TransferConversationRejectionCode;
+};
+export interface ConversationAssignmentChanged {
+    eventId: ID;
+    sourceEventId: ID;
+    type: 'conversation.assignment.changed';
+    schemaVersion: 1;
+    spaceId: ID;
+    conversationId: ID;
+    conversationVersion: number;
+    reason: ConversationAssignmentReason;
+    previous?: AssignmentStateReference;
+    current: AssignmentStateReference;
+    actor: AssignmentActorReference;
+    correlationId: ID;
+    causationId: ID;
+    occurredAt: Date;
+}
+export type ConversationAssignmentChangedOutboxEvent = OutboxEvent<ConversationAssignmentChanged> & {
+    aggregateType: 'conversation';
+    eventType: 'conversation.assignment.changed';
+    schemaVersion: 1;
+};

package/dist/Conversations/Transfer.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Conversations/WebHook.d.ts

@@ -5,7 +5,7 @@ import { AuthType } from '../Common/API/AuthType';
 import { Method } from '../Common/API/Method';
 interface IWebhook {
     id?: string | null;
-    tenantId?: string | null;
+    spaceId?: string | null;
     name?: string | null;
     apiUrl?: string | null;
     apiMethod?: Method | null;

package/dist/Conversations/index.d.ts

@@ -1,7 +1,10 @@
 export * as Flows from './Flows/index';
 export * as Groups from './Groups/Group';
+export * from './Assignment';
 export * from './Conversation';
-export * from './InboxCounters';
+export * from './InboxMongo';
+export * from './InboxProjection';
+export * from './Outbox';
 export * from './Ending';
 export * from './Label';
 export * from './WebHook';
@@ -12,3 +15,6 @@ export * from '../Forms/API';
 export * from './DashBoard/dashboardChannels';
 export * from './DashBoard/dashboardMessages';
 export * from './Survey';
+export * from './Queue';
+export * from './Routing';
+export * from './Transfer';

package/dist/Conversations/index.js

@@ -39,8 +39,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Groups = exports.Flows = void 0;
 exports.Flows = __importStar(require("./Flows/index"));
 exports.Groups = __importStar(require("./Groups/Group"));
+__exportStar(require("./Assignment"), exports);
 __exportStar(require("./Conversation"), exports);
-__exportStar(require("./InboxCounters"), exports);
+__exportStar(require("./InboxMongo"), exports);
+__exportStar(require("./InboxProjection"), exports);
+__exportStar(require("./Outbox"), exports);
 __exportStar(require("./Ending"), exports);
 __exportStar(require("./Label"), exports);
 __exportStar(require("./WebHook"), exports);
@@ -51,3 +54,6 @@ __exportStar(require("../Forms/API"), exports);
 __exportStar(require("./DashBoard/dashboardChannels"), exports);
 __exportStar(require("./DashBoard/dashboardMessages"), exports);
 __exportStar(require("./Survey"), exports);
+__exportStar(require("./Queue"), exports);
+__exportStar(require("./Routing"), exports);
+__exportStar(require("./Transfer"), exports);

package/dist/Presence/QueueParticipation.d.ts

@@ -1,4 +1,4 @@
-import { GroupInfo } from "../Conversations/Groups/Group";
+import { ConversationQueueInfo } from "../Conversations/Queue";
 export interface QueueParticipation {
     spaceId: string;
     userId: string;
@@ -13,5 +13,5 @@ export interface QueueParticipationDto {
     authorized: boolean;
     active: boolean;
     updatedAt: Date;
-    queue?: GroupInfo | null;
+    queue?: ConversationQueueInfo | null;
 }

package/dist/Presence/QueueRoutingState.d.ts

@@ -1,4 +1,4 @@
-import { GroupInfo } from "../Conversations/Groups/Group";
+import { ConversationQueueInfo } from "../Conversations/Queue";
 export interface QueueRoutingState {
     spaceId: string;
     userId: string;
@@ -17,7 +17,7 @@ export declare enum RoutingPresenceStatus {
 }
 export interface RoutingStateDto {
     queueId: string;
-    queue?: GroupInfo | null;
+    queue?: ConversationQueueInfo | null;
     isEligible: boolean;
     presenceStatus?: RoutingPresenceStatus;
     activeJobCount: number;

package/dist/Tickets/Dashboard.d.ts

@@ -323,6 +323,32 @@ export interface ITicketDashboard {
     updatedAt?: Date;
     updatedBy?: string;
 }
+export interface ICreateTicketDashboardDto {
+    name: string;
+    description?: string;
+    audience: TicketAnalyticsAudience;
+    visibility: TicketDashboardVisibility;
+    sharedRoleIds?: string[];
+    sharedGroupIds?: string[];
+    defaultFilter?: ITicketAnalyticsFilter;
+    widgets?: ITicketWidgetConfiguration[];
+    refreshMode?: TicketWidgetRefreshMode;
+    refreshIntervalSeconds?: number;
+    isDefault?: boolean;
+}
+export interface IUpdateTicketDashboardDto {
+    name?: string;
+    description?: string;
+    audience?: TicketAnalyticsAudience;
+    visibility?: TicketDashboardVisibility;
+    sharedRoleIds?: string[];
+    sharedGroupIds?: string[];
+    defaultFilter?: ITicketAnalyticsFilter;
+    widgets?: ITicketWidgetConfiguration[];
+    refreshMode?: TicketWidgetRefreshMode;
+    refreshIntervalSeconds?: number;
+    isDefault?: boolean;
+}
 export interface ITicketDashboardTemplate {
     id: string;
     spaceId: string;
@@ -332,6 +358,20 @@ export interface ITicketDashboardTemplate {
     widgets: ITicketWidgetConfiguration[];
     enabled: boolean;
 }
+export interface ICreateTicketDashboardTemplateDto {
+    name: string;
+    description?: string;
+    audience: TicketAnalyticsAudience;
+    widgets?: ITicketWidgetConfiguration[];
+    enabled?: boolean;
+}
+export interface IUpdateTicketDashboardTemplateDto {
+    name?: string;
+    description?: string;
+    audience?: TicketAnalyticsAudience;
+    widgets?: ITicketWidgetConfiguration[];
+    enabled?: boolean;
+}
 export interface ITicketDashboardSnapshot {
     id: string;
     dashboardId: string;
@@ -371,6 +411,26 @@ export interface ITicketAnalyticsGoal {
     ownerUserId?: string;
     createdAt: Date;
 }
+export interface ICreateTicketAnalyticsGoalDto {
+    name: string;
+    metric: TicketMetricCode;
+    target: number;
+    filter: ITicketAnalyticsFilter;
+    validFrom: Date;
+    validUntil?: Date;
+    ownerGroupId?: string;
+    ownerUserId?: string;
+}
+export interface IUpdateTicketAnalyticsGoalDto {
+    name?: string;
+    metric?: TicketMetricCode;
+    target?: number;
+    filter?: ITicketAnalyticsFilter;
+    validFrom?: Date;
+    validUntil?: Date;
+    ownerGroupId?: string;
+    ownerUserId?: string;
+}
 /** Reports freshness so users know whether a card is real-time, delayed or partial. */
 export interface ITicketAnalyticsFreshness {
     metric: TicketMetricCode;

package/package.json

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