@livequery/react 2.0.30 → 2.0.92

package/dist/useCollection.d.ts

@@ -0,0 +1,23 @@
+import { LivequeryCollection, LivequeryCore, type Doc, type LivequeryCollectionOptions } from "@livequery/core";
+/**
+ * Returns the `LivequeryCore` instance from the nearest provider.
+ */
+export declare const useLivequeryCore: () => LivequeryCore;
+/**
+ * Provides a `LivequeryCore` instance to all descendants that use this package's hooks.
+ */
+export declare const LivequeryCoreProvider: import("react").FC<import("react").PropsWithChildren<{
+    core: LivequeryCore;
+}>>;
+/**
+ * Creates and initializes a `LivequeryCollection` for the supplied collection path.
+ *
+ * The collection instance is stable for the lifetime of the component. Initialization is
+ * skipped when `ref` is falsy.
+ *
+ * @param ref Collection path understood by `@livequery/core`.
+ * @param options Collection options forwarded to `LivequeryCollection`.
+ * @returns A stable `LivequeryCollection` instance.
+ */
+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

@@ -0,0 +1 @@
+{"version":3,"file":"useCollection.d.ts","sourceRoot":"","sources":["../src/useCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,KAAK,GAAG,EAAE,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAQ/G;;GAEG;AACH,eAAO,MAAM,gBAAgB,qBAA0B,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,qBAAqB;UAXd,aAAa;GAW2B,CAAA;AAE5D;;;;;;;;;GASG;AACH,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,2BAY7I,CAAA"}

package/dist/useDocument.d.ts

@@ -0,0 +1,15 @@
+import { type Doc } from "@livequery/core";
+/**
+ * Subscribes to a single document path and returns the first emitted item with loading state.
+ *
+ * Internally this hook creates a `LivequeryCollection`, initializes it with the document ref,
+ * then reads the first item from the collection stream.
+ *
+ * @param ref Document path understood by `@livequery/core`.
+ * @param options Collection options used when creating the backing collection.
+ * @returns A tuple of `[document, loading]`.
+ */
+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];
+//# sourceMappingURL=useDocument.d.ts.map

package/dist/useDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocument.d.ts","sourceRoot":"","sources":["../src/useDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAK/D;;;;;;;;;GASG;AACH,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,+JAqBvH,CAAA"}

package/dist/useGlobalValue.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolves a process-wide singleton value stored on `globalThis`.
+ *
+ * The resolver runs only the first time a given key is requested in the current runtime.
+ * Later calls with the same key return the cached value.
+ *
+ * @param key Unique key within the package global registry.
+ * @param resolver Lazy factory used when the value does not exist yet.
+ * @returns The cached or newly created value.
+ */
+export declare const useGlobalValue: <T>(key: string, resolver: () => T) => T;
+//# sourceMappingURL=useGlobalValue.d.ts.map

package/dist/useGlobalValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalValue.d.ts","sourceRoot":"","sources":["../src/useGlobalValue.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAU,MAAM,CAAC,KAIzB,CACtC,CAAA"}

package/dist/useObservable.d.ts

@@ -0,0 +1,17 @@
+import { Observable, BehaviorSubject } from "rxjs";
+/**
+ * Accepts either a value or a lazy factory returning that value.
+ */
+export type MaybeFunction<T> = T | (() => T);
+/**
+ * Subscribes to an RxJS observable and mirrors its latest value into React state.
+ *
+ * When a `BehaviorSubject` is provided, the hook uses `getValue()` for the initial render.
+ * When a factory is provided, the observable is resolved lazily inside the effect.
+ *
+ * @param o Observable source or factory returning the source.
+ * @param default_value Fallback value used before the first emission when the source is not a `BehaviorSubject`.
+ * @returns The latest value emitted by the source.
+ */
+export declare const useObservable: <T extends any>(o: MaybeFunction<BehaviorSubject<T> | Observable<T>>, default_value?: T) => T;
+//# sourceMappingURL=useObservable.d.ts.map

package/dist/useObservable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObservable.d.ts","sourceRoot":"","sources":["../src/useObservable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAc,MAAM,MAAM,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAE5C;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,EAAE,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,MAgBnH,CAAA"}

package/package.json

