@ethlete/query-devtools 1.0.0-next.7 → 1.0.0-next.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethlete/query-devtools",
-  "version": "1.0.0-next.7",
+  "version": "1.0.0-next.9",
   "license": "MIT",
   "sideEffects": false,
   "peerDependencies": {

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

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { Signal, WritableSignal, OnInit } from '@angular/core';
 import * as _ethlete_query from '@ethlete/query';
-import { JsonPath, QueryDevtoolsOverridesRecorder, QueryRefreshCause, QueryRepositoryEntryDestroyedCause, Query, QueryRepositoryCacheEntry, HttpRequestRetryState, HttpRequestLoadingProgressState, QueryDevtoolsStats, QueryDevtoolsStatsHandle, QueryDevtoolsEntry, AnyQueryBatchItemResult, QueryRepository, QueryClient, QueryKeyLockState, QueryDevtoolsFeature, QueryDevtoolsFault, AnyQueryStack, AnyPagedQueryStack, QuerySequence, AnyQueryBatch, AnyBearerAuthProvider, WebSocketDevtoolsHandle, QueryDevtoolsFormHandle, QuerySequenceStatus, AnyQuerySnapshot, QueryDevtoolsRun, QueryDevtoolsRunError, WebSocketDevtoolsMessage, QueryDevtoolsStorageScope } from '@ethlete/query';
+import { JsonPath, QueryDevtoolsOverridesRecorder, QueryRefreshCause, QueryRepositoryEntryDestroyedCause, Query, QueryRepositoryCacheEntry, HttpRequestRetryState, HttpRequestLoadingProgressState, QueryDevtoolsStats, QueryDevtoolsStatsHandle, QueryDevtoolsEntry, AnyQueryBatchItemResult, QueryRepository, QueryClient, QueryKeyLockState, QueryDevtoolsFeature, QueryDevtoolsFault, AnyQueryStack, AnyPagedQueryStack, QuerySequence, AnyQueryBatch, AnyBearerAuthProvider, WebSocketDevtoolsHandle, QueryDevtoolsFormHandle, QuerySequenceStatus, AnyQuerySnapshot, QueryDevtoolsRun, QueryDevtoolsRunError, WebSocketDevtoolsMessage, QueryDevtoolsStorageScope, QueryDevtoolsApiEnvSwitch } from '@ethlete/query';
 import { ResizeEdge, DragMoveEvent, ResizeMoveEvent } from '@ethlete/core';
 
 type AboutRow = {
@@ -96,7 +96,7 @@ declare class QueryDevtoolsJsonComponent {
     private togglePath;
     private defaultExpanded;
     private localExpanded;
-    protected expanded: _angular_core.Signal<boolean>;
+    private expanded;
     /** Only slices that actually contain a match unfold while searching, so a filter stays cheap. */
     private chunkHasHit;
     protected effectiveExpanded: _angular_core.Signal<boolean>;
@@ -494,6 +494,11 @@ type QueryDevtoolsHost = {
     requestUrl(query: AnyQuery): string | null;
     requestPath(url: string): string;
     queryArgs(query: AnyQuery): unknown;
+    /**
+     * The headers the query's last run sent, or - before it has run - the ones its args and its client
+     * resolve to now. `null` when there are none, or while a header provider cannot resolve yet.
+     */
+    requestHeaders(query: AnyQuery): Record<string, string> | null;
     routeSegments(entry: QueryDevtoolsEntry | undefined, query: AnyQuery): RouteSegment[];
     queryActivity(entry: QueryDevtoolsEntry): QueryActivity;
     linkActivity(link: QueryLink): QueryActivity;
@@ -726,7 +731,7 @@ type QueryDevtoolsHost = {
     resetPaneSize(pane: PaneTarget): void;
 };
 
-type ScopeKey = 'viewState' | 'pins' | 'overrides' | 'mocks' | 'armedMocks' | 'armedFaults';
+type ScopeKey = 'viewState' | 'pins' | 'overrides' | 'mocks' | 'armedMocks' | 'armedFaults' | 'authSessions';
 type ScopeRow = {
     key: ScopeKey;
     label: string;
@@ -755,6 +760,7 @@ type LimitRow = {
  * otherwise hold as constants, and the toggles their own tabs also carry.
  */
 declare class QueryDevtoolsSettingsComponent {
+    private document;
     protected host: QueryDevtoolsHost;
     protected readonly SCOPE_ROWS: ScopeRow[];
     protected readonly SCOPES: {
@@ -769,9 +775,27 @@ declare class QueryDevtoolsSettingsComponent {
     /** What queries actually retain, which is the application's value unless this panel raised it. */
     protected responseHistory: _angular_core.Signal<number>;
     protected mockCount: _angular_core.Signal<number>;
+    protected sessionCount: _angular_core.Signal<number>;
     protected armedMockCount: _angular_core.Signal<number>;
     protected armedFaultCount: _angular_core.Signal<number>;
     protected resetConfirming: _angular_core.WritableSignal<boolean>;
+    protected readonly FORGET_SESSIONS: () => void;
+    /** The backends the application declared, or an empty list - the card renders only for a declared one. */
+    protected apiEnvs: _angular_core.Signal<QueryDevtoolsApiEnvSwitch[]>;
+    /** The env id (or typed URL) a switch's key holds, or `null` while the application picks for itself. */
+    protected apiEnvValue(apiSwitch: QueryDevtoolsApiEnvSwitch): string | null;
+    /** The env a switch falls back to with nothing stored, described for the default button. */
+    protected apiEnvFallback(apiSwitch: QueryDevtoolsApiEnvSwitch): {
+        label: string;
+        production: boolean;
+    };
+    /** Whether the pick in force - the stored env, or the fallback behind an unwritten key - is production. */
+    protected apiEnvIsProduction(apiSwitch: QueryDevtoolsApiEnvSwitch): boolean;
+    /** A stored value no declared env carries, which is a URL somebody typed in below. */
+    protected apiEnvCustomUrl(apiSwitch: QueryDevtoolsApiEnvSwitch): string;
+    /** Writes the application's own key and reloads - it is read before Angular boots, so nothing else can. */
+    protected pickApiEnv(apiSwitch: QueryDevtoolsApiEnvSwitch, value: string | null): void;
+    protected setCustomApiUrl(apiSwitch: QueryDevtoolsApiEnvSwitch, value: string): void;
     protected settings(): _ethlete_query.QueryDevtoolsSettings;
     protected scopeOf(key: ScopeKey): QueryDevtoolsStorageScope;
     protected limitOf(key: LimitKey): number;
@@ -814,21 +838,6 @@ type FloatRect = {
     width: number;
     height: number;
 };
-/**
- * A drag in progress: the panel's docked edge, the floating panel being moved or resized, or the
- * divider between a two-pane tab's panes.
- */
-type ResizeDrag = {
-    /** The document the pointer moves in - a popped-out panel lives in a window of its own. */
-    doc: Document;
-} & ({
-    kind: 'panel';
-} | {
-    kind: 'pane';
-    pane: PaneTarget;
-    axis: PaneAxis;
-    container: HTMLElement;
-});
 type PersistedState = {
     open?: boolean;
     height?: number;
@@ -1020,7 +1029,7 @@ declare class QueryDevtoolsComponent implements OnInit {
     protected drawerWidth: WritableSignal<number | null>;
     protected listHeight: WritableSignal<number | null>;
     protected drawerHeight: WritableSignal<number | null>;
-    protected drag: WritableSignal<ResizeDrag | null>;
+    private drag;
     protected resizing: _angular_core.Signal<boolean>;
     /** Which edge the panel is docked to, or `float` for a window of its own inside the page. */
     protected dock: WritableSignal<DevtoolsDock>;
@@ -1222,7 +1231,8 @@ declare class QueryDevtoolsComponent implements OnInit {
     lockRows: _angular_core.Signal<DevtoolsLockRow[] | null>;
     /** "Inspect" mode: hover the live UI to find the query that a component created. */
     protected inspectActive: WritableSignal<boolean>;
-    protected inspectHover: WritableSignal<{
+    /** @internal */
+    inspectHover: WritableSignal<{
         rect: DOMRect;
         entries: QueryDevtoolsEntry[];
     } | null>;
@@ -1525,6 +1535,19 @@ declare class QueryDevtoolsComponent implements OnInit {
      * its current request was built from stand in.
      */
     queryArgs(query: AnyQuery): Omit<any, "response" | "rawResponse"> | null;
+    /**
+     * The headers a query's request carries, as a plain `name: value` record, or `null` for a query that
+     * has none the panel can read. The set the last run sent, so it stays readable after the token it
+     * used was replaced; for a query that has not run, what its current args and its client resolve to
+     * now. `null` while a header provider throws - a secure query's needs an access token.
+     *
+     * The args tree cannot answer this on its own: a `withArgs` query reads its args from the feature's
+     * source, which the secure `Authorization` provider is never written back to, and client-level
+     * headers are merged in per execution rather than being part of the args at all.
+     */
+    requestHeaders(query: AnyQuery): {
+        [k: string]: string;
+    } | null;
     queryStatus(query: AnyQuery): QueryStatus;
     /**
      * A request in flight is already refreshing, so reporting it as stale on top of `loading` is noise -
@@ -1803,6 +1826,12 @@ declare class QueryDevtoolsComponent implements OnInit {
         content: string;
         type: string;
     }): void;
+    /**
+     * The headers an execution of this request would resolve to now: the client's with the per-request
+     * ones merged on top, providers called. `undefined` when a provider throws, which for a secure query
+     * means no access token is available yet.
+     */
+    private resolvedHeaders;
     /**
      * The same route rendered from a set of args rather than from a query, which is what a batch item leaves
      * behind: the batch destroys its query the moment the item settles.
@@ -1953,7 +1982,7 @@ declare class QueryDevtoolsComponent implements OnInit {
 declare const QUERY_DEVTOOLS_IMPORTS: readonly [typeof QueryDevtoolsComponent];
 
 /** The version of `@ethlete/query-devtools` this build was cut from. */
-declare const QUERY_DEVTOOLS_VERSION = "1.0.0-next.7";
+declare const QUERY_DEVTOOLS_VERSION = "1.0.0-next.9";
 
 export { QUERY_DEVTOOLS_IMPORTS, QUERY_DEVTOOLS_VERSION, QueryDevtoolsAboutComponent, QueryDevtoolsComponent, QueryDevtoolsJsonComponent, QueryDevtoolsJsonStylesComponent, QueryDevtoolsSettingsComponent, QueryDevtoolsTimelineStylesComponent, clampFloatToPeek, kindOf, resizedFloatRect, settledFloatRect };
 export type { JsonKind };