@evolu/react 10.4.0 → 11.0.0

package/src/{useIsSsr.ts → local-first/useIsSsr.ts}

@@ -9,7 +9,6 @@ const emptySubscribe = () => () => {};
  *
  * @see https://kurtextrem.de/posts/react-uses-hydration
  */
-export const useIsSsr = (): boolean => {
+export const useIsSsr = (): boolean =>
   // TODO: Consider useDeferredValue(isSSRSync);
-  return useSyncExternalStore(emptySubscribe, constFalse, constTrue);
-};
+  useSyncExternalStore(emptySubscribe, constFalse, constTrue);

package/dist/EvoluContext.d.ts

@@ -1,3 +0,0 @@
-import { Evolu } from "@evolu/common/local-first";
-export declare const EvoluContext: import("react").Context<Evolu<any> | null>;
-//# sourceMappingURL=EvoluContext.d.ts.map

package/dist/EvoluContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EvoluContext.d.ts","sourceRoot":"","sources":["../src/EvoluContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAGlD,eAAO,MAAM,YAAY,4CAAyC,CAAC"}

package/dist/EvoluContext.js

@@ -1,2 +0,0 @@
-import { createContext } from "react";
-export const EvoluContext = createContext(null);

package/dist/EvoluProvider.d.ts

@@ -1,7 +0,0 @@
-import { Evolu } from "@evolu/common/local-first";
-import { ReactNode } from "react";
-export declare const EvoluProvider: ({ children, value, }: {
-    readonly children?: ReactNode | undefined;
-    readonly value: Evolu<any>;
-}) => React.ReactElement;
-//# sourceMappingURL=EvoluProvider.d.ts.map

package/dist/EvoluProvider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EvoluProvider.d.ts","sourceRoot":"","sources":["../src/EvoluProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlC,eAAO,MAAM,aAAa,GAAI,sBAG3B;IACD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CAC5B,KAAG,KAAK,CAAC,YAAqE,CAAC"}

package/dist/EvoluProvider.js

@@ -1,4 +0,0 @@
-"use client";
-import { jsx as _jsx } from "react/jsx-runtime";
-import { EvoluContext } from "./EvoluContext.js";
-export const EvoluProvider = ({ children, value, }) => _jsx(EvoluContext, { value: value, children: children });

package/dist/createUseEvolu.d.ts

@@ -1,13 +0,0 @@
-import { Evolu, EvoluSchema } from "@evolu/common";
-/**
- * Creates a typed React Hook returning an instance of {@link Evolu}.
- *
- * ### Example
- *
- * ```ts
- * const useEvolu = createUseEvolu(evolu);
- * const { insert, update } = useEvolu();
- * ```
- */
-export declare const createUseEvolu: <S extends EvoluSchema>(evolu: Evolu<S>) => (() => Evolu<S>);
-//# sourceMappingURL=createUseEvolu.d.ts.map

package/dist/createUseEvolu.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createUseEvolu.d.ts","sourceRoot":"","sources":["../src/createUseEvolu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,WAAW,EAElD,OAAO,KAAK,CAAC,CAAC,CAAC,KACd,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAA+B,CAAC"}

package/dist/createUseEvolu.js

@@ -1,14 +0,0 @@
-import { useEvolu } from "./useEvolu.js";
-/**
- * Creates a typed React Hook returning an instance of {@link Evolu}.
- *
- * ### Example
- *
- * ```ts
- * const useEvolu = createUseEvolu(evolu);
- * const { insert, update } = useEvolu();
- * ```
- */
-export const createUseEvolu = (
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-evolu) => useEvolu;

package/dist/index.d.ts

