@ethlete/query 6.0.0-next.24 → 6.0.0-next.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethlete/query",
-  "version": "6.0.0-next.24",
+  "version": "6.0.0-next.26",
   "license": "MIT",
   "sideEffects": false,
   "peerDependencies": {
@@ -13,7 +13,6 @@
     "@ethlete/types": "^2.0.0-beta.4",
     "@nx/devkit": "23.1.0",
     "rxjs": "7.8.2",
-    "socket.io-client": "4.8.3",
     "typescript": "6.0.3",
     "vite": "8.1.5"
   },
@@ -24,9 +23,6 @@
     "@nx/devkit": {
       "optional": true
     },
-    "socket.io-client": {
-      "optional": true
-    },
     "typescript": {
       "optional": true
     },

package/types/ethlete-query-testing.d.ts

@@ -1,4 +1,4 @@
-import { AnyCreateQueryClientResult, QueryClientRef, createGetQuery, createPostQuery, createPutQuery, createPatchQuery, createDeleteQuery, BearerAuthProviderFeatureContext, AnyQueryBuilder, BearerAuthProvider, AuthQueryBuilder, TokenRefreshQueryBuilder, TokenRefreshQueryConfig, QueryPersistenceAdapter, PersistedQueryEntry } from '@ethlete/query';
+import { AnyCreateQueryClientResult, QueryClientRef, createGetQuery, createPostQuery, createPutQuery, createPatchQuery, createDeleteQuery, BearerAuthProviderFeatureContext, AnyQueryBuilder, BearerAuthProvider, AuthQueryBuilder, TokenRefreshQueryBuilder, TokenRefreshQueryConfig, QueryPersistenceAdapter, PersistedQueryEntry, WebSocketClientIo, SocketMessageView } from '@ethlete/query';
 import { HttpClient } from '@angular/common/http';
 import { HttpTestingController } from '@angular/common/http/testing';
 import { Injector } from '@angular/core';
@@ -249,5 +249,44 @@ declare const expectFlushAndWait: <T = unknown>(httpTesting: HttpTestingControll
     statusText: string;
 }) => void;
 
-export { createFakeQueryPersistenceStore, expectAndFlush, expectFlushAndWait, flushMultiTabSync, installFakeBroadcastChannel, installFakeWebLocks, setupAuthTest, setupQueryTest };
-export type { AnyFeatureBuilder, AuthTestSetup, AuthTestSetupConfig, FakeBroadcastChannelHandle, FakeBroadcastMessage, FakeQueryPersistenceStoreHandle, FakeWebLocksHandle, QueryTestSetup, QueryTestSetupConfig };
+/** A scripted stand-in for `socket.io-client`'s `io`, driven from a spec. */
+type WebSocketTestDouble = {
+    /** Pass this as `createWebSocketClient({ io })`. */
+    io: WebSocketClientIo;
+    /** The url and options the client called the factory with, or `null` until it did. */
+    connection: () => {
+        url: string;
+        transports: string[] | undefined;
+    } | null;
+    /** Every message the client sent, newest last - room joins and leaves included. */
+    sent: () => {
+        event: string;
+        data: unknown;
+    }[];
+    /** Whether the client asked the socket to connect, and whether it has since disconnected it. */
+    state: () => {
+        connectRequested: boolean;
+        disconnected: boolean;
+    };
+    /** Complete the handshake, so the client's `isConnected` turns true and queued rooms re-join. */
+    serverConnect: () => void;
+    /** Drop the connection, so `isConnected` turns false. */
+    serverDisconnect: () => void;
+    /** Deliver a message the way the server would. */
+    serverSend: (message: SocketMessageView) => void;
+    /** Deliver a raw frame, for the malformed-payload path. */
+    serverSendRaw: (frame: string) => void;
+};
+/**
+ * A socket io test double, for specs around `createWebSocketClient` - which takes its `io` factory as
+ * an option precisely so a spec (or an app that never opens a socket) needs no `socket.io-client`.
+ *
+ * Nothing here connects on its own: the client's own `connect()` only flips
+ * {@link WebSocketTestDouble.state}, and it is {@link WebSocketTestDouble.serverConnect} that fires
+ * the `connect` listener. That split is what makes "joined a room while disconnected, and the join
+ * was re-sent on connect" testable.
+ */
+declare const createWebSocketTestDouble: () => WebSocketTestDouble;
+
+export { createFakeQueryPersistenceStore, createWebSocketTestDouble, expectAndFlush, expectFlushAndWait, flushMultiTabSync, installFakeBroadcastChannel, installFakeWebLocks, setupAuthTest, setupQueryTest };
+export type { AnyFeatureBuilder, AuthTestSetup, AuthTestSetupConfig, FakeBroadcastChannelHandle, FakeBroadcastMessage, FakeQueryPersistenceStoreHandle, FakeWebLocksHandle, QueryTestSetup, QueryTestSetupConfig, WebSocketTestDouble };

package/types/ethlete-query.d.ts

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { DestroyRef, EnvironmentInjector, ErrorHandler, WritableSignal, Signal, Injector, CreateEffectOptions, EnvironmentProviders, CreateComputedOptions, InjectionToken, TrackByFunction, PipeTransform, OnInit, OnDestroy } from '@angular/core';
 import * as _ethlete_core from '@ethlete/core';
-import { ProviderDefinition, RuntimeError } from '@ethlete/core';
+import { RuntimeError, ProviderDefinition } from '@ethlete/core';
 import * as rxjs from 'rxjs';
 import { Observable, Subscribable, BehaviorSubject } from 'rxjs';
 import * as _angular_common_http from '@angular/common/http';
@@ -40,18 +40,9 @@ type DescribableFeature = {
     devtools?: QueryDevtoolsFeatureDescriber;
 };
 
-/**
- * Route building, query-string serialization and the token clock - shared by the current generation and
- * the legacy V2 client, which re-exports them under their original names.
- */
-declare const buildErrorMessage: (code: string, message: string) => string;
-declare class QueryError extends Error {
-    data?: unknown;
-    constructor(code: string, message: string, data?: unknown);
-}
-declare const invalidBaseRouteError: (data: unknown) => QueryError;
-declare const invalidRouteError: (data: unknown) => QueryError;
-declare const pathParamsMissingInRouteFunctionError: (data: unknown) => QueryError;
+declare const invalidBaseRouteError: (data: unknown) => RuntimeError<1>;
+declare const invalidRouteError: (data: unknown) => RuntimeError<2>;
+declare const pathParamsMissingInRouteFunctionError: (data: unknown) => RuntimeError<3>;
 type QueryParams = object;
 type PathParams = Record<string, string | number>;
 /** A literal route, or a function building one from path params. Structurally the legacy `AnyRoute`. */
@@ -514,6 +505,121 @@ type QueryDevtoolsFormLinksRecorder = QueryDevtoolsFormLinksHandle & {
     track: <T>(build: () => T) => T;
 };
 
