npm - @flanksource/clicky-ui - Versions diffs - 0.3.21 → 0.3.23 - Mend

@flanksource/clicky-ui 0.3.21 → 0.3.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1627) hide show

package/dist/rpc/types.d.ts CHANGED Viewed

@@ -4,6 +4,7 @@ export interface ExecutionRequest {
     args?: string[];
     flags?: Record<string, string>;
 }
+export type OperationRequestValues = Record<string, string | string[]>;
 export interface ExecutionPagination {
     total?: number;
     limit?: number;
@@ -42,10 +43,42 @@ export interface OpenAPISchema {
     additionalProperties?: OpenAPISchema | boolean;
     nullable?: boolean;
 }
-export type ClickyParameterRole = "search" | "filter" | "limit" | "offset" | "cursor" | "time-from" | "time-to";
+export type ClickyParameterRole = "search" | "filter" | "limit" | "offset" | "cursor" | "sort" | "order" | "time-from" | "time-to";
 export interface ClickyParameterMeta {
     role?: ClickyParameterRole;
 }
+/**
+ * A parameter's pointer to its filter control, set server-side.
+ *
+ * `$ref` names the control's SHAPE — which control this is — and is present on
+ * every generated filter, because a control's identity never varies with the
+ * values currently selected. `url`/`filter`/`searchParam` are the separate
+ * question of where its OPTIONS come from, and are present only when the
+ * backend can enumerate them: a range has no list to offer.
+ */
+export interface ClickyParameterLookup {
+    /** JSON pointer into `components["x-clicky-filters"]`. */
+    $ref?: string;
+    url?: string;
+    filter?: string;
+    searchParam?: string;
+    multi?: boolean;
+}
+/**
+ * One entry of `components["x-clicky-filters"]`: a filter control's shape,
+ * published once per spec and invariant for the life of it.
+ *
+ * Distinct from OperationLookupFilter, which is the per-request answer to "what
+ * values can this filter take right now" and may legitimately narrow as other
+ * filters are selected. Reading shape from here rather than from a lookup
+ * response is what keeps a control from decaying into a text box while its
+ * options are in flight.
+ */
+export interface ClickyFilterShape {
+    label?: string;
+    type?: OperationLookupFilterType;
+    multi?: boolean;
+}
 export interface OpenAPIParameter {
     name: string;
     in: "query" | "path" | "header";
@@ -56,6 +89,7 @@ export interface OpenAPIParameter {
      *  which is help text and must NOT be used as a placeholder. */
     placeholder?: string;
     "x-clicky"?: ClickyParameterMeta;
+    "x-clicky-lookup"?: ClickyParameterLookup;
     /** Vendor-extension placeholder, set server-side by clicky's converter.
      *  Takes precedence over `placeholder` when both are present. */
     "x-clicky-placeholder"?: string;
@@ -75,7 +109,7 @@ export interface OpenAPIOperation {
             schema?: OpenAPISchema;
         }>;
     };
-    responses: Record<string, unknown>;
+    responses?: Record<string, unknown>;
     "x-clicky"?: ClickyOperationMeta;
 }
 export interface OpenAPISpec {
@@ -90,6 +124,9 @@ export interface OpenAPISpec {
         name: string;
         description?: string;
     }>;
+    components?: {
+        "x-clicky-filters"?: Record<string, ClickyFilterShape>;
+    };
     "x-clicky"?: ClickySpecMeta;
 }
 export interface ResolvedOperation {
@@ -158,7 +195,18 @@ export interface ClickyToolHints {
 }
 export type OperationLookupFilterType = "bool" | "number" | "date"
 /** Both edges of a range under one parameter, as ">=from,<=to". */
- | "date-range" | "from" | "to" | "multi-filter"
+ | "date-range"
+/** A "date-range" with the clock taken off it: whole days, same grammar. */
+ | "day-range"
+/**
+ * A numeric range over elapsed time. Same grammar as "number"; the operands
+ * are the column's own unit, which `unit` names.
+ */
+ | "duration" | "from" | "to" | "multi-filter"
+/** A Kubernetes workload selected inside a profile's target scope. */
+ | "workload"
+/** Kubernetes label values, grouped by key when options are key=value pairs. */
+ | "labels"
 /**
  * An exact-value selection with nothing to enumerate — a UUID column, say.
  * Same wire grammar as "multi-filter"; typed rather than picked, because a
@@ -183,6 +231,10 @@ export interface OperationLookupFilter {
     timeEnabled?: boolean;
     timeZone?: string;
     timeZones?: string[];
+    /** The unit a "duration" filter's operands are written in ("ms" or "s"), so
+     *  the control labels itself in the numbers the column is stored in. Absent
+     *  means milliseconds. */
+    unit?: string;
 }
 export interface OperationLookupResponse {
     filters: Record<string, OperationLookupFilter>;

package/dist/rpc/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rpc/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,aAAa,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IAI7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAIlB,UAAU,CAAC,EAAE,MAAM,CAAC;IAIpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,oBAAoB,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;~~AAWD~~,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;oEACgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC;qEACiE;IACjE,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;+EAE+E;AAC/E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,GACtB,MAAM,GAAG,SAAS,CAEpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,EAAE,aAAa,CAAA;SAAE,CAAC,CAAC;KACtD,CAAC;~~IACF~~,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;~~IACnC~~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~~GACZ~~,MAAM,GACN,IAAI,GACJ,cAAc;AAChB;;;;GAIG;GACD,OAAO,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,yBAAyB,CAAC;IACjC,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CACb;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,oBAAoB,CACnE,CAAC;IACF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;~~CACtB~~;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAChD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAK9D"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rpc/types.ts"],"names":[],"mappings":"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"}