@@ -4,38 +4,38 @@
         "url": "https://github.com/livequery/react"
     },
     "type": "module",
-    "version": "2.0.30",
+    "version": "2.0.92",
     "description": "",
-    "main": "build/index.js",
-    "types": "build/index.d.ts",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
     "files": [
-        "build/**/*"
+        "dist/**/*"
     ],
     "dependencies": {
-        "@livequery/client": "^2.0.30",
-        "rxjs": "^7.8.1"
+        "@livequery/core": "^2.0.92",
+        "rxjs": "^7.8.2"
     },
     "devDependencies": {
-        "@livequery/types": "^2.0.22",
-        "@types/react": "^17.0.11",
-        "typescript": "5.6.3"
+        "@types/react": "^19.2.14"
     },
     "peerDependencies": {
-        "react": "^18.3.1"
+        "react": "^19.2.5"
     },
     "scripts": {
-        "test": "echo \"Error: no test specified\" && exit 1",
-        "build": "rm -rf build; tsc -b .",
-        "deploy": "yarn build; git add .; git commit -m \"Update\"; git push origin master; npm publish --access public"
+        "clean": "rm -rf dist",
+        "build:js": "bun build ./src/index.ts --outdir ./dist --target browser --format esm --sourcemap",
+        "build:types": "bunx tsc -p tsconfig.build.json",
+        "build": "bun run clean && bun run build:js && bun run build:types",
+        "build:watch": "bun build ./src/index.ts --outdir ./dist --target browser --format esm --watch",
+        "prepublishOnly": "bun run build"
     },
     "author": "",
-    "license": "ISC",
-    "exports": {
-        ".": {
-            "import": {
-                "types": "./build/index.d.ts",
-                "default": "./build/index.js"
-            }
-        }
-    }
+    "license": "ISC"
 }

package/build/LiveQueryContext.d.ts

@@ -1,11 +0,0 @@
-import React, { PropsWithChildren } from 'react';
-import { Transporter, TransporterHook } from '@livequery/types';
-export type LivequeryContext = {
-    transporter?: Transporter;
-    hooks?: TransporterHook[];
-};
-export declare function mergeTransporterHooks(...hooks: TransporterHook[]): TransporterHook;
-export declare const useLivequeryContext: () => {
-    transporter: Transporter;
-};
-export declare const LiveQueryContextProvider: (props: PropsWithChildren<LivequeryContext>) => React.JSX.Element;

package/build/LiveQueryContext.js

@@ -1,22 +0,0 @@
-"use client";
-import React from 'react';
-import { createContext, useContext } from "react";
-import { pipe } from 'rxjs';
-export function mergeTransporterHooks(...hooks) {
-    return hooks.reduce((p, c) => (next) => p(() => c(next)), (next) => pipe(next()));
-}
-const LivequeryContext = createContext({});
-export const useLivequeryContext = () => {
-    const ctx = useContext(LivequeryContext);
-    if (!ctx.transporter && typeof window != 'undefined')
-        throw 'MISSING_LIVEQUERY_TRANSPORTER';
-    return {
-        transporter: ctx.transporter
-    };
-};
-export const LiveQueryContextProvider = (props) => {
-    const ctx = useContext(LivequeryContext);
-    const merged = mergeTransporterHooks(...props.hooks || []);
-    const transporter = ctx.transporter ? ctx.transporter.hook(merged) : props.transporter?.hook(merged);
-    return (React.createElement(LivequeryContext.Provider, { value: { transporter } }, props.children));
-};

package/build/hooks/createContextFromHook.d.ts

@@ -1,2 +0,0 @@
-import React, { PropsWithChildren } from 'react';
-export declare const createContextFromHook: <T, K>(fn: ((props: T) => K) | (() => K)) => [() => K, ({ children, ...props }: PropsWithChildren<T>) => React.JSX.Element];

package/build/hooks/createContextFromHook.js

@@ -1,12 +0,0 @@
-"use client";
-import React from 'react';
-import { createContext, useContext } from "react";
-export const createContextFromHook = (fn) => {
-    const context = createContext({});
-    const getContext = () => useContext(context);
-    const Provider = ({ children, ...props }) => {
-        const value = fn(props);
-        return (React.createElement(context.Provider, { value: value }, children));
-    };
-    return [getContext, Provider];
-};

