@flanksource/clicky-ui 0.3.36 → 0.3.38

package/dist/rpc/operation-cli-command.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const shellCommand = require("../lib/shell-command.cjs");
+function operationCLICommand(operation, args, cli) {
+  var _a;
+  const command = (_a = operation == null ? void 0 : operation.operation["x-clicky"]) == null ? void 0 : _a.command;
+  if (!command || !(cli == null ? void 0 : cli.executable)) return void 0;
+  const parts = [shellCommand.shellQuote(cli.executable)];
+  for (const [name, value] of sortedEntries(cli.globalFlags ?? {})) {
+    appendFlag(parts, name, value);
+  }
+  parts.push(...command.split("/").filter(Boolean).map(shellCommand.shellQuote));
+  const positional = args.args;
+  if (Array.isArray(positional)) {
+    parts.push(...positional.map((value) => shellCommand.shellQuote(String(value))));
+  } else if (positional !== void 0 && positional !== null) {
+    parts.push(shellCommand.shellQuote(String(positional)));
+  }
+  for (const [name, value] of sortedEntries(args)) {
+    if (name !== "args") appendFlag(parts, name, value);
+  }
+  return parts.join(" ");
+}
+function sortedEntries(values) {
+  return Object.entries(values).sort(
+    ([left], [right]) => left.localeCompare(right)
+  );
+}
+function appendFlag(parts, name, value) {
+  if (value === void 0 || value === null || value === "") return;
+  if (value === true) {
+    parts.push(`--${name}`);
+    return;
+  }
+  parts.push(`--${name}=${shellCommand.shellQuote(flagValue(value))}`);
+}
+function flagValue(value) {
+  if (Array.isArray(value)) return value.map(String).join(",");
+  if (typeof value === "object") return JSON.stringify(value);
+  return String(value);
+}
+exports.operationCLICommand = operationCLICommand;
+//# sourceMappingURL=operation-cli-command.cjs.map

package/dist/rpc/operation-cli-command.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-cli-command.cjs","sources":["../../src/rpc/operation-cli-command.ts"],"sourcesContent":["import { shellQuote } from \"../lib/shell-command\";\nimport type { OperationScheduleCLI } from \"./operation-schedule-types\";\nimport type { ResolvedOperation } from \"./types\";\n\nexport function operationCLICommand(\n  operation: ResolvedOperation | undefined,\n  args: Record<string, unknown>,\n  cli: OperationScheduleCLI | undefined,\n): string | undefined {\n  const command = operation?.operation[\"x-clicky\"]?.command;\n  if (!command || !cli?.executable) return undefined;\n\n  const parts = [shellQuote(cli.executable)];\n  for (const [name, value] of sortedEntries(cli.globalFlags ?? {})) {\n    appendFlag(parts, name, value);\n  }\n  parts.push(...command.split(\"/\").filter(Boolean).map(shellQuote));\n\n  const positional = args.args;\n  if (Array.isArray(positional)) {\n    parts.push(...positional.map((value) => shellQuote(String(value))));\n  } else if (positional !== undefined && positional !== null) {\n    parts.push(shellQuote(String(positional)));\n  }\n\n  for (const [name, value] of sortedEntries(args)) {\n    if (name !== \"args\") appendFlag(parts, name, value);\n  }\n  return parts.join(\" \");\n}\n\nfunction sortedEntries(\n  values: Record<string, unknown>,\n): Array<[string, unknown]> {\n  return Object.entries(values).sort(([left], [right]) =>\n    left.localeCompare(right),\n  );\n}\n\nfunction appendFlag(parts: string[], name: string, value: unknown): void {\n  if (value === undefined || value === null || value === \"\") return;\n  if (value === true) {\n    parts.push(`--${name}`);\n    return;\n  }\n  parts.push(`--${name}=${shellQuote(flagValue(value))}`);\n}\n\nfunction flagValue(value: unknown): string {\n  if (Array.isArray(value)) return value.map(String).join(\",\");\n  if (typeof value === \"object\") return JSON.stringify(value);\n  return String(value);\n}\n"],"names":["shellQuote"],"mappings":";;;AAIO,SAAS,oBACd,WACA,MACA,KACoB;;AACpB,QAAM,WAAU,4CAAW,UAAU,gBAArB,mBAAkC;AAClD,MAAI,CAAC,WAAW,EAAC,2BAAK,YAAY,QAAO;AAEzC,QAAM,QAAQ,CAACA,aAAAA,WAAW,IAAI,UAAU,CAAC;AACzC,aAAW,CAAC,MAAM,KAAK,KAAK,cAAc,IAAI,eAAe,CAAA,CAAE,GAAG;AAChE,eAAW,OAAO,MAAM,KAAK;AAAA,EAC/B;AACA,QAAM,KAAK,GAAG,QAAQ,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,IAAIA,aAAAA,UAAU,CAAC;AAEhE,QAAM,aAAa,KAAK;AACxB,MAAI,MAAM,QAAQ,UAAU,GAAG;AAC7B,UAAM,KAAK,GAAG,WAAW,IAAI,CAAC,UAAUA,aAAAA,WAAW,OAAO,KAAK,CAAC,CAAC,CAAC;AAAA,EACpE,WAAW,eAAe,UAAa,eAAe,MAAM;AAC1D,UAAM,KAAKA,aAAAA,WAAW,OAAO,UAAU,CAAC,CAAC;AAAA,EAC3C;AAEA,aAAW,CAAC,MAAM,KAAK,KAAK,cAAc,IAAI,GAAG;AAC/C,QAAI,SAAS,OAAQ,YAAW,OAAO,MAAM,KAAK;AAAA,EACpD;AACA,SAAO,MAAM,KAAK,GAAG;AACvB;AAEA,SAAS,cACP,QAC0B;AAC1B,SAAO,OAAO,QAAQ,MAAM,EAAE;AAAA,IAAK,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,MAChD,KAAK,cAAc,KAAK;AAAA,EAAA;AAE5B;AAEA,SAAS,WAAW,OAAiB,MAAc,OAAsB;AACvE,MAAI,UAAU,UAAa,UAAU,QAAQ,UAAU,GAAI;AAC3D,MAAI,UAAU,MAAM;AAClB,UAAM,KAAK,KAAK,IAAI,EAAE;AACtB;AAAA,EACF;AACA,QAAM,KAAK,KAAK,IAAI,IAAIA,aAAAA,WAAW,UAAU,KAAK,CAAC,CAAC,EAAE;AACxD;AAEA,SAAS,UAAU,OAAwB;AACzC,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,MAAM,EAAE,KAAK,GAAG;AAC3D,MAAI,OAAO,UAAU,SAAU,QAAO,KAAK,UAAU,KAAK;AAC1D,SAAO,OAAO,KAAK;AACrB;;"}

package/dist/rpc/operation-cli-command.d.ts

@@ -0,0 +1,4 @@
+import { OperationScheduleCLI } from './operation-schedule-types';
+import { ResolvedOperation } from './types';
+export declare function operationCLICommand(operation: ResolvedOperation | undefined, args: Record<string, unknown>, cli: OperationScheduleCLI | undefined): string | undefined;
+//# sourceMappingURL=operation-cli-command.d.ts.map

package/dist/rpc/operation-cli-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-cli-command.d.ts","sourceRoot":"","sources":["../../src/rpc/operation-cli-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,oBAAoB,GAAG,SAAS,GACpC,MAAM,GAAG,SAAS,CAqBpB"}

package/dist/rpc/operation-cli-command.js