@@ -1,11 +0,0 @@
-export * from "./createUseEvolu.js";
-export * from "./EvoluContext.js";
-export * from "./EvoluProvider.js";
-export * from "./useEvolu.js";
-export * from "./useEvoluError.js";
-export * from "./useOwner.js";
-export * from "./useQueries.js";
-export * from "./useQuery.js";
-export * from "./useQuerySubscription.js";
-export * from "./useIsSsr.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAE1C,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -1,11 +0,0 @@
-export * from "./createUseEvolu.js";
-export * from "./EvoluContext.js";
-export * from "./EvoluProvider.js";
-export * from "./useEvolu.js";
-export * from "./useEvoluError.js";
-export * from "./useOwner.js";
-export * from "./useQueries.js";
-export * from "./useQuery.js";
-export * from "./useQuerySubscription.js";
-// export * from "./useSyncState.js"; TODO: Update it for the owner-api
-export * from "./useIsSsr.js";

package/dist/useEvolu.d.ts

@@ -1,9 +0,0 @@
-import { Evolu } from "@evolu/common/local-first";
-/**
- * React Hook returning a generic instance of {@link Evolu}.
- *
- * This is intended for internal usage. Applications should use
- * {@link createUseEvolu}, which provides a correctly typed instance.
- */
-export declare const useEvolu: () => Evolu;
-//# sourceMappingURL=useEvolu.d.ts.map

package/dist/useEvolu.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useEvolu.d.ts","sourceRoot":"","sources":["../src/useEvolu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAKlD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,QAAO,KAQ3B,CAAC"}

package/dist/useEvolu.js

@@ -1,15 +0,0 @@
-import { useContext } from "react";
-import { EvoluContext } from "./EvoluContext.js";
-/**
- * React Hook returning a generic instance of {@link Evolu}.
- *
- * This is intended for internal usage. Applications should use
- * {@link createUseEvolu}, which provides a correctly typed instance.
- */
-export const useEvolu = () => {
-    const evolu = useContext(EvoluContext);
-    if (evolu == null) {
-        throw new Error("Could not find Evolu context value. Ensure the component is wrapped in an <EvoluProvider>.");
-    }
-    return evolu;
-};

package/dist/useEvoluError.d.ts

@@ -1,4 +0,0 @@
-import { EvoluError } from "@evolu/common";
-/** Subscribe to {@link EvoluError} changes. */
-export declare const useEvoluError: () => EvoluError | null;
-//# sourceMappingURL=useEvoluError.d.ts.map

package/dist/useEvoluError.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useEvoluError.d.ts","sourceRoot":"","sources":["../src/useEvoluError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,UAAU,EAAE,MAAM,eAAe,CAAC;AAItD,+CAA+C;AAC/C,eAAO,MAAM,aAAa,QAAO,UAAU,GAAG,IAG7C,CAAC"}

package/dist/useEvoluError.js

@@ -1,8 +0,0 @@
-import { constNull } from "@evolu/common";
-import { useSyncExternalStore } from "react";
-import { useEvolu } from "./useEvolu.js";
-/** Subscribe to {@link EvoluError} changes. */
-export const useEvoluError = () => {
-    const evolu = useEvolu();
-    return useSyncExternalStore(evolu.subscribeError, evolu.getError, constNull);
-};

package/dist/useIsSsr.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useIsSsr.d.ts","sourceRoot":"","sources":["../src/useIsSsr.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAAO,OAG3B,CAAC"}

package/dist/useOwner.d.ts

@@ -1,9 +0,0 @@
-import { SyncOwner } from "@evolu/common";
-/**
- * React Hook for Evolu `useOwner` method.
- *
- * Using an owner means syncing it with its transports, or the transports
- * defined in Evolu config if the owner has no transports defined.
- */
-export declare const useOwner: (owner: SyncOwner | null) => void;
-//# sourceMappingURL=useOwner.d.ts.map

package/dist/useOwner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useOwner.d.ts","sourceRoot":"","sources":["../src/useOwner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI1C;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,GAAG,IAAI,KAAG,IAOlD,CAAC"}

package/dist/useOwner.js

