anchordb-react 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AnchorDB contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# anchordb-react
+
+React and React Native hooks for [AnchorDB](https://www.npmjs.com/package/anchordb).
+
+```bash
+npm install anchordb-react
+```
+
+```tsx
+import { useFind, useSyncStatus } from "anchordb-react";
+
+function Users({ db, User }) {
+  const { data, loading, refresh } = useFind(db, User, { age: { $gte: 18 } }, { sort: "-createdAt" });
+  const { status, pending, sync } = useSyncStatus(db);
+
+  if (loading) return <Spinner />;
+  return (
+    <>
+      <StatusBar status={status} pending={pending} onSync={sync} />
+      <FlatList data={data} onRefresh={refresh} />
+    </>
+  );
+}
+```
+
+## Hooks
+
+| Hook | Purpose |
+| --- | --- |
+| `useFind` | live list query; re-runs on every matching change |
+| `useFindOne` | live single document |
+| `useCount` | live count, without fetching documents |
+| `useAggregate` | live aggregation pipeline |
+| `useSyncStatus` | status, pending count and a `sync()` trigger |
+| `useAnchorEvent` | subscribe to any AnchorDB event |
+
+All are built on the same `observeQuery` primitive as the Angular bindings and the inspector's push
+events, so a change visible to one is visible to all three.
+
+## Two things worth knowing
+
+**Filters are keyed on serialised content, not object identity.** Writing
+`useFind(db, User, { age: { $gte: 18 } })` creates a fresh object every render; depending on
+identity would resubscribe on each render and loop forever.
+
+**`useSyncStatus` works in local-only mode**, reporting `"disabled"` with zero pending — so a status
+indicator can be rendered unconditionally instead of every screen branching on whether sync exists.
+
+## Status
+
+**0.1.0.** React is a peer dependency (>=18). MIT.

package/dist/cjs/index.d.ts

@@ -0,0 +1,61 @@
+import { type AnchorDB, type Filter, type ModelConstructor, type SyncStatus } from "anchordb";
+/**
+ * React and React Native bindings.
+ *
+ * Built on the same `observeQuery` primitive as the Angular bindings and the inspector's push
+ * events, so all three see exactly the same changes. A hook that could miss an update the
+ * equivalent observable caught would be a source of bugs nobody could reproduce.
+ */
+export interface QueryState<T> {
+    data: T | undefined;
+    loading: boolean;
+    error: unknown;
+    /** Re-run immediately, e.g. from a pull-to-refresh. */
+    refresh: () => void;
+}
+export interface UseFindOptions {
+    sort?: unknown;
+    skip?: number;
+    limit?: number;
+    select?: string | Record<string, 0 | 1>;
+    populate?: string | string[];
+    lean?: boolean;
+    debounceMs?: number;
+    /** Skip the query entirely — for dependent queries that are not ready yet. */
+    enabled?: boolean;
+}
+/** Live list query. Re-runs whenever the collection changes. */
+export declare function useFind<T extends Record<string, unknown>>(db: AnchorDB, model: ModelConstructor<T>, filter?: Filter, options?: UseFindOptions): QueryState<T[]>;
+/** Live single-document query. */
+export declare function useFindOne<T extends Record<string, unknown>>(db: AnchorDB, model: ModelConstructor<T>, filter?: Filter, options?: UseFindOptions): QueryState<T | null>;
+/** Live document count — cheaper than fetching documents just to count them. */
+export declare function useCount<T extends Record<string, unknown>>(db: AnchorDB, model: ModelConstructor<T>, filter?: Filter, options?: {
+    debounceMs?: number;
+}): QueryState<number>;
+/** Live aggregation. */
+export declare function useAggregate<R = Record<string, unknown>>(db: AnchorDB, model: ModelConstructor, pipeline: unknown[], options?: {
+    debounceMs?: number;
+    enabled?: boolean;
+}): QueryState<R[]>;
+export interface SyncState {
+    status: SyncStatus;
+    pending: number;
+    enabled: boolean;
+    sync: () => Promise<void>;
+}
+/**
+ * Live sync status.
+ *
+ * Works in local-only mode too, reporting `"disabled"` with zero pending — so a status indicator
+ * can be rendered unconditionally instead of every screen branching on whether sync exists.
+ */
+export declare function useSyncStatus(db: AnchorDB): SyncState;
+/** Subscribe to any AnchorDB event from a component. */
+export declare function useAnchorEvent<K extends Parameters<AnchorDB["on"]>[0]>(db: AnchorDB, event: K, handler: (payload: unknown) => void): void;
+/**
+ * Snapshot of connection state, via `useSyncExternalStore` so it is concurrent-safe and never
+ * tears between renders.
+ */
+export declare function useAnchorReady(db: AnchorDB): boolean;
+export type { AnchorDB, ModelConstructor };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

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

package/dist/cjs/index.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFind = useFind;
+exports.useFindOne = useFindOne;
+exports.useCount = useCount;
+exports.useAggregate = useAggregate;
+exports.useSyncStatus = useSyncStatus;
+exports.useAnchorEvent = useAnchorEvent;
+exports.useAnchorReady = useAnchorReady;
+const react_1 = require("react");
+const anchordb_1 = require("anchordb");
+/**
+ * Stable key for a filter/options object.
+ *
+ * Callers naturally write `useFind(User, { age: { $gte: 18 } })`, creating a fresh object on every
+ * render. Depending on the object identity would resubscribe on each render and loop forever, so
+ * dependencies are keyed on serialised content instead.
+ */
+function useStableKey(value) {
+    return (0, react_1.useMemo)(() => JSON.stringify(value ?? null), [value]);
+}
+/** Live list query. Re-runs whenever the collection changes. */
+function useFind(db, model, filter = {}, options = {}) {
+    const filterKey = useStableKey(filter);
+    const optionsKey = useStableKey({ ...options, enabled: undefined, debounceMs: undefined });
+    const [state, setState] = (0, react_1.useState)({
+        data: undefined,
+        loading: options.enabled !== false,
+        error: undefined,
+    });
+    const [nonce, setNonce] = (0, react_1.useState)(0);
+    (0, react_1.useEffect)(() => {
+        if (options.enabled === false) {
+            setState({ data: undefined, loading: false, error: undefined });
+            return;
+        }
+        setState((s) => ({ ...s, loading: true }));
+        const subscription = (0, anchordb_1.observeQuery)(db, model.collectionName, async () => {
+            const query = model.find(JSON.parse(filterKey));
+            if (options.sort)
+                query.sort(options.sort);
+            if (options.skip !== undefined)
+                query.skip(options.skip);
+            if (options.limit !== undefined)
+                query.limit(options.limit);
+            if (options.select)
+                query.select(options.select);
+            if (options.populate)
+                query.populate(options.populate);
+            if (options.lean)
+                query.lean();
+            return (await query.exec());
+        }, {
+            next: (data) => setState({ data, loading: false, error: undefined }),
+            error: (error) => setState((s) => ({ ...s, loading: false, error })),
+        }, options.debounceMs !== undefined ? { debounceMs: options.debounceMs } : {});
+        return () => subscription.unsubscribe();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [db, model, filterKey, optionsKey, options.enabled, options.debounceMs, nonce]);
+    const refresh = (0, react_1.useCallback)(() => setNonce((n) => n + 1), []);
+    return { ...state, refresh };
+}
+/** Live single-document query. */
+function useFindOne(db, model, filter = {}, options = {}) {
+    const result = useFind(db, model, filter, { ...options, limit: 1 });
+    return (0, react_1.useMemo)(() => ({
+        data: result.data === undefined ? undefined : (result.data[0] ?? null),
+        loading: result.loading,
+        error: result.error,
+        refresh: result.refresh,
+    }), [result.data, result.loading, result.error, result.refresh]);
+}
+/** Live document count — cheaper than fetching documents just to count them. */
+function useCount(db, model, filter = {}, options = {}) {
+    const filterKey = useStableKey(filter);
+    const [state, setState] = (0, react_1.useState)({
+        data: undefined,
+        loading: true,
+        error: undefined,
+    });
+    const [nonce, setNonce] = (0, react_1.useState)(0);
+    (0, react_1.useEffect)(() => {
+        const subscription = (0, anchordb_1.observeQuery)(db, model.collectionName, () => model.countDocuments(JSON.parse(filterKey)), {
+            next: (data) => setState({ data, loading: false, error: undefined }),
+            error: (error) => setState((s) => ({ ...s, loading: false, error })),
+        }, options.debounceMs !== undefined ? { debounceMs: options.debounceMs } : {});
+        return () => subscription.unsubscribe();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [db, model, filterKey, options.debounceMs, nonce]);
+    return { ...state, refresh: (0, react_1.useCallback)(() => setNonce((n) => n + 1), []) };
+}
+/** Live aggregation. */
+function useAggregate(db, model, pipeline, options = {}) {
+    const pipelineKey = useStableKey(pipeline);
+    const [state, setState] = (0, react_1.useState)({
+        data: undefined,
+        loading: options.enabled !== false,
+        error: undefined,
+    });
+    const [nonce, setNonce] = (0, react_1.useState)(0);
+    (0, react_1.useEffect)(() => {
+        if (options.enabled === false)
+            return;
+        const subscription = (0, anchordb_1.observeQuery)(db, model.collectionName, () => model.aggregate(JSON.parse(pipelineKey)), {
+            next: (data) => setState({ data, loading: false, error: undefined }),
+            error: (error) => setState((s) => ({ ...s, loading: false, error })),
+        }, options.debounceMs !== undefined ? { debounceMs: options.debounceMs } : {});
+        return () => subscription.unsubscribe();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [db, model, pipelineKey, options.enabled, options.debounceMs, nonce]);
+    return { ...state, refresh: (0, react_1.useCallback)(() => setNonce((n) => n + 1), []) };
+}
+/**
+ * Live sync status.
+ *
+ * Works in local-only mode too, reporting `"disabled"` with zero pending — so a status indicator
+ * can be rendered unconditionally instead of every screen branching on whether sync exists.
+ */
+function useSyncStatus(db) {
+    const [state, setState] = (0, react_1.useState)({
+        status: db.sync.status(),
+        pending: 0,
+    });
+    (0, react_1.useEffect)(() => {
+        const subscription = (0, anchordb_1.observeSyncStatus)(db, {
+            next: (value) => setState({ status: value.status, pending: value.pending }),
+        });
+        return () => subscription.unsubscribe();
+    }, [db]);
+    const sync = (0, react_1.useCallback)(async () => {
+        await db.sync.now();
+    }, [db]);
+    return { ...state, enabled: db.syncEnabled, sync };
+}
+/** Subscribe to any AnchorDB event from a component. */
+function useAnchorEvent(db, event, handler) {
+    const ref = (0, react_1.useRef)(handler);
+    ref.current = handler;
+    (0, react_1.useEffect)(() => db.on(event, (payload) => ref.current(payload)), [db, event]);
+}
+/**
+ * Snapshot of connection state, via `useSyncExternalStore` so it is concurrent-safe and never
+ * tears between renders.
+ */
+function useAnchorReady(db) {
+    const subscribe = (0, react_1.useCallback)((onChange) => {
+        let cancelled = false;
+        void db.open().then(() => {
+            if (!cancelled)
+                onChange();
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [db]);
+    const ready = (0, react_1.useRef)(false);
+    return (0, react_1.useSyncExternalStore)(subscribe, () => {
+        if (!ready.current) {
+            void db.open().then(() => {
+                ready.current = true;
+            });
+        }
+        return ready.current;
+    }, () => false);
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,61 @@
+import { type AnchorDB, type Filter, type ModelConstructor, type SyncStatus } from "anchordb";
+/**
+ * React and React Native bindings.
+ *
+ * Built on the same `observeQuery` primitive as the Angular bindings and the inspector's push
+ * events, so all three see exactly the same changes. A hook that could miss an update the
+ * equivalent observable caught would be a source of bugs nobody could reproduce.
+ */
+export interface QueryState<T> {
+    data: T | undefined;
+    loading: boolean;
+    error: unknown;
+    /** Re-run immediately, e.g. from a pull-to-refresh. */
+    refresh: () => void;
+}
+export interface UseFindOptions {
+    sort?: unknown;
+    skip?: number;
+    limit?: number;
+    select?: string | Record<string, 0 | 1>;
+    populate?: string | string[];
+    lean?: boolean;
+    debounceMs?: number;
+    /** Skip the query entirely — for dependent queries that are not ready yet. */
+    enabled?: boolean;
+}
+/** Live list query. Re-runs whenever the collection changes. */
+export declare function useFind<T extends Record<string, unknown>>(db: AnchorDB, model: ModelConstructor<T>, filter?: Filter, options?: UseFindOptions): QueryState<T[]>;
+/** Live single-document query. */
+export declare function useFindOne<T extends Record<string, unknown>>(db: AnchorDB, model: ModelConstructor<T>, filter?: Filter, options?: UseFindOptions): QueryState<T | null>;
+/** Live document count — cheaper than fetching documents just to count them. */
+export declare function useCount<T extends Record<string, unknown>>(db: AnchorDB, model: ModelConstructor<T>, filter?: Filter, options?: {
+    debounceMs?: number;
+}): QueryState<number>;
+/** Live aggregation. */
+export declare function useAggregate<R = Record<string, unknown>>(db: AnchorDB, model: ModelConstructor, pipeline: unknown[], options?: {
+    debounceMs?: number;
+    enabled?: boolean;
+}): QueryState<R[]>;
+export interface SyncState {
+    status: SyncStatus;
+    pending: number;
+    enabled: boolean;
+    sync: () => Promise<void>;
+}
+/**
+ * Live sync status.
+ *
+ * Works in local-only mode too, reporting `"disabled"` with zero pending — so a status indicator
+ * can be rendered unconditionally instead of every screen branching on whether sync exists.
+ */
+export declare function useSyncStatus(db: AnchorDB): SyncState;
+/** Subscribe to any AnchorDB event from a component. */
+export declare function useAnchorEvent<K extends Parameters<AnchorDB["on"]>[0]>(db: AnchorDB, event: K, handler: (payload: unknown) => void): void;
+/**
+ * Snapshot of connection state, via `useSyncExternalStore` so it is concurrent-safe and never
+ * tears between renders.
+ */
+export declare function useAnchorReady(db: AnchorDB): boolean;
+export type { AnchorDB, ModelConstructor };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

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

package/dist/esm/index.js

@@ -0,0 +1,157 @@
+import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { observeQuery, observeSyncStatus, } from "anchordb";
+/**
+ * Stable key for a filter/options object.
+ *
+ * Callers naturally write `useFind(User, { age: { $gte: 18 } })`, creating a fresh object on every
+ * render. Depending on the object identity would resubscribe on each render and loop forever, so
+ * dependencies are keyed on serialised content instead.
+ */
+function useStableKey(value) {
+    return useMemo(() => JSON.stringify(value ?? null), [value]);
+}
+/** Live list query. Re-runs whenever the collection changes. */
+export function useFind(db, model, filter = {}, options = {}) {
+    const filterKey = useStableKey(filter);
+    const optionsKey = useStableKey({ ...options, enabled: undefined, debounceMs: undefined });
+    const [state, setState] = useState({
+        data: undefined,
+        loading: options.enabled !== false,
+        error: undefined,
+    });
+    const [nonce, setNonce] = useState(0);
+    useEffect(() => {
+        if (options.enabled === false) {
+            setState({ data: undefined, loading: false, error: undefined });
+            return;
+        }
+        setState((s) => ({ ...s, loading: true }));
+        const subscription = observeQuery(db, model.collectionName, async () => {
+            const query = model.find(JSON.parse(filterKey));
+            if (options.sort)
+                query.sort(options.sort);
+            if (options.skip !== undefined)
+                query.skip(options.skip);
+            if (options.limit !== undefined)
+                query.limit(options.limit);
+            if (options.select)
+                query.select(options.select);
+            if (options.populate)
+                query.populate(options.populate);
+            if (options.lean)
+                query.lean();
+            return (await query.exec());
+        }, {
+            next: (data) => setState({ data, loading: false, error: undefined }),
+            error: (error) => setState((s) => ({ ...s, loading: false, error })),
+        }, options.debounceMs !== undefined ? { debounceMs: options.debounceMs } : {});
+        return () => subscription.unsubscribe();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [db, model, filterKey, optionsKey, options.enabled, options.debounceMs, nonce]);
+    const refresh = useCallback(() => setNonce((n) => n + 1), []);
+    return { ...state, refresh };
+}
+/** Live single-document query. */
+export function useFindOne(db, model, filter = {}, options = {}) {
+    const result = useFind(db, model, filter, { ...options, limit: 1 });
+    return useMemo(() => ({
+        data: result.data === undefined ? undefined : (result.data[0] ?? null),
+        loading: result.loading,
+        error: result.error,
+        refresh: result.refresh,
+    }), [result.data, result.loading, result.error, result.refresh]);
+}
+/** Live document count — cheaper than fetching documents just to count them. */
+export function useCount(db, model, filter = {}, options = {}) {
+    const filterKey = useStableKey(filter);
+    const [state, setState] = useState({
+        data: undefined,
+        loading: true,
+        error: undefined,
+    });
+    const [nonce, setNonce] = useState(0);
+    useEffect(() => {
+        const subscription = observeQuery(db, model.collectionName, () => model.countDocuments(JSON.parse(filterKey)), {
+            next: (data) => setState({ data, loading: false, error: undefined }),
+            error: (error) => setState((s) => ({ ...s, loading: false, error })),
+        }, options.debounceMs !== undefined ? { debounceMs: options.debounceMs } : {});
+        return () => subscription.unsubscribe();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [db, model, filterKey, options.debounceMs, nonce]);
+    return { ...state, refresh: useCallback(() => setNonce((n) => n + 1), []) };
+}
+/** Live aggregation. */
+export function useAggregate(db, model, pipeline, options = {}) {
+    const pipelineKey = useStableKey(pipeline);
+    const [state, setState] = useState({
+        data: undefined,
+        loading: options.enabled !== false,
+        error: undefined,
+    });
+    const [nonce, setNonce] = useState(0);
+    useEffect(() => {
+        if (options.enabled === false)
+            return;
+        const subscription = observeQuery(db, model.collectionName, () => model.aggregate(JSON.parse(pipelineKey)), {
+            next: (data) => setState({ data, loading: false, error: undefined }),
+            error: (error) => setState((s) => ({ ...s, loading: false, error })),
+        }, options.debounceMs !== undefined ? { debounceMs: options.debounceMs } : {});
+        return () => subscription.unsubscribe();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [db, model, pipelineKey, options.enabled, options.debounceMs, nonce]);
+    return { ...state, refresh: useCallback(() => setNonce((n) => n + 1), []) };
+}
+/**
+ * Live sync status.
+ *
+ * Works in local-only mode too, reporting `"disabled"` with zero pending — so a status indicator
+ * can be rendered unconditionally instead of every screen branching on whether sync exists.
+ */
+export function useSyncStatus(db) {
+    const [state, setState] = useState({
+        status: db.sync.status(),
+        pending: 0,
+    });
+    useEffect(() => {
+        const subscription = observeSyncStatus(db, {
+            next: (value) => setState({ status: value.status, pending: value.pending }),
+        });
+        return () => subscription.unsubscribe();
+    }, [db]);
+    const sync = useCallback(async () => {
+        await db.sync.now();
+    }, [db]);
+    return { ...state, enabled: db.syncEnabled, sync };
+}
+/** Subscribe to any AnchorDB event from a component. */
+export function useAnchorEvent(db, event, handler) {
+    const ref = useRef(handler);
+    ref.current = handler;
+    useEffect(() => db.on(event, (payload) => ref.current(payload)), [db, event]);
+}
+/**
+ * Snapshot of connection state, via `useSyncExternalStore` so it is concurrent-safe and never
+ * tears between renders.
+ */
+export function useAnchorReady(db) {
+    const subscribe = useCallback((onChange) => {
+        let cancelled = false;
+        void db.open().then(() => {
+            if (!cancelled)
+                onChange();
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [db]);
+    const ready = useRef(false);
+    return useSyncExternalStore(subscribe, () => {
+        if (!ready.current) {
+            void db.open().then(() => {
+                ready.current = true;
+            });
+        }
+        return ready.current;
+    }, () => false);
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAChG,OAAO,EACL,YAAY,EACZ,iBAAiB,GAKlB,MAAM,UAAU,CAAC;AAkBlB;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC;AAcD,gEAAgE;AAChE,MAAM,UAAU,OAAO,CACrB,EAAY,EACZ,KAA0B,EAC1B,SAAiB,EAAE,EACnB,UAA0B,EAAE;IAE5B,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3F,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA8D;QAC9F,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,KAAK;QAClC,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC9B,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAEzD,MAAM,YAAY,GAAG,YAAY,CAC/B,EAAE,EACF,KAAK,CAAC,cAAc,EACpB,KAAK,IAAI,EAAE;YACT,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAW,CAAC,CAAC;YAC1D,IAAI,OAAO,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAa,CAAC,CAAC;YACpD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5D,IAAI,OAAO,CAAC,MAAM;gBAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAe,CAAC,CAAC;YAC1D,IAAI,OAAO,CAAC,QAAQ;gBAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAiB,CAAC,CAAC;YAChE,IAAI,OAAO,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC/B,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAQ,CAAC;QACrC,CAAC,EACD;YACE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACpE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;SACnF,EACD,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAC3E,CAAC;QAEF,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QACxC,uDAAuD;IACzD,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnF,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,UAAU,CACxB,EAAY,EACZ,KAA0B,EAC1B,SAAiB,EAAE,EACnB,UAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,OAAO,CAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACvE,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACtE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,EACF,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CACtB,EAAY,EACZ,KAA0B,EAC1B,SAAiB,EAAE,EACnB,UAAmC,EAAE;IAErC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAiE;QACjG,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,YAAY,CAC/B,EAAE,EACF,KAAK,CAAC,cAAc,EACpB,GAAG,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAW,CAAC,EAC3D;YACE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACpE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;SACnF,EACD,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAC3E,CAAC;QACF,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QACxC,uDAAuD;IACzD,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAEtD,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,YAAY,CAC1B,EAAY,EACZ,KAAuB,EACvB,QAAmB,EACnB,UAAsD,EAAE;IAExD,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA8D;QAC9F,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,KAAK;QAClC,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;YAAE,OAAO;QACtC,MAAM,YAAY,GAAG,YAAY,CAC/B,EAAE,EACF,KAAK,CAAC,cAAc,EACpB,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAU,CAAC,EAC1D;YACE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACpE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;SACnF,EACD,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAC3E,CAAC;QACF,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QACxC,uDAAuD;IACzD,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAEzE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACtF,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,EAAY;IACxC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA0C;QAC1E,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,iBAAiB,CAAC,EAAE,EAAE;YACzC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAoB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SAC1F,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAET,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAET,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAC5B,EAAY,EACZ,KAAQ,EACR,OAAmC;IAEnC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAY;IACzC,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,QAAoB,EAAE,EAAE;QACvB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YACvB,IAAI,CAAC,SAAS;gBAAE,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EACD,CAAC,EAAE,CAAC,CACL,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,oBAAoB,CACzB,SAAS,EACT,GAAG,EAAE;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBACvB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC,EACD,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;AACJ,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "anchordb-react",
+  "version": "0.2.0",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.build.json && tsc -p tsconfig.build.cjs.json && node ../core/scripts/finalize-dist.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "check:package": "publint && attw --pack . --profile node16",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "dependencies": {
+    "anchordb": "^0.2.0"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "React and React Native hooks for AnchorDB.",
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/knnadeera/anchordb.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/knnadeera/anchordb#readme",
+  "bugs": {
+    "url": "https://github.com/knnadeera/anchordb/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "author": "Nisala Nadeera <knnadeera@gmail.com>"
+}