@flanksource/clicky-ui 0.3.24 → 0.3.26

package/dist/devtools/tabs/QueriesTab.cjs

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const DataTable = require("../../data/DataTable.cjs");
+const ExecutionDetail = require("../ExecutionDetail.cjs");
+const COLUMNS = [
+  { key: "time", label: "Time", kind: "timestamp", shrink: true, minWidth: 120 },
+  { key: "surface", label: "Surface", shrink: true, minWidth: 100, filterable: true },
+  { key: "provider", label: "Provider", shrink: true, minWidth: 110, filterable: true },
+  {
+    key: "query",
+    label: "Query",
+    grow: true,
+    minWidth: 280,
+    cellClassName: "font-mono text-xs",
+    render: (value) => /* @__PURE__ */ jsxRuntime.jsx("span", { title: String(value ?? ""), children: String(value ?? "") })
+  },
+  {
+    key: "operations",
+    label: "Ops",
+    align: "right",
+    shrink: true,
+    // A request that ran one operation is the ordinary case; showing "1" on
+    // every row would bury the four-operation request that is worth noticing.
+    render: (value) => Number(value ?? 0) > 1 ? String(value) : ""
+  },
+  { key: "rows", label: "Rows", align: "right", shrink: true },
+  {
+    key: "durationMs",
+    label: "Duration",
+    align: "right",
+    shrink: true,
+    render: (value) => `${Number(value ?? 0).toFixed(1)}ms`,
+    sortValue: (value) => Number(value ?? 0)
+  },
+  { key: "status", label: "Status", kind: "status", shrink: true, minWidth: 90 }
+];
+function QueriesTab({ records, client, search, onSelect }) {
+  const rows = react.useMemo(() => records.map(toRow), [records]);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    DataTable.DataTable,
+    {
+      data: rows,
+      columns: COLUMNS,
+      ...search === void 0 ? { showGlobalFilter: true } : { globalFilter: search },
+      emptyMessage: "No captures yet — run a query with the console open.",
+      defaultSort: { key: "time", dir: "desc" },
+      onRowClick: (row) => {
+        onSelect == null ? void 0 : onSelect(row.record);
+      },
+      renderExpandedRow: (row) => /* @__PURE__ */ jsxRuntime.jsx(ExecutionDetail.ExecutionDetail, { record: row.record, ...client ? { client } : {} })
+    }
+  );
+}
+function toRow(record) {
+  const operations = record.operations ?? [];
+  const first = operations[0];
+  return {
+    id: record.id,
+    time: record.startedAt,
+    surface: record.source.profile ? `${record.source.surface}: ${record.source.profile}` : record.source.surface,
+    provider: providerLabel(operations.map((operation) => operation.provider)),
+    query: (first == null ? void 0 : first.query) ?? (first == null ? void 0 : first.url) ?? "",
+    rows: record.rows,
+    durationMs: record.durationMs,
+    status: statusLabel(record),
+    operations: record.counts.operations,
+    record
+  };
+}
+function providerLabel(providers) {
+  const distinct = Array.from(new Set(providers.filter(Boolean)));
+  if (distinct.length === 0) return "";
+  if (distinct.length === 1) return distinct[0];
+  return `${distinct[0]} +${distinct.length - 1}`;
+}
+function statusLabel(record) {
+  if (record.error) return "error";
+  if (typeof record.status === "number" && record.status >= 400) return `error ${record.status}`;
+  if (typeof record.status === "number") return String(record.status);
+  return "ok";
+}
+exports.QueriesTab = QueriesTab;
+//# sourceMappingURL=QueriesTab.cjs.map

package/dist/devtools/tabs/QueriesTab.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueriesTab.cjs","sources":["../../../src/devtools/tabs/QueriesTab.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport { DataTable, type DataTableColumn } from \"../../data/DataTable\";\nimport type { DebugClient } from \"../debugClient\";\nimport { ExecutionDetail } from \"../ExecutionDetail\";\nimport type { ExecutionSummary } from \"../types\";\n\n/**\n * What ran, in the order it ran.\n *\n * One row per request rather than per provider operation: a profile with\n * context sub-queries is one thing the user asked for, and its operations are\n * listed in the detail pane where their relationship is visible. The counts\n * column says how many there were, so a request that quietly ran four queries\n * cannot look like one.\n */\n\nexport type QueriesTabProps = {\n  records: ExecutionSummary[];\n  client?: DebugClient | undefined;\n  /** Search term owned by the console header, shared across tabs. */\n  search?: string | undefined;\n  /**\n   * Called when a row is opened. The Network and Inspection tabs are scoped to\n   * one capture, and this is how they learn which.\n   */\n  onSelect?: ((record: ExecutionSummary) => void) | undefined;\n};\n\ntype QueryRow = Record<string, unknown> & {\n  id: string;\n  time: string;\n  surface: string;\n  provider: string;\n  query: string;\n  rows: number;\n  durationMs: number;\n  status: string;\n  operations: number;\n  record: ExecutionSummary;\n};\n\nconst COLUMNS: DataTableColumn<QueryRow>[] = [\n  { key: \"time\", label: \"Time\", kind: \"timestamp\", shrink: true, minWidth: 120 },\n  { key: \"surface\", label: \"Surface\", shrink: true, minWidth: 100, filterable: true },\n  { key: \"provider\", label: \"Provider\", shrink: true, minWidth: 110, filterable: true },\n  {\n    key: \"query\",\n    label: \"Query\",\n    grow: true,\n    minWidth: 280,\n    cellClassName: \"font-mono text-xs\",\n    render: (value) => <span title={String(value ?? \"\")}>{String(value ?? \"\")}</span>,\n  },\n  {\n    key: \"operations\",\n    label: \"Ops\",\n    align: \"right\",\n    shrink: true,\n    // A request that ran one operation is the ordinary case; showing \"1\" on\n    // every row would bury the four-operation request that is worth noticing.\n    render: (value) => (Number(value ?? 0) > 1 ? String(value) : \"\"),\n  },\n  { key: \"rows\", label: \"Rows\", align: \"right\", shrink: true },\n  {\n    key: \"durationMs\",\n    label: \"Duration\",\n    align: \"right\",\n    shrink: true,\n    render: (value) => `${Number(value ?? 0).toFixed(1)}ms`,\n    sortValue: (value) => Number(value ?? 0),\n  },\n  { key: \"status\", label: \"Status\", kind: \"status\", shrink: true, minWidth: 90 },\n];\n\nexport function QueriesTab({ records, client, search, onSelect }: QueriesTabProps) {\n  const rows = useMemo(() => records.map(toRow), [records]);\n\n  return (\n    <DataTable<QueryRow>\n      data={rows}\n      columns={COLUMNS}\n      {...(search === undefined ? { showGlobalFilter: true } : { globalFilter: search })}\n      emptyMessage=\"No captures yet — run a query with the console open.\"\n      defaultSort={{ key: \"time\", dir: \"desc\" }}\n      onRowClick={(row) => {\n        onSelect?.(row.record);\n      }}\n      renderExpandedRow={(row) => <ExecutionDetail record={row.record} {...(client ? { client } : {})} />}\n    />\n  );\n}\n\nfunction toRow(record: ExecutionSummary): QueryRow {\n  const operations = record.operations ?? [];\n  const first = operations[0];\n  return {\n    id: record.id,\n    time: record.startedAt,\n    surface: record.source.profile\n      ? `${record.source.surface}: ${record.source.profile}`\n      : record.source.surface,\n    provider: providerLabel(operations.map((operation) => operation.provider)),\n    query: first?.query ?? first?.url ?? \"\",\n    rows: record.rows,\n    durationMs: record.durationMs,\n    status: statusLabel(record),\n    operations: record.counts.operations,\n    record,\n  };\n}\n\n/** Several providers in one request is a fact about it, not a cell to truncate. */\nfunction providerLabel(providers: string[]): string {\n  const distinct = Array.from(new Set(providers.filter(Boolean)));\n  if (distinct.length === 0) return \"\";\n  if (distinct.length === 1) return distinct[0] as string;\n  return `${distinct[0]} +${distinct.length - 1}`;\n}\n\nfunction statusLabel(record: ExecutionSummary): string {\n  if (record.error) return \"error\";\n  if (typeof record.status === \"number\" && record.status >= 400) return `error ${record.status}`;\n  if (typeof record.status === \"number\") return String(record.status);\n  return \"ok\";\n}\n"],"names":["jsx","useMemo","DataTable","ExecutionDetail"],"mappings":"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"}

