@agent-native/core 0.12.30 → 0.12.31

package/dist/client/sharing/ShareButton.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"ShareButton.spec.js","sourceRoot":"","sources":["../../../src/client/sharing/ShareButton.spec.tsx"],"names":[],"mappings":"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","sourcesContent":["// @vitest-environment happy-dom\nimport React, { act } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport { createRoot, type Root } from \"react-dom/client\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { ShareButton } from \"./ShareButton.js\";\n\nconst shareMutate = vi.hoisted(() => vi.fn());\nconst otherMutate = vi.hoisted(() => vi.fn());\nconst refetchShares = vi.hoisted(() => vi.fn(async () => undefined));\n\nvi.mock(\"../use-action.js\", () => ({\n  useActionQuery: () => ({\n    data: {\n      ownerEmail: \"owner@example.com\",\n      orgId: null,\n      visibility: \"private\",\n      role: \"owner\",\n      shares: [],\n    },\n    refetch: refetchShares,\n  }),\n  useActionMutation: (name: string) => ({\n    mutate: name === \"share-resource\" ? shareMutate : otherMutate,\n  }),\n}));\n\nvi.mock(\"../components/ui/popover.js\", () => ({\n  Popover: ({ children }: { children: React.ReactNode }) => (\n    <div>{children}</div>\n  ),\n  PopoverTrigger: ({ children }: { children: React.ReactNode }) => (\n    <>{children}</>\n  ),\n  PopoverContent: ({ children }: { children: React.ReactNode }) => (\n    <div>{children}</div>\n  ),\n}));\n\nfunction setInputValue(input: HTMLInputElement, value: string) {\n  const setter = Object.getOwnPropertyDescriptor(\n    Object.getPrototypeOf(input),\n    \"value\",\n  )?.set;\n  act(() => {\n    setter?.call(input, value);\n    input.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    input.dispatchEvent(new Event(\"change\", { bubbles: true }));\n  });\n}\n\ndescribe(\"ShareButton\", () => {\n  let container: HTMLDivElement;\n  let root: Root;\n  let queryClient: QueryClient;\n\n  beforeEach(() => {\n    vi.stubGlobal(\"IS_REACT_ACT_ENVIRONMENT\", true);\n    vi.stubGlobal(\n      \"fetch\",\n      vi.fn(async () =>\n        Response.json({\n          members: [],\n        }),\n      ),\n    );\n    shareMutate.mockReset();\n    otherMutate.mockReset();\n    refetchShares.mockClear();\n    queryClient = new QueryClient({\n      defaultOptions: {\n        queries: { retry: false },\n        mutations: { retry: false },\n      },\n    });\n    container = document.createElement(\"div\");\n    document.body.appendChild(container);\n    root = createRoot(container);\n  });\n\n  afterEach(() => {\n    act(() => root.unmount());\n    queryClient.clear();\n    container.remove();\n    vi.unstubAllGlobals();\n  });\n\n  it(\"submits a typed email invite when Done is clicked\", async () => {\n    await act(async () => {\n      root.render(\n        <QueryClientProvider client={queryClient}>\n          <ShareButton\n            resourceType=\"document\"\n            resourceId=\"doc-1\"\n            resourceTitle=\"Launch notes\"\n            shareUrl=\"https://content.agent-native.com/page/doc-1\"\n          />\n        </QueryClientProvider>,\n      );\n    });\n\n    const input = container.querySelector(\n      'input[placeholder=\"Add people by email\"]',\n    ) as HTMLInputElement;\n    setInputValue(input, \"teammate@example.com\");\n\n    const done = Array.from(container.querySelectorAll(\"button\")).find(\n      (button) => button.textContent === \"Done\",\n    );\n    if (!done) throw new Error(\"Done button not found\");\n\n    act(() => {\n      done.click();\n    });\n\n    expect(shareMutate).toHaveBeenCalledWith(\n      expect.objectContaining({\n        resourceType: \"document\",\n        resourceId: \"doc-1\",\n        principalType: \"user\",\n        principalId: \"teammate@example.com\",\n        role: \"viewer\",\n        notify: true,\n        resourceUrl: \"https://content.agent-native.com/page/doc-1\",\n      }),\n      expect.any(Object),\n    );\n  });\n});\n"]}
+{"version":3,"file":"ShareButton.spec.js","sourceRoot":"","sources":["../../../src/client/sharing/ShareButton.spec.tsx"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,OAAc,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzE,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,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9C,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9C,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AACrE,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnC,OAAO,EAAE;QACP,UAAU,EAAE,mBAAmB;QAC/B,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,EAAE;KACX;CACF,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QACrB,IAAI,EAAE,UAAU,CAAC,OAAO;QACxB,OAAO,EAAE,aAAa;KACvB,CAAC;IACF,iBAAiB,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,EAAE,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW;KAC9D,CAAC;CACH,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,6BAA6B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5C,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CACxD,wBAAM,QAAQ,GAAO,CACtB;IACD,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,4BAAG,QAAQ,GAAI,CAChB;IACD,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,wBAAM,QAAQ,GAAO,CACtB;CACF,CAAC,CAAC,CAAC;AAEJ,SAAS,aAAa,CAAC,KAAuB,EAAE,KAAa;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,wBAAwB,CAC5C,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAC5B,OAAO,CACR,EAAE,GAAG,CAAC;IACP,GAAG,CAAC,GAAG,EAAE;QACP,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3B,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3D,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,SAAyB,CAAC;IAC9B,IAAI,IAAU,CAAC;IACf,IAAI,WAAwB,CAAC;IAE7B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,UAAU,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;QAChD,EAAE,CAAC,UAAU,CACX,OAAO,EACP,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CACf,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,EAAE;SACZ,CAAC,CACH,CACF,CAAC;QACF,WAAW,CAAC,SAAS,EAAE,CAAC;QACxB,WAAW,CAAC,SAAS,EAAE,CAAC;QACxB,aAAa,CAAC,SAAS,EAAE,CAAC;QAC1B,UAAU,CAAC,OAAO,GAAG;YACnB,UAAU,EAAE,mBAAmB;YAC/B,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,EAAE;SACX,CAAC;QACF,WAAW,GAAG,IAAI,WAAW,CAAC;YAC5B,cAAc,EAAE;gBACd,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;gBACzB,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;aAC5B;SACF,CAAC,CAAC;QACH,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1B,WAAW,CAAC,KAAK,EAAE,CAAC;QACpB,SAAS,CAAC,MAAM,EAAE,CAAC;QACnB,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;YACnB,IAAI,CAAC,MAAM,CACT,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YACtC,KAAC,WAAW,IACV,YAAY,EAAC,UAAU,EACvB,UAAU,EAAC,OAAO,EAClB,aAAa,EAAC,cAAc,EAC5B,QAAQ,EAAC,6CAA6C,GACtD,GACkB,CACvB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CACnC,0CAA0C,CACvB,CAAC;QACtB,aAAa,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;QAE7C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAChE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,KAAK,MAAM,CAC1C,CAAC;QACF,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEpD,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CACtC,MAAM,CAAC,gBAAgB,CAAC;YACtB,YAAY,EAAE,UAAU;YACxB,UAAU,EAAE,OAAO;YACnB,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,sBAAsB;YACnC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,6CAA6C;SAC3D,CAAC,EACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CACnB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE;YAC5C,KAAK,EAAE,EAAE,SAAS,EAAE;YACpB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;YACnB,IAAI,CAAC,MAAM,CACT,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YACtC,KAAC,WAAW,IACV,YAAY,EAAC,MAAM,EACnB,UAAU,EAAC,QAAQ,EACnB,aAAa,EAAC,aAAa,EAC3B,QAAQ,EAAC,0CAA0C,EACnD,sBAAsB,SACtB,GACkB,CACvB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAClC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CACrC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,KAAK,sBAAsB,CAAC,CAAC;QAClE,IAAI,CAAC,iBAAiB;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAExE,MAAM,SAAS,GAAG,SAAS,CAAC,aAAa,CACvC,8DAA8D,CAC/D,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,CAAC;QAE/B,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;YACnB,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CACtC,MAAM,CAAC,gBAAgB,CAAC;YACtB,YAAY,EAAE,MAAM;YACpB,UAAU,EAAE,QAAQ;YACpB,UAAU,EAAE,QAAQ;SACrB,CAAC,EACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CACnB,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,UAAU,CAAC,OAAO,GAAG;YACnB,UAAU,EAAE,mBAAmB;YAC/B,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,QAAQ;YACpB,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,EAAE;SACX,CAAC;QAEF,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;YACnB,IAAI,CAAC,MAAM,CACT,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YACtC,KAAC,WAAW,IACV,YAAY,EAAC,MAAM,EACnB,UAAU,EAAC,QAAQ,EACnB,QAAQ,EAAC,0CAA0C,EACnD,sBAAsB,SACtB,GACkB,CACvB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,CACJ,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CACnD,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,KAAK,MAAM,CAC1C,CACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["// @vitest-environment happy-dom\nimport React, { act } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport { createRoot, type Root } from \"react-dom/client\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { ShareButton } from \"./ShareButton.js\";\n\nconst shareMutate = vi.hoisted(() => vi.fn());\nconst otherMutate = vi.hoisted(() => vi.fn());\nconst refetchShares = vi.hoisted(() => vi.fn(async () => undefined));\nconst sharesData = vi.hoisted(() => ({\n  current: {\n    ownerEmail: \"owner@example.com\",\n    orgId: null,\n    visibility: \"private\",\n    role: \"owner\",\n    shares: [],\n  },\n}));\n\nvi.mock(\"../use-action.js\", () => ({\n  useActionQuery: () => ({\n    data: sharesData.current,\n    refetch: refetchShares,\n  }),\n  useActionMutation: (name: string) => ({\n    mutate: name === \"share-resource\" ? shareMutate : otherMutate,\n  }),\n}));\n\nvi.mock(\"../components/ui/popover.js\", () => ({\n  Popover: ({ children }: { children: React.ReactNode }) => (\n    <div>{children}</div>\n  ),\n  PopoverTrigger: ({ children }: { children: React.ReactNode }) => (\n    <>{children}</>\n  ),\n  PopoverContent: ({ children }: { children: React.ReactNode }) => (\n    <div>{children}</div>\n  ),\n}));\n\nfunction setInputValue(input: HTMLInputElement, value: string) {\n  const setter = Object.getOwnPropertyDescriptor(\n    Object.getPrototypeOf(input),\n    \"value\",\n  )?.set;\n  act(() => {\n    setter?.call(input, value);\n    input.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    input.dispatchEvent(new Event(\"change\", { bubbles: true }));\n  });\n}\n\ndescribe(\"ShareButton\", () => {\n  let container: HTMLDivElement;\n  let root: Root;\n  let queryClient: QueryClient;\n\n  beforeEach(() => {\n    vi.stubGlobal(\"IS_REACT_ACT_ENVIRONMENT\", true);\n    vi.stubGlobal(\n      \"fetch\",\n      vi.fn(async () =>\n        Response.json({\n          members: [],\n        }),\n      ),\n    );\n    shareMutate.mockReset();\n    otherMutate.mockReset();\n    refetchShares.mockClear();\n    sharesData.current = {\n      ownerEmail: \"owner@example.com\",\n      orgId: null,\n      visibility: \"private\",\n      role: \"owner\",\n      shares: [],\n    };\n    queryClient = new QueryClient({\n      defaultOptions: {\n        queries: { retry: false },\n        mutations: { retry: false },\n      },\n    });\n    container = document.createElement(\"div\");\n    document.body.appendChild(container);\n    root = createRoot(container);\n  });\n\n  afterEach(() => {\n    act(() => root.unmount());\n    queryClient.clear();\n    container.remove();\n    vi.unstubAllGlobals();\n  });\n\n  it(\"submits a typed email invite when Done is clicked\", async () => {\n    await act(async () => {\n      root.render(\n        <QueryClientProvider client={queryClient}>\n          <ShareButton\n            resourceType=\"document\"\n            resourceId=\"doc-1\"\n            resourceTitle=\"Launch notes\"\n            shareUrl=\"https://content.agent-native.com/page/doc-1\"\n          />\n        </QueryClientProvider>,\n      );\n    });\n\n    const input = container.querySelector(\n      'input[placeholder=\"Add people by email\"]',\n    ) as HTMLInputElement;\n    setInputValue(input, \"teammate@example.com\");\n\n    const done = Array.from(container.querySelectorAll(\"button\")).find(\n      (button) => button.textContent === \"Done\",\n    );\n    if (!done) throw new Error(\"Done button not found\");\n\n    act(() => {\n      done.click();\n    });\n\n    expect(shareMutate).toHaveBeenCalledWith(\n      expect.objectContaining({\n        resourceType: \"document\",\n        resourceId: \"doc-1\",\n        principalType: \"user\",\n        principalId: \"teammate@example.com\",\n        role: \"viewer\",\n        notify: true,\n        resourceUrl: \"https://content.agent-native.com/page/doc-1\",\n      }),\n      expect.any(Object),\n    );\n  });\n\n  it(\"requires public visibility before copying a public-only link\", async () => {\n    const writeText = vi.fn(async () => undefined);\n    Object.defineProperty(navigator, \"clipboard\", {\n      value: { writeText },\n      configurable: true,\n    });\n\n    await act(async () => {\n      root.render(\n        <QueryClientProvider client={queryClient}>\n          <ShareButton\n            resourceType=\"deck\"\n            resourceId=\"deck-1\"\n            resourceTitle=\"Launch deck\"\n            shareUrl=\"https://slides.agent-native.com/p/deck-1\"\n            shareUrlRequiresPublic\n          />\n        </QueryClientProvider>,\n      );\n    });\n\n    const makePublicAndCopy = Array.from(\n      container.querySelectorAll(\"button\"),\n    ).find((button) => button.textContent === \"Make public and copy\");\n    if (!makePublicAndCopy) throw new Error(\"Make public button not found\");\n\n    const linkInput = container.querySelector(\n      'input[value=\"Link available after general access is Public\"]',\n    );\n    expect(linkInput).toBeTruthy();\n\n    await act(async () => {\n      makePublicAndCopy.click();\n    });\n\n    expect(otherMutate).toHaveBeenCalledWith(\n      expect.objectContaining({\n        resourceType: \"deck\",\n        resourceId: \"deck-1\",\n        visibility: \"public\",\n      }),\n      expect.any(Object),\n    );\n    expect(writeText).not.toHaveBeenCalled();\n  });\n\n  it(\"shows the copy action for public public-only links\", async () => {\n    sharesData.current = {\n      ownerEmail: \"owner@example.com\",\n      orgId: null,\n      visibility: \"public\",\n      role: \"owner\",\n      shares: [],\n    };\n\n    await act(async () => {\n      root.render(\n        <QueryClientProvider client={queryClient}>\n          <ShareButton\n            resourceType=\"deck\"\n            resourceId=\"deck-1\"\n            shareUrl=\"https://slides.agent-native.com/p/deck-1\"\n            shareUrlRequiresPublic\n          />\n        </QueryClientProvider>,\n      );\n    });\n\n    expect(\n      Array.from(container.querySelectorAll(\"button\")).some(\n        (button) => button.textContent === \"Copy\",\n      ),\n    ).toBe(true);\n  });\n});\n"]}

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

@@ -4,17 +4,23 @@ interface QueryClient {
     }): void;
 }
 /**
- * Hook that polls /_agent-native/poll for DB change events and invalidates
- * react-query caches when changes are detected.
+ * Hook that listens to /_agent-native/events for DB change events and
+ * invalidates react-query caches when changes are detected. Falls back to
+ * /_agent-native/poll so cross-process/serverless writes still show up.
  *
  * Works in all deployment environments (serverless, edge, long-lived server).
+ * SSE is the fast path; polling is the safety net.
  *
  * @param options.queryClient - The react-query QueryClient instance
  * @param options.queryKeys - Array of query key prefixes to invalidate on change.
  *   Default: ["data"]
  * @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.
  * @param options.onEvent - Optional callback for each change event
  * @param options.interval - Poll interval in ms. Default: 2000
+ * @param options.fallbackInterval - Poll interval while SSE is connected.
+ *   Default: 15000
  * @param options.pauseWhenHidden - Pause polling while the tab is hidden.
  *   Default: true
  * @param options.ignoreSource - Skip events whose `requestSource` matches this
@@ -25,10 +31,12 @@ export declare function useDbSync(options?: {
     queryClient?: QueryClient;
     queryKeys?: string[];
     pollUrl?: string;
+    sseUrl?: string | false;
     /** @deprecated Use pollUrl instead */
     eventsUrl?: string;
     onEvent?: (data: any) => void;
     interval?: number;
