easy-ping 0.5.0 → 0.6.0

package/dist/react.d.ts

@@ -19,14 +19,64 @@ type NotifyState = {
     isLoading: boolean;
     error: Error | null;
 };
+type Transport = "auto" | "sse" | "poll";
+type TransportStatus = {
+    /** "leader" holds this browser's single connection; "follower" mirrors it; "solo" has no Web Locks. */
+    role: "leader" | "follower" | "solo";
+    /** What the leader is using right now. */
+    transport: "sse" | "poll";
+    /** True while the event stream has said `ready` and not since closed. */
+    connected: boolean;
+};
+type LockManagerLike = {
+    request(name: string, options: {
+        mode: "exclusive";
+        signal?: AbortSignal;
+    }, callback: () => Promise<void>): Promise<void>;
+};
+type ChannelLike = {
+    postMessage(message: unknown): void;
+    addEventListener(type: "message", handler: (event: {
+        data: unknown;
+    }) => void): void;
+    removeEventListener(type: "message", handler: (event: {
+        data: unknown;
+    }) => void): void;
+    close(): void;
+};
+type MessageTargetLike = {
+    addEventListener(type: string, handler: (event: {
+        data?: unknown;
+    }) => void): void;
+    removeEventListener(type: string, handler: (event: {
+        data?: unknown;
+    }) => void): void;
+};
 type NotifyClientOptions = {
     baseUrl?: string | undefined;
     fetch?: typeof globalThis.fetch | undefined;
     limit?: number | undefined;
+    /** Poll interval while the user is active and no stream is connected. Default 15 s. */
     pollIntervalMs?: number | undefined;
+    /** Ceiling the idle backoff grows to. Default 10 min. */
     maxPollIntervalMs?: number | undefined;
+    /** Poll interval while the event stream is connected: a safety net. Default 5 min. */
+    safetyNetMs?: number | undefined;
+    /** How long after user input polling stays at the base interval. Default 60 s. */
+    activeWindowMs?: number | undefined;
+    /** "auto" streams when a DOM is present, "poll" never streams, "sse" always tries. */
+    transport?: Transport | undefined;
     /** Injectable so the poller can be tested without a DOM. */
     isDocumentHidden?: (() => boolean) | undefined;
+    /** Web Locks, for one connection per browser. Defaults to navigator.locks; null disables. */
+    locks?: LockManagerLike | null | undefined;
+    /** Cross-tab channel factory. Defaults to BroadcastChannel; null disables. */
+    channel?: (() => ChannelLike) | null | undefined;
+    /** Where push relays arrive. Defaults to navigator.serviceWorker; null disables. */
+    serviceWorker?: MessageTargetLike | null | undefined;
+    /** Where user activity is observed. Defaults to window; null disables. */
+    activityTarget?: MessageTargetLike | null | undefined;
+    now?: (() => number) | undefined;
 };
 declare function createNotifyClient(options?: NotifyClientOptions): {
     subscribe: (listener: (state: NotifyState) => void) => () => void;
@@ -35,7 +85,9 @@ declare function createNotifyClient(options?: NotifyClientOptions): {
     markAsRead: (id: string) => Promise<void>;
     markAllRead: () => Promise<void>;
     markSeen: () => Promise<void>;
+    instrument: (inner: typeof globalThis.fetch) => typeof globalThis.fetch;
     getState: () => NotifyState;
+    getTransport: () => TransportStatus;
 };
 type NotifyClient = ReturnType<typeof createNotifyClient>;
 

package/dist/react.js

@@ -14,22 +14,62 @@ var INITIAL = {
   error: null
 };
 var countUnread = (rows) => rows.reduce((total, row) => row.readAt === null ? total + 1 : total, 0);
+var SHORT_STREAM_MS = 15e3;
+var SHORT_STREAMS_BEFORE_GIVING_UP = 3;
 function createNotifyClient(options = {}) {
   const baseUrl = (options.baseUrl ?? "/api/notifications").replace(/\/$/, "");
   const doFetch = options.fetch ?? ((...args) => globalThis.fetch(...args));
   const limit = options.limit ?? 20;
   const pollIntervalMs = options.pollIntervalMs ?? 15e3;
-  const maxPollIntervalMs = options.maxPollIntervalMs ?? 5 * 6e4;
+  const maxPollIntervalMs = options.maxPollIntervalMs ?? 10 * 6e4;
+  const safetyNetMs = options.safetyNetMs ?? 5 * 6e4;
+  const activeWindowMs = options.activeWindowMs ?? 6e4;
+  const now = options.now ?? (() => Date.now());
+  const hasDom = typeof window !== "undefined" && typeof document !== "undefined";
+  const transport = options.transport ?? "auto";
+  const wantsStream = transport === "sse" || transport === "auto" && hasDom;
   const isHidden = options.isDocumentHidden ?? (() => typeof document !== "undefined" && document.visibilityState === "hidden");
+  const locks = options.locks === void 0 ? typeof navigator !== "undefined" ? navigator.locks ?? null : null : options.locks;
+  const makeChannel = options.channel === void 0 ? typeof BroadcastChannel !== "undefined" ? () => new BroadcastChannel(`easy-ping:${baseUrl}`) : null : options.channel;
+  const serviceWorker = options.serviceWorker === void 0 ? typeof navigator !== "undefined" ? navigator.serviceWorker ?? null : null : options.serviceWorker;
+  const activityTarget = options.activityTarget === void 0 ? hasDom ? window : null : options.activityTarget;
   let state = INITIAL;
   const listeners = /* @__PURE__ */ new Set();
+  let role = "solo";
+  let running = false;
+  let channel;
+  let releaseLock;
+  let lockAbort;
   let timer;
   let consecutiveFailures = 0;
+  let idleTicks = 0;
+  let activeUntil = 0;
+  let lastRefreshAt = 0;
+  let refreshing;
+  let refreshAgain = false;
+  let streamAbort;
+  let streamConnected = false;
+  let streamDisabled = !wantsStream;
+  let shortStreams = 0;
+  let streamFailures = 0;
   let generation = 0;
+  const localReads = /* @__PURE__ */ new Set();
+  let localSeen = false;
+  const stamp = () => (/* @__PURE__ */ new Date()).toISOString();
+  function emit() {
+    for (const listener of listeners) listener(state);
+  }
   function set(patch) {
     state = { ...state, ...patch };
     state = { ...state, unreadCount: countUnread(state.notifications) };
-    for (const listener of listeners) listener(state);
+    emit();
+    if (role === "leader") post({ type: "state", state });
+  }
+  function post(message) {
+    try {
+      channel?.postMessage(message);
+    } catch {
+    }
   }
   async function request(path, init) {
     const response = await doFetch(`${baseUrl}${path}`, {
@@ -40,7 +80,7 @@ function createNotifyClient(options = {}) {
       throw new Error(`${init?.method ?? "GET"} ${path} failed: ${response.status}`);
     return await response.json();
   }
-  async function refresh() {
+  async function fetchPage() {
     const startedAt = generation;
     const page = await request(`/?limit=${limit}`);
     const unseenCount = page.unseenCount ?? (await request("/count")).unseen;
@@ -53,6 +93,24 @@ function createNotifyClient(options = {}) {
       error: null
     });
   }
+  function refresh() {
+    if (refreshing) {
+      refreshAgain = true;
+      return refreshing;
+    }
+    refreshing = (async () => {
+      try {
+        do {
+          refreshAgain = false;
+          await fetchPage();
+          lastRefreshAt = now();
+        } while (refreshAgain);
+      } finally {
+        refreshing = void 0;
+      }
+    })();
+    return refreshing;
+  }
   let loadingMore;
   async function loadMore() {
     if (!state.nextCursor) return;
@@ -81,30 +139,39 @@ function createNotifyClient(options = {}) {
     set({ notifications: apply(state.notifications), ...patch });
     try {
       await send();
+      if (role === "follower") post({ type: "mutated" });
     } catch (error) {
       generation += 1;
       state = previous;
-      for (const listener of listeners) listener(state);
+      emit();
       throw error;
     }
   }
-  const stamp = () => (/* @__PURE__ */ new Date()).toISOString();
   async function markAsRead(id) {
+    if (role === "follower") localReads.add(id);
     await optimistic(
       (rows) => rows.map((row) => row.id === id ? { ...row, readAt: row.readAt ?? stamp() } : row),
       {},
       () => request("/read", { method: "POST", body: JSON.stringify({ ids: [id] }) })
-    );
+    ).catch((error) => {
+      localReads.delete(id);
+      throw error;
+    });
   }
   async function markAllRead() {
+    if (role === "follower") for (const row of state.notifications) localReads.add(row.id);
     await optimistic(
       (rows) => rows.map((row) => ({ ...row, readAt: row.readAt ?? stamp() })),
       {},
       () => request("/read-all", { method: "POST" })
-    );
+    ).catch((error) => {
+      localReads.clear();
+      throw error;
+    });
   }
   async function markSeen() {
     const newest = state.notifications[0]?.createdAt;
+    if (role === "follower") localSeen = true;
     await optimistic(
       (rows) => rows.map((row) => ({ ...row, seenAt: row.seenAt ?? stamp() })),
       { unseenCount: 0 },
@@ -112,13 +179,55 @@ function createNotifyClient(options = {}) {
         method: "POST",
         body: JSON.stringify(newest ? { before: newest } : {})
       })
-    );
+    ).catch((error) => {
+      localSeen = false;
+      throw error;
+    });
+  }
+  function applyRemoteState(remote) {
+    const notifications = remote.notifications.map((row) => {
+      if (!localReads.has(row.id)) return row;
+      if (row.readAt) {
+        localReads.delete(row.id);
+        return row;
+      }
+      return { ...row, readAt: stamp() };
+    });
+    if (localSeen && remote.unseenCount === 0) localSeen = false;
+    state = {
+      ...remote,
+      notifications,
+      unseenCount: localSeen ? 0 : remote.unseenCount,
+      unreadCount: countUnread(notifications)
+    };
+    emit();
+  }
+  function onTabMessage(event) {
+    const message = event.data;
+    if (!message || typeof message !== "object") return;
+    if (role === "leader") {
+      if (message.type === "hello") post({ type: "state", state });
+      else if (message.type === "mutated") void refresh().catch(() => {
+      });
+      return;
+    }
+    if (message.type === "state") applyRemoteState(message.state);
   }
   function schedule(delay) {
     clearTimeout(timer);
     timer = setTimeout(tick, delay);
   }
+  function nextDelay() {
+    if (consecutiveFailures > 0) {
+      return Math.min(pollIntervalMs * 2 ** consecutiveFailures, maxPollIntervalMs);
+    }
+    if (streamConnected) return safetyNetMs;
+    if (now() < activeUntil) return pollIntervalMs;
+    idleTicks += 1;
+    return Math.min(pollIntervalMs * 2 ** idleTicks, maxPollIntervalMs);
+  }
   async function tick() {
+    if (!running) return;
     if (isHidden()) {
       schedule(pollIntervalMs);
       return;
@@ -130,20 +239,176 @@ function createNotifyClient(options = {}) {
       consecutiveFailures += 1;
       set({ isLoading: false, error: error instanceof Error ? error : new Error(String(error)) });
     }
-    schedule(
-      consecutiveFailures === 0 ? pollIntervalMs : Math.min(pollIntervalMs * 2 ** consecutiveFailures, maxPollIntervalMs)
-    );
+    if (running) schedule(nextDelay());
+  }
+  function onActivity() {
+    if (!running || role === "follower") return;
+    activeUntil = now() + activeWindowMs;
+    idleTicks = 0;
+    if (!isHidden() && now() - lastRefreshAt > pollIntervalMs) {
+      void refresh().catch(() => {
+      });
+      schedule(nextDelay());
+    }
+  }
+  const onVisibility = () => {
+    if (!isHidden()) onActivity();
+  };
+  const ACTIVITY_EVENTS = ["focus", "pointerdown", "keydown", "online"];
+  function changed() {
+    if (!running) return;
+    void refresh().catch(() => {
+    });
+  }
+  async function readStream(signal) {
+    const openedAt = now();
+    const response = await doFetch(`${baseUrl}/events`, {
+      headers: { accept: "text/event-stream" },
+      signal
+    });
+    if (!response.ok || !response.body) throw new Error(`GET /events failed: ${response.status}`);
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let eventName = "";
+    try {
+      for (; ; ) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        let newline = buffer.indexOf("\n");
+        while (newline >= 0) {
+          const line = buffer.slice(0, newline).replace(/\r$/, "");
+          buffer = buffer.slice(newline + 1);
+          if (line === "") {
+            if (eventName === "ready") {
+              streamConnected = true;
+              streamFailures = 0;
+              schedule(nextDelay());
+            } else if (eventName === "changed") changed();
+            eventName = "";
+          } else if (line.startsWith("event:")) eventName = line.slice(6).trim();
+          newline = buffer.indexOf("\n");
+        }
+      }
+    } finally {
+      streamConnected = false;
+      if (now() - openedAt < SHORT_STREAM_MS) shortStreams += 1;
+      else shortStreams = 0;
+    }
+  }
+  const isFollower = () => role === "follower";
+  async function streamLoop() {
+    while (running && !streamDisabled && !isFollower()) {
+      streamAbort = new AbortController();
+      try {
+        await readStream(streamAbort.signal);
+      } catch {
+        if (!running) return;
+        streamFailures += 1;
+      }
+      if (!running || isFollower()) return;
+      if (shortStreams >= SHORT_STREAMS_BEFORE_GIVING_UP) {
+        streamDisabled = true;
+        schedule(nextDelay());
+        return;
+      }
+      await new Promise(
+        (resolve) => setTimeout(resolve, Math.min(3e3 * 2 ** streamFailures, 6e4))
+      );
+    }
+  }
+  function becomeLeader() {
+    role = "leader";
+    post({ type: "leader" });
+    post({ type: "state", state });
+    void tick();
+    if (!streamDisabled) void streamLoop();
+  }
+  function becomeFollower() {
+    role = "follower";
+    post({ type: "hello" });
+  }
+  function acquireLeadership() {
+    if (!locks || !channel) {
+      role = "solo";
+      void tick();
+      if (!streamDisabled) void streamLoop();
+      return;
+    }
+    becomeFollower();
+    lockAbort = new AbortController();
+    locks.request(
+      `easy-ping:leader:${baseUrl}`,
+      { mode: "exclusive", signal: lockAbort.signal },
+      () => new Promise((resolve) => {
+        releaseLock = resolve;
+        if (running) becomeLeader();
+        else resolve();
+      })
+    ).catch(() => {
+    });
+  }
+  function start() {
+    running = true;
+    channel = makeChannel ? makeChannel() : void 0;
+    channel?.addEventListener("message", onTabMessage);
+    serviceWorker?.addEventListener("message", onRelay);
+    if (activityTarget) {
+      for (const name of ACTIVITY_EVENTS) activityTarget.addEventListener(name, onActivity);
+    }
+    if (typeof document !== "undefined") {
+      document.addEventListener("visibilitychange", onVisibility);
+    }
+    activeUntil = now() + activeWindowMs;
+    acquireLeadership();
+  }
+  function stop() {
+    running = false;
+    clearTimeout(timer);
+    timer = void 0;
+    streamAbort?.abort();
+    streamAbort = void 0;
+    lockAbort?.abort();
+    lockAbort = void 0;
+    releaseLock?.();
+    releaseLock = void 0;
+    channel?.removeEventListener("message", onTabMessage);
+    channel?.close();
+    channel = void 0;
+    serviceWorker?.removeEventListener("message", onRelay);
+    if (activityTarget) {
+      for (const name of ACTIVITY_EVENTS) activityTarget.removeEventListener(name, onActivity);
+    }
+    if (typeof document !== "undefined") {
+      document.removeEventListener("visibilitychange", onVisibility);
+    }
+    role = "solo";
+  }
+  function onRelay(event) {
+    const data = event.data;
+    if (data?.source === "easy-ping" && data.type === "changed") changed();
+  }
+  let lastInboxVersion = null;
+  function instrument(inner) {
+    return (async (...args) => {
+      const response = await inner(...args);
+      const version = response.headers.get("x-easy-ping-inbox");
+      if (version !== null && version !== lastInboxVersion) {
+        const first = lastInboxVersion === null;
+        lastInboxVersion = version;
+        if (!first && role !== "follower") changed();
+      }
+      return response;
+    });
   }
   function subscribe(listener) {
     listeners.add(listener);
     listener(state);
-    if (listeners.size === 1) void tick();
+    if (listeners.size === 1) start();
     return () => {
       listeners.delete(listener);
-      if (listeners.size === 0) {
-        clearTimeout(timer);
-        timer = void 0;
-      }
+      if (listeners.size === 0) stop();
     };
   }
   return {
@@ -153,13 +418,28 @@ function createNotifyClient(options = {}) {
     markAsRead,
     markAllRead,
     markSeen,
-    getState: () => state
+    instrument,
+    getState: () => state,
+    getTransport: () => ({
+      role,
+      transport: streamDisabled ? "poll" : "sse",
+      connected: streamConnected
+    })
   };
 }
 
 // src/react/index.ts
 function useNotifications(options = {}) {
-  const { client: provided, baseUrl, limit, pollIntervalMs, maxPollIntervalMs } = options;
+  const {
+    client: provided,
+    baseUrl,
+    limit,
+    pollIntervalMs,
+    maxPollIntervalMs,
+    safetyNetMs,
+    activeWindowMs,
+    transport
+  } = options;
   const callbacksRef = useRef(options);
   callbacksRef.current = options;
   const client = useMemo(
@@ -168,10 +448,22 @@ function useNotifications(options = {}) {
       limit,
       pollIntervalMs,
       maxPollIntervalMs,
+      safetyNetMs,
+      activeWindowMs,
+      transport,
       fetch: (...args) => (callbacksRef.current.fetch ?? globalThis.fetch)(...args),
       isDocumentHidden: () => callbacksRef.current.isDocumentHidden?.() ?? (typeof document !== "undefined" && document.visibilityState === "hidden")
     }),
-    [provided, baseUrl, limit, pollIntervalMs, maxPollIntervalMs]
+    [
+      provided,
+      baseUrl,
+      limit,
+      pollIntervalMs,
+      maxPollIntervalMs,
+      safetyNetMs,
+      activeWindowMs,
+      transport
+    ]
   );
   const [state, setState] = useState(() => client.getState());
   useEffect(() => client.subscribe(setState), [client]);

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/index.ts","../src/client/index.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport {\n  createNotifyClient,\n  type NotifyClient,\n  type NotifyClientOptions,\n  type NotifyState,\n} from \"../client\";\n\nexport type UseNotificationsResult = NotifyState & {\n  markAsRead: (id: string) => Promise<void>;\n  markAllRead: () => Promise<void>;\n  markSeen: () => Promise<void>;\n  loadMore: () => Promise<void>;\n  refresh: () => Promise<void>;\n};\n\n/** State lives in the framework-agnostic client; this only wires React's lifecycle. */\nexport function useNotifications(\n  options: NotifyClientOptions & { client?: NotifyClient } = {},\n): UseNotificationsResult {\n  const { client: provided, baseUrl, limit, pollIntervalMs, maxPollIntervalMs } = options;\n\n  // Held in a ref so a new callback identity per render does not rebuild the client.\n  const callbacksRef = useRef(options);\n  callbacksRef.current = options;\n\n  const client = useMemo(\n    () =>\n      provided ??\n      createNotifyClient({\n        baseUrl,\n        limit,\n        pollIntervalMs,\n        maxPollIntervalMs,\n        fetch: (...args) => (callbacksRef.current.fetch ?? globalThis.fetch)(...args),\n        isDocumentHidden: () =>\n          callbacksRef.current.isDocumentHidden?.() ??\n          (typeof document !== \"undefined\" && document.visibilityState === \"hidden\"),\n      }),\n    [provided, baseUrl, limit, pollIntervalMs, maxPollIntervalMs],\n  );\n\n  const [state, setState] = useState<NotifyState>(() => client.getState());\n\n  useEffect(() => client.subscribe(setState), [client]);\n\n  return {\n    ...state,\n    markAsRead: useCallback((id: string) => client.markAsRead(id), [client]),\n    markAllRead: useCallback(() => client.markAllRead(), [client]),\n    markSeen: useCallback(() => client.markSeen(), [client]),\n    loadMore: useCallback(() => client.loadMore(), [client]),\n    refresh: useCallback(() => client.refresh(), [client]),\n  };\n}\n\nexport type {\n  NotificationView,\n  NotifyClient,\n  NotifyClientOptions,\n  NotifyState,\n} from \"../client\";\nexport { createNotifyClient } from \"../client\";\n","export type NotificationView = {\n  id: string;\n  userId: string;\n  type: string;\n  payload: unknown;\n  actorId: string | null;\n  groupKey: string | null;\n  seenAt: string | null;\n  readAt: string | null;\n  createdAt: string;\n};\n\nexport type NotifyState = {\n  notifications: readonly NotificationView[];\n  /** Badge count — cleared when the dropdown opens. Server-authoritative. */\n  unseenCount: number;\n  /** Items still bold. Derived from what is loaded, not a server total. */\n  unreadCount: number;\n  nextCursor: string | null;\n  isLoading: boolean;\n  error: Error | null;\n};\n\nexport type NotifyClientOptions = {\n  baseUrl?: string | undefined;\n  fetch?: typeof globalThis.fetch | undefined;\n  limit?: number | undefined;\n  pollIntervalMs?: number | undefined;\n  maxPollIntervalMs?: number | undefined;\n  /** Injectable so the poller can be tested without a DOM. */\n  isDocumentHidden?: (() => boolean) | undefined;\n};\n\nconst INITIAL: NotifyState = {\n  notifications: [],\n  unseenCount: 0,\n  unreadCount: 0,\n  nextCursor: null,\n  isLoading: true,\n  error: null,\n};\n\nconst countUnread = (rows: readonly NotificationView[]) =>\n  rows.reduce((total, row) => (row.readAt === null ? total + 1 : total), 0);\n\nexport function createNotifyClient(options: NotifyClientOptions = {}) {\n  const baseUrl = (options.baseUrl ?? \"/api/notifications\").replace(/\\/$/, \"\");\n  const doFetch = options.fetch ?? ((...args) => globalThis.fetch(...args));\n  const limit = options.limit ?? 20;\n  const pollIntervalMs = options.pollIntervalMs ?? 15_000;\n  const maxPollIntervalMs = options.maxPollIntervalMs ?? 5 * 60_000;\n  const isHidden =\n    options.isDocumentHidden ??\n    (() => typeof document !== \"undefined\" && document.visibilityState === \"hidden\");\n\n  let state: NotifyState = INITIAL;\n  const listeners = new Set<(state: NotifyState) => void>();\n\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let consecutiveFailures = 0;\n\n  // Bumped per mutation so an in-flight poll cannot revert an optimistic update.\n  let generation = 0;\n\n  function set(patch: Partial<NotifyState>) {\n    state = { ...state, ...patch };\n    state = { ...state, unreadCount: countUnread(state.notifications) };\n    for (const listener of listeners) listener(state);\n  }\n\n  async function request<T>(path: string, init?: RequestInit): Promise<T> {\n    const response = await doFetch(`${baseUrl}${path}`, {\n      ...init,\n      headers: { \"content-type\": \"application/json\", ...init?.headers },\n    });\n    if (!response.ok)\n      throw new Error(`${init?.method ?? \"GET\"} ${path} failed: ${response.status}`);\n    return (await response.json()) as T;\n  }\n\n  async function refresh(): Promise<void> {\n    const startedAt = generation;\n\n    // One request per poll; /count is only the fallback for a server too old to send unseenCount.\n    const page = await request<{\n      notifications: NotificationView[];\n      nextCursor: string | null;\n      unseenCount?: number;\n    }>(`/?limit=${limit}`);\n\n    const unseenCount = page.unseenCount ?? (await request<{ unseen: number }>(\"/count\")).unseen;\n\n    // A mutation landed while this was in flight; the response is stale.\n    if (generation !== startedAt) return;\n\n    set({\n      notifications: page.notifications,\n      nextCursor: page.nextCursor,\n      unseenCount,\n      isLoading: false,\n      error: null,\n    });\n  }\n\n  let loadingMore: Promise<void> | undefined;\n\n  async function loadMore(): Promise<void> {\n    if (!state.nextCursor) return;\n\n    // Share the in-flight request so two clicks cannot append the same page twice.\n    if (loadingMore) return loadingMore;\n\n    const cursor = state.nextCursor;\n\n    loadingMore = (async () => {\n      try {\n        const page = await request<{\n          notifications: NotificationView[];\n          nextCursor: string | null;\n        }>(`/?limit=${limit}&cursor=${encodeURIComponent(cursor)}`);\n\n        const known = new Set(state.notifications.map((row) => row.id));\n\n        set({\n          notifications: [\n            ...state.notifications,\n            ...page.notifications.filter((row) => !known.has(row.id)),\n          ],\n          nextCursor: page.nextCursor,\n        });\n      } finally {\n        loadingMore = undefined;\n      }\n    })();\n\n    return loadingMore;\n  }\n\n  /** Applies a patch immediately and reverts it if the request fails. */\n  async function optimistic(\n    apply: (rows: readonly NotificationView[]) => readonly NotificationView[],\n    patch: Partial<NotifyState>,\n    send: () => Promise<unknown>,\n  ): Promise<void> {\n    const previous = state;\n    generation += 1;\n    set({ notifications: apply(state.notifications), ...patch });\n\n    try {\n      await send();\n    } catch (error) {\n      generation += 1;\n      state = previous;\n      for (const listener of listeners) listener(state);\n      throw error;\n    }\n  }\n\n  const stamp = () => new Date().toISOString();\n\n  async function markAsRead(id: string): Promise<void> {\n    await optimistic(\n      (rows) =>\n        rows.map((row) => (row.id === id ? { ...row, readAt: row.readAt ?? stamp() } : row)),\n      {},\n      () => request(\"/read\", { method: \"POST\", body: JSON.stringify({ ids: [id] }) }),\n    );\n  }\n\n  async function markAllRead(): Promise<void> {\n    await optimistic(\n      (rows) => rows.map((row) => ({ ...row, readAt: row.readAt ?? stamp() })),\n      {},\n      () => request(\"/read-all\", { method: \"POST\" }),\n    );\n  }\n\n  async function markSeen(): Promise<void> {\n    // Only what the user could have seen: no cutoff would mark newer arrivals seen too.\n    const newest = state.notifications[0]?.createdAt;\n\n    await optimistic(\n      (rows) => rows.map((row) => ({ ...row, seenAt: row.seenAt ?? stamp() })),\n      { unseenCount: 0 },\n      () =>\n        request(\"/seen\", {\n          method: \"POST\",\n          body: JSON.stringify(newest ? { before: newest } : {}),\n        }),\n    );\n  }\n\n  function schedule(delay: number) {\n    clearTimeout(timer);\n    timer = setTimeout(tick, delay);\n  }\n\n  async function tick() {\n    // A hidden tab is not looking at the bell.\n    if (isHidden()) {\n      schedule(pollIntervalMs);\n      return;\n    }\n\n    try {\n      await refresh();\n      consecutiveFailures = 0;\n    } catch (error) {\n      consecutiveFailures += 1;\n      set({ isLoading: false, error: error instanceof Error ? error : new Error(String(error)) });\n    }\n\n    // Back off on failure so an outage does not become a retry storm.\n    schedule(\n      consecutiveFailures === 0\n        ? pollIntervalMs\n        : Math.min(pollIntervalMs * 2 ** consecutiveFailures, maxPollIntervalMs),\n    );\n  }\n\n  function subscribe(listener: (state: NotifyState) => void): () => void {\n    listeners.add(listener);\n    listener(state);\n\n    // One poller regardless of how many components subscribe.\n    if (listeners.size === 1) void tick();\n\n    return () => {\n      listeners.delete(listener);\n      if (listeners.size === 0) {\n        clearTimeout(timer);\n        timer = undefined;\n      }\n    };\n  }\n\n  return {\n    subscribe,\n    refresh,\n    loadMore,\n    markAsRead,\n    markAllRead,\n    markSeen,\n    getState: () => state,\n  };\n}\n\nexport type NotifyClient = ReturnType<typeof createNotifyClient>;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/react/index.ts","../src/client/index.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport {\n  createNotifyClient,\n  type NotifyClient,\n  type NotifyClientOptions,\n  type NotifyState,\n} from \"../client\";\n\nexport type UseNotificationsResult = NotifyState & {\n  markAsRead: (id: string) => Promise<void>;\n  markAllRead: () => Promise<void>;\n  markSeen: () => Promise<void>;\n  loadMore: () => Promise<void>;\n  refresh: () => Promise<void>;\n};\n\n/** State lives in the framework-agnostic client; this only wires React's lifecycle. */\nexport function useNotifications(\n  options: NotifyClientOptions & { client?: NotifyClient } = {},\n): UseNotificationsResult {\n  const {\n    client: provided,\n    baseUrl,\n    limit,\n    pollIntervalMs,\n    maxPollIntervalMs,\n    safetyNetMs,\n    activeWindowMs,\n    transport,\n  } = options;\n\n  // Held in a ref so a new callback identity per render does not rebuild the client.\n  const callbacksRef = useRef(options);\n  callbacksRef.current = options;\n\n  const client = useMemo(\n    () =>\n      provided ??\n      createNotifyClient({\n        baseUrl,\n        limit,\n        pollIntervalMs,\n        maxPollIntervalMs,\n        safetyNetMs,\n        activeWindowMs,\n        transport,\n        fetch: (...args) => (callbacksRef.current.fetch ?? globalThis.fetch)(...args),\n        isDocumentHidden: () =>\n          callbacksRef.current.isDocumentHidden?.() ??\n          (typeof document !== \"undefined\" && document.visibilityState === \"hidden\"),\n      }),\n    [\n      provided,\n      baseUrl,\n      limit,\n      pollIntervalMs,\n      maxPollIntervalMs,\n      safetyNetMs,\n      activeWindowMs,\n      transport,\n    ],\n  );\n\n  const [state, setState] = useState<NotifyState>(() => client.getState());\n\n  useEffect(() => client.subscribe(setState), [client]);\n\n  return {\n    ...state,\n    markAsRead: useCallback((id: string) => client.markAsRead(id), [client]),\n    markAllRead: useCallback(() => client.markAllRead(), [client]),\n    markSeen: useCallback(() => client.markSeen(), [client]),\n    loadMore: useCallback(() => client.loadMore(), [client]),\n    refresh: useCallback(() => client.refresh(), [client]),\n  };\n}\n\nexport type {\n  NotificationView,\n  NotifyClient,\n  NotifyClientOptions,\n  NotifyState,\n} from \"../client\";\nexport { createNotifyClient } from \"../client\";\n","export type NotificationView = {\n  id: string;\n  userId: string;\n  type: string;\n  payload: unknown;\n  actorId: string | null;\n  groupKey: string | null;\n  seenAt: string | null;\n  readAt: string | null;\n  createdAt: string;\n};\n\nexport type NotifyState = {\n  notifications: readonly NotificationView[];\n  /** Badge count — cleared when the dropdown opens. Server-authoritative. */\n  unseenCount: number;\n  /** Items still bold. Derived from what is loaded, not a server total. */\n  unreadCount: number;\n  nextCursor: string | null;\n  isLoading: boolean;\n  error: Error | null;\n};\n\nexport type Transport = \"auto\" | \"sse\" | \"poll\";\n\nexport type TransportStatus = {\n  /** \"leader\" holds this browser's single connection; \"follower\" mirrors it; \"solo\" has no Web Locks. */\n  role: \"leader\" | \"follower\" | \"solo\";\n  /** What the leader is using right now. */\n  transport: \"sse\" | \"poll\";\n  /** True while the event stream has said `ready` and not since closed. */\n  connected: boolean;\n};\n\ntype LockManagerLike = {\n  request(\n    name: string,\n    options: { mode: \"exclusive\"; signal?: AbortSignal },\n    callback: () => Promise<void>,\n  ): Promise<void>;\n};\n\ntype ChannelLike = {\n  postMessage(message: unknown): void;\n  addEventListener(type: \"message\", handler: (event: { data: unknown }) => void): void;\n  removeEventListener(type: \"message\", handler: (event: { data: unknown }) => void): void;\n  close(): void;\n};\n\ntype MessageTargetLike = {\n  addEventListener(type: string, handler: (event: { data?: unknown }) => void): void;\n  removeEventListener(type: string, handler: (event: { data?: unknown }) => void): void;\n};\n\nexport type NotifyClientOptions = {\n  baseUrl?: string | undefined;\n  fetch?: typeof globalThis.fetch | undefined;\n  limit?: number | undefined;\n  /** Poll interval while the user is active and no stream is connected. Default 15 s. */\n  pollIntervalMs?: number | undefined;\n  /** Ceiling the idle backoff grows to. Default 10 min. */\n  maxPollIntervalMs?: number | undefined;\n  /** Poll interval while the event stream is connected: a safety net. Default 5 min. */\n  safetyNetMs?: number | undefined;\n  /** How long after user input polling stays at the base interval. Default 60 s. */\n  activeWindowMs?: number | undefined;\n  /** \"auto\" streams when a DOM is present, \"poll\" never streams, \"sse\" always tries. */\n  transport?: Transport | undefined;\n  /** Injectable so the poller can be tested without a DOM. */\n  isDocumentHidden?: (() => boolean) | undefined;\n  /** Web Locks, for one connection per browser. Defaults to navigator.locks; null disables. */\n  locks?: LockManagerLike | null | undefined;\n  /** Cross-tab channel factory. Defaults to BroadcastChannel; null disables. */\n  channel?: (() => ChannelLike) | null | undefined;\n  /** Where push relays arrive. Defaults to navigator.serviceWorker; null disables. */\n  serviceWorker?: MessageTargetLike | null | undefined;\n  /** Where user activity is observed. Defaults to window; null disables. */\n  activityTarget?: MessageTargetLike | null | undefined;\n  now?: (() => number) | undefined;\n};\n\nconst INITIAL: NotifyState = {\n  notifications: [],\n  unseenCount: 0,\n  unreadCount: 0,\n  nextCursor: null,\n  isLoading: true,\n  error: null,\n};\n\nconst countUnread = (rows: readonly NotificationView[]) =>\n  rows.reduce((total, row) => (row.readAt === null ? total + 1 : total), 0);\n\n/** A stream that dies this fast, repeatedly, is being cut by the platform: stop trying. */\nconst SHORT_STREAM_MS = 15_000;\nconst SHORT_STREAMS_BEFORE_GIVING_UP = 3;\n\ntype TabMessage =\n  | { type: \"hello\" }\n  | { type: \"state\"; state: NotifyState }\n  | { type: \"mutated\" }\n  | { type: \"leader\" };\n\nexport function createNotifyClient(options: NotifyClientOptions = {}) {\n  const baseUrl = (options.baseUrl ?? \"/api/notifications\").replace(/\\/$/, \"\");\n  const doFetch = options.fetch ?? ((...args) => globalThis.fetch(...args));\n  const limit = options.limit ?? 20;\n  const pollIntervalMs = options.pollIntervalMs ?? 15_000;\n  const maxPollIntervalMs = options.maxPollIntervalMs ?? 10 * 60_000;\n  const safetyNetMs = options.safetyNetMs ?? 5 * 60_000;\n  const activeWindowMs = options.activeWindowMs ?? 60_000;\n  const now = options.now ?? (() => Date.now());\n  const hasDom = typeof window !== \"undefined\" && typeof document !== \"undefined\";\n  const transport: Transport = options.transport ?? \"auto\";\n  const wantsStream = transport === \"sse\" || (transport === \"auto\" && hasDom);\n  const isHidden =\n    options.isDocumentHidden ??\n    (() => typeof document !== \"undefined\" && document.visibilityState === \"hidden\");\n\n  const locks =\n    options.locks === undefined\n      ? typeof navigator !== \"undefined\"\n        ? ((navigator as { locks?: LockManagerLike }).locks ?? null)\n        : null\n      : options.locks;\n  const makeChannel =\n    options.channel === undefined\n      ? typeof BroadcastChannel !== \"undefined\"\n        ? () => new BroadcastChannel(`easy-ping:${baseUrl}`) as unknown as ChannelLike\n        : null\n      : options.channel;\n  const serviceWorker =\n    options.serviceWorker === undefined\n      ? typeof navigator !== \"undefined\"\n        ? ((navigator as { serviceWorker?: MessageTargetLike }).serviceWorker ?? null)\n        : null\n      : options.serviceWorker;\n  const activityTarget =\n    options.activityTarget === undefined\n      ? hasDom\n        ? (window as unknown as MessageTargetLike)\n        : null\n      : options.activityTarget;\n\n  let state: NotifyState = INITIAL;\n  const listeners = new Set<(state: NotifyState) => void>();\n\n  let role: TransportStatus[\"role\"] = \"solo\";\n  let running = false;\n  let channel: ChannelLike | undefined;\n  let releaseLock: (() => void) | undefined;\n  let lockAbort: AbortController | undefined;\n\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let consecutiveFailures = 0;\n  let idleTicks = 0;\n  let activeUntil = 0;\n  let lastRefreshAt = 0;\n  let refreshing: Promise<void> | undefined;\n  let refreshAgain = false;\n\n  let streamAbort: AbortController | undefined;\n  let streamConnected = false;\n  let streamDisabled = !wantsStream;\n  let shortStreams = 0;\n  let streamFailures = 0;\n\n  // Bumped per mutation so an in-flight poll cannot revert an optimistic update.\n  let generation = 0;\n\n  // A follower's own optimistic changes, kept until the leader's state reflects them.\n  const localReads = new Set<string>();\n  let localSeen = false;\n\n  const stamp = () => new Date().toISOString();\n\n  function emit() {\n    for (const listener of listeners) listener(state);\n  }\n\n  function set(patch: Partial<NotifyState>) {\n    state = { ...state, ...patch };\n    state = { ...state, unreadCount: countUnread(state.notifications) };\n    emit();\n    if (role === \"leader\") post({ type: \"state\", state });\n  }\n\n  function post(message: TabMessage) {\n    try {\n      channel?.postMessage(message);\n    } catch {\n      // channel closed\n    }\n  }\n\n  async function request<T>(path: string, init?: RequestInit): Promise<T> {\n    const response = await doFetch(`${baseUrl}${path}`, {\n      ...init,\n      headers: { \"content-type\": \"application/json\", ...init?.headers },\n    });\n    if (!response.ok)\n      throw new Error(`${init?.method ?? \"GET\"} ${path} failed: ${response.status}`);\n    return (await response.json()) as T;\n  }\n\n  async function fetchPage(): Promise<void> {\n    const startedAt = generation;\n\n    const page = await request<{\n      notifications: NotificationView[];\n      nextCursor: string | null;\n      unseenCount?: number;\n    }>(`/?limit=${limit}`);\n\n    const unseenCount = page.unseenCount ?? (await request<{ unseen: number }>(\"/count\")).unseen;\n\n    // A mutation landed while this was in flight; the response is stale.\n    if (generation !== startedAt) return;\n\n    set({\n      notifications: page.notifications,\n      nextCursor: page.nextCursor,\n      unseenCount,\n      isLoading: false,\n      error: null,\n    });\n  }\n\n  /** Coalesces overlapping calls: a second request while one is in flight runs once after it. */\n  function refresh(): Promise<void> {\n    if (refreshing) {\n      refreshAgain = true;\n      return refreshing;\n    }\n    refreshing = (async () => {\n      try {\n        do {\n          refreshAgain = false;\n          await fetchPage();\n          lastRefreshAt = now();\n        } while (refreshAgain);\n      } finally {\n        refreshing = undefined;\n      }\n    })();\n    return refreshing;\n  }\n\n  let loadingMore: Promise<void> | undefined;\n\n  async function loadMore(): Promise<void> {\n    if (!state.nextCursor) return;\n\n    // Share the in-flight request so two clicks cannot append the same page twice.\n    if (loadingMore) return loadingMore;\n\n    const cursor = state.nextCursor;\n\n    loadingMore = (async () => {\n      try {\n        const page = await request<{\n          notifications: NotificationView[];\n          nextCursor: string | null;\n        }>(`/?limit=${limit}&cursor=${encodeURIComponent(cursor)}`);\n\n        const known = new Set(state.notifications.map((row) => row.id));\n\n        set({\n          notifications: [\n            ...state.notifications,\n            ...page.notifications.filter((row) => !known.has(row.id)),\n          ],\n          nextCursor: page.nextCursor,\n        });\n      } finally {\n        loadingMore = undefined;\n      }\n    })();\n\n    return loadingMore;\n  }\n\n  /** Applies a patch immediately and reverts it if the request fails. */\n  async function optimistic(\n    apply: (rows: readonly NotificationView[]) => readonly NotificationView[],\n    patch: Partial<NotifyState>,\n    send: () => Promise<unknown>,\n  ): Promise<void> {\n    const previous = state;\n    generation += 1;\n    set({ notifications: apply(state.notifications), ...patch });\n\n    try {\n      await send();\n      if (role === \"follower\") post({ type: \"mutated\" });\n    } catch (error) {\n      generation += 1;\n      state = previous;\n      emit();\n      throw error;\n    }\n  }\n\n  async function markAsRead(id: string): Promise<void> {\n    if (role === \"follower\") localReads.add(id);\n    await optimistic(\n      (rows) =>\n        rows.map((row) => (row.id === id ? { ...row, readAt: row.readAt ?? stamp() } : row)),\n      {},\n      () => request(\"/read\", { method: \"POST\", body: JSON.stringify({ ids: [id] }) }),\n    ).catch((error) => {\n      localReads.delete(id);\n      throw error;\n    });\n  }\n\n  async function markAllRead(): Promise<void> {\n    if (role === \"follower\") for (const row of state.notifications) localReads.add(row.id);\n    await optimistic(\n      (rows) => rows.map((row) => ({ ...row, readAt: row.readAt ?? stamp() })),\n      {},\n      () => request(\"/read-all\", { method: \"POST\" }),\n    ).catch((error) => {\n      localReads.clear();\n      throw error;\n    });\n  }\n\n  async function markSeen(): Promise<void> {\n    // Only what the user could have seen: no cutoff would mark newer arrivals seen too.\n    const newest = state.notifications[0]?.createdAt;\n    if (role === \"follower\") localSeen = true;\n\n    await optimistic(\n      (rows) => rows.map((row) => ({ ...row, seenAt: row.seenAt ?? stamp() })),\n      { unseenCount: 0 },\n      () =>\n        request(\"/seen\", {\n          method: \"POST\",\n          body: JSON.stringify(newest ? { before: newest } : {}),\n        }),\n    ).catch((error) => {\n      localSeen = false;\n      throw error;\n    });\n  }\n\n  // ---- follower: mirror the leader, keep own optimistic changes until confirmed ----\n\n  function applyRemoteState(remote: NotifyState) {\n    const notifications = remote.notifications.map((row) => {\n      if (!localReads.has(row.id)) return row;\n      if (row.readAt) {\n        localReads.delete(row.id);\n        return row;\n      }\n      return { ...row, readAt: stamp() };\n    });\n    if (localSeen && remote.unseenCount === 0) localSeen = false;\n    state = {\n      ...remote,\n      notifications,\n      unseenCount: localSeen ? 0 : remote.unseenCount,\n      unreadCount: countUnread(notifications),\n    };\n    emit();\n  }\n\n  function onTabMessage(event: { data: unknown }) {\n    const message = event.data as TabMessage | null;\n    if (!message || typeof message !== \"object\") return;\n    if (role === \"leader\") {\n      if (message.type === \"hello\") post({ type: \"state\", state });\n      else if (message.type === \"mutated\") void refresh().catch(() => {});\n      return;\n    }\n    if (message.type === \"state\") applyRemoteState(message.state);\n  }\n\n  // ---- leader / solo: polling with activity-shaped backoff ----\n\n  function schedule(delay: number) {\n    clearTimeout(timer);\n    timer = setTimeout(tick, delay);\n  }\n\n  function nextDelay(): number {\n    if (consecutiveFailures > 0) {\n      return Math.min(pollIntervalMs * 2 ** consecutiveFailures, maxPollIntervalMs);\n    }\n    if (streamConnected) return safetyNetMs;\n    if (now() < activeUntil) return pollIntervalMs;\n    idleTicks += 1;\n    return Math.min(pollIntervalMs * 2 ** idleTicks, maxPollIntervalMs);\n  }\n\n  async function tick() {\n    if (!running) return;\n    // A hidden tab is not looking at the bell.\n    if (isHidden()) {\n      schedule(pollIntervalMs);\n      return;\n    }\n\n    try {\n      await refresh();\n      consecutiveFailures = 0;\n    } catch (error) {\n      consecutiveFailures += 1;\n      set({ isLoading: false, error: error instanceof Error ? error : new Error(String(error)) });\n    }\n\n    if (running) schedule(nextDelay());\n  }\n\n  /** User input or a returning tab: poll fast again, and catch up now if the last refresh is stale. */\n  function onActivity() {\n    if (!running || role === \"follower\") return;\n    activeUntil = now() + activeWindowMs;\n    idleTicks = 0;\n    if (!isHidden() && now() - lastRefreshAt > pollIntervalMs) {\n      void refresh().catch(() => {});\n      schedule(nextDelay());\n    }\n  }\n\n  const onVisibility = () => {\n    if (!isHidden()) onActivity();\n  };\n\n  const ACTIVITY_EVENTS = [\"focus\", \"pointerdown\", \"keydown\", \"online\"];\n\n  // ---- leader / solo: the event stream ----\n\n  function changed() {\n    if (!running) return;\n    void refresh().catch(() => {});\n  }\n\n  async function readStream(signal: AbortSignal): Promise<void> {\n    const openedAt = now();\n    const response = await doFetch(`${baseUrl}/events`, {\n      headers: { accept: \"text/event-stream\" },\n      signal,\n    });\n    if (!response.ok || !response.body) throw new Error(`GET /events failed: ${response.status}`);\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n    let eventName = \"\";\n\n    try {\n      for (;;) {\n        const { done, value } = await reader.read();\n        if (done) break;\n        buffer += decoder.decode(value, { stream: true });\n        let newline = buffer.indexOf(\"\\n\");\n        while (newline >= 0) {\n          const line = buffer.slice(0, newline).replace(/\\r$/, \"\");\n          buffer = buffer.slice(newline + 1);\n          if (line === \"\") {\n            if (eventName === \"ready\") {\n              streamConnected = true;\n              streamFailures = 0;\n              schedule(nextDelay());\n            } else if (eventName === \"changed\") changed();\n            eventName = \"\";\n          } else if (line.startsWith(\"event:\")) eventName = line.slice(6).trim();\n          newline = buffer.indexOf(\"\\n\");\n        }\n      }\n    } finally {\n      streamConnected = false;\n      if (now() - openedAt < SHORT_STREAM_MS) shortStreams += 1;\n      else shortStreams = 0;\n    }\n  }\n\n  const isFollower = () => role === \"follower\";\n\n  async function streamLoop() {\n    while (running && !streamDisabled && !isFollower()) {\n      streamAbort = new AbortController();\n      try {\n        await readStream(streamAbort.signal);\n      } catch {\n        if (!running) return;\n        streamFailures += 1;\n      }\n      if (!running || isFollower()) return;\n      if (shortStreams >= SHORT_STREAMS_BEFORE_GIVING_UP) {\n        // The platform cuts streams too fast for them to be worth it here.\n        streamDisabled = true;\n        schedule(nextDelay());\n        return;\n      }\n      await new Promise((resolve) =>\n        setTimeout(resolve, Math.min(3_000 * 2 ** streamFailures, 60_000)),\n      );\n    }\n  }\n\n  // ---- roles ----\n\n  function becomeLeader() {\n    role = \"leader\";\n    post({ type: \"leader\" });\n    post({ type: \"state\", state });\n    void tick();\n    if (!streamDisabled) void streamLoop();\n  }\n\n  function becomeFollower() {\n    role = \"follower\";\n    post({ type: \"hello\" });\n  }\n\n  function acquireLeadership() {\n    if (!locks || !channel) {\n      role = \"solo\";\n      void tick();\n      if (!streamDisabled) void streamLoop();\n      return;\n    }\n    becomeFollower();\n    lockAbort = new AbortController();\n    locks\n      .request(\n        `easy-ping:leader:${baseUrl}`,\n        { mode: \"exclusive\", signal: lockAbort.signal },\n        () =>\n          new Promise<void>((resolve) => {\n            releaseLock = resolve;\n            if (running) becomeLeader();\n            else resolve();\n          }),\n      )\n      .catch(() => {\n        // aborted on stop, or Web Locks refused; either way no leadership here\n      });\n  }\n\n  function start() {\n    running = true;\n    channel = makeChannel ? makeChannel() : undefined;\n    channel?.addEventListener(\"message\", onTabMessage);\n    serviceWorker?.addEventListener(\"message\", onRelay);\n    if (activityTarget) {\n      for (const name of ACTIVITY_EVENTS) activityTarget.addEventListener(name, onActivity);\n    }\n    if (typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", onVisibility);\n    }\n    activeUntil = now() + activeWindowMs;\n    acquireLeadership();\n  }\n\n  function stop() {\n    running = false;\n    clearTimeout(timer);\n    timer = undefined;\n    streamAbort?.abort();\n    streamAbort = undefined;\n    lockAbort?.abort();\n    lockAbort = undefined;\n    releaseLock?.();\n    releaseLock = undefined;\n    channel?.removeEventListener(\"message\", onTabMessage);\n    channel?.close();\n    channel = undefined;\n    serviceWorker?.removeEventListener(\"message\", onRelay);\n    if (activityTarget) {\n      for (const name of ACTIVITY_EVENTS) activityTarget.removeEventListener(name, onActivity);\n    }\n    if (typeof document !== \"undefined\") {\n      document.removeEventListener(\"visibilitychange\", onVisibility);\n    }\n    role = \"solo\";\n  }\n\n  // ---- signals from outside: the service worker relay and the piggyback header ----\n\n  function onRelay(event: { data?: unknown }) {\n    const data = event.data as { source?: unknown; type?: unknown } | null;\n    if (data?.source === \"easy-ping\" && data.type === \"changed\") changed();\n  }\n\n  let lastInboxVersion: string | null = null;\n\n  /**\n   * Wraps your app's fetch so responses carrying the inbox-version header\n   * refresh the bell when the version moves. Active users then never need a\n   * dedicated poll. RFC 0006 idea 1.\n   */\n  function instrument(inner: typeof globalThis.fetch): typeof globalThis.fetch {\n    return (async (...args: Parameters<typeof globalThis.fetch>) => {\n      const response = await inner(...args);\n      const version = response.headers.get(\"x-easy-ping-inbox\");\n      if (version !== null && version !== lastInboxVersion) {\n        const first = lastInboxVersion === null;\n        lastInboxVersion = version;\n        if (!first && role !== \"follower\") changed();\n      }\n      return response;\n    }) as typeof globalThis.fetch;\n  }\n\n  function subscribe(listener: (state: NotifyState) => void): () => void {\n    listeners.add(listener);\n    listener(state);\n\n    // One transport regardless of how many components subscribe.\n    if (listeners.size === 1) start();\n\n    return () => {\n      listeners.delete(listener);\n      if (listeners.size === 0) stop();\n    };\n  }\n\n  return {\n    subscribe,\n    refresh,\n    loadMore,\n    markAsRead,\n    markAllRead,\n    markSeen,\n    instrument,\n    getState: () => state,\n    getTransport: (): TransportStatus => ({\n      role,\n      transport: streamDisabled ? \"poll\" : \"sse\",\n      connected: streamConnected,\n    }),\n  };\n}\n\nexport type NotifyClient = ReturnType<typeof createNotifyClient>;\n"],"mappings":"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","names":[]}