package/dist/rpc/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n args?: string[];\n flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n total?: number;\n limit?: number;\n offset?: number;\n\n // totalRelation says whether total is a count or a lower bound. A backend\n // that stops counting past a threshold reports \"gte\", and rendering that as\n // a count would state a number nobody promised.\n totalRelation?: \"eq\" \| \"gte\";\n\n // hasMore is the server's answer, not an inference from the page length: a\n // short page and the end of the data are different facts.\n hasMore?: boolean;\n\n // nextCursor resumes after this page. Opaque — it is passed back unchanged\n // and never parsed, because a client that can read one can forge one.\n nextCursor?: string;\n\n // truncated reports that the server stopped short of the whole result, so a\n // partial answer is never rendered as a complete one.\n truncated?: boolean;\n}\n\nexport interface ExecutionResponse {\n success: boolean;\n message?: string;\n output?: string;\n stdout?: string;\n stderr?: string;\n exit_code: number;\n error?: string;\n cli?: string;\n input?: ExecutionRequest;\n contentType?: string;\n requestUrl?: string;\n responseHeaders?: Record<string, string>;\n pagination?: ExecutionPagination;\n blob?: Blob;\n parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n type?: string;\n format?: string;\n default?: unknown;\n enum?: unknown[];\n description?: string;\n properties?: Record<string, OpenAPISchema>;\n items?: OpenAPISchema;\n oneOf?: OpenAPISchema[];\n additionalProperties?: OpenAPISchema \| boolean;\n nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n// \"search\" — render as the FilterBar's dedicated search input\n// \"filter\" — render as a FilterBar chip on the DataTable\n// \"limit\" — feed into DataTable pagination's pageSize\n// \"offset\" — feed into DataTable pagination's page (or skip)\n// \"cursor\" — carry the opaque position the previous page returned\n// \"time-from\" — left edge of a time-range picker\n// \"time-to\" — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n \| \"search\"\n \| \"filter\"\n \| \"limit\"\n \| \"offset\"\n \| \"cursor\"\n \| \"time-from\"\n \| \"time-to\";\n\nexport interface ClickyParameterMeta {\n role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n name: string;\n in: \"query\" \| \"path\" \| \"header\";\n description?: string;\n required?: boolean;\n schema?: OpenAPISchema;\n /** Hint text shown inside the empty input. Distinct from `description`,\n * which is help text and must NOT be used as a placeholder. /\n placeholder?: string;\n \"x-clicky\"?: ClickyParameterMeta;\n /* Vendor-extension placeholder, set server-side by clicky's converter.\n * Takes precedence over `placeholder` when both are present. /\n \"x-clicky-placeholder\"?: string;\n}\n\n/* Resolves the input placeholder for a parameter, drawing ONLY from explicit\n * placeholder fields — never from `description` (help text). Returns undefined\n * when no placeholder is declared so callers can apply their own fallback. /\nexport function parameterPlaceholder(\n param: OpenAPIParameter,\n): string \| undefined {\n return param[\"x-clicky-placeholder\"] ?? param.placeholder;\n}\n\nexport interface OpenAPIOperation {\n tags?: string[];\n summary?: string;\n description?: string;\n operationId?: string;\n parameters?: OpenAPIParameter[];\n requestBody?: {\n content?: Record<string, { schema?: OpenAPISchema }>;\n };\n responses: Record<string, unknown>;\n \"x-clicky\"?: ClickyOperationMeta;\n}\n\nexport interface OpenAPISpec {\n openapi: string;\n info: { title: string; description?: string; version: string };\n paths: Record<string, Record<string, OpenAPIOperation>>;\n tags?: Array<{ name: string; description?: string }>;\n \"x-clicky\"?: ClickySpecMeta;\n}\n\nexport interface ResolvedOperation {\n path: string;\n method: string;\n operation: OpenAPIOperation;\n}\n\nexport interface DomainDefinition {\n key: string;\n title: string;\n description: string;\n icon?: string;\n emptyTitle?: string;\n emptyDescription?: string;\n}\n\nexport interface ClickySpecMeta {\n surfaces?: ClickySurface[];\n}\n\nexport interface ClickySurface {\n key: string;\n entity: string;\n title: string;\n parent?: string;\n admin?: boolean;\n description?: string;\n /* Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. /\n icon?: string;\n /\n Hierarchy position within `parent`, \"/\"-separated (x-clicky-path) — e.g.\n * \"jms/incoming/disbursements\". The backend has already applied whatever\n * delimiter its own naming convention uses, so the UI never guesses one.\n * Absent — the default — means the parent group renders as a flat list.\n /\n path?: string;\n}\n\nexport interface ClickyOperationMeta {\n command?: string;\n surface?: string;\n verb: \"list\" \| \"get\" \| \"create\" \| \"update\" \| \"delete\" \| \"action\";\n scope: \"collection\" \| \"entity\";\n actionName?: string;\n idParam?: string;\n supportsLookup?: boolean;\n supportsFilterMode?: boolean;\n group?: string;\n toolHints?: ClickyToolHints;\n export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n formats?: string[];\n scopes?: Array<\"page\" \| \"all\">;\n allRowsMode?: \"streaming\" \| \"buffered\";\n formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n title?: string;\n readOnlyHint?: boolean;\n destructiveHint?: boolean;\n idempotentHint?: boolean;\n openWorldHint?: boolean;\n icon?: string;\n group?: string;\n parent?: string;\n defaultPermission?: \"on\" \| \"ask\" \| \"off\" \| \"auto\";\n strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n \| \"bool\"\n \| \"number\"\n \| \"date\"\n /* Both edges of a range under one parameter, as \">=from,<=to\". /\n \| \"date-range\"\n \| \"from\"\n \| \"to\"\n \| \"multi-filter\"\n /\n An exact-value selection with nothing to enumerate — a UUID column, say.\n * Same wire grammar as \"multi-filter\"; typed rather than picked, because a\n * dropdown over identifiers is a page of the rows.\n /\n \| \"value\";\n\nexport interface OperationLookupFilter {\n label?: string;\n options?: Record<string, ClickyNode>;\n selected?: Record<string, ClickyNode>;\n multi?: boolean;\n type?: OperationLookupFilterType;\n /* True when `options` is only the head of a larger set (server-side capped). /\n truncated?: boolean;\n /* True distinct count behind a truncated option set; drives \"… and N more\". */\n total?: number;\n presets?: Array<\n { label: string; from: string; to: string } \| TimeRangePresetGroup\n >;\n timeEnabled?: boolean;\n timeZone?: string;\n timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n return (\n p.name === \"args\" \|\|\n p.description?.toLowerCase().includes(\"positional argument\") === true\n );\n}\n"],"names":[],"mappings":"AAsGO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAoIO,SAAS,kBAAkB,GAA8B;AAxIzD;AAyIL,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;"}
1	+ {"version":3,"file":"types.js","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n args?: string[];\n flags?: Record<string, string>;\n}\n\nexport type OperationRequestValues = Record<string, string \| string[]>;\n\nexport interface ExecutionPagination {\n total?: number;\n limit?: number;\n offset?: number;\n\n // totalRelation says whether total is a count or a lower bound. A backend\n // that stops counting past a threshold reports \"gte\", and rendering that as\n // a count would state a number nobody promised.\n totalRelation?: \"eq\" \| \"gte\";\n\n // hasMore is the server's answer, not an inference from the page length: a\n // short page and the end of the data are different facts.\n hasMore?: boolean;\n\n // nextCursor resumes after this page. Opaque — it is passed back unchanged\n // and never parsed, because a client that can read one can forge one.\n nextCursor?: string;\n\n // truncated reports that the server stopped short of the whole result, so a\n // partial answer is never rendered as a complete one.\n truncated?: boolean;\n}\n\nexport interface ExecutionResponse {\n success: boolean;\n message?: string;\n output?: string;\n stdout?: string;\n stderr?: string;\n exit_code: number;\n error?: string;\n cli?: string;\n input?: ExecutionRequest;\n contentType?: string;\n requestUrl?: string;\n responseHeaders?: Record<string, string>;\n pagination?: ExecutionPagination;\n blob?: Blob;\n parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n type?: string;\n format?: string;\n default?: unknown;\n enum?: unknown[];\n description?: string;\n properties?: Record<string, OpenAPISchema>;\n items?: OpenAPISchema;\n oneOf?: OpenAPISchema[];\n additionalProperties?: OpenAPISchema \| boolean;\n nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n// \"search\" — render as the FilterBar's dedicated search input\n// \"filter\" — render as a FilterBar chip on the DataTable\n// \"limit\" — feed into DataTable pagination's pageSize\n// \"offset\" — feed into DataTable pagination's page (or skip)\n// \"cursor\" — carry the opaque position the previous page returned\n// \"sort\" — select a public server-side sort key from a table header\n// \"order\" — carry that sort's asc/desc direction\n// \"time-from\" — left edge of a time-range picker\n// \"time-to\" — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n \| \"search\"\n \| \"filter\"\n \| \"limit\"\n \| \"offset\"\n \| \"cursor\"\n \| \"sort\"\n \| \"order\"\n \| \"time-from\"\n \| \"time-to\";\n\nexport interface ClickyParameterMeta {\n role?: ClickyParameterRole;\n}\n\n/*\n A parameter's pointer to its filter control, set server-side.\n \n `$ref` names the control's SHAPE — which control this is — and is present on\n * every generated filter, because a control's identity never varies with the\n * values currently selected. `url`/`filter`/`searchParam` are the separate\n * question of where its OPTIONS come from, and are present only when the\n * backend can enumerate them: a range has no list to offer.\n /\nexport interface ClickyParameterLookup {\n /* JSON pointer into `components[\"x-clicky-filters\"]`. /\n $ref?: string;\n url?: string;\n filter?: string;\n searchParam?: string;\n multi?: boolean;\n}\n\n/\n One entry of `components[\"x-clicky-filters\"]`: a filter control's shape,\n * published once per spec and invariant for the life of it.\n \n Distinct from OperationLookupFilter, which is the per-request answer to \"what\n * values can this filter take right now\" and may legitimately narrow as other\n * filters are selected. Reading shape from here rather than from a lookup\n * response is what keeps a control from decaying into a text box while its\n * options are in flight.\n /\nexport interface ClickyFilterShape {\n label?: string;\n type?: OperationLookupFilterType;\n multi?: boolean;\n}\n\nexport interface OpenAPIParameter {\n name: string;\n in: \"query\" \| \"path\" \| \"header\";\n description?: string;\n required?: boolean;\n schema?: OpenAPISchema;\n /* Hint text shown inside the empty input. Distinct from `description`,\n * which is help text and must NOT be used as a placeholder. /\n placeholder?: string;\n \"x-clicky\"?: ClickyParameterMeta;\n \"x-clicky-lookup\"?: ClickyParameterLookup;\n /* Vendor-extension placeholder, set server-side by clicky's converter.\n * Takes precedence over `placeholder` when both are present. /\n \"x-clicky-placeholder\"?: string;\n}\n\n/* Resolves the input placeholder for a parameter, drawing ONLY from explicit\n * placeholder fields — never from `description` (help text). Returns undefined\n * when no placeholder is declared so callers can apply their own fallback. /\nexport function parameterPlaceholder(\n param: OpenAPIParameter,\n): string \| undefined {\n return param[\"x-clicky-placeholder\"] ?? param.placeholder;\n}\n\nexport interface OpenAPIOperation {\n tags?: string[];\n summary?: string;\n description?: string;\n operationId?: string;\n parameters?: OpenAPIParameter[];\n requestBody?: {\n content?: Record<string, { schema?: OpenAPISchema }>;\n };\n // Optional because nothing here reads it, and a server may serve this catalog\n // with the response schemas reduced to a stub — they are over half the bytes\n // of a spec whose only job here is to describe what can be called.\n responses?: Record<string, unknown>;\n \"x-clicky\"?: ClickyOperationMeta;\n}\n\nexport interface OpenAPISpec {\n openapi: string;\n info: { title: string; description?: string; version: string };\n paths: Record<string, Record<string, OpenAPIOperation>>;\n tags?: Array<{ name: string; description?: string }>;\n components?: {\n \"x-clicky-filters\"?: Record<string, ClickyFilterShape>;\n };\n \"x-clicky\"?: ClickySpecMeta;\n}\n\nexport interface ResolvedOperation {\n path: string;\n method: string;\n operation: OpenAPIOperation;\n}\n\nexport interface DomainDefinition {\n key: string;\n title: string;\n description: string;\n icon?: string;\n emptyTitle?: string;\n emptyDescription?: string;\n}\n\nexport interface ClickySpecMeta {\n surfaces?: ClickySurface[];\n}\n\nexport interface ClickySurface {\n key: string;\n entity: string;\n title: string;\n parent?: string;\n admin?: boolean;\n description?: string;\n /* Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. /\n icon?: string;\n /\n Hierarchy position within `parent`, \"/\"-separated (x-clicky-path) — e.g.\n * \"jms/incoming/disbursements\". The backend has already applied whatever\n * delimiter its own naming convention uses, so the UI never guesses one.\n * Absent — the default — means the parent group renders as a flat list.\n /\n path?: string;\n}\n\nexport interface ClickyOperationMeta {\n command?: string;\n surface?: string;\n verb: \"list\" \| \"get\" \| \"create\" \| \"update\" \| \"delete\" \| \"action\";\n scope: \"collection\" \| \"entity\";\n actionName?: string;\n idParam?: string;\n supportsLookup?: boolean;\n supportsFilterMode?: boolean;\n group?: string;\n toolHints?: ClickyToolHints;\n export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n formats?: string[];\n scopes?: Array<\"page\" \| \"all\">;\n allRowsMode?: \"streaming\" \| \"buffered\";\n formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n title?: string;\n readOnlyHint?: boolean;\n destructiveHint?: boolean;\n idempotentHint?: boolean;\n openWorldHint?: boolean;\n icon?: string;\n group?: string;\n parent?: string;\n defaultPermission?: \"on\" \| \"ask\" \| \"off\" \| \"auto\";\n strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n \| \"bool\"\n \| \"number\"\n \| \"date\"\n /* Both edges of a range under one parameter, as \">=from,<=to\". /\n \| \"date-range\"\n /* A \"date-range\" with the clock taken off it: whole days, same grammar. /\n \| \"day-range\"\n /\n A numeric range over elapsed time. Same grammar as \"number\"; the operands\n * are the column's own unit, which `unit` names.\n /\n \| \"duration\"\n \| \"from\"\n \| \"to\"\n \| \"multi-filter\"\n /* A Kubernetes workload selected inside a profile's target scope. /\n \| \"workload\"\n /* Kubernetes label values, grouped by key when options are key=value pairs. /\n \| \"labels\"\n /\n An exact-value selection with nothing to enumerate — a UUID column, say.\n * Same wire grammar as \"multi-filter\"; typed rather than picked, because a\n * dropdown over identifiers is a page of the rows.\n /\n \| \"value\";\n\nexport interface OperationLookupFilter {\n label?: string;\n options?: Record<string, ClickyNode>;\n selected?: Record<string, ClickyNode>;\n multi?: boolean;\n type?: OperationLookupFilterType;\n /* True when `options` is only the head of a larger set (server-side capped). /\n truncated?: boolean;\n /* True distinct count behind a truncated option set; drives \"… and N more\". /\n total?: number;\n presets?: Array<\n { label: string; from: string; to: string } \| TimeRangePresetGroup\n >;\n timeEnabled?: boolean;\n timeZone?: string;\n timeZones?: string[];\n /* The unit a \"duration\" filter's operands are written in (\"ms\" or \"s\"), so\n * the control labels itself in the numbers the column is stored in. Absent\n * means milliseconds. */\n unit?: string;\n}\n\nexport interface OperationLookupResponse {\n filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n return (\n p.name === \"args\" \|\|\n p.description?.toLowerCase().includes(\"positional argument\") === true\n );\n}\n"],"names":[],"mappings":"AA+IO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAyJO,SAAS,kBAAkB,GAA8B;AA7JzD;AA8JL,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;"}

