@trii/types 2.10.757 → 2.10.759

package/dist/Automations/Events/Event.d.ts

@@ -1,8 +1,8 @@
 import { AutomationCustomer, AutomationJsonObject, AutomationJsonSchema, AutomationResourceReference, AutomationSourceApplication } from '../Common';
 export declare const AUTOMATION_MESSAGE_SCHEMAS: {
-    readonly DOMAIN_EVENT_V1: "automations.domain-event/v1";
-    readonly START_REQUEST_V1: "automations.start-request/v1";
-    readonly EXECUTION_WORK_ITEM_V1: "automations.execution.work-item/v1";
+    readonly DOMAIN_EVENT_V1: 'automations.domain-event/v1';
+    readonly START_REQUEST_V1: 'automations.start-request/v1';
+    readonly EXECUTION_WORK_ITEM_V1: 'automations.execution.work-item/v1';
 };
 export interface AutomationEventDefinition {
     eventType: string;

package/dist/Contacts/CommunicationEndpoint.d.ts

@@ -9,22 +9,22 @@ export declare enum CommunicationEndpointKind {
  */
 export declare const providerIdentityNamespaces: {
     readonly meta: {
-        readonly instagramUser: "instagram_user";
-        readonly messengerUser: "messenger_user";
-        readonly whatsappUser: "whatsapp_user";
+        readonly instagramUser: 'instagram_user';
+        readonly messengerUser: 'messenger_user';
+        readonly whatsappUser: 'whatsapp_user';
     };
     readonly telegram: {
-        readonly user: "user";
-        readonly chat: "chat";
+        readonly user: 'user';
+        readonly chat: 'chat';
     };
     readonly trii: {
-        readonly webchatVisitor: "webchat_visitor";
+        readonly webchatVisitor: 'webchat_visitor';
     };
     readonly mercadolibre: {
-        readonly buyer: "buyer";
+        readonly buyer: 'buyer';
     };
     readonly google: {
-        readonly businessMessagesUser: "business_messages_user";
+        readonly businessMessagesUser: 'business_messages_user';
     };
 };
 export type KnownIdentityProvider = keyof typeof providerIdentityNamespaces;

package/dist/Conversations/Classifications/ConversationClassificationEvents.d.ts

@@ -1,7 +1,7 @@
 import type { ConversationClassificationEvaluationStatus } from './ConversationClassificationEvaluation';
 export declare const CONVERSATION_CLASSIFICATION_EVENT_TYPES: {
-    readonly CONVERSATION_RESOLVED_FOR_EVALUATION: "conversation.resolved-for-classification";
-    readonly EVALUATION_FINISHED: "conversation.classification-evaluation-finished";
+    readonly CONVERSATION_RESOLVED_FOR_EVALUATION: 'conversation.resolved-for-classification';
+    readonly EVALUATION_FINISHED: 'conversation.classification-evaluation-finished';
 };
 export declare const CONVERSATION_CLASSIFICATION_EVENT_SCHEMA_VERSION: 1;
 /**

package/dist/Conversations/Conversation.d.ts

@@ -258,35 +258,35 @@ export type ConversationAssignmentSnapshot = {
     offerExpiresAt?: never;
     assignedAt?: never;
     acceptedAt?: never;
-} | QueuedConversationAssignmentBase & {
+} | (QueuedConversationAssignmentBase & {
     status: 'queued' | 'routing';
     owner: NoConversationOwner;
     offeredAt?: never;
     offerExpiresAt?: never;
     assignedAt?: never;
     acceptedAt?: never;
-} | QueuedConversationAssignmentBase & {
+}) | (QueuedConversationAssignmentBase & {
     status: 'offered';
     owner: UserConversationOwner;
     offeredAt: Date;
     offerExpiresAt?: Date;
     assignedAt?: never;
     acceptedAt?: never;
-} | QueuedConversationAssignmentBase & {
+}) | (QueuedConversationAssignmentBase & {
     status: 'assigned';
     owner: UserConversationOwner;
     offeredAt?: Date;
     offerExpiresAt?: Date;
     assignedAt: Date;
     acceptedAt?: never;
-} | QueuedConversationAssignmentBase & {
+}) | (QueuedConversationAssignmentBase & {
     status: 'accepted';
     owner: UserConversationOwner;
     offeredAt?: Date;
     offerExpiresAt?: Date;
     assignedAt: Date;
     acceptedAt: Date;
-};
+});
 export type ActorType = 'user' | 'contact' | 'bot' | 'flow' | 'system';
 export type ParticipantRole = 'owner' | 'collaborator' | 'follower' | 'mentioned' | 'supervisor' | 'bot' | 'flow' | 'historical';
 export type ConversationEventType = 'conversation_created' | 'queued' | 'assigned' | 'accepted' | 'transferred' | 'consult_requested' | 'collaborator_added' | 'participant_added' | 'participant_removed' | 'participation_abandoned' | 'follow_started' | 'follow_stopped' | 'message_sent' | 'message_received' | 'internal_note_added' | 'bot_started' | 'bot_finished' | 'flow_started' | 'flow_finished' | 'status_changed' | 'resolved' | 'reopened' | 'sla_warning' | 'sla_breached' | 'sla_started' | 'sla_paused' | 'sla_resumed' | 'sla_met' | 'sla_overridden';
@@ -320,15 +320,15 @@ interface ConversationSubscriptionBase {
  * A subscription is persistent product intent. Assignment or participation
  * visibility must not create it unless an explicit auto-follow policy applies.
  */
-export type ConversationSubscription = ConversationSubscriptionBase & {
+export type ConversationSubscription = (ConversationSubscriptionBase & {
     status: 'following';
     followedAt: Date;
     unfollowedAt?: never;
-} | ConversationSubscriptionBase & {
+}) | (ConversationSubscriptionBase & {
     status: 'unfollowed';
     followedAt: Date;
     unfollowedAt: Date;
-};
+});
 export interface PutConversationSubscriptionRequest {
     expectedVersion?: number;
     notifications: ConversationSubscriptionNotifications;

package/dist/Conversations/Routing.d.ts

@@ -26,27 +26,27 @@ export interface PartyOwnerAssigneeResolver {
     mode: 'prefer' | 'required';
 }
 export type QueueOwnerAssigneeResolver = PartyOwnerAssigneeResolver;
-export type QueueRoutingPolicy = QueueRoutingPolicyBase & {
+export type QueueRoutingPolicy = (QueueRoutingPolicyBase & {
     distributionMode: 'shared';
     strategy?: never;
     ownerResolver?: never;
-} | QueueRoutingPolicyBase & {
+}) | (QueueRoutingPolicyBase & {
     distributionMode: 'manual_pull';
     strategy?: never;
     ownerResolver?: never;
-} | QueueRoutingPolicyBase & {
+}) | (QueueRoutingPolicyBase & {
     distributionMode: 'exclusive';
     strategy: QueueRoutingStrategy;
-    ownerResolver?: undefined | PartyOwnerAssigneeResolver & {
+    ownerResolver?: undefined | (PartyOwnerAssigneeResolver & {
         mode: 'prefer';
-    };
-} | QueueRoutingPolicyBase & {
+    });
+}) | (QueueRoutingPolicyBase & {
     distributionMode: 'exclusive';
     strategy?: never;
     ownerResolver: PartyOwnerAssigneeResolver & {
         mode: 'required';
     };
-};
+});
 export type QueueRoutingConfig = QueueRoutingPolicy & {
     queueId: string;
     spaceId: string;
@@ -133,15 +133,15 @@ export type PartyOwnerAssigneeEvaluation = {
     }>;
     outcome: 'selected';
     nextStep?: never;
-} | FailedPartyOwnerEvaluation & {
+} | (FailedPartyOwnerEvaluation & {
     type: 'party_owner';
     mode: 'prefer';
     nextStep: 'strategy';
-} | FailedPartyOwnerEvaluation & {
+}) | (FailedPartyOwnerEvaluation & {
     type: 'party_owner';
     mode: 'required';
     nextStep: 'fallback';
-};
+});
 export interface RoutingDecision {
     decisionId: string;
     spaceId: string;

package/dist/Events/DomainEventTypes.d.ts

@@ -9,39 +9,39 @@
  */
 export declare const DOMAIN_EVENT_TYPES: {
     readonly AUTOMATIONS: {
-        readonly MANUAL: "automations.manual";
-        readonly SCHEDULE_TICK: "automations.schedule.tick";
+        readonly MANUAL: 'automations.manual';
+        readonly SCHEDULE_TICK: 'automations.schedule.tick';
     };
     readonly CONTACTS: {
-        readonly CONTACT_CREATED: "contacts.contact.created";
-        readonly BUSINESS_CREATED: "contacts.business.created";
-        readonly PROPERTY_CHANGED: "contacts.property.changed";
-        readonly TAG_ADDED: "contacts.tag.added";
-        readonly TAG_REMOVED: "contacts.tag.removed";
-        readonly PROPERTY_DATE_REACHED: "contacts.property.date_reached";
+        readonly CONTACT_CREATED: 'contacts.contact.created';
+        readonly BUSINESS_CREATED: 'contacts.business.created';
+        readonly PROPERTY_CHANGED: 'contacts.property.changed';
+        readonly TAG_ADDED: 'contacts.tag.added';
+        readonly TAG_REMOVED: 'contacts.tag.removed';
+        readonly PROPERTY_DATE_REACHED: 'contacts.property.date_reached';
     };
     readonly CONVERSATIONS: {
-        readonly CONVERSATION_CREATED: "conversations.conversation.created";
-        readonly CONVERSATION_CLOSED: "conversations.conversation.closed";
-        readonly MESSAGE_RECEIVED: "conversations.message.received";
-        readonly AGENT_INTERVENED: "conversations.agent.intervened";
+        readonly CONVERSATION_CREATED: 'conversations.conversation.created';
+        readonly CONVERSATION_CLOSED: 'conversations.conversation.closed';
+        readonly MESSAGE_RECEIVED: 'conversations.message.received';
+        readonly AGENT_INTERVENED: 'conversations.agent.intervened';
     };
     readonly TICKETS: {
-        readonly CREATED: "tickets.created";
-        readonly STATUS_CHANGED: "tickets.status_changed";
-        readonly PRIORITY_CHANGED: "tickets.priority_changed";
-        readonly ASSIGNED: "tickets.assigned";
-        readonly CUSTOMER_REPLIED: "tickets.customer_replied";
-        readonly SLA_WARNING: "tickets.sla_warning";
-        readonly SLA_BREACHED: "tickets.sla_breached";
-        readonly CLOSED: "tickets.closed";
-        readonly REOPENED: "tickets.reopened";
+        readonly CREATED: 'tickets.created';
+        readonly STATUS_CHANGED: 'tickets.status_changed';
+        readonly PRIORITY_CHANGED: 'tickets.priority_changed';
+        readonly ASSIGNED: 'tickets.assigned';
+        readonly CUSTOMER_REPLIED: 'tickets.customer_replied';
+        readonly SLA_WARNING: 'tickets.sla_warning';
+        readonly SLA_BREACHED: 'tickets.sla_breached';
+        readonly CLOSED: 'tickets.closed';
+        readonly REOPENED: 'tickets.reopened';
     };
     readonly FORMS: {
-        readonly SUBMITTED: "forms.submitted";
+        readonly SUBMITTED: 'forms.submitted';
     };
     readonly INTEGRATIONS: {
-        readonly WEBHOOK_RECEIVED: "integrations.webhook.received";
+        readonly WEBHOOK_RECEIVED: 'integrations.webhook.received';
     };
 };
 type Values<T> = T extends unknown ? T[keyof T] : never;

package/dist/Tickets/Automation.d.ts

@@ -23,6 +23,8 @@ export declare enum TicketAutomationTrigger {
     SATISFACTION_RECEIVED = "SATISFACTION_RECEIVED",
     TICKET_REOPENED = "TICKET_REOPENED",
     TICKET_RESOLVED = "TICKET_RESOLVED",
+    /** The ticket entered a work queue or moved to another one. */
+    TICKET_ENQUEUED = "TICKET_ENQUEUED",
     SCHEDULED = "SCHEDULED",
     MANUAL = "MANUAL"
 }

package/dist/Tickets/Automation.js

@@ -25,6 +25,8 @@ var TicketAutomationTrigger;
     TicketAutomationTrigger["SATISFACTION_RECEIVED"] = "SATISFACTION_RECEIVED";
     TicketAutomationTrigger["TICKET_REOPENED"] = "TICKET_REOPENED";
     TicketAutomationTrigger["TICKET_RESOLVED"] = "TICKET_RESOLVED";
+    /** The ticket entered a work queue or moved to another one. */
+    TicketAutomationTrigger["TICKET_ENQUEUED"] = "TICKET_ENQUEUED";
     TicketAutomationTrigger["SCHEDULED"] = "SCHEDULED";
     TicketAutomationTrigger["MANUAL"] = "MANUAL";
 })(TicketAutomationTrigger || (exports.TicketAutomationTrigger = TicketAutomationTrigger = {}));

package/dist/Tickets/Group.d.ts

@@ -0,0 +1,74 @@
+import { ITicketAuditedEntity } from './Common';
+/**
+ * Ticket groups, owned by tickets-api (/groups) and administered independently
+ * from the conversations groups. Groups imported from conversations keep their
+ * original 24-hex ObjectId as `id`, so existing references stay valid; new
+ * groups also get an ObjectId.
+ */
+/**
+ * Member of a group. Same shape as the `id` the conversations `IGroup.users`
+ * exposes, plus `name`/`email` when the user directory resolves them.
+ */
+export interface ITicketGroupUser {
+    id: string;
+    name?: string;
+    email?: string;
+}
+export interface ITicketGroup extends ITicketAuditedEntity {
+    name: string;
+    color: string | null;
+    description: string | null;
+    /** Disabled groups stay resolvable by id but are not offered in pickers. */
+    enabled: boolean;
+    /** The plain member set. */
+    userIds: string[];
+    users: ITicketGroupUser[];
+}
+/** Body of POST /groups. The server generates the id. */
+export interface ICreateTicketGroupDto {
+    name: string;
+    color?: string | null;
+    description?: string | null;
+    enabled?: boolean;
+    /** Initial members; every id must exist in the user directory. */
+    userIds?: string[];
+}
+/**
+ * Body of PATCH /groups/{id}. At least one field; `null` clears color or
+ * description. Membership is NOT accepted here: use PUT /groups/{id}/members.
+ */
+export interface IUpdateTicketGroupDto {
+    name?: string;
+    color?: string | null;
+    description?: string | null;
+    enabled?: boolean;
+}
+/** Body of PUT /groups/{id}/members. Replaces the whole member set. */
+export interface IReplaceTicketGroupMembersDto {
+    userIds: string[];
+}
+export interface ITicketGroupUsageRef {
+    id: string;
+    name: string;
+}
+/**
+ * Body of GET /groups/{id}/usages. Tickets and tasks are counts; configuration
+ * dependents are listed by name. Any non-empty entry blocks DELETE (409
+ * GROUP_IN_USE); disabling is always allowed.
+ */
+export interface ITicketGroupUsages {
+    tickets: number;
+    tasks: number;
+    categories: ITicketGroupUsageRef[];
+    requestTypes: ITicketGroupUsageRef[];
+    queues: ITicketGroupUsageRef[];
+    views: ITicketGroupUsageRef[];
+    dashboards: ITicketGroupUsageRef[];
+    quickResponses: ITicketGroupUsageRef[];
+    analyticsGoals: ITicketGroupUsageRef[];
+    macros: ITicketGroupUsageRef[];
+    escalationPolicies: ITicketGroupUsageRef[];
+    approvalDefinitions: ITicketGroupUsageRef[];
+    securityPolicies: ITicketGroupUsageRef[];
+    slaPolicies: ITicketGroupUsageRef[];
+}

package/dist/Tickets/Routing.d.ts

@@ -261,6 +261,11 @@ export interface ITicketRoutingState {
     requiredSkills?: ITicketSkillRequirement[];
     lastDecisionId?: string;
 }
+/**
+ * Body of POST /tickets/{id}/routing/enqueue. `queueId` is optional in the
+ * contract for automatic routing (the router picks the queue); until that
+ * exists the endpoint requires it and answers 422 without it.
+ */
 export interface IEnqueueTicketDto {
     expectedVersion: number;
     queueId?: string;
@@ -402,6 +407,29 @@ export interface IEscalationPolicyUsage {
 export interface IEscalationPolicyUsageSummary {
     queuesCount: number;
 }
+export interface ITicketQueueUsageRef {
+    id: string;
+    name: string;
+}
+/**
+ * Body of GET /routing/queues/{id}/usages: live (non-deleted) resources in the
+ * space that point at a work queue. Any non-empty entry blocks DELETE (409
+ * QUEUE_IN_USE); disabling is always allowed.
+ */
+export interface ITicketQueueUsages {
+    /** Tickets currently waiting in the queue (routing status QUEUED). */
+    tickets: number;
+    /** Routing policies whose target is the queue. */
+    routingPolicies: ITicketQueueUsageRef[];
+    /** Escalation steps with a CHANGE_QUEUE action targeting the queue. */
+    escalationPolicies: ITicketQueueUsageRef[];
+    /** Macros with an ENQUEUE action targeting the queue. */
+    macros: ITicketQueueUsageRef[];
+    /** Dashboards whose default filter or any widget query filters by the queue. */
+    dashboards: ITicketQueueUsageRef[];
+    /** Analytics goals whose filter includes the queue. */
+    analyticsGoals: ITicketQueueUsageRef[];
+}
 /** Mirror of TicketSkillWarningCode; only one member is needed today. */
 export declare enum EscalationPolicyWarningCode {
     DISABLED_BUT_REFERENCED = "DISABLED_BUT_REFERENCED"

package/dist/Tickets/Ticket.d.ts

@@ -102,6 +102,13 @@ export interface ICreateTicketDto {
      * be used together.
      */
     messageReferences?: string[];
+    /**
+     * Work queue the ticket enters on creation (manual routing). Optional: when
+     * absent the ticket is created NOT_ROUTED. Automatic queue selection from
+     * routing policies and queue conditions is planned for this same case, so
+     * clients must not treat "absent" as "never routed".
+     */
+    queueId?: string;
 }
 export interface IUpdateTicketDto {
     expectedVersion: number;

package/dist/Tickets/Workflow.d.ts

@@ -92,7 +92,9 @@ export declare enum TicketActivityType {
     TASK_COMPLETED = "TASK_COMPLETED",
     ALL_REQUIRED_TASKS_COMPLETED = "ALL_REQUIRED_TASKS_COMPLETED",
     CHECKLIST_COMPLETED = "CHECKLIST_COMPLETED",
-    TICKET_EVENT = "TICKET_EVENT"
+    TICKET_EVENT = "TICKET_EVENT",
+    /** The ticket entered a work queue or moved to another one (`changes` carries `queueId`). */
+    ENQUEUED = "ENQUEUED"
 }
 export interface ITicketFieldChange {
     fieldNameKey: string;

package/dist/Tickets/Workflow.js

@@ -41,4 +41,6 @@ var TicketActivityType;
     TicketActivityType["ALL_REQUIRED_TASKS_COMPLETED"] = "ALL_REQUIRED_TASKS_COMPLETED";
     TicketActivityType["CHECKLIST_COMPLETED"] = "CHECKLIST_COMPLETED";
     TicketActivityType["TICKET_EVENT"] = "TICKET_EVENT";
+    /** The ticket entered a work queue or moved to another one (`changes` carries `queueId`). */
+    TicketActivityType["ENQUEUED"] = "ENQUEUED";
 })(TicketActivityType || (exports.TicketActivityType = TicketActivityType = {}));

package/dist/Tickets/index.d.ts

@@ -21,3 +21,4 @@ export * from './Fields';
 export * from './Layouts';
 export * from './Views';
 export * from './AI';
+export * from './Group';

package/dist/Tickets/index.js

@@ -37,3 +37,4 @@ __exportStar(require("./Fields"), exports);
 __exportStar(require("./Layouts"), exports);
 __exportStar(require("./Views"), exports);
 __exportStar(require("./AI"), exports);
+__exportStar(require("./Group"), exports);

package/dist/src/Common/Channels/Channel.d.ts

@@ -37,16 +37,6 @@ interface IChannelInfo {
      */
     status?: string;
 }
-/**
- * Fallback routing used only when no published Flow entry point matches the
- * channel, or when the selected Flow cannot produce a valid disposition.
- *
- * Flow-to-channel bindings remain authoritative in FlowEntryPoint.
- */
-interface ChannelConversationRoutingConfig {
-    /** Stable id of a ConversationQueue in the same space as the channel. */
-    defaultQueueId: string;
-}
 interface IChannel {
     id?: string | null;
     spaceId?: string | null;
@@ -54,28 +44,13 @@ interface IChannel {
     description?: string | null;
     type?: ChannelType | null;
     permissions?: Permission[] | null;
-    /**
-     * @deprecated Legacy channel assignment configuration. Use QueueRoutingConfig.
-     */
     assignTo?: ConversationAssigned;
-    /**
-     * @deprecated Legacy channel assignment configuration. Use QueueRoutingConfig.
-     */
     assignMethod: AssignMethod;
-    /**
-     * @deprecated Ownership is produced by the routing decision.
-     */
     assignToOwner?: boolean;
     /**
      * habilita la creacion de conversaciones para este canal, si esta en false, los mensajes entrantes no generaran conversaciones
      */
     conversationsEnabled: boolean | false;
-    /**
-     * Default Queue for newly-created conversations that are not handled by a
-     * Flow. Store only the Queue id; Queue configuration remains authoritative
-     * in the Conversations domain.
-     */
-    conversationRouting?: ChannelConversationRoutingConfig | null;
     /**
      * Gets or sets a value indicating whether webhook notifications are enabled.
      * Redirects incoming messages to the specified webhook URL when set to true.
@@ -121,4 +96,4 @@ declare enum channelStatus {
     SUSPENDED = 7,
     CONFIGURATION_PENDING = 9
 }
-export { IChannel, IChannelInfo, ChannelConversationRoutingConfig, channelStatus, MessagingAvailability };
+export { IChannel, IChannelInfo, channelStatus, MessagingAvailability };

package/dist/src/Contacts/contacts.d.ts

@@ -14,7 +14,7 @@ export interface IBusiness {
     counters?: ICounters;
     name: string;
     imageUrl: string;
-    ownerUserId?: string;
+    owner?: string;
     membersId: string[];
     members: IContactInfo[];
     phones: IContactAddress[];
@@ -54,7 +54,7 @@ export interface IContact {
     lastName: string;
     imageUrl: string;
     birthDate?: Date | null;
-    ownerUserId?: string;
+    owner?: string;
     businessId?: string;
     businessName?: string;
     phones: IContactAddress[];