@micha.bigler/ui-core-micha 2.15.0 → 2.17.0

package/dist/messaging/MessagingProvider.js

@@ -0,0 +1,363 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useReducer, useRef } from 'react';
+import { AuthContext } from '../auth/AuthContext';
+import { archiveConversation, createBroadcastConversation, createDirectConversation, createGroupConversation, getReadStatus, getUnreadCount, listConversations, listMessages, listThread, patchConversationPreferences, markConversationRead, markThreadRead, createMessage, uploadAttachments, getAttachment, getAttachmentThumbnail, addReaction, removeReaction, createPoll, votePoll, closePoll, getConversationConfig, patchConversationConfig, patchMessage as patchMessageRequest, deleteMessage as deleteMessageRequest, } from './api';
+import { useRealtime } from '../notifications/realtime';
+const MessagingContext = createContext(null);
+export const MESSAGING_ENVELOPE = 'messaging';
+const EMPTY_CACHE = { conversations: {}, messages: {}, threads: {}, polls: {}, reactions: {}, receipts: {}, unread: { unread_count: 0, by_conversation: {} }, cursors: { conversations: null, messages: {}, threads: {} } };
+const DEFAULT_API = {
+    listConversations, listMessages, listThread, getReadStatus, getUnreadCount, archiveConversation,
+    patchConversationPreferences, createGroupConversation, createBroadcastConversation, createDirectConversation,
+    markConversationRead, markThreadRead,
+    createMessage, uploadAttachments, getAttachment, getAttachmentThumbnail,
+    addReaction, removeReaction, createPoll, votePoll, closePoll, getConversationConfig, patchConversationConfig,
+    patchMessage: patchMessageRequest, deleteMessage: deleteMessageRequest,
+};
+function idOf(item) { var _a, _b, _c; return (_c = (_b = (_a = item === null || item === void 0 ? void 0 : item.id) !== null && _a !== void 0 ? _a : item === null || item === void 0 ? void 0 : item.conversation_id) !== null && _b !== void 0 ? _b : item === null || item === void 0 ? void 0 : item.message_id) !== null && _c !== void 0 ? _c : item === null || item === void 0 ? void 0 : item.poll_id; }
+function mergeById(slice, item) { const id = idOf(item); return id == null ? slice : Object.assign(Object.assign({}, slice), { [id]: Object.assign(Object.assign({}, slice[id]), item) }); }
+function resultsOf(response) { return (response === null || response === void 0 ? void 0 : response.results) || []; }
+function clientRequestIdOf(message) { return message === null || message === void 0 ? void 0 : message.client_request_id; }
+/**
+ * dcm's DRF validation errors aren't always {detail}: ConversationAttachmentView
+ * translates a rejected upload into a field-keyed {"files": [...]} body (the
+ * MSG-2 chunk-4 fix — see django-core-micha messaging/views.py), while other
+ * endpoints use {detail}. Check every shape a caller might actually receive
+ * before falling back to the generic axios error message.
+ */
+export function extractApiErrorMessage(error) {
+    var _a;
+    const data = (_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.data;
+    if (typeof (data === null || data === void 0 ? void 0 : data.detail) === 'string')
+        return data.detail;
+    if (typeof (data === null || data === void 0 ? void 0 : data.message) === 'string')
+        return data.message;
+    if (Array.isArray(data === null || data === void 0 ? void 0 : data.files))
+        return data.files.join(' ');
+    if (data && typeof data === 'object') {
+        const firstArray = Object.values(data).find((value) => Array.isArray(value) && value.length);
+        if (firstArray)
+            return firstArray.join(' ');
+    }
+    return error === null || error === void 0 ? void 0 : error.message;
+}
+function reconcileMessage(messages, message) {
+    var _a, _b;
+    const requestId = clientRequestIdOf(message);
+    const matchingEntry = requestId && Object.entries(messages).find(([, item]) => clientRequestIdOf(item) === requestId);
+    if (!matchingEntry)
+        return mergeById(messages, message);
+    const [previousKey, previous] = matchingEntry;
+    const next = Object.assign({}, messages);
+    delete next[previousKey];
+    const id = (_a = idOf(message)) !== null && _a !== void 0 ? _a : previousKey;
+    next[id] = Object.assign(Object.assign(Object.assign({}, previous), message), { id: (_b = idOf(message)) !== null && _b !== void 0 ? _b : previous.id, status: message.status || 'sent', error: null });
+    return next;
+}
+export function messagingReducer(state, action) {
+    var _a, _b, _c, _d, _e, _f;
+    switch (action.type) {
+        case 'conversationsLoaded': {
+            const conversations = action.results.reduce((next, item) => mergeById(next, item), state.conversations);
+            return Object.assign(Object.assign({}, state), { conversations, cursors: Object.assign(Object.assign({}, state.cursors), { conversations: (_a = action.nextCursor) !== null && _a !== void 0 ? _a : null }) });
+        }
+        case 'unreadLoaded': return Object.assign(Object.assign({}, state), { unread: action.unread || EMPTY_CACHE.unread });
+        case 'messagesLoaded': {
+            const messages = action.results.reduce((next, item) => mergeById(next, item), state.messages);
+            return Object.assign(Object.assign({}, state), { messages, cursors: Object.assign(Object.assign({}, state.cursors), { messages: Object.assign(Object.assign({}, state.cursors.messages), { [action.conversationId]: (_b = action.nextCursor) !== null && _b !== void 0 ? _b : null }) }) });
+        }
+        case 'threadLoaded': {
+            const messages = action.results.reduce((next, item) => mergeById(next, item), state.messages);
+            return Object.assign(Object.assign({}, state), { messages, cursors: Object.assign(Object.assign({}, state.cursors), { threads: Object.assign(Object.assign({}, state.cursors.threads), { [action.rootId]: (_c = action.nextCursor) !== null && _c !== void 0 ? _c : null }) }) });
+        }
+        case 'conversationUpsert': return Object.assign(Object.assign({}, state), { conversations: mergeById(state.conversations, action.conversation) });
+        case 'messageOptimistic': return Object.assign(Object.assign({}, state), { messages: mergeById(state.messages, action.message) });
+        case 'messageReconciled': return Object.assign(Object.assign({}, state), { messages: reconcileMessage(state.messages, action.message) });
+        case 'messageFailed': {
+            const matching = Object.entries(state.messages).find(([, item]) => clientRequestIdOf(item) === action.clientRequestId);
+            if (!matching)
+                return state;
+            const [key, message] = matching;
+            return Object.assign(Object.assign({}, state), { messages: Object.assign(Object.assign({}, state.messages), { [key]: Object.assign(Object.assign({}, message), { status: 'error', error: action.error }) }) });
+        }
+        case 'messagePatched': return Object.assign(Object.assign({}, state), { messages: mergeById(state.messages, action.message) });
+        case 'conversationRead': {
+            const previousCount = ((_e = (_d = state.unread) === null || _d === void 0 ? void 0 : _d.by_conversation) === null || _e === void 0 ? void 0 : _e[action.conversationId]) || 0;
+            if (!previousCount)
+                return state;
+            return Object.assign(Object.assign({}, state), { unread: Object.assign(Object.assign({}, state.unread), { unread_count: Math.max(0, (((_f = state.unread) === null || _f === void 0 ? void 0 : _f.unread_count) || 0) - previousCount), by_conversation: Object.assign(Object.assign({}, state.unread.by_conversation), { [action.conversationId]: 0 }) }) });
+        }
+        case 'frame': return applyFrame(state, action.frame, action.activeConversationId);
+        default: return state;
+    }
+}
+export function applyFrame(state, frame, activeConversationId = null) {
+    var _a, _b, _c, _d;
+    const payload = frame.message || frame.conversation || frame.participant || frame;
+    const conversationId = (_a = frame.conversation_id) !== null && _a !== void 0 ? _a : payload.conversation_id;
+    if (frame.type === 'message') {
+        const message = Object.assign(Object.assign({}, payload), { conversation_id: conversationId });
+        const requestId = clientRequestIdOf(message);
+        const reconcilesOptimisticMessage = Boolean(requestId && Object.values(state.messages).some((item) => clientRequestIdOf(item) === requestId));
+        const messages = reconcileMessage(state.messages, message);
+        if (conversationId == null || String(conversationId) === String(activeConversationId) || reconcilesOptimisticMessage)
+            return Object.assign(Object.assign({}, state), { messages });
+        const unread = state.unread || EMPTY_CACHE.unread;
+        const previousCount = ((_b = unread.by_conversation) === null || _b === void 0 ? void 0 : _b[conversationId]) || 0;
+        return Object.assign(Object.assign({}, state), { messages, unread: Object.assign(Object.assign({}, unread), { unread_count: (unread.unread_count || 0) + 1, by_conversation: Object.assign(Object.assign({}, unread.by_conversation), { [conversationId]: previousCount + 1 }) }) });
+    }
+    if (frame.type === 'message_edited')
+        return Object.assign(Object.assign({}, state), { messages: mergeById(state.messages, payload) });
+    if (frame.type === 'reaction') {
+        const messageId = (_c = frame.message_id) !== null && _c !== void 0 ? _c : payload.message_id;
+        const previous = state.messages[messageId] || { id: messageId };
+        return Object.assign(Object.assign({}, state), { messages: mergeById(state.messages, Object.assign(Object.assign({}, previous), { reactions: payload.reactions || frame.reactions || previous.reactions || [] })) });
+    }
+    if (frame.type === 'poll_updated') {
+        const messageId = (_d = frame.message_id) !== null && _d !== void 0 ? _d : payload.message_id;
+        const previous = state.messages[messageId] || { id: messageId };
+        const poll = payload.poll || frame.poll || payload;
+        return Object.assign(Object.assign({}, state), { messages: mergeById(state.messages, Object.assign(Object.assign({}, previous), { poll })), polls: mergeById(state.polls, poll) });
+    }
+    if (frame.type === 'message_deleted') {
+        const previous = state.messages[frame.message_id] || {};
+        return Object.assign(Object.assign({}, state), { messages: Object.assign(Object.assign({}, state.messages), { [frame.message_id]: Object.assign(Object.assign({}, previous), { id: frame.message_id, deleted_at: frame.deleted_at, deleted_by: frame.deleted_by, body: null, title: null, link_target: null }) }) });
+    }
+    if (frame.type === 'conversation_upsert')
+        return Object.assign(Object.assign({}, state), { conversations: mergeById(state.conversations, payload) });
+    // conversation_archived/participant_changed: the design doc names these frame
+    // types but doesn't pin their exact payload shape. Treating them as merging
+    // onto the conversation record (participant-local fields folded flat, an
+    // `archived` flag set) is this chunk's best-effort reading, not a confirmed
+    // contract — re-verify against dcm's actual WS payload once available, per
+    // the WO's "shape fixtures from the design doc, not from imagination" caution.
+    if (frame.type === 'conversation_archived')
+        return Object.assign(Object.assign({}, state), { conversations: mergeById(state.conversations, Object.assign(Object.assign({}, payload), { id: conversationId, archived: true })) });
+    if (frame.type === 'participant_changed')
+        return Object.assign(Object.assign({}, state), { conversations: mergeById(state.conversations, Object.assign(Object.assign({}, payload), { id: conversationId })) });
+    return state;
+}
+export function MessagingProvider({ children, filters = {}, activeConversationId = null, api = DEFAULT_API, active = true }) {
+    const { subscribe, onReconnect } = useRealtime();
+    const { user } = useContext(AuthContext) || {};
+    const [cache, dispatch] = useReducer(messagingReducer, EMPTY_CACHE);
+    const activeIdRef = useRef(activeConversationId);
+    const seenEventsRef = useRef(new Set());
+    const filtersRef = useRef(filters);
+    activeIdRef.current = activeConversationId;
+    filtersRef.current = filters;
+    const refreshConversations = useCallback(async () => {
+        const response = await api.listConversations(filtersRef.current);
+        dispatch({ type: 'conversationsLoaded', results: resultsOf(response), nextCursor: response === null || response === void 0 ? void 0 : response.next_cursor });
+        return response;
+    }, [api]);
+    const refreshUnread = useCallback(async () => {
+        const unread = await api.getUnreadCount();
+        dispatch({ type: 'unreadLoaded', unread });
+        return unread;
+    }, [api]);
+    const refreshThread = useCallback(async (conversationId = activeIdRef.current, { cursor } = {}) => {
+        if (conversationId == null)
+            return null;
+        const response = await api.listMessages(conversationId, ...(cursor ? [{ cursor }] : []));
+        dispatch({ type: 'messagesLoaded', conversationId, results: resultsOf(response), nextCursor: response === null || response === void 0 ? void 0 : response.next_cursor });
+        return response;
+    }, [api]);
+    const loadMoreMessages = useCallback((conversationId = activeIdRef.current) => {
+        const cursor = cache.cursors.messages[conversationId];
+        return cursor ? refreshThread(conversationId, { cursor }) : Promise.resolve(null);
+    }, [cache.cursors.messages, refreshThread]);
+    const loadThreadReplies = useCallback(async (rootId, { cursor } = {}) => {
+        const response = await api.listThread(rootId, { cursor });
+        dispatch({ type: 'threadLoaded', rootId, results: resultsOf(response), nextCursor: response === null || response === void 0 ? void 0 : response.next_cursor });
+        return response;
+    }, [api]);
+    const getMessageReadStatus = useCallback((messageId) => api.getReadStatus(messageId), [api]);
+    const loadMoreConversations = useCallback(async () => {
+        const cursor = cache.cursors.conversations;
+        if (!cursor)
+            return null;
+        const response = await api.listConversations(Object.assign(Object.assign({}, filtersRef.current), { cursor }));
+        dispatch({ type: 'conversationsLoaded', results: resultsOf(response), nextCursor: response === null || response === void 0 ? void 0 : response.next_cursor });
+        return response;
+    }, [api, cache.cursors.conversations]);
+    const updateConversation = useCallback((conversation) => {
+        dispatch({ type: 'conversationUpsert', conversation });
+        return conversation;
+    }, []);
+    const setConversationArchived = useCallback(async (conversationId, archived) => {
+        var _a;
+        const conversation = await api.archiveConversation(conversationId, archived);
+        return updateConversation(Object.assign(Object.assign({}, conversation), { id: (_a = conversation === null || conversation === void 0 ? void 0 : conversation.id) !== null && _a !== void 0 ? _a : conversationId, archived: Boolean(archived) }));
+    }, [api, updateConversation]);
+    const setConversationPreferences = useCallback(async (conversationId, patch) => {
+        var _a;
+        const conversation = await api.patchConversationPreferences(conversationId, patch);
+        return updateConversation(Object.assign(Object.assign(Object.assign({}, conversation), { id: (_a = conversation === null || conversation === void 0 ? void 0 : conversation.id) !== null && _a !== void 0 ? _a : conversationId }), patch));
+    }, [api, updateConversation]);
+    const markConversationAsRead = useCallback(async (conversationId, readAt) => {
+        const result = await api.markConversationRead(conversationId, readAt);
+        dispatch({ type: 'conversationRead', conversationId });
+        return result;
+    }, [api]);
+    const markReplyThreadRead = useCallback((rootId, readAt) => api.markThreadRead(rootId, readAt), [api]);
+    const openGroupConversation = useCallback(async (payload) => {
+        const conversation = await api.createGroupConversation(payload);
+        return updateConversation(conversation);
+    }, [api, updateConversation]);
+    const openBroadcastConversation = useCallback(async (payload) => {
+        const conversation = await api.createBroadcastConversation(payload);
+        return updateConversation(conversation);
+    }, [api, updateConversation]);
+    const openDirectConversation = useCallback(async (payload) => {
+        const conversation = await api.createDirectConversation(payload);
+        return updateConversation(conversation);
+    }, [api, updateConversation]);
+    const sendMessage = useCallback(async (conversationId, payload, { clientRequestId, retry = false } = {}) => {
+        var _a, _b;
+        const requestId = clientRequestId || payload.client_request_id;
+        const optimistic = Object.assign({ id: `local-${requestId}`, conversation_id: conversationId, kind: payload.kind || 'chat', body: payload.body || '', title: payload.title || null, link_target: payload.link_target || null, reply_to: payload.reply_to || null, client_request_id: requestId, created_at: new Date().toISOString(), status: 'pending', sender: user ? { id: user.id, display_name: user.display_name || user.username } : undefined }, (retry ? {} : {}));
+        if (!retry)
+            dispatch({ type: 'messageOptimistic', message: optimistic });
+        else
+            dispatch({ type: 'messageReconciled', message: Object.assign(Object.assign({}, optimistic), { status: 'pending', error: null }) });
+        try {
+            const message = await api.createMessage(conversationId, Object.assign(Object.assign({}, payload), { client_request_id: requestId }), { idempotencyKey: requestId });
+            dispatch({ type: 'messageReconciled', message: Object.assign(Object.assign({}, message), { conversation_id: (_a = message === null || message === void 0 ? void 0 : message.conversation_id) !== null && _a !== void 0 ? _a : conversationId, client_request_id: (_b = message === null || message === void 0 ? void 0 : message.client_request_id) !== null && _b !== void 0 ? _b : requestId }) });
+            return message;
+        }
+        catch (error) {
+            dispatch({ type: 'messageFailed', clientRequestId: requestId, error: extractApiErrorMessage(error) });
+            throw error;
+        }
+    }, [api, user]);
+    const sendAttachments = useCallback(async (conversationId, formData, { clientRequestId, optimisticMessage, retry = false, onUploadProgress } = {}) => {
+        var _a, _b;
+        const optimistic = {
+            id: `local-${clientRequestId}`, conversation_id: conversationId, kind: 'chat', body: (optimisticMessage === null || optimisticMessage === void 0 ? void 0 : optimisticMessage.body) || '',
+            reply_to: (optimisticMessage === null || optimisticMessage === void 0 ? void 0 : optimisticMessage.reply_to) || null, client_request_id: clientRequestId, created_at: new Date().toISOString(), status: 'pending',
+            sender: user ? { id: user.id, display_name: user.display_name || user.username } : undefined,
+            attachments: (optimisticMessage === null || optimisticMessage === void 0 ? void 0 : optimisticMessage.attachments) || [],
+        };
+        if (!retry)
+            dispatch({ type: 'messageOptimistic', message: optimistic });
+        else
+            dispatch({ type: 'messageReconciled', message: Object.assign(Object.assign({}, optimistic), { status: 'pending', error: null }) });
+        try {
+            const message = await api.uploadAttachments(conversationId, formData, { idempotencyKey: clientRequestId, onUploadProgress });
+            dispatch({ type: 'messageReconciled', message: Object.assign(Object.assign({}, message), { conversation_id: (_a = message === null || message === void 0 ? void 0 : message.conversation_id) !== null && _a !== void 0 ? _a : conversationId, client_request_id: (_b = message === null || message === void 0 ? void 0 : message.client_request_id) !== null && _b !== void 0 ? _b : clientRequestId }) });
+            return message;
+        }
+        catch (error) {
+            dispatch({ type: 'messageFailed', clientRequestId, error: extractApiErrorMessage(error) });
+            throw error;
+        }
+    }, [api, user]);
+    const patchMessage = useCallback((message) => dispatch({ type: 'messagePatched', message }), []);
+    // Keep this API-backed action deliberately distinct from the cache-merge
+    // helper above. The server remains the authority for author/moderator rights.
+    const editMessage = useCallback(async (messageId, patch) => {
+        var _a;
+        const result = await api.patchMessage(messageId, patch);
+        const message = (result === null || result === void 0 ? void 0 : result.message) || result;
+        patchMessage(Object.assign(Object.assign(Object.assign({}, (cache.messages[messageId] || { id: messageId })), (message || {})), { id: (_a = message === null || message === void 0 ? void 0 : message.id) !== null && _a !== void 0 ? _a : messageId }));
+        return result;
+    }, [api, cache.messages, patchMessage]);
+    const removeMessage = useCallback(async (messageId) => {
+        var _a, _b, _c, _d, _e;
+        const result = await api.deleteMessage(messageId);
+        const message = (result === null || result === void 0 ? void 0 : result.message) || result;
+        const previous = cache.messages[messageId] || { id: messageId };
+        patchMessage(Object.assign(Object.assign(Object.assign({}, previous), (message || {})), { id: (_a = message === null || message === void 0 ? void 0 : message.id) !== null && _a !== void 0 ? _a : messageId, deleted_at: (_c = (_b = message === null || message === void 0 ? void 0 : message.deleted_at) !== null && _b !== void 0 ? _b : previous.deleted_at) !== null && _c !== void 0 ? _c : new Date().toISOString(), deleted_by: (_e = (_d = message === null || message === void 0 ? void 0 : message.deleted_by) !== null && _d !== void 0 ? _d : previous.deleted_by) !== null && _e !== void 0 ? _e : user === null || user === void 0 ? void 0 : user.id, body: null, title: null, link_target: null }));
+        return result;
+    }, [api, cache.messages, patchMessage, user]);
+    const toggleReaction = useCallback(async (messageId, emoji, active) => {
+        var _a;
+        const message = cache.messages[messageId] || { id: messageId };
+        const reactions = message.reactions || [];
+        const current = reactions.find((reaction) => reaction.emoji === emoji);
+        const nextReactions = active
+            ? reactions.map((reaction) => reaction.emoji === emoji ? Object.assign(Object.assign({}, reaction), { reacted: false, count: Math.max(0, (reaction.count || 1) - 1) }) : reaction).filter((reaction) => reaction.count !== 0)
+            : current
+                ? reactions.map((reaction) => reaction.emoji === emoji ? Object.assign(Object.assign({}, reaction), { reacted: true, count: (reaction.count || 0) + 1 }) : reaction)
+                : [...reactions, { emoji, count: 1, reacted: true }];
+        patchMessage(Object.assign(Object.assign({}, message), { reactions: nextReactions }));
+        try {
+            const result = active ? await api.removeReaction(messageId, emoji) : await api.addReaction(messageId, emoji);
+            patchMessage(Object.assign(Object.assign(Object.assign({}, message), ((result === null || result === void 0 ? void 0 : result.message) || result)), { reactions: (result === null || result === void 0 ? void 0 : result.reactions) || ((_a = result === null || result === void 0 ? void 0 : result.message) === null || _a === void 0 ? void 0 : _a.reactions) || nextReactions }));
+            return result;
+        }
+        catch (error) {
+            patchMessage(message);
+            throw error;
+        }
+    }, [api, cache.messages, patchMessage]);
+    const createConversationPoll = useCallback(async (conversationId, payload, { clientRequestId } = {}) => {
+        var _a;
+        const poll = await api.createPoll(conversationId, Object.assign(Object.assign({}, payload), { client_request_id: clientRequestId }), { idempotencyKey: clientRequestId });
+        const message = (poll === null || poll === void 0 ? void 0 : poll.message) || poll;
+        if ((message === null || message === void 0 ? void 0 : message.id) != null)
+            patchMessage(Object.assign(Object.assign({}, message), { conversation_id: (_a = message.conversation_id) !== null && _a !== void 0 ? _a : conversationId, poll: message.poll || poll.poll || poll }));
+        return poll;
+    }, [api, patchMessage]);
+    const castPollVote = useCallback(async (messageId, poll, optionIds) => {
+        const result = await api.votePoll(poll.id, optionIds);
+        const nextPoll = Object.assign(Object.assign({}, poll), ((result === null || result === void 0 ? void 0 : result.poll) || result));
+        patchMessage(Object.assign(Object.assign({}, (cache.messages[messageId] || { id: messageId })), { poll: nextPoll }));
+        return result;
+    }, [api, cache.messages, patchMessage]);
+    const closeConversationPoll = useCallback(async (messageId, poll) => {
+        var _a;
+        const result = await api.closePoll(poll.id);
+        const nextPoll = Object.assign(Object.assign(Object.assign({}, poll), ((result === null || result === void 0 ? void 0 : result.poll) || result)), { closed_at: ((_a = result === null || result === void 0 ? void 0 : result.poll) === null || _a === void 0 ? void 0 : _a.closed_at) || (result === null || result === void 0 ? void 0 : result.closed_at) || new Date().toISOString() });
+        patchMessage(Object.assign(Object.assign({}, (cache.messages[messageId] || { id: messageId })), { poll: nextPoll }));
+        return result;
+    }, [api, cache.messages, patchMessage]);
+    const loadConversationConfig = useCallback((conversationId) => api.getConversationConfig(conversationId), [api]);
+    const saveConversationConfig = useCallback((conversationId, patch) => api.patchConversationConfig(conversationId, patch), [api]);
+    const refresh = useCallback(async () => Promise.all([refreshConversations(), refreshUnread(), refreshThread()]), [refreshConversations, refreshThread, refreshUnread]);
+    // `/api/messaging/` is authenticated-only (design §REST). Host apps mount
+    // MessagingProvider inside NotificationsProvider, which itself renders its
+    // children regardless of auth state — so without this gate a provider
+    // mounted before login completes fires three REST calls that spuriously
+    // 401. Defaults to true (matches chunk 1's existing tests/harness usage,
+    // which don't pass it); a host app gates it with `active={authenticated}`.
+    useEffect(() => { if (active)
+        refresh().catch(() => { }); }, [active, refresh]);
+    useEffect(() => subscribe(MESSAGING_ENVELOPE, (frame) => {
+        if (frame.event_id && seenEventsRef.current.has(frame.event_id))
+            return;
+        if (frame.event_id) {
+            seenEventsRef.current.add(frame.event_id);
+            if (seenEventsRef.current.size > 500)
+                seenEventsRef.current.delete(seenEventsRef.current.values().next().value);
+        }
+        dispatch({ type: 'frame', frame, activeConversationId: activeIdRef.current });
+    }), [subscribe]);
+    useEffect(() => {
+        if (!active || !onReconnect)
+            return undefined;
+        return onReconnect(() => { refresh().catch(() => { }); });
+    }, [active, onReconnect, refresh]);
+    const value = useMemo(() => ({
+        cache, refresh, refreshConversations, refreshUnread, refreshThread, loadMoreMessages, loadThreadReplies, getMessageReadStatus, loadMoreConversations,
+        setConversationArchived, setConversationPreferences, openGroupConversation,
+        markConversationRead: markConversationAsRead, markThreadRead: markReplyThreadRead,
+        openBroadcastConversation, openDirectConversation, sendMessage, sendAttachments, editMessage, removeMessage, toggleReaction, createConversationPoll, castPollVote, closeConversationPoll,
+        loadConversationConfig, saveConversationConfig, currentUser: user, getAttachment: api.getAttachment,
+        getAttachmentThumbnail: api.getAttachmentThumbnail, activeConversationId,
+    }), [cache, refresh, refreshConversations, refreshUnread, refreshThread, loadMoreMessages, loadThreadReplies, getMessageReadStatus, loadMoreConversations,
+        setConversationArchived, setConversationPreferences, openGroupConversation, markConversationAsRead, markReplyThreadRead,
+        openBroadcastConversation, openDirectConversation, sendMessage, sendAttachments, editMessage, removeMessage, toggleReaction, createConversationPoll, castPollVote, closeConversationPoll,
+        loadConversationConfig, saveConversationConfig, user, api.getAttachment, api.getAttachmentThumbnail, activeConversationId]);
+    return _jsx(MessagingContext.Provider, { value: value, children: children });
+}
+export function useMessaging() {
+    const context = useOptionalMessaging();
+    if (!context)
+        throw new Error('useMessaging must be used within a MessagingProvider');
+    return context;
+}
+export function useOptionalMessaging() {
+    return useContext(MessagingContext);
+}

package/dist/messaging/MessagingScopeConfig.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert, Box, CircularProgress, FormControl, FormControlLabel, InputLabel, MenuItem, Select, Stack, Switch, Typography } from '@mui/material';
+import { useEffect, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { extractApiErrorMessage, useMessaging } from './MessagingProvider';
+/** Provider-backed scope configuration surface; hosts choose its placement and capability gate. */
+export function MessagingScopeConfig({ conversationId }) {
+    const { t } = useTranslation();
+    const { loadConversationConfig, saveConversationConfig } = useMessaging();
+    const [config, setConfig] = useState(null);
+    const [error, setError] = useState(null);
+    const [saving, setSaving] = useState(false);
+    useEffect(() => { let live = true; loadConversationConfig(conversationId).then((value) => live && setConfig(value)).catch((loadError) => live && setError(t('MessagingConfig.LOAD_ERROR', { message: extractApiErrorMessage(loadError) }))); return () => { live = false; }; }, [conversationId, loadConversationConfig, t]);
+    const update = async (patch) => { setSaving(true); setError(null); try {
+        setConfig(await saveConversationConfig(conversationId, patch));
+    }
+    catch (saveError) {
+        setError(t('MessagingConfig.SAVE_ERROR', { message: extractApiErrorMessage(saveError) }));
+    }
+    finally {
+        setSaving(false);
+    } };
+    if (!config)
+        return error
+            ? _jsx(Alert, { severity: "error", role: "alert", children: error })
+            : _jsx(Box, { "aria-label": t('MessagingConfig.LOADING'), sx: { display: 'flex', justifyContent: 'center', py: 4 }, children: _jsx(CircularProgress, { size: 24 }) });
+    return _jsxs(Stack, { spacing: 1, "aria-label": t('MessagingConfig.LABEL'), children: [_jsx(Typography, { variant: "subtitle1", children: t('MessagingConfig.TITLE') }), error && _jsx(Alert, { severity: "error", role: "alert", children: error }), _jsxs(FormControl, { fullWidth: true, size: "small", disabled: saving, children: [_jsx(InputLabel, { children: t('MessagingConfig.DM_POLICY') }), _jsxs(Select, { label: t('MessagingConfig.DM_POLICY'), value: config.dm_policy || 'all', onChange: (event) => update({ dm_policy: event.target.value }), children: [_jsx(MenuItem, { value: "all", children: t('MessagingConfig.DM_ALL') }), _jsx(MenuItem, { value: "within_shared_groups", children: t('MessagingConfig.DM_SHARED') }), _jsx(MenuItem, { value: "team_only", children: t('MessagingConfig.DM_TEAM') })] })] }), _jsx(FormControlLabel, { control: _jsx(Switch, { checked: Boolean(config.group_chat_enabled), disabled: saving, onChange: (event) => update({ group_chat_enabled: event.target.checked }) }), label: t('MessagingConfig.GROUP_ENABLED') }), _jsx(FormControlLabel, { control: _jsx(Switch, { checked: Boolean(config.everyone_can_post), disabled: saving || !config.group_chat_enabled, onChange: (event) => update({ everyone_can_post: event.target.checked }) }), label: t('MessagingConfig.EVERYONE_POSTS') })] });
+}

package/dist/messaging/PollCard.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert, Button, Checkbox, FormControlLabel, Paper, Stack, Typography } from '@mui/material';
+import { useEffect, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { extractApiErrorMessage, useMessaging } from './MessagingProvider';
+/** Independently mountable live poll view. Server authorization remains authoritative. */
+export function PollCard({ message, canClose: canCloseProp }) {
+    var _a, _b, _c, _d, _e, _f;
+    const { t } = useTranslation();
+    const { castPollVote, closeConversationPoll, currentUser } = useMessaging();
+    const poll = message === null || message === void 0 ? void 0 : message.poll;
+    const [selected, setSelected] = useState([]);
+    const [error, setError] = useState(null);
+    const [busy, setBusy] = useState(false);
+    useEffect(() => setSelected(((poll === null || poll === void 0 ? void 0 : poll.options) || []).filter((option) => option.selected || option.voted).map((option) => option.id)), [poll]);
+    if (!poll)
+        return null;
+    const closed = Boolean(poll.closed_at);
+    const creatorId = (_b = (_a = poll.created_by) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : poll.created_by;
+    const canClose = (_f = (_d = (_c = canCloseProp !== null && canCloseProp !== void 0 ? canCloseProp : poll.can_close) !== null && _c !== void 0 ? _c : message === null || message === void 0 ? void 0 : message.can_close) !== null && _d !== void 0 ? _d : (_e = message === null || message === void 0 ? void 0 : message.permissions) === null || _e === void 0 ? void 0 : _e.can_close) !== null && _f !== void 0 ? _f : (creatorId != null && creatorId === (currentUser === null || currentUser === void 0 ? void 0 : currentUser.id));
+    const changeSelection = (id) => setSelected((current) => poll.allow_multiple ? (current.includes(id) ? current.filter((value) => value !== id) : [...current, id]) : (current.includes(id) ? [] : [id]));
+    const vote = async () => {
+        if (!selected.length) {
+            setError(t('MessagingPoll.SELECT_OPTION'));
+            return;
+        }
+        setBusy(true);
+        setError(null);
+        try {
+            await castPollVote(message.id, poll, selected);
+        }
+        catch (voteError) {
+            setError(t('MessagingPoll.VOTE_ERROR', { message: extractApiErrorMessage(voteError) }));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const close = async () => {
+        setBusy(true);
+        setError(null);
+        try {
+            await closeConversationPoll(message.id, poll);
+        }
+        catch (closeError) {
+            setError(t('MessagingPoll.CLOSE_ERROR', { message: extractApiErrorMessage(closeError) }));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    return _jsx(Paper, { variant: "outlined", sx: { p: 1 }, "aria-label": t('MessagingPoll.LABEL'), children: _jsxs(Stack, { spacing: 0.5, children: [_jsx(Typography, { variant: "subtitle2", children: poll.question }), (poll.options || []).map((option) => { var _a, _b; return _jsx(FormControlLabel, { disabled: closed || busy, control: _jsx(Checkbox, { checked: selected.includes(option.id), onChange: () => changeSelection(option.id) }), label: `${option.text || option.label} (${(_b = (_a = option.vote_count) !== null && _a !== void 0 ? _a : option.votes_count) !== null && _b !== void 0 ? _b : 0})` }, option.id); }), error && _jsx(Alert, { severity: "error", role: "alert", children: error }), _jsxs(Stack, { direction: "row", spacing: 1, children: [_jsx(Button, { size: "small", onClick: vote, disabled: closed || busy, children: t('MessagingPoll.VOTE') }), canClose && !closed && _jsx(Button, { size: "small", color: "warning", onClick: close, disabled: busy, children: t('MessagingPoll.CLOSE') }), closed && _jsx(Typography, { variant: "caption", children: t('MessagingPoll.CLOSED') })] })] }) });
+}

package/dist/messaging/ReactionBar.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import AddReactionOutlinedIcon from '@mui/icons-material/AddReactionOutlined';
+import { Alert, Chip, IconButton, Stack } from '@mui/material';
+import { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { extractApiErrorMessage, useMessaging } from './MessagingProvider';
+export const QUICK_EMOJIS = ['👍', '❤️', '😂', '🎉', '👀'];
+/** Independently mountable aggregate reaction controls for one message. */
+export function ReactionBar({ message }) {
+    const { t } = useTranslation();
+    const { toggleReaction } = useMessaging();
+    const [expanded, setExpanded] = useState(false);
+    const [error, setError] = useState(null);
+    // Tracks in-flight emoji toggles for this message so a rapid double-click
+    // can't fire two concurrent requests for the same emoji — toggleReaction's
+    // rollback-on-failure reverts to a pre-optimistic snapshot, which would
+    // silently discard a second, already-succeeded change if both were in
+    // flight at once. Disabling the chip while its own request is pending
+    // removes the race instead of trying to make concurrent toggles safe.
+    const [pending, setPending] = useState(() => new Set());
+    const reactions = (message === null || message === void 0 ? void 0 : message.reactions) || [];
+    const react = async (emoji, active = false) => {
+        if (pending.has(emoji))
+            return;
+        setError(null);
+        setPending((current) => new Set(current).add(emoji));
+        try {
+            await toggleReaction(message.id, emoji, active);
+        }
+        catch (reactionError) {
+            setError(t('MessagingReactions.ERROR', { message: extractApiErrorMessage(reactionError) }));
+        }
+        finally {
+            setPending((current) => { const next = new Set(current); next.delete(emoji); return next; });
+        }
+    };
+    return _jsxs(Stack, { spacing: 0.5, "aria-label": t('MessagingReactions.LABEL'), children: [_jsxs(Stack, { direction: "row", spacing: 0.5, flexWrap: "wrap", children: [reactions.map((reaction) => _jsx(Chip, { size: "small", disabled: pending.has(reaction.emoji), color: reaction.reacted ? 'primary' : 'default', label: `${reaction.emoji} ${reaction.count || 0}`, onClick: () => react(reaction.emoji, Boolean(reaction.reacted)), "aria-label": t('MessagingReactions.TOGGLE', { emoji: reaction.emoji, count: reaction.count || 0 }) }, reaction.emoji)), _jsx(IconButton, { size: "small", "aria-label": t('MessagingReactions.ADD'), onClick: () => setExpanded((value) => !value), children: _jsx(AddReactionOutlinedIcon, { fontSize: "small" }) })] }), expanded && _jsx(Stack, { direction: "row", spacing: 0.25, flexWrap: "wrap", children: QUICK_EMOJIS.map((emoji) => {
+                    // A quick-emoji already reflected in the aggregate row must toggle it
+                    // off, not re-add it — otherwise clicking an already-reacted emoji here
+                    // optimistically double-increments the count before the API call.
+                    const existing = reactions.find((reaction) => reaction.emoji === emoji);
+                    return _jsx(Chip, { size: "small", disabled: pending.has(emoji), color: (existing === null || existing === void 0 ? void 0 : existing.reacted) ? 'primary' : 'default', label: emoji, onClick: () => { react(emoji, Boolean(existing === null || existing === void 0 ? void 0 : existing.reacted)); setExpanded(false); } }, emoji);
+                }) }), error && _jsx(Alert, { severity: "error", role: "alert", children: error })] });
+}

package/dist/messaging/ReadTicks.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { ButtonBase, List, ListItem, Popover, Typography } from '@mui/material';
+import { useEffect, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { useMessaging } from './MessagingProvider';
+/** Renders only the aggregate receipt unless the server explicitly supplies permitted detail. */
+export function ReadTicks({ messageId, conversation }) {
+    const { t } = useTranslation();
+    const { getMessageReadStatus } = useMessaging();
+    const [status, setStatus] = useState(null);
+    const [anchorEl, setAnchorEl] = useState(null);
+    useEffect(() => {
+        let mounted = true;
+        getMessageReadStatus(messageId).then((next) => { if (mounted)
+            setStatus(next); }).catch(() => { if (mounted)
+            setStatus(null); });
+        return () => { mounted = false; };
+    }, [getMessageReadStatus, messageId]);
+    if (!status)
+        return null;
+    const label = status.all_read ? t('MessagingReadTicks.ALL_READ') : t('MessagingReadTicks.DELIVERED', { count: status.delivered_count || 0 });
+    // The server never returns DM detail; enforce the same carve-out defensively.
+    const detail = (conversation === null || conversation === void 0 ? void 0 : conversation.kind) === 'direct' ? null : status.recipient_detail;
+    const recipients = (detail === null || detail === void 0 ? void 0 : detail.map((recipient) => recipient.display_name || recipient.username || recipient.user_id).filter(Boolean)) || [];
+    if (!recipients.length)
+        return _jsx(Typography, { component: "span", variant: "caption", color: "text.secondary", "aria-label": label, children: label });
+    return _jsxs(_Fragment, { children: [_jsx(ButtonBase, { "aria-label": label, "aria-haspopup": "dialog", "aria-expanded": Boolean(anchorEl), onClick: (event) => setAnchorEl(event.currentTarget), sx: { typography: 'caption', color: 'text.secondary', textDecoration: 'underline' }, children: label }), _jsx(Popover, { open: Boolean(anchorEl), anchorEl: anchorEl, onClose: () => setAnchorEl(null), children: _jsx(List, { "aria-label": t('MessagingReadTicks.RECIPIENTS'), children: recipients.map((recipient) => _jsx(ListItem, { children: recipient }, recipient)) }) })] });
+}