package/dist/rpc/useOperationPages.cjs ADDED Viewed

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const reactQuery = require("@tanstack/react-query");
+const cursorStale = require("./cursorStale.cjs");
+const formMetadata = require("./formMetadata.cjs");
+const LIST_KEY = "operation-list";
+const CLICKY_HEADERS = { Accept: "application/json+clicky" };
+function useOperationPages({
+  client,
+  endpoint,
+  parameters,
+  filters
+}) {
+  var _a;
+  const queryClient = reactQuery.useQueryClient();
+  const cursorParam = cursorStale.cursorParameterName(parameters);
+  const path = endpoint == null ? void 0 : endpoint.path;
+  const method = endpoint == null ? void 0 : endpoint.method;
+  const walkFilters = react.useMemo(() => {
+    if (!cursorParam) return filters;
+    const rest = { ...filters };
+    delete rest[cursorParam];
+    return rest;
+  }, [cursorParam, filters]);
+  const execute = react.useCallback(
+    (values) => client.executeCommand(
+      path,
+      method,
+      formMetadata.packParameterValues(values, parameters),
+      CLICKY_HEADERS
+    ),
+    [client, method, parameters, path]
+  );
+  const single = reactQuery.useQuery({
+    queryKey: [LIST_KEY, method, path, filters],
+    queryFn: () => execute(filters),
+    enabled: !!endpoint && !cursorParam,
+    placeholderData: reactQuery.keepPreviousData,
+    staleTime: 3e4,
+    retry: 0
+  });
+  const walkKey = react.useMemo(
+    () => [LIST_KEY, "walk", method, path, walkFilters],
+    [method, path, walkFilters]
+  );
+  const walk = reactQuery.useInfiniteQuery({
+    queryKey: walkKey,
+    queryFn: ({ pageParam }) => execute(pageParam ? { ...walkFilters, [cursorParam]: pageParam } : walkFilters),
+    initialPageParam: void 0,
+    // The server's two answers, both required: it has more, and here is where
+    // to resume. A page claiming more without minting a token cannot be walked,
+    // and guessing one is how a client forges a position it was never given.
+    getNextPageParam: (lastPage) => {
+      var _a2;
+      return ((_a2 = lastPage.pagination) == null ? void 0 : _a2.hasMore) ? lastPage.pagination.nextCursor : void 0;
+    },
+    enabled: !!endpoint && !!cursorParam,
+    placeholderData: reactQuery.keepPreviousData,
+    staleTime: 3e4,
+    retry: 0
+  });
+  const walkPages = (_a = walk.data) == null ? void 0 : _a.pages;
+  const staleWalk = cursorStale.isCursorStale(walk.error) && ((walkPages == null ? void 0 : walkPages.length) ?? 0) > 0;
+  react.useEffect(() => {
+    if (!staleWalk) return;
+    void queryClient.resetQueries({ queryKey: walkKey });
+  }, [queryClient, staleWalk, walkKey]);
+  const fetchNextPage = walk.fetchNextPage;
+  const infinite = react.useMemo(() => {
+    if (!cursorParam) return void 0;
+    return {
+      hasMore: walk.hasNextPage,
+      loading: walk.isFetchingNextPage,
+      onLoadMore: () => void fetchNextPage()
+    };
+  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage]);
+  const resetWalk = react.useCallback(() => {
+    void queryClient.resetQueries({ queryKey: walkKey });
+  }, [queryClient, walkKey]);
+  const refetchSingle = single.refetch;
+  if (!cursorParam) {
+    return {
+      pages: single.data ? [single.data] : [],
+      response: single.data ?? null,
+      isFetching: single.isFetching,
+      isPending: single.isPending,
+      isError: single.isError,
+      error: single.error,
+      refetch: () => void refetchSingle()
+    };
+  }
+  const pages = walkPages ?? [];
+  return {
+    pages,
+    response: pages[pages.length - 1] ?? null,
+    // Fetching the next page grows the run; it does not replace it. Reporting
+    // it as a load of the whole surface is what drops a spinner over rows the
+    // reader is still reading.
+    isFetching: walk.isFetching && !walk.isFetchingNextPage,
+    isPending: walk.isPending,
+    isError: walk.isError && !staleWalk,
+    error: staleWalk ? void 0 : walk.error,
+    // A mutation just changed the rows this walk was cut from, so its cursors
+    // no longer name positions in it. Starting over is the only honest refetch.
+    refetch: resetWalk,
+    ...infinite ? { infinite } : {}
+  };
+}
+exports.useOperationPages = useOperationPages;
+//# sourceMappingURL=useOperationPages.cjs.map

