@flanksource/clicky-ui 0.3.21 → 0.3.22

package/dist/rpc/apiClient.js

@@ -2,6 +2,7 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { stripTrailingSlashes, stripLeadingSlashes } from "../lib/string.js";
+const CLICKY_OPENAPI_MEDIA_TYPE = "application/vnd.clicky.openapi+json";
 class OperationsApiClientError extends Error {
   constructor(message, options = {}) {
     super(message);
@@ -41,7 +42,13 @@ function createOperationsApiClient(options = {}) {
   }
   async function getOpenAPISpec() {
     const response = await request(openApiPath, "GET", {
-      headers: { Accept: "application/json" }
+      // Prefer the catalog projection — the same document with each operation's
+      // response schemas stubbed, which nothing here reads and which is over
+      // half the bytes. A server that does not serve it answers with the
+      // complete document, which parses the same.
+      headers: {
+        Accept: `${CLICKY_OPENAPI_MEDIA_TYPE}, application/json;q=0.9`
+      }
     });
     const parsed = await readResponseBody(response, "json");
     if (!response.ok) {
@@ -375,7 +382,10 @@ function messageFromBody(data) {
   return errorFromClickyEnvelope(data);
 }
 export {
+  CLICKY_OPENAPI_MEDIA_TYPE,
   OperationsApiClientError,
-  createOperationsApiClient
+  createOperationsApiClient,
+  errorFromResponse,
+  readResponseBody
 };
 //# sourceMappingURL=apiClient.js.map

package/dist/rpc/apiClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"apiClient.js","sources":["../../src/rpc/apiClient.ts"],"sourcesContent":["import type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport { stripLeadingSlashes, stripTrailingSlashes } from \"../lib/string\";\nimport type {\n  ExecutionPagination,\n  ExecutionResponse,\n  OpenAPISpec,\n  OperationLookupFilter,\n  OperationLookupResponse,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\ntype MaybePromise<T> = T | Promise<T>;\n\nexport type OperationApiClientContext = {\n  path: string;\n  method: string;\n};\n\nexport type OperationDefaultParams = (context: {\n  path: string;\n  method: string;\n  params: Record<string, string>;\n}) => MaybePromise<Record<string, string>>;\n\nexport type OperationHeadersProvider = (\n  headers: Headers,\n  context: OperationApiClientContext,\n) => MaybePromise<HeadersInit | void>;\n\nexport type CreateOperationsApiClientOptions = {\n  baseUrl?: string;\n  openApiPath?: string;\n  credentials?: RequestCredentials;\n  fetch?: typeof fetch;\n  prepareHeaders?: OperationHeadersProvider;\n  defaultParams?: OperationDefaultParams;\n};\n\nexport class OperationsApiClientError extends Error {\n  status: number | undefined;\n  method: string | undefined;\n  url: string | undefined;\n  responseBody: string | undefined;\n  responseData: unknown;\n  responseHeaders: Record<string, string> | undefined;\n\n  constructor(\n    message: string,\n    options: {\n      status?: number;\n      method?: string;\n      url?: string;\n      responseBody?: string;\n      responseData?: unknown;\n      responseHeaders?: Record<string, string>;\n    } = {},\n  ) {\n    super(message);\n    this.name = \"OperationsApiClientError\";\n    this.status = options.status;\n    this.method = options.method;\n    this.url = options.url;\n    this.responseBody = options.responseBody;\n    this.responseData = options.responseData;\n    this.responseHeaders = options.responseHeaders;\n  }\n}\n\nexport interface SharedOperationsApiClient extends OperationsApiClient {\n  lookupFilterOptions(\n    path: string,\n    method: string,\n    filterKey: string,\n    query: string,\n    extraParams?: Record<string, string>,\n  ): Promise<OperationLookupFilter>;\n  executeCommandBody(\n    path: string,\n    body: Record<string, unknown>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n  getSchema(path: string): Promise<JsonSchemaObject | undefined>;\n  submitForm(\n    path: string,\n    method: string,\n    body: Record<string, unknown>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n}\n\nexport function createOperationsApiClient(\n  options: CreateOperationsApiClientOptions = {},\n): SharedOperationsApiClient {\n  const fetcher = options.fetch ?? fetch;\n  const openApiPath = options.openApiPath ?? \"/api/openapi.json\";\n\n  async function makeHeaders(\n    base: HeadersInit | undefined,\n    context: OperationApiClientContext,\n  ): Promise<Headers> {\n    const headers = new Headers(base);\n    const prepared = await options.prepareHeaders?.(headers, context);\n    return prepared ? new Headers(prepared) : headers;\n  }\n\n  async function request(\n    path: string,\n    method: string,\n    init: Omit<RequestInit, \"method\" | \"headers\" | \"credentials\"> & {\n      headers?: HeadersInit;\n      requestUrl?: string;\n    } = {},\n  ): Promise<Response> {\n    const url = joinUrl(options.baseUrl, path);\n    const headers = await makeHeaders(init.headers, { path, method });\n    return fetcher(url, {\n      ...init,\n      method,\n      headers,\n      ...(options.credentials ? { credentials: options.credentials } : {}),\n    });\n  }\n\n  async function getOpenAPISpec(): Promise<OpenAPISpec> {\n    const response = await request(openApiPath, \"GET\", {\n      headers: { Accept: \"application/json\" },\n    });\n    const parsed = await readResponseBody(response, \"json\");\n    if (!response.ok) {\n      throw errorFromResponse(response, \"GET\", openApiPath, parsed);\n    }\n    return parsed.data as OpenAPISpec;\n  }\n\n  async function withDefaults(path: string, method: string, params: Record<string, string>) {\n    return (await options.defaultParams?.({ path, method, params })) ?? params;\n  }\n\n  return {\n    getOpenAPISpec,\n\n    async executeCommand(path, method, params, headers) {\n      const upper = method.toUpperCase();\n      const resolved = resolvePathParams(path, params);\n      const scoped = await withDefaults(resolved.path, upper, resolved.params);\n      const accept = headerValue(headers, \"Accept\");\n\n      if (upper === \"GET\") {\n        const requestUrl = appendQuery(resolved.path, scoped);\n        const response = await request(requestUrl, upper, {\n          ...(headers ? { headers } : {}),\n          requestUrl,\n        });\n        return parseExecutionResponse(response, await readResponseBody(response, responseKind(accept)), {\n          method: upper,\n          requestUrl,\n        });\n      }\n\n      const response = await request(resolved.path, upper, {\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify(scoped),\n      });\n      return parseExecutionResponse(response, await readResponseBody(response, responseKind(accept)), {\n        method: upper,\n        requestUrl: resolved.path,\n      });\n    },\n\n    async executeCommandBody(path, body, headers) {\n      const accept = headerValue(headers, \"Accept\");\n      const response = await request(path, \"POST\", {\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify(body),\n      });\n      return parseExecutionResponse(response, await readResponseBody(response, responseKind(accept)), {\n        method: \"POST\",\n        requestUrl: path,\n      });\n    },\n\n    // getSchema fetches a resource's JSON Schema via content negotiation\n    // (Accept: application/schema+json on the same endpoint). It returns\n    // undefined when the resource serves no schema (the request falls through to\n    // its data representation), so callers can fall back to a parameter form.\n    async getSchema(path) {\n      const response = await request(path, \"GET\", {\n        headers: { Accept: \"application/schema+json\" },\n      });\n      if (!response.ok) return undefined;\n      const contentType = response.headers.get(\"Content-Type\") || \"\";\n      if (!contentType.toLowerCase().includes(\"schema\")) return undefined;\n      const parsed = await readResponseBody(response, \"json\");\n      const data = parsed.data;\n      return data && typeof data === \"object\" ? (data as JsonSchemaObject) : undefined;\n    },\n\n    // submitForm sends a nested JSON body with the given HTTP method (POST to\n    // create, PUT to update). Unlike executeCommand it preserves nested objects\n    // and arrays — the server reads the raw body (clicky's RequestFromContext),\n    // so connection `properties` and profile `provider`/`params`/`columns`\n    // survive intact.\n    async submitForm(path, method, body, headers) {\n      const upper = method.toUpperCase();\n      const response = await request(path, upper, {\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify(body),\n      });\n      return parseExecutionResponse(response, await readResponseBody(response, \"json\"), {\n        method: upper,\n        requestUrl: path,\n      });\n    },\n\n    async lookupFilters(path, method, params, headers) {\n      const upper = method.toUpperCase();\n      const resolved = resolvePathParams(path, params);\n\n      if (upper === \"GET\") {\n        const requestUrl = appendQuery(resolved.path, { ...resolved.params, __lookup: \"filters\" });\n        const response = await request(requestUrl, \"GET\", {\n          headers: { Accept: \"application/json+clicky\", ...headers },\n        });\n        if (response.status === 404) return { filters: {} };\n        const parsed = await readResponseBody(response, \"json\");\n        if (!response.ok) throw errorFromResponse(response, \"GET\", requestUrl, parsed);\n        return (parsed.data as OperationLookupResponse | undefined) ?? { filters: {} };\n      }\n\n      const response = await request(appendQuery(resolved.path, { __lookup: \"filters\" }), upper, {\n        headers: {\n          Accept: \"application/json+clicky\",\n          \"Content-Type\": \"application/json\",\n          ...headers,\n        },\n        body: JSON.stringify(resolved.params),\n      });\n      if (response.status === 404) return { filters: {} };\n      const parsed = await readResponseBody(response, \"json\");\n      if (!response.ok) throw errorFromResponse(response, upper, resolved.path, parsed);\n      return (parsed.data as OperationLookupResponse | undefined) ?? { filters: {} };\n    },\n\n    async lookupFilterOptions(path, method, filterKey, query, extraParams) {\n      const upper = method.toUpperCase();\n      // Resolved against the supplied params, as lookupFilters does: a lookup on\n      // an operation with a templated path would otherwise request the literal\n      // \"{id}\" and the sibling values that scope the search would be lost.\n      const resolved = resolvePathParams(path, extraParams ?? {});\n      const queryParams = {\n        ...resolved.params,\n        __lookup: \"filters\",\n        __lookup_filter: filterKey,\n        __lookup_q: query,\n      };\n\n      const requestPath = appendQuery(resolved.path, queryParams);\n      const response = await request(requestPath, upper, {\n        headers: { Accept: \"application/json+clicky\" },\n      });\n      const parsed = await readResponseBody(response, \"json\");\n      if (!response.ok) throw errorFromResponse(response, upper, requestPath, parsed);\n      return ((parsed.data as OperationLookupResponse | undefined)?.filters?.[filterKey] ??\n        {}) as OperationLookupFilter;\n    },\n  };\n}\n\nfunction responseKind(accept?: string): \"json\" | \"text\" | \"blob\" {\n  if (!accept) return \"json\";\n  const normalized = accept.toLowerCase();\n  if (normalized.includes(\"application/pdf\")) return \"blob\";\n  if (\n    normalized.includes(\"text/\") ||\n    normalized.includes(\"application/x-yaml\") ||\n    normalized.includes(\"application/yaml\")\n  ) {\n    return \"text\";\n  }\n  return \"json\";\n}\n\ntype ParsedBody = {\n  data: unknown;\n  text: string;\n  blob?: Blob;\n  contentType: string;\n};\n\nasync function readResponseBody(response: Response, kind: \"json\" | \"text\" | \"blob\"): Promise<ParsedBody> {\n  const contentType = response.headers.get(\"Content-Type\") || \"\";\n  if (kind === \"blob\") {\n    const blob = await response.blob();\n    return { data: undefined, text: \"[binary]\", blob, contentType };\n  }\n\n  const text = await response.text();\n  if (kind === \"text\" || !shouldParseJson(text, contentType)) {\n    return { data: text, text, contentType };\n  }\n\n  try {\n    return { data: JSON.parse(text) as unknown, text, contentType };\n  } catch {\n    return { data: text, text, contentType };\n  }\n}\n\nfunction parseExecutionResponse(\n  response: Response,\n  parsed: ParsedBody,\n  context: { method: string; requestUrl: string },\n): ExecutionResponse {\n  const headers = responseHeaders(response.headers);\n  const data = parsed.data;\n  const stdout =\n    parsed.blob != null\n      ? \"[binary]\"\n      : typeof data === \"string\"\n        ? data\n        : parsed.text || JSON.stringify(data, null, 2);\n  const clickyEnvelope = isClickyEnvelope(data);\n\n  if (!response.ok && !clickyEnvelope) {\n    throw errorFromResponse(response, context.method, context.requestUrl, parsed);\n  }\n\n  const clickyError = errorFromClickyEnvelope(data);\n  const successHeader = headers[\"x-execution-success\"];\n  const success = successHeader == null ? response.ok && !clickyError : successHeader !== \"false\";\n  const exitCode = parseInt(headers[\"x-exit-code\"] ?? (success ? \"0\" : \"1\"), 10);\n  const cli = headers[\"x-cli-command\"];\n  const error = headers[\"x-error\"] || clickyError;\n  const pagination = paginationFromHeaders(headers);\n\n  return {\n    success,\n    stdout,\n    output: stdout,\n    exit_code: Number.isFinite(exitCode) ? exitCode : success ? 0 : 1,\n    contentType: parsed.contentType || headers[\"content-type\"] || \"application/json\",\n    requestUrl: context.requestUrl,\n    responseHeaders: headers,\n    ...(pagination ? { pagination } : {}),\n    ...(cli ? { cli } : {}),\n    ...(error ? { error } : {}),\n    ...(parsed.blob ? { blob: parsed.blob } : {}),\n    ...(parsed.blob == null && typeof data !== \"string\" ? { parsed: data } : {}),\n  };\n}\n\nfunction errorFromResponse(\n  response: Response,\n  method: string,\n  url: string,\n  parsed: ParsedBody,\n): OperationsApiClientError {\n  const headers = responseHeaders(response.headers);\n  const message =\n    headers[\"x-error\"] ||\n    messageFromBody(parsed.data) ||\n    `${method} ${url} failed with ${response.status}: ${\n      parsed.text || response.statusText\n    }`;\n  return new OperationsApiClientError(message, {\n    status: response.status,\n    method,\n    url,\n    responseBody: parsed.text,\n    responseData: parsed.data,\n    responseHeaders: headers,\n  });\n}\n\nfunction resolvePathParams(\n  path: string,\n  params: Record<string, string>,\n): { path: string; params: Record<string, string> } {\n  const queryParams = { ...params };\n  let resolvedPath = path;\n  const placeholders = [...path.matchAll(/\\{([^{}]+)\\}/g)]\n    .map((match) => match[1])\n    .filter((name): name is string => Boolean(name));\n  const argValues = parseArgsParam(params.args);\n  let consumedArgs = false;\n  const consumedDirectValues: string[] = [];\n\n  for (const [index, name] of placeholders.entries()) {\n    const directValue = queryParams[name];\n    const fallbackValue = directValue || argValues[index];\n    if (!fallbackValue) continue;\n\n    resolvedPath = resolvedPath.replace(`{${name}}`, encodeURIComponent(fallbackValue));\n    delete queryParams[name];\n    if (!directValue && argValues[index]) consumedArgs = true;\n    if (directValue) consumedDirectValues[index] = directValue;\n  }\n\n  const argsDuplicateResolvedPath =\n    argValues.length > 0 &&\n    argValues.length === consumedDirectValues.filter(Boolean).length &&\n    argValues.every((value, index) => value === consumedDirectValues[index]);\n\n  if (consumedArgs || argsDuplicateResolvedPath) {\n    delete queryParams.args;\n  }\n\n  return { path: resolvedPath, params: stripRunnerParams(queryParams) };\n}\n\nfunction parseArgsParam(value: string | undefined): string[] {\n  if (!value) return [];\n  const trimmed = value.trim();\n  if (!trimmed || trimmed === \"[]\" || trimmed.toLowerCase() === \"null\") return [];\n  try {\n    const parsed = JSON.parse(trimmed);\n    if (Array.isArray(parsed)) return parsed.map(String).filter(Boolean);\n  } catch {\n    // Fall back to comma-delimited args below.\n  }\n  return trimmed\n    .split(\",\")\n    .map((part) => part.trim())\n    .filter(Boolean);\n}\n\nfunction stripRunnerParams(params: Record<string, string>) {\n  const next = { ...params };\n  delete next.autoRun;\n  delete next.__autoRun;\n  return next;\n}\n\nfunction appendQuery(path: string, params: Record<string, string>) {\n  const query = new URLSearchParams(pruneParams(params)).toString();\n  if (!query) return path;\n  return `${path}${path.includes(\"?\") ? \"&\" : \"?\"}${query}`;\n}\n\nfunction pruneParams(params: Record<string, string>) {\n  return Object.fromEntries(Object.entries(params).filter(([, value]) => value !== \"\"));\n}\n\nfunction joinUrl(baseUrl: string | undefined, path: string) {\n  if (!baseUrl || /^https?:\\/\\//i.test(path)) return path;\n  return `${stripTrailingSlashes(baseUrl)}/${stripLeadingSlashes(path)}`;\n}\n\nfunction headerValue(headers: Record<string, string> | undefined, name: string) {\n  const wanted = name.toLowerCase();\n  for (const [key, value] of Object.entries(headers ?? {})) {\n    if (key.toLowerCase() === wanted) return value;\n  }\n  return undefined;\n}\n\nfunction responseHeaders(headers: Headers): Record<string, string> {\n  const out: Record<string, string> = {};\n  headers.forEach((value, key) => {\n    out[key.toLowerCase()] = value;\n  });\n  return out;\n}\n\nfunction paginationFromHeaders(headers: Record<string, string>): ExecutionPagination | undefined {\n  const pagination: ExecutionPagination = {};\n  const total = integerHeader(headers[\"x-total-count\"]);\n  const limit = integerHeader(headers[\"x-page-limit\"]);\n  const offset = integerHeader(headers[\"x-page-offset\"]);\n\n  if (total !== undefined) pagination.total = total;\n  if (limit !== undefined) pagination.limit = limit;\n  if (offset !== undefined) pagination.offset = offset;\n\n  const relation = headers[\"x-total-relation\"];\n  if (relation === \"eq\" || relation === \"gte\") pagination.totalRelation = relation;\n\n  const hasMore = booleanHeader(headers[\"x-has-more\"]);\n  if (hasMore !== undefined) pagination.hasMore = hasMore;\n\n  const cursor = headers[\"x-next-cursor\"];\n  if (cursor != null && cursor.trim() !== \"\") pagination.nextCursor = cursor;\n\n  if (booleanHeader(headers[\"x-truncated\"]) === true) pagination.truncated = true;\n\n  return Object.keys(pagination).length > 0 ? pagination : undefined;\n}\n\nfunction booleanHeader(value: string | undefined): boolean | undefined {\n  if (value == null || value.trim() === \"\") return undefined;\n  const normalized = value.trim().toLowerCase();\n  if (normalized === \"true\") return true;\n  if (normalized === \"false\") return false;\n  return undefined;\n}\n\nfunction integerHeader(value: string | undefined): number | undefined {\n  if (value == null || value.trim() === \"\") return undefined;\n  const parsed = parseInt(value, 10);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction shouldParseJson(text: string, contentType: string) {\n  const trimmed = text.trim();\n  return (\n    trimmed !== \"\" &&\n    (contentType.toLowerCase().includes(\"json\") ||\n      trimmed.startsWith(\"{\") ||\n      trimmed.startsWith(\"[\"))\n  );\n}\n\nfunction isClickyEnvelope(data: unknown): boolean {\n  if (!data || typeof data !== \"object\") return false;\n  const body = data as Record<string, unknown>;\n  return body.version != null && body.node != null && typeof body.node === \"object\";\n}\n\nfunction readClickyText(node: unknown): string | undefined {\n  if (!node || typeof node !== \"object\") return undefined;\n  const n = node as Record<string, unknown>;\n  if (typeof n.plain === \"string\" && n.plain !== \"\") return n.plain;\n  if (typeof n.text === \"string\" && n.text !== \"\") return n.text;\n  if (Array.isArray(n.children)) {\n    for (const child of n.children) {\n      const text = readClickyText(child);\n      if (text) return text;\n    }\n  }\n  return undefined;\n}\n\nfunction errorFromClickyEnvelope(data: unknown): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  const node = (data as Record<string, unknown>).node;\n  if (!node || typeof node !== \"object\") return undefined;\n  const n = node as Record<string, unknown>;\n  if (n.kind !== \"map\" || !Array.isArray(n.fields)) return undefined;\n\n  let errorText: string | undefined;\n  let failed = false;\n  for (const field of n.fields) {\n    if (!field || typeof field !== \"object\") continue;\n    const f = field as Record<string, unknown>;\n    if (f.name === \"Error\") errorText = readClickyText(f.value);\n    if (f.name === \"Success\" && readClickyText(f.value) === \"false\") failed = true;\n  }\n  return failed ? errorText : undefined;\n}\n\nfunction messageFromBody(data: unknown): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  const body = data as Record<string, unknown>;\n  if (typeof body.error === \"string\" && body.error) return body.error;\n  if (typeof body.message === \"string\" && body.message) return body.message;\n  return errorFromClickyEnvelope(data);\n}\n"],"names":["response","parsed"],"mappings":";;;;AAsCO,MAAM,iCAAiC,MAAM;AAAA,EAQlD,YACE,SACA,UAOI,IACJ;AACA,UAAM,OAAO;AAlBf;AACA;AACA;AACA;AACA;AACA;AAcE,SAAK,OAAO;AACZ,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ;AACtB,SAAK,MAAM,QAAQ;AACnB,SAAK,eAAe,QAAQ;AAC5B,SAAK,eAAe,QAAQ;AAC5B,SAAK,kBAAkB,QAAQ;AAAA,EACjC;AACF;AAwBO,SAAS,0BACd,UAA4C,IACjB;AAC3B,QAAM,UAAU,QAAQ,SAAS;AACjC,QAAM,cAAc,QAAQ,eAAe;AAE3C,iBAAe,YACb,MACA,SACkB;;AAClB,UAAM,UAAU,IAAI,QAAQ,IAAI;AAChC,UAAM,WAAW,QAAM,aAAQ,mBAAR,iCAAyB,SAAS;AACzD,WAAO,WAAW,IAAI,QAAQ,QAAQ,IAAI;AAAA,EAC5C;AAEA,iBAAe,QACb,MACA,QACA,OAGI,CAAA,GACe;AACnB,UAAM,MAAM,QAAQ,QAAQ,SAAS,IAAI;AACzC,UAAM,UAAU,MAAM,YAAY,KAAK,SAAS,EAAE,MAAM,QAAQ;AAChE,WAAO,QAAQ,KAAK;AAAA,MAClB,GAAG;AAAA,MACH;AAAA,MACA;AAAA,MACA,GAAI,QAAQ,cAAc,EAAE,aAAa,QAAQ,YAAA,IAAgB,CAAA;AAAA,IAAC,CACnE;AAAA,EACH;AAEA,iBAAe,iBAAuC;AACpD,UAAM,WAAW,MAAM,QAAQ,aAAa,OAAO;AAAA,MACjD,SAAS,EAAE,QAAQ,mBAAA;AAAA,IAAmB,CACvC;AACD,UAAM,SAAS,MAAM,iBAAiB,UAAU,MAAM;AACtD,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,kBAAkB,UAAU,OAAO,aAAa,MAAM;AAAA,IAC9D;AACA,WAAO,OAAO;AAAA,EAChB;AAEA,iBAAe,aAAa,MAAc,QAAgB,QAAgC;;AACxF,WAAQ,QAAM,aAAQ,kBAAR,iCAAwB,EAAE,MAAM,QAAQ,OAAA,OAAc;AAAA,EACtE;AAEA,SAAO;AAAA,IACL;AAAA,IAEA,MAAM,eAAe,MAAM,QAAQ,QAAQ,SAAS;AAClD,YAAM,QAAQ,OAAO,YAAA;AACrB,YAAM,WAAW,kBAAkB,MAAM,MAAM;AAC/C,YAAM,SAAS,MAAM,aAAa,SAAS,MAAM,OAAO,SAAS,MAAM;AACvE,YAAM,SAAS,YAAY,SAAS,QAAQ;AAE5C,UAAI,UAAU,OAAO;AACnB,cAAM,aAAa,YAAY,SAAS,MAAM,MAAM;AACpD,cAAMA,YAAW,MAAM,QAAQ,YAAY,OAAO;AAAA,UAChD,GAAI,UAAU,EAAE,QAAA,IAAY,CAAA;AAAA,UAC5B;AAAA,QAAA,CACD;AACD,eAAO,uBAAuBA,WAAU,MAAM,iBAAiBA,WAAU,aAAa,MAAM,CAAC,GAAG;AAAA,UAC9F,QAAQ;AAAA,UACR;AAAA,QAAA,CACD;AAAA,MACH;AAEA,YAAM,WAAW,MAAM,QAAQ,SAAS,MAAM,OAAO;AAAA,QACnD,SAAS,EAAE,gBAAgB,oBAAoB,GAAG,QAAA;AAAA,QAClD,MAAM,KAAK,UAAU,MAAM;AAAA,MAAA,CAC5B;AACD,aAAO,uBAAuB,UAAU,MAAM,iBAAiB,UAAU,aAAa,MAAM,CAAC,GAAG;AAAA,QAC9F,QAAQ;AAAA,QACR,YAAY,SAAS;AAAA,MAAA,CACtB;AAAA,IACH;AAAA,IAEA,MAAM,mBAAmB,MAAM,MAAM,SAAS;AAC5C,YAAM,SAAS,YAAY,SAAS,QAAQ;AAC5C,YAAM,WAAW,MAAM,QAAQ,MAAM,QAAQ;AAAA,QAC3C,SAAS,EAAE,gBAAgB,oBAAoB,GAAG,QAAA;AAAA,QAClD,MAAM,KAAK,UAAU,IAAI;AAAA,MAAA,CAC1B;AACD,aAAO,uBAAuB,UAAU,MAAM,iBAAiB,UAAU,aAAa,MAAM,CAAC,GAAG;AAAA,QAC9F,QAAQ;AAAA,QACR,YAAY;AAAA,MAAA,CACb;AAAA,IACH;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,MAAM,UAAU,MAAM;AACpB,YAAM,WAAW,MAAM,QAAQ,MAAM,OAAO;AAAA,QAC1C,SAAS,EAAE,QAAQ,0BAAA;AAAA,MAA0B,CAC9C;AACD,UAAI,CAAC,SAAS,GAAI,QAAO;AACzB,YAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;AAC5D,UAAI,CAAC,YAAY,YAAA,EAAc,SAAS,QAAQ,EAAG,QAAO;AAC1D,YAAM,SAAS,MAAM,iBAAiB,UAAU,MAAM;AACtD,YAAM,OAAO,OAAO;AACpB,aAAO,QAAQ,OAAO,SAAS,WAAY,OAA4B;AAAA,IACzE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,MAAM,WAAW,MAAM,QAAQ,MAAM,SAAS;AAC5C,YAAM,QAAQ,OAAO,YAAA;AACrB,YAAM,WAAW,MAAM,QAAQ,MAAM,OAAO;AAAA,QAC1C,SAAS,EAAE,gBAAgB,oBAAoB,GAAG,QAAA;AAAA,QAClD,MAAM,KAAK,UAAU,IAAI;AAAA,MAAA,CAC1B;AACD,aAAO,uBAAuB,UAAU,MAAM,iBAAiB,UAAU,MAAM,GAAG;AAAA,QAChF,QAAQ;AAAA,QACR,YAAY;AAAA,MAAA,CACb;AAAA,IACH;AAAA,IAEA,MAAM,cAAc,MAAM,QAAQ,QAAQ,SAAS;AACjD,YAAM,QAAQ,OAAO,YAAA;AACrB,YAAM,WAAW,kBAAkB,MAAM,MAAM;AAE/C,UAAI,UAAU,OAAO;AACnB,cAAM,aAAa,YAAY,SAAS,MAAM,EAAE,GAAG,SAAS,QAAQ,UAAU,WAAW;AACzF,cAAMA,YAAW,MAAM,QAAQ,YAAY,OAAO;AAAA,UAChD,SAAS,EAAE,QAAQ,2BAA2B,GAAG,QAAA;AAAA,QAAQ,CAC1D;AACD,YAAIA,UAAS,WAAW,YAAY,EAAE,SAAS,CAAA,EAAC;AAChD,cAAMC,UAAS,MAAM,iBAAiBD,WAAU,MAAM;AACtD,YAAI,CAACA,UAAS,GAAI,OAAM,kBAAkBA,WAAU,OAAO,YAAYC,OAAM;AAC7E,eAAQA,QAAO,QAAgD,EAAE,SAAS,CAAA,EAAC;AAAA,MAC7E;AAEA,YAAM,WAAW,MAAM,QAAQ,YAAY,SAAS,MAAM,EAAE,UAAU,WAAW,GAAG,OAAO;AAAA,QACzF,SAAS;AAAA,UACP,QAAQ;AAAA,UACR,gBAAgB;AAAA,UAChB,GAAG;AAAA,QAAA;AAAA,QAEL,MAAM,KAAK,UAAU,SAAS,MAAM;AAAA,MAAA,CACrC;AACD,UAAI,SAAS,WAAW,YAAY,EAAE,SAAS,CAAA,EAAC;AAChD,YAAM,SAAS,MAAM,iBAAiB,UAAU,MAAM;AACtD,UAAI,CAAC,SAAS,GAAI,OAAM,kBAAkB,UAAU,OAAO,SAAS,MAAM,MAAM;AAChF,aAAQ,OAAO,QAAgD,EAAE,SAAS,CAAA,EAAC;AAAA,IAC7E;AAAA,IAEA,MAAM,oBAAoB,MAAM,QAAQ,WAAW,OAAO,aAAa;;AACrE,YAAM,QAAQ,OAAO,YAAA;AAIrB,YAAM,WAAW,kBAAkB,MAAM,eAAe,CAAA,CAAE;AAC1D,YAAM,cAAc;AAAA,QAClB,GAAG,SAAS;AAAA,QACZ,UAAU;AAAA,QACV,iBAAiB;AAAA,QACjB,YAAY;AAAA,MAAA;AAGd,YAAM,cAAc,YAAY,SAAS,MAAM,WAAW;AAC1D,YAAM,WAAW,MAAM,QAAQ,aAAa,OAAO;AAAA,QACjD,SAAS,EAAE,QAAQ,0BAAA;AAAA,MAA0B,CAC9C;AACD,YAAM,SAAS,MAAM,iBAAiB,UAAU,MAAM;AACtD,UAAI,CAAC,SAAS,GAAI,OAAM,kBAAkB,UAAU,OAAO,aAAa,MAAM;AAC9E,eAAS,kBAAO,SAAP,mBAAqD,YAArD,mBAA+D,eACtE,CAAA;AAAA,IACJ;AAAA,EAAA;AAEJ;AAEA,SAAS,aAAa,QAA2C;AAC/D,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,aAAa,OAAO,YAAA;AAC1B,MAAI,WAAW,SAAS,iBAAiB,EAAG,QAAO;AACnD,MACE,WAAW,SAAS,OAAO,KAC3B,WAAW,SAAS,oBAAoB,KACxC,WAAW,SAAS,kBAAkB,GACtC;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AASA,eAAe,iBAAiB,UAAoB,MAAqD;AACvG,QAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;AAC5D,MAAI,SAAS,QAAQ;AACnB,UAAM,OAAO,MAAM,SAAS,KAAA;AAC5B,WAAO,EAAE,MAAM,QAAW,MAAM,YAAY,MAAM,YAAA;AAAA,EACpD;AAEA,QAAM,OAAO,MAAM,SAAS,KAAA;AAC5B,MAAI,SAAS,UAAU,CAAC,gBAAgB,MAAM,WAAW,GAAG;AAC1D,WAAO,EAAE,MAAM,MAAM,MAAM,YAAA;AAAA,EAC7B;AAEA,MAAI;AACF,WAAO,EAAE,MAAM,KAAK,MAAM,IAAI,GAAc,MAAM,YAAA;AAAA,EACpD,QAAQ;AACN,WAAO,EAAE,MAAM,MAAM,MAAM,YAAA;AAAA,EAC7B;AACF;AAEA,SAAS,uBACP,UACA,QACA,SACmB;AACnB,QAAM,UAAU,gBAAgB,SAAS,OAAO;AAChD,QAAM,OAAO,OAAO;AACpB,QAAM,SACJ,OAAO,QAAQ,OACX,aACA,OAAO,SAAS,WACd,OACA,OAAO,QAAQ,KAAK,UAAU,MAAM,MAAM,CAAC;AACnD,QAAM,iBAAiB,iBAAiB,IAAI;AAE5C,MAAI,CAAC,SAAS,MAAM,CAAC,gBAAgB;AACnC,UAAM,kBAAkB,UAAU,QAAQ,QAAQ,QAAQ,YAAY,MAAM;AAAA,EAC9E;AAEA,QAAM,cAAc,wBAAwB,IAAI;AAChD,QAAM,gBAAgB,QAAQ,qBAAqB;AACnD,QAAM,UAAU,iBAAiB,OAAO,SAAS,MAAM,CAAC,cAAc,kBAAkB;AACxF,QAAM,WAAW,SAAS,QAAQ,aAAa,MAAM,UAAU,MAAM,MAAM,EAAE;AAC7E,QAAM,MAAM,QAAQ,eAAe;AACnC,QAAM,QAAQ,QAAQ,SAAS,KAAK;AACpC,QAAM,aAAa,sBAAsB,OAAO;AAEhD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,WAAW,OAAO,SAAS,QAAQ,IAAI,WAAW,UAAU,IAAI;AAAA,IAChE,aAAa,OAAO,eAAe,QAAQ,cAAc,KAAK;AAAA,IAC9D,YAAY,QAAQ;AAAA,IACpB,iBAAiB;AAAA,IACjB,GAAI,aAAa,EAAE,WAAA,IAAe,CAAA;AAAA,IAClC,GAAI,MAAM,EAAE,IAAA,IAAQ,CAAA;AAAA,IACpB,GAAI,QAAQ,EAAE,MAAA,IAAU,CAAA;AAAA,IACxB,GAAI,OAAO,OAAO,EAAE,MAAM,OAAO,KAAA,IAAS,CAAA;AAAA,IAC1C,GAAI,OAAO,QAAQ,QAAQ,OAAO,SAAS,WAAW,EAAE,QAAQ,SAAS,CAAA;AAAA,EAAC;AAE9E;AAEA,SAAS,kBACP,UACA,QACA,KACA,QAC0B;AAC1B,QAAM,UAAU,gBAAgB,SAAS,OAAO;AAChD,QAAM,UACJ,QAAQ,SAAS,KACjB,gBAAgB,OAAO,IAAI,KAC3B,GAAG,MAAM,IAAI,GAAG,gBAAgB,SAAS,MAAM,KAC7C,OAAO,QAAQ,SAAS,UAC1B;AACF,SAAO,IAAI,yBAAyB,SAAS;AAAA,IAC3C,QAAQ,SAAS;AAAA,IACjB;AAAA,IACA;AAAA,IACA,cAAc,OAAO;AAAA,IACrB,cAAc,OAAO;AAAA,IACrB,iBAAiB;AAAA,EAAA,CAClB;AACH;AAEA,SAAS,kBACP,MACA,QACkD;AAClD,QAAM,cAAc,EAAE,GAAG,OAAA;AACzB,MAAI,eAAe;AACnB,QAAM,eAAe,CAAC,GAAG,KAAK,SAAS,eAAe,CAAC,EACpD,IAAI,CAAC,UAAU,MAAM,CAAC,CAAC,EACvB,OAAO,CAAC,SAAyB,QAAQ,IAAI,CAAC;AACjD,QAAM,YAAY,eAAe,OAAO,IAAI;AAC5C,MAAI,eAAe;AACnB,QAAM,uBAAiC,CAAA;AAEvC,aAAW,CAAC,OAAO,IAAI,KAAK,aAAa,WAAW;AAClD,UAAM,cAAc,YAAY,IAAI;AACpC,UAAM,gBAAgB,eAAe,UAAU,KAAK;AACpD,QAAI,CAAC,cAAe;AAEpB,mBAAe,aAAa,QAAQ,IAAI,IAAI,KAAK,mBAAmB,aAAa,CAAC;AAClF,WAAO,YAAY,IAAI;AACvB,QAAI,CAAC,eAAe,UAAU,KAAK,EAAG,gBAAe;AACrD,QAAI,YAAa,sBAAqB,KAAK,IAAI;AAAA,EACjD;AAEA,QAAM,4BACJ,UAAU,SAAS,KACnB,UAAU,WAAW,qBAAqB,OAAO,OAAO,EAAE,UAC1D,UAAU,MAAM,CAAC,OAAO,UAAU,UAAU,qBAAqB,KAAK,CAAC;AAEzE,MAAI,gBAAgB,2BAA2B;AAC7C,WAAO,YAAY;AAAA,EACrB;AAEA,SAAO,EAAE,MAAM,cAAc,QAAQ,kBAAkB,WAAW,EAAA;AACpE;AAEA,SAAS,eAAe,OAAqC;AAC3D,MAAI,CAAC,MAAO,QAAO,CAAA;AACnB,QAAM,UAAU,MAAM,KAAA;AACtB,MAAI,CAAC,WAAW,YAAY,QAAQ,QAAQ,YAAA,MAAkB,OAAQ,QAAO,CAAA;AAC7E,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,OAAO;AACjC,QAAI,MAAM,QAAQ,MAAM,EAAG,QAAO,OAAO,IAAI,MAAM,EAAE,OAAO,OAAO;AAAA,EACrE,QAAQ;AAAA,EAER;AACA,SAAO,QACJ,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,KAAA,CAAM,EACzB,OAAO,OAAO;AACnB;AAEA,SAAS,kBAAkB,QAAgC;AACzD,QAAM,OAAO,EAAE,GAAG,OAAA;AAClB,SAAO,KAAK;AACZ,SAAO,KAAK;AACZ,SAAO;AACT;AAEA,SAAS,YAAY,MAAc,QAAgC;AACjE,QAAM,QAAQ,IAAI,gBAAgB,YAAY,MAAM,CAAC,EAAE,SAAA;AACvD,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,GAAG,IAAI,GAAG,KAAK,SAAS,GAAG,IAAI,MAAM,GAAG,GAAG,KAAK;AACzD;AAEA,SAAS,YAAY,QAAgC;AACnD,SAAO,OAAO,YAAY,OAAO,QAAQ,MAAM,EAAE,OAAO,CAAC,CAAA,EAAG,KAAK,MAAM,UAAU,EAAE,CAAC;AACtF;AAEA,SAAS,QAAQ,SAA6B,MAAc;AAC1D,MAAI,CAAC,WAAW,gBAAgB,KAAK,IAAI,EAAG,QAAO;AACnD,SAAO,GAAG,qBAAqB,OAAO,CAAC,IAAI,oBAAoB,IAAI,CAAC;AACtE;AAEA,SAAS,YAAY,SAA6C,MAAc;AAC9E,QAAM,SAAS,KAAK,YAAA;AACpB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,WAAW,CAAA,CAAE,GAAG;AACxD,QAAI,IAAI,kBAAkB,OAAQ,QAAO;AAAA,EAC3C;AACA,SAAO;AACT;AAEA,SAAS,gBAAgB,SAA0C;AACjE,QAAM,MAA8B,CAAA;AACpC,UAAQ,QAAQ,CAAC,OAAO,QAAQ;AAC9B,QAAI,IAAI,YAAA,CAAa,IAAI;AAAA,EAC3B,CAAC;AACD,SAAO;AACT;AAEA,SAAS,sBAAsB,SAAkE;AAC/F,QAAM,aAAkC,CAAA;AACxC,QAAM,QAAQ,cAAc,QAAQ,eAAe,CAAC;AACpD,QAAM,QAAQ,cAAc,QAAQ,cAAc,CAAC;AACnD,QAAM,SAAS,cAAc,QAAQ,eAAe,CAAC;AAErD,MAAI,UAAU,OAAW,YAAW,QAAQ;AAC5C,MAAI,UAAU,OAAW,YAAW,QAAQ;AAC5C,MAAI,WAAW,OAAW,YAAW,SAAS;AAE9C,QAAM,WAAW,QAAQ,kBAAkB;AAC3C,MAAI,aAAa,QAAQ,aAAa,kBAAkB,gBAAgB;AAExE,QAAM,UAAU,cAAc,QAAQ,YAAY,CAAC;AACnD,MAAI,YAAY,OAAW,YAAW,UAAU;AAEhD,QAAM,SAAS,QAAQ,eAAe;AACtC,MAAI,UAAU,QAAQ,OAAO,WAAW,eAAe,aAAa;AAEpE,MAAI,cAAc,QAAQ,aAAa,CAAC,MAAM,iBAAiB,YAAY;AAE3E,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,aAAa;AAC3D;AAEA,SAAS,cAAc,OAAgD;AACrE,MAAI,SAAS,QAAQ,MAAM,KAAA,MAAW,GAAI,QAAO;AACjD,QAAM,aAAa,MAAM,KAAA,EAAO,YAAA;AAChC,MAAI,eAAe,OAAQ,QAAO;AAClC,MAAI,eAAe,QAAS,QAAO;AACnC,SAAO;AACT;AAEA,SAAS,cAAc,OAA+C;AACpE,MAAI,SAAS,QAAQ,MAAM,KAAA,MAAW,GAAI,QAAO;AACjD,QAAM,SAAS,SAAS,OAAO,EAAE;AACjC,SAAO,OAAO,SAAS,MAAM,IAAI,SAAS;AAC5C;AAEA,SAAS,gBAAgB,MAAc,aAAqB;AAC1D,QAAM,UAAU,KAAK,KAAA;AACrB,SACE,YAAY,OACX,YAAY,YAAA,EAAc,SAAS,MAAM,KACxC,QAAQ,WAAW,GAAG,KACtB,QAAQ,WAAW,GAAG;AAE5B;AAEA,SAAS,iBAAiB,MAAwB;AAChD,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,OAAO;AACb,SAAO,KAAK,WAAW,QAAQ,KAAK,QAAQ,QAAQ,OAAO,KAAK,SAAS;AAC3E;AAEA,SAAS,eAAe,MAAmC;AACzD,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,IAAI;AACV,MAAI,OAAO,EAAE,UAAU,YAAY,EAAE,UAAU,WAAW,EAAE;AAC5D,MAAI,OAAO,EAAE,SAAS,YAAY,EAAE,SAAS,WAAW,EAAE;AAC1D,MAAI,MAAM,QAAQ,EAAE,QAAQ,GAAG;AAC7B,eAAW,SAAS,EAAE,UAAU;AAC9B,YAAM,OAAO,eAAe,KAAK;AACjC,UAAI,KAAM,QAAO;AAAA,IACnB;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,wBAAwB,MAAmC;AAClE,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,OAAQ,KAAiC;AAC/C,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,IAAI;AACV,MAAI,EAAE,SAAS,SAAS,CAAC,MAAM,QAAQ,EAAE,MAAM,EAAG,QAAO;AAEzD,MAAI;AACJ,MAAI,SAAS;AACb,aAAW,SAAS,EAAE,QAAQ;AAC5B,QAAI,CAAC,SAAS,OAAO,UAAU,SAAU;AACzC,UAAM,IAAI;AACV,QAAI,EAAE,SAAS,QAAS,aAAY,eAAe,EAAE,KAAK;AAC1D,QAAI,EAAE,SAAS,aAAa,eAAe,EAAE,KAAK,MAAM,QAAS,UAAS;AAAA,EAC5E;AACA,SAAO,SAAS,YAAY;AAC9B;AAEA,SAAS,gBAAgB,MAAmC;AAC1D,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,OAAO;AACb,MAAI,OAAO,KAAK,UAAU,YAAY,KAAK,cAAc,KAAK;AAC9D,MAAI,OAAO,KAAK,YAAY,YAAY,KAAK,gBAAgB,KAAK;AAClE,SAAO,wBAAwB,IAAI;AACrC;"}
+{"version":3,"file":"apiClient.js","sources":["../../src/rpc/apiClient.ts"],"sourcesContent":["import type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport { stripLeadingSlashes, stripTrailingSlashes } from \"../lib/string\";\nimport type {\n  ExecutionPagination,\n  ExecutionResponse,\n  OpenAPISpec,\n  OperationLookupFilter,\n  OperationLookupResponse,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\ntype MaybePromise<T> = T | Promise<T>;\n\n/** Operation catalog: an OpenAPI document whose response schemas may be stubs. */\nexport const CLICKY_OPENAPI_MEDIA_TYPE = \"application/vnd.clicky.openapi+json\";\n\nexport type OperationApiClientContext = {\n  path: string;\n  method: string;\n};\n\nexport type OperationDefaultParams = (context: {\n  path: string;\n  method: string;\n  params: Record<string, string>;\n}) => MaybePromise<Record<string, string>>;\n\nexport type OperationHeadersProvider = (\n  headers: Headers,\n  context: OperationApiClientContext,\n) => MaybePromise<HeadersInit | void>;\n\nexport type CreateOperationsApiClientOptions = {\n  baseUrl?: string;\n  openApiPath?: string;\n  credentials?: RequestCredentials;\n  fetch?: typeof fetch;\n  prepareHeaders?: OperationHeadersProvider;\n  defaultParams?: OperationDefaultParams;\n};\n\nexport class OperationsApiClientError extends Error {\n  status: number | undefined;\n  method: string | undefined;\n  url: string | undefined;\n  responseBody: string | undefined;\n  responseData: unknown;\n  responseHeaders: Record<string, string> | undefined;\n\n  constructor(\n    message: string,\n    // Each field mirrors the property it lands on, undefined included: a caller\n    // rebuilding an error from a partial response should not have to spread\n    // conditionally to say \"this one is unknown\".\n    options: {\n      status?: number | undefined;\n      method?: string | undefined;\n      url?: string | undefined;\n      responseBody?: string | undefined;\n      responseData?: unknown;\n      responseHeaders?: Record<string, string> | undefined;\n    } = {},\n  ) {\n    super(message);\n    this.name = \"OperationsApiClientError\";\n    this.status = options.status;\n    this.method = options.method;\n    this.url = options.url;\n    this.responseBody = options.responseBody;\n    this.responseData = options.responseData;\n    this.responseHeaders = options.responseHeaders;\n  }\n}\n\nexport interface SharedOperationsApiClient extends OperationsApiClient {\n  lookupFilterOptions(\n    path: string,\n    method: string,\n    filterKey: string,\n    query: string,\n    extraParams?: Record<string, string>,\n  ): Promise<OperationLookupFilter>;\n  executeCommandBody(\n    path: string,\n    body: Record<string, unknown>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n  getSchema(path: string): Promise<JsonSchemaObject | undefined>;\n  submitForm(\n    path: string,\n    method: string,\n    body: Record<string, unknown>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n}\n\nexport function createOperationsApiClient(\n  options: CreateOperationsApiClientOptions = {},\n): SharedOperationsApiClient {\n  const fetcher = options.fetch ?? fetch;\n  const openApiPath = options.openApiPath ?? \"/api/openapi.json\";\n\n  async function makeHeaders(\n    base: HeadersInit | undefined,\n    context: OperationApiClientContext,\n  ): Promise<Headers> {\n    const headers = new Headers(base);\n    const prepared = await options.prepareHeaders?.(headers, context);\n    return prepared ? new Headers(prepared) : headers;\n  }\n\n  async function request(\n    path: string,\n    method: string,\n    init: Omit<RequestInit, \"method\" | \"headers\" | \"credentials\"> & {\n      headers?: HeadersInit;\n      requestUrl?: string;\n    } = {},\n  ): Promise<Response> {\n    const url = joinUrl(options.baseUrl, path);\n    const headers = await makeHeaders(init.headers, { path, method });\n    return fetcher(url, {\n      ...init,\n      method,\n      headers,\n      ...(options.credentials ? { credentials: options.credentials } : {}),\n    });\n  }\n\n  async function getOpenAPISpec(): Promise<OpenAPISpec> {\n    const response = await request(openApiPath, \"GET\", {\n      // Prefer the catalog projection — the same document with each operation's\n      // response schemas stubbed, which nothing here reads and which is over\n      // half the bytes. A server that does not serve it answers with the\n      // complete document, which parses the same.\n      headers: {\n        Accept: `${CLICKY_OPENAPI_MEDIA_TYPE}, application/json;q=0.9`,\n      },\n    });\n    const parsed = await readResponseBody(response, \"json\");\n    if (!response.ok) {\n      throw errorFromResponse(response, \"GET\", openApiPath, parsed);\n    }\n    return parsed.data as OpenAPISpec;\n  }\n\n  async function withDefaults(path: string, method: string, params: Record<string, string>) {\n    return (await options.defaultParams?.({ path, method, params })) ?? params;\n  }\n\n  return {\n    getOpenAPISpec,\n\n    async executeCommand(path, method, params, headers) {\n      const upper = method.toUpperCase();\n      const resolved = resolvePathParams(path, params);\n      const scoped = await withDefaults(resolved.path, upper, resolved.params);\n      const accept = headerValue(headers, \"Accept\");\n\n      if (upper === \"GET\") {\n        const requestUrl = appendQuery(resolved.path, scoped);\n        const response = await request(requestUrl, upper, {\n          ...(headers ? { headers } : {}),\n          requestUrl,\n        });\n        return parseExecutionResponse(response, await readResponseBody(response, responseKind(accept)), {\n          method: upper,\n          requestUrl,\n        });\n      }\n\n      const response = await request(resolved.path, upper, {\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify(scoped),\n      });\n      return parseExecutionResponse(response, await readResponseBody(response, responseKind(accept)), {\n        method: upper,\n        requestUrl: resolved.path,\n      });\n    },\n\n    async executeCommandBody(path, body, headers) {\n      const accept = headerValue(headers, \"Accept\");\n      const response = await request(path, \"POST\", {\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify(body),\n      });\n      return parseExecutionResponse(response, await readResponseBody(response, responseKind(accept)), {\n        method: \"POST\",\n        requestUrl: path,\n      });\n    },\n\n    // getSchema fetches a resource's JSON Schema via content negotiation\n    // (Accept: application/schema+json on the same endpoint). It returns\n    // undefined when the resource serves no schema (the request falls through to\n    // its data representation), so callers can fall back to a parameter form.\n    async getSchema(path) {\n      const response = await request(path, \"GET\", {\n        headers: { Accept: \"application/schema+json\" },\n      });\n      if (!response.ok) return undefined;\n      const contentType = response.headers.get(\"Content-Type\") || \"\";\n      if (!contentType.toLowerCase().includes(\"schema\")) return undefined;\n      const parsed = await readResponseBody(response, \"json\");\n      const data = parsed.data;\n      return data && typeof data === \"object\" ? (data as JsonSchemaObject) : undefined;\n    },\n\n    // submitForm sends a nested JSON body with the given HTTP method (POST to\n    // create, PUT to update). Unlike executeCommand it preserves nested objects\n    // and arrays — the server reads the raw body (clicky's RequestFromContext),\n    // so connection `properties` and profile `provider`/`params`/`columns`\n    // survive intact.\n    async submitForm(path, method, body, headers) {\n      const upper = method.toUpperCase();\n      const response = await request(path, upper, {\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify(body),\n      });\n      return parseExecutionResponse(response, await readResponseBody(response, \"json\"), {\n        method: upper,\n        requestUrl: path,\n      });\n    },\n\n    async lookupFilters(path, method, params, headers) {\n      const upper = method.toUpperCase();\n      const resolved = resolvePathParams(path, params);\n\n      if (upper === \"GET\") {\n        const requestUrl = appendQuery(resolved.path, { ...resolved.params, __lookup: \"filters\" });\n        const response = await request(requestUrl, \"GET\", {\n          headers: { Accept: \"application/json+clicky\", ...headers },\n        });\n        if (response.status === 404) return { filters: {} };\n        const parsed = await readResponseBody(response, \"json\");\n        if (!response.ok) throw errorFromResponse(response, \"GET\", requestUrl, parsed);\n        return (parsed.data as OperationLookupResponse | undefined) ?? { filters: {} };\n      }\n\n      const response = await request(appendQuery(resolved.path, { __lookup: \"filters\" }), upper, {\n        headers: {\n          Accept: \"application/json+clicky\",\n          \"Content-Type\": \"application/json\",\n          ...headers,\n        },\n        body: JSON.stringify(resolved.params),\n      });\n      if (response.status === 404) return { filters: {} };\n      const parsed = await readResponseBody(response, \"json\");\n      if (!response.ok) throw errorFromResponse(response, upper, resolved.path, parsed);\n      return (parsed.data as OperationLookupResponse | undefined) ?? { filters: {} };\n    },\n\n    async lookupFilterOptions(path, method, filterKey, query, extraParams) {\n      const upper = method.toUpperCase();\n      // Resolved against the supplied params, as lookupFilters does: a lookup on\n      // an operation with a templated path would otherwise request the literal\n      // \"{id}\" and the sibling values that scope the search would be lost.\n      const resolved = resolvePathParams(path, extraParams ?? {});\n      const queryParams = {\n        ...resolved.params,\n        __lookup: \"filters\",\n        __lookup_filter: filterKey,\n        __lookup_q: query,\n      };\n\n      const requestPath = appendQuery(resolved.path, queryParams);\n      const response = await request(requestPath, upper, {\n        headers: { Accept: \"application/json+clicky\" },\n      });\n      const parsed = await readResponseBody(response, \"json\");\n      if (!response.ok) throw errorFromResponse(response, upper, requestPath, parsed);\n      return ((parsed.data as OperationLookupResponse | undefined)?.filters?.[filterKey] ??\n        {}) as OperationLookupFilter;\n    },\n  };\n}\n\nfunction responseKind(accept?: string): \"json\" | \"text\" | \"blob\" {\n  if (!accept) return \"json\";\n  const normalized = accept.toLowerCase();\n  if (normalized.includes(\"application/pdf\")) return \"blob\";\n  if (\n    normalized.includes(\"text/\") ||\n    normalized.includes(\"application/x-yaml\") ||\n    normalized.includes(\"application/yaml\")\n  ) {\n    return \"text\";\n  }\n  return \"json\";\n}\n\nexport type ParsedBody = {\n  data: unknown;\n  text: string;\n  blob?: Blob;\n  contentType: string;\n};\n\nexport async function readResponseBody(response: Response, kind: \"json\" | \"text\" | \"blob\"): Promise<ParsedBody> {\n  const contentType = response.headers.get(\"Content-Type\") || \"\";\n  if (kind === \"blob\") {\n    const blob = await response.blob();\n    return { data: undefined, text: \"[binary]\", blob, contentType };\n  }\n\n  const text = await response.text();\n  if (kind === \"text\" || !shouldParseJson(text, contentType)) {\n    return { data: text, text, contentType };\n  }\n\n  try {\n    return { data: JSON.parse(text) as unknown, text, contentType };\n  } catch {\n    return { data: text, text, contentType };\n  }\n}\n\nfunction parseExecutionResponse(\n  response: Response,\n  parsed: ParsedBody,\n  context: { method: string; requestUrl: string },\n): ExecutionResponse {\n  const headers = responseHeaders(response.headers);\n  const data = parsed.data;\n  const stdout =\n    parsed.blob != null\n      ? \"[binary]\"\n      : typeof data === \"string\"\n        ? data\n        : parsed.text || JSON.stringify(data, null, 2);\n  const clickyEnvelope = isClickyEnvelope(data);\n\n  if (!response.ok && !clickyEnvelope) {\n    throw errorFromResponse(response, context.method, context.requestUrl, parsed);\n  }\n\n  const clickyError = errorFromClickyEnvelope(data);\n  const successHeader = headers[\"x-execution-success\"];\n  const success = successHeader == null ? response.ok && !clickyError : successHeader !== \"false\";\n  const exitCode = parseInt(headers[\"x-exit-code\"] ?? (success ? \"0\" : \"1\"), 10);\n  const cli = headers[\"x-cli-command\"];\n  const error = headers[\"x-error\"] || clickyError;\n  const pagination = paginationFromHeaders(headers);\n\n  return {\n    success,\n    stdout,\n    output: stdout,\n    exit_code: Number.isFinite(exitCode) ? exitCode : success ? 0 : 1,\n    contentType: parsed.contentType || headers[\"content-type\"] || \"application/json\",\n    requestUrl: context.requestUrl,\n    responseHeaders: headers,\n    ...(pagination ? { pagination } : {}),\n    ...(cli ? { cli } : {}),\n    ...(error ? { error } : {}),\n    ...(parsed.blob ? { blob: parsed.blob } : {}),\n    ...(parsed.blob == null && typeof data !== \"string\" ? { parsed: data } : {}),\n  };\n}\n\n// Exported because every fetch in the package has to fail the same way: with\n// the status, the URL and the parsed body attached, which is what\n// operationErrorDiagnostics reads back out to render ErrorDetails. A second\n// error-from-Response path would silently drop one of those again.\nexport function errorFromResponse(\n  response: Response,\n  method: string,\n  url: string,\n  parsed: ParsedBody,\n): OperationsApiClientError {\n  const headers = responseHeaders(response.headers);\n  const message =\n    headers[\"x-error\"] ||\n    messageFromBody(parsed.data) ||\n    `${method} ${url} failed with ${response.status}: ${\n      parsed.text || response.statusText\n    }`;\n  return new OperationsApiClientError(message, {\n    status: response.status,\n    method,\n    url,\n    responseBody: parsed.text,\n    responseData: parsed.data,\n    responseHeaders: headers,\n  });\n}\n\nfunction resolvePathParams(\n  path: string,\n  params: Record<string, string>,\n): { path: string; params: Record<string, string> } {\n  const queryParams = { ...params };\n  let resolvedPath = path;\n  const placeholders = [...path.matchAll(/\\{([^{}]+)\\}/g)]\n    .map((match) => match[1])\n    .filter((name): name is string => Boolean(name));\n  const argValues = parseArgsParam(params.args);\n  let consumedArgs = false;\n  const consumedDirectValues: string[] = [];\n\n  for (const [index, name] of placeholders.entries()) {\n    const directValue = queryParams[name];\n    const fallbackValue = directValue || argValues[index];\n    if (!fallbackValue) continue;\n\n    resolvedPath = resolvedPath.replace(`{${name}}`, encodeURIComponent(fallbackValue));\n    delete queryParams[name];\n    if (!directValue && argValues[index]) consumedArgs = true;\n    if (directValue) consumedDirectValues[index] = directValue;\n  }\n\n  const argsDuplicateResolvedPath =\n    argValues.length > 0 &&\n    argValues.length === consumedDirectValues.filter(Boolean).length &&\n    argValues.every((value, index) => value === consumedDirectValues[index]);\n\n  if (consumedArgs || argsDuplicateResolvedPath) {\n    delete queryParams.args;\n  }\n\n  return { path: resolvedPath, params: stripRunnerParams(queryParams) };\n}\n\nfunction parseArgsParam(value: string | undefined): string[] {\n  if (!value) return [];\n  const trimmed = value.trim();\n  if (!trimmed || trimmed === \"[]\" || trimmed.toLowerCase() === \"null\") return [];\n  try {\n    const parsed = JSON.parse(trimmed);\n    if (Array.isArray(parsed)) return parsed.map(String).filter(Boolean);\n  } catch {\n    // Fall back to comma-delimited args below.\n  }\n  return trimmed\n    .split(\",\")\n    .map((part) => part.trim())\n    .filter(Boolean);\n}\n\nfunction stripRunnerParams(params: Record<string, string>) {\n  const next = { ...params };\n  delete next.autoRun;\n  delete next.__autoRun;\n  return next;\n}\n\nfunction appendQuery(path: string, params: Record<string, string>) {\n  const query = new URLSearchParams(pruneParams(params)).toString();\n  if (!query) return path;\n  return `${path}${path.includes(\"?\") ? \"&\" : \"?\"}${query}`;\n}\n\nfunction pruneParams(params: Record<string, string>) {\n  return Object.fromEntries(Object.entries(params).filter(([, value]) => value !== \"\"));\n}\n\nfunction joinUrl(baseUrl: string | undefined, path: string) {\n  if (!baseUrl || /^https?:\\/\\//i.test(path)) return path;\n  return `${stripTrailingSlashes(baseUrl)}/${stripLeadingSlashes(path)}`;\n}\n\nfunction headerValue(headers: Record<string, string> | undefined, name: string) {\n  const wanted = name.toLowerCase();\n  for (const [key, value] of Object.entries(headers ?? {})) {\n    if (key.toLowerCase() === wanted) return value;\n  }\n  return undefined;\n}\n\nfunction responseHeaders(headers: Headers): Record<string, string> {\n  const out: Record<string, string> = {};\n  headers.forEach((value, key) => {\n    out[key.toLowerCase()] = value;\n  });\n  return out;\n}\n\nfunction paginationFromHeaders(headers: Record<string, string>): ExecutionPagination | undefined {\n  const pagination: ExecutionPagination = {};\n  const total = integerHeader(headers[\"x-total-count\"]);\n  const limit = integerHeader(headers[\"x-page-limit\"]);\n  const offset = integerHeader(headers[\"x-page-offset\"]);\n\n  if (total !== undefined) pagination.total = total;\n  if (limit !== undefined) pagination.limit = limit;\n  if (offset !== undefined) pagination.offset = offset;\n\n  const relation = headers[\"x-total-relation\"];\n  if (relation === \"eq\" || relation === \"gte\") pagination.totalRelation = relation;\n\n  const hasMore = booleanHeader(headers[\"x-has-more\"]);\n  if (hasMore !== undefined) pagination.hasMore = hasMore;\n\n  const cursor = headers[\"x-next-cursor\"];\n  if (cursor != null && cursor.trim() !== \"\") pagination.nextCursor = cursor;\n\n  if (booleanHeader(headers[\"x-truncated\"]) === true) pagination.truncated = true;\n\n  return Object.keys(pagination).length > 0 ? pagination : undefined;\n}\n\nfunction booleanHeader(value: string | undefined): boolean | undefined {\n  if (value == null || value.trim() === \"\") return undefined;\n  const normalized = value.trim().toLowerCase();\n  if (normalized === \"true\") return true;\n  if (normalized === \"false\") return false;\n  return undefined;\n}\n\nfunction integerHeader(value: string | undefined): number | undefined {\n  if (value == null || value.trim() === \"\") return undefined;\n  const parsed = parseInt(value, 10);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction shouldParseJson(text: string, contentType: string) {\n  const trimmed = text.trim();\n  return (\n    trimmed !== \"\" &&\n    (contentType.toLowerCase().includes(\"json\") ||\n      trimmed.startsWith(\"{\") ||\n      trimmed.startsWith(\"[\"))\n  );\n}\n\nfunction isClickyEnvelope(data: unknown): boolean {\n  if (!data || typeof data !== \"object\") return false;\n  const body = data as Record<string, unknown>;\n  return body.version != null && body.node != null && typeof body.node === \"object\";\n}\n\nfunction readClickyText(node: unknown): string | undefined {\n  if (!node || typeof node !== \"object\") return undefined;\n  const n = node as Record<string, unknown>;\n  if (typeof n.plain === \"string\" && n.plain !== \"\") return n.plain;\n  if (typeof n.text === \"string\" && n.text !== \"\") return n.text;\n  if (Array.isArray(n.children)) {\n    for (const child of n.children) {\n      const text = readClickyText(child);\n      if (text) return text;\n    }\n  }\n  return undefined;\n}\n\nfunction errorFromClickyEnvelope(data: unknown): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  const node = (data as Record<string, unknown>).node;\n  if (!node || typeof node !== \"object\") return undefined;\n  const n = node as Record<string, unknown>;\n  if (n.kind !== \"map\" || !Array.isArray(n.fields)) return undefined;\n\n  let errorText: string | undefined;\n  let failed = false;\n  for (const field of n.fields) {\n    if (!field || typeof field !== \"object\") continue;\n    const f = field as Record<string, unknown>;\n    if (f.name === \"Error\") errorText = readClickyText(f.value);\n    if (f.name === \"Success\" && readClickyText(f.value) === \"false\") failed = true;\n  }\n  return failed ? errorText : undefined;\n}\n\nfunction messageFromBody(data: unknown): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  const body = data as Record<string, unknown>;\n  if (typeof body.error === \"string\" && body.error) return body.error;\n  if (typeof body.message === \"string\" && body.message) return body.message;\n  return errorFromClickyEnvelope(data);\n}\n"],"names":["response","parsed"],"mappings":"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"}

package/dist/rpc/cursorStale.cjs

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const apiClient = require("./apiClient.cjs");
+const CURSOR_STALE_CODE = "cursor_stale";
+function isCursorStale(error) {
+  if (!(error instanceof apiClient.OperationsApiClientError)) return false;
+  const data = error.responseData;
+  if (typeof data !== "object" || data === null) return false;
+  return data.code === CURSOR_STALE_CODE;
+}
+function cursorParameterName(parameters) {
+  var _a;
+  return (_a = parameters.find((parameter) => {
+    var _a2;
+    return ((_a2 = parameter["x-clicky"]) == null ? void 0 : _a2.role) === "cursor";
+  })) == null ? void 0 : _a.name;
+}
+function useCursorStaleRecovery({
+  error,
+  parameters,
+  values,
+  setValues
+}) {
+  react.useEffect(() => {
+    if (!isCursorStale(error)) return;
+    const name = cursorParameterName(parameters);
+    if (!name || !values[name]) return;
+    setValues((current) => current[name] ? { ...current, [name]: "" } : current);
+  }, [error, parameters, values, setValues]);
+}
+exports.cursorParameterName = cursorParameterName;
+exports.isCursorStale = isCursorStale;
+exports.useCursorStaleRecovery = useCursorStaleRecovery;
+//# sourceMappingURL=cursorStale.cjs.map

package/dist/rpc/cursorStale.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorStale.cjs","sources":["../../src/rpc/cursorStale.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\nimport { OperationsApiClientError } from \"./apiClient\";\nimport type { ParameterValues, ParameterValuesSetter } from \"./formMetadata\";\nimport type { OpenAPIParameter } from \"./types\";\n\n/** The server's code for a cursor that no longer names a position in this query. */\nconst CURSOR_STALE_CODE = \"cursor_stale\";\n\n// isCursorStale reads the structured code rather than matching the message,\n// which is prose the server is free to reword.\nexport function isCursorStale(error: unknown): boolean {\n  if (!(error instanceof OperationsApiClientError)) return false;\n  const data = error.responseData;\n  if (typeof data !== \"object\" || data === null) return false;\n  return (data as { code?: unknown }).code === CURSOR_STALE_CODE;\n}\n\nexport function cursorParameterName(\n  parameters: readonly OpenAPIParameter[],\n): string | undefined {\n  return parameters.find((parameter) => parameter[\"x-clicky\"]?.role === \"cursor\")?.name;\n}\n\n/**\n * useCursorStaleRecovery restarts a walk whose position the server has refused.\n *\n * A stale cursor is always recoverable — the query is fine, only the position is\n * gone — so surfacing it as an error panel strands the user on a page they\n * cannot leave: the cursor lives in the URL as well as in the form, so a reload\n * replays the same rejected request. Clearing it through `setValues` is what\n * rewrites both, and the query re-runs from the first page on its own.\n *\n * Guarded on a cursor actually being set, so a server that answered\n * `cursor_stale` to a request carrying none cannot spin.\n */\nexport function useCursorStaleRecovery({\n  error,\n  parameters,\n  values,\n  setValues,\n}: {\n  error: unknown;\n  parameters: readonly OpenAPIParameter[];\n  values: ParameterValues;\n  setValues: ParameterValuesSetter;\n}) {\n  useEffect(() => {\n    if (!isCursorStale(error)) return;\n    const name = cursorParameterName(parameters);\n    if (!name || !values[name]) return;\n    setValues((current) => (current[name] ? { ...current, [name]: \"\" } : current));\n  }, [error, parameters, values, setValues]);\n}\n"],"names":["OperationsApiClientError","_a","useEffect"],"mappings":";;;;AAOA,MAAM,oBAAoB;AAInB,SAAS,cAAc,OAAyB;AACrD,MAAI,EAAE,iBAAiBA,oCAA2B,QAAO;AACzD,QAAM,OAAO,MAAM;AACnB,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,SAAQ,KAA4B,SAAS;AAC/C;AAEO,SAAS,oBACd,YACoB;;AACpB,UAAO,gBAAW,KAAK,CAAC,cAAA;;AAAc,aAAAC,MAAA,UAAU,UAAU,MAApB,gBAAAA,IAAuB,UAAS;AAAA,GAAQ,MAAvE,mBAA0E;AACnF;AAcO,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKG;AACDC,QAAAA,UAAU,MAAM;AACd,QAAI,CAAC,cAAc,KAAK,EAAG;AAC3B,UAAM,OAAO,oBAAoB,UAAU;AAC3C,QAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAG;AAC5B,cAAU,CAAC,YAAa,QAAQ,IAAI,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,GAAG,GAAA,IAAO,OAAQ;AAAA,EAC/E,GAAG,CAAC,OAAO,YAAY,QAAQ,SAAS,CAAC;AAC3C;;;;"}

package/dist/rpc/cursorStale.d.ts

@@ -0,0 +1,23 @@
+import { ParameterValues, ParameterValuesSetter } from './formMetadata';
+import { OpenAPIParameter } from './types';
+export declare function isCursorStale(error: unknown): boolean;
+export declare function cursorParameterName(parameters: readonly OpenAPIParameter[]): string | undefined;
+/**
+ * useCursorStaleRecovery restarts a walk whose position the server has refused.
+ *
+ * A stale cursor is always recoverable — the query is fine, only the position is
+ * gone — so surfacing it as an error panel strands the user on a page they
+ * cannot leave: the cursor lives in the URL as well as in the form, so a reload
+ * replays the same rejected request. Clearing it through `setValues` is what
+ * rewrites both, and the query re-runs from the first page on its own.
+ *
+ * Guarded on a cursor actually being set, so a server that answered
+ * `cursor_stale` to a request carrying none cannot spin.
+ */
+export declare function useCursorStaleRecovery({ error, parameters, values, setValues, }: {
+    error: unknown;
+    parameters: readonly OpenAPIParameter[];
+    values: ParameterValues;
+    setValues: ParameterValuesSetter;
+}): void;
+//# sourceMappingURL=cursorStale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursorStale.d.ts","sourceRoot":"","sources":["../../src/rpc/cursorStale.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAOhD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKrD;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,gBAAgB,EAAE,GACtC,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,UAAU,EACV,MAAM,EACN,SAAS,GACV,EAAE;IACD,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,qBAAqB,CAAC;CAClC,QAOA"}

package/dist/rpc/cursorStale.js

@@ -0,0 +1,35 @@
+import { useEffect } from "react";
+import { OperationsApiClientError } from "./apiClient.js";
+const CURSOR_STALE_CODE = "cursor_stale";
+function isCursorStale(error) {
+  if (!(error instanceof OperationsApiClientError)) return false;
+  const data = error.responseData;
+  if (typeof data !== "object" || data === null) return false;
+  return data.code === CURSOR_STALE_CODE;
+}
+function cursorParameterName(parameters) {
+  var _a;
+  return (_a = parameters.find((parameter) => {
+    var _a2;
+    return ((_a2 = parameter["x-clicky"]) == null ? void 0 : _a2.role) === "cursor";
+  })) == null ? void 0 : _a.name;
+}
+function useCursorStaleRecovery({
+  error,
+  parameters,
+  values,
+  setValues
+}) {
+  useEffect(() => {
+    if (!isCursorStale(error)) return;
+    const name = cursorParameterName(parameters);
+    if (!name || !values[name]) return;
+    setValues((current) => current[name] ? { ...current, [name]: "" } : current);
+  }, [error, parameters, values, setValues]);
+}
+export {
+  cursorParameterName,
+  isCursorStale,
+  useCursorStaleRecovery
+};
+//# sourceMappingURL=cursorStale.js.map

package/dist/rpc/cursorStale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorStale.js","sources":["../../src/rpc/cursorStale.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\nimport { OperationsApiClientError } from \"./apiClient\";\nimport type { ParameterValues, ParameterValuesSetter } from \"./formMetadata\";\nimport type { OpenAPIParameter } from \"./types\";\n\n/** The server's code for a cursor that no longer names a position in this query. */\nconst CURSOR_STALE_CODE = \"cursor_stale\";\n\n// isCursorStale reads the structured code rather than matching the message,\n// which is prose the server is free to reword.\nexport function isCursorStale(error: unknown): boolean {\n  if (!(error instanceof OperationsApiClientError)) return false;\n  const data = error.responseData;\n  if (typeof data !== \"object\" || data === null) return false;\n  return (data as { code?: unknown }).code === CURSOR_STALE_CODE;\n}\n\nexport function cursorParameterName(\n  parameters: readonly OpenAPIParameter[],\n): string | undefined {\n  return parameters.find((parameter) => parameter[\"x-clicky\"]?.role === \"cursor\")?.name;\n}\n\n/**\n * useCursorStaleRecovery restarts a walk whose position the server has refused.\n *\n * A stale cursor is always recoverable — the query is fine, only the position is\n * gone — so surfacing it as an error panel strands the user on a page they\n * cannot leave: the cursor lives in the URL as well as in the form, so a reload\n * replays the same rejected request. Clearing it through `setValues` is what\n * rewrites both, and the query re-runs from the first page on its own.\n *\n * Guarded on a cursor actually being set, so a server that answered\n * `cursor_stale` to a request carrying none cannot spin.\n */\nexport function useCursorStaleRecovery({\n  error,\n  parameters,\n  values,\n  setValues,\n}: {\n  error: unknown;\n  parameters: readonly OpenAPIParameter[];\n  values: ParameterValues;\n  setValues: ParameterValuesSetter;\n}) {\n  useEffect(() => {\n    if (!isCursorStale(error)) return;\n    const name = cursorParameterName(parameters);\n    if (!name || !values[name]) return;\n    setValues((current) => (current[name] ? { ...current, [name]: \"\" } : current));\n  }, [error, parameters, values, setValues]);\n}\n"],"names":["_a"],"mappings":";;AAOA,MAAM,oBAAoB;AAInB,SAAS,cAAc,OAAyB;AACrD,MAAI,EAAE,iBAAiB,0BAA2B,QAAO;AACzD,QAAM,OAAO,MAAM;AACnB,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,SAAQ,KAA4B,SAAS;AAC/C;AAEO,SAAS,oBACd,YACoB;;AACpB,UAAO,gBAAW,KAAK,CAAC,cAAA;;AAAc,aAAAA,MAAA,UAAU,UAAU,MAApB,gBAAAA,IAAuB,UAAS;AAAA,GAAQ,MAAvE,mBAA0E;AACnF;AAcO,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKG;AACD,YAAU,MAAM;AACd,QAAI,CAAC,cAAc,KAAK,EAAG;AAC3B,UAAM,OAAO,oBAAoB,UAAU;AAC3C,QAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAG;AAC5B,cAAU,CAAC,YAAa,QAAQ,IAAI,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,GAAG,GAAA,IAAO,OAAQ;AAAA,EAC/E,GAAG,CAAC,OAAO,YAAY,QAAQ,SAAS,CAAC;AAC3C;"}

