uapp-communication-sdk 1.0.0-dev.101

package/types/features/chat/chat-module.d.ts

@@ -0,0 +1,58 @@
+import type { HttpClient } from '@core/http';
+import type { Logger } from '@core/logger';
+import type { Clock } from '@core/time';
+import type { RealtimeConnection } from '@core/realtime';
+import { CreateGroupUseCase, DeleteConversationUseCase, DeleteMessageUseCase, DeleteMessageForMeUseCase, DownloadChatMediaUseCase, EditMessageUseCase, GetConversationUseCase, GetConversationCountsUseCase, GetMessagesBeforeUseCase, GetMessagesSinceUseCase, GetMessagesUseCase, GetViewerUseCase, LeaveConversationUseCase, ListConversationsUseCase, GetGroupMemberPoolUseCase, ListStaffUseCase, MarkDeliveredUseCase, MarkReadUseCase, ReactToMessageUseCase, RefreshPortalUseCase, SaveMembersUseCase, SendMessageUseCase, SendMediaMessageUseCase, SetArchivedUseCase, SetFavouriteUseCase, SetPinnedUseCase, StartDirectUseCase, SubscribePushUseCase } from './application';
+import type { ChatOutboxStore } from './domain';
+import { type ChatRealtimeStore } from './store';
+export interface ChatModuleDeps {
+    readonly logger: Logger;
+    readonly httpClient: HttpClient;
+    readonly clock: Clock;
+    /** The chat hub connection, built by the composition root (the single SignalR concrete). */
+    readonly realtime: RealtimeConnection;
+}
+export interface ChatModule {
+    readonly listConversations: ListConversationsUseCase;
+    readonly getConversation: GetConversationUseCase;
+    readonly getConversationCounts: GetConversationCountsUseCase;
+    readonly listStaff: ListStaffUseCase;
+    readonly getGroupMemberPool: GetGroupMemberPoolUseCase;
+    readonly getViewer: GetViewerUseCase;
+    readonly getMessages: GetMessagesUseCase;
+    readonly getMessagesSince: GetMessagesSinceUseCase;
+    readonly getMessagesBefore: GetMessagesBeforeUseCase;
+    readonly startDirect: StartDirectUseCase;
+    readonly createGroup: CreateGroupUseCase;
+    readonly sendMessage: SendMessageUseCase;
+    readonly sendMediaMessage: SendMediaMessageUseCase;
+    readonly downloadChatMedia: DownloadChatMediaUseCase;
+    readonly editMessage: EditMessageUseCase;
+    readonly deleteMessage: DeleteMessageUseCase;
+    readonly deleteMessageForMe: DeleteMessageForMeUseCase;
+    readonly subscribePush: SubscribePushUseCase;
+    readonly markDelivered: MarkDeliveredUseCase;
+    readonly markRead: MarkReadUseCase;
+    readonly setFavourite: SetFavouriteUseCase;
+    readonly setArchived: SetArchivedUseCase;
+    readonly setPinned: SetPinnedUseCase;
+    readonly deleteConversation: DeleteConversationUseCase;
+    readonly leaveConversation: LeaveConversationUseCase;
+    readonly refreshPortal: RefreshPortalUseCase;
+    readonly reactToMessage: ReactToMessageUseCase;
+    readonly saveMembers: SaveMembersUseCase;
+    /** The clock — presentation reads `now()` to decide if a message is still inside the
+     *  delete-for-everyone window. */
+    readonly clock: Clock;
+    /** The live chat hub connection (subscribe/invoke). The realtime controller drives it. */
+    readonly realtime: RealtimeConnection;
+    /** Ephemeral client/UI realtime state (status, presence, typing, receipts). */
+    readonly realtimeStore: ChatRealtimeStore;
+    /** Scoped logger for the realtime controller (malformed-payload warnings, best-effort invokes). */
+    readonly logger: Logger;
+    /** Durable outbox for optimistic sends (IndexedDB). */
+    readonly outbox: ChatOutboxStore;
+}
+/** Composition root for the chat feature — wires the HTTP gateway to the use cases. */
+export declare const createChatModule: (deps: ChatModuleDeps) => ChatModule;
+//# sourceMappingURL=chat-module.d.ts.map

package/types/features/chat/chat-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-module.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/chat-module.ts"],"names":[],"mappings":"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"}

