@lunora/react 1.0.0-alpha.25 → 1.0.0-alpha.250

package/dist/packem_shared/cache-D1O_xfAe.mjs

@@ -1,80 +0,0 @@
-import { k as keyHash } from './query-key-BmCbgidV.mjs';
-
-class LunoraSubscriptionRegistry {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  entries = /* @__PURE__ */ new Map();
-  /**
-   * Hash a TanStack `queryKey` to the internal registry index. Exposed so a
-   * hook can look up the registry without re-implementing the hash.
-   */
-  // eslint-disable-next-line class-methods-use-this -- instance method by design: callers reach the hash through a registry handle rather than importing the module-level helper.
-  keyOf(queryKey) {
-    return keyHash(queryKey);
-  }
-  /**
-   * Attach a consumer to the live subscription for `queryKey`. The first
-   * attach opens the underlying WS subscription; subsequent attaches reuse
-   * it (refcount-bumped). Returns the detach function — call it exactly once
-   * per attach.
-   */
-  attach(queryClient, queryKey, function_, args, shardKey, options = {}) {
-    const key = keyHash(queryKey);
-    let entry = this.entries.get(key);
-    if (!entry) {
-      entry = {
-        pollTimer: void 0,
-        refCount: 0,
-        unsubscribe: void 0
-      };
-      this.entries.set(key, entry);
-      try {
-        entry.unsubscribe = this.client.subscribe(function_, args, (value) => {
-          queryClient.setQueryData(queryKey, value);
-        }, {
-          shardKey
-        });
-      } catch {
-        entry.pollTimer = setInterval(() => {
-          queryClient.invalidateQueries({
-            queryKey
-          }).catch(() => {
-          });
-        }, options.pollIntervalMs ?? 5e3);
-      }
-    }
-    entry.refCount += 1;
-    let detached = false;
-    return () => {
-      if (detached) {
-        return;
-      }
-      detached = true;
-      const current = this.entries.get(key);
-      if (!current) {
-        return;
-      }
-      current.refCount -= 1;
-      if (current.refCount <= 0) {
-        current.unsubscribe?.();
-        if (current.pollTimer) {
-          clearInterval(current.pollTimer);
-        }
-        this.entries.delete(key);
-      }
-    };
-  }
-}
-const registryByClient = /* @__PURE__ */ new WeakMap();
-const getSubscriptionRegistry = (client) => {
-  let registry = registryByClient.get(client);
-  if (!registry) {
-    registry = new LunoraSubscriptionRegistry(client);
-    registryByClient.set(client, registry);
-  }
-  return registry;
-};
-
-export { getSubscriptionRegistry as g };

package/dist/packem_shared/hydratePreloaded-uMDH_xA9.mjs

@@ -1,54 +0,0 @@
-'use client';
-import { c } from 'react/compiler-runtime';
-import { useQueryClient, useQuery } from '@tanstack/react-query';
-import { useEffect } from 'react';
-import { g as getSubscriptionRegistry } from './cache-D1O_xfAe.mjs';
-import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
-import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-BmCbgidV.mjs';
-
-const usePreloadedQuery = function(preloaded) {
-  const $ = c(4);
-  const client = useLunora();
-  const queryClient = useQueryClient();
-  const {
-    args,
-    functionPath,
-    shardKey,
-    value
-  } = preloaded;
-  const functionRef = {
-    __lunoraRef: functionPath
-  };
-  const queryKey = lunoraQueryKey(functionRef, args, shardKey);
-  const {
-    data
-  } = useQuery({
-    initialData: value,
-    queryFn: () => client.query(functionRef, args, {
-      shardKey
-    }),
-    queryKey,
-    staleTime: Number.POSITIVE_INFINITY
-  });
-  const t0 = serializeQueryKey(queryKey);
-  let t1;
-  if ($[0] !== client || $[1] !== queryClient || $[2] !== t0) {
-    t1 = [client, queryClient, t0];
-    $[0] = client;
-    $[1] = queryClient;
-    $[2] = t0;
-    $[3] = t1;
-  } else {
-    t1 = $[3];
-  }
-  useEffect(() => {
-    const registry = getSubscriptionRegistry(client);
-    return registry.attach(queryClient, queryKey, functionRef, args, shardKey);
-  }, t1);
-  return data === void 0 ? value : data;
-};
-const hydratePreloaded = function(preloaded) {
-  return usePreloadedQuery(preloaded);
-};
-
-export { usePreloadedQuery as default, hydratePreloaded };

package/dist/packem_shared/lunoraQueryOptions-C3uwOTMW.mjs

