@trii/types 2.10.678 → 2.10.680

package/dist/src/Conversations/Routing.d.ts

@@ -0,0 +1,164 @@
+import { ChannelType } from '../Common/Channels/ChannelType';
+interface QueueRoutingPolicyBase {
+    requiredSkills?: string[];
+    optionalSkills?: string[];
+    acceptedChannelTypes: ChannelType[];
+    requireActiveParticipation: boolean;
+    requireAvailablePresence: boolean;
+    requireAcceptance: boolean;
+    capacityPolicy: {
+        maxConcurrentByChannelType: Partial<Record<ChannelType, number>>;
+        weightByChannelType: Partial<Record<ChannelType, 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/src/Conversations/Routing.js

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

package/dist/src/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/src/Conversations/Transfer.js

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

package/dist/src/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/src/Conversations/index.d.ts

@@ -1,13 +1,20 @@
 export * as Flows from './Flows/index';
 export * as Groups from './Groups/Group';
+export * from './Assignment';
 export * from './Conversation';
+export * from './InboxMongo';
+export * from './InboxProjection';
+export * from './Outbox';
 export * from './Ending';
 export * from './Label';
 export * from './WebHook';
 export * from './SocialWalls';
 export * from './QuickResponse';
 export * from './DashBoard/dashboard';
-export * from './DashBoard/dashboardForms';
+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/src/Conversations/index.js

@@ -39,14 +39,21 @@ 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("./InboxMongo"), exports);
+__exportStar(require("./InboxProjection"), exports);
+__exportStar(require("./Outbox"), exports);
 __exportStar(require("./Ending"), exports);
 __exportStar(require("./Label"), exports);
 __exportStar(require("./WebHook"), exports);
 __exportStar(require("./SocialWalls"), exports);
 __exportStar(require("./QuickResponse"), exports);
 __exportStar(require("./DashBoard/dashboard"), exports);
-__exportStar(require("./DashBoard/dashboardForms"), exports);
+__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/src/Forms/API.d.ts

@@ -0,0 +1,53 @@
+import { FormItemType } from "../Common/Channels/Form";
+import { FormAnswerV2, FormTag } from "./SubmittedForm";
+export interface RequestInfo {
+    formId: string;
+    timeStart: Date | null;
+    timeEnd: Date | null;
+    skip: number | null;
+    limit: number | null;
+}
+export interface SummaryInfo {
+    formId: string;
+    timeStart: Date | null;
+    timeEnd: Date | null;
+    completedForms: number;
+    records: QuestionSummary[];
+}
+export interface QuestionSummary {
+    questionId: string;
+    question: string;
+    type: FormItemType;
+    fieldType: string;
+    count: number;
+    responses: ResponseSummary[];
+}
+export interface ResponseSummary {
+    count: number;
+    responseTitle: string;
+}
+export interface SubmittedFormsInfo {
+    formId: string;
+    timeStart: Date | null;
+    timeEnd: Date | null;
+    completedForms: number;
+    records: SubmittedFormRecord[];
+}
+export interface SubmittedFormRecord {
+    id: string;
+    tags: FormTag[];
+    responses: SubmittedFormResponse[];
+    expireAt: Date | null;
+    createdAt: Date;
+    completedAt: Date | null;
+    contractVersion: number;
+    formRevision: number;
+}
+export interface SubmittedFormResponse {
+    type: FormItemType;
+    fieldType: string;
+    questionId: string;
+    question: string;
+    response: unknown | null;
+    answer?: FormAnswerV2 | null;
+}

package/dist/src/Forms/API.js

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

package/dist/src/Forms/SubmittedForm.d.ts

@@ -0,0 +1,56 @@
+import { FormItemType } from "../Common/Channels/Form";
+export interface SubmittedForm {
+    id: string;
+    shardKey: string;
+    spaceId: string;
+    formId: string;
+    contractVersion: number;
+    formRevision: number;
+    schemaHash: string | null;
+    tags: FormTag[];
+    /** Compatibilidad con formularios V1. */
+    responses?: FormResponse[] | null;
+    answers: FormAnswerV2[];
+    createdAt: Date;
+    expireAt: Date | null;
+    completedAt: Date | null;
+}
+export interface FormTag {
+    name: string;
+    value: string;
+}
+export declare enum FormStatus {
+    pending = 0,
+    completed = 1,
+    expired = 2
+}
+export interface FormResponse {
+    questionId: string;
+    type: FormItemType;
+    response: unknown;
+}
+export interface FormAnswerV2 {
+    fieldId: string;
+    fieldType: string;
+    /** Snapshot útil para exportaciones históricas. */
+    fieldLabel: string | null;
+    textValue: string | null;
+    numericValue: number | null;
+    /** Formatos canónicos: yyyy-MM-dd y HH:mm:ss. */
+    dateValue: string | null;
+    timeValue: string | null;
+    selectedOptions: FormSelectedOption[] | null;
+    files: FormSubmittedFile[] | null;
+}
+export interface FormSelectedOption {
+    id: string;
+    /** Snapshot histórico de la etiqueta. */
+    label: string | null;
+}
+export interface FormSubmittedFile {
+    storageId: string;
+    fileName: string;
+    contentType: string | null;
+    sizeBytes: number;
+    url: string | null;
+}

package/dist/src/Forms/SubmittedForm.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormStatus = void 0;
+var FormStatus;
+(function (FormStatus) {
+    FormStatus[FormStatus["pending"] = 0] = "pending";
+    FormStatus[FormStatus["completed"] = 1] = "completed";
+    FormStatus[FormStatus["expired"] = 2] = "expired";
+})(FormStatus || (exports.FormStatus = FormStatus = {}));

package/dist/src/Forms/index.d.ts

@@ -0,0 +1,2 @@
+export * from './API';
+export * from './SubmittedForm';

package/dist/src/Forms/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./API"), exports);
+__exportStar(require("./SubmittedForm"), exports);

package/dist/src/Presence/AgentPause.d.ts

@@ -0,0 +1,24 @@
+export interface AgentPause {
+    id: string;
+    spaceId: string;
+    userId: string;
+    reason: PauseReason;
+    startedAt: Date;
+    startedByUserId?: string;
+    startedBy: PauseActorType;
+    endedAt?: Date;
+}
+export declare enum PauseReason {
+    LUNCH = 0,
+    RESTROOM = 1,
+    BREAK = 2,
+    MEETING = 3,
+    TRAINING = 4,
+    ADMINISTRATIVE_WORK = 5,
+    OTHER = 6
+}
+export declare enum PauseActorType {
+    AGENT = 0,
+    SUPERVISOR = 1,
+    SYSTEM = 2
+}

package/dist/src/Presence/AgentPause.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PauseActorType = exports.PauseReason = void 0;
+var PauseReason;
+(function (PauseReason) {
+    PauseReason[PauseReason["LUNCH"] = 0] = "LUNCH";
+    PauseReason[PauseReason["RESTROOM"] = 1] = "RESTROOM";
+    PauseReason[PauseReason["BREAK"] = 2] = "BREAK";
+    PauseReason[PauseReason["MEETING"] = 3] = "MEETING";
+    PauseReason[PauseReason["TRAINING"] = 4] = "TRAINING";
+    PauseReason[PauseReason["ADMINISTRATIVE_WORK"] = 5] = "ADMINISTRATIVE_WORK";
+    PauseReason[PauseReason["OTHER"] = 6] = "OTHER";
+})(PauseReason || (exports.PauseReason = PauseReason = {}));
+var PauseActorType;
+(function (PauseActorType) {
+    PauseActorType[PauseActorType["AGENT"] = 0] = "AGENT";
+    PauseActorType[PauseActorType["SUPERVISOR"] = 1] = "SUPERVISOR";
+    PauseActorType[PauseActorType["SYSTEM"] = 2] = "SYSTEM";
+})(PauseActorType || (exports.PauseActorType = PauseActorType = {}));

package/dist/src/Presence/QueueParticipation.d.ts

@@ -0,0 +1,17 @@
+import { ConversationQueueInfo } from "../Conversations/Queue";
+export interface QueueParticipation {
+    spaceId: string;
+    userId: string;
+    queueId: string;
+    authorized: boolean;
+    active: boolean;
+    updatedAt: Date;
+    updatedByUserId?: string;
+}
+export interface QueueParticipationDto {
+    queueId: string;
+    authorized: boolean;
+    active: boolean;
+    updatedAt: Date;
+    queue?: ConversationQueueInfo | null;
+}

package/dist/src/Presence/QueueParticipation.js

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

package/dist/src/Presence/QueueRoutingState.d.ts

@@ -0,0 +1,27 @@
+import { ConversationQueueInfo } from "../Conversations/Queue";
+export interface QueueRoutingState {
+    spaceId: string;
+    userId: string;
+    queueId: string;
+    isEligible: boolean;
+    presenceStatus: RoutingPresenceStatus;
+    activeJobCount: number;
+    maxCapacity?: number;
+    notRespondingDetectedAt?: Date;
+    updatedAt: Date;
+}
+export declare enum RoutingPresenceStatus {
+    IDLE = 0,
+    INTERACTING = 1,
+    BUSY = 2
+}
+export interface RoutingStateDto {
+    queueId: string;
+    queue?: ConversationQueueInfo | null;
+    isEligible: boolean;
+    presenceStatus?: RoutingPresenceStatus;
+    activeJobCount: number;
+    maxCapacity?: number | null;
+    notRespondingDetectedAt?: Date;
+    updatedAt?: Date;
+}

package/dist/src/Presence/QueueRoutingState.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoutingPresenceStatus = void 0;
+var RoutingPresenceStatus;
+(function (RoutingPresenceStatus) {
+    RoutingPresenceStatus[RoutingPresenceStatus["IDLE"] = 0] = "IDLE";
+    RoutingPresenceStatus[RoutingPresenceStatus["INTERACTING"] = 1] = "INTERACTING";
+    RoutingPresenceStatus[RoutingPresenceStatus["BUSY"] = 2] = "BUSY";
+})(RoutingPresenceStatus || (exports.RoutingPresenceStatus = RoutingPresenceStatus = {}));

package/dist/src/Presence/index.d.ts

@@ -0,0 +1,3 @@
+export * from './AgentPause';
+export * from './QueueParticipation';
+export * from './QueueRoutingState';

package/dist/src/Presence/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AgentPause"), exports);
+__exportStar(require("./QueueParticipation"), exports);
+__exportStar(require("./QueueRoutingState"), exports);

package/dist/src/Tickets/Category.d.ts

@@ -51,3 +51,21 @@ export interface IUpdateTicketCategoryDto {
     fieldDefinitionIds?: string[] | null;
     layoutIds?: string[] | null;
 }
+export interface ICreateTicketResolutionTypeDto {
+    name: string;
+    description?: string;
+    enabled?: boolean;
+    order?: number;
+    formRequirements?: ITicketFormRequirement[];
+    fieldDefinitionIds?: string[];
+    layoutIds?: string[];
+}
+export interface IUpdateTicketResolutionTypeDto {
+    name?: string;
+    description?: string | null;
+    enabled?: boolean;
+    order?: number;
+    formRequirements?: ITicketFormRequirement[] | null;
+    fieldDefinitionIds?: string[] | null;
+    layoutIds?: string[] | null;
+}