@flanksource/clicky-ui 0.3.25 → 0.3.27

package/dist/devtools/ExecutionDetail.js

@@ -0,0 +1,135 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from "react";
+import { CodeBlock } from "../data/CodeBlock.js";
+import { JsonView } from "../data/JsonView.js";
+import { DebugClient, DetailEvictedError } from "./debugClient.js";
+function ExecutionDetail({ record, client, detail: provided }) {
+  const { detail, error, loading } = useExecutionDetail(record.id, client, provided);
+  if (provided === void 0 && loading) {
+    return /* @__PURE__ */ jsx("div", { className: "p-density-4 text-muted-foreground text-sm", children: "Loading capture…" });
+  }
+  if (error) {
+    return /* @__PURE__ */ jsxs("div", { className: "p-density-4 text-sm", children: [
+      /* @__PURE__ */ jsx("p", { className: "text-destructive", children: error }),
+      /* @__PURE__ */ jsx(RerunHint, { record })
+    ] });
+  }
+  if (!detail) return null;
+  const operations = detail.operations ?? [];
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-density-4 p-density-4", children: [
+    record.error ? /* @__PURE__ */ jsxs("section", { children: [
+      /* @__PURE__ */ jsx(SectionLabel, { children: "Error" }),
+      /* @__PURE__ */ jsx("p", { className: "whitespace-pre-wrap font-mono text-destructive text-xs", children: record.error })
+    ] }) : null,
+    operations.length === 0 ? /* @__PURE__ */ jsx("p", { className: "text-muted-foreground text-sm", children: "This request reached no provider — nothing ran that could be explained." }) : operations.map((diagnostics, index) => /* @__PURE__ */ jsx(
+      OperationDetail,
+      {
+        index: index + 1,
+        total: operations.length,
+        diagnostics
+      },
+      `${diagnostics.provider}-${index}`
+    )),
+    detail.logs && detail.logs.length > 0 ? /* @__PURE__ */ jsxs("section", { children: [
+      /* @__PURE__ */ jsxs(SectionLabel, { children: [
+        "Log lines (",
+        detail.logs.length,
+        ")"
+      ] }),
+      /* @__PURE__ */ jsx("div", { className: "max-h-64 overflow-auto rounded border border-border bg-muted/30 p-density-2 font-mono text-xs", children: detail.logs.map((line) => /* @__PURE__ */ jsxs("div", { className: "whitespace-pre-wrap", children: [
+        /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: line.level }),
+        " ",
+        line.message
+      ] }, `${line.source}-${line.sequence}`)) })
+    ] }) : null,
+    /* @__PURE__ */ jsx(RerunHint, { record })
+  ] });
+}
+function OperationDetail({
+  index,
+  total,
+  diagnostics
+}) {
+  const request = diagnostics.request ?? {};
+  const response = diagnostics.response ?? {};
+  return /* @__PURE__ */ jsxs("section", { className: "flex flex-col gap-density-3", children: [
+    /* @__PURE__ */ jsxs(SectionLabel, { children: [
+      total > 1 ? `Operation ${index} of ${total} — ` : "",
+      diagnostics.provider,
+      request.connection ? ` · ${request.connection}` : ""
+    ] }),
+    request.query ? /* @__PURE__ */ jsx(CodeBlock, { source: request.query, language: "sql" }) : null,
+    request.rendered && request.rendered !== request.query ? /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx(SectionLabel, { children: "Rendered from the profile" }),
+      /* @__PURE__ */ jsx(CodeBlock, { source: request.rendered, language: "sql" })
+    ] }) : null,
+    request.arguments && request.arguments.length > 0 ? /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx(SectionLabel, { children: "Bound arguments" }),
+      /* @__PURE__ */ jsx(JsonView, { data: request.arguments })
+    ] }) : null,
+    request.method || request.url ? /* @__PURE__ */ jsxs("p", { className: "font-mono text-xs", children: [
+      request.method,
+      " ",
+      request.url,
+      typeof response.status === "number" ? ` → ${response.status}` : ""
+    ] }) : null,
+    request.options && Object.keys(request.options).length > 0 ? /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx(SectionLabel, { children: "Options" }),
+      /* @__PURE__ */ jsx(JsonView, { data: request.options })
+    ] }) : null,
+    response.preview ? /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsxs(SectionLabel, { children: [
+        "Response preview",
+        response.truncated ? " (truncated)" : ""
+      ] }),
+      /* @__PURE__ */ jsx(CodeBlock, { source: response.preview, language: "json" })
+    ] }) : null,
+    diagnostics.error ? /* @__PURE__ */ jsx("p", { className: "whitespace-pre-wrap font-mono text-destructive text-xs", children: diagnostics.error }) : null
+  ] });
+}
+function RerunHint({ record }) {
+  if (record.level === "trace2" || record.level === "trace3" || record.level === "trace4") return null;
+  return /* @__PURE__ */ jsxs("p", { className: "text-muted-foreground text-xs", children: [
+    "Captured at ",
+    /* @__PURE__ */ jsx("span", { className: "font-mono", children: record.level }),
+    ". Response bodies are only buffered at ",
+    /* @__PURE__ */ jsx("span", { className: "font-mono", children: "trace2" }),
+    " — raise the level and run it again to see them."
+  ] });
+}
+function SectionLabel({ children }) {
+  return /* @__PURE__ */ jsx("p", { className: "mb-density-1 font-medium text-muted-foreground text-xs uppercase tracking-wide", children });
+}
+function useExecutionDetail(id, client, provided) {
+  const [detail, setDetail] = useState(provided);
+  const [error, setError] = useState();
+  const [loading, setLoading] = useState(provided === void 0);
+  useEffect(() => {
+    if (provided !== void 0) {
+      setDetail(provided);
+      setLoading(false);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    setError(void 0);
+    (client ?? new DebugClient()).detail(id).then((payload) => {
+      if (!cancelled) setDetail(payload);
+    }).catch((failure) => {
+      if (cancelled) return;
+      setError(
+        failure instanceof DetailEvictedError ? `${failure.message}. The summary above is all that survives.` : failure instanceof Error ? failure.message : String(failure)
+      );
+    }).finally(() => {
+      if (!cancelled) setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [id, client, provided]);
+  return { detail, error, loading };
+}
+export {
+  ExecutionDetail
+};
+//# sourceMappingURL=ExecutionDetail.js.map

package/dist/devtools/ExecutionDetail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionDetail.js","sources":["../../src/devtools/ExecutionDetail.tsx"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { CodeBlock } from \"../data/CodeBlock\";\nimport { JsonView } from \"../data/JsonView\";\nimport type { QueryBrowserDiagnostics } from \"../data/query-browser/QueryBrowser.types\";\nimport { DebugClient, DetailEvictedError } from \"./debugClient\";\nimport type { ExecutionDetail as ExecutionDetailPayload, ExecutionSummary } from \"./types\";\n\n/**\n * The pane behind one row: what the execution actually sent, what came back,\n * and the lines it wrote on the way.\n *\n * Everything here is fetched by record id — it is the run that already\n * happened, not a re-run of it. That is the whole point of the console: the old\n * \"Debug\" dialog answered \"what does this URL run\" by running it a second time,\n * so what you inspected was never the execution that misbehaved.\n */\n\nexport type ExecutionDetailProps = {\n  record: ExecutionSummary;\n  client?: DebugClient | undefined;\n  /** Pre-loaded detail, for a story or a test that has no server. */\n  detail?: ExecutionDetailPayload | undefined;\n};\n\nexport function ExecutionDetail({ record, client, detail: provided }: ExecutionDetailProps) {\n  const { detail, error, loading } = useExecutionDetail(record.id, client, provided);\n\n  if (provided === undefined && loading) {\n    return <div className=\"p-density-4 text-muted-foreground text-sm\">Loading capture…</div>;\n  }\n  if (error) {\n    return (\n      <div className=\"p-density-4 text-sm\">\n        <p className=\"text-destructive\">{error}</p>\n        <RerunHint record={record} />\n      </div>\n    );\n  }\n  if (!detail) return null;\n\n  const operations = detail.operations ?? [];\n  return (\n    <div className=\"flex flex-col gap-density-4 p-density-4\">\n      {record.error ? (\n        <section>\n          <SectionLabel>Error</SectionLabel>\n          <p className=\"whitespace-pre-wrap font-mono text-destructive text-xs\">{record.error}</p>\n        </section>\n      ) : null}\n\n      {operations.length === 0 ? (\n        <p className=\"text-muted-foreground text-sm\">\n          This request reached no provider — nothing ran that could be explained.\n        </p>\n      ) : (\n        operations.map((diagnostics, index) => (\n          <OperationDetail\n            key={`${diagnostics.provider}-${index}`}\n            index={index + 1}\n            total={operations.length}\n            diagnostics={diagnostics}\n          />\n        ))\n      )}\n\n      {detail.logs && detail.logs.length > 0 ? (\n        <section>\n          <SectionLabel>Log lines ({detail.logs.length})</SectionLabel>\n          <div className=\"max-h-64 overflow-auto rounded border border-border bg-muted/30 p-density-2 font-mono text-xs\">\n            {detail.logs.map((line) => (\n              <div key={`${line.source}-${line.sequence}`} className=\"whitespace-pre-wrap\">\n                <span className=\"text-muted-foreground\">{line.level}</span> {line.message}\n              </div>\n            ))}\n          </div>\n        </section>\n      ) : null}\n\n      <RerunHint record={record} />\n    </div>\n  );\n}\n\nfunction OperationDetail({\n  index,\n  total,\n  diagnostics,\n}: {\n  index: number;\n  total: number;\n  diagnostics: QueryBrowserDiagnostics;\n}) {\n  const request = diagnostics.request ?? {};\n  const response = diagnostics.response ?? {};\n  return (\n    <section className=\"flex flex-col gap-density-3\">\n      <SectionLabel>\n        {total > 1 ? `Operation ${index} of ${total} — ` : \"\"}\n        {diagnostics.provider}\n        {request.connection ? ` · ${request.connection}` : \"\"}\n      </SectionLabel>\n\n      {request.query ? <CodeBlock source={request.query} language=\"sql\" /> : null}\n      {/* Shown only when it differs: for most providers the two are equal, and a\n          second identical block reads as a second query. */}\n      {request.rendered && request.rendered !== request.query ? (\n        <div>\n          <SectionLabel>Rendered from the profile</SectionLabel>\n          <CodeBlock source={request.rendered} language=\"sql\" />\n        </div>\n      ) : null}\n\n      {request.arguments && request.arguments.length > 0 ? (\n        <div>\n          <SectionLabel>Bound arguments</SectionLabel>\n          <JsonView data={request.arguments} />\n        </div>\n      ) : null}\n\n      {request.method || request.url ? (\n        <p className=\"font-mono text-xs\">\n          {request.method} {request.url}\n          {typeof response.status === \"number\" ? ` → ${response.status}` : \"\"}\n        </p>\n      ) : null}\n\n      {request.options && Object.keys(request.options).length > 0 ? (\n        <div>\n          <SectionLabel>Options</SectionLabel>\n          <JsonView data={request.options} />\n        </div>\n      ) : null}\n\n      {response.preview ? (\n        <div>\n          <SectionLabel>\n            Response preview\n            {response.truncated ? \" (truncated)\" : \"\"}\n          </SectionLabel>\n          <CodeBlock source={response.preview} language=\"json\" />\n        </div>\n      ) : null}\n\n      {diagnostics.error ? (\n        <p className=\"whitespace-pre-wrap font-mono text-destructive text-xs\">{diagnostics.error}</p>\n      ) : null}\n    </section>\n  );\n}\n\n/**\n * A run captured below the level needed for what you are looking for cannot be\n * enriched retroactively — the bodies were never buffered. Saying so, and\n * naming the level that would have them, is the honest answer.\n */\nfunction RerunHint({ record }: { record: ExecutionSummary }) {\n  if (record.level === \"trace2\" || record.level === \"trace3\" || record.level === \"trace4\") return null;\n  return (\n    <p className=\"text-muted-foreground text-xs\">\n      Captured at <span className=\"font-mono\">{record.level}</span>. Response bodies are only\n      buffered at <span className=\"font-mono\">trace2</span> — raise the level and run it again to\n      see them.\n    </p>\n  );\n}\n\nfunction SectionLabel({ children }: { children: React.ReactNode }) {\n  return (\n    <p className=\"mb-density-1 font-medium text-muted-foreground text-xs uppercase tracking-wide\">\n      {children}\n    </p>\n  );\n}\n\nfunction useExecutionDetail(\n  id: string,\n  client: DebugClient | undefined,\n  provided: ExecutionDetailPayload | undefined,\n) {\n  const [detail, setDetail] = useState<ExecutionDetailPayload | undefined>(provided);\n  const [error, setError] = useState<string | undefined>();\n  const [loading, setLoading] = useState(provided === undefined);\n\n  useEffect(() => {\n    if (provided !== undefined) {\n      setDetail(provided);\n      setLoading(false);\n      return;\n    }\n    let cancelled = false;\n    setLoading(true);\n    setError(undefined);\n    (client ?? new DebugClient())\n      .detail(id)\n      .then((payload) => {\n        if (!cancelled) setDetail(payload);\n      })\n      .catch((failure: unknown) => {\n        if (cancelled) return;\n        setError(\n          failure instanceof DetailEvictedError\n            ? `${failure.message}. The summary above is all that survives.`\n            : failure instanceof Error\n              ? failure.message\n              : String(failure),\n        );\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [id, client, provided]);\n\n  return { detail, error, loading };\n}\n"],"names":[],"mappings":"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"}

package/dist/devtools/debugClient.cjs

@@ -0,0 +1,172 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const debugStore = require("./debugStore.cjs");
+const types = require("./types.cjs");
+const DEFAULT_PREFIX = "/api/v1";
+class DebugClient {
+  constructor(options = {}) {
+    __publicField(this, "prefix");
+    __publicField(this, "request");
+    this.prefix = (options.prefix ?? DEFAULT_PREFIX).replace(/\/$/, "");
+    this.request = options.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  get root() {
+    return `${this.prefix}/devtools`;
+  }
+  /** The stream URL, resumed from the last sequence the caller already holds. */
+  streamUrl(after) {
+    return after > 0 ? `${this.root}/stream?after=${after}` : `${this.root}/stream`;
+  }
+  async capabilities() {
+    return this.json(this.root);
+  }
+  async records(after = 0) {
+    return this.json(after > 0 ? `${this.root}/records?after=${after}` : `${this.root}/records`);
+  }
+  /**
+   * Fetches one record's detail.
+   *
+   * A 410 is not an error the caller should treat as a failure — it is the
+   * server saying the bodies aged out while the summary survived, which is a
+   * different thing from "no such record" and has to stay distinguishable.
+   */
+  async detail(id) {
+    const response = await this.request(`${this.root}/records/${encodeURIComponent(id)}`);
+    if (response.status === 410) {
+      const body = await response.json().catch(() => null);
+      throw new DetailEvictedError(id, (body == null ? void 0 : body.reason) ?? "the server no longer holds it");
+    }
+    if (!response.ok) {
+      throw new Error(`devtools record ${id}: ${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+  }
+  async har(id) {
+    return this.json(`${this.root}/records/${encodeURIComponent(id)}/har`);
+  }
+  async clear() {
+    const response = await this.request(`${this.root}/records`, { method: "DELETE" });
+    if (!response.ok) {
+      throw new Error(`clear devtools records: ${response.status} ${response.statusText}`);
+    }
+  }
+  /** What the server's metadata caches are holding right now. */
+  async inspection() {
+    return this.json(`${this.root}/inspection`);
+  }
+  /**
+   * Runs one captured provider request through the existing read-only sample
+   * boundary, where column inspection and cardinality probing already live.
+   */
+  async runInspection(options) {
+    const level = debugStore.debugStore.getSnapshot().level;
+    const headers = new Headers({ "Content-Type": "application/json" });
+    headers.set(types.DEBUG_LEVEL_HEADER, level === "off" ? "debug" : level);
+    if (options.refresh) headers.set(types.DEBUG_REFRESH_HEADER, "true");
+    const provider = { type: options.provider };
+    if (options.connection) provider.connection = options.connection;
+    if (options.options && Object.keys(options.options).length > 0) {
+      provider.options = options.options;
+    }
+    const profile = {
+      profile: "manual-inspection",
+      provider,
+      query: options.query
+    };
+    if (options.columns && options.columns.length > 0) {
+      profile.columns = options.columns.map((name) => ({ name, type: "string" }));
+    }
+    const response = await this.request(`${this.prefix}/profile/sample`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        profile,
+        pagination: { limit: 1 },
+        refreshInspection: options.refresh
+      })
+    });
+    const body = await response.text();
+    const recordID = response.headers.get(types.DEBUG_ID_HEADER);
+    if (!recordID) {
+      let message = "";
+      try {
+        message = String(JSON.parse(body).error ?? "");
+      } catch {
+        message = body.trim();
+      }
+      throw new Error(message || `manual inspection: ${response.status} ${response.statusText}`);
+    }
+    return this.detail(recordID);
+  }
+  /**
+   * Drops cached metadata so the next lookup rebuilds it, and returns what
+   * actually went.
+   *
+   * The count matters: an empty flush and a broken one look identical without
+   * it, and this affects every request that follows, not just this browser's.
+   */
+  async flushInspection(options = {}) {
+    const params = new URLSearchParams();
+    if (options.policy) params.set("policy", options.policy);
+    if (options.key) params.set("key", options.key);
+    const query = params.toString();
+    const response = await this.request(`${this.root}/inspection${query ? `?${query}` : ""}`, {
+      method: "DELETE"
+    });
+    if (!response.ok) {
+      throw new Error((await response.text()).trim() || `${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+  }
+  async json(url) {
+    const response = await this.request(url);
+    if (!response.ok) {
+      throw new Error(`${url}: ${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+  }
+}
+class DetailEvictedError extends Error {
+  constructor(id, reason) {
+    super(`the detail for ${id} is no longer held: ${reason}`);
+    this.id = id;
+    this.reason = reason;
+    this.name = "DetailEvictedError";
+  }
+}
+function withDebugFetch(inner = globalThis.fetch.bind(globalThis), options = {}) {
+  const readLevel = options.level ?? (() => debugStore.debugStore.getSnapshot().level);
+  const readRefresh = options.refreshInspection ?? (() => debugStore.debugStore.getSnapshot().refreshInspection);
+  return async (input, init) => {
+    const level = readLevel();
+    if (level === "off") return inner(input, init);
+    const headers = new Headers((init == null ? void 0 : init.headers) ?? (input instanceof Request ? input.headers : void 0));
+    headers.set(types.DEBUG_LEVEL_HEADER, level);
+    if (readRefresh()) headers.set(types.DEBUG_REFRESH_HEADER, "true");
+    const response = await inner(input, { ...init, headers });
+    const id = response.headers.get(types.DEBUG_ID_HEADER);
+    if (id && options.onRecordId) {
+      options.onRecordId(id, {
+        method: (init == null ? void 0 : init.method) ?? (input instanceof Request ? input.method : "GET"),
+        url: typeof input === "string" ? input : input instanceof URL ? input.href : input.url
+      });
+    }
+    return response;
+  };
+}
+function armUrl(url, level) {
+  if (level === "off") return url;
+  const hashAt = url.indexOf("#");
+  const base = hashAt === -1 ? url : url.slice(0, hashAt);
+  const hash = hashAt === -1 ? "" : url.slice(hashAt);
+  const separator = base.includes("?") ? "&" : "?";
+  return `${base}${separator}${types.DEBUG_LEVEL_PARAM}=${encodeURIComponent(level)}${hash}`;
+}
+exports.DebugClient = DebugClient;
+exports.DetailEvictedError = DetailEvictedError;
+exports.armUrl = armUrl;
+exports.withDebugFetch = withDebugFetch;
+//# sourceMappingURL=debugClient.cjs.map

package/dist/devtools/debugClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugClient.cjs","sources":["../../src/devtools/debugClient.ts"],"sourcesContent":["import { debugStore } from \"./debugStore\";\nimport {\n  DEBUG_ID_HEADER,\n  DEBUG_LEVEL_HEADER,\n  DEBUG_LEVEL_PARAM,\n  DEBUG_REFRESH_HEADER,\n  type DebugCapabilities,\n  type DebugLevel,\n  type DebugRecordsPage,\n  type ExecutionDetail,\n  type FlushResult,\n  type HARFile,\n  type InspectionCaches,\n} from \"./types\";\n\n/**\n * Talking to the devtools endpoints, and arming the app's own requests.\n *\n * Arming rides on a request header rather than a server-side mode so that one\n * browser tab cannot change what another tab's requests cost, and so nothing\n * has to be switched off again when that tab is closed.\n */\n\nexport type DebugClientOptions = {\n  /** API root, e.g. \"/api/v1\". */\n  prefix?: string | undefined;\n  /** Injected so a test can drive the client without a network. */\n  fetch?: typeof fetch | undefined;\n};\n\nexport type ManualInspectionRequest = {\n  provider: string;\n  connection?: string | undefined;\n  query: string;\n  options?: Record<string, unknown> | undefined;\n  columns?: string[] | undefined;\n  refresh: boolean;\n};\n\nconst DEFAULT_PREFIX = \"/api/v1\";\n\nexport class DebugClient {\n  private readonly prefix: string;\n  private readonly request: typeof fetch;\n\n  constructor(options: DebugClientOptions = {}) {\n    this.prefix = (options.prefix ?? DEFAULT_PREFIX).replace(/\\/$/, \"\");\n    this.request = options.fetch ?? globalThis.fetch.bind(globalThis);\n  }\n\n  get root(): string {\n    return `${this.prefix}/devtools`;\n  }\n\n  /** The stream URL, resumed from the last sequence the caller already holds. */\n  streamUrl(after: number): string {\n    return after > 0 ? `${this.root}/stream?after=${after}` : `${this.root}/stream`;\n  }\n\n  async capabilities(): Promise<DebugCapabilities> {\n    return this.json<DebugCapabilities>(this.root);\n  }\n\n  async records(after = 0): Promise<DebugRecordsPage> {\n    return this.json<DebugRecordsPage>(after > 0 ? `${this.root}/records?after=${after}` : `${this.root}/records`);\n  }\n\n  /**\n   * Fetches one record's detail.\n   *\n   * A 410 is not an error the caller should treat as a failure — it is the\n   * server saying the bodies aged out while the summary survived, which is a\n   * different thing from \"no such record\" and has to stay distinguishable.\n   */\n  async detail(id: string): Promise<ExecutionDetail> {\n    const response = await this.request(`${this.root}/records/${encodeURIComponent(id)}`);\n    if (response.status === 410) {\n      const body = (await response.json().catch(() => null)) as { reason?: string } | null;\n      throw new DetailEvictedError(id, body?.reason ?? \"the server no longer holds it\");\n    }\n    if (!response.ok) {\n      throw new Error(`devtools record ${id}: ${response.status} ${response.statusText}`);\n    }\n    return (await response.json()) as ExecutionDetail;\n  }\n\n  async har(id: string): Promise<HARFile> {\n    return this.json<HARFile>(`${this.root}/records/${encodeURIComponent(id)}/har`);\n  }\n\n  async clear(): Promise<void> {\n    const response = await this.request(`${this.root}/records`, { method: \"DELETE\" });\n    if (!response.ok) {\n      throw new Error(`clear devtools records: ${response.status} ${response.statusText}`);\n    }\n  }\n\n  /** What the server's metadata caches are holding right now. */\n  async inspection(): Promise<InspectionCaches> {\n    return this.json<InspectionCaches>(`${this.root}/inspection`);\n  }\n\n  /**\n   * Runs one captured provider request through the existing read-only sample\n   * boundary, where column inspection and cardinality probing already live.\n   */\n  async runInspection(options: ManualInspectionRequest): Promise<ExecutionDetail> {\n    const level = debugStore.getSnapshot().level;\n    const headers = new Headers({ \"Content-Type\": \"application/json\" });\n    headers.set(DEBUG_LEVEL_HEADER, level === \"off\" ? \"debug\" : level);\n    if (options.refresh) headers.set(DEBUG_REFRESH_HEADER, \"true\");\n\n    const provider: Record<string, unknown> = { type: options.provider };\n    if (options.connection) provider.connection = options.connection;\n    if (options.options && Object.keys(options.options).length > 0) {\n      provider.options = options.options;\n    }\n    const profile: Record<string, unknown> = {\n      profile: \"manual-inspection\",\n      provider,\n      query: options.query,\n    };\n    if (options.columns && options.columns.length > 0) {\n      profile.columns = options.columns.map((name) => ({ name, type: \"string\" }));\n    }\n\n    const response = await this.request(`${this.prefix}/profile/sample`, {\n      method: \"POST\",\n      headers,\n      body: JSON.stringify({\n        profile,\n        pagination: { limit: 1 },\n        refreshInspection: options.refresh,\n      }),\n    });\n    const body = await response.text();\n    const recordID = response.headers.get(DEBUG_ID_HEADER);\n    if (!recordID) {\n      let message = \"\";\n      try {\n        message = String((JSON.parse(body) as { error?: string }).error ?? \"\");\n      } catch {\n        message = body.trim();\n      }\n      throw new Error(message || `manual inspection: ${response.status} ${response.statusText}`);\n    }\n    return this.detail(recordID);\n  }\n\n  /**\n   * Drops cached metadata so the next lookup rebuilds it, and returns what\n   * actually went.\n   *\n   * The count matters: an empty flush and a broken one look identical without\n   * it, and this affects every request that follows, not just this browser's.\n   */\n  async flushInspection(options: { policy?: string; key?: string } = {}): Promise<FlushResult> {\n    const params = new URLSearchParams();\n    if (options.policy) params.set(\"policy\", options.policy);\n    if (options.key) params.set(\"key\", options.key);\n    const query = params.toString();\n    const response = await this.request(`${this.root}/inspection${query ? `?${query}` : \"\"}`, {\n      method: \"DELETE\",\n    });\n    if (!response.ok) {\n      throw new Error((await response.text()).trim() || `${response.status} ${response.statusText}`);\n    }\n    return (await response.json()) as FlushResult;\n  }\n\n  private async json<T>(url: string): Promise<T> {\n    const response = await this.request(url);\n    if (!response.ok) {\n      throw new Error(`${url}: ${response.status} ${response.statusText}`);\n    }\n    return (await response.json()) as T;\n  }\n}\n\n/** The server held the record but let its expensive half go. */\nexport class DetailEvictedError extends Error {\n  constructor(\n    readonly id: string,\n    readonly reason: string,\n  ) {\n    super(`the detail for ${id} is no longer held: ${reason}`);\n    this.name = \"DetailEvictedError\";\n  }\n}\n\nexport type DebugFetchOptions = {\n  /** Reads the level to arm at. Defaults to the shared store's current level. */\n  level?: (() => DebugLevel) | undefined;\n  /**\n   * Reads whether to also rebuild every metadata lookup. Defaults to the shared\n   * store's current setting.\n   */\n  refreshInspection?: (() => boolean) | undefined;\n  /** Called with the record id the server stamped on each armed response. */\n  onRecordId?: (id: string, request: { method: string; url: string }) => void;\n};\n\n/**\n * Wraps a `fetch` so every call through it arms the server at the console's\n * current level.\n *\n * It wraps the client's fetch rather than patching `window.fetch`: a patch\n * would capture Vite HMR, chat SSE and every other unrelated request, and\n * shipping that behaviour in a published library is hostile. The cost is that\n * bare `fetch()` call sites are not timed client-side — their server-side work\n * still arrives on the stream, which is what the tabs actually render.\n */\nexport function withDebugFetch(\n  inner: typeof fetch = globalThis.fetch.bind(globalThis),\n  options: DebugFetchOptions = {},\n): typeof fetch {\n  const readLevel = options.level ?? (() => debugStore.getSnapshot().level);\n  const readRefresh =\n    options.refreshInspection ?? (() => debugStore.getSnapshot().refreshInspection);\n  return async (input, init) => {\n    const level = readLevel();\n    if (level === \"off\") return inner(input, init);\n\n    const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));\n    headers.set(DEBUG_LEVEL_HEADER, level);\n    // Only sent when it is on. An always-present header carrying \"false\" would\n    // make every request look like it had opted out of something.\n    if (readRefresh()) headers.set(DEBUG_REFRESH_HEADER, \"true\");\n    const response = await inner(input, { ...init, headers });\n\n    const id = response.headers.get(DEBUG_ID_HEADER);\n    if (id && options.onRecordId) {\n      options.onRecordId(id, {\n        method: init?.method ?? (input instanceof Request ? input.method : \"GET\"),\n        url: typeof input === \"string\" ? input : input instanceof URL ? input.href : input.url,\n      });\n    }\n    return response;\n  };\n}\n\n/**\n * Marks a URL a browser will follow on its own — a download link, which builds\n * its own request and cannot carry a header.\n */\nexport function armUrl(url: string, level: DebugLevel): string {\n  if (level === \"off\") return url;\n  const hashAt = url.indexOf(\"#\");\n  const base = hashAt === -1 ? url : url.slice(0, hashAt);\n  const hash = hashAt === -1 ? \"\" : url.slice(hashAt);\n  const separator = base.includes(\"?\") ? \"&\" : \"?\";\n  return `${base}${separator}${DEBUG_LEVEL_PARAM}=${encodeURIComponent(level)}${hash}`;\n}\n"],"names":["debugStore","DEBUG_LEVEL_HEADER","DEBUG_REFRESH_HEADER","DEBUG_ID_HEADER","DEBUG_LEVEL_PARAM"],"mappings":";;;;;;;AAuCA,MAAM,iBAAiB;AAEhB,MAAM,YAAY;AAAA,EAIvB,YAAY,UAA8B,IAAI;AAH7B;AACA;AAGf,SAAK,UAAU,QAAQ,UAAU,gBAAgB,QAAQ,OAAO,EAAE;AAClE,SAAK,UAAU,QAAQ,SAAS,WAAW,MAAM,KAAK,UAAU;AAAA,EAClE;AAAA,EAEA,IAAI,OAAe;AACjB,WAAO,GAAG,KAAK,MAAM;AAAA,EACvB;AAAA;AAAA,EAGA,UAAU,OAAuB;AAC/B,WAAO,QAAQ,IAAI,GAAG,KAAK,IAAI,iBAAiB,KAAK,KAAK,GAAG,KAAK,IAAI;AAAA,EACxE;AAAA,EAEA,MAAM,eAA2C;AAC/C,WAAO,KAAK,KAAwB,KAAK,IAAI;AAAA,EAC/C;AAAA,EAEA,MAAM,QAAQ,QAAQ,GAA8B;AAClD,WAAO,KAAK,KAAuB,QAAQ,IAAI,GAAG,KAAK,IAAI,kBAAkB,KAAK,KAAK,GAAG,KAAK,IAAI,UAAU;AAAA,EAC/G;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OAAO,IAAsC;AACjD,UAAM,WAAW,MAAM,KAAK,QAAQ,GAAG,KAAK,IAAI,YAAY,mBAAmB,EAAE,CAAC,EAAE;AACpF,QAAI,SAAS,WAAW,KAAK;AAC3B,YAAM,OAAQ,MAAM,SAAS,OAAO,MAAM,MAAM,IAAI;AACpD,YAAM,IAAI,mBAAmB,KAAI,6BAAM,WAAU,+BAA+B;AAAA,IAClF;AACA,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,mBAAmB,EAAE,KAAK,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,IACpF;AACA,WAAQ,MAAM,SAAS,KAAA;AAAA,EACzB;AAAA,EAEA,MAAM,IAAI,IAA8B;AACtC,WAAO,KAAK,KAAc,GAAG,KAAK,IAAI,YAAY,mBAAmB,EAAE,CAAC,MAAM;AAAA,EAChF;AAAA,EAEA,MAAM,QAAuB;AAC3B,UAAM,WAAW,MAAM,KAAK,QAAQ,GAAG,KAAK,IAAI,YAAY,EAAE,QAAQ,SAAA,CAAU;AAChF,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,2BAA2B,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,IACrF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,aAAwC;AAC5C,WAAO,KAAK,KAAuB,GAAG,KAAK,IAAI,aAAa;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,cAAc,SAA4D;AAC9E,UAAM,QAAQA,WAAAA,WAAW,YAAA,EAAc;AACvC,UAAM,UAAU,IAAI,QAAQ,EAAE,gBAAgB,oBAAoB;AAClE,YAAQ,IAAIC,MAAAA,oBAAoB,UAAU,QAAQ,UAAU,KAAK;AACjE,QAAI,QAAQ,QAAS,SAAQ,IAAIC,MAAAA,sBAAsB,MAAM;AAE7D,UAAM,WAAoC,EAAE,MAAM,QAAQ,SAAA;AAC1D,QAAI,QAAQ,WAAY,UAAS,aAAa,QAAQ;AACtD,QAAI,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,EAAE,SAAS,GAAG;AAC9D,eAAS,UAAU,QAAQ;AAAA,IAC7B;AACA,UAAM,UAAmC;AAAA,MACvC,SAAS;AAAA,MACT;AAAA,MACA,OAAO,QAAQ;AAAA,IAAA;AAEjB,QAAI,QAAQ,WAAW,QAAQ,QAAQ,SAAS,GAAG;AACjD,cAAQ,UAAU,QAAQ,QAAQ,IAAI,CAAC,UAAU,EAAE,MAAM,MAAM,SAAA,EAAW;AAAA,IAC5E;AAEA,UAAM,WAAW,MAAM,KAAK,QAAQ,GAAG,KAAK,MAAM,mBAAmB;AAAA,MACnE,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACnB;AAAA,QACA,YAAY,EAAE,OAAO,EAAA;AAAA,QACrB,mBAAmB,QAAQ;AAAA,MAAA,CAC5B;AAAA,IAAA,CACF;AACD,UAAM,OAAO,MAAM,SAAS,KAAA;AAC5B,UAAM,WAAW,SAAS,QAAQ,IAAIC,MAAAA,eAAe;AACrD,QAAI,CAAC,UAAU;AACb,UAAI,UAAU;AACd,UAAI;AACF,kBAAU,OAAQ,KAAK,MAAM,IAAI,EAAyB,SAAS,EAAE;AAAA,MACvE,QAAQ;AACN,kBAAU,KAAK,KAAA;AAAA,MACjB;AACA,YAAM,IAAI,MAAM,WAAW,sBAAsB,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,IAC3F;AACA,WAAO,KAAK,OAAO,QAAQ;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,gBAAgB,UAA6C,IAA0B;AAC3F,UAAM,SAAS,IAAI,gBAAA;AACnB,QAAI,QAAQ,OAAQ,QAAO,IAAI,UAAU,QAAQ,MAAM;AACvD,QAAI,QAAQ,IAAK,QAAO,IAAI,OAAO,QAAQ,GAAG;AAC9C,UAAM,QAAQ,OAAO,SAAA;AACrB,UAAM,WAAW,MAAM,KAAK,QAAQ,GAAG,KAAK,IAAI,cAAc,QAAQ,IAAI,KAAK,KAAK,EAAE,IAAI;AAAA,MACxF,QAAQ;AAAA,IAAA,CACT;AACD,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,OAAO,MAAM,SAAS,QAAQ,KAAA,KAAU,GAAG,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,IAC/F;AACA,WAAQ,MAAM,SAAS,KAAA;AAAA,EACzB;AAAA,EAEA,MAAc,KAAQ,KAAyB;AAC7C,UAAM,WAAW,MAAM,KAAK,QAAQ,GAAG;AACvC,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,GAAG,GAAG,KAAK,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,IACrE;AACA,WAAQ,MAAM,SAAS,KAAA;AAAA,EACzB;AACF;AAGO,MAAM,2BAA2B,MAAM;AAAA,EAC5C,YACW,IACA,QACT;AACA,UAAM,kBAAkB,EAAE,uBAAuB,MAAM,EAAE;AAHhD,SAAA,KAAA;AACA,SAAA,SAAA;AAGT,SAAK,OAAO;AAAA,EACd;AACF;AAwBO,SAAS,eACd,QAAsB,WAAW,MAAM,KAAK,UAAU,GACtD,UAA6B,IACf;AACd,QAAM,YAAY,QAAQ,UAAU,MAAMH,WAAAA,WAAW,cAAc;AACnE,QAAM,cACJ,QAAQ,sBAAsB,MAAMA,WAAAA,WAAW,cAAc;AAC/D,SAAO,OAAO,OAAO,SAAS;AAC5B,UAAM,QAAQ,UAAA;AACd,QAAI,UAAU,MAAO,QAAO,MAAM,OAAO,IAAI;AAE7C,UAAM,UAAU,IAAI,SAAQ,6BAAM,aAAY,iBAAiB,UAAU,MAAM,UAAU,OAAU;AACnG,YAAQ,IAAIC,MAAAA,oBAAoB,KAAK;AAGrC,QAAI,YAAA,EAAe,SAAQ,IAAIC,MAAAA,sBAAsB,MAAM;AAC3D,UAAM,WAAW,MAAM,MAAM,OAAO,EAAE,GAAG,MAAM,SAAS;AAExD,UAAM,KAAK,SAAS,QAAQ,IAAIC,MAAAA,eAAe;AAC/C,QAAI,MAAM,QAAQ,YAAY;AAC5B,cAAQ,WAAW,IAAI;AAAA,QACrB,SAAQ,6BAAM,YAAW,iBAAiB,UAAU,MAAM,SAAS;AAAA,QACnE,KAAK,OAAO,UAAU,WAAW,QAAQ,iBAAiB,MAAM,MAAM,OAAO,MAAM;AAAA,MAAA,CACpF;AAAA,IACH;AACA,WAAO;AAAA,EACT;AACF;AAMO,SAAS,OAAO,KAAa,OAA2B;AAC7D,MAAI,UAAU,MAAO,QAAO;AAC5B,QAAM,SAAS,IAAI,QAAQ,GAAG;AAC9B,QAAM,OAAO,WAAW,KAAK,MAAM,IAAI,MAAM,GAAG,MAAM;AACtD,QAAM,OAAO,WAAW,KAAK,KAAK,IAAI,MAAM,MAAM;AAClD,QAAM,YAAY,KAAK,SAAS,GAAG,IAAI,MAAM;AAC7C,SAAO,GAAG,IAAI,GAAG,SAAS,GAAGC,MAAAA,iBAAiB,IAAI,mBAAmB,KAAK,CAAC,GAAG,IAAI;AACpF;;;;;"}

package/dist/devtools/debugClient.d.ts

@@ -0,0 +1,98 @@
+import { DebugCapabilities, DebugLevel, DebugRecordsPage, ExecutionDetail, FlushResult, HARFile, InspectionCaches } from './types';
+/**
+ * Talking to the devtools endpoints, and arming the app's own requests.
+ *
+ * Arming rides on a request header rather than a server-side mode so that one
+ * browser tab cannot change what another tab's requests cost, and so nothing
+ * has to be switched off again when that tab is closed.
+ */
+export type DebugClientOptions = {
+    /** API root, e.g. "/api/v1". */
+    prefix?: string | undefined;
+    /** Injected so a test can drive the client without a network. */
+    fetch?: typeof fetch | undefined;
+};
+export type ManualInspectionRequest = {
+    provider: string;
+    connection?: string | undefined;
+    query: string;
+    options?: Record<string, unknown> | undefined;
+    columns?: string[] | undefined;
+    refresh: boolean;
+};
+export declare class DebugClient {
+    private readonly prefix;
+    private readonly request;
+    constructor(options?: DebugClientOptions);
+    get root(): string;
+    /** The stream URL, resumed from the last sequence the caller already holds. */
+    streamUrl(after: number): string;
+    capabilities(): Promise<DebugCapabilities>;
+    records(after?: number): Promise<DebugRecordsPage>;
+    /**
+     * Fetches one record's detail.
+     *
+     * A 410 is not an error the caller should treat as a failure — it is the
+     * server saying the bodies aged out while the summary survived, which is a
+     * different thing from "no such record" and has to stay distinguishable.
+     */
+    detail(id: string): Promise<ExecutionDetail>;
+    har(id: string): Promise<HARFile>;
+    clear(): Promise<void>;
+    /** What the server's metadata caches are holding right now. */
+    inspection(): Promise<InspectionCaches>;
+    /**
+     * Runs one captured provider request through the existing read-only sample
+     * boundary, where column inspection and cardinality probing already live.
+     */
+    runInspection(options: ManualInspectionRequest): Promise<ExecutionDetail>;
+    /**
+     * Drops cached metadata so the next lookup rebuilds it, and returns what
+     * actually went.
+     *
+     * The count matters: an empty flush and a broken one look identical without
+     * it, and this affects every request that follows, not just this browser's.
+     */
+    flushInspection(options?: {
+        policy?: string;
+        key?: string;
+    }): Promise<FlushResult>;
+    private json;
+}
+/** The server held the record but let its expensive half go. */
+export declare class DetailEvictedError extends Error {
+    readonly id: string;
+    readonly reason: string;
+    constructor(id: string, reason: string);
+}
+export type DebugFetchOptions = {
+    /** Reads the level to arm at. Defaults to the shared store's current level. */
+    level?: (() => DebugLevel) | undefined;
+    /**
+     * Reads whether to also rebuild every metadata lookup. Defaults to the shared
+     * store's current setting.
+     */
+    refreshInspection?: (() => boolean) | undefined;
+    /** Called with the record id the server stamped on each armed response. */
+    onRecordId?: (id: string, request: {
+        method: string;
+        url: string;
+    }) => void;
+};
+/**
+ * Wraps a `fetch` so every call through it arms the server at the console's
+ * current level.
+ *
+ * It wraps the client's fetch rather than patching `window.fetch`: a patch
+ * would capture Vite HMR, chat SSE and every other unrelated request, and
+ * shipping that behaviour in a published library is hostile. The cost is that
+ * bare `fetch()` call sites are not timed client-side — their server-side work
+ * still arrives on the stream, which is what the tabs actually render.
+ */
+export declare function withDebugFetch(inner?: typeof fetch, options?: DebugFetchOptions): typeof fetch;
+/**
+ * Marks a URL a browser will follow on its own — a download link, which builds
+ * its own request and cannot carry a header.
+ */
+export declare function armUrl(url: string, level: DebugLevel): string;
+//# sourceMappingURL=debugClient.d.ts.map

package/dist/devtools/debugClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugClient.d.ts","sourceRoot":"","sources":["../../src/devtools/debugClient.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACtB,MAAM,SAAS,CAAC;AAEjB;;;;;;GAMG;AAEH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAIF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,OAAO,GAAE,kBAAuB;IAK5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,+EAA+E;IAC/E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1B,YAAY,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI1C,OAAO,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAInD;;;;;;OAMG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAY5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,+DAA+D;IACzD,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI7C;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;IA2C/E;;;;;;OAMG;IACG,eAAe,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;YAc9E,IAAI;CAOnB;AAED,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,KAAK;IAEzC,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADd,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM;CAK1B;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,CAAC,MAAM,UAAU,CAAC,GAAG,SAAS,CAAC;IACvC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,CAAC;IAChD,2EAA2E;IAC3E,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7E,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,KAAK,GAAE,OAAO,KAAyC,EACvD,OAAO,GAAE,iBAAsB,GAC9B,OAAO,KAAK,CAwBd;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAO7D"}

package/dist/devtools/debugClient.js

@@ -0,0 +1,172 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import { debugStore } from "./debugStore.js";
+import { DEBUG_LEVEL_HEADER, DEBUG_REFRESH_HEADER, DEBUG_ID_HEADER, DEBUG_LEVEL_PARAM } from "./types.js";
+const DEFAULT_PREFIX = "/api/v1";
+class DebugClient {
+  constructor(options = {}) {
+    __publicField(this, "prefix");
+    __publicField(this, "request");
+    this.prefix = (options.prefix ?? DEFAULT_PREFIX).replace(/\/$/, "");
+    this.request = options.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  get root() {
+    return `${this.prefix}/devtools`;
+  }
+  /** The stream URL, resumed from the last sequence the caller already holds. */
+  streamUrl(after) {
+    return after > 0 ? `${this.root}/stream?after=${after}` : `${this.root}/stream`;
+  }
+  async capabilities() {
+    return this.json(this.root);
+  }
+  async records(after = 0) {
+    return this.json(after > 0 ? `${this.root}/records?after=${after}` : `${this.root}/records`);
+  }
+  /**
+   * Fetches one record's detail.
+   *
+   * A 410 is not an error the caller should treat as a failure — it is the
+   * server saying the bodies aged out while the summary survived, which is a
+   * different thing from "no such record" and has to stay distinguishable.
+   */
+  async detail(id) {
+    const response = await this.request(`${this.root}/records/${encodeURIComponent(id)}`);
+    if (response.status === 410) {
+      const body = await response.json().catch(() => null);
+      throw new DetailEvictedError(id, (body == null ? void 0 : body.reason) ?? "the server no longer holds it");
+    }
+    if (!response.ok) {
+      throw new Error(`devtools record ${id}: ${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+  }
+  async har(id) {
+    return this.json(`${this.root}/records/${encodeURIComponent(id)}/har`);
+  }
+  async clear() {
+    const response = await this.request(`${this.root}/records`, { method: "DELETE" });
+    if (!response.ok) {
+      throw new Error(`clear devtools records: ${response.status} ${response.statusText}`);
+    }
+  }
+  /** What the server's metadata caches are holding right now. */
+  async inspection() {
+    return this.json(`${this.root}/inspection`);
+  }
+  /**
+   * Runs one captured provider request through the existing read-only sample
+   * boundary, where column inspection and cardinality probing already live.
+   */
+  async runInspection(options) {
+    const level = debugStore.getSnapshot().level;
+    const headers = new Headers({ "Content-Type": "application/json" });
+    headers.set(DEBUG_LEVEL_HEADER, level === "off" ? "debug" : level);
+    if (options.refresh) headers.set(DEBUG_REFRESH_HEADER, "true");
+    const provider = { type: options.provider };
+    if (options.connection) provider.connection = options.connection;
+    if (options.options && Object.keys(options.options).length > 0) {
+      provider.options = options.options;
+    }
+    const profile = {
+      profile: "manual-inspection",
+      provider,
+      query: options.query
+    };
+    if (options.columns && options.columns.length > 0) {
+      profile.columns = options.columns.map((name) => ({ name, type: "string" }));
+    }
+    const response = await this.request(`${this.prefix}/profile/sample`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        profile,
+        pagination: { limit: 1 },
+        refreshInspection: options.refresh
+      })
+    });
+    const body = await response.text();
+    const recordID = response.headers.get(DEBUG_ID_HEADER);
+    if (!recordID) {
+      let message = "";
+      try {
+        message = String(JSON.parse(body).error ?? "");
+      } catch {
+        message = body.trim();
+      }
+      throw new Error(message || `manual inspection: ${response.status} ${response.statusText}`);
+    }
+    return this.detail(recordID);
+  }
+  /**
+   * Drops cached metadata so the next lookup rebuilds it, and returns what
+   * actually went.
+   *
+   * The count matters: an empty flush and a broken one look identical without
+   * it, and this affects every request that follows, not just this browser's.
+   */
+  async flushInspection(options = {}) {
+    const params = new URLSearchParams();
+    if (options.policy) params.set("policy", options.policy);
+    if (options.key) params.set("key", options.key);
+    const query = params.toString();
+    const response = await this.request(`${this.root}/inspection${query ? `?${query}` : ""}`, {
+      method: "DELETE"
+    });
+    if (!response.ok) {
+      throw new Error((await response.text()).trim() || `${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+  }
+  async json(url) {
+    const response = await this.request(url);
+    if (!response.ok) {
+      throw new Error(`${url}: ${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+  }
+}
+class DetailEvictedError extends Error {
+  constructor(id, reason) {
+    super(`the detail for ${id} is no longer held: ${reason}`);
+    this.id = id;
+    this.reason = reason;
+    this.name = "DetailEvictedError";
+  }
+}
+function withDebugFetch(inner = globalThis.fetch.bind(globalThis), options = {}) {
+  const readLevel = options.level ?? (() => debugStore.getSnapshot().level);
+  const readRefresh = options.refreshInspection ?? (() => debugStore.getSnapshot().refreshInspection);
+  return async (input, init) => {
+    const level = readLevel();
+    if (level === "off") return inner(input, init);
+    const headers = new Headers((init == null ? void 0 : init.headers) ?? (input instanceof Request ? input.headers : void 0));
+    headers.set(DEBUG_LEVEL_HEADER, level);
+    if (readRefresh()) headers.set(DEBUG_REFRESH_HEADER, "true");
+    const response = await inner(input, { ...init, headers });
+    const id = response.headers.get(DEBUG_ID_HEADER);
+    if (id && options.onRecordId) {
+      options.onRecordId(id, {
+        method: (init == null ? void 0 : init.method) ?? (input instanceof Request ? input.method : "GET"),
+        url: typeof input === "string" ? input : input instanceof URL ? input.href : input.url
+      });
+    }
+    return response;
+  };
+}
+function armUrl(url, level) {
+  if (level === "off") return url;
+  const hashAt = url.indexOf("#");
+  const base = hashAt === -1 ? url : url.slice(0, hashAt);
+  const hash = hashAt === -1 ? "" : url.slice(hashAt);
+  const separator = base.includes("?") ? "&" : "?";
+  return `${base}${separator}${DEBUG_LEVEL_PARAM}=${encodeURIComponent(level)}${hash}`;
+}
+export {
+  DebugClient,
+  DetailEvictedError,
+  armUrl,
+  withDebugFetch
+};
+//# sourceMappingURL=debugClient.js.map