@@ -0,0 +1,43 @@
+import { shellQuote } from "../lib/shell-command.js";
+function operationCLICommand(operation, args, cli) {
+  var _a;
+  const command = (_a = operation == null ? void 0 : operation.operation["x-clicky"]) == null ? void 0 : _a.command;
+  if (!command || !(cli == null ? void 0 : cli.executable)) return void 0;
+  const parts = [shellQuote(cli.executable)];
+  for (const [name, value] of sortedEntries(cli.globalFlags ?? {})) {
+    appendFlag(parts, name, value);
+  }
+  parts.push(...command.split("/").filter(Boolean).map(shellQuote));
+  const positional = args.args;
+  if (Array.isArray(positional)) {
+    parts.push(...positional.map((value) => shellQuote(String(value))));
+  } else if (positional !== void 0 && positional !== null) {
+    parts.push(shellQuote(String(positional)));
+  }
+  for (const [name, value] of sortedEntries(args)) {
+    if (name !== "args") appendFlag(parts, name, value);
+  }
+  return parts.join(" ");
+}
+function sortedEntries(values) {
+  return Object.entries(values).sort(
+    ([left], [right]) => left.localeCompare(right)
+  );
+}
+function appendFlag(parts, name, value) {
+  if (value === void 0 || value === null || value === "") return;
+  if (value === true) {
+    parts.push(`--${name}`);
+    return;
+  }
+  parts.push(`--${name}=${shellQuote(flagValue(value))}`);
+}
+function flagValue(value) {
+  if (Array.isArray(value)) return value.map(String).join(",");
+  if (typeof value === "object") return JSON.stringify(value);
+  return String(value);
+}
+export {
+  operationCLICommand
+};
+//# sourceMappingURL=operation-cli-command.js.map

package/dist/rpc/operation-cli-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-cli-command.js","sources":["../../src/rpc/operation-cli-command.ts"],"sourcesContent":["import { shellQuote } from \"../lib/shell-command\";\nimport type { OperationScheduleCLI } from \"./operation-schedule-types\";\nimport type { ResolvedOperation } from \"./types\";\n\nexport function operationCLICommand(\n  operation: ResolvedOperation | undefined,\n  args: Record<string, unknown>,\n  cli: OperationScheduleCLI | undefined,\n): string | undefined {\n  const command = operation?.operation[\"x-clicky\"]?.command;\n  if (!command || !cli?.executable) return undefined;\n\n  const parts = [shellQuote(cli.executable)];\n  for (const [name, value] of sortedEntries(cli.globalFlags ?? {})) {\n    appendFlag(parts, name, value);\n  }\n  parts.push(...command.split(\"/\").filter(Boolean).map(shellQuote));\n\n  const positional = args.args;\n  if (Array.isArray(positional)) {\n    parts.push(...positional.map((value) => shellQuote(String(value))));\n  } else if (positional !== undefined && positional !== null) {\n    parts.push(shellQuote(String(positional)));\n  }\n\n  for (const [name, value] of sortedEntries(args)) {\n    if (name !== \"args\") appendFlag(parts, name, value);\n  }\n  return parts.join(\" \");\n}\n\nfunction sortedEntries(\n  values: Record<string, unknown>,\n): Array<[string, unknown]> {\n  return Object.entries(values).sort(([left], [right]) =>\n    left.localeCompare(right),\n  );\n}\n\nfunction appendFlag(parts: string[], name: string, value: unknown): void {\n  if (value === undefined || value === null || value === \"\") return;\n  if (value === true) {\n    parts.push(`--${name}`);\n    return;\n  }\n  parts.push(`--${name}=${shellQuote(flagValue(value))}`);\n}\n\nfunction flagValue(value: unknown): string {\n  if (Array.isArray(value)) return value.map(String).join(\",\");\n  if (typeof value === \"object\") return JSON.stringify(value);\n  return String(value);\n}\n"],"names":[],"mappings":";AAIO,SAAS,oBACd,WACA,MACA,KACoB;;AACpB,QAAM,WAAU,4CAAW,UAAU,gBAArB,mBAAkC;AAClD,MAAI,CAAC,WAAW,EAAC,2BAAK,YAAY,QAAO;AAEzC,QAAM,QAAQ,CAAC,WAAW,IAAI,UAAU,CAAC;AACzC,aAAW,CAAC,MAAM,KAAK,KAAK,cAAc,IAAI,eAAe,CAAA,CAAE,GAAG;AAChE,eAAW,OAAO,MAAM,KAAK;AAAA,EAC/B;AACA,QAAM,KAAK,GAAG,QAAQ,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,IAAI,UAAU,CAAC;AAEhE,QAAM,aAAa,KAAK;AACxB,MAAI,MAAM,QAAQ,UAAU,GAAG;AAC7B,UAAM,KAAK,GAAG,WAAW,IAAI,CAAC,UAAU,WAAW,OAAO,KAAK,CAAC,CAAC,CAAC;AAAA,EACpE,WAAW,eAAe,UAAa,eAAe,MAAM;AAC1D,UAAM,KAAK,WAAW,OAAO,UAAU,CAAC,CAAC;AAAA,EAC3C;AAEA,aAAW,CAAC,MAAM,KAAK,KAAK,cAAc,IAAI,GAAG;AAC/C,QAAI,SAAS,OAAQ,YAAW,OAAO,MAAM,KAAK;AAAA,EACpD;AACA,SAAO,MAAM,KAAK,GAAG;AACvB;AAEA,SAAS,cACP,QAC0B;AAC1B,SAAO,OAAO,QAAQ,MAAM,EAAE;AAAA,IAAK,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,MAChD,KAAK,cAAc,KAAK;AAAA,EAAA;AAE5B;AAEA,SAAS,WAAW,OAAiB,MAAc,OAAsB;AACvE,MAAI,UAAU,UAAa,UAAU,QAAQ,UAAU,GAAI;AAC3D,MAAI,UAAU,MAAM;AAClB,UAAM,KAAK,KAAK,IAAI,EAAE;AACtB;AAAA,EACF;AACA,QAAM,KAAK,KAAK,IAAI,IAAI,WAAW,UAAU,KAAK,CAAC,CAAC,EAAE;AACxD;AAEA,SAAS,UAAU,OAAwB;AACzC,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,MAAM,EAAE,KAAK,GAAG;AAC3D,MAAI,OAAO,UAAU,SAAU,QAAO,KAAK,UAAU,KAAK;AAC1D,SAAO,OAAO,KAAK;AACrB;"}

package/dist/rpc/operation-schedule-model.cjs

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const scheduleTypes = require("../components/schedule-types.cjs");
+function schedulableOperations(operations) {
+  return operations.filter(
+    ({ operation }) => {
+      var _a;
+      return Boolean(operation.operationId && ((_a = operation["x-clicky"]) == null ? void 0 : _a.schedule));
+    }
+  );
+}
+function operationLabel(operation) {
+  return (operation == null ? void 0 : operation.operation.summary) ?? (operation == null ? void 0 : operation.operation.operationId) ?? "Unknown operation";
+}
+function operationByID(operations, operationID) {
+  return operations.find(({ operation }) => operation.operationId === operationID);
+}
+function operationInputSchema(operation) {
+  var _a, _b, _c;
+  const schema = (_c = (_b = (_a = operation == null ? void 0 : operation.operation.requestBody) == null ? void 0 : _a.content) == null ? void 0 : _b["application/json"]) == null ? void 0 : _c.schema;
+  if (!schema || schema.type !== "object") return void 0;
+  return schema;
+}
+function newOperationScheduleInput() {
+  return {
+    name: "",
+    operationId: "",
+    args: {},
+    cron: scheduleTypes.DEFAULT_CRON,
+    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC",
+    enabled: true
+  };
+}
+function scheduleToInput(schedule) {
+  return {
+    name: schedule.name,
+    operationId: schedule.operationId,
+    args: schedule.args,
+    cron: schedule.cron,
+    timezone: schedule.timezone,
+    enabled: schedule.enabled
+  };
+}
+function formatScheduleTimestamp(value) {
+  if (!value) return "Never";
+  const timestamp = new Date(value);
+  return Number.isNaN(timestamp.getTime()) ? value : timestamp.toLocaleString();
+}
+exports.formatScheduleTimestamp = formatScheduleTimestamp;
+exports.newOperationScheduleInput = newOperationScheduleInput;
+exports.operationByID = operationByID;
+exports.operationInputSchema = operationInputSchema;
+exports.operationLabel = operationLabel;
+exports.schedulableOperations = schedulableOperations;
+exports.scheduleToInput = scheduleToInput;
+//# sourceMappingURL=operation-schedule-model.cjs.map

