tempest-react-sdk 0.78.0 → 0.80.0

package/dist/tempest-react-sdk.d.ts

@@ -1,6 +1,11 @@
+import { ActionFunction } from 'react-router';
+import { ActionFunctionArgs } from 'react-router';
 import { AnchorHTMLAttributes } from 'react';
 import { AnimationEventHandler } from 'react';
 import { AriaRole } from 'react';
+import { Await } from 'react-router';
+import { Blocker } from 'react-router';
+import { BlockerFunction } from 'react-router';
 import { BrowserRouter } from 'react-router';
 import { ButtonHTMLAttributes } from 'react';
 import { ChangeEventHandler } from 'react';
@@ -11,12 +16,22 @@ import { CompositionEventHandler } from 'react';
 import { Control } from 'react-hook-form';
 import { Controller } from 'react-hook-form';
 import { ControllerRenderProps } from 'react-hook-form';
+import { createBrowserRouter } from 'react-router';
+import { createHashRouter } from 'react-router';
+import { createMemoryRouter } from 'react-router';
+import { createPath } from 'react-router';
+import { createRoutesFromChildren } from 'react-router';
+import { createRoutesFromElements } from 'react-router';
+import { createSearchParams } from 'react-router';
 import { CSSProperties } from 'react';
+import { data } from 'react-router';
 import { default as default_2 } from 'dexie';
 import { DefaultOptions } from '@tanstack/react-query';
 import { DOMElement } from 'react';
 import { DragEventHandler } from 'react';
 import { ErrorInfo } from 'react';
+import { Fetcher } from 'react-router';
+import { FetcherWithComponents } from 'react-router';
 import { FieldArrayWithId } from 'react-hook-form';
 import { FieldError } from 'react-hook-form';
 import { FieldErrors } from 'react-hook-form';
@@ -26,27 +41,50 @@ import { FocusEventHandler } from 'react';
 import { FormHTMLAttributes } from 'react';
 import { FormProvider } from 'react-hook-form';
 import { ForwardRefExoticComponent } from 'react';
+import { generatePath } from 'react-router';
 import { HashRouter } from 'react-router';
 import { HTMLAttributes } from 'react';
+import { IDLE_BLOCKER } from 'react-router';
+import { IDLE_FETCHER } from 'react-router';
+import { IDLE_NAVIGATION } from 'react-router';
 import { ImgHTMLAttributes } from 'react';
+import { IndexRouteObject } from 'react-router';
 import { InfiniteData } from '@tanstack/react-query';
 import { InputEventHandler } from 'react';
 import { InputHTMLAttributes } from 'react';
+import { isRouteErrorResponse } from 'react-router';
 import { JSX } from 'react';
 import { KeyboardEvent as KeyboardEvent_2 } from 'react';
 import { KeyboardEventHandler } from 'react';
 import { LabelHTMLAttributes } from 'react';
 import { lazy } from 'react';
 import { Link } from 'react-router';
+import { LinkProps } from 'react-router';
+import { LoaderFunction } from 'react-router';
+import { LoaderFunctionArgs } from 'react-router';
+import { Location as Location_2 } from 'react-router';
+import { matchPath } from 'react-router';
+import { matchRoutes } from 'react-router';
 import { MemoryRouter } from 'react-router';
 import { MouseEvent as MouseEvent_2 } from 'react';
 import { MouseEventHandler } from 'react';
 import { Navigate } from 'react-router';
+import { NavigateFunction } from 'react-router';
 import { NavigateOptions } from 'react-router';
+import { NavigateProps } from 'react-router';
+import { Navigation as Navigation_2 } from 'react-router';
+import { NavigationType as NavigationType_2 } from 'react-router';
 import { NavLink } from 'react-router';
+import { NavLinkProps } from 'react-router';
+import { NavLinkRenderProps } from 'react-router';
+import { NonIndexRouteObject } from 'react-router';
 import { Outlet } from 'react-router';
+import { OutletProps } from 'react-router';
 import { Params } from 'react-router';
+import { parsePath } from 'react-router';
 import { Path } from 'react-hook-form';
+import { PathMatch } from 'react-router';
+import { PathPattern } from 'react-router';
 import { PersistOptions } from 'zustand/middleware';
 import { PointerEvent as PointerEvent_2 } from 'react';
 import { PointerEventHandler } from 'react';
@@ -57,13 +95,27 @@ import { ReactEventHandler } from 'react';
 import { ReactNode } from 'react';
 import { ReactPortal } from 'react';
 import { redirect } from 'react-router';
+import { redirectDocument } from 'react-router';
 import { Ref } from 'react';
 import { RefAttributes } from 'react';
 import { RefObject } from 'react';
+import { renderMatches } from 'react-router';
+import { replace } from 'react-router';
+import { resolvePath } from 'react-router';
 import { Resolver } from 'react-hook-form';
 import { Route } from 'react-router';