@@ -1,16 +0,0 @@
-import { useEffect } from "react";
-import { useEvolu } from "./useEvolu.js";
-/**
- * React Hook for Evolu `useOwner` method.
- *
- * Using an owner means syncing it with its transports, or the transports
- * defined in Evolu config if the owner has no transports defined.
- */
-export const useOwner = (owner) => {
-    const evolu = useEvolu();
-    useEffect(() => {
-        if (owner == null)
-            return;
-        return evolu.useOwner(owner);
-    }, [evolu, owner]);
-};

package/dist/useQueries.d.ts

@@ -1,13 +0,0 @@
-import { Queries, QueriesToQueryRows, QueriesToQueryRowsPromises, Row } from "@evolu/common/local-first";
-/**
- * The same as {@link useQuery}, but for many queries.
- *
- * The number of queries must remain stable across renders.
- */
-export declare const useQueries: <R extends Row, Q extends Queries<R>, OQ extends Queries<R>>(queries: [...Q], options?: Partial<{
-    /** Queries that should be only loaded, not subscribed to. */
-    readonly once: [...OQ];
-    /** Reuse existing promises instead of loading so query will not suspense. */
-    readonly promises: [...QueriesToQueryRowsPromises<Q>, ...QueriesToQueryRowsPromises<OQ>];
-}>) => [...QueriesToQueryRows<Q>, ...QueriesToQueryRows<OQ>];
-//# sourceMappingURL=useQueries.d.ts.map

package/dist/useQueries.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useQueries.d.ts","sourceRoot":"","sources":["../src/useQueries.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,kBAAkB,EAClB,0BAA0B,EAC1B,GAAG,EACJ,MAAM,2BAA2B,CAAC;AAOnC;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,CAAC,SAAS,GAAG,EACb,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EACpB,EAAE,SAAS,OAAO,CAAC,CAAC,CAAC,EAErB,SAAS,CAAC,GAAG,CAAC,CAAC,EACf,UAAS,OAAO,CAAC;IACf,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IAEvB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,CACjB,GAAG,0BAA0B,CAAC,CAAC,CAAC,EAChC,GAAG,0BAA0B,CAAC,EAAE,CAAC,CAClC,CAAC;CACH,CAAM,KACN,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAkBtD,CAAC"}

package/dist/useQueries.js

@@ -1,31 +0,0 @@
-import { use, useRef } from "react";
-import { useEvolu } from "./useEvolu.js";
-import { useQuerySubscription } from "./useQuerySubscription.js";
-import { useIsSsr } from "./useIsSsr.js";
-/**
- * The same as {@link useQuery}, but for many queries.
- *
- * The number of queries must remain stable across renders.
- */
-export const useQueries = (queries, options = {}) => {
-    const evolu = useEvolu();
-    const once = useRef(options).current.once;
-    const allQueries = once ? queries.concat(once) : queries;
-    const wasSSR = useIsSsr();
-    if (wasSSR) {
-        if (!options.promises)
-            void evolu.loadQueries(allQueries);
-    }
-    else {
-        if (options.promises)
-            options.promises.map(use);
-        // No waterfall: loadQuery batches all queries in the same microtask,
-        // so React suspends once and all promises resolve together.
-        else
-            evolu.loadQueries(allQueries).map(use);
-    }
-    return allQueries.map((query, i) => 
-    // Safe until the number of queries is stable.
-    // eslint-disable-next-line react-hooks/rules-of-hooks
-    useQuerySubscription(query, { once: i > queries.length - 1 }));
-};

package/dist/useQuery.d.ts

