@livequery/react 2.0.104 → 2.0.106

package/README.md

@@ -1,10 +1,10 @@
 # @livequery/react
 
-Thin React bindings for `@livequery/core`.
+Thin React bindings for `@livequery/client`.
 
 This repository is the React bindings library package, not an application. Changes here should preserve reusable hook behavior unless a task explicitly targets a breaking change.
 
-This package provides a small set of hooks and helpers for wiring a `LivequeryCore` instance into a React app, subscribing to RxJS streams, and reading collection or document state from `@livequery/core`.
+This package provides a small set of hooks and helpers for wiring a `LivequeryClient` instance into a React app, subscribing to RxJS streams, and reading collection or document state from `@livequery/client`.
 
 ## AI Agent Guidance
 
@@ -13,24 +13,24 @@ Repository-specific agent guidance lives in `AGENTS.md` and `copilot-instruction
 - `AGENTS.md` is the implementation-focused guide for coding agents modifying this package.
 - `copilot-instructions.md` provides repo-level instructions for Copilot when generating or reviewing code in this workspace.
 - Both documents assume this repo is a React bindings library package, so agent changes should avoid app-specific scaffolding and should preserve public API compatibility by default.
-- Agents generating consumer code should create one shared `LivequeryCore`, provide it through `LivequeryCoreProvider`, and subscribe to collection state with `useObservable()`.
+- Agents generating consumer code should create one shared `LivequeryClient`, provide it through `LivequeryClientProvider`, and subscribe to collection state with `useObservable()`.
 
 ## Install
 
 ```bash
-bun add @livequery/react @livequery/core react rxjs
+bun add @livequery/react @livequery/client react rxjs
 ```
 
 Or with npm:
 
 ```bash
-npm install @livequery/react @livequery/core react rxjs
+npm install @livequery/react @livequery/client react rxjs
 ```
 
 ## Exports
 
-- `LivequeryCoreProvider`
-- `useLivequeryCore`
+- `LivequeryClientProvider`
+- `useLivequeryClient`
 - `useCollection`
 - `useDocument`
 - `useObservable`
@@ -39,21 +39,21 @@ npm install @livequery/react @livequery/core react rxjs
 
 ## Core setup
 
-`useCollection` and `useDocument` read the active `LivequeryCore` instance from `LivequeryCoreProvider`.
+`useCollection` and `useDocument` read the active `LivequeryClient` instance from `LivequeryClientProvider`.
 
 ```tsx
-import { LivequeryCore } from '@livequery/core'
-import { LivequeryCoreProvider } from '@livequery/react'
+import { LivequeryClient } from '@livequery/client'
+import { LivequeryClientProvider } from '@livequery/react'
 