package/types/features/chat/domain/chat-constants.d.ts

@@ -0,0 +1,13 @@
+/** How many messages to fetch per page (initial load cap, sync, and backward pagination). */
+export declare const PAGE_SIZE = 50;
+/**
+ * Window after sending within which an own message may still be "deleted for everyone" (WhatsApp-style).
+ * Past it, only "delete for me" remains. One hour — long enough to fix a slip, short enough that the
+ * record stabilizes.
+ */
+export declare const DELETE_FOR_EVERYONE_WINDOW_MS: number;
+/**
+ * Window after sending within which an own message may still be edited (15 minutes).
+ */
+export declare const EDIT_WINDOW_MS: number;
+//# sourceMappingURL=chat-constants.d.ts.map

package/types/features/chat/domain/chat-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-constants.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/domain/chat-constants.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,QAAiB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,cAAc,QAAiB,CAAC"}

package/types/features/chat/domain/entities/chat-message.d.ts

@@ -0,0 +1,102 @@
+export interface ChatReaction {
+    readonly emoji: string;
+    /** Number of distinct users who reacted with this emoji. */
+    readonly count: number;
+    /** True when the current viewer is one of those reactors (highlights the chip). */
+    readonly reacted: boolean;
+}
+/** `text` is a normal bubble; `system` is a centered activity line; `media` is an attachment bubble. */
+export type ChatMessageKind = 'text' | 'system' | 'media';
+/** Quoted message preview shown on replies. */
+export interface MessageReplyPreview {
+    readonly messageId: string;
+    readonly authorName: string;
+    readonly text: string;
+}
+export interface ChatMessageProps {
+    readonly id: string;
+    readonly kind: ChatMessageKind;
+    readonly authorName: string;
+    readonly authorInitials: string;
+    readonly authorColor: string;
+    readonly text: string;
+    /** Short display clock label, e.g. `8:04 PM` (already localized by the server). */
+    readonly time: string;
+    /** Full ISO instant the message was sent — drives day grouping / date separators. May be `''`. */
+    readonly sentAt?: string;
+    /** True when the current viewer sent it (right-aligned bubble). */
+    readonly fromViewer: boolean;
+    readonly reactions: readonly ChatReaction[];
+    /** Per-conversation monotonic order — the authoritative ordering + sync cursor. */
+    readonly sequence: number;
+    /** Author user id (`''`/Guid-empty for system messages). */
+    readonly senderId: string;
+    /** Idempotency key echoed by the server (null for system/legacy messages). */
+    readonly clientMessageId: string | null;
+    /** Quoted parent message, when this message is a reply. */
+    readonly replyTo?: MessageReplyPreview | null;
+    /** Public URL for an image/file attachment, when present. */
+    readonly mediaUrl?: string | null;
+    /** MIME type of the attachment (e.g. `image/png`, `application/pdf`) — decides image vs file card. */
+    readonly mediaContentType?: string | null;
+    /** Original file name of the attachment (shown on the file card + used for download). */
+    readonly mediaFileName?: string | null;
+    /** True when the server marked the message as edited. */
+    readonly isEdited?: boolean;
+    /** True when the author deleted this message for everyone (content is cleared server-side). */
+    readonly deletedForEveryone?: boolean;
+}
+/** A single chat message. Immutable. */
+export declare class ChatMessage {
+    readonly id: string;
+    readonly kind: ChatMessageKind;
+    readonly authorName: string;
+    readonly authorInitials: string;
+    readonly authorColor: string;
+    readonly text: string;
+    readonly time: string;
+    readonly sentAt: string;
+    readonly fromViewer: boolean;
+    readonly reactions: readonly ChatReaction[];
+    readonly sequence: number;
+    readonly senderId: string;
+    readonly clientMessageId: string | null;
+    readonly replyTo: MessageReplyPreview | null;
+    readonly mediaUrl: string | null;
+    readonly mediaContentType: string | null;
+    readonly mediaFileName: string | null;
+    readonly isEdited: boolean;
+    readonly deletedForEveryone: boolean;
+    constructor(props: ChatMessageProps);
+    get isSystem(): boolean;
+    /**
+     * Whether this message can still be "deleted for everyone" at `nowMs`: it must be the viewer's own,
+     * a real (non-system) message that isn't already deleted, and sent within
+     * {@link DELETE_FOR_EVERYONE_WINDOW_MS}. Past that window only "delete for me" applies — a rich-domain
+     * rule (tell-don't-ask) the dialog asks before offering the option. Messages with no `sentAt` (legacy
+     * / mock) are treated as out of window.
+     */
+    canDeleteForEveryone(nowMs: number): boolean;
+    get isSharedCard(): boolean;
+    /**
+     * Whether this message can still be edited at `nowMs`: it must be the viewer's own,
+     * a real (non-system) message that isn't already deleted, and sent within
+     * {@link EDIT_WINDOW_MS}. Messages with no `sentAt` are treated as out of window.
+     */
+    canEdit(nowMs: number): boolean;
+    /**
+     * A copy with the given fields overridden and ALL others preserved. The SINGLE place that enumerates
+     * every field, so adding a new prop (e.g. the media content-type/file-name) never silently drops it
+     * from a copy — which caused images to reconcile back to a generic file card over the realtime echo.
+     */
+    with(overrides: Partial<ChatMessageProps>): ChatMessage;
+    /**
+     * A copy that adopts `fallback` as its `sentAt` ONLY when it has none — used during optimistic
+     * reconciliation so a server echo that arrives without a timestamp doesn't wipe the instant the
+     * optimistic copy already carried. Returns `this` when nothing changes.
+     */
+    withFallbackSentAt(fallback: string): ChatMessage;
+    /** Returns a copy marked deleted-for-everyone with content cleared (matches server soft-delete). */
+    asDeletedForEveryone(): ChatMessage;
+}
+//# sourceMappingURL=chat-message.d.ts.map

