@fitzzero/quickdraw-core 5.1.1 → 5.1.3

package/dist/client/index.d.ts

@@ -1,198 +1,21 @@
-export { BreadcrumbItem, JWTPayload, NavItem, ServerCallOptions, ServerCaller, ServerCallerHeaders, ServerCallerOptions, ServerMethod, ServerMutation, ServerQuery, buildBreadcrumbs, createServerCaller, findNavItemByHref, findParentNavItem, formatCurrency, formatDate, formatDateTime, formatNumber, formatPercent, parseJWTPayload, routeRequiresAuth, truncate } from '../utils/index.js';
+export { BreadcrumbItem, JWTPayload, NavItem, QueryClientLike, ServerCallOptions, ServerCaller, ServerCallerHeaders, ServerCallerOptions, ServerMethod, ServerMutation, ServerQuery, buildBreadcrumbs, createServerCaller, findNavItemByHref, findParentNavItem, formatCurrency, formatDate, formatDateTime, formatNumber, formatPercent, parseJWTPayload, routeRequiresAuth, truncate } from '../utils/index.js';
 import { C as CollectionQueryKey, M as MethodQueryKey } from '../keys-CqKkljVN.js';
 export { E as EntityQueryKey, K as KEY_ROOT, b as MethodKeyPrefix, S as ServiceKeyPrefix, c as collectionKey, e as entityKey, m as methodKey, a as methodKeyPrefix, s as serviceKeyPrefix } from '../keys-CqKkljVN.js';
-import { Q as QuickdrawConnection, a as QuickdrawConnectionOptions, C as ConnectionAuth, b as ConnectionStatus, c as ConnectionRefusal } from '../connection-Cr1BU07W.js';
-export { B as BackoffKind, g as BackoffWindows, e as ConnectionState, D as DEFAULT_BACKOFF_MS, h as DEFAULT_SUBSCRIPTION_LANE, J as JoinWait, L as LaneCallback, f as QuickdrawSocket, S as SocketClientOptions, i as SubscriptionEvent, j as SubscriptionLane, T as TopicWatch, d as createQuickdrawConnection } from '../connection-Cr1BU07W.js';
-import { k as MethodKind, O as OrderBy, C as CollectionDef, ae as ContractMap, A as AccessLevel, z as SortDirection } from '../infer-Teo1xpsd.js';
-import { ad as Version, y as CallSuccess, w as CallNotModified, n as ProtocolMismatch, a5 as Revision, F as CollectionDelta, G as CollectionFrame, a7 as RevokeReason, k as HelloFrame } from '../envelope-Cp3YcVxC.js';
-import { QueryClient, QueryKey, Query, UseQueryResult, UseMutationResult } from '@tanstack/react-query';
-import { Q as QuickdrawClient, M as MethodQueryOptions, a as QueryCallOptions, b as MethodMutationOptions, c as MutationCallOptions } from '../clientTypes-Bc-G8n-U.js';
-export { A as AddItemOptions, h as AdminMembers, u as ChannelMember, C as CollectionMember, E as EntityMembers, v as EventMember, G as GlobalStreamMember, L as LiveMembers, i as MethodMember, j as MutationMember, k as MutationVariables, O as OnRefused, d as OptimisticCache, l as OptimisticCacheOf, e as OptimisticUpdate, f as OverlayStore, g as OverlayView, m as QueryMember, n as QuickdrawInvalidate, w as RealtimeMembers, R as RefusedAddition, p as RefusedItem, x as ScopedStreamMember, H as SearchMember, I as SearchMemberOf, S as ServiceClient, y as StreamMember, z as UseChannelResult, U as UseCollectionOptions, q as UseCollectionResult, r as UseEntitiesResult, s as UseEntityOptions, t as UseEntityResult, B as UseEventOptions, J as UseSearchOptions, K as UseSearchResult, D as UseStreamOptions, F as UseStreamResult, o as overlaysOf } from '../clientTypes-Bc-G8n-U.js';
+export { AuthProviderInfo, AuthRoutesTarget, CallRequest, CallResult, DEFAULT_ICE_SERVERS, Host, HostChannelContext, HostChannelHandler, HostDefinition, HostImplementation, HostListener, HostPeer, HostStream, HostStreamOptions, PeerConnectionConfig, PeerIceServer, PeerLinkOptions, PeerRequest, RelayMode, SignInUrlOptions, authProviders, call, callData, clearAuthToken, createPeerLink, defineHost, getAuthToken, hostOf, isNotModified, isUnknownOutcome, newId, onHostChange, onPeerRequest, reloadOncePerSession, setAuthToken, shouldRetry, signInUrl, signOut, signOutEverywhere } from './core.js';
+import { Q as QuickdrawConnection, a as QuickdrawConnectionOptions, C as ConnectionAuth, b as ConnectionStatus, c as ConnectionRefusal } from '../connection-2EeQ_Et0.js';
+export { B as BackoffKind, g as BackoffWindows, e as ConnectionState, D as DEFAULT_BACKOFF_MS, h as DEFAULT_SUBSCRIPTION_LANE, J as JoinWait, L as LaneCallback, f as QuickdrawSocket, S as SocketClientOptions, i as SubscriptionEvent, j as SubscriptionLane, T as TopicWatch, d as createQuickdrawConnection } from '../connection-2EeQ_Et0.js';
+export { b as PeerClock, c as PeerCloseReason, a as PeerLink, d as PeerLinkEvents, e as PeerLinkLag, f as PeerLinkLagOptions, g as PeerLinkState, h as PeerLinkStats, P as PeerPath } from '../types-tMagHbjy.js';
+import { QueryClient, QueryKey, Query, UseQueryResult, Updater, UseMutationResult } from '@tanstack/react-query';
+import { Q as QuickdrawClient, M as MethodQueryOptions, a as QueryCallOptions, b as MethodMutationOptions, c as MutationCallOptions } from '../clientTypes-CUUNJwWs.js';
+export { A as AddItemOptions, h as AdminMembers, u as ChannelMember, C as CollectionMember, E as EntityMembers, v as EventMember, G as GlobalStreamMember, L as LiveMembers, i as MethodMember, j as MutationMember, k as MutationVariables, O as OnRefused, d as OptimisticCache, l as OptimisticCacheOf, e as OptimisticUpdate, f as OverlayStore, g as OverlayView, m as QueryMember, n as QuickdrawInvalidate, w as RealtimeMembers, R as RefusedAddition, p as RefusedItem, x as ScopedStreamMember, H as SearchMember, I as SearchMemberOf, S as ServiceClient, y as StreamMember, z as UseChannelResult, U as UseCollectionOptions, q as UseCollectionResult, r as UseEntitiesResult, s as UseEntityOptions, t as UseEntityResult, B as UseEventOptions, J as UseSearchOptions, K as UseSearchResult, D as UseStreamOptions, F as UseStreamResult, o as overlaysOf } from '../clientTypes-CUUNJwWs.js';
+import { as as Revision, J as CollectionDelta, K as CollectionFrame, au as RevokeReason, m as HelloFrame } from '../envelope-BMBaxppV.js';
+export { ab as PeerLabel } from '../envelope-BMBaxppV.js';
+import { O as OrderBy, C as CollectionDef, ae as ContractMap, A as AccessLevel, z as SortDirection } from '../infer-Br62cnyW.js';
 import { Q as QuickdrawError } from '../errors-S-bxEIBC.js';