package/dist/rpc/operation-schedule-model.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-schedule-model.cjs","sources":["../../src/rpc/operation-schedule-model.ts"],"sourcesContent":["import type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport { DEFAULT_CRON } from \"../components/schedule-types\";\nimport type { OperationSchedule, OperationScheduleInput } from \"./operation-schedule-types\";\nimport type { ResolvedOperation } from \"./types\";\n\nexport function schedulableOperations(\n  operations: readonly ResolvedOperation[],\n): ResolvedOperation[] {\n  return operations.filter(\n    ({ operation }) => Boolean(operation.operationId && operation[\"x-clicky\"]?.schedule),\n  );\n}\n\nexport function operationLabel(operation: ResolvedOperation | undefined): string {\n  return operation?.operation.summary ?? operation?.operation.operationId ?? \"Unknown operation\";\n}\n\nexport function operationByID(\n  operations: readonly ResolvedOperation[],\n  operationID: string,\n): ResolvedOperation | undefined {\n  return operations.find(({ operation }) => operation.operationId === operationID);\n}\n\nexport function operationInputSchema(\n  operation: ResolvedOperation | undefined,\n): JsonSchemaObject | undefined {\n  const schema = operation?.operation.requestBody?.content?.[\"application/json\"]?.schema;\n  if (!schema || schema.type !== \"object\") return undefined;\n  return schema as JsonSchemaObject;\n}\n\nexport function newOperationScheduleInput(): OperationScheduleInput {\n  return {\n    name: \"\",\n    operationId: \"\",\n    args: {},\n    cron: DEFAULT_CRON,\n    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\",\n    enabled: true,\n  };\n}\n\nexport function scheduleToInput(schedule: OperationSchedule): OperationScheduleInput {\n  return {\n    name: schedule.name,\n    operationId: schedule.operationId,\n    args: schedule.args,\n    cron: schedule.cron,\n    timezone: schedule.timezone,\n    enabled: schedule.enabled,\n  };\n}\n\nexport function formatScheduleTimestamp(value: string | undefined): string {\n  if (!value) return \"Never\";\n  const timestamp = new Date(value);\n  return Number.isNaN(timestamp.getTime()) ? value : timestamp.toLocaleString();\n}\n"],"names":["DEFAULT_CRON"],"mappings":";;;AAKO,SAAS,sBACd,YACqB;AACrB,SAAO,WAAW;AAAA,IAChB,CAAC,EAAE,UAAA,MAAU;;AAAM,qBAAQ,UAAU,iBAAe,eAAU,UAAU,MAApB,mBAAuB,SAAQ;AAAA;AAAA,EAAA;AAEvF;AAEO,SAAS,eAAe,WAAkD;AAC/E,UAAO,uCAAW,UAAU,aAAW,uCAAW,UAAU,gBAAe;AAC7E;AAEO,SAAS,cACd,YACA,aAC+B;AAC/B,SAAO,WAAW,KAAK,CAAC,EAAE,gBAAgB,UAAU,gBAAgB,WAAW;AACjF;AAEO,SAAS,qBACd,WAC8B;;AAC9B,QAAM,UAAS,wDAAW,UAAU,gBAArB,mBAAkC,YAAlC,mBAA4C,wBAA5C,mBAAiE;AAChF,MAAI,CAAC,UAAU,OAAO,SAAS,SAAU,QAAO;AAChD,SAAO;AACT;AAEO,SAAS,4BAAoD;AAClE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,MAAM,CAAA;AAAA,IACN,MAAMA,cAAAA;AAAAA,IACN,UAAU,KAAK,eAAA,EAAiB,gBAAA,EAAkB,YAAY;AAAA,IAC9D,SAAS;AAAA,EAAA;AAEb;AAEO,SAAS,gBAAgB,UAAqD;AACnF,SAAO;AAAA,IACL,MAAM,SAAS;AAAA,IACf,aAAa,SAAS;AAAA,IACtB,MAAM,SAAS;AAAA,IACf,MAAM,SAAS;AAAA,IACf,UAAU,SAAS;AAAA,IACnB,SAAS,SAAS;AAAA,EAAA;AAEtB;AAEO,SAAS,wBAAwB,OAAmC;AACzE,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,YAAY,IAAI,KAAK,KAAK;AAChC,SAAO,OAAO,MAAM,UAAU,QAAA,CAAS,IAAI,QAAQ,UAAU,eAAA;AAC/D;;;;;;;;"}

package/dist/rpc/operation-schedule-model.d.ts

@@ -0,0 +1,11 @@
+import { JsonSchemaObject } from '../components/json-schema-form-types';
+import { OperationSchedule, OperationScheduleInput } from './operation-schedule-types';
+import { ResolvedOperation } from './types';
+export declare function schedulableOperations(operations: readonly ResolvedOperation[]): ResolvedOperation[];
+export declare function operationLabel(operation: ResolvedOperation | undefined): string;
+export declare function operationByID(operations: readonly ResolvedOperation[], operationID: string): ResolvedOperation | undefined;
+export declare function operationInputSchema(operation: ResolvedOperation | undefined): JsonSchemaObject | undefined;
+export declare function newOperationScheduleInput(): OperationScheduleInput;
+export declare function scheduleToInput(schedule: OperationSchedule): OperationScheduleInput;
+export declare function formatScheduleTimestamp(value: string | undefined): string;
+//# sourceMappingURL=operation-schedule-model.d.ts.map

package/dist/rpc/operation-schedule-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-schedule-model.d.ts","sourceRoot":"","sources":["../../src/rpc/operation-schedule-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,iBAAiB,EAAE,GACvC,iBAAiB,EAAE,CAIrB;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAE/E;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,WAAW,EAAE,MAAM,GAClB,iBAAiB,GAAG,SAAS,CAE/B;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,GAAG,SAAS,GACvC,gBAAgB,GAAG,SAAS,CAI9B;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CASlE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,sBAAsB,CASnF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIzE"}

package/dist/rpc/operation-schedule-model.js

@@ -0,0 +1,56 @@
+import { DEFAULT_CRON } from "../components/schedule-types.js";
+function schedulableOperations(operations) {
+  return operations.filter(
+    ({ operation }) => {
+      var _a;
+      return Boolean(operation.operationId && ((_a = operation["x-clicky"]) == null ? void 0 : _a.schedule));
+    }
+  );
+}
+function operationLabel(operation) {
+  return (operation == null ? void 0 : operation.operation.summary) ?? (operation == null ? void 0 : operation.operation.operationId) ?? "Unknown operation";
+}
+function operationByID(operations, operationID) {
+  return operations.find(({ operation }) => operation.operationId === operationID);
+}
+function operationInputSchema(operation) {
+  var _a, _b, _c;
+  const schema = (_c = (_b = (_a = operation == null ? void 0 : operation.operation.requestBody) == null ? void 0 : _a.content) == null ? void 0 : _b["application/json"]) == null ? void 0 : _c.schema;
+  if (!schema || schema.type !== "object") return void 0;
+  return schema;
+}
+function newOperationScheduleInput() {
+  return {
+    name: "",
+    operationId: "",
+    args: {},
+    cron: DEFAULT_CRON,
+    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC",
+    enabled: true
+  };
+}
+function scheduleToInput(schedule) {
+  return {
+    name: schedule.name,
+    operationId: schedule.operationId,
+    args: schedule.args,
+    cron: schedule.cron,
+    timezone: schedule.timezone,
+    enabled: schedule.enabled
+  };
+}
+function formatScheduleTimestamp(value) {
+  if (!value) return "Never";
+  const timestamp = new Date(value);
+  return Number.isNaN(timestamp.getTime()) ? value : timestamp.toLocaleString();
+}
+export {
+  formatScheduleTimestamp,
+  newOperationScheduleInput,
+  operationByID,
+  operationInputSchema,
+  operationLabel,
+  schedulableOperations,
+  scheduleToInput
+};
+//# sourceMappingURL=operation-schedule-model.js.map