@@ -1,37 +0,0 @@
-import { Query, QueryRows, Row } from "@evolu/common/local-first";
-/**
- * Load and subscribe to the Query, and return an object with `rows` and `row`
- * properties that are automatically updated when data changes.
- *
- * Note that {@link useQuery} uses React Suspense. It means every usage of
- * {@link useQuery} blocks rendering until loading is completed. To avoid loading
- * waterfall with more queries, use {@link useQueries}.
- *
- * The `promise` option allows preloading queries before rendering, which can be
- * useful for complex queries that might take noticeable time even with local
- * data. However, this is rarely needed as local queries are typically fast.
- *
- * ### Example
- *
- * ```ts
- * // Get all rows.
- * const rows = useQuery(allTodos);
- *
- * // Get rows for a specific todo (the first row can be null).
- * const rows = useQuery(todoById(1));
- *
- * // Get all rows, but without subscribing to changes.
- * const rows = useQuery(allTodos, { once: true });
- *
- * // Preload a query (rarely needed).
- * const allTodosPromise = evolu.loadQuery(allTodos);
- * const rows = useQuery(allTodos, { promise: allTodosPromise });
- * ```
- */
-export declare const useQuery: <R extends Row>(query: Query<R>, options?: Partial<{
-    /** Without subscribing to changes. */
-    readonly once: boolean;
-    /** Reuse existing promise instead of loading so query will not suspense. */
-    readonly promise: Promise<QueryRows<R>>;
-}>) => QueryRows<R>;
-//# sourceMappingURL=useQuery.d.ts.map

package/dist/useQuery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useQuery.d.ts","sourceRoot":"","sources":["../src/useQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAOlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,GAAG,EACpC,OAAO,KAAK,CAAC,CAAC,CAAC,EACf,UAAS,OAAO,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC,CAAM,KACN,SAAS,CAAC,CAAC,CAWb,CAAC"}

package/dist/useQuery.js

@@ -1,45 +0,0 @@
-import { use } from "react";
-import { useEvolu } from "./useEvolu.js";
-import { useQuerySubscription } from "./useQuerySubscription.js";
-import { useIsSsr } from "./useIsSsr.js";
-/**
- * Load and subscribe to the Query, and return an object with `rows` and `row`
- * properties that are automatically updated when data changes.
- *
- * Note that {@link useQuery} uses React Suspense. It means every usage of
- * {@link useQuery} blocks rendering until loading is completed. To avoid loading
- * waterfall with more queries, use {@link useQueries}.
- *
- * The `promise` option allows preloading queries before rendering, which can be
- * useful for complex queries that might take noticeable time even with local
- * data. However, this is rarely needed as local queries are typically fast.
- *
- * ### Example
- *
- * ```ts
- * // Get all rows.
- * const rows = useQuery(allTodos);
- *
- * // Get rows for a specific todo (the first row can be null).
- * const rows = useQuery(todoById(1));
- *
- * // Get all rows, but without subscribing to changes.
- * const rows = useQuery(allTodos, { once: true });
- *
- * // Preload a query (rarely needed).
- * const allTodosPromise = evolu.loadQuery(allTodos);
- * const rows = useQuery(allTodos, { promise: allTodosPromise });
- * ```
- */
-export const useQuery = (query, options = {}) => {
-    const evolu = useEvolu();
-    const isSSR = useIsSsr();
-    if (isSSR) {
-        if (!options.promise)
-            void evolu.loadQuery(query);
-    }
-    else {
-        use(options.promise ?? evolu.loadQuery(query));
-    }
-    return useQuerySubscription(query, options);
-};

package/dist/useQuerySubscription.d.ts

@@ -1,10 +0,0 @@
-import { Query, QueryRows, Row } from "@evolu/common/local-first";
-/** Subscribe to {@link Query} {@link QueryRows} changes. */
-export declare const useQuerySubscription: <R extends Row>(query: Query<R>, options?: Partial<{
-    /**
-     * Only subscribe and get the current value once. Subscribed query will not
-     * invoke React Suspense after a mutation.
-     */
-    readonly once: boolean;
-}>) => QueryRows<R>;
-//# sourceMappingURL=useQuerySubscription.d.ts.map

package/dist/useQuerySubscription.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useQuerySubscription.d.ts","sourceRoot":"","sources":["../src/useQuerySubscription.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAa,MAAM,2BAA2B,CAAC;AAI7E,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,GAAG,EAChD,OAAO,KAAK,CAAC,CAAC,CAAC,EACf,UAAS,OAAO,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,CAAM,KACN,SAAS,CAAC,CAAC,CAsBb,CAAC"}