+import { RouteObject } from 'react-router';
+import { RouteProps } from 'react-router';
+import { Router } from 'react-router';
+import { Form as RouterForm } from 'react-router';
+import { FormProps as RouterFormProps } from 'react-router';
+import { RouterProvider } from 'react-router';
+import { RouterProviderProps } from 'react-router';
 import { Routes } from 'react-router';
+import { ScrollRestoration as ScrollRestoration_2 } from 'react-router';
 import { SelectHTMLAttributes } from 'react';
+import { SetURLSearchParams } from 'react-router';
+import { ShouldRevalidateFunction } from 'react-router';
 import { StateCreator } from 'zustand';
 import { StoreApi } from 'zustand';
 import { SubmitEventHandler } from 'react';
@@ -76,26 +128,51 @@ import { TouchEvent as TouchEvent_2 } from 'react';
 import { TouchEventHandler } from 'react';
 import { TransitionEventHandler } from 'react';
 import { UIEventHandler } from 'react';
+import { UIMatch } from 'react-router';
+import { URLSearchParamsInit } from 'react-router';
+import { useActionData } from 'react-router';
+import { useAsyncError } from 'react-router';
+import { useAsyncValue } from 'react-router';
+import { useBeforeUnload } from 'react-router';
+import { useBlocker } from 'react-router';
 import { UseBoundStore } from 'zustand';
+import { useFetcher } from 'react-router';
+import { useFetchers } from 'react-router';
 import { useFieldArray } from 'react-hook-form';
 import { UseFieldArrayReturn } from 'react-hook-form';
 import { useForm } from 'react-hook-form';
+import { useFormAction } from 'react-router';
 import { useFormContext } from 'react-hook-form';
 import { UseFormProps } from 'react-hook-form';
 import { UseFormRegister } from 'react-hook-form';
 import { UseFormReturn } from 'react-hook-form';
 import { useFormState } from 'react-hook-form';
+import { useHref } from 'react-router';
 import { UseInfiniteQueryOptions } from '@tanstack/react-query';
+import { useInRouterContext } from 'react-router';
+import { useLinkClickHandler } from 'react-router';
+import { useLoaderData } from 'react-router';
 import { useLocation } from 'react-router';
 import { useMatch } from 'react-router';
+import { useMatches } from 'react-router';
 import { UseMutationOptions } from '@tanstack/react-query';
 import { UseMutationResult } from '@tanstack/react-query';
 import { useNavigate } from 'react-router';
+import { useNavigation } from 'react-router';
+import { useNavigationType } from 'react-router';
+import { useOutlet } from 'react-router';
+import { useOutletContext } from 'react-router';
 import { useParams } from 'react-router';
 import { UseQueryOptions } from '@tanstack/react-query';
 import { UseQueryResult } from '@tanstack/react-query';
+import { useResolvedPath } from 'react-router';
+import { useRevalidator } from 'react-router';
 import { useRouteError } from 'react-router';
+import { useRouteLoaderData } from 'react-router';
+import { useRoutes } from 'react-router';
 import { useSearchParams } from 'react-router';
+import { useSubmit } from 'react-router';
+import { useViewTransitionState } from 'react-router';
 import { useWatch } from 'react-hook-form';
 import { WheelEventHandler } from 'react';
 import { z } from 'zod';
@@ -172,6 +249,10 @@ export declare interface AccordionProps {
     className?: string;
 }
 
+export { ActionFunction }
+
+export { ActionFunctionArgs }
+
 /**
  * Resolve which navigation key is active for the current route.
  *
@@ -687,6 +768,20 @@ export declare interface ApiClient {
      */
     arrayBuffer(path: string, options?: RequestOptions): Promise<ArrayBuffer>;
     upload<T>(path: string, formData: FormData, method?: "POST" | "PUT" | "PATCH", options?: Omit<RequestOptions, "body" | "method">): Promise<T>;
