@appsupportkit/support-sdk 0.1.1 → 0.2.0

package/lib/module/theme.js

@@ -1,23 +1,142 @@
 "use strict";
 
 // The SDK consumes the same design tokens as the admin dashboard, so both
-// surfaces look like one product.
+// surfaces look like one product. On top of those it adds the few values
+// that only exist on mobile: sheet/bubble radii and the elevation used by
+// the launcher and the sheet (the web side gets those from CSS).
 import { darkColors, lightColors, motion, radii, spacing } from '@appsupportkit/design-tokens';
-export const supportDarkTheme = {
-  name: 'dark',
-  colors: darkColors,
-  spacing,
-  radii,
-  motion
+/** Rounder than the dashboard: touch targets read better with more radius. */
+export const supportRadii = {
+  ...radii,
+  control: 10,
+  card: 14,
+  cardLg: 18,
+  /** Message bubbles. */
+  bubble: 18,
+  /** The tight corner on a bubble's sender side. */
+  bubbleTail: 6,
+  sheet: 24,
+  pill: 999
 };
-export const supportLightTheme = {
-  name: 'light',
-  colors: lightColors,
-  spacing,
-  radii,
-  motion
-};
-export function resolveTheme(name) {
-  return name === 'light' ? supportLightTheme : supportDarkTheme;
+
+/**
+ * The launcher sits on the host app's own background rather than on an SDK
+ * surface, so the two themes need different treatment: on near-black a
+ * solid fill needs a hairline to separate from the background and a black
+ * shadow, while on white the accent-tinted shadow does that work and a
+ * borderless mark has to be darkened to stay legible.
+ */
+
+// Color helpers come first: the themes below are built at module load, so
+// anything they reach for has to already be initialized. (A `const` used
+// before its definition survives tsc but lands as `undefined` on Hermes.)
+const HEX = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i;
+function parseHex(color) {
+  const match = HEX.exec(color.trim());
+  const digits = match?.[1];
+  if (digits === undefined) return null;
+  const hex = digits.length === 3 ? digits.split('').map(c => c + c).join('') : digits;
+  return [parseInt(hex.slice(0, 2), 16), parseInt(hex.slice(2, 4), 16), parseInt(hex.slice(4, 6), 16)];
+}
+function mix([r, g, b], target, amount) {
+  const channel = c => Math.round(c + (target - c) * amount);
+  return `rgb(${channel(r)}, ${channel(g)}, ${channel(b)})`;
+}
+function shadowsFor(name, accent) {
+  const dark = name === 'dark';
+  return {
+    launcher: {
+      // Tinting the launcher's shadow with the accent is what makes it read
+      // as lifted rather than pasted on.
+      shadowColor: dark ? '#000000' : accent,
+      shadowOpacity: dark ? 0.45 : 0.3,
+      shadowRadius: 14,
+      shadowOffset: {
+        width: 0,
+        height: 6
+      },
+      elevation: 8
+    },
+    sheet: {
+      shadowColor: '#000000',
+      shadowOpacity: dark ? 0.5 : 0.16,
+      shadowRadius: 24,
+      shadowOffset: {
+        width: 0,
+        height: -6
+      },
+      elevation: 24
+    },
+    badge: {
+      shadowColor: '#000000',
+      shadowOpacity: 0.25,
+      shadowRadius: 3,
+      shadowOffset: {
+        width: 0,
+        height: 1
+      },
+      elevation: 3
+    }
+  };
+}
+function launcherFor(name, accent) {
+  const rgb = parseHex(accent);
+  return {
+    solidRing: name === 'dark' ? 'rgba(255, 255, 255, 0.14)' : 'rgba(0, 0, 0, 0.06)',
+    // On a dark app background the raw accent is too close to the surface
+    // to read as a glyph; lift it toward white.
+    minimalMark: name === 'dark' && rgb !== null ? mix(rgb, 255, 0.35) : accent
+  };
+}
+function buildTheme(name, colors) {
+  return {
+    name,
+    colors,
+    spacing,
+    radii: supportRadii,
+    motion,
+    shadows: shadowsFor(name, colors.accent),
+    launcher: launcherFor(name, colors.accent)
+  };
+}
+export const supportDarkTheme = buildTheme('dark', darkColors);
+export const supportLightTheme = buildTheme('light', lightColors);
+
+/**
+ * Derives the accent family from a single brand color: a pressed shade, the
+ * 12% wash used behind chips and own-message bubbles, and a foreground that
+ * stays legible on top (dark text on light brands, white on dark ones).
+ */
+function withAccent(theme, accent) {
+  const rgb = parseHex(accent);
+  if (!rgb) return theme;
+  const [r, g, b] = rgb;
+  // Relative luminance, sRGB coefficients — good enough to pick a foreground.
+  const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+  const colors = {
+    ...theme.colors,
+    accent,
+    accentHover: mix(rgb, theme.name === 'dark' ? 255 : 0, 0.12),
+    accentMuted: `rgba(${r}, ${g}, ${b}, 0.12)`,
+    accentForeground: luminance > 0.62 ? '#111113' : '#FFFFFF',
+    statusOpen: accent,
+    statusOpenBg: `rgba(${r}, ${g}, ${b}, 0.10)`,
+    focusRing: accent
+  };
+  return {
+    ...theme,
+    colors,
+    shadows: shadowsFor(theme.name, accent),
+    launcher: launcherFor(theme.name, accent)
+  };
+}
+
+/**
+ * @param name  "light" | "dark" (default dark).
+ * @param accentColor Optional brand color (hex) replacing the default accent.
+ */
+export function resolveTheme(name, accentColor) {
+  const base = name === 'light' ? supportLightTheme : supportDarkTheme;
+  return accentColor ? withAccent(base, accentColor) : base;
 }
 //# sourceMappingURL=theme.js.map

package/lib/module/theme.js.map

@@ -1 +1 @@
-{"version":3,"names":["darkColors","lightColors","motion","radii","spacing","supportDarkTheme","name","colors","supportLightTheme","resolveTheme"],"sourceRoot":"../../src","sources":["theme.ts"],"mappings":";;AAAA;AACA;AACA,SACEA,UAAU,EACVC,WAAW,EACXC,MAAM,EACNC,KAAK,EACLC,OAAO,QAEF,8BAA8B;AAWrC,OAAO,MAAMC,gBAA8B,GAAG;EAC5CC,IAAI,EAAE,MAAM;EACZC,MAAM,EAAEP,UAAU;EAClBI,OAAO;EACPD,KAAK;EACLD;AACF,CAAC;AAED,OAAO,MAAMM,iBAA+B,GAAG;EAC7CF,IAAI,EAAE,OAAO;EACbC,MAAM,EAAEN,WAAW;EACnBG,OAAO;EACPD,KAAK;EACLD;AACF,CAAC;AAED,OAAO,SAASO,YAAYA,CAACH,IAA2B,EAAgB;EACtE,OAAOA,IAAI,KAAK,OAAO,GAAGE,iBAAiB,GAAGH,gBAAgB;AAChE","ignoreList":[]}
+{"version":3,"names":["darkColors","lightColors","motion","radii","spacing","supportRadii","control","card","cardLg","bubble","bubbleTail","sheet","pill","HEX","parseHex","color","match","exec","trim","digits","undefined","hex","length","split","map","c","join","parseInt","slice","mix","r","g","b","target","amount","channel","Math","round","shadowsFor","name","accent","dark","launcher","shadowColor","shadowOpacity","shadowRadius","shadowOffset","width","height","elevation","badge","launcherFor","rgb","solidRing","minimalMark","buildTheme","colors","shadows","supportDarkTheme","supportLightTheme","withAccent","theme","luminance","accentHover","accentMuted","accentForeground","statusOpen","statusOpenBg","focusRing","resolveTheme","accentColor","base"],"sourceRoot":"../../src","sources":["theme.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/types.js

@@ -1,5 +1,12 @@
 "use strict";
 
+/**
+ * How the launcher renders:
+ *   solid   — accent fill, elevated. The floating action button.
+ *   soft    — app surface + hairline border. Sits in a header or toolbar.
+ *   minimal — bare mark, no fill or border. Sits in a nav bar.
+ */
+
 export const QUERY_TYPE_LABEL = {
   feedback: 'Feedback',
   feature_request: 'Feature request',

package/lib/module/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["QUERY_TYPE_LABEL","feedback","feature_request","bug_report","USER_MESSAGE_MIN","USER_MESSAGE_MAX"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAsEA,OAAO,MAAMA,gBAA2C,GAAG;EACzDC,QAAQ,EAAE,UAAU;EACpBC,eAAe,EAAE,iBAAiB;EAClCC,UAAU,EAAE;AACd,CAAC;AAED,OAAO,MAAMC,gBAAgB,GAAG,EAAE;AAClC,OAAO,MAAMC,gBAAgB,GAAG,GAAG","ignoreList":[]}
+{"version":3,"names":["QUERY_TYPE_LABEL","feedback","feature_request","bug_report","USER_MESSAGE_MIN","USER_MESSAGE_MAX"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAQA;AACA;AACA;AACA;AACA;AACA;;AA4FA,OAAO,MAAMA,gBAA2C,GAAG;EACzDC,QAAQ,EAAE,UAAU;EACpBC,eAAe,EAAE,iBAAiB;EAClCC,UAAU,EAAE;AACd,CAAC;AAED,OAAO,MAAMC,gBAAgB,GAAG,EAAE;AAClC,OAAO,MAAMC,gBAAgB,GAAG,GAAG","ignoreList":[]}

package/lib/module/unread.js

@@ -0,0 +1,83 @@
+"use strict";
+
+// Unread accounting.
+//
+// The server counts a thread's unread as "admin messages newer than the
+// user's read receipt". That number is authoritative, but it is always a
+// little behind the device: between the moment the user opens a thread and
+// the moment `mark-read` lands, every already-in-flight poll still reports
+// the old count — which is what made the badge flicker back on after being
+// cleared, and what made a thread the user was actively reading accumulate
+// unread replies.
+//
+// So the client keeps its own watermark per thread: the `created_at` of the
+// newest admin message the user has actually seen. Those are *server*
+// timestamps, so nothing here compares against the device clock.
+//
+// Displayed unread is then the stricter of the two counts, which is correct
+// in both directions:
+//
+//   read here, receipt not written yet  → local watermark wins  (0)
+//   read on another device              → server count wins     (0)
+
+/** Watermark map: thread id → `created_at` (ms) of the newest seen reply. */
+
+/** `created_at` (ms) of the newest admin message, or 0 if there are none. */
+export function latestAdminMessageAt(thread) {
+  let latest = 0;
+  for (const message of thread.messages) {
+    if (message.sender !== 'admin') continue;
+    const at = Date.parse(message.created_at);
+    if (Number.isFinite(at) && at > latest) latest = at;
+  }
+  return latest;
+}
+
+/** Admin messages in `thread` newer than `watermark`. */
+export function unreadSince(thread, watermark) {
+  let count = 0;
+  for (const message of thread.messages) {
+    if (message.sender !== 'admin') continue;
+    const at = Date.parse(message.created_at);
+    if (Number.isFinite(at) && at > watermark) count += 1;
+  }
+  return count;
+}
+
+/**
+ * Returns `thread` with `unread_count` narrowed by what this device knows
+ * the user has read. Identity is preserved when nothing changes so lists
+ * stay referentially stable between polls.
+ */
+export function reconcileThread(thread, watermarks) {
+  const watermark = watermarks.get(thread.id);
+  if (watermark === undefined || thread.unread_count === 0) return thread;
+  const unread = Math.min(thread.unread_count, unreadSince(thread, watermark));
+  return unread === thread.unread_count ? thread : {
+    ...thread,
+    unread_count: unread
+  };
+}
+export function reconcileThreads(threads, watermarks) {
+  return threads.map(thread => reconcileThread(thread, watermarks));
+}
+export function sumUnread(threads) {
+  return threads.reduce((total, thread) => total + thread.unread_count, 0);
+}
+
+/**
+ * Drops watermarks the server has caught up on (its own count is already 0)
+ * and ones for threads that no longer exist, so the map can't grow without
+ * bound over a long session.
+ */
+export function pruneWatermarks(watermarks, serverThreads) {
+  const keep = new Map();
+  for (const thread of serverThreads) {
+    const watermark = watermarks.get(thread.id);
+    if (watermark !== undefined && thread.unread_count > 0) {
+      keep.set(thread.id, watermark);
+    }
+  }
+  return keep;
+}
+//# sourceMappingURL=unread.js.map

package/lib/module/unread.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["latestAdminMessageAt","thread","latest","message","messages","sender","at","Date","parse","created_at","Number","isFinite","unreadSince","watermark","count","reconcileThread","watermarks","get","id","undefined","unread_count","unread","Math","min","reconcileThreads","threads","map","sumUnread","reduce","total","pruneWatermarks","serverThreads","keep","Map","set"],"sourceRoot":"../../src","sources":["unread.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;;AAGA;AACA,OAAO,SAASA,oBAAoBA,CAACC,MAAc,EAAU;EAC3D,IAAIC,MAAM,GAAG,CAAC;EACd,KAAK,MAAMC,OAAO,IAAIF,MAAM,CAACG,QAAQ,EAAE;IACrC,IAAID,OAAO,CAACE,MAAM,KAAK,OAAO,EAAE;IAChC,MAAMC,EAAE,GAAGC,IAAI,CAACC,KAAK,CAACL,OAAO,CAACM,UAAU,CAAC;IACzC,IAAIC,MAAM,CAACC,QAAQ,CAACL,EAAE,CAAC,IAAIA,EAAE,GAAGJ,MAAM,EAAEA,MAAM,GAAGI,EAAE;EACrD;EACA,OAAOJ,MAAM;AACf;;AAEA;AACA,OAAO,SAASU,WAAWA,CAACX,MAAc,EAAEY,SAAiB,EAAU;EACrE,IAAIC,KAAK,GAAG,CAAC;EACb,KAAK,MAAMX,OAAO,IAAIF,MAAM,CAACG,QAAQ,EAAE;IACrC,IAAID,OAAO,CAACE,MAAM,KAAK,OAAO,EAAE;IAChC,MAAMC,EAAE,GAAGC,IAAI,CAACC,KAAK,CAACL,OAAO,CAACM,UAAU,CAAC;IACzC,IAAIC,MAAM,CAACC,QAAQ,CAACL,EAAE,CAAC,IAAIA,EAAE,GAAGO,SAAS,EAAEC,KAAK,IAAI,CAAC;EACvD;EACA,OAAOA,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAC7Bd,MAAc,EACde,UAA0B,EAClB;EACR,MAAMH,SAAS,GAAGG,UAAU,CAACC,GAAG,CAAChB,MAAM,CAACiB,EAAE,CAAC;EAC3C,IAAIL,SAAS,KAAKM,SAAS,IAAIlB,MAAM,CAACmB,YAAY,KAAK,CAAC,EAAE,OAAOnB,MAAM;EACvE,MAAMoB,MAAM,GAAGC,IAAI,CAACC,GAAG,CAACtB,MAAM,CAACmB,YAAY,EAAER,WAAW,CAACX,MAAM,EAAEY,SAAS,CAAC,CAAC;EAC5E,OAAOQ,MAAM,KAAKpB,MAAM,CAACmB,YAAY,GAAGnB,MAAM,GAAG;IAAE,GAAGA,MAAM;IAAEmB,YAAY,EAAEC;EAAO,CAAC;AACtF;AAEA,OAAO,SAASG,gBAAgBA,CAC9BC,OAAiB,EACjBT,UAA0B,EAChB;EACV,OAAOS,OAAO,CAACC,GAAG,CAAEzB,MAAM,IAAKc,eAAe,CAACd,MAAM,EAAEe,UAAU,CAAC,CAAC;AACrE;AAEA,OAAO,SAASW,SAASA,CAACF,OAAiB,EAAU;EACnD,OAAOA,OAAO,CAACG,MAAM,CAAC,CAACC,KAAK,EAAE5B,MAAM,KAAK4B,KAAK,GAAG5B,MAAM,CAACmB,YAAY,EAAE,CAAC,CAAC;AAC1E;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASU,eAAeA,CAC7Bd,UAA0B,EAC1Be,aAAuB,EACP;EAChB,MAAMC,IAAoB,GAAG,IAAIC,GAAG,CAAC,CAAC;EACtC,KAAK,MAAMhC,MAAM,IAAI8B,aAAa,EAAE;IAClC,MAAMlB,SAAS,GAAGG,UAAU,CAACC,GAAG,CAAChB,MAAM,CAACiB,EAAE,CAAC;IAC3C,IAAIL,SAAS,KAAKM,SAAS,IAAIlB,MAAM,CAACmB,YAAY,GAAG,CAAC,EAAE;MACtDY,IAAI,CAACE,GAAG,CAACjC,MAAM,CAACiB,EAAE,EAAEL,SAAS,CAAC;IAChC;EACF;EACA,OAAOmB,IAAI;AACb","ignoreList":[]}

package/lib/module/useSupportThreads.js

@@ -0,0 +1,281 @@
+"use strict";
+
+// Threads + unread state for the SDK: fetching, poll cadence, and read
+// tracking. Kept out of SupportButton so the rules below live in one place.
+//
+// Three invariants make the badge trustworthy:
+//
+//   1. Responses are applied in issue order (`appliedSeq`), so a slow poll
+//      can never overwrite a newer one.
+//   2. The badge-only endpoint returns a bare number that cannot be
+//      reconciled against local reads, so its answer is dropped when a read
+//      happened while it was in flight (`readEpoch`), and it isn't used at
+//      all while any `mark-read` is still unconfirmed — the full endpoint is
+//      polled instead, since that payload *can* be reconciled.
+//   3. `mark-read` failures are retried instead of swallowed, and the local
+//      watermark holds the UI correct in the meantime.
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { AppState } from 'react-native';
+import { getThreads, getUnreadCount, markRead, SupportApiError } from './api';
+import { latestAdminMessageAt, pruneWatermarks, reconcileThreads, sumUnread } from './unread';
+
+// Poll cadence by context: fast where latency is felt (staring at a thread
+// waiting for a reply), slow when the sheet is closed — and the idle tick
+// uses the count-only endpoint, so it costs ~18 bytes instead of the full
+// thread list.
+const THREAD_POLL_MS = 5_000;
+const SHEET_POLL_MS = 15_000;
+export const IDLE_POLL_MS = 60_000;
+const MIN_POLL_MS = 3_000;
+
+// A failed mark-read used to be dropped on the floor, which resurrected the
+// badge on the next poll. Retry a few times with backoff; anything still
+// unconfirmed after that is picked up by the next poll tick or foreground.
+const MARK_READ_MAX_ATTEMPTS = 4;
+const MARK_READ_BACKOFF_MS = 1_500;
+
+/**
+ * Load failures the user can act on say so; the rest stay neutral. A 401 is
+ * an integration mistake — the end user retrying forever won't fix a key
+ * that doesn't match the app — so the real cause is logged for whoever is
+ * running the build instead of hidden behind "couldn't load".
+ */
+function loadErrorMessage(e) {
+  if (e instanceof SupportApiError) {
+    if (e.offline) return "You're offline — check your connection";
+    if (e.status === 401 || e.status === 403) {
+      if (__DEV__) {
+        console.error('SupportButton: the support API rejected this app (401). Check that ' + '`apiKey` is the key shown when the app was registered and that ' + '`appName` matches that app exactly.');
+      }
+      return 'Support is unavailable right now';
+    }
+    if (e.status === 429) return 'Too many requests — try again in a bit';
+  }
+  return "Couldn't load your conversations";
+}
+export function useSupportThreads({
+  config,
+  revenuecatId,
+  enabled,
+  sheetOpen,
+  activeThreadId,
+  idlePollMs
+}) {
+  const [threads, setThreads] = useState(null);
+  const [totalUnread, setTotalUnread] = useState(0);
+  const [loading, setLoading] = useState(false);
+  const [refreshing, setRefreshing] = useState(false);
+  const [error, setError] = useState(null);
+  const mounted = useRef(true);
+  /** Last server payload, before local read reconciliation. */
+  const rawThreads = useRef(null);
+  const watermarks = useRef(new Map());
+  const reads = useRef(new Map());
+  const requestSeq = useRef(0);
+  const appliedSeq = useRef(0);
+  const readEpoch = useRef(0);
+  const activeThreadIdRef = useRef(activeThreadId);
+  useEffect(() => {
+    activeThreadIdRef.current = activeThreadId;
+  }, [activeThreadId]);
+  useEffect(() => {
+    mounted.current = true;
+    const timers = reads.current;
+    return () => {
+      mounted.current = false;
+      for (const attempt of timers.values()) {
+        if (attempt.timer !== null) clearTimeout(attempt.timer);
+      }
+      timers.clear();
+    };
+  }, []);
+  const publish = useCallback(() => {
+    const raw = rawThreads.current;
+    if (raw === null) return;
+    const reconciled = reconcileThreads(raw, watermarks.current);
+    setThreads(reconciled);
+    setTotalUnread(sumUnread(reconciled));
+  }, []);
+
+  /** POSTs the receipt, retrying transient failures with backoff. */
+  const sendRead = useCallback(threadId => {
+    const attempt = reads.current.get(threadId);
+    if (!attempt || attempt.inFlight !== null) return;
+    const covers = attempt.target;
+    attempt.inFlight = covers;
+    attempt.timer = null;
+    markRead(config, {
+      queryId: threadId,
+      revenuecatId
+    }).then(() => {
+      if (!mounted.current) return;
+      const current = reads.current.get(threadId);
+      if (!current) return;
+      current.inFlight = null;
+      // A reply that landed while this request was in flight isn't
+      // covered by the receipt it just wrote — send one more.
+      if (current.target > covers) {
+        current.attempts = 0;
+        sendRead(threadId);
+        return;
+      }
+      reads.current.delete(threadId);
+      // The receipt now exists server-side, so any response still in
+      // flight predates it and must not be trusted for unread counts.
+      readEpoch.current += 1;
+    }).catch(() => {
+      if (!mounted.current) return;
+      const current = reads.current.get(threadId);
+      if (!current) return;
+      current.inFlight = null;
+      current.attempts += 1;
+      if (current.attempts >= MARK_READ_MAX_ATTEMPTS) return;
+      current.timer = setTimeout(() => sendRead(threadId), MARK_READ_BACKOFF_MS * 2 ** (current.attempts - 1));
+    });
+  }, [config, revenuecatId]);
+
+  /** Re-drives receipts that gave up earlier (next poll tick / foreground). */
+  const flushReads = useCallback(() => {
+    for (const [threadId, attempt] of reads.current) {
+      if (attempt.inFlight !== null || attempt.timer !== null) continue;
+      attempt.attempts = 0;
+      sendRead(threadId);
+    }
+  }, [sendRead]);
+
+  /**
+   * Records that the user has seen every reply currently in `threadId` and
+   * persists it. Idempotent: re-marking a thread with nothing new is a
+   * no-op, so the 5s in-thread poll doesn't spam the endpoint.
+   */
+  const markThreadRead = useCallback(threadId => {
+    const thread = rawThreads.current?.find(t => t.id === threadId);
+    if (!thread) return;
+    const latest = latestAdminMessageAt(thread);
+    if (latest === 0) return;
+    if (latest <= (watermarks.current.get(threadId) ?? 0)) return;
+    watermarks.current.set(threadId, latest);
+    // Invalidate the bare counts of any request already in flight.
+    readEpoch.current += 1;
+    publish();
+    const attempt = reads.current.get(threadId);
+    if (attempt) attempt.target = latest;else {
+      reads.current.set(threadId, {
+        target: latest,
+        inFlight: null,
+        attempts: 0,
+        timer: null
+      });
+    }
+    sendRead(threadId);
+  }, [publish, sendRead]);
+  const fetchThreads = useCallback(async mode => {
+    if (!enabled) return;
+    const seq = requestSeq.current += 1;
+    // With nothing cached there is no list to pull down, so a retry shows
+    // the skeleton rather than a spinner nobody can see.
+    const blank = rawThreads.current === null;
+    const spinner = mode === 'user' && !blank;
+    const skeleton = mode !== 'background' && blank;
+    if (spinner) setRefreshing(true);
+    if (skeleton) setLoading(true);
+    try {
+      const data = await getThreads(config, revenuecatId);
+      if (!mounted.current) return;
+      // A slower earlier request must never clobber a newer answer.
+      if (seq <= appliedSeq.current) return;
+      appliedSeq.current = seq;
+      rawThreads.current = data.threads;
+      watermarks.current = pruneWatermarks(watermarks.current, data.threads);
+      setError(null);
+      publish();
+
+      // Replies that arrived while the user is sitting in the thread are
+      // read on arrival — otherwise the badge climbed while they read.
+      const active = activeThreadIdRef.current;
+      if (active !== null) markThreadRead(active);
+      flushReads();
+    } catch (e) {
+      if (!mounted.current) return;
+      // A failed background poll must not blow away cached threads.
+      if (rawThreads.current === null) setError(loadErrorMessage(e));
+    } finally {
+      if (mounted.current) {
+        if (spinner) setRefreshing(false);
+        if (skeleton) setLoading(false);
+      }
+    }
+  }, [config, enabled, revenuecatId, publish, markThreadRead, flushReads]);
+
+  /** Badge-only refresh — the cheap endpoint, used while idle. */
+  const fetchCount = useCallback(async () => {
+    if (!enabled) return;
+    const seq = requestSeq.current += 1;
+    const epoch = readEpoch.current;
+    try {
+      const data = await getUnreadCount(config, revenuecatId);
+      if (!mounted.current) return;
+      // This payload is just a number: there is no way to subtract reads
+      // that happened while it was in flight, so discard it instead.
+      if (readEpoch.current !== epoch) return;
+      if (seq <= appliedSeq.current) return;
+      appliedSeq.current = seq;
+      setTotalUnread(data.total_unread);
+    } catch {
+      // Best effort: the next tick or the next sheet open reconciles.
+    }
+  }, [config, enabled, revenuecatId]);
+
+  // Initial load.
+  useEffect(() => {
+    void fetchThreads('initial');
+  }, [fetchThreads]);
+
+  // Opening the sheet always shows fresh data.
+  useEffect(() => {
+    if (sheetOpen) void fetchThreads('background');
+  }, [sheetOpen, fetchThreads]);
+
+  // Opening a thread marks it read immediately, before the next poll.
+  useEffect(() => {
+    if (activeThreadId !== null) markThreadRead(activeThreadId);
+  }, [activeThreadId, markThreadRead]);
+
+  // Cadence follows what the user is looking at; the app returning to the
+  // foreground always ticks.
+  useEffect(() => {
+    if (!enabled) return;
+    const idle = !sheetOpen;
+    const intervalMs = idle ? idlePollMs : activeThreadId !== null ? THREAD_POLL_MS : SHEET_POLL_MS;
+    const tick = () => {
+      // While a receipt is unconfirmed the count-only endpoint would report
+      // replies the user has already read, so pay for the full payload.
+      if (idle && reads.current.size === 0) void fetchCount();else void fetchThreads('background');
+    };
+
+    // Clamped so a typo like `pollIntervalMs={30}` can't hammer the API;
+    // 0 (or negative) disables idle polling entirely.
+    const timer = intervalMs > 0 ? setInterval(tick, Math.max(intervalMs, MIN_POLL_MS)) : null;
+    const appStateSub = AppState.addEventListener('change', state => {
+      if (state === 'active') tick();
+    });
+    return () => {
+      if (timer !== null) clearInterval(timer);
+      appStateSub.remove();
+    };
+  }, [enabled, sheetOpen, activeThreadId, idlePollMs, fetchThreads, fetchCount]);
+  const refresh = useCallback(() => {
+    void fetchThreads('user');
+  }, [fetchThreads]);
+  const reload = useCallback(() => fetchThreads('background'), [fetchThreads]);
+  return {
+    threads,
+    totalUnread,
+    loading,
+    refreshing,
+    error,
+    refresh,
+    reload
+  };
+}
+//# sourceMappingURL=useSupportThreads.js.map

package/lib/module/useSupportThreads.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useRef","useState","AppState","getThreads","getUnreadCount","markRead","SupportApiError","latestAdminMessageAt","pruneWatermarks","reconcileThreads","sumUnread","THREAD_POLL_MS","SHEET_POLL_MS","IDLE_POLL_MS","MIN_POLL_MS","MARK_READ_MAX_ATTEMPTS","MARK_READ_BACKOFF_MS","loadErrorMessage","e","offline","status","__DEV__","console","error","useSupportThreads","config","revenuecatId","enabled","sheetOpen","activeThreadId","idlePollMs","threads","setThreads","totalUnread","setTotalUnread","loading","setLoading","refreshing","setRefreshing","setError","mounted","rawThreads","watermarks","Map","reads","requestSeq","appliedSeq","readEpoch","activeThreadIdRef","current","timers","attempt","values","timer","clearTimeout","clear","publish","raw","reconciled","sendRead","threadId","get","inFlight","covers","target","queryId","then","attempts","delete","catch","setTimeout","flushReads","markThreadRead","thread","find","t","id","latest","set","fetchThreads","mode","seq","blank","spinner","skeleton","data","active","fetchCount","epoch","total_unread","idle","intervalMs","tick","size","setInterval","Math","max","appStateSub","addEventListener","state","clearInterval","remove","refresh","reload"],"sourceRoot":"../../src","sources":["useSupportThreads.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils.js

@@ -25,6 +25,36 @@ export function formatDate(iso) {
   });
 }
 
+/** "14:32" in the device's locale — shown under a group of messages. */
+export function formatTime(iso) {
+  return new Date(iso).toLocaleTimeString(undefined, {
+    hour: 'numeric',
+    minute: '2-digit'
+  });
+}
+export function isSameDay(a, b) {
+  const first = new Date(a);
+  const second = new Date(b);
+  return first.getFullYear() === second.getFullYear() && first.getMonth() === second.getMonth() && first.getDate() === second.getDate();
+}
+
+/** Date separator label: Today / Yesterday / "Mon, 5 Jan". */
+export function dayLabel(iso) {
+  const now = new Date();
+  if (isSameDay(iso, now.toISOString())) return 'Today';
+  const yesterday = new Date(now.getTime() - 86_400_000);
+  if (isSameDay(iso, yesterday.toISOString())) return 'Yesterday';
+  const date = new Date(iso);
+  return date.toLocaleDateString(undefined, {
+    weekday: 'short',
+    month: 'short',
+    day: 'numeric',
+    ...(date.getFullYear() === now.getFullYear() ? {} : {
+      year: 'numeric'
+    })
+  });
+}
+
 /** Dev-mode prop validation with actionable messages. */
 export function validateProps(props) {
   if (typeof props.appName !== 'string' || props.appName.length === 0) {

package/lib/module/utils.js.map

@@ -1 +1 @@
-{"version":3,"names":["relativeTime","iso","then","Date","getTime","seconds","Math","max","floor","now","minutes","hours","days","weeks","months","formatDate","toLocaleDateString","undefined","year","month","day","validateProps","props","appName","length","apiKey","supabaseUrl","test","user","name","isPaid","revenuecatId","appVersion"],"sourceRoot":"../../src","sources":["utils.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["relativeTime","iso","then","Date","getTime","seconds","Math","max","floor","now","minutes","hours","days","weeks","months","formatDate","toLocaleDateString","undefined","year","month","day","formatTime","toLocaleTimeString","hour","minute","isSameDay","a","b","first","second","getFullYear","getMonth","getDate","dayLabel","toISOString","yesterday","date","weekday","validateProps","props","appName","length","apiKey","supabaseUrl","test","user","name","isPaid","revenuecatId","appVersion"],"sourceRoot":"../../src","sources":["utils.ts"],"mappings":"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","ignoreList":[]}