package/build/hooks/createStaticContext.d.ts

@@ -1,3 +0,0 @@
-export declare const createStaticContext: <T extends {}>() => [() => T, ({ children, ...props }: import("react").PropsWithChildren<{
-    value: T;
-}>) => import("react").JSX.Element];

package/build/hooks/createStaticContext.js

@@ -1,3 +0,0 @@
-"use client";
-import { createContextFromHook } from './createContextFromHook.js';
-export const createStaticContext = () => createContextFromHook((props) => props.value);

package/build/index.d.ts

@@ -1,6 +0,0 @@
-export * from "./useDocumentData.js";
-export * from './useCollectionData.js';
-export * from './useMonitor.js';
-export * from "./LiveQueryContext.js";
-export * from './hooks/createContextFromHook.js';
-export * from './hooks/createStaticContext.js';

package/build/index.js

@@ -1,6 +0,0 @@
-export * from "./useDocumentData.js";
-export * from './useCollectionData.js';
-export * from './useMonitor.js';
-export * from "./LiveQueryContext.js";
-export * from './hooks/createContextFromHook.js';
-export * from './hooks/createStaticContext.js';

package/build/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["../src/index.ts","../src/livequerycontext.tsx","../src/usecollectiondata.ts","../src/usedocumentdata.ts","../src/usemonitor.ts","../src/hooks/createcontextfromhook.tsx","../src/hooks/createstaticcontext.tsx"],"version":"5.6.3"}

package/build/useCollectionData.d.ts

@@ -1,21 +0,0 @@
-import { LivequeryBaseEntity, QueryOption } from "@livequery/types";
-import { CollectionObservable, CollectionOption, CollectionStream } from "@livequery/client";
-export type useCollectionDataOptions<T extends LivequeryBaseEntity = LivequeryBaseEntity> = CollectionOption<T> & {
-    lazy?: boolean;
-    options: Partial<QueryOption<T>>;
-    load_all: boolean;
-};
-export type CollectionRef = string | undefined | '' | null | false;
-export type CollectionData<T extends LivequeryBaseEntity> = (CollectionStream<T> & Pick<CollectionObservable<T>, 'add' | 'fetch_more' | 'fetch_prev' | 'reset' | 'trigger' | 'update' | '$changes' | 'filter'> & {
-    empty: boolean;
-    ref: CollectionRef;
-    filters: CollectionStream<T>['options'];
-});
-export declare const CollectionMap: Map<string, CollectionData<any>>;
-export declare const useCollectionData: <T extends LivequeryBaseEntity>(ref: CollectionRef, collection_options?: Partial<useCollectionDataOptions<T>>) => CollectionStream<T> & Pick<CollectionObservable<T>, "add" | "reset" | "filter" | "update" | "fetch_more" | "fetch_prev" | "trigger" | "$changes"> & {
-    empty: boolean;
-    ref: CollectionRef;
-    filters: Partial<QueryOption<T>>;
-} & {
-    state: number;
-};

package/build/useCollectionData.js

@@ -1,59 +0,0 @@
-"use client";
-import { useEffect, useMemo, useState } from "react";
-import { useLivequeryContext } from "./LiveQueryContext.js";
-import { CollectionObservable } from "@livequery/client";
-import { Subject } from 'rxjs';
-function assert(fn, thiss) {
-    return (fn || (() => { })).bind(thiss);
-}
-export const CollectionMap = new Map();
-export const useCollectionData = (ref, collection_options = {}) => {
-    const { transporter } = useLivequeryContext();
-    const client = useMemo(() => new CollectionObservable(ref, {
-        ...collection_options,
-        transporter
-    }), [ref]);
-    const [$, set_$] = useState(client.getValue());
-    const [state, set_state] = useState(0);
-    // Sync stream effect
-    useEffect(() => {
-        if (collection_options.lazy)
-            return;
-        client.fetch_more();
-        const s = client.subscribe(data => {
-            if (collection_options.load_all && data.paging.has?.next) {
-                client.fetch_more();
-            }
-            else {
-                set_$(data);
-                set_state(Date.now());
-            }
-        });
-        return () => {
-            s.unsubscribe();
-        };
-    }, [client, set_$, collection_options.lazy, set_state]);
-    const empty = !!(!$.loading && $.items.length == 0);
-    const loading = $.n == 0 && !collection_options.lazy ? 'both' : $.loading;
-    const result = {
-        ...$,
-        loading,
-        state,
-        empty,
-        filters: $.options,
-        add: assert(client?.add, client),
-        fetch_more: assert(client?.fetch_more, client),
-        fetch_prev: assert(client?.fetch_prev, client),
-        filter: assert(client?.filter, client),
-        reset: assert(client?.reset, client),
-        trigger: assert(client?.trigger, client),
-        update: assert(client?.update, client),
-        $changes: client?.$changes || new Subject(),
-        ref
-    };
-    useEffect(() => {
-        ref && CollectionMap.set(ref, result);
-        return () => { ref && CollectionMap.delete(ref); };
-    }, [client]);
-    return result;
-};