package/dist/rpc/useOperationPages.cjs.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/rpc/useOperationPages.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+import { DataTableInfinite } from '../data/DataTable';
+import { ParameterValues } from './formMetadata';
+import { ExecutionResponse, OpenAPIParameter, ResolvedOperation } from './types';
+import { OperationsApiClient } from './useOperations';
+export type OperationPagesOptions = {
+    client: OperationsApiClient;
+    /** The list operation, or undefined for a surface that has none. */
+    endpoint: ResolvedOperation | undefined;
+    /** Every parameter the operation declares — the source of the cursor role. */
+    parameters: OpenAPIParameter[];
+    /** Current filter/pagination state, as the catalog holds and URL-mirrors it. */
+    filters: ParameterValues;
+};
+export type OperationPages = {
+    /** Every page fetched so far, oldest first. One entry outside a walk. */
+    pages: ExecutionResponse[];
+    /** The newest page — what every renderer means by "the response". */
+    response: ExecutionResponse | null;
+    /** True while the whole result is being replaced, not while it is growing. */
+    isFetching: boolean;
+    isPending: boolean;
+    isError: boolean;
+    error: unknown;
+    /** Re-runs the list. A walk restarts rather than replaying its cursors. */
+    refetch: () => void;
+    /** Load-more handle; absent unless the operation can walk by cursor. */
+    infinite?: DataTableInfinite;
+};
+/**
+ * useOperationPages runs a surface's list operation, walking it forward when it
+ * declares a cursor and fetching a single page when it does not.
+ *
+ * The mode is the operation's to decide, not the caller's: a cursor role is the
+ * server saying "you may resume this query", and everything else — the majority
+ * of surfaces — keeps the single-page query it has always had, replacing its
+ * rows when the offset moves.
+ *
+ * In walk mode the cursor is deliberately absent from the query key. The key is
+ * the identity of the query being walked, and the cursor is a position inside
+ * it; keying on it made every page a different query, which is precisely why
+ * advancing replaced the rows instead of extending them. Every other filter
+ * stays in the key, so any filter, parameter or time-range change starts a new
+ * walk on its own, with no reset logic layered on top.
+ */
+export declare function useOperationPages({ client, endpoint, parameters, filters, }: OperationPagesOptions): OperationPages;
+//# sourceMappingURL=useOperationPages.d.ts.map

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