package/types/features/chat/domain/entities/chat-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/chat/domain/entities/chat-message.ts"],"names":[],"mappings":"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"}

package/types/features/chat/domain/entities/conversation.d.ts

@@ -0,0 +1,122 @@
+import type { PresenceStatus } from '@shared/presence';
+export type ConversationKind = 'dm' | 'group';
+/** A member shown in a group conversation's avatar stack + the Manage-members panel. */
+export interface ConversationMember {
+    readonly id: string;
+    readonly name: string;
+    readonly initials: string;
+    readonly color: string;
+    /** Job title shown under the name in the members panel (empty for unknown). */
+    readonly role: string;
+    /**
+     * The member's status, defaulting to `offline` — which is also what a conversation LIST carries,
+     * because a list row draws avatars rather than statuses. The badge hides at offline, so an
+     * unresolved member is silent instead of mislabelled.
+     */
+    readonly status?: PresenceStatus;
+    readonly statusUntilUtc?: string | null;
+}
+/** The signed-in user, as the chat feature sees them (drives self/admin checks + right-aligned bubbles). */
+export interface ChatViewer {
+    readonly id: string;
+    readonly name: string;
+    readonly initials: string;
+    readonly color: string;
+}
+/** Per-member read/delivered cursors — the UI computes accurate tick states from these. */
+export interface ConversationMemberReceipt {
+    readonly userId: string;
+    /** Highest message sequence the member has been delivered (0 = none). */
+    readonly deliveredUpto: number;
+    /** Highest message sequence the member has read (0 = none). */
+    readonly readUpto: number;
+}
+export interface ConversationProps {
+    readonly id: string;
+    readonly kind: ConversationKind;
+    readonly title: string;
+    readonly subtitle: string;
+    readonly initials: string;
+    readonly color: string;
+    readonly online: boolean;
+    /**
+     * The DM peer's status badge. Optional and defaulting to `offline`, which is also what a group
+     * carries: a group header shows its member stack, not one person's status.
+     *
+     * <p>Not derivable from `online` — someone in a meeting is very much online, and that is the half
+     * that decides whether to interrupt them.</p>
+     */
+    readonly status?: PresenceStatus;
+    /** When the peer's status ends (ISO UTC), when it is bounded. */
+    readonly statusUntilUtc?: string | null;
+    readonly unread: number;
+    readonly pinned: boolean;
+    /** Starred by the viewer — surfaces under the Favourites filter. */
+    readonly favourite: boolean;
+    /** Hidden from the main list — surfaces only under the Archive filter. */
+    readonly archived: boolean;
+    /** The viewer administers this group (shows the "YOU'RE ADMIN" badge + member management). */
+    readonly admin: boolean;
+    readonly lastMessage: string;
+    /** Legacy server-formatted last-message label (UTC). Prefer `lastMessageAt` for a timezone-correct clock. */
+    readonly lastTime: string;
+    /** UTC instant of the last message (ISO string), or null. The row formats it in the viewer's timezone. */
+    readonly lastMessageAt?: string | null;
+    /** Human-readable "last synced" label for portal-backed groups (e.g. "16d ago"), else null. */
+    readonly lastSynced: string | null;
+    /** Tenant the group belongs to — used to resolve its group category. */
+    readonly tenantId: string;
+    /** Explicit group-category binding; when null the locked default ("General") applies. */
+    readonly categoryId: string | null;
+    /** Group members (empty for DMs) — rendered as the header avatar stack. */
+    readonly members: readonly ConversationMember[];
+    /** Ids (subset of members) who administer the group — drive the ADMIN badges + management rights. */
+    readonly adminIds: readonly string[];
+    /** Field values the group category reads by key (appId, studentName, applicationStatus, …). */
+    readonly data: Readonly<Record<string, string>>;
+    /** The other participant for a DM (drives peer presence); null for groups. */
+    readonly peerUserId: string | null;
+    /** Per-member read/delivered cursors (one per member, including the viewer). */
+    readonly memberReceipts: readonly ConversationMemberReceipt[];
+}
+/** A direct or group conversation as shown in the chat list. Immutable. */
+export declare class Conversation {
+    readonly id: string;
+    readonly kind: ConversationKind;
+    readonly title: string;
+    readonly subtitle: string;
+    readonly initials: string;
+    readonly color: string;
+    readonly online: boolean;
+    readonly status: PresenceStatus;
+    readonly statusUntilUtc: string | null;
+    readonly unread: number;
+    readonly pinned: boolean;
+    readonly favourite: boolean;
+    readonly archived: boolean;
+    readonly admin: boolean;
+    readonly lastMessage: string;
+    readonly lastTime: string;
+    readonly lastMessageAt: string | null;
+    readonly lastSynced: string | null;
+    readonly tenantId: string;
+    readonly categoryId: string | null;
+    readonly members: readonly ConversationMember[];
+    readonly adminIds: readonly string[];
+    readonly data: Readonly<Record<string, string>>;
+    readonly peerUserId: string | null;
+    readonly memberReceipts: readonly ConversationMemberReceipt[];
+    constructor(props: ConversationProps);
+    get isUnread(): boolean;
+    get isGroup(): boolean;
+    get isDm(): boolean;
+    get hasCategory(): boolean;
+    get memberCount(): number;
+    /** Whether the given user administers this group. */
+    isAdmin(userId: string): boolean;
+    /** Whether the given user may add, remove, or promote members. */
+    canManageMembers(userId: string): boolean;
+    /** Returns a copy with the given fields overridden. */
+    with(overrides: Partial<ConversationProps>): Conversation;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/types/features/chat/domain/entities/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/chat/domain/entities/conversation.ts"],"names":[],"mappings":"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"}

package/types/features/chat/domain/errors/chat-errors.d.ts

@@ -0,0 +1,35 @@
+import { DomainError } from '@core/errors';
+/** Base type for every chat-domain failure. */
+export declare abstract class ChatError extends DomainError {
+}
+/** The chat service could not be reached or returned an unexpected response. */
+export declare class ChatUnavailableError extends ChatError {
+    readonly code = "CHAT_UNAVAILABLE";
+    constructor(cause?: unknown, message?: string);
+}
+/** A message could not be sent because it was empty. */
+export declare class EmptyMessageError extends ChatError {
+    readonly code = "CHAT_EMPTY_MESSAGE";
+    constructor();
+}
+/** A message could not be sent because it exceeded the length limit. */
+export declare class MessageTooLongError extends ChatError {
+    readonly code = "CHAT_MESSAGE_TOO_LONG";
+    constructor(maxLength: number);
+}
+/** A group could not be created because it had no title. */
+export declare class EmptyGroupTitleError extends ChatError {
+    readonly code = "CHAT_EMPTY_GROUP_TITLE";
+    constructor();
+}
+/** A group could not be created because no members were selected. */
+export declare class EmptyGroupMembersError extends ChatError {
+    readonly code = "CHAT_EMPTY_GROUP_MEMBERS";
+    constructor();
+}
+/** A direct conversation could not be started because no recipient was given. */
+export declare class MissingDirectRecipientError extends ChatError {
+    readonly code = "CHAT_MISSING_DIRECT_RECIPIENT";
+    constructor();
+}
+//# sourceMappingURL=chat-errors.d.ts.map

package/types/features/chat/domain/errors/chat-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-errors.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/chat/domain/errors/chat-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,+CAA+C;AAC/C,8BAAsB,SAAU,SAAQ,WAAW;CAAG;AAEtD,gFAAgF;AAChF,qBAAa,oBAAqB,SAAQ,SAAS;IACjD,SAAgB,IAAI,sBAAsB;gBAEvB,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM;CAGrD;AAED,wDAAwD;AACxD,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,SAAgB,IAAI,wBAAwB;;CAK7C;AAED,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,SAAgB,IAAI,2BAA2B;gBAE5B,SAAS,EAAE,MAAM;CAGrC;AAED,4DAA4D;AAC5D,qBAAa,oBAAqB,SAAQ,SAAS;IACjD,SAAgB,IAAI,4BAA4B;;CAKjD;AAED,qEAAqE;AACrE,qBAAa,sBAAuB,SAAQ,SAAS;IACnD,SAAgB,IAAI,8BAA8B;;CAKnD;AAED,iFAAiF;AACjF,qBAAa,2BAA4B,SAAQ,SAAS;IACxD,SAAgB,IAAI,mCAAmC;;CAKxD"}

package/types/features/chat/domain/index.d.ts

@@ -0,0 +1,8 @@
+export * from './errors/chat-errors';
+export * from './entities/chat-message';
+export * from './entities/conversation';
+export * from './chat-constants';
+export * from './server-instant';
+export type { ChatOutboxEntry, ChatOutboxStore } from './ports/chat-outbox-store';
+export type { ChatGateway, ChatMediaUpload, ConversationQuery, ConversationScope, ConversationScopeCounts, ConversationsPage, PushSubscriptionPayload, SendMediaMessageParams, } from './ports/chat-gateway';
+//# sourceMappingURL=index.d.ts.map

package/types/features/chat/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,YAAY,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/types/features/chat/domain/ports/chat-gateway.d.ts

@@ -0,0 +1,122 @@
+import type { Result } from '@core/result';
+import type { ChatError } from '../errors/chat-errors';
+import type { ChatViewer, Conversation, ConversationMember } from '../entities/conversation';
+import type { ChatMessage } from '../entities/chat-message';
+/** Wire reference returned after uploading chat media. */
+export interface ChatMediaUpload {
+    readonly mediaId: string;
+    readonly url: string;
+}
+/** Push subscription payload sent to the backend. */
+export interface PushSubscriptionPayload {
+    readonly endpoint: string;
+    readonly p256dh: string;
+    readonly auth: string;
+}
+/** One page of conversations plus the grand total, so the UI knows whether more remain to load. */
+export interface ConversationsPage {
+    readonly items: readonly Conversation[];
+    readonly totalCount: number;
+}
+/**
+ * Which slice of the viewer's conversations to fetch — the chat tabs, resolved at the SERVER (each tab is
+ * its own correctly-paged query, not a client-side filter of one page). Archived chats appear only under
+ * `archive`; every other scope excludes them.
+ */
+export type ConversationScope = 'all' | 'unread' | 'favourites' | 'groups' | 'archive';
+/**
+ * Per-tab NOTIFICATION counts for the chat tab badges — how many conversations in each tab have UNREAD
+ * messages (not the tab's total inventory). A tab with nothing unread is 0, so the UI shows no badge.
+ */
+export interface ConversationScopeCounts {
+    /** Non-archived conversations with unread messages. */
+    readonly unread: number;
+    /** Non-archived starred conversations with unread messages. */
+    readonly favourites: number;
+    /** Non-archived group conversations with unread messages. */
+    readonly groups: number;
+    /** Archived conversations with unread messages. */
+    readonly archived: number;
+}
+/** A page request for the conversation list: which tab scope, an optional text filter, the paging window. */
+export interface ConversationQuery {
+    readonly scope: ConversationScope;
+    readonly filter: string | undefined;
+    readonly skipCount: number;
+    readonly maxResultCount: number;
+}
+/** Parameters for sending a media attachment as a chat message. */
+export interface SendMediaMessageParams {
+    readonly conversationId: string;
+    readonly file: Blob;
+    readonly fileName: string;
+    readonly clientMessageId: string;
+    /** Optional text shown with the attachment (WhatsApp-style caption). */
+    readonly caption?: string;
+    readonly replyToMessageId?: string | null;
+}
+/** Port to the chat service. Implemented over the (mock) gateway now, HTTP later. */
+export interface ChatGateway {
+    /**
+     * A page of the viewer's conversations for a tab scope (pinned first, then most-recent), optionally
+     * narrowed by a text filter over title + member names — all server-side — for infinite scroll.
+     */
+    listConversations(query: ConversationQuery): Promise<Result<ConversationsPage, ChatError>>;
+    /** Exact per-tab conversation counts (server-computed) for the chat tab badges. */
+    getConversationCounts(): Promise<Result<ConversationScopeCounts, ChatError>>;
+    /**
+     * A single conversation the viewer belongs to, by id — for the OPEN pane / deep-links, independent of the
+     * current tab or page. A non-member / missing id resolves to a `ChatError` (the UI reads it as lost access).
+     */
+    getConversation(conversationId: string): Promise<Result<Conversation, ChatError>>;
+    /** The addable-staff roster; `filter` is an optional server-side typeahead over name + role. */
+    listStaff(filter?: string): Promise<Result<readonly ConversationMember[], ChatError>>;
+    /**
+     * The people the viewer may add when creating a group (or adding members later) — their hierarchy
+     * scope projected onto the directory. The server enforces the SAME pool on the write and serves the
+     * full roster when the org-hierarchy feature is off, so pickers can always call it.
+     */
+    getGroupMemberPool(filter?: string): Promise<Result<readonly ConversationMember[], ChatError>>;
+    /** The signed-in user (for self/admin checks in the members panel). */
+    getViewer(): Promise<Result<ChatViewer, ChatError>>;
+    getMessages(conversationId: string, maxResultCount?: number): Promise<Result<readonly ChatMessage[], ChatError>>;
+    /** Incremental fetch: messages with `sequence > afterSequence`, capped at `maxResultCount`. */
+    getMessagesSince(conversationId: string, afterSequence: number, maxResultCount: number): Promise<Result<readonly ChatMessage[], ChatError>>;
+    /** Backfill: older messages with `sequence < beforeSequence`, capped at `maxResultCount`, ascending. */
+    getMessagesBefore(conversationId: string, beforeSequence: number, maxResultCount: number): Promise<Result<readonly ChatMessage[], ChatError>>;
+    /** Find-or-create a DM with `otherUserId` and return the conversation. */
+    startDirect(otherUserId: string): Promise<Result<Conversation, ChatError>>;
+    /** Create a group with the given title + member ids and return the conversation. */
+    createGroup(title: string, memberIds: readonly string[]): Promise<Result<Conversation, ChatError>>;
+    sendMessage(conversationId: string, text: string, clientMessageId: string, replyToMessageId?: string | null): Promise<Result<ChatMessage, ChatError>>;
+    /** Upload a media attachment for a conversation (returns a reference for send). */
+    uploadChatMedia(conversationId: string, file: Blob, fileName: string): Promise<Result<ChatMediaUpload, ChatError>>;
+    /** Send a media message (multipart upload + message create). */
+    sendMediaMessage(params: SendMediaMessageParams): Promise<Result<ChatMessage, ChatError>>;
+    /**
+     * Download chat media (image/file) as a `Blob` through the AUTHENTICATED client. A plain `<img src>`
+     * can't attach the bearer token, so the presentation fetches the blob here and renders an object URL.
+     * `mediaPath` is the server-relative URL carried on the message (e.g. `/api/app/chat-media/{blob}`).
+     */
+    downloadMedia(mediaPath: string): Promise<Result<Blob, ChatError>>;
+    editMessage(conversationId: string, messageId: string, text: string): Promise<Result<ChatMessage, ChatError>>;
+    deleteMessage(conversationId: string, messageId: string): Promise<Result<void, ChatError>>;
+    /** "Delete for me": hide the message from the current viewer only (it stays for everyone else). */
+    deleteMessageForMe(conversationId: string, messageId: string): Promise<Result<void, ChatError>>;
+    subscribePush(subscription: PushSubscriptionPayload): Promise<Result<void, ChatError>>;
+    /** Acknowledge delivery up to (and including) `uptoSequence` for the viewer. */
+    markDelivered(conversationId: string, uptoSequence: number): Promise<Result<void, ChatError>>;
+    /** Mark read up to (and including) `uptoSequence` for the viewer. */
+    markRead(conversationId: string, uptoSequence: number): Promise<Result<void, ChatError>>;
+    setFavourite(conversationId: string, favourite: boolean): Promise<Result<void, ChatError>>;
+    setArchived(conversationId: string, archived: boolean): Promise<Result<void, ChatError>>;
+    setPinned(conversationId: string, pinned: boolean): Promise<Result<void, ChatError>>;
+    deleteConversation(conversationId: string): Promise<Result<void, ChatError>>;
+    /** Self-service leave: remove the viewer from a group conversation's membership. */
+    leaveConversation(conversationId: string): Promise<Result<void, ChatError>>;
+    refreshPortal(conversationId: string): Promise<Result<void, ChatError>>;
+    reactToMessage(conversationId: string, messageId: string, emoji: string): Promise<Result<void, ChatError>>;
+    /** Replace a group's members + admins; the diff is logged as activity (system) messages. */
+    saveMembers(conversationId: string, members: readonly ConversationMember[], adminIds: readonly string[]): Promise<Result<void, ChatError>>;
+}
+//# sourceMappingURL=chat-gateway.d.ts.map

package/types/features/chat/domain/ports/chat-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/chat/domain/ports/chat-gateway.ts"],"names":[],"mappings":"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"}

package/types/features/chat/domain/ports/chat-outbox-store.d.ts

@@ -0,0 +1,16 @@
+/** A persisted optimistic send awaiting delivery or retry after reconnect. */
+export interface ChatOutboxEntry {
+    readonly clientMessageId: string;
+    readonly conversationId: string;
+    readonly text: string;
+    /** ISO timestamp when the send last failed; null while in-flight or not yet attempted. */
+    readonly failedAt: string | null;
+}
+/** Port for durable pending-send storage (IndexedDB). Survives reloads and offline periods. */
+export interface ChatOutboxStore {
+    put(entry: ChatOutboxEntry): Promise<void>;
+    remove(clientMessageId: string): Promise<void>;
+    listAll(): Promise<readonly ChatOutboxEntry[]>;
+    listByConversation(conversationId: string): Promise<readonly ChatOutboxEntry[]>;
+}
+//# sourceMappingURL=chat-outbox-store.d.ts.map

package/types/features/chat/domain/ports/chat-outbox-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-outbox-store.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/chat/domain/ports/chat-outbox-store.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;IAC/C,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;CACjF"}

package/types/features/chat/domain/server-instant.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Parses a server timestamp into an absolute instant. The backend emits UTC instants, but some
+ * serialize WITHOUT a `Z` (a `DateTimeKind.Unspecified` value read back from a `timestamp without time
+ * zone` column) — which `new Date(...)` would wrongly interpret as the viewer's LOCAL time. We anchor
+ * such strings to UTC by appending `Z`, so the instant is correct before it's rendered in the viewer's
+ * own timezone. Strings that already carry a designator are parsed as-is. An empty/invalid input yields
+ * an Invalid Date (callers check `Number.isNaN(date.getTime())`).
+ */
+export declare const parseServerInstant: (iso: string) => Date;
+//# sourceMappingURL=server-instant.d.ts.map

package/types/features/chat/domain/server-instant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-instant.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/domain/server-instant.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,IACuB,CAAC"}

package/types/features/chat/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Public API of the `chat` feature. Other features and the app shell import ONLY from here.
+ */
+export { createChatModule, type ChatModule, type ChatModuleDeps } from './chat-module';
+export { ChatModuleProvider, ChatRealtimeProvider } from './presentation';
+export { useUnreadChatCount, useChatViewer, useChatStaff, useChatModule, useConversations, useStaffSearch, } from './presentation';
+export type { Conversation, ConversationMember, ChatMessage } from './domain';
+//# sourceMappingURL=index.d.ts.map

package/types/features/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/types/features/chat/infrastructure/chat-gateway-errors.d.ts

@@ -0,0 +1,17 @@
+import type { Logger } from '@core/logger';
+import type { Clock } from '@core/time';
+import { type Result } from '@core/result';
+import { type ChatError, type ChatMessage, type Conversation } from '../domain';
+/**
+ * {@link HttpChatGateway} boundary helpers — error mapping + the two response parsers — kept out of
+ * the gateway class so it stays a thin set of request methods within the file-size budget. Every
+ * failure is mapped to a {@link ChatUnavailableError} value; nothing is thrown.
+ */
+/** Log + map a Zod parse failure at the chat HTTP boundary to a {@link ChatUnavailableError}. */
+export declare const parseFailure: (logger: Logger, label: string, cause: unknown) => Result<never, ChatError>;
+export declare const mapChatError: (logger: Logger, cause: unknown) => ChatError;
+/** Validate + map a message-list response (ascending). */
+export declare const parseMessageList: (logger: Logger, label: string, raw: unknown) => Result<readonly ChatMessage[], ChatError>;
+/** Validate + map a single-conversation response. */
+export declare const parseConversation: (logger: Logger, clock: Clock, label: string, raw: unknown) => Result<Conversation, ChatError>;
+//# sourceMappingURL=chat-gateway-errors.d.ts.map

package/types/features/chat/infrastructure/chat-gateway-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-gateway-errors.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/infrastructure/chat-gateway-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,WAAW,CAAC;AAInB;;;;GAIG;AAEH,iGAAiG;AACjG,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,OAAO,OAAO,KACb,MAAM,CAAC,KAAK,EAAE,SAAS,CAGzB,CAAC;AAoDF,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,KAAG,SAG7D,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,KAAK,OAAO,KACX,MAAM,CAAC,SAAS,WAAW,EAAE,EAAE,SAAS,CAM1C,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,OAAO,KAAK,EACZ,OAAO,MAAM,EACb,KAAK,OAAO,KACX,MAAM,CAAC,YAAY,EAAE,SAAS,CAMhC,CAAC"}

package/types/features/chat/infrastructure/chat-mappers.d.ts

@@ -0,0 +1,13 @@
+import { type ChatViewer, type ConversationMember, ChatMessage, Conversation } from '../domain';
+import type { ChatMessageDto, ChatViewerDto, ConversationDto, ConversationMemberDto } from './dto/chat-dtos';
+/**
+ * A short relative-time label vs `now` (e.g. `just now`, `5m`, `3h`, `16d`). Pure: same inputs →
+ * same output, so it is unit-testable with a fixed `now`. Future/just-now instants collapse to
+ * `just now`; everything else picks the coarsest unit that is at least 1.
+ */
+export declare const relativeTime: (date: Date, now: Date) => string;
+export declare const toConversationMember: (dto: ConversationMemberDto) => ConversationMember;
+export declare const toChatViewer: (dto: ChatViewerDto) => ChatViewer;
+export declare const toConversation: (dto: ConversationDto, now: Date) => Conversation;
+export declare const toChatMessage: (dto: ChatMessageDto) => ChatMessage;
+//# sourceMappingURL=chat-mappers.d.ts.map

package/types/features/chat/infrastructure/chat-mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-mappers.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/infrastructure/chat-mappers.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,UAAU,EAEf,KAAK,kBAAkB,EACvB,WAAW,EACX,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAMzB;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,IAAI,EAAE,KAAK,IAAI,KAAG,MAYpD,CAAC;AAiBF,eAAO,MAAM,oBAAoB,GAAI,KAAK,qBAAqB,KAAG,kBAQhE,CAAC;AAEH,eAAO,MAAM,YAAY,GAAI,KAAK,aAAa,KAAG,UAKhD,CAAC;AAmBH,eAAO,MAAM,cAAc,GAAI,KAAK,eAAe,EAAE,KAAK,IAAI,KAAG,YAmC7D,CAAC;AAEL,eAAO,MAAM,aAAa,GAAI,KAAK,cAAc,KAAG,WAoCnD,CAAC"}

package/types/features/chat/infrastructure/chat-outbox-store.d.ts

@@ -0,0 +1,4 @@
+import type { ChatOutboxStore } from '../domain/ports/chat-outbox-store';
+/** IndexedDB-backed {@link ChatOutboxStore} for durable optimistic sends. */
+export declare const createIdbChatOutboxStore: () => ChatOutboxStore;
+//# sourceMappingURL=chat-outbox-store.d.ts.map

package/types/features/chat/infrastructure/chat-outbox-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-outbox-store.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/infrastructure/chat-outbox-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAO1F,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB,QAAO,eAyB1C,CAAC"}