package/dist/rpc/executionPages.cjs

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const clickyParse = require("../data/clicky-parse.cjs");
+function mergeExecutionPages(pages) {
+  const first = pages[0];
+  const last = pages[pages.length - 1];
+  if (!first || !last) return null;
+  if (pages.length === 1) return first;
+  const documents = pages.map(documentOf);
+  const base = documents[0];
+  if (!base || !findFirstTable(base.node)) return last;
+  const rows = [];
+  for (const [index, document] of documents.entries()) {
+    const table = document ? findFirstTable(document.node) : void 0;
+    if (!table) {
+      throw new Error(
+        `Cursor walk page ${index + 1} of ${pages.length} carries no table to append to the run`
+      );
+    }
+    rows.push(...table.rows ?? []);
+  }
+  const merged = {
+    version: 1,
+    node: mapFirstTable(base.node, (table) => ({ ...table, rows })).node
+  };
+  return {
+    ...last,
+    // The paging facts are the newest page's — how many rows exist and whether
+    // more follow are answers about now — but a download re-requests
+    // `requestUrl`, and the walk's identity is the request that named the query
+    // without naming a position inside it.
+    ...first.requestUrl !== void 0 ? { requestUrl: first.requestUrl } : {},
+    parsed: merged,
+    stdout: JSON.stringify(merged),
+    ...last.output !== void 0 ? { output: JSON.stringify(merged) } : {}
+  };
+}
+function documentOf(response) {
+  const payload = response.parsed ?? response.stdout ?? response.output ?? "";
+  if (typeof payload !== "string" && typeof payload !== "object") return void 0;
+  const parsed = clickyParse.parseClickyData(payload);
+  return parsed.ok ? parsed.document : void 0;
+}
+function findFirstTable(node) {
+  let found;
+  mapFirstTable(node, (table) => {
+    found = table;
+    return table;
+  });
+  return found;
+}
+function mapFirstTable(node, fn) {
+  if (node.kind === "table") return { node: fn(node), found: true };
+  const children = mapFirstIn(node.children, fn);
+  if (children) return { node: { ...node, children }, found: true };
+  const items = mapFirstIn(node.items, fn);
+  if (items) return { node: { ...node, items }, found: true };
+  if (node.fields) {
+    const values = mapFirstIn(
+      node.fields.map((field) => field.value),
+      fn
+    );
+    if (values) {
+      return {
+        node: {
+          ...node,
+          fields: node.fields.map((field, index) => ({
+            ...field,
+            value: values[index] ?? field.value
+          }))
+        },
+        found: true
+      };
+    }
+  }
+  if (node.content) {
+    const content = mapFirstTable(node.content, fn);
+    if (content.found) return { node: { ...node, content: content.node }, found: true };
+  }
+  return { node, found: false };
+}
+function mapFirstIn(nodes, fn) {
+  if (!nodes) return void 0;
+  for (const [index, child] of nodes.entries()) {
+    const mapped = mapFirstTable(child, fn);
+    if (!mapped.found) continue;
+    const next = [...nodes];
+    next[index] = mapped.node;
+    return next;
+  }
+  return void 0;
+}
+exports.mergeExecutionPages = mergeExecutionPages;
+//# sourceMappingURL=executionPages.cjs.map

