@lunora/react 1.0.0-alpha.3 → 1.0.0-alpha.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/react",
-  "version": "1.0.0-alpha.3",
+  "version": "1.0.0-alpha.30",
   "description": "React hooks for Lunora: useQuery, useMutation, useSubscription, and useAuth",
   "keywords": [
     "cloudflare",
@@ -25,7 +25,7 @@
     "directory": "packages/react"
   },
   "files": [
-    "dist",
+    "./dist",
     "README.md",
     "LICENSE.md",
     "__assets__"
@@ -49,8 +49,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.2",
-    "@lunora/ratelimit": "1.0.0-alpha.2"
+    "@lunora/client": "1.0.0-alpha.26",
+    "@lunora/errors": "1.0.0-alpha.6",
+    "@lunora/ratelimit": "1.0.0-alpha.9"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.101.0",
@@ -65,7 +66,7 @@
       "optional": false
     },
     "react-dom": {
-      "optional": false
+      "optional": true
     }
   },
   "engines": {

package/dist/packem_shared/hydratePreloaded-BlFL9FGq.mjs

@@ -1,46 +0,0 @@
-'use client';
-import { useQueryClient, useQuery } from '@tanstack/react-query';
-import { useMemo, useEffect } from 'react';
-import { g as getSubscriptionRegistry } from './cache-CItk3fgN.mjs';
-import { useLunora } from './LunoraProvider-D38Xp16l.mjs';
-import { l as lunoraQueryKey, s as serializeQueryKey } from './query-key-C5rufkEE.mjs';
-
-const usePreloadedQuery = function(preloaded) {
-  const client = useLunora();
-  const queryClient = useQueryClient();
-  const {
-    args,
-    functionPath,
-    shardKey,
-    value
-  } = preloaded;
-  const functionRef = useMemo(() => {
-    return {
-      __lunoraRef: functionPath
-    };
-  }, [functionPath]);
-  const queryKey = useMemo(() => lunoraQueryKey(functionRef, args, shardKey), [functionRef.__lunoraRef, JSON.stringify(args), shardKey]);
-  const {
-    data
-  } = useQuery({
-    // Seed the cache with the server value so the first paint doesn't
-    // re-fetch. TanStack treats `initialData` as fresh — the WS push from
-    // the registry is what supplies subsequent updates.
-    initialData: value,
-    queryFn: () => client.query(functionRef, args, {
-      shardKey
-    }),
-    queryKey,
-    staleTime: Number.POSITIVE_INFINITY
-  });
-  useEffect(() => {
-    const registry = getSubscriptionRegistry(client);
-    return registry.attach(queryClient, queryKey, functionRef, args, shardKey);
-  }, [client, queryClient, serializeQueryKey(queryKey)]);
-  return data ?? value;
-};
-const hydratePreloaded = function(preloaded) {
-  return usePreloadedQuery(preloaded);
-};
-
-export { usePreloadedQuery as default, hydratePreloaded };

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 };

package/dist/packem_shared/query-options.d-D4okOpO8.d.mts

@@ -1,38 +0,0 @@
-import { FunctionReference, ReturnOf, LunoraClient, ArgsOf } from '@lunora/client';
-import { QueryKey } from '@tanstack/react-query';
-/**
-* Pure, transport-free adapter between a Lunora function reference and a
-* TanStack Query options object. No `"use client"` directive and only a
-* type-level `@lunora/client` import, so it is safe to use on either side of an
-* RSC boundary (the runtime transport is the `LunoraClient` you pass in).
-*
-* Use it when you want to drive a Lunora query through TanStack's own hooks —
-* `useSuspenseQuery`, `useQueries`, or the server-side
-* `queryClient.ensureQueryData` / `prefetchQuery` — rather than the first-class
-* `useQuery` from `@lunora/react`.
-*/
-/** Shape returned by `lunoraQueryOptions`, spread into a TanStack hook. */
-interface LunoraQueryOptions<F extends FunctionReference> {
-  queryFn: () => Promise<ReturnOf<F>>;
-  queryKey: QueryKey;
-  staleTime: number;
-}
-/**
-* Build a TanStack Query options object for a Lunora query, keyed identically
-* to the first-class hooks (see `lunoraQueryKey`) so a value fetched through
-* this adapter shares cache identity with anything `useQuery` /
-* `prefetchQuery` reads or writes for the same `(fn, args, shardKey)` triple.
-*
-* ```ts
-* const { data } = useSuspenseQuery(lunoraQueryOptions(client, api.posts.list, {}));
-* ```
-*
-* This is a one-shot fetch: it resolves once and `staleTime` is infinite, so
-* TanStack never refetches on its own. It does not open a WebSocket — for live
-* updates that re-render on every server push, use `useQuery` from
-* `@lunora/react`, which attaches a shared subscription to the same cache key.
-*/
-declare const lunoraQueryOptions: <F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
-  shardKey?: string;
-}) => LunoraQueryOptions<F>;
-export { LunoraQueryOptions as L, lunoraQueryOptions as l };