@@ -0,0 +1 @@

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

package/dist/rpc/useOperationPages.js ADDED Viewed

@@ -0,0 +1,111 @@
+import { useMemo, useCallback, useEffect } from "react";
+import { useQueryClient, useQuery, keepPreviousData, useInfiniteQuery } from "@tanstack/react-query";
+import { cursorParameterName, isCursorStale } from "./cursorStale.js";
+import { packParameterValues } from "./formMetadata.js";
+const LIST_KEY = "operation-list";
+const CLICKY_HEADERS = { Accept: "application/json+clicky" };
+function useOperationPages({
+  client,
+  endpoint,
+  parameters,
+  filters
+}) {
+  var _a;
+  const queryClient = useQueryClient();
+  const cursorParam = cursorParameterName(parameters);
+  const path = endpoint == null ? void 0 : endpoint.path;
+  const method = endpoint == null ? void 0 : endpoint.method;
+  const walkFilters = useMemo(() => {
+    if (!cursorParam) return filters;
+    const rest = { ...filters };
+    delete rest[cursorParam];
+    return rest;
+  }, [cursorParam, filters]);
+  const execute = useCallback(
+    (values) => client.executeCommand(
+      path,
+      method,
+      packParameterValues(values, parameters),
+      CLICKY_HEADERS
+    ),
+    [client, method, parameters, path]
+  );
+  const single = useQuery({
+    queryKey: [LIST_KEY, method, path, filters],
+    queryFn: () => execute(filters),
+    enabled: !!endpoint && !cursorParam,
+    placeholderData: keepPreviousData,
+    staleTime: 3e4,
+    retry: 0
+  });
+  const walkKey = useMemo(
+    () => [LIST_KEY, "walk", method, path, walkFilters],
+    [method, path, walkFilters]
+  );
+  const walk = useInfiniteQuery({
+    queryKey: walkKey,
+    queryFn: ({ pageParam }) => execute(pageParam ? { ...walkFilters, [cursorParam]: pageParam } : walkFilters),
+    initialPageParam: void 0,
+    // The server's two answers, both required: it has more, and here is where
+    // to resume. A page claiming more without minting a token cannot be walked,
+    // and guessing one is how a client forges a position it was never given.
+    getNextPageParam: (lastPage) => {
+      var _a2;
+      return ((_a2 = lastPage.pagination) == null ? void 0 : _a2.hasMore) ? lastPage.pagination.nextCursor : void 0;
+    },
+    enabled: !!endpoint && !!cursorParam,
+    placeholderData: keepPreviousData,
+    staleTime: 3e4,
+    retry: 0
+  });
+  const walkPages = (_a = walk.data) == null ? void 0 : _a.pages;
+  const staleWalk = isCursorStale(walk.error) && ((walkPages == null ? void 0 : walkPages.length) ?? 0) > 0;
+  useEffect(() => {
+    if (!staleWalk) return;
+    void queryClient.resetQueries({ queryKey: walkKey });
+  }, [queryClient, staleWalk, walkKey]);
+  const fetchNextPage = walk.fetchNextPage;
+  const infinite = useMemo(() => {
+    if (!cursorParam) return void 0;
+    return {
+      hasMore: walk.hasNextPage,
+      loading: walk.isFetchingNextPage,
+      onLoadMore: () => void fetchNextPage()
+    };
+  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage]);
+  const resetWalk = useCallback(() => {
+    void queryClient.resetQueries({ queryKey: walkKey });
+  }, [queryClient, walkKey]);
+  const refetchSingle = single.refetch;
+  if (!cursorParam) {
+    return {
+      pages: single.data ? [single.data] : [],
+      response: single.data ?? null,
+      isFetching: single.isFetching,
+      isPending: single.isPending,
+      isError: single.isError,
+      error: single.error,
+      refetch: () => void refetchSingle()
+    };
+  }
+  const pages = walkPages ?? [];
+  return {
+    pages,
+    response: pages[pages.length - 1] ?? null,
+    // Fetching the next page grows the run; it does not replace it. Reporting
+    // it as a load of the whole surface is what drops a spinner over rows the
+    // reader is still reading.
+    isFetching: walk.isFetching && !walk.isFetchingNextPage,
+    isPending: walk.isPending,
+    isError: walk.isError && !staleWalk,
+    error: staleWalk ? void 0 : walk.error,
+    // A mutation just changed the rows this walk was cut from, so its cursors
+    // no longer name positions in it. Starting over is the only honest refetch.
+    refetch: resetWalk,
+    ...infinite ? { infinite } : {}
+  };
+}
+export {
+  useOperationPages
+};
+//# sourceMappingURL=useOperationPages.js.map