package/dist/rpc/operation-schedule-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-schedule-model.js","sources":["../../src/rpc/operation-schedule-model.ts"],"sourcesContent":["import type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport { DEFAULT_CRON } from \"../components/schedule-types\";\nimport type { OperationSchedule, OperationScheduleInput } from \"./operation-schedule-types\";\nimport type { ResolvedOperation } from \"./types\";\n\nexport function schedulableOperations(\n  operations: readonly ResolvedOperation[],\n): ResolvedOperation[] {\n  return operations.filter(\n    ({ operation }) => Boolean(operation.operationId && operation[\"x-clicky\"]?.schedule),\n  );\n}\n\nexport function operationLabel(operation: ResolvedOperation | undefined): string {\n  return operation?.operation.summary ?? operation?.operation.operationId ?? \"Unknown operation\";\n}\n\nexport function operationByID(\n  operations: readonly ResolvedOperation[],\n  operationID: string,\n): ResolvedOperation | undefined {\n  return operations.find(({ operation }) => operation.operationId === operationID);\n}\n\nexport function operationInputSchema(\n  operation: ResolvedOperation | undefined,\n): JsonSchemaObject | undefined {\n  const schema = operation?.operation.requestBody?.content?.[\"application/json\"]?.schema;\n  if (!schema || schema.type !== \"object\") return undefined;\n  return schema as JsonSchemaObject;\n}\n\nexport function newOperationScheduleInput(): OperationScheduleInput {\n  return {\n    name: \"\",\n    operationId: \"\",\n    args: {},\n    cron: DEFAULT_CRON,\n    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\",\n    enabled: true,\n  };\n}\n\nexport function scheduleToInput(schedule: OperationSchedule): OperationScheduleInput {\n  return {\n    name: schedule.name,\n    operationId: schedule.operationId,\n    args: schedule.args,\n    cron: schedule.cron,\n    timezone: schedule.timezone,\n    enabled: schedule.enabled,\n  };\n}\n\nexport function formatScheduleTimestamp(value: string | undefined): string {\n  if (!value) return \"Never\";\n  const timestamp = new Date(value);\n  return Number.isNaN(timestamp.getTime()) ? value : timestamp.toLocaleString();\n}\n"],"names":[],"mappings":";AAKO,SAAS,sBACd,YACqB;AACrB,SAAO,WAAW;AAAA,IAChB,CAAC,EAAE,UAAA,MAAU;;AAAM,qBAAQ,UAAU,iBAAe,eAAU,UAAU,MAApB,mBAAuB,SAAQ;AAAA;AAAA,EAAA;AAEvF;AAEO,SAAS,eAAe,WAAkD;AAC/E,UAAO,uCAAW,UAAU,aAAW,uCAAW,UAAU,gBAAe;AAC7E;AAEO,SAAS,cACd,YACA,aAC+B;AAC/B,SAAO,WAAW,KAAK,CAAC,EAAE,gBAAgB,UAAU,gBAAgB,WAAW;AACjF;AAEO,SAAS,qBACd,WAC8B;;AAC9B,QAAM,UAAS,wDAAW,UAAU,gBAArB,mBAAkC,YAAlC,mBAA4C,wBAA5C,mBAAiE;AAChF,MAAI,CAAC,UAAU,OAAO,SAAS,SAAU,QAAO;AAChD,SAAO;AACT;AAEO,SAAS,4BAAoD;AAClE,SAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,MAAM,CAAA;AAAA,IACN,MAAM;AAAA,IACN,UAAU,KAAK,eAAA,EAAiB,gBAAA,EAAkB,YAAY;AAAA,IAC9D,SAAS;AAAA,EAAA;AAEb;AAEO,SAAS,gBAAgB,UAAqD;AACnF,SAAO;AAAA,IACL,MAAM,SAAS;AAAA,IACf,aAAa,SAAS;AAAA,IACtB,MAAM,SAAS;AAAA,IACf,MAAM,SAAS;AAAA,IACf,UAAU,SAAS;AAAA,IACnB,SAAS,SAAS;AAAA,EAAA;AAEtB;AAEO,SAAS,wBAAwB,OAAmC;AACzE,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,YAAY,IAAI,KAAK,KAAK;AAChC,SAAO,OAAO,MAAM,UAAU,QAAA,CAAS,IAAI,QAAQ,UAAU,eAAA;AAC/D;"}

package/dist/rpc/operation-schedule-types.d.ts

@@ -0,0 +1,31 @@
+import { ResolvedOperation } from './types';
+export interface OperationSchedule {
+    id: string;
+    name: string;
+    operationId: string;
+    args: Record<string, unknown>;
+    cron: string;
+    timezone: string;
+    enabled: boolean;
+    lastRun?: string;
+    nextRun?: string;
+}
+export type OperationScheduleInput = Omit<OperationSchedule, "id" | "lastRun" | "nextRun">;
+export type OperationScheduleRunInput = Pick<OperationScheduleInput, "operationId" | "args">;
+export interface OperationScheduleCLI {
+    executable: string;
+    globalFlags?: Record<string, unknown>;
+}
+export interface OperationSchedulesProps {
+    operations: readonly ResolvedOperation[];
+    schedules: readonly OperationSchedule[];
+    disabled?: boolean;
+    loading?: boolean;
+    cli?: OperationScheduleCLI;
+    onCreate: (input: OperationScheduleInput) => Promise<unknown>;
+    onUpdate: (id: string, input: OperationScheduleInput) => Promise<unknown>;
+    onDelete: (id: string) => Promise<unknown>;
+    onRunSaved: (id: string) => Promise<unknown>;
+    onRunDraft: (input: OperationScheduleRunInput) => Promise<unknown>;
+}
+//# sourceMappingURL=operation-schedule-types.d.ts.map

package/dist/rpc/operation-schedule-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-schedule-types.d.ts","sourceRoot":"","sources":["../../src/rpc/operation-schedule-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,iBAAiB,EACjB,IAAI,GAAG,SAAS,GAAG,SAAS,CAC7B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,sBAAsB,EACtB,aAAa,GAAG,MAAM,CACvB,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACzC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,UAAU,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE"}

package/dist/rpc/operationCatalogFilterState.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const operationCatalogUrl = require("./operationCatalogUrl.cjs");
+function useOperationCatalogFilterState({
+  listParameters,
+  lockedValues,
+  urlState,
+  initialValues
+}) {
+  const urlStateDisabled = urlState === false;
+  const urlStatePrefix = urlState ? urlState.prefix : void 0;
+  const [filters, setFilters] = react.useState(() => ({
+    ...initialValues,
+    ...urlStateDisabled ? {} : operationCatalogUrl.readOperationFiltersFromUrl(urlStatePrefix)
+  }));
+  const effectiveFilters = react.useMemo(
+    () => ({ ...filters, ...lockedValues }),
+    [filters, lockedValues]
+  );
+  react.useEffect(() => {
+    if (urlStateDisabled) return;
+    operationCatalogUrl.writeOperationFiltersToUrl(
+      filters,
+      listParameters.map((parameter) => parameter.name).filter(
+        (name) => !Object.prototype.hasOwnProperty.call(lockedValues, name)
+      ),
+      urlStatePrefix
+    );
+  }, [filters, listParameters, lockedValues, urlStateDisabled, urlStatePrefix]);
+  return { filters, setFilters, effectiveFilters };
+}
+exports.useOperationCatalogFilterState = useOperationCatalogFilterState;
+//# sourceMappingURL=operationCatalogFilterState.cjs.map

