@lunora/react 1.0.0-alpha.6 → 1.0.0-alpha.7

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { ReactNode, ReactElement } from 'react';
-import { LunoraClient, OptimisticUpdate, User, ConnectionStatus, ReturnOf, ArgsOf, FunctionReference, Preloaded } from '@lunora/client';
-export type { ArgsOf, FunctionReference, LunoraClient, OptimisticLocalStore, OptimisticUpdate, Preloaded, ReturnOf, User } from '@lunora/client';
+import { LunoraClient, OptimisticUpdate, User, ConnectionStatus, ReturnOf, ArgsOf, FunctionReference, MutatorHandle, Preloaded } from '@lunora/client';
+export type { ArgsOf, FunctionReference, LunoraClient, MutatorHandle, MutatorTransaction, OptimisticLocalStore, OptimisticUpdate, Preloaded, ReturnOf, User } from '@lunora/client';
 import { QueryClient } from '@tanstack/react-query';
 export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-D4okOpO8.mjs";
 import { PaginationStatus } from '@lunora/client/pagination';
@@ -354,6 +354,31 @@ interface MutationHook<F extends FunctionReference> {
 * through TanStack's `onMutate`.
 */
 declare const useMutation: <F extends FunctionReference>(function_: F) => MutationHook<F>;
+interface MutatorHook<TArgs> {
+  /** The latest invocation's error, or `undefined`. */
+  error: Error | undefined;
+  /** `true` when the latest invocation rejected. */
+  isError: boolean;
+  /** Run the mutator; resolves once the write is persisted, rejects on failure. */
+  mutate: (args: TArgs) => Promise<void>;
+  /** `true` while ANY invocation from this hook is in flight (ref-counted, so overlapping calls compose). */
+  pending: boolean;
+  /** Clear the latest `error` back to idle. */
+  reset: () => void;
+}
+/**
+* Ergonomic `{ mutate, pending, error, isError, reset }` wrapper over a bound
+* custom-mutator handle from `@lunora/db`'s `bindMutators`. The optimistic
+* overlay and server-authoritative push are owned by the bound handle (and
+* TanStack DB's optimistic-transaction layer rebases pending overlays on every
+* sync tick) — this hook only surfaces React state for the in-flight/error
+* lifecycle. Reads stay on the existing `useLiveQuery`; no new query hook is
+* needed.
+*
+* `pending` is ref-counted across overlapping invocations of THIS hook instance,
+* so it clears only once every concurrent call has settled.
+*/
+declare const useMutator: <TArgs = Record<string, unknown>>(handle: MutatorHandle<TArgs>) => MutatorHook<TArgs>;
 /**
 * Hydrate a query from a {@link Preloaded} token produced by `preloadQuery`
 * during SSR, then keep it live.
@@ -528,4 +553,4 @@ declare const useStream: <F extends FunctionReference<"stream">>(function_: F, a
 * the server pushes over the WS.
 */
 declare const useSubscription: <F extends FunctionReference>(function_: F, args: ArgsOf<F> | "skip", options?: UseQueryOptions) => UseSubscriptionResult<ReturnOf<F>>;
-export { AuthLoading, type AuthState, Authenticated, CheckoutButton, type CheckoutButtonProps, CustomerPortalButton, type CustomerPortalButtonProps, type FlagContext, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraProvider, type LunoraProviderProps, type MutationHook, type PageItemOf, type PaginatedArgs, type RedirectTarget, type RedirectTrigger, type Subscription, Unauthenticated, type UseAuthResult, type UseCheckoutResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, hydratePreloaded, useAuth, useAuthState, useCheckout, useConnectionStatus, useFlag, useFlags, useInfiniteQuery, useLunora, useMutation, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription };
+export { AuthLoading, type AuthState, Authenticated, CheckoutButton, type CheckoutButtonProps, CustomerPortalButton, type CustomerPortalButtonProps, type FlagContext, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraProvider, type LunoraProviderProps, type MutationHook, type MutatorHook, type PageItemOf, type PaginatedArgs, type RedirectTarget, type RedirectTrigger, type Subscription, Unauthenticated, type UseAuthResult, type UseCheckoutResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, hydratePreloaded, useAuth, useAuthState, useCheckout, useConnectionStatus, useFlag, useFlags, useInfiniteQuery, useLunora, useMutation, useMutator, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { ReactNode, ReactElement } from 'react';
-import { LunoraClient, OptimisticUpdate, User, ConnectionStatus, ReturnOf, ArgsOf, FunctionReference, Preloaded } from '@lunora/client';
-export type { ArgsOf, FunctionReference, LunoraClient, OptimisticLocalStore, OptimisticUpdate, Preloaded, ReturnOf, User } from '@lunora/client';
+import { LunoraClient, OptimisticUpdate, User, ConnectionStatus, ReturnOf, ArgsOf, FunctionReference, MutatorHandle, Preloaded } from '@lunora/client';
+export type { ArgsOf, FunctionReference, LunoraClient, MutatorHandle, MutatorTransaction, OptimisticLocalStore, OptimisticUpdate, Preloaded, ReturnOf, User } from '@lunora/client';
 import { QueryClient } from '@tanstack/react-query';
 export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-D4okOpO8.js";
 import { PaginationStatus } from '@lunora/client/pagination';
@@ -354,6 +354,31 @@ interface MutationHook<F extends FunctionReference> {
 * through TanStack's `onMutate`.
 */
 declare const useMutation: <F extends FunctionReference>(function_: F) => MutationHook<F>;
+interface MutatorHook<TArgs> {
+  /** The latest invocation's error, or `undefined`. */
+  error: Error | undefined;
+  /** `true` when the latest invocation rejected. */
+  isError: boolean;
+  /** Run the mutator; resolves once the write is persisted, rejects on failure. */
+  mutate: (args: TArgs) => Promise<void>;
+  /** `true` while ANY invocation from this hook is in flight (ref-counted, so overlapping calls compose). */
+  pending: boolean;
+  /** Clear the latest `error` back to idle. */
+  reset: () => void;
+}
+/**
+* Ergonomic `{ mutate, pending, error, isError, reset }` wrapper over a bound
+* custom-mutator handle from `@lunora/db`'s `bindMutators`. The optimistic
+* overlay and server-authoritative push are owned by the bound handle (and
+* TanStack DB's optimistic-transaction layer rebases pending overlays on every
+* sync tick) — this hook only surfaces React state for the in-flight/error
+* lifecycle. Reads stay on the existing `useLiveQuery`; no new query hook is
+* needed.
+*
+* `pending` is ref-counted across overlapping invocations of THIS hook instance,
+* so it clears only once every concurrent call has settled.
+*/
+declare const useMutator: <TArgs = Record<string, unknown>>(handle: MutatorHandle<TArgs>) => MutatorHook<TArgs>;
 /**
 * Hydrate a query from a {@link Preloaded} token produced by `preloadQuery`
 * during SSR, then keep it live.
@@ -528,4 +553,4 @@ declare const useStream: <F extends FunctionReference<"stream">>(function_: F, a
 * the server pushes over the WS.
 */
 declare const useSubscription: <F extends FunctionReference>(function_: F, args: ArgsOf<F> | "skip", options?: UseQueryOptions) => UseSubscriptionResult<ReturnOf<F>>;
-export { AuthLoading, type AuthState, Authenticated, CheckoutButton, type CheckoutButtonProps, CustomerPortalButton, type CustomerPortalButtonProps, type FlagContext, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraProvider, type LunoraProviderProps, type MutationHook, type PageItemOf, type PaginatedArgs, type RedirectTarget, type RedirectTrigger, type Subscription, Unauthenticated, type UseAuthResult, type UseCheckoutResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, hydratePreloaded, useAuth, useAuthState, useCheckout, useConnectionStatus, useFlag, useFlags, useInfiniteQuery, useLunora, useMutation, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription };
+export { AuthLoading, type AuthState, Authenticated, CheckoutButton, type CheckoutButtonProps, CustomerPortalButton, type CustomerPortalButtonProps, type FlagContext, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraProvider, type LunoraProviderProps, type MutationHook, type MutatorHook, type PageItemOf, type PaginatedArgs, type RedirectTarget, type RedirectTrigger, type Subscription, Unauthenticated, type UseAuthResult, type UseCheckoutResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, hydratePreloaded, useAuth, useAuthState, useCheckout, useConnectionStatus, useFlag, useFlags, useInfiniteQuery, useLunora, useMutation, useMutator, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription };

package/dist/index.mjs

@@ -7,9 +7,10 @@ export { lunoraQueryOptions } from './packem_shared/lunoraQueryOptions-Cij4KWBK.
 export { default as useAuth } from './packem_shared/useAuth-CNUKtOOp.mjs';
 export { default as useConnectionStatus } from './packem_shared/useConnectionStatus-DRSY9ldm.mjs';
 export { useFlag, useFlags } from './packem_shared/useFlag-Bg5DpkGv.mjs';
-export { default as useInfiniteQuery } from './packem_shared/useInfiniteQuery-HjOCDd3R.mjs';
+export { default as useInfiniteQuery } from './packem_shared/useInfiniteQuery-BBIDFXBN.mjs';
 export { useMutation } from './packem_shared/useMutation-CrvMXRsk.mjs';
-export { usePaginatedQuery } from './packem_shared/usePaginatedQuery-BGYvICZU.mjs';
+export { useMutator } from './packem_shared/useMutator-IIrLtDiM.mjs';
+export { usePaginatedQuery } from './packem_shared/usePaginatedQuery-AQO3kdp1.mjs';
 export { hydratePreloaded, default as usePreloadedQuery } from './packem_shared/hydratePreloaded-B6OHn0eL.mjs';
 export { usePresence } from './packem_shared/usePresence-D7jLuxj0.mjs';
 export { default as useQuery } from './packem_shared/useQuery-EB74gtBJ.mjs';

package/dist/packem_shared/{use-paginated-core-DxGvzQVR.mjs → use-paginated-core-DP72UNWn.mjs}

@@ -49,12 +49,14 @@ const usePaginatedCore = function(function_, args, options) {
     key: key_0
   }) => serializeQueryKey(key_0)).join("|");
   const desiredRef = useRef({
+    baseArgs,
     entries: [],
     fn: function_,
     shardKey
   });
   useEffect(() => {
     desiredRef.current = {
+      baseArgs,
       entries: pageEntries,
       fn: function_,
       shardKey
@@ -140,17 +142,30 @@ const usePaginatedCore = function(function_, args, options) {
     }
   });
   const {
-    nextCursor,
     status
   } = derivePaginationStatus(skipped, pageResults);
-  const nextCursorRef = useRef(void 0);
-  useEffect(() => {
-    nextCursorRef.current = status === "CanLoadMore" ? nextCursor : void 0;
-  });
   const loadMore = useCallback((numberItems) => {
-    const cursor = nextCursorRef.current;
-    setPages((current) => applyLoadMore(current, cursor, numberItems) ?? current);
-  }, []);
+    setPages((current) => {
+      const desired_0 = desiredRef.current;
+      const results = current.map((page_0) => {
+        const pageArgs_0 = {
+          ...desired_0.baseArgs,
+          paginationOpts: {
+            cursor: page_0.lower,
+            endCursor: page_0.upper,
+            numItems: page_0.numItems
+          }
+        };
+        return queryClient.getQueryData(lunoraQueryKey(desired_0.fn, pageArgs_0, desired_0.shardKey));
+      });
+      const {
+        nextCursor,
+        status: liveStatus
+      } = derivePaginationStatus(false, results);
+      const cursor = liveStatus === "CanLoadMore" ? nextCursor : void 0;
+      return applyLoadMore(current, cursor, numberItems) ?? current;
+    });
+  }, [queryClient]);
   return {
     loadMore,
     pageResults,

package/dist/packem_shared/{useInfiniteQuery-HjOCDd3R.mjs → useInfiniteQuery-BBIDFXBN.mjs}

@@ -1,7 +1,7 @@
 'use client';
 import { c } from 'react/compiler-runtime';
 import { useRef, useEffect } from 'react';
-import { u as usePaginatedCore } from './use-paginated-core-DxGvzQVR.mjs';
+import { u as usePaginatedCore } from './use-paginated-core-DP72UNWn.mjs';
 
 const useInfiniteQuery = (function_, args, options) => {
   const $ = c(15);

package/dist/packem_shared/useMutator-IIrLtDiM.mjs

@@ -0,0 +1,47 @@
+'use client';
+import { c } from 'react/compiler-runtime';
+import { createMutatorRunner } from '@lunora/client';
+import { useState } from 'react';
+
+const useMutator = function useMutator2(handle) {
+  const $ = c(8);
+  const [pending, setPending] = useState(false);
+  const [error, setError] = useState(void 0);
+  let t0;
+  if ($[0] !== handle) {
+    t0 = createMutatorRunner(handle, {
+      setError,
+      setPending
+    });
+    $[0] = handle;
+    $[1] = t0;
+  } else {
+    t0 = $[1];
+  }
+  const {
+    mutate,
+    reset
+  } = t0;
+  const t1 = error !== void 0;
+  let t2;
+  if ($[2] !== error || $[3] !== mutate || $[4] !== pending || $[5] !== reset || $[6] !== t1) {
+    t2 = {
+      error,
+      isError: t1,
+      mutate,
+      pending,
+      reset
+    };
+    $[2] = error;
+    $[3] = mutate;
+    $[4] = pending;
+    $[5] = reset;
+    $[6] = t1;
+    $[7] = t2;
+  } else {
+    t2 = $[7];
+  }
+  return t2;
+};
+
+export { useMutator };

package/dist/packem_shared/{usePaginatedQuery-BGYvICZU.mjs → usePaginatedQuery-AQO3kdp1.mjs}

@@ -1,6 +1,6 @@
 'use client';
 import { c } from 'react/compiler-runtime';
-import { u as usePaginatedCore } from './use-paginated-core-DxGvzQVR.mjs';
+import { u as usePaginatedCore } from './use-paginated-core-DP72UNWn.mjs';
 
 const usePaginatedQuery = (function_, args, options) => {
   const $ = c(7);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/react",
-  "version": "1.0.0-alpha.6",
+  "version": "1.0.0-alpha.7",
   "description": "React hooks for Lunora: useQuery, useMutation, useSubscription, and useAuth",
   "keywords": [
     "cloudflare",
@@ -49,7 +49,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.4",
+    "@lunora/client": "1.0.0-alpha.5",
     "@lunora/ratelimit": "1.0.0-alpha.3"
   },
   "peerDependencies": {