@lunora/react 1.0.0-alpha.39 → 1.0.0-alpha.40

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { ReactNode, ReactElement } from 'react';
-import { LunoraClient, OptimisticUpdate, User, FunctionReference, ClientQueryRef, ConnectionStatus, ArgsOf, ReturnOf, HttpStreamRef, HttpStreamArgsOf, HttpStreamChunkOf, MutatorHandle, Preloaded } from '@lunora/client';
+import { LunoraClient, OptimisticUpdate, User, AuthImpersonation, AuthSession, AuthUser, FunctionReference, ClientQueryRef, ConnectionStatus, ArgsOf, ReturnOf, HttpStreamRef, HttpStreamArgsOf, HttpStreamChunkOf, MutatorHandle, Preloaded } from '@lunora/client';
 export { type ArgsOf, type ClientQueryRef, type FunctionReference, type HttpStreamArgsOf, type HttpStreamChunkOf, type HttpStreamRef, type LunoraClient, type LunoraErrorCode, type MutatorHandle, type MutatorTransaction, type OptimisticLocalStore, type OptimisticUpdate, type Preloaded, type ReturnOf, type User, createClientQuery, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from '@lunora/client';
 import { QueryClient } from '@tanstack/react-query';
 export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-CdgGQ9s4.mjs";
@@ -199,6 +199,136 @@ interface UseAuthResult {
   token: string | null;
   user: User | null;
 }
+/** The shape every list hook in this file returns. */
+interface AdminAuthListResult<T> {
+  /** Rows loaded so far (the full current window, not just the latest page). `undefined` before the first response. */
+  readonly data: ReadonlyArray<T> | undefined;
+  /** The read error, or `undefined`. */
+  readonly error: Error | undefined;
+  /**
+   * `true` when the server reports more rows exist beyond the current window
+   * (`total > data.length`). `false` before the first response resolves.
+   */
+  readonly hasMore: boolean;
+  /** `true` only before the first response has resolved (matches TanStack's `isLoading`, not `isFetching`). */
+  readonly loading: boolean;
+  /**
+   * Grow the requested window by one page and re-fetch. A no-op while
+   * `hasMore` is `false`. This is a growing-window re-fetch (re-request
+   * `{ limit }` from the top), not a page-accumulator — `AuthPage` is
+   * offset/limit-based, not cursor-based, and there is no live delta stream
+   * to keep page boundaries stable against (unlike
+   * `@lunora/react`'s `usePaginatedQuery`). See the design doc for the
+   * trade-off.
+   */
+  readonly loadMore: () => void;
+  /** Re-run the read — e.g. after a caller performs a mutation via a plain `client.*` call (mirrors Studio's `onDone={refetchOrgs}` pattern). */
+  readonly refetch: () => void;
+  /** `AuthPage.total` — the server-reported row count across the whole collection, not just the current window. `undefined` before the first response. */
+  readonly total: number | undefined;
+}
+/** Options shared by every `useAuthUsers`-style hook. */
+interface AdminAuthQueryOptions {
+  /** Gate the read (rules-of-hooks safe). Defaults to `true`. */
+  enabled?: boolean;
+  /** Page size for the first read; `loadMore` grows the window by this amount. Defaults to 50. */
+  pageSize?: number;
+}
+/** Options for {@link useAuthUsers}. */
+interface UseAuthUsersOptions extends AdminAuthQueryOptions {
+  filterField?: string;
+  filterValue?: string;
+  search?: string;
+  searchField?: string;
+  sortBy?: string;
+  sortDirection?: "asc" | "desc";
+}
+/**
+ * List authenticated users, paged and optionally searched/filtered/sorted.
+ * Hits the admin-gated `GET /_lunora/admin/auth/users` HTTP endpoint via
+ * `client.listAuthUsers` (never the WS/live transport) — the worker must be
+ * built with an `authAdmin` and `adminToken`.
+ *
+ * Mirrors `packages/studio/src/features/auth/users-panel.tsx`'s
+ * `useClientQuery(["lunora-auth-users", …], () => client.listAuthUsers(…))`
+ * read, minus the studio-specific polling (`useAutoRefresh`) — an app using
+ * this hook decides its own refresh cadence by calling `refetch()`.
+ */
+declare const useAuthUsers: (options?: UseAuthUsersOptions) => AdminAuthListResult<AuthUser>;
+/** Options for {@link useOrganizations}. */
+type UseOrganizationsOptions = AdminAuthQueryOptions;
+/**
+ * List organizations (requires the better-auth `organization` plugin).
+ * Hits `client.listAuthOrganizations` — an HTTP-only admin-gated read, same
+ * transport note as {@link useAuthUsers}.
+ *
+ * Mirrors `organizations-panel.tsx`'s
+ * `useClientQuery(["lunora-auth-orgs"], () => client.listAuthOrganizations({ limit: 100 }))`.
+ * Mutations (`client.createAuthOrganization`, `client.deleteAuthOrganization`,
+ * …) stay plain `client.*` calls; call this hook's `refetch()` afterward —
+ * see the design doc's "mutation ergonomics" section for why no hidden
+ * invalidation-on-mutate is wired in.
+ */
+declare const useOrganizations: (options?: UseOrganizationsOptions) => AdminAuthListResult<Record<string, unknown>>;
+/** Options for {@link useAuthSessions}. */
+interface UseAuthSessionsOptions extends AdminAuthQueryOptions {
+  /** Scope the list to one user's sessions; omit for the global cross-user browser. */
+  userId?: string;
+}
+/**
+ * List auth sessions, paged and optionally scoped to one user. Hits
+ * `client.listAuthSessions` — HTTP-only, same transport note as
+ * {@link useAuthUsers}.
+ *
+ * Mirrors `auth-sessions-panel.tsx`'s
+ * `useClientQuery(["lunora-auth-sessions", …], () => client.listAuthSessions({ limit }))`.
+ * Revoking a session (`client.revokeAuthSession`/`revokeAuthUserSessions`)
+ * stays a plain `client.*` call followed by this hook's `refetch()`.
+ */
+declare const useAuthSessions: (options?: UseAuthSessionsOptions) => AdminAuthListResult<AuthSession>;
+/** Everything {@link useImpersonate} returns. */
+interface UseImpersonateResult {
+  /** The latest successful impersonation's token + user + expiry, or `undefined`. */
+  readonly data: AuthImpersonation | undefined;
+  /** The latest attempt's error, or `undefined`. */
+  readonly error: Error | undefined;
+  /**
+   * Mint an impersonation session for `userId`, resolving its bearer
+   * `AuthImpersonation`. Deliberately does **not** call
+   * `client.setAuthToken(...)` on the current client — see the security
+   * note below.
+   */
+  readonly impersonate: (userId: string) => Promise<AuthImpersonation>;
+  /** `true` while an impersonation request is in flight. */
+  readonly pending: boolean;
+  /** Clear `data`/`error` back to idle. */
+  readonly reset: () => void;
+}
+/**
+ * Mint an impersonation session via `client.impersonateAuthUser` — the one
+ * genuinely mutation-shaped hook of the four prototyped here (TanStack
+ * `useMutation` underneath, matching `@lunora/react`'s own `useMutation`
+ * ergonomics: `data`/`error`/`pending`/`reset`).
+ *
+ * **Security note (open question — see the design doc):** Studio's
+ * `user-detail-drawer.tsx` (`onImpersonate`) mints the token and displays it
+ * in a read-only text field; it never calls `client.setAuthToken(token)` on
+ * the admin's own client instance. This hook preserves that discipline
+ * deliberately — silently swapping the *current* session would sign the
+ * admin out of their own admin session with no visible transition and no
+ * "return to admin" path. The caller decides what to do with the resolved
+ * `AuthImpersonation` (open a second tab/incognito window authenticated as
+ * the target user, surface it for manual copy, etc.). What the ideal UX is
+ * (a dedicated "Acting as X — Return to admin" banner + explicit swap-back)
+ * is an open product question this spike does not resolve.
+ *
+ * Unlike the three list hooks, impersonating a user has no single paired
+ * list to invalidate (it may affect a sessions list, but not the user/org
+ * list currently being viewed) — mirroring Studio's own `refresh: false` on
+ * this action, this hook does not auto-invalidate anything. A caller that
+ * also renders `useAuthSessions` can call its `refetch()` explicitly.
+ */
+declare const useImpersonate: () => UseImpersonateResult;
 /**
  * The lifecycle status stored on an agent thread. Client-safe mirror of
  * `@lunora/agent`'s `AgentThreadStatus` — re-declared here (rather than imported)
@@ -1135,4 +1265,4 @@ interface UseVoiceAgentResult {
  * `createSocket`) so the hook is drivable outside a browser.
  */
 declare const useVoiceAgent: (options: UseVoiceAgentOptions) => UseVoiceAgentResult;
-export { type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, 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 UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseCheckoutResult, type UseHttpStreamOptions, type UseHttpStreamResult, 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, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, hydratePreloaded, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useAuthState, useCheckout, useClientQuery, useConnectionStatus, useFlag, useFlags, useHttpStream, useInfiniteQuery, useLunora, useMutation, useMutator, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription, useVoiceAgent };
+export { type AdminAuthListResult, type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, 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 UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseAuthSessionsOptions, type UseAuthUsersOptions, type UseCheckoutResult, type UseHttpStreamOptions, type UseHttpStreamResult, type UseImpersonateResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UseOrganizationsOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, hydratePreloaded, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useAuthSessions, useAuthState, useAuthUsers, useCheckout, useClientQuery, useConnectionStatus, useFlag, useFlags, useHttpStream, useImpersonate, useInfiniteQuery, useLunora, useMutation, useMutator, useOrganizations, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription, useVoiceAgent };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode, ReactElement } from 'react';
-import { LunoraClient, OptimisticUpdate, User, FunctionReference, ClientQueryRef, ConnectionStatus, ArgsOf, ReturnOf, HttpStreamRef, HttpStreamArgsOf, HttpStreamChunkOf, MutatorHandle, Preloaded } from '@lunora/client';
+import { LunoraClient, OptimisticUpdate, User, AuthImpersonation, AuthSession, AuthUser, FunctionReference, ClientQueryRef, ConnectionStatus, ArgsOf, ReturnOf, HttpStreamRef, HttpStreamArgsOf, HttpStreamChunkOf, MutatorHandle, Preloaded } from '@lunora/client';
 export { type ArgsOf, type ClientQueryRef, type FunctionReference, type HttpStreamArgsOf, type HttpStreamChunkOf, type HttpStreamRef, type LunoraClient, type LunoraErrorCode, type MutatorHandle, type MutatorTransaction, type OptimisticLocalStore, type OptimisticUpdate, type Preloaded, type ReturnOf, type User, createClientQuery, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from '@lunora/client';
 import { QueryClient } from '@tanstack/react-query';
 export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-CdgGQ9s4.js";
@@ -199,6 +199,136 @@ interface UseAuthResult {
   token: string | null;
   user: User | null;
 }
+/** The shape every list hook in this file returns. */
+interface AdminAuthListResult<T> {
+  /** Rows loaded so far (the full current window, not just the latest page). `undefined` before the first response. */
+  readonly data: ReadonlyArray<T> | undefined;
+  /** The read error, or `undefined`. */
+  readonly error: Error | undefined;
+  /**
+   * `true` when the server reports more rows exist beyond the current window
+   * (`total > data.length`). `false` before the first response resolves.
+   */
+  readonly hasMore: boolean;
+  /** `true` only before the first response has resolved (matches TanStack's `isLoading`, not `isFetching`). */
+  readonly loading: boolean;
+  /**
+   * Grow the requested window by one page and re-fetch. A no-op while
+   * `hasMore` is `false`. This is a growing-window re-fetch (re-request
+   * `{ limit }` from the top), not a page-accumulator — `AuthPage` is
+   * offset/limit-based, not cursor-based, and there is no live delta stream
+   * to keep page boundaries stable against (unlike
+   * `@lunora/react`'s `usePaginatedQuery`). See the design doc for the
+   * trade-off.
+   */
+  readonly loadMore: () => void;
+  /** Re-run the read — e.g. after a caller performs a mutation via a plain `client.*` call (mirrors Studio's `onDone={refetchOrgs}` pattern). */
+  readonly refetch: () => void;
+  /** `AuthPage.total` — the server-reported row count across the whole collection, not just the current window. `undefined` before the first response. */
+  readonly total: number | undefined;
+}
+/** Options shared by every `useAuthUsers`-style hook. */
+interface AdminAuthQueryOptions {
+  /** Gate the read (rules-of-hooks safe). Defaults to `true`. */
+  enabled?: boolean;
+  /** Page size for the first read; `loadMore` grows the window by this amount. Defaults to 50. */
+  pageSize?: number;
+}
+/** Options for {@link useAuthUsers}. */
+interface UseAuthUsersOptions extends AdminAuthQueryOptions {
+  filterField?: string;
+  filterValue?: string;
+  search?: string;
+  searchField?: string;
+  sortBy?: string;
+  sortDirection?: "asc" | "desc";
+}
+/**
+ * List authenticated users, paged and optionally searched/filtered/sorted.
+ * Hits the admin-gated `GET /_lunora/admin/auth/users` HTTP endpoint via
+ * `client.listAuthUsers` (never the WS/live transport) — the worker must be
+ * built with an `authAdmin` and `adminToken`.
+ *
+ * Mirrors `packages/studio/src/features/auth/users-panel.tsx`'s
+ * `useClientQuery(["lunora-auth-users", …], () => client.listAuthUsers(…))`
+ * read, minus the studio-specific polling (`useAutoRefresh`) — an app using
+ * this hook decides its own refresh cadence by calling `refetch()`.
+ */
+declare const useAuthUsers: (options?: UseAuthUsersOptions) => AdminAuthListResult<AuthUser>;
+/** Options for {@link useOrganizations}. */
+type UseOrganizationsOptions = AdminAuthQueryOptions;
+/**
+ * List organizations (requires the better-auth `organization` plugin).
+ * Hits `client.listAuthOrganizations` — an HTTP-only admin-gated read, same
+ * transport note as {@link useAuthUsers}.
+ *
+ * Mirrors `organizations-panel.tsx`'s
+ * `useClientQuery(["lunora-auth-orgs"], () => client.listAuthOrganizations({ limit: 100 }))`.
+ * Mutations (`client.createAuthOrganization`, `client.deleteAuthOrganization`,
+ * …) stay plain `client.*` calls; call this hook's `refetch()` afterward —
+ * see the design doc's "mutation ergonomics" section for why no hidden
+ * invalidation-on-mutate is wired in.
+ */
+declare const useOrganizations: (options?: UseOrganizationsOptions) => AdminAuthListResult<Record<string, unknown>>;
+/** Options for {@link useAuthSessions}. */
+interface UseAuthSessionsOptions extends AdminAuthQueryOptions {
+  /** Scope the list to one user's sessions; omit for the global cross-user browser. */
+  userId?: string;
+}
+/**
+ * List auth sessions, paged and optionally scoped to one user. Hits
+ * `client.listAuthSessions` — HTTP-only, same transport note as
+ * {@link useAuthUsers}.
+ *
+ * Mirrors `auth-sessions-panel.tsx`'s
+ * `useClientQuery(["lunora-auth-sessions", …], () => client.listAuthSessions({ limit }))`.
+ * Revoking a session (`client.revokeAuthSession`/`revokeAuthUserSessions`)
+ * stays a plain `client.*` call followed by this hook's `refetch()`.
+ */
+declare const useAuthSessions: (options?: UseAuthSessionsOptions) => AdminAuthListResult<AuthSession>;
+/** Everything {@link useImpersonate} returns. */
+interface UseImpersonateResult {
+  /** The latest successful impersonation's token + user + expiry, or `undefined`. */
+  readonly data: AuthImpersonation | undefined;
+  /** The latest attempt's error, or `undefined`. */
+  readonly error: Error | undefined;
+  /**
+   * Mint an impersonation session for `userId`, resolving its bearer
+   * `AuthImpersonation`. Deliberately does **not** call
+   * `client.setAuthToken(...)` on the current client — see the security
+   * note below.
+   */
+  readonly impersonate: (userId: string) => Promise<AuthImpersonation>;
+  /** `true` while an impersonation request is in flight. */
+  readonly pending: boolean;
+  /** Clear `data`/`error` back to idle. */
+  readonly reset: () => void;
+}
+/**
+ * Mint an impersonation session via `client.impersonateAuthUser` — the one
+ * genuinely mutation-shaped hook of the four prototyped here (TanStack
+ * `useMutation` underneath, matching `@lunora/react`'s own `useMutation`
+ * ergonomics: `data`/`error`/`pending`/`reset`).
+ *
+ * **Security note (open question — see the design doc):** Studio's
+ * `user-detail-drawer.tsx` (`onImpersonate`) mints the token and displays it
+ * in a read-only text field; it never calls `client.setAuthToken(token)` on
+ * the admin's own client instance. This hook preserves that discipline
+ * deliberately — silently swapping the *current* session would sign the
+ * admin out of their own admin session with no visible transition and no
+ * "return to admin" path. The caller decides what to do with the resolved
+ * `AuthImpersonation` (open a second tab/incognito window authenticated as
+ * the target user, surface it for manual copy, etc.). What the ideal UX is
+ * (a dedicated "Acting as X — Return to admin" banner + explicit swap-back)
+ * is an open product question this spike does not resolve.
+ *
+ * Unlike the three list hooks, impersonating a user has no single paired
+ * list to invalidate (it may affect a sessions list, but not the user/org
+ * list currently being viewed) — mirroring Studio's own `refresh: false` on
+ * this action, this hook does not auto-invalidate anything. A caller that
+ * also renders `useAuthSessions` can call its `refetch()` explicitly.
+ */
+declare const useImpersonate: () => UseImpersonateResult;
 /**
  * The lifecycle status stored on an agent thread. Client-safe mirror of
  * `@lunora/agent`'s `AgentThreadStatus` — re-declared here (rather than imported)
@@ -1135,4 +1265,4 @@ interface UseVoiceAgentResult {
  * `createSocket`) so the hook is drivable outside a browser.
  */
 declare const useVoiceAgent: (options: UseVoiceAgentOptions) => UseVoiceAgentResult;
-export { type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, 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 UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseCheckoutResult, type UseHttpStreamOptions, type UseHttpStreamResult, 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, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, hydratePreloaded, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useAuthState, useCheckout, useClientQuery, useConnectionStatus, useFlag, useFlags, useHttpStream, useInfiniteQuery, useLunora, useMutation, useMutator, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription, useVoiceAgent };
+export { type AdminAuthListResult, type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, 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 UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseAuthSessionsOptions, type UseAuthUsersOptions, type UseCheckoutResult, type UseHttpStreamOptions, type UseHttpStreamResult, type UseImpersonateResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UseOrganizationsOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, hydratePreloaded, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useAuthSessions, useAuthState, useAuthUsers, useCheckout, useClientQuery, useConnectionStatus, useFlag, useFlags, useHttpStream, useImpersonate, useInfiniteQuery, useLunora, useMutation, useMutator, useOrganizations, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription, useVoiceAgent };

package/dist/index.mjs

@@ -1,2 +1,2 @@
 'use client';
-import{AuthLoading as t,Authenticated as o,Unauthenticated as u}from"./packem_shared/AuthLoading-eLWn4Z7G.mjs";import{useAuthState as a}from"./packem_shared/useAuthState-jnCMkIwt.mjs";import{LunoraProvider as f,useLunora as n}from"./packem_shared/LunoraProvider-InsjxtOB.mjs";import{CheckoutButton as d,CustomerPortalButton as i,useCheckout as x}from"./packem_shared/CheckoutButton-DS_DKgNf.mjs";import{lunoraQueryOptions as c}from"./packem_shared/lunoraQueryOptions-BhiUY9ZF.mjs";import{useAgent as h}from"./packem_shared/useAgent-DNKxqQ9F.mjs";import{useAgentChat as A}from"./packem_shared/useAgentChat-BdDuGIHz.mjs";import{useAgentState as U}from"./packem_shared/useAgentState-DO0yz6OU.mjs";import{useAgentToolEvents as P}from"./packem_shared/useAgentToolEvents-DTWZCIfd.mjs";import{default as S}from"./packem_shared/useAuth-CWkJn7i9.mjs";import{default as R}from"./packem_shared/useClientQuery-EPo__hzu.mjs";import{default as M}from"./packem_shared/useConnectionStatus-PL5D-S7t.mjs";import{useFlag as b,useFlags as v}from"./packem_shared/useFlag-Dh7bXXPx.mjs";import{useHttpStream as I}from"./packem_shared/useHttpStream-DFswZrRk.mjs";import{default as z}from"./packem_shared/useInfiniteQuery-DyExohf2.mjs";import{useMutation as O}from"./packem_shared/useMutation-B4uL3Rde.mjs";import{useMutator as j}from"./packem_shared/useMutator-D3CGrk5-.mjs";import{usePaginatedQuery as w}from"./packem_shared/usePaginatedQuery-Roo_jyC9.mjs";import{hydratePreloaded as G,default as J}from"./packem_shared/hydratePreloaded-DltXxPnp.mjs";import{usePresence as N}from"./packem_shared/usePresence-SJBy81um.mjs";import{default as X}from"./packem_shared/useQuery-m-trnMUV.mjs";import{useRateLimit as Z}from"./packem_shared/useRateLimit-DqikMrX9.mjs";import{useStream as $}from"./packem_shared/useStream-CGcSWvPI.mjs";import{default as re}from"./packem_shared/useSubscription-CiQk8tFR.mjs";import{useVoiceAgent as oe}from"./packem_shared/useVoiceAgent-4gj2W2jc.mjs";import{createClientQuery as se,getErrorCode as ae,getRetryAfterMs as pe,isConflictError as fe,isForbiddenError as ne,isRateLimitedError as me,isUnauthorizedError as de}from"@lunora/client";import{RestrictionError as xe,UploadControl as le,UploadError as ce}from"@visulima/storage-client";import{useChunkedRestUpload as he,useFileInput as Ce,useMultipartUpload as Ae,usePasteUpload as ye,useTusUpload as Ue,useUpload as Ee}from"@visulima/storage-client/react";export{t as AuthLoading,o as Authenticated,d as CheckoutButton,i as CustomerPortalButton,f as LunoraProvider,xe as RestrictionError,u as Unauthenticated,le as UploadControl,ce as UploadError,se as createClientQuery,ae as getErrorCode,pe as getRetryAfterMs,G as hydratePreloaded,fe as isConflictError,ne as isForbiddenError,me as isRateLimitedError,de as isUnauthorizedError,c as lunoraQueryOptions,h as useAgent,A as useAgentChat,U as useAgentState,P as useAgentToolEvents,S as useAuth,a as useAuthState,x as useCheckout,he as useChunkedRestUpload,R as useClientQuery,M as useConnectionStatus,Ce as useFileInput,b as useFlag,v as useFlags,I as useHttpStream,z as useInfiniteQuery,n as useLunora,Ae as useMultipartUpload,O as useMutation,j as useMutator,w as usePaginatedQuery,ye as usePasteUpload,J as usePreloadedQuery,N as usePresence,X as useQuery,Z as useRateLimit,$ as useStream,re as useSubscription,Ue as useTusUpload,Ee as useUpload,oe as useVoiceAgent};
+import{AuthLoading as t,Authenticated as o,Unauthenticated as u}from"./packem_shared/AuthLoading-eLWn4Z7G.mjs";import{useAuthState as a}from"./packem_shared/useAuthState-jnCMkIwt.mjs";import{LunoraProvider as f,useLunora as n}from"./packem_shared/LunoraProvider-InsjxtOB.mjs";import{CheckoutButton as i,CustomerPortalButton as d,useCheckout as x}from"./packem_shared/CheckoutButton-DS_DKgNf.mjs";import{lunoraQueryOptions as h}from"./packem_shared/lunoraQueryOptions-BhiUY9ZF.mjs";import{useAuthSessions as A,useAuthUsers as c,useImpersonate as C,useOrganizations as U}from"./packem_shared/useAuthSessions-Dw4Zhtxa.mjs";import{useAgent as E}from"./packem_shared/useAgent-DNKxqQ9F.mjs";import{useAgentChat as Q}from"./packem_shared/useAgentChat-BdDuGIHz.mjs";import{useAgentState as L}from"./packem_shared/useAgentState-DO0yz6OU.mjs";import{useAgentToolEvents as F}from"./packem_shared/useAgentToolEvents-DTWZCIfd.mjs";import{default as k}from"./packem_shared/useAuth-CWkJn7i9.mjs";import{default as b}from"./packem_shared/useClientQuery-EPo__hzu.mjs";import{default as z}from"./packem_shared/useConnectionStatus-PL5D-S7t.mjs";import{useFlag as O,useFlags as T}from"./packem_shared/useFlag-Dh7bXXPx.mjs";import{useHttpStream as V}from"./packem_shared/useHttpStream-DFswZrRk.mjs";import{default as q}from"./packem_shared/useInfiniteQuery-DyExohf2.mjs";import{useMutation as D}from"./packem_shared/useMutation-B4uL3Rde.mjs";import{useMutator as J}from"./packem_shared/useMutator-D3CGrk5-.mjs";import{usePaginatedQuery as N}from"./packem_shared/usePaginatedQuery-Roo_jyC9.mjs";import{hydratePreloaded as X,default as Y}from"./packem_shared/hydratePreloaded-DltXxPnp.mjs";import{usePresence as _}from"./packem_shared/usePresence-xAbekAr_.mjs";import{default as ee}from"./packem_shared/useQuery-m-trnMUV.mjs";import{useRateLimit as te}from"./packem_shared/useRateLimit-DqikMrX9.mjs";import{useStream as ue}from"./packem_shared/useStream-CGcSWvPI.mjs";import{default as ae}from"./packem_shared/useSubscription-CiQk8tFR.mjs";import{useVoiceAgent as fe}from"./packem_shared/useVoiceAgent-4gj2W2jc.mjs";import{createClientQuery as me,getErrorCode as ie,getRetryAfterMs as de,isConflictError as xe,isForbiddenError as le,isRateLimitedError as he,isUnauthorizedError as ge}from"@lunora/client";import{RestrictionError as ce,UploadControl as Ce,UploadError as Ue}from"@visulima/storage-client";import{useChunkedRestUpload as Ee,useFileInput as Pe,useMultipartUpload as Qe,usePasteUpload as Se,useTusUpload as Le,useUpload as Re}from"@visulima/storage-client/react";export{t as AuthLoading,o as Authenticated,i as CheckoutButton,d as CustomerPortalButton,f as LunoraProvider,ce as RestrictionError,u as Unauthenticated,Ce as UploadControl,Ue as UploadError,me as createClientQuery,ie as getErrorCode,de as getRetryAfterMs,X as hydratePreloaded,xe as isConflictError,le as isForbiddenError,he as isRateLimitedError,ge as isUnauthorizedError,h as lunoraQueryOptions,E as useAgent,Q as useAgentChat,L as useAgentState,F as useAgentToolEvents,k as useAuth,A as useAuthSessions,a as useAuthState,c as useAuthUsers,x as useCheckout,Ee as useChunkedRestUpload,b as useClientQuery,z as useConnectionStatus,Pe as useFileInput,O as useFlag,T as useFlags,V as useHttpStream,C as useImpersonate,q as useInfiniteQuery,n as useLunora,Qe as useMultipartUpload,D as useMutation,J as useMutator,U as useOrganizations,N as usePaginatedQuery,Se as usePasteUpload,Y as usePreloadedQuery,_ as usePresence,ee as useQuery,te as useRateLimit,ue as useStream,ae as useSubscription,Le as useTusUpload,Re as useUpload,fe as useVoiceAgent};

package/dist/packem_shared/useAuthSessions-Dw4Zhtxa.mjs

@@ -0,0 +1,2 @@
+'use client';
+import{c as y}from"react/compiler-runtime";import{useMutation as b,useQuery as F,keepPreviousData as v}from"@tanstack/react-query";import{useState as A,useSyncExternalStore as I}from"react";import{useLunora as S}from"./LunoraProvider-InsjxtOB.mjs";const D="lunora-react-admin-auth",P=50;function z(t,e,n,d={}){const{enabled:o=!0,pageSize:u=P}=d,[i,r]=A(u),l=I(f=>t.onAuthTokenChange(f),()=>t.currentIdentity(),()=>t.currentIdentity()),s=[D,l??"anon",...e,i],a=F({enabled:o,placeholderData:v,queryFn:()=>n(i),queryKey:s,staleTime:0}),c=a.data?.rows,h=a.data?.total,m=h!==void 0&&c!==void 0&&c.length<h,p=()=>{m&&r(f=>f+u)},g=()=>{a.refetch().catch(()=>{})};return{data:c,error:a.error??void 0,hasMore:m,loadMore:p,loading:a.isLoading,refetch:g,total:h}}const V=t=>{const e=y(20);let n;e[0]!==t?(n=t===void 0?{}:t,e[0]=t,e[1]=n):n=e[1];const d=n,o=S(),{enabled:u,filterField:i,filterValue:r,pageSize:l,search:s,searchField:a,sortBy:c,sortDirection:h}=d;let m;e[2]!==i||e[3]!==r||e[4]!==s||e[5]!==a||e[6]!==c||e[7]!==h?(m=["users",{filterField:i,filterValue:r,search:s,searchField:a,sortBy:c,sortDirection:h}],e[2]=i,e[3]=r,e[4]=s,e[5]=a,e[6]=c,e[7]=h,e[8]=m):m=e[8];let p;e[9]!==o||e[10]!==i||e[11]!==r||e[12]!==s||e[13]!==a||e[14]!==c||e[15]!==h?(p=f=>o.listAuthUsers({filterField:i,filterValue:r,limit:f,search:s,searchField:a,sortBy:c,sortDirection:h}),e[9]=o,e[10]=i,e[11]=r,e[12]=s,e[13]=a,e[14]=c,e[15]=h,e[16]=p):p=e[16];let g;return e[17]!==u||e[18]!==l?(g={enabled:u,pageSize:l},e[17]=u,e[18]=l,e[19]=g):g=e[19],z(o,m,p,g)},k=t=>{const e=y(8);let n;e[0]!==t?(n=t===void 0?{}:t,e[0]=t,e[1]=n):n=e[1];const d=n,o=S(),{enabled:u,pageSize:i}=d;let r;e[2]===Symbol.for("react.memo_cache_sentinel")?(r=["organizations"],e[2]=r):r=e[2];let l;e[3]!==o?(l=a=>o.listAuthOrganizations({limit:a}),e[3]=o,e[4]=l):l=e[4];let s;return e[5]!==u||e[6]!==i?(s={enabled:u,pageSize:i},e[5]=u,e[6]=i,e[7]=s):s=e[7],z(o,r,l,s)},q=t=>{const e=y(10);let n;e[0]!==t?(n=t===void 0?{}:t,e[0]=t,e[1]=n):n=e[1];const d=n,o=S(),{enabled:u,pageSize:i,userId:r}=d;let l;e[2]!==r?(l=["sessions",{userId:r}],e[2]=r,e[3]=l):l=e[3];let s;e[4]!==o||e[5]!==r?(s=c=>o.listAuthSessions({limit:c,userId:r}),e[4]=o,e[5]=r,e[6]=s):s=e[6];let a;return e[7]!==u||e[8]!==i?(a={enabled:u,pageSize:i},e[7]=u,e[8]=i,e[9]=a):a=e[9],z(o,l,s,a)},x=()=>{const t=y(10),e=S();let n;t[0]!==e?(n={mutationFn:a=>e.impersonateAuthUser({userId:a})},t[0]=e,t[1]=n):n=t[1];const d=b(n),{mutateAsync:o,reset:u}=d;let i;t[2]!==o?(i=a=>o(a),t[2]=o,t[3]=i):i=t[3];const r=i,l=d.error??void 0;let s;return t[4]!==r||t[5]!==d.data||t[6]!==d.isPending||t[7]!==u||t[8]!==l?(s={data:d.data,error:l,impersonate:r,pending:d.isPending,reset:u},t[4]=r,t[5]=d.data,t[6]=d.isPending,t[7]=u,t[8]=l,t[9]=s):s=t[9],s};export{q as useAuthSessions,V as useAuthUsers,x as useImpersonate,k as useOrganizations};

package/dist/packem_shared/usePresence-xAbekAr_.mjs

@@ -0,0 +1,2 @@
+'use client';
+import{useMemo as S,useState as U,useRef as I,useEffect as c,useCallback as p}from"react";import{useLunora as $}from"./LunoraProvider-InsjxtOB.mjs";const D=(e="sess")=>{if(typeof crypto<"u"){if(typeof crypto.randomUUID=="function")return crypto.randomUUID();if(typeof crypto.getRandomValues=="function"){const s=crypto.getRandomValues(new Uint8Array(16));return`${e}-${Array.from(s,t=>t.toString(16).padStart(2,"0")).join("")}`}}return`${e}-${Date.now().toString(36)}`},L=1e4,P=(e,s)=>{const t=$(),{heartbeat:m,intervalMs:y=L,listPresent:f,shardKey:o}=s,i=S(()=>s.sessionId??D(),[s.sessionId]),[h,v]=U(void 0),u=I(s.data),l=I({client:t,heartbeat:m,roomId:e,sessionId:i,shardKey:o});c(()=>{l.current={client:t,heartbeat:m,roomId:e,sessionId:i,shardKey:o}});const n=p(()=>{const{client:r,heartbeat:a,roomId:d,sessionId:K,shardKey:g}=l.current,R={roomId:d,sessionId:K,...u.current===void 0?{}:{data:u.current}};r.mutation(a,R,{shardKey:g}).catch(()=>{})},[]),b=p(r=>{u.current=r,n()},[n]);return c(()=>{n();const r=setInterval(n,y),a=()=>{typeof document<"u"&&document.visibilityState==="visible"&&n()};return typeof document<"u"&&document.addEventListener("visibilitychange",a),()=>{clearInterval(r),typeof document<"u"&&document.removeEventListener("visibilitychange",a)}},[n,y]),c(()=>t.acquireConnectionContext({roomId:e,sessionId:i},{shardKey:o}),[t,e,i,o]),c(()=>{let r=!1;const a=t.subscribe(f,{roomId:e},d=>{r||v(d)},{shardKey:o});return()=>{r=!0,a()}},[t,f.__lunoraRef,e,o]),{present:h,sessionId:i,setData:b}};export{P as usePresence};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/react",
-  "version": "1.0.0-alpha.39",
+  "version": "1.0.0-alpha.40",
   "description": "React hooks for Lunora: useQuery, useMutation, useSubscription, and useAuth",
   "keywords": [
     "cloudflare",
@@ -53,9 +53,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.35",
-    "@lunora/errors": "1.0.0-alpha.10",
-    "@lunora/ratelimit": "1.0.0-alpha.14",
+    "@lunora/client": "1.0.0-alpha.36",
+    "@lunora/errors": "1.0.0-alpha.12",
+    "@lunora/ratelimit": "1.0.0-alpha.15",
     "@visulima/storage-client": "1.0.0"
   },
   "peerDependencies": {

package/dist/packem_shared/usePresence-SJBy81um.mjs

@@ -1,2 +0,0 @@
-'use client';
-import{useMemo as S,useState as U,useRef as f,useEffect as c,useCallback as h}from"react";import{useLunora as $}from"./LunoraProvider-InsjxtOB.mjs";const D=(e="sess")=>{if(typeof crypto<"u"){if(typeof crypto.randomUUID=="function")return crypto.randomUUID();if(typeof crypto.getRandomValues=="function"){const s=crypto.getRandomValues(new Uint8Array(16));return`${e}-${Array.from(s,t=>t.toString(16).padStart(2,"0")).join("")}`}}return`${e}-${Date.now().toString(36)}`},C=1e4,P=(e,s)=>{const t=$(),{heartbeat:m,intervalMs:l=C,listPresent:y,shardKey:n}=s,i=S(()=>s.sessionId??D(),[s.sessionId]),[p,v]=U(void 0),d=f(s.data),I=f({client:t,heartbeat:m,roomId:e,sessionId:i,shardKey:n});c(()=>{I.current={client:t,heartbeat:m,roomId:e,sessionId:i,shardKey:n}});const o=h(()=>{const{client:r,heartbeat:a,roomId:u,sessionId:K,shardKey:g}=I.current,R={roomId:u,sessionId:K,...d.current===void 0?{}:{data:d.current}};r.mutation(a,R,{shardKey:g}).catch(()=>{})},[]),b=h(r=>{d.current=r,o()},[o]);return c(()=>{o();const r=setInterval(o,l),a=()=>{document.visibilityState==="visible"&&o()};return document.addEventListener("visibilitychange",a),()=>{clearInterval(r),document.removeEventListener("visibilitychange",a)}},[o,l]),c(()=>t.acquireConnectionContext({roomId:e,sessionId:i},{shardKey:n}),[t,e,i,n]),c(()=>{let r=!1;const a=t.subscribe(y,{roomId:e},u=>{r||v(u)},{shardKey:n});return()=>{r=!0,a()}},[t,y.__lunoraRef,e,n]),{present:p,sessionId:i,setData:b}};export{P as usePresence};