package/dist/useQuerySubscription.js

@@ -1,18 +0,0 @@
-import { constVoid } from "@evolu/common";
-import { emptyRows } from "@evolu/common/local-first";
-import { useEffect, useMemo, useRef, useSyncExternalStore } from "react";
-import { useEvolu } from "./useEvolu.js";
-/** Subscribe to {@link Query} {@link QueryRows} changes. */
-export const useQuerySubscription = (query, options = {}) => {
-    const evolu = useEvolu();
-    // useRef to not break "rules-of-hooks"
-    const { once } = useRef(options).current;
-    if (once) {
-        /* eslint-disable react-hooks/rules-of-hooks */
-        useEffect(
-        // No useSyncExternalStore, no unnecessary updates.
-        () => evolu.subscribeQuery(query)(constVoid), [evolu, query]);
-        return evolu.getQueryRows(query);
-    }
-    return useSyncExternalStore(useMemo(() => evolu.subscribeQuery(query), [evolu, query]), useMemo(() => () => evolu.getQueryRows(query), [evolu, query]), () => emptyRows);
-};

package/dist/useSyncState.d.ts

@@ -1,4 +0,0 @@
-import { SyncState } from "@evolu/common/local-first";
-/** Subscribe to {@link SyncState} changes. */
-export declare const useSyncState: () => SyncState;
-//# sourceMappingURL=useSyncState.d.ts.map

package/dist/useSyncState.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useSyncState.d.ts","sourceRoot":"","sources":["../src/useSyncState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGtD,8CAA8C;AAC9C,eAAO,MAAM,YAAY,QAAO,SAQ/B,CAAC"}

package/dist/useSyncState.js

@@ -1,11 +0,0 @@
-import { useEvolu } from "./useEvolu.js";
-/** Subscribe to {@link SyncState} changes. */
-export const useSyncState = () => {
-    const _evolu = useEvolu();
-    // return useSyncExternalStore(
-    //   evolu.subscribeSyncState,
-    //   evolu.getSyncState,
-    //   () => initialSyncState,
-    // );
-    throw new Error("TODO");
-};

package/src/EvoluContext.ts

@@ -1,4 +0,0 @@
-import { Evolu } from "@evolu/common/local-first";
-import { createContext } from "react";
-
-export const EvoluContext = createContext<Evolu<any> | null>(null);

package/src/EvoluProvider.tsx

@@ -1,13 +0,0 @@
-"use client";
-
-import { Evolu } from "@evolu/common/local-first";
-import { ReactNode } from "react";
-import { EvoluContext } from "./EvoluContext.js";
-
-export const EvoluProvider = ({
-  children,
-  value,
-}: {
-  readonly children?: ReactNode | undefined;
-  readonly value: Evolu<any>;
-}): React.ReactElement => <EvoluContext value={value}>{children}</EvoluContext>;

package/src/createUseEvolu.ts

@@ -1,17 +0,0 @@
-import { Evolu, EvoluSchema } from "@evolu/common";
-import { useEvolu } from "./useEvolu.js";
-
-/**
- * Creates a typed React Hook returning an instance of {@link Evolu}.
- *
- * ### Example
- *
- * ```ts
- * const useEvolu = createUseEvolu(evolu);
- * const { insert, update } = useEvolu();
- * ```
- */
-export const createUseEvolu = <S extends EvoluSchema>(
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  evolu: Evolu<S>,
-): (() => Evolu<S>) => useEvolu as () => Evolu<S>;

package/src/useEvolu.ts