+/**
+ * A JSON-pointer-style path into a response body: object keys and array indices, root first. Captured
+ * by the devtools panel from wherever the user opened the overrides menu in the value explorer.
+ */
+type JsonPath = (string | number)[];
+/**
+ * One path-addressed edit an override registry replays against the live response on every fetch. Unlike
+ * the panel's raw-JSON JIT editor, an op describes *how* to change a value rather than freezing the
+ * whole body, which is what lets it survive a refetch that returns a differently-valued but same-shaped
+ * response.
+ *
+ * `reset` is never stored or replayed - arming one clears the other ops already armed at its exact path
+ * instead, so the panel's "reset this value" action and its "arm an edit" actions share one entry point.
+ */
+type OverrideOp = {
+    type: 'set';
+    path: JsonPath;
+    value: unknown;
+} | {
+    type: 'stringPreset';
+    path: JsonPath;
+    preset: 'short' | 'long' | 'unicode' | 'custom';
+    custom?: string;
+} | {
+    type: 'numberPreset';
+    path: JsonPath;
+    preset: 'zero' | 'negative' | 'huge' | 'custom';
+    custom?: number;
+} | {
+    type: 'booleanFlip';
+    path: JsonPath;
+} | {
+    type: 'datePreset';
+    path: JsonPath;
+    preset: 'now' | 'plusDay' | 'minusDay' | 'farFuture' | 'farPast' | 'invalid';
+} | {
+    type: 'duplicateArrayItem';
+    path: JsonPath;
+    index: number;
+} | {
+    type: 'duplicateArray';
+    path: JsonPath;
+} | {
+    type: 'paginationResize';
+    path: JsonPath;
+    mode: 'shrink' | 'extend';
+    amount: number;
+} | {
+    type: 'reset';
+    path: JsonPath;
+};
+/** One op armed on a query, with the id its owning {@link QueryDevtoolsOverridesHandle} lists it under. */
+type QueryDevtoolsOverrideEntry = {
+    id: string;
+    op: OverrideOp;
+};
+/** The read side of an overrides recorder, as a {@link QueryDevtoolsEntry} exposes it to the panel. */
+type QueryDevtoolsOverridesHandle = {
+    /** Every op currently armed on this query, oldest first - the order {@link applyQueryDevtoolsOverrides} replays them in. */
+    list: Signal<readonly QueryDevtoolsOverrideEntry[]>;
+    /** Disarms one op by id. */
+    clear: (id: string) => void;
+    /** Disarms every op on this query. */
+    clearAll: () => void;
+};
+/** The write side, used by the instrumentation inside the query itself. */
+type QueryDevtoolsOverridesRecorder = QueryDevtoolsOverridesHandle & {
+    /**
+     * Arms a new op, or - for `{ type: 'reset' }` - disarms whatever op(s) already sit at that exact path
+     * instead of adding one.
+     */
+    arm: (op: OverrideOp) => void;
+};
+/**
+ * Clones `item` (a plain object array element) with every identity-shaped field replaced by a fresh
+ * value, so a duplicated row never collides with the one it was copied from. A field counts as identity
+ * when its key looks like one (`id`, `fooId`, `uuid`, `key`) or every sibling in `siblings` holds a
+ * distinct value for it - without this, `track` bindings and detail-by-id lookups can't tell the copy
+ * from the original.
+ */
+declare const smartDuplicateArrayItem: (item: unknown, siblings: readonly unknown[]) => unknown;
+/**
+ * The shape of a paginated response this module knows how to resize, matching the variants declared in
+ * `@ethlete/types`' pagination types.
+ */
+type PaginationShape = 'gg-like' | 'dyn-like' | 'normalized' | 'contentful-gql-like';
+/**
+ * Whether `value` structurally matches one of the pagination shapes shrink/extend know how to resize -
+ * an `items` array plus a recognized combination of total/page/limit counters. Exported so the panel's
+ * menu can offer shrink/extend only where it would actually apply.
+ */
+declare const detectPaginationShape: (value: unknown) => PaginationShape | null;
+/**
+ * Whether a leaf is offered date presets instead of string presets: its key looks date-shaped
+ * (`date`, `fooAt`, `fooTimestamp`) and its value round-trips through `Date.parse`, or the value
+ * itself matches an ISO-8601 date/datetime pattern regardless of what its key is called. Exported so
+ * the panel's menu can decide which preset list to show without duplicating the check.
+ */
+declare const isDateShapedLeaf: (key: string | number | null, value: unknown) => boolean;
+/**
+ * Every path under `value` (relative to it, not absolute) whose leaf is of `kind` - the paths a "fill
+ * recursively" menu action turns into one `set`-family op each. Exported so the panel's menu builds the
+ * op list with the exact same walk the docs describe, rather than a second, possibly-drifted one.
+ */
+declare const collectLeafPaths: (value: unknown, kind: "string" | "number" | "boolean") => JsonPath[];
+/**
+ * Replays `entries` against `raw`, in order, and reports which ones no longer resolve. Shared by the
+ * pipeline (which only needs {@link value}) and the panel's menu (which previews a value and marks stale
+ * ops before arming a new one) - one implementation, so the two cannot drift.
+ */
+declare const applyQueryDevtoolsOverrides: (entries: readonly QueryDevtoolsOverrideEntry[], raw: unknown) => {
+    value: unknown;
+    staleIds: string[];
+};
+
 /**
  * What a query did over its lifetime, as the devtools panel accounts for it: how often it ran, how many
  * of those runs reached the network, and how much payload they moved.
@@ -556,6 +662,13 @@ type QueryDevtoolsStats = {
     lastDurationMs: number | null;
     /** The sum of every response's duration, which together with {@link responses} gives the average. */
     totalDurationMs: number;
+    /**
+     * Whether the query's last completed run ended in a devtools fault rather than a real server
+     * response or failure - the fact the panel's tamper indicator badges on. Cleared by the next real
+     * response; a run that exhausts its retries on a real error also clears it, since nothing about that
+     * outcome was altered by the devtools.
+     */
+    lastResponseWasFaulted: boolean;
 };
 /** A payload whose transferred size is to be measured, plus the headers it came with (if any). */
 type QueryDevtoolsPayload = {
@@ -630,7 +743,9 @@ type QueryDevtoolsStatsRecorder = QueryDevtoolsStatsHandle & {
         url?: string;
     }) => void;
     recordResponse: (payload: QueryDevtoolsPayload) => void;
-    recordError: () => void;
+    recordError: (options?: {
+        faulted?: boolean;
+    }) => void;
     /**
      * Raises the attempt count of the run in flight. Idempotent per attempt, so a caller driven off a
      * signal may report the same attempt more than once without inflating {@link QueryDevtoolsStats.retries}.
@@ -639,6 +754,17 @@ type QueryDevtoolsStatsRecorder = QueryDevtoolsStatsHandle & {
         attempt: number;
     }) => void;
 };
+/**
+ * The size of a payload in bytes, and whether that size is the one that went over the wire. Only a
+ * `content-length` header is exact; everything else is measured by serializing the body.
+ *
+ * Part of the devtools contract - the panel measures the cache and the event log with it. **Not part of
+ * the general public contract.**
+ */
+declare const measureQueryDevtoolsPayload: (payload: QueryDevtoolsPayload) => {
+    bytes: number;
+    isExact: boolean;
+};
 /**
  * Adds up the stats of several entries, for a stack's or a client's total. `lastDurationMs` is taken from
  * whichever entry responded most recently rather than summed.
@@ -657,6 +783,11 @@ type SetupQueryStateOptions<TArgs extends QueryArgs> = {
      * not installed.
      */
     devtoolsFormLinks?: QueryDevtoolsFormLinksRecorder | null;