package/dist/devtools/tabs/QueriesTab.d.ts

@@ -0,0 +1,24 @@
+import { DebugClient } from '../debugClient';
+import { ExecutionSummary } from '../types';
+/**
+ * What ran, in the order it ran.
+ *
+ * One row per request rather than per provider operation: a profile with
+ * context sub-queries is one thing the user asked for, and its operations are
+ * listed in the detail pane where their relationship is visible. The counts
+ * column says how many there were, so a request that quietly ran four queries
+ * cannot look like one.
+ */
+export type QueriesTabProps = {
+    records: ExecutionSummary[];
+    client?: DebugClient | undefined;
+    /** Search term owned by the console header, shared across tabs. */
+    search?: string | undefined;
+    /**
+     * Called when a row is opened. The Network and Inspection tabs are scoped to
+     * one capture, and this is how they learn which.
+     */
+    onSelect?: ((record: ExecutionSummary) => void) | undefined;
+};
+export declare function QueriesTab({ records, client, search, onSelect }: QueriesTabProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QueriesTab.d.ts.map

package/dist/devtools/tabs/QueriesTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueriesTab.d.ts","sourceRoot":"","sources":["../../../src/devtools/tabs/QueriesTab.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;;;;;;GAQG;AAEH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7D,CAAC;AAgDF,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,2CAgBhF"}

package/dist/devtools/tabs/QueriesTab.js

@@ -0,0 +1,85 @@
+import { jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { DataTable } from "../../data/DataTable.js";
+import { ExecutionDetail } from "../ExecutionDetail.js";
+const COLUMNS = [
+  { key: "time", label: "Time", kind: "timestamp", shrink: true, minWidth: 120 },
+  { key: "surface", label: "Surface", shrink: true, minWidth: 100, filterable: true },
+  { key: "provider", label: "Provider", shrink: true, minWidth: 110, filterable: true },
+  {
+    key: "query",
+    label: "Query",
+    grow: true,
+    minWidth: 280,
+    cellClassName: "font-mono text-xs",
+    render: (value) => /* @__PURE__ */ jsx("span", { title: String(value ?? ""), children: String(value ?? "") })
+  },
+  {
+    key: "operations",
+    label: "Ops",
+    align: "right",
+    shrink: true,
+    // A request that ran one operation is the ordinary case; showing "1" on
+    // every row would bury the four-operation request that is worth noticing.
+    render: (value) => Number(value ?? 0) > 1 ? String(value) : ""
+  },
+  { key: "rows", label: "Rows", align: "right", shrink: true },
+  {
+    key: "durationMs",
+    label: "Duration",
+    align: "right",
+    shrink: true,
+    render: (value) => `${Number(value ?? 0).toFixed(1)}ms`,
+    sortValue: (value) => Number(value ?? 0)
+  },
+  { key: "status", label: "Status", kind: "status", shrink: true, minWidth: 90 }
+];
+function QueriesTab({ records, client, search, onSelect }) {
+  const rows = useMemo(() => records.map(toRow), [records]);
+  return /* @__PURE__ */ jsx(
+    DataTable,
+    {
+      data: rows,
+      columns: COLUMNS,
+      ...search === void 0 ? { showGlobalFilter: true } : { globalFilter: search },
+      emptyMessage: "No captures yet — run a query with the console open.",
+      defaultSort: { key: "time", dir: "desc" },
+      onRowClick: (row) => {
+        onSelect == null ? void 0 : onSelect(row.record);
+      },
+      renderExpandedRow: (row) => /* @__PURE__ */ jsx(ExecutionDetail, { record: row.record, ...client ? { client } : {} })
+    }
+  );
+}
+function toRow(record) {
+  const operations = record.operations ?? [];
+  const first = operations[0];
+  return {
+    id: record.id,
+    time: record.startedAt,
+    surface: record.source.profile ? `${record.source.surface}: ${record.source.profile}` : record.source.surface,
+    provider: providerLabel(operations.map((operation) => operation.provider)),
+    query: (first == null ? void 0 : first.query) ?? (first == null ? void 0 : first.url) ?? "",
+    rows: record.rows,
+    durationMs: record.durationMs,
+    status: statusLabel(record),
+    operations: record.counts.operations,
+    record
+  };
+}
+function providerLabel(providers) {
+  const distinct = Array.from(new Set(providers.filter(Boolean)));
+  if (distinct.length === 0) return "";
+  if (distinct.length === 1) return distinct[0];
+  return `${distinct[0]} +${distinct.length - 1}`;
+}
+function statusLabel(record) {
+  if (record.error) return "error";
+  if (typeof record.status === "number" && record.status >= 400) return `error ${record.status}`;
+  if (typeof record.status === "number") return String(record.status);
+  return "ok";
+}
+export {
+  QueriesTab
+};
+//# sourceMappingURL=QueriesTab.js.map

package/dist/devtools/tabs/QueriesTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueriesTab.js","sources":["../../../src/devtools/tabs/QueriesTab.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport { DataTable, type DataTableColumn } from \"../../data/DataTable\";\nimport type { DebugClient } from \"../debugClient\";\nimport { ExecutionDetail } from \"../ExecutionDetail\";\nimport type { ExecutionSummary } from \"../types\";\n\n/**\n * What ran, in the order it ran.\n *\n * One row per request rather than per provider operation: a profile with\n * context sub-queries is one thing the user asked for, and its operations are\n * listed in the detail pane where their relationship is visible. The counts\n * column says how many there were, so a request that quietly ran four queries\n * cannot look like one.\n */\n\nexport type QueriesTabProps = {\n  records: ExecutionSummary[];\n  client?: DebugClient | undefined;\n  /** Search term owned by the console header, shared across tabs. */\n  search?: string | undefined;\n  /**\n   * Called when a row is opened. The Network and Inspection tabs are scoped to\n   * one capture, and this is how they learn which.\n   */\n  onSelect?: ((record: ExecutionSummary) => void) | undefined;\n};\n\ntype QueryRow = Record<string, unknown> & {\n  id: string;\n  time: string;\n  surface: string;\n  provider: string;\n  query: string;\n  rows: number;\n  durationMs: number;\n  status: string;\n  operations: number;\n  record: ExecutionSummary;\n};\n\nconst COLUMNS: DataTableColumn<QueryRow>[] = [\n  { key: \"time\", label: \"Time\", kind: \"timestamp\", shrink: true, minWidth: 120 },\n  { key: \"surface\", label: \"Surface\", shrink: true, minWidth: 100, filterable: true },\n  { key: \"provider\", label: \"Provider\", shrink: true, minWidth: 110, filterable: true },\n  {\n    key: \"query\",\n    label: \"Query\",\n    grow: true,\n    minWidth: 280,\n    cellClassName: \"font-mono text-xs\",\n    render: (value) => <span title={String(value ?? \"\")}>{String(value ?? \"\")}</span>,\n  },\n  {\n    key: \"operations\",\n    label: \"Ops\",\n    align: \"right\",\n    shrink: true,\n    // A request that ran one operation is the ordinary case; showing \"1\" on\n    // every row would bury the four-operation request that is worth noticing.\n    render: (value) => (Number(value ?? 0) > 1 ? String(value) : \"\"),\n  },\n  { key: \"rows\", label: \"Rows\", align: \"right\", shrink: true },\n  {\n    key: \"durationMs\",\n    label: \"Duration\",\n    align: \"right\",\n    shrink: true,\n    render: (value) => `${Number(value ?? 0).toFixed(1)}ms`,\n    sortValue: (value) => Number(value ?? 0),\n  },\n  { key: \"status\", label: \"Status\", kind: \"status\", shrink: true, minWidth: 90 },\n];\n\nexport function QueriesTab({ records, client, search, onSelect }: QueriesTabProps) {\n  const rows = useMemo(() => records.map(toRow), [records]);\n\n  return (\n    <DataTable<QueryRow>\n      data={rows}\n      columns={COLUMNS}\n      {...(search === undefined ? { showGlobalFilter: true } : { globalFilter: search })}\n      emptyMessage=\"No captures yet — run a query with the console open.\"\n      defaultSort={{ key: \"time\", dir: \"desc\" }}\n      onRowClick={(row) => {\n        onSelect?.(row.record);\n      }}\n      renderExpandedRow={(row) => <ExecutionDetail record={row.record} {...(client ? { client } : {})} />}\n    />\n  );\n}\n\nfunction toRow(record: ExecutionSummary): QueryRow {\n  const operations = record.operations ?? [];\n  const first = operations[0];\n  return {\n    id: record.id,\n    time: record.startedAt,\n    surface: record.source.profile\n      ? `${record.source.surface}: ${record.source.profile}`\n      : record.source.surface,\n    provider: providerLabel(operations.map((operation) => operation.provider)),\n    query: first?.query ?? first?.url ?? \"\",\n    rows: record.rows,\n    durationMs: record.durationMs,\n    status: statusLabel(record),\n    operations: record.counts.operations,\n    record,\n  };\n}\n\n/** Several providers in one request is a fact about it, not a cell to truncate. */\nfunction providerLabel(providers: string[]): string {\n  const distinct = Array.from(new Set(providers.filter(Boolean)));\n  if (distinct.length === 0) return \"\";\n  if (distinct.length === 1) return distinct[0] as string;\n  return `${distinct[0]} +${distinct.length - 1}`;\n}\n\nfunction statusLabel(record: ExecutionSummary): string {\n  if (record.error) return \"error\";\n  if (typeof record.status === \"number\" && record.status >= 400) return `error ${record.status}`;\n  if (typeof record.status === \"number\") return String(record.status);\n  return \"ok\";\n}\n"],"names":[],"mappings":"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"}

