@trii/types 2.10.753 → 2.10.754

package/dist/Common/Messages/Message.d.ts

@@ -415,6 +415,8 @@ export interface IMessage {
     idLocal?: number;
     spaceId: string;
     conversationId: string;
+    /** Deduplicated incoming ordinal within Conversation; null for outgoing/internal/legacy. */
+    conversationIncomingSequence?: number | null;
     workflowId?: string;
     /**only for Front-End */
     contactId?: string;

package/dist/Conversations/Assignment.d.ts

@@ -1,5 +1,4 @@
 import { ID } from './Conversation';
-export declare const CONVERSATION_ASSIGNMENT_EVENTS_COLLECTION = "conversation_assignment_events";
 export type ConversationAssignmentEventType = 'enqueued' | 'routing_started' | 'offered' | 'assigned' | 'accepted' | 'transferred' | 'released' | 'timed_out' | 'requeued';
 export type ConversationAssignmentReason = 'conversation_created' | 'routing_selected' | 'manual_assignment' | 'manual_transfer' | 'flow_routing' | 'offer_timeout' | 'assignment_timeout' | 'agent_accepted' | 'agent_released' | 'supervisor_released' | 'capacity_rebalance' | 'sla_escalation' | 'system_recovery' | 'transfer_cancelled' | 'transfer_declined';
 export type AssignmentOwnerReference = {

package/dist/Conversations/Assignment.js

@@ -1,4 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONVERSATION_ASSIGNMENT_EVENTS_COLLECTION = void 0;
-exports.CONVERSATION_ASSIGNMENT_EVENTS_COLLECTION = 'conversation_assignment_events';

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

@@ -1,6 +1,4 @@
 import type { ClassificationSeverity } from './ConversationClassificationEvaluation';
-export declare const CLASSIFICATION_TAXONOMY_VERSIONS_COLLECTION = "classification_taxonomy_versions";
-export declare const CONVERSATION_EVALUATIONS_COLLECTION = "conversation_evaluations";
 export type ConversationClassificationDimension = 'contact_reason' | 'incident' | 'outcome' | 'recovery';
 export type ClassificationTaxonomyStatus = 'draft' | 'published' | 'archived';
 /**

package/dist/Conversations/Classifications/ClassificationTaxonomy.js

@@ -1,5 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONVERSATION_EVALUATIONS_COLLECTION = exports.CLASSIFICATION_TAXONOMY_VERSIONS_COLLECTION = void 0;
-exports.CLASSIFICATION_TAXONOMY_VERSIONS_COLLECTION = 'classification_taxonomy_versions';
-exports.CONVERSATION_EVALUATIONS_COLLECTION = 'conversation_evaluations';

package/dist/Conversations/Conversation.d.ts

@@ -1,4 +1,7 @@
 import { UserInfo } from "../Users/UserTrii";
+import type { ConversationReadState } from './ConversationReadState';
+import type { ConversationPendingTransfer } from './ConversationPendingTransfer';
+import type { ConversationSlaSnapshot, ConversationSlaStatus } from './ConversationSlaClockState';
 import { ILabel } from "./Label";
 import { GroupInfo } from "./Groups/Group";
 import { Channels } from "../Common/index";
@@ -38,39 +41,26 @@ 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;
-        policyId?: string;
-        version: number;
-    };
+    /** Preserve assignment until acceptance atomically replaces it and clears this handoff. */
+    pendingTransfer?: ConversationPendingTransfer | null;
+    sla: ConversationSlaSnapshot;
     lastMessage: string;
     lastMessageId?: string;
-    newMessagesCount: number;
-    newMessagesUnread: boolean;
+    readState: ConversationReadState;
     lastActivityAt: Date;
     lastCustomerActivityAt?: Date;
     lastAgentActivityAt?: Date;
     labels: ILabel[];
-    /**
-     * Fijado/favorito. En chats internos (GROUP/DIRECT) el documento está duplicado por miembro
-     * (`shardKey = "User|{userId}"`), por lo que este flag es por copia/usuario (B1), no del grupo.
-     */
+    /** Shared pin for every viewer of this conversation. */
     pinned: boolean;
+    /** Shared outstanding work; reading does not answer or resolve it. */
+    requiresAction: boolean;
     /**
-     * Silenciado hasta (B3). Por copia/usuario, igual que `pinned`. null/undefined = no silenciado.
+     * Legacy internal-chat preference. Not the shared pin or customer conversation state.
      * El front compara contra la hora actual; una fecha lejana representa "siempre".
      */
     mutedUntil?: Date | null;
-    /** @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;
@@ -93,7 +83,18 @@ export interface IConversation {
     resolutionReasonId?: string;
     finalizedAt: Date;
     finalizedBy?: string;
+    /** Presentation kind, not a separate lifecycle. Public conversations belong to one contact. */
+    interactionKind: InteractionKind;
+    /** Internal Post.id, required for public views. Null for private conversations. */
+    wallPostId?: string | null;
+    /** Stable internal WallMessage.id root; required for comment/mention, null for wall_post/private.
+     * Correlate by tenant/channel/contact/post/root, never by post alone.
+     */
+    wallRootCommentId?: string | null;
+    /** Mutable navigation focus in the public thread, not its identity. */
+    lastCommentId?: string | null;
 }
+export type InteractionKind = 'private' | 'wall_post' | 'comment' | 'mention';
 export interface IWhatsAppGroupInfo {
     whatsappGroupId: string;
     groupInviteCode: string;
@@ -185,7 +186,7 @@ export declare enum ConversationStatus {
     FINALIZED = 3,// Alias for RESOLVED
     WAITING = 10
 }
-export type InboxViewId = 'pending' | 'following' | 'sla_warning' | 'sla_breached' | 'team_sla_breached' | 'resolved' | 'label';
+export type InboxViewId = 'pending' | 'following' | 'sla_warning' | 'sla_breached' | 'team_sla_breached';
 export type OwnerType = 'user' | 'bot' | 'flow' | 'none';
 export interface NoConversationOwner {
     type: 'none';
@@ -308,194 +309,41 @@ export interface PutConversationSubscriptionRequest {
     expectedVersion?: number;
     notifications: ConversationSubscriptionNotifications;
 }
-export interface UserConversationState {
-    id: ID;
-    spaceId: ID;
-    conversationId: ID;
-    userId: ID;
-    pinned: boolean;
-    pinnedAt?: Date;
-    lastReadMessageId?: ID;
-    lastReadAt?: Date;
-    updatedAt: Date;
-    version: number;
-}
 export type ConversationReadStateMode = 'read' | 'unread';
 export interface PutConversationReadStateRequest {
     mode: ConversationReadStateMode;
-    lastReadMessageId?: ID;
-    lastReadAt?: Date;
+    commandId: string;
+    expectedConversationVersion: number;
+    /** Required for read, null for unread. Observed cursor, never silently server-latest. */
+    throughIncomingSequence?: number | null;
 }
 export interface PutConversationPinRequest {
+    commandId: string;
+    expectedConversationVersion: number;
     pinned: boolean;
 }
-export type InboxVisibilityReason = 'manual_follow' | 'assigned_to_user' | 'shared_queue_member' | 'queue_claimable' | 'active_participant' | 'sla_warning_owner' | 'sla_breached_owner' | 'supervised_queue_sla' | 'supervisor_escalation' | 'resolved_visible' | 'labeled';
-export interface ConversationInboxSnapshot {
-    interactionKind: 'private' | 'wall_post' | 'comment' | 'mention';
-    channelType: string;
-    channelId?: ID;
-    contact: {
-        id?: ID;
-        displayName: string;
-        initials?: string;
-        isBusiness: boolean;
-    };
-    status: ConversationStatus;
-    owner: ConversationOwner;
-    queueId?: ID;
-    preview?: string;
-    lastMessageId?: ID;
-    unreadCount: number;
-    priority: 'low' | 'normal' | 'high' | 'urgent';
-    sla: {
-        status: 'none' | 'running' | 'warning' | 'breached' | 'met';
-        deadlineAt?: Date;
-    };
-    lastActivityAt: Date;
-    labels: {
-        id: ID;
-        name: string;
-        color?: string;
-    }[];
-    /** Solo poblado para interactionKind='comment'|'mention' - el WallMessage.id del comentario mas
-     *  reciente, para abrir el hilo posicionado ahi (igual que lastMessageId para conversaciones). */
-    commentId?: ID;
-    participants: {
-        id: ID;
-        displayName?: string;
-        avatarUrl?: string;
-    }[];
-    /**
-     * Transferencia pendiente que nadie tomo todavia: el assignment vigente
-     * tiene source='transfer' y status 'offered' o 'queued'.
-     *
-     * Resuelta POR USUARIO. `UserInboxItemDocument` es un documento por
-     * espacio+usuario+conversacion, asi que el backend puede decir de que lado
-     * queda cada uno — que es lo que la card previa a la migracion del inbox
-     * calculaba en el cliente comparando el destino contra el uid propio:
-     *
-     * - 'in'  -> se la transfirieron a este usuario; `counterpartName` es quien
-     *   la transfirio.
-     * - 'out' -> la transferencia va hacia otro; `counterpartName` es el
-     *   destino (usuario o cola).
-     *
-     * Los dos nombres estan a mano en el momento de la transferencia, asi que
-     * el proyector no necesita releer el historial de eventos.
-     *
-     * Ausente cuando no hay transferencia pendiente y en documentos anteriores
-     * al campo. `counterpartName` no es opcional: sin nombre la fila no puede
-     * rotular el icono y descarta el indicador, igual que hace con los
-     * `participants` sin `displayName`.
-     */
-    pendingTransfer?: {
-        direction: 'in' | 'out';
-        counterpartName: string;
-    };
-}
-/**
- * Membership of one materialized conversation in one logical inbox view.
- *
- * visibilityReasons has set semantics: values must be unique and non-empty.
- * Removing one reason preserves the view while at least one reason remains.
- *
- * labelId is only populated when viewId is 'label' - identifies which of the
- * space's labels this particular view entry represents (InboxViewId is a
- * fixed enum, but labels are dynamic per space).
- */
-export interface UserInboxItemView {
-    viewId: InboxViewId;
-    visibilityReasons: [
-        InboxVisibilityReason,
-        ...InboxVisibilityReason[]
-    ];
-    requiresAction: boolean;
-    labelId?: ID;
-}
-/**
- * Materialized read model. There is exactly one document for each
- * spaceId + userId + conversationId tuple.
- *
- * views must contain unique viewId values, EXCEPT for viewId='label': a
- * conversation can carry multiple labels, so multiple entries with
- * viewId='label' are allowed as long as their labelId differs (unique
- * (viewId, labelId) pairs for that case). Delete the document when the last
- * view is removed.
- */
-export interface UserInboxItemDocument {
-    id: ID;
-    spaceId: ID;
-    userId: ID;
-    conversationId: ID;
-    views: UserInboxItemView[];
-    snapshot: ConversationInboxSnapshot;
-    pinned: boolean;
-    priorityScore: number;
-    sortAt: Date;
-    conversationVersion: number;
-    subscriptionVersion?: number;
-    projectionVersion: number;
-    lastSourceEventId: ID;
-    projectedAt: Date;
-}
-/**
- * Materialized counters for exactly one user/view pair (user/view/label when
- * viewId is 'label' - labelId becomes part of the logical key in that case).
- *
- * total and requiresAction count conversations, never visibility reasons.
- * unread counts conversations whose snapshot.unreadCount is greater than zero,
- * not the number of unread messages.
- */
-export interface UserInboxCounterDocument {
-    id: ID;
-    spaceId: ID;
-    userId: ID;
-    viewId: InboxViewId;
-    labelId?: ID;
-    total: number;
-    requiresAction: number;
-    unread: number;
-    projectionVersion: number;
-    updatedAt: Date;
-}
+/** Conversation lists return CursorPage<IConversation> directly; authorization stays in backend. */
 export interface CursorPage<T> {
     items: T[];
-    nextCursor?: string;
+    nextCursor?: string | null;
     hasMore: boolean;
     generatedAt: Date;
 }
-export interface ConversationCapabilitiesDto {
-    canView: boolean;
-    canReply: boolean;
-    canFollow: boolean;
-    canAbandon: boolean;
-    canClaim: boolean;
-    canAccept: boolean;
-    canRelease: boolean;
-    canTransfer: boolean;
-    canResolve: boolean;
-    canReopen: boolean;
-    canChangePriority: boolean;
-    canManageLabels: boolean;
-    canManageSla: boolean;
-    canViewAssignmentHistory: boolean;
-    canViewRoutingDecisions: boolean;
-}
+/** Counts distinct authorized conversations on demand; unread includes manual unread. */
 export interface InboxViewSummaryDto {
-    id: InboxViewId | 'supervised_target' | `label:${string}`;
+    id: string;
     label: string;
-    scope: 'personal' | 'supervision' | 'history' | 'labels';
+    scope: string;
     order: number;
     total: number;
     requiresAction: number;
     unread: number;
     enabled: boolean;
     targetRequired: boolean;
-    capabilities: string[];
 }
 export interface InboxViewsResponse {
     views: InboxViewSummaryDto[];
     countersGeneratedAt: Date;
-    projectionLagMs?: number;
 }
 export interface InboxFilterDto {
     text?: string;
@@ -504,7 +352,8 @@ export interface InboxFilterDto {
     channelTypes?: string[];
     statuses?: ConversationStatus[];
     priorities?: Array<'low' | 'normal' | 'high' | 'urgent'>;
-    slaStatuses?: Array<'none' | 'running' | 'warning' | 'breached' | 'met'>;
+    slaStatuses?: ConversationSlaStatus[];
+    /** OR within the authorized view; labels never grant access. */
     labelIds?: ID[];
     unread?: boolean;
     requiresAction?: boolean;
@@ -519,16 +368,6 @@ export interface InboxFilterDto {
         type: 'priority';
     };
 }
-export type InboxConversationItemDto = Pick<UserInboxItemDocument, 'conversationId' | 'views' | 'snapshot' | 'pinned' | 'priorityScore' | 'sortAt'> & {
-    capabilities: Pick<ConversationCapabilitiesDto, 'canView' | 'canReply' | 'canClaim' | 'canTransfer'>;
-};
-export interface InboxConversationPage extends CursorPage<InboxConversationItemDto> {
-    appliedFilter: InboxFilterDto;
-    facets?: unknown;
-}
-/**
- * DTO API - GET /inbox/views/{viewId}/filter-options.
- */
 export interface InboxFacetOptionDto {
     id: string;
     label: string;
@@ -541,9 +380,11 @@ export interface InboxFacetsDto {
     statuses: InboxFacetOptionDto[];
     priorities: InboxFacetOptionDto[];
     slaStatuses: InboxFacetOptionDto[];
+    /** Full selected view, before label filters/pagination; only positive counts, once per label/conversation. */
     labels: InboxFacetOptionDto[];
 }
 export interface InboxFilterOptionsResponse {
+    viewId: InboxViewId;
     facets: InboxFacetsDto;
     generatedAt: Date;
 }
@@ -558,14 +399,10 @@ export interface ConversationUserRelationDto {
     isOwner: boolean;
     isParticipant: boolean;
     isFollowing: boolean;
-    isPinned: boolean;
-    unreadCount: number;
 }
 export interface ConversationDetailResponse {
     conversation: IConversation;
     relation: ConversationUserRelationDto;
-    capabilities: ConversationCapabilitiesDto;
-    availableActions: string[];
 }
 export interface AddConversationParticipantRequest {
     userId: string;

package/dist/Conversations/ConversationPendingTransfer.d.ts

@@ -0,0 +1,16 @@
+import type { TransferConversationReason, TransferConversationTarget } from './Transfer';
+/** Single current handoff, not history. Keep assignment unchanged until acceptance.
+ * Accept atomically with matching transferId, sourceAssignmentId and Conversation.version.
+ * First valid acceptance wins. Reject/cancel/expire clears this state without moving source.
+ * Resolve authorized target audience at query time, checking expiration even before cleanup.
+ */
+export interface ConversationPendingTransfer {
+    transferId: string;
+    sourceAssignmentId: string;
+    target: TransferConversationTarget;
+    /** Null for automated requests; full actor is recorded in events. */
+    requestedByUserId?: string | null;
+    requestedAt: Date;
+    expiresAt?: Date | null;
+    reason: TransferConversationReason;
+}

package/dist/Conversations/ConversationReadState.d.ts

@@ -0,0 +1,16 @@
+/** Shared state; 0 <= readThroughSequence <= lastIncomingSequence.
+ * Incoming ordinals are assigned once per deduplicated message in ingestion order.
+ * Reading advances only to the observed ordinal; manual unread preserves the cursor.
+ * Numeric counters must remain within JavaScript's safe integer range.
+ */
+export interface ConversationReadState {
+    lastIncomingSequence: number;
+    readThroughSequence: number;
+    manuallyMarkedUnread: boolean;
+    changedAt?: Date | null;
+    changedByUserId?: string | null;
+    /** Derived by the backend; not persisted in BSON. */
+    readonly unreadCount: number;
+    /** Includes manual unread even when unreadCount is zero. */
+    readonly isUnread: boolean;
+}

package/dist/Conversations/ConversationReadState.js

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

package/dist/Conversations/ConversationSlaClockState.d.ts

@@ -0,0 +1,45 @@
+import type { ConversationSlaMetric, ConversationSlaCycleStatus } from './Sla';
+export type ConversationSlaStatus = 'none' | 'running' | 'warning' | 'breached' | 'met' | 'paused' | 'cancelled';
+/** Current operational state, at most one clock per metric. No configuration/history.
+ * A replacement gets a new cycleId; archive the previous cycle outside Conversation.
+ * Updates use Conversation.version plus expected cycleId/SLA revision. All times UTC.
+ */
+export interface ConversationSlaClockState {
+    cycleId: string;
+    metric: ConversationSlaMetric;
+    sequence: number;
+    /** breached is unfinished; late completion preserves breachedAt. */
+    status: ConversationSlaCycleStatus;
+    /** Immutable applied reference must resolve historical calendar/timezone rules. */
+    policyId: string;
+    policyVersion: number;
+    startedByEventId: string;
+    startedByMessageId?: string | null;
+    assignmentId?: string | null;
+    startedAt: Date;
+    deadlineAt?: Date | null;
+    nextWarningAt?: Date | null;
+    warningAt?: Date | null;
+    /** Current pause only; clear on resume. */
+    pausedAt?: Date | null;
+    /** Chargeable seconds through elapsedCalculatedAt, within JS safe integer range. */
+    elapsedSeconds: number;
+    /** Accounting watermark; on resume reset to resume time preserving consumed seconds. */
+    elapsedCalculatedAt: Date;
+    breachedAt?: Date | null;
+    completedAt?: Date | null;
+    cancelledAt?: Date | null;
+}
+/** Summary updated atomically with clocks; never an independent state source. */
+export interface ConversationSlaSnapshot {
+    /** Precedence: breached, active warning, running, paused, met, cancelled, none. */
+    status: ConversationSlaStatus;
+    /** Earliest unfinished/unpaused deadline. Compare against UTC even if evaluator lags. */
+    deadlineAt?: Date | null;
+    /** Selection for new clocks; current clocks retain their applied references. */
+    policyId?: string | null;
+    policyVersion?: number | null;
+    clocks: ConversationSlaClockState[];
+    /** SLA state revision, not policy version. */
+    version: number;
+}

package/dist/Conversations/ConversationSlaClockState.js

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

package/dist/Conversations/InboxQueries.d.ts

@@ -0,0 +1,30 @@
+import type { ID, InboxViewId, InboxFilterDto } from './Conversation';
+export type InboxPaginationSort = 'activity' | 'priority';
+/** Cursor over current authorized conversations, after filtering.
+ * Bind to tenant/user/view/filter/sort; live updates may move rows between pages.
+ */
+export interface InboxActivityCursor {
+    sort: 'activity';
+    pinned: boolean;
+    lastActivityAt: Date;
+    conversationId: ID;
+}
+export interface InboxPriorityCursor {
+    sort: 'priority';
+    pinned: boolean;
+    /** Explicit rank urgent > high > normal > low, not lexical order. */
+    priority: 'low' | 'normal' | 'high' | 'urgent';
+    lastActivityAt: Date;
+    conversationId: ID;
+}
+export type InboxPaginationCursor = InboxActivityCursor | InboxPriorityCursor;
+export interface InboxPageQuery {
+    /** Trusted server context, not client authorization claims. */
+    spaceId: ID;
+    userId: ID;
+    viewId: InboxViewId;
+    limit: number;
+    filter: InboxFilterDto;
+    /** Must match filter.sort. */
+    cursor?: InboxPaginationCursor | null;
+}

package/dist/Conversations/InboxQueries.js

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

package/dist/Conversations/Outbox.d.ts

@@ -1,4 +1,3 @@
-export declare const OUTBOX_EVENTS_COLLECTION = "outbox_events";
 export type OutboxEventStatus = 'pending' | 'publishing' | 'published' | 'failed';
 /**
  * Transactional outbox record persisted with the aggregate mutation.

package/dist/Conversations/Outbox.js

@@ -1,4 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OUTBOX_EVENTS_COLLECTION = void 0;
-exports.OUTBOX_EVENTS_COLLECTION = 'outbox_events';

package/dist/Conversations/Queue.d.ts

@@ -1,6 +1,5 @@
 import { ID } from './Conversation';
 import { QueueRoutingPolicy } from './Routing';
-export declare const CONVERSATION_QUEUES_COLLECTION = "conversation_queues";
 export type QueueSlaTransferBehavior = 'preserve' | 'restart' | 'recalculate';
 export type ConversationQueueSlaConfig = {
     enabled: false;
@@ -21,15 +20,14 @@ export type ConversationQueueSlaConfig = {
  */
 export type QueueMemberAudienceMode = 'distribution' | 'all_current' | 'none';
 export type QueueSupervisorAudienceMode = 'all_current' | 'sla_only' | 'escalations_only' | 'none';
+/** Open conversations only. Finalization retains authorized following, not queue visibility. */
 export interface ConversationQueueAudienceConfig {
     members: {
         mode: QueueMemberAudienceMode;
         requireActiveParticipation: boolean;
-        includeResolved: boolean;
     };
     supervisors: {
         mode: QueueSupervisorAudienceMode;
-        includeResolved: boolean;
     };
 }
 export interface ConversationQueueInfo {

package/dist/Conversations/Queue.js

@@ -1,4 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONVERSATION_QUEUES_COLLECTION = void 0;
-exports.CONVERSATION_QUEUES_COLLECTION = 'conversation_queues';

package/dist/Conversations/Sla.d.ts

@@ -1,9 +1,6 @@
 import type { ISchedule } from '../Common/Schedules/Schedules';
 import type { ConversationEventType, ConversationStatus, ID } from './Conversation';
 import type { OutboxEvent } from './Outbox';
-export declare const CONVERSATION_SLA_POLICIES_COLLECTION = "conversation_sla_policies";
-export declare const CONVERSATION_SLA_CYCLES_COLLECTION = "conversation_sla_cycles";
-export declare const CONVERSATION_SLA_EVENTS_COLLECTION = "conversation_sla_events";
 export type ConversationSlaMetric = 'first_response' | 'next_response' | 'assignment' | 'acceptance' | 'resolution';
 /**
  * continuous counts natural elapsed time, including nights and holidays.
@@ -166,8 +163,8 @@ export interface ConversationSlaPausePeriod {
     sourceEventId: ID;
 }
 /**
- * Durable metric cycle. The target and time calculation are copied from the
- * selected policy version so later policy edits cannot alter active history.
+ * External history/read model. Current clocks live only in Conversation.sla.clocks.
+ * Policy copies here describe historical configuration, not another live state source.
  */
 export interface ConversationSlaCycle {
     id: ID;

package/dist/Conversations/Sla.js

@@ -1,6 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONVERSATION_SLA_EVENTS_COLLECTION = exports.CONVERSATION_SLA_CYCLES_COLLECTION = exports.CONVERSATION_SLA_POLICIES_COLLECTION = void 0;
-exports.CONVERSATION_SLA_POLICIES_COLLECTION = 'conversation_sla_policies';
-exports.CONVERSATION_SLA_CYCLES_COLLECTION = 'conversation_sla_cycles';
-exports.CONVERSATION_SLA_EVENTS_COLLECTION = 'conversation_sla_events';

package/dist/Conversations/SocialWalls.d.ts

@@ -1,7 +1,6 @@
 import { Channels } from "../Common/index";
 import { UserInfo } from "../Users/UserTrii";
-import { ConversationAssignmentSnapshot, ConversationCapabilitiesDto, ConversationStatus, ConversationUserRelationDto } from "./Conversation";
-import { ILabel } from "./Label";
+import { ConversationAssignmentSnapshot, IConversation, InteractionKind, ConversationUserRelationDto } from "./Conversation";
 export interface Post {
     id: string;
     spaceId: string;
@@ -30,6 +29,9 @@ export interface PostStats {
 }
 export interface WallMessage {
     id: string;
+    /** Canonical conversation owning shared read/SLA state. */
+    conversationId?: string | null;
+    conversationIncomingSequence?: number | null;
     spaceId: string;
     postId: string;
     parentId: string;
@@ -75,56 +77,12 @@ export interface ExternalUserInfo {
     name: string;
     imageUrl: string;
 }
-/**
- * Estado de una interaccion wall (post/comment/mention), equivalente a lo que para una
- * conversacion vive directo en IConversation. Post no tiene estos campos persistidos (no hay
- * assignment/sla reales para posts todavia), asi que este objeto se arma al vuelo del lado del
- * backend a partir de UserInboxItemDocument.snapshot (owner/status/queueId/unreadCount) y del
- * propio Post (participants/channelInfo/fechas).
- */
-export interface WallInteractionState {
-    id: string;
-    spaceId: string;
-    status: ConversationStatus;
-    priority: 'low' | 'normal' | 'high' | 'urgent';
-    assignment: ConversationAssignmentSnapshot;
-    sla: {
-        status: 'none' | 'running' | 'warning' | 'breached' | 'met';
-        deadlineAt?: Date;
-        policyId?: string;
-        version: number;
-    };
-    labels: ILabel[];
-    participants: UserInfo[];
-    channelInfo: Channels.IChannelInfo;
-    unreadCount: number;
-    lastActivityAt: Date;
-    createdAt: Date;
-    updatedAt: Date;
-    finalizedAt?: Date;
-}
-/**
- * DTO API - GET /Walls/{postId}/detail. Rama "wall" del sobre que en conversaciones da
- * ConversationDetailResponse. interactionKind viaja igual (wall_post/comment/mention) aunque el
- * front ya sepa que pego en el endpoint de walls, por si quiere distinguir el motivo de la fila.
- */
+/** Public content plus its canonical conversation; no independent attention lifecycle. */
 export interface WallPostDetailResponse {
-    interactionKind: 'wall_post' | 'comment' | 'mention';
+    interactionKind: InteractionKind;
     post: Post;
-    interaction: WallInteractionState;
-    /** Comentario que origino la interaccion (comment/mention). Ausente para wall_post o cuando
-     *  todavia no se implementa el tracking de comentario puntual (P1, ver discusion). */
-    focusCommentId?: string;
+    conversation: IConversation;
+    /** Navigation focus only; stable identity is conversation.wallRootCommentId. */
+    focusCommentId?: string | null;
     relation: ConversationUserRelationDto;
-    capabilities: ConversationCapabilitiesDto;
-    availableActions: string[];
-}
-/**
- * DTO API - GET /inbox/items/{id}. Resuelve deep-link (F5, link compartido) sin tener el snapshot
- * del listado: solo dice de que tipo es el id para que el front pegue en
- * /Conversations/{id}/detail o en /Walls/{postId}/detail segun corresponda.
- */
-export interface InboxItemKindDto {
-    id: string;
-    interactionKind: 'private' | 'wall_post' | 'comment' | 'mention';
 }

package/dist/Conversations/Transfer.d.ts

@@ -5,6 +5,7 @@ export type TransferConversationReason = Extract<ConversationAssignmentReason, '
 export type TransferConversationTarget = {
     type: 'queue';
     queueId: ID;
+    userId?: null;
 } | {
     type: 'user';
     queueId: ID;

package/dist/Conversations/index.d.ts

@@ -2,8 +2,10 @@ 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 './InboxQueries';
+export * from './ConversationReadState';
+export * from './ConversationPendingTransfer';
+export * from './ConversationSlaClockState';
 export * from './Outbox';
 export * from './Ending';
 export * from './Label';

package/dist/Conversations/index.js

@@ -41,8 +41,10 @@ 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("./InboxQueries"), exports);
+__exportStar(require("./ConversationReadState"), exports);
+__exportStar(require("./ConversationPendingTransfer"), exports);
+__exportStar(require("./ConversationSlaClockState"), exports);
 __exportStar(require("./Outbox"), exports);
 __exportStar(require("./Ending"), exports);
 __exportStar(require("./Label"), exports);

package/package.json

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

package/dist/Conversations/InboxMongo.d.ts

@@ -1,154 +0,0 @@
-import { ID, InboxViewId } from './Conversation';
-export declare const CONVERSATION_SUBSCRIPTIONS_COLLECTION = "conversation_subscriptions";
-export declare const USER_INBOX_ITEMS_COLLECTION = "user_inbox_items";
-export declare const USER_INBOX_COUNTERS_COLLECTION = "user_inbox_counters";
-export declare const INBOX_PROCESSOR_RECEIPTS_COLLECTION = "inbox_processor_receipts";
-/**
- * MongoDB indexes for conversation_subscriptions.
- *
- * The unique index enforces one current subscription state per
- * user/conversation. The follower index resolves the active followers that
- * InboxAudienceResolver receives as input.
- */
-export declare const CONVERSATION_SUBSCRIPTION_INDEXES: readonly [{
-    readonly name: "uq_subscription_user_conversation";
-    readonly key: {
-        readonly spaceId: 1;
-        readonly userId: 1;
-        readonly conversationId: 1;
-    };
-    readonly unique: true;
-}, {
-    readonly name: "ix_subscription_conversation_followers";
-    readonly key: {
-        readonly spaceId: 1;
-        readonly conversationId: 1;
-        readonly status: 1;
-        readonly userId: 1;
-    };
-}];
-/**
- * MongoDB indexes for user_inbox_items.
- *
- * views.viewId is the only array field in each compound index. Do not add
- * views.visibilityReasons to these indexes: MongoDB compound multikey indexes
- * must not combine multiple array paths.
- */
-export declare const USER_INBOX_ITEM_INDEXES: readonly [{
-    readonly name: "uq_inbox_item_user_conversation";
-    readonly key: {
-        readonly spaceId: 1;
-        readonly userId: 1;
-        readonly conversationId: 1;
-    };
-    readonly unique: true;
-}, {
-    readonly name: "ix_inbox_view_activity";
-    readonly key: {
-        readonly spaceId: 1;
-        readonly userId: 1;
-        readonly 'views.viewId': 1;
-        readonly pinned: -1;
-        readonly sortAt: -1;
-        readonly id: -1;
-    };
-}, {
-    readonly name: "ix_inbox_view_priority";
-    readonly key: {
-        readonly spaceId: 1;
-        readonly userId: 1;
-        readonly 'views.viewId': 1;
-        readonly pinned: -1;
-        readonly priorityScore: -1;
-        readonly sortAt: -1;
-        readonly id: -1;
-    };
-}, {
-    readonly name: "ix_inbox_view_status_activity";
-    readonly key: {
-        readonly spaceId: 1;
-        readonly userId: 1;
-        readonly 'views.viewId': 1;
-        readonly 'snapshot.status': 1;
-        readonly sortAt: -1;
-        readonly id: -1;
-    };
-}, {
-    readonly name: "ix_inbox_view_queue_activity";
-    readonly key: {
-        readonly spaceId: 1;
-        readonly userId: 1;
-        readonly 'views.viewId': 1;
-        readonly 'snapshot.queueId': 1;
-        readonly sortAt: -1;
-        readonly id: -1;
-    };
-}];
-/**
- * MongoDB indexes for user_inbox_counters.
- *
- * The unique index also serves reads for all views of a user through its
- * spaceId + userId prefix.
- */
-export declare const USER_INBOX_COUNTER_INDEXES: readonly [{
-    readonly name: "uq_inbox_counter_user_view";
-    readonly key: {
-        readonly spaceId: 1;
-        readonly userId: 1;
-        readonly viewId: 1;
-    };
-    readonly unique: true;
-}];
-/**
- * MongoDB indexes for durable processor idempotency receipts.
- */
-export declare const INBOX_PROCESSOR_RECEIPT_INDEXES: readonly [{
-    readonly name: "uq_inbox_processor_source_scope";
-    readonly key: {
-        readonly processor: 1;
-        readonly sourceEventId: 1;
-        readonly scopeKey: 1;
-    };
-    readonly unique: true;
-}];
-export type InboxPaginationSort = 'activity' | 'priority';
-/**
- * Seek-pagination cursor matching ix_inbox_view_activity.
- */
-export interface InboxActivityCursor {
-    sort: 'activity';
-    pinned: boolean;
-    sortAt: Date;
-    id: ID;
-}
-/**
- * Seek-pagination cursor matching ix_inbox_view_priority.
- */
-export interface InboxPriorityCursor {
-    sort: 'priority';
-    pinned: boolean;
-    priorityScore: number;
-    sortAt: Date;
-    id: ID;
-}
-export type InboxPaginationCursor = InboxActivityCursor | InboxPriorityCursor;
-/**
- * Query contract for one logical inbox view.
- *
- * Implementations must use seek pagination with cursor; skip pagination is not
- * compatible with frequently changing sortAt values.
- */
-interface InboxPageQueryBase {
-    spaceId: ID;
-    userId: ID;
-    viewId: InboxViewId;
-    limit: number;
-}
-export type InboxPageQuery = InboxPageQueryBase & {
-    sort: 'activity';
-    cursor?: InboxActivityCursor;
-} | InboxPageQueryBase & {
-    sort: 'priority';
-    cursor?: InboxPriorityCursor;
-};
-export {};

package/dist/Conversations/InboxMongo.js

@@ -1,128 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.INBOX_PROCESSOR_RECEIPT_INDEXES = exports.USER_INBOX_COUNTER_INDEXES = exports.USER_INBOX_ITEM_INDEXES = exports.CONVERSATION_SUBSCRIPTION_INDEXES = exports.INBOX_PROCESSOR_RECEIPTS_COLLECTION = exports.USER_INBOX_COUNTERS_COLLECTION = exports.USER_INBOX_ITEMS_COLLECTION = exports.CONVERSATION_SUBSCRIPTIONS_COLLECTION = void 0;
-exports.CONVERSATION_SUBSCRIPTIONS_COLLECTION = 'conversation_subscriptions';
-exports.USER_INBOX_ITEMS_COLLECTION = 'user_inbox_items';
-exports.USER_INBOX_COUNTERS_COLLECTION = 'user_inbox_counters';
-exports.INBOX_PROCESSOR_RECEIPTS_COLLECTION = 'inbox_processor_receipts';
-/**
- * MongoDB indexes for conversation_subscriptions.
- *
- * The unique index enforces one current subscription state per
- * user/conversation. The follower index resolves the active followers that
- * InboxAudienceResolver receives as input.
- */
-exports.CONVERSATION_SUBSCRIPTION_INDEXES = [
-    {
-        name: 'uq_subscription_user_conversation',
-        key: {
-            spaceId: 1,
-            userId: 1,
-            conversationId: 1,
-        },
-        unique: true,
-    },
-    {
-        name: 'ix_subscription_conversation_followers',
-        key: {
-            spaceId: 1,
-            conversationId: 1,
-            status: 1,
-            userId: 1,
-        },
-    },
-];
-/**
- * MongoDB indexes for user_inbox_items.
- *
- * views.viewId is the only array field in each compound index. Do not add
- * views.visibilityReasons to these indexes: MongoDB compound multikey indexes
- * must not combine multiple array paths.
- */
-exports.USER_INBOX_ITEM_INDEXES = [
-    {
-        name: 'uq_inbox_item_user_conversation',
-        key: {
-            spaceId: 1,
-            userId: 1,
-            conversationId: 1,
-        },
-        unique: true,
-    },
-    {
-        name: 'ix_inbox_view_activity',
-        key: {
-            spaceId: 1,
-            userId: 1,
-            'views.viewId': 1,
-            pinned: -1,
-            sortAt: -1,
-            id: -1,
-        },
-    },
-    {
-        name: 'ix_inbox_view_priority',
-        key: {
-            spaceId: 1,
-            userId: 1,
-            'views.viewId': 1,
-            pinned: -1,
-            priorityScore: -1,
-            sortAt: -1,
-            id: -1,
-        },
-    },
-    {
-        name: 'ix_inbox_view_status_activity',
-        key: {
-            spaceId: 1,
-            userId: 1,
-            'views.viewId': 1,
-            'snapshot.status': 1,
-            sortAt: -1,
-            id: -1,
-        },
-    },
-    {
-        name: 'ix_inbox_view_queue_activity',
-        key: {
-            spaceId: 1,
-            userId: 1,
-            'views.viewId': 1,
-            'snapshot.queueId': 1,
-            sortAt: -1,
-            id: -1,
-        },
-    },
-];
-/**
- * MongoDB indexes for user_inbox_counters.
- *
- * The unique index also serves reads for all views of a user through its
- * spaceId + userId prefix.
- */
-exports.USER_INBOX_COUNTER_INDEXES = [
-    {
-        name: 'uq_inbox_counter_user_view',
-        key: {
-            spaceId: 1,
-            userId: 1,
-            viewId: 1,
-        },
-        unique: true,
-    },
-];
-/**
- * MongoDB indexes for durable processor idempotency receipts.
- */
-exports.INBOX_PROCESSOR_RECEIPT_INDEXES = [
-    {
-        name: 'uq_inbox_processor_source_scope',
-        key: {
-            processor: 1,
-            sourceEventId: 1,
-            scopeKey: 1,
-        },
-        unique: true,
-    },
-];

package/dist/Conversations/InboxProjection.d.ts

@@ -1,162 +0,0 @@
-import { ConversationInboxSnapshot, ID, InboxViewId, UserInboxItemView } from './Conversation';
-import { ConversationQueue } from './Queue';
-import { ConversationAssignmentChanged } from './Transfer';
-export type InboxProcessorName = 'inbox-audience-resolver' | 'inbox-item-projector' | 'inbox-counter-projector';
-/**
- * Queue membership snapshot used while resolving an assignment change.
- *
- * Produced by: assignment-change consumer.
- * Consumed by: InboxAudienceResolver.
- * Used when: previous/current queue audiences must be expanded from groups
- * into concrete users without embedding membership in the integration event.
- */
-export interface QueueAudienceResolutionContext {
-    queue: ConversationQueue;
-    memberUserIds: ID[];
-    activeMemberUserIds: ID[];
-    supervisorUserIds: ID[];
-}
-/**
- * Complete input for calculating desired inbox visibility.
- *
- * Produced by: ConversationAssignmentChanged consumer.
- * Consumed by: InboxAudienceResolver.
- * Used when: an assignment/transfer changes queue, owner or status and the
- * desired per-user inbox audience must be recalculated.
- */
-export interface InboxAudienceResolverInput {
-    sourceEvent: ConversationAssignmentChanged;
-    snapshot: ConversationInboxSnapshot;
-    previousQueue?: QueueAudienceResolutionContext;
-    currentQueue?: QueueAudienceResolutionContext;
-    participantUserIds: ID[];
-    followerUserIds: ID[];
-}
-/**
- * Visibility of one conversation inside one logical inbox view.
- *
- * Produced by: InboxAudienceResolver.
- * Consumed by: inbox item projection planner/projector.
- * Used when: multiple independent reasons can preserve the same view without
- * generating duplicate inbox items or duplicate counter increments.
- */
-export type ResolvedInboxView = UserInboxItemView;
-/**
- * Desired inbox visibility for a single user after applying the source event.
- *
- * Produced by: InboxAudienceResolver.
- * Consumed by: inbox item projection planner/projector.
- * Used when: the projector compares desired visibility with the materialized
- * user_inbox_items state.
- */
-export interface ResolvedInboxUserVisibility {
-    userId: ID;
-    views: ResolvedInboxView[];
-}
-/**
- * Full audience resolution result for one conversation version.
- *
- * Produced by: InboxAudienceResolver.
- * Consumed by: inbox item projection planner/projector.
- * Used when: all affected users must be diffed against their existing
- * user_inbox_items documents.
- */
-export interface ResolvedInboxAudience {
-    sourceEventId: ID;
-    spaceId: ID;
-    conversationId: ID;
-    conversationVersion: number;
-    snapshot: ConversationInboxSnapshot;
-    users: ResolvedInboxUserVisibility[];
-    resolvedAt: Date;
-}
-/**
- * Processor boundary for pure audience calculation.
- *
- * Called by: ConversationAssignmentChanged consumer.
- * Returns to: inbox item projection planner/projector.
- */
-export interface InboxAudienceResolver {
-    resolve(input: InboxAudienceResolverInput): Promise<ResolvedInboxAudience>;
-}
-export type InboxProjectionOperation = 'insert' | 'update' | 'delete';
-/**
- * Idempotent mutation plan for one user's materialized conversation item.
- *
- * Produced by: inbox item projection planner.
- * Consumed by: inbox item projector; after persistence it is also the input
- * used to derive InboxCounterDelta messages.
- * Used when: desired audience is compared with the existing projection.
- *
- * id must be deterministic from:
- * sourceEventId + userId + conversationId.
- */
-export interface InboxProjectionDelta {
-    id: ID;
-    sourceEventId: ID;
-    spaceId: ID;
-    userId: ID;
-    conversationId: ID;
-    conversationVersion: number;
-    operation: InboxProjectionOperation;
-    previous?: ResolvedInboxUserVisibility;
-    current?: ResolvedInboxUserVisibility;
-    snapshot?: ConversationInboxSnapshot;
-    createdAt: Date;
-}
-/**
- * Atomic counter change for one user/view caused by one projection delta.
- *
- * Produced by: inbox item projector after determining the actual persisted
- * before/after state.
- * Consumed by: InboxCounterProjector.
- * Used when: view membership, requiresAction or unread state changes.
- *
- * id must be deterministic from:
- * sourceEventId + userId + conversationId + viewId.
- */
-export interface InboxCounterDelta {
-    id: ID;
-    sourceEventId: ID;
-    spaceId: ID;
-    userId: ID;
-    conversationId: ID;
-    viewId: InboxViewId;
-    conversationVersion: number;
-    totalDelta: -1 | 0 | 1;
-    requiresActionDelta: -1 | 0 | 1;
-    unreadDelta: -1 | 0 | 1;
-    createdAt: Date;
-}
-/**
- * Durable idempotency receipt for a processor side effect.
- *
- * Produced and consumed by: inbox item projector or InboxCounterProjector.
- * Used when: the same outbox event/delta is delivered more than once.
- *
- * Unique key:
- * processor + sourceEventId + scopeKey.
- *
- * scopeKey examples:
- * - item projector: userId + conversationId
- * - counter projector: userId + conversationId + viewId
- */
-export interface InboxProcessorReceipt {
-    id: ID;
-    processor: InboxProcessorName;
-    sourceEventId: ID;
-    scopeKey: string;
-    spaceId: ID;
-    conversationId: ID;
-    conversationVersion: number;
-    processedAt: Date;
-}
-/**
- * Processor boundary for applying counter deltas idempotently.
- *
- * Called by: inbox item projector.
- * Mutates: user_inbox_counters and InboxProcessorReceipt in one transaction.
- */
-export interface InboxCounterProjector {
-    apply(delta: InboxCounterDelta): Promise<void>;
-}