package/dist/rpc/executionPages.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionPages.cjs","sources":["../../src/rpc/executionPages.ts"],"sourcesContent":["import type { ClickyDocument, ClickyNode, ClickyRow } from \"../data/Clicky\";\nimport { parseClickyData } from \"../data/clicky-parse\";\nimport type { ExecutionResponse } from \"./types\";\n\n/**\n * mergeExecutionPages stacks a cursor walk into the one document the default\n * result surface renders.\n *\n * The walk arrives unmerged because a page is a rendered document, not a row\n * array, and what stacking two of them means depends on what they contain. For\n * the clicky result surface the answer is knowable: the payload is a table, and\n * appending its rows in walk order is what \"one continuous list\" means. Every\n * other part of the document is the first page's, because the columns, the\n * headings and the shape are facts about the query rather than about the page.\n *\n * Callers hand over the whole walk on every render, so a single-page walk is\n * returned by identity — the common case must not churn the document and force\n * the table to rebuild rows nobody changed.\n */\nexport function mergeExecutionPages(\n  pages: readonly ExecutionResponse[],\n): ExecutionResponse | null {\n  const first = pages[0];\n  const last = pages[pages.length - 1];\n  if (!first || !last) return null;\n  if (pages.length === 1) return first;\n\n  const documents = pages.map(documentOf);\n  const base = documents[0];\n  // A walk whose pages are not tables has nothing to accumulate into — a\n  // detail document, say, served one at a time. The newest one is the whole of\n  // what there is to show.\n  if (!base || !findFirstTable(base.node)) return last;\n\n  const rows: ClickyRow[] = [];\n  for (const [index, document] of documents.entries()) {\n    const table = document ? findFirstTable(document.node) : undefined;\n    if (!table) {\n      // Loudly, because the alternative is deleting rows the reader has\n      // already scrolled past and calling it a shorter list.\n      throw new Error(\n        `Cursor walk page ${index + 1} of ${pages.length} carries no table to append to the run`,\n      );\n    }\n    rows.push(...(table.rows ?? []));\n  }\n\n  const merged: ClickyDocument = {\n    version: 1,\n    node: mapFirstTable(base.node, (table) => ({ ...table, rows })).node,\n  };\n\n  return {\n    ...last,\n    // The paging facts are the newest page's — how many rows exist and whether\n    // more follow are answers about now — but a download re-requests\n    // `requestUrl`, and the walk's identity is the request that named the query\n    // without naming a position inside it.\n    ...(first.requestUrl !== undefined ? { requestUrl: first.requestUrl } : {}),\n    parsed: merged,\n    stdout: JSON.stringify(merged),\n    ...(last.output !== undefined ? { output: JSON.stringify(merged) } : {}),\n  };\n}\n\n// The executor puts the decoded document on `parsed` and its bytes on\n// `stdout`; CommandOutput reads them in that order, so this does too or a\n// merged page could disagree with the one the renderer would have shown.\nfunction documentOf(response: ExecutionResponse): ClickyDocument | undefined {\n  const payload = response.parsed ?? response.stdout ?? response.output ?? \"\";\n  if (typeof payload !== \"string\" && typeof payload !== \"object\") return undefined;\n  const parsed = parseClickyData(payload as Parameters<typeof parseClickyData>[0]);\n  return parsed.ok ? parsed.document : undefined;\n}\n\nfunction findFirstTable(node: ClickyNode): ClickyNode | undefined {\n  let found: ClickyNode | undefined;\n  mapFirstTable(node, (table) => {\n    found = table;\n    return table;\n  });\n  return found;\n}\n\n/**\n * Rebuilds `node` with its first table — depth-first, in document order —\n * replaced by `fn`'s result. One traversal serves both finding a table and\n * rewriting it, so the page a walk reads rows out of is by construction the\n * page it writes them back into.\n */\nfunction mapFirstTable(\n  node: ClickyNode,\n  fn: (table: ClickyNode) => ClickyNode,\n): { node: ClickyNode; found: boolean } {\n  if (node.kind === \"table\") return { node: fn(node), found: true };\n\n  const children = mapFirstIn(node.children, fn);\n  if (children) return { node: { ...node, children }, found: true };\n\n  const items = mapFirstIn(node.items, fn);\n  if (items) return { node: { ...node, items }, found: true };\n\n  if (node.fields) {\n    const values = mapFirstIn(\n      node.fields.map((field) => field.value),\n      fn,\n    );\n    if (values) {\n      return {\n        node: {\n          ...node,\n          fields: node.fields.map((field, index) => ({\n            ...field,\n            value: values[index] ?? field.value,\n          })),\n        },\n        found: true,\n      };\n    }\n  }\n\n  if (node.content) {\n    const content = mapFirstTable(node.content, fn);\n    if (content.found) return { node: { ...node, content: content.node }, found: true };\n  }\n\n  return { node, found: false };\n}\n\n/** The rewritten list, or undefined when none of `nodes` held a table. */\nfunction mapFirstIn(\n  nodes: ClickyNode[] | undefined,\n  fn: (table: ClickyNode) => ClickyNode,\n): ClickyNode[] | undefined {\n  if (!nodes) return undefined;\n  for (const [index, child] of nodes.entries()) {\n    const mapped = mapFirstTable(child, fn);\n    if (!mapped.found) continue;\n    const next = [...nodes];\n    next[index] = mapped.node;\n    return next;\n  }\n  return undefined;\n}\n"],"names":["parseClickyData"],"mappings":"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"}

