@agent-native/core 0.21.0 → 0.22.1

package/dist/client/use-db-sync.d.ts

@@ -12,11 +12,11 @@ interface QueryClient {
  * SSE is the fast path; polling is the safety net.
  *
  * @param options.queryClient - The react-query QueryClient instance
- * @param options.queryKeys - **Deprecated and ignored.** The hook now
- *   invalidates every active query on any non-own change event, so templates
- *   no longer need to enumerate their keys. Kept in the type signature for
- *   backward compatibility — existing call sites that still pass this option
- *   keep working but the value has no effect.
+ * @param options.queryKeys - **Deprecated and ignored.** The hook uses
+ *   framework-owned fixed prefixes plus per-source change counters instead of
+ *   caller-supplied key lists. Kept in the type signature for backward
+ *   compatibility — existing call sites that still pass this option keep
+ *   working but the value has no effect.
  * @param options.pollUrl - Poll endpoint URL. Default: "/_agent-native/poll"
  * @param options.sseUrl - SSE endpoint URL. Default: "/_agent-native/events".
  *   Pass false to disable SSE and use polling only.

package/dist/client/use-db-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-db-sync.d.ts","sourceRoot":"","sources":["../../src/client/use-db-sync.ts"],"names":[],"mappings":"AAKA,UAAU,WAAW;IACnB,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CACzD;AAyFD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CACvB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,IAAI,CA4NN;AAED,wCAAwC;AACxC,eAAO,MAAM,cAAc,kBAAY,CAAC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,MAAM,CAsJR"}
+{"version":3,"file":"use-db-sync.d.ts","sourceRoot":"","sources":["../../src/client/use-db-sync.ts"],"names":[],"mappings":"AAKA,UAAU,WAAW;IACnB,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CACzD;AAyFD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CACvB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,IAAI,CAuON;AAED,wCAAwC;AACxC,eAAO,MAAM,cAAc,kBAAY,CAAC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,MAAM,CAsJR"}

package/dist/client/use-db-sync.js

@@ -63,11 +63,11 @@ async function fetchPollJson(pollUrl, since, interval) {
  * SSE is the fast path; polling is the safety net.
  *
  * @param options.queryClient - The react-query QueryClient instance
- * @param options.queryKeys - **Deprecated and ignored.** The hook now
- *   invalidates every active query on any non-own change event, so templates
- *   no longer need to enumerate their keys. Kept in the type signature for
- *   backward compatibility — existing call sites that still pass this option
- *   keep working but the value has no effect.
+ * @param options.queryKeys - **Deprecated and ignored.** The hook uses
+ *   framework-owned fixed prefixes plus per-source change counters instead of
+ *   caller-supplied key lists. Kept in the type signature for backward
+ *   compatibility — existing call sites that still pass this option keep
+ *   working but the value has no effect.
  * @param options.pollUrl - Poll endpoint URL. Default: "/_agent-native/poll"
  * @param options.sseUrl - SSE endpoint URL. Default: "/_agent-native/events".
  *   Pass false to disable SSE and use polling only.
@@ -126,6 +126,16 @@ export function useDbSync(options = {}) {
                     bumpChangeVersion(src, ver);
             }
             if (relevant.length > 0 && queryClient) {
+                const hasActionEvent = relevant.some((evt) => evt.source === "action");
+                if (hasActionEvent) {
+                    // Custom apps frequently start with raw `useQuery` calls before
+                    // graduating to `useActionQuery` or source-versioned query keys.
+                    // A successful mutating action is the core "agent changed app data"
+                    // signal, so refresh active queries broadly as a compatibility
+                    // safety net. Other event sources stay targeted to avoid request
+                    // storms from noisy domain-specific writes.
+                    queryClient.invalidateQueries();
+                }
                 // Framework-level invalidate: a small, fixed list of query-key
                 // prefixes the framework's own hooks/components use (action results,
                 // extension state, application-state, the agent's `set-url` channel,

package/dist/client/use-db-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-db-sync.js","sourceRoot":"","sources":["../../src/client/use-db-sync.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { agentNativePath } from \"./api-path.js\";\nimport { bumpChangeVersion } from \"./use-change-version.js\";\nimport { ensureDemoModeFetchInterceptor } from \"../demo/fetch-interceptor.js\";\n\ninterface QueryClient {\n  invalidateQueries(opts?: { queryKey?: string[] }): void;\n}\n\nconst POLL_ABORT_MIN_MS = 10_000;\nconst SSE_FALLBACK_INTERVAL_MS = 15_000;\n\ntype SyncEvent = {\n  version?: number;\n  source?: string;\n  type?: string;\n  key?: string;\n  requestSource?: string;\n  [k: string]: unknown;\n};\n\ntype PollResponse = {\n  version: number;\n  events: SyncEvent[];\n};\n\nfunction getPollAbortMs(interval: number): number {\n  return Math.max(POLL_ABORT_MIN_MS, interval * 4);\n}\n\nfunction isDocumentHidden(): boolean {\n  return (\n    typeof document !== \"undefined\" && document.visibilityState === \"hidden\"\n  );\n}\n\nfunction resolveSseUrl(sseUrl: string | false | undefined): string | false {\n  if (sseUrl === false) return false;\n  return agentNativePath(sseUrl ?? \"/_agent-native/events\");\n}\n\nfunction normalizeEventPayload(payload: unknown): SyncEvent[] {\n  if (!payload || typeof payload !== \"object\") return [];\n  const record = payload as { type?: unknown; events?: unknown };\n  if (record.type === \"batch\" && Array.isArray(record.events)) {\n    return record.events.filter(\n      (event): event is SyncEvent => !!event && typeof event === \"object\",\n    );\n  }\n  if (Array.isArray(record.events)) {\n    return record.events.filter(\n      (event): event is SyncEvent => !!event && typeof event === \"object\",\n    );\n  }\n  return [payload as SyncEvent];\n}\n\nfunction eventVersion(event: SyncEvent): number {\n  return typeof event.version === \"number\" ? event.version : 0;\n}\n\nfunction hasAppStateEvent(events: SyncEvent[], key: string): boolean {\n  return events.some(\n    (event) =>\n      event.source === \"app-state\" &&\n      (event.key === key ||\n        event.key === \"*\" ||\n        (typeof event.key === \"string\" && event.key.startsWith(`${key}:`))),\n  );\n}\n\nasync function fetchPollJson<T>(\n  pollUrl: string,\n  since: number,\n  interval: number,\n): Promise<T> {\n  const controller =\n    typeof AbortController === \"undefined\" ? null : new AbortController();\n  const timeout = controller\n    ? setTimeout(() => controller.abort(), getPollAbortMs(interval))\n    : null;\n\n  try {\n    const res = await fetch(\n      `${pollUrl}?since=${since}`,\n      controller ? { signal: controller.signal } : undefined,\n    );\n    if (!res.ok) throw new Error(\"HTTP \" + res.status);\n    // Await the json before the finally so a body-stream abort doesn't\n    // produce a dangling promise that escapes as an unhandled rejection.\n    return await res.json();\n  } finally {\n    if (timeout) clearTimeout(timeout);\n  }\n}\n\n/**\n * Hook that listens to /_agent-native/events for DB change events and\n * invalidates react-query caches when changes are detected. Falls back to\n * /_agent-native/poll so cross-process/serverless writes still show up.\n *\n * Works in all deployment environments (serverless, edge, long-lived server).\n * SSE is the fast path; polling is the safety net.\n *\n * @param options.queryClient - The react-query QueryClient instance\n * @param options.queryKeys - **Deprecated and ignored.** The hook now\n *   invalidates every active query on any non-own change event, so templates\n *   no longer need to enumerate their keys. Kept in the type signature for\n *   backward compatibility — existing call sites that still pass this option\n *   keep working but the value has no effect.\n * @param options.pollUrl - Poll endpoint URL. Default: \"/_agent-native/poll\"\n * @param options.sseUrl - SSE endpoint URL. Default: \"/_agent-native/events\".\n *   Pass false to disable SSE and use polling only.\n * @param options.onEvent - Optional callback for each change event\n * @param options.interval - Poll interval in ms. Default: 2000\n * @param options.fallbackInterval - Poll interval while SSE is connected.\n *   Default: 15000\n * @param options.pauseWhenHidden - Pause polling while the tab is hidden.\n *   Default: true\n * @param options.ignoreSource - Skip events whose `requestSource` matches this\n *   value. Use a per-tab ID so the UI ignores its own writes while still\n *   picking up changes from other tabs, agents, and scripts.\n */\nexport function useDbSync(\n  options: {\n    queryClient?: QueryClient;\n    queryKeys?: string[];\n    pollUrl?: string;\n    sseUrl?: string | false;\n    /** @deprecated Use pollUrl instead */\n    eventsUrl?: string;\n    onEvent?: (data: any) => void;\n    interval?: number;\n    fallbackInterval?: number;\n    pauseWhenHidden?: boolean;\n    ignoreSource?: string;\n  } = {},\n): void {\n  const {\n    queryClient,\n    pollUrl = agentNativePath(options.eventsUrl ?? \"/_agent-native/poll\"),\n    sseUrl = resolveSseUrl(options.sseUrl),\n    interval = 2000,\n    fallbackInterval = Math.max(\n      options.fallbackInterval ?? SSE_FALLBACK_INTERVAL_MS,\n      interval,\n    ),\n    pauseWhenHidden = true,\n  } = options;\n\n  const onEventRef = useRef(options.onEvent);\n  onEventRef.current = options.onEvent;\n\n  const ignoreSourceRef = useRef(options.ignoreSource);\n  ignoreSourceRef.current = options.ignoreSource;\n\n  useEffect(() => {\n    // Universal demo-mode redaction for the UI. Idempotent + browser-only +\n    // a no-op until demo mode is on. Lives here because every template root\n    // already mounts useDbSync, so this needs zero per-template wiring.\n    ensureDemoModeFetchInterceptor();\n\n    let versionRef = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let stopped = false;\n    let inFlight = false;\n    let eventSource: EventSource | null = null;\n    let sseConnected = false;\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(\n        () => {\n          timer = null;\n          void poll();\n        },\n        sseConnected ? fallbackInterval : interval,\n      );\n    }\n\n    function invalidateForEvents(events: SyncEvent[]) {\n      const ignore = ignoreSourceRef.current;\n      const relevant = ignore\n        ? events.filter((e) => e.requestSource !== ignore)\n        : events;\n\n      // Bump per-source change counters. Components that read these via\n      // `useChangeVersion(source)` and fold the value into a React Query\n      // queryKey get a targeted refetch — no whole-cache invalidate, no\n      // request storm. See `use-change-version.ts` for the contract.\n      for (const evt of relevant) {\n        const src = typeof evt.source === \"string\" ? evt.source : \"\";\n        const ver = typeof evt.version === \"number\" ? evt.version : 0;\n        if (src && ver > 0) bumpChangeVersion(src, ver);\n      }\n\n      if (relevant.length > 0 && queryClient) {\n        // Framework-level invalidate: a small, fixed list of query-key\n        // prefixes the framework's own hooks/components use (action results,\n        // extension state, application-state, the agent's `set-url` channel,\n        // etc.). Templates' own data queries do NOT live here — they react\n        // through `useChangeVersion(source)` in their query keys instead, so\n        // a single change event doesn't fan out into \"refetch everything\".\n        queryClient.invalidateQueries({ queryKey: [\"action\"] });\n        queryClient.invalidateQueries({ queryKey: [\"extension\"] });\n        queryClient.invalidateQueries({ queryKey: [\"extensions\"] });\n        queryClient.invalidateQueries({ queryKey: [\"extension-slots\"] });\n        queryClient.invalidateQueries({ queryKey: [\"slot-installs\"] });\n        queryClient.invalidateQueries({ queryKey: [\"slot-available\"] });\n        queryClient.invalidateQueries({ queryKey: [\"tool\"] });\n        queryClient.invalidateQueries({ queryKey: [\"tools\"] });\n        queryClient.invalidateQueries({ queryKey: [\"app-state\"] });\n        if (hasAppStateEvent(relevant, \"navigate\")) {\n          queryClient.invalidateQueries({ queryKey: [\"navigate-command\"] });\n        }\n        if (hasAppStateEvent(relevant, \"show-questions\")) {\n          queryClient.invalidateQueries({ queryKey: [\"show-questions\"] });\n        }\n        if (hasAppStateEvent(relevant, \"__set_url__\")) {\n          queryClient.invalidateQueries({ queryKey: [\"__set_url__\"] });\n        }\n      }\n\n      // Always forward all events to onEvent — templates can layer surgical\n      // logic on top (e.g. ignore their own writes via requestSource, or\n      // invalidate inactive queries for a specific source).\n      for (const evt of events) {\n        onEventRef.current?.(evt);\n      }\n    }\n\n    function applyEvents(events: SyncEvent[], version?: number) {\n      const freshEvents = events.filter((event) => {\n        const version = eventVersion(event);\n        return version === 0 || version > versionRef;\n      });\n\n      if (freshEvents.length > 0) {\n        invalidateForEvents(freshEvents);\n      }\n\n      const maxEventVersion = freshEvents.reduce(\n        (max, event) => Math.max(max, eventVersion(event)),\n        0,\n      );\n      versionRef = Math.max(versionRef, version ?? 0, maxEventVersion);\n    }\n\n    function closeEvents() {\n      if (!eventSource) return;\n      eventSource.close();\n      eventSource = null;\n      sseConnected = false;\n    }\n\n    function connectEvents() {\n      if (\n        stopped ||\n        !sseUrl ||\n        eventSource ||\n        typeof EventSource === \"undefined\" ||\n        (pauseWhenHidden && isDocumentHidden())\n      ) {\n        return;\n      }\n\n      const source = new EventSource(sseUrl);\n      eventSource = source;\n      source.onopen = () => {\n        sseConnected = true;\n        schedulePoll();\n      };\n      source.onerror = () => {\n        sseConnected = false;\n        schedulePoll();\n      };\n      source.onmessage = (message) => {\n        try {\n          const payload = JSON.parse(message.data);\n          const events = normalizeEventPayload(payload);\n          const version =\n            typeof payload?.version === \"number\" ? payload.version : undefined;\n          applyEvents(events, version);\n        } catch {\n          // Ignore malformed SSE frames; polling is the safety net.\n        }\n      };\n    }\n\n    async function poll() {\n      if (stopped || inFlight) return;\n      inFlight = true;\n      try {\n        const data = await fetchPollJson<PollResponse>(\n          pollUrl,\n          versionRef,\n          interval,\n        );\n        applyEvents(data.events ?? [], data.version);\n      } catch {\n        // Network error — will retry on next interval\n      } finally {\n        inFlight = false;\n        schedulePoll();\n      }\n    }\n\n    function pollNow() {\n      if (pauseWhenHidden && isDocumentHidden()) {\n        return;\n      }\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      connectEvents();\n      void poll();\n    }\n\n    function handleVisibilityChange() {\n      if (document.visibilityState === \"visible\") {\n        connectEvents();\n        pollNow();\n      } else if (pauseWhenHidden) {\n        closeEvents();\n        if (timer) {\n          clearTimeout(timer);\n          timer = null;\n        }\n      }\n    }\n\n    // Initial poll immediately when visible. Hidden tabs catch up on focus.\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      connectEvents();\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      closeEvents();\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [\n    pollUrl,\n    sseUrl,\n    queryClient,\n    interval,\n    fallbackInterval,\n    pauseWhenHidden,\n  ]);\n}\n\n/** @deprecated Use useDbSync instead */\nexport const useFileWatcher = useDbSync;\n\n/**\n * Subscribe to `refresh-screen` events from the agent. Returns an integer\n * that increments every time the agent invokes the framework's `refresh-screen`\n * tool. Apply it as a React `key` on the main content wrapper (the part\n * OUTSIDE the agent chat sidebar) so that region remounts and re-fetches its\n * data while the chat, sidebar, and any other persistent chrome keep their\n * in-flight state.\n *\n * Usage in a template's root:\n *\n *   const screenKey = useScreenRefreshKey();\n *   return (\n *     <AppLayout>\n *       <div key={screenKey}>\n *         <Outlet />\n *       </div>\n *     </AppLayout>\n *   );\n */\nexport function useScreenRefreshKey(\n  options: {\n    pollUrl?: string;\n    sseUrl?: string | false;\n    interval?: number;\n    fallbackInterval?: number;\n    pauseWhenHidden?: boolean;\n  } = {},\n): number {\n  const {\n    pollUrl = agentNativePath(options.pollUrl ?? \"/_agent-native/poll\"),\n    sseUrl = resolveSseUrl(options.sseUrl),\n    interval = 2000,\n    fallbackInterval = Math.max(\n      options.fallbackInterval ?? SSE_FALLBACK_INTERVAL_MS,\n      interval,\n    ),\n    pauseWhenHidden = true,\n  } = options;\n  const [key, setKey] = useState(0);\n\n  useEffect(() => {\n    let versionRef = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let stopped = false;\n    let inFlight = false;\n    let eventSource: EventSource | null = null;\n    let sseConnected = false;\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(\n        () => {\n          timer = null;\n          void poll();\n        },\n        sseConnected ? fallbackInterval : interval,\n      );\n    }\n\n    function applyEvents(events: SyncEvent[], version?: number) {\n      const freshEvents = events.filter((event) => {\n        const version = eventVersion(event);\n        return version === 0 || version > versionRef;\n      });\n      if (freshEvents.some((e) => e.source === \"screen-refresh\")) {\n        setKey((k) => k + 1);\n      }\n      const maxEventVersion = freshEvents.reduce(\n        (max, event) => Math.max(max, eventVersion(event)),\n        0,\n      );\n      versionRef = Math.max(versionRef, version ?? 0, maxEventVersion);\n    }\n\n    function closeEvents() {\n      if (!eventSource) return;\n      eventSource.close();\n      eventSource = null;\n      sseConnected = false;\n    }\n\n    function connectEvents() {\n      if (\n        stopped ||\n        !sseUrl ||\n        eventSource ||\n        typeof EventSource === \"undefined\" ||\n        (pauseWhenHidden && isDocumentHidden())\n      ) {\n        return;\n      }\n\n      const source = new EventSource(sseUrl);\n      eventSource = source;\n      source.onopen = () => {\n        sseConnected = true;\n        schedulePoll();\n      };\n      source.onerror = () => {\n        sseConnected = false;\n        schedulePoll();\n      };\n      source.onmessage = (message) => {\n        try {\n          const payload = JSON.parse(message.data);\n          const events = normalizeEventPayload(payload);\n          const version =\n            typeof payload?.version === \"number\" ? payload.version : undefined;\n          applyEvents(events, version);\n        } catch {\n          // Polling will catch missed screen-refresh events.\n        }\n      };\n    }\n\n    async function poll() {\n      if (stopped || inFlight) return;\n      inFlight = true;\n      try {\n        const data = await fetchPollJson<PollResponse>(\n          pollUrl,\n          versionRef,\n          interval,\n        );\n        applyEvents(data.events ?? [], data.version);\n      } catch {\n        // Network error — retry on next interval.\n      } finally {\n        inFlight = false;\n        schedulePoll();\n      }\n    }\n\n    function pollNow() {\n      if (pauseWhenHidden && isDocumentHidden()) {\n        return;\n      }\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      connectEvents();\n      void poll();\n    }\n\n    function handleVisibilityChange() {\n      if (document.visibilityState === \"visible\") {\n        connectEvents();\n        pollNow();\n      } else if (pauseWhenHidden) {\n        closeEvents();\n        if (timer) {\n          clearTimeout(timer);\n          timer = null;\n        }\n      }\n    }\n\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      connectEvents();\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      closeEvents();\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [pollUrl, sseUrl, interval, fallbackInterval, pauseWhenHidden]);\n\n  return key;\n}\n"]}
+{"version":3,"file":"use-db-sync.js","sourceRoot":"","sources":["../../src/client/use-db-sync.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { agentNativePath } from \"./api-path.js\";\nimport { bumpChangeVersion } from \"./use-change-version.js\";\nimport { ensureDemoModeFetchInterceptor } from \"../demo/fetch-interceptor.js\";\n\ninterface QueryClient {\n  invalidateQueries(opts?: { queryKey?: string[] }): void;\n}\n\nconst POLL_ABORT_MIN_MS = 10_000;\nconst SSE_FALLBACK_INTERVAL_MS = 15_000;\n\ntype SyncEvent = {\n  version?: number;\n  source?: string;\n  type?: string;\n  key?: string;\n  requestSource?: string;\n  [k: string]: unknown;\n};\n\ntype PollResponse = {\n  version: number;\n  events: SyncEvent[];\n};\n\nfunction getPollAbortMs(interval: number): number {\n  return Math.max(POLL_ABORT_MIN_MS, interval * 4);\n}\n\nfunction isDocumentHidden(): boolean {\n  return (\n    typeof document !== \"undefined\" && document.visibilityState === \"hidden\"\n  );\n}\n\nfunction resolveSseUrl(sseUrl: string | false | undefined): string | false {\n  if (sseUrl === false) return false;\n  return agentNativePath(sseUrl ?? \"/_agent-native/events\");\n}\n\nfunction normalizeEventPayload(payload: unknown): SyncEvent[] {\n  if (!payload || typeof payload !== \"object\") return [];\n  const record = payload as { type?: unknown; events?: unknown };\n  if (record.type === \"batch\" && Array.isArray(record.events)) {\n    return record.events.filter(\n      (event): event is SyncEvent => !!event && typeof event === \"object\",\n    );\n  }\n  if (Array.isArray(record.events)) {\n    return record.events.filter(\n      (event): event is SyncEvent => !!event && typeof event === \"object\",\n    );\n  }\n  return [payload as SyncEvent];\n}\n\nfunction eventVersion(event: SyncEvent): number {\n  return typeof event.version === \"number\" ? event.version : 0;\n}\n\nfunction hasAppStateEvent(events: SyncEvent[], key: string): boolean {\n  return events.some(\n    (event) =>\n      event.source === \"app-state\" &&\n      (event.key === key ||\n        event.key === \"*\" ||\n        (typeof event.key === \"string\" && event.key.startsWith(`${key}:`))),\n  );\n}\n\nasync function fetchPollJson<T>(\n  pollUrl: string,\n  since: number,\n  interval: number,\n): Promise<T> {\n  const controller =\n    typeof AbortController === \"undefined\" ? null : new AbortController();\n  const timeout = controller\n    ? setTimeout(() => controller.abort(), getPollAbortMs(interval))\n    : null;\n\n  try {\n    const res = await fetch(\n      `${pollUrl}?since=${since}`,\n      controller ? { signal: controller.signal } : undefined,\n    );\n    if (!res.ok) throw new Error(\"HTTP \" + res.status);\n    // Await the json before the finally so a body-stream abort doesn't\n    // produce a dangling promise that escapes as an unhandled rejection.\n    return await res.json();\n  } finally {\n    if (timeout) clearTimeout(timeout);\n  }\n}\n\n/**\n * Hook that listens to /_agent-native/events for DB change events and\n * invalidates react-query caches when changes are detected. Falls back to\n * /_agent-native/poll so cross-process/serverless writes still show up.\n *\n * Works in all deployment environments (serverless, edge, long-lived server).\n * SSE is the fast path; polling is the safety net.\n *\n * @param options.queryClient - The react-query QueryClient instance\n * @param options.queryKeys - **Deprecated and ignored.** The hook uses\n *   framework-owned fixed prefixes plus per-source change counters instead of\n *   caller-supplied key lists. Kept in the type signature for backward\n *   compatibility — existing call sites that still pass this option keep\n *   working but the value has no effect.\n * @param options.pollUrl - Poll endpoint URL. Default: \"/_agent-native/poll\"\n * @param options.sseUrl - SSE endpoint URL. Default: \"/_agent-native/events\".\n *   Pass false to disable SSE and use polling only.\n * @param options.onEvent - Optional callback for each change event\n * @param options.interval - Poll interval in ms. Default: 2000\n * @param options.fallbackInterval - Poll interval while SSE is connected.\n *   Default: 15000\n * @param options.pauseWhenHidden - Pause polling while the tab is hidden.\n *   Default: true\n * @param options.ignoreSource - Skip events whose `requestSource` matches this\n *   value. Use a per-tab ID so the UI ignores its own writes while still\n *   picking up changes from other tabs, agents, and scripts.\n */\nexport function useDbSync(\n  options: {\n    queryClient?: QueryClient;\n    queryKeys?: string[];\n    pollUrl?: string;\n    sseUrl?: string | false;\n    /** @deprecated Use pollUrl instead */\n    eventsUrl?: string;\n    onEvent?: (data: any) => void;\n    interval?: number;\n    fallbackInterval?: number;\n    pauseWhenHidden?: boolean;\n    ignoreSource?: string;\n  } = {},\n): void {\n  const {\n    queryClient,\n    pollUrl = agentNativePath(options.eventsUrl ?? \"/_agent-native/poll\"),\n    sseUrl = resolveSseUrl(options.sseUrl),\n    interval = 2000,\n    fallbackInterval = Math.max(\n      options.fallbackInterval ?? SSE_FALLBACK_INTERVAL_MS,\n      interval,\n    ),\n    pauseWhenHidden = true,\n  } = options;\n\n  const onEventRef = useRef(options.onEvent);\n  onEventRef.current = options.onEvent;\n\n  const ignoreSourceRef = useRef(options.ignoreSource);\n  ignoreSourceRef.current = options.ignoreSource;\n\n  useEffect(() => {\n    // Universal demo-mode redaction for the UI. Idempotent + browser-only +\n    // a no-op until demo mode is on. Lives here because every template root\n    // already mounts useDbSync, so this needs zero per-template wiring.\n    ensureDemoModeFetchInterceptor();\n\n    let versionRef = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let stopped = false;\n    let inFlight = false;\n    let eventSource: EventSource | null = null;\n    let sseConnected = false;\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(\n        () => {\n          timer = null;\n          void poll();\n        },\n        sseConnected ? fallbackInterval : interval,\n      );\n    }\n\n    function invalidateForEvents(events: SyncEvent[]) {\n      const ignore = ignoreSourceRef.current;\n      const relevant = ignore\n        ? events.filter((e) => e.requestSource !== ignore)\n        : events;\n\n      // Bump per-source change counters. Components that read these via\n      // `useChangeVersion(source)` and fold the value into a React Query\n      // queryKey get a targeted refetch — no whole-cache invalidate, no\n      // request storm. See `use-change-version.ts` for the contract.\n      for (const evt of relevant) {\n        const src = typeof evt.source === \"string\" ? evt.source : \"\";\n        const ver = typeof evt.version === \"number\" ? evt.version : 0;\n        if (src && ver > 0) bumpChangeVersion(src, ver);\n      }\n\n      if (relevant.length > 0 && queryClient) {\n        const hasActionEvent = relevant.some((evt) => evt.source === \"action\");\n        if (hasActionEvent) {\n          // Custom apps frequently start with raw `useQuery` calls before\n          // graduating to `useActionQuery` or source-versioned query keys.\n          // A successful mutating action is the core \"agent changed app data\"\n          // signal, so refresh active queries broadly as a compatibility\n          // safety net. Other event sources stay targeted to avoid request\n          // storms from noisy domain-specific writes.\n          queryClient.invalidateQueries();\n        }\n\n        // Framework-level invalidate: a small, fixed list of query-key\n        // prefixes the framework's own hooks/components use (action results,\n        // extension state, application-state, the agent's `set-url` channel,\n        // etc.). Templates' own data queries do NOT live here — they react\n        // through `useChangeVersion(source)` in their query keys instead, so\n        // a single change event doesn't fan out into \"refetch everything\".\n        queryClient.invalidateQueries({ queryKey: [\"action\"] });\n        queryClient.invalidateQueries({ queryKey: [\"extension\"] });\n        queryClient.invalidateQueries({ queryKey: [\"extensions\"] });\n        queryClient.invalidateQueries({ queryKey: [\"extension-slots\"] });\n        queryClient.invalidateQueries({ queryKey: [\"slot-installs\"] });\n        queryClient.invalidateQueries({ queryKey: [\"slot-available\"] });\n        queryClient.invalidateQueries({ queryKey: [\"tool\"] });\n        queryClient.invalidateQueries({ queryKey: [\"tools\"] });\n        queryClient.invalidateQueries({ queryKey: [\"app-state\"] });\n        if (hasAppStateEvent(relevant, \"navigate\")) {\n          queryClient.invalidateQueries({ queryKey: [\"navigate-command\"] });\n        }\n        if (hasAppStateEvent(relevant, \"show-questions\")) {\n          queryClient.invalidateQueries({ queryKey: [\"show-questions\"] });\n        }\n        if (hasAppStateEvent(relevant, \"__set_url__\")) {\n          queryClient.invalidateQueries({ queryKey: [\"__set_url__\"] });\n        }\n      }\n\n      // Always forward all events to onEvent — templates can layer surgical\n      // logic on top (e.g. ignore their own writes via requestSource, or\n      // invalidate inactive queries for a specific source).\n      for (const evt of events) {\n        onEventRef.current?.(evt);\n      }\n    }\n\n    function applyEvents(events: SyncEvent[], version?: number) {\n      const freshEvents = events.filter((event) => {\n        const version = eventVersion(event);\n        return version === 0 || version > versionRef;\n      });\n\n      if (freshEvents.length > 0) {\n        invalidateForEvents(freshEvents);\n      }\n\n      const maxEventVersion = freshEvents.reduce(\n        (max, event) => Math.max(max, eventVersion(event)),\n        0,\n      );\n      versionRef = Math.max(versionRef, version ?? 0, maxEventVersion);\n    }\n\n    function closeEvents() {\n      if (!eventSource) return;\n      eventSource.close();\n      eventSource = null;\n      sseConnected = false;\n    }\n\n    function connectEvents() {\n      if (\n        stopped ||\n        !sseUrl ||\n        eventSource ||\n        typeof EventSource === \"undefined\" ||\n        (pauseWhenHidden && isDocumentHidden())\n      ) {\n        return;\n      }\n\n      const source = new EventSource(sseUrl);\n      eventSource = source;\n      source.onopen = () => {\n        sseConnected = true;\n        schedulePoll();\n      };\n      source.onerror = () => {\n        sseConnected = false;\n        schedulePoll();\n      };\n      source.onmessage = (message) => {\n        try {\n          const payload = JSON.parse(message.data);\n          const events = normalizeEventPayload(payload);\n          const version =\n            typeof payload?.version === \"number\" ? payload.version : undefined;\n          applyEvents(events, version);\n        } catch {\n          // Ignore malformed SSE frames; polling is the safety net.\n        }\n      };\n    }\n\n    async function poll() {\n      if (stopped || inFlight) return;\n      inFlight = true;\n      try {\n        const data = await fetchPollJson<PollResponse>(\n          pollUrl,\n          versionRef,\n          interval,\n        );\n        applyEvents(data.events ?? [], data.version);\n      } catch {\n        // Network error — will retry on next interval\n      } finally {\n        inFlight = false;\n        schedulePoll();\n      }\n    }\n\n    function pollNow() {\n      if (pauseWhenHidden && isDocumentHidden()) {\n        return;\n      }\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      connectEvents();\n      void poll();\n    }\n\n    function handleVisibilityChange() {\n      if (document.visibilityState === \"visible\") {\n        connectEvents();\n        pollNow();\n      } else if (pauseWhenHidden) {\n        closeEvents();\n        if (timer) {\n          clearTimeout(timer);\n          timer = null;\n        }\n      }\n    }\n\n    // Initial poll immediately when visible. Hidden tabs catch up on focus.\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      connectEvents();\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      closeEvents();\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [\n    pollUrl,\n    sseUrl,\n    queryClient,\n    interval,\n    fallbackInterval,\n    pauseWhenHidden,\n  ]);\n}\n\n/** @deprecated Use useDbSync instead */\nexport const useFileWatcher = useDbSync;\n\n/**\n * Subscribe to `refresh-screen` events from the agent. Returns an integer\n * that increments every time the agent invokes the framework's `refresh-screen`\n * tool. Apply it as a React `key` on the main content wrapper (the part\n * OUTSIDE the agent chat sidebar) so that region remounts and re-fetches its\n * data while the chat, sidebar, and any other persistent chrome keep their\n * in-flight state.\n *\n * Usage in a template's root:\n *\n *   const screenKey = useScreenRefreshKey();\n *   return (\n *     <AppLayout>\n *       <div key={screenKey}>\n *         <Outlet />\n *       </div>\n *     </AppLayout>\n *   );\n */\nexport function useScreenRefreshKey(\n  options: {\n    pollUrl?: string;\n    sseUrl?: string | false;\n    interval?: number;\n    fallbackInterval?: number;\n    pauseWhenHidden?: boolean;\n  } = {},\n): number {\n  const {\n    pollUrl = agentNativePath(options.pollUrl ?? \"/_agent-native/poll\"),\n    sseUrl = resolveSseUrl(options.sseUrl),\n    interval = 2000,\n    fallbackInterval = Math.max(\n      options.fallbackInterval ?? SSE_FALLBACK_INTERVAL_MS,\n      interval,\n    ),\n    pauseWhenHidden = true,\n  } = options;\n  const [key, setKey] = useState(0);\n\n  useEffect(() => {\n    let versionRef = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let stopped = false;\n    let inFlight = false;\n    let eventSource: EventSource | null = null;\n    let sseConnected = false;\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(\n        () => {\n          timer = null;\n          void poll();\n        },\n        sseConnected ? fallbackInterval : interval,\n      );\n    }\n\n    function applyEvents(events: SyncEvent[], version?: number) {\n      const freshEvents = events.filter((event) => {\n        const version = eventVersion(event);\n        return version === 0 || version > versionRef;\n      });\n      if (freshEvents.some((e) => e.source === \"screen-refresh\")) {\n        setKey((k) => k + 1);\n      }\n      const maxEventVersion = freshEvents.reduce(\n        (max, event) => Math.max(max, eventVersion(event)),\n        0,\n      );\n      versionRef = Math.max(versionRef, version ?? 0, maxEventVersion);\n    }\n\n    function closeEvents() {\n      if (!eventSource) return;\n      eventSource.close();\n      eventSource = null;\n      sseConnected = false;\n    }\n\n    function connectEvents() {\n      if (\n        stopped ||\n        !sseUrl ||\n        eventSource ||\n        typeof EventSource === \"undefined\" ||\n        (pauseWhenHidden && isDocumentHidden())\n      ) {\n        return;\n      }\n\n      const source = new EventSource(sseUrl);\n      eventSource = source;\n      source.onopen = () => {\n        sseConnected = true;\n        schedulePoll();\n      };\n      source.onerror = () => {\n        sseConnected = false;\n        schedulePoll();\n      };\n      source.onmessage = (message) => {\n        try {\n          const payload = JSON.parse(message.data);\n          const events = normalizeEventPayload(payload);\n          const version =\n            typeof payload?.version === \"number\" ? payload.version : undefined;\n          applyEvents(events, version);\n        } catch {\n          // Polling will catch missed screen-refresh events.\n        }\n      };\n    }\n\n    async function poll() {\n      if (stopped || inFlight) return;\n      inFlight = true;\n      try {\n        const data = await fetchPollJson<PollResponse>(\n          pollUrl,\n          versionRef,\n          interval,\n        );\n        applyEvents(data.events ?? [], data.version);\n      } catch {\n        // Network error — retry on next interval.\n      } finally {\n        inFlight = false;\n        schedulePoll();\n      }\n    }\n\n    function pollNow() {\n      if (pauseWhenHidden && isDocumentHidden()) {\n        return;\n      }\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      connectEvents();\n      void poll();\n    }\n\n    function handleVisibilityChange() {\n      if (document.visibilityState === \"visible\") {\n        connectEvents();\n        pollNow();\n      } else if (pauseWhenHidden) {\n        closeEvents();\n        if (timer) {\n          clearTimeout(timer);\n          timer = null;\n        }\n      }\n    }\n\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      connectEvents();\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      closeEvents();\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [pollUrl, sseUrl, interval, fallbackInterval, pauseWhenHidden]);\n\n  return key;\n}\n"]}

package/dist/client/use-db-sync.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-db-sync.spec.d.ts.map

package/dist/client/use-db-sync.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-db-sync.spec.d.ts","sourceRoot":"","sources":["../../src/client/use-db-sync.spec.tsx"],"names":[],"mappings":""}

package/dist/client/use-db-sync.spec.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useDbSync } from "./use-db-sync.js";
+class QueryClientProbe {
+    calls = [];
+    invalidateQueries(opts) {
+        this.calls.push(opts);
+    }
+}
+function SyncProbe({ queryClient }) {
+    useDbSync({
+        queryClient,
+        sseUrl: false,
+        interval: 50,
+        pauseWhenHidden: false,
+    });
+    return null;
+}
+async function renderWithEvent(event) {
+    const queryClient = new QueryClientProbe();
+    const fetchMock = vi.fn(async () => new Response(JSON.stringify({ version: event.version ?? 1, events: [event] })));
+    vi.stubGlobal("fetch", fetchMock);
+    const container = document.createElement("div");
+    document.body.appendChild(container);
+    const root = createRoot(container);
+    await act(async () => {
+        root.render(_jsx(SyncProbe, { queryClient: queryClient }));
+        await Promise.resolve();
+        await Promise.resolve();
+    });
+    return { container, fetchMock, queryClient, root };
+}
+describe("useDbSync", () => {
+    let roots = [];
+    let containers = [];
+    beforeEach(() => {
+        vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", true);
+    });
+    afterEach(() => {
+        for (const root of roots) {
+            act(() => root.unmount());
+        }
+        for (const container of containers) {
+            container.remove();
+        }
+        roots = [];
+        containers = [];
+        vi.unstubAllGlobals();
+    });
+    it("broadly invalidates active queries for action events", async () => {
+        const result = await renderWithEvent({
+            version: 1,
+            source: "action",
+            type: "change",
+            key: "create-project",
+        });
+        roots.push(result.root);
+        containers.push(result.container);
+        expect(result.fetchMock).toHaveBeenCalled();
+        expect(result.queryClient.calls).toContainEqual(undefined);
+        expect(result.queryClient.calls).toContainEqual({ queryKey: ["action"] });
+    });
+    it("keeps non-action events on targeted framework invalidations", async () => {
+        const result = await renderWithEvent({
+            version: 1,
+            source: "settings",
+            type: "change",
+            key: "*",
+        });
+        roots.push(result.root);
+        containers.push(result.container);
+        expect(result.fetchMock).toHaveBeenCalled();
+        expect(result.queryClient.calls).not.toContainEqual(undefined);
+        expect(result.queryClient.calls).toContainEqual({ queryKey: ["action"] });
+    });
+});
+//# sourceMappingURL=use-db-sync.spec.js.map

