@flanksource/clicky-ui 0.3.40 → 0.3.42

package/dist/rpc/operationCatalogRowSelection.cjs

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const executionPages = require("./executionPages.cjs");
+const rowNavigation = require("./rowNavigation.cjs");
+function nextPickedRowIds(mode, previous, next) {
+  if (mode === "multi") return [...next];
+  assertSingleSelection(previous);
+  const added = next.filter((id) => !previous.includes(id));
+  if (added.length === 0) return [...next];
+  if (added.length === 1) return [added[0]];
+  throw new Error(
+    `OperationCatalog single-mode selection was offered ${added.length} new rows at once (${added.join(", ")}); only a row checkbox or row click may change it`
+  );
+}
+function assertSingleSelection(ids) {
+  if (ids.length > 1) {
+    throw new Error(
+      `OperationCatalog single-mode selection holds ${ids.length} ids (${ids.join(", ")}); pass at most one`
+    );
+  }
+}
+function pickerTableRowSelection(selection, filters) {
+  const { mode, selectedRowIds, onSelectionChange, unavailableRows } = selection;
+  if (mode === "single") assertSingleSelection(selectedRowIds);
+  return {
+    selectedRowIds,
+    toggleOnRowClick: true,
+    selectAll: mode === "multi",
+    getRowId: (row, index) => rowNavigation.getClickyRowId(row) ?? `operation-catalog-row-${index}`,
+    isRowSelectable: (row) => rowNavigation.getClickyRowId(row) != null && !(unavailableRows == null ? void 0 : unavailableRows.isUnavailable(row)),
+    onSelectionChange: (nextIds, rows) => {
+      const ids = nextPickedRowIds(mode, selectedRowIds, nextIds);
+      const picked = rows.filter((row) => {
+        const id = rowNavigation.getClickyRowId(row);
+        return id != null && ids.includes(id);
+      });
+      onSelectionChange(ids, picked, { filters });
+    }
+  };
+}
+const UNAVAILABLE_COLUMN = "__unavailable";
+function markUnavailableRows(response, unavailable) {
+  const document = executionPages.documentOf(response);
+  if (!document) return response;
+  let marked = false;
+  const node = executionPages.mapFirstTable(document.node, (table) => {
+    const flags = (table.rows ?? []).map(unavailable.isUnavailable);
+    if (!flags.some(Boolean)) return table;
+    marked = true;
+    return {
+      ...table,
+      columns: [
+        ...table.columns ?? [],
+        { name: UNAVAILABLE_COLUMN, label: unavailable.columnLabel, shrink: true }
+      ],
+      rows: (table.rows ?? []).map((row, index) => ({
+        ...row,
+        cells: {
+          ...row.cells,
+          [UNAVAILABLE_COLUMN]: flags[index] ? { kind: "badge", badgeLabel: unavailable.label } : { kind: "text", text: "", plain: "" }
+        }
+      }))
+    };
+  }).node;
+  if (!marked) return response;
+  const parsed = { ...document, node };
+  return { ...response, parsed, stdout: JSON.stringify(parsed) };
+}
+function operationLookupQuery(client, endpoint, lookupParameters) {
+  return {
+    queryKey: ["operation-lookup", endpoint == null ? void 0 : endpoint.method, endpoint == null ? void 0 : endpoint.path, lookupParameters],
+    queryFn: async () => {
+      var _a;
+      if (!endpoint) throw new Error("operation lookup ran without a list operation");
+      return await ((_a = client.lookupFilters) == null ? void 0 : _a.call(client, endpoint.path, endpoint.method, lookupParameters, {
+        Accept: "application/json+clicky"
+      })) ?? { filters: {} };
+    }
+  };
+}
+exports.markUnavailableRows = markUnavailableRows;
+exports.nextPickedRowIds = nextPickedRowIds;
+exports.operationLookupQuery = operationLookupQuery;
+exports.pickerTableRowSelection = pickerTableRowSelection;
+//# sourceMappingURL=operationCatalogRowSelection.cjs.map

package/dist/rpc/operationCatalogRowSelection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationCatalogRowSelection.cjs","sources":["../../src/rpc/operationCatalogRowSelection.ts"],"sourcesContent":["import type { ClickyNode, ClickyRow, ClickyTableRowSelection } from \"../data/Clicky\";\nimport { documentOf, mapFirstTable } from \"./executionPages\";\nimport type { ParameterValues } from \"./formMetadata\";\nimport { getClickyRowId } from \"./rowNavigation\";\nimport type {\n  ExecutionResponse,\n  OperationLookupResponse,\n  OperationRequestValues,\n  ResolvedOperation,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\nexport type OperationCatalogRowSelectionMode = \"single\" | \"multi\";\n\nexport type OperationCatalogRowSelectionContext = {\n  /**\n   * The catalog's effective list filters (locked values included) when the\n   * selection changed — what a host needs to fetch the picked rows' details\n   * under the same scope the list was read in.\n   */\n  filters: ParameterValues;\n};\n\n/** Rows that are listed but cannot be picked, badged in a trailing column. */\nexport type OperationCatalogUnavailableRows = {\n  isUnavailable: (row: ClickyRow) => boolean;\n  /** Badge text on an unavailable row, e.g. \"Attached\". */\n  label: string;\n  /** Header of the badge column. */\n  columnLabel: string;\n};\n\nexport type OperationCatalogRowSelection = {\n  /** `single` keeps at most one row checked: checking a row replaces the last. */\n  mode: OperationCatalogRowSelectionMode;\n  /** Controlled ids, read through `getClickyRowId`. */\n  selectedRowIds: string[];\n  /**\n   * Called with the next ids and the rows among them that are loaded on the\n   * current page — a row checked on an earlier page is not in `rows`.\n   */\n  onSelectionChange: (\n    ids: string[],\n    rows: ClickyRow[],\n    context: OperationCatalogRowSelectionContext,\n  ) => void;\n  unavailableRows?: OperationCatalogUnavailableRows;\n};\n\n/**\n * nextPickedRowIds applies the selection mode to the id set the table\n * proposes. Single mode keeps the one row just checked. The table offers no\n * header or group checkbox in single mode (`selectAll: false`), so a proposal\n * adding several rows at once is a broken invariant and throws.\n */\nexport function nextPickedRowIds(\n  mode: OperationCatalogRowSelectionMode,\n  previous: readonly string[],\n  next: readonly string[],\n): string[] {\n  if (mode === \"multi\") return [...next];\n  assertSingleSelection(previous);\n  const added = next.filter((id) => !previous.includes(id));\n  if (added.length === 0) return [...next];\n  if (added.length === 1) return [added[0]!];\n  throw new Error(\n    `OperationCatalog single-mode selection was offered ${added.length} new rows at once (${added.join(\", \")}); only a row checkbox or row click may change it`,\n  );\n}\n\nfunction assertSingleSelection(ids: readonly string[]) {\n  if (ids.length > 1) {\n    throw new Error(\n      `OperationCatalog single-mode selection holds ${ids.length} ids (${ids.join(\", \")}); pass at most one`,\n    );\n  }\n}\n\n/** Adapts a host's picker selection to the result table's row selection. */\nexport function pickerTableRowSelection(\n  selection: OperationCatalogRowSelection,\n  filters: ParameterValues,\n): ClickyTableRowSelection {\n  const { mode, selectedRowIds, onSelectionChange, unavailableRows } = selection;\n  if (mode === \"single\") assertSingleSelection(selectedRowIds);\n  return {\n    selectedRowIds,\n    toggleOnRowClick: true,\n    selectAll: mode === \"multi\",\n    getRowId: (row, index) => getClickyRowId(row) ?? `operation-catalog-row-${index}`,\n    isRowSelectable: (row) =>\n      getClickyRowId(row) != null && !unavailableRows?.isUnavailable(row),\n    onSelectionChange: (nextIds, rows) => {\n      const ids = nextPickedRowIds(mode, selectedRowIds, nextIds);\n      const picked = rows.filter((row) => {\n        const id = getClickyRowId(row);\n        return id != null && ids.includes(id);\n      });\n      onSelectionChange(ids, picked, { filters });\n    },\n  };\n}\n\nconst UNAVAILABLE_COLUMN = \"__unavailable\";\n\n/**\n * markUnavailableRows appends a badge column naming why a row cannot be\n * picked. A response with no unavailable row is returned by identity.\n */\nexport function markUnavailableRows(\n  response: ExecutionResponse,\n  unavailable: OperationCatalogUnavailableRows,\n): ExecutionResponse {\n  const document = documentOf(response);\n  if (!document) return response;\n  let marked = false;\n  const node = mapFirstTable(document.node, (table): ClickyNode => {\n    const flags = (table.rows ?? []).map(unavailable.isUnavailable);\n    if (!flags.some(Boolean)) return table;\n    marked = true;\n    return {\n      ...table,\n      columns: [\n        ...(table.columns ?? []),\n        { name: UNAVAILABLE_COLUMN, label: unavailable.columnLabel, shrink: true },\n      ],\n      rows: (table.rows ?? []).map((row, index) => ({\n        ...row,\n        cells: {\n          ...row.cells,\n          [UNAVAILABLE_COLUMN]: flags[index]\n            ? { kind: \"badge\", badgeLabel: unavailable.label }\n            : { kind: \"text\", text: \"\", plain: \"\" },\n        },\n      })),\n    };\n  }).node;\n  if (!marked) return response;\n  const parsed = { ...document, node };\n  return { ...response, parsed, stdout: JSON.stringify(parsed) };\n}\n\n/**\n * The react-query key and fetcher of a list surface's filter lookup. Shared so\n * a host reading the same lookup (the picker's scope line) observes the entry\n * the catalog fetches instead of issuing its own request.\n */\nexport function operationLookupQuery(\n  client: OperationsApiClient,\n  endpoint: ResolvedOperation | undefined,\n  lookupParameters: OperationRequestValues,\n) {\n  return {\n    queryKey: [\"operation-lookup\", endpoint?.method, endpoint?.path, lookupParameters] as const,\n    queryFn: async (): Promise<OperationLookupResponse> => {\n      if (!endpoint) throw new Error(\"operation lookup ran without a list operation\");\n      return (\n        (await client.lookupFilters?.(endpoint.path, endpoint.method, lookupParameters, {\n          Accept: \"application/json+clicky\",\n        })) ?? { filters: {} }\n      );\n    },\n  };\n}\n"],"names":["getClickyRowId","documentOf","mapFirstTable"],"mappings":"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"}