-import { n as AdminServiceMeta, F as FilterValue, y as AdminPage, z as AdminSubscribers } from '../adminSchemas-2DUA_hZ8.js';
+import { n as AdminServiceMeta, F as FilterValue, y as AdminPage, z as AdminSubscribers } from '../adminSchemas-29cGgrg5.js';
 import * as React from 'react';
 import 'socket.io-client';
 
-/**
- * Get the stored auth token: from `localStorage`, or from memory where it
- * cannot be used; `null` without a `window`.
- */
-declare function getAuthToken(): string | null;
-/**
- * Store the auth token (in `localStorage`, else in memory) and dispatch a
- * change event. Does nothing without a `window`.
- */
-declare function setAuthToken(token: string): void;
-/**
- * Remove the auth token and dispatch a change event. Does nothing without a
- * `window`.
- */
-declare function clearAuthToken(): void;
-/** Where the auth routes are, for the browser helpers. */
-interface AuthRoutesTarget {
-    /**
-     * The API's URL, where `createAuthRoutes` is mounted:
-     * `"https://api.example.com"`. Default: `NEXT_PUBLIC_API_URL` where it can
-     * be read, else `http://localhost:4000`.
-     */
-    readonly apiUrl?: string;
-    /** The routes' `basePath`, as `createAuthRoutes` was given it. Default `/auth`. */
-    readonly basePath?: string;
-}
-/** Options of {@link signInUrl}. */
-interface SignInUrlOptions extends AuthRoutesTarget {
-    /**
-     * The page to come back to: an origin or a URL on one, of which the
-     * routes keep the origin when `allowedOrigins` lists it, and land on
-     * `{origin}{successPath}`. Default: the current page's origin where there
-     * is a page; elsewhere the routes take their first allowed origin.
-     */
-    readonly returnTo?: string;
-}
-/**
- * The URL that starts a sign-in with `provider`: the auth routes' `GET
- * {basePath}/{provider}/start?returnTo=`, which redirects to the provider
- * and, once the user consents, back to `returnTo`'s origin with the session
- * cookie set (or to the routes' `errorPath` with `?error=`). Navigate to it:
- * a link, or `location.assign`. Throws a `TypeError` for a provider id the
- * routes cannot have (lowercase letters, digits and hyphens).
- *
- * @example
- * <a href={signInUrl("google", { apiUrl: API_URL })}>Sign in with Google</a>
- */
-declare function signInUrl(provider: string, options?: SignInUrlOptions): string;
-/**
- * Signs out: `POST {basePath}/logout`, which revokes the request's session
- * and clears its cookie, sent with the session cookie and, when one is
- * stored, the bearer token; the stored token is forgotten either way.
- * Rejects with a `QuickdrawError` when the server cannot be reached or
- * refuses (`RATE_LIMITED`, say), so the app knows the session may still be
- * live. The connection keeps the user it signed in as until it connects
- * again: with cookie sessions, reconnect it (`connection.close()`, then
- * `open()`), or load the next page; a provider whose `auth` was the stored
- * token reconnects when the app clears it.
- *
- * @example
- * await signOut({ apiUrl: API_URL });
- */
-declare function signOut(options?: AuthRoutesTarget): Promise<void>;
-/** A sign-in the API's auth routes serve, as `GET {basePath}/providers` lists it ({@link authProviders}). */
-interface AuthProviderInfo {
-    /** Its id: `signInUrl(id)` starts it; a guest's is `POST {basePath}/guest`. */
-    readonly id: string;
-    /** A name for its button: `"Google"`, `"Discord"`, `"Mock"`, `"Guest"`, or an OAuth provider's own. */
-    readonly name: string;
-    /** `"oauth"` (a redirecting provider), `"mock"` (the development picker) or `"guest"`. */
-    readonly kind: "oauth" | "mock" | "guest";
-}
-/**
- * The sign-ins the API serves, in the order its routes list them: `GET
- * {basePath}/providers` (finding F9.1 of the owner's QA of the template), so
- * a login page renders a button only for a provider that is there, whatever
- * the web app was built with: a provider whose credentials the server lacks
- * is not listed, nor the mock where it is off. Rejects with a
- * `QuickdrawError` when the server cannot be reached or refuses.
- *
- * @example
- * const { data: providers = [] } = useQuery({
- *   queryKey: ["auth", "providers"],
- *   queryFn: () => authProviders({ apiUrl: API_URL }),
- * });
- */
-declare function authProviders(options?: AuthRoutesTarget): Promise<readonly AuthProviderInfo[]>;
-/**
- * Signs the user out everywhere: `POST {basePath}/logout-all`, which
- * revokes every session of the user (the app's `onRevoke` can disconnect
- * their sockets) and clears this browser's cookie; the stored token is
- * forgotten either way. Rejects with `UNAUTHENTICATED` when the request
- * carries no live session, and with a `QuickdrawError` when the server
- * cannot be reached or refuses.
- */
-declare function signOutEverywhere(options?: AuthRoutesTarget): Promise<void>;
-
-/** One call, as {@link call} takes it. */
-interface CallRequest {
-    /** The service's name on the wire: the contract's `name`. */
-    readonly service: string;
-    readonly method: string;
-    /** The input; left out of the envelope when `undefined`. */
-    readonly input?: unknown;
-    /** The method's kind, which picks the backoff a `RATE_LIMITED` answer starts. Default `"query"`. */
-    readonly kind?: MethodKind;
-    /** Aborting it cancels the call. */
-    readonly signal?: AbortSignal;
-    /** How long to wait for the answer. Default: the connection's `timeoutMs`. */
-    readonly timeoutMs?: number;
-    /** The version of the result the caller holds; the server answers "not modified" while it is current. */
-    readonly v?: Version;
-    /**
-     * Called with the result the moment the reply arrives, before any frame
-     * the server sent after it is handled; the returned promise settles only
-     * after more microtasks, and a client on Node can handle several frames in
-     * between. What must follow reply order goes here: an optimistic layer
-     * ends at the first newer frame after its call's reply.
-     */
-    readonly onReply?: (result: CallResult) => void;
-}
-/** What a call resolves with: the data, or "not modified" when the `v` it sent is current. */
-type CallResult<Output = unknown> = CallSuccess<Output> | CallNotModified;
-/** True when the server answered that the caller's version is current. */
-declare function isNotModified(result: CallResult): result is CallNotModified;
-/**
- * True when `error` leaves a call's outcome unknown: a `TIMEOUT` (the
- * server may still be running it, or ran it and the answer was lost), or the
- * `INTERNAL` of a call whose connection dropped after it was sent. The write
- * may have been made: before sending it again, make sure the call is
- * idempotent (a create that carries an id the client made, which the server
- * keeps, fails `CONFLICT` the second time instead of writing a second row).
- * False for a refusal, and for a call that was never sent.
- *
- * @example
- * onError: (error) => setStatus(isUnknownOutcome(error) ? "checking" : "failed")
- */
-declare function isUnknownOutcome(error: unknown): boolean;
-/**
- * Calls `request.method` of `request.service` over `connection`. Resolves
- * with `{ ok: true, d, v? }`, or `{ ok: true, nm: true, v }` when the `v` it
- * sent is current; rejects with a `QuickdrawError` (see the top of this file
- * for which code when).
- *
- * @example
- * const reply = await call(connection, { service: "taskService", method: "get", input: { id } });
- * const task = isNotModified(reply) ? cached : reply.d;
- */
-declare function call<Output = unknown>(connection: QuickdrawConnection, request: CallRequest): Promise<CallResult<Output>>;
-/**
- * Calls a method and resolves with its data. For a caller that sends no
- * version, which is never answered "not modified".
- */
-declare function callData<Output = unknown>(connection: QuickdrawConnection, request: Omit<CallRequest, "v">): Promise<Output>;
-/**
- * The default `retry` of query hooks: one more attempt after an `INTERNAL`
- * error, which includes a dropped connection, or an error that is not a
- * `QuickdrawError`; none for any other code. A `TIMEOUT` is not retried,
- * because the server may still be running the call, and `RATE_LIMITED`
- * waits for the backoff instead.
- */
-declare function shouldRetry(failureCount: number, error: unknown): boolean;
-
-/** The default `onProtocolMismatch`: reloads the page once per session and server protocol. */
-declare function reloadOncePerSession(mismatch: ProtocolMismatch): void;
-
-/**
- * A new id for a row the client creates and the server keeps: a version 4
- * UUID, from `crypto.randomUUID()`, or from `crypto.getRandomValues()` where
- * that is missing (a page over plain http, which browsers do not give
- * `randomUUID`). Give it to an item an optimistic update adds and to the
- * create's input, so the scope's next load can find the item after a lost
- * answer and `retry()` cannot write twice. Throws a `TypeError` in a runtime
- * without Web Crypto.
- *
- * @example
- * create.mutate({ id: newId(), chatId, content });
- */
-declare function newId(): string;
-
 /** How long after a refetch further invalidations of the key are served together, by default. */
 declare const DEFAULT_INVALIDATION_WINDOW_MS = 250;
 /** The longest random delay of a refetch after a reconnect, by default. */
