@mitumba/sdk 1.31.0 → 1.32.1

package/dist/index.d.ts

@@ -24,6 +24,801 @@ declare class IDBTokenStore implements TokenStore {
 /** Creates IDBTokenStore if indexedDB is available, otherwise MemoryTokenStore. */
 declare function createTokenStore(): TokenStore;
 
+/** Stable opaque identifier for one buyer/store conversation. */
+type ConversationId = string;
+/** Stable opaque identifier for one General, Listing, or Order thread. */
+type ThreadId = string;
+/** Stable opaque identifier for one human-authored message. */
+type MessageId = string;
+/** Stable opaque identifier for a message or system event in a thread timeline. */
+type ThreadTimelineItemId = string;
+/** Opaque server-issued cursor whose contents clients must not interpret. */
+type MessagingCursor = string;
+/** Explicit identity under which an authenticated human accesses messaging resources. */
+type MessagingPerspective = {
+    /** Act as the authenticated buyer. */
+    kind: 'buyer';
+} | {
+    /** Act as an authorized representative of one store. */
+    kind: 'store';
+    /** Store represented by this request. */
+    store_id: string;
+};
+/** Versioned success envelope returned by every Messaging v2 resource operation. */
+interface ApiResponse<T> {
+    /** Public messaging API version. */
+    api_version: 2;
+    /** Typed operation result. */
+    data: T;
+}
+/** Cursor-paged resource collection. */
+interface CursorPage<T> {
+    /** Resources in server-defined deterministic order. */
+    items: T[];
+    /** Cursor for the next page, or null when no next page exists. */
+    next_cursor: MessagingCursor | null;
+    /** Whether another page exists after this page. */
+    has_more: boolean;
+}
+/** Recipient-safe buyer identity snapshot. */
+interface BuyerSummary {
+    /** Stable buyer account identifier. */
+    id: string;
+    /** Current buyer display name, when configured. */
+    display_name: string | null;
+    /** Current buyer avatar URL, when configured. */
+    avatar_url: string | null;
+}
+/** Recipient-safe store identity snapshot. */
+interface StoreSummary {
+    /** Stable store identifier. */
+    id: string;
+    /** Current store display name. */
+    name: string;
+    /** Current canonical store slug. */
+    slug: string;
+    /** Current store logo URL, when configured. */
+    logo_url: string | null;
+}
+/** Immutable thread subject snapshot for General, Listing, or Order context. */
+type ThreadSubject = {
+    /** General buyer/store conversation subject. */
+    kind: 'general';
+} | {
+    /** Listing inquiry subject. */
+    kind: 'listing';
+    /** Listing represented by this thread. */
+    listing_id: string;
+    /** Snapshotted listing title. */
+    title: string;
+    /** Snapshotted listing image URL, when available. */
+    image_url: string | null;
+    /** Current coarse listing availability. */
+    availability: 'active' | 'sold' | 'inactive' | 'unknown';
+} | {
+    /** Order support subject. */
+    kind: 'order';
+    /** Order represented by this thread. */
+    order_id: string;
+    /** Human-readable short order identifier. */
+    short_id: string;
+    /** Snapshotted listing title associated with the order. */
+    listing_title: string;
+    /** Snapshotted listing image URL, when available. */
+    image_url: string | null;
+    /** Current canonical order status. */
+    order_status: string;
+};
+/** Public message author identity without private store-operator identity. */
+type MessageAuthor = {
+    /** Message was authored from the buyer perspective. */
+    side: 'buyer';
+    /** Recipient-safe buyer identity. */
+    buyer: BuyerSummary;
+} | {
+    /** Message was authored from the store perspective. */
+    side: 'store';
+    /** Recipient-safe store identity; human operator identity is intentionally omitted. */
+    store: StoreSummary;
+};
+/** Safe attachment metadata associated with a committed message. */
+interface MessageAttachment {
+    /** Stable attachment identifier. */
+    id: string;
+    /** Attachment presentation category. */
+    kind: 'image' | 'file';
+    /** Sanitized original file name. */
+    file_name: string;
+    /** Validated media type. */
+    content_type: string;
+    /** Validated byte size. */
+    size_bytes: number;
+}
+/** Canonical immutable human-authored message. */
+interface ThreadMessage {
+    /** Stable message identifier. */
+    id: MessageId;
+    /** Thread containing this message. */
+    thread_id: ThreadId;
+    /** Monotonic order within the thread timeline. */
+    sequence: number;
+    /** Explicit public author side and identity. */
+    author: MessageAuthor;
+    /** Canonical message body after server policy processing. */
+    body: string;
+    /** Same-thread quote snapshot, or null when the message is not a reply. */
+    reply_to: {
+        /** Quoted message identifier. */
+        message_id: MessageId;
+        /** Recipient-safe author label captured for the quote. */
+        author_name: string;
+        /** Immutable safe excerpt captured for the quote. */
+        excerpt: string;
+    } | null;
+    /** Safe committed attachments; empty for text-only messages. */
+    attachments: MessageAttachment[];
+    /** Caller-owned idempotency identifier echoed for reconciliation, when supplied. */
+    client_message_id: string | null;
+    /** UTC ISO 8601 creation timestamp. */
+    created_at: string;
+}
+/** Server-authored event linking a Listing thread and its related Order thread. */
+interface ThreadSystemEvent {
+    /** Stable timeline-item identifier. */
+    id: ThreadTimelineItemId;
+    /** Thread containing this system event. */
+    thread_id: ThreadId;
+    /** Monotonic order within the thread timeline. */
+    sequence: number;
+    /** System-event discriminator. */
+    kind: 'thread.linked';
+    /** Stable identifier shared by the paired link events. */
+    relation_id: string;
+    /** Direction and correctly correlated related thread snapshot. */
+    link: {
+        /** This Listing thread links forward to an Order thread. */
+        direction: 'listing_to_order';
+        /** Related Order thread. */
+        related_thread: {
+            /** Stable related thread identifier. */
+            id: ThreadId;
+            /** Related thread kind. */
+            kind: 'order';
+            /** Correlated Order subject snapshot. */
+            subject: Extract<ThreadSubject, {
+                kind: 'order';
+            }>;
+        };
+    } | {
+        /** This Order thread links back to a Listing thread. */
+        direction: 'order_to_listing';
+        /** Related Listing thread. */
+        related_thread: {
+            /** Stable related thread identifier. */
+            id: ThreadId;
+            /** Related thread kind. */
+            kind: 'listing';
+            /** Correlated Listing subject snapshot. */
+            subject: Extract<ThreadSubject, {
+                kind: 'listing';
+            }>;
+        };
+    };
+    /** Recipient-facing event label. */
+    label: string;
+    /** Perspectives for which this event contributes to unread state. */
+    notify_sides: Array<'buyer' | 'store'>;
+    /** UTC ISO 8601 creation timestamp. */
+    created_at: string;
+}
+/** Ordered item in a thread timeline. */
+type ThreadTimelineItem = {
+    /** Human-message timeline item. */
+    kind: 'message';
+    /** Canonical message. */
+    message: ThreadMessage;
+} | {
+    /** Server system-event timeline item. */
+    kind: 'system';
+    /** Canonical system event. */
+    event: ThreadSystemEvent;
+};
+/** Shared support lifecycle for Listing and Order threads. */
+type ThreadStatus = 'open' | 'resolved';
+/** Perspective-private presentation preferences for one thread. */
+interface ThreadPreferences {
+    /** Whether the current perspective archived this thread. */
+    archived: boolean;
+    /** Whether the current perspective pinned this thread. */
+    pinned: boolean;
+    /** Whether the current perspective muted this thread. */
+    muted: boolean;
+}
+/** Perspective-private presentation preferences for one conversation. */
+interface ConversationPreferences {
+    /** Whether the current perspective archived this conversation. */
+    archived: boolean;
+    /** Whether the current perspective muted this conversation. */
+    muted: boolean;
+}
+type ThreadCardBase = {
+    /** Stable thread identifier. */
+    id: ThreadId;
+    /** Stable parent conversation identifier. */
+    conversation_id: ConversationId;
+    /** Shared support status, independent of commerce status. */
+    status: ThreadStatus;
+    /** Private preferences for the selected perspective. */
+    preferences: ThreadPreferences;
+    /** Latest human-authored message, or null before the first message. */
+    last_message: ThreadMessage | null;
+    /** Exact unread timeline-item count for the selected perspective. */
+    unread_count: number;
+    /** UTC ISO 8601 timestamp of latest thread activity. */
+    last_activity_at: string;
+    /** UTC ISO 8601 creation timestamp. */
+    created_at: string;
+    /** UTC ISO 8601 last-update timestamp. */
+    updated_at: string;
+};
+/** Thread-card summary with kind and subject correlated at compile time. */
+type ThreadCard = (ThreadCardBase & {
+    /** General thread card. */
+    kind: 'general';
+    /** Correlated General subject. */
+    subject: Extract<ThreadSubject, {
+        kind: 'general';
+    }>;
+}) | (ThreadCardBase & {
+    /** Listing inquiry thread card. */
+    kind: 'listing';
+    /** Correlated Listing subject. */
+    subject: Extract<ThreadSubject, {
+        kind: 'listing';
+    }>;
+}) | (ThreadCardBase & {
+    /** Order support thread card. */
+    kind: 'order';
+    /** Correlated Order subject. */
+    subject: Extract<ThreadSubject, {
+        kind: 'order';
+    }>;
+});
+/** Buyer/store conversation summary containing no loose messages. */
+interface ConversationSummary {
+    /** Stable all-time buyer/store conversation identifier. */
+    id: ConversationId;
+    /** Buyer in this relationship. */
+    buyer: BuyerSummary;
+    /** Store in this relationship. */
+    store: StoreSummary;
+    /** Most recently active thread, or null when no thread has activity. */
+    last_thread: ThreadCard | null;
+    /** Exact aggregate unread count for the selected perspective. */
+    unread_count: number;
+    /** UTC ISO 8601 timestamp of latest child-thread activity. */
+    last_activity_at: string;
+    /** Private preferences for the selected perspective. */
+    preferences: ConversationPreferences;
+    /** UTC ISO 8601 creation timestamp. */
+    created_at: string;
+    /** UTC ISO 8601 last-update timestamp. */
+    updated_at: string;
+}
+/** Idempotent conversation/thread resolution result. */
+interface ResolveThreadResult {
+    /** Resolved all-time buyer/store conversation. */
+    conversation: ConversationSummary;
+    /** Resolved singleton context thread. */
+    thread: ThreadCard;
+    /** Whether either resource was created by this resolution. */
+    created: {
+        /** Whether the conversation was created. */
+        conversation: boolean;
+        /** Whether the thread was created. */
+        thread: boolean;
+    };
+}
+/** Newest, older, or catch-up window of ascending thread timeline items. */
+interface MessagePage {
+    /** Timeline items ordered by ascending sequence. */
+    items: ThreadTimelineItem[];
+    /** Cursor for older history, or null at the beginning. */
+    older_cursor: MessagingCursor | null;
+    /** Cursor for newer catch-up, or null at the live edge. */
+    newer_cursor: MessagingCursor | null;
+    /** Whether older history exists. */
+    has_older: boolean;
+    /** Whether newer history exists. */
+    has_newer: boolean;
+}
+/** Authoritative monotonic read-cursor result. */
+interface ReadCursorResult {
+    /** Thread whose cursor was evaluated. */
+    thread_id: ThreadId;
+    /** Last committed visible message or system-event identifier. */
+    last_read_item_id: ThreadTimelineItemId;
+    /** Monotonic sequence of the last read item. */
+    last_read_sequence: number;
+    /** Whether this request advanced the cursor. */
+    changed: boolean;
+    /** UTC ISO 8601 cursor-update timestamp. */
+    updated_at: string;
+}
+/** Buyer-authorized input for idempotent thread resolution. */
+type BuyerResolveThreadInput = {
+    /** Resolve the General thread for a store. */
+    kind: 'general';
+    /** Store to contact. */
+    store_id: string;
+} | {
+    /** Resolve a Listing inquiry thread. */
+    kind: 'listing';
+    /** Store owning the listing. */
+    store_id: string;
+    /** Listing to ask about. */
+    listing_id: string;
+} | {
+    /** Resolve an Order support thread. */
+    kind: 'order';
+    /** Authorized buyer order. */
+    order_id: string;
+};
+/** Store-authorized input for idempotent thread resolution. */
+type StoreResolveThreadInput = {
+    /** Resolve an entitled existing General relationship. */
+    kind: 'general';
+    /** Buyer in the entitled relationship. */
+    buyer_id: string;
+} | {
+    /** Resolve an Order support thread. */
+    kind: 'order';
+    /** Authorized store order. */
+    order_id: string;
+};
+/** Cursor inputs for newest, older, or catch-up message windows. */
+type ListThreadMessagesParams = {
+    /** Older-history cursor. */
+    before?: MessagingCursor;
+    /** Catch-up cursor is mutually exclusive with before. */
+    after?: never;
+    /** Requested page size. */
+    limit?: number;
+} | {
+    /** Catch-up cursor. */
+    after?: MessagingCursor;
+    /** Older-history cursor is mutually exclusive with after. */
+    before?: never;
+    /** Requested page size. */
+    limit?: number;
+};
+/** Caller-owned, idempotent input for one human-authored message. */
+interface SendThreadMessageInput {
+    /**
+     * Stable caller-generated identifier reused for every retry.
+     *
+     * The runtime method maps this value to the `Idempotency-Key` header, omits it from the JSON
+     * body, and never generates a replacement key during retry.
+     */
+    client_message_id: string;
+    /** Required trimmed body of 1–2,000 characters. */
+    body: string;
+    /** Same-thread quoted message; omit rather than send null when absent. */
+    reply_to_message_id?: MessageId;
+    /** Safe staged attachment identifiers; empty or omitted for text-only sends. */
+    attachment_ids?: string[];
+}
+/** Canonical result of an accepted or deduplicated send. */
+interface SendThreadMessageResult {
+    /** Canonical committed message. */
+    message: ThreadMessage;
+    /** Whether this response replayed an earlier accepted request. */
+    deduplicated: boolean;
+    /** Server policy processing applied to the submitted body. */
+    policy: {
+        /** Whether policy processing changed the body. */
+        body_modified: boolean;
+        /** Recipient-safe policy notices. */
+        notices: string[];
+    };
+}
+/** Lifecycle state of one staged attachment upload. */
+type AttachmentUploadState = 'authorized' | 'uploaded' | 'pending_scan' | 'safe' | 'rejected' | 'expired' | 'claimed';
+/** Server capability declaration for the staged Messaging v2 rollout. */
+interface MessagingCapabilities {
+    /** Public resource schema version. */
+    api_version: 2;
+    /** Realtime protocol versions understood by this deployment. */
+    protocol_versions: number[];
+    /** Whether the Messaging v2 HTTP resource surface is enabled. */
+    http: {
+        enabled: boolean;
+    };
+    /** Whether legacy writes are mirrored into Messaging v2. */
+    dual_write: {
+        enabled: boolean;
+    };
+    /** Whether migration shadow reads are enabled. */
+    shadow_read: {
+        enabled: boolean;
+    };
+    /** Whether clients must address a stable Messaging v2 thread. */
+    require_thread: {
+        enabled: boolean;
+    };
+    /** Managed realtime capability and supported wire versions. */
+    realtime: {
+        /** Whether clients may establish managed realtime connections. */
+        enabled: boolean;
+        /** Realtime protocol versions currently available. */
+        protocol_versions: number[];
+    };
+    /** Optional attachment capability. */
+    attachments: {
+        /** Whether clients may expose attachment controls. */
+        enabled: boolean;
+        /** Maximum accepted upload size. */
+        max_size_bytes: number;
+        /** Allowed upload media types. */
+        allowed_content_types: string[];
+    };
+}
+/** Short-lived authorization for one private staged attachment upload. */
+interface AttachmentUploadAuthorization {
+    /** Stable upload identifier. */
+    id: string;
+    /** Thread for which the upload was authorized. */
+    thread_id: ThreadId;
+    /** Initial upload state. */
+    state: 'authorized';
+    /** Absolute short-lived upload URL. */
+    upload_url: string;
+    /** One-use upload ticket that is not an access token. */
+    upload_ticket: string;
+    /** UTC ISO 8601 authorization expiry. */
+    expires_at: string;
+    /** Server-accepted upload constraints. */
+    accepted: {
+        /** Accepted media type. */
+        content_type: string;
+        /** Accepted byte size. */
+        size_bytes: number;
+        /** Accepted SHA-256 digest. */
+        sha256: string;
+    };
+}
+/** Current status of one private staged attachment upload. */
+interface AttachmentUploadStatus {
+    /** Stable upload identifier. */
+    id: string;
+    /** Thread for which the upload was authorized. */
+    thread_id: ThreadId;
+    /** Current upload lifecycle state. */
+    state: AttachmentUploadState;
+    /** UTC ISO 8601 upload expiry. */
+    expires_at: string;
+    /** Safe rejection code, or null when not rejected. */
+    rejection_code: string | null;
+    /** Committed safe attachment, or null until available. */
+    attachment: MessageAttachment | null;
+}
+/** Read-only summary of exact-participant history that cannot be assigned to a store. */
+interface LegacyMessageArchiveSummary {
+    /** Stable legacy archive identifier. */
+    id: string;
+    /** Other original participant. */
+    other_user: BuyerSummary;
+    /** Latest historic message body. */
+    last_message_body: string;
+    /** UTC ISO 8601 timestamp of the latest historic message. */
+    last_message_at: string;
+}
+/** Read-only historic message that cannot be assigned to a store conversation. */
+interface LegacyMessageRecord {
+    /** Stable legacy message identifier. */
+    id: string;
+    /** Original sender. */
+    sender: BuyerSummary;
+    /** Historic message body. */
+    body: string;
+    /** UTC ISO 8601 creation timestamp. */
+    created_at: string;
+}
+/** Safe result of resolving a temporary Buyer legacy navigation link. */
+type LegacyLinkResolution = {
+    /** Legacy link resolved to canonical v2 resources. */
+    result: 'resolved';
+    /** Canonical conversation identifier. */
+    conversation_id: ConversationId;
+    /** Canonical thread identifier. */
+    thread_id: ThreadId;
+} | {
+    /** Several stores match and the buyer must choose explicitly. */
+    result: 'choose_store';
+    /** Safe candidate stores. */
+    stores: StoreSummary[];
+} | {
+    /** Link targets exact-participant read-only legacy history. */
+    result: 'legacy_archive';
+    /** Canonical legacy archive identifier. */
+    legacy_thread_id: string;
+} | {
+    /** Link is invalid, forbidden, or cannot be resolved safely. */
+    result: 'unavailable';
+};
+declare const MESSAGING_ERROR_CODES: readonly ["invalid_input", "unauthorized", "session_expired", "forbidden", "conversation_not_found", "thread_not_found", "message_not_found", "timeline_item_not_found", "context_mismatch", "idempotency_conflict", "cursor_invalid", "cursor_expired", "attachment_not_ready", "blocked", "legacy_context_required", "client_upgrade_required", "rate_limited", "temporarily_unavailable", "internal_error", "invalid_response", "network_error"];
+/** Closed messaging-specific API error code vocabulary. */
+type MessagingErrorCode = typeof MESSAGING_ERROR_CODES[number];
+type MessagingAPIError = APIError & {
+    code: MessagingErrorCode;
+};
+/**
+ * Narrow an unknown value to an API error carrying a recognized messaging code.
+ *
+ * @param value - Unknown caught value
+ * @returns Whether the value is a messaging API error
+ */
+declare function isMessagingAPIError(value: unknown): value is MessagingAPIError;
+/**
+ * Narrow an unknown value to an API error carrying one expected messaging code.
+ *
+ * @param value - Unknown caught value
+ * @param code - Expected messaging error code
+ * @returns Whether the value carries the expected code
+ */
+declare function isMessagingAPIError<Code extends MessagingErrorCode>(value: unknown, code: Code): value is APIError & {
+    code: Code;
+};
+/** Error raised when a Messaging realtime frame or protocol contract is invalid. */
+declare class RealtimeProtocolError extends Error {
+    /** Construct a stable protocol failure without echoing an untrusted frame. */
+    constructor();
+}
+/** Error raised when the current runtime has no supported WebSocket implementation. */
+declare class RealtimeUnavailableError extends Error {
+    /** Construct a stable runtime-unavailable failure. */
+    constructor();
+}
+/** Cursor parameters for conversation collections. */
+interface ListConversationsParams {
+    /** Opaque next-page cursor. */
+    cursor?: MessagingCursor;
+    /** Page size from 1 through 100. */
+    limit?: number;
+}
+/** Cursor and filter parameters for thread-card collections. */
+interface ListThreadsParams extends ListConversationsParams {
+    /** Include threads archived by the selected perspective. */
+    include_archived?: boolean;
+    /** Optional shared support-status filter. */
+    status?: 'open' | 'resolved';
+}
+/** Thread preference patch for one perspective. */
+interface UpdateThreadPreferencesInput {
+    /** Archive or restore the thread for this perspective. */
+    archived?: boolean;
+    /** Pin or unpin the thread for this perspective. */
+    pinned?: boolean;
+    /** Mute or unmute the thread for this perspective. */
+    muted?: boolean;
+}
+/** Conversation preference patch for one perspective. */
+interface UpdateConversationPreferencesInput {
+    /** Archive or restore the conversation for this perspective. */
+    archived?: boolean;
+    /** Mute or unmute the conversation for this perspective. */
+    muted?: boolean;
+}
+/** Request options for an idempotent operation. */
+interface MessagingIdempotentRequestOptions {
+    /** Stable key reused for an exact retry. */
+    idempotencyKey: string;
+    /** Optional cancellation signal. */
+    signal?: AbortSignal;
+    /** Additional non-authorization headers. */
+    headers?: Record<string, string>;
+}
+/** Metadata used to authorize one private attachment upload. */
+interface CreateAttachmentUploadInput {
+    /** Sanitized display file name. */
+    file_name: string;
+    /** Lowercase allowlisted media type. */
+    content_type: string;
+    /** Exact byte length. */
+    size_bytes: number;
+    /** Lowercase hexadecimal SHA-256 digest. */
+    sha256: string;
+}
+/** Portable in-memory body accepted by attachment upload. */
+type AttachmentUploadBody = Blob | ArrayBuffer | ArrayBufferView;
+/** Short-lived mediated attachment download. */
+interface AttachmentDownloadAuthorization {
+    /** Absolute application download URL containing a short-lived ticket. */
+    url: string;
+    /** UTC ISO 8601 ticket expiry. */
+    expires_at: string;
+}
+/** Buyer and currently represented store inboxes. */
+interface MessagingInboxes {
+    /** Personal buyer perspective. */
+    buyer: {
+        kind: 'buyer';
+        buyer: BuyerSummary;
+    };
+    /** Authorized store perspectives. */
+    stores: Array<{
+        kind: 'store';
+        store: StoreSummary;
+    }>;
+}
+/** One-use realtime bootstrap ticket. */
+interface MessagesRealtimeTicket {
+    /** Opaque ticket; never persist or log it. */
+    ticket: string;
+    /** UTC ISO 8601 ticket expiry. */
+    expires_at: string;
+    /** Absolute ticket-only WebSocket URL. */
+    websocket_url: string;
+    /** Required negotiated subprotocol. */
+    websocket_protocol: 'mitumba-messaging-v1';
+    /** Realtime protocol version. */
+    protocol_version: 1;
+    /** Requested resume cursor, or null for a fresh connection. */
+    resume_cursor: MessagingCursor | null;
+}
+/** Minimal event delivered by an isomorphic WebSocket transport. */
+interface WebSocketMessageEventLike {
+    /** Untrusted frame data parsed by the SDK before exposure. */
+    data: unknown;
+}
+/** Minimal close event delivered by an isomorphic WebSocket transport. */
+interface WebSocketCloseEventLike {
+    /** WebSocket close code. */
+    code: number;
+    /** Safe close reason. */
+    reason?: string;
+    /** Whether the transport observed a clean close. */
+    wasClean?: boolean;
+}
+/** Minimal WebSocket contract supported in Browser, Node, Edge, and Worker runtimes. */
+interface WebSocketLike {
+    /** Connecting ready state. */
+    readonly CONNECTING?: number;
+    /** Open ready state. */
+    readonly OPEN?: number;
+    /** Current ready state. */
+    readonly readyState: number;
+    /** Send one client frame. */
+    send(data: string): void;
+    /** Close this transport. */
+    close(code?: number, reason?: string): void;
+    /** Register a transport listener. */
+    addEventListener(type: 'open', listener: () => void): void;
+    addEventListener(type: 'message', listener: (event: WebSocketMessageEventLike) => void): void;
+    addEventListener(type: 'close', listener: (event: WebSocketCloseEventLike) => void): void;
+    addEventListener(type: 'error', listener: (event: unknown) => void): void;
+    /** Remove a transport listener. */
+    removeEventListener(type: 'open', listener: () => void): void;
+    removeEventListener(type: 'message', listener: (event: WebSocketMessageEventLike) => void): void;
+    removeEventListener(type: 'close', listener: (event: WebSocketCloseEventLike) => void): void;
+    removeEventListener(type: 'error', listener: (event: unknown) => void): void;
+}
+/** Injectable WebSocket constructor for isomorphic runtimes. */
+type WebSocketFactory = (url: string, protocols: string | string[]) => WebSocketLike;
+/** Managed realtime lifecycle state. */
+type MessagesRealtimeState = 'connecting' | 'open' | 'reconnecting' | 'closed' | 'failed';
+/** Durable realtime envelope shared by all resumable events. */
+interface MessagesRealtimeEnvelope<Type extends string, Payload> {
+    /** Public resource schema version. */
+    api_version: 2;
+    /** Wire protocol version. */
+    protocol_version: 1;
+    /** Stable event identifier used for deduplication. */
+    event_id: string;
+    /** Opaque audience resume cursor. */
+    resume_cursor: MessagingCursor;
+    /** Event discriminator. */
+    type: Type;
+    /** UTC ISO 8601 occurrence timestamp. */
+    occurred_at: string;
+    /** Related conversation when applicable. */
+    conversation_id?: ConversationId;
+    /** Related thread when applicable. */
+    thread_id?: ThreadId;
+    /** Event payload validated before exposure. */
+    payload: Payload;
+}
+/** Validated managed Messaging realtime event. */
+type MessagesRealtimeEvent = MessagesRealtimeEnvelope<'message.created', {
+    message: ThreadMessage;
+}> | MessagesRealtimeEnvelope<'system_event.created', {
+    event: ThreadSystemEvent;
+}> | MessagesRealtimeEnvelope<'conversation.updated', {
+    conversation: ConversationSummary;
+}> | MessagesRealtimeEnvelope<'thread.created', {
+    thread: ThreadCard;
+}> | MessagesRealtimeEnvelope<'thread.updated', {
+    thread: ThreadCard;
+}> | MessagesRealtimeEnvelope<'read_cursor.updated', {
+    cursor: ReadCursorResult;
+}> | MessagesRealtimeEnvelope<'attachment.updated', {
+    upload: AttachmentUploadStatus;
+}> | MessagesRealtimeEnvelope<'message.policy_applied', {
+    message_id: MessageId;
+    notices: string[];
+}> | {
+    /** Resource schema version. */
+    api_version: 2;
+    /** Wire protocol version. */
+    protocol_version: 1;
+    /** Ephemeral event discriminator. */
+    type: 'typing.updated';
+    /** Thread scoped by this typing state. */
+    thread_id: ThreadId;
+    /** Validated public author. */
+    author: MessageAuthor;
+    /** Current typing state. */
+    is_typing: boolean;
+    /** UTC ISO 8601 occurrence timestamp. */
+    occurred_at: string;
+} | {
+    /** Resource schema version. */
+    api_version: 2;
+    /** Wire protocol version. */
+    protocol_version: 1;
+    /** Authoritative rebuild signal. */
+    type: 'resync.required';
+    /** Safe reason for rebuilding HTTP state. */
+    reason: 'cursor_expired' | 'gap_detected' | 'authorization_changed';
+    /** Resume cursor after the authoritative rebuild. */
+    resume_cursor: MessagingCursor;
+};
+/** Options for an inert or immediately started managed realtime connection. */
+interface MessagesRealtimeOptions {
+    /** Buyer or authorized-store audience. */
+    perspective: MessagingPerspective;
+    /** Last acknowledged cursor, or null for a fresh connection. */
+    resumeCursor?: MessagingCursor | null;
+    /** Optional cancellation signal for ticket requests. */
+    signal?: AbortSignal;
+    /** Initial reconnect delay in milliseconds. */
+    reconnectBaseDelayMs?: number;
+    /** Maximum reconnect delay in milliseconds. */
+    reconnectMaxDelayMs?: number;
+    /** Injected randomness for deterministic tests. */
+    random?: () => number;
+}
+/** Managed, resumable messaging connection. */
+interface MessagesRealtimeConnection {
+    /** Current connection lifecycle state. */
+    readonly state: MessagesRealtimeState;
+    /** Last acknowledged durable cursor. */
+    readonly resumeCursor: MessagingCursor | null;
+    /** Start the inert connection. Repeated calls are safe. */
+    start(): Promise<void>;
+    /** Permanently close and release sockets, timers, and listeners. */
+    close(): void;
+    /** Subscribe to validated messaging events. */
+    onEvent(listener: (event: MessagesRealtimeEvent) => void | Promise<void>): () => void;
+    /** Subscribe to lifecycle changes. */
+    onStateChange(listener: (state: MessagesRealtimeState) => void): () => void;
+    /** Select a thread for message and typing delivery. */
+    subscribeThread(threadId: ThreadId): void;
+    /** Stop local delivery for one selected thread. */
+    unsubscribeThread(threadId: ThreadId): void;
+    /** Publish thread-scoped ephemeral typing state. */
+    setTyping(threadId: ThreadId, isTyping: boolean): void;
+}
+/** Older-history page for one read-only legacy archive. */
+interface LegacyMessagePage {
+    /** Historic messages in ascending display order. */
+    items: LegacyMessageRecord[];
+    /** Cursor for older history, or null at the beginning. */
+    older_cursor: MessagingCursor | null;
+    /** Whether older history remains. */
+    has_older: boolean;
+}
+
 interface BlockedIp {
     ip: string;
     reason: string;
@@ -988,6 +1783,7 @@ interface VaziFeedResponse {
     offset: number;
 }
 
+/** @deprecated Use ConversationSummary from Messaging v2. */
 interface Conversation {
     partner_id: string;
     partner_name: string;
@@ -999,6 +1795,7 @@ interface Conversation {
     listing_title?: string | null;
     unread_count: number;
 }
+/** @deprecated Use ThreadMessage from Messaging v2. */
 interface Message {
     id: string;
     sender_id: string;
@@ -1011,6 +1808,7 @@ interface Message {
     read_at: string | null;
     created_at: string;
 }
+/** @deprecated Resolve a thread and use SendThreadMessageInput. Context fields are server-validated hints. */
 interface SendMessageInput {
     receiver_id: string;
     body: string;
@@ -1019,6 +1817,7 @@ interface SendMessageInput {
     order_id?: string;
     from_store?: boolean;
 }
+/** @deprecated Use validated managed Messaging realtime events. */
 interface InboxRealtimeEvent {
     type: 'message';
     conversation_key: string;
@@ -1029,6 +1828,40 @@ interface InboxRealtimeEvent {
     created_at: string;
     unread_count?: number;
 }
+/** Recipient-safe reason for a message or conversation report. */
+type MessageReportReason = 'off_platform_payment' | 'contact_sharing' | 'spam' | 'scam' | 'harassment' | 'counterfeit' | 'offensive' | 'other';
+/** Typed report input for a message or buyer/store conversation. */
+type CreateMessageReportInput = {
+    subject_kind: 'message';
+    message_id: string;
+    reason: MessageReportReason;
+    detail?: string;
+} | {
+    subject_kind: 'conversation';
+    partner_id: string;
+    store_id: string;
+    reason: MessageReportReason;
+    detail?: string;
+};
+/** Idempotent open-report result. */
+interface CreateMessageReportResult {
+    id: string;
+    status: 'open';
+    deduplicated: boolean;
+}
+/** Context used to block one buyer/store relationship. */
+interface CreateMessageBlockInput {
+    partner_id: string;
+    store_id: string;
+    from_store?: boolean;
+    reason?: string;
+}
+/** Idempotent active-block result. */
+interface CreateMessageBlockResult {
+    id: string;
+    active: true;
+    deduplicated: boolean;
+}
 
 type NotificationType = 'order' | 'message' | 'price_drop' | 'offer' | 'payout' | 'system';
 interface Notification {
@@ -1402,6 +2235,10 @@ interface MitumbaClientConfig {
      * needs to re-authenticate. Only fires when session is truly dead.
      */
     onAuthExpired?: () => void;
+    /**
+     * Optional isomorphic WebSocket factory. Defaults to globalThis.WebSocket when available.
+     */
+    webSocketFactory?: WebSocketFactory;
     /**
      * Custom token store for persisting tokens. Defaults to IndexedDB in browsers,
      * in-memory elsewhere. Pass your own implementation for custom persistence.
@@ -1455,6 +2292,8 @@ declare class APIClient {
     }): Promise<void>;
     getToken(): string | undefined;
     getBaseUrl(): string;
+    /** Create an isomorphic WebSocket using the configured or global transport. */
+    createWebSocket(url: string, protocols: string | string[]): WebSocketLike;
     clearToken(): Promise<void>;
     /**
      * Check if user has a stored session (access or refresh token available).
@@ -1464,7 +2303,7 @@ declare class APIClient {
      * Hydrate tokens from the store into memory (call on app boot).
      */
     hydrate(): Promise<void>;
-    private ensureFreshToken;
+    ensureFreshToken(options?: RequestOptions): Promise<void>;
     private request;
     private handleTokenRefresh;
     get<T>(path: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<T>;
@@ -1906,40 +2745,90 @@ declare class VaziModule {
 declare class MessagesModule {
     private readonly client;
     constructor(client: APIClient);
-    /**
-     * List all conversations for the authenticated user.
-     */
+    /** @deprecated Use listConversations or listStoreConversations. Context fields are non-authoritative server-validated hints. */
     list(storeId?: string, options?: RequestOptions): Promise<{
         data: Conversation[];
     }>;
-    /**
-     * Get the message thread with a specific partner.
-     */
+    /** @deprecated Resolve a v2 thread and call listThreadMessages. */
     getThread(partnerId: string, storeId?: string, options?: RequestOptions): Promise<{
         data: Message[];
     }>;
-    /**
-     * Send a message to another user.
-     */
+    /** @deprecated Use sendThreadMessage. Receiver and context fields are hints validated by the server. */
     send(input: SendMessageInput, options?: RequestOptions): Promise<{
         id: string;
     }>;
-    /**
-     * Mark all messages from a partner as read.
-     */
+    /** @deprecated Use advanceThreadReadCursor for precise monotonic state. */
     markRead(partnerId: string, storeId?: string, options?: RequestOptions): Promise<{
         ok: true;
     }>;
-    /**
-     * Connect to the typing indicator WebSocket for a conversation.
-     * Token is passed via query param since WebSocket can't set headers.
-     */
+    /** @deprecated Use managed messaging realtime. */
     connectTyping(partnerId: string): WebSocket;
-    /**
-     * Connect to the user-scoped inbox WebSocket.
-     * Emits InboxRealtimeEvent for every inbound message across all conversations.
-     */
+    /** @deprecated Use managed messaging realtime. */
     connectInbox(): WebSocket;
+    /** Create a legacy inbox socket only after hydrating/refreshing the access token. */
+    connectInboxFresh(options?: RequestOptions): Promise<WebSocketLike>;
+    /** Create a report for a message or conversation. */
+    createReport(input: CreateMessageReportInput, options?: RequestOptions): Promise<CreateMessageReportResult>;
+    /** Create an idempotent bilateral buyer/store relationship block. */
+    createBlock(input: CreateMessageBlockInput, options?: RequestOptions): Promise<CreateMessageBlockResult>;
+    /** Remove a block created by the current perspective. */
+    removeBlock(blockId: string, options?: RequestOptions): Promise<{
+        ok: true;
+        active: false;
+    }>;
+    /** Discover server messaging capabilities. */
+    getMessagingCapabilities(options?: RequestOptions): Promise<MessagingCapabilities>;
+    /** List buyer and represented-store inbox perspectives. */
+    listMessagingInboxes(options?: RequestOptions): Promise<MessagingInboxes>;
+    /** List personal buyer conversations. */
+    listConversations(params?: ListConversationsParams, options?: RequestOptions): Promise<CursorPage<ConversationSummary>>;
+    /** List conversations for one represented store. */
+    listStoreConversations(storeId: string, params?: ListConversationsParams, options?: RequestOptions): Promise<CursorPage<ConversationSummary>>;
+    /** Get one authorized buyer/store conversation. */
+    getConversation(perspective: MessagingPerspective, conversationId: string, options?: RequestOptions): Promise<ConversationSummary>;
+    /** Resolve a General, Listing, or Order thread idempotently. */
+    resolveThread(perspective: MessagingPerspective, input: BuyerResolveThreadInput | StoreResolveThreadInput, options: MessagingIdempotentRequestOptions): Promise<ResolveThreadResult>;
+    /** List contextual thread cards for one conversation. */
+    listThreads(perspective: MessagingPerspective, conversationId: string, params?: ListThreadsParams, options?: RequestOptions): Promise<CursorPage<ThreadCard>>;
+    /** Get one contextual thread card and its conversation. */
+    getConversationThread(perspective: MessagingPerspective, threadId: ThreadId, options?: RequestOptions): Promise<{
+        conversation: ConversationSummary;
+        thread: ThreadCard;
+    }>;
+    /** Update shared support status for a Listing or Order thread. */
+    updateThreadStatus(perspective: MessagingPerspective, threadId: ThreadId, status: 'open' | 'resolved', options?: RequestOptions): Promise<ThreadCard>;
+    /** Update perspective-private thread preferences. */
+    updateThreadPreferences(perspective: MessagingPerspective, threadId: ThreadId, preferences: UpdateThreadPreferencesInput, options?: RequestOptions): Promise<ThreadCard>;
+    /** Update perspective-private conversation preferences. */
+    updateConversationPreferences(perspective: MessagingPerspective, conversationId: string, preferences: UpdateConversationPreferencesInput, options?: RequestOptions): Promise<ConversationSummary>;
+    /** List the newest, older, or catch-up timeline window for one thread. */
+    listThreadMessages(perspective: MessagingPerspective, threadId: ThreadId, params?: ListThreadMessagesParams, options?: RequestOptions): Promise<MessagePage>;
+    /** Send one idempotent message without ever replacing the caller-owned ID. */
+    sendThreadMessage(perspective: MessagingPerspective, threadId: ThreadId, input: SendThreadMessageInput, options?: RequestOptions): Promise<SendThreadMessageResult>;
+    /** Advance the selected perspective read cursor to one visible timeline item. */
+    advanceThreadReadCursor(perspective: MessagingPerspective, threadId: ThreadId, timelineItemId: string, options?: RequestOptions): Promise<ReadCursorResult>;
+    /** List read-only exact-participant legacy archives. */
+    listLegacyMessageArchives(params?: ListConversationsParams, options?: RequestOptions): Promise<CursorPage<LegacyMessageArchiveSummary>>;
+    /** List messages in one read-only legacy archive. */
+    listLegacyMessages(legacyThreadId: string, params?: ListThreadMessagesParams, options?: RequestOptions): Promise<LegacyMessagePage>;
+    /** Resolve a temporary partner/order link without guessing between stores. */
+    resolveLegacyLink(input: {
+        partner_id: string;
+        store_id: string | null;
+        order_id: string | null;
+    }, options?: RequestOptions): Promise<LegacyLinkResolution>;
+    /** Authorize a private attachment upload for one thread. */
+    createThreadAttachmentUpload(perspective: MessagingPerspective, threadId: ThreadId, input: CreateAttachmentUploadInput, options?: RequestOptions): Promise<AttachmentUploadAuthorization>;
+    /** Upload exact bytes through a one-use application ticket. */
+    uploadThreadAttachment(authorization: AttachmentUploadAuthorization, body: AttachmentUploadBody, options?: RequestOptions): Promise<AttachmentUploadStatus>;
+    /** Get current status for an upload created by the same perspective. */
+    getThreadAttachmentUpload(perspective: MessagingPerspective, threadId: ThreadId, uploadId: string, options?: RequestOptions): Promise<AttachmentUploadStatus>;
+    /** Create a short-lived mediated download for one committed attachment. */
+    createThreadAttachmentDownload(perspective: MessagingPerspective, threadId: ThreadId, attachmentId: string, options?: RequestOptions): Promise<AttachmentDownloadAuthorization>;
+    /** Create an inert managed realtime connection. Register listeners before start(). */
+    createMessagesRealtimeConnection(options: MessagesRealtimeOptions): MessagesRealtimeConnection;
+    /** Create and start a managed realtime connection. */
+    connectMessagesRealtime(options: MessagesRealtimeOptions): Promise<MessagesRealtimeConnection>;
 }
 
 declare class NotificationsModule {
@@ -2757,4 +3646,4 @@ declare class MitumbaClient {
     isAuthenticated(): Promise<boolean>;
 }
 
-export { APIClient, APIError, type APIErrorResponse, type Add2FAMethodInput, type Add2FAMethodResult, type AddAddressInput, type AddDepotInput, type AddPaymentMethodInput, type Address, type AdminAuditEntry, type AdminAuthStrength, type AdminListingItem, AdminModule, type AdminOperator, type AdminOrderDetail, type AdminOrderListItem, type AdminPayoutItem, type AdminPermission, type AdminPermissionDescription, type AdminRecoveryEvent, type AdminRecoveryRequest, type AdminReport, type AdminRolePreset, type AdminStoreDetail, type AdminStoreListItem, type AdminUserDetail, type AdminUserListItem, type AdminVaziOutfit, type AdminVerificationItem, type AdminWholesalePendingStore, type AuthCapabilities, AuthModule, type AuthTokens, type AuthenticationResponseJSON, BALE_ORDER_STATUSES, type Bale, type BaleDetail, type BaleFeedItem, type BaleFulfillment, type BaleGrade, type BaleOrder, type BaleOrderEvent, type BaleOrderStatus, type BaleType, type BecomeBaleSellerInput, type BecomeSellerInput, type BlockedIp, type Business, type BusinessType, BusinessesModule, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type CheckoutNextAction, type CheckoutOrder, type CheckoutPaymentMethod, type CheckoutStatus, type CheckoutStatusResponse, type City, type CompleteOnboardingInput, type CompleteRecoveryResult, type Condition, type Conversation, type CreateBaleInput, type CreateBaleOrderInput, type CreateListingInput, type CreateOrderInput, type CreateReportInput, type CreateReviewInput, type CreateStoreInput, DEFAULT_SHARE_ORIGIN, DESIRED_RESOLUTIONS, DISPUTE_REASONS, DISPUTE_STATUSES, type DeliveryAddress, type DesiredResolution, type Dispute, type DisputeEvent, type DisputeEvidence, type DisputeListParams, type DisputeReason, type DisputeStatus, DisputesModule, type EmailLoginInput, type EmailRegisterInput, type FollowedStore, type ForgotPasswordInput, IDBTokenStore, type InboxRealtimeEvent, type InitiateCheckoutInput, type InitiateCheckoutResponse, type KnownPaymentProvider, LISTING_STATUSES, type LinkedAccount, type LinkedAccountProvider, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageResponse, MessagesModule, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type OperatorPermissionGrant, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentAttemptStatus, type PaymentMethod, type PaymentMethodType, type PaymentProvider, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PendingPayoutApproval, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type ProviderId, type PublicKeyCredentialCreationOptionsJSON, type PublicKeyCredentialRequestOptionsJSON, type RaiseDisputeInput, type RecoveryStatus, type RecoveryStatusResult, type RegenerateBackupCodesResult, type RegisterInput, type RegistrationResponseJSON, ReportsModule, type RequestOptions, type RequestRecoveryInput, type RequestRecoveryResult, type ResetPasswordInput, type ResolveDisputeInput, type RespondDisputeInput, type Review, type ReviewableOrder, ReviewsModule, type RootSetupInput, type RootSetupResult, type SaveSearchInput, type SaveWholesaleStoreInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SellerType, type SendEmailInput, type SendMessageInput, type SendOtpInput, type Session, SettingsModule, type ShareUrlOptions, type SimilarListing, type StiEvent, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreSettings, type StoreStats, StoresModule, type SubscriptionTier, type SystemStats, TWO_FACTOR_METHOD_TYPES, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorMethod, type TwoFactorMethodType, type TwoFactorRequired, type UpdateBusinessInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, UploadsModule, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WholesaleDepot, type WholesaleFeedParams, WholesaleModule, type WholesaleStore, type WishlistListing, WishlistsModule, baleShareUrl, createTokenStore, listingShareUrl, storeShareUrl };
+export { APIClient, APIError, type APIErrorResponse, type Add2FAMethodInput, type Add2FAMethodResult, type AddAddressInput, type AddDepotInput, type AddPaymentMethodInput, type Address, type AdminAuditEntry, type AdminAuthStrength, type AdminListingItem, AdminModule, type AdminOperator, type AdminOrderDetail, type AdminOrderListItem, type AdminPayoutItem, type AdminPermission, type AdminPermissionDescription, type AdminRecoveryEvent, type AdminRecoveryRequest, type AdminReport, type AdminRolePreset, type AdminStoreDetail, type AdminStoreListItem, type AdminUserDetail, type AdminUserListItem, type AdminVaziOutfit, type AdminVerificationItem, type AdminWholesalePendingStore, type ApiResponse, type AttachmentDownloadAuthorization, type AttachmentUploadAuthorization, type AttachmentUploadBody, type AttachmentUploadState, type AttachmentUploadStatus, type AuthCapabilities, AuthModule, type AuthTokens, type AuthenticationResponseJSON, BALE_ORDER_STATUSES, type Bale, type BaleDetail, type BaleFeedItem, type BaleFulfillment, type BaleGrade, type BaleOrder, type BaleOrderEvent, type BaleOrderStatus, type BaleType, type BecomeBaleSellerInput, type BecomeSellerInput, type BlockedIp, type Business, type BusinessType, BusinessesModule, type BuyerResolveThreadInput, type BuyerSummary, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type CheckoutNextAction, type CheckoutOrder, type CheckoutPaymentMethod, type CheckoutStatus, type CheckoutStatusResponse, type City, type CompleteOnboardingInput, type CompleteRecoveryResult, type Condition, type Conversation, type ConversationId, type ConversationSummary, type CreateAttachmentUploadInput, type CreateBaleInput, type CreateBaleOrderInput, type CreateListingInput, type CreateMessageBlockInput, type CreateMessageBlockResult, type CreateMessageReportInput, type CreateMessageReportResult, type CreateOrderInput, type CreateReportInput, type CreateReviewInput, type CreateStoreInput, type CursorPage, DEFAULT_SHARE_ORIGIN, DESIRED_RESOLUTIONS, DISPUTE_REASONS, DISPUTE_STATUSES, type DeliveryAddress, type DesiredResolution, type Dispute, type DisputeEvent, type DisputeEvidence, type DisputeListParams, type DisputeReason, type DisputeStatus, DisputesModule, type EmailLoginInput, type EmailRegisterInput, type FollowedStore, type ForgotPasswordInput, IDBTokenStore, type InboxRealtimeEvent, type InitiateCheckoutInput, type InitiateCheckoutResponse, type KnownPaymentProvider, LISTING_STATUSES, type LegacyLinkResolution, type LegacyMessageArchiveSummary, type LegacyMessagePage, type LegacyMessageRecord, type LinkedAccount, type LinkedAccountProvider, type ListConversationsParams, type ListThreadMessagesParams, type ListThreadsParams, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageAttachment, type MessageAuthor, type MessageId, type MessagePage, type MessageReportReason, type MessageResponse, MessagesModule, type MessagesRealtimeConnection, type MessagesRealtimeEnvelope, type MessagesRealtimeEvent, type MessagesRealtimeOptions, type MessagesRealtimeState, type MessagesRealtimeTicket, type MessagingCapabilities, type MessagingCursor, type MessagingErrorCode, type MessagingIdempotentRequestOptions, type MessagingInboxes, type MessagingPerspective, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type OperatorPermissionGrant, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentAttemptStatus, type PaymentMethod, type PaymentMethodType, type PaymentProvider, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PendingPayoutApproval, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type ProviderId, type PublicKeyCredentialCreationOptionsJSON, type PublicKeyCredentialRequestOptionsJSON, type RaiseDisputeInput, type ReadCursorResult, RealtimeProtocolError, RealtimeUnavailableError, type RecoveryStatus, type RecoveryStatusResult, type RegenerateBackupCodesResult, type RegisterInput, type RegistrationResponseJSON, ReportsModule, type RequestOptions, type RequestRecoveryInput, type RequestRecoveryResult, type ResetPasswordInput, type ResolveDisputeInput, type ResolveThreadResult, type RespondDisputeInput, type Review, type ReviewableOrder, ReviewsModule, type RootSetupInput, type RootSetupResult, type SaveSearchInput, type SaveWholesaleStoreInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SellerType, type SendEmailInput, type SendMessageInput, type SendOtpInput, type SendThreadMessageInput, type SendThreadMessageResult, type Session, SettingsModule, type ShareUrlOptions, type SimilarListing, type StiEvent, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreResolveThreadInput, type StoreSettings, type StoreStats, type StoreSummary, StoresModule, type SubscriptionTier, type SystemStats, TWO_FACTOR_METHOD_TYPES, type ThreadCard, type ThreadId, type ThreadMessage, type ThreadSubject, type ThreadSystemEvent, type ThreadTimelineItem, type ThreadTimelineItemId, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorMethod, type TwoFactorMethodType, type TwoFactorRequired, type UpdateBusinessInput, type UpdateConversationPreferencesInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, type UpdateThreadPreferencesInput, UploadsModule, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WebSocketCloseEventLike, type WebSocketFactory, type WebSocketLike, type WebSocketMessageEventLike, type WholesaleDepot, type WholesaleFeedParams, WholesaleModule, type WholesaleStore, type WishlistListing, WishlistsModule, baleShareUrl, createTokenStore, isMessagingAPIError, listingShareUrl, storeShareUrl };