@@ -1,16 +0,0 @@
-import { l as lunoraQueryKey } from './query-key-BmCbgidV.mjs';
-
-const lunoraQueryOptions = (client, function_, args, options = {}) => {
-  const argsRecord = args ?? {};
-  return {
-    queryFn: () => client.query(function_, argsRecord, {
-      shardKey: options.shardKey
-    }),
-    queryKey: lunoraQueryKey(function_, argsRecord, options.shardKey),
-    // Lunora is push-driven: the value never goes stale on a timer. For
-    // reactivity use `useQuery`; this adapter is a one-shot/suspense read.
-    staleTime: Number.POSITIVE_INFINITY
-  };
-};
-
-export { lunoraQueryOptions };

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

@@ -1,13 +0,0 @@
-import { s as stableStringify } from './stable-key-CGp4e2Ux.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/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/stable-key-CGp4e2Ux.mjs

@@ -1,38 +0,0 @@
-const compareKeys = (a, b) => {
-  if (a < b) {
-    return -1;
-  }
-  return a > b ? 1 : 0;
-};
-const stableStringify = (value) => {
-  if (value === void 0) {
-    return "null";
-  }
-  if (typeof value === "bigint") {
-    throw new TypeError("stableStringify: cannot use a bigint in a cache key (query/subscription/shape args) — pass it as a string");
-  }
-  if (value === null || typeof value !== "object") {
-    return JSON.stringify(value);
-  }
-  if (Array.isArray(value)) {
-    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
-  }
-  const proto = Object.getPrototypeOf(value);
-  if (proto !== null && proto !== Object.prototype) {
-    const name = value.constructor?.name ?? "value";
-    throw new TypeError(`stableStringify: cannot use a ${name} in a cache key (query/subscription/shape args) — only plain objects, arrays, and JSON primitives are supported`);
-  }
-  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-DafedU4l.mjs

@@ -1,179 +0,0 @@
-'use client';
-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-D1O_xfAe.mjs';
-import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
-import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-BmCbgidV.mjs';
-
-const useLazyRef = function(create) {
-  const reference = useRef(void 0);
-  reference.current ??= create();
-  return reference;
-};
-
-const usePaginatedCore = function(function_, args, options) {
-  const client = useLunora();
-  const queryClient = useQueryClient();
-  const {
-    initialNumItems,
-    shardKey
-  } = options;
-  const skipped = args === "skip";
-  const baseArgs = skipped ? {} : args;
-  const [, forceRender] = useReducer((tick) => tick + 1, 0);
-  const [pages, setPages] = useState(() => initialPages(initialNumItems));
-  const resetKey = `${serializeQueryKey(lunoraQueryKey(function_, baseArgs, shardKey))}::${String(initialNumItems)}`;
-  const resetKeyRef = useRef(resetKey);
-  if (resetKeyRef.current !== resetKey) {
-    resetKeyRef.current = resetKey;
-    setPages(initialPages(initialNumItems));
-  }
-  const pageEntries = pages.map((page) => {
-    const pageArgs = {
-      ...baseArgs,
-      paginationOpts: {
-        cursor: page.lower,
-        endCursor: page.upper,
-        numItems: page.numItems
-      }
-    };
-    const key = lunoraQueryKey(function_, pageArgs, shardKey);
-    return {
-      args: pageArgs,
-      key
-    };
-  });
-  const pageKeysHash = pageEntries.map(({
-    key: key_0
-  }) => serializeQueryKey(key_0)).join("|");
-  const desiredRef = useRef({
-    baseArgs,
-    entries: [],
-    fn: function_,
-    shardKey
-  });
-  useEffect(() => {
-    desiredRef.current = {
-      baseArgs,
-      entries: pageEntries,
-      fn: function_,
-      shardKey
-    };
-  });
-  const detachesRef = useLazyRef(() => /* @__PURE__ */ new Map());
-  const detachClientRef = useRef(client);
-  useEffect(() => {
-    const detaches = detachesRef.current;
-    if (detachClientRef.current !== client) {
-      for (const detach of detaches.values()) {
-        detach();
-      }
-      detaches.clear();
-      detachClientRef.current = client;
-    }
-    if (skipped) {
-      for (const detach_0 of detaches.values()) {
-        detach_0();
-      }
-      detaches.clear();
-      return;
-    }
-    const desired = desiredRef.current;
-    const registry = getSubscriptionRegistry(client);
-    const wanted = new Set(desired.entries.map(({
-      key: key_1
-    }) => serializeQueryKey(key_1)));
-    for (const [hash, detach_1] of detaches) {
-      if (!wanted.has(hash)) {
-        detach_1();
-        detaches.delete(hash);
-      }
-    }
-    for (const entry of desired.entries) {
-      const hash_0 = serializeQueryKey(entry.key);
-      if (detaches.has(hash_0)) {
-        continue;
-      }
-      const initialFetch = queryClient.fetchQuery({
-        queryFn: () => client.query(desired.fn, entry.args, {
-          shardKey: desired.shardKey
-        }),
-        queryKey: entry.key,
-        staleTime: 0
-      });
-      initialFetch.catch(() => {
-      });
-      detaches.set(hash_0, registry.attach(queryClient, entry.key, desired.fn, entry.args, desired.shardKey));
-    }
-  }, [client, queryClient, pageKeysHash, skipped]);
-  useEffect(
-    () => () => {
-      for (const detach_2 of detachesRef.current.values()) {
-        detach_2();
-      }
-      detachesRef.current.clear();
-    },
-    // react-doctor-disable-next-line react-doctor/exhaustive-deps -- intentional: unmount-only cleanup. `detachesRef` is a stable ref, so the empty dep array is correct — the teardown must run once on unmount, not every render.
-    []
-  );
-  useEffect(() => {
-    const cache = queryClient.getQueryCache();
-    const unsubscribe = cache.subscribe((event) => {
-      if (event.type !== "updated") {
-        return;
-      }
-      const hash_1 = serializeQueryKey(event.query.queryKey);
-      if (pageEntries.some(({
-        key: key_2
-      }) => serializeQueryKey(key_2) === hash_1)) {
-        forceRender();
-      }
-    });
-    return unsubscribe;
-  }, [queryClient, pageKeysHash]);
-  const pageResults = skipped ? [] : pageEntries.map(({
-    key: key_3
-  }) => queryClient.getQueryData(key_3));
-  useEffect(() => {
-    if (skipped) {
-      return;
-    }
-    const next = rebalance(pages, pageResults);
-    if (next) {
-      setPages(next);
-    }
-  });
-  const {
-    status
-  } = derivePaginationStatus(skipped, pageResults);
-  const loadMore = useCallback((numberItems) => {
-    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,
-    status
-  };
-};
-
-export { usePaginatedCore as u };

package/dist/packem_shared/useAgent-DwLxTc3P.mjs

@@ -1,101 +0,0 @@
-'use client';
-import { c } from 'react/compiler-runtime';
-import { useMutation } from './useMutation-BeqeIjTr.mjs';
-import useSubscription from './useSubscription-D38Jdyr8.mjs';
-
-const NO_MUTATION_REF = {
-  __lunoraRef: ""
-};
-const useAgent = (options) => {
-  const $ = c(17);
-  const {
-    api,
-    cancel: cancelReference,
-    run: runReference,
-    runArgs,
-    threadKey
-  } = options;
-  const runMutation = useMutation(runReference);
-  const cancelMutation = useMutation(cancelReference ?? NO_MUTATION_REF);
-  let t0;
-  if ($[0] !== threadKey) {
-    t0 = {
-      key: threadKey
-    };
-    $[0] = threadKey;
-    $[1] = t0;
-  } else {
-    t0 = $[1];
-  }
-  const {
-    data: threadData
-  } = useSubscription(api.agents.agentThread, t0);
-  const thread = threadData;
-  const status = thread?.status;
-  const instanceId = thread?.instanceId;
-  const {
-    mutate: runMutate
-  } = runMutation;
-  const {
-    mutate: cancelMutate
-  } = cancelMutation;
-  let t1;
-  if ($[2] !== runArgs || $[3] !== runMutate || $[4] !== threadKey) {
-    t1 = async (input, args) => {
-      await runMutate({
-        input,
-        threadKey,
-        ...runArgs,
-        ...args
-      });
-    };
-    $[2] = runArgs;
-    $[3] = runMutate;
-    $[4] = threadKey;
-    $[5] = t1;
-  } else {
-    t1 = $[5];
-  }
-  const run = t1;
-  let t2;
-  if ($[6] !== cancelMutate || $[7] !== cancelReference || $[8] !== instanceId || $[9] !== threadKey) {
-    t2 = async () => {
-      if (cancelReference === void 0 || instanceId === void 0) {
-        return;
-      }
-      await cancelMutate({
-        instanceId,
-        threadKey
-      });
-    };
-    $[6] = cancelMutate;
-    $[7] = cancelReference;
-    $[8] = instanceId;
-    $[9] = threadKey;
-    $[10] = t2;
-  } else {
-    t2 = $[10];
-  }
-  const cancel = t2;
-  let t3;
-  if ($[11] !== cancel || $[12] !== run || $[13] !== runMutation.pending || $[14] !== status || $[15] !== thread) {
-    t3 = {
-      cancel,
-      pending: runMutation.pending,
-      run,
-      status,
-      thread
-    };
-    $[11] = cancel;
-    $[12] = run;
-    $[13] = runMutation.pending;
-    $[14] = status;
-    $[15] = thread;
-    $[16] = t3;
-  } else {
-    t3 = $[16];
-  }
-  return t3;
-};
-
-export { useAgent };