-const core = new LivequeryCore({
+const client = new LivequeryClient({
   endpoint: 'https://your-livequery-server'
 })
 
 export function AppProviders({ children }: { children: React.ReactNode }) {
   return (
-    <LivequeryCoreProvider core={core}>
+    <LivequeryClientProvider client={client}>
       {children}
-    </LivequeryCoreProvider>
+    </LivequeryClientProvider>
   )
 }
 ```
@@ -140,12 +140,12 @@ You can also pass a function when the observable should be resolved lazily.
 `useGlobalValue` stores a lazily created singleton on `globalThis`. This is useful when an app should reuse one object across renders or across multiple React roots in the same runtime.
 
 ```tsx
-import { LivequeryCore } from '@livequery/core'
+import { LivequeryClient } from '@livequery/client'
 import { useGlobalValue } from '@livequery/react'
 
-export function useAppCore() {
-  return useGlobalValue('livequery-core', () => {
-    return new LivequeryCore({
+export function useAppClient() {
+  return useGlobalValue('livequery-client', () => {
+    return new LivequeryClient({
       endpoint: 'https://your-livequery-server'
     })
   })
@@ -180,7 +180,7 @@ Compared to creating context by hand, `createContextFromHook` removes the repeti
 
 It is especially useful when you want an API that reads like a hook-based service locator, but stays explicit through React providers.
 
-The `LivequeryCoreProvider` and `useLivequeryCore` pair in this package is built from this helper.
+The `LivequeryClientProvider` and `useLivequeryClient` pair in this package is built from this helper.
 
 ### Mental model
 
@@ -224,7 +224,7 @@ This is why the consumer side feels like a plain hook even though the data flow
 
 ### Good use cases
 
-- exposing a configured client instance such as `LivequeryCore`
+- exposing a configured client instance such as `LivequeryClient`
 - deriving session or auth state from provider props
 - wrapping feature-specific state that should be consumed through a single custom hook
 - hiding context implementation details from package consumers

package/dist/LivequeryClientContext.d.ts

@@ -0,0 +1,5 @@
+import type { LivequeryClient } from "@livequery/client";
+export declare const useLivequeryClient: () => LivequeryClient, LivequeryClientProvider: (props: import("react").PropsWithChildren<{
+    core: any;
+}>) => import("react").JSX.Element;
+//# sourceMappingURL=LivequeryClientContext.d.ts.map

package/dist/LivequeryClientContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LivequeryClientContext.d.ts","sourceRoot":"","sources":["../src/LivequeryClientContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,eAAO,MAAO,kBAAkB,yBAAE,uBAAuB;UACrC,GAAG;kCACtB,CAAA"}

package/dist/LivequeryClientContext.js

@@ -0,0 +1,3 @@
+import { createContextFromHook } from "./createContextFromHook.js";
+export const [useLivequeryClient, LivequeryClientProvider] = createContextFromHook((props) => props.core);
+//# sourceMappingURL=LivequeryClientContext.js.map

package/dist/LivequeryClientContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LivequeryClientContext.js","sourceRoot":"","sources":["../src/LivequeryClientContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,GAAG,qBAAqB,CAC9E,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAuB,CAC1D,CAAA"}

package/dist/index.d.ts

@@ -2,6 +2,6 @@ export * from './createContextFromHook.js';
 export * from './useCollection.js';
 export * from './useDocument.js';
 export * from './useObservable.js';
-export * from './LivequeryCoreContext.js';
+export * from './LivequeryClientContext.js';
 export * from './useAction.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -2,6 +2,6 @@ export * from './createContextFromHook.js';
 export * from './useCollection.js';
 export * from './useDocument.js';
 export * from './useObservable.js';
-export * from './LivequeryCoreContext.js';
+export * from './LivequeryClientContext.js';
 export * from './useAction.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA;AACzC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gBAAgB,CAAA"}

package/dist/useCollection.d.ts

@@ -1,3 +1,3 @@
-import { LivequeryCollection, type Doc, type LivequeryCollectionOptions } from "@livequery/core";
+import { LivequeryCollection, type Doc, type LivequeryCollectionOptions } from "@livequery/client";
 export declare const useCollection: <T extends Doc>(ref: string | undefined | "" | null | false, options?: Partial<LivequeryCollectionOptions<T>>) => LivequeryCollection<T>;
 //# sourceMappingURL=useCollection.d.ts.map

package/dist/useCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCollection.d.ts","sourceRoot":"","sources":["../src/useCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,GAAG,EAAE,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAMhG,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,MAAM,GAAG,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,EAAE,UAAS,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAM,2BAW7I,CAAA"}
+{"version":3,"file":"useCollection.d.ts","sourceRoot":"","sources":["../src/useCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,GAAG,EAAE,KAAK,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAMlG,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,MAAM,GAAG,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,EAAE,UAAS,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAM,2BAW7I,CAAA"}

package/dist/useCollection.js

@@ -1,17 +1,17 @@
-import { LivequeryCollection } from "@livequery/core";
+import { LivequeryCollection } from "@livequery/client";
 import { useMemo, useEffect } from "react";
-import { useLivequeryCore } from "./LivequeryCoreContext.js";
+import { useLivequeryClient } from "./LivequeryClientContext.js";
 export const useCollection = (ref, options = {}) => {
-    const core = useLivequeryCore();
-    const collection = useMemo(() => new LivequeryCollection(core, options), []);
+    const client = useLivequeryClient();
+    const collection = useMemo(() => new LivequeryCollection(client, options), []);
     useEffect(() => {
-        if (!ref || !core)
+        if (!ref || !client)
             return;
         const linker = collection.initialize(ref);
         return () => {
             linker?.unsubscribe();
         };
-    }, [collection, core, ref]);
+    }, [collection, client, ref]);
     return collection;
 };
 //# sourceMappingURL=useCollection.js.map

package/dist/useCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCollection.js","sourceRoot":"","sources":["../src/useCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA6C,MAAM,iBAAiB,CAAA;AAChG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAI5D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAgB,GAA2C,EAAE,UAAkD,EAAE,EAAE,EAAE;IAC9I,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAA;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAI,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;IAC/E,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;YAAE,OAAM;QACzB,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACzC,OAAO,GAAG,EAAE;YACR,MAAM,EAAE,WAAW,EAAE,CAAA;QACzB,CAAC,CAAA;IACL,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;IAC3B,OAAO,UAAU,CAAA;AACrB,CAAC,CAAA"}
+{"version":3,"file":"useCollection.js","sourceRoot":"","sources":["../src/useCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA6C,MAAM,mBAAmB,CAAA;AAClG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAIhE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAgB,GAA2C,EAAE,UAAkD,EAAE,EAAE,EAAE;IAC9I,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAA;IACnC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAI,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;IACjF,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM;YAAE,OAAM;QAC3B,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACzC,OAAO,GAAG,EAAE;YACR,MAAM,EAAE,WAAW,EAAE,CAAA;QACzB,CAAC,CAAA;IACL,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;IAC7B,OAAO,UAAU,CAAA;AACrB,CAAC,CAAA"}

package/dist/useDocument.d.ts

@@ -1,5 +1,5 @@
-import { type Doc } from "@livequery/core";
+import { type Doc } from "@livequery/client";
 export declare const useDocument: <T extends Doc>(ref: string | undefined | "" | null | false, options?: {
     lazy?: boolean;
-}) => readonly [import("@livequery/core").LivequeryDocument<import("@livequery/core").DocState<T>> | undefined, import("@livequery/core").LivequeryLoadingState];
+}) => readonly [import("@livequery/client").LivequeryDocument<import("@livequery/client").DocState<T>> | undefined, import("@livequery/client").LivequeryLoadingState];
 //# sourceMappingURL=useDocument.d.ts.map

package/dist/useDocument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDocument.d.ts","sourceRoot":"","sources":["../src/useDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAK1C,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,MAAM,GAAG,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,EAAE,UAAS;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,+JAKvH,CAAA"}
+{"version":3,"file":"useDocument.d.ts","sourceRoot":"","sources":["../src/useDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAK5C,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,MAAM,GAAG,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,EAAE,UAAS;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,qKAKvH,CAAA"}

package/dist/useDocument.js

@@ -1,4 +1,4 @@
-import {} from "@livequery/core";
+import {} from "@livequery/client";
 import { useObservable } from "./useObservable.js";
 import { useCollection } from "./useCollection.js";
 export const useDocument = (ref, options = {}) => {

package/dist/useDocument.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDocument.js","sourceRoot":"","sources":["../src/useDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAgB,GAA2C,EAAE,UAA8B,EAAE,EAAE,EAAE;IACxH,MAAM,UAAU,GAAG,aAAa,CAAI,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAChE,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACjD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAU,CAAA;AACvC,CAAC,CAAA"}
+{"version":3,"file":"useDocument.js","sourceRoot":"","sources":["../src/useDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAgB,GAA2C,EAAE,UAA8B,EAAE,EAAE,EAAE;IACxH,MAAM,UAAU,GAAG,aAAa,CAAI,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAChE,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACjD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAU,CAAA;AACvC,CAAC,CAAA"}

package/package.json

@@ -4,7 +4,7 @@
         "url": "https://github.com/livequery/react"
     },
     "type": "module",
-    "version": "2.0.104",
+    "version": "2.0.106",
     "description": "",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -19,10 +19,10 @@
             "import": "./dist/createContextFromHook.js",
             "default": "./dist/createContextFromHook.js"
         },
-        "./LivequeryCoreContext": {
-            "types": "./dist/LivequeryCoreContext.d.ts",
-            "import": "./dist/LivequeryCoreContext.js",
-            "default": "./dist/LivequeryCoreContext.js"
+        "./LivequeryClientContext": {
+            "types": "./dist/LivequeryClientContext.d.ts",
+            "import": "./dist/LivequeryClientContext.js",
+            "default": "./dist/LivequeryClientContext.js"
         },
         "./useAction": {
             "types": "./dist/useAction.d.ts",
@@ -52,7 +52,7 @@
         "@types/react": "^19.2.14"
     },
     "peerDependencies": {
-        "@livequery/core": "^2.0.104",
+        "@livequery/client": "^2.0.106",
         "rxjs": "^7.8.2",
         "react": "^19.2.5"
     },

package/dist/LivequeryCoreContext.d.ts

@@ -1,5 +0,0 @@
-import type { LivequeryCore } from "@livequery/core";
-export declare const useLivequeryCore: () => LivequeryCore, LivequeryCoreProvider: (props: import("react").PropsWithChildren<{
-    core: any;
-}>) => import("react").JSX.Element;
-//# sourceMappingURL=LivequeryCoreContext.d.ts.map

package/dist/LivequeryCoreContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LivequeryCoreContext.d.ts","sourceRoot":"","sources":["../src/LivequeryCoreContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,eAAO,MAAO,gBAAgB,uBAAE,qBAAqB;UACjC,GAAG;kCACtB,CAAA"}

package/dist/LivequeryCoreContext.js

@@ -1,3 +0,0 @@
-import { createContextFromHook } from "./createContextFromHook.js";
-export const [useLivequeryCore, LivequeryCoreProvider] = createContextFromHook((props) => props.core);
-//# sourceMappingURL=LivequeryCoreContext.js.map

package/dist/LivequeryCoreContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LivequeryCoreContext.js","sourceRoot":"","sources":["../src/LivequeryCoreContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,GAAG,qBAAqB,CAC1E,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAqB,CACxD,CAAA"}