package/dist/rpc/executionPages.d.ts

@@ -0,0 +1,18 @@
+import { ExecutionResponse } from './types';
+/**
+ * mergeExecutionPages stacks a cursor walk into the one document the default
+ * result surface renders.
+ *
+ * The walk arrives unmerged because a page is a rendered document, not a row
+ * array, and what stacking two of them means depends on what they contain. For
+ * the clicky result surface the answer is knowable: the payload is a table, and
+ * appending its rows in walk order is what "one continuous list" means. Every
+ * other part of the document is the first page's, because the columns, the
+ * headings and the shape are facts about the query rather than about the page.
+ *
+ * Callers hand over the whole walk on every render, so a single-page walk is
+ * returned by identity — the common case must not churn the document and force
+ * the table to rebuild rows nobody changed.
+ */
+export declare function mergeExecutionPages(pages: readonly ExecutionResponse[]): ExecutionResponse | null;
+//# sourceMappingURL=executionPages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executionPages.d.ts","sourceRoot":"","sources":["../../src/rpc/executionPages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAClC,iBAAiB,GAAG,IAAI,CA0C1B"}

package/dist/rpc/executionPages.js

@@ -0,0 +1,94 @@
+import { parseClickyData } from "../data/clicky-parse.js";
+function mergeExecutionPages(pages) {
+  const first = pages[0];
+  const last = pages[pages.length - 1];
+  if (!first || !last) return null;
+  if (pages.length === 1) return first;
+  const documents = pages.map(documentOf);
+  const base = documents[0];
+  if (!base || !findFirstTable(base.node)) return last;
+  const rows = [];
+  for (const [index, document] of documents.entries()) {
+    const table = document ? findFirstTable(document.node) : void 0;
+    if (!table) {
+      throw new Error(
+        `Cursor walk page ${index + 1} of ${pages.length} carries no table to append to the run`
+      );
+    }
+    rows.push(...table.rows ?? []);
+  }
+  const merged = {
+    version: 1,
+    node: mapFirstTable(base.node, (table) => ({ ...table, rows })).node
+  };
+  return {
+    ...last,
+    // The paging facts are the newest page's — how many rows exist and whether
+    // more follow are answers about now — but a download re-requests
+    // `requestUrl`, and the walk's identity is the request that named the query
+    // without naming a position inside it.
+    ...first.requestUrl !== void 0 ? { requestUrl: first.requestUrl } : {},
+    parsed: merged,
+    stdout: JSON.stringify(merged),
+    ...last.output !== void 0 ? { output: JSON.stringify(merged) } : {}
+  };
+}
+function documentOf(response) {
+  const payload = response.parsed ?? response.stdout ?? response.output ?? "";
+  if (typeof payload !== "string" && typeof payload !== "object") return void 0;
+  const parsed = parseClickyData(payload);
+  return parsed.ok ? parsed.document : void 0;
+}
+function findFirstTable(node) {
+  let found;
+  mapFirstTable(node, (table) => {
+    found = table;
+    return table;
+  });
+  return found;
+}
+function mapFirstTable(node, fn) {
+  if (node.kind === "table") return { node: fn(node), found: true };
+  const children = mapFirstIn(node.children, fn);
+  if (children) return { node: { ...node, children }, found: true };
+  const items = mapFirstIn(node.items, fn);
+  if (items) return { node: { ...node, items }, found: true };
+  if (node.fields) {
+    const values = mapFirstIn(
+      node.fields.map((field) => field.value),
+      fn
+    );
+    if (values) {
+      return {
+        node: {
+          ...node,
+          fields: node.fields.map((field, index) => ({
+            ...field,
+            value: values[index] ?? field.value
+          }))
+        },
+        found: true
+      };
+    }
+  }
+  if (node.content) {
+    const content = mapFirstTable(node.content, fn);
+    if (content.found) return { node: { ...node, content: content.node }, found: true };
+  }
+  return { node, found: false };
+}
+function mapFirstIn(nodes, fn) {
+  if (!nodes) return void 0;
+  for (const [index, child] of nodes.entries()) {
+    const mapped = mapFirstTable(child, fn);
+    if (!mapped.found) continue;
+    const next = [...nodes];
+    next[index] = mapped.node;
+    return next;
+  }
+  return void 0;
+}
+export {
+  mergeExecutionPages
+};
+//# sourceMappingURL=executionPages.js.map