@@ -1,20 +0,0 @@
-import { Evolu } from "@evolu/common/local-first";
-import { useContext } from "react";
-import { EvoluContext } from "./EvoluContext.js";
-import type { createUseEvolu } from "./createUseEvolu.js";
-
-/**
- * React Hook returning a generic instance of {@link Evolu}.
- *
- * This is intended for internal usage. Applications should use
- * {@link createUseEvolu}, which provides a correctly typed instance.
- */
-export const useEvolu = (): Evolu => {
-  const evolu = useContext(EvoluContext);
-  if (evolu == null) {
-    throw new Error(
-      "Could not find Evolu context value. Ensure the component is wrapped in an <EvoluProvider>.",
-    );
-  }
-  return evolu as Evolu;
-};

package/src/useEvoluError.ts

@@ -1,9 +0,0 @@
-import { constNull, EvoluError } from "@evolu/common";
-import { useSyncExternalStore } from "react";
-import { useEvolu } from "./useEvolu.js";
-
-/** Subscribe to {@link EvoluError} changes. */
-export const useEvoluError = (): EvoluError | null => {
-  const evolu = useEvolu();
-  return useSyncExternalStore(evolu.subscribeError, evolu.getError, constNull);
-};

package/src/useOwner.ts

@@ -1,18 +0,0 @@
-import { SyncOwner } from "@evolu/common";
-import { useEffect } from "react";
-import { useEvolu } from "./useEvolu.js";
-
-/**
- * React Hook for Evolu `useOwner` method.
- *
- * Using an owner means syncing it with its transports, or the transports
- * defined in Evolu config if the owner has no transports defined.
- */
-export const useOwner = (owner: SyncOwner | null): void => {
-  const evolu = useEvolu();
-
-  useEffect(() => {
-    if (owner == null) return;
-    return evolu.useOwner(owner);
-  }, [evolu, owner]);
-};

package/src/useQueries.ts

@@ -1,52 +0,0 @@
-import {
-  Queries,
-  QueriesToQueryRows,
-  QueriesToQueryRowsPromises,
-  Row,
-} from "@evolu/common/local-first";
-import { use, useRef } from "react";
-import { useEvolu } from "./useEvolu.js";
-import type { useQuery } from "./useQuery.js";
-import { useQuerySubscription } from "./useQuerySubscription.js";
-import { useIsSsr } from "./useIsSsr.js";
-
-/**
- * The same as {@link useQuery}, but for many queries.
- *
- * The number of queries must remain stable across renders.
- */
-export const useQueries = <
-  R extends Row,
-  Q extends Queries<R>,
-  OQ extends Queries<R>,
->(
-  queries: [...Q],
-  options: Partial<{
-    /** Queries that should be only loaded, not subscribed to. */
-    readonly once: [...OQ];
-
-    /** Reuse existing promises instead of loading so query will not suspense. */
-    readonly promises: [
-      ...QueriesToQueryRowsPromises<Q>,
-      ...QueriesToQueryRowsPromises<OQ>,
-    ];
-  }> = {},
-): [...QueriesToQueryRows<Q>, ...QueriesToQueryRows<OQ>] => {
-  const evolu = useEvolu();
-  const once = useRef(options).current.once;
-  const allQueries = once ? queries.concat(once) : queries;
-  const wasSSR = useIsSsr();
-  if (wasSSR) {
-    if (!options.promises) void evolu.loadQueries(allQueries);
-  } else {
-    if (options.promises) options.promises.map(use);
-    // No waterfall: loadQuery batches all queries in the same microtask,
-    // so React suspends once and all promises resolve together.
-    else evolu.loadQueries(allQueries).map(use);
-  }
-  return allQueries.map((query, i) =>
-    // Safe until the number of queries is stable.
-    // eslint-disable-next-line react-hooks/rules-of-hooks
-    useQuerySubscription(query, { once: i > queries.length - 1 }),
-  ) as never;
-};

package/src/useQuery.ts