package/dist/devtools/types.cjs

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DEBUG_TABS = ["queries", "network", "console", "inspection"];
+const SELECTABLE_LEVELS = ["off", "info", "debug", "trace", "trace1", "trace2"];
+const LEVEL_HELP = {
+  off: "Nothing is captured and an ordinary run pays nothing",
+  info: "Query text, connection, filters, rows, duration and errors",
+  debug: "Adds HAR entries and response previews — no bodies are buffered",
+  trace: "Adds request headers and the SQL statement itself",
+  trace1: "Adds request bodies and bound SQL arguments",
+  trace2: "Adds response bodies, with truncation reported"
+};
+const DEFAULT_DEBUG_LEVEL = "debug";
+const DEBUG_LEVEL_HEADER = "X-Debug-Level";
+const DEBUG_ID_HEADER = "X-Debug-Id";
+const DEBUG_REFRESH_HEADER = "X-Debug-Refresh-Inspection";
+const DEBUG_LEVEL_PARAM = "__debug";
+exports.DEBUG_ID_HEADER = DEBUG_ID_HEADER;
+exports.DEBUG_LEVEL_HEADER = DEBUG_LEVEL_HEADER;
+exports.DEBUG_LEVEL_PARAM = DEBUG_LEVEL_PARAM;
+exports.DEBUG_REFRESH_HEADER = DEBUG_REFRESH_HEADER;
+exports.DEBUG_TABS = DEBUG_TABS;
+exports.DEFAULT_DEBUG_LEVEL = DEFAULT_DEBUG_LEVEL;
+exports.LEVEL_HELP = LEVEL_HELP;
+exports.SELECTABLE_LEVELS = SELECTABLE_LEVELS;
+//# sourceMappingURL=types.cjs.map

