@samirify/messenger 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Samirify
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @samirify/messenger
+
+MIT-licensed trainer↔client messenger UI and hooks for React Native and web.
+
+## Install
+
+```bash
+npm install @samirify/messenger
+```
+
+Peer deps: `react`, `@tanstack/react-query`. Optional: `react-native` (native entry), `react-dom` + `framer-motion` (web entry).
+
+## Entries
+
+| Import | Surface |
+|--------|---------|
+| `@samirify/messenger` | Core: provider, hooks, deep links |
+| `@samirify/messenger/native` | RN `InboxScreen` / `ThreadScreen` |
+| `@samirify/messenger/web` | DOM `ChatDock` / `ChatPanel` |
+
+Wire a host adapter (`MessengerProvider`) with auth HTTP, theme, i18n, and navigation.

package/dist/index.cjs

@@ -0,0 +1,302 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+var reactQuery = require('@tanstack/react-query');
+
+// src/api.ts
+async function listThreads(http) {
+  const res = await http.getJson(
+    "/api/messages/threads"
+  );
+  return { ...res, data: res.data?.threads ?? [] };
+}
+async function openThread(http, clientUserId) {
+  return http.postJson("/api/messages/threads", {
+    ...clientUserId ? { client_user_id: clientUserId } : {}
+  });
+}
+async function getThread(http, threadId, limit = 50, beforeId) {
+  const params = new URLSearchParams({ limit: String(limit) });
+  if (beforeId != null) params.set("before_id", String(beforeId));
+  return http.getJson(`/api/messages/threads/${threadId}?${params.toString()}`);
+}
+async function sendMessage(http, threadId, body, image) {
+  const path = `/api/messages/threads/${threadId}/messages`;
+  if (image?.uri || image?.file) {
+    const form = new FormData();
+    if (body.trim()) form.append("body", body.trim());
+    const filename = image.name ?? image.uri?.split("/").pop() ?? "photo.jpg";
+    const match = /\.(\w+)$/.exec(filename);
+    const type = image.type ?? (match ? `image/${match[1]}` : "image/jpeg");
+    if (image.file) {
+      form.append("image", image.file, filename);
+    } else if (image.uri.startsWith("blob:") || image.uri.startsWith("data:")) {
+      const blob = await fetch(image.uri).then((r) => r.blob());
+      form.append("image", blob, filename);
+    } else {
+      form.append("image", {
+        uri: image.uri,
+        name: filename,
+        type
+      });
+    }
+    return http.postForm(path, form);
+  }
+  return http.postJson(path, { body });
+}
+async function markThreadRead(http, threadId) {
+  return http.patchJson(`/api/messages/threads/${threadId}/read`, {});
+}
+function sumUnread(threads) {
+  return threads.reduce((sum, th) => sum + Number(th.unread_count ?? 0), 0);
+}
+
+// src/queryKeys.ts
+var messengerKeys = {
+  all: ["messenger"],
+  threads: () => [...messengerKeys.all, "threads"],
+  thread: (id) => [...messengerKeys.all, "thread", id]
+};
+
+// src/i18nKeys.ts
+var MessengerI18n = {
+  off: {
+    key: "mobile.messenger.off",
+    fallback: "Messaging is not enabled for this account."
+  },
+  inbox: { key: "mobile.messenger.inbox", fallback: "Chat" },
+  chat: { key: "mobile.messenger.chat", fallback: "Chat" },
+  /** Dock / list title — prefer over inbox for web UI copy. */
+  messages: { key: "mobile.messenger.messages", fallback: "Chat" },
+  messagesHint: {
+    key: "mobile.messenger.messagesHint",
+    fallback: "Message your coach anytime"
+  },
+  messageCoach: {
+    key: "mobile.messenger.messageCoach",
+    fallback: "Message your coach"
+  },
+  empty: {
+    key: "mobile.messenger.empty",
+    fallback: "No conversations yet"
+  },
+  yourCoach: {
+    key: "mobile.messenger.yourCoach",
+    fallback: "Your coach"
+  },
+  photo: { key: "mobile.messenger.photo", fallback: "Photo" },
+  noMessages: {
+    key: "mobile.messenger.noMessages",
+    fallback: "No messages yet"
+  },
+  startConversation: {
+    key: "mobile.messenger.startConversation",
+    fallback: "Say hello \u2014 send the first message."
+  },
+  typeMessage: {
+    key: "mobile.messenger.typeMessage",
+    fallback: "Type a message\u2026"
+  },
+  client: { key: "mobile.trainer.client", fallback: "Client" },
+  back: { key: "common.back", fallback: "Back" }
+};
+
+// src/deepLink.ts
+function resolveMessageNotificationRoute(data) {
+  if (!data) return null;
+  const type = data.type ?? data.notification_type;
+  const link = typeof data.link === "string" ? data.link : "";
+  const isMessage = type === "message" || link === "/messages" || link.startsWith("/messages/");
+  if (!isMessage) return null;
+  const raw = data.thread_id ?? data.threadId ?? (typeof link === "string" ? link.match(/\/messages\/(\d+)/)?.[1] : null);
+  const threadId = raw != null ? Number(raw) : NaN;
+  if (Number.isFinite(threadId) && threadId > 0) {
+    return { kind: "thread", threadId };
+  }
+  return { kind: "inbox" };
+}
+var MessengerContext = react.createContext(null);
+function MessengerProvider({
+  config,
+  children
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsx(MessengerContext.Provider, { value: config, children });
+}
+function useMessengerConfig() {
+  const ctx = react.useContext(MessengerContext);
+  if (!ctx) {
+    throw new Error(
+      "@gymlium/messenger: useMessengerConfig must be used within MessengerProvider"
+    );
+  }
+  return ctx;
+}
+function useOptionalMessengerConfig() {
+  return react.useContext(MessengerContext);
+}
+var MessengerUiContext = react.createContext(null);
+function MessengerUiProvider({ children }) {
+  const [open, setOpen] = react.useState(false);
+  const [threadId, setThreadId] = react.useState(null);
+  const openInbox = react.useCallback(() => {
+    setThreadId(null);
+    setOpen(true);
+  }, []);
+  const openThread2 = react.useCallback((id) => {
+    setThreadId(id);
+    setOpen(true);
+  }, []);
+  const close = react.useCallback(() => {
+    setOpen(false);
+  }, []);
+  const value = react.useMemo(
+    () => ({
+      open,
+      threadId,
+      openInbox,
+      openThread: openThread2,
+      close,
+      setOpen
+    }),
+    [open, threadId, openInbox, openThread2, close]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(MessengerUiContext.Provider, { value, children });
+}
+function useMessengerUi() {
+  const ctx = react.useContext(MessengerUiContext);
+  if (!ctx) {
+    throw new Error(
+      "@gymlium/messenger: useMessengerUi must be used within MessengerUiProvider"
+    );
+  }
+  return ctx;
+}
+function useOptionalMessengerUi() {
+  return react.useContext(MessengerUiContext);
+}
+function useThreads(options) {
+  const { http, enabled: featureOn } = useMessengerConfig();
+  const enabled = (options?.enabled ?? true) && featureOn;
+  return reactQuery.useQuery({
+    queryKey: messengerKeys.threads(),
+    queryFn: async () => {
+      const res = await listThreads(http);
+      if (!res.success) {
+        throw new Error(res.message ?? "Failed to load threads");
+      }
+      return res.data;
+    },
+    enabled
+  });
+}
+var POLL_MS = 18e3;
+function useThread(threadId, options) {
+  const { http, enabled: featureOn } = useMessengerConfig();
+  const enabled = (options?.enabled ?? true) && featureOn && Number.isFinite(threadId) && threadId > 0;
+  const poll = options?.poll ?? true;
+  return reactQuery.useQuery({
+    queryKey: messengerKeys.thread(threadId),
+    queryFn: async () => {
+      const res = await getThread(http, threadId);
+      if (!res.success) {
+        throw new Error(res.message ?? "Failed to load thread");
+      }
+      return res.data;
+    },
+    enabled,
+    refetchInterval: enabled && poll ? POLL_MS : false
+  });
+}
+function useSendMessage(threadId) {
+  const { http } = useMessengerConfig();
+  const qc = reactQuery.useQueryClient();
+  return reactQuery.useMutation({
+    mutationFn: async (input) => {
+      const res = await sendMessage(http, threadId, input.body, input.image);
+      if (!res.success || !res.data?.message) {
+        throw new Error(res.message ?? "Send failed");
+      }
+      return res.data.message;
+    },
+    onSuccess: (message) => {
+      qc.setQueryData(
+        messengerKeys.thread(threadId),
+        (prev) => {
+          if (!prev) return prev;
+          if (prev.messages.some((m) => m.id === message.id)) return prev;
+          return { ...prev, messages: [...prev.messages, message] };
+        }
+      );
+      void qc.invalidateQueries({ queryKey: messengerKeys.threads() });
+    }
+  });
+}
+function useOpenThread() {
+  const { http, navigation } = useMessengerConfig();
+  const qc = reactQuery.useQueryClient();
+  return reactQuery.useMutation({
+    mutationFn: async (clientUserId) => {
+      const res = await openThread(http, clientUserId);
+      if (!res.success || !res.data?.thread?.id) {
+        throw new Error(res.message ?? "Could not open thread");
+      }
+      return res.data.thread;
+    },
+    onSuccess: (thread) => {
+      void qc.invalidateQueries({ queryKey: messengerKeys.threads() });
+      navigation.openThread(thread.id);
+    }
+  });
+}
+function useUnreadTotal(options) {
+  const cfg = useOptionalMessengerConfig();
+  const featureOn = cfg?.enabled === true;
+  const http = cfg?.http;
+  const enabled = (options?.enabled ?? true) && featureOn && !!http;
+  const query = reactQuery.useQuery({
+    queryKey: messengerKeys.threads(),
+    queryFn: async () => {
+      const res = await listThreads(http);
+      if (!res.success) {
+        throw new Error(res.message ?? "Failed to load threads");
+      }
+      return res.data;
+    },
+    enabled
+  });
+  const total = react.useMemo(
+    () => query.data ? sumUnread(query.data) : 0,
+    [query.data]
+  );
+  return {
+    total,
+    isLoading: query.isLoading,
+    isFetching: query.isFetching,
+    refetch: query.refetch,
+    enabled: featureOn
+  };
+}
+
+exports.MessengerI18n = MessengerI18n;
+exports.MessengerProvider = MessengerProvider;
+exports.MessengerUiProvider = MessengerUiProvider;
+exports.getThread = getThread;
+exports.listThreads = listThreads;
+exports.markThreadRead = markThreadRead;
+exports.messengerKeys = messengerKeys;
+exports.openThread = openThread;
+exports.resolveMessageNotificationRoute = resolveMessageNotificationRoute;
+exports.sendMessage = sendMessage;
+exports.sumUnread = sumUnread;
+exports.useMessengerConfig = useMessengerConfig;
+exports.useMessengerUi = useMessengerUi;
+exports.useOpenThread = useOpenThread;
+exports.useOptionalMessengerConfig = useOptionalMessengerConfig;
+exports.useOptionalMessengerUi = useOptionalMessengerUi;
+exports.useSendMessage = useSendMessage;
+exports.useThread = useThread;
+exports.useThreads = useThreads;
+exports.useUnreadTotal = useUnreadTotal;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api.ts","../src/queryKeys.ts","../src/i18nKeys.ts","../src/deepLink.ts","../src/provider.tsx","../src/uiController.tsx","../src/hooks/useThreads.ts","../src/hooks/useThread.ts","../src/hooks/useSendMessage.ts","../src/hooks/useOpenThread.ts","../src/hooks/useUnreadTotal.ts"],"names":["createContext","useContext","useState","useCallback","openThread","useMemo","jsx","useQuery","useQueryClient","useMutation"],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n  ApiResult,\n  ChatMessage,\n  MessageThread,\n  MessengerHttp,\n  PickedImage,\n} from \"./types\";\n\nexport async function listThreads(\n  http: MessengerHttp\n): Promise<ApiResult<MessageThread[]>> {\n  const res = await http.getJson<{ threads: MessageThread[] }>(\n    \"/api/messages/threads\"\n  );\n  return { ...res, data: res.data?.threads ?? [] };\n}\n\nexport async function openThread(\n  http: MessengerHttp,\n  clientUserId?: number\n): Promise<ApiResult<{ thread: MessageThread }>> {\n  return http.postJson<{ thread: MessageThread }>(\"/api/messages/threads\", {\n    ...(clientUserId ? { client_user_id: clientUserId } : {}),\n  });\n}\n\nexport async function getThread(\n  http: MessengerHttp,\n  threadId: number,\n  limit = 50,\n  beforeId?: number\n): Promise<ApiResult<{ thread: MessageThread; messages: ChatMessage[] }>> {\n  const params = new URLSearchParams({ limit: String(limit) });\n  if (beforeId != null) params.set(\"before_id\", String(beforeId));\n  return http.getJson(`/api/messages/threads/${threadId}?${params.toString()}`);\n}\n\nexport async function sendMessage(\n  http: MessengerHttp,\n  threadId: number,\n  body: string,\n  image?: PickedImage | null\n): Promise<ApiResult<{ message: ChatMessage }>> {\n  const path = `/api/messages/threads/${threadId}/messages`;\n  if (image?.uri || image?.file) {\n    const form = new FormData();\n    if (body.trim()) form.append(\"body\", body.trim());\n    const filename =\n      image.name ??\n      image.uri?.split(\"/\").pop() ??\n      \"photo.jpg\";\n    const match = /\\.(\\w+)$/.exec(filename);\n    const type =\n      image.type ?? (match ? `image/${match[1]}` : \"image/jpeg\");\n\n    if (image.file) {\n      form.append(\"image\", image.file, filename);\n    } else if (image.uri.startsWith(\"blob:\") || image.uri.startsWith(\"data:\")) {\n      const blob = await fetch(image.uri).then((r) => r.blob());\n      form.append(\"image\", blob, filename);\n    } else {\n      // React Native FormData file shape\n      form.append(\"image\", {\n        uri: image.uri,\n        name: filename,\n        type,\n      } as unknown as Blob);\n    }\n    return http.postForm<{ message: ChatMessage }>(path, form);\n  }\n  return http.postJson<{ message: ChatMessage }>(path, { body });\n}\n\nexport async function markThreadRead(\n  http: MessengerHttp,\n  threadId: number\n): Promise<ApiResult<{ success: boolean }>> {\n  return http.patchJson(`/api/messages/threads/${threadId}/read`, {});\n}\n\nexport function sumUnread(threads: MessageThread[]): number {\n  return threads.reduce((sum, th) => sum + Number(th.unread_count ?? 0), 0);\n}\n","export const messengerKeys = {\n  all: [\"messenger\"] as const,\n  threads: () => [...messengerKeys.all, \"threads\"] as const,\n  thread: (id: number) => [...messengerKeys.all, \"thread\", id] as const,\n};\n","/** Stable i18n keys + English fallbacks used by the package UI. */\nexport const MessengerI18n = {\n  off: {\n    key: \"mobile.messenger.off\",\n    fallback: \"Messaging is not enabled for this account.\",\n  },\n  inbox: { key: \"mobile.messenger.inbox\", fallback: \"Chat\" },\n  chat: { key: \"mobile.messenger.chat\", fallback: \"Chat\" },\n  /** Dock / list title — prefer over inbox for web UI copy. */\n  messages: { key: \"mobile.messenger.messages\", fallback: \"Chat\" },\n  messagesHint: {\n    key: \"mobile.messenger.messagesHint\",\n    fallback: \"Message your coach anytime\",\n  },\n  messageCoach: {\n    key: \"mobile.messenger.messageCoach\",\n    fallback: \"Message your coach\",\n  },\n  empty: {\n    key: \"mobile.messenger.empty\",\n    fallback: \"No conversations yet\",\n  },\n  yourCoach: {\n    key: \"mobile.messenger.yourCoach\",\n    fallback: \"Your coach\",\n  },\n  photo: { key: \"mobile.messenger.photo\", fallback: \"Photo\" },\n  noMessages: {\n    key: \"mobile.messenger.noMessages\",\n    fallback: \"No messages yet\",\n  },\n  startConversation: {\n    key: \"mobile.messenger.startConversation\",\n    fallback: \"Say hello — send the first message.\",\n  },\n  typeMessage: {\n    key: \"mobile.messenger.typeMessage\",\n    fallback: \"Type a message…\",\n  },\n  client: { key: \"mobile.trainer.client\", fallback: \"Client\" },\n  back: { key: \"common.back\", fallback: \"Back\" },\n} as const;\n","/**\n * Resolve inbox vs thread route hints from push / in-app notification payloads.\n * Host maps the result onto its router (Expo Router, Next.js, etc.).\n */\nexport type MessageDeepLink =\n  | { kind: \"inbox\" }\n  | { kind: \"thread\"; threadId: number }\n  | null;\n\nexport function resolveMessageNotificationRoute(\n  data: Record<string, unknown> | null | undefined\n): MessageDeepLink {\n  if (!data) return null;\n  const type = data.type ?? data.notification_type;\n  const link = typeof data.link === \"string\" ? data.link : \"\";\n  const isMessage =\n    type === \"message\" || link === \"/messages\" || link.startsWith(\"/messages/\");\n\n  if (!isMessage) return null;\n\n  const raw =\n    data.thread_id ??\n    data.threadId ??\n    (typeof link === \"string\" ? link.match(/\\/messages\\/(\\d+)/)?.[1] : null);\n\n  const threadId = raw != null ? Number(raw) : NaN;\n  if (Number.isFinite(threadId) && threadId > 0) {\n    return { kind: \"thread\", threadId };\n  }\n  return { kind: \"inbox\" };\n}\n","import React, { createContext, useContext, type ReactNode } from \"react\";\nimport type { MessengerConfig } from \"./types\";\n\nconst MessengerContext = createContext<MessengerConfig | null>(null);\n\nexport function MessengerProvider({\n  config,\n  children,\n}: {\n  config: MessengerConfig;\n  children: ReactNode;\n}) {\n  return (\n    <MessengerContext.Provider value={config}>\n      {children}\n    </MessengerContext.Provider>\n  );\n}\n\nexport function useMessengerConfig(): MessengerConfig {\n  const ctx = useContext(MessengerContext);\n  if (!ctx) {\n    throw new Error(\n      \"@gymlium/messenger: useMessengerConfig must be used within MessengerProvider\"\n    );\n  }\n  return ctx;\n}\n\n/** Safe variant for optional host chrome (returns null outside provider). */\nexport function useOptionalMessengerConfig(): MessengerConfig | null {\n  return useContext(MessengerContext);\n}\n","import React, {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n  type ReactNode,\n} from \"react\";\n\nexport interface MessengerUiState {\n  open: boolean;\n  threadId: number | null;\n  openInbox: () => void;\n  openThread: (threadId: number) => void;\n  close: () => void;\n  setOpen: (open: boolean) => void;\n}\n\nconst MessengerUiContext = createContext<MessengerUiState | null>(null);\n\nexport function MessengerUiProvider({ children }: { children: ReactNode }) {\n  const [open, setOpen] = useState(false);\n  const [threadId, setThreadId] = useState<number | null>(null);\n\n  const openInbox = useCallback(() => {\n    setThreadId(null);\n    setOpen(true);\n  }, []);\n\n  const openThread = useCallback((id: number) => {\n    setThreadId(id);\n    setOpen(true);\n  }, []);\n\n  const close = useCallback(() => {\n    setOpen(false);\n  }, []);\n\n  const value = useMemo(\n    () => ({\n      open,\n      threadId,\n      openInbox,\n      openThread,\n      close,\n      setOpen,\n    }),\n    [open, threadId, openInbox, openThread, close]\n  );\n\n  return (\n    <MessengerUiContext.Provider value={value}>\n      {children}\n    </MessengerUiContext.Provider>\n  );\n}\n\nexport function useMessengerUi(): MessengerUiState {\n  const ctx = useContext(MessengerUiContext);\n  if (!ctx) {\n    throw new Error(\n      \"@gymlium/messenger: useMessengerUi must be used within MessengerUiProvider\"\n    );\n  }\n  return ctx;\n}\n\nexport function useOptionalMessengerUi(): MessengerUiState | null {\n  return useContext(MessengerUiContext);\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { listThreads } from \"../api\";\nimport { messengerKeys } from \"../queryKeys\";\nimport { useMessengerConfig } from \"../provider\";\n\nexport function useThreads(options?: { enabled?: boolean }) {\n  const { http, enabled: featureOn } = useMessengerConfig();\n  const enabled = (options?.enabled ?? true) && featureOn;\n\n  return useQuery({\n    queryKey: messengerKeys.threads(),\n    queryFn: async () => {\n      const res = await listThreads(http);\n      if (!res.success) {\n        throw new Error(res.message ?? \"Failed to load threads\");\n      }\n      return res.data;\n    },\n    enabled,\n  });\n}\n","import { useQuery } from \"@tanstack/react-query\";\nimport { getThread } from \"../api\";\nimport { messengerKeys } from \"../queryKeys\";\nimport { useMessengerConfig } from \"../provider\";\n\nconst POLL_MS = 18_000;\n\nexport function useThread(\n  threadId: number,\n  options?: { enabled?: boolean; poll?: boolean }\n) {\n  const { http, enabled: featureOn } = useMessengerConfig();\n  const enabled =\n    (options?.enabled ?? true) && featureOn && Number.isFinite(threadId) && threadId > 0;\n  const poll = options?.poll ?? true;\n\n  return useQuery({\n    queryKey: messengerKeys.thread(threadId),\n    queryFn: async () => {\n      const res = await getThread(http, threadId);\n      if (!res.success) {\n        throw new Error(res.message ?? \"Failed to load thread\");\n      }\n      return res.data;\n    },\n    enabled,\n    refetchInterval: enabled && poll ? POLL_MS : false,\n  });\n}\n","import { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport { sendMessage } from \"../api\";\nimport { messengerKeys } from \"../queryKeys\";\nimport { useMessengerConfig } from \"../provider\";\nimport type { ChatMessage, PickedImage } from \"../types\";\n\nexport function useSendMessage(threadId: number) {\n  const { http } = useMessengerConfig();\n  const qc = useQueryClient();\n\n  return useMutation({\n    mutationFn: async (input: { body: string; image?: PickedImage | null }) => {\n      const res = await sendMessage(http, threadId, input.body, input.image);\n      if (!res.success || !res.data?.message) {\n        throw new Error(res.message ?? \"Send failed\");\n      }\n      return res.data.message as ChatMessage;\n    },\n    onSuccess: (message: ChatMessage) => {\n      qc.setQueryData(\n        messengerKeys.thread(threadId),\n        (prev: { thread: unknown; messages: ChatMessage[] } | undefined) => {\n          if (!prev) return prev;\n          if (prev.messages.some((m) => m.id === message.id)) return prev;\n          return { ...prev, messages: [...prev.messages, message] };\n        }\n      );\n      void qc.invalidateQueries({ queryKey: messengerKeys.threads() });\n    },\n  });\n}\n","import { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport { openThread } from \"../api\";\nimport { messengerKeys } from \"../queryKeys\";\nimport { useMessengerConfig } from \"../provider\";\nimport type { MessageThread } from \"../types\";\n\nexport function useOpenThread() {\n  const { http, navigation } = useMessengerConfig();\n  const qc = useQueryClient();\n\n  return useMutation({\n    mutationFn: async (clientUserId?: number) => {\n      const res = await openThread(http, clientUserId);\n      if (!res.success || !res.data?.thread?.id) {\n        throw new Error(res.message ?? \"Could not open thread\");\n      }\n      return res.data.thread as MessageThread;\n    },\n    onSuccess: (thread: MessageThread) => {\n      void qc.invalidateQueries({ queryKey: messengerKeys.threads() });\n      navigation.openThread(thread.id);\n    },\n  });\n}\n","import { useMemo } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { listThreads, sumUnread } from \"../api\";\nimport { messengerKeys } from \"../queryKeys\";\nimport { useOptionalMessengerConfig } from \"../provider\";\n\n/**\n * Total unread across threads. Works outside MessengerProvider (returns 0).\n * Prefer mounting MessengerProvider above host chrome that needs this.\n */\nexport function useUnreadTotal(options?: { enabled?: boolean }) {\n  const cfg = useOptionalMessengerConfig();\n  const featureOn = cfg?.enabled === true;\n  const http = cfg?.http;\n  const enabled = (options?.enabled ?? true) && featureOn && !!http;\n\n  const query = useQuery({\n    queryKey: messengerKeys.threads(),\n    queryFn: async () => {\n      const res = await listThreads(http!);\n      if (!res.success) {\n        throw new Error(res.message ?? \"Failed to load threads\");\n      }\n      return res.data;\n    },\n    enabled,\n  });\n\n  const total = useMemo(\n    () => (query.data ? sumUnread(query.data) : 0),\n    [query.data]\n  );\n\n  return {\n    total,\n    isLoading: query.isLoading,\n    isFetching: query.isFetching,\n    refetch: query.refetch,\n    enabled: featureOn,\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,157 @@
+import { M as MessengerHttp, A as ApiResult, a as MessageThread, C as ChatMessage, P as PickedImage, b as MessengerConfig } from './types-B7dU_l7c.cjs';
+export { c as MessengerNavigation, d as MessengerTheme, e as MessengerUser, T as TranslateFn } from './types-B7dU_l7c.cjs';
+import React, { ReactNode } from 'react';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import * as _tanstack_query_core from '@tanstack/query-core';
+
+declare function listThreads(http: MessengerHttp): Promise<ApiResult<MessageThread[]>>;
+declare function openThread(http: MessengerHttp, clientUserId?: number): Promise<ApiResult<{
+    thread: MessageThread;
+}>>;
+declare function getThread(http: MessengerHttp, threadId: number, limit?: number, beforeId?: number): Promise<ApiResult<{
+    thread: MessageThread;
+    messages: ChatMessage[];
+}>>;
+declare function sendMessage(http: MessengerHttp, threadId: number, body: string, image?: PickedImage | null): Promise<ApiResult<{
+    message: ChatMessage;
+}>>;
+declare function markThreadRead(http: MessengerHttp, threadId: number): Promise<ApiResult<{
+    success: boolean;
+}>>;
+declare function sumUnread(threads: MessageThread[]): number;
+
+declare const messengerKeys: {
+    all: readonly ["messenger"];
+    threads: () => readonly ["messenger", "threads"];
+    thread: (id: number) => readonly ["messenger", "thread", number];
+};
+
+/** Stable i18n keys + English fallbacks used by the package UI. */
+declare const MessengerI18n: {
+    readonly off: {
+        readonly key: "mobile.messenger.off";
+        readonly fallback: "Messaging is not enabled for this account.";
+    };
+    readonly inbox: {
+        readonly key: "mobile.messenger.inbox";
+        readonly fallback: "Chat";
+    };
+    readonly chat: {
+        readonly key: "mobile.messenger.chat";
+        readonly fallback: "Chat";
+    };
+    /** Dock / list title — prefer over inbox for web UI copy. */
+    readonly messages: {
+        readonly key: "mobile.messenger.messages";
+        readonly fallback: "Chat";
+    };
+    readonly messagesHint: {
+        readonly key: "mobile.messenger.messagesHint";
+        readonly fallback: "Message your coach anytime";
+    };
+    readonly messageCoach: {
+        readonly key: "mobile.messenger.messageCoach";
+        readonly fallback: "Message your coach";
+    };
+    readonly empty: {
+        readonly key: "mobile.messenger.empty";
+        readonly fallback: "No conversations yet";
+    };
+    readonly yourCoach: {
+        readonly key: "mobile.messenger.yourCoach";
+        readonly fallback: "Your coach";
+    };
+    readonly photo: {
+        readonly key: "mobile.messenger.photo";
+        readonly fallback: "Photo";
+    };
+    readonly noMessages: {
+        readonly key: "mobile.messenger.noMessages";
+        readonly fallback: "No messages yet";
+    };
+    readonly startConversation: {
+        readonly key: "mobile.messenger.startConversation";
+        readonly fallback: "Say hello — send the first message.";
+    };
+    readonly typeMessage: {
+        readonly key: "mobile.messenger.typeMessage";
+        readonly fallback: "Type a message…";
+    };
+    readonly client: {
+        readonly key: "mobile.trainer.client";
+        readonly fallback: "Client";
+    };
+    readonly back: {
+        readonly key: "common.back";
+        readonly fallback: "Back";
+    };
+};
+
+/**
+ * Resolve inbox vs thread route hints from push / in-app notification payloads.
+ * Host maps the result onto its router (Expo Router, Next.js, etc.).
+ */
+type MessageDeepLink = {
+    kind: "inbox";
+} | {
+    kind: "thread";
+    threadId: number;
+} | null;
+declare function resolveMessageNotificationRoute(data: Record<string, unknown> | null | undefined): MessageDeepLink;
+
+declare function MessengerProvider({ config, children, }: {
+    config: MessengerConfig;
+    children: ReactNode;
+}): React.JSX.Element;
+declare function useMessengerConfig(): MessengerConfig;
+/** Safe variant for optional host chrome (returns null outside provider). */
+declare function useOptionalMessengerConfig(): MessengerConfig | null;
+
+interface MessengerUiState {
+    open: boolean;
+    threadId: number | null;
+    openInbox: () => void;
+    openThread: (threadId: number) => void;
+    close: () => void;
+    setOpen: (open: boolean) => void;
+}
+declare function MessengerUiProvider({ children }: {
+    children: ReactNode;
+}): React.JSX.Element;
+declare function useMessengerUi(): MessengerUiState;
+declare function useOptionalMessengerUi(): MessengerUiState | null;
+
+declare function useThreads(options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<MessageThread[]>, Error>;
+
+declare function useThread(threadId: number, options?: {
+    enabled?: boolean;
+    poll?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    thread: MessageThread;
+    messages: ChatMessage[];
+}>, Error>;
+
+declare function useSendMessage(threadId: number): _tanstack_react_query.UseMutationResult<ChatMessage, Error, {
+    body: string;
+    image?: PickedImage | null;
+}, unknown>;
+
+declare function useOpenThread(): _tanstack_react_query.UseMutationResult<MessageThread, Error, number | undefined, unknown>;
+
+/**
+ * Total unread across threads. Works outside MessengerProvider (returns 0).
+ * Prefer mounting MessengerProvider above host chrome that needs this.
+ */
+declare function useUnreadTotal(options?: {
+    enabled?: boolean;
+}): {
+    total: number;
+    isLoading: boolean;
+    isFetching: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<MessageThread[]>, Error>>;
+    enabled: boolean;
+};
+
+export { ApiResult, ChatMessage, type MessageDeepLink, MessageThread, MessengerConfig, MessengerHttp, MessengerI18n, MessengerProvider, MessengerUiProvider, PickedImage, getThread, listThreads, markThreadRead, messengerKeys, openThread, resolveMessageNotificationRoute, sendMessage, sumUnread, useMessengerConfig, useMessengerUi, useOpenThread, useOptionalMessengerConfig, useOptionalMessengerUi, useSendMessage, useThread, useThreads, useUnreadTotal };