package/dist/schema.js

@@ -1,6 +1,6 @@
 export { INTROSPECT_SQL, planPostgresMigration, renderDrizzleSchema, renderPostgresDdl } from './chunk-XIDVLYNQ.js';
-export { renderSqliteDdl } from './chunk-HY47TQMY.js';
 export { renderMysqlDdl } from './chunk-M4R77BJD.js';
+export { renderSqliteDdl } from './chunk-HY47TQMY.js';
 export { coreSchema, toSnakeCase } from './chunk-AEYYTE5I.js';
 //# sourceMappingURL=schema.js.map
 //# sourceMappingURL=schema.js.map

package/dist/signals-kPmOlKDX.d.cts

@@ -0,0 +1,27 @@
+/**
+ * The wake-up seam. A publish carries no payload: it says "something changed
+ * on this channel, go look", so losing one costs latency, never data.
+ * RFC 0006 §4C.
+ */
+type Signals = {
+    /** True when a publish in one process reaches subscribers in another. */
+    readonly crossProcess: boolean;
+    publish(channel: string): void;
+    subscribe(channel: string, handler: () => void): () => void;
+    close?(): Promise<void> | void;
+};
+declare const DELIVERIES_CHANNEL = "deliveries";
+declare const inboxChannel: (userId: string) => string;
+/** In-process only. The default, and exactly right on SQLite or a single replica. */
+declare function createMemorySignals(): Signals;
+/**
+ * Wraps a cross-process transport (LISTEN/NOTIFY, a change stream) so local
+ * subscribers still hear local publishes even if the transport drops them,
+ * and a transport failure degrades to in-process rather than to silence.
+ */
+declare function createBridgedSignals(transport: {
+    publish(channel: string): Promise<void> | void;
+    subscribe(channel: string, handler: () => void): Promise<() => void> | (() => void);
+}, onError: (error: unknown) => void): Signals;
+
+export { DELIVERIES_CHANNEL as D, type Signals as S, createMemorySignals as a, createBridgedSignals as c, inboxChannel as i };