+    /**
+     * The recorder of response overrides armed on this query, or nothing when the devtools are not
+     * installed. Replayed against every response that settles into {@link QueryState.rawResponse}.
+     */
+    devtoolsOverrides?: QueryDevtoolsOverridesRecorder | null;
 };
 type QueryStateSubtle<TArgs extends QueryArgs> = {
     request: WritableSignal<HttpRequest<TArgs> | null>;
@@ -2041,7 +2172,7 @@ type HttpRequestLoadingProgressState = {
     loaded: number;
     /** The percentage of the transfer that is completed */
     percentage: number;
-    /** The speed of the transfer in bytes per millisecond */
+    /** The speed of the transfer in bytes per second */
     speed: number | null;
     /** The estimated remaining time in milliseconds */
     remainingTime: number | null;
@@ -2128,6 +2259,13 @@ type HttpRequestSubtle<TArgs extends QueryArgs> = {
     attempts: Signal<number>;
     /** The retry currently being waited out, or `null` when none is. @see HttpRequestRetryState */
     retryState: Signal<HttpRequestRetryState | null>;
+    /**
+     * How long the last settled execution took, measured from the `execute()` that started it - so it
+     * covers every attempt and the backoff between them, not just the last round trip. `null` until one
+     * has settled, and untouched by a response adopted from another tab or from disk, neither of which
+     * this request spent any time on.
+     */
+    lastDurationMs: Signal<number | null>;
 };
 type HttpRequest<TArgs extends QueryArgs> = {
     /** The HTTP method of the request. */
@@ -2187,6 +2325,11 @@ type HttpRequest<TArgs extends QueryArgs> = {
 type HttpErrorEvent = {
     type: 'error';
     error: QueryErrorResponse;
+    /**
+     * Whether this error is a devtools fault the panel armed, rather than a real server failure - the
+     * fact `lastResponseWasFaulted` (`query-devtools-stats.ts`) is built from.
+     */
+    faulted?: boolean;
 };
 type RequestHttpEvent<TArgs extends QueryArgs> = HttpEvent<ResponseType<TArgs>> | HttpErrorEvent;
 declare const createHttpRequest: <TArgs extends QueryArgs>(options: CreateHttpRequestOptions<TArgs>) => HttpRequest<TArgs>;
@@ -2745,6 +2888,10 @@ declare const QueryRuntimeErrorCode: {
     readonly CIRCULAR_QUERY_DEPENDENCY: 800;
     readonly QUERY_SEQUENCE_ALREADY_RUNNING: 900;
     readonly LEGACY_PREPARE_WITHOUT_INJECTION_CONTEXT: 950;
+    readonly LEGACY_QUERY_STATE_ALREADY_HAS_KEY: 951;
+    readonly LEGACY_QUERY_STATE_DOES_NOT_CONTAIN_KEY: 952;
+    readonly LEGACY_QUERY_STATE_CANNOT_TRANSFORM: 953;
+    readonly LEGACY_INVALID_BODY: 954;
 };
 type QueryRuntimeErrorCode = (typeof QueryRuntimeErrorCode)[keyof typeof QueryRuntimeErrorCode];
 declare const queryFeatureUsedMultipleTimes: (type: QueryFeatureType) => RuntimeError<0>;
@@ -3645,7 +3792,11 @@ type BearerAuthExecutionStateLogout = {
     type: 'logout';
     state: 'success';
 };
-type BearerAuthExecutionState<TType extends string = string> = BearerAuthExecutionStateLoading<TType> | BearerAuthExecutionStateSuccess<TType> | BearerAuthExecutionStateError<TType> | BearerAuthExecutionStateLogout;
+type BearerAuthExecutionStateTokenSeed = {
+    type: 'tokenSeed';
+    state: 'success';
+};
+type BearerAuthExecutionState<TType extends string = string> = BearerAuthExecutionStateLoading<TType> | BearerAuthExecutionStateSuccess<TType> | BearerAuthExecutionStateError<TType> | BearerAuthExecutionStateLogout | BearerAuthExecutionStateTokenSeed;
 declare const BearerAuthFeatureType: {
     readonly PERSISTENT_AUTH: "PERSISTENT_AUTH";
     readonly TOKEN_EXPIRATION_WARNING: "TOKEN_EXPIRATION_WARNING";
@@ -3791,15 +3942,16 @@ type BearerAuthProvider<TBuilders extends readonly AnyQueryBuilder[], TFeatures
      * The current execution state of the auth provider.
      * Tracks the latest auth operation (login, autoLogin, tokenRefresh, logout, revocation) with its state and payload.
      */
-    executionState: Signal<BearerAuthExecutionState<ExtractQueryKey<TBuilders[number]> | 'autoLogin' | 'tokenRefresh' | 'logout' | 'revocation'> | null>;
+    executionState: Signal<BearerAuthExecutionState<ExtractQueryKey<TBuilders[number]> | 'autoLogin' | 'tokenRefresh' | 'logout' | 'revocation' | 'tokenSeed'> | null>;
     /**
      * Seeds the provider with tokens that were issued outside of it - an SSO/OIDC callback that
      * arrives with both tokens in the URL, a token handed over by a native shell, a test harness.
      *
-     * Behaves exactly like a successful auth query: the tokens are applied, `bearerData` /
-     * `isAuthenticated` update, `afterTokenRefresh$` emits so waiting secure queries run, and (unless
-     * disabled) other tabs are synced. Without it the only way in is to execute the refresh query with
-     * the refresh token and throw the access token away.
+     * Behaves like a successful auth query: the tokens are applied, `bearerData` / `isAuthenticated`
+     * update, `executionState` becomes `{ type: 'tokenSeed', state: 'success' }`, `afterTokenRefresh$`
+     * emits so waiting secure queries run, and (unless disabled) other tabs are synced. Without it the
+     * only way in is to execute the refresh query with the refresh token and throw the access token
+     * away.
      *
      * Does **not** persist anything by itself - `withPersistentAuth` picks the tokens up through the
      * same signals it watches for query-issued ones.
@@ -4067,6 +4219,12 @@ type QueryDevtoolsEntry = {
     stats?: QueryDevtoolsStatsHandle;
     /** The query forms this entry's args read, for queries created with a `withArgs` feature. */
     formLinks?: QueryDevtoolsFormLinksHandle;
+    /**
+     * The response overrides armed on this entry, for queries. Unlike {@link stats}/{@link formLinks} -
+     * whose write side is internal instrumentation the panel only ever reads - the panel itself is what
+     * arms an override, so this exposes the full recorder rather than a read-only handle.
+     */
+    overrides?: QueryDevtoolsOverridesRecorder;
 };
 /**
  * What an instrumentation site hands to the registry. Raw values (`route`, `clientRef`) are rendered
@@ -4097,6 +4255,8 @@ type QueryDevtoolsRegistration = {
     stats?: QueryDevtoolsStatsHandle;
     /** @see QueryDevtoolsEntry.formLinks */
     formLinks?: QueryDevtoolsFormLinksHandle;
+    /** @see QueryDevtoolsEntry.overrides */
+    overrides?: QueryDevtoolsOverridesRecorder;
 };
 /** The registry {@link provideQueryDevtools} installs. */
 type QueryDevtoolsRegistrar = (entry: QueryDevtoolsRegistration) => () => void;
@@ -6375,8 +6535,8 @@ declare class QueryDevtoolsComponent {
                 readonly refreshBuffer: number | "30000 (default)";
                 readonly expiresInPropertyName: string;
                 readonly strategy: _ethlete_query.AuthBearerRefreshStrategy | "AuthBearerRefreshStrategy.BeforeExpiration (default)";
-                readonly requestArgsAdapter: "default" | "custom";
-                readonly responseAdapter: "default" | "custom";
+                readonly requestArgsAdapter: "custom" | "default";
+                readonly responseAdapter: "custom" | "default";
             };
             readonly name?: undefined;
             readonly value?: undefined;
@@ -6736,19 +6896,19 @@ declare class QueryDirective<Q extends QueryDirectiveType | null> {
 /**
  * @deprecated Part of the legacy (v2) query system. Migrate to the current query API - see https://ethlete-sdk-docs.web.app/query/migrating-from-v2, and run `nx g @ethlete/query:migrate-to-query-v3` to rewrite the mechanical parts. Intent to remove in v7.
  */
-declare const queryStateAlreadyHasKeyError: (data: unknown) => QueryError;
+declare const queryStateAlreadyHasKeyError: (data: unknown) => RuntimeError<951>;
 /**
  * @deprecated Part of the legacy (v2) query system. Migrate to the current query API - see https://ethlete-sdk-docs.web.app/query/migrating-from-v2, and run `nx g @ethlete/query:migrate-to-query-v3` to rewrite the mechanical parts. Intent to remove in v7.
  */
-declare const queryStateDoesNotContainKeyError: (data: unknown) => QueryError;
+declare const queryStateDoesNotContainKeyError: (data: unknown) => RuntimeError<952>;
 /**
  * @deprecated Part of the legacy (v2) query system. Migrate to the current query API - see https://ethlete-sdk-docs.web.app/query/migrating-from-v2, and run `nx g @ethlete/query:migrate-to-query-v3` to rewrite the mechanical parts. Intent to remove in v7.
  */
-declare const queryStateCannotTransformError: (data: unknown) => QueryError;
+declare const queryStateCannotTransformError: (data: unknown) => RuntimeError<953>;
 /**
  * @deprecated Part of the legacy (v2) query system. Migrate to the current query API - see https://ethlete-sdk-docs.web.app/query/migrating-from-v2, and run `nx g @ethlete/query:migrate-to-query-v3` to rewrite the mechanical parts. Intent to remove in v7.
  */
-declare const invalidBodyError: (data: unknown) => QueryError;
+declare const invalidBodyError: (data: unknown) => RuntimeError<954>;
 
 /**
  * The args accepted by the creator's `prepare()` - includes `mock`/`config` extras.
@@ -7132,6 +7292,11 @@ type WebSocketDevtoolsMessage = {
     room: string;
     event: string;
     data: unknown;
+    /**
+     * Whether the message arrived from the server or was sent by this client - room joins and leaves
+     * included, which is what makes "the room was never joined" tellable from "the room is quiet".
+     */
+    direction: 'in' | 'out';
 };
 /**
  * The live handle a web socket client registers with the devtools. Read by the `<et-query-devtools>`
@@ -7141,13 +7306,55 @@ type WebSocketDevtoolsHandle = {
     connected: Signal<boolean>;
     rooms: Signal<string[]>;
     messages: Signal<WebSocketDevtoolsMessage[]>;
+    /**
+     * Sends a message the way the app would, so the panel can provoke a server that only answers a
+     * client that asked. Recorded in {@link messages} like any other outgoing one.
+     */
+    emit: (options: {
+        event: string;
+        data: unknown;
+    }) => void;
 };
 type CreateWebSocketClientTransport = 'polling' | 'websocket' | 'webtransport';
+/** The options {@link createWebSocketClient} passes to the socket io factory. */
+type WebSocketClientIoOptions = {
+    withCredentials: boolean;
+    autoConnect: boolean;
+    transports: CreateWebSocketClientTransport[] | undefined;
+};
+/** The slice of a socket io `Socket` this client drives. */
+type WebSocketClientSocket = {
+    connect: () => void;
+    disconnect: () => void;
+    emit: (event: string, data: unknown) => void;
+    on: (event: 'connect' | 'disconnect', listener: () => void) => void;
+    onAny: (listener: (data: string) => void) => void;
+};
+/**
+ * The `io` factory of `socket.io-client`, declared structurally.
+ *
+ * `@ethlete/query` never imports `socket.io-client` itself: the package ships no `sideEffects: false`,
+ * so a single static import of it is unshakeable and would cost *every* consumer ~13 kB gz - a
+ * REST-only app included, which could then not even build without installing the optional peer.
+ * Passing `io` in keeps that cost with the apps that actually open a socket.
+ */
+type WebSocketClientIo = (url: string, options: WebSocketClientIoOptions) => WebSocketClientSocket;
 type CreateWebSocketClientConfigOptions = {
     /** A unique name for the client */
     name: string;
     /** The URL of the socket io server */
     url: string;
+    /**
+     * The `io` factory, imported by the app: `import { io } from 'socket.io-client'`.
+     *
+     * @example
+     * ```ts
+     * import { io } from 'socket.io-client';
+     *
+     * const MATCH_SOCKET = createWebSocketClient({ name: 'match', url: env.wsUrl, io });
+     * ```
+     */
+    io: WebSocketClientIo;
     /** A list of transports to try (in order). Engine.io always attempts to connect directly with the first one, provided the feature detection test for it passes. */
     transports?: CreateWebSocketClientTransport[];
 };
@@ -7185,5 +7392,5 @@ type WebSocketClientResult<TMessageData extends SocketMessageView = SocketMessag
 type AnyWebSocketClient<TMessageData extends SocketMessageView = SocketMessageView> = WebSocketClientResult<TMessageData>;
 declare const createWebSocketClient: <TMessageData extends SocketMessageView = SocketMessageView>(options: CreateWebSocketClientConfigOptions) => WebSocketClientResult<TMessageData>;
 
-export { AuthBearerRefreshStrategy, BasicAuthProvider, BearerAuthFeatureType, BooleanArrayQueryField, CLEAR_QUERY_ARGS, CustomHeaderAuthProvider, DEFAULT_KEEP_UNUSED_FOR, DEFAULT_QUERY_PERSISTENCE_MAX_AGE, DEFAULT_QUERY_PERSISTENCE_MAX_ENTRIES, DEFAULT_QUERY_PERSISTENCE_VERSION, DEFAULT_QUERY_PERSISTENCE_WRITE_DELAY, DateArrayQueryField, DateQueryField, EMPTY_QUERY_DEVTOOLS_FAULT, EntityStore, IGNORED_FILTER_COUNT_FIELDS, INFINITY_QUERY_TOKEN, InfinityQuery, InfinityQueryDirective, InfinityQueryTriggerDirective, LegacyQuery, LegacyQueryCreator, MAX_UNUSED_ENTRIES, NumberArrayQueryField, ParseHttpErrorCodeToMessageDePipe, ParseHttpErrorCodeToMessageEnPipe, ParseHttpErrorCodeToTitleDePipe, ParseHttpErrorCodeToTitleEnPipe, QUERY_CLIENT_DEVTOOLS_TOKEN, QUERY_DEVTOOLS_FAULT_STATUSES, QUERY_PERSISTENCE_STORE_VERSION, QUERY_SYNC_PROTOCOL_VERSION, QueryClientFeatureType, QueryDevtoolsComponent, QueryDirective, QueryError, QueryFeatureType, QueryField, QueryForm, QueryFormSignals, QueryRuntimeErrorCode, QueryShortNamePipe, QueryStateType, QueryStore, SERVER_ERROR_KIND, SERVER_VIOLATION_ERROR_KIND, SPEED_BUFFER_TIME_IN_MS, SearchQueryField, SortQueryField, StringArrayQueryField, V2BearerAuthProvider, V2Query, V2QueryClient, V2QueryCreator, addQueryContainerHandling, applyQueryFeatures, authExtractTokensResponseMissingAccessToken, authExtractTokensResponseMissingRefreshToken, authExtractTokensResponseNotObject, authProviderFeatureUsedMultipleTimes, booleanArrayQueryField, buildErrorMessage, buildQueryCacheKey, buildQueryString, buildRoute, buildTimestampFromSeconds, castQueryCreatorTypes, circularQueryDependency, circularQueryDependencyChecker, clearQueryDevtoolsFaults, computeQueryAuthHeader, computeQueryBody, computeQueryHeaders, computeQueryMethod, computeQueryQueryParams, contentfulGqlLikePaginationAdapter, createBaseQuery, createBaseQueryCreator, createBearerAuthProvider, createDeleteQuery, createExecuteFn, createGetQuery, createGqlExecuteFn, createGqlMutationViaGet, createGqlMutationViaPost, createGqlQuery, createGqlQueryCreator, createGqlQueryViaGet, createGqlQueryViaPost, createHttpRequest, createIndexedDbQueryPersistenceAdapter, createInfinityQueryConfig, createLegacyQueryCreator, createNoopQueryPersistenceAdapter, createPagedQueryStack, createPatchQuery, createPersistentAuthFeature, createPostQuery, createPutQuery, createQuery, createQueryClient, createQueryCollection, createQueryCollectionSignal, createQueryCollectionSubject, createQueryContext, createQueryCreator, createQueryErrorResponse, createQueryFeature, createQueryForm, createQueryInvalidationFilter, createQueryKeyLockManager, createQueryObject, createQueryPersistenceEngine, createQueryRepository, createQuerySnapshotFn, createQueryStack, createQuerySyncEngine, createQuerySyncTransport, createSecureDeleteQuery, createSecureExecuteFactory, createSecureExecuteFn, createSecureGetQuery, createSecureGqlExecuteFn, createSecureGqlMutationViaGet, createSecureGqlMutationViaPost, createSecureGqlQuery, createSecureGqlQueryCreator, createSecureGqlQueryViaGet, createSecureGqlQueryViaPost, createSecurePatchQuery, createSecurePostQuery, createSecurePutQuery, createSecureQuery, createSecureQueryCreator, createTrackingFeature, createWebSocketClient, dateArrayQueryField, dateQueryField, decryptBearer, deepFreeze, def, detectContentTypeHeader, dynLikePaginationAdapter, effectComputed, emptyQueryArgs, ethletePaginationAdapter, executeUntilSettled, extractExpiresInSeconds, extractFormViolations, extractHtmlErrorMessage, extractQuery, fakePaginationAdapter, filterFailure, filterNull, filterQueryStates, filterSuccess, forEachHeader, getDefaultHeaders, getQueryFeatureUsage, getResponseUrl, ggLikePaginationAdapter, gql, gqlDataPropertyMissingInResponse, hasHeader, htmlErrorPayload, htmlQueryErrorParser, ignoreAutoRefresh, injectInfinityQueryResponseDelay, injectQueryContext, insertFrom, invalidBaseRouteError, invalidBodyError, invalidRouteError, invalidStateInsideSecureExecuteFactory, isAutoRefresh, isBasicAuthProvider, isBearerAuthProvider, isClassValidatorError, isCreateGqlQueryOptions, isCustomHeaderAuthProvider, isEmptyString, isGqlQueryConfig, isHtmlErrorPayload, isLegacyQuery, isNaN, isPageOutOfRangeError, isQuery, isQueryCollection, isQueryDevtoolsFaultArmed, isQueryErrorResponse, isQueryStateCancelled, isQueryStateFailure, isQueryStateLoading, isQueryStatePrepared, isQueryStateSuccess, isRequestError, isSymfonyError, isSymfonyFormViolationListError, isSymfonyListError, isSymfonyPagerfantaOutOfRangeError, isUnderInvalidatedUrl, legacyPrepareWithoutInjectionContext, mapToPaginated, mapViolationsToFormErrors, maybeExecute, mergeHeaders, nestedEffect, numberArrayQueryField, pagedQueryStackNextPageCalledWithoutPreviousPage, pagedQueryStackPageBiggerThanTotalPages, pagedQueryStackPreviousPageCalledButAlreadyAtFirstPage, paginatedEntityValueUpdater, parseAllXhrResponseHeaders, parseHttpErrorCodeToMessageDe, parseHttpErrorCodeToMessageEn, parseHttpErrorCodeToTitleDe, parseHttpErrorCodeToTitleEn, pathParamsMissingInRouteFunctionError, provideInfinityQueryResponseDelay, provideLegacyPrepareFallback, provideQueryClientForDevtools, provideQueryDevtools, queryArrayComputed, queryClientFeatureUsedMultipleTimes, queryComputed, queryComputedTillTruthy, queryDevtoolsEntries, queryDevtoolsFaults, queryErrorMessage, queryErrorMessages, queryExecute, queryFeatureUsedMultipleTimes, queryField, querySequence, querySequenceAlreadyRunning, queryStackTotalQueriesAndExpectedQueriesMismatch, queryStackWithArgsUsed, queryStackWithResponseUpdateUsed, queryStateAlreadyHasKeyError, queryStateCannotTransformError, queryStateDoesNotContainKeyError, queryStateErrorSignal, queryStateLoadingSignal, queryStateResponseSignal, queryStateSignal, registerQueryErrorParser, removeFrom, request, resetExecuteState, resetPageOnError, resolveInvalidationUrl, searchQueryField, serializeBody, setDefaultQueryRetryFn, setQueryDevtoolsFault, setupQueryDependencies, setupQueryExecuteState, setupQueryState, shouldAutoExecuteGqlQuery, shouldAutoExecuteQuery, shouldCacheQuery, shouldRetryRequest, silenceMissingWithArgsFeatureErrorUsedButWithArgsPresent, skipPaginationPageParamCalculator, sortQueryField, splitQueryConfig, stringArrayQueryField, stringifyQueryRouteParts, sumQueryDevtoolsStats, switchQueryCollectionState, switchQueryState, symfonyQueryErrorParser, takeUntilResponse, toQuerySignal, toQuerySubject, tokensNotAvailableInsideAuthAndExec, transformArrayResponse, transformExecStateToQueryState, transformGql, transformMethod, transformPaginatedResponse, transformToBoolean, transformToBooleanArray, transformToDate, transformToDateArray, transformToNumber, transformToNumberArray, transformToSort, transformToSortQueryParam, transformToString, transformToStringArray, uncacheableRequestHasAllowCacheParam, uncacheableRequestHasCacheKeyParam, unwrapQuerySyncMessage, v2BuildQueryCacheKey, v2ExtractExpiresInSeconds, v2ShouldCacheQuery, v2ShouldRetryRequest, validateWithQuery, validateWithV2Query, withArgs, withArgsQueryFeatureMissingButRouteIsFunction, withAuthenticationQuery, withAutoRefresh, withAutoRefreshUsedInManualQuery, withAutoRefreshUsedOnUnsupportedHttpMethod, withBearerAuthMultiTabSync, withDefaultRetry, withErrorHandling, withEthleteApiErrors, withHtmlErrorParsing, withInactivityLogout, withLogging, withMultiTabSync, withPageResetOnError, withPersistentAuth, withPolling, withPollingUsedOnUnsupportedHttpMethod, withQueryPersistence, withRefreshQuery, withResponseUpdate, withSuccessHandling, withSymfonyErrors, withTokenExpirationWarning, withTokenRevocation, withTracking, wrapAsObservableSignal, wrapQuerySyncMessage };
-export type { AnyBearerAuthProvider, AnyCreateBearerAuthProviderResult, AnyCreateGqlQueryCreatorOptions, AnyCreateQueryClientResult, AnyGqlQueryConfig, AnyInfinityQuery, AnyInfinityQueryConfig, AnyLegacyQuery, AnyLegacyQueryCreator, AnyNewQuery, AnyPagedQueryStack, AnyQueryBuilder, AnyQueryClient, AnyQueryCollection, AnyQueryCollectionData, AnyQueryCollectionResponse, AnyQueryCreator, AnyQueryCreatorCollection, AnyQueryForm, AnyQuerySnapshot, AnyQueryStack, AnyRestQueryConfig, AnyRoute, AnyV2Query, AnyV2QueryCreator, AnyWebSocketClient, AppendItemsLocation, ApplyExternalResponseOptions, ApplyPersistedResponseOptions, AuthProvider, AuthProviderBasicConfig, AuthProviderBearerConfig, AuthProviderCustomHeaderConfig, AuthQueryBuilder, AuthQueryConfig, BaseArguments, BaseQueryCreatorFactoryOptions, BaseQueryCreatorOptions, BaseQueryCreatorOptionsSubtle, BearerAuthExecutionState, BearerAuthExecutionStateError, BearerAuthExecutionStateLoading, BearerAuthExecutionStateLogout, BearerAuthExecutionStateSuccess, BearerAuthFeature, BearerAuthMultiTabSyncConfig, BearerAuthMultiTabSyncFeature, BearerAuthProvider, BearerAuthProviderEarlySetup, BearerAuthProviderEarlySetupContext, BearerAuthProviderEarlySetupResult, BearerAuthProviderFeatureContext, BearerAuthProviderOf, BearerAuthProviderQueryContext, BearerAuthProviderRef, BearerAuthProviderTokens, BearerRefreshConfig, BodyType, BuildQueryStringConfig, CacheAdapterFn, Cancelled, ClassValidatorError, ClearQueryArgs, ConstructQuery, CreateBaseQueryOptions, CreateBearerAuthProviderConfig, CreateGqlQueryCreatorOptions, CreateGqlQueryExecuteOptions, CreateGqlQueryOptions, CreateHttpRequestDependencies, CreateHttpRequestOptions, CreateIndexedDbQueryPersistenceAdapterOptions, CreateLegacyQueryCreatorOptions, CreateLegacyQueryOptions, CreatePagedQueryStackOptions, CreateQueryClientConfigOptions, CreateQueryCreatorOptions, CreateQueryExecuteOptions, CreateQueryFormConfig, CreateQueryObjectOptions, CreateQueryOptions, CreateQueryPersistenceEngineOptions, CreateQueryRepositoryConfig, CreateQuerySnapshotOptions, CreateQueryStackOptions, CreateQuerySyncEngineOptions, CreateSecureGqlQueryExecuteOptions, CreateSecureGqlQueryOptions, CreateSecureQueryExecuteOptions, CreateSecureQueryOptions, CreateWebSocketClientConfigOptions, CreateWebSocketClientTransport, DescribableFeature, DestroyCleanupCallback, EmptyObject, EntityGetParams, EntityIdParams, EntityKey, EntitySetParams, EntityStoreConfig, ExecuteFactory, ExecuteQueryOptions, ExtractQueryArgs, ExtractQueryKey, Failure, FeatureRegistry, GQL, GqlQueryArgs, GqlQueryConfig, GqlQueryConfigWithoutMethod, GqlQueryMethod, GqlQueryTransport, GqlTransferOption, GqlTransformer, GqlVariablesType, HttpErrorEvent, HttpRequest, HttpRequestLoadingProgressState, HttpRequestLoadingState, HttpRequestResponseType, HttpRequestRetryState, HttpRequestSubtle, HttpRequestTransferCacheConfig, InactivityLogoutConfig, InactivityLogoutFeature, InfinityQueryConfig, InfinityQueryConfigType, InfinityQueryOf, InfinityQueryParamLocation, InsertFromConfig, InternalCreateGqlQueryCreatorOptions, InternalCreateQueryCreatorOptions, InternalQueryExecute, InternalSecureCreateGqlQueryCreatorOptions, InternalSecureCreateQueryCreatorOptions, InternalWebSocketRoom, LeaderInstanceCountChangeEventData, LeaderStatusChangeEventData, LegacyArgumentsOfQueryArgs, LegacyQueryPrepareFn, Loading, MapViolationsToFormErrorsOptions, Method, ObservableSignal, OptionalQueryFieldOptions, PageParamCalculatorOptions, PagedQueryStack, PagedQueryStackDirection, PagedQueryStackExecuteOptions, PagedQueryStackResetOptions, PartialXhrState, PathParams, PathParamsType, PersistedQueryBody, PersistedQueryEntry, PersistedQueryEntryMeta, PersistentAuthConfig, PersistentAuthFeature, PollConfig, Prepared, Query, QueryArgs, QueryArgsOf, QueryArgsOfLegacyArguments, QueryAutoRefreshConfig, QueryBase, QueryClient, QueryClientDevtoolsOptions, QueryClientErrorPipelineFeature, QueryClientFeature, QueryClientFeatureContext, QueryClientFeatureFn, QueryClientMultiTabSyncFeature, QueryClientPersistenceFeature, QueryClientRef, QueryClientSubtle, QueryCollectionKeysOf, QueryCollectionOf, QueryCollectionWithNullableQuery, QueryConfig, QueryConfigBase, QueryConfigWithoutMethod, QueryContainerConfig, QueryContext, QueryCreator, QueryDataOf, QueryDependencies, QueryDevtoolsAuthQuery, QueryDevtoolsEntry, QueryDevtoolsEntryKind, QueryDevtoolsEntryMeta, QueryDevtoolsFault, QueryDevtoolsFaultTarget, QueryDevtoolsFeature, QueryDevtoolsFeatureDescriber, QueryDevtoolsFeatureDetail, QueryDevtoolsFormField, QueryDevtoolsFormHandle, QueryDevtoolsFormLinksHandle, QueryDevtoolsFormLinksRecorder, QueryDevtoolsPayload, QueryDevtoolsRegistrar, QueryDevtoolsRegistration, QueryDevtoolsResolvedFault, QueryDevtoolsRoutePart, QueryDevtoolsRun, QueryDevtoolsRunStatus, QueryDevtoolsStats, QueryDevtoolsStatsHandle, QueryDevtoolsStatsRecorder, QueryDirectiveContext, QueryDirectiveType, QueryEntityConfig, QueryErrorParser, QueryErrorResponse, QueryErrorResponseItem, QueryErrorResponseList, QueryErrorResponseSingle, QueryExecute, QueryExecuteArgs, QueryExecuteEventData, QueryExecuteOptions, QueryExecuteState, QueryExecutionState, QueryExecutionStateFailure, QueryExecutionStateLoading, QueryExecutionStateLoadingWithCachedResponse, QueryExecutionStateLoadingWithNoResponse, QueryExecutionStateSuccess, QueryFailureEventData, QueryFeature, QueryFeatureContext, QueryFeatureFlags, QueryFeatureFn, QueryFieldConfig, QueryFieldDef, QueryFieldOptions, QueryFieldValue, QueryFilterConfig, QueryFormBranch, QueryFormChange, QueryFormFields, QueryFormGroup, QueryFormGroupControls, QueryFormModel, QueryFormObserveOptions, QueryFormOf, QueryFormOptions, QueryFormSignalsObserveOptions, QueryFormSignalsWriteOptions, QueryFormValue, QueryFormValueEvent, QueryFormWriteOptions, QueryInvalidationCandidate, QueryInvalidationFilterFn, QueryInvalidationOptions, QueryKey, QueryKeyLockHold, QueryKeyLockManager, QueryKeyLockState, QueryMethod, QueryMockConfig, QueryMultiTabSyncConfig, QueryOf, QueryParams, QueryParamsType, QueryPersistenceAdapter, QueryPersistenceCandidate, QueryPersistenceConfig, QueryPersistenceEngine, QueryPrepareFn, QueryRefreshCause, QueryRegistry, QueryRegistryEntry, QueryRepository, QueryRepositoryCacheEntry, QueryRepositoryDependencies, QueryRepositoryEvent, QueryRepositoryItem, QueryRepositoryRefreshFilterFn, QueryRepositoryRequestOptions, QueryRepositorySubtle, QueryResponseOf, QueryRouteOf, QuerySequence, QuerySequenceResult, QuerySequenceStatus, QuerySequenceStepArgs, QuerySnapshot, QueryStack, QueryStackSubtle, QueryState, QueryStateMeta, QueryStateResponseOf, QueryStateSignal, QueryStateSubtle, QueryStateSuccessMeta, QueryStoreIdOf, QueryStoreOf, QuerySubtle, QuerySuccessEventData, QuerySyncEngine, QuerySyncEnvelope, QuerySyncInvalidateMessage, QuerySyncMessage, QuerySyncMessageListener, QuerySyncMutation, QuerySyncMutationFilterFn, QuerySyncMutationMessage, QuerySyncRefreshCandidate, QuerySyncRefreshOnMutationConfig, QuerySyncResponseMessage, QuerySyncTransport, QueryTrigger, RawResponseType, ReadonlyQuery, RemoveFromConfig, RequestArgs, RequestConfig, RequestError, RequestEvent, RequestHeaders, RequestHeadersMethodMap, RequestHttpEvent, RequestProgress, RequestRetryFn, RequestRetryFnConfig, RequestRetryFnResult, RequiresTransform, ResetExecuteStateOptions, ResetPageOnErrorOperatorConfig, ResponseType, RestQueryConfig, RouteString, RouteType, RunQueryCreator, RunQueryExecuteOptions, SecureExecuteFactoryOptions, ServerValidationError, ServerViolationValidationError, SetupQueryDependenciesOptions, SetupQueryStateOptions, ShouldRetryRequestFn, ShouldRetryRequestOptions, ShouldRetryRequestResult, SocketMessageView, Sort, SortDirection, Success, SymfonyError, SymfonyErrorTrace, TokenExpirationWarningConfig, TokenExpirationWarningFeature, TokenRefreshEventData, TokenRefreshQueryBuilder, TokenRefreshQueryConfig, TokenResponse, TokenRevocationConfig, TokenRevocationFeature, TotalPagesExtractorOptions, TrackingConfig, TrackingEventDataMap, TrackingEventHandler, TrackingEventName, TrackingFeature, TransformedGqlQuery, V2CacheAdapterFn, V2PrepareArgsOf, V2QueryArgsOf, V2QueryClientConfig, V2QueryConfig, V2QueryState, V2RouteString, V2RouteType, ValidateWithQueryConfig, ValidateWithV2QueryConfig, WebSocketClient, WebSocketClientResult, WebSocketClientSubtle, WebSocketDevtoolsHandle, WebSocketDevtoolsMessage, WebSocketRoom, WithAutoRefreshFeatureOptions, WithBody, WithConfig, WithErrorHandlingFeatureOptions, WithHeaders, WithInjector, WithLegacyConfig, WithLoggingFeatureOptions, WithMock, WithPageResetOnErrorFeatureOptions, WithPathParams, WithPollingFeatureOptions, WithQueryParams, WithResponseUpdateFeatureFnData, WithResponseUpdateFeatureOptions, WithSuccessHandlingFeatureOptions, WithVariables };
+export { AuthBearerRefreshStrategy, BasicAuthProvider, BearerAuthFeatureType, BooleanArrayQueryField, CLEAR_QUERY_ARGS, CustomHeaderAuthProvider, DEFAULT_KEEP_UNUSED_FOR, DEFAULT_QUERY_PERSISTENCE_MAX_AGE, DEFAULT_QUERY_PERSISTENCE_MAX_ENTRIES, DEFAULT_QUERY_PERSISTENCE_VERSION, DEFAULT_QUERY_PERSISTENCE_WRITE_DELAY, DateArrayQueryField, DateQueryField, EMPTY_QUERY_DEVTOOLS_FAULT, EntityStore, IGNORED_FILTER_COUNT_FIELDS, INFINITY_QUERY_TOKEN, InfinityQuery, InfinityQueryDirective, InfinityQueryTriggerDirective, LegacyQuery, LegacyQueryCreator, MAX_UNUSED_ENTRIES, NumberArrayQueryField, ParseHttpErrorCodeToMessageDePipe, ParseHttpErrorCodeToMessageEnPipe, ParseHttpErrorCodeToTitleDePipe, ParseHttpErrorCodeToTitleEnPipe, QUERY_CLIENT_DEVTOOLS_TOKEN, QUERY_DEVTOOLS_FAULT_STATUSES, QUERY_PERSISTENCE_STORE_VERSION, QUERY_SYNC_PROTOCOL_VERSION, QueryClientFeatureType, QueryDevtoolsComponent, QueryDirective, QueryFeatureType, QueryField, QueryForm, QueryFormSignals, QueryRuntimeErrorCode, QueryShortNamePipe, QueryStateType, QueryStore, SERVER_ERROR_KIND, SERVER_VIOLATION_ERROR_KIND, SPEED_BUFFER_TIME_IN_MS, SearchQueryField, SortQueryField, StringArrayQueryField, V2BearerAuthProvider, V2Query, V2QueryClient, V2QueryCreator, addQueryContainerHandling, applyQueryDevtoolsOverrides, applyQueryFeatures, authExtractTokensResponseMissingAccessToken, authExtractTokensResponseMissingRefreshToken, authExtractTokensResponseNotObject, authProviderFeatureUsedMultipleTimes, booleanArrayQueryField, buildQueryCacheKey, buildQueryString, buildRoute, buildTimestampFromSeconds, castQueryCreatorTypes, circularQueryDependency, circularQueryDependencyChecker, clearQueryDevtoolsFaults, collectLeafPaths, computeQueryAuthHeader, computeQueryBody, computeQueryHeaders, computeQueryMethod, computeQueryQueryParams, contentfulGqlLikePaginationAdapter, createBaseQuery, createBaseQueryCreator, createBearerAuthProvider, createDeleteQuery, createExecuteFn, createGetQuery, createGqlExecuteFn, createGqlMutationViaGet, createGqlMutationViaPost, createGqlQuery, createGqlQueryCreator, createGqlQueryViaGet, createGqlQueryViaPost, createHttpRequest, createIndexedDbQueryPersistenceAdapter, createInfinityQueryConfig, createLegacyQueryCreator, createNoopQueryPersistenceAdapter, createPagedQueryStack, createPatchQuery, createPersistentAuthFeature, createPostQuery, createPutQuery, createQuery, createQueryClient, createQueryCollection, createQueryCollectionSignal, createQueryCollectionSubject, createQueryContext, createQueryCreator, createQueryErrorResponse, createQueryFeature, createQueryForm, createQueryInvalidationFilter, createQueryKeyLockManager, createQueryObject, createQueryPersistenceEngine, createQueryRepository, createQuerySnapshotFn, createQueryStack, createQuerySyncEngine, createQuerySyncTransport, createSecureDeleteQuery, createSecureExecuteFactory, createSecureExecuteFn, createSecureGetQuery, createSecureGqlExecuteFn, createSecureGqlMutationViaGet, createSecureGqlMutationViaPost, createSecureGqlQuery, createSecureGqlQueryCreator, createSecureGqlQueryViaGet, createSecureGqlQueryViaPost, createSecurePatchQuery, createSecurePostQuery, createSecurePutQuery, createSecureQuery, createSecureQueryCreator, createTrackingFeature, createWebSocketClient, dateArrayQueryField, dateQueryField, decryptBearer, deepFreeze, def, detectContentTypeHeader, detectPaginationShape, dynLikePaginationAdapter, effectComputed, emptyQueryArgs, ethletePaginationAdapter, executeUntilSettled, extractExpiresInSeconds, extractFormViolations, extractHtmlErrorMessage, extractQuery, fakePaginationAdapter, filterFailure, filterNull, filterQueryStates, filterSuccess, forEachHeader, getDefaultHeaders, getQueryFeatureUsage, getResponseUrl, ggLikePaginationAdapter, gql, gqlDataPropertyMissingInResponse, hasHeader, htmlErrorPayload, htmlQueryErrorParser, ignoreAutoRefresh, injectInfinityQueryResponseDelay, injectQueryContext, insertFrom, invalidBaseRouteError, invalidBodyError, invalidRouteError, invalidStateInsideSecureExecuteFactory, isAutoRefresh, isBasicAuthProvider, isBearerAuthProvider, isClassValidatorError, isCreateGqlQueryOptions, isCustomHeaderAuthProvider, isDateShapedLeaf, isEmptyString, isGqlQueryConfig, isHtmlErrorPayload, isLegacyQuery, isNaN, isPageOutOfRangeError, isQuery, isQueryCollection, isQueryDevtoolsFaultArmed, isQueryErrorResponse, isQueryStateCancelled, isQueryStateFailure, isQueryStateLoading, isQueryStatePrepared, isQueryStateSuccess, isRequestError, isSymfonyError, isSymfonyFormViolationListError, isSymfonyListError, isSymfonyPagerfantaOutOfRangeError, isUnderInvalidatedUrl, legacyPrepareWithoutInjectionContext, mapToPaginated, mapViolationsToFormErrors, maybeExecute, measureQueryDevtoolsPayload, mergeHeaders, nestedEffect, numberArrayQueryField, pagedQueryStackNextPageCalledWithoutPreviousPage, pagedQueryStackPageBiggerThanTotalPages, pagedQueryStackPreviousPageCalledButAlreadyAtFirstPage, paginatedEntityValueUpdater, parseAllXhrResponseHeaders, parseHttpErrorCodeToMessageDe, parseHttpErrorCodeToMessageEn, parseHttpErrorCodeToTitleDe, parseHttpErrorCodeToTitleEn, pathParamsMissingInRouteFunctionError, provideInfinityQueryResponseDelay, provideLegacyPrepareFallback, provideQueryClientForDevtools, provideQueryDevtools, queryArrayComputed, queryClientFeatureUsedMultipleTimes, queryComputed, queryComputedTillTruthy, queryDevtoolsEntries, queryDevtoolsFaults, queryErrorMessage, queryErrorMessages, queryExecute, queryFeatureUsedMultipleTimes, queryField, querySequence, querySequenceAlreadyRunning, queryStackTotalQueriesAndExpectedQueriesMismatch, queryStackWithArgsUsed, queryStackWithResponseUpdateUsed, queryStateAlreadyHasKeyError, queryStateCannotTransformError, queryStateDoesNotContainKeyError, queryStateErrorSignal, queryStateLoadingSignal, queryStateResponseSignal, queryStateSignal, registerQueryErrorParser, removeFrom, request, resetExecuteState, resetPageOnError, resolveInvalidationUrl, searchQueryField, serializeBody, setDefaultQueryRetryFn, setQueryDevtoolsFault, setupQueryDependencies, setupQueryExecuteState, setupQueryState, shouldAutoExecuteGqlQuery, shouldAutoExecuteQuery, shouldCacheQuery, shouldRetryRequest, silenceMissingWithArgsFeatureErrorUsedButWithArgsPresent, skipPaginationPageParamCalculator, smartDuplicateArrayItem, sortQueryField, splitQueryConfig, stringArrayQueryField, stringifyQueryRouteParts, sumQueryDevtoolsStats, switchQueryCollectionState, switchQueryState, symfonyQueryErrorParser, takeUntilResponse, toQuerySignal, toQuerySubject, tokensNotAvailableInsideAuthAndExec, transformArrayResponse, transformExecStateToQueryState, transformGql, transformMethod, transformPaginatedResponse, transformToBoolean, transformToBooleanArray, transformToDate, transformToDateArray, transformToNumber, transformToNumberArray, transformToSort, transformToSortQueryParam, transformToString, transformToStringArray, uncacheableRequestHasAllowCacheParam, uncacheableRequestHasCacheKeyParam, unwrapQuerySyncMessage, v2BuildQueryCacheKey, v2ExtractExpiresInSeconds, v2ShouldCacheQuery, v2ShouldRetryRequest, validateWithQuery, validateWithV2Query, withArgs, withArgsQueryFeatureMissingButRouteIsFunction, withAuthenticationQuery, withAutoRefresh, withAutoRefreshUsedInManualQuery, withAutoRefreshUsedOnUnsupportedHttpMethod, withBearerAuthMultiTabSync, withDefaultRetry, withErrorHandling, withEthleteApiErrors, withHtmlErrorParsing, withInactivityLogout, withLogging, withMultiTabSync, withPageResetOnError, withPersistentAuth, withPolling, withPollingUsedOnUnsupportedHttpMethod, withQueryPersistence, withRefreshQuery, withResponseUpdate, withSuccessHandling, withSymfonyErrors, withTokenExpirationWarning, withTokenRevocation, withTracking, wrapAsObservableSignal, wrapQuerySyncMessage };
+export type { AnyBearerAuthProvider, AnyCreateBearerAuthProviderResult, AnyCreateGqlQueryCreatorOptions, AnyCreateQueryClientResult, AnyGqlQueryConfig, AnyInfinityQuery, AnyInfinityQueryConfig, AnyLegacyQuery, AnyLegacyQueryCreator, AnyNewQuery, AnyPagedQueryStack, AnyQueryBuilder, AnyQueryClient, AnyQueryCollection, AnyQueryCollectionData, AnyQueryCollectionResponse, AnyQueryCreator, AnyQueryCreatorCollection, AnyQueryForm, AnyQuerySnapshot, AnyQueryStack, AnyRestQueryConfig, AnyRoute, AnyV2Query, AnyV2QueryCreator, AnyWebSocketClient, AppendItemsLocation, ApplyExternalResponseOptions, ApplyPersistedResponseOptions, AuthProvider, AuthProviderBasicConfig, AuthProviderBearerConfig, AuthProviderCustomHeaderConfig, AuthQueryBuilder, AuthQueryConfig, BaseArguments, BaseQueryCreatorFactoryOptions, BaseQueryCreatorOptions, BaseQueryCreatorOptionsSubtle, BearerAuthExecutionState, BearerAuthExecutionStateError, BearerAuthExecutionStateLoading, BearerAuthExecutionStateLogout, BearerAuthExecutionStateSuccess, BearerAuthExecutionStateTokenSeed, BearerAuthFeature, BearerAuthMultiTabSyncConfig, BearerAuthMultiTabSyncFeature, BearerAuthProvider, BearerAuthProviderEarlySetup, BearerAuthProviderEarlySetupContext, BearerAuthProviderEarlySetupResult, BearerAuthProviderFeatureContext, BearerAuthProviderOf, BearerAuthProviderQueryContext, BearerAuthProviderRef, BearerAuthProviderTokens, BearerRefreshConfig, BodyType, BuildQueryStringConfig, CacheAdapterFn, Cancelled, ClassValidatorError, ClearQueryArgs, ConstructQuery, CreateBaseQueryOptions, CreateBearerAuthProviderConfig, CreateGqlQueryCreatorOptions, CreateGqlQueryExecuteOptions, CreateGqlQueryOptions, CreateHttpRequestDependencies, CreateHttpRequestOptions, CreateIndexedDbQueryPersistenceAdapterOptions, CreateLegacyQueryCreatorOptions, CreateLegacyQueryOptions, CreatePagedQueryStackOptions, CreateQueryClientConfigOptions, CreateQueryCreatorOptions, CreateQueryExecuteOptions, CreateQueryFormConfig, CreateQueryObjectOptions, CreateQueryOptions, CreateQueryPersistenceEngineOptions, CreateQueryRepositoryConfig, CreateQuerySnapshotOptions, CreateQueryStackOptions, CreateQuerySyncEngineOptions, CreateSecureGqlQueryExecuteOptions, CreateSecureGqlQueryOptions, CreateSecureQueryExecuteOptions, CreateSecureQueryOptions, CreateWebSocketClientConfigOptions, CreateWebSocketClientTransport, DescribableFeature, DestroyCleanupCallback, EmptyObject, EntityGetParams, EntityIdParams, EntityKey, EntitySetParams, EntityStoreConfig, ExecuteFactory, ExecuteQueryOptions, ExtractQueryArgs, ExtractQueryKey, Failure, FeatureRegistry, GQL, GqlQueryArgs, GqlQueryConfig, GqlQueryConfigWithoutMethod, GqlQueryMethod, GqlQueryTransport, GqlTransferOption, GqlTransformer, GqlVariablesType, HttpErrorEvent, HttpRequest, HttpRequestLoadingProgressState, HttpRequestLoadingState, HttpRequestResponseType, HttpRequestRetryState, HttpRequestSubtle, HttpRequestTransferCacheConfig, InactivityLogoutConfig, InactivityLogoutFeature, InfinityQueryConfig, InfinityQueryConfigType, InfinityQueryOf, InfinityQueryParamLocation, InsertFromConfig, InternalCreateGqlQueryCreatorOptions, InternalCreateQueryCreatorOptions, InternalQueryExecute, InternalSecureCreateGqlQueryCreatorOptions, InternalSecureCreateQueryCreatorOptions, InternalWebSocketRoom, JsonPath, LeaderInstanceCountChangeEventData, LeaderStatusChangeEventData, LegacyArgumentsOfQueryArgs, LegacyQueryPrepareFn, Loading, MapViolationsToFormErrorsOptions, Method, ObservableSignal, OptionalQueryFieldOptions, OverrideOp, PageParamCalculatorOptions, PagedQueryStack, PagedQueryStackDirection, PagedQueryStackExecuteOptions, PagedQueryStackResetOptions, PartialXhrState, PathParams, PathParamsType, PersistedQueryBody, PersistedQueryEntry, PersistedQueryEntryMeta, PersistentAuthConfig, PersistentAuthFeature, PollConfig, Prepared, Query, QueryArgs, QueryArgsOf, QueryArgsOfLegacyArguments, QueryAutoRefreshConfig, QueryBase, QueryClient, QueryClientDevtoolsOptions, QueryClientErrorPipelineFeature, QueryClientFeature, QueryClientFeatureContext, QueryClientFeatureFn, QueryClientMultiTabSyncFeature, QueryClientPersistenceFeature, QueryClientRef, QueryClientSubtle, QueryCollectionKeysOf, QueryCollectionOf, QueryCollectionWithNullableQuery, QueryConfig, QueryConfigBase, QueryConfigWithoutMethod, QueryContainerConfig, QueryContext, QueryCreator, QueryDataOf, QueryDependencies, QueryDevtoolsAuthQuery, QueryDevtoolsEntry, QueryDevtoolsEntryKind, QueryDevtoolsEntryMeta, QueryDevtoolsFault, QueryDevtoolsFaultTarget, QueryDevtoolsFeature, QueryDevtoolsFeatureDescriber, QueryDevtoolsFeatureDetail, QueryDevtoolsFormField, QueryDevtoolsFormHandle, QueryDevtoolsFormLinksHandle, QueryDevtoolsFormLinksRecorder, QueryDevtoolsOverrideEntry, QueryDevtoolsOverridesHandle, QueryDevtoolsOverridesRecorder, QueryDevtoolsPayload, QueryDevtoolsRegistrar, QueryDevtoolsRegistration, QueryDevtoolsResolvedFault, QueryDevtoolsRoutePart, QueryDevtoolsRun, QueryDevtoolsRunStatus, QueryDevtoolsStats, QueryDevtoolsStatsHandle, QueryDevtoolsStatsRecorder, QueryDirectiveContext, QueryDirectiveType, QueryEntityConfig, QueryErrorParser, QueryErrorResponse, QueryErrorResponseItem, QueryErrorResponseList, QueryErrorResponseSingle, QueryExecute, QueryExecuteArgs, QueryExecuteEventData, QueryExecuteOptions, QueryExecuteState, QueryExecutionState, QueryExecutionStateFailure, QueryExecutionStateLoading, QueryExecutionStateLoadingWithCachedResponse, QueryExecutionStateLoadingWithNoResponse, QueryExecutionStateSuccess, QueryFailureEventData, QueryFeature, QueryFeatureContext, QueryFeatureFlags, QueryFeatureFn, QueryFieldConfig, QueryFieldDef, QueryFieldOptions, QueryFieldValue, QueryFilterConfig, QueryFormBranch, QueryFormChange, QueryFormFields, QueryFormGroup, QueryFormGroupControls, QueryFormModel, QueryFormObserveOptions, QueryFormOf, QueryFormOptions, QueryFormSignalsObserveOptions, QueryFormSignalsWriteOptions, QueryFormValue, QueryFormValueEvent, QueryFormWriteOptions, QueryInvalidationCandidate, QueryInvalidationFilterFn, QueryInvalidationOptions, QueryKey, QueryKeyLockHold, QueryKeyLockManager, QueryKeyLockState, QueryMethod, QueryMockConfig, QueryMultiTabSyncConfig, QueryOf, QueryParams, QueryParamsType, QueryPersistenceAdapter, QueryPersistenceCandidate, QueryPersistenceConfig, QueryPersistenceEngine, QueryPrepareFn, QueryRefreshCause, QueryRegistry, QueryRegistryEntry, QueryRepository, QueryRepositoryCacheEntry, QueryRepositoryDependencies, QueryRepositoryEvent, QueryRepositoryItem, QueryRepositoryRefreshFilterFn, QueryRepositoryRequestOptions, QueryRepositorySubtle, QueryResponseOf, QueryRouteOf, QuerySequence, QuerySequenceResult, QuerySequenceStatus, QuerySequenceStepArgs, QuerySnapshot, QueryStack, QueryStackSubtle, QueryState, QueryStateMeta, QueryStateResponseOf, QueryStateSignal, QueryStateSubtle, QueryStateSuccessMeta, QueryStoreIdOf, QueryStoreOf, QuerySubtle, QuerySuccessEventData, QuerySyncEngine, QuerySyncEnvelope, QuerySyncInvalidateMessage, QuerySyncMessage, QuerySyncMessageListener, QuerySyncMutation, QuerySyncMutationFilterFn, QuerySyncMutationMessage, QuerySyncRefreshCandidate, QuerySyncRefreshOnMutationConfig, QuerySyncResponseMessage, QuerySyncTransport, QueryTrigger, RawResponseType, ReadonlyQuery, RemoveFromConfig, RequestArgs, RequestConfig, RequestError, RequestEvent, RequestHeaders, RequestHeadersMethodMap, RequestHttpEvent, RequestProgress, RequestRetryFn, RequestRetryFnConfig, RequestRetryFnResult, RequiresTransform, ResetExecuteStateOptions, ResetPageOnErrorOperatorConfig, ResponseType, RestQueryConfig, RouteString, RouteType, RunQueryCreator, RunQueryExecuteOptions, SecureExecuteFactoryOptions, ServerValidationError, ServerViolationValidationError, SetupQueryDependenciesOptions, SetupQueryStateOptions, ShouldRetryRequestFn, ShouldRetryRequestOptions, ShouldRetryRequestResult, SocketMessageView, Sort, SortDirection, Success, SymfonyError, SymfonyErrorTrace, TokenExpirationWarningConfig, TokenExpirationWarningFeature, TokenRefreshEventData, TokenRefreshQueryBuilder, TokenRefreshQueryConfig, TokenResponse, TokenRevocationConfig, TokenRevocationFeature, TotalPagesExtractorOptions, TrackingConfig, TrackingEventDataMap, TrackingEventHandler, TrackingEventName, TrackingFeature, TransformedGqlQuery, V2CacheAdapterFn, V2PrepareArgsOf, V2QueryArgsOf, V2QueryClientConfig, V2QueryConfig, V2QueryState, V2RouteString, V2RouteType, ValidateWithQueryConfig, ValidateWithV2QueryConfig, WebSocketClient, WebSocketClientIo, WebSocketClientIoOptions, WebSocketClientResult, WebSocketClientSocket, WebSocketClientSubtle, WebSocketDevtoolsHandle, WebSocketDevtoolsMessage, WebSocketRoom, WithAutoRefreshFeatureOptions, WithBody, WithConfig, WithErrorHandlingFeatureOptions, WithHeaders, WithInjector, WithLegacyConfig, WithLoggingFeatureOptions, WithMock, WithPageResetOnErrorFeatureOptions, WithPathParams, WithPollingFeatureOptions, WithQueryParams, WithResponseUpdateFeatureFnData, WithResponseUpdateFeatureOptions, WithSuccessHandlingFeatureOptions, WithVariables };