@ethlete/query 6.0.0-next.54 → 6.0.0-next.56

package/generators/report-legacy-query-apis/schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "report-legacy-query-apis",
+  "title": "Report legacy query collections, infinity queries, *etQuery templates and entity stores",
+  "type": "object",
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Nx projects to scan. Defaults to every project in the workspace.",
+      "alias": "project"
+    },
+    "include": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Path prefixes to scan, relative to the workspace root (e.g. 'libs/queries'). Unioned with `projects`. Defaults to the whole workspace.",
+      "alias": "includePath"
+    }
+  },
+  "required": []
+}

package/migrations.json

@@ -4,6 +4,7 @@
       "name": "to-query-v3",
       "version": "5.42.0",
       "kind": "auto",
+      "level": "optional",
       "description": "Move the legacy query system onto the new one through the interop layer.",
       "generator": "@ethlete/query:migrate-to-query-v3",
       "docs": "/query/migrating-from-v2"
@@ -12,6 +13,7 @@
       "name": "prep-for-query-v3",
       "version": "6.0.0-beta.8",
       "kind": "auto",
+      "level": "required",
       "description": "Prepare the call sites the v3 query system changes, before the move itself.",
       "generator": "@ethlete/query:prep-for-query-v3",
       "docs": "/query/migrating-from-v2"
@@ -20,6 +22,7 @@
       "name": "query-client-features",
       "version": "6.0.0-next.23",
       "kind": "auto",
+      "level": "required",
       "description": "Move the createQueryClient multiTabSync and persistence options onto opt-in features.",
       "generator": "@ethlete/query:migrate-query-client-features",
       "docs": "/query/features"
@@ -28,6 +31,7 @@
       "name": "query-opt-in-features",
       "version": "6.0.0-next.23",
       "kind": "auto",
+      "level": "required",
       "description": "Move query clients onto the opt-in error pipeline, and bearer auth onto the opt-in multi-tab sync feature.",
       "generator": "@ethlete/query:migrate-query-opt-in-features",
       "docs": "/query/features"
@@ -36,6 +40,7 @@
       "name": "deprecate-legacy-queries",
       "version": "6.0.0-next.24",
       "kind": "auto",
+      "level": "recommended",
       "description": "Mark the remaining createLegacyQueryCreator wrappers as deprecated, so their call sites surface as still on v2.",
       "generator": "@ethlete/query:deprecate-legacy-queries",
       "docs": "/query/legacy"
@@ -44,6 +49,7 @@
       "name": "search-query-field-string",
       "version": "6.0.0-next.52",
       "kind": "assisted",
+      "level": "required",
       "description": "searchQueryField() is typed string and starts at '' instead of null; writes and checks of null move to ''.",
       "instructions": "./migrations/search-query-field-string.md",
       "docs": "/query/query-forms"
@@ -52,9 +58,29 @@
       "name": "query-field-default-types",
       "version": "6.0.0-next.52",
       "kind": "assisted",
+      "level": "required",
       "description": "queryField() is typed by its default and reads the URL into that type; fields without a default or with a non-primitive one need a queryParamToValue.",
       "instructions": "./migrations/query-field-default-types.md",
       "docs": "/query/query-forms"
+    },
+    {
+      "name": "report-legacy-query-apis",
+      "version": "6.0.0-next.55",
+      "kind": "auto",
+      "level": "optional",
+      "description": "List every query collection, infinity query, *etQuery template and entity store that still needs a hand edit in query-v3-migration-tasks.md.",
+      "generator": "@ethlete/query:report-legacy-query-apis",
+      "scan": "@ethlete/query:report-legacy-query-apis",
+      "docs": "/query/migrating-from-v2"
+    },
+    {
+      "name": "devtools-contract-entry-point",
+      "version": "6.0.0-next.55",
+      "kind": "auto",
+      "level": "required",
+      "description": "Import the devtools contract (the names @ethlete/query-devtools reads) from @ethlete/query/devtools-contract instead of @ethlete/query.",
+      "generator": "@ethlete/query:move-devtools-contract-imports",
+      "docs": "/query-devtools/#the-devtools-contract"
     }
   ]
 }

package/package.json