package/dist/rpc/operationCatalogFilterState.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationCatalogFilterState.cjs","sources":["../../src/rpc/operationCatalogFilterState.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport type { ParameterValues, ParameterValuesSetter } from \"./formMetadata\";\nimport {\n  readOperationFiltersFromUrl,\n  writeOperationFiltersToUrl,\n} from \"./operationCatalogUrl\";\nimport type { OpenAPIParameter } from \"./types\";\n\nexport type OperationCatalogUrlState = false | { prefix: string };\n\nexport type OperationCatalogFilterState = {\n  /** The FilterBar's own state — never includes a locked param. */\n  filters: ParameterValues;\n  setFilters: ParameterValuesSetter;\n  /**\n   * `filters` with `lockedValues` merged in. This is what every list request,\n   * filter lookup and export/download URL is built from — locked values\n   * always win, and a param a host has locked can never be overridden by\n   * anything the FilterBar itself could produce.\n   */\n  effectiveFilters: ParameterValues;\n};\n\n/**\n * useOperationCatalogFilterState owns OperationCatalog's filter state and its\n * two host-controlled overlays:\n *\n * - `lockedValues` are merged into every effective request but are never\n *   read from, or written to, the URL — they are the host's, not the\n *   reader's, to carry across a reload or a shared link.\n * - `urlState` decides whether (and under what key) the remaining, editable\n *   filters round-trip through the URL at all: unset keeps today's\n *   unprefixed behaviour, `false` turns it off, and `{ prefix }` namespaces\n *   every key so a catalog embedded in a host route (its own `?step=&tab=`)\n *   never collides with it.\n */\nexport function useOperationCatalogFilterState({\n  listParameters,\n  lockedValues,\n  urlState,\n  initialValues,\n}: {\n  listParameters: OpenAPIParameter[];\n  lockedValues: ParameterValues;\n  urlState: OperationCatalogUrlState | undefined;\n  /**\n   * Editable seed values applied only to a key the URL has no value for —\n   * unlike `lockedValues`, these are ordinary starting `filters`: the reader\n   * can change them, and a change round-trips through the URL like any other\n   * edit. Never merged into `lockedValues` and never itself written to the\n   * URL as a distinct concept (only the resulting `filters` value is).\n   */\n  initialValues?: ParameterValues;\n}): OperationCatalogFilterState {\n  // Read as primitives rather than the `urlState` object itself so an inline\n  // object literal from the host does not retrigger the URL-write effect on\n  // every render.\n  const urlStateDisabled = urlState === false;\n  const urlStatePrefix = urlState ? urlState.prefix : undefined;\n\n  const [filters, setFilters] = useState<ParameterValues>(() => ({\n    ...initialValues,\n    ...(urlStateDisabled ? {} : readOperationFiltersFromUrl(urlStatePrefix)),\n  }));\n\n  const effectiveFilters = useMemo(\n    () => ({ ...filters, ...lockedValues }),\n    [filters, lockedValues]\n  );\n\n  useEffect(() => {\n    if (urlStateDisabled) return;\n    writeOperationFiltersToUrl(\n      filters,\n      listParameters\n        .map((parameter) => parameter.name)\n        .filter(\n          (name) => !Object.prototype.hasOwnProperty.call(lockedValues, name)\n        ),\n      urlStatePrefix\n    );\n  }, [filters, listParameters, lockedValues, urlStateDisabled, urlStatePrefix]);\n\n  return { filters, setFilters, effectiveFilters };\n}\n"],"names":["useState","readOperationFiltersFromUrl","useMemo","useEffect","writeOperationFiltersToUrl"],"mappings":";;;;AAoCO,SAAS,+BAA+B;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAYgC;AAI9B,QAAM,mBAAmB,aAAa;AACtC,QAAM,iBAAiB,WAAW,SAAS,SAAS;AAEpD,QAAM,CAAC,SAAS,UAAU,IAAIA,MAAAA,SAA0B,OAAO;AAAA,IAC7D,GAAG;AAAA,IACH,GAAI,mBAAmB,KAAKC,oBAAAA,4BAA4B,cAAc;AAAA,EAAA,EACtE;AAEF,QAAM,mBAAmBC,MAAAA;AAAAA,IACvB,OAAO,EAAE,GAAG,SAAS,GAAG;IACxB,CAAC,SAAS,YAAY;AAAA,EAAA;AAGxBC,QAAAA,UAAU,MAAM;AACd,QAAI,iBAAkB;AACtBC,wBAAAA;AAAAA,MACE;AAAA,MACA,eACG,IAAI,CAAC,cAAc,UAAU,IAAI,EACjC;AAAA,QACC,CAAC,SAAS,CAAC,OAAO,UAAU,eAAe,KAAK,cAAc,IAAI;AAAA,MAAA;AAAA,MAEtE;AAAA,IAAA;AAAA,EAEJ,GAAG,CAAC,SAAS,gBAAgB,cAAc,kBAAkB,cAAc,CAAC;AAE5E,SAAO,EAAE,SAAS,YAAY,iBAAA;AAChC;;"}

package/dist/rpc/operationCatalogFilterState.d.ts

@@ -0,0 +1,44 @@
+import { ParameterValues, ParameterValuesSetter } from './formMetadata';
+import { OpenAPIParameter } from './types';
+export type OperationCatalogUrlState = false | {
+    prefix: string;
+};
+export type OperationCatalogFilterState = {
+    /** The FilterBar's own state — never includes a locked param. */
+    filters: ParameterValues;
+    setFilters: ParameterValuesSetter;
+    /**
+     * `filters` with `lockedValues` merged in. This is what every list request,
+     * filter lookup and export/download URL is built from — locked values
+     * always win, and a param a host has locked can never be overridden by
+     * anything the FilterBar itself could produce.
+     */
+    effectiveFilters: ParameterValues;
+};
+/**
+ * useOperationCatalogFilterState owns OperationCatalog's filter state and its
+ * two host-controlled overlays:
+ *
+ * - `lockedValues` are merged into every effective request but are never
+ *   read from, or written to, the URL — they are the host's, not the
+ *   reader's, to carry across a reload or a shared link.
+ * - `urlState` decides whether (and under what key) the remaining, editable
+ *   filters round-trip through the URL at all: unset keeps today's
+ *   unprefixed behaviour, `false` turns it off, and `{ prefix }` namespaces
+ *   every key so a catalog embedded in a host route (its own `?step=&tab=`)
+ *   never collides with it.
+ */
+export declare function useOperationCatalogFilterState({ listParameters, lockedValues, urlState, initialValues, }: {
+    listParameters: OpenAPIParameter[];
+    lockedValues: ParameterValues;
+    urlState: OperationCatalogUrlState | undefined;
+    /**
+     * Editable seed values applied only to a key the URL has no value for —
+     * unlike `lockedValues`, these are ordinary starting `filters`: the reader
+     * can change them, and a change round-trips through the URL like any other
+     * edit. Never merged into `lockedValues` and never itself written to the
+     * URL as a distinct concept (only the resulting `filters` value is).
+     */
+    initialValues?: ParameterValues;
+}): OperationCatalogFilterState;
+//# sourceMappingURL=operationCatalogFilterState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operationCatalogFilterState.d.ts","sourceRoot":"","sources":["../../src/rpc/operationCatalogFilterState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAK7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,MAAM,wBAAwB,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,2BAA2B,GAAG;IACxC,iEAAiE;IACjE,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,qBAAqB,CAAC;IAClC;;;;;OAKG;IACH,gBAAgB,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,EAAE;IACD,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,YAAY,EAAE,eAAe,CAAC;IAC9B,QAAQ,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC/C;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC,GAAG,2BAA2B,CA+B9B"}

package/dist/rpc/operationCatalogFilterState.js