@@ -1,57 +0,0 @@
-import { Query, QueryRows, Row } from "@evolu/common/local-first";
-import { use } from "react";
-import { useEvolu } from "./useEvolu.js";
-import type { useQueries } from "./useQueries.js";
-import { useQuerySubscription } from "./useQuerySubscription.js";
-import { useIsSsr } from "./useIsSsr.js";
-
-/**
- * Load and subscribe to the Query, and return an object with `rows` and `row`
- * properties that are automatically updated when data changes.
- *
- * Note that {@link useQuery} uses React Suspense. It means every usage of
- * {@link useQuery} blocks rendering until loading is completed. To avoid loading
- * waterfall with more queries, use {@link useQueries}.
- *
- * The `promise` option allows preloading queries before rendering, which can be
- * useful for complex queries that might take noticeable time even with local
- * data. However, this is rarely needed as local queries are typically fast.
- *
- * ### Example
- *
- * ```ts
- * // Get all rows.
- * const rows = useQuery(allTodos);
- *
- * // Get rows for a specific todo (the first row can be null).
- * const rows = useQuery(todoById(1));
- *
- * // Get all rows, but without subscribing to changes.
- * const rows = useQuery(allTodos, { once: true });
- *
- * // Preload a query (rarely needed).
- * const allTodosPromise = evolu.loadQuery(allTodos);
- * const rows = useQuery(allTodos, { promise: allTodosPromise });
- * ```
- */
-export const useQuery = <R extends Row>(
-  query: Query<R>,
-  options: Partial<{
-    /** Without subscribing to changes. */
-    readonly once: boolean;
-
-    /** Reuse existing promise instead of loading so query will not suspense. */
-    readonly promise: Promise<QueryRows<R>>;
-  }> = {},
-): QueryRows<R> => {
-  const evolu = useEvolu();
-  const isSSR = useIsSsr();
-
-  if (isSSR) {
-    if (!options.promise) void evolu.loadQuery(query);
-  } else {
-    use(options.promise ?? evolu.loadQuery(query));
-  }
-
-  return useQuerySubscription(query, options);
-};

package/src/useQuerySubscription.ts

@@ -1,38 +0,0 @@
-import { constVoid } from "@evolu/common";
-import { Query, QueryRows, Row, emptyRows } from "@evolu/common/local-first";
-import { useEffect, useMemo, useRef, useSyncExternalStore } from "react";
-import { useEvolu } from "./useEvolu.js";
-
-/** Subscribe to {@link Query} {@link QueryRows} changes. */
-export const useQuerySubscription = <R extends Row>(
-  query: Query<R>,
-  options: Partial<{
-    /**
-     * Only subscribe and get the current value once. Subscribed query will not
-     * invoke React Suspense after a mutation.
-     */
-    readonly once: boolean;
-  }> = {},
-): QueryRows<R> => {
-  const evolu = useEvolu();
-
-  // useRef to not break "rules-of-hooks"
-  const { once } = useRef(options).current;
-
-  if (once) {
-    /* eslint-disable react-hooks/rules-of-hooks */
-    useEffect(
-      // No useSyncExternalStore, no unnecessary updates.
-      () => evolu.subscribeQuery(query)(constVoid),
-      [evolu, query],
-    );
-    return evolu.getQueryRows(query);
-  }
-
-  return useSyncExternalStore(
-    useMemo(() => evolu.subscribeQuery(query), [evolu, query]),
-    useMemo(() => () => evolu.getQueryRows(query), [evolu, query]),
-    () => emptyRows as QueryRows<R>,
-    /* eslint-enable react-hooks/rules-of-hooks */
-  );
-};

package/src/useSyncState.ts

@@ -1,13 +0,0 @@
-import { SyncState } from "@evolu/common/local-first";
-import { useEvolu } from "./useEvolu.js";
-
-/** Subscribe to {@link SyncState} changes. */
-export const useSyncState = (): SyncState => {
-  const _evolu = useEvolu();
-  // return useSyncExternalStore(
-  //   evolu.subscribeSyncState,
-  //   evolu.getSyncState,
-  //   () => initialSyncState,
-  // );
-  throw new Error("TODO");
-};