package/dist/packem_shared/query-options.d-D4okOpO8.d.ts

@@ -1,38 +0,0 @@
-import { FunctionReference, ReturnOf, LunoraClient, ArgsOf } from '@lunora/client';
-import { QueryKey } from '@tanstack/react-query';
-/**
-* Pure, transport-free adapter between a Lunora function reference and a
-* TanStack Query options object. No `"use client"` directive and only a
-* type-level `@lunora/client` import, so it is safe to use on either side of an
-* RSC boundary (the runtime transport is the `LunoraClient` you pass in).
-*
-* Use it when you want to drive a Lunora query through TanStack's own hooks —
-* `useSuspenseQuery`, `useQueries`, or the server-side
-* `queryClient.ensureQueryData` / `prefetchQuery` — rather than the first-class
-* `useQuery` from `@lunora/react`.
-*/
-/** Shape returned by `lunoraQueryOptions`, spread into a TanStack hook. */
-interface LunoraQueryOptions<F extends FunctionReference> {
-  queryFn: () => Promise<ReturnOf<F>>;
-  queryKey: QueryKey;
-  staleTime: number;
-}
-/**
-* Build a TanStack Query options object for a Lunora query, keyed identically
-* to the first-class hooks (see `lunoraQueryKey`) so a value fetched through
-* this adapter shares cache identity with anything `useQuery` /
-* `prefetchQuery` reads or writes for the same `(fn, args, shardKey)` triple.
-*
-* ```ts
-* const { data } = useSuspenseQuery(lunoraQueryOptions(client, api.posts.list, {}));
-* ```
-*
-* This is a one-shot fetch: it resolves once and `staleTime` is infinite, so
-* TanStack never refetches on its own. It does not open a WebSocket — for live
-* updates that re-render on every server push, use `useQuery` from
-* `@lunora/react`, which attaches a shared subscription to the same cache key.
-*/
-declare const lunoraQueryOptions: <F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
-  shardKey?: string;
-}) => LunoraQueryOptions<F>;
-export { LunoraQueryOptions as L, lunoraQueryOptions as l };

package/dist/packem_shared/useQuery-C5S0W-7K.mjs

@@ -1,41 +0,0 @@
-'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 { useLunora } from './LunoraProvider-D38Xp16l.mjs';
-import { l as lunoraQueryKey, a as stableStringify, s as serializeQueryKey } from './query-key-C5rufkEE.mjs';
-
-const useQuery = (function_, args, options = {}) => {
-  const client = useLunora();
-  const queryClient = useQueryClient();
-  const {
-    shardKey
-  } = options;
-  const skipped = args === "skip";
-  const argsRecord = skipped ? {} : args;
-  const queryKey = useMemo(() => lunoraQueryKey(function_, argsRecord, shardKey), [function_.__lunoraRef, stableStringify(argsRecord), shardKey]);
-  const {
-    data
-  } = useQuery$1({
-    enabled: !skipped,
-    queryFn: () => client.query(function_, argsRecord, {
-      shardKey
-    }),
-    queryKey,
-    // Lunora is push-driven: once the initial fetch resolves, the WS owns
-    // freshness. Staleness only matters when the subscription is missing,
-    // and the registry handles that with a polling fallback.
-    staleTime: Number.POSITIVE_INFINITY
-  });
-  useEffect(() => {
-    if (skipped) {
-      return () => {
-      };
-    }
-    const registry = getSubscriptionRegistry(client);
-    return registry.attach(queryClient, queryKey, function_, argsRecord, shardKey);
-  }, [client, queryClient, serializeQueryKey(queryKey), skipped]);
-  return data;
-};
-
-export { useQuery as default };