package/dist/devtools/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sources":["../../src/devtools/types.ts"],"sourcesContent":["import type { HARFile, HAREntry } from \"../data/har/types\";\nimport type { QueryBrowserDiagnostics } from \"../data/query-browser/QueryBrowser.types\";\n\n/**\n * The devtools wire types, mirroring the server's `query` package field for\n * field.\n *\n * They are split in two the same way the server splits them. A summary is what\n * every armed request produces and what the stream pushes; a detail carries the\n * bodies, previews and correlated logs and is fetched for one record when\n * someone opens it. A console watching a busy server would otherwise be handed\n * megabytes of response bodies for queries nobody looked at.\n */\n\n/** Capture levels, in the order the server accepts them. */\nexport type DebugLevel =\n  | \"off\"\n  | \"error\"\n  | \"warn\"\n  | \"info\"\n  | \"debug\"\n  | \"trace\"\n  | \"trace1\"\n  | \"trace2\"\n  | \"trace3\"\n  | \"trace4\";\n\n/** The seam a recorded request came in on. */\nexport type ExecutionSource = {\n  surface: string;\n  profile?: string | undefined;\n  method?: string | undefined;\n  path?: string | undefined;\n  /** The client's query string, credential-shaped values blanked. */\n  query?: string | undefined;\n};\n\n/**\n * What detail exists to fetch, so a badge can be rendered without paying for\n * the payload behind it.\n */\nexport type RecordCounts = {\n  operations: number;\n  harEntries: number;\n  harDropped: number;\n  logLines: number;\n  logDropped: number;\n  probes: number;\n  inspections: number;\n};\n\n/**\n * One provider operation inside a request.\n *\n * A request is routinely more than one — a profile with context sub-queries\n * runs several — and reporting them as a single row is what makes \"which of\n * these three was slow\" unanswerable.\n */\nexport type OperationSummary = {\n  /** 1-based, in the order the operations started. */\n  index: number;\n  provider: string;\n  connection?: string | undefined;\n  query?: string | undefined;\n  method?: string | undefined;\n  url?: string | undefined;\n  status?: number | undefined;\n  durationMs: number;\n  rows: number;\n  pages?: number | undefined;\n  error?: string | undefined;\n};\n\n/** The cheap half: what ran, against what, how long, and how much came back. */\nexport type ExecutionSummary = {\n  id: string;\n  /** Assigned by the server's store; also the stream's event id. */\n  sequence: number;\n  source: ExecutionSource;\n  startedAt: string;\n  durationMs: number;\n  rows: number;\n  status?: number | undefined;\n  error?: string | undefined;\n  /**\n   * The level this run was armed at. A console showing a record it did not arm\n   * needs it to explain why the bodies are missing, rather than implying the\n   * request made none.\n   */\n  level: string;\n  operations?: OperationSummary[] | undefined;\n  counts: RecordCounts;\n};\n\n/** One line a request logged, or one the process logged while no request owned it. */\nexport type DebugLogLine = {\n  sequence: number;\n  time: string;\n  level: string;\n  /** `request` lines are captured structurally; `process` lines are scraped text. */\n  source: \"request\" | \"process\" | string;\n  logger?: string | undefined;\n  event?: string | undefined;\n  message: string;\n  values?: Record<string, unknown> | undefined;\n  recordId?: string | undefined;\n  /** Which operation within the request wrote it; 0 when not attributable. */\n  operation?: number | undefined;\n};\n\n/** A column-cardinality question and the filter kind its answer chose. */\nexport type CardinalityProbe = {\n  provider: string;\n  connection?: string | undefined;\n  column: string;\n  field?: string | undefined;\n  distinct: number;\n  limit: number;\n  kind: string;\n  cached: boolean;\n};\n\n/** One inspection-cache lookup a request made. */\nexport type InspectionRecord = {\n  policy: string;\n  key: string;\n  /** ~0 for a hit, the whole fill for a miss. That difference is the point. */\n  elapsedMs: number;\n  cached: boolean;\n  state?: string | undefined;\n  refreshing?: boolean | undefined;\n  ageMs: number;\n  /** A failed refresh behind a value that was still served. */\n  refreshError?: string | undefined;\n  /** A failure the caller actually got. */\n  error?: string | undefined;\n};\n\n/** The expensive half, served for one record on demand. */\nexport type ExecutionDetail = {\n  summary: ExecutionSummary;\n  operations?: QueryBrowserDiagnostics[] | undefined;\n  har?: HARFile | undefined;\n  logs?: DebugLogLine[] | undefined;\n  probes?: CardinalityProbe[] | undefined;\n  inspections?: InspectionRecord[] | undefined;\n  /**\n   * Credential capture was on, so the HAR entries hold live secrets. Stated\n   * rather than refused: a console that hands the file to a colleague has to\n   * know which kind of file it is.\n   */\n  harSensitive?: boolean | undefined;\n};\n\n/**\n * One metadata cache as the server holds it — the other half of the Inspection\n * tab. A record says what one request looked up; this says what is being kept\n * on everyone's behalf, which is the thing a flush throws away.\n */\nexport type InspectionCacheStats = {\n  policy: string;\n  entries: number;\n  maxEntries: number;\n  weight: number;\n  maxWeight: number;\n  /** Loads in flight. Always-filling means the freshness window is too short. */\n  filling: number;\n  oldest?: string | undefined;\n  freshForSeconds: number;\n  maxFreshForSeconds: number;\n};\n\nexport type InspectionCaches = {\n  caches: InspectionCacheStats[];\n};\n\n/** What a flush actually dropped, per cache. */\nexport type FlushResult = {\n  caches: { policy: string; entries: number }[];\n  entries: number;\n};\n\n/** What the server's record store currently holds and what it has let go. */\nexport type DebugStats = {\n  records: number;\n  recordsDropped: number;\n  oldestSequence: number;\n  logLines: number;\n  logsDropped: number;\n  logsOldestSequence: number;\n  detailsHeld: number;\n  detailBytes: number;\n  detailsEvicted: number;\n  maxDetailBytes: number;\n  detailTtlSeconds: number;\n};\n\n/**\n * What this server will do, asked before anything is asked of it — so the UI is\n * not built around constants duplicated on the other side of the wire.\n */\nexport type DebugCapabilities = {\n  enabled: boolean;\n  levels: string[];\n  header: string;\n  param: string;\n  idHeader: string;\n  stats: DebugStats;\n};\n\nexport type DebugRecordsPage = {\n  records: ExecutionSummary[];\n  stats: DebugStats;\n};\n\n/** The server's answer when a record exists but its detail has aged out. */\nexport type DetailEvicted = {\n  code: \"detail_evicted\";\n  id: string;\n  reason: string;\n};\n\nexport type { HARFile, HAREntry };\n\n/** The console's tabs, in the order they appear. */\nexport const DEBUG_TABS = [\"queries\", \"network\", \"console\", \"inspection\"] as const;\nexport type DebugTab = (typeof DEBUG_TABS)[number];\n\n/**\n * Offered in the level picker, in the order they cost more.\n *\n * A subset of DebugLevel: `error`/`warn` capture less than the summary every\n * run already produces, and trace3/trace4 add nothing this console renders — a\n * picker offering ten options where six differ is a picker nobody reads.\n */\nexport const SELECTABLE_LEVELS: DebugLevel[] = [\"off\", \"info\", \"debug\", \"trace\", \"trace1\", \"trace2\"];\n\n/**\n * What each level buys, stated as the extra capture rather than as a number.\n *\n * These are the *existing* per-event defaults in the server's observability\n * policy, not a scale this console invented — which is why the wording names\n * concrete artifacts (HAR entries, the SQL statement, response bodies).\n */\nexport const LEVEL_HELP: Record<string, string> = {\n  off: \"Nothing is captured and an ordinary run pays nothing\",\n  info: \"Query text, connection, filters, rows, duration and errors\",\n  debug: \"Adds HAR entries and response previews — no bodies are buffered\",\n  trace: \"Adds request headers and the SQL statement itself\",\n  trace1: \"Adds request bodies and bound SQL arguments\",\n  trace2: \"Adds response bodies, with truncation reported\",\n};\n\n/** Default arming level. `debug` buys HAR entries without buffering bodies. */\nexport const DEFAULT_DEBUG_LEVEL: DebugLevel = \"debug\";\n\n/** The header a request arms itself with, and the one the response answers by. */\nexport const DEBUG_LEVEL_HEADER = \"X-Debug-Level\";\nexport const DEBUG_ID_HEADER = \"X-Debug-Id\";\n/**\n * Asks a request to rebuild every metadata lookup it makes rather than read\n * what is cached.\n *\n * It rides per-request so the cost lands on the caller who asked and on nobody\n * else — unlike flushing, which drops the entry for everyone. The console keeps\n * it on until it is switched off, and drops it when the console closes, exactly\n * as it does the capture level.\n */\nexport const DEBUG_REFRESH_HEADER = \"X-Debug-Refresh-Inspection\";\n/** Says the same thing as the header for a caller that cannot set one. */\nexport const DEBUG_LEVEL_PARAM = \"__debug\";\n"],"names":[],"mappings":";;AAiOO,MAAM,aAAa,CAAC,WAAW,WAAW,WAAW,YAAY;AAUjE,MAAM,oBAAkC,CAAC,OAAO,QAAQ,SAAS,SAAS,UAAU,QAAQ;AAS5F,MAAM,aAAqC;AAAA,EAChD,KAAK;AAAA,EACL,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AACV;AAGO,MAAM,sBAAkC;AAGxC,MAAM,qBAAqB;AAC3B,MAAM,kBAAkB;AAUxB,MAAM,uBAAuB;AAE7B,MAAM,oBAAoB;;;;;;;;;"}