package/dist/rpc/executionPages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionPages.js","sources":["../../src/rpc/executionPages.ts"],"sourcesContent":["import type { ClickyDocument, ClickyNode, ClickyRow } from \"../data/Clicky\";\nimport { parseClickyData } from \"../data/clicky-parse\";\nimport type { ExecutionResponse } from \"./types\";\n\n/**\n * mergeExecutionPages stacks a cursor walk into the one document the default\n * result surface renders.\n *\n * The walk arrives unmerged because a page is a rendered document, not a row\n * array, and what stacking two of them means depends on what they contain. For\n * the clicky result surface the answer is knowable: the payload is a table, and\n * appending its rows in walk order is what \"one continuous list\" means. Every\n * other part of the document is the first page's, because the columns, the\n * headings and the shape are facts about the query rather than about the page.\n *\n * Callers hand over the whole walk on every render, so a single-page walk is\n * returned by identity — the common case must not churn the document and force\n * the table to rebuild rows nobody changed.\n */\nexport function mergeExecutionPages(\n  pages: readonly ExecutionResponse[],\n): ExecutionResponse | null {\n  const first = pages[0];\n  const last = pages[pages.length - 1];\n  if (!first || !last) return null;\n  if (pages.length === 1) return first;\n\n  const documents = pages.map(documentOf);\n  const base = documents[0];\n  // A walk whose pages are not tables has nothing to accumulate into — a\n  // detail document, say, served one at a time. The newest one is the whole of\n  // what there is to show.\n  if (!base || !findFirstTable(base.node)) return last;\n\n  const rows: ClickyRow[] = [];\n  for (const [index, document] of documents.entries()) {\n    const table = document ? findFirstTable(document.node) : undefined;\n    if (!table) {\n      // Loudly, because the alternative is deleting rows the reader has\n      // already scrolled past and calling it a shorter list.\n      throw new Error(\n        `Cursor walk page ${index + 1} of ${pages.length} carries no table to append to the run`,\n      );\n    }\n    rows.push(...(table.rows ?? []));\n  }\n\n  const merged: ClickyDocument = {\n    version: 1,\n    node: mapFirstTable(base.node, (table) => ({ ...table, rows })).node,\n  };\n\n  return {\n    ...last,\n    // The paging facts are the newest page's — how many rows exist and whether\n    // more follow are answers about now — but a download re-requests\n    // `requestUrl`, and the walk's identity is the request that named the query\n    // without naming a position inside it.\n    ...(first.requestUrl !== undefined ? { requestUrl: first.requestUrl } : {}),\n    parsed: merged,\n    stdout: JSON.stringify(merged),\n    ...(last.output !== undefined ? { output: JSON.stringify(merged) } : {}),\n  };\n}\n\n// The executor puts the decoded document on `parsed` and its bytes on\n// `stdout`; CommandOutput reads them in that order, so this does too or a\n// merged page could disagree with the one the renderer would have shown.\nfunction documentOf(response: ExecutionResponse): ClickyDocument | undefined {\n  const payload = response.parsed ?? response.stdout ?? response.output ?? \"\";\n  if (typeof payload !== \"string\" && typeof payload !== \"object\") return undefined;\n  const parsed = parseClickyData(payload as Parameters<typeof parseClickyData>[0]);\n  return parsed.ok ? parsed.document : undefined;\n}\n\nfunction findFirstTable(node: ClickyNode): ClickyNode | undefined {\n  let found: ClickyNode | undefined;\n  mapFirstTable(node, (table) => {\n    found = table;\n    return table;\n  });\n  return found;\n}\n\n/**\n * Rebuilds `node` with its first table — depth-first, in document order —\n * replaced by `fn`'s result. One traversal serves both finding a table and\n * rewriting it, so the page a walk reads rows out of is by construction the\n * page it writes them back into.\n */\nfunction mapFirstTable(\n  node: ClickyNode,\n  fn: (table: ClickyNode) => ClickyNode,\n): { node: ClickyNode; found: boolean } {\n  if (node.kind === \"table\") return { node: fn(node), found: true };\n\n  const children = mapFirstIn(node.children, fn);\n  if (children) return { node: { ...node, children }, found: true };\n\n  const items = mapFirstIn(node.items, fn);\n  if (items) return { node: { ...node, items }, found: true };\n\n  if (node.fields) {\n    const values = mapFirstIn(\n      node.fields.map((field) => field.value),\n      fn,\n    );\n    if (values) {\n      return {\n        node: {\n          ...node,\n          fields: node.fields.map((field, index) => ({\n            ...field,\n            value: values[index] ?? field.value,\n          })),\n        },\n        found: true,\n      };\n    }\n  }\n\n  if (node.content) {\n    const content = mapFirstTable(node.content, fn);\n    if (content.found) return { node: { ...node, content: content.node }, found: true };\n  }\n\n  return { node, found: false };\n}\n\n/** The rewritten list, or undefined when none of `nodes` held a table. */\nfunction mapFirstIn(\n  nodes: ClickyNode[] | undefined,\n  fn: (table: ClickyNode) => ClickyNode,\n): ClickyNode[] | undefined {\n  if (!nodes) return undefined;\n  for (const [index, child] of nodes.entries()) {\n    const mapped = mapFirstTable(child, fn);\n    if (!mapped.found) continue;\n    const next = [...nodes];\n    next[index] = mapped.node;\n    return next;\n  }\n  return undefined;\n}\n"],"names":[],"mappings":"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"}

