@trii/types 2.10.676 → 2.10.678

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

@@ -193,6 +193,17 @@ export declare enum TicketMetricCode {
     SECURITY_DENIAL_COUNT = "SECURITY_DENIAL_COUNT",
     PII_ACCESS_COUNT = "PII_ACCESS_COUNT"
 }
+export declare enum DashboardIcon {
+    DASHBOARD = "DASHBOARD",
+    HOME = "HOME",
+    SUPPORT = "SUPPORT",
+    ANALYTICS = "ANALYTICS",
+    REPORTS = "REPORTS",
+    USERS = "USERS",
+    SETTINGS = "SETTINGS",
+    FAVORITES = "FAVORITES",
+    QUICK_ACTIONS = "QUICK_ACTIONS"
+}
 export interface ITicketAnalyticsFilter extends ITicketFilter {
     range: ITicketDateRange;
     channelTypes?: ChannelType[];
@@ -318,6 +329,8 @@ export interface ITicketDashboard {
     refreshMode: TicketWidgetRefreshMode;
     refreshIntervalSeconds?: number;
     isDefault?: boolean;
+    order: number;
+    icon?: DashboardIcon;
     createdAt: Date;
     createdBy: string;
     updatedAt?: Date;
@@ -334,7 +347,9 @@ export interface ICreateTicketDashboardDto {
     widgets?: ITicketWidgetConfiguration[];
     refreshMode?: TicketWidgetRefreshMode;
     refreshIntervalSeconds?: number;
+    order?: number;
     isDefault?: boolean;
+    icon?: DashboardIcon;
 }
 export interface IUpdateTicketDashboardDto {
     name?: string;
@@ -347,7 +362,9 @@ export interface IUpdateTicketDashboardDto {
     widgets?: ITicketWidgetConfiguration[];
     refreshMode?: TicketWidgetRefreshMode;
     refreshIntervalSeconds?: number;
+    order?: number;
     isDefault?: boolean;
+    icon?: DashboardIcon;
 }
 export interface ITicketDashboardTemplate {
     id: string;

package/dist/Tickets/Dashboard.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TicketMetricCode = exports.TicketDrilldownTarget = exports.TicketWidgetRefreshMode = exports.TicketMetricFormat = exports.TicketComparisonMode = exports.TicketTimeGranularity = exports.TicketAnalyticsDimension = exports.TicketMetricAggregation = exports.TicketWidgetType = exports.TicketDashboardVisibility = exports.TicketAnalyticsAudience = void 0;
+exports.DashboardIcon = exports.TicketMetricCode = exports.TicketDrilldownTarget = exports.TicketWidgetRefreshMode = exports.TicketMetricFormat = exports.TicketComparisonMode = exports.TicketTimeGranularity = exports.TicketAnalyticsDimension = exports.TicketMetricAggregation = exports.TicketWidgetType = exports.TicketDashboardVisibility = exports.TicketAnalyticsAudience = void 0;
 var TicketAnalyticsAudience;
 (function (TicketAnalyticsAudience) {
     TicketAnalyticsAudience["AGENT"] = "AGENT";
@@ -204,3 +204,15 @@ var TicketMetricCode;
     TicketMetricCode["SECURITY_DENIAL_COUNT"] = "SECURITY_DENIAL_COUNT";
     TicketMetricCode["PII_ACCESS_COUNT"] = "PII_ACCESS_COUNT";
 })(TicketMetricCode || (exports.TicketMetricCode = TicketMetricCode = {}));
+var DashboardIcon;
+(function (DashboardIcon) {
+    DashboardIcon["DASHBOARD"] = "DASHBOARD";
+    DashboardIcon["HOME"] = "HOME";
+    DashboardIcon["SUPPORT"] = "SUPPORT";
+    DashboardIcon["ANALYTICS"] = "ANALYTICS";
+    DashboardIcon["REPORTS"] = "REPORTS";
+    DashboardIcon["USERS"] = "USERS";
+    DashboardIcon["SETTINGS"] = "SETTINGS";
+    DashboardIcon["FAVORITES"] = "FAVORITES";
+    DashboardIcon["QUICK_ACTIONS"] = "QUICK_ACTIONS";
+})(DashboardIcon || (exports.DashboardIcon = DashboardIcon = {}));

package/package.json

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