package/dist/devtools/types.d.ts

@@ -0,0 +1,235 @@
+import { HARFile, HAREntry } from '../data/har/types';
+import { QueryBrowserDiagnostics } from '../data/query-browser/QueryBrowser.types';
+/**
+ * The devtools wire types, mirroring the server's `query` package field for
+ * field.
+ *
+ * They are split in two the same way the server splits them. A summary is what
+ * every armed request produces and what the stream pushes; a detail carries the
+ * bodies, previews and correlated logs and is fetched for one record when
+ * someone opens it. A console watching a busy server would otherwise be handed
+ * megabytes of response bodies for queries nobody looked at.
+ */
+/** Capture levels, in the order the server accepts them. */
+export type DebugLevel = "off" | "error" | "warn" | "info" | "debug" | "trace" | "trace1" | "trace2" | "trace3" | "trace4";
+/** The seam a recorded request came in on. */
+export type ExecutionSource = {
+    surface: string;
+    profile?: string | undefined;
+    method?: string | undefined;
+    path?: string | undefined;
+    /** The client's query string, credential-shaped values blanked. */
+    query?: string | undefined;
+};
+/**
+ * What detail exists to fetch, so a badge can be rendered without paying for
+ * the payload behind it.
+ */
+export type RecordCounts = {
+    operations: number;
+    harEntries: number;
+    harDropped: number;
+    logLines: number;
+    logDropped: number;
+    probes: number;
+    inspections: number;
+};
+/**
+ * One provider operation inside a request.
+ *
+ * A request is routinely more than one — a profile with context sub-queries
+ * runs several — and reporting them as a single row is what makes "which of
+ * these three was slow" unanswerable.
+ */
+export type OperationSummary = {
+    /** 1-based, in the order the operations started. */
+    index: number;
+    provider: string;
+    connection?: string | undefined;
+    query?: string | undefined;
+    method?: string | undefined;
+    url?: string | undefined;
+    status?: number | undefined;
+    durationMs: number;
+    rows: number;
+    pages?: number | undefined;
+    error?: string | undefined;
+};
+/** The cheap half: what ran, against what, how long, and how much came back. */
+export type ExecutionSummary = {
+    id: string;
+    /** Assigned by the server's store; also the stream's event id. */
+    sequence: number;
+    source: ExecutionSource;
+    startedAt: string;
+    durationMs: number;
+    rows: number;
+    status?: number | undefined;
+    error?: string | undefined;
+    /**
+     * The level this run was armed at. A console showing a record it did not arm
+     * needs it to explain why the bodies are missing, rather than implying the
+     * request made none.
+     */
+    level: string;
+    operations?: OperationSummary[] | undefined;
+    counts: RecordCounts;
+};
+/** One line a request logged, or one the process logged while no request owned it. */
+export type DebugLogLine = {
+    sequence: number;
+    time: string;
+    level: string;
+    /** `request` lines are captured structurally; `process` lines are scraped text. */
+    source: "request" | "process" | string;
+    logger?: string | undefined;
+    event?: string | undefined;
+    message: string;
+    values?: Record<string, unknown> | undefined;
+    recordId?: string | undefined;
+    /** Which operation within the request wrote it; 0 when not attributable. */
+    operation?: number | undefined;
+};
+/** A column-cardinality question and the filter kind its answer chose. */
+export type CardinalityProbe = {
+    provider: string;
+    connection?: string | undefined;
+    column: string;
+    field?: string | undefined;
+    distinct: number;
+    limit: number;
+    kind: string;
+    cached: boolean;
+};
+/** One inspection-cache lookup a request made. */
+export type InspectionRecord = {
+    policy: string;
+    key: string;
+    /** ~0 for a hit, the whole fill for a miss. That difference is the point. */
+    elapsedMs: number;
+    cached: boolean;
+    state?: string | undefined;
+    refreshing?: boolean | undefined;
+    ageMs: number;
+    /** A failed refresh behind a value that was still served. */
+    refreshError?: string | undefined;
+    /** A failure the caller actually got. */
+    error?: string | undefined;
+};
+/** The expensive half, served for one record on demand. */
+export type ExecutionDetail = {
+    summary: ExecutionSummary;
+    operations?: QueryBrowserDiagnostics[] | undefined;
+    har?: HARFile | undefined;
+    logs?: DebugLogLine[] | undefined;
+    probes?: CardinalityProbe[] | undefined;
+    inspections?: InspectionRecord[] | undefined;
+    /**
+     * Credential capture was on, so the HAR entries hold live secrets. Stated
+     * rather than refused: a console that hands the file to a colleague has to
+     * know which kind of file it is.
+     */
+    harSensitive?: boolean | undefined;
+};
+/**
+ * One metadata cache as the server holds it — the other half of the Inspection
+ * tab. A record says what one request looked up; this says what is being kept
+ * on everyone's behalf, which is the thing a flush throws away.
+ */
+export type InspectionCacheStats = {
+    policy: string;
+    entries: number;
+    maxEntries: number;
+    weight: number;
+    maxWeight: number;
+    /** Loads in flight. Always-filling means the freshness window is too short. */
+    filling: number;
+    oldest?: string | undefined;
+    freshForSeconds: number;
+    maxFreshForSeconds: number;
+};
+export type InspectionCaches = {
+    caches: InspectionCacheStats[];
+};
+/** What a flush actually dropped, per cache. */
+export type FlushResult = {
+    caches: {
+        policy: string;
+        entries: number;
+    }[];
+    entries: number;
+};
+/** What the server's record store currently holds and what it has let go. */
+export type DebugStats = {
+    records: number;
+    recordsDropped: number;
+    oldestSequence: number;
+    logLines: number;
+    logsDropped: number;
+    logsOldestSequence: number;
+    detailsHeld: number;
+    detailBytes: number;
+    detailsEvicted: number;
+    maxDetailBytes: number;
+    detailTtlSeconds: number;
+};
+/**
+ * What this server will do, asked before anything is asked of it — so the UI is
+ * not built around constants duplicated on the other side of the wire.
+ */
+export type DebugCapabilities = {
+    enabled: boolean;
+    levels: string[];
+    header: string;
+    param: string;
+    idHeader: string;
+    stats: DebugStats;
+};
+export type DebugRecordsPage = {
+    records: ExecutionSummary[];
+    stats: DebugStats;
+};
+/** The server's answer when a record exists but its detail has aged out. */
+export type DetailEvicted = {
+    code: "detail_evicted";
+    id: string;
+    reason: string;
+};
+export type { HARFile, HAREntry };
+/** The console's tabs, in the order they appear. */
+export declare const DEBUG_TABS: readonly ["queries", "network", "console", "inspection"];
+export type DebugTab = (typeof DEBUG_TABS)[number];
+/**
+ * Offered in the level picker, in the order they cost more.
+ *
+ * A subset of DebugLevel: `error`/`warn` capture less than the summary every
+ * run already produces, and trace3/trace4 add nothing this console renders — a
+ * picker offering ten options where six differ is a picker nobody reads.
+ */
+export declare const SELECTABLE_LEVELS: DebugLevel[];
+/**
+ * What each level buys, stated as the extra capture rather than as a number.
+ *
+ * These are the *existing* per-event defaults in the server's observability
+ * policy, not a scale this console invented — which is why the wording names
+ * concrete artifacts (HAR entries, the SQL statement, response bodies).
+ */
+export declare const LEVEL_HELP: Record<string, string>;
+/** Default arming level. `debug` buys HAR entries without buffering bodies. */
+export declare const DEFAULT_DEBUG_LEVEL: DebugLevel;
+/** The header a request arms itself with, and the one the response answers by. */
+export declare const DEBUG_LEVEL_HEADER = "X-Debug-Level";
+export declare const DEBUG_ID_HEADER = "X-Debug-Id";
+/**
+ * Asks a request to rebuild every metadata lookup it makes rather than read
+ * what is cached.
+ *
+ * It rides per-request so the cost lands on the caller who asked and on nobody
+ * else — unlike flushing, which drops the entry for everyone. The console keeps
+ * it on until it is switched off, and drops it when the console closes, exactly
+ * as it does the capture level.
+ */
+export declare const DEBUG_REFRESH_HEADER = "X-Debug-Refresh-Inspection";
+/** Says the same thing as the header for a caller that cannot set one. */
+export declare const DEBUG_LEVEL_PARAM = "__debug";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/devtools/types.ts"],"names":[],"mappings":"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"}