package/dist/client/use-db-sync.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-db-sync.spec.js","sourceRoot":"","sources":["../../src/client/use-db-sync.spec.tsx"],"names":[],"mappings":";AAAA,gCAAgC;AAEhC,OAAc,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,gBAAgB;IACpB,KAAK,GAA+C,EAAE,CAAC;IAEvD,iBAAiB,CAAC,IAA8B;QAC9C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;CACF;AAED,SAAS,SAAS,CAAC,EAAE,WAAW,EAAqC;IACnE,SAAS,CAAC;QACR,WAAW;QACX,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,KAAK;KACvB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,KAA8B;IAC3D,MAAM,WAAW,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,CACrB,KAAK,IAAI,EAAE,CACT,IAAI,QAAQ,CACV,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CACjE,CACJ,CAAC;IACF,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAElC,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAEnC,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,CAAC,MAAM,CAAC,KAAC,SAAS,IAAC,WAAW,EAAE,WAAW,GAAI,CAAC,CAAC;QACrD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,IAAI,KAAK,GAAW,EAAE,CAAC;IACvB,IAAI,UAAU,GAAqB,EAAE,CAAC;IAEtC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,UAAU,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,CAAC;QACD,KAAK,GAAG,EAAE,CAAC;QACX,UAAU,GAAG,EAAE,CAAC;QAChB,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;YACnC,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,QAAQ;YACd,GAAG,EAAE,gBAAgB;SACtB,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAElC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;YACnC,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,QAAQ;YACd,GAAG,EAAE,GAAG;SACT,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAElC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["// @vitest-environment happy-dom\n\nimport React, { act } from \"react\";\nimport { createRoot, type Root } from \"react-dom/client\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { useDbSync } from \"./use-db-sync.js\";\n\nclass QueryClientProbe {\n  calls: Array<{ queryKey?: string[] } | undefined> = [];\n\n  invalidateQueries(opts?: { queryKey?: string[] }) {\n    this.calls.push(opts);\n  }\n}\n\nfunction SyncProbe({ queryClient }: { queryClient: QueryClientProbe }) {\n  useDbSync({\n    queryClient,\n    sseUrl: false,\n    interval: 50,\n    pauseWhenHidden: false,\n  });\n  return null;\n}\n\nasync function renderWithEvent(event: Record<string, unknown>) {\n  const queryClient = new QueryClientProbe();\n  const fetchMock = vi.fn(\n    async () =>\n      new Response(\n        JSON.stringify({ version: event.version ?? 1, events: [event] }),\n      ),\n  );\n  vi.stubGlobal(\"fetch\", fetchMock);\n\n  const container = document.createElement(\"div\");\n  document.body.appendChild(container);\n  const root = createRoot(container);\n\n  await act(async () => {\n    root.render(<SyncProbe queryClient={queryClient} />);\n    await Promise.resolve();\n    await Promise.resolve();\n  });\n\n  return { container, fetchMock, queryClient, root };\n}\n\ndescribe(\"useDbSync\", () => {\n  let roots: Root[] = [];\n  let containers: HTMLDivElement[] = [];\n\n  beforeEach(() => {\n    vi.stubGlobal(\"IS_REACT_ACT_ENVIRONMENT\", true);\n  });\n\n  afterEach(() => {\n    for (const root of roots) {\n      act(() => root.unmount());\n    }\n    for (const container of containers) {\n      container.remove();\n    }\n    roots = [];\n    containers = [];\n    vi.unstubAllGlobals();\n  });\n\n  it(\"broadly invalidates active queries for action events\", async () => {\n    const result = await renderWithEvent({\n      version: 1,\n      source: \"action\",\n      type: \"change\",\n      key: \"create-project\",\n    });\n    roots.push(result.root);\n    containers.push(result.container);\n\n    expect(result.fetchMock).toHaveBeenCalled();\n    expect(result.queryClient.calls).toContainEqual(undefined);\n    expect(result.queryClient.calls).toContainEqual({ queryKey: [\"action\"] });\n  });\n\n  it(\"keeps non-action events on targeted framework invalidations\", async () => {\n    const result = await renderWithEvent({\n      version: 1,\n      source: \"settings\",\n      type: \"change\",\n      key: \"*\",\n    });\n    roots.push(result.root);\n    containers.push(result.container);\n\n    expect(result.fetchMock).toHaveBeenCalled();\n    expect(result.queryClient.calls).not.toContainEqual(undefined);\n    expect(result.queryClient.calls).toContainEqual({ queryKey: [\"action\"] });\n  });\n});\n"]}