+    fallbackInterval?: number;
     pauseWhenHidden?: boolean;
     ignoreSource?: string;
 }): void;
@@ -55,7 +63,9 @@ export declare const useFileWatcher: typeof useDbSync;
  */
 export declare function useScreenRefreshKey(options?: {
     pollUrl?: string;
+    sseUrl?: string | false;
     interval?: number;
+    fallbackInterval?: number;
     pauseWhenHidden?: boolean;
 }): number;
 export {};

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":"AAGA,UAAU,WAAW;IACnB,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CACzD;AAqCD;;;;;;;;;;;;;;;;;GAiBG;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,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,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,IAAI,CAyIN;AAED,wCAAwC;AACxC,eAAO,MAAM,cAAc,kBAAY,CAAC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,MAAM,CA+ER"}
+{"version":3,"file":"use-db-sync.d.ts","sourceRoot":"","sources":["../../src/client/use-db-sync.ts"],"names":[],"mappings":"AAGA,UAAU,WAAW;IACnB,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CACzD;AA6ED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;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,CA2MN;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

@@ -1,12 +1,33 @@
 import { useEffect, useRef, useState } from "react";
 import { agentNativePath } from "./api-path.js";
 const POLL_ABORT_MIN_MS = 10_000;
+const SSE_FALLBACK_INTERVAL_MS = 15_000;
 function getPollAbortMs(interval) {
     return Math.max(POLL_ABORT_MIN_MS, interval * 4);
 }
 function isDocumentHidden() {
     return (typeof document !== "undefined" && document.visibilityState === "hidden");
 }
+function resolveSseUrl(sseUrl) {
+    if (sseUrl === false)
+        return false;
+    return agentNativePath(sseUrl ?? "/_agent-native/events");
+}
+function normalizeEventPayload(payload) {
+    if (!payload || typeof payload !== "object")
+        return [];
+    const record = payload;
+    if (record.type === "batch" && Array.isArray(record.events)) {
+        return record.events.filter((event) => !!event && typeof event === "object");
+    }
+    if (Array.isArray(record.events)) {
+        return record.events.filter((event) => !!event && typeof event === "object");
+    }
+    return [payload];
+}
+function eventVersion(event) {
+    return typeof event.version === "number" ? event.version : 0;
+}
 async function fetchPollJson(pollUrl, since, interval) {
     const controller = typeof AbortController === "undefined" ? null : new AbortController();
     const timeout = controller
@@ -24,17 +45,23 @@ async function fetchPollJson(pollUrl, since, interval) {
     }
 }
 /**
- * Hook that polls /_agent-native/poll for DB change events and invalidates
- * react-query caches when changes are detected.
+ * Hook that listens to /_agent-native/events for DB change events and
+ * invalidates react-query caches when changes are detected. Falls back to
+ * /_agent-native/poll so cross-process/serverless writes still show up.
  *
  * Works in all deployment environments (serverless, edge, long-lived server).
+ * SSE is the fast path; polling is the safety net.
  *
  * @param options.queryClient - The react-query QueryClient instance
  * @param options.queryKeys - Array of query key prefixes to invalidate on change.
  *   Default: ["data"]
  * @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.
  * @param options.onEvent - Optional callback for each change event
  * @param options.interval - Poll interval in ms. Default: 2000
+ * @param options.fallbackInterval - Poll interval while SSE is connected.
+ *   Default: 15000
  * @param options.pauseWhenHidden - Pause polling while the tab is hidden.
  *   Default: true
  * @param options.ignoreSource - Skip events whose `requestSource` matches this
@@ -42,7 +69,7 @@ async function fetchPollJson(pollUrl, since, interval) {
  *   picking up changes from other tabs, agents, and scripts.
  */
 export function useDbSync(options = {}) {
-    const { queryClient, queryKeys = ["data"], pollUrl = agentNativePath(options.eventsUrl ?? "/_agent-native/poll"), interval = 2000, pauseWhenHidden = true, } = options;
+    const { queryClient, queryKeys = ["data"], pollUrl = agentNativePath(options.eventsUrl ?? "/_agent-native/poll"), sseUrl = resolveSseUrl(options.sseUrl), interval = 2000, fallbackInterval = Math.max(options.fallbackInterval ?? SSE_FALLBACK_INTERVAL_MS, interval), pauseWhenHidden = true, } = options;
     const onEventRef = useRef(options.onEvent);
     onEventRef.current = options.onEvent;
     const keysRef = useRef(queryKeys);
@@ -54,6 +81,8 @@ export function useDbSync(options = {}) {
         let timer = null;
         let stopped = false;
         let inFlight = false;
+        let eventSource = null;
+        let sseConnected = false;
         function schedulePoll() {
             if (stopped)
                 return;
@@ -64,7 +93,86 @@ export function useDbSync(options = {}) {
             timer = setTimeout(() => {
                 timer = null;
                 void poll();
-            }, interval);
+            }, sseConnected ? fallbackInterval : interval);
+        }
+        function invalidateForEvents(events) {
+            const ignore = ignoreSourceRef.current;
+            const relevant = ignore
+                ? events.filter((e) => e.requestSource !== ignore)
+                : events;
+            if (relevant.length > 0 && queryClient) {
+                for (const key of keysRef.current) {
+                    queryClient.invalidateQueries({ queryKey: [key] });
+                }
+                // Framework-level invalidation: always invalidate framework query
+                // keys on any non-own change event so that mutating actions
+                // (agent or HTTP) auto-refresh the UI — regardless of how the
+                // template configured queryKeys / onEvent.
+                queryClient.invalidateQueries({ queryKey: ["action"] });
+                queryClient.invalidateQueries({ queryKey: ["extension"] });
+                queryClient.invalidateQueries({ queryKey: ["extensions"] });
+                queryClient.invalidateQueries({ queryKey: ["extension-slots"] });
+                queryClient.invalidateQueries({ queryKey: ["slot-installs"] });
+                queryClient.invalidateQueries({ queryKey: ["slot-available"] });
+                queryClient.invalidateQueries({ queryKey: ["tool"] });
+                queryClient.invalidateQueries({ queryKey: ["tools"] });
+                queryClient.invalidateQueries({ queryKey: ["app-state"] });
+                queryClient.invalidateQueries({ queryKey: ["navigate-command"] });
+                queryClient.invalidateQueries({ queryKey: ["show-questions"] });
+                queryClient.invalidateQueries({ queryKey: ["__set_url__"] });
+            }
+            // Always forward all events to onEvent — templates can decide.
+            for (const evt of events) {
+                onEventRef.current?.(evt);
+            }
+        }
+        function applyEvents(events, version) {
+            const freshEvents = events.filter((event) => {
+                const version = eventVersion(event);
+                return version === 0 || version > versionRef;
+            });
+            if (freshEvents.length > 0) {
+                invalidateForEvents(freshEvents);
+            }
+            const maxEventVersion = freshEvents.reduce((max, event) => Math.max(max, eventVersion(event)), 0);
+            versionRef = Math.max(versionRef, version ?? 0, maxEventVersion);
+        }
+        function closeEvents() {
+            if (!eventSource)
+                return;
+            eventSource.close();
+            eventSource = null;
+            sseConnected = false;
+        }
+        function connectEvents() {
+            if (stopped ||
+                !sseUrl ||
+                eventSource ||
+                typeof EventSource === "undefined" ||
+                (pauseWhenHidden && isDocumentHidden())) {
+                return;
+            }
+            const source = new EventSource(sseUrl);
+            eventSource = source;
+            source.onopen = () => {
+                sseConnected = true;
+                schedulePoll();
+            };
+            source.onerror = () => {
+                sseConnected = false;
+                schedulePoll();
+            };
+            source.onmessage = (message) => {
+                try {
+                    const payload = JSON.parse(message.data);
+                    const events = normalizeEventPayload(payload);
+                    const version = typeof payload?.version === "number" ? payload.version : undefined;
+                    applyEvents(events, version);
+                }
+                catch {
+                    // Ignore malformed SSE frames; polling is the safety net.
+                }
+            };
         }
         async function poll() {
             if (stopped || inFlight)
@@ -72,41 +180,7 @@ export function useDbSync(options = {}) {
             inFlight = true;
             try {
                 const data = await fetchPollJson(pollUrl, versionRef, interval);
-                const { version, events } = data;
-                if (events.length > 0 && queryClient) {
-                    const ignore = ignoreSourceRef.current;
-                    const relevant = ignore
-                        ? events.filter((e) => e.requestSource !== ignore)
-                        : events;
-                    if (relevant.length > 0) {
-                        for (const key of keysRef.current) {
-                            queryClient.invalidateQueries({ queryKey: [key] });
-                        }
-                        // Framework-level invalidation: always invalidate framework query
-                        // keys on any non-own change event so that mutating actions
-                        // (agent or HTTP) auto-refresh the UI — regardless of how the
-                        // template configured queryKeys / onEvent.
-                        queryClient.invalidateQueries({ queryKey: ["action"] });
-                        queryClient.invalidateQueries({ queryKey: ["extension"] });
-                        queryClient.invalidateQueries({ queryKey: ["extensions"] });
-                        queryClient.invalidateQueries({ queryKey: ["extension-slots"] });
-                        queryClient.invalidateQueries({ queryKey: ["slot-installs"] });
-                        queryClient.invalidateQueries({ queryKey: ["slot-available"] });
-                        queryClient.invalidateQueries({ queryKey: ["tool"] });
-                        queryClient.invalidateQueries({ queryKey: ["tools"] });
-                        queryClient.invalidateQueries({ queryKey: ["app-state"] });
-                        queryClient.invalidateQueries({ queryKey: ["navigate-command"] });
-                        queryClient.invalidateQueries({ queryKey: ["show-questions"] });
-                        queryClient.invalidateQueries({ queryKey: ["__set_url__"] });
-                    }
-                    // Always forward all events to onEvent — templates can decide
-                    for (const evt of events) {
-                        onEventRef.current?.(evt);
-                    }
-                }
-                // Never decrease — protects against serverless instances with
-                // slightly different version counters.
-                versionRef = Math.max(versionRef, version);
+                applyEvents(data.events ?? [], data.version);
             }
             catch {
                 // Network error — will retry on next interval
@@ -124,31 +198,45 @@ export function useDbSync(options = {}) {
                 clearTimeout(timer);
                 timer = null;
             }
+            connectEvents();
             void poll();
         }
         function handleVisibilityChange() {
             if (document.visibilityState === "visible") {
+                connectEvents();
                 pollNow();
             }
-            else if (pauseWhenHidden && timer) {
-                clearTimeout(timer);
-                timer = null;
+            else if (pauseWhenHidden) {
+                closeEvents();
+                if (timer) {
+                    clearTimeout(timer);
+                    timer = null;
+                }
             }
         }
         // Initial poll immediately when visible. Hidden tabs catch up on focus.
         if (!pauseWhenHidden || !isDocumentHidden()) {
+            connectEvents();
             void poll();
         }
         window.addEventListener("focus", pollNow);
         document.addEventListener("visibilitychange", handleVisibilityChange);
         return () => {
             stopped = true;
+            closeEvents();
             if (timer)
                 clearTimeout(timer);
             window.removeEventListener("focus", pollNow);
             document.removeEventListener("visibilitychange", handleVisibilityChange);
         };
-    }, [pollUrl, queryClient, interval, pauseWhenHidden]);
+    }, [
+        pollUrl,
+        sseUrl,
+        queryClient,
+        interval,
+        fallbackInterval,
+        pauseWhenHidden,
+    ]);
 }
 /** @deprecated Use useDbSync instead */
 export const useFileWatcher = useDbSync;
