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

package/README.md

@@ -103,6 +103,8 @@ function MessageList({ room }: { room: string }) {
 | `useInfiniteQuery(fn, args, { initialNumItems })`    | `{ pages, status, hasNextPage, fetchNextPage, … }`              | Page-array variant of the same paginator.                                      |
 | `usePreloadedQuery(preloaded)`                       | `T`                                                             | Reads a server `Preloaded` token, then goes live.                              |
 | `usePresence({ heartbeat, listPresent, roomId, … })` | present members                                                 | Drives the `definePresence` heartbeat + list functions.                        |
+| `useFlag(key, default, context?)`                    | flag value (live)                                               | Live OpenFeature flag over the WS; reads `default` until the server answers.   |
+| `useFlags(defaults, context?)`                       | `{ [key]: value }`                                              | Batch variant — one live value per key in the `defaults` map.                  |
 | `useStream(fn, args, options?)`                      | `{ chunks, status, error, cancel }`                             | Consumes a streamed action response chunk by chunk.                            |
 | `useRateLimit(config, options?)`                     | `{ ok, disabled, retryAfter, check, consume, reset }`           | Client-side mirror of a `@lunora/ratelimit` budget for instant UX.             |
 | `useConnectionStatus()`                              | `ConnectionStatus`                                              | `idle` / `connecting` / `connected` / `offline`.                               |

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';
@@ -233,6 +233,38 @@ declare const useAuth: () => UseAuthResult;
 * operator can tell a healthy live channel from a silently-dropped socket.
 */
 declare const useConnectionStatus: () => ConnectionStatus;
+/** A targeting context merged on top of the app's default (`defineFlags({ identify })`). */
+type FlagContext = Record<string, unknown>;
+/** The value kinds a flag resolves to — OpenFeature's boolean / number / string / structured (JSON) flags. */
+type FlagValue = boolean | number | string | {
+  [key: string]: unknown;
+} | unknown[] | null;
+/**
+* Subscribe to a single feature flag, live over Lunora's WebSocket.
+*
+* Returns `defaultValue` until the first evaluation lands, then the server's
+* resolved value — re-pushed whenever the provider re-evaluates (e.g. a flag is
+* toggled in Cloudflare Flagship). The flag's kind is inferred from
+* `defaultValue`'s runtime type, so `useFlag("dark", false)` reads a boolean and
+* `useFlag("hero", "control")` a string. `context` supplies a per-call targeting
+* context merged on top of the app's default `identify` targeting key.
+*
+* Evaluation runs through whatever OpenFeature provider the app wired in
+* `lunora/flags.ts`; the read never throws — a provider error resolves the
+* default (the same fail-open contract as server-side `ctx.flags`).
+*/
+declare const useFlag: <T extends FlagValue>(key: string, defaultValue: T, context?: FlagContext) => T;
+/**
+* Subscribe to several feature flags at once, live over Lunora's WebSocket.
+*
+* Pass a record of `key → defaultValue`; each flag's kind is inferred from its
+* default, and the result is the same-shaped record with resolved values (the
+* defaults until each evaluation lands). A single `context` applies to every
+* flag. This is the batched form of {@link useFlag} — one effect manages one
+* subscription per key, so it stays rules-of-hooks-safe even as the flag set
+* changes between renders.
+*/
+declare const useFlags: <T extends Record<string, FlagValue>>(flags: T, context?: FlagContext) => T;
 /** The args a paginated query exposes minus the framework-supplied page cursor. */
 type PaginatedArgs<F> = Omit<ArgsOf<F>, "paginationOpts">;
 /** The element type of the `page` array a paginated query returns. */
@@ -322,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.
@@ -496,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 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, 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';
@@ -233,6 +233,38 @@ declare const useAuth: () => UseAuthResult;
 * operator can tell a healthy live channel from a silently-dropped socket.
 */
 declare const useConnectionStatus: () => ConnectionStatus;
+/** A targeting context merged on top of the app's default (`defineFlags({ identify })`). */
+type FlagContext = Record<string, unknown>;
+/** The value kinds a flag resolves to — OpenFeature's boolean / number / string / structured (JSON) flags. */
+type FlagValue = boolean | number | string | {
+  [key: string]: unknown;
+} | unknown[] | null;
+/**
+* Subscribe to a single feature flag, live over Lunora's WebSocket.
+*
+* Returns `defaultValue` until the first evaluation lands, then the server's
+* resolved value — re-pushed whenever the provider re-evaluates (e.g. a flag is
+* toggled in Cloudflare Flagship). The flag's kind is inferred from
+* `defaultValue`'s runtime type, so `useFlag("dark", false)` reads a boolean and
+* `useFlag("hero", "control")` a string. `context` supplies a per-call targeting
+* context merged on top of the app's default `identify` targeting key.
+*
+* Evaluation runs through whatever OpenFeature provider the app wired in
+* `lunora/flags.ts`; the read never throws — a provider error resolves the
+* default (the same fail-open contract as server-side `ctx.flags`).
+*/
+declare const useFlag: <T extends FlagValue>(key: string, defaultValue: T, context?: FlagContext) => T;
+/**
+* Subscribe to several feature flags at once, live over Lunora's WebSocket.
+*
+* Pass a record of `key → defaultValue`; each flag's kind is inferred from its
+* default, and the result is the same-shaped record with resolved values (the
+* defaults until each evaluation lands). A single `context` applies to every
+* flag. This is the batched form of {@link useFlag} — one effect manages one
+* subscription per key, so it stays rules-of-hooks-safe even as the flag set
+* changes between renders.
+*/
+declare const useFlags: <T extends Record<string, FlagValue>>(flags: T, context?: FlagContext) => T;
 /** The args a paginated query exposes minus the framework-supplied page cursor. */
 type PaginatedArgs<F> = Omit<ArgsOf<F>, "paginationOpts">;
 /** The element type of the `page` array a paginated query returns. */
@@ -322,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.
@@ -496,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 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, 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

@@ -6,9 +6,11 @@ export { CheckoutButton, CustomerPortalButton, useCheckout } from './packem_shar
 export { lunoraQueryOptions } from './packem_shared/lunoraQueryOptions-Cij4KWBK.mjs';
 export { default as useAuth } from './packem_shared/useAuth-CNUKtOOp.mjs';
 export { default as useConnectionStatus } from './packem_shared/useConnectionStatus-DRSY9ldm.mjs';
-export { default as useInfiniteQuery } from './packem_shared/useInfiniteQuery-HjOCDd3R.mjs';
+export { useFlag, useFlags } from './packem_shared/useFlag-Bg5DpkGv.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/useFlag-Bg5DpkGv.mjs

@@ -0,0 +1,224 @@
+'use client';
+import { c } from 'react/compiler-runtime';
+import { useState, useRef, useEffect } from 'react';
+import { useLunora } from './LunoraProvider-D38Xp16l.mjs';
+import { s as stableStringify } from './stable-key-CaKZv9lp.mjs';
+
+const FLAGS_EVAL_PATH = "__lunora_flags__:eval";
+const flagKind = (value) => {
+  const kind = typeof value;
+  if (kind === "boolean" || kind === "number" || kind === "string") {
+    return kind;
+  }
+  return "object";
+};
+const flagsReference = {
+  __lunoraRef: FLAGS_EVAL_PATH
+};
+const useFlag = (key, defaultValue, context) => {
+  const $ = c(19);
+  const client = useLunora();
+  const [value, setValue] = useState(defaultValue);
+  let t0;
+  if ($[0] !== defaultValue) {
+    t0 = flagKind(defaultValue);
+    $[0] = defaultValue;
+    $[1] = t0;
+  } else {
+    t0 = $[1];
+  }
+  const type = t0;
+  let t1;
+  if ($[2] !== context) {
+    t1 = context === void 0 ? "" : stableStringify(context);
+    $[2] = context;
+    $[3] = t1;
+  } else {
+    t1 = $[3];
+  }
+  const serializedContext = t1;
+  let t2;
+  if ($[4] !== context || $[5] !== defaultValue) {
+    t2 = {
+      context,
+      defaultValue
+    };
+    $[4] = context;
+    $[5] = defaultValue;
+    $[6] = t2;
+  } else {
+    t2 = $[6];
+  }
+  const latest = useRef(t2);
+  let t3;
+  if ($[7] !== context || $[8] !== defaultValue) {
+    t3 = () => {
+      latest.current = {
+        context,
+        defaultValue
+      };
+    };
+    $[7] = context;
+    $[8] = defaultValue;
+    $[9] = t3;
+  } else {
+    t3 = $[9];
+  }
+  useEffect(t3);
+  let t4;
+  if ($[10] !== client || $[11] !== key || $[12] !== type) {
+    t4 = () => {
+      let cancelled = false;
+      const {
+        context: currentContext,
+        defaultValue: currentDefault
+      } = latest.current;
+      setValue(currentDefault);
+      let unsubscribe;
+      try {
+        unsubscribe = client.subscribe(flagsReference, {
+          context: currentContext,
+          default: currentDefault,
+          key,
+          type
+        }, (next) => {
+          if (!cancelled) {
+            setValue(next);
+          }
+        });
+      } catch {
+        return () => {
+          cancelled = true;
+        };
+      }
+      return () => {
+        cancelled = true;
+        unsubscribe();
+      };
+    };
+    $[10] = client;
+    $[11] = key;
+    $[12] = type;
+    $[13] = t4;
+  } else {
+    t4 = $[13];
+  }
+  let t5;
+  if ($[14] !== client || $[15] !== key || $[16] !== serializedContext || $[17] !== type) {
+    t5 = [client, key, type, serializedContext];
+    $[14] = client;
+    $[15] = key;
+    $[16] = serializedContext;
+    $[17] = type;
+    $[18] = t5;
+  } else {
+    t5 = $[18];
+  }
+  useEffect(t4, t5);
+  return value;
+};
+const useFlags = (flags, context) => {
+  const $ = c(16);
+  const client = useLunora();
+  const [values, setValues] = useState(flags);
+  let t0;
+  if ($[0] !== flags) {
+    t0 = stableStringify(flags);
+    $[0] = flags;
+    $[1] = t0;
+  } else {
+    t0 = $[1];
+  }
+  const spec = t0;
+  let t1;
+  if ($[2] !== context) {
+    t1 = context === void 0 ? "" : stableStringify(context);
+    $[2] = context;
+    $[3] = t1;
+  } else {
+    t1 = $[3];
+  }
+  const serializedContext = t1;
+  let t2;
+  if ($[4] !== context || $[5] !== flags) {
+    t2 = {
+      context,
+      flags
+    };
+    $[4] = context;
+    $[5] = flags;
+    $[6] = t2;
+  } else {
+    t2 = $[6];
+  }
+  const latest = useRef(t2);
+  let t3;
+  if ($[7] !== context || $[8] !== flags) {
+    t3 = () => {
+      latest.current = {
+        context,
+        flags
+      };
+    };
+    $[7] = context;
+    $[8] = flags;
+    $[9] = t3;
+  } else {
+    t3 = $[9];
+  }
+  useEffect(t3);
+  let t4;
+  if ($[10] !== client) {
+    t4 = () => {
+      let cancelled = false;
+      const {
+        context: currentContext,
+        flags: currentFlags
+      } = latest.current;
+      setValues(currentFlags);
+      const unsubscribes = [];
+      for (const [key, defaultValue] of Object.entries(currentFlags)) {
+        try {
+          unsubscribes.push(client.subscribe(flagsReference, {
+            context: currentContext,
+            default: defaultValue,
+            key,
+            type: flagKind(defaultValue)
+          }, (next) => {
+            if (!cancelled) {
+              setValues((previous) => ({
+                ...previous,
+                [key]: next
+              }));
+            }
+          }));
+        } catch {
+        }
+      }
+      return () => {
+        cancelled = true;
+        for (const unsubscribe of unsubscribes) {
+          unsubscribe();
+        }
+      };
+    };
+    $[10] = client;
+    $[11] = t4;
+  } else {
+    t4 = $[11];
+  }
+  let t5;
+  if ($[12] !== client || $[13] !== serializedContext || $[14] !== spec) {
+    t5 = [client, spec, serializedContext];
+    $[12] = client;
+    $[13] = serializedContext;
+    $[14] = spec;
+    $[15] = t5;
+  } else {
+    t5 = $[15];
+  }
+  useEffect(t4, t5);
+  return values;
+};
+
+export { useFlag, useFlags };

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.5",
+  "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": {