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

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

@@ -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. */
@@ -496,4 +528,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 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 };

package/dist/index.d.ts

@@ -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. */
@@ -496,4 +528,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 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 };

package/dist/index.mjs

@@ -3,15 +3,16 @@ export { AuthLoading, Authenticated, Unauthenticated } from './packem_shared/Aut
 export { useAuthState } from './packem_shared/useAuthState-BiGhtSCs.mjs';
 export { LunoraProvider, useLunora } from './packem_shared/LunoraProvider-D38Xp16l.mjs';
 export { CheckoutButton, CustomerPortalButton, useCheckout } from './packem_shared/CheckoutButton-CVSry8U1.mjs';
-export { lunoraQueryOptions } from './packem_shared/lunoraQueryOptions-CsuWzjg1.mjs';
+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-MH0x4l8h.mjs';
+export { useFlag, useFlags } from './packem_shared/useFlag-Bg5DpkGv.mjs';
+export { default as useInfiniteQuery } from './packem_shared/useInfiniteQuery-HjOCDd3R.mjs';
 export { useMutation } from './packem_shared/useMutation-CrvMXRsk.mjs';
-export { usePaginatedQuery } from './packem_shared/usePaginatedQuery-D3PTDRGS.mjs';
-export { hydratePreloaded, default as usePreloadedQuery } from './packem_shared/hydratePreloaded-BlFL9FGq.mjs';
+export { usePaginatedQuery } from './packem_shared/usePaginatedQuery-BGYvICZU.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-C5S0W-7K.mjs';
+export { default as useQuery } from './packem_shared/useQuery-EB74gtBJ.mjs';
 export { useRateLimit } from './packem_shared/useRateLimit-DTEffQEi.mjs';
-export { useStream } from './packem_shared/useStream-BRY9nemd.mjs';
-export { default as useSubscription } from './packem_shared/useSubscription-CHMCjyQg.mjs';
+export { useStream } from './packem_shared/useStream-MdYnWDL_.mjs';
+export { default as useSubscription } from './packem_shared/useSubscription-DSJuryrU.mjs';

package/dist/packem_shared/{cache-CItk3fgN.mjs → cache-CAp1fVNL.mjs}

