@trii/types 2.10.699 → 2.10.701

package/dist/src/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/src/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>;
-}

package/dist/src/Conversations/InboxProjection.js

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

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

@@ -1,24 +0,0 @@
-export declare const OUTBOX_EVENTS_COLLECTION = "outbox_events";
-export type OutboxEventStatus = 'pending' | 'publishing' | 'published' | 'failed';
-/**
- * Transactional outbox record persisted with the aggregate mutation.
- */
-export interface OutboxEvent<TPayload> {
-    id: string;
-    spaceId: string;
-    aggregateType: string;
-    aggregateId: string;
-    eventType: string;
-    schemaVersion: number;
-    payload: TPayload;
-    status: OutboxEventStatus;
-    attempts: number;
-    availableAt: Date;
-    lockedAt?: Date;
-    lockedUntil?: Date;
-    lockedBy?: string;
-    createdAt: Date;
-    lastAttemptAt?: Date;
-    publishedAt?: Date;
-    lastError?: string;
-}

package/dist/src/Conversations/Outbox.js

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

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

@@ -1,107 +0,0 @@
-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;
-    policyId?: never;
-    policyVersion?: never;
-    onTransferIn?: never;
-} | {
-    enabled: true;
-    policyId: ID;
-    policyVersion: number;
-    onTransferIn: QueueSlaTransferBehavior;
-};
-/**
- * distribution:
- *   visibility follows shared, manual_pull or exclusive routing semantics.
- * all_current:
- *   all authorized queue members can see current queue conversations.
- */
-export type QueueMemberAudienceMode = 'distribution' | 'all_current' | 'none';
-export type QueueSupervisorAudienceMode = 'all_current' | 'sla_only' | 'escalations_only' | 'none';
-export interface ConversationQueueAudienceConfig {
-    members: {
-        mode: QueueMemberAudienceMode;
-        requireActiveParticipation: boolean;
-        includeResolved: boolean;
-    };
-    supervisors: {
-        mode: QueueSupervisorAudienceMode;
-        includeResolved: boolean;
-    };
-}
-export interface ConversationQueueInfo {
-    id: ID;
-    name: string;
-    color?: string;
-    enabled: boolean;
-}
-/**
- * Conversation routing, supervision and reporting boundary.
- * Groups only provide user membership; they never own conversations.
- */
-export interface ConversationQueue {
-    id: ID;
-    spaceId: ID;
-    name: string;
-    description?: string;
-    color?: string;
-    enabled: boolean;
-    /**
-     * Higher values are evaluated first when multiple queues match.
-     */
-    priority: number;
-    memberGroupIds: ID[];
-    supervisorGroupIds: ID[];
-    routing: QueueRoutingPolicy;
-    sla: ConversationQueueSlaConfig;
-    audience: ConversationQueueAudienceConfig;
-    version: number;
-    createdAt: Date;
-    createdByUserId?: ID;
-    updatedAt: Date;
-    updatedByUserId?: ID;
-}
-/**
- * Editable Queue definition sent by clients.
- *
- * It excludes id, version and audit fields controlled by the backend. Nested
- * routing, SLA and audience objects use full-replacement semantics.
- */
-export interface ConversationQueueDefinitionInput {
-    name: string;
-    description?: string;
-    color?: string;
-    enabled: boolean;
-    priority: number;
-    memberGroupIds: ID[];
-    supervisorGroupIds: ID[];
-    routing: QueueRoutingPolicy;
-    sla: ConversationQueueSlaConfig;
-    audience: ConversationQueueAudienceConfig;
-}
-/**
- * Creates a Queue. commandId makes retries idempotent. The backend assigns
- * queue id, version and audit fields.
- */
-export interface CreateConversationQueueRequest {
-    commandId: ID;
-    spaceId: ID;
-    definition: ConversationQueueDefinitionInput;
-}
-/**
- * Replaces the editable definition of an existing Queue.
- *
- * expectedVersion is the version loaded by the client; it is not incremented
- * by the client. The backend rejects stale writes and returns the updated
- * ConversationQueue with its new version and audit fields.
- */
-export interface UpdateConversationQueueRequest {
-    commandId: ID;
-    spaceId: ID;
-    queueId: ID;
-    expectedVersion: number;
-    definition: ConversationQueueDefinitionInput;
-}

package/dist/src/Conversations/Queue.js

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

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

@@ -1,164 +0,0 @@
-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

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