package/dist/rpc/useOperationPages.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/rpc/useOperations.cjs CHANGED Viewed

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const reactQuery = require("@tanstack/react-query");
+const react = require("react");
 function useOpenAPI(client) {
   return reactQuery.useQuery({
     queryKey: ["openapi-spec"],
@@ -10,14 +11,16 @@ function useOpenAPI(client) {
 }
 function useOperations(client) {
   const { data: spec, ...rest } = useOpenAPI(client);
-  const operations = [];
-  if (spec) {
+  const operations = react.useMemo(() => {
+    if (!spec) return [];
+    const resolved = [];
     for (const [path, methods] of Object.entries(spec.paths)) {
       for (const [method, operation] of Object.entries(methods)) {
-        operations.push({ path, method, operation });
+        resolved.push({ path, method, operation });
       }
     }
-  }
+    return resolved;
+  }, [spec]);
   return { operations, spec, ...rest };
 }
 function useOperationById(client, operationId) {

package/dist/rpc/useOperations.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useOperations.cjs","sources":["../../src/rpc/useOperations.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport type {\n ExecutionResponse,\n OpenAPISpec,\n OperationLookupFilter,\n OperationLookupResponse,\n ResolvedOperation,\n} from \"./types\";\n\nexport interface OperationsApiClient {\n getOpenAPISpec(): Promise<OpenAPISpec>;\n executeCommand(\n path: string,\n method: string,\n params: ~~Record<string, string>,\~~n headers?: Record<string, string>,\n ): Promise<ExecutionResponse>;\n lookupFilters?(\n path: string,\n method: string,\n params: ~~Record<string, string>,\~~n headers?: Record<string, string>,\n ): Promise<OperationLookupResponse>;\n lookupFilterOptions?(\n path: string,\n method: string,\n filterKey: string,\n query: string,\n // Extra query params merged into the lookup request (e.g. a scope filter\n // derived from a sibling form field). Lets a form-field lookup narrow the\n // option set beyond the search term.\n extraParams?: ~~Record<string, string>,\~~n ): Promise<OperationLookupFilter>;\n // getSchema fetches a resource's JSON Schema via content negotiation; undefined\n // when the resource exposes none. submitForm sends a nested JSON body (create\n // POST / update PUT) preserving nested objects and arrays. Both are optional so\n // alternative client implementations can omit schema-driven forms.\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 useOpenAPI(client: OperationsApiClient) {\n return useQuery<OpenAPISpec>({\n queryKey: [\"openapi-spec\"],\n queryFn: () => client.getOpenAPISpec(),\n staleTime: 5 * 60 * 1000,\n });\n}\n\nexport function useOperations(client: OperationsApiClient) {\n const { data: spec, ...rest } = useOpenAPI(client);\n\n const operations: ResolvedOperation[] = ~~[];\~~n if (spec) {\n for (const [path, methods] of Object.entries(spec.paths)) {\n for (const [method, operation] of Object.entries(methods)) {\n ~~operations~~.push({ path, method, operation });\n }\n }\n }\n\n return { operations, spec, ...rest };\n}\n\nexport function useOperationById(client: OperationsApiClient, operationId: string \| undefined) {\n const { operations, ...rest } = useOperations(client);\n const operation = operationId\n ? operations.find((op) => op.operation.operationId === operationId)\n : undefined;\n return { operation, ...rest };\n}\n"],"names":["useQuery"],"mappings":"~~;;;AA+CO~~,SAAS,WAAW,QAA6B;AACtD,SAAOA,oBAAsB;AAAA,IAC3B,UAAU,CAAC,cAAc;AAAA,IACzB,SAAS,MAAM,OAAO,eAAA;AAAA,IACtB,WAAW,IAAI,KAAK;AAAA,EAAA,CACrB;AACH;AAEO,SAAS,cAAc,QAA6B;AACzD,QAAM,EAAE,MAAM,MAAM,GAAG,KAAA,IAAS,WAAW,MAAM;~~AAEjD~~,QAAM,~~aAAkC~~,CAAA;~~AACxC~~,~~MAAI~~,~~MAAM~~;~~AACR~~,eAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,KAAK,KAAK,GAAG;AACxD,iBAAW,CAAC,QAAQ,SAAS,KAAK,OAAO,QAAQ,OAAO,GAAG;AACzD,~~mBAAW~~,KAAK,EAAE,MAAM,QAAQ,WAAW;AAAA,~~MAC7C~~;AAAA,IACF;AAAA,~~EACF~~;~~AAEA~~,SAAO,EAAE,YAAY,MAAM,GAAG,KAAA;AAChC;AAEO,SAAS,iBAAiB,QAA6B,aAAiC;AAC7F,QAAM,EAAE,YAAY,GAAG,KAAA,IAAS,cAAc,MAAM;AACpD,QAAM,YAAY,cACd,WAAW,KAAK,CAAC,OAAO,GAAG,UAAU,gBAAgB,WAAW,IAChE;AACJ,SAAO,EAAE,WAAW,GAAG,KAAA;AACzB;;;;"}
1	+ {"version":3,"file":"useOperations.cjs","sources":["../../src/rpc/useOperations.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\nimport type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport type {\n ExecutionResponse,\n OpenAPISpec,\n OperationLookupFilter,\n OperationLookupResponse,\n OperationRequestValues,\n ResolvedOperation,\n} from \"./types\";\n\nexport interface OperationsApiClient {\n getOpenAPISpec(): Promise<OpenAPISpec>;\n executeCommand(\n path: string,\n method: string,\n params: OperationRequestValues,\n headers?: Record<string, string>,\n ): Promise<ExecutionResponse>;\n lookupFilters?(\n path: string,\n method: string,\n params: OperationRequestValues,\n headers?: Record<string, string>,\n ): Promise<OperationLookupResponse>;\n lookupFilterOptions?(\n path: string,\n method: string,\n filterKey: string,\n query: string,\n // Extra query params merged into the lookup request (e.g. a scope filter\n // derived from a sibling form field). Lets a form-field lookup narrow the\n // option set beyond the search term.\n extraParams?: OperationRequestValues,\n ): Promise<OperationLookupFilter>;\n // getSchema fetches a resource's JSON Schema via content negotiation; undefined\n // when the resource exposes none. submitForm sends a nested JSON body (create\n // POST / update PUT) preserving nested objects and arrays. Both are optional so\n // alternative client implementations can omit schema-driven forms.\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 useOpenAPI(client: OperationsApiClient) {\n return useQuery<OpenAPISpec>({\n queryKey: [\"openapi-spec\"],\n queryFn: () => client.getOpenAPISpec(),\n staleTime: 5 * 60 * 1000,\n });\n}\n\nexport function useOperations(client: OperationsApiClient) {\n const { data: spec, ...rest } = useOpenAPI(client);\n\n // Flattening a hundred operations is cheap once and wasteful on every render\n // of every page that reads the catalog — and callers memoize off this array,\n // so a fresh identity re-runs their work too.\n const operations = useMemo<ResolvedOperation[]>(() => {\n if (!spec) return [];\n const resolved: ResolvedOperation[] = [];\n for (const [path, methods] of Object.entries(spec.paths)) {\n for (const [method, operation] of Object.entries(methods)) {\n resolved.push({ path, method, operation });\n }\n }\n return resolved;\n }, [spec]);\n\n return { operations, spec, ...rest };\n}\n\nexport function useOperationById(client: OperationsApiClient, operationId: string \| undefined) {\n const { operations, ...rest } = useOperations(client);\n const operation = operationId\n ? operations.find((op) => op.operation.operationId === operationId)\n : undefined;\n return { operation, ...rest };\n}\n"],"names":["useQuery","useMemo"],"mappings":";;;;AAiDO,SAAS,WAAW,QAA6B;AACtD,SAAOA,oBAAsB;AAAA,IAC3B,UAAU,CAAC,cAAc;AAAA,IACzB,SAAS,MAAM,OAAO,eAAA;AAAA,IACtB,WAAW,IAAI,KAAK;AAAA,EAAA,CACrB;AACH;AAEO,SAAS,cAAc,QAA6B;AACzD,QAAM,EAAE,MAAM,MAAM,GAAG,KAAA,IAAS,WAAW,MAAM;AAKjD,QAAM,aAAaC,MAAAA,QAA6B,MAAM;AACpD,QAAI,CAAC,KAAM,QAAO,CAAA;AAClB,UAAM,WAAgC,CAAA;AACtC,eAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,KAAK,KAAK,GAAG;AACxD,iBAAW,CAAC,QAAQ,SAAS,KAAK,OAAO,QAAQ,OAAO,GAAG;AACzD,iBAAS,KAAK,EAAE,MAAM,QAAQ,WAAW;AAAA,MAC3C;AAAA,IACF;AACA,WAAO;AAAA,EACT,GAAG,CAAC,IAAI,CAAC;AAET,SAAO,EAAE,YAAY,MAAM,GAAG,KAAA;AAChC;AAEO,SAAS,iBAAiB,QAA6B,aAAiC;AAC7F,QAAM,EAAE,YAAY,GAAG,KAAA,IAAS,cAAc,MAAM;AACpD,QAAM,YAAY,cACd,WAAW,KAAK,CAAC,OAAO,GAAG,UAAU,gBAAgB,WAAW,IAChE;AACJ,SAAO,EAAE,WAAW,GAAG,KAAA;AACzB;;;;"}

package/dist/rpc/useOperations.d.ts CHANGED Viewed

@@ -1,10 +1,10 @@
 import { JsonSchemaObject } from '../components/json-schema-form-types';
-import { ExecutionResponse, OpenAPISpec, OperationLookupFilter, OperationLookupResponse, ResolvedOperation } from './types';
+import { ExecutionResponse, OpenAPISpec, OperationLookupFilter, OperationLookupResponse, OperationRequestValues, ResolvedOperation } from './types';
 export interface OperationsApiClient {
     getOpenAPISpec(): Promise<OpenAPISpec>;
-    executeCommand(path: string, method: string, params: Record<string, string>, headers?: Record<string, string>): Promise<ExecutionResponse>;
-    lookupFilters?(path: string, method: string, params: Record<string, string>, headers?: Record<string, string>): Promise<OperationLookupResponse>;
-    lookupFilterOptions?(path: string, method: string, filterKey: string, query: string, extraParams?: Record<string, string>): Promise<OperationLookupFilter>;
+    executeCommand(path: string, method: string, params: OperationRequestValues, headers?: Record<string, string>): Promise<ExecutionResponse>;
+    lookupFilters?(path: string, method: string, params: OperationRequestValues, headers?: Record<string, string>): Promise<OperationLookupResponse>;
+    lookupFilterOptions?(path: string, method: string, filterKey: string, query: string, extraParams?: OperationRequestValues): Promise<OperationLookupFilter>;
     getSchema?(path: string): Promise<JsonSchemaObject | undefined>;
     submitForm?(path: string, method: string, body: Record<string, unknown>, headers?: Record<string, string>): Promise<ExecutionResponse>;
 }

package/dist/rpc/useOperations.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useOperations.d.ts","sourceRoot":"","sources":["../../src/rpc/useOperations.ts"],"names":[],"mappings":"~~AACA~~,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,mBAAmB;IAClC,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,~~MAAM~~,~~CAAC,MAAM,EAAE,MAAM,CAAC,~~EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,aAAa,CAAC,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,~~MAAM~~,~~CAAC,MAAM,EAAE,MAAM,CAAC,~~EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,mBAAmB,CAAC,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EAIb,WAAW,CAAC,EAAE,~~MAAM~~,~~CAAC,MAAM,EAAE,MAAM,CAAC,~~GACnC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAKlC,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAChE,UAAU,CAAC,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,mBAAmB,sEAMrD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~EAaxD~~;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5F"}
1	+ {"version":3,"file":"useOperations.d.ts","sourceRoot":"","sources":["../../src/rpc/useOperations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,mBAAmB;IAClC,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,aAAa,CAAC,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,mBAAmB,CAAC,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EAIb,WAAW,CAAC,EAAE,sBAAsB,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAKlC,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAChE,UAAU,CAAC,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,mBAAmB,sEAMrD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBxD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5F"}

package/dist/rpc/useOperations.js CHANGED Viewed

@@ -1,4 +1,5 @@
 import { useQuery } from "@tanstack/react-query";
+import { useMemo } from "react";
 function useOpenAPI(client) {
   return useQuery({
     queryKey: ["openapi-spec"],
@@ -8,14 +9,16 @@ function useOpenAPI(client) {
 }
 function useOperations(client) {
   const { data: spec, ...rest } = useOpenAPI(client);
-  const operations = [];
-  if (spec) {
+  const operations = useMemo(() => {
+    if (!spec) return [];
+    const resolved = [];
     for (const [path, methods] of Object.entries(spec.paths)) {
       for (const [method, operation] of Object.entries(methods)) {
-        operations.push({ path, method, operation });
+        resolved.push({ path, method, operation });
       }
     }
-  }
+    return resolved;
+  }, [spec]);
   return { operations, spec, ...rest };
 }
 function useOperationById(client, operationId) {