package/build/useDocumentData.d.ts

@@ -1,15 +0,0 @@
-import { useCollectionDataOptions } from "./useCollectionData.js";
-import { LivequeryBaseEntity } from "@livequery/types";
-import { SmartQueryItem } from "@livequery/client";
-export type useDocumentDataOptions<T extends LivequeryBaseEntity = LivequeryBaseEntity> = Partial<Omit<useCollectionDataOptions<T>, 'filters'>>;
-export declare const useDocumentData: <T extends LivequeryBaseEntity>(ref: string | undefined | "" | null | false, config?: useDocumentDataOptions<T>) => {
-    item: SmartQueryItem<T>;
-    error: null;
-    loading: boolean;
-    $changes: import("rxjs").Subject<import("@livequery/types").UpdatedData<T>>;
-} | {
-    item: SmartQueryItem<T>;
-    loading: import("@livequery/client").LoadingIndicator | undefined;
-    error: boolean | undefined;
-    $changes: import("rxjs").Subject<import("@livequery/types").UpdatedData<T>>;
-};

package/build/useDocumentData.js

@@ -1,40 +0,0 @@
-"use client";
-import { useEffect, useState } from "react";
-import { CollectionMap, useCollectionData } from "./useCollectionData.js";
-import { filter, tap } from "rxjs";
-export const useDocumentData = (ref, config = {}) => {
-    const [old, set_old] = useState((() => {
-        if (!ref)
-            return;
-        const id = ref.split('/').pop();
-        const collection_ref = ref.split('/').slice(0, -1).join('/');
-        const collection = CollectionMap.get(collection_ref);
-        if (!collection)
-            return;
-        const item = collection.items.find(item => item.id == id);
-        if (!item)
-            return;
-        return { collection, item };
-    })());
-    useEffect(() => {
-        if (!old || !old.item || !ref)
-            return;
-        const s = old.collection.$changes.pipe(filter(id => id.data.id == old.item.id), tap(d => set_old({ ...old, item: { ...old.item, ...d.data } }))).subscribe();
-        return () => s.unsubscribe();
-    }, [ref]);
-    const { items, loading, error, $changes } = useCollectionData(old ? null : ref, config);
-    if (old && old.item) {
-        return {
-            item: old.item,
-            error: null,
-            loading: false,
-            $changes: old.collection.$changes
-        };
-    }
-    return {
-        item: items[0],
-        loading,
-        error,
-        $changes
-    };
-};

package/build/useMonitor.d.ts

@@ -1,9 +0,0 @@
-type PromiseType<T> = T extends PromiseLike<infer U> ? U : T;
-export declare const useMonitor: <T extends (...args: any) => any>(fn: T) => {
-    excute: T;
-    loading: boolean | undefined;
-    data: PromiseType<ReturnType<T>> | null | undefined;
-    error: any;
-    vaild: boolean;
-};
-export {};

package/build/useMonitor.js

@@ -1,16 +0,0 @@
-"use client";
-import { useState } from "react";
-export const useMonitor = (fn) => {
-    const [{ error, data, loading }, update] = useState({});
-    const excute = (async (...args) => {
-        update({ data: null, loading: true, error: null });
-        try {
-            update({ data: await fn(...args), error: null, loading: false });
-        }
-        catch (error) {
-            update({ data: null, error, loading: false });
-        }
-    });
-    const vaild = !error && !loading;
-    return { excute, loading, data, error, vaild };
-};