@@ -0,0 +1,34 @@
+import { useState, useMemo, useEffect } from "react";
+import { readOperationFiltersFromUrl, writeOperationFiltersToUrl } from "./operationCatalogUrl.js";
+function useOperationCatalogFilterState({
+  listParameters,
+  lockedValues,
+  urlState,
+  initialValues
+}) {
+  const urlStateDisabled = urlState === false;
+  const urlStatePrefix = urlState ? urlState.prefix : void 0;
+  const [filters, setFilters] = useState(() => ({
+    ...initialValues,
+    ...urlStateDisabled ? {} : readOperationFiltersFromUrl(urlStatePrefix)
+  }));
+  const effectiveFilters = useMemo(
+    () => ({ ...filters, ...lockedValues }),
+    [filters, lockedValues]
+  );
+  useEffect(() => {
+    if (urlStateDisabled) return;
+    writeOperationFiltersToUrl(
+      filters,
+      listParameters.map((parameter) => parameter.name).filter(
+        (name) => !Object.prototype.hasOwnProperty.call(lockedValues, name)
+      ),
+      urlStatePrefix
+    );
+  }, [filters, listParameters, lockedValues, urlStateDisabled, urlStatePrefix]);
+  return { filters, setFilters, effectiveFilters };
+}
+export {
+  useOperationCatalogFilterState
+};
+//# sourceMappingURL=operationCatalogFilterState.js.map

package/dist/rpc/operationCatalogFilterState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationCatalogFilterState.js","sources":["../../src/rpc/operationCatalogFilterState.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport type { ParameterValues, ParameterValuesSetter } from \"./formMetadata\";\nimport {\n  readOperationFiltersFromUrl,\n  writeOperationFiltersToUrl,\n} from \"./operationCatalogUrl\";\nimport type { OpenAPIParameter } from \"./types\";\n\nexport type OperationCatalogUrlState = false | { prefix: string };\n\nexport type OperationCatalogFilterState = {\n  /** The FilterBar's own state — never includes a locked param. */\n  filters: ParameterValues;\n  setFilters: ParameterValuesSetter;\n  /**\n   * `filters` with `lockedValues` merged in. This is what every list request,\n   * filter lookup and export/download URL is built from — locked values\n   * always win, and a param a host has locked can never be overridden by\n   * anything the FilterBar itself could produce.\n   */\n  effectiveFilters: ParameterValues;\n};\n\n/**\n * useOperationCatalogFilterState owns OperationCatalog's filter state and its\n * two host-controlled overlays:\n *\n * - `lockedValues` are merged into every effective request but are never\n *   read from, or written to, the URL — they are the host's, not the\n *   reader's, to carry across a reload or a shared link.\n * - `urlState` decides whether (and under what key) the remaining, editable\n *   filters round-trip through the URL at all: unset keeps today's\n *   unprefixed behaviour, `false` turns it off, and `{ prefix }` namespaces\n *   every key so a catalog embedded in a host route (its own `?step=&tab=`)\n *   never collides with it.\n */\nexport function useOperationCatalogFilterState({\n  listParameters,\n  lockedValues,\n  urlState,\n  initialValues,\n}: {\n  listParameters: OpenAPIParameter[];\n  lockedValues: ParameterValues;\n  urlState: OperationCatalogUrlState | undefined;\n  /**\n   * Editable seed values applied only to a key the URL has no value for —\n   * unlike `lockedValues`, these are ordinary starting `filters`: the reader\n   * can change them, and a change round-trips through the URL like any other\n   * edit. Never merged into `lockedValues` and never itself written to the\n   * URL as a distinct concept (only the resulting `filters` value is).\n   */\n  initialValues?: ParameterValues;\n}): OperationCatalogFilterState {\n  // Read as primitives rather than the `urlState` object itself so an inline\n  // object literal from the host does not retrigger the URL-write effect on\n  // every render.\n  const urlStateDisabled = urlState === false;\n  const urlStatePrefix = urlState ? urlState.prefix : undefined;\n\n  const [filters, setFilters] = useState<ParameterValues>(() => ({\n    ...initialValues,\n    ...(urlStateDisabled ? {} : readOperationFiltersFromUrl(urlStatePrefix)),\n  }));\n\n  const effectiveFilters = useMemo(\n    () => ({ ...filters, ...lockedValues }),\n    [filters, lockedValues]\n  );\n\n  useEffect(() => {\n    if (urlStateDisabled) return;\n    writeOperationFiltersToUrl(\n      filters,\n      listParameters\n        .map((parameter) => parameter.name)\n        .filter(\n          (name) => !Object.prototype.hasOwnProperty.call(lockedValues, name)\n        ),\n      urlStatePrefix\n    );\n  }, [filters, listParameters, lockedValues, urlStateDisabled, urlStatePrefix]);\n\n  return { filters, setFilters, effectiveFilters };\n}\n"],"names":[],"mappings":";;AAoCO,SAAS,+BAA+B;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAYgC;AAI9B,QAAM,mBAAmB,aAAa;AACtC,QAAM,iBAAiB,WAAW,SAAS,SAAS;AAEpD,QAAM,CAAC,SAAS,UAAU,IAAI,SAA0B,OAAO;AAAA,IAC7D,GAAG;AAAA,IACH,GAAI,mBAAmB,KAAK,4BAA4B,cAAc;AAAA,EAAA,EACtE;AAEF,QAAM,mBAAmB;AAAA,IACvB,OAAO,EAAE,GAAG,SAAS,GAAG;IACxB,CAAC,SAAS,YAAY;AAAA,EAAA;AAGxB,YAAU,MAAM;AACd,QAAI,iBAAkB;AACtB;AAAA,MACE;AAAA,MACA,eACG,IAAI,CAAC,cAAc,UAAU,IAAI,EACjC;AAAA,QACC,CAAC,SAAS,CAAC,OAAO,UAAU,eAAe,KAAK,cAAc,IAAI;AAAA,MAAA;AAAA,MAEtE;AAAA,IAAA;AAAA,EAEJ,GAAG,CAAC,SAAS,gBAAgB,cAAc,kBAAkB,cAAc,CAAC;AAE5E,SAAO,EAAE,SAAS,YAAY,iBAAA;AAChC;"}