@@ -172,13 +260,15 @@ export const useFileWatcher = useDbSync;
  *   );
  */
 export function useScreenRefreshKey(options = {}) {
-    const { pollUrl = agentNativePath(options.pollUrl ?? "/_agent-native/poll"), interval = 2000, pauseWhenHidden = true, } = options;
+    const { pollUrl = agentNativePath(options.pollUrl ?? "/_agent-native/poll"), sseUrl = resolveSseUrl(options.sseUrl), interval = 2000, fallbackInterval = Math.max(options.fallbackInterval ?? SSE_FALLBACK_INTERVAL_MS, interval), pauseWhenHidden = true, } = options;
     const [key, setKey] = useState(0);
     useEffect(() => {
         let versionRef = 0;
         let timer = null;
         let stopped = false;
         let inFlight = false;
+        let eventSource = null;
+        let sseConnected = false;
         function schedulePoll() {
             if (stopped)
                 return;
@@ -189,7 +279,55 @@ export function useScreenRefreshKey(options = {}) {
             timer = setTimeout(() => {
                 timer = null;
                 void poll();
-            }, interval);
+            }, sseConnected ? fallbackInterval : interval);
+        }
+        function applyEvents(events, version) {
+            const freshEvents = events.filter((event) => {
+                const version = eventVersion(event);
+                return version === 0 || version > versionRef;
+            });
+            if (freshEvents.some((e) => e.source === "screen-refresh")) {
+                setKey((k) => k + 1);
+            }
+            const maxEventVersion = freshEvents.reduce((max, event) => Math.max(max, eventVersion(event)), 0);
+            versionRef = Math.max(versionRef, version ?? 0, maxEventVersion);
+        }
+        function closeEvents() {
+            if (!eventSource)
+                return;
+            eventSource.close();
+            eventSource = null;
+            sseConnected = false;
+        }
+        function connectEvents() {
+            if (stopped ||
+                !sseUrl ||
+                eventSource ||
+                typeof EventSource === "undefined" ||
+                (pauseWhenHidden && isDocumentHidden())) {
+                return;
+            }
+            const source = new EventSource(sseUrl);
+            eventSource = source;
+            source.onopen = () => {
+                sseConnected = true;
+                schedulePoll();
+            };
+            source.onerror = () => {
+                sseConnected = false;
+                schedulePoll();
+            };
+            source.onmessage = (message) => {
+                try {
+                    const payload = JSON.parse(message.data);
+                    const events = normalizeEventPayload(payload);
+                    const version = typeof payload?.version === "number" ? payload.version : undefined;
+                    applyEvents(events, version);
+                }
+                catch {
+                    // Polling will catch missed screen-refresh events.
+                }
+            };
         }
         async function poll() {
             if (stopped || inFlight)
@@ -197,10 +335,7 @@ export function useScreenRefreshKey(options = {}) {
             inFlight = true;
             try {
                 const data = await fetchPollJson(pollUrl, versionRef, interval);
-                if (data.events?.some((e) => e.source === "screen-refresh")) {
-                    setKey((k) => k + 1);
-                }
-                versionRef = Math.max(versionRef, data.version);
+                applyEvents(data.events ?? [], data.version);
             }
             catch {
                 // Network error — retry on next interval.
@@ -218,30 +353,37 @@ export function useScreenRefreshKey(options = {}) {
                 clearTimeout(timer);
                 timer = null;
             }
+            connectEvents();
             void poll();
         }
         function handleVisibilityChange() {
             if (document.visibilityState === "visible") {
+                connectEvents();
                 pollNow();
             }
-            else if (pauseWhenHidden && timer) {
-                clearTimeout(timer);
-                timer = null;
+            else if (pauseWhenHidden) {
+                closeEvents();
+                if (timer) {
+                    clearTimeout(timer);
+                    timer = null;
+                }
             }
         }
         if (!pauseWhenHidden || !isDocumentHidden()) {
+            connectEvents();
             void poll();
         }
         window.addEventListener("focus", pollNow);
         document.addEventListener("visibilitychange", handleVisibilityChange);
         return () => {
             stopped = true;
+            closeEvents();
             if (timer)
                 clearTimeout(timer);
             window.removeEventListener("focus", pollNow);
             document.removeEventListener("visibilitychange", handleVisibilityChange);
         };
-    }, [pollUrl, interval, pauseWhenHidden]);
+    }, [pollUrl, sseUrl, interval, fallbackInterval, pauseWhenHidden]);
     return key;
 }
 //# sourceMappingURL=use-db-sync.js.map

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\";\n\ninterface QueryClient {\n  invalidateQueries(opts?: { queryKey?: string[] }): void;\n}\n\nconst POLL_ABORT_MIN_MS = 10_000;\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\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    return res.json();\n  } finally {\n    if (timeout) clearTimeout(timeout);\n  }\n}\n\n/**\n * Hook that polls /_agent-native/poll for DB change events and invalidates\n * react-query caches when changes are detected.\n *\n * Works in all deployment environments (serverless, edge, long-lived server).\n *\n * @param options.queryClient - The react-query QueryClient instance\n * @param options.queryKeys - Array of query key prefixes to invalidate on change.\n *   Default: [\"data\"]\n * @param options.pollUrl - Poll endpoint URL. Default: \"/_agent-native/poll\"\n * @param options.onEvent - Optional callback for each change event\n * @param options.interval - Poll interval in ms. Default: 2000\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    /** @deprecated Use pollUrl instead */\n    eventsUrl?: string;\n    onEvent?: (data: any) => void;\n    interval?: number;\n    pauseWhenHidden?: boolean;\n    ignoreSource?: string;\n  } = {},\n): void {\n  const {\n    queryClient,\n    queryKeys = [\"data\"],\n    pollUrl = agentNativePath(options.eventsUrl ?? \"/_agent-native/poll\"),\n    interval = 2000,\n    pauseWhenHidden = true,\n  } = options;\n\n  const onEventRef = useRef(options.onEvent);\n  onEventRef.current = options.onEvent;\n\n  const keysRef = useRef(queryKeys);\n  keysRef.current = queryKeys;\n\n  const ignoreSourceRef = useRef(options.ignoreSource);\n  ignoreSourceRef.current = options.ignoreSource;\n\n  useEffect(() => {\n    let versionRef = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    let stopped = false;\n    let inFlight = false;\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(() => {\n        timer = null;\n        void poll();\n      }, interval);\n    }\n\n    async function poll() {\n      if (stopped || inFlight) return;\n      inFlight = true;\n      try {\n        const data = await fetchPollJson<{\n          version: number;\n          events: Array<{\n            source: string;\n            type: string;\n            key?: string;\n            requestSource?: string;\n          }>;\n        }>(pollUrl, versionRef, interval);\n        const { version, events } = data as {\n          version: number;\n          events: Array<{\n            source: string;\n            type: string;\n            key?: string;\n            requestSource?: string;\n          }>;\n        };\n\n        if (events.length > 0 && queryClient) {\n          const ignore = ignoreSourceRef.current;\n          const relevant = ignore\n            ? events.filter((e: any) => e.requestSource !== ignore)\n            : events;\n\n          if (relevant.length > 0) {\n            for (const key of keysRef.current) {\n              queryClient.invalidateQueries({ queryKey: [key] });\n            }\n\n            // Framework-level invalidation: always invalidate framework query\n            // keys on any non-own change event so that mutating actions\n            // (agent or HTTP) auto-refresh the UI — regardless of how the\n            // template configured queryKeys / onEvent.\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            queryClient.invalidateQueries({ queryKey: [\"navigate-command\"] });\n            queryClient.invalidateQueries({ queryKey: [\"show-questions\"] });\n            queryClient.invalidateQueries({ queryKey: [\"__set_url__\"] });\n          }\n\n          // Always forward all events to onEvent — templates can decide\n          for (const evt of events) {\n            onEventRef.current?.(evt);\n          }\n        }\n\n        // Never decrease — protects against serverless instances with\n        // slightly different version counters.\n        versionRef = Math.max(versionRef, 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      void poll();\n    }\n\n    function handleVisibilityChange() {\n      if (document.visibilityState === \"visible\") {\n        pollNow();\n      } else if (pauseWhenHidden && timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n    }\n\n    // Initial poll immediately when visible. Hidden tabs catch up on focus.\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [pollUrl, queryClient, interval, pauseWhenHidden]);\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    interval?: number;\n    pauseWhenHidden?: boolean;\n  } = {},\n): number {\n  const {\n    pollUrl = agentNativePath(options.pollUrl ?? \"/_agent-native/poll\"),\n    interval = 2000,\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\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(() => {\n        timer = null;\n        void poll();\n      }, interval);\n    }\n\n    async function poll() {\n      if (stopped || inFlight) return;\n      inFlight = true;\n      try {\n        const data = await fetchPollJson<{\n          version: number;\n          events: Array<{ source: string }>;\n        }>(pollUrl, versionRef, interval);\n        if (data.events?.some((e) => e.source === \"screen-refresh\")) {\n          setKey((k) => k + 1);\n        }\n        versionRef = Math.max(versionRef, 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      void poll();\n    }\n\n    function handleVisibilityChange() {\n      if (document.visibilityState === \"visible\") {\n        pollNow();\n      } else if (pauseWhenHidden && timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n    }\n\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [pollUrl, interval, 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\";\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\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    return 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 - Array of query key prefixes to invalidate on change.\n *   Default: [\"data\"]\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    queryKeys = [\"data\"],\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 keysRef = useRef(queryKeys);\n  keysRef.current = queryKeys;\n\n  const ignoreSourceRef = useRef(options.ignoreSource);\n  ignoreSourceRef.current = options.ignoreSource;\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 invalidateForEvents(events: SyncEvent[]) {\n      const ignore = ignoreSourceRef.current;\n      const relevant = ignore\n        ? events.filter((e) => e.requestSource !== ignore)\n        : events;\n\n      if (relevant.length > 0 && queryClient) {\n        for (const key of keysRef.current) {\n          queryClient.invalidateQueries({ queryKey: [key] });\n        }\n\n        // Framework-level invalidation: always invalidate framework query\n        // keys on any non-own change event so that mutating actions\n        // (agent or HTTP) auto-refresh the UI — regardless of how the\n        // template configured queryKeys / onEvent.\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        queryClient.invalidateQueries({ queryKey: [\"navigate-command\"] });\n        queryClient.invalidateQueries({ queryKey: [\"show-questions\"] });\n        queryClient.invalidateQueries({ queryKey: [\"__set_url__\"] });\n      }\n\n      // Always forward all events to onEvent — templates can decide.\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/server/core-routes-plugin.js