package/dist/devtools/types.js

@@ -0,0 +1,26 @@
+const DEBUG_TABS = ["queries", "network", "console", "inspection"];
+const SELECTABLE_LEVELS = ["off", "info", "debug", "trace", "trace1", "trace2"];
+const LEVEL_HELP = {
+  off: "Nothing is captured and an ordinary run pays nothing",
+  info: "Query text, connection, filters, rows, duration and errors",
+  debug: "Adds HAR entries and response previews — no bodies are buffered",
+  trace: "Adds request headers and the SQL statement itself",
+  trace1: "Adds request bodies and bound SQL arguments",
+  trace2: "Adds response bodies, with truncation reported"
+};
+const DEFAULT_DEBUG_LEVEL = "debug";
+const DEBUG_LEVEL_HEADER = "X-Debug-Level";
+const DEBUG_ID_HEADER = "X-Debug-Id";
+const DEBUG_REFRESH_HEADER = "X-Debug-Refresh-Inspection";
+const DEBUG_LEVEL_PARAM = "__debug";
+export {
+  DEBUG_ID_HEADER,
+  DEBUG_LEVEL_HEADER,
+  DEBUG_LEVEL_PARAM,
+  DEBUG_REFRESH_HEADER,
+  DEBUG_TABS,
+  DEFAULT_DEBUG_LEVEL,
+  LEVEL_HELP,
+  SELECTABLE_LEVELS
+};
+//# sourceMappingURL=types.js.map