@@ -1,4 +1,4 @@
-import { k as keyHash } from './query-key-C5rufkEE.mjs';
+import { k as keyHash } from './query-key-B5eRQCbR.mjs';
 
 class LunoraSubscriptionRegistry {
   constructor(client) {

package/dist/packem_shared/{hydratePreloaded-BlFL9FGq.mjs → hydratePreloaded-B6OHn0eL.mjs}

@@ -1,9 +1,9 @@
 'use client';
 import { useQueryClient, useQuery } from '@tanstack/react-query';
 import { useMemo, useEffect } from 'react';
-import { g as getSubscriptionRegistry } from './cache-CItk3fgN.mjs';
+import { g as getSubscriptionRegistry } from './cache-CAp1fVNL.mjs';
 import { useLunora } from './LunoraProvider-D38Xp16l.mjs';
-import { l as lunoraQueryKey, s as serializeQueryKey } from './query-key-C5rufkEE.mjs';
+import { l as lunoraQueryKey, s as serializeQueryKey } from './query-key-B5eRQCbR.mjs';
 
 const usePreloadedQuery = function(preloaded) {
   const client = useLunora();

package/dist/packem_shared/{lunoraQueryOptions-CsuWzjg1.mjs → lunoraQueryOptions-Cij4KWBK.mjs}

@@ -1,4 +1,4 @@
-import { l as lunoraQueryKey } from './query-key-C5rufkEE.mjs';
+import { l as lunoraQueryKey } from './query-key-B5eRQCbR.mjs';
 
 const lunoraQueryOptions = (client, function_, args, options = {}) => {
   const argsRecord = args ?? {};

package/dist/packem_shared/query-key-B5eRQCbR.mjs

@@ -0,0 +1,13 @@
+import { s as stableStringify } from './stable-key-CaKZv9lp.mjs';
+
+const keyHash = (queryKey) => stableStringify(queryKey);
+const lunoraQueryKey = (function_, args, shardKey) => [
+  "lunora",
+  function_.__lunoraRef,
+  args,
+  // eslint-disable-next-line unicorn/no-null -- this literal is part of the JSON-serialized query key TanStack hashes for dedup; `null` keeps a stable, distinct slot from an absent shardKey across renders.
+  shardKey ?? null
+];
+const serializeQueryKey = (queryKey) => keyHash(queryKey);
+
+export { keyHash as k, lunoraQueryKey as l, serializeQueryKey as s };

package/dist/packem_shared/stable-key-CaKZv9lp.mjs

@@ -0,0 +1,30 @@
+const compareKeys = (a, b) => {
+  if (a < b) {
+    return -1;
+  }
+  return a > b ? 1 : 0;
+};
+const stableStringify = (value) => {
+  if (value === void 0) {
+    return "null";
+  }
+  if (value === null || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+  const record = value;
+  const keys = Object.keys(record).toSorted(compareKeys);
+  const parts = [];
+  for (const key of keys) {
+    const raw = record[key];
+    if (raw === void 0) {
+      continue;
+    }
+    parts.push(`${JSON.stringify(key)}:${stableStringify(raw)}`);
+  }
+  return `{${parts.join(",")}}`;
+};
+
+export { stableStringify as s };

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

@@ -2,9 +2,9 @@
 import { initialPages, rebalance, derivePaginationStatus, applyLoadMore } from '@lunora/client/pagination';
 import { useQueryClient } from '@tanstack/react-query';
 import { useRef, useReducer, useState, useEffect, useCallback } from 'react';
-import { g as getSubscriptionRegistry } from './cache-CItk3fgN.mjs';
+import { g as getSubscriptionRegistry } from './cache-CAp1fVNL.mjs';
 import { useLunora } from './LunoraProvider-D38Xp16l.mjs';
-import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-C5rufkEE.mjs';
+import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-B5eRQCbR.mjs';
 
 const useLazyRef = function(create) {
   const reference = useRef(void 0);

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-MH0x4l8h.mjs → useInfiniteQuery-HjOCDd3R.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-CoOfcc-p.mjs';
+import { u as usePaginatedCore } from './use-paginated-core-DxGvzQVR.mjs';
 
 const useInfiniteQuery = (function_, args, options) => {
   const $ = c(15);

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

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

package/dist/packem_shared/{useQuery-C5S0W-7K.mjs → useQuery-EB74gtBJ.mjs}

@@ -1,9 +1,10 @@
 'use client';
 import { useQueryClient, useQuery as useQuery$1 } from '@tanstack/react-query';
 import { useMemo, useEffect } from 'react';
-import { g as getSubscriptionRegistry } from './cache-CItk3fgN.mjs';
+import { g as getSubscriptionRegistry } from './cache-CAp1fVNL.mjs';
 import { useLunora } from './LunoraProvider-D38Xp16l.mjs';
-import { l as lunoraQueryKey, a as stableStringify, s as serializeQueryKey } from './query-key-C5rufkEE.mjs';
+import { l as lunoraQueryKey, s as serializeQueryKey } from './query-key-B5eRQCbR.mjs';
+import { s as stableStringify } from './stable-key-CaKZv9lp.mjs';
 
 const useQuery = (function_, args, options = {}) => {
   const client = useLunora();

package/dist/packem_shared/{useStream-BRY9nemd.mjs → useStream-MdYnWDL_.mjs}

@@ -1,7 +1,7 @@
 'use client';
 import { useReducer, useRef, useEffect } from 'react';
 import { useLunora } from './LunoraProvider-D38Xp16l.mjs';
-import { a as stableStringify } from './query-key-C5rufkEE.mjs';
+import { s as stableStringify } from './stable-key-CaKZv9lp.mjs';
 
 const reducer = function(state, action) {
   switch (action.type) {

package/dist/packem_shared/{useSubscription-CHMCjyQg.mjs → useSubscription-DSJuryrU.mjs}

@@ -3,7 +3,7 @@ import { c } from 'react/compiler-runtime';
 import { createQuerySubscription } from '@lunora/client/query';
 import { useState, useRef, useEffect } from 'react';
 import { useLunora } from './LunoraProvider-D38Xp16l.mjs';
-import { a as stableStringify } from './query-key-C5rufkEE.mjs';
+import { s as stableStringify } from './stable-key-CaKZv9lp.mjs';
 
 const useSubscription = (function_, args, t0) => {
   const $ = c(22);

package/dist/server.mjs

@@ -1,7 +1,7 @@
 import { createServerClient } from '@lunora/client/ssr';
 export { createServerClient, deserializePreloaded, getServerSession, serializePreloaded } from '@lunora/client/ssr';
-import { l as lunoraQueryKey } from './packem_shared/query-key-C5rufkEE.mjs';
-export { lunoraQueryOptions } from './packem_shared/lunoraQueryOptions-CsuWzjg1.mjs';
+import { l as lunoraQueryKey } from './packem_shared/query-key-B5eRQCbR.mjs';
+export { lunoraQueryOptions } from './packem_shared/lunoraQueryOptions-Cij4KWBK.mjs';
 export { preloadQuery, preloadedQueryResult } from '@lunora/client';
 export { HydrationBoundary, dehydrate } from '@tanstack/react-query';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/react",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.6",
   "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.3",
+    "@lunora/client": "1.0.0-alpha.4",
     "@lunora/ratelimit": "1.0.0-alpha.3"
   },
   "peerDependencies": {

package/dist/packem_shared/query-key-C5rufkEE.mjs

@@ -1,21 +0,0 @@
-const keyHash = (queryKey) => JSON.stringify(queryKey);
-const stableStringify = (value) => {
-  if (value === null || typeof value !== "object") {
-    return JSON.stringify(value);
-  }
-  if (Array.isArray(value)) {
-    return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
-  }
-  const entries = Object.entries(value).toSorted(([a], [b]) => a.localeCompare(b));
-  return `{${entries.map(([key, value_]) => `${JSON.stringify(key)}:${stableStringify(value_)}`).join(",")}}`;
-};
-const lunoraQueryKey = (function_, args, shardKey) => [
-  "lunora",
-  function_.__lunoraRef,
-  args,
-  // eslint-disable-next-line unicorn/no-null -- this literal is part of the JSON-serialized query key TanStack hashes for dedup; `null` keeps a stable, distinct slot from an absent shardKey across renders.
-  shardKey ?? null
-];
-const serializeQueryKey = (queryKey) => keyHash(queryKey);
-
-export { stableStringify as a, keyHash as k, lunoraQueryKey as l, serializeQueryKey as s };