@@ -3,7 +3,7 @@ import { getAllowedCorsOrigin, readCorsAllowedOrigins, } from "./cors-origins.js
 import { defineEventHandler, setResponseStatus, setResponseHeader, getMethod, getHeader, } from "h3";
 import path from "node:path";
 import { createPollHandler } from "./poll.js";
-import { createSSEHandler } from "./sse.js";
+import { createPollEventsHandler } from "./poll-events.js";
 import { upsertEnvFile } from "./create-server.js";
 import { readBody } from "./h3-helpers.js";
 import { BUILDER_CONNECT_PARAM, BUILDER_ENV_KEYS, appendBuilderConnectToken, buildBuilderCliAuthUrl, createBuilderBrowserCallbackErrorPage, createBuilderBrowserCallbackPage, getBuilderBrowserStatusForEvent, resolveBuilderBranchProjectId, resolveSafePreviewUrl, runBuilderAgent, verifyBuilderConnectToken, } from "./builder-browser.js";
@@ -319,7 +319,7 @@ export function createCoreRoutesPlugin(options = {}) {
         // SSE
         if (!options.disableSSE) {
             const sseRoute = options.sseRoute ?? `${P}/events`;
-            getH3App(nitroApp).use(sseRoute, createSSEHandler());
+            getH3App(nitroApp).use(sseRoute, createPollEventsHandler());
         }
         // Ping
         if (!options.disablePing) {