package/dist/rpc/filterShapes.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function resolveFilterShape(param, components) {
+  var _a;
+  const ref = (_a = param["x-clicky-lookup"]) == null ? void 0 : _a.$ref;
+  if (!ref || !components) return void 0;
+  const name = ref.split("/").pop();
+  return name ? components[name] : void 0;
+}
+function filterShapesByName(parameters, components) {
+  return new Map(
+    parameters.map((param) => [param.name, resolveFilterShape(param, components)])
+  );
+}
+exports.filterShapesByName = filterShapesByName;
+exports.resolveFilterShape = resolveFilterShape;
+//# sourceMappingURL=filterShapes.cjs.map

package/dist/rpc/filterShapes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterShapes.cjs","sources":["../../src/rpc/filterShapes.ts"],"sourcesContent":["import type { ClickyFilterShape, OpenAPIParameter } from \"./types\";\n\n/**\n * Resolves a parameter's filter control shape from the spec's shared component\n * map, following the `$ref` the server stamped on it.\n *\n * A control's shape belongs to the spec, not to a lookup response: the spec is\n * fetched once and never varies with the values currently selected, so a filter\n * bar built from it renders the right control on first paint and holds it while\n * fresh options are in flight. A parameter that names no shape — a plain string\n * param — resolves to undefined and is rendered as the text input it is.\n *\n * A ref that does not resolve is treated the same as an absent one rather than\n * throwing: the spec is remote input, and one stale pointer should cost that\n * single control its chrome, not the whole bar.\n */\nexport function resolveFilterShape(\n  param: OpenAPIParameter,\n  components: Record<string, ClickyFilterShape> | undefined,\n): ClickyFilterShape | undefined {\n  const ref = param[\"x-clicky-lookup\"]?.$ref;\n  if (!ref || !components) return undefined;\n  const name = ref.split(\"/\").pop();\n  return name ? components[name] : undefined;\n}\n\n/**\n * Indexes every parameter's shape by name, so a caller that consults shapes\n * repeatedly resolves each ref once.\n */\nexport function filterShapesByName(\n  parameters: OpenAPIParameter[],\n  components: Record<string, ClickyFilterShape> | undefined,\n): Map<string, ClickyFilterShape | undefined> {\n  return new Map(\n    parameters.map((param) => [param.name, resolveFilterShape(param, components)]),\n  );\n}\n"],"names":[],"mappings":";;AAgBO,SAAS,mBACd,OACA,YAC+B;;AAC/B,QAAM,OAAM,WAAM,iBAAiB,MAAvB,mBAA0B;AACtC,MAAI,CAAC,OAAO,CAAC,WAAY,QAAO;AAChC,QAAM,OAAO,IAAI,MAAM,GAAG,EAAE,IAAA;AAC5B,SAAO,OAAO,WAAW,IAAI,IAAI;AACnC;AAMO,SAAS,mBACd,YACA,YAC4C;AAC5C,SAAO,IAAI;AAAA,IACT,WAAW,IAAI,CAAC,UAAU,CAAC,MAAM,MAAM,mBAAmB,OAAO,UAAU,CAAC,CAAC;AAAA,EAAA;AAEjF;;;"}