@@ -1,33 +1,25 @@
 {
   "name": "@ethlete/query",
-  "version": "6.0.0-next.54",
+  "version": "6.0.0-next.56",
   "license": "MIT",
   "sideEffects": false,
   "peerDependencies": {
-    "@analogjs/vite-plugin-angular": "2.6.3",
-    "@angular/common": "22.1.6",
-    "@angular/core": "22.1.6",
-    "@angular/forms": "22.1.6",
-    "@angular/router": "22.1.6",
+    "@angular/common": "^22.1.0",
+    "@angular/core": "^22.1.0",
+    "@angular/forms": "^22.1.0",
+    "@angular/router": "^22.1.0",
     "@ethlete/core": "^5.0.0-beta.11",
     "@ethlete/types": "^2.0.0-beta.4",
-    "@nx/devkit": "23.1.0",
-    "rxjs": "7.8.2",
-    "typescript": "6.0.3",
-    "vite": "8.1.5"
+    "@nx/devkit": "^23.0.0",
+    "rxjs": "^7.8.0",
+    "typescript": "^6.0.0"
   },
   "peerDependenciesMeta": {
-    "@analogjs/vite-plugin-angular": {
-      "optional": true
-    },
     "@nx/devkit": {
       "optional": true
     },
     "typescript": {
       "optional": true
-    },
-    "vite": {
-      "optional": true
     }
   },
   "ethlete": {
@@ -44,6 +36,10 @@
       "types": "./types/ethlete-query.d.ts",
       "default": "./fesm2022/ethlete-query.mjs"
     },
+    "./devtools-contract": {
+      "types": "./types/ethlete-query-devtools-contract.d.ts",
+      "default": "./fesm2022/ethlete-query-devtools-contract.mjs"
+    },
     "./ngrx-toolkit": {
       "types": "./types/ethlete-query-ngrx-toolkit.d.ts",
       "default": "./fesm2022/ethlete-query-ngrx-toolkit.mjs"

package/types/ethlete-query-devtools-contract.d.ts

@@ -0,0 +1 @@
+export { ɵDescribableFeature as DescribableFeature, ɵEMPTY_QUERY_DEVTOOLS_FAULT as EMPTY_QUERY_DEVTOOLS_FAULT, ɵJsonPath as JsonPath, ɵMAX_QUERY_BATCH_TOMBSTONES as MAX_QUERY_BATCH_TOMBSTONES, ɵMAX_QUERY_BATCH_TOMBSTONE_BUCKETS as MAX_QUERY_BATCH_TOMBSTONE_BUCKETS, ɵMAX_QUERY_DEVTOOLS_TOMBSTONES as MAX_QUERY_DEVTOOLS_TOMBSTONES, ɵOverrideOp as OverrideOp, ɵQUERY_DEVTOOLS_FAULT_STATUSES as QUERY_DEVTOOLS_FAULT_STATUSES, ɵQUERY_DEVTOOLS_TOKEN_TTL_LIMIT as QUERY_DEVTOOLS_TOKEN_TTL_LIMIT, ɵQueryDevtoolsAbout as QueryDevtoolsAbout, ɵQueryDevtoolsAuthAccountView as QueryDevtoolsAuthAccountView, ɵQueryDevtoolsAuthLocalAccount as QueryDevtoolsAuthLocalAccount, ɵQueryDevtoolsAuthProviderHandle as QueryDevtoolsAuthProviderHandle, ɵQueryDevtoolsAuthProviderRegistration as QueryDevtoolsAuthProviderRegistration, ɵQueryDevtoolsAuthQuery as QueryDevtoolsAuthQuery, ɵQueryDevtoolsAuthSeed as QueryDevtoolsAuthSeed, ɵQueryDevtoolsAuthSession as QueryDevtoolsAuthSession, ɵQueryDevtoolsEntry as QueryDevtoolsEntry, ɵQueryDevtoolsEntryKind as QueryDevtoolsEntryKind, ɵQueryDevtoolsEntryMeta as QueryDevtoolsEntryMeta, ɵQueryDevtoolsFault as QueryDevtoolsFault, ɵQueryDevtoolsFaultTarget as QueryDevtoolsFaultTarget, ɵQueryDevtoolsFeature as QueryDevtoolsFeature, ɵQueryDevtoolsFormField as QueryDevtoolsFormField, ɵQueryDevtoolsFormHandle as QueryDevtoolsFormHandle, ɵQueryDevtoolsFormLinksHandle as QueryDevtoolsFormLinksHandle, ɵQueryDevtoolsFormLinksRecorder as QueryDevtoolsFormLinksRecorder, ɵQueryDevtoolsMock as QueryDevtoolsMock, ɵQueryDevtoolsMockTarget as QueryDevtoolsMockTarget, ɵQueryDevtoolsOverrideEntry as QueryDevtoolsOverrideEntry, ɵQueryDevtoolsOverrideTransfer as QueryDevtoolsOverrideTransfer, ɵQueryDevtoolsOverrideTransferParse as QueryDevtoolsOverrideTransferParse, ɵQueryDevtoolsOverridesHandle as QueryDevtoolsOverridesHandle, ɵQueryDevtoolsOverridesRecorder as QueryDevtoolsOverridesRecorder, ɵQueryDevtoolsPayload as QueryDevtoolsPayload, ɵQueryDevtoolsRegistrar as QueryDevtoolsRegistrar, ɵQueryDevtoolsRegistration as QueryDevtoolsRegistration, ɵQueryDevtoolsResolvedFault as QueryDevtoolsResolvedFault, ɵQueryDevtoolsResolvedMock as QueryDevtoolsResolvedMock, ɵQueryDevtoolsRoutePart as QueryDevtoolsRoutePart, ɵQueryDevtoolsRun as QueryDevtoolsRun, ɵQueryDevtoolsRunError as QueryDevtoolsRunError, ɵQueryDevtoolsRunStatus as QueryDevtoolsRunStatus, ɵQueryDevtoolsSchemaComponents as QueryDevtoolsSchemaComponents, ɵQueryDevtoolsSchemaRoute as QueryDevtoolsSchemaRoute, ɵQueryDevtoolsSchemaSeed as QueryDevtoolsSchemaSeed, ɵQueryDevtoolsSchemaState as QueryDevtoolsSchemaState, ɵQueryDevtoolsSeedStyle as QueryDevtoolsSeedStyle, ɵQueryDevtoolsSettings as QueryDevtoolsSettings, ɵQueryDevtoolsStats as QueryDevtoolsStats, ɵQueryDevtoolsStatsHandle as QueryDevtoolsStatsHandle, ɵQueryDevtoolsStatsRecorder as QueryDevtoolsStatsRecorder, ɵQueryDevtoolsStorageScope as QueryDevtoolsStorageScope, ɵRestoredQueryDevtoolsOverrides as RestoredQueryDevtoolsOverrides, ɵaddQueryDevtoolsAuthAccount as addQueryDevtoolsAuthAccount, ɵapplyQueryDevtoolsOverrides as applyQueryDevtoolsOverrides, ɵapplyQueryDevtoolsTokenTtl as applyQueryDevtoolsTokenTtl, ɵarmAllQueryDevtoolsMocks as armAllQueryDevtoolsMocks, ɵarmQueryDevtoolsMock as armQueryDevtoolsMock, ɵarmQueryDevtoolsOverrideTransfer as armQueryDevtoolsOverrideTransfer, ɵcanOverrideQueryDevtoolsTokenTtl as canOverrideQueryDevtoolsTokenTtl, ɵclearQueryDevtoolsArmedMocks as clearQueryDevtoolsArmedMocks, ɵclearQueryDevtoolsAuthCredentials as clearQueryDevtoolsAuthCredentials, ɵclearQueryDevtoolsAuthSessions as clearQueryDevtoolsAuthSessions, ɵclearQueryDevtoolsFaults as clearQueryDevtoolsFaults, ɵclearQueryDevtoolsMockStore as clearQueryDevtoolsMockStore, ɵclearQueryDevtoolsOverrideStore as clearQueryDevtoolsOverrideStore, ɵclearQueryDevtoolsStore as clearQueryDevtoolsStore, ɵclearQueryDevtoolsTombstones as clearQueryDevtoolsTombstones, ɵclearRestoredQueryDevtoolsOverrides as clearRestoredQueryDevtoolsOverrides, ɵcollectLeafPaths as collectLeafPaths, ɵcollectQueryDevtoolsSchemaComponents as collectQueryDevtoolsSchemaComponents, ɵcountUnresolvedQueryDevtoolsOverrides as countUnresolvedQueryDevtoolsOverrides, ɵcreateQueryDevtoolsOverrides as createQueryDevtoolsOverrides, ɵdeleteQueryDevtoolsMock as deleteQueryDevtoolsMock, ɵdetectPaginationShape as detectPaginationShape, ɵforgetQueryDevtoolsAuthSession as forgetQueryDevtoolsAuthSession, ɵforgetQueryDevtoolsAuthSessionsFor as forgetQueryDevtoolsAuthSessionsFor, ɵgenerateQueryDevtoolsNumberPreset as generateQueryDevtoolsNumberPreset, ɵgenerateQueryDevtoolsSampleNumber as generateQueryDevtoolsSampleNumber, ɵgenerateQueryDevtoolsStringPreset as generateQueryDevtoolsStringPreset, ɵhasQueryDevtoolsOverridesAtPath as hasQueryDevtoolsOverridesAtPath, ɵisDateShapedLeaf as isDateShapedLeaf, ɵisQueryDevtoolsEnabled as isQueryDevtoolsEnabled, ɵisQueryDevtoolsFaultArmed as isQueryDevtoolsFaultArmed, ɵisQueryDevtoolsRepositoryLive as isQueryDevtoolsRepositoryLive, ɵloadQueryDevtoolsSchema as loadQueryDevtoolsSchema, ɵloginQueryDevtoolsAuthAccount as loginQueryDevtoolsAuthAccount, ɵlogoutQueryDevtoolsAuthSession as logoutQueryDevtoolsAuthSession, ɵmatchesQueryDevtoolsMockPattern as matchesQueryDevtoolsMockPattern, ɵmatchesQueryDevtoolsMockQuery as matchesQueryDevtoolsMockQuery, ɵmeasureQueryDevtoolsPayload as measureQueryDevtoolsPayload, ɵparseQueryDevtoolsOverrideTransfer as parseQueryDevtoolsOverrideTransfer, ɵqueryDevtoolsAbout as queryDevtoolsAbout, ɵqueryDevtoolsAllowsLocalAuthSessions as queryDevtoolsAllowsLocalAuthSessions, ɵqueryDevtoolsApiEnvIds as queryDevtoolsApiEnvIds, ɵqueryDevtoolsApiEnvIsProduction as queryDevtoolsApiEnvIsProduction, ɵqueryDevtoolsApiEnvScope as queryDevtoolsApiEnvScope, ɵqueryDevtoolsApiEnvValues as queryDevtoolsApiEnvValues, ɵqueryDevtoolsApiEnvs as queryDevtoolsApiEnvs, ɵqueryDevtoolsArmedMocks as queryDevtoolsArmedMocks, ɵqueryDevtoolsArmedMocksRestored as queryDevtoolsArmedMocksRestored, ɵqueryDevtoolsAuthAccountsFor as queryDevtoolsAuthAccountsFor, ɵqueryDevtoolsAuthActive as queryDevtoolsAuthActive, ɵqueryDevtoolsAuthFieldsFor as queryDevtoolsAuthFieldsFor, ɵqueryDevtoolsAuthOtherScopeCount as queryDevtoolsAuthOtherScopeCount, ɵqueryDevtoolsAuthSessions as queryDevtoolsAuthSessions, ɵqueryDevtoolsAuthSessionsFor as queryDevtoolsAuthSessionsFor, ɵqueryDevtoolsAuthTabLocal as queryDevtoolsAuthTabLocal, ɵqueryDevtoolsEntries as queryDevtoolsEntries, ɵqueryDevtoolsFaults as queryDevtoolsFaults, ɵqueryDevtoolsFaultsRestored as queryDevtoolsFaultsRestored, ɵqueryDevtoolsMockId as queryDevtoolsMockId, ɵqueryDevtoolsMocks as queryDevtoolsMocks, ɵqueryDevtoolsOverridePersistence as queryDevtoolsOverridePersistence, ɵqueryDevtoolsRequestPath as queryDevtoolsRequestPath, ɵqueryDevtoolsResponseHistory as queryDevtoolsResponseHistory, ɵqueryDevtoolsRestoredOverridesScope as queryDevtoolsRestoredOverridesScope, ɵqueryDevtoolsSchemaNames as queryDevtoolsSchemaNames, ɵqueryDevtoolsSchemaRoutes as queryDevtoolsSchemaRoutes, ɵqueryDevtoolsSchemaState as queryDevtoolsSchemaState, ɵqueryDevtoolsSettings as queryDevtoolsSettings, ɵqueryDevtoolsStorage as queryDevtoolsStorage, ɵqueryDevtoolsTokenTtls as queryDevtoolsTokenTtls, ɵreadQueryDevtoolsStore as readQueryDevtoolsStore, ɵregisterEthleteVersion as registerEthleteVersion, ɵremoveQueryDevtoolsAuthAccount as removeQueryDevtoolsAuthAccount, ɵrenameQueryDevtoolsAuthSession as renameQueryDevtoolsAuthSession, ɵrestoredQueryDevtoolsOverrides as restoredQueryDevtoolsOverrides, ɵsaveQueryDevtoolsMock as saveQueryDevtoolsMock, ɵseedQueryDevtoolsSchemaBody as seedQueryDevtoolsSchemaBody, ɵseedQueryDevtoolsSchemaRoute as seedQueryDevtoolsSchemaRoute, ɵserializeQueryDevtoolsOverrideTransfer as serializeQueryDevtoolsOverrideTransfer, ɵsetQueryDevtoolsApiEnv as setQueryDevtoolsApiEnv, ɵsetQueryDevtoolsAppInfo as setQueryDevtoolsAppInfo, ɵsetQueryDevtoolsArmedMocksScope as setQueryDevtoolsArmedMocksScope, ɵsetQueryDevtoolsAuthCredentials as setQueryDevtoolsAuthCredentials, ɵsetQueryDevtoolsAuthTabLocal as setQueryDevtoolsAuthTabLocal, ɵsetQueryDevtoolsFault as setQueryDevtoolsFault, ɵsetQueryDevtoolsFaultsScope as setQueryDevtoolsFaultsScope, ɵsetQueryDevtoolsOverridePersistence as setQueryDevtoolsOverridePersistence, ɵsetQueryDevtoolsOverridesScope as setQueryDevtoolsOverridesScope, ɵsetQueryDevtoolsSettings as setQueryDevtoolsSettings, ɵsmartDuplicateArrayItem as smartDuplicateArrayItem, ɵsnapshotQueryDevtoolsHandle as snapshotQueryDevtoolsHandle, ɵstringifyQueryRouteParts as stringifyQueryRouteParts, ɵsumQueryDevtoolsStats as sumQueryDevtoolsStats, ɵswitchQueryDevtoolsAuthSession as switchQueryDevtoolsAuthSession, ɵtombstoneOf as tombstoneOf, ɵwriteQueryDevtoolsStore as writeQueryDevtoolsStore } from '@ethlete/query';

package/types/ethlete-query-ngrx-toolkit.d.ts

@@ -117,8 +117,8 @@ type ToolkitCallOptions = {
 declare const toolkitSelect: <TCreator extends AnyQueryCreator>(creator: TCreator, args: ActionCallArgs<TCreator>, options?: ToolkitCallOptions) => MappedEntityState<TCreator>;
 /**
  * Executes a query creator with toolkit-shaped args and returns its handle - the `FacadeBase.call(group, args)` of
- * `@tomtomb/ngrx-toolkit`. Every call sends the request again; equal args return the same handle, which lives as
- * long as the injector.
+ * `@tomtomb/ngrx-toolkit`. Every call sends the request again, unless one with equal args is still in flight, which it
+ * joins; equal args return the same handle, which lives as long as the injector.
  *
  * @example
  * ```ts

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, WebSocketClientIo, SocketMessageView } from '@ethlete/query';
+import { AnyCreateQueryClientResult, QueryClientRef, createGetQuery, createPostQuery, createPutQuery, createPatchQuery, createDeleteQuery, BearerAuthProviderFeatureContext, AnyQueryBuilder, AuthQueryBuilder, TokenRefreshQueryBuilder, BearerAuthProvider, FeatureRegistry, 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';
@@ -16,15 +16,20 @@ type QueryTestSetup = {
     createPatch: ReturnType<typeof createPatchQuery>;
     createDelete: ReturnType<typeof createDeleteQuery>;
     /**
-     * Puts back the `console.warn` / `console.error` that were installed before the first
-     * {@link setupQueryTest} call. Idempotent, and safe to call from any of the setups a file created.
+     * Puts back the `console.error` that was installed before the first {@link setupQueryTest} call. Runs
+     * on its own when the `TestBed` module is reset; idempotent, and safe to call from any setup.
      */
     restoreConsole: () => void;
 };
 type QueryTestSetupConfig = {
     baseUrl?: string;
     name?: string;
-    mockErrorHandler?: boolean;
+    /**
+     * `true` swallows the `ErrorHandler` reports of failed requests and rethrows every other error, `'all'`
+     * swallows everything, `false` keeps Angular's own handler.
+     * @default true
+     */
+    mockErrorHandler?: boolean | 'all';
 };
 declare const setupQueryTest: (config?: QueryTestSetupConfig) => QueryTestSetup;
 
@@ -32,38 +37,25 @@ type AnyFeatureBuilder = (context: BearerAuthProviderFeatureContext<any, readonl
     type: string;
     instance: unknown;
 };
-type AuthTestSetupConfig<TLoginArgs extends {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-} = {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-}, TRefreshArgs extends {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-} = {
+type AuthTestArgs = {
     body: Record<string, unknown>;
     response: {
         accessToken: string;
         refreshToken: string;
     };
-}, TFeatures extends readonly AnyFeatureBuilder[] = [], TBearerData = unknown> = {
+};
+/** The query builders of the provider {@link setupAuthTest} builds: a `login` and a `refresh` query. */
+type AuthTestQueryBuilders<TLoginArgs extends AuthTestArgs = AuthTestArgs, TRefreshArgs extends AuthTestArgs = AuthTestArgs> = [AuthQueryBuilder<'login', TLoginArgs>, TokenRefreshQueryBuilder<'refresh', TRefreshArgs>];
+/** A feature for the provider {@link setupAuthTest} builds, typed against its `login`/`refresh` queries. */
+type AuthTestFeatureBuilder = (context: BearerAuthProviderFeatureContext<any, AuthTestQueryBuilders>) => unknown;
+type AuthTestSetupConfig<TLoginArgs extends AuthTestArgs = AuthTestArgs, TRefreshArgs extends AuthTestArgs = AuthTestArgs, TFeatures extends readonly AuthTestFeatureBuilder[] = [], TBearerData = unknown> = {
     /** The query test setup instance */
     querySetup: QueryTestSetup;
     /** Login endpoint path. Default: '/auth/login' */
     loginPath?: string;
     /** Refresh endpoint path. Default: '/auth/refresh' */
     refreshPath?: string;
-    /** Whether to enable auto-retry on 401. Default: false */
+    /** Whether to refresh and retry a secure request that answers 401. Default: true, as in production */
     autoRetryOn401?: boolean;
     /** Function to extract tokens from login response */
     extractLoginTokens?: (response: TLoginArgs['response']) => {
@@ -78,7 +70,7 @@ type AuthTestSetupConfig<TLoginArgs extends {
     /** Builds the refresh request from the refresh token. See TokenRefreshQueryConfig for details */
     buildRefreshArgs?: TokenRefreshQueryConfig<TRefreshArgs>['buildArgs'];
     /** Feature builders for additional auth functionality */
-    features?: [...TFeatures];
+    features?: TFeatures;
     /** Custom bearer decrypt function for testing */
     bearerDecryptFn?: (token: string) => TBearerData;
     /** Refresh strategy configuration. See TokenRefreshQueryConfig for details */
@@ -92,36 +84,11 @@ type AuthTestSetupConfig<TLoginArgs extends {
     /** What to do when the refresh query fails for good. Defaults to the provider's own policy */
     onRefreshFailure?: TokenRefreshQueryConfig<TRefreshArgs>['onRefreshFailure'];
 };
-type AuthTestSetup<TLoginArgs extends {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-} = {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-}, TRefreshArgs extends {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-} = {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-}, TFeatures extends readonly AnyFeatureBuilder[] = [], TBearerData = unknown> = {
+type AuthTestSetup<TLoginArgs extends AuthTestArgs = AuthTestArgs, TRefreshArgs extends AuthTestArgs = AuthTestArgs, TFeatures extends readonly AuthTestFeatureBuilder[] = [], TBearerData = unknown> = {
     /** The bearer auth provider instance */
-    auth: BearerAuthProvider<[
-        AuthQueryBuilder<'login', TLoginArgs>,
-        TokenRefreshQueryBuilder<'refresh', TRefreshArgs>
-    ], TFeatures, TBearerData>;
+    auth: Omit<BearerAuthProvider<AuthTestQueryBuilders<TLoginArgs, TRefreshArgs>, [], TBearerData>, 'features'> & {
+        features: FeatureRegistry<TFeatures, AuthTestQueryBuilders<TLoginArgs, TRefreshArgs>>;
+    };
     /** Helper to login a user and flush the HTTP request */
     login: (credentials: TLoginArgs['body'], response: TLoginArgs['response']) => void;
     /** Helper to trigger a refresh and flush the HTTP request. Sends `buildRefreshArgs(token)` when configured, else `{ body: { token } }` */
@@ -129,31 +96,7 @@ type AuthTestSetup<TLoginArgs extends {
     /** Helper to make a secure request that requires authentication */
     makeSecureRequest: (route: string) => void;
 };
-declare const setupAuthTest: <TLoginArgs extends {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-} = {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-}, TRefreshArgs extends {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-} = {
-    body: Record<string, unknown>;
-    response: {
-        accessToken: string;
-        refreshToken: string;
-    };
-}, TFeatures extends readonly AnyFeatureBuilder[] = readonly AnyFeatureBuilder[], TBearerData = unknown>(config: AuthTestSetupConfig<TLoginArgs, TRefreshArgs, TFeatures, TBearerData>) => AuthTestSetup<TLoginArgs, TRefreshArgs, TFeatures, TBearerData>;
+declare const setupAuthTest: <TLoginArgs extends AuthTestArgs = AuthTestArgs, TRefreshArgs extends AuthTestArgs = AuthTestArgs, TFeatures extends readonly AuthTestFeatureBuilder[] = readonly AuthTestFeatureBuilder[], TBearerData = unknown>(config: AuthTestSetupConfig<TLoginArgs, TRefreshArgs, TFeatures, TBearerData>) => AuthTestSetup<TLoginArgs, TRefreshArgs, TFeatures, TBearerData>;
 
 /**
  * Test doubles for the two browser APIs the query client's multi-tab sync is built on:
@@ -347,5 +290,22 @@ type WebSocketTestDouble = {
  */
 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 };
+type MintTestTokenOptions = {
+    /** @default 900000 (15 minutes) */
+    expiresInMs?: number;
+    /** Extra payload claims, e.g. the user id or roles `bearerData()` and the auth guards read. */
+    claims?: Record<string, unknown>;
+};
+/**
+ * Mints an unsigned JWT the bearer auth provider can decode, with `iat`, `exp` and a unique `jti`.
+ * Hand it to `setTokens()` to put the app's own provider into a session.
+ *
+ * @example
+ * ```ts
+ * TestBed.runInInjectionContext(() => authProviderRef.inject().setTokens(mintTestToken({ claims: { sub: '1' } }), 'refresh'));
+ * ```
+ */
+declare const mintTestToken: (options?: MintTestTokenOptions) => string;
+
+export { createFakeQueryPersistenceStore, createWebSocketTestDouble, expectAndFlush, expectFlushAndWait, flushMultiTabSync, installFakeBroadcastChannel, installFakeWebLocks, mintTestToken, setupAuthTest, setupQueryTest };
+export type { AnyFeatureBuilder, AuthTestFeatureBuilder, AuthTestQueryBuilders, AuthTestSetup, AuthTestSetupConfig, FakeBroadcastChannelHandle, FakeBroadcastMessage, FakeQueryPersistenceStoreHandle, FakeWebLocksHandle, MintTestTokenOptions, QueryTestSetup, QueryTestSetupConfig, WebSocketTestDouble };