package/dist/db/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"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"}

package/dist/db/client.js

@@ -9,6 +9,7 @@
  * Cloudflare Workers, edge) without failing on missing native deps.
  */
 import path from "path";
+const recyclingPostgresPools = new WeakSet();
 // ---------------------------------------------------------------------------
 // Per-app DATABASE_URL resolution
 // ---------------------------------------------------------------------------
@@ -566,12 +567,16 @@ async function createDbExecInternal(config = {}, trackSingletonResources = false
             let pool = createPool();
             if (trackSingletonResources)
                 _pgPool = pool;
-            const recyclePool = async () => {
-                const oldPool = pool;
-                pool = createPool();
-                if (trackSingletonResources)
-                    _pgPool = pool;
-                await oldPool.end({ timeout: 1 });
+            const recyclePool = async (timedOutPool) => {
+                if (recyclingPostgresPools.has(timedOutPool))
+                    return;
+                recyclingPostgresPools.add(timedOutPool);
+                if (pool === timedOutPool) {
+                    pool = createPool();
+                    if (trackSingletonResources)
+                        _pgPool = pool;
+                }
+                await timedOutPool.end({ timeout: 1 });
             };
             return {
                 async execute(sql) {
@@ -579,8 +584,9 @@ async function createDbExecInternal(config = {}, trackSingletonResources = false
                     const args = typeof sql === "string" ? [] : sql.args || [];
                     const pgSql = sqliteToPostgresParams(rawSql);
                     const result = await retryOnConnectionError(() => {
-                        const query = pool.unsafe(pgSql, args);
-                        return withDbTimeout("query", () => query, dbOpTimeoutMs(), recyclePool);
+                        const queryPool = pool;
+                        const query = queryPool.unsafe(pgSql, args);
+                        return withDbTimeout("query", () => query, dbOpTimeoutMs(), () => recyclePool(queryPool));
                     });
                     return {
                         rows: Array.from(result),