package/dist/rpc/operationCatalogFollow.cjs

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const executionPages = require("./executionPages.cjs");
+const rowNavigation = require("./rowNavigation.cjs");
+const FOLLOW_EXCLUDED_ROLES = /* @__PURE__ */ new Set(["limit", "offset", "cursor", "sort", "order"]);
+function followSessionParams(listParameters, effectiveFilters) {
+  var _a;
+  const params = {};
+  for (const parameter of listParameters) {
+    const role = ((_a = parameter["x-clicky"]) == null ? void 0 : _a.role) ?? "";
+    if (FOLLOW_EXCLUDED_ROLES.has(role)) continue;
+    const value = effectiveFilters[parameter.name];
+    if (value !== void 0 && value !== "") params[parameter.name] = value;
+  }
+  return params;
+}
+function findSessionStartOperation(operations, listEndpoint) {
+  if (!listEndpoint) return void 0;
+  const sessionsPath = `${listEndpoint.path}/sessions`;
+  return operations.find(
+    (operation) => operation.method.toLowerCase() === "post" && operation.path === sessionsPath
+  );
+}
+function deriveLogTailTarget(path) {
+  const marker = "/profile/";
+  const index = path.indexOf(marker);
+  if (index < 0) return void 0;
+  const profile = path.slice(index + marker.length);
+  if (!profile) return void 0;
+  return { basePath: path.slice(0, index) || "/", profile };
+}
+const SEQ_ID_KEYS = ["seq", "Seq", "sequence", "Sequence"];
+function followRowIdentity(row) {
+  var _a;
+  const id = rowNavigation.getClickyRowId(row);
+  if (id) return id;
+  for (const key of SEQ_ID_KEYS) {
+    const plain = (_a = row.cells[key]) == null ? void 0 : _a.plain;
+    if (plain) return `${key}:${plain}`;
+  }
+  return void 0;
+}
+function followRowOrder(sortDir) {
+  return sortDir === "asc" ? "oldest-first" : "newest-first";
+}
+function partitionFollowRows(rows, clickyRows) {
+  const presented = [];
+  let missingClickyRow = false;
+  for (let index = 0; index < rows.length; index += 1) {
+    const clickyRow = clickyRows[index];
+    if (clickyRow) presented.push(clickyRow);
+    else missingClickyRow = true;
+  }
+  return { rows: presented, missingClickyRow };
+}
+function mergeFollowRowsIntoResponse(response, liveRows, order = "newest-first") {
+  if (!response || liveRows.length === 0) return void 0;
+  const document = executionPages.documentOf(response);
+  if (!document) return void 0;
+  const table = executionPages.findFirstTable(document.node);
+  if (!table) {
+    throw new Error(
+      "OperationCatalog follow mode: the list response carries no table to merge live rows into"
+    );
+  }
+  const existingRows = table.rows ?? [];
+  const existingIds = new Set(
+    existingRows.map(followRowIdentity).filter((id) => id != null)
+  );
+  const freshRows = liveRows.filter((row) => {
+    const id = followRowIdentity(row);
+    return id == null || !existingIds.has(id);
+  });
+  if (freshRows.length === 0) return void 0;
+  const ordered = order === "newest-first" ? [...freshRows].reverse() : freshRows;
+  const mergedRows = order === "newest-first" ? [...ordered, ...existingRows] : [...existingRows, ...ordered];
+  const merged = {
+    version: 1,
+    node: executionPages.mapFirstTable(document.node, (t) => ({ ...t, rows: mergedRows })).node
+  };
+  return {
+    response: { ...response, parsed: merged, stdout: JSON.stringify(merged) },
+    addedCount: freshRows.length
+  };
+}
+exports.deriveLogTailTarget = deriveLogTailTarget;
+exports.findSessionStartOperation = findSessionStartOperation;
+exports.followRowIdentity = followRowIdentity;
+exports.followRowOrder = followRowOrder;
+exports.followSessionParams = followSessionParams;
+exports.mergeFollowRowsIntoResponse = mergeFollowRowsIntoResponse;
+exports.partitionFollowRows = partitionFollowRows;
+//# sourceMappingURL=operationCatalogFollow.cjs.map