package/dist/rpc/operationCatalogRowSelection.d.ts

@@ -0,0 +1,57 @@
+import { ClickyRow, ClickyTableRowSelection } from '../data/Clicky.js';
+import { ParameterValues } from './formMetadata.js';
+import { ExecutionResponse, OperationLookupResponse, OperationRequestValues, ResolvedOperation } from './types.js';
+import { OperationsApiClient } from './useOperations.js';
+export type OperationCatalogRowSelectionMode = "single" | "multi";
+export type OperationCatalogRowSelectionContext = {
+    /**
+     * The catalog's effective list filters (locked values included) when the
+     * selection changed — what a host needs to fetch the picked rows' details
+     * under the same scope the list was read in.
+     */
+    filters: ParameterValues;
+};
+/** Rows that are listed but cannot be picked, badged in a trailing column. */
+export type OperationCatalogUnavailableRows = {
+    isUnavailable: (row: ClickyRow) => boolean;
+    /** Badge text on an unavailable row, e.g. "Attached". */
+    label: string;
+    /** Header of the badge column. */
+    columnLabel: string;
+};
+export type OperationCatalogRowSelection = {
+    /** `single` keeps at most one row checked: checking a row replaces the last. */
+    mode: OperationCatalogRowSelectionMode;
+    /** Controlled ids, read through `getClickyRowId`. */
+    selectedRowIds: string[];
+    /**
+     * Called with the next ids and the rows among them that are loaded on the
+     * current page — a row checked on an earlier page is not in `rows`.
+     */
+    onSelectionChange: (ids: string[], rows: ClickyRow[], context: OperationCatalogRowSelectionContext) => void;
+    unavailableRows?: OperationCatalogUnavailableRows;
+};
+/**
+ * nextPickedRowIds applies the selection mode to the id set the table
+ * proposes. Single mode keeps the one row just checked. The table offers no
+ * header or group checkbox in single mode (`selectAll: false`), so a proposal
+ * adding several rows at once is a broken invariant and throws.
+ */
+export declare function nextPickedRowIds(mode: OperationCatalogRowSelectionMode, previous: readonly string[], next: readonly string[]): string[];
+/** Adapts a host's picker selection to the result table's row selection. */
+export declare function pickerTableRowSelection(selection: OperationCatalogRowSelection, filters: ParameterValues): ClickyTableRowSelection;
+/**
+ * markUnavailableRows appends a badge column naming why a row cannot be
+ * picked. A response with no unavailable row is returned by identity.
+ */
+export declare function markUnavailableRows(response: ExecutionResponse, unavailable: OperationCatalogUnavailableRows): ExecutionResponse;
+/**
+ * The react-query key and fetcher of a list surface's filter lookup. Shared so
+ * a host reading the same lookup (the picker's scope line) observes the entry
+ * the catalog fetches instead of issuing its own request.
+ */
+export declare function operationLookupQuery(client: OperationsApiClient, endpoint: ResolvedOperation | undefined, lookupParameters: OperationRequestValues): {
+    queryKey: readonly ["operation-lookup", string | undefined, string | undefined, OperationRequestValues];
+    queryFn: () => Promise<OperationLookupResponse>;
+};
+//# sourceMappingURL=operationCatalogRowSelection.d.ts.map

package/dist/rpc/operationCatalogRowSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationCatalogRowSelection.d.ts","sourceRoot":"","sources":["../../src/rpc/operationCatalogRowSelection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,SAAS,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAErF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,MAAM,gCAAgC,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE,MAAM,MAAM,mCAAmC,GAAG;IAChD;;;;OAIG;IACH,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,+BAA+B,GAAG;IAC5C,aAAa,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC;IAC3C,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,gFAAgF;IAChF,IAAI,EAAE,gCAAgC,CAAC;IACvC,qDAAqD;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,iBAAiB,EAAE,CACjB,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,SAAS,EAAE,EACjB,OAAO,EAAE,mCAAmC,KACzC,IAAI,CAAC;IACV,eAAe,CAAC,EAAE,+BAA+B,CAAC;CACnD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,gCAAgC,EACtC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,EAAE,CASV;AAUD,4EAA4E;AAC5E,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,4BAA4B,EACvC,OAAO,EAAE,eAAe,GACvB,uBAAuB,CAmBzB;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,+BAA+B,GAC3C,iBAAiB,CA4BnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,gBAAgB,EAAE,sBAAsB;;mBAInB,OAAO,CAAC,uBAAuB,CAAC;EAStD"}

package/dist/rpc/operationCatalogRowSelection.js

@@ -0,0 +1,85 @@
+import { documentOf, mapFirstTable } from "./executionPages.js";
+import { getClickyRowId } from "./rowNavigation.js";
+function nextPickedRowIds(mode, previous, next) {
+  if (mode === "multi") return [...next];
+  assertSingleSelection(previous);
+  const added = next.filter((id) => !previous.includes(id));
+  if (added.length === 0) return [...next];
+  if (added.length === 1) return [added[0]];
+  throw new Error(
+    `OperationCatalog single-mode selection was offered ${added.length} new rows at once (${added.join(", ")}); only a row checkbox or row click may change it`
+  );
+}
+function assertSingleSelection(ids) {
+  if (ids.length > 1) {
+    throw new Error(
+      `OperationCatalog single-mode selection holds ${ids.length} ids (${ids.join(", ")}); pass at most one`
+    );
+  }
+}
+function pickerTableRowSelection(selection, filters) {
+  const { mode, selectedRowIds, onSelectionChange, unavailableRows } = selection;
+  if (mode === "single") assertSingleSelection(selectedRowIds);
+  return {
+    selectedRowIds,
+    toggleOnRowClick: true,
+    selectAll: mode === "multi",
+    getRowId: (row, index) => getClickyRowId(row) ?? `operation-catalog-row-${index}`,
+    isRowSelectable: (row) => getClickyRowId(row) != null && !(unavailableRows == null ? void 0 : unavailableRows.isUnavailable(row)),
+    onSelectionChange: (nextIds, rows) => {
+      const ids = nextPickedRowIds(mode, selectedRowIds, nextIds);
+      const picked = rows.filter((row) => {
+        const id = getClickyRowId(row);
+        return id != null && ids.includes(id);
+      });
+      onSelectionChange(ids, picked, { filters });
+    }
+  };
+}
+const UNAVAILABLE_COLUMN = "__unavailable";
+function markUnavailableRows(response, unavailable) {
+  const document = documentOf(response);
+  if (!document) return response;
+  let marked = false;
+  const node = mapFirstTable(document.node, (table) => {
+    const flags = (table.rows ?? []).map(unavailable.isUnavailable);
+    if (!flags.some(Boolean)) return table;
+    marked = true;
+    return {
+      ...table,
+      columns: [
+        ...table.columns ?? [],
+        { name: UNAVAILABLE_COLUMN, label: unavailable.columnLabel, shrink: true }
+      ],
+      rows: (table.rows ?? []).map((row, index) => ({
+        ...row,
+        cells: {
+          ...row.cells,
+          [UNAVAILABLE_COLUMN]: flags[index] ? { kind: "badge", badgeLabel: unavailable.label } : { kind: "text", text: "", plain: "" }
+        }
+      }))
+    };
+  }).node;
+  if (!marked) return response;
+  const parsed = { ...document, node };
+  return { ...response, parsed, stdout: JSON.stringify(parsed) };
+}
+function operationLookupQuery(client, endpoint, lookupParameters) {
+  return {
+    queryKey: ["operation-lookup", endpoint == null ? void 0 : endpoint.method, endpoint == null ? void 0 : endpoint.path, lookupParameters],
+    queryFn: async () => {
+      var _a;
+      if (!endpoint) throw new Error("operation lookup ran without a list operation");
+      return await ((_a = client.lookupFilters) == null ? void 0 : _a.call(client, endpoint.path, endpoint.method, lookupParameters, {
+        Accept: "application/json+clicky"
+      })) ?? { filters: {} };
+    }
+  };
+}
+export {
+  markUnavailableRows,
+  nextPickedRowIds,
+  operationLookupQuery,
+  pickerTableRowSelection
+};
+//# sourceMappingURL=operationCatalogRowSelection.js.map