package/dist/devtools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../src/devtools/types.ts"],"sourcesContent":["import type { HARFile, HAREntry } from \"../data/har/types\";\nimport type { QueryBrowserDiagnostics } from \"../data/query-browser/QueryBrowser.types\";\n\n/**\n * The devtools wire types, mirroring the server's `query` package field for\n * field.\n *\n * They are split in two the same way the server splits them. A summary is what\n * every armed request produces and what the stream pushes; a detail carries the\n * bodies, previews and correlated logs and is fetched for one record when\n * someone opens it. A console watching a busy server would otherwise be handed\n * megabytes of response bodies for queries nobody looked at.\n */\n\n/** Capture levels, in the order the server accepts them. */\nexport type DebugLevel =\n  | \"off\"\n  | \"error\"\n  | \"warn\"\n  | \"info\"\n  | \"debug\"\n  | \"trace\"\n  | \"trace1\"\n  | \"trace2\"\n  | \"trace3\"\n  | \"trace4\";\n\n/** The seam a recorded request came in on. */\nexport type ExecutionSource = {\n  surface: string;\n  profile?: string | undefined;\n  method?: string | undefined;\n  path?: string | undefined;\n  /** The client's query string, credential-shaped values blanked. */\n  query?: string | undefined;\n};\n\n/**\n * What detail exists to fetch, so a badge can be rendered without paying for\n * the payload behind it.\n */\nexport type RecordCounts = {\n  operations: number;\n  harEntries: number;\n  harDropped: number;\n  logLines: number;\n  logDropped: number;\n  probes: number;\n  inspections: number;\n};\n\n/**\n * One provider operation inside a request.\n *\n * A request is routinely more than one — a profile with context sub-queries\n * runs several — and reporting them as a single row is what makes \"which of\n * these three was slow\" unanswerable.\n */\nexport type OperationSummary = {\n  /** 1-based, in the order the operations started. */\n  index: number;\n  provider: string;\n  connection?: string | undefined;\n  query?: string | undefined;\n  method?: string | undefined;\n  url?: string | undefined;\n  status?: number | undefined;\n  durationMs: number;\n  rows: number;\n  pages?: number | undefined;\n  error?: string | undefined;\n};\n\n/** The cheap half: what ran, against what, how long, and how much came back. */\nexport type ExecutionSummary = {\n  id: string;\n  /** Assigned by the server's store; also the stream's event id. */\n  sequence: number;\n  source: ExecutionSource;\n  startedAt: string;\n  durationMs: number;\n  rows: number;\n  status?: number | undefined;\n  error?: string | undefined;\n  /**\n   * The level this run was armed at. A console showing a record it did not arm\n   * needs it to explain why the bodies are missing, rather than implying the\n   * request made none.\n   */\n  level: string;\n  operations?: OperationSummary[] | undefined;\n  counts: RecordCounts;\n};\n\n/** One line a request logged, or one the process logged while no request owned it. */\nexport type DebugLogLine = {\n  sequence: number;\n  time: string;\n  level: string;\n  /** `request` lines are captured structurally; `process` lines are scraped text. */\n  source: \"request\" | \"process\" | string;\n  logger?: string | undefined;\n  event?: string | undefined;\n  message: string;\n  values?: Record<string, unknown> | undefined;\n  recordId?: string | undefined;\n  /** Which operation within the request wrote it; 0 when not attributable. */\n  operation?: number | undefined;\n};\n\n/** A column-cardinality question and the filter kind its answer chose. */\nexport type CardinalityProbe = {\n  provider: string;\n  connection?: string | undefined;\n  column: string;\n  field?: string | undefined;\n  distinct: number;\n  limit: number;\n  kind: string;\n  cached: boolean;\n};\n\n/** One inspection-cache lookup a request made. */\nexport type InspectionRecord = {\n  policy: string;\n  key: string;\n  /** ~0 for a hit, the whole fill for a miss. That difference is the point. */\n  elapsedMs: number;\n  cached: boolean;\n  state?: string | undefined;\n  refreshing?: boolean | undefined;\n  ageMs: number;\n  /** A failed refresh behind a value that was still served. */\n  refreshError?: string | undefined;\n  /** A failure the caller actually got. */\n  error?: string | undefined;\n};\n\n/** The expensive half, served for one record on demand. */\nexport type ExecutionDetail = {\n  summary: ExecutionSummary;\n  operations?: QueryBrowserDiagnostics[] | undefined;\n  har?: HARFile | undefined;\n  logs?: DebugLogLine[] | undefined;\n  probes?: CardinalityProbe[] | undefined;\n  inspections?: InspectionRecord[] | undefined;\n  /**\n   * Credential capture was on, so the HAR entries hold live secrets. Stated\n   * rather than refused: a console that hands the file to a colleague has to\n   * know which kind of file it is.\n   */\n  harSensitive?: boolean | undefined;\n};\n\n/**\n * One metadata cache as the server holds it — the other half of the Inspection\n * tab. A record says what one request looked up; this says what is being kept\n * on everyone's behalf, which is the thing a flush throws away.\n */\nexport type InspectionCacheStats = {\n  policy: string;\n  entries: number;\n  maxEntries: number;\n  weight: number;\n  maxWeight: number;\n  /** Loads in flight. Always-filling means the freshness window is too short. */\n  filling: number;\n  oldest?: string | undefined;\n  freshForSeconds: number;\n  maxFreshForSeconds: number;\n};\n\nexport type InspectionCaches = {\n  caches: InspectionCacheStats[];\n};\n\n/** What a flush actually dropped, per cache. */\nexport type FlushResult = {\n  caches: { policy: string; entries: number }[];\n  entries: number;\n};\n\n/** What the server's record store currently holds and what it has let go. */\nexport type DebugStats = {\n  records: number;\n  recordsDropped: number;\n  oldestSequence: number;\n  logLines: number;\n  logsDropped: number;\n  logsOldestSequence: number;\n  detailsHeld: number;\n  detailBytes: number;\n  detailsEvicted: number;\n  maxDetailBytes: number;\n  detailTtlSeconds: number;\n};\n\n/**\n * What this server will do, asked before anything is asked of it — so the UI is\n * not built around constants duplicated on the other side of the wire.\n */\nexport type DebugCapabilities = {\n  enabled: boolean;\n  levels: string[];\n  header: string;\n  param: string;\n  idHeader: string;\n  stats: DebugStats;\n};\n\nexport type DebugRecordsPage = {\n  records: ExecutionSummary[];\n  stats: DebugStats;\n};\n\n/** The server's answer when a record exists but its detail has aged out. */\nexport type DetailEvicted = {\n  code: \"detail_evicted\";\n  id: string;\n  reason: string;\n};\n\nexport type { HARFile, HAREntry };\n\n/** The console's tabs, in the order they appear. */\nexport const DEBUG_TABS = [\"queries\", \"network\", \"console\", \"inspection\"] as const;\nexport type DebugTab = (typeof DEBUG_TABS)[number];\n\n/**\n * Offered in the level picker, in the order they cost more.\n *\n * A subset of DebugLevel: `error`/`warn` capture less than the summary every\n * run already produces, and trace3/trace4 add nothing this console renders — a\n * picker offering ten options where six differ is a picker nobody reads.\n */\nexport const SELECTABLE_LEVELS: DebugLevel[] = [\"off\", \"info\", \"debug\", \"trace\", \"trace1\", \"trace2\"];\n\n/**\n * What each level buys, stated as the extra capture rather than as a number.\n *\n * These are the *existing* per-event defaults in the server's observability\n * policy, not a scale this console invented — which is why the wording names\n * concrete artifacts (HAR entries, the SQL statement, response bodies).\n */\nexport const LEVEL_HELP: Record<string, string> = {\n  off: \"Nothing is captured and an ordinary run pays nothing\",\n  info: \"Query text, connection, filters, rows, duration and errors\",\n  debug: \"Adds HAR entries and response previews — no bodies are buffered\",\n  trace: \"Adds request headers and the SQL statement itself\",\n  trace1: \"Adds request bodies and bound SQL arguments\",\n  trace2: \"Adds response bodies, with truncation reported\",\n};\n\n/** Default arming level. `debug` buys HAR entries without buffering bodies. */\nexport const DEFAULT_DEBUG_LEVEL: DebugLevel = \"debug\";\n\n/** The header a request arms itself with, and the one the response answers by. */\nexport const DEBUG_LEVEL_HEADER = \"X-Debug-Level\";\nexport const DEBUG_ID_HEADER = \"X-Debug-Id\";\n/**\n * Asks a request to rebuild every metadata lookup it makes rather than read\n * what is cached.\n *\n * It rides per-request so the cost lands on the caller who asked and on nobody\n * else — unlike flushing, which drops the entry for everyone. The console keeps\n * it on until it is switched off, and drops it when the console closes, exactly\n * as it does the capture level.\n */\nexport const DEBUG_REFRESH_HEADER = \"X-Debug-Refresh-Inspection\";\n/** Says the same thing as the header for a caller that cannot set one. */\nexport const DEBUG_LEVEL_PARAM = \"__debug\";\n"],"names":[],"mappings":"AAiOO,MAAM,aAAa,CAAC,WAAW,WAAW,WAAW,YAAY;AAUjE,MAAM,oBAAkC,CAAC,OAAO,QAAQ,SAAS,SAAS,UAAU,QAAQ;AAS5F,MAAM,aAAqC;AAAA,EAChD,KAAK;AAAA,EACL,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AACV;AAGO,MAAM,sBAAkC;AAGxC,MAAM,qBAAqB;AAC3B,MAAM,kBAAkB;AAUxB,MAAM,uBAAuB;AAE7B,MAAM,oBAAoB;"}

