@flanksource/clicky-ui 0.3.21 → 0.3.23

package/dist/rpc/OperationCatalog.js

@@ -1,25 +1,23 @@
-import { jsxs, jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { useMemo, useState, useEffect, useCallback } from "react";
 import { createPortal } from "react-dom";
 import { useQuery, keepPreviousData } from "@tanstack/react-query";
+import { useOperationPages } from "./useOperationPages.js";
 import { filterOperationsByDomain } from "./classify.js";
 import { filterOperationsBySurface, findSurfaceListOperation, findSurfaceDetailOperation, findSurfaceCollectionActions, getOperationClickyMeta } from "./clickyMetadata.js";
 import { EndpointList } from "./EndpointList.js";
 import { OperationActionBar } from "./OperationActionBar.js";
+import { OperationsApiClientError } from "./apiClient.js";
+import { renderOperationError } from "./operationErrorDiagnostics.js";
 import { OperationResultView } from "./OperationResultView.js";
 import { applyFilterExtensions } from "../components/filter-bar-utils.js";
 import { useOperations } from "./useOperations.js";
-import { packParameterValues, parametersToFormConfig, dataTablePaginationFromForm } from "./formMetadata.js";
+import { packLookupParameterValues, parametersToFormConfig, dataTablePaginationFromForm } from "./formMetadata.js";
+import { useCursorStaleRecovery, cursorParameterName } from "./cursorStale.js";
 import { useOperationFilterSearch } from "./operationFilterSearch.js";
 import { parseMultiFilterValue, serializeMultiFilterValue } from "../data/data-table-filter-values.js";
+import { Loading } from "../components/loading.js";
 const defaultCommandHref = (operationId) => `/commands/${operationId}`;
-function defaultRenderError(err, title) {
-  const message = err instanceof Error ? err.message : String(err ?? "");
-  return /* @__PURE__ */ jsxs("div", { className: "rounded-xl border border-destructive/40 bg-destructive/5 p-4 text-sm text-destructive", children: [
-    /* @__PURE__ */ jsx("div", { className: "font-medium", children: title }),
-    message && /* @__PURE__ */ jsx("div", { className: "mt-1 whitespace-pre-wrap text-xs opacity-80", children: message })
-  ] });
-}
 function OperationCatalog({
   definition,
   entities,
@@ -29,7 +27,7 @@ function OperationCatalog({
   surfaceKey,
   filterPre,
   getCommandHref = defaultCommandHref,
-  renderError = defaultRenderError,
+  renderError = renderOperationError,
   commandRuntime,
   formPre,
   formPost,
@@ -38,8 +36,9 @@ function OperationCatalog({
   resultRenderer,
   actionsContainer
 }) {
-  var _a, _b;
-  const { operations, isLoading } = useOperations(client);
+  var _a, _b, _c;
+  const { operations, spec, isLoading } = useOperations(client);
+  const filterShapes = (_a = spec == null ? void 0 : spec.components) == null ? void 0 : _a["x-clicky-filters"];
   const surfaceOps = useMemo(
     () => filterOperationsBySurface(operations, surfaceKey),
     [operations, surfaceKey]
@@ -61,6 +60,10 @@ function OperationCatalog({
     () => readFiltersFromUrl()
   );
   const listParameters = (listEndpoint == null ? void 0 : listEndpoint.operation.parameters) ?? [];
+  const lookupParameters = useMemo(
+    () => packLookupParameterValues(filters, listParameters),
+    [filters, listParameters]
+  );
   const download = useMemo(() => {
     var _a2;
     const meta = (_a2 = listEndpoint == null ? void 0 : listEndpoint.operation["x-clicky"]) == null ? void 0 : _a2.export;
@@ -78,32 +81,24 @@ function OperationCatalog({
   useEffect(() => {
     writeFiltersToUrl(filters);
   }, [filters]);
-  const listQuery = useQuery({
-    queryKey: [
-      "operation-list",
-      listEndpoint == null ? void 0 : listEndpoint.method,
-      listEndpoint == null ? void 0 : listEndpoint.path,
-      filters
-    ],
-    queryFn: () => client.executeCommand(
-      listEndpoint.path,
-      listEndpoint.method,
-      packParameterValues(filters, listEndpoint.operation.parameters ?? []),
-      {
-        Accept: "application/json+clicky"
-      }
-    ),
-    enabled: !!listEndpoint,
-    placeholderData: keepPreviousData,
-    staleTime: 3e4,
-    retry: 0
+  const list = useOperationPages({
+    client,
+    endpoint: listEndpoint,
+    parameters: listParameters,
+    filters
+  });
+  useCursorStaleRecovery({
+    error: list.error,
+    parameters: listParameters,
+    values: filters,
+    setValues: setFilters
   });
   const lookupQuery = useQuery({
     queryKey: [
       "operation-lookup",
       listEndpoint == null ? void 0 : listEndpoint.method,
       listEndpoint == null ? void 0 : listEndpoint.path,
-      filters
+      lookupParameters
     ],
     queryFn: async () => {
       var _a2;
@@ -111,11 +106,15 @@ function OperationCatalog({
         client,
         listEndpoint.path,
         listEndpoint.method,
-        packParameterValues(filters, listParameters),
+        lookupParameters,
         { Accept: "application/json+clicky" }
       )) ?? { filters: {} };
     },
     enabled: !!listEndpoint && !!client.lookupFilters,
+    // Options are the answer to "what can this filter be set to now", so the
+    // previous answer stays on screen while the next one is fetched rather than
+    // the dropdowns emptying and refilling on every selection.
+    placeholderData: keepPreviousData,
     staleTime: 3e4,
     retry: 0
   });
@@ -132,16 +131,17 @@ function OperationCatalog({
   const filterBarConfig = useMemo(() => {
     const options = {
       includeLocations: ["query"],
-      lookupSearch
+      lookupSearch,
+      components: filterShapes
     };
     if (lookupQuery.data != null) {
       options.lookup = lookupQuery.data;
     }
     return parametersToFormConfig(listParameters, filters, setFilters, options);
-  }, [filters, listParameters, lookupQuery.data, lookupSearch]);
+  }, [filters, filterShapes, listParameters, lookupQuery.data, lookupSearch]);
   const dataTablePagination = useMemo(
-    () => dataTablePaginationFromForm(filterBarConfig.pagination, listQuery.data),
-    [filterBarConfig.pagination, listQuery.data]
+    () => dataTablePaginationFromForm(filterBarConfig.pagination, list.response),
+    [filterBarConfig.pagination, list.response]
   );
   const decoratedFilters = useMemo(
     () => filterBarConfig.filters.map(
@@ -169,7 +169,9 @@ function OperationCatalog({
           return parameter.name === key && ((_a2 = parameter["x-clicky"]) == null ? void 0 : _a2.role) === "filter";
         }
       )) {
-        throw new Error(`Clicky table column references unknown filter parameter ${key}`);
+        throw new Error(
+          `Clicky table column references unknown filter parameter ${key}`
+        );
       }
       setFilters((current) => {
         const selected = parseMultiFilterValue(current[key] ?? "");
@@ -192,6 +194,8 @@ function OperationCatalog({
           }
         );
         if (offset) next[offset.name] = "0";
+        const cursor = cursorParameterName(listParameters);
+        if (cursor) next[cursor] = "";
         return next;
       });
     },
@@ -215,20 +219,25 @@ function OperationCatalog({
   );
   const showTable = !!listEndpoint;
   let listError;
-  if (!listQuery.isFetching) {
-    if (listQuery.isError) {
-      listError = listQuery.error;
-    } else if (((_a = listQuery.data) == null ? void 0 : _a.success) === false) {
-      listError = new Error(
-        listQuery.data.error || listQuery.data.message || listQuery.data.stderr || `Command failed with exit code ${listQuery.data.exit_code}`
+  if (!list.isFetching) {
+    if (list.isError) {
+      listError = list.error;
+    } else if (((_b = list.response) == null ? void 0 : _b.success) === false) {
+      listError = new OperationsApiClientError(
+        list.response.error || list.response.message || list.response.stderr || `Command failed with exit code ${list.response.exit_code}`,
+        {
+          method: listEndpoint == null ? void 0 : listEndpoint.method,
+          url: list.response.requestUrl,
+          responseBody: list.response.stdout,
+          responseData: list.response.parsed,
+          responseHeaders: list.response.responseHeaders
+        }
       );
     }
   }
-  const tableError = listError !== void 0 ? renderError(
-    listError,
-    `Failed to load ${(listEndpoint == null ? void 0 : listEndpoint.path) ?? ""}`
-  ) : void 0;
-  const tableResponse = ((_b = listQuery.data) == null ? void 0 : _b.success) === false ? null : listQuery.data ?? null;
+  const tableError = listError !== void 0 ? renderError(listError, `Failed to load ${(listEndpoint == null ? void 0 : listEndpoint.path) ?? ""}`) : void 0;
+  const tableResponse = ((_c = list.response) == null ? void 0 : _c.success) === false ? null : list.response;
+  const walkProps = list.infinite ? { pages: list.pages, infinite: list.infinite } : {};
   function getActionLockedValues(op) {
     const meta = getOperationClickyMeta(op);
     if (meta == null || !meta.supportsFilterMode) {
@@ -249,12 +258,8 @@ function OperationCatalog({
     }
     return locked;
   }
-  if (isLoading) {
-    return /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
-      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-10 w-72" }),
-      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-4 w-[32rem]" }),
-      Array.from({ length: 5 }).map((_, i) => /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-12" }, i))
-    ] });
+  if (isLoading || showTable && list.isPending && list.response == null) {
+    return /* @__PURE__ */ jsx(Loading, { variant: "centered", label: `Loading ${definition.title}…` });
   }
   const actionBar = /* @__PURE__ */ jsx(
     OperationActionBar,
@@ -262,7 +267,7 @@ function OperationCatalog({
       actions: actionOps,
       client,
       getLockedValues: getActionLockedValues,
-      onExecuted: () => void listQuery.refetch(),
+      onExecuted: () => list.refetch(),
       ...commandRuntime ? { commandRuntime } : {},
       ...formPre ? { formPre } : {},
       ...formPost ? { formPost } : {},
@@ -277,44 +282,43 @@ function OperationCatalog({
       "data-slot": "operation-catalog",
       children: [
         actionsContainer ? createPortal(actionBar, actionsContainer) : actionBar,
-        showTable ? /* @__PURE__ */ jsx(
-          "div",
-          {
-            className: "min-h-0 flex-1",
-            "data-slot": "operation-catalog-results",
-            children: (() => {
-              const defaultView = /* @__PURE__ */ jsx(
-                OperationResultView,
-                {
-                  response: tableResponse,
-                  loading: listQuery.isFetching,
-                  loadingMessage: `Loading ${definition.title} results…`,
-                  emptyMessage: "No records returned",
-                  ariaLabel: `${definition.title} results`,
-                  className: "mt-0 h-full min-h-0",
-                  detailOperation,
-                  filterConfig: resultFilterConfig,
-                  ...tableError ? { error: tableError } : {},
-                  ...commandRuntime ? { commandRuntime } : {},
-                  ...dataTablePagination ? { pagination: dataTablePagination } : {},
-                  ...download ? { download } : {}
-                }
-              );
-              return resultRenderer ? resultRenderer({
-                response: listQuery.data ?? null,
-                defaultView,
-                filterConfig: resultFilterConfig,
-                // A renderer that replaces the table owns the whole surface,
-                // pager and download menu included. Without these it can only
-                // drop them, which is how a replaced view silently loses the
-                // ability to reach page two.
-                ...dataTablePagination ? { pagination: dataTablePagination } : {},
-                ...download ? { download } : {},
-                ...surfaceKey ? { surfaceKey } : {}
-              }) : defaultView;
-            })()
-          }
-        ) : /* @__PURE__ */ jsx(
+        showTable ? /* @__PURE__ */ jsx("div", { className: "min-h-0 flex-1", "data-slot": "operation-catalog-results", children: (() => {
+          const defaultView = /* @__PURE__ */ jsx(
+            OperationResultView,
+            {
+              response: tableResponse,
+              loading: list.isFetching,
+              loadingMessage: `Loading ${definition.title} results…`,
+              emptyMessage: "No records returned",
+              ariaLabel: `${definition.title} results`,
+              className: "mt-0 h-full min-h-0",
+              detailOperation,
+              filterConfig: resultFilterConfig,
+              ...tableError ? { error: tableError } : {},
+              ...commandRuntime ? { commandRuntime } : {},
+              ...dataTablePagination ? { pagination: dataTablePagination } : {},
+              ...filterBarConfig.sort ? { sort: filterBarConfig.sort } : {},
+              ...download ? { download } : {},
+              ...walkProps
+            }
+          );
+          return resultRenderer ? resultRenderer({
+            response: list.response,
+            loading: list.isFetching,
+            defaultView,
+            filterConfig: resultFilterConfig,
+            // A renderer that replaces the table owns the whole surface,
+            // pager and download menu included. Without these it can only
+            // drop them, which is how a replaced view silently loses the
+            // ability to reach page two — or, under a walk, page one's
+            // rows the moment page two arrives.
+            ...dataTablePagination ? { pagination: dataTablePagination } : {},
+            ...filterBarConfig.sort ? { sort: filterBarConfig.sort } : {},
+            ...download ? { download } : {},
+            ...surfaceKey ? { surfaceKey } : {},
+            ...walkProps
+          }) : defaultView;
+        })() }) : /* @__PURE__ */ jsx(
           EndpointList,
           {
             operations: domainOps,
@@ -337,14 +341,6 @@ function readFiltersFromUrl() {
   }
   return values;
 }
-function SkeletonBlock({ className }) {
-  return /* @__PURE__ */ jsx(
-    "div",
-    {
-      className: `animate-pulse rounded-md bg-muted ${className ?? ""}`.trim()
-    }
-  );
-}
 function writeFiltersToUrl(filters) {
   if (typeof window === "undefined") return;
   const search = reservedSearchParamsFromUrl();

package/dist/rpc/OperationCatalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"OperationCatalog.js","sources":["../../src/rpc/OperationCatalog.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport { filterOperationsByDomain } from \"./classify\";\nimport {\n  filterOperationsBySurface,\n  findSurfaceCollectionActions,\n  findSurfaceDetailOperation,\n  findSurfaceListOperation,\n  getOperationClickyMeta,\n} from \"./clickyMetadata\";\nimport type {\n  ClickyCommandRuntime,\n  ClickyDownloadOptions,\n  ClickyRemoteFormat,\n} from \"../data/Clicky\";\nimport type { CellFilterChange } from \"../data/cells/CellFilterActions\";\nimport { EndpointList, type RenderLink } from \"./EndpointList\";\nimport { OperationActionBar } from \"./OperationActionBar\";\nimport {\n  OperationResultView,\n  type OperationResultFilterConfig,\n  type ResultRenderer,\n} from \"./OperationResultView\";\nimport { type FormActionsRenderer } from \"./SchemaActionForm\";\nimport {\n  applyFilterExtensions,\n  type FilterExtension,\n} from \"../components/filter-bar-utils\";\nimport type {\n  PreExtension,\n  PostExtension,\n} from \"../components/json-schema-form-types\";\nimport {\n  type DomainDefinition,\n  type ExecutionResponse,\n  type OperationLookupResponse,\n  type ResolvedOperation,\n} from \"./types\";\nimport { useOperations, type OperationsApiClient } from \"./useOperations\";\nimport {\n  dataTablePaginationFromForm,\n  packParameterValues,\n  parametersToFormConfig,\n  type ParameterFormOptions,\n} from \"./formMetadata\";\nimport { useOperationFilterSearch } from \"./operationFilterSearch\";\nimport {\n  parseMultiFilterValue,\n  serializeMultiFilterValue,\n} from \"../data/data-table-filter-values\";\n\nexport type OperationCatalogProps = {\n  definition: DomainDefinition;\n  entities: string[];\n  client: OperationsApiClient;\n  renderLink: RenderLink;\n  // Override to return all operations (e.g. for an \"API explorer\" domain\n  // that shouldn't be filtered by entity tags).\n  allOperations?: boolean;\n  surfaceKey?: string;\n  // Domain-specific filter decorators (e.g. stamp an entity icon by filter\n  // name). Composed in array order; mirrors JsonSchemaForm's `pre`.\n  filterPre?: FilterExtension[];\n  getCommandHref?: (operationId: string, op: ResolvedOperation) => string;\n  renderError?: (err: unknown, title: string) => ReactNode;\n  commandRuntime?: ClickyCommandRuntime;\n  // Custom JsonSchemaForm field extensions forwarded to the create/edit form.\n  formPre?: PreExtension[];\n  formPost?: PostExtension[];\n  // Optional extra footer actions for the create/edit form (e.g. a connection\n  // \"Test\" button).\n  formActions?: FormActionsRenderer;\n  actionLabels?: Record<string, string>;\n  // Optional host override for the result surface, keyed off the current surface.\n  // Receives the default OperationResultView so non-overridden surfaces render\n  // unchanged.\n  resultRenderer?: ResultRenderer;\n  /**\n   * Portal target for the collection action bar (Create, bulk actions). When\n   * set, the bar renders into this element — typically an app shell's\n   * `bodyActions` slot — instead of inline under the catalog header.\n   *\n   * A portal rather than a render-prop because the bar owns its own dialog\n   * state and closes over the catalog's live filters and list query; moving the\n   * element would sever both. Falls back to inline rendering when null, so\n   * existing consumers are unaffected.\n   */\n  actionsContainer?: Element | null;\n};\n\nconst defaultCommandHref = (operationId: string) => `/commands/${operationId}`;\n\nfunction defaultRenderError(err: unknown, title: string) {\n  const message = err instanceof Error ? err.message : String(err ?? \"\");\n  return (\n    <div className=\"rounded-xl border border-destructive/40 bg-destructive/5 p-4 text-sm text-destructive\">\n      <div className=\"font-medium\">{title}</div>\n      {message && (\n        <div className=\"mt-1 whitespace-pre-wrap text-xs opacity-80\">\n          {message}\n        </div>\n      )}\n    </div>\n  );\n}\n\nexport function OperationCatalog({\n  definition,\n  entities,\n  client,\n  renderLink,\n  allOperations = false,\n  surfaceKey,\n  filterPre,\n  getCommandHref = defaultCommandHref,\n  renderError = defaultRenderError,\n  commandRuntime,\n  formPre,\n  formPost,\n  formActions,\n  actionLabels,\n  resultRenderer,\n  actionsContainer,\n}: OperationCatalogProps) {\n  const { operations, isLoading } = useOperations(client);\n\n  const surfaceOps = useMemo(\n    () => filterOperationsBySurface(operations, surfaceKey),\n    [operations, surfaceKey],\n  );\n  const useSurfaceMetadata = surfaceOps.length > 0;\n\n  // domainOps are the operations scoped to this domain: a surface's operations\n  // when surfaceKey resolves, otherwise the entity-tagged operations — used only\n  // to render the generic operation-page fallback, never to guess a table.\n  const domainOps = useMemo(() => {\n    if (useSurfaceMetadata) return surfaceOps;\n    return allOperations\n      ? operations\n      : filterOperationsByDomain(operations, entities);\n  }, [allOperations, entities, operations, surfaceOps, useSurfaceMetadata]);\n\n  // The list table is driven solely by x-clicky surface metadata. Without a\n  // surface there is no authoritative list op, so listEndpoint stays undefined\n  // and the catalog renders the generic EndpointList fallback instead of\n  // guessing a table from operationId/path conventions.\n  const listEndpoint = useMemo(() => {\n    if (!useSurfaceMetadata) return undefined;\n    return findSurfaceListOperation(domainOps, surfaceKey);\n  }, [domainOps, surfaceKey, useSurfaceMetadata]);\n  // The detail op turns each list row into a link to /<surface>/<id>; absent it\n  // (no surface metadata) rows stay non-navigable.\n  const detailOperation = useMemo(\n    () =>\n      useSurfaceMetadata\n        ? findSurfaceDetailOperation(domainOps, surfaceKey)\n        : undefined,\n    [domainOps, surfaceKey, useSurfaceMetadata],\n  );\n  const [filters, setFilters] = useState<Record<string, string>>(() =>\n    readFiltersFromUrl(),\n  );\n  const listParameters = listEndpoint?.operation.parameters ?? [];\n  const download = useMemo<ClickyDownloadOptions | undefined>(() => {\n    const meta = listEndpoint?.operation[\"x-clicky\"]?.export;\n    if (!meta) return undefined;\n    return {\n      label: definition.title,\n      ...(meta.formats\n        ? { formats: meta.formats as ClickyRemoteFormat[] }\n        : {}),\n      ...(meta.scopes ? { scopes: meta.scopes } : {}),\n      ...(meta.allRowsMode ? { allRowsMode: meta.allRowsMode } : {}),\n      ...(meta.formatMaxRows\n        ? {\n            formatMaxRows: meta.formatMaxRows as Partial<\n              Record<ClickyRemoteFormat, number>\n            >,\n          }\n        : {}),\n    };\n  }, [definition.title, listEndpoint]);\n\n  useEffect(() => {\n    writeFiltersToUrl(filters);\n  }, [filters]);\n\n  const listQuery = useQuery<ExecutionResponse>({\n    queryKey: [\n      \"operation-list\",\n      listEndpoint?.method,\n      listEndpoint?.path,\n      filters,\n    ],\n    queryFn: () =>\n      client.executeCommand(\n        listEndpoint!.path,\n        listEndpoint!.method,\n        packParameterValues(filters, listEndpoint!.operation.parameters ?? []),\n        {\n          Accept: \"application/json+clicky\",\n        },\n      ),\n    enabled: !!listEndpoint,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const lookupQuery = useQuery<OperationLookupResponse>({\n    queryKey: [\n      \"operation-lookup\",\n      listEndpoint?.method,\n      listEndpoint?.path,\n      filters,\n    ],\n    queryFn: async () =>\n      (await client.lookupFilters?.(\n        listEndpoint!.path,\n        listEndpoint!.method,\n        packParameterValues(filters, listParameters),\n        { Accept: \"application/json+clicky\" },\n      )) ?? { filters: {} },\n    enabled: !!listEndpoint && !!client.lookupFilters,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  // The list action bar shows only collection-scoped actions (create + bulk\n  // actions that operate on the filtered set). Entity-scoped actions\n  // (update/delete and per-id custom actions) need an {id}, so they live on the\n  // detail page (OperationEntityPage) instead. In the generic fallback the\n  // EndpointList already exposes every operation as a runnable card, so there is\n  // no separate action bar to guess at.\n  const actionOps = useMemo(\n    () =>\n      useSurfaceMetadata\n        ? findSurfaceCollectionActions(domainOps, surfaceKey)\n        : [],\n    [domainOps, surfaceKey, useSurfaceMetadata],\n  );\n\n  const lookupSearch = useOperationFilterSearch(\n    client,\n    listEndpoint,\n    filters,\n    listParameters,\n  );\n\n  const filterBarConfig = useMemo(() => {\n    const options: ParameterFormOptions = {\n      includeLocations: [\"query\"],\n      lookupSearch,\n    };\n    if (lookupQuery.data != null) {\n      options.lookup = lookupQuery.data;\n    }\n    return parametersToFormConfig(listParameters, filters, setFilters, options);\n  }, [filters, listParameters, lookupQuery.data, lookupSearch]);\n  const dataTablePagination = useMemo(\n    () =>\n      dataTablePaginationFromForm(filterBarConfig.pagination, listQuery.data),\n    [filterBarConfig.pagination, listQuery.data],\n  );\n  const decoratedFilters = useMemo(\n    () =>\n      filterBarConfig.filters.map((filter) =>\n        applyFilterExtensions(filter, filterPre),\n      ),\n    [filterBarConfig.filters, filterPre],\n  );\n  const cellFilters = useMemo(\n    () =>\n      Object.fromEntries(\n        listParameters\n          .filter((parameter) => parameter[\"x-clicky\"]?.role === \"filter\")\n          .map((parameter) => [\n            parameter.name,\n            parseMultiFilterValue(filters[parameter.name] ?? \"\"),\n          ]),\n      ),\n    [filters, listParameters],\n  );\n  const onCellFilterChange = useCallback(\n    ({ key, value, mode }: CellFilterChange) => {\n      if (\n        !listParameters.some(\n          (parameter) =>\n            parameter.name === key && parameter[\"x-clicky\"]?.role === \"filter\",\n        )\n      ) {\n        throw new Error(`Clicky table column references unknown filter parameter ${key}`);\n      }\n\n      setFilters((current) => {\n        const selected = parseMultiFilterValue(current[key] ?? \"\");\n        if (mode === undefined) {\n          delete selected[value];\n        } else {\n          selected[value] = mode;\n        }\n\n        const next = { ...current };\n        const serialized = serializeMultiFilterValue(selected);\n        if (serialized) {\n          next[key] = serialized;\n        } else {\n          delete next[key];\n        }\n\n        const offset = listParameters.find(\n          (parameter) => parameter[\"x-clicky\"]?.role === \"offset\",\n        );\n        if (offset) next[offset.name] = \"0\";\n        return next;\n      });\n    },\n    [listParameters],\n  );\n  const resultFilterConfig = useMemo<OperationResultFilterConfig>(\n    () => ({\n      filters: decoratedFilters,\n      cellFilters,\n      onCellFilterChange,\n      ...(filterBarConfig.search ? { search: filterBarConfig.search } : {}),\n      ...(filterBarConfig.timeRange\n        ? { timeRange: filterBarConfig.timeRange }\n        : {}),\n    }),\n    [\n      cellFilters,\n      decoratedFilters,\n      filterBarConfig.search,\n      filterBarConfig.timeRange,\n      onCellFilterChange,\n    ],\n  );\n\n  const showTable = !!listEndpoint;\n  let listError: unknown;\n  if (!listQuery.isFetching) {\n    if (listQuery.isError) {\n      listError = listQuery.error;\n    } else if (listQuery.data?.success === false) {\n      listError = new Error(\n        listQuery.data.error ||\n          listQuery.data.message ||\n          listQuery.data.stderr ||\n          `Command failed with exit code ${listQuery.data.exit_code}`,\n      );\n    }\n  }\n  const tableError =\n    listError !== undefined\n      ? renderError(\n          listError,\n          `Failed to load ${listEndpoint?.path ?? \"\"}`,\n        )\n      : undefined;\n  const tableResponse =\n    listQuery.data?.success === false ? null : (listQuery.data ?? null);\n  // Lock the current list filters into a bulk action (supportsFilterMode), so a\n  // collection action like \"pause\" runs against the same set the table shows.\n  // Entity-scoped actions never reach here (they live on the detail page).\n  function getActionLockedValues(\n    op: ResolvedOperation,\n  ): Record<string, string> {\n    const meta = getOperationClickyMeta(op);\n    if (meta == null || !meta.supportsFilterMode) {\n      return {};\n    }\n\n    const locked: Record<string, string> = {};\n    for (const param of op.operation.parameters ?? []) {\n      const value = filters[param.name];\n      if (param.in === \"query\" && value) {\n        locked[param.name] = value;\n      }\n    }\n\n    if (meta.idParam) {\n      locked[meta.idParam] = \"all\";\n    }\n\n    if (\n      (op.operation.parameters ?? []).some((param) => param.name === \"filter\")\n    ) {\n      locked.filter =\n        Object.entries(filters)\n          .filter(([, value]) => value)\n          .map(([key, value]) => `${key}=${value}`)\n          .join(\", \") || \"current list filters\";\n    }\n\n    return locked;\n  }\n\n  if (isLoading) {\n    return (\n      <div className=\"space-y-3\">\n        <SkeletonBlock className=\"h-10 w-72\" />\n        <SkeletonBlock className=\"h-4 w-[32rem]\" />\n        {Array.from({ length: 5 }).map((_, i) => (\n          <SkeletonBlock key={i} className=\"h-12\" />\n        ))}\n      </div>\n    );\n  }\n\n  const actionBar = (\n    <OperationActionBar\n      actions={actionOps}\n      client={client}\n      getLockedValues={getActionLockedValues}\n      onExecuted={() => void listQuery.refetch()}\n      {...(commandRuntime ? { commandRuntime } : {})}\n      {...(formPre ? { formPre } : {})}\n      {...(formPost ? { formPost } : {})}\n      {...(formActions ? { formActions } : {})}\n      {...(actionLabels ? { actionLabels } : {})}\n    />\n  );\n\n  return (\n    <div\n      className=\"flex h-full min-h-0 flex-col gap-2\"\n      data-slot=\"operation-catalog\"\n    >\n      {/* No title/description here by design: page headers and breadcrumbs are\n          the host's to define (e.g. an app shell's bodyHeader), so the catalog\n          never invents chrome the consumer would have to fight or duplicate. */}\n      {actionsContainer ? createPortal(actionBar, actionsContainer) : actionBar}\n\n      {showTable ? (\n        <div\n          className=\"min-h-0 flex-1\"\n          data-slot=\"operation-catalog-results\"\n        >\n          {(() => {\n            const defaultView = (\n              <OperationResultView\n                response={tableResponse}\n                loading={listQuery.isFetching}\n                loadingMessage={`Loading ${definition.title} results…`}\n                emptyMessage=\"No records returned\"\n                ariaLabel={`${definition.title} results`}\n                className=\"mt-0 h-full min-h-0\"\n                detailOperation={detailOperation}\n                filterConfig={resultFilterConfig}\n                {...(tableError ? { error: tableError } : {})}\n                {...(commandRuntime ? { commandRuntime } : {})}\n                {...(dataTablePagination\n                  ? { pagination: dataTablePagination }\n                  : {})}\n                {...(download ? { download } : {})}\n              />\n            );\n            return resultRenderer\n              ? resultRenderer({\n                  response: listQuery.data ?? null,\n                  defaultView,\n                  filterConfig: resultFilterConfig,\n                  // A renderer that replaces the table owns the whole surface,\n                  // pager and download menu included. Without these it can only\n                  // drop them, which is how a replaced view silently loses the\n                  // ability to reach page two.\n                  ...(dataTablePagination ? { pagination: dataTablePagination } : {}),\n                  ...(download ? { download } : {}),\n                  ...(surfaceKey ? { surfaceKey } : {}),\n                })\n              : defaultView;\n          })()}\n        </div>\n      ) : (\n        <EndpointList\n          operations={domainOps}\n          definition={definition}\n          renderLink={renderLink}\n          getCommandHref={getCommandHref}\n        />\n      )}\n    </div>\n  );\n}\n\nfunction readFiltersFromUrl(): Record<string, string> {\n  if (typeof window === \"undefined\") return {};\n  const search = new URLSearchParams(window.location.search);\n  const values: Record<string, string> = {};\n  for (const [key, value] of search.entries()) {\n    if (key.startsWith(\"__\")) continue;\n    if (value !== \"\") values[key] = value;\n  }\n  return values;\n}\n\nfunction SkeletonBlock({ className }: { className?: string }) {\n  return (\n    <div\n      className={`animate-pulse rounded-md bg-muted ${className ?? \"\"}`.trim()}\n    />\n  );\n}\n\nfunction writeFiltersToUrl(filters: Record<string, string>) {\n  if (typeof window === \"undefined\") return;\n  const search = reservedSearchParamsFromUrl();\n  for (const [key, value] of Object.entries(filters)) {\n    if (value !== \"\") search.set(key, value);\n  }\n  const query = search.toString();\n  const next = `${window.location.pathname}${query ? `?${query}` : \"\"}${window.location.hash}`;\n  if (\n    next !==\n    `${window.location.pathname}${window.location.search}${window.location.hash}`\n  ) {\n    window.history.replaceState(window.history.state, \"\", next);\n  }\n}\n\nfunction reservedSearchParamsFromUrl() {\n  const current = new URLSearchParams(window.location.search);\n  const next = new URLSearchParams();\n  for (const [key, value] of current.entries()) {\n    if (!key.startsWith(\"__\")) continue;\n    if (key === \"__autoRun\" || key.startsWith(\"__arg\")) continue;\n    next.append(key, value);\n  }\n  return next;\n}\n"],"names":["_a"],"mappings":"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"}
+{"version":3,"file":"OperationCatalog.js","sources":["../../src/rpc/OperationCatalog.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport { useOperationPages } from \"./useOperationPages\";\nimport { filterOperationsByDomain } from \"./classify\";\nimport {\n  filterOperationsBySurface,\n  findSurfaceCollectionActions,\n  findSurfaceDetailOperation,\n  findSurfaceListOperation,\n  getOperationClickyMeta,\n} from \"./clickyMetadata\";\nimport type {\n  ClickyCommandRuntime,\n  ClickyDownloadOptions,\n  ClickyRemoteFormat,\n} from \"../data/Clicky\";\nimport type { CellFilterChange } from \"../data/cells/CellFilterActions\";\nimport { EndpointList, type RenderLink } from \"./EndpointList\";\nimport { OperationActionBar } from \"./OperationActionBar\";\nimport { OperationsApiClientError } from \"./apiClient\";\nimport { renderOperationError } from \"./operationErrorDiagnostics\";\nimport {\n  OperationResultView,\n  type OperationResultFilterConfig,\n  type ResultRenderer,\n} from \"./OperationResultView\";\nimport { type FormActionsRenderer } from \"./SchemaActionForm\";\nimport {\n  applyFilterExtensions,\n  type FilterExtension,\n} from \"../components/filter-bar-utils\";\nimport type {\n  PreExtension,\n  PostExtension,\n} from \"../components/json-schema-form-types\";\nimport {\n  type DomainDefinition,\n  type OperationLookupResponse,\n  type ResolvedOperation,\n} from \"./types\";\nimport { useOperations, type OperationsApiClient } from \"./useOperations\";\nimport {\n  dataTablePaginationFromForm,\n  packLookupParameterValues,\n  parametersToFormConfig,\n  type ParameterFormOptions,\n} from \"./formMetadata\";\nimport { cursorParameterName, useCursorStaleRecovery } from \"./cursorStale\";\nimport { useOperationFilterSearch } from \"./operationFilterSearch\";\nimport {\n  parseMultiFilterValue,\n  serializeMultiFilterValue,\n} from \"../data/data-table-filter-values\";\nimport { Loading } from \"../components/loading\";\n\nexport type OperationCatalogProps = {\n  definition: DomainDefinition;\n  entities: string[];\n  client: OperationsApiClient;\n  renderLink: RenderLink;\n  // Override to return all operations (e.g. for an \"API explorer\" domain\n  // that shouldn't be filtered by entity tags).\n  allOperations?: boolean;\n  surfaceKey?: string;\n  // Domain-specific filter decorators (e.g. stamp an entity icon by filter\n  // name). Composed in array order; mirrors JsonSchemaForm's `pre`.\n  filterPre?: FilterExtension[];\n  getCommandHref?: (operationId: string, op: ResolvedOperation) => string;\n  renderError?: (err: unknown, title: string) => ReactNode;\n  commandRuntime?: ClickyCommandRuntime;\n  // Custom JsonSchemaForm field extensions forwarded to the create/edit form.\n  formPre?: PreExtension[];\n  formPost?: PostExtension[];\n  // Optional extra footer actions for the create/edit form (e.g. a connection\n  // \"Test\" button).\n  formActions?: FormActionsRenderer;\n  actionLabels?: Record<string, string>;\n  // Optional host override for the result surface, keyed off the current surface.\n  // Receives the default OperationResultView so non-overridden surfaces render\n  // unchanged.\n  resultRenderer?: ResultRenderer;\n  /**\n   * Portal target for the collection action bar (Create, bulk actions). When\n   * set, the bar renders into this element — typically an app shell's\n   * `bodyActions` slot — instead of inline under the catalog header.\n   *\n   * A portal rather than a render-prop because the bar owns its own dialog\n   * state and closes over the catalog's live filters and list query; moving the\n   * element would sever both. Falls back to inline rendering when null, so\n   * existing consumers are unaffected.\n   */\n  actionsContainer?: Element | null;\n};\n\nconst defaultCommandHref = (operationId: string) => `/commands/${operationId}`;\n\nexport function OperationCatalog({\n  definition,\n  entities,\n  client,\n  renderLink,\n  allOperations = false,\n  surfaceKey,\n  filterPre,\n  getCommandHref = defaultCommandHref,\n  renderError = renderOperationError,\n  commandRuntime,\n  formPre,\n  formPost,\n  formActions,\n  actionLabels,\n  resultRenderer,\n  actionsContainer,\n}: OperationCatalogProps) {\n  const { operations, spec, isLoading } = useOperations(client);\n  const filterShapes = spec?.components?.[\"x-clicky-filters\"];\n\n  const surfaceOps = useMemo(\n    () => filterOperationsBySurface(operations, surfaceKey),\n    [operations, surfaceKey],\n  );\n  const useSurfaceMetadata = surfaceOps.length > 0;\n\n  // domainOps are the operations scoped to this domain: a surface's operations\n  // when surfaceKey resolves, otherwise the entity-tagged operations — used only\n  // to render the generic operation-page fallback, never to guess a table.\n  const domainOps = useMemo(() => {\n    if (useSurfaceMetadata) return surfaceOps;\n    return allOperations\n      ? operations\n      : filterOperationsByDomain(operations, entities);\n  }, [allOperations, entities, operations, surfaceOps, useSurfaceMetadata]);\n\n  // The list table is driven solely by x-clicky surface metadata. Without a\n  // surface there is no authoritative list op, so listEndpoint stays undefined\n  // and the catalog renders the generic EndpointList fallback instead of\n  // guessing a table from operationId/path conventions.\n  const listEndpoint = useMemo(() => {\n    if (!useSurfaceMetadata) return undefined;\n    return findSurfaceListOperation(domainOps, surfaceKey);\n  }, [domainOps, surfaceKey, useSurfaceMetadata]);\n  // The detail op turns each list row into a link to /<surface>/<id>; absent it\n  // (no surface metadata) rows stay non-navigable.\n  const detailOperation = useMemo(\n    () =>\n      useSurfaceMetadata\n        ? findSurfaceDetailOperation(domainOps, surfaceKey)\n        : undefined,\n    [domainOps, surfaceKey, useSurfaceMetadata],\n  );\n  const [filters, setFilters] = useState<Record<string, string>>(() =>\n    readFiltersFromUrl(),\n  );\n  const listParameters = listEndpoint?.operation.parameters ?? [];\n  const lookupParameters = useMemo(\n    () => packLookupParameterValues(filters, listParameters),\n    [filters, listParameters],\n  );\n  const download = useMemo<ClickyDownloadOptions | undefined>(() => {\n    const meta = listEndpoint?.operation[\"x-clicky\"]?.export;\n    if (!meta) return undefined;\n    return {\n      label: definition.title,\n      ...(meta.formats\n        ? { formats: meta.formats as ClickyRemoteFormat[] }\n        : {}),\n      ...(meta.scopes ? { scopes: meta.scopes } : {}),\n      ...(meta.allRowsMode ? { allRowsMode: meta.allRowsMode } : {}),\n      ...(meta.formatMaxRows\n        ? {\n            formatMaxRows: meta.formatMaxRows as Partial<\n              Record<ClickyRemoteFormat, number>\n            >,\n          }\n        : {}),\n    };\n  }, [definition.title, listEndpoint]);\n\n  useEffect(() => {\n    writeFiltersToUrl(filters);\n  }, [filters]);\n\n  const list = useOperationPages({\n    client,\n    endpoint: listEndpoint,\n    parameters: listParameters,\n    filters,\n  });\n\n  // Only reaches a cursor the form itself holds — an offset-mode surface that\n  // stepped onto a cursor near the depth limit. A walk keeps its position in the\n  // query rather than in the form, and restarts itself from inside the hook.\n  useCursorStaleRecovery({\n    error: list.error,\n    parameters: listParameters,\n    values: filters,\n    setValues: setFilters,\n  });\n\n  const lookupQuery = useQuery<OperationLookupResponse>({\n    queryKey: [\n      \"operation-lookup\",\n      listEndpoint?.method,\n      listEndpoint?.path,\n      lookupParameters,\n    ],\n    queryFn: async () =>\n      (await client.lookupFilters?.(\n        listEndpoint!.path,\n        listEndpoint!.method,\n        lookupParameters,\n        { Accept: \"application/json+clicky\" },\n      )) ?? { filters: {} },\n    enabled: !!listEndpoint && !!client.lookupFilters,\n    // Options are the answer to \"what can this filter be set to now\", so the\n    // previous answer stays on screen while the next one is fetched rather than\n    // the dropdowns emptying and refilling on every selection.\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  // The list action bar shows only collection-scoped actions (create + bulk\n  // actions that operate on the filtered set). Entity-scoped actions\n  // (update/delete and per-id custom actions) need an {id}, so they live on the\n  // detail page (OperationEntityPage) instead. In the generic fallback the\n  // EndpointList already exposes every operation as a runnable card, so there is\n  // no separate action bar to guess at.\n  const actionOps = useMemo(\n    () =>\n      useSurfaceMetadata\n        ? findSurfaceCollectionActions(domainOps, surfaceKey)\n        : [],\n    [domainOps, surfaceKey, useSurfaceMetadata],\n  );\n\n  const lookupSearch = useOperationFilterSearch(\n    client,\n    listEndpoint,\n    filters,\n    listParameters,\n  );\n\n  const filterBarConfig = useMemo(() => {\n    const options: ParameterFormOptions = {\n      includeLocations: [\"query\"],\n      lookupSearch,\n      components: filterShapes,\n    };\n    if (lookupQuery.data != null) {\n      options.lookup = lookupQuery.data;\n    }\n    return parametersToFormConfig(listParameters, filters, setFilters, options);\n  }, [filters, filterShapes, listParameters, lookupQuery.data, lookupSearch]);\n  const dataTablePagination = useMemo(\n    () => dataTablePaginationFromForm(filterBarConfig.pagination, list.response),\n    [filterBarConfig.pagination, list.response],\n  );\n  const decoratedFilters = useMemo(\n    () =>\n      filterBarConfig.filters.map((filter) =>\n        applyFilterExtensions(filter, filterPre),\n      ),\n    [filterBarConfig.filters, filterPre],\n  );\n  const cellFilters = useMemo(\n    () =>\n      Object.fromEntries(\n        listParameters\n          .filter((parameter) => parameter[\"x-clicky\"]?.role === \"filter\")\n          .map((parameter) => [\n            parameter.name,\n            parseMultiFilterValue(filters[parameter.name] ?? \"\"),\n          ]),\n      ),\n    [filters, listParameters],\n  );\n  const onCellFilterChange = useCallback(\n    ({ key, value, mode }: CellFilterChange) => {\n      if (\n        !listParameters.some(\n          (parameter) =>\n            parameter.name === key && parameter[\"x-clicky\"]?.role === \"filter\",\n        )\n      ) {\n        throw new Error(\n          `Clicky table column references unknown filter parameter ${key}`,\n        );\n      }\n\n      setFilters((current) => {\n        const selected = parseMultiFilterValue(current[key] ?? \"\");\n        if (mode === undefined) {\n          delete selected[value];\n        } else {\n          selected[value] = mode;\n        }\n\n        const next = { ...current };\n        const serialized = serializeMultiFilterValue(selected);\n        if (serialized) {\n          next[key] = serialized;\n        } else {\n          delete next[key];\n        }\n\n        // Both positions go, for the reason rewind gives: filtering from a cell\n        // changes which rows exist, so an offset names different rows and a\n        // cursor minted under the old filters is refused outright.\n        const offset = listParameters.find(\n          (parameter) => parameter[\"x-clicky\"]?.role === \"offset\",\n        );\n        if (offset) next[offset.name] = \"0\";\n        const cursor = cursorParameterName(listParameters);\n        if (cursor) next[cursor] = \"\";\n        return next;\n      });\n    },\n    [listParameters],\n  );\n  const resultFilterConfig = useMemo<OperationResultFilterConfig>(\n    () => ({\n      filters: decoratedFilters,\n      cellFilters,\n      onCellFilterChange,\n      ...(filterBarConfig.search ? { search: filterBarConfig.search } : {}),\n      ...(filterBarConfig.timeRange\n        ? { timeRange: filterBarConfig.timeRange }\n        : {}),\n    }),\n    [\n      cellFilters,\n      decoratedFilters,\n      filterBarConfig.search,\n      filterBarConfig.timeRange,\n      onCellFilterChange,\n    ],\n  );\n\n  const showTable = !!listEndpoint;\n  let listError: unknown;\n  if (!list.isFetching) {\n    if (list.isError) {\n      listError = list.error;\n    } else if (list.response?.success === false) {\n      // A non-2xx that still carries a clicky envelope never throws, so this\n      // branch has to rebuild the error the client would have raised — with the\n      // request identity and raw body intact, not just the message.\n      listError = new OperationsApiClientError(\n        list.response.error ||\n          list.response.message ||\n          list.response.stderr ||\n          `Command failed with exit code ${list.response.exit_code}`,\n        {\n          method: listEndpoint?.method,\n          url: list.response.requestUrl,\n          responseBody: list.response.stdout,\n          responseData: list.response.parsed,\n          responseHeaders: list.response.responseHeaders,\n        },\n      );\n    }\n  }\n  const tableError =\n    listError !== undefined\n      ? renderError(listError, `Failed to load ${listEndpoint?.path ?? \"\"}`)\n      : undefined;\n  const tableResponse =\n    list.response?.success === false ? null : list.response;\n  // The walk is handed on only while there is one. Outside cursor mode `pages`\n  // would be a one-element array restating `response`, and a renderer reading\n  // it as \"the surface is accumulating\" would be wrong.\n  const walkProps = list.infinite\n    ? { pages: list.pages, infinite: list.infinite }\n    : {};\n  // Lock the current list filters into a bulk action (supportsFilterMode), so a\n  // collection action like \"pause\" runs against the same set the table shows.\n  // Entity-scoped actions never reach here (they live on the detail page).\n  function getActionLockedValues(\n    op: ResolvedOperation,\n  ): Record<string, string> {\n    const meta = getOperationClickyMeta(op);\n    if (meta == null || !meta.supportsFilterMode) {\n      return {};\n    }\n\n    const locked: Record<string, string> = {};\n    for (const param of op.operation.parameters ?? []) {\n      const value = filters[param.name];\n      if (param.in === \"query\" && value) {\n        locked[param.name] = value;\n      }\n    }\n\n    if (meta.idParam) {\n      locked[meta.idParam] = \"all\";\n    }\n\n    if (\n      (op.operation.parameters ?? []).some((param) => param.name === \"filter\")\n    ) {\n      locked.filter =\n        Object.entries(filters)\n          .filter(([, value]) => value)\n          .map(([key, value]) => `${key}=${value}`)\n          .join(\", \") || \"current list filters\";\n    }\n\n    return locked;\n  }\n\n  if (isLoading || (showTable && list.isPending && list.response == null)) {\n    return (\n      <Loading variant=\"centered\" label={`Loading ${definition.title}…`} />\n    );\n  }\n\n  const actionBar = (\n    <OperationActionBar\n      actions={actionOps}\n      client={client}\n      getLockedValues={getActionLockedValues}\n      onExecuted={() => list.refetch()}\n      {...(commandRuntime ? { commandRuntime } : {})}\n      {...(formPre ? { formPre } : {})}\n      {...(formPost ? { formPost } : {})}\n      {...(formActions ? { formActions } : {})}\n      {...(actionLabels ? { actionLabels } : {})}\n    />\n  );\n\n  return (\n    <div\n      className=\"flex h-full min-h-0 flex-col gap-2\"\n      data-slot=\"operation-catalog\"\n    >\n      {/* No title/description here by design: page headers and breadcrumbs are\n          the host's to define (e.g. an app shell's bodyHeader), so the catalog\n          never invents chrome the consumer would have to fight or duplicate. */}\n      {actionsContainer ? createPortal(actionBar, actionsContainer) : actionBar}\n\n      {showTable ? (\n        <div className=\"min-h-0 flex-1\" data-slot=\"operation-catalog-results\">\n          {(() => {\n            const defaultView = (\n              <OperationResultView\n                response={tableResponse}\n                loading={list.isFetching}\n                loadingMessage={`Loading ${definition.title} results…`}\n                emptyMessage=\"No records returned\"\n                ariaLabel={`${definition.title} results`}\n                className=\"mt-0 h-full min-h-0\"\n                detailOperation={detailOperation}\n                filterConfig={resultFilterConfig}\n                {...(tableError ? { error: tableError } : {})}\n                {...(commandRuntime ? { commandRuntime } : {})}\n                {...(dataTablePagination\n                  ? { pagination: dataTablePagination }\n                  : {})}\n                {...(filterBarConfig.sort\n                  ? { sort: filterBarConfig.sort }\n                  : {})}\n                {...(download ? { download } : {})}\n                {...walkProps}\n              />\n            );\n            return resultRenderer\n              ? resultRenderer({\n                  response: list.response,\n                  loading: list.isFetching,\n                  defaultView,\n                  filterConfig: resultFilterConfig,\n                  // A renderer that replaces the table owns the whole surface,\n                  // pager and download menu included. Without these it can only\n                  // drop them, which is how a replaced view silently loses the\n                  // ability to reach page two — or, under a walk, page one's\n                  // rows the moment page two arrives.\n                  ...(dataTablePagination\n                    ? { pagination: dataTablePagination }\n                    : {}),\n                  ...(filterBarConfig.sort\n                    ? { sort: filterBarConfig.sort }\n                    : {}),\n                  ...(download ? { download } : {}),\n                  ...(surfaceKey ? { surfaceKey } : {}),\n                  ...walkProps,\n                })\n              : defaultView;\n          })()}\n        </div>\n      ) : (\n        <EndpointList\n          operations={domainOps}\n          definition={definition}\n          renderLink={renderLink}\n          getCommandHref={getCommandHref}\n        />\n      )}\n    </div>\n  );\n}\n\nfunction readFiltersFromUrl(): Record<string, string> {\n  if (typeof window === \"undefined\") return {};\n  const search = new URLSearchParams(window.location.search);\n  const values: Record<string, string> = {};\n  for (const [key, value] of search.entries()) {\n    if (key.startsWith(\"__\")) continue;\n    if (value !== \"\") values[key] = value;\n  }\n  return values;\n}\n\nfunction writeFiltersToUrl(filters: Record<string, string>) {\n  if (typeof window === \"undefined\") return;\n  const search = reservedSearchParamsFromUrl();\n  for (const [key, value] of Object.entries(filters)) {\n    if (value !== \"\") search.set(key, value);\n  }\n  const query = search.toString();\n  const next = `${window.location.pathname}${query ? `?${query}` : \"\"}${window.location.hash}`;\n  if (\n    next !==\n    `${window.location.pathname}${window.location.search}${window.location.hash}`\n  ) {\n    window.history.replaceState(window.history.state, \"\", next);\n  }\n}\n\nfunction reservedSearchParamsFromUrl() {\n  const current = new URLSearchParams(window.location.search);\n  const next = new URLSearchParams();\n  for (const [key, value] of current.entries()) {\n    if (!key.startsWith(\"__\")) continue;\n    if (key === \"__autoRun\" || key.startsWith(\"__arg\")) continue;\n    next.append(key, value);\n  }\n  return next;\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/rpc/OperationCommandPage.cjs

@@ -8,6 +8,7 @@ const string = require("../lib/string.cjs");
 const CommandForm = require("./CommandForm.cjs");
 const commandFormUtils = require("./command-form-utils.cjs");
 const formMetadata = require("./formMetadata.cjs");
+const cursorStale = require("./cursorStale.cjs");
 const InlineError = require("./InlineError.cjs");
 const OperationActionDialog = require("./OperationActionDialog.cjs");
 const OperationResultView = require("./OperationResultView.cjs");
@@ -31,6 +32,7 @@ function OperationCommandPage({
   hideLockedPathFilters = Boolean(providedOperation),
   className
 }) {
+  var _a, _b;
   const lookup = useOperations.useOperationById(
     client,
     providedOperation ? void 0 : operationId
@@ -46,12 +48,12 @@ function OperationCommandPage({
   const effectiveAutoRun = operation ? autoRun ?? isGet : false;
   const parameterSignature = JSON.stringify(
     parameters.map((param) => {
-      var _a;
+      var _a2;
       return {
         name: param.name,
         in: param.in,
         required: param.required ?? false,
-        default: ((_a = param.schema) == null ? void 0 : _a.default) ?? null
+        default: ((_a2 = param.schema) == null ? void 0 : _a2.default) ?? null
       };
     })
   );
@@ -96,32 +98,39 @@ function OperationCommandPage({
     if (!isGet || !operation) return;
     writeQueryParameterValuesToUrl(debouncedValues, parameters);
   }, [isGet, operationKey, debouncedValues, parameterSignature]);
+  const lookupParameters = react.useMemo(
+    () => formMetadata.packLookupParameterValues(debouncedValues, parameters),
+    [debouncedValues, parameters]
+  );
   const lookupQuery = reactQuery.useQuery({
     queryKey: [
       "operation-query-lookup",
       operation == null ? void 0 : operation.method,
       operation == null ? void 0 : operation.path,
-      debouncedValues
+      lookupParameters
     ],
     queryFn: async () => {
-      var _a;
+      var _a2;
       if (!operation) return { filters: {} };
-      return await ((_a = client.lookupFilters) == null ? void 0 : _a.call(
+      return await ((_a2 = client.lookupFilters) == null ? void 0 : _a2.call(
         client,
         operation.path,
         operation.method,
-        formMetadata.packParameterValues(debouncedValues, parameters),
+        lookupParameters,
         { Accept: "application/json+clicky" }
       )) ?? { filters: {} };
     },
     enabled: isGet && !!operation && !!client.lookupFilters && parameters.some((param) => param.in === "query"),
+    placeholderData: reactQuery.keepPreviousData,
     staleTime: 3e4,
     retry: 0
   });
+  const filterShapes = (_b = (_a = lookup.spec) == null ? void 0 : _a.components) == null ? void 0 : _b["x-clicky-filters"];
   const formConfig = react.useMemo(() => {
     if (!isGet) return { filters: [] };
     return formMetadata.parametersToFormConfig(parameters, values, setValues, {
       lookup: lookupQuery.data,
+      components: filterShapes,
       lockedValues: lockedPathValues,
       hideLocked: hideLockedPathFilters
     });
@@ -130,6 +139,7 @@ function OperationCommandPage({
     parameters,
     values,
     lookupQuery.data,
+    filterShapes,
     lockedPathValues,
     hideLockedPathFilters
   ]);
@@ -138,7 +148,7 @@ function OperationCommandPage({
     [formConfig.pagination, result]
   );
   const lastSubmittedSignature = react.useRef("");
-  async function executeOperation(values2) {
+  async function executeOperation(options) {
     if (!operation) return;
     setIsExecuting(true);
     setError(null);
@@ -146,11 +156,11 @@ function OperationCommandPage({
       const response = await client.executeCommand(
         operation.path,
         operation.method,
-        formMetadata.packParameterValues(values2, operation.operation.parameters ?? []),
-        { Accept: RESULT_ACCEPT }
+        options.request ?? formMetadata.packParameterValues(options.values, operation.operation.parameters ?? []),
+        options.headers ?? { Accept: RESULT_ACCEPT }
       );
       setResult(response);
-      onResult == null ? void 0 : onResult(response, operation, values2);
+      onResult == null ? void 0 : onResult(response, operation, options.values);
     } catch (err) {
       setResult(null);
       setError(err);
@@ -158,6 +168,7 @@ function OperationCommandPage({
       setIsExecuting(false);
     }
   }
+  cursorStale.useCursorStaleRecovery({ error, parameters, values, setValues });
   react.useEffect(() => {
     setHasAutoRun(false);
     setResult(null);
@@ -175,7 +186,7 @@ function OperationCommandPage({
     lastSubmittedSignature.current = JSON.stringify(
       formMetadata.pruneParameterValues(effectiveInitialValues)
     );
-    void executeOperation(effectiveInitialValues);
+    void executeOperation({ values: effectiveInitialValues });
   }, [
     effectiveAutoRun,
     effectiveInitialValues,
@@ -194,7 +205,7 @@ function OperationCommandPage({
     const signature = JSON.stringify(formMetadata.pruneParameterValues(merged));
     if (lastSubmittedSignature.current === signature) return;
     lastSubmittedSignature.current = signature;
-    void executeOperation(merged);
+    void executeOperation({ values: merged });
   }, [
     isGet,
     hasAutoRun,
@@ -271,7 +282,7 @@ function OperationCommandPage({
       CommandForm.CommandForm,
       {
         parameters,
-        onExecute: (params) => executeOperation(params),
+        onExecute: (submission) => executeOperation(submission),
         isPending: isExecuting,
         method,
         path,
@@ -294,7 +305,8 @@ function OperationCommandPage({
             ...formConfig.timeRange ? { timeRange: formConfig.timeRange } : {}
           }
         } : {},
-        ...isGet && effectiveAutoRun && dataTablePagination ? { pagination: dataTablePagination } : {}
+        ...isGet && effectiveAutoRun && dataTablePagination ? { pagination: dataTablePagination } : {},
+        ...isGet && effectiveAutoRun && formConfig.sort ? { sort: formConfig.sort } : {}
       }
     ) : null
   ] });