package/dist/rpc/operationCatalogRowSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationCatalogRowSelection.js","sources":["../../src/rpc/operationCatalogRowSelection.ts"],"sourcesContent":["import type { ClickyNode, ClickyRow, ClickyTableRowSelection } from \"../data/Clicky\";\nimport { documentOf, mapFirstTable } from \"./executionPages\";\nimport type { ParameterValues } from \"./formMetadata\";\nimport { getClickyRowId } from \"./rowNavigation\";\nimport type {\n  ExecutionResponse,\n  OperationLookupResponse,\n  OperationRequestValues,\n  ResolvedOperation,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\nexport type OperationCatalogRowSelectionMode = \"single\" | \"multi\";\n\nexport type OperationCatalogRowSelectionContext = {\n  /**\n   * The catalog's effective list filters (locked values included) when the\n   * selection changed — what a host needs to fetch the picked rows' details\n   * under the same scope the list was read in.\n   */\n  filters: ParameterValues;\n};\n\n/** Rows that are listed but cannot be picked, badged in a trailing column. */\nexport type OperationCatalogUnavailableRows = {\n  isUnavailable: (row: ClickyRow) => boolean;\n  /** Badge text on an unavailable row, e.g. \"Attached\". */\n  label: string;\n  /** Header of the badge column. */\n  columnLabel: string;\n};\n\nexport type OperationCatalogRowSelection = {\n  /** `single` keeps at most one row checked: checking a row replaces the last. */\n  mode: OperationCatalogRowSelectionMode;\n  /** Controlled ids, read through `getClickyRowId`. */\n  selectedRowIds: string[];\n  /**\n   * Called with the next ids and the rows among them that are loaded on the\n   * current page — a row checked on an earlier page is not in `rows`.\n   */\n  onSelectionChange: (\n    ids: string[],\n    rows: ClickyRow[],\n    context: OperationCatalogRowSelectionContext,\n  ) => void;\n  unavailableRows?: OperationCatalogUnavailableRows;\n};\n\n/**\n * nextPickedRowIds applies the selection mode to the id set the table\n * proposes. Single mode keeps the one row just checked. The table offers no\n * header or group checkbox in single mode (`selectAll: false`), so a proposal\n * adding several rows at once is a broken invariant and throws.\n */\nexport function nextPickedRowIds(\n  mode: OperationCatalogRowSelectionMode,\n  previous: readonly string[],\n  next: readonly string[],\n): string[] {\n  if (mode === \"multi\") return [...next];\n  assertSingleSelection(previous);\n  const added = next.filter((id) => !previous.includes(id));\n  if (added.length === 0) return [...next];\n  if (added.length === 1) return [added[0]!];\n  throw new Error(\n    `OperationCatalog single-mode selection was offered ${added.length} new rows at once (${added.join(\", \")}); only a row checkbox or row click may change it`,\n  );\n}\n\nfunction assertSingleSelection(ids: readonly string[]) {\n  if (ids.length > 1) {\n    throw new Error(\n      `OperationCatalog single-mode selection holds ${ids.length} ids (${ids.join(\", \")}); pass at most one`,\n    );\n  }\n}\n\n/** Adapts a host's picker selection to the result table's row selection. */\nexport function pickerTableRowSelection(\n  selection: OperationCatalogRowSelection,\n  filters: ParameterValues,\n): ClickyTableRowSelection {\n  const { mode, selectedRowIds, onSelectionChange, unavailableRows } = selection;\n  if (mode === \"single\") assertSingleSelection(selectedRowIds);\n  return {\n    selectedRowIds,\n    toggleOnRowClick: true,\n    selectAll: mode === \"multi\",\n    getRowId: (row, index) => getClickyRowId(row) ?? `operation-catalog-row-${index}`,\n    isRowSelectable: (row) =>\n      getClickyRowId(row) != null && !unavailableRows?.isUnavailable(row),\n    onSelectionChange: (nextIds, rows) => {\n      const ids = nextPickedRowIds(mode, selectedRowIds, nextIds);\n      const picked = rows.filter((row) => {\n        const id = getClickyRowId(row);\n        return id != null && ids.includes(id);\n      });\n      onSelectionChange(ids, picked, { filters });\n    },\n  };\n}\n\nconst UNAVAILABLE_COLUMN = \"__unavailable\";\n\n/**\n * markUnavailableRows appends a badge column naming why a row cannot be\n * picked. A response with no unavailable row is returned by identity.\n */\nexport function markUnavailableRows(\n  response: ExecutionResponse,\n  unavailable: OperationCatalogUnavailableRows,\n): ExecutionResponse {\n  const document = documentOf(response);\n  if (!document) return response;\n  let marked = false;\n  const node = mapFirstTable(document.node, (table): ClickyNode => {\n    const flags = (table.rows ?? []).map(unavailable.isUnavailable);\n    if (!flags.some(Boolean)) return table;\n    marked = true;\n    return {\n      ...table,\n      columns: [\n        ...(table.columns ?? []),\n        { name: UNAVAILABLE_COLUMN, label: unavailable.columnLabel, shrink: true },\n      ],\n      rows: (table.rows ?? []).map((row, index) => ({\n        ...row,\n        cells: {\n          ...row.cells,\n          [UNAVAILABLE_COLUMN]: flags[index]\n            ? { kind: \"badge\", badgeLabel: unavailable.label }\n            : { kind: \"text\", text: \"\", plain: \"\" },\n        },\n      })),\n    };\n  }).node;\n  if (!marked) return response;\n  const parsed = { ...document, node };\n  return { ...response, parsed, stdout: JSON.stringify(parsed) };\n}\n\n/**\n * The react-query key and fetcher of a list surface's filter lookup. Shared so\n * a host reading the same lookup (the picker's scope line) observes the entry\n * the catalog fetches instead of issuing its own request.\n */\nexport function operationLookupQuery(\n  client: OperationsApiClient,\n  endpoint: ResolvedOperation | undefined,\n  lookupParameters: OperationRequestValues,\n) {\n  return {\n    queryKey: [\"operation-lookup\", endpoint?.method, endpoint?.path, lookupParameters] as const,\n    queryFn: async (): Promise<OperationLookupResponse> => {\n      if (!endpoint) throw new Error(\"operation lookup ran without a list operation\");\n      return (\n        (await client.lookupFilters?.(endpoint.path, endpoint.method, lookupParameters, {\n          Accept: \"application/json+clicky\",\n        })) ?? { filters: {} }\n      );\n    },\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/rpc/operationEntityPicker.fixtures.d.ts