@@ -270,9 +93,12 @@ interface InvalidationCoordinator {
  */
 declare function createInvalidationCoordinator(queryClient: QueryClient, options?: CoordinatorOptions): InvalidationCoordinator;
 
-/** What a new `qd:hello` meant for the cache. */
+/** What a new `qd:hello`, or the end of the session, meant for the cache. */
 interface HelloChange {
-    /** It names another user than the cache was loaded for: the cache was emptied. */
+    /**
+     * It names another user than the cache was loaded for, or the server ended
+     * the session: the cache was emptied.
+     */
     readonly switched: boolean;
     /** No hello was held before it: the connection's first, or the first on new credentials. */
     readonly first: boolean;
@@ -608,6 +434,8 @@ interface StreamTarget {
     readonly stream: string;
     /** True for a stream with one feed per scope value; false for a global stream. */
     readonly scoped: boolean;
+    /** A host-served stream's room of each scope, whose host serves the feed; absent for the server's. */
+    readonly host?: (scope: string) => string | undefined;
 }
 /** What a feed shows: its items, oldest first, whether its seed is still to come, and why it failed. */
 interface StreamState<Item = unknown> {
@@ -829,6 +657,15 @@ interface AdminQueryMember<Input, Output> {
     call(input: Input, options?: QueryCallOptions): Promise<Output>;
     key(input: Input): MethodQueryKey<Input>;
     prefetch(queryClient: QueryClient, input: Input): Promise<void>;
+    /**
+     * Writes the cached result for `input`, as the typed client's `setData`
+     * does: `updater` is the new result, or a function of the cached one
+     * (`undefined` when nothing is cached; returning `undefined` writes
+     * nothing), and it returns what the cache then holds. The admin kit's
+     * reads are not live, so this is how a screen shows the row a write
+     * returned: `admin.adminGet?.setData({ id: row.id }, row)`.
+     */
+    setData(input: Input, updater: Updater<Output | undefined, Output | undefined>): Output | undefined;
 }
 /** A mutation member of an admin screen: the typed client's, typed by field name. */
 interface AdminMutationMember<Input, Output> {
@@ -917,29 +754,40 @@ interface QuickdrawStatus {
     readonly isConnected: boolean;
     /**
      * True once the server's hello on the current credentials has arrived:
-     * `userId` is then final, `null` meaning anonymous. False before it, and
-     * again from new credentials (`auth` changed) until their hello; it stays
-     * true while the connection reconnects with the same credentials. Gate on
-     * it, not on `isConnected`, to tell "signed out" from "not known yet".
+     * `userId` is then final, `null` meaning anonymous. False before it, again
+     * from new credentials (`auth` changed) until their hello, and again once
+     * the server ended the session or refused a connect for it (`status`
+     * `"disconnected"`, or `"refused"` after the handshake's error code
+     * `UNAUTHENTICATED` or `FORBIDDEN`): the hello, the grants and everything
+     * quickdraw cached are gone. Another protocol (`refusal.code`
+     * `"PROTOCOL_MISMATCH"`) keeps them, and so does a server that could not
+     * check the credentials (`INTERNAL`: the connection stays `"connecting"`
+     * and connects again by itself). It stays true while the connection
+     * reconnects with the same credentials. Gate on it, not on `isConnected`;
+     * while it is false, a stopped `status` tells "signed out" from "not
+     * known yet".
      */
     readonly isKnown: boolean;
     /**
      * True while the connection is connecting again after it was connected
-     * with its current credentials (the network dropped, or the server asked
-     * it to rotate). What it showed stays meanwhile, and `userId` is kept.
+     * with its current credentials (the network dropped, the server asked it
+     * to rotate, or the server could not authenticate a reconnect). What it
+     * showed stays meanwhile, and `userId` is kept.
      */
     readonly reconnecting: boolean;
     /** The server's `qd:hello` on the current credentials: its version, limits and who the socket acts for. */
     readonly hello: HelloFrame | null;
     /**
      * The user the connection acts for, from the server's hello: `null` while
-     * anonymous, and before the hello on the current credentials arrives
-     * (`isKnown` tells the two apart).
+     * anonymous, before the hello on the current credentials arrives, and
+     * once the server ended the session (`isKnown` and `status` tell them
+     * apart).
      */
     readonly userId: string | null;
     /**
      * The user's service grants: from the server's hello, then from each
-     * `qd:access` push; `null` before the hello on the current credentials.
+     * `qd:access` push; `null` before the hello on the current credentials,
+     * and once the server ended the session.
      */
     readonly serviceAccess: Readonly<Record<string, AccessLevel>> | null;
     /** Why the server refused the connection, while `status` is `refused`. */
@@ -970,10 +818,11 @@ declare function QuickdrawProvider<Contracts extends ContractMap>(props: Quickdr
  * `RATE_LIMITED`.
  *
  * @example
- * const { isKnown, userId } = useQuickdraw();
- * if (!isKnown) return <Spinner />;
+ * const { status, isKnown, userId } = useQuickdraw();
+ * // stopped with nobody known: the server ended or refused the session
+ * if (!isKnown) return status === "disconnected" || status === "refused" ? <SignIn /> : <Spinner />;
  * return userId === null ? <SignIn /> : <App />;
  */
 declare function useQuickdraw(): QuickdrawStatus;
 
-export { type AdminKeysOf, type AdminListRequest, type AdminMutationMember, type AdminQueryMember, type AdminRow, type AdminScreen, type AdminServiceInfo, type AdminWriteData, type AuthProviderInfo, type AuthRoutesTarget, type CacheSession, type CallRequest, type CallResult, type CollectionController, type CollectionEntry, type CollectionHub, type CollectionItem, CollectionQueryKey, type CollectionShape, type CollectionState, type CollectionTarget, ConnectionAuth, ConnectionRefusal, ConnectionStatus, type CoordinatorOptions, DEFAULT_INVALIDATION_WINDOW_MS, type DeltaBatch, type DeltaOptions, type DeltaResult, type EntityEntry, type EntityStore, type EventBus, type EventHandler, type HelloChange, type IndexRow, type InvalidateOptions, type InvalidationCoordinator, type JoinMember, type JoinStatus, type KeptResult, type LiveData, MethodMutationOptions, MethodQueryKey, MethodQueryOptions, MutationCallOptions, PENDING_STREAM, type PageReply, type PresenceStore, QueryCallOptions, QuickdrawClient, QuickdrawConnection, QuickdrawConnectionOptions, QuickdrawProvider, type QuickdrawProviderProps, type QuickdrawStatus, RECONNECT_JITTER_MS, type ReconnectRefetchOptions, type ResumeReason, SEARCH_DEBOUNCE_MS, STREAM_DEFAULT_MAX, STREAM_MAX_ITEMS, type ScopeHolding, type ScopeOptions, type SignInUrlOptions, type StreamState, type StreamStore, type StreamTarget, type UseAdminServicesOptions, type UseAdminServicesResult, type UseJoinOptions, type UseJoinResult, adminOf, applyDeltas as applyCollectionDeltas, applyFrames as applyCollectionFrames, applyItems as applyCollectionItems, applyKept as applyCollectionKept, applyPage as applyCollectionPage, applySnapshot as applyCollectionSnapshot, authProviders, call, callData, clearAuthToken, createInvalidationCoordinator, createQuickdrawClient, emptyCollection, feedKey, getAuthToken, isNotModified, isUnknownOutcome, liveDataOf, newId, refetchOnAccessChanges, reloadOncePerSession, sessionOf, setAuthToken, shouldRetry, signInUrl, signOut, signOutEverywhere, useAdminServices, useJoin, usePresence, useQuickdraw };
+export { type AdminKeysOf, type AdminListRequest, type AdminMutationMember, type AdminQueryMember, type AdminRow, type AdminScreen, type AdminServiceInfo, type AdminWriteData, type CacheSession, type CollectionController, type CollectionEntry, type CollectionHub, type CollectionItem, CollectionQueryKey, type CollectionShape, type CollectionState, type CollectionTarget, ConnectionAuth, ConnectionRefusal, ConnectionStatus, type CoordinatorOptions, DEFAULT_INVALIDATION_WINDOW_MS, type DeltaBatch, type DeltaOptions, type DeltaResult, type EntityEntry, type EntityStore, type EventBus, type EventHandler, type HelloChange, type IndexRow, type InvalidateOptions, type InvalidationCoordinator, type JoinMember, type JoinStatus, type KeptResult, type LiveData, MethodMutationOptions, MethodQueryKey, MethodQueryOptions, MutationCallOptions, PENDING_STREAM, type PageReply, type PresenceStore, QueryCallOptions, QuickdrawClient, QuickdrawConnection, QuickdrawConnectionOptions, QuickdrawProvider, type QuickdrawProviderProps, type QuickdrawStatus, RECONNECT_JITTER_MS, type ReconnectRefetchOptions, type ResumeReason, SEARCH_DEBOUNCE_MS, STREAM_DEFAULT_MAX, STREAM_MAX_ITEMS, type ScopeHolding, type ScopeOptions, type StreamState, type StreamStore, type StreamTarget, type UseAdminServicesOptions, type UseAdminServicesResult, type UseJoinOptions, type UseJoinResult, adminOf, applyDeltas as applyCollectionDeltas, applyFrames as applyCollectionFrames, applyItems as applyCollectionItems, applyKept as applyCollectionKept, applyPage as applyCollectionPage, applySnapshot as applyCollectionSnapshot, createInvalidationCoordinator, createQuickdrawClient, emptyCollection, feedKey, liveDataOf, refetchOnAccessChanges, sessionOf, useAdminServices, useJoin, usePresence, useQuickdraw };

package/dist/client/index.js

@@ -2,19 +2,12 @@
 import {
   QuickdrawProvider,
   SEARCH_DEBOUNCE_MS,
-  call,
-  callData,
   createQuickdrawClient,
-  isNotModified,
-  isUnknownOutcome,
-  shouldRetry,
   useLiveData,
   useQuickdraw
-} from "../chunk-ZIVPHYRG.js";
+} from "../chunk-NZHA4TZD.js";
 import {
-  DEFAULT_BACKOFF_MS,
   DEFAULT_INVALIDATION_WINDOW_MS,
-  DEFAULT_SUBSCRIPTION_LANE,
   PENDING_STREAM,
   RECONNECT_JITTER_MS,
   STREAM_DEFAULT_MAX,
@@ -27,26 +20,37 @@ import {
   applyPage,
   applySnapshot,
   createInvalidationCoordinator,
-  createQuickdrawConnection,
   emptyCollection,
   feedKey,
   liveDataOf,
   overlaysOf,
   refetchOnAccessChanges,
-  reloadOncePerSession,
-  retryAfterOf,
   serverStateOf,
   sessionOf,
   useAdminServices,
   useConnectionState,
   useQuickdrawContext
-} from "../chunk-OECZPRPW.js";
-import "../chunk-CDKG4TFA.js";
-import "../chunk-VSQBHPWH.js";
-import "../chunk-RT6OILOI.js";
-import "../chunk-47AEXVDM.js";
-import "../chunk-Z2LZ7IZ7.js";
-import "../chunk-YSWH776Y.js";
+} from "../chunk-64I6MYBC.js";
+import "../chunk-XD7SRDUY.js";
+import "../chunk-4D2DOGAW.js";
+import "../chunk-AK23XSWD.js";
+import "../chunk-DKE6QO26.js";
+import {
+  authProviders,
+  clearAuthToken,
+  defineHost,
+  getAuthToken,
+  newId,
+  setAuthToken,
+  signInUrl,
+  signOut,
+  signOutEverywhere
+} from "../chunk-Z7I6SONO.js";
+import {
+  DEFAULT_ICE_SERVERS,
+  createPeerLink,
+  onPeerRequest
+} from "../chunk-DNP65TD5.js";
 import {
   buildBreadcrumbs,
   createServerCaller,
@@ -60,7 +64,24 @@ import {
   parseJWTPayload,
   routeRequiresAuth,
   truncate
-} from "../chunk-B2P7AZ25.js";
+} from "../chunk-CYE4UBOB.js";
+import "../chunk-ASAMUGHG.js";
+import {
+  call,
+  callData,
+  isNotModified,
+  isUnknownOutcome,
+  shouldRetry
+} from "../chunk-NX2V6SIL.js";
+import {
+  DEFAULT_BACKOFF_MS,
+  DEFAULT_SUBSCRIPTION_LANE,
+  createQuickdrawConnection,
+  hostOf,
+  onHostChange,
+  reloadOncePerSession,
+  retryAfterOf
+} from "../chunk-STH5DLQP.js";
 import {
   KEY_ROOT,
   collectionKey,
@@ -68,206 +89,20 @@ import {
   methodKey,
   methodKeyPrefix,
   serviceKeyPrefix
-} from "../chunk-X5CWPX7H.js";
+} from "../chunk-IIQ3WMJK.js";
+import "../chunk-7473HK24.js";
+import "../chunk-2FDSKLBO.js";
+import "../chunk-MPQAT55F.js";
+import "../chunk-A2RBQD66.js";
+import "../chunk-X4ZU4QH5.js";
+import "../chunk-GYLWEJHW.js";
+import "../chunk-47AEXVDM.js";
+import "../chunk-SN3OZVEQ.js";
+import "../chunk-7Y5ROPXL.js";
 import {
-  QuickdrawError,
-  isErrorCode,
-  isRecord
-} from "../chunk-4YO5H5ON.js";
-
-// src/client/auth.ts
-var AUTH_TOKEN_KEY = "auth_token";
-var DEFAULT_API_URL = "http://localhost:4000";
-var memoryToken = null;
-function onClient() {
-  return typeof window !== "undefined";
-}
-function storedToken() {
-  try {
-    return globalThis.localStorage.getItem(AUTH_TOKEN_KEY);
-  } catch {
-    return void 0;
-  }
-}
-function announce() {
-  if (typeof window.dispatchEvent === "function" && typeof Event === "function") {
-    window.dispatchEvent(new Event("auth-token-changed"));
-  }
-}
-function apiUrlOf(apiUrl) {
-  if (apiUrl !== void 0) {
-    return apiUrl;
-  }
-  try {
-    return process.env.NEXT_PUBLIC_API_URL ?? DEFAULT_API_URL;
-  } catch {
-    return DEFAULT_API_URL;
-  }
-}
-function getAuthToken() {
-  if (!onClient()) return null;
-  const stored = storedToken();
-  return stored === void 0 ? memoryToken : stored;
-}
-function setAuthToken(token) {
-  if (!onClient()) return;
-  memoryToken = token;
-  try {
-    globalThis.localStorage.setItem(AUTH_TOKEN_KEY, token);
-  } catch {
-  }
-  announce();
-}
-function clearAuthToken() {
-  if (!onClient()) return;
-  memoryToken = null;
-  try {
-    globalThis.localStorage.removeItem(AUTH_TOKEN_KEY);
-  } catch {
-  }
-  announce();
-}
-var PROVIDER_ID = /^[a-z0-9][a-z0-9-]*$/;
-function routesUrl(owner, target) {
-  const base = apiUrlOf(target.apiUrl).replace(/\/+$/, "");
-  const path = target.basePath ?? "/auth";
-  if (typeof path !== "string" || !path.startsWith("/")) {
-    throw new TypeError(`${owner}: basePath must start with "/", as createAuthRoutes takes it`);
-  }
-  return `${base}${path.replace(/\/+$/, "")}`;
-}
-function pageOrigin() {
-  try {
-    const origin = globalThis.location?.origin;
-    return typeof origin === "string" && origin !== "null" ? origin : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function signInUrl(provider, options = {}) {
-  if (typeof provider !== "string" || !PROVIDER_ID.test(provider)) {
-    throw new TypeError(
-      `signInUrl: a provider id is lowercase letters, digits and hyphens; got ${String(provider)}`
-    );
-  }
-  const url = new URL(`${routesUrl("signInUrl", options)}/${provider}/start`);
-  const returnTo = options.returnTo ?? pageOrigin();
-  if (returnTo !== void 0) {
-    url.searchParams.set("returnTo", returnTo);
-  }
-  return url.toString();
-}
-async function refusalOf(response) {
-  let body;
-  try {
-    body = await response.json();
-  } catch {
-    body = void 0;
-  }
-  const code = isRecord(body) && isErrorCode(body.error) ? body.error : void 0;
-  const message = isRecord(body) && typeof body.message === "string" ? body.message : `The auth route answered ${String(response.status)}`;
-  if (code !== void 0) {
-    return new QuickdrawError(code, message);
-  }
-  return new QuickdrawError(response.status === 429 ? "RATE_LIMITED" : "INTERNAL", message);
-}
-async function postRoute(owner, route, target) {
-  const url = `${routesUrl(owner, target)}${route}`;
-  const token = getAuthToken();
-  let response;
-  try {
-    response = await fetch(url, {
-      method: "POST",
-      credentials: "include",
-      headers: {
-        "Content-Type": "application/json",
-        ...token === null ? {} : { Authorization: `Bearer ${token}` }
-      },
-      body: "{}"
-    });
-  } catch (error) {
-    throw new QuickdrawError("INTERNAL", `${owner}: ${url} could not be reached`, {
-      cause: error instanceof Error ? error.message : String(error)
-    });
-  }
-  if (!response.ok) {
-    throw await refusalOf(response);
-  }
-}
-async function signOut(options = {}) {
-  try {
-    await postRoute("signOut", "/logout", options);
-  } finally {
-    clearAuthToken();
-  }
-}
-var PROVIDER_KINDS = /* @__PURE__ */ new Set(["oauth", "mock", "guest"]);
-function providerInfoOf(value) {
-  if (!isRecord(value) || typeof value.id !== "string" || !PROVIDER_ID.test(value.id)) {
-    return void 0;
-  }
-  const kind = PROVIDER_KINDS.has(value.kind) ? value.kind : void 0;
-  return kind === void 0 ? void 0 : { id: value.id, name: typeof value.name === "string" ? value.name : value.id, kind };
-}
-async function authProviders(options = {}) {
-  const url = `${routesUrl("authProviders", options)}/providers`;
-  let response;
-  try {
-    response = await fetch(url, { headers: { Accept: "application/json" } });
-  } catch (error) {
-    throw new QuickdrawError("INTERNAL", `authProviders: ${url} could not be reached`, {
-      cause: error instanceof Error ? error.message : String(error)
-    });
-  }
-  if (!response.ok) {
-    throw await refusalOf(response);
-  }
-  let body;
-  try {
-    body = await response.json();
-  } catch {
-    body = void 0;
-  }
-  if (!isRecord(body) || !Array.isArray(body.providers)) {
-    throw new QuickdrawError("INTERNAL", `authProviders: ${url} answered no list of providers`);
-  }
-  return body.providers.flatMap((entry) => {
-    const info = providerInfoOf(entry);
-    return info === void 0 ? [] : [info];
-  });
-}
-async function signOutEverywhere(options = {}) {
-  try {
-    await postRoute("signOutEverywhere", "/logout-all", options);
-  } finally {
-    clearAuthToken();
-  }
-}
-
-// src/client/newId.ts
-function uuidByte(byte, index) {
-  if (index === 6) {
-    return 64 + byte % 16;
-  }
-  return index === 8 ? 128 + byte % 64 : byte;
-}
-function uuidOf(bytes) {
-  const hex = Array.from(
-    bytes,
-    (byte, index) => uuidByte(byte, index).toString(16).padStart(2, "0")
-  ).join("");
-  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-}
-function newId() {
-  const { crypto } = globalThis;
-  if (typeof crypto?.randomUUID === "function") {
-    return crypto.randomUUID();
-  }
-  if (typeof crypto?.getRandomValues !== "function") {
-    throw new TypeError("newId: this runtime has no crypto.getRandomValues");
-  }
-  return uuidOf(crypto.getRandomValues(new Uint8Array(16)));
-}
+  QuickdrawError
+} from "../chunk-Q4OGQM5I.js";
+import "../chunk-QSU47XEX.js";
 
 // src/client/live/usePresence.ts
 import { useCallback, useSyncExternalStore } from "react";
@@ -413,6 +248,7 @@ function adminOf(client, key) {
 }
 export {
   DEFAULT_BACKOFF_MS,
+  DEFAULT_ICE_SERVERS,
   DEFAULT_INVALIDATION_WINDOW_MS,
   DEFAULT_SUBSCRIPTION_LANE,
   KEY_ROOT,
@@ -436,9 +272,11 @@ export {
   clearAuthToken,
   collectionKey,
   createInvalidationCoordinator,
+  createPeerLink,
   createQuickdrawClient,
   createQuickdrawConnection,
   createServerCaller,
+  defineHost,
   emptyCollection,
   entityKey,
   feedKey,
@@ -450,12 +288,15 @@ export {
   formatNumber,
   formatPercent,
   getAuthToken,
+  hostOf,
   isNotModified,
   isUnknownOutcome,
   liveDataOf,
   methodKey,
   methodKeyPrefix,
   newId,
+  onHostChange,
+  onPeerRequest,
   overlaysOf,
   parseJWTPayload,
   refetchOnAccessChanges,