package/dist/rpc/filterShapes.d.ts

@@ -0,0 +1,22 @@
+import { ClickyFilterShape, OpenAPIParameter } from './types';
+/**
+ * Resolves a parameter's filter control shape from the spec's shared component
+ * map, following the `$ref` the server stamped on it.
+ *
+ * A control's shape belongs to the spec, not to a lookup response: the spec is
+ * fetched once and never varies with the values currently selected, so a filter
+ * bar built from it renders the right control on first paint and holds it while
+ * fresh options are in flight. A parameter that names no shape — a plain string
+ * param — resolves to undefined and is rendered as the text input it is.
+ *
+ * A ref that does not resolve is treated the same as an absent one rather than
+ * throwing: the spec is remote input, and one stale pointer should cost that
+ * single control its chrome, not the whole bar.
+ */
+export declare function resolveFilterShape(param: OpenAPIParameter, components: Record<string, ClickyFilterShape> | undefined): ClickyFilterShape | undefined;
+/**
+ * Indexes every parameter's shape by name, so a caller that consults shapes
+ * repeatedly resolves each ref once.
+ */
+export declare function filterShapesByName(parameters: OpenAPIParameter[], components: Record<string, ClickyFilterShape> | undefined): Map<string, ClickyFilterShape | undefined>;
+//# sourceMappingURL=filterShapes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filterShapes.d.ts","sourceRoot":"","sources":["../../src/rpc/filterShapes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEnE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,SAAS,GACxD,iBAAiB,GAAG,SAAS,CAK/B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,gBAAgB,EAAE,EAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,SAAS,GACxD,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC,CAI5C"}

package/dist/rpc/filterShapes.js

@@ -0,0 +1,17 @@
+function resolveFilterShape(param, components) {
+  var _a;
+  const ref = (_a = param["x-clicky-lookup"]) == null ? void 0 : _a.$ref;
+  if (!ref || !components) return void 0;
+  const name = ref.split("/").pop();
+  return name ? components[name] : void 0;
+}
+function filterShapesByName(parameters, components) {
+  return new Map(
+    parameters.map((param) => [param.name, resolveFilterShape(param, components)])
+  );
+}
+export {
+  filterShapesByName,
+  resolveFilterShape
+};
+//# sourceMappingURL=filterShapes.js.map