@@ -0,0 +1,13 @@
+import { ClickyRow } from '../data/Clicky.js';
+import { ExecutionResponse, OpenAPISpec, OperationLookupResponse } from './types.js';
+import { OperationsApiClient } from './useOperations.js';
+export declare const SCHEMES_PATH = "/api/v1/schemes";
+export declare function schemeRow(id: string, company: string, status: string): ClickyRow;
+export declare const SCHEME_ROWS: ClickyRow[];
+export declare function schemesSpec(): OpenAPISpec;
+export declare function schemesResponse(rows?: ClickyRow[]): ExecutionResponse;
+export declare const SCHEMES_LOOKUP: OperationLookupResponse;
+export declare const executeSchemes: () => Promise<ExecutionResponse>;
+export declare const lookupSchemes: () => Promise<OperationLookupResponse>;
+export declare function schemesClient(overrides?: Partial<OperationsApiClient>): OperationsApiClient;
+//# sourceMappingURL=operationEntityPicker.fixtures.d.ts.map

package/dist/rpc/operationEntityPicker.fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationEntityPicker.fixtures.d.ts","sourceRoot":"","sources":["../../src/rpc/operationEntityPicker.fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACxB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAS3D,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAE9C,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAShF;AAED,eAAO,MAAM,WAAW,EAAE,SAAS,EAGlC,CAAC;AAEF,wBAAgB,WAAW,IAAI,WAAW,CA+CzC;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,SAAS,EAAgB,GAAG,iBAAiB,CAkBlF;AAED,eAAO,MAAM,cAAc,EAAE,uBAW5B,CAAC;AAEF,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,iBAAiB,CAAsB,CAAC;AACxF,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,uBAAuB,CAAmB,CAAC;AAE1F,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAAG,mBAAmB,CAO/F"}

package/dist/rpc/useOperationPages.cjs