package/dist/rpc/operationCatalogFollow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationCatalogFollow.cjs","sources":["../../src/rpc/operationCatalogFollow.ts"],"sourcesContent":["import type { ClickyDocument, ClickyRow } from \"../data/Clicky\";\nimport { documentOf, findFirstTable, mapFirstTable } from \"./executionPages\";\nimport { getClickyRowId } from \"./rowNavigation\";\nimport type { ExecutionResponse, OpenAPIParameter, ResolvedOperation } from \"./types\";\n\n// Parameter roles a follow session's query string mirrors: everything that\n// scopes *which* rows the stream serves (locked values, filter chips, search,\n// a time window). Paging/sort/cursor describe a fetched page, not a live\n// stream that has no pages to walk and appends rows in the order they close.\nconst FOLLOW_EXCLUDED_ROLES = new Set([\"limit\", \"offset\", \"cursor\", \"sort\", \"order\"]);\n\n/**\n * The query-string params a follow session opens with: the same scoping\n * parameters (locked values plus every active filter/search) the list\n * request itself sends, minus paging/sort/cursor. Reusing exactly these,\n * rather than a separate follow-specific filter set, is what keeps a follow\n * session and the page it augments looking at the same rows.\n */\nexport function followSessionParams(\n  listParameters: OpenAPIParameter[],\n  effectiveFilters: Record<string, string>,\n): Record<string, string> {\n  const params: Record<string, string> = {};\n  for (const parameter of listParameters) {\n    const role = parameter[\"x-clicky\"]?.role ?? \"\";\n    if (FOLLOW_EXCLUDED_ROLES.has(role)) continue;\n    const value = effectiveFilters[parameter.name];\n    if (value !== undefined && value !== \"\") params[parameter.name] = value;\n  }\n  return params;\n}\n\n/**\n * Finds the session-start operation the server contract advertises for a\n * followable list operation: `POST <listPath>/sessions` (operationId\n * `start-<name>-session`). Matched on path+method rather than the\n * operationId spelling, because the path is what `useLogTail` actually\n * calls — this is the one fact that has to be right.\n */\nexport function findSessionStartOperation(\n  operations: ResolvedOperation[],\n  listEndpoint: ResolvedOperation | undefined,\n): ResolvedOperation | undefined {\n  if (!listEndpoint) return undefined;\n  const sessionsPath = `${listEndpoint.path}/sessions`;\n  return operations.find(\n    (operation) => operation.method.toLowerCase() === \"post\" && operation.path === sessionsPath,\n  );\n}\n\nexport type LogTailTarget = { basePath: string; profile: string };\n\n/**\n * Splits a list operation's path into the session API's basePath and profile\n * name. `useLogTail` builds `POST {basePath}/profile/{profile}/sessions`\n * itself, so this only has to find where \"/profile/\" sits in the operation's\n * own path — e.g. \"/api/v1/profile/profile-trace-results-jvm-trace\" splits\n * into basePath \"/api/v1\" and profile \"profile-trace-results-jvm-trace\".\n */\nexport function deriveLogTailTarget(path: string): LogTailTarget | undefined {\n  const marker = \"/profile/\";\n  const index = path.indexOf(marker);\n  if (index < 0) return undefined;\n  const profile = path.slice(index + marker.length);\n  if (!profile) return undefined;\n  return { basePath: path.slice(0, index) || \"/\", profile };\n}\n\n// Result rows carry a unique \"seq\" column (the recordstore's own sequence)\n// even when they have none of the conventional id columns getClickyRowId\n// looks for, so follow-row identity falls back to it before giving up.\nconst SEQ_ID_KEYS = [\"seq\", \"Seq\", \"sequence\", \"Sequence\"];\n\n/**\n * Row identity for follow-mode dedup, read off the *presented* ClickyRow —\n * the same cells the table itself renders — rather than the raw JSON row's\n * own field names, which need not match a column name at all (a presenter\n * can rename, compute or drop fields). Using the presented row is what keeps\n * dedup correct without follow mode having to know a profile's raw shape.\n */\nexport function followRowIdentity(row: ClickyRow): string | undefined {\n  const id = getClickyRowId(row);\n  if (id) return id;\n  for (const key of SEQ_ID_KEYS) {\n    const plain = row.cells[key]?.plain;\n    if (plain) return `${key}:${plain}`;\n  }\n  return undefined;\n}\n\nexport type FollowRowOrder = \"newest-first\" | \"oldest-first\";\n\n/** The insertion order a follow merge uses, from the catalog's own sort\n *  direction: descending (or no sort at all — the default a live view reads\n *  as \"most recent on top\") keeps the newest arrival at the head; ascending\n *  keeps the table's oldest-first order and appends at the tail. */\nexport function followRowOrder(sortDir: \"asc\" | \"desc\" | undefined): FollowRowOrder {\n  return sortDir === \"asc\" ? \"oldest-first\" : \"newest-first\";\n}\n\nexport type FollowRowsPartition = {\n  /** Presented rows ready to merge into the table, in arrival order. */\n  rows: ClickyRow[];\n  /**\n   * True when at least one buffered row-shaped event arrived with no\n   * presented `clickyRow`. OperationCatalog's follow mode only ever targets\n   * a tabular list surface, whose per-row events are expected to carry one\n   * (see `LogTailEvent.clickyRow`); a row missing it is never guessed at as\n   * plain text — it is a stream contract violation to surface as an error.\n   */\n  missingClickyRow: boolean;\n};\n\n/**\n * Pairs `useLogTail`'s raw `rows` with its index-aligned `clickyRows` (both\n * from `UseLogTailResult`) and separates the two things a caller needs:\n * the rows that are ready to merge, and whether any arrived without one.\n */\nexport function partitionFollowRows(\n  rows: Record<string, unknown>[],\n  clickyRows: (ClickyRow | undefined)[],\n): FollowRowsPartition {\n  const presented: ClickyRow[] = [];\n  let missingClickyRow = false;\n  for (let index = 0; index < rows.length; index += 1) {\n    const clickyRow = clickyRows[index];\n    if (clickyRow) presented.push(clickyRow);\n    else missingClickyRow = true;\n  }\n  return { rows: presented, missingClickyRow };\n}\n\nexport type FollowMergeResult = {\n  response: ExecutionResponse;\n  /** Live rows folded into the table that were not already on the page. */\n  addedCount: number;\n};\n\n/**\n * Folds a follow session's presented rows into the last list response's\n * table — de-duplicated against whatever the table already shows, including\n * rows a later refetch brought back through the ordinary list query.\n * Recomputed from `response` fresh on every call rather than keeping its own\n * running row list, which is what keeps a refetch from ever duplicating a\n * row this merge already folded in.\n *\n * Returns undefined when there is nothing new to fold in — no response yet,\n * no live rows, or every live row already on the page — so a caller can\n * cheaply keep rendering the unmerged response by identity.\n *\n * Throws when `response` carries no table to merge into: a follow session\n * only ever targets a tabular list surface, so a response with nothing to\n * fold into is a contract violation, not a case to quietly drop rows for.\n */\nexport function mergeFollowRowsIntoResponse(\n  response: ExecutionResponse | null,\n  liveRows: ClickyRow[],\n  order: FollowRowOrder = \"newest-first\",\n): FollowMergeResult | undefined {\n  if (!response || liveRows.length === 0) return undefined;\n  const document = documentOf(response);\n  if (!document) return undefined;\n  const table = findFirstTable(document.node);\n  if (!table) {\n    throw new Error(\n      \"OperationCatalog follow mode: the list response carries no table to merge live rows into\",\n    );\n  }\n\n  const existingRows = table.rows ?? [];\n  const existingIds = new Set(\n    existingRows.map(followRowIdentity).filter((id): id is string => id != null),\n  );\n  const freshRows = liveRows.filter((row) => {\n    const id = followRowIdentity(row);\n    return id == null || !existingIds.has(id);\n  });\n  if (freshRows.length === 0) return undefined;\n\n  // `liveRows` arrives oldest-first (LogTailBuffer's own order); a\n  // newest-first merge has to reverse that batch so the freshest arrival ends\n  // up first, right at the table's head.\n  const ordered = order === \"newest-first\" ? [...freshRows].reverse() : freshRows;\n  const mergedRows =\n    order === \"newest-first\" ? [...ordered, ...existingRows] : [...existingRows, ...ordered];\n\n  const merged: ClickyDocument = {\n    version: 1,\n    node: mapFirstTable(document.node, (t) => ({ ...t, rows: mergedRows })).node,\n  };\n\n  return {\n    response: { ...response, parsed: merged, stdout: JSON.stringify(merged) },\n    addedCount: freshRows.length,\n  };\n}\n"],"names":["getClickyRowId","documentOf","findFirstTable","mapFirstTable"],"mappings":";;;;AASA,MAAM,4CAA4B,IAAI,CAAC,SAAS,UAAU,UAAU,QAAQ,OAAO,CAAC;AAS7E,SAAS,oBACd,gBACA,kBACwB;;AACxB,QAAM,SAAiC,CAAA;AACvC,aAAW,aAAa,gBAAgB;AACtC,UAAM,SAAO,eAAU,UAAU,MAApB,mBAAuB,SAAQ;AAC5C,QAAI,sBAAsB,IAAI,IAAI,EAAG;AACrC,UAAM,QAAQ,iBAAiB,UAAU,IAAI;AAC7C,QAAI,UAAU,UAAa,UAAU,GAAI,QAAO,UAAU,IAAI,IAAI;AAAA,EACpE;AACA,SAAO;AACT;AASO,SAAS,0BACd,YACA,cAC+B;AAC/B,MAAI,CAAC,aAAc,QAAO;AAC1B,QAAM,eAAe,GAAG,aAAa,IAAI;AACzC,SAAO,WAAW;AAAA,IAChB,CAAC,cAAc,UAAU,OAAO,kBAAkB,UAAU,UAAU,SAAS;AAAA,EAAA;AAEnF;AAWO,SAAS,oBAAoB,MAAyC;AAC3E,QAAM,SAAS;AACf,QAAM,QAAQ,KAAK,QAAQ,MAAM;AACjC,MAAI,QAAQ,EAAG,QAAO;AACtB,QAAM,UAAU,KAAK,MAAM,QAAQ,OAAO,MAAM;AAChD,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,EAAE,UAAU,KAAK,MAAM,GAAG,KAAK,KAAK,KAAK,QAAA;AAClD;AAKA,MAAM,cAAc,CAAC,OAAO,OAAO,YAAY,UAAU;AASlD,SAAS,kBAAkB,KAAoC;;AACpE,QAAM,KAAKA,cAAAA,eAAe,GAAG;AAC7B,MAAI,GAAI,QAAO;AACf,aAAW,OAAO,aAAa;AAC7B,UAAM,SAAQ,SAAI,MAAM,GAAG,MAAb,mBAAgB;AAC9B,QAAI,MAAO,QAAO,GAAG,GAAG,IAAI,KAAK;AAAA,EACnC;AACA,SAAO;AACT;AAQO,SAAS,eAAe,SAAqD;AAClF,SAAO,YAAY,QAAQ,iBAAiB;AAC9C;AAoBO,SAAS,oBACd,MACA,YACqB;AACrB,QAAM,YAAyB,CAAA;AAC/B,MAAI,mBAAmB;AACvB,WAAS,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;AACnD,UAAM,YAAY,WAAW,KAAK;AAClC,QAAI,UAAW,WAAU,KAAK,SAAS;AAAA,QAClC,oBAAmB;AAAA,EAC1B;AACA,SAAO,EAAE,MAAM,WAAW,iBAAA;AAC5B;AAwBO,SAAS,4BACd,UACA,UACA,QAAwB,gBACO;AAC/B,MAAI,CAAC,YAAY,SAAS,WAAW,EAAG,QAAO;AAC/C,QAAM,WAAWC,eAAAA,WAAW,QAAQ;AACpC,MAAI,CAAC,SAAU,QAAO;AACtB,QAAM,QAAQC,eAAAA,eAAe,SAAS,IAAI;AAC1C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,QAAM,eAAe,MAAM,QAAQ,CAAA;AACnC,QAAM,cAAc,IAAI;AAAA,IACtB,aAAa,IAAI,iBAAiB,EAAE,OAAO,CAAC,OAAqB,MAAM,IAAI;AAAA,EAAA;AAE7E,QAAM,YAAY,SAAS,OAAO,CAAC,QAAQ;AACzC,UAAM,KAAK,kBAAkB,GAAG;AAChC,WAAO,MAAM,QAAQ,CAAC,YAAY,IAAI,EAAE;AAAA,EAC1C,CAAC;AACD,MAAI,UAAU,WAAW,EAAG,QAAO;AAKnC,QAAM,UAAU,UAAU,iBAAiB,CAAC,GAAG,SAAS,EAAE,YAAY;AACtE,QAAM,aACJ,UAAU,iBAAiB,CAAC,GAAG,SAAS,GAAG,YAAY,IAAI,CAAC,GAAG,cAAc,GAAG,OAAO;AAEzF,QAAM,SAAyB;AAAA,IAC7B,SAAS;AAAA,IACT,MAAMC,eAAAA,cAAc,SAAS,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,WAAA,EAAa,EAAE;AAAA,EAAA;AAG1E,SAAO;AAAA,IACL,UAAU,EAAE,GAAG,UAAU,QAAQ,QAAQ,QAAQ,KAAK,UAAU,MAAM,EAAA;AAAA,IACtE,YAAY,UAAU;AAAA,EAAA;AAE1B;;;;;;;;"}