@trii/types 2.10.677 → 2.10.679

package/dist/src/Conversations/InboxMongo.js

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

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

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

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

@@ -0,0 +1,10 @@
+interface ILabel {
+    id?: string | null;
+    spaceId?: string | null;
+    name?: string | null;
+    color?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+    deletedAt?: string | null;
+}
+export { ILabel };

package/dist/src/Conversations/Label.js

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

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

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

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

@@ -0,0 +1,66 @@
+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;
+}

package/dist/src/Conversations/Queue.js

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

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

@@ -0,0 +1,34 @@
+export interface IQuickResponse {
+    id: string;
+    spaceId: string;
+    categoryId: string;
+    categoryName: string;
+    title: string;
+    bodyIM: string;
+    bodyHTML: string;
+    isTemplate: boolean;
+    templateId?: string | null;
+    templateName?: string | null;
+    templateVariables: string[];
+    createdAt: Date;
+    createdBy: string;
+    updatedAt?: Date;
+    updatedBy?: string;
+    deletedAt?: Date;
+    deletedBy?: string;
+}
+export interface IQuickResponseCategory {
+    id: string;
+    spaceId: string;
+    name: string;
+    isPublic: boolean;
+    sharedGroupIds: string[];
+    sharedUserIds: string[];
+    sharedWith: string[];
+    createdAt: Date;
+    createdBy: string;
+    updatedAt?: Date;
+    updatedBy?: string;
+    deletedAt?: Date;
+    deletedBy?: string;
+}

package/dist/src/Conversations/QuickResponse.js

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

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/SocialWalls.d.ts

@@ -0,0 +1,72 @@
+import { Channels } from "../Common/index";
+import { UserInfo } from "../Users/UserTrii";
+export interface Post {
+    id: string;
+    spaceId: string;
+    externalId: string;
+    title: string;
+    details: string;
+    imageUrl: string;
+    photos: string[];
+    videos: string[];
+    reactions: string[];
+    channelInfo: Channels.IChannelInfo;
+    newMessagesCount: number;
+    postUrl?: string;
+    counters: PostStats;
+    participants: UserInfo[];
+    archived: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface PostStats {
+    likes: number;
+    comments: number;
+}
+export interface WallMessage {
+    id: string;
+    spaceId: string;
+    postId: string;
+    parentId: string;
+    readed: boolean;
+    externalUserSender?: ExternalUserInfo;
+    contactId?: string;
+    contactAddressId?: string;
+    userSender?: string;
+    message?: string;
+    imageUrl?: string;
+    videoUrl?: string;
+    reactions?: WallReaction;
+    responses?: WallMessage[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface WallReaction {
+    like: number;
+    likeUsers: ExternalUserInfo[];
+    love: number;
+    loveUsers: ExternalUserInfo[];
+    haha: number;
+    hahaUsers: ExternalUserInfo[];
+    wow: number;
+    wowUsers: ExternalUserInfo[];
+    sad: number;
+    sadUsers: ExternalUserInfo[];
+    angry: number;
+    angryUsers: ExternalUserInfo[];
+}
+export interface Response {
+    id: string;
+    external_parent_id: string;
+    externalUserSender?: ExternalUserInfo;
+    userSender?: UserInfo;
+    message: string;
+    response?: Response[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface ExternalUserInfo {
+    id: string;
+    name: string;
+    imageUrl: string;
+}

package/dist/src/Conversations/SocialWalls.js

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