@hermesihq/react 0.1.0

package/dist/index.cjs

@@ -0,0 +1,924 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  HERMS_CHANNELS: () => HERMS_CHANNELS,
+  HermsApiError: () => HermsApiError,
+  HermsClient: () => HermsClient,
+  HermsInbox: () => HermsInbox,
+  HermsProvider: () => HermsProvider,
+  decodeSubscriberTokenExp: () => decodeSubscriberTokenExp,
+  useHermsContext: () => useHermsContext,
+  useInbox: () => useInbox,
+  usePreferences: () => usePreferences,
+  useUnreadCount: () => useUnreadCount
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core/subscriberToken.ts
+function base64UrlDecodeToString(segment) {
+  const base64 = segment.replace(/-/g, "+").replace(/_/g, "/");
+  const padded = base64 + "=".repeat((4 - base64.length % 4) % 4);
+  const binary = atob(padded);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);
+  return new TextDecoder().decode(bytes);
+}
+function decodeSubscriberTokenExp(token) {
+  const [payloadSegment] = token.split(".");
+  if (!payloadSegment) return null;
+  try {
+    const parsed = JSON.parse(base64UrlDecodeToString(payloadSegment));
+    if (typeof parsed === "object" && parsed !== null && "exp" in parsed && typeof parsed.exp === "number") {
+      return parsed.exp;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// src/core/types.ts
+var HERMS_CHANNELS = [
+  "in_app",
+  "email",
+  "push",
+  "sms",
+  "whatsapp",
+  "telegram",
+  "slack",
+  "teams",
+  "discord"
+];
+var HermsApiError = class extends Error {
+  status;
+  code;
+  type;
+  requestId;
+  /** Per-problem specifics. Possibly empty, never absent: the API's own words. */
+  detail;
+  /** Documentation for this `code`, or `''` when the server sent none. */
+  docUrl;
+  constructor(status, body) {
+    const envelope = typeof body === "object" && body !== null && "error" in body ? body.error : void 0;
+    const message = typeof envelope?.message === "string" ? envelope.message : `Hermesi client API request failed with status ${status}.`;
+    super(message);
+    this.name = "HermsApiError";
+    this.status = status;
+    this.code = typeof envelope?.code === "string" ? envelope.code : "unknown_error";
+    this.type = typeof envelope?.type === "string" ? envelope.type : "unknown_error";
+    this.requestId = typeof envelope?.request_id === "string" ? envelope.request_id : "";
+    this.detail = Array.isArray(envelope?.detail) ? envelope.detail.filter(
+      (entry) => typeof entry === "object" && entry !== null
+    ) : [];
+    this.docUrl = typeof envelope?.doc_url === "string" ? envelope.doc_url : "";
+  }
+};
+
+// src/core/HermsClient.ts
+var POLL_INTERVAL_MS = 6e4;
+var MAX_FAST_RECONNECT_ATTEMPTS = 3;
+var BASE_RECONNECT_DELAY_MS = 1e3;
+var MAX_RECONNECT_DELAY_MS = 3e4;
+var TOKEN_EXPIRY_BUFFER_SECONDS = 60;
+function backoffDelayMs(attempt) {
+  const exponential = BASE_RECONNECT_DELAY_MS * 2 ** Math.max(0, attempt - 1);
+  return Math.min(MAX_RECONNECT_DELAY_MS, exponential);
+}
+function buildQueryString(params) {
+  const search = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    if (value === void 0) continue;
+    if (Array.isArray(value)) {
+      for (const item of value) search.append(key, item);
+    } else {
+      search.append(key, String(value));
+    }
+  }
+  const qs = search.toString();
+  return qs ? `?${qs}` : "";
+}
+function fromWireItem(wire) {
+  return {
+    id: wire.id,
+    title: wire.title,
+    body: wire.body,
+    actionUrl: wire.action_url,
+    category: wire.category ? { key: wire.category.key, name: wire.category.name } : null,
+    seenAt: wire.seen_at,
+    readAt: wire.read_at,
+    createdAt: wire.created_at
+  };
+}
+function fromWirePreferences(wire) {
+  return {
+    firstName: wire.first_name,
+    globalChannels: wire.global_channels.map((c) => ({ channel: c.channel, enabled: c.enabled })),
+    globalEmailEnabled: wire.global_email_enabled,
+    globalInAppEnabled: wire.global_in_app_enabled,
+    categories: wire.categories.map((category) => ({
+      categoryId: category.category_id,
+      key: category.key,
+      name: category.name,
+      isCritical: category.is_critical,
+      channels: category.channels.map((c) => ({ channel: c.channel, enabled: c.enabled })),
+      emailEnabled: category.email_enabled,
+      inAppEnabled: category.in_app_enabled
+    }))
+  };
+}
+var HermsClient = class {
+  options;
+  baseUrl;
+  expiryTimer = null;
+  lastScheduledExp = null;
+  constructor(options) {
+    this.options = options;
+    this.baseUrl = options.apiBaseUrl.replace(/\/+$/, "");
+  }
+  // --- Token handling ----------------------------------------------------
+  /** Every request goes through here: always a *fresh* call to
+   * `getSubscriberToken()` (never cached past what the host itself returns,
+   * per this class's own contract), which also re-arms `onTokenExpiring`
+   * against whatever token comes back. */
+  async getFreshToken() {
+    const token = await this.options.getSubscriberToken();
+    this.scheduleExpiryHook(token);
+    return token;
+  }
+  scheduleExpiryHook(token) {
+    const { onTokenExpiring } = this.options;
+    if (!onTokenExpiring) return;
+    const exp = decodeSubscriberTokenExp(token);
+    if (exp === null || exp === this.lastScheduledExp) return;
+    if (this.expiryTimer !== null) clearTimeout(this.expiryTimer);
+    this.lastScheduledExp = exp;
+    const delayMs = Math.max(0, exp * 1e3 - TOKEN_EXPIRY_BUFFER_SECONDS * 1e3 - Date.now());
+    this.expiryTimer = setTimeout(() => {
+      onTokenExpiring();
+    }, delayMs);
+  }
+  /** Stops the scheduled `onTokenExpiring` timer. Called from
+   * `HermsProvider`'s unmount cleanup so a torn-down client never fires the
+   * hook after the app has stopped caring. */
+  destroy() {
+    if (this.expiryTimer !== null) clearTimeout(this.expiryTimer);
+    this.expiryTimer = null;
+  }
+  // --- Transport -----------------------------------------------------------
+  /**
+   * `expectsBody` is how this knows a missing response body is a failure rather than a
+   * normal outcome. It defaults to `true` because most calls here read a payload; the
+   * methods that resolve to `void` pass `false`.
+   *
+   * Without it the success path did no checking at all. A `200` carrying a proxy's HTML
+   * page, or a `204` where a body was expected, left `parsed` null and returned it as
+   * `T`, so `listInbox()` rejected with `TypeError: Cannot read properties of null
+   * (reading 'data')` and the stack pointed at this SDK instead of at whatever was
+   * actually in the way. The *error* path already handled exactly that case carefully;
+   * only the success path did not.
+   */
+  async request(path, init = {}) {
+    const token = await this.getFreshToken();
+    const qs = init.query ? buildQueryString(init.query) : "";
+    const headers = {
+      Authorization: `Bearer ${this.options.publicKey}`,
+      "X-Hermesi-Subscriber-Token": token,
+      Accept: "application/json"
+    };
+    if (init.body !== void 0) headers["Content-Type"] = "application/json";
+    const response = await fetch(`${this.baseUrl}${path}${qs}`, {
+      method: init.method ?? "GET",
+      headers,
+      body: init.body !== void 0 ? JSON.stringify(init.body) : void 0
+    });
+    const expectsBody = init.expectsBody ?? true;
+    if (response.status === 204) {
+      if (expectsBody) throw new HermsApiError(response.status, null);
+      return void 0;
+    }
+    const rawText = await response.text();
+    let parsed = null;
+    if (rawText) {
+      try {
+        parsed = JSON.parse(rawText);
+      } catch {
+        parsed = null;
+      }
+    }
+    if (!response.ok) {
+      throw new HermsApiError(response.status, parsed);
+    }
+    if (expectsBody && parsed === null) {
+      throw new HermsApiError(response.status, null);
+    }
+    return parsed;
+  }
+  // --- Inbox reads -----------------------------------------------------------
+  async listInbox(params = {}) {
+    const wire = await this.request("/inbox", {
+      query: {
+        limit: params.limit,
+        cursor: params.cursor,
+        read: params.status === void 0 ? void 0 : params.status === "read" ? "true" : "false",
+        category: params.category
+      }
+    });
+    return {
+      items: wire.data.map(fromWireItem),
+      hasMore: wire.has_more,
+      nextCursor: wire.next_cursor
+    };
+  }
+  async getCounts() {
+    const wire = await this.request("/inbox/counts");
+    return { unread: wire.unread, unseen: wire.unseen };
+  }
+  // --- Inbox writes ------------------------------------------------------
+  async markRead(id) {
+    const wire = await this.request(`/inbox/${encodeURIComponent(id)}/read`, { method: "POST" });
+    return fromWireItem(wire);
+  }
+  async markAllRead() {
+    const wire = await this.request("/inbox/read-all", { method: "POST" });
+    return { updated: wire.updated };
+  }
+  async markSeen(ids) {
+    if (ids.length === 0) return { updated: 0 };
+    const wire = await this.request("/inbox/seen", { method: "POST", body: { ids } });
+    return { updated: wire.updated };
+  }
+  async archive(id) {
+    const wire = await this.request(`/inbox/${encodeURIComponent(id)}/archive`, { method: "POST" });
+    return fromWireItem(wire);
+  }
+  async delete(id) {
+    await this.request(`/inbox/${encodeURIComponent(id)}`, { method: "DELETE", expectsBody: false });
+  }
+  // --- Channels (device-token self-registration) --------------------------
+  //
+  // `POST/DELETE /v1/client/channels`: landing alongside this SDK, not yet
+  // live in every deployment at the time this client was written. Implemented
+  // against the documented shape (§8.5/§6.10) so the SDK's public surface is
+  // complete; a backend that hasn't shipped the route yet will 404, surfaced
+  // to the caller as an ordinary `HermsApiError`, same as any other endpoint.
+  async registerChannel(params) {
+    await this.request("/channels", {
+      method: "POST",
+      expectsBody: false,
+      body: { channel: params.channel, identifier: params.identifier, metadata: params.metadata }
+    });
+  }
+  // --- Preferences -----------------------------------------------------------
+  /**
+   * The subscriber's own notification settings, for rendering a preference centre.
+   *
+   * There is deliberately no `unsubscribe()` beside this, although the API exposes
+   * `POST /v1/client/unsubscribe`. That route is the target of a `List-Unsubscribe`
+   * one-click link (RFC 8058): its token is minted by Hermesi and embedded in an
+   * outgoing email's headers, and the API's own description says it is invoked by a
+   * mail client rather than by application code. Wrapping it here would invite a host
+   * to build an unsubscribe button on a token it cannot obtain. The equivalent here
+   * is `updatePreference({ channel: 'email', enabled: false })`.
+   */
+  async getPreferences() {
+    return fromWirePreferences(await this.request("/preferences"));
+  }
+  /**
+   * Change one setting, and receive the whole updated state back.
+   *
+   * The server answers `PATCH` with the full preferences rather than an
+   * acknowledgement, so a caller never has to refetch, and never renders a view
+   * assembled from its own optimistic guess plus whatever else has changed since.
+   * Omit `categoryId` for the global setting; supply it to change one category.
+   */
+  async updatePreference(update) {
+    const wire = await this.request("/preferences", {
+      method: "PATCH",
+      body: {
+        channel: update.channel,
+        enabled: update.enabled,
+        // Sent as `null` rather than omitted: the API reads its absence and its null
+        // the same way, and being explicit keeps "global" visible in a request log.
+        category_id: update.categoryId ?? null
+      }
+    });
+    return fromWirePreferences(wire);
+  }
+  /**
+   * **Path parameters, not a query string.** This sent
+   * `DELETE /channels?channel=...&identifier=...` for as long as the method has existed,
+   * and there is no `DELETE` on `/v1/client/channels` at all: the route is
+   * `/v1/client/channels/{channel}/{identifier}`, so every call 404'd. Nothing caught
+   * it: the reference integration never deregisters, and the package had no tests.
+   *
+   * `identifier` is encoded because it is somebody's address (an email, a phone
+   * number, a chat conversation id), and those carry `@`, `+` and `:`.
+   */
+  async deregisterChannel(channel, identifier) {
+    await this.request(`/channels/${encodeURIComponent(channel)}/${encodeURIComponent(identifier)}`, {
+      method: "DELETE",
+      expectsBody: false
+    });
+  }
+  // --- Real-time -----------------------------------------------------------
+  /**
+   * Opens a live connection for real-time inbox events and returns an
+   * unsubscribe function. SSR-safe: `window`/`EventSource` are only read here,
+   * at call time, never at module or constructor time.
+   *
+   * - Prefers SSE (`GET /inbox/stream`) when `EventSource` exists.
+   * - Falls back to polling `getCounts()` every 60s (§6.6) when `EventSource`
+   *   doesn't exist at all, or after `MAX_FAST_RECONNECT_ATTEMPTS` consecutive
+   *   immediate reconnect failures (an invalid/expired token, or a network
+   *   that blocks SSE outright). It still retries SSE in the background with
+   *   exponential backoff rather than abandoning it permanently, so a fixed
+   *   token/network problem self-heals without a page reload.
+   */
+  subscribe(onEvent) {
+    let stopped = false;
+    let eventSource = null;
+    let pollTimer = null;
+    let reconnectTimer = null;
+    let consecutiveFailures = 0;
+    const hasEventSource = typeof window !== "undefined" && typeof EventSource !== "undefined";
+    const startPolling = () => {
+      if (pollTimer !== null) return;
+      pollTimer = setInterval(() => {
+        this.getCounts().then((counts) => onEvent({ type: "counts.changed", data: counts })).catch(() => {
+        });
+      }, POLL_INTERVAL_MS);
+    };
+    const stopPolling = () => {
+      if (pollTimer !== null) {
+        clearInterval(pollTimer);
+        pollTimer = null;
+      }
+    };
+    const scheduleReconnect = () => {
+      if (stopped) return;
+      consecutiveFailures += 1;
+      if (consecutiveFailures >= MAX_FAST_RECONNECT_ATTEMPTS) startPolling();
+      const delay = backoffDelayMs(consecutiveFailures);
+      reconnectTimer = setTimeout(() => {
+        void connect();
+      }, delay);
+    };
+    const connect = async () => {
+      if (stopped || !hasEventSource) return;
+      let token;
+      try {
+        token = await this.getFreshToken();
+      } catch {
+        scheduleReconnect();
+        return;
+      }
+      if (stopped) return;
+      const qs = buildQueryString({ public_key: this.options.publicKey, subscriber_token: token });
+      const source = new EventSource(`${this.baseUrl}/inbox/stream${qs}`);
+      eventSource = source;
+      source.addEventListener("item.created", (evt) => {
+        consecutiveFailures = 0;
+        try {
+          const data = JSON.parse(evt.data);
+          onEvent({ type: "item.created", data });
+        } catch {
+        }
+      });
+      source.addEventListener("counts.changed", (evt) => {
+        consecutiveFailures = 0;
+        try {
+          const data = JSON.parse(evt.data);
+          onEvent({ type: "counts.changed", data });
+        } catch {
+        }
+      });
+      source.onopen = () => {
+        consecutiveFailures = 0;
+        stopPolling();
+      };
+      source.onerror = () => {
+        source.close();
+        if (eventSource === source) eventSource = null;
+        if (!stopped) scheduleReconnect();
+      };
+    };
+    if (hasEventSource) {
+      void connect();
+    } else {
+      startPolling();
+    }
+    return () => {
+      stopped = true;
+      stopPolling();
+      if (reconnectTimer !== null) clearTimeout(reconnectTimer);
+      eventSource?.close();
+    };
+  }
+};
+
+// src/react/HermsProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var HermsContext = (0, import_react.createContext)(null);
+function HermsProvider({ client, children }) {
+  const listenersRef = (0, import_react.useRef)(/* @__PURE__ */ new Set());
+  (0, import_react.useEffect)(() => {
+    const unsubscribe = client.subscribe((event) => {
+      for (const listener of listenersRef.current) listener(event);
+    });
+    return () => {
+      unsubscribe();
+      client.destroy();
+    };
+  }, [client]);
+  const value = (0, import_react.useMemo)(
+    () => ({
+      client,
+      addEventListener: (listener) => {
+        listenersRef.current.add(listener);
+        return () => listenersRef.current.delete(listener);
+      }
+    }),
+    [client]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(HermsContext.Provider, { value, children });
+}
+function useHermsContext() {
+  const ctx = (0, import_react.useContext)(HermsContext);
+  if (!ctx) {
+    throw new Error("@hermesihq/react: this hook/component must be rendered inside <HermsProvider client={...}>.");
+  }
+  return ctx;
+}
+
+// src/react/useUnreadCount.ts
+var import_react2 = require("react");
+function useUnreadCount() {
+  const { client, addEventListener } = useHermsContext();
+  const [counts, setCounts] = (0, import_react2.useState)({ unread: 0, unseen: 0 });
+  const [isLoading, setIsLoading] = (0, import_react2.useState)(true);
+  (0, import_react2.useEffect)(() => {
+    let cancelled = false;
+    setIsLoading(true);
+    client.getCounts().then((fresh) => {
+      if (!cancelled) setCounts(fresh);
+    }).catch(() => {
+    }).finally(() => {
+      if (!cancelled) setIsLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client]);
+  (0, import_react2.useEffect)(
+    () => addEventListener((event) => {
+      if (event.type === "counts.changed") setCounts(event.data);
+    }),
+    [addEventListener]
+  );
+  return { ...counts, isLoading };
+}
+
+// src/react/useInbox.ts
+var import_react3 = require("react");
+function useInbox(options = {}) {
+  const { client, addEventListener } = useHermsContext();
+  const { status, category } = options;
+  const [items, setItems] = (0, import_react3.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react3.useState)(true);
+  const [isLoadingMore, setIsLoadingMore] = (0, import_react3.useState)(false);
+  const [error, setError] = (0, import_react3.useState)(null);
+  const [hasMore, setHasMore] = (0, import_react3.useState)(false);
+  const cursorRef = (0, import_react3.useRef)(null);
+  const requestIdRef = (0, import_react3.useRef)(0);
+  const fetchFirstPage = (0, import_react3.useCallback)(() => {
+    const requestId = ++requestIdRef.current;
+    setIsLoading(true);
+    setError(null);
+    client.listInbox({ status, category }).then((page) => {
+      if (requestIdRef.current !== requestId) return;
+      setItems(page.items);
+      setHasMore(page.hasMore);
+      cursorRef.current = page.nextCursor;
+    }).catch((err) => {
+      if (requestIdRef.current !== requestId) return;
+      setError(err instanceof Error ? err : new Error("Failed to load inbox."));
+    }).finally(() => {
+      if (requestIdRef.current === requestId) setIsLoading(false);
+    });
+  }, [client, status, category]);
+  (0, import_react3.useEffect)(() => {
+    fetchFirstPage();
+  }, [fetchFirstPage]);
+  const loadMore = (0, import_react3.useCallback)(() => {
+    if (isLoadingMore || !hasMore || cursorRef.current === null) return;
+    setIsLoadingMore(true);
+    client.listInbox({ status, category, cursor: cursorRef.current }).then((page) => {
+      setItems((prev) => [...prev, ...page.items]);
+      setHasMore(page.hasMore);
+      cursorRef.current = page.nextCursor;
+    }).catch((err) => {
+      setError(err instanceof Error ? err : new Error("Failed to load more of the inbox."));
+    }).finally(() => setIsLoadingMore(false));
+  }, [client, status, category, isLoadingMore, hasMore]);
+  const reconcileFirstPage = (0, import_react3.useCallback)(() => {
+    client.listInbox({ status, category }).then((page) => {
+      setItems((prev) => {
+        const freshById = new Map(page.items.map((item) => [item.id, item]));
+        const merged = prev.map((item) => freshById.get(item.id) ?? item);
+        const knownIds = new Set(merged.map((item) => item.id));
+        const additions = page.items.filter((item) => !knownIds.has(item.id));
+        return [...additions, ...merged];
+      });
+    }).catch(() => {
+    });
+  }, [client, status, category]);
+  (0, import_react3.useEffect)(
+    () => addEventListener((event) => {
+      if (event.type !== "item.created") return;
+      const partial = {
+        id: event.data.id,
+        title: event.data.title,
+        body: "",
+        actionUrl: null,
+        category: null,
+        seenAt: null,
+        readAt: null,
+        createdAt: event.data.created_at
+      };
+      setItems((prev) => prev.some((item) => item.id === partial.id) ? prev : [partial, ...prev]);
+      reconcileFirstPage();
+    }),
+    [addEventListener, reconcileFirstPage]
+  );
+  const markRead = (0, import_react3.useCallback)(
+    async (id) => {
+      const updated = await client.markRead(id);
+      setItems((prev) => prev.map((item) => item.id === id ? updated : item));
+    },
+    [client]
+  );
+  const markAllRead = (0, import_react3.useCallback)(async () => {
+    await client.markAllRead();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    setItems((prev) => prev.map((item) => item.readAt ? item : { ...item, readAt: now }));
+  }, [client]);
+  const archive = (0, import_react3.useCallback)(
+    async (id) => {
+      await client.archive(id);
+      setItems((prev) => prev.filter((item) => item.id !== id));
+    },
+    [client]
+  );
+  const remove = (0, import_react3.useCallback)(
+    async (id) => {
+      await client.delete(id);
+      setItems((prev) => prev.filter((item) => item.id !== id));
+    },
+    [client]
+  );
+  return {
+    items,
+    isLoading,
+    isLoadingMore,
+    error,
+    hasMore,
+    loadMore,
+    markRead,
+    markAllRead,
+    archive,
+    remove,
+    refetch: fetchFirstPage
+  };
+}
+
+// src/react/usePreferences.ts
+var import_react4 = require("react");
+function usePreferences() {
+  const { client } = useHermsContext();
+  const [preferences, setPreferences] = (0, import_react4.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react4.useState)(true);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const load = (0, import_react4.useCallback)(async () => {
+    setIsLoading(true);
+    try {
+      const fresh = await client.getPreferences();
+      setPreferences(fresh);
+      setError(null);
+    } catch (caught) {
+      setError(caught instanceof Error ? caught : new Error(String(caught)));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [client]);
+  (0, import_react4.useEffect)(() => {
+    let cancelled = false;
+    setIsLoading(true);
+    client.getPreferences().then((fresh) => {
+      if (cancelled) return;
+      setPreferences(fresh);
+      setError(null);
+    }).catch((caught) => {
+      if (cancelled) return;
+      setError(caught instanceof Error ? caught : new Error(String(caught)));
+    }).finally(() => {
+      if (!cancelled) setIsLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client]);
+  const setPreference = (0, import_react4.useCallback)(
+    async (update) => {
+      try {
+        setPreferences(await client.updatePreference(update));
+        setError(null);
+      } catch (caught) {
+        setError(caught instanceof Error ? caught : new Error(String(caught)));
+        throw caught;
+      }
+    },
+    [client]
+  );
+  return { preferences, isLoading, error, setPreference, reload: load };
+}
+
+// src/react/HermsInbox.tsx
+var import_react5 = require("react");
+var Popover = __toESM(require("@radix-ui/react-popover"), 1);
+
+// src/react/locale.ts
+var en = {
+  bellLabel: "Notifications",
+  bellLabelWithUnread: (count) => `Notifications, ${count} unread`,
+  panelTitle: "Notifications",
+  markAllRead: "Mark all as read",
+  close: "Close",
+  loading: "Loading notifications\u2026",
+  empty: "You're all caught up",
+  errorTitle: "Couldn't load notifications.",
+  retry: "Retry",
+  loadMore: "Load more",
+  loadingMore: "Loading\u2026",
+  archive: "Archive",
+  unreadDot: "Unread"
+};
+var fr = {
+  bellLabel: "Notifications",
+  bellLabelWithUnread: (count) => `Notifications, ${count} non lues`,
+  panelTitle: "Notifications",
+  markAllRead: "Tout marquer comme lu",
+  close: "Fermer",
+  loading: "Chargement des notifications\u2026",
+  empty: "Vous \xEAtes \xE0 jour",
+  errorTitle: "Impossible de charger les notifications.",
+  retry: "R\xE9essayer",
+  loadMore: "Charger plus",
+  loadingMore: "Chargement\u2026",
+  archive: "Archiver",
+  unreadDot: "Non lu"
+};
+var dictionaries = { en, fr };
+function getHermsInboxStrings(locale) {
+  return dictionaries[locale ?? "en"] ?? en;
+}
+
+// src/react/HermsInbox.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var placementToSideAlign = {
+  "bottom-start": { side: "bottom", align: "start" },
+  "bottom-end": { side: "bottom", align: "end" },
+  "top-start": { side: "top", align: "start" },
+  "top-end": { side: "top", align: "end" }
+};
+function BellIcon() {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("svg", { className: "herms-inbox__bell", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M6 8a6 6 0 0 1 12 0c0 5 2 6 2 6H4s2-1 2-6" }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M10 21a2 2 0 0 0 4 0" })
+  ] });
+}
+function CloseIcon() {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("svg", { viewBox: "0 0 24 24", width: "14", height: "14", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M18 6 6 18M6 6l12 12" }) });
+}
+function ArchiveIcon() {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("svg", { viewBox: "0 0 24 24", width: "15", height: "15", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("rect", { x: "3", y: "4", width: "18", height: "4", rx: "1" }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M5 8v10a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V8" }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M10 13h4" })
+  ] });
+}
+function AlertIcon() {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("svg", { viewBox: "0 0 24 24", width: "20", height: "20", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("circle", { cx: "12", cy: "12", r: "9" }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M12 8v5M12 16h.01" })
+  ] });
+}
+function relativeTime(iso, locale) {
+  const then = new Date(iso).getTime();
+  if (Number.isNaN(then)) return "";
+  const diffSeconds = Math.max(0, Math.round((Date.now() - then) / 1e3));
+  const formatter = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
+  if (diffSeconds < 60) return formatter.format(0, "minute");
+  const diffMinutes = Math.round(diffSeconds / 60);
+  if (diffMinutes < 60) return formatter.format(-diffMinutes, "minute");
+  const diffHours = Math.round(diffMinutes / 60);
+  if (diffHours < 24) return formatter.format(-diffHours, "hour");
+  const diffDays = Math.round(diffHours / 24);
+  return formatter.format(-diffDays, "day");
+}
+function HermsInbox({ placement = "bottom-end", onItemClick, theme, colorScheme = "auto", locale, className }) {
+  const { client } = useHermsContext();
+  const { unread, unseen } = useUnreadCount();
+  const { items, isLoading, isLoadingMore, error, hasMore, loadMore, markRead, markAllRead, archive, refetch } = useInbox();
+  const [open, setOpen] = (0, import_react5.useState)(false);
+  const [activeIndex, setActiveIndex] = (0, import_react5.useState)(0);
+  const itemRefs = (0, import_react5.useRef)([]);
+  const seenIdsRef = (0, import_react5.useRef)(/* @__PURE__ */ new Set());
+  const strings = getHermsInboxStrings(locale);
+  (0, import_react5.useEffect)(() => {
+    if (!open || items.length === 0) return;
+    const toMark = items.filter((item) => !seenIdsRef.current.has(item.id)).map((item) => item.id);
+    if (toMark.length === 0) return;
+    for (const id of toMark) seenIdsRef.current.add(id);
+    void client.markSeen(toMark);
+  }, [open, items, client]);
+  (0, import_react5.useEffect)(() => {
+    if (open) setActiveIndex(0);
+  }, [open]);
+  const focusItem = (0, import_react5.useCallback)((index) => {
+    setActiveIndex(index);
+    itemRefs.current[index]?.focus();
+  }, []);
+  const handleListKeyDown = (0, import_react5.useCallback)(
+    (event) => {
+      if (items.length === 0) return;
+      switch (event.key) {
+        case "ArrowDown":
+          event.preventDefault();
+          focusItem(Math.min(activeIndex + 1, items.length - 1));
+          break;
+        case "ArrowUp":
+          event.preventDefault();
+          focusItem(Math.max(activeIndex - 1, 0));
+          break;
+        case "Home":
+          event.preventDefault();
+          focusItem(0);
+          break;
+        case "End":
+          event.preventDefault();
+          focusItem(items.length - 1);
+          break;
+        default:
+          break;
+      }
+    },
+    [items.length, activeIndex, focusItem]
+  );
+  const handleActivate = (0, import_react5.useCallback)(
+    (item) => {
+      if (!item.readAt) void markRead(item.id);
+      if (onItemClick) {
+        onItemClick(item);
+      } else if (item.actionUrl && typeof window !== "undefined") {
+        window.location.assign(item.actionUrl);
+      }
+    },
+    [markRead, onItemClick]
+  );
+  const rootStyle = (0, import_react5.useMemo)(() => {
+    const style = {};
+    if (theme?.accent) style["--herms-color-accent"] = theme.accent;
+    if (theme?.radius) style["--herms-radius"] = theme.radius;
+    return style;
+  }, [theme?.accent, theme?.radius]);
+  const { side, align } = placementToSideAlign[placement];
+  const rootClassName = ["herms-inbox", className].filter(Boolean).join(" ");
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: rootClassName, style: rootStyle, "data-herms-color-scheme": colorScheme === "auto" ? void 0 : colorScheme, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "herms-inbox__visually-hidden", role: "status", "aria-live": "polite", children: unread > 0 ? strings.bellLabelWithUnread(unread) : "" }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Popover.Root, { open, onOpenChange: setOpen, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Popover.Trigger, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+        "button",
+        {
+          type: "button",
+          className: "herms-inbox__trigger",
+          "aria-label": unread > 0 ? strings.bellLabelWithUnread(unread) : strings.bellLabel,
+          "aria-expanded": open,
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(BellIcon, {}),
+            unseen > 0 && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "herms-inbox__badge", "aria-hidden": "true", children: unseen > 99 ? "99+" : unseen })
+          ]
+        }
+      ) }),
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Popover.Portal, { children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+        Popover.Content,
+        {
+          className: "herms-inbox__panel",
+          side,
+          align,
+          sideOffset: 8,
+          onOpenAutoFocus: (event) => {
+            if (items.length > 0) {
+              event.preventDefault();
+              itemRefs.current[0]?.focus();
+            }
+          },
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "herms-inbox__header", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: "herms-inbox__title", children: strings.panelTitle }),
+              /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "herms-inbox__header-actions", children: [
+                /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { type: "button", className: "herms-inbox__text-button", onClick: () => void markAllRead(), disabled: unread === 0, children: strings.markAllRead }),
+                /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Popover.Close, { asChild: true, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { type: "button", className: "herms-inbox__icon-button", "aria-label": strings.close, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(CloseIcon, {}) }) })
+              ] })
+            ] }),
+            isLoading ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { role: "status", "aria-label": strings.loading, children: [0, 1, 2, 3].map((i) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "herms-inbox__skeleton-line", style: { width: i % 2 === 0 ? "85%" : "65%" } }, i)) }) : error ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "herms-inbox__state", role: "alert", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(AlertIcon, {}),
+              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: "herms-inbox__state-title", children: strings.errorTitle }),
+              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { type: "button", className: "herms-inbox__text-button", onClick: () => refetch(), children: strings.retry })
+            ] }) : items.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "herms-inbox__state", children: strings.empty }) : /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
+              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("ul", { className: "herms-inbox__list", role: "menu", "aria-label": strings.panelTitle, onKeyDown: handleListKeyDown, children: items.map((item, index) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("li", { className: "herms-inbox__list-row", role: "none", children: [
+                /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+                  "button",
+                  {
+                    type: "button",
+                    role: "menuitem",
+                    ref: (el) => {
+                      itemRefs.current[index] = el;
+                    },
+                    tabIndex: index === activeIndex ? 0 : -1,
+                    className: "herms-inbox__item",
+                    "data-unread": !item.readAt,
+                    onFocus: () => setActiveIndex(index),
+                    onClick: () => handleActivate(item),
+                    children: [
+                      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "herms-inbox__item-title", children: item.title }),
+                      item.body && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "herms-inbox__item-body", children: item.body }),
+                      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "herms-inbox__item-meta", children: relativeTime(item.createdAt, locale ?? "en") })
+                    ]
+                  }
+                ),
+                /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+                  "button",
+                  {
+                    type: "button",
+                    className: "herms-inbox__archive-button",
+                    "aria-label": `${strings.archive}: ${item.title}`,
+                    onClick: (event) => {
+                      event.stopPropagation();
+                      void archive(item.id);
+                    },
+                    children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ArchiveIcon, {})
+                  }
+                )
+              ] }, item.id)) }),
+              hasMore && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { type: "button", className: "herms-inbox__load-more", onClick: loadMore, disabled: isLoadingMore, children: isLoadingMore ? strings.loadingMore : strings.loadMore })
+            ] })
+          ]
+        }
+      ) })
+    ] })
+  ] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HERMS_CHANNELS,
+  HermsApiError,
+  HermsClient,
+  HermsInbox,
+  HermsProvider,
+  decodeSubscriberTokenExp,
+  useHermsContext,
+  useInbox,
+  usePreferences,
+  useUnreadCount
+});
+//# sourceMappingURL=index.cjs.map