@@ -11,7 +11,8 @@ function useOperationPages({
   endpoint,
   parameters,
   filters,
-  paginationMode
+  paginationMode,
+  refreshIntervalMs
 }) {
   var _a;
   const queryClient = reactQuery.useQueryClient();
@@ -24,6 +25,9 @@ function useOperationPages({
     );
   }
   const walkMode = paginationMode === "infinite" || paginationMode === void 0 && !!cursorParam;
+  if (refreshIntervalMs !== void 0 && (!Number.isFinite(refreshIntervalMs) || refreshIntervalMs <= 0 || walkMode)) {
+    throw new Error("Operation page refresh requires a positive interval and paged mode");
+  }
   const walkFilters = react.useMemo(() => {
     if (!cursorParam) return filters;
     const rest = { ...filters };
@@ -45,6 +49,7 @@ function useOperationPages({
     enabled: !!endpoint && !walkMode,
     placeholderData: reactQuery.keepPreviousData,
     staleTime: 3e4,
+    ...refreshIntervalMs !== void 0 ? { refetchInterval: refreshIntervalMs } : {},
     retry: 0
   });
   const walkKey = react.useMemo(

package/dist/rpc/useOperationPages.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationPages.cjs","sources":["../../src/rpc/useOperationPages.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo } from \"react\";\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useQuery,\n  useQueryClient,\n  type InfiniteData,\n  type QueryKey,\n} from \"@tanstack/react-query\";\n\nimport type { DataTableInfinite } from \"../data/DataTable\";\nimport { cursorParameterName, isCursorStale } from \"./cursorStale\";\nimport { packParameterValues, type ParameterValues } from \"./formMetadata\";\nimport type {\n  ExecutionResponse,\n  OpenAPIParameter,\n  ResolvedOperation,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\nconst LIST_KEY = \"operation-list\";\nconst CLICKY_HEADERS = { Accept: \"application/json+clicky\" };\n\nexport type OperationPagesOptions = {\n  client: OperationsApiClient;\n  /** The list operation, or undefined for a surface that has none. */\n  endpoint: ResolvedOperation | undefined;\n  /** Every parameter the operation declares — the source of the cursor role. */\n  parameters: OpenAPIParameter[];\n  /** Current filter/pagination state, as the catalog holds and URL-mirrors it. */\n  filters: ParameterValues;\n  /** Omit to infer a cursor walk from the operation; hosts may force either presentation. */\n  paginationMode?: \"paged\" | \"infinite\";\n};\n\nexport type OperationPages = {\n  /** Every page fetched so far, oldest first. One entry outside a walk. */\n  pages: ExecutionResponse[];\n  /** The newest page — what every renderer means by \"the response\". */\n  response: ExecutionResponse | null;\n  /** True while the whole result is being replaced, not while it is growing. */\n  isFetching: boolean;\n  isPending: boolean;\n  isError: boolean;\n  error: unknown;\n  /** Re-runs the list. A walk restarts rather than replaying its cursors. */\n  refetch: () => void;\n  /** Load-more handle; absent unless the operation can walk by cursor. */\n  infinite?: DataTableInfinite;\n};\n\n/**\n * useOperationPages runs a surface's list operation, walking it forward when it\n * declares a cursor and fetching a single page when it does not. A host can\n * explicitly keep a cursor-capable operation paged when readers need offset\n * controls; omission retains automatic selection.\n *\n * Automatic mode follows the operation: a cursor role is the server saying\n * \"you may resume this query\", and everything else keeps the single-page query\n * it has always had. An explicit host override changes only the presentation;\n * the operation still owns the available cursor and offset capabilities.\n *\n * In walk mode the cursor is deliberately absent from the query key. The key is\n * the identity of the query being walked, and the cursor is a position inside\n * it; keying on it made every page a different query, which is precisely why\n * advancing replaced the rows instead of extending them. Every other filter\n * stays in the key, so any filter, parameter or time-range change starts a new\n * walk on its own, with no reset logic layered on top.\n */\nexport function useOperationPages({\n  client,\n  endpoint,\n  parameters,\n  filters,\n  paginationMode,\n}: OperationPagesOptions): OperationPages {\n  const queryClient = useQueryClient();\n  const cursorParam = cursorParameterName(parameters);\n  const path = endpoint?.path;\n  const method = endpoint?.method;\n  if (endpoint && paginationMode === \"infinite\" && !cursorParam) {\n    throw new Error(\n      `Operation ${method?.toUpperCase()} ${path} cannot use infinite pagination without a cursor parameter`,\n    );\n  }\n  const walkMode = paginationMode === \"infinite\" || (paginationMode === undefined && !!cursorParam);\n\n  // The walk's own view of the filters: everything that identifies the query,\n  // with the position taken out. A cursor left over in the URL from a shared\n  // link names a position in a walk this session never made, so it is dropped\n  // rather than replayed.\n  const walkFilters = useMemo(() => {\n    if (!cursorParam) return filters;\n    const rest = { ...filters };\n    delete rest[cursorParam];\n    return rest;\n  }, [cursorParam, filters]);\n\n  const execute = useCallback(\n    (values: ParameterValues) =>\n      client.executeCommand(\n        path!,\n        method!,\n        packParameterValues(values, parameters),\n        CLICKY_HEADERS,\n      ),\n    [client, method, parameters, path],\n  );\n\n  // Both queries are declared on every render — hooks are not conditional — and\n  // exactly one is enabled. Their keys differ in shape as well as content, so a\n  // surface that switches modes can never read a page array as a page.\n  const single = useQuery<ExecutionResponse>({\n    queryKey: [LIST_KEY, method, path, filters],\n    queryFn: () => execute(filters),\n    enabled: !!endpoint && !walkMode,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  // Prefixed with the same LIST_KEY as the single-page query: host apps\n  // invalidate [\"operation-list\"] after a mutation, and a walk that fell\n  // outside that prefix would keep serving rows the mutation changed.\n  const walkKey = useMemo(\n    () => [LIST_KEY, \"walk\", method, path, walkFilters],\n    [method, path, walkFilters],\n  );\n\n  const walk = useInfiniteQuery<\n    ExecutionResponse,\n    Error,\n    InfiniteData<ExecutionResponse, string | undefined>,\n    QueryKey,\n    string | undefined\n  >({\n    queryKey: walkKey,\n    queryFn: ({ pageParam }) =>\n      execute(pageParam ? { ...walkFilters, [cursorParam!]: pageParam } : walkFilters),\n    initialPageParam: undefined,\n    // The server's two answers, both required: it has more, and here is where\n    // to resume. A page claiming more without minting a token cannot be walked,\n    // and guessing one is how a client forges a position it was never given.\n    getNextPageParam: (lastPage) =>\n      lastPage.pagination?.hasMore ? lastPage.pagination.nextCursor : undefined,\n    enabled: !!endpoint && walkMode,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const walkPages = walk.data?.pages;\n\n  // A cursor the server refuses is recoverable by construction: the query is\n  // fine and only the position is gone, so the walk starts again instead of\n  // stranding the reader on an error panel they cannot page out of. Resetting\n  // is what does it — refetching would replay the very cursors that were\n  // refused, page by page.\n  //\n  // Guarded on a page having already been fetched, because only then can a\n  // cursor have been sent. A first page refused this way is a server that\n  // answers `cursor_stale` to a request carrying no cursor, and restarting on\n  // that spins: refuse, restart, refuse.\n  const staleWalk = isCursorStale(walk.error) && (walkPages?.length ?? 0) > 0;\n\n  useEffect(() => {\n    if (!staleWalk) return;\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, staleWalk, walkKey]);\n\n  const fetchNextPage = walk.fetchNextPage;\n  const infinite = useMemo<DataTableInfinite | undefined>(() => {\n    if (!walkMode || !cursorParam) return undefined;\n    return {\n      hasMore: walk.hasNextPage,\n      loading: walk.isFetchingNextPage,\n      onLoadMore: () => void fetchNextPage(),\n    };\n  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage, walkMode]);\n\n  const resetWalk = useCallback(() => {\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, walkKey]);\n  const refetchSingle = single.refetch;\n\n  if (!walkMode) {\n    return {\n      pages: single.data ? [single.data] : [],\n      response: single.data ?? null,\n      isFetching: single.isFetching,\n      isPending: single.isPending,\n      isError: single.isError,\n      error: single.error,\n      refetch: () => void refetchSingle(),\n    };\n  }\n\n  const pages = walkPages ?? [];\n  return {\n    pages,\n    response: pages[pages.length - 1] ?? null,\n    // Fetching the next page grows the run; it does not replace it. Reporting\n    // it as a load of the whole surface is what drops a spinner over rows the\n    // reader is still reading.\n    isFetching: walk.isFetching && !walk.isFetchingNextPage,\n    isPending: walk.isPending,\n    isError: walk.isError && !staleWalk,\n    error: staleWalk ? undefined : walk.error,\n    // A mutation just changed the rows this walk was cut from, so its cursors\n    // no longer name positions in it. Starting over is the only honest refetch.\n    refetch: resetWalk,\n    ...(infinite ? { infinite } : {}),\n  };\n}\n"],"names":["useQueryClient","cursorParameterName","useMemo","useCallback","packParameterValues","useQuery","keepPreviousData","useInfiniteQuery","_a","isCursorStale","useEffect"],"mappings":"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"}
+{"version":3,"file":"useOperationPages.cjs","sources":["../../src/rpc/useOperationPages.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo } from \"react\";\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useQuery,\n  useQueryClient,\n  type InfiniteData,\n  type QueryKey,\n} from \"@tanstack/react-query\";\n\nimport type { DataTableInfinite } from \"../data/DataTable\";\nimport { cursorParameterName, isCursorStale } from \"./cursorStale\";\nimport { packParameterValues, type ParameterValues } from \"./formMetadata\";\nimport type {\n  ExecutionResponse,\n  OpenAPIParameter,\n  ResolvedOperation,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\nconst LIST_KEY = \"operation-list\";\nconst CLICKY_HEADERS = { Accept: \"application/json+clicky\" };\n\nexport type OperationPagesOptions = {\n  client: OperationsApiClient;\n  /** The list operation, or undefined for a surface that has none. */\n  endpoint: ResolvedOperation | undefined;\n  /** Every parameter the operation declares — the source of the cursor role. */\n  parameters: OpenAPIParameter[];\n  /** Current filter/pagination state, as the catalog holds and URL-mirrors it. */\n  filters: ParameterValues;\n  /** Omit to infer a cursor walk from the operation; hosts may force either presentation. */\n  paginationMode?: \"paged\" | \"infinite\";\n  /** Poll the current server page while it can change, in milliseconds. */\n  refreshIntervalMs?: number;\n};\n\nexport type OperationPages = {\n  /** Every page fetched so far, oldest first. One entry outside a walk. */\n  pages: ExecutionResponse[];\n  /** The newest page — what every renderer means by \"the response\". */\n  response: ExecutionResponse | null;\n  /** True while the whole result is being replaced, not while it is growing. */\n  isFetching: boolean;\n  isPending: boolean;\n  isError: boolean;\n  error: unknown;\n  /** Re-runs the list. A walk restarts rather than replaying its cursors. */\n  refetch: () => void;\n  /** Load-more handle; absent unless the operation can walk by cursor. */\n  infinite?: DataTableInfinite;\n};\n\n/**\n * useOperationPages runs a surface's list operation, walking it forward when it\n * declares a cursor and fetching a single page when it does not. A host can\n * explicitly keep a cursor-capable operation paged when readers need offset\n * controls; omission retains automatic selection.\n *\n * Automatic mode follows the operation: a cursor role is the server saying\n * \"you may resume this query\", and everything else keeps the single-page query\n * it has always had. An explicit host override changes only the presentation;\n * the operation still owns the available cursor and offset capabilities.\n *\n * In walk mode the cursor is deliberately absent from the query key. The key is\n * the identity of the query being walked, and the cursor is a position inside\n * it; keying on it made every page a different query, which is precisely why\n * advancing replaced the rows instead of extending them. Every other filter\n * stays in the key, so any filter, parameter or time-range change starts a new\n * walk on its own, with no reset logic layered on top.\n */\nexport function useOperationPages({\n  client,\n  endpoint,\n  parameters,\n  filters,\n  paginationMode,\n  refreshIntervalMs,\n}: OperationPagesOptions): OperationPages {\n  const queryClient = useQueryClient();\n  const cursorParam = cursorParameterName(parameters);\n  const path = endpoint?.path;\n  const method = endpoint?.method;\n  if (endpoint && paginationMode === \"infinite\" && !cursorParam) {\n    throw new Error(\n      `Operation ${method?.toUpperCase()} ${path} cannot use infinite pagination without a cursor parameter`,\n    );\n  }\n  const walkMode = paginationMode === \"infinite\" || (paginationMode === undefined && !!cursorParam);\n  if (refreshIntervalMs !== undefined && (!Number.isFinite(refreshIntervalMs) || refreshIntervalMs <= 0 || walkMode)) {\n    throw new Error(\"Operation page refresh requires a positive interval and paged mode\");\n  }\n\n  // The walk's own view of the filters: everything that identifies the query,\n  // with the position taken out. A cursor left over in the URL from a shared\n  // link names a position in a walk this session never made, so it is dropped\n  // rather than replayed.\n  const walkFilters = useMemo(() => {\n    if (!cursorParam) return filters;\n    const rest = { ...filters };\n    delete rest[cursorParam];\n    return rest;\n  }, [cursorParam, filters]);\n\n  const execute = useCallback(\n    (values: ParameterValues) =>\n      client.executeCommand(\n        path!,\n        method!,\n        packParameterValues(values, parameters),\n        CLICKY_HEADERS,\n      ),\n    [client, method, parameters, path],\n  );\n\n  // Both queries are declared on every render — hooks are not conditional — and\n  // exactly one is enabled. Their keys differ in shape as well as content, so a\n  // surface that switches modes can never read a page array as a page.\n  const single = useQuery<ExecutionResponse>({\n    queryKey: [LIST_KEY, method, path, filters],\n    queryFn: () => execute(filters),\n    enabled: !!endpoint && !walkMode,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    ...(refreshIntervalMs !== undefined ? { refetchInterval: refreshIntervalMs } : {}),\n    retry: 0,\n  });\n\n  // Prefixed with the same LIST_KEY as the single-page query: host apps\n  // invalidate [\"operation-list\"] after a mutation, and a walk that fell\n  // outside that prefix would keep serving rows the mutation changed.\n  const walkKey = useMemo(\n    () => [LIST_KEY, \"walk\", method, path, walkFilters],\n    [method, path, walkFilters],\n  );\n\n  const walk = useInfiniteQuery<\n    ExecutionResponse,\n    Error,\n    InfiniteData<ExecutionResponse, string | undefined>,\n    QueryKey,\n    string | undefined\n  >({\n    queryKey: walkKey,\n    queryFn: ({ pageParam }) =>\n      execute(pageParam ? { ...walkFilters, [cursorParam!]: pageParam } : walkFilters),\n    initialPageParam: undefined,\n    // The server's two answers, both required: it has more, and here is where\n    // to resume. A page claiming more without minting a token cannot be walked,\n    // and guessing one is how a client forges a position it was never given.\n    getNextPageParam: (lastPage) =>\n      lastPage.pagination?.hasMore ? lastPage.pagination.nextCursor : undefined,\n    enabled: !!endpoint && walkMode,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const walkPages = walk.data?.pages;\n\n  // A cursor the server refuses is recoverable by construction: the query is\n  // fine and only the position is gone, so the walk starts again instead of\n  // stranding the reader on an error panel they cannot page out of. Resetting\n  // is what does it — refetching would replay the very cursors that were\n  // refused, page by page.\n  //\n  // Guarded on a page having already been fetched, because only then can a\n  // cursor have been sent. A first page refused this way is a server that\n  // answers `cursor_stale` to a request carrying no cursor, and restarting on\n  // that spins: refuse, restart, refuse.\n  const staleWalk = isCursorStale(walk.error) && (walkPages?.length ?? 0) > 0;\n\n  useEffect(() => {\n    if (!staleWalk) return;\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, staleWalk, walkKey]);\n\n  const fetchNextPage = walk.fetchNextPage;\n  const infinite = useMemo<DataTableInfinite | undefined>(() => {\n    if (!walkMode || !cursorParam) return undefined;\n    return {\n      hasMore: walk.hasNextPage,\n      loading: walk.isFetchingNextPage,\n      onLoadMore: () => void fetchNextPage(),\n    };\n  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage, walkMode]);\n\n  const resetWalk = useCallback(() => {\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, walkKey]);\n  const refetchSingle = single.refetch;\n\n  if (!walkMode) {\n    return {\n      pages: single.data ? [single.data] : [],\n      response: single.data ?? null,\n      isFetching: single.isFetching,\n      isPending: single.isPending,\n      isError: single.isError,\n      error: single.error,\n      refetch: () => void refetchSingle(),\n    };\n  }\n\n  const pages = walkPages ?? [];\n  return {\n    pages,\n    response: pages[pages.length - 1] ?? null,\n    // Fetching the next page grows the run; it does not replace it. Reporting\n    // it as a load of the whole surface is what drops a spinner over rows the\n    // reader is still reading.\n    isFetching: walk.isFetching && !walk.isFetchingNextPage,\n    isPending: walk.isPending,\n    isError: walk.isError && !staleWalk,\n    error: staleWalk ? undefined : walk.error,\n    // A mutation just changed the rows this walk was cut from, so its cursors\n    // no longer name positions in it. Starting over is the only honest refetch.\n    refetch: resetWalk,\n    ...(infinite ? { infinite } : {}),\n  };\n}\n"],"names":["useQueryClient","cursorParameterName","useMemo","useCallback","packParameterValues","useQuery","keepPreviousData","useInfiniteQuery","_a","isCursorStale","useEffect"],"mappings":"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"}

package/dist/rpc/useOperationPages.d.ts

@@ -12,6 +12,8 @@ export type OperationPagesOptions = {
     filters: ParameterValues;
     /** Omit to infer a cursor walk from the operation; hosts may force either presentation. */
     paginationMode?: "paged" | "infinite";
+    /** Poll the current server page while it can change, in milliseconds. */
+    refreshIntervalMs?: number;
 };
 export type OperationPages = {
     /** Every page fetched so far, oldest first. One entry outside a walk. */
@@ -46,5 +48,5 @@ export type OperationPages = {
  * stays in the key, so any filter, parameter or time-range change starts a new
  * walk on its own, with no reset logic layered on top.
  */
-export declare function useOperationPages({ client, endpoint, parameters, filters, paginationMode, }: OperationPagesOptions): OperationPages;
+export declare function useOperationPages({ client, endpoint, parameters, filters, paginationMode, refreshIntervalMs, }: OperationPagesOptions): OperationPages;
 //# sourceMappingURL=useOperationPages.d.ts.map

package/dist/rpc/useOperationPages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationPages.d.ts","sourceRoot":"","sources":["../../src/rpc/useOperationPages.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAK3D,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,8EAA8E;IAC9E,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,gFAAgF;IAChF,OAAO,EAAE,eAAe,CAAC;IACzB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,yEAAyE;IACzE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,OAAO,EACP,cAAc,GACf,EAAE,qBAAqB,GAAG,cAAc,CA0IxC"}
+{"version":3,"file":"useOperationPages.d.ts","sourceRoot":"","sources":["../../src/rpc/useOperationPages.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAK3D,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,8EAA8E;IAC9E,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,gFAAgF;IAChF,OAAO,EAAE,eAAe,CAAC;IACzB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACtC,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,yEAAyE;IACzE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,OAAO,EACP,cAAc,EACd,iBAAiB,GAClB,EAAE,qBAAqB,GAAG,cAAc,CA8IxC"}

package/dist/rpc/useOperationPages.js

@@ -9,7 +9,8 @@ function useOperationPages({
   endpoint,
   parameters,
   filters,
-  paginationMode
+  paginationMode,
+  refreshIntervalMs
 }) {
   var _a;
   const queryClient = useQueryClient();
@@ -22,6 +23,9 @@ function useOperationPages({
     );
   }
   const walkMode = paginationMode === "infinite" || paginationMode === void 0 && !!cursorParam;
+  if (refreshIntervalMs !== void 0 && (!Number.isFinite(refreshIntervalMs) || refreshIntervalMs <= 0 || walkMode)) {
+    throw new Error("Operation page refresh requires a positive interval and paged mode");
+  }
   const walkFilters = useMemo(() => {
     if (!cursorParam) return filters;
     const rest = { ...filters };
@@ -43,6 +47,7 @@ function useOperationPages({
     enabled: !!endpoint && !walkMode,
     placeholderData: keepPreviousData,
     staleTime: 3e4,
+    ...refreshIntervalMs !== void 0 ? { refetchInterval: refreshIntervalMs } : {},
     retry: 0
   });
   const walkKey = useMemo(

package/dist/rpc/useOperationPages.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationPages.js","sources":["../../src/rpc/useOperationPages.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo } from \"react\";\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useQuery,\n  useQueryClient,\n  type InfiniteData,\n  type QueryKey,\n} from \"@tanstack/react-query\";\n\nimport type { DataTableInfinite } from \"../data/DataTable\";\nimport { cursorParameterName, isCursorStale } from \"./cursorStale\";\nimport { packParameterValues, type ParameterValues } from \"./formMetadata\";\nimport type {\n  ExecutionResponse,\n  OpenAPIParameter,\n  ResolvedOperation,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\nconst LIST_KEY = \"operation-list\";\nconst CLICKY_HEADERS = { Accept: \"application/json+clicky\" };\n\nexport type OperationPagesOptions = {\n  client: OperationsApiClient;\n  /** The list operation, or undefined for a surface that has none. */\n  endpoint: ResolvedOperation | undefined;\n  /** Every parameter the operation declares — the source of the cursor role. */\n  parameters: OpenAPIParameter[];\n  /** Current filter/pagination state, as the catalog holds and URL-mirrors it. */\n  filters: ParameterValues;\n  /** Omit to infer a cursor walk from the operation; hosts may force either presentation. */\n  paginationMode?: \"paged\" | \"infinite\";\n};\n\nexport type OperationPages = {\n  /** Every page fetched so far, oldest first. One entry outside a walk. */\n  pages: ExecutionResponse[];\n  /** The newest page — what every renderer means by \"the response\". */\n  response: ExecutionResponse | null;\n  /** True while the whole result is being replaced, not while it is growing. */\n  isFetching: boolean;\n  isPending: boolean;\n  isError: boolean;\n  error: unknown;\n  /** Re-runs the list. A walk restarts rather than replaying its cursors. */\n  refetch: () => void;\n  /** Load-more handle; absent unless the operation can walk by cursor. */\n  infinite?: DataTableInfinite;\n};\n\n/**\n * useOperationPages runs a surface's list operation, walking it forward when it\n * declares a cursor and fetching a single page when it does not. A host can\n * explicitly keep a cursor-capable operation paged when readers need offset\n * controls; omission retains automatic selection.\n *\n * Automatic mode follows the operation: a cursor role is the server saying\n * \"you may resume this query\", and everything else keeps the single-page query\n * it has always had. An explicit host override changes only the presentation;\n * the operation still owns the available cursor and offset capabilities.\n *\n * In walk mode the cursor is deliberately absent from the query key. The key is\n * the identity of the query being walked, and the cursor is a position inside\n * it; keying on it made every page a different query, which is precisely why\n * advancing replaced the rows instead of extending them. Every other filter\n * stays in the key, so any filter, parameter or time-range change starts a new\n * walk on its own, with no reset logic layered on top.\n */\nexport function useOperationPages({\n  client,\n  endpoint,\n  parameters,\n  filters,\n  paginationMode,\n}: OperationPagesOptions): OperationPages {\n  const queryClient = useQueryClient();\n  const cursorParam = cursorParameterName(parameters);\n  const path = endpoint?.path;\n  const method = endpoint?.method;\n  if (endpoint && paginationMode === \"infinite\" && !cursorParam) {\n    throw new Error(\n      `Operation ${method?.toUpperCase()} ${path} cannot use infinite pagination without a cursor parameter`,\n    );\n  }\n  const walkMode = paginationMode === \"infinite\" || (paginationMode === undefined && !!cursorParam);\n\n  // The walk's own view of the filters: everything that identifies the query,\n  // with the position taken out. A cursor left over in the URL from a shared\n  // link names a position in a walk this session never made, so it is dropped\n  // rather than replayed.\n  const walkFilters = useMemo(() => {\n    if (!cursorParam) return filters;\n    const rest = { ...filters };\n    delete rest[cursorParam];\n    return rest;\n  }, [cursorParam, filters]);\n\n  const execute = useCallback(\n    (values: ParameterValues) =>\n      client.executeCommand(\n        path!,\n        method!,\n        packParameterValues(values, parameters),\n        CLICKY_HEADERS,\n      ),\n    [client, method, parameters, path],\n  );\n\n  // Both queries are declared on every render — hooks are not conditional — and\n  // exactly one is enabled. Their keys differ in shape as well as content, so a\n  // surface that switches modes can never read a page array as a page.\n  const single = useQuery<ExecutionResponse>({\n    queryKey: [LIST_KEY, method, path, filters],\n    queryFn: () => execute(filters),\n    enabled: !!endpoint && !walkMode,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  // Prefixed with the same LIST_KEY as the single-page query: host apps\n  // invalidate [\"operation-list\"] after a mutation, and a walk that fell\n  // outside that prefix would keep serving rows the mutation changed.\n  const walkKey = useMemo(\n    () => [LIST_KEY, \"walk\", method, path, walkFilters],\n    [method, path, walkFilters],\n  );\n\n  const walk = useInfiniteQuery<\n    ExecutionResponse,\n    Error,\n    InfiniteData<ExecutionResponse, string | undefined>,\n    QueryKey,\n    string | undefined\n  >({\n    queryKey: walkKey,\n    queryFn: ({ pageParam }) =>\n      execute(pageParam ? { ...walkFilters, [cursorParam!]: pageParam } : walkFilters),\n    initialPageParam: undefined,\n    // The server's two answers, both required: it has more, and here is where\n    // to resume. A page claiming more without minting a token cannot be walked,\n    // and guessing one is how a client forges a position it was never given.\n    getNextPageParam: (lastPage) =>\n      lastPage.pagination?.hasMore ? lastPage.pagination.nextCursor : undefined,\n    enabled: !!endpoint && walkMode,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const walkPages = walk.data?.pages;\n\n  // A cursor the server refuses is recoverable by construction: the query is\n  // fine and only the position is gone, so the walk starts again instead of\n  // stranding the reader on an error panel they cannot page out of. Resetting\n  // is what does it — refetching would replay the very cursors that were\n  // refused, page by page.\n  //\n  // Guarded on a page having already been fetched, because only then can a\n  // cursor have been sent. A first page refused this way is a server that\n  // answers `cursor_stale` to a request carrying no cursor, and restarting on\n  // that spins: refuse, restart, refuse.\n  const staleWalk = isCursorStale(walk.error) && (walkPages?.length ?? 0) > 0;\n\n  useEffect(() => {\n    if (!staleWalk) return;\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, staleWalk, walkKey]);\n\n  const fetchNextPage = walk.fetchNextPage;\n  const infinite = useMemo<DataTableInfinite | undefined>(() => {\n    if (!walkMode || !cursorParam) return undefined;\n    return {\n      hasMore: walk.hasNextPage,\n      loading: walk.isFetchingNextPage,\n      onLoadMore: () => void fetchNextPage(),\n    };\n  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage, walkMode]);\n\n  const resetWalk = useCallback(() => {\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, walkKey]);\n  const refetchSingle = single.refetch;\n\n  if (!walkMode) {\n    return {\n      pages: single.data ? [single.data] : [],\n      response: single.data ?? null,\n      isFetching: single.isFetching,\n      isPending: single.isPending,\n      isError: single.isError,\n      error: single.error,\n      refetch: () => void refetchSingle(),\n    };\n  }\n\n  const pages = walkPages ?? [];\n  return {\n    pages,\n    response: pages[pages.length - 1] ?? null,\n    // Fetching the next page grows the run; it does not replace it. Reporting\n    // it as a load of the whole surface is what drops a spinner over rows the\n    // reader is still reading.\n    isFetching: walk.isFetching && !walk.isFetchingNextPage,\n    isPending: walk.isPending,\n    isError: walk.isError && !staleWalk,\n    error: staleWalk ? undefined : walk.error,\n    // A mutation just changed the rows this walk was cut from, so its cursors\n    // no longer name positions in it. Starting over is the only honest refetch.\n    refetch: resetWalk,\n    ...(infinite ? { infinite } : {}),\n  };\n}\n"],"names":["_a"],"mappings":"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"}
+{"version":3,"file":"useOperationPages.js","sources":["../../src/rpc/useOperationPages.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo } from \"react\";\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useQuery,\n  useQueryClient,\n  type InfiniteData,\n  type QueryKey,\n} from \"@tanstack/react-query\";\n\nimport type { DataTableInfinite } from \"../data/DataTable\";\nimport { cursorParameterName, isCursorStale } from \"./cursorStale\";\nimport { packParameterValues, type ParameterValues } from \"./formMetadata\";\nimport type {\n  ExecutionResponse,\n  OpenAPIParameter,\n  ResolvedOperation,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\nconst LIST_KEY = \"operation-list\";\nconst CLICKY_HEADERS = { Accept: \"application/json+clicky\" };\n\nexport type OperationPagesOptions = {\n  client: OperationsApiClient;\n  /** The list operation, or undefined for a surface that has none. */\n  endpoint: ResolvedOperation | undefined;\n  /** Every parameter the operation declares — the source of the cursor role. */\n  parameters: OpenAPIParameter[];\n  /** Current filter/pagination state, as the catalog holds and URL-mirrors it. */\n  filters: ParameterValues;\n  /** Omit to infer a cursor walk from the operation; hosts may force either presentation. */\n  paginationMode?: \"paged\" | \"infinite\";\n  /** Poll the current server page while it can change, in milliseconds. */\n  refreshIntervalMs?: number;\n};\n\nexport type OperationPages = {\n  /** Every page fetched so far, oldest first. One entry outside a walk. */\n  pages: ExecutionResponse[];\n  /** The newest page — what every renderer means by \"the response\". */\n  response: ExecutionResponse | null;\n  /** True while the whole result is being replaced, not while it is growing. */\n  isFetching: boolean;\n  isPending: boolean;\n  isError: boolean;\n  error: unknown;\n  /** Re-runs the list. A walk restarts rather than replaying its cursors. */\n  refetch: () => void;\n  /** Load-more handle; absent unless the operation can walk by cursor. */\n  infinite?: DataTableInfinite;\n};\n\n/**\n * useOperationPages runs a surface's list operation, walking it forward when it\n * declares a cursor and fetching a single page when it does not. A host can\n * explicitly keep a cursor-capable operation paged when readers need offset\n * controls; omission retains automatic selection.\n *\n * Automatic mode follows the operation: a cursor role is the server saying\n * \"you may resume this query\", and everything else keeps the single-page query\n * it has always had. An explicit host override changes only the presentation;\n * the operation still owns the available cursor and offset capabilities.\n *\n * In walk mode the cursor is deliberately absent from the query key. The key is\n * the identity of the query being walked, and the cursor is a position inside\n * it; keying on it made every page a different query, which is precisely why\n * advancing replaced the rows instead of extending them. Every other filter\n * stays in the key, so any filter, parameter or time-range change starts a new\n * walk on its own, with no reset logic layered on top.\n */\nexport function useOperationPages({\n  client,\n  endpoint,\n  parameters,\n  filters,\n  paginationMode,\n  refreshIntervalMs,\n}: OperationPagesOptions): OperationPages {\n  const queryClient = useQueryClient();\n  const cursorParam = cursorParameterName(parameters);\n  const path = endpoint?.path;\n  const method = endpoint?.method;\n  if (endpoint && paginationMode === \"infinite\" && !cursorParam) {\n    throw new Error(\n      `Operation ${method?.toUpperCase()} ${path} cannot use infinite pagination without a cursor parameter`,\n    );\n  }\n  const walkMode = paginationMode === \"infinite\" || (paginationMode === undefined && !!cursorParam);\n  if (refreshIntervalMs !== undefined && (!Number.isFinite(refreshIntervalMs) || refreshIntervalMs <= 0 || walkMode)) {\n    throw new Error(\"Operation page refresh requires a positive interval and paged mode\");\n  }\n\n  // The walk's own view of the filters: everything that identifies the query,\n  // with the position taken out. A cursor left over in the URL from a shared\n  // link names a position in a walk this session never made, so it is dropped\n  // rather than replayed.\n  const walkFilters = useMemo(() => {\n    if (!cursorParam) return filters;\n    const rest = { ...filters };\n    delete rest[cursorParam];\n    return rest;\n  }, [cursorParam, filters]);\n\n  const execute = useCallback(\n    (values: ParameterValues) =>\n      client.executeCommand(\n        path!,\n        method!,\n        packParameterValues(values, parameters),\n        CLICKY_HEADERS,\n      ),\n    [client, method, parameters, path],\n  );\n\n  // Both queries are declared on every render — hooks are not conditional — and\n  // exactly one is enabled. Their keys differ in shape as well as content, so a\n  // surface that switches modes can never read a page array as a page.\n  const single = useQuery<ExecutionResponse>({\n    queryKey: [LIST_KEY, method, path, filters],\n    queryFn: () => execute(filters),\n    enabled: !!endpoint && !walkMode,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    ...(refreshIntervalMs !== undefined ? { refetchInterval: refreshIntervalMs } : {}),\n    retry: 0,\n  });\n\n  // Prefixed with the same LIST_KEY as the single-page query: host apps\n  // invalidate [\"operation-list\"] after a mutation, and a walk that fell\n  // outside that prefix would keep serving rows the mutation changed.\n  const walkKey = useMemo(\n    () => [LIST_KEY, \"walk\", method, path, walkFilters],\n    [method, path, walkFilters],\n  );\n\n  const walk = useInfiniteQuery<\n    ExecutionResponse,\n    Error,\n    InfiniteData<ExecutionResponse, string | undefined>,\n    QueryKey,\n    string | undefined\n  >({\n    queryKey: walkKey,\n    queryFn: ({ pageParam }) =>\n      execute(pageParam ? { ...walkFilters, [cursorParam!]: pageParam } : walkFilters),\n    initialPageParam: undefined,\n    // The server's two answers, both required: it has more, and here is where\n    // to resume. A page claiming more without minting a token cannot be walked,\n    // and guessing one is how a client forges a position it was never given.\n    getNextPageParam: (lastPage) =>\n      lastPage.pagination?.hasMore ? lastPage.pagination.nextCursor : undefined,\n    enabled: !!endpoint && walkMode,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const walkPages = walk.data?.pages;\n\n  // A cursor the server refuses is recoverable by construction: the query is\n  // fine and only the position is gone, so the walk starts again instead of\n  // stranding the reader on an error panel they cannot page out of. Resetting\n  // is what does it — refetching would replay the very cursors that were\n  // refused, page by page.\n  //\n  // Guarded on a page having already been fetched, because only then can a\n  // cursor have been sent. A first page refused this way is a server that\n  // answers `cursor_stale` to a request carrying no cursor, and restarting on\n  // that spins: refuse, restart, refuse.\n  const staleWalk = isCursorStale(walk.error) && (walkPages?.length ?? 0) > 0;\n\n  useEffect(() => {\n    if (!staleWalk) return;\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, staleWalk, walkKey]);\n\n  const fetchNextPage = walk.fetchNextPage;\n  const infinite = useMemo<DataTableInfinite | undefined>(() => {\n    if (!walkMode || !cursorParam) return undefined;\n    return {\n      hasMore: walk.hasNextPage,\n      loading: walk.isFetchingNextPage,\n      onLoadMore: () => void fetchNextPage(),\n    };\n  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage, walkMode]);\n\n  const resetWalk = useCallback(() => {\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, walkKey]);\n  const refetchSingle = single.refetch;\n\n  if (!walkMode) {\n    return {\n      pages: single.data ? [single.data] : [],\n      response: single.data ?? null,\n      isFetching: single.isFetching,\n      isPending: single.isPending,\n      isError: single.isError,\n      error: single.error,\n      refetch: () => void refetchSingle(),\n    };\n  }\n\n  const pages = walkPages ?? [];\n  return {\n    pages,\n    response: pages[pages.length - 1] ?? null,\n    // Fetching the next page grows the run; it does not replace it. Reporting\n    // it as a load of the whole surface is what drops a spinner over rows the\n    // reader is still reading.\n    isFetching: walk.isFetching && !walk.isFetchingNextPage,\n    isPending: walk.isPending,\n    isError: walk.isError && !staleWalk,\n    error: staleWalk ? undefined : walk.error,\n    // A mutation just changed the rows this walk was cut from, so its cursors\n    // no longer name positions in it. Starting over is the only honest refetch.\n    refetch: resetWalk,\n    ...(infinite ? { infinite } : {}),\n  };\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/rpc.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const OperationCatalog = require("./rpc/OperationCatalog.cjs");
+const OperationEntityPicker = require("./rpc/OperationEntityPicker.cjs");
 const SessionsCatalog = require("./rpc/SessionsCatalog.cjs");
 const SessionHeader = require("./rpc/SessionHeader.cjs");
 const useSession = require("./rpc/useSession.cjs");
@@ -38,6 +39,7 @@ const router = require("./rpc/router.cjs");
 const RouterProvider = require("./rpc/RouterProvider.cjs");
 const types = require("./rpc/types.cjs");
 exports.OperationCatalog = OperationCatalog.OperationCatalog;
+exports.OperationEntityPicker = OperationEntityPicker.OperationEntityPicker;
 exports.SESSIONS_SURFACE_KEY = SessionsCatalog.SESSIONS_SURFACE_KEY;
 exports.SessionsCatalog = SessionsCatalog.SessionsCatalog;
 exports.SessionHeader = SessionHeader.SessionHeader;

package/dist/rpc.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"rpc.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/rpc.d.ts

@@ -1,4 +1,6 @@
 export { OperationCatalog, type OperationCatalogProps, } from './rpc/OperationCatalog.js';
+export type { OperationCatalogRowSelection, OperationCatalogRowSelectionContext, OperationCatalogRowSelectionMode, OperationCatalogUnavailableRows, } from './rpc/operationCatalogRowSelection.js';
+export { OperationEntityPicker, type OperationEntityPickerProps, } from './rpc/OperationEntityPicker.js';
 export { SESSIONS_SURFACE_KEY, SessionsCatalog, type SessionsCatalogProps, } from './rpc/SessionsCatalog.js';
 export { SessionHeader, type SessionConfirmRenderArgs, type SessionHeaderProps, } from './rpc/SessionHeader.js';
 export { SESSION_POLL_MS, useSession, type SessionAction, type UseSessionOptions, type UseSessionResult, } from './rpc/useSession.js';

package/dist/rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,4BAA4B,EAC5B,mCAAmC,EACnC,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mCAAmC,EACnC,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,GAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,4BAA4B,EAC5B,KAAK,iCAAiC,EACtC,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,GACvC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,wBAAwB,GACzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EACL,KAAK,aAAa,EAClB,SAAS,EACT,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC"}

package/dist/rpc.js

@@ -1,4 +1,5 @@
 import { OperationCatalog } from "./rpc/OperationCatalog.js";
+import { OperationEntityPicker } from "./rpc/OperationEntityPicker.js";
 import { SESSIONS_SURFACE_KEY, SessionsCatalog } from "./rpc/SessionsCatalog.js";
 import { SessionHeader } from "./rpc/SessionHeader.js";
 import { SESSION_POLL_MS, useSession } from "./rpc/useSession.js";
@@ -51,6 +52,7 @@ export {
   OperationCommandPage,
   OperationEntityContextPicker,
   OperationEntityPage,
+  OperationEntityPicker,
   OperationPicker,
   OperationResultView,
   OperationScheduleDialog,

package/dist/rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"rpc.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}