package/dist/devtools/useDebugStream.cjs

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const debugClient = require("./debugClient.cjs");
+const debugStore = require("./debugStore.cjs");
+function useDebugStream(options) {
+  const store = options.store ?? debugStore.debugStore;
+  const state = react.useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+  react.useEffect(() => {
+    if (!options.enabled) {
+      store.setConnected(false);
+      return;
+    }
+    const client = options.client ?? new debugClient.DebugClient();
+    const create = options.createEventSource ?? ((url) => new EventSource(url));
+    const source = create(client.streamUrl(store.lastSequence()));
+    const onRecord = (event) => {
+      const record = parse(event.data);
+      if (record) store.addRecord(record);
+    };
+    const onLog = (event) => {
+      const line = parse(event.data);
+      if (line) store.addLog(line);
+    };
+    source.addEventListener("record", onRecord);
+    source.addEventListener("log", onLog);
+    source.onopen = () => store.setConnected(true);
+    source.onerror = () => store.setConnected(false, "reconnecting to the devtools stream");
+    return () => {
+      source.removeEventListener("record", onRecord);
+      source.removeEventListener("log", onLog);
+      source.close();
+      store.setConnected(false);
+    };
+  }, [options.enabled, options.client, options.createEventSource, store]);
+  return state;
+}
+function parse(data) {
+  try {
+    return JSON.parse(data);
+  } catch {
+    return null;
+  }
+}
+exports.useDebugStream = useDebugStream;
+//# sourceMappingURL=useDebugStream.cjs.map

package/dist/devtools/useDebugStream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebugStream.cjs","sources":["../../src/devtools/useDebugStream.ts"],"sourcesContent":["import { useEffect, useSyncExternalStore } from \"react\";\nimport { DebugClient } from \"./debugClient\";\nimport { debugStore, type DebugStore, type DebugStoreState } from \"./debugStore\";\nimport type { DebugLogLine, ExecutionSummary } from \"./types\";\n\n/**\n * The console's live connection: one SSE stream carrying both records and log\n * lines.\n *\n * One stream, not two, because an HTTP/1.1 origin gets six connections and this\n * server already holds session streams on the same one. The frames are tagged,\n * so the split happens here rather than on the wire.\n */\n\nexport type UseDebugStreamOptions = {\n  /** Off by default — a closed console must not hold a connection open. */\n  enabled: boolean;\n  client?: DebugClient | undefined;\n  store?: DebugStore | undefined;\n  /**\n   * Builds the EventSource. Injected so a test can drive frames without a\n   * server, and so a host with its own auth wrapper can supply one.\n   */\n  createEventSource?: ((url: string) => EventSource) | undefined;\n};\n\nexport function useDebugStream(options: UseDebugStreamOptions): DebugStoreState {\n  const store = options.store ?? debugStore;\n  const state = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);\n\n  useEffect(() => {\n    if (!options.enabled) {\n      store.setConnected(false);\n      return;\n    }\n    const client = options.client ?? new DebugClient();\n    const create = options.createEventSource ?? ((url: string) => new EventSource(url));\n    const source = create(client.streamUrl(store.lastSequence()));\n\n    const onRecord = (event: MessageEvent) => {\n      const record = parse<ExecutionSummary>(event.data);\n      if (record) store.addRecord(record);\n    };\n    const onLog = (event: MessageEvent) => {\n      const line = parse<DebugLogLine>(event.data);\n      if (line) store.addLog(line);\n    };\n\n    source.addEventListener(\"record\", onRecord as EventListener);\n    source.addEventListener(\"log\", onLog as EventListener);\n    source.onopen = () => store.setConnected(true);\n    // EventSource reconnects on its own and resumes from Last-Event-ID, so this\n    // reports the gap rather than tearing the stream down and rebuilding it.\n    source.onerror = () => store.setConnected(false, \"reconnecting to the devtools stream\");\n\n    return () => {\n      source.removeEventListener(\"record\", onRecord as EventListener);\n      source.removeEventListener(\"log\", onLog as EventListener);\n      source.close();\n      store.setConnected(false);\n    };\n  }, [options.enabled, options.client, options.createEventSource, store]);\n\n  return state;\n}\n\nfunction parse<T>(data: string): T | null {\n  try {\n    return JSON.parse(data) as T;\n  } catch {\n    // A malformed frame is the server's bug, not a reason to drop the stream:\n    // the next frame is very likely fine, and a console that went blank here\n    // would hide every record that follows.\n    return null;\n  }\n}\n"],"names":["debugStore","useSyncExternalStore","useEffect","DebugClient"],"mappings":";;;;;AA0BO,SAAS,eAAe,SAAiD;AAC9E,QAAM,QAAQ,QAAQ,SAASA,WAAAA;AAC/B,QAAM,QAAQC,MAAAA,qBAAqB,MAAM,WAAW,MAAM,aAAa,MAAM,WAAW;AAExFC,QAAAA,UAAU,MAAM;AACd,QAAI,CAAC,QAAQ,SAAS;AACpB,YAAM,aAAa,KAAK;AACxB;AAAA,IACF;AACA,UAAM,SAAS,QAAQ,UAAU,IAAIC,YAAAA,YAAA;AACrC,UAAM,SAAS,QAAQ,sBAAsB,CAAC,QAAgB,IAAI,YAAY,GAAG;AACjF,UAAM,SAAS,OAAO,OAAO,UAAU,MAAM,aAAA,CAAc,CAAC;AAE5D,UAAM,WAAW,CAAC,UAAwB;AACxC,YAAM,SAAS,MAAwB,MAAM,IAAI;AACjD,UAAI,OAAQ,OAAM,UAAU,MAAM;AAAA,IACpC;AACA,UAAM,QAAQ,CAAC,UAAwB;AACrC,YAAM,OAAO,MAAoB,MAAM,IAAI;AAC3C,UAAI,KAAM,OAAM,OAAO,IAAI;AAAA,IAC7B;AAEA,WAAO,iBAAiB,UAAU,QAAyB;AAC3D,WAAO,iBAAiB,OAAO,KAAsB;AACrD,WAAO,SAAS,MAAM,MAAM,aAAa,IAAI;AAG7C,WAAO,UAAU,MAAM,MAAM,aAAa,OAAO,qCAAqC;AAEtF,WAAO,MAAM;AACX,aAAO,oBAAoB,UAAU,QAAyB;AAC9D,aAAO,oBAAoB,OAAO,KAAsB;AACxD,aAAO,MAAA;AACP,YAAM,aAAa,KAAK;AAAA,IAC1B;AAAA,EACF,GAAG,CAAC,QAAQ,SAAS,QAAQ,QAAQ,QAAQ,mBAAmB,KAAK,CAAC;AAEtE,SAAO;AACT;AAEA,SAAS,MAAS,MAAwB;AACxC,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AAIN,WAAO;AAAA,EACT;AACF;;"}