+    /**
+     * The absolute URL a request to `path` would hit, without sending one.
+     *
+     * For the consumers that cannot go through `fetch` but must land on the
+     * same host: an `EventSource`, an `<img src>`, a download link. Rebuilding
+     * the URL by hand duplicates `baseURL` and `prefix`, and a forgotten prefix
+     * is a silent 404. No credential is attached: the URL is a string, and a
+     * token placed in it would end up in every proxy log.
+     *
+     * @param path - Path joined onto the client's base URL and prefix.
+     * @param params - Query params to append; `undefined` and `null` are skipped.
+     * @returns The absolute URL.
+     */
+    url(path: string, params?: RequestOptions["params"]): string;
 }
 
 export declare interface ApiClientConfig {
@@ -1794,6 +1889,8 @@ export declare type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
 
 export declare type AvatarStatus = "online" | "offline" | "busy";
 
+export { Await }
+
 /**
  * `type` of the message the worker posts to window clients to ask about a queued
  * request. Answered by {@link provideBackgroundSyncCredentials}.
@@ -2182,6 +2279,10 @@ export declare interface BeforeInstallPromptEvent extends Event {
  */
 export declare function blobToWav(blob: Blob, options?: WavOptions): Promise<Blob>;
 
+export { Blocker }
+
+export { BlockerFunction }
+
 /**
  * Fixed-bottom mobile tab bar. 3–5 items recommended. Pair with
  * `<Show below="md">` to render only on mobile.
@@ -2330,7 +2431,10 @@ export { BrowserRouter }
  *
  * A path that is itself an absolute URL wins over all of this, which is how a
  * client reaches a second host (a signed upload endpoint, a CDN) without a
- * second client.
+ * second client. Without `params` it is returned exactly as given: a signed
+ * URL covers its query, and a round trip through `URL` re-encodes characters
+ * outside the canonical form (`'` became `%27`, measured), which is a rewrite
+ * of a string the server signed.
  *
  * @example
  * buildApiUrl("https://api.example.com", "/auth/login", { prefix: "/api" });
@@ -4083,6 +4187,8 @@ export declare interface CreateAuthStoreOptions<TUser> {
  */
 export declare function createBarcodeDetector(formats?: readonly BarcodeFormat[]): BarcodeDetectorLike | null;
 
+export { createBrowserRouter }
+
 /**
  * Build a ten-step tint scale from a single color.
  *
@@ -4131,11 +4237,15 @@ export declare function createDataProvider(client: ApiClient, options?: DataProv
  * `onMessage`. Pass `withCredentials: true` when the backend authenticates via
  * cookies. Call `close()` from the returned controller to tear down.
  *
- * @param url - Full SSE endpoint URL.
+ * When `url` is a function it is called before every connection, so a
+ * reconnect presents a fresh credential instead of the one that expired. A
+ * resolution still pending when `close()` or `reconnect()` runs is discarded.
+ *
+ * @param url - Full SSE endpoint URL, or a function returning it per connection.
  * @param options - Stream configuration and callbacks.
  * @returns A controller exposing `close`, `reconnect` and the current `status`.
  */
-export declare function createEventStream<T = unknown>(url: string, options?: CreateEventStreamOptions<T>): EventStreamController;
+export declare function createEventStream<T = unknown>(url: EventStreamUrl, options?: CreateEventStreamOptions<T>): EventStreamController;
 
 export declare interface CreateEventStreamOptions<T> {
     /** Send cookies with the EventSource handshake. Default: false. */
@@ -4190,6 +4300,21 @@ export declare interface CreateEventStreamOptions<T> {
      * `isDevBuild()` to be able to answer, and this callback is the app's own.
      */
     onValidationError?: (issues: SchemaIssue[], raw: string) => void;
+    /**
+     * The URL function threw or rejected, so no connection was attempted.
+     *
+     * `onError` cannot carry this: it receives the `EventSource` `Event`, and a
+     * URL that never resolved never had an `EventSource`.
+     */
+    onUrlError?: (error: unknown) => void;
+    /**
+     * Whether a URL-resolution failure is worth another attempt. Default: always.
+     *
+     * Return `false` for failures no backoff can fix — a `401` or a `403` when
+     * fetching a ticket is a session decision, not a network blip — and the stream
+     * stops at `status: "error"` instead of spending `maxRetries` on it.
+     */
+    shouldRetryUrl?: (error: unknown) => boolean;
     onOpen?: () => void;
     onMessage?: (message: EventStreamMessage<T>) => void;
     onError?: (error: Event) => void;
@@ -4223,6 +4348,8 @@ export declare interface CreateGrowthBookFeatureFlagsAdapterOptions {
     growthbook: GrowthBookLike;
 }
 
+export { createHashRouter }
+
 /**
  * Create an i18n object with translation, pluralization and Intl helpers.
  *
@@ -4521,6 +4648,8 @@ export declare interface CreateLoggerOptions {
  */
 export declare function createMediaRecorder(stream: MediaStream, options: MediaRecordingOptions): MediaRecorderHandle;
 
+export { createMemoryRouter }
+
 /**
  * Build several {@link OfflineStore}s that share one IndexedDB database.
  *
@@ -4715,6 +4844,8 @@ export declare interface CreatePasskeyClientOptions {
     credentials?: CredentialsContainerLike;
 }
 
+export { createPath }
+
 /**
  * One `RTCPeerConnection` per peer, with the slots negotiated up front.
  *
@@ -4972,6 +5103,12 @@ export declare function createResumableUpload(options: ResumableUploadOptions):
  */
 export declare function createRoleAccessControl(config: RoleAccessControlConfig): AccessControl;
 
+export { createRoutesFromChildren }
+
+export { createRoutesFromElements }
+
+export { createSearchParams }
+
 /**
  * Attach auto-generated selector hooks to a Zustand store. Instead of writing
  * `useStore((s) => s.user)` at every call site, you get `useStore.use.user()`
@@ -5377,6 +5514,35 @@ export declare interface CreateThemeOptions {
     inverseSelector?: string;
 }
 
+/**
+ * Open the ticket-authenticated stream of the `tempest-fastapi-sdk` SSE router.
+ *
+ * `POST <prefix>/ticket` through the authenticated client, then
+ * `GET <prefix>/stream?ticket=…` — and again for every reconnect, because the
+ * ticket only opens streams for `expires_in` seconds and a reconnect after that
+ * with the old one is a `401`. A ticket request refused with a status no
+ * backoff fixes (`401`, `403 ACCOUNT_INACTIVE`) stops the stream at
+ * `status: "error"` and reaches `onUrlError`; pass `shouldRetryUrl` to replace
+ * {@link isRetriableTicketError}.
+ *
+ * The access token never enters the URL: it travels as the client's header (or
+ * cookie) on the ticket request, and the ticket in the URL opens that stream
+ * and nothing else.
+ *
+ * @example
+ * const stream = createTicketEventStream<Notification>({
+ *     client: api,
+ *     onMessage: ({ data }) => addNotification(data),
+ *     onUrlError: (error) => toast.error(describeApiError(error)),
+ * });
+ *
+ * @param options - Ticket source plus every {@link createEventStream} option.
+ * @returns The stream controller.
+ */
+export declare function createTicketEventStream<T = unknown>(options: CreateTicketEventStreamOptions<T>): EventStreamController;
+
+export declare type CreateTicketEventStreamOptions<T> = TicketEventStreamSource & CreateEventStreamOptions<T>;
+
 /**
  * Record a video stream — a camera, a screen share, or a `canvas.captureStream()`.
  *
@@ -5817,6 +5983,8 @@ export declare interface CursorParams {
     ascending?: boolean;
 }
 
+export { data }
+
 /** Filters passed to {@link DataProvider.getList}, spread verbatim into the query string. */
 export declare type DataFilters = Record<string, ParamValue>;
 
@@ -7223,6 +7391,19 @@ export declare interface EventStreamMessage<T> {
 
 export declare type EventStreamStatus = "idle" | "connecting" | "open" | "closed" | "error";
 
+/**
+ * Where the stream connects: a fixed URL, or a function resolved again before
+ * every connection, the first one and each reconnect.
+ *
+ * The function form exists for short-lived credentials carried in the URL,
+ * such as the `?ticket=` of the `tempest-fastapi-sdk` SSE router. `EventSource`
+ * cannot send headers, so the credential has to ride in the query, and one that
+ * expires makes a fixed URL a trap: the reconnect after the expiry presents the
+ * same dead credential, gets a `401`, and burns every retry on it while the user
+ * is still signed in.
+ */
+export declare type EventStreamUrl = string | (() => string | Promise<string>);
+
 /**
  * Finish a `tempest-fastapi-sdk` social login from the SPA's callback route.
  *
@@ -7299,6 +7480,10 @@ export declare interface FeatureFlagsProviderProps {
     children: ReactNode;
 }
 
+export { Fetcher }
+
+export { FetcherWithComponents }
+
 export { FieldArrayWithId }
 
 export { FieldError }
@@ -8148,6 +8333,8 @@ export declare interface GeneratedTheme {
  */
 export declare function generateIdempotencyKey(): string;
 
+export { generatePath }
+
 /**
  * Axis-aligned geographic bounding box. `min`/`max` follow the same degree
  * ranges as {@link Coordinate}.
@@ -8504,6 +8691,12 @@ export declare interface I18nProviderProps {
     storageKey?: string | null;
 }
 
+export { IDLE_BLOCKER }
+
+export { IDLE_FETCHER }
+
+export { IDLE_NAVIGATION }
+
 /**
  * Renders an `<img>` with native lazy loading and a one-shot fallback.
  *
@@ -8596,6 +8789,8 @@ export declare interface ImageProps extends Omit<ImgHTMLAttributes<HTMLImageElem
     lazy?: boolean;
 }
 
+export { IndexRouteObject }
+
 /**
  * Records how long each stage of a pipeline took.
  *
@@ -9361,6 +9556,23 @@ export declare function isRejectionCloseCode(code: number): boolean;
  */
 export declare function isRetriableStatus(status: number): boolean;
 
+/**
+ * Whether a failure to obtain a ticket is worth another attempt.
+ *
+ * Only a failure the backoff can outlast is: no response at all, a timeout, a
+ * rate limit, a `5xx`. A `401` reached the caller after the client already
+ * tried its refresh, and a `403` (`ACCOUNT_INACTIVE`) is the backend saying no;
+ * both are session decisions, and retrying them only delays the error state the
+ * app has to show. Anything that is not an API error is a contract mismatch,
+ * which a retry cannot fix either.
+ *
+ * @param error - What the ticket request threw.
+ * @returns Whether to schedule a reconnect.
+ */
+export declare function isRetriableTicketError(error: unknown): boolean;
+
+export { isRouteErrorResponse }
+
 /** Whether `getDisplayMedia` is reachable at all. */
 export declare function isScreenCaptureSupported(): boolean;
 
@@ -9877,6 +10089,8 @@ export declare interface LimiterSettings {
 
 export { Link }
 
+export { LinkProps }
+
 /**
  * One link's outbound picture, in the shape a call UI actually renders.
  *
@@ -10056,6 +10270,10 @@ export declare interface ListTileProps {
     className?: string;
 }
 
+export { LoaderFunction }
+
+export { LoaderFunctionArgs }
+
 export declare type LocalStorageOptions<T> = {
     serialize?: (value: T) => string;
     deserialize?: (raw: string) => T;
@@ -10080,6 +10298,8 @@ export declare interface LocalUploadStorage extends ResumableUploadStorage {
     clear(): void;
 }
 
+export { Location_2 as Location }
+
 export declare interface LogEntry {
     level: LogLevel;
     message: string;
@@ -10262,6 +10482,10 @@ export declare interface MasonryProps<T> extends Omit<HTMLAttributes<HTMLDivElem
     gap?: string;
 }
 
+export { matchPath }
+
+export { matchRoutes }
+
 /**
  * The matrix as an SVG path, one `M…h…v…h…z` rectangle per dark module.
  *
@@ -10934,8 +11158,14 @@ export declare type NavbarTone = "surface" | "primary" | "inverse" | "transparen
 
 export { Navigate }
 
+export { NavigateFunction }
+
 export { NavigateOptions }
 
+export { NavigateProps }
+
+export { Navigation_2 as Navigation }
+
 /**
  * Horizontal navigation menu with hover/click/focus dropdown submenus.
  *
@@ -11038,8 +11268,14 @@ export declare interface NavigationRailProps extends Omit<HTMLAttributes<HTMLEle
     className?: string;
 }
 
+export { NavigationType_2 as NavigationType }
+
 export { NavLink }
 
+export { NavLinkProps }
+
+export { NavLinkRenderProps }
+
 /** Options for {@link measureNoiseFloor}. */
 export declare interface NoiseFloorOptions {
     /** Called with `0..1` so a dialog can show the wait. */
@@ -11050,6 +11286,8 @@ export declare interface NoiseFloorOptions {
     context?: AudioContext;
 }
 
+export { NonIndexRouteObject }
+
 /**
  * Turn one raw detection into a {@link BarcodeScanResult}.
  *
@@ -11845,6 +12083,8 @@ export declare type OutboxOp = "create" | "update" | "delete";
 
 export { Outlet }
 
+export { OutletProps }
+
 /**
  * DOM attributes this component redefines.
  *
@@ -11999,6 +12239,8 @@ export { Params }
 /** Query-param values accepted by the API client for a list request. */
 declare type ParamValue = string | number | boolean | undefined | null;
 
+export { parsePath }
+
 /**
  * Validate an unknown response payload against a zod schema.
  *
@@ -12293,6 +12535,10 @@ export { Path }
  */
 export declare function pathLengthKm(points: readonly Coordinate[]): number;
 
+export { PathMatch }
+
+export { PathPattern }
+
 /** Raw PCM ready to be wrapped in a RIFF container. */
 export declare interface PcmAudio {
     /** One `Float32Array` per channel, samples in −1…1. */
@@ -12773,6 +13019,22 @@ export declare type PreloadableLazy<T extends AnyComponent> = ReturnType<typeof
     }>;
 };
 
+/**
+ * A pre-signed `POST` form, as `tempest-fastapi-sdk` >= 0.331.0 hands it out
+ * (`presigned_post_policy` / `SubjectObjectStorage.presign_post`).
+ *
+ * Snake case on purpose: this is the wire shape, so it parses straight from the
+ * response of the app's own route.
+ */
+export declare interface PresignedPost {
+    /** Where the form is posted: the bucket on S3/MinIO, or the API itself on the local backend. */
+    url: string;
+    /** Form fields to send before the file, in this order — `key`, `policy`, signature and the rest. */
+    fields: Record<string, string>;
+    /** Largest file the policy accepts, in bytes. */
+    max_bytes: number;
+}
+
 /** A model whose cached size should appear in the report. */
 export declare interface ProfiledModel {
     /** Label for the report row, e.g. `"detector"`. */
@@ -13405,6 +13667,8 @@ export declare function receiptLabel(receipt: ChatReceipt, strings: {
 
 export { redirect }
 
+export { redirectDocument }
+
 /** Recommended refetch intervals (milliseconds). */
 export declare const REFETCH_TIME: {
     readonly REALTIME: number;
@@ -13598,11 +13862,15 @@ export declare function removeById<T, V extends Partial<Record<keyof T, unknown>
 /** Renders the instruction shown when the browser has no install prompt. */
 export declare type RenderInstallHint = (input: InstallHintInput) => ReactNode;
 
+export { renderMatches }
+
 export declare interface ReorderPayload {
     from: number;
     to: number;
 }
 
+export { replace }
+
 /**
  * What {@link ApiClientConfig.refresh} and {@link ApiClientConfig.onUnauthorized}
  * learn about the attempt that came back `401`: the credential and the session it
@@ -13741,6 +14009,8 @@ export declare function resolveDegradation(quality: MeshQuality, effective: Mesh
 
 export declare type ResolvedTheme = "light" | "dark";
 
+export { resolvePath }
+
 /**
  * Resolve the tick state of an outgoing message.
  *
@@ -14182,9 +14452,23 @@ export declare interface RouteGuardProps {
  */
 export declare type RouteGuardResult = boolean | "pending";
 
+export { RouteObject }
+
+export { RouteProps }
+
+export { Router }
+
+export { RouterForm }
+
+export { RouterFormProps }
+
 /** Router history strategy used by {@link AppRouter}. */
 export declare type RouterKind = "browser" | "hash" | "memory";
 
+export { RouterProvider }
+
+export { RouterProviderProps }
+
 export { Routes }
 
 /**
@@ -14509,9 +14793,9 @@ export declare interface SchedulerProps extends Omit<HTMLAttributes<HTMLDivEleme
  * - [Standard Schema](https://standardschema.dev) (`~standard`), which zod
  *   (>=3.24), valibot and arktype all implement, so the SDK validates against
  *   any of them without depending on one;
- * - `.safeParse`, because the SDK's own zod range starts at `^3.23.0`, which
- *   predates `~standard`, and because it is the method every zod user already
- *   knows.
+ * - `.safeParse`, because it is the method every zod user already knows, and
+ *   because an app may still build its schemas with its own copy of zod 3.23,
+ *   which predates `~standard`, even though the SDK itself requires `^4.6.6`.
  */
 /** One field-level complaint from a schema validation. */
 export declare interface SchemaIssue {
@@ -14559,6 +14843,8 @@ export declare interface ScrollAreaProps extends HTMLAttributes<HTMLDivElement>
 /** Which axis to watch for overflow. */
 export declare type ScrollOverflowAxis = "horizontal" | "vertical" | "both";
 
+export { ScrollRestoration_2 as ScrollRestoration }
+
 /**
  * Search input with magnifier icon and a clear button. Controlled component:
  * pass `value` and `onChange`.
@@ -15031,6 +15317,8 @@ export declare function setSenderBitrate(sender: RTCRtpSender, maxBitrate: numbe
  */
 export declare function setTunedLocalDescription(connection: RTCPeerConnection, description: RTCSessionDescriptionInit, profiles: OpusProfile | OpusProfileMap): Promise<TunedDescriptionResult>;
 
+export { SetURLSearchParams }
+
 /** Imperative handle over a pool of short sound effects. */
 export declare interface SfxPool {
     /** Play a clip, allocating and caching its element on first use. */
@@ -15147,6 +15435,8 @@ export declare interface ShareResult {
  */
 export declare function shouldRetryQuery(failureCount: number, error: unknown): boolean;
 
+export { ShouldRevalidateFunction }
+
 /**
  * Conditionally render children based on the viewport breakpoint.
  *
@@ -15648,6 +15938,14 @@ export declare interface SpinnerProps {
 
 export declare type SpinnerSize = "xs" | "sm" | "md" | "lg" | "xl";
 
+/** Body of `POST <prefix>/ticket` on the `tempest-fastapi-sdk` SSE router. */
+export declare interface SseTicketResponse {
+    /** Signed stream ticket, presented as a query param when opening the stream. */
+    ticket: string;
+    /** Seconds the ticket is accepted for opening a stream. */
+    expires_in: number;
+}
+
 /** Flex-based vertical or horizontal stack with a numeric `gap`. */
 export declare function Stack({ direction, gap, align, justify, wrap, className, style, children, ...props }: StackProps): JSX.Element;
 
@@ -16400,6 +16698,20 @@ export declare function throttle<A extends unknown[]>(fn: (...args: A) => void,
     cancel: () => void;
 };
 
+/** Where the ticket comes from and how the stream URL is built. */
+export declare interface TicketEventStreamSource {
+    /**
+     * Authenticated client the ticket is requested through, so it carries the
+     * `Authorization` header or the session cookie, the CSRF header, and the
+     * 401 refresh-and-replay that a hand-rolled `fetch` would lose.
+     */
+    client: Pick<ApiClient, "post" | "url">;
+    /** Router prefix, relative to the client's base URL. Default: `"/sse"`. */
+    prefix?: string;
+    /** Query param the stream reads the ticket from. Default: `"ticket"`. */
+    ticketParam?: string;
+}
+
 /**
  * Vertical event timeline — activity feeds, order trackers, audit logs.
  * Each entry has a marker (color or custom icon), title, optional
@@ -17092,6 +17404,8 @@ export declare function tuneOpus(sdp: string, profiles: OpusProfile | OpusProfil
  */
 export declare function turnTime(timestamp: number, locale?: "pt-BR" | "en"): string;
 
+export { UIMatch }
+
 /**
  * Remove duplicate items, keeping the first occurrence of each distinct key.
  *
@@ -17180,6 +17494,48 @@ export declare interface UpdateVariables {
  */
 export declare function uploadFingerprint(endpoint: string, file: Blob | File): string;
 
+/**
+ * Upload a file straight to storage through a pre-signed `POST` form, with the
+ * size ceiling the policy enforces.
+ *
+ * The form is built the way S3 requires: every `post.fields` entry in order,
+ * the file last in the `file` part — S3 ignores whatever follows the file.
+ *
+ * The request carries **no** credential and no custom header: no
+ * `Authorization`, no CSRF token, no `X-Request-ID`, no cookies. `post.url` is
+ * usually the storage host, outside the API's origin, and the signature in
+ * `fields` is the whole authorization. Without custom headers the request is a
+ * CORS "simple request", so it does not depend on the bucket's CORS rules
+ * allowing a preflight.
+ *
+ * A file larger than `post.max_bytes` is refused before anything is sent, with
+ * the same `413 FILE_TOO_LARGE` the server would answer. Server errors are
+ * normalized into one `TempestApiError` whichever backend answered: the S3 XML
+ * (`EntityTooLarge` → `FILE_TOO_LARGE`, `EntityTooSmall` → `FILE_TOO_SMALL`,
+ * `AccessDenied` → `SIGNED_URL_INVALID`, or `SIGNED_URL_EXPIRED` when the policy
+ * expired) or the local backend's JSON envelope, which already uses those codes.
+ *
+ * @example
+ * const post = await api.post<PresignedPost>("/avatars/upload-form");
+ * await uploadPresignedPost(post, file, { onProgress: (p) => setProgress(p.fraction) });
+ *
+ * @param post - The form the API handed out.
+ * @param file - The file or blob to upload.
+ * @param options - Progress callback, abort signal and file name.
+ * @returns Resolves when storage accepted the file (`204` on S3).
+ * @throws TempestApiError On a refused upload, with the normalized `code`.
+ */
+export declare function uploadPresignedPost(post: PresignedPost, file: Blob, options?: UploadPresignedPostOptions): Promise<void>;
+
+export declare interface UploadPresignedPostOptions {
+    /** Called on every `progress` event of the upload. */
+    onProgress?: (event: UploadProgressEvent) => void;
+    /** Abort the upload; rejects with an `AbortError` `DOMException`. */
+    signal?: AbortSignal;
+    /** File name sent with the `file` part. Defaults to `file.name` for a `File`. */
+    fileName?: string;
+}
+
 export declare interface UploadProgressEvent {
     /** Bytes already uploaded. */
     loaded: number;
@@ -17289,6 +17645,8 @@ export declare function upsertById<T>(idField?: keyof T): (current: T[] | undefi
  */
 export declare function urlBase64ToUint8Array(base64String: string): Uint8Array<ArrayBuffer>;
 
+export { URLSearchParamsInit }
+
 /**
  * Read the current {@link AccessControl} from context.
  *
@@ -17299,6 +17657,8 @@ export declare function urlBase64ToUint8Array(base64String: string): Uint8Array<
  */
 export declare function useAccessControl(): AccessControl | null;
 
+export { useActionData }
+
 /**
  * Announce transient messages to screen readers through one shared live region
  * pair.
@@ -17346,6 +17706,8 @@ export declare function useAsync<T>(asyncFn: () => Promise<T>, deps?: ReadonlyAr
     immediate?: boolean;
 }): UseAsyncResult<T>;
 
+export { useAsyncError }
+
 export declare interface UseAsyncResult<T> {
     status: AsyncStatus;
     data: T | undefined;
@@ -17359,6 +17721,8 @@ export declare interface UseAsyncResult<T> {
     reset: () => void;
 }
 
+export { useAsyncValue }
+
 /**
  * The player lives in a state initializer, not in a lazily-written ref: the
  * initializer runs exactly once and is not a side effect during render, which is
@@ -17590,6 +17954,10 @@ export declare interface UseBeforeInstallPromptResult {
     prompt: () => Promise<"accepted" | "dismissed" | "unsupported">;
 }
 
+export { useBeforeUnload }
+
+export { useBlocker }
+
 /**
  * Reactive viewport-breakpoint hook.
  *
@@ -17949,6 +18317,11 @@ export declare function useEventListener<K extends keyof HTMLElementEventMap>(ev
  * tied to the component (and the `url`/`enabled` dependencies); the stream
  * closes on unmount.
  *
+ * A string `url` reopens the stream when it changes. A function `url` does not:
+ * an inline arrow is a new function every render, and keying on its identity
+ * would reconnect on every render. The latest function is the one called on the
+ * next connection, so call `reconnect()` when what it resolves to must change now.
+ *
  * Pass `schema` to have every frame validated before it reaches `onMessage`,
  * instead of trusting the type argument: without it `data` is announced as `T`
  * on the strength of the generic alone, which is a promise about the server
@@ -17972,7 +18345,7 @@ export declare function useEventListener<K extends keyof HTMLElementEventMap>(ev
  *     onMessage: ({ data }) => addNotification(data),
  * });
  */
-export declare function useEventStream<T = unknown>(url: string, options?: UseEventStreamOptions<T>): UseEventStreamResult<T>;
+export declare function useEventStream<T = unknown>(url: EventStreamUrl, options?: UseEventStreamOptions<T>): UseEventStreamResult<T>;
 
 export declare interface UseEventStreamOptions<T> extends Omit<CreateEventStreamOptions<T>, "onStatusChange"> {
     /** When false, the stream is not opened. Useful for "wait for auth". Default: true. */
@@ -18004,6 +18377,10 @@ export declare function useFavicon(href: string): void;
  */
 export declare function useFeatureFlag(key: string, defaultValue?: boolean): boolean;
 
+export { useFetcher }
+
+export { useFetchers }
+
 export { useFieldArray }
 
 export { UseFieldArrayReturn }
@@ -18052,6 +18429,8 @@ export declare function useFocusTrap(containerRef: RefObject<HTMLElement | null>
 
 export { useForm }
 
+export { useFormAction }
+
 export { useFormContext }
 
 export { UseFormProps }
@@ -18158,6 +18537,8 @@ export declare interface UseGeolocationOptions extends PositionOptions {
  */
 export declare function useHover<T extends HTMLElement>(ref: RefObject<T | null>): boolean;
 
+export { useHref }
+
 /**
  * Access translation helpers. Must be used inside an {@link I18nProvider}.
  */
@@ -18169,6 +18550,8 @@ export declare function useI18n(): I18nContextValue;
  */
 export declare function useIdle(timeout?: number): boolean;
 
+export { useInRouterContext }
+
 /**
  * React hook that resolves how (and whether) to offer PWA installation.
  *
@@ -18347,6 +18730,8 @@ export declare interface UseKeyboardShortcutOptions {
  */
 export declare function useLatestRef<T>(value: T): RefObject<T>;
 
+export { useLinkClickHandler }
+
 /**
  * Poll one connection's throughput, resolution and round trip.
  *
@@ -18414,6 +18799,8 @@ export declare type UseListOptions<T> = Omit<UseQueryOptions<OffsetPage<T>, Erro
  */
 export declare function useListState<T>(initial?: T[]): [T[], ListStateHandlers<T>];
 
+export { useLoaderData }
+
 /**
  * State synced with `localStorage`. SSR-safe — initial render returns the
  * provided default; the stored value is hydrated after mount. Updates to the
@@ -18522,6 +18909,8 @@ export declare interface UseMapResult<K, V> {
 
 export { useMatch }
 
+export { useMatches }
+
 /**
  * List capture and playback devices, and keep the list fresh.
  *
@@ -18689,6 +19078,10 @@ export declare function useModals(): ModalsApi;
 
 export { useNavigate }
 
+export { useNavigation }
+
+export { useNavigationType }
+
 /**
  * Client-side inbox state for received notifications.
  *
@@ -19010,6 +19403,10 @@ export declare interface UseOnlineOptions {
  */
 export declare function useOptionalI18n(): I18nContextValue | null;
 
+export { useOutlet }
+
+export { useOutletContext }
+
 /**
  * Offset-pagination hook over TanStack Query for the fastapi-pagination /
  * Tempest envelope (`{ items, total, page, size, pages }`).
@@ -19443,8 +19840,16 @@ export declare interface UseQueueResult<T> {
  */
 export declare function useResizeObserver(ref: RefObject<Element | null>): ElementSize | null;
 
+export { useResolvedPath }
+
+export { useRevalidator }
+
 export { useRouteError }
 
+export { useRouteLoaderData }
+
+export { useRoutes }
+
 /**
  * Capture a screen, a window or a tab with `getDisplayMedia`.
  *
@@ -19925,6 +20330,8 @@ export declare interface UseStorageEstimateResult extends StorageEstimate_2 {
     requestPersist: () => Promise<boolean>;
 }
 
+export { useSubmit }
+
 /**
  * Subscribe to an {@link OfflineSync} engine and return a display-only
  * {@link SyncStatus}. A thin read-only companion to {@link useOfflineSync},
@@ -19957,6 +20364,30 @@ export declare function useTheme(): ThemeContextValue;
  */
 export declare function useThrottle<T>(value: T, delay: number): T;
 
+/**
+ * React form of {@link createTicketEventStream}: same ticket per connection,
+ * lifecycle tied to the component like {@link useEventStream}.
+ *
+ * Changing `client`, `prefix` or `ticketParam` does not drop an open stream:
+ * the next connection uses the new values, and `reconnect()` applies them now.
+ * Reopening on identity would reconnect on every render for a client built
+ * inline.
+ *
+ * @example
+ * const { status } = useTicketEventStream<Notification>({
+ *     client: api,
+ *     enabled: isAuthenticated,
+ *     schema: notificationSchema,
+ *     onMessage: ({ data }) => addNotification(data),
+ * });
+ *
+ * @param options - Ticket source plus every {@link useEventStream} option.
+ * @returns Status, last message and `reconnect`.
+ */
+export declare function useTicketEventStream<T = unknown>(options: UseTicketEventStreamOptions<T>): UseEventStreamResult<T>;
+
+export declare type UseTicketEventStreamOptions<T> = TicketEventStreamSource & UseEventStreamOptions<T>;
+
 /**
  * Run a callback after `delay` ms. Pass `null` to disable. Resets when
  * `delay` changes; the callback ref always points at the latest closure.
@@ -20159,6 +20590,8 @@ export declare interface UseVideoRecorderResult {
     cancel: () => void;
 }
 
+export { useViewTransitionState }
+
 export { useWatch }
 
 /**