@redocly/cli 2.62.2 → 2.64.0

package/lib/chunks/{XJE2OFDN.js → HAOBCQWB.js}

@@ -487,6 +487,7 @@ type PaginationSpec struct {
 	Param      string
 	NextCursor string
 	HasMore    string
+	NextLink   string
 	LimitParam string
 	Items      string
 }
@@ -577,7 +578,7 @@ func iterPages(call pageCall, spec PaginationSpec, base url.Values) func(yield f
 				}
 				cursor = next
 			}
-		case "link":
+		case "link", "body-link":
 			params := cloneValues(base)
 			previous := ""
 			for {
@@ -589,7 +590,18 @@ func iterPages(call pageCall, spec PaginationSpec, base url.Values) func(yield f
 				if !yield(page, nil) {
 					return
 				}
-				target := linkNext(resp.Header.Get("Link"))
+				var target string
+				if spec.Style == "link" {
+					target = linkNext(resp.Header.Get("Link"))
+				} else {
+					value := resolvePointer(page, spec.NextLink)
+					link, isString := value.(string)
+					if value != nil && !isString {
+						yield(nil, fmt.Errorf("pagination link at %s is not a string", spec.NextLink))
+						return
+					}
+					target = link
+				}
 				if target == "" {
 					return
 				}
@@ -614,9 +626,7 @@ func iterPages(call pageCall, spec PaginationSpec, base url.Values) func(yield f
 				previous = next
 				params = cloneValues(base)
 				for key, values := range targetURL.Query() {
-					for _, value := range values {
-						params.Add(key, value)
-					}
+					params[key] = values
 				}
 			}
 		default: // offset / page
@@ -1262,8 +1272,8 @@ function linkNext(?string $header): ?string
 
 /**
  * Auto-pagination: \`$call(array $params): [mixed rawPage, array $response]\`, \`$spec\` is the
- * normalized rule (\`style\`, \`param\`, \`nextCursor\`, \`hasMore\`, \`items\`), \`$base\` the caller's
- * query params. Yields raw decoded pages; generated wrappers hydrate them into models.
+ * normalized rule (\`style\`, \`param\`, \`nextCursor\`, \`hasMore\`, \`nextLink\`, \`items\`), \`$base\`
+ * the caller's query params. Yields raw decoded pages; generated wrappers hydrate them into models.
  */
 function iterPages(callable $call, array $spec, array $base): \\Generator
 {
@@ -1286,9 +1296,11 @@ function iterPages(callable $call, array $spec, array $base): \\Generator
             }
             $seenCursors[$next] = true;
             $params[$spec['param']] = $next;
-        } elseif ($style === 'link') {
-            $target = linkNext($response['headers']['link'] ?? null);
-            if ($target === null || isset($seenLinks[$target])) {
+        } elseif ($style === 'link' || $style === 'body-link') {
+            $target = $style === 'body-link'
+                ? resolvePointer($raw, $spec['nextLink'])
+                : linkNext($response['headers']['link'] ?? null);
+            if (!is_string($target) || $target === '' || isset($seenLinks[$target])) {
                 return;
             }
             $seenLinks[$target] = true;
@@ -1959,8 +1971,9 @@ async def send_async(
 `,"_paginate.py":`# Auto-pagination iterators for generated Python clients \u2014 the TypeScript
 # runtime's paginate.ts semantics ported: cursor (next-cursor pointer, optional
 # has-more flag, repeated-cursor guard), offset/page (advance by count/one,
-# repeated-page guard, null start treated as absent), and link (RFC 8288
-# \`Link: rel="next"\` following with relative resolution and a loop guard).
+# repeated-page guard, null start treated as absent), link (RFC 8288
+# \`Link: rel="next"\` following) and body-link (the next-link pointer's URL), both
+# with relative resolution and a loop guard.
 from __future__ import annotations
 
 import re
@@ -2015,8 +2028,8 @@ def iter_pages(call: PageCall, spec: Dict[str, Any], params: Optional[Dict[str,
             if nxt == cursor:
                 raise ValueError("Pagination did not advance: the operation returned the same cursor twice")
             cursor = nxt
-    elif style == "link":
-        yield from _iter_pages_by_link(call, base)
+    elif style in ("link", "body-link"):
+        yield from _iter_pages_by_link(call, spec, base)
     else:  # offset / page
         start = base.get(spec["param"])
         fallback = 1 if style == "page" else 0
@@ -2051,13 +2064,27 @@ def _link_next(header: Optional[str]) -> Optional[str]:
     return None
 
 
-def _iter_pages_by_link(call: PageCall, base: Dict[str, Any]) -> Iterator[Any]:
+def _next_link(spec: Dict[str, Any], page: Any, response: Any) -> Optional[str]:
+    """The next page's URL: the \`Link\` header's rel="next" target for \`link\`, the value at
+    the \`next_link\` pointer for \`body-link\`; None when absent, null, or empty."""
+    if spec["style"] == "link":
+        return _link_next(response.headers.get("link"))
+    pointer = spec["next_link"]
+    target = resolve_pointer(page, pointer)
+    if target is None or target == "":
+        return None
+    if not isinstance(target, str):
+        raise ValueError(f"Pagination link at {pointer} is not a string")
+    return target
+
+
+def _iter_pages_by_link(call: PageCall, spec: Dict[str, Any], base: Dict[str, Any]) -> Iterator[Any]:
     params = dict(base)
     previous = None
     while True:
         page, response = call(params)
         yield page
-        target = _link_next(response.headers.get("link"))
+        target = _next_link(spec, page, response)
         if target is None:
             return
         page_url = str(response.request.url) if response.request is not None else ""
@@ -2111,13 +2138,13 @@ async def aiter_pages(
             if nxt == cursor:
                 raise ValueError("Pagination did not advance: the operation returned the same cursor twice")
             cursor = nxt
-    elif style == "link":
+    elif style in ("link", "body-link"):
         previous = None
         link_params: Dict[str, Any] = dict(base)
         while True:
             page, response = await call(link_params)
             yield page
-            target = _link_next(response.headers.get("link"))
+            target = _next_link(spec, page, response)
             if target is None:
                 return
             page_url = str(response.request.url) if response.request is not None else ""
@@ -2365,4 +2392,316 @@ def multipart_arguments(body: Any) -> Dict[str, Any]:
         return {"content": body}
     data, files = to_multipart(body)
     return {"data": data, "files": files}
-`};export{e as a,t as b,n as c};
+`};var r=`import type { Middleware, SettledCall } from '../../../runtime-contract.js';
+
+const GENERATOR_VERSION: string = 'dev';
+const DEFAULT_ENDPOINT = 'https://otel.cloud.redocly.com/v1/traces';
+const EVENT_TYPE = 'com.redocly.sdkUsage.aggregated';
+const SEND_TIMEOUT_MS = 3000;
+const SERVICE_NAME = 'redocly-sdk';
+
+type StatusClass = '2xx' | '3xx' | '4xx' | '5xx' | 'network_error' | 'timeout' | 'aborted';
+type LatencyBucket = 'lt_100ms' | 'lt_300ms' | 'lt_1s' | 'lt_3s' | 'lt_10s' | 'gte_10s';
+
+const STATUS_CLASSES: StatusClass[] = [
+  '2xx',
+  '3xx',
+  '4xx',
+  '5xx',
+  'network_error',
+  'timeout',
+  'aborted',
+];
+const LATENCY_BUCKETS: Array<{ bucket: LatencyBucket; belowMs: number }> = [
+  { bucket: 'lt_100ms', belowMs: 100 },
+  { bucket: 'lt_300ms', belowMs: 300 },
+  { bucket: 'lt_1s', belowMs: 1000 },
+  { bucket: 'lt_3s', belowMs: 3000 },
+  { bucket: 'lt_10s', belowMs: 10000 },
+  { bucket: 'gte_10s', belowMs: Infinity },
+];
+
+export type SdkUsageEvent = {
+  id: string;
+  type: typeof EVENT_TYPE;
+  source: string;
+  time: string;
+  data: {
+    usage: Record<string, string | number>;
+    sdk: Record<string, string>;
+  };
+};
+
+export type TelemetryOptions = {
+  sdkName: string;
+  sdkVersion: string;
+  client: string;
+  sink?: (events: SdkUsageEvent[]) => void | Promise<void>;
+  endpoint?: string;
+  flushIntervalMs?: number;
+};
+
+type OperationCounts = {
+  calls: number;
+  attempts: number;
+  durationSumMs: number;
+  status: Record<StatusClass, number>;
+  latency: Record<LatencyBucket, number>;
+};
+
+type ProcessLike = {
+  env?: Record<string, string | undefined>;
+  versions?: { node?: string; bun?: string; deno?: string };
+  on?: (event: 'beforeExit', listener: () => void) => void;
+};
+
+const activeWindows = new Set<() => Promise<void>>();
+const pendingSends = new Set<Promise<void>>();
+let exitHookInstalled = false;
+
+function nodeProcess(): ProcessLike | undefined {
+  return (globalThis as { process?: ProcessLike }).process;
+}
+
+function telemetryDisabled(): boolean {
+  const runtimeProcess = nodeProcess();
+  if (runtimeProcess === undefined) return true;
+  // A browser bundle can add a \`process\` shim, so also check for \`document\`.
+  if (typeof document !== 'undefined') return true;
+  const env = runtimeProcess.env ?? {};
+  if (env.REDOCLY_SDK_TELEMETRY === 'off') return true;
+  if (env.DO_NOT_TRACK === '1') return true;
+  return false;
+}
+
+export async function flush(): Promise<void> {
+  for (const flushWindow of activeWindows) void flushWindow();
+  await Promise.all(pendingSends);
+}
+
+export function telemetry(options: TelemetryOptions): Middleware {
+  if (telemetryDisabled()) return {};
+  const intervalMs = options.flushIntervalMs ?? 60_000;
+  const endpoint = options.endpoint ?? DEFAULT_ENDPOINT;
+  const sink = options.sink ?? ((events: SdkUsageEvent[]) => sendOtlp(endpoint, events));
+  const versions = nodeProcess()?.versions ?? {};
+  let runtime = 'node';
+  let runtimeVersion = versions.node ?? '';
+  if (versions.bun !== undefined) {
+    runtime = 'bun';
+    runtimeVersion = versions.bun;
+  } else if (versions.deno !== undefined) {
+    runtime = 'deno';
+    runtimeVersion = versions.deno;
+  }
+  const sdk: Record<string, string> = {
+    name: options.sdkName,
+    version: options.sdkVersion,
+    generator_version: GENERATOR_VERSION,
+    language: 'typescript',
+    runtime,
+    runtime_version: runtimeVersion,
+    client: options.client,
+  };
+  let counts = new Map<string, OperationCounts>();
+  let windowStart = 0;
+  let timer: ReturnType<typeof setTimeout> | undefined;
+
+  async function flushWindow(): Promise<void> {
+    if (counts.size === 0) return;
+    if (timer !== undefined) clearTimeout(timer);
+    timer = undefined;
+    activeWindows.delete(flushWindow);
+    const events = toEvents(counts, windowStart, Date.now() - windowStart, options.sdkName, sdk);
+    counts = new Map();
+    if (telemetryDisabled()) return;
+    const send = Promise.resolve()
+      .then(() => sink(events))
+      .catch(() => undefined);
+    pendingSends.add(send);
+    await send;
+    pendingSends.delete(send);
+  }
+
+  installExitHook();
+
+  return {
+    onSettled: (ctx, call) => {
+      if (counts.size === 0) {
+        windowStart = Date.now();
+        timer = setTimeout(() => void flushWindow(), intervalMs);
+        unrefTimer(timer);
+        activeWindows.add(flushWindow);
+      }
+      let operation = counts.get(ctx.operation.id);
+      if (operation === undefined) {
+        operation = emptyCounts();
+        counts.set(ctx.operation.id, operation);
+      }
+      record(operation, call);
+    },
+  };
+}
+
+function installExitHook(): void {
+  if (exitHookInstalled) return;
+  exitHookInstalled = true;
+  nodeProcess()?.on?.('beforeExit', () => void flush());
+}
+
+function unrefTimer(timer: unknown): void {
+  if (timer instanceof Object && 'unref' in timer && typeof timer.unref === 'function') {
+    timer.unref();
+  }
+}
+
+function emptyCounts(): OperationCounts {
+  return {
+    calls: 0,
+    attempts: 0,
+    durationSumMs: 0,
+    status: { '2xx': 0, '3xx': 0, '4xx': 0, '5xx': 0, network_error: 0, timeout: 0, aborted: 0 },
+    latency: { lt_100ms: 0, lt_300ms: 0, lt_1s: 0, lt_3s: 0, lt_10s: 0, gte_10s: 0 },
+  };
+}
+
+function record(operation: OperationCounts, call: SettledCall): void {
+  operation.calls += 1;
+  operation.attempts += call.attempts;
+  operation.durationSumMs += call.durationMs;
+  operation.status[statusClass(call)] += 1;
+  for (const { bucket, belowMs } of LATENCY_BUCKETS) {
+    if (call.durationMs < belowMs) {
+      operation.latency[bucket] += 1;
+      break;
+    }
+  }
+}
+
+function statusClass(call: SettledCall): StatusClass {
+  if (call.response === undefined) {
+    if (call.error instanceof Error && call.error.name === 'TimeoutError') return 'timeout';
+    if (call.error instanceof Error && call.error.name === 'AbortError') return 'aborted';
+    return 'network_error';
+  }
+  const status = call.response.status;
+  if (status >= 500) return '5xx';
+  if (status >= 400) return '4xx';
+  if (status >= 300) return '3xx';
+  return '2xx';
+}
+
+function toEvents(
+  counts: Map<string, OperationCounts>,
+  windowStart: number,
+  windowMs: number,
+  source: string,
+  sdk: Record<string, string>
+): SdkUsageEvent[] {
+  const events: SdkUsageEvent[] = [];
+  for (const [operationId, operation] of counts) {
+    const usage: Record<string, string | number> = {
+      operation_id: operationId,
+      window_ms: windowMs,
+      calls: operation.calls,
+      attempts: operation.attempts,
+      duration_sum_ms: operation.durationSumMs,
+    };
+    for (const statusClass of STATUS_CLASSES) {
+      const count = operation.status[statusClass];
+      if (count > 0) {
+        usage[\`status_\${statusClass}\`] = count;
+      }
+    }
+    for (const { bucket } of LATENCY_BUCKETS) {
+      const count = operation.latency[bucket];
+      if (count > 0) {
+        usage[\`latency_\${bucket}\`] = count;
+      }
+    }
+    events.push({
+      id: \`evt_\${randomHex(16)}\`,
+      type: EVENT_TYPE,
+      source,
+      time: new Date(windowStart).toISOString(),
+      data: { usage, sdk },
+    });
+  }
+  return events;
+}
+
+async function sendOtlp(endpoint: string, events: SdkUsageEvent[]): Promise<void> {
+  const response = await fetch(endpoint, {
+    method: 'POST',
+    // One send per window, so the socket is never reused: close it instead of keeping it idle.
+    headers: { 'Content-Type': 'application/json', Connection: 'close' },
+    body: JSON.stringify(toOtlpRequest(events)),
+    signal: AbortSignal.timeout(SEND_TIMEOUT_MS),
+  });
+  await response.body?.cancel();
+}
+
+type OtlpValue = { stringValue: string } | { intValue: number } | { doubleValue: number };
+type OtlpAttribute = { key: string; value: OtlpValue };
+
+function toOtlpRequest(events: SdkUsageEvent[]) {
+  const spans = [];
+  for (const event of events) {
+    const timeUnixNano = \`\${Date.parse(event.time)}000000\`;
+    const attributes: OtlpAttribute[] = [
+      attribute('cloudevents.event_id', event.id),
+      attribute('cloudevents.event_type', event.type),
+      attribute('cloudevents.event_source', event.source),
+      attribute('cloudevents.event_spec_version', '1.0'),
+      attribute('cloudevents.event_data_content_type', 'application/json; charset=utf-8'),
+      attribute('cloudevents.event_time', event.time),
+      attribute('cloudevents.event_subject', ''),
+      attribute('cloudevents.event_origin', SERVICE_NAME),
+      attribute('cloudevents.event_object', 'event'),
+      attribute('cloudevents.event_category', 'product'),
+      attribute('cloudevents.event_signal', 'metric'),
+    ];
+    for (const [key, value] of Object.entries(event.data.usage)) {
+      attributes.push(attribute(\`cloudevents.event_data.usage.\${key}\`, value));
+    }
+    for (const [key, value] of Object.entries(event.data.sdk)) {
+      attributes.push(attribute(\`cloudevents.event_data.sdk.\${key}\`, value));
+    }
+    spans.push({
+      traceId: randomHex(16),
+      spanId: randomHex(8),
+      name: \`event.\${event.type}\`,
+      kind: 1,
+      startTimeUnixNano: timeUnixNano,
+      endTimeUnixNano: timeUnixNano,
+      attributes,
+    });
+  }
+  return {
+    resourceSpans: [
+      {
+        resource: {
+          attributes: [
+            attribute('service.name', SERVICE_NAME),
+            attribute('service.version', GENERATOR_VERSION),
+          ],
+        },
+        scopeSpans: [{ scope: { name: 'redocly-sdk-telemetry' }, spans }],
+      },
+    ],
+  };
+}
+
+function attribute(key: string, value: string | number): OtlpAttribute {
+  if (typeof value === 'string') return { key, value: { stringValue: value } };
+  if (Number.isInteger(value)) return { key, value: { intValue: value } };
+  return { key, value: { doubleValue: value } };
+}
+
+function randomHex(byteCount: number): string {
+  const bytes = crypto.getRandomValues(new Uint8Array(byteCount));
+  let hex = '';
+  for (const byte of bytes) hex += byte.toString(16).padStart(2, '0');
+  return hex;
+}
+`;export{e as a,t as b,n as c,r as d};

package/lib/chunks/{IUSSBOYO.js → HIII45WJ.js}

@@ -4,7 +4,7 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{h as g}from"./3JYQOGV3.js";import{f as C,m as u,n as p}from"./RU7T4CKG.js";import{c as j,d as v}from"./FDGP3ZYZ.js";import{ia as b}from"./22EANOP2.js";import{a as S,b as k}from"./UW4UC7ZI.js";import{join as $}from"node:path";function h(r){return(r??"").replace(/\s+/g," ").trim().replace(/\\/g,"\\\\").replace(/\|/g,"\\|")}function w(r){return[r.group===void 0?void 0:u(r.group),r.name].filter(Boolean).join(" ")}function T(r,e){return[r,w(e),...e.positionals.map(o=>`<${o.name}>`),...e.flags.filter(o=>o.required).map(o=>`--${o.name} <${o.type}>`),...e.body?[e.body.required?"--json '<json>'":"[--json '<json>']"]:[]].filter(o=>o!=="").join(" ")}function B(r,e){r.line("| Flag | Type | Required | Description |"),r.line("| ---- | ---- | -------- | ----------- |");for(let n of e){let o=[h(n.description),n.enum===void 0?"":`One of ${n.enum.map(t=>`\`${t}\``).join(", ")}.`,n.type==="array"?"Repeat the flag for multiple values.":""].filter(t=>t!=="").join(" ");r.line(`| \`--${n.name}\` | ${n.type} | ${n.required?"yes":"no"} | ${o} |`)}r.blank()}function D(r,e,n){if(r.line(`### \`${w(e)}\``),r.blank(),e.summary!==void 0&&(r.line(h(e.summary)),r.blank()),r.line(`\`${e.method} ${e.path}\``),r.blank(),r.line("```sh"),r.line(T(n.name,e)),r.line("```"),r.blank(),e.positionals.length>0){r.line("| Argument | Description |"),r.line("| -------- | ----------- |");for(let t of e.positionals)r.line(`| \`<${t.name}>\` | ${h(t.description)} |`);r.blank()}e.flags.length>0&&B(r,e.flags);let o=[e.body===void 0?"":`Takes a JSON body${e.body.required?" (required)":""}: \`--json '<json>'\`, \`--json @file.json\`, or \`--json @-\` for stdin.`,e.unsupportedBody===void 0?"":`Takes a \`${e.unsupportedBody}\` body, which the CLI cannot build \u2014 call this operation through the generated client instead.`,e.paginated===!0?"Paginated: `--page-all` follows every page, printing one JSON page per line.":"",e.sse===!0?"Streams server-sent events as one JSON object per line.":"",e.blob===!0?"Returns binary content, so `--output <path>` is required.":""].filter(t=>t!=="");for(let t of o)r.line(t);o.length>0&&r.blank()}function R(r,e){let n=new S;e.frontmatter&&(n.line("---"),n.line(`title: ${e.title}`),n.line("---"),n.blank()),n.line(`# ${e.title}`),n.blank(),n.line(`Generated command-line reference for \`${e.name}\`, produced from the API description by \`redocly generate-client\`.`),n.line("Re-run generation to update it \u2014 this file is not hand-edited."),n.blank(),n.line("## Usage"),n.blank(),n.line("```sh"),n.line(`${e.name} <command> [flags]`),n.line(`${e.name} --help`),n.line(`${e.name} schema <command>   # request/response schemas`),n.line("```"),n.blank(),n.line("Install the file under any `bin` name: the command takes that name, and the credential variables below do not change."),n.blank(),n.line("## Global flags"),n.blank(),n.line("| Flag | Description |"),n.line("| ---- | ----------- |");let o=e.schemes.some(i=>i.kind==="bearer");for(let[i,s]of[["--server-url <url>","Override the server URL included in the client."],["--format <json\\|ndjson>","Output format."],["--dry-run","Print the prepared request, credentials redacted, without sending it."],["--page-all","Follow pagination, printing one JSON page per line."],["--output <path>","Write the response body to a file. Required for binary responses."],...o?[["--token <token>","Bearer token, overriding the environment."]]:[],["--json <json\\|@file\\|@->","Request body, inline or from a file or stdin."]])n.line(`| \`${i}\` | ${s} |`);n.blank();let t=p(e.name);if(n.line("## Credentials"),n.blank(),e.schemes.length===0)n.line("The description declares no security schemes, so no credentials are read.");else{n.line("Credentials come from the environment:"),n.blank(),n.line("| Scheme | Variable |"),n.line("| ------ | -------- |");for(let i of e.schemes){let s=i.kind==="bearer"?`\`${t}_TOKEN\` (or \`--token\`)`:i.kind==="basic"?`\`${t}_USERNAME\` and \`${t}_PASSWORD\``:`\`${t}_API_KEY_${p(i.key)}\``;n.line(`| ${i.kind} (\`${i.key}\`) | ${s} |`)}}n.blank(),n.line("## Exit codes"),n.blank(),n.line("| Code | Meaning |"),n.line("| ---- | ------- |");for(let[i,s]of[[0,"success"],[1,"API error (status other than 401 or 403)"],[2,"auth error (401 or 403)"],[3,"validation error"],[4,"usage error (unknown command or flag, bad `--json`)"]])n.line(`| ${i} | ${s} |`);n.blank(),n.line("Errors print one JSON object to stderr, so stdout stays clean for piping."),n.blank();let a=[...new Set(r.map(i=>i.group))];for(let i of a){let s=r.filter(l=>l.group===i);i===void 0?(n.line("## Commands"),n.blank()):(n.line(`## ${i}`),n.blank(),n.line(`Addressed as \`${e.name} ${u(i)} <command>\`.`),n.blank());for(let l of s)D(n,l,e)}return n.toString().replace(/\n{3,}/g,`
+import{h as g}from"./CEASD5U3.js";import{f as C,m as u,n as p}from"./JQJ5TDVP.js";import{c as j,d as v}from"./UNOXQ62I.js";import{ia as b}from"./EQTXHL74.js";import{a as S,b as k}from"./UW4UC7ZI.js";import{join as $}from"node:path";function h(r){return(r??"").replace(/\s+/g," ").trim().replace(/\\/g,"\\\\").replace(/\|/g,"\\|")}function w(r){return[r.group===void 0?void 0:u(r.group),r.name].filter(Boolean).join(" ")}function T(r,e){return[r,w(e),...e.positionals.map(o=>`<${o.name}>`),...e.flags.filter(o=>o.required).map(o=>`--${o.name} <${o.type}>`),...e.body?[e.body.required?"--json '<json>'":"[--json '<json>']"]:[]].filter(o=>o!=="").join(" ")}function B(r,e){r.line("| Flag | Type | Required | Description |"),r.line("| ---- | ---- | -------- | ----------- |");for(let n of e){let o=[h(n.description),n.enum===void 0?"":`One of ${n.enum.map(t=>`\`${t}\``).join(", ")}.`,n.type==="array"?"Repeat the flag for multiple values.":""].filter(t=>t!=="").join(" ");r.line(`| \`--${n.name}\` | ${n.type} | ${n.required?"yes":"no"} | ${o} |`)}r.blank()}function D(r,e,n){if(r.line(`### \`${w(e)}\``),r.blank(),e.summary!==void 0&&(r.line(h(e.summary)),r.blank()),r.line(`\`${e.method} ${e.path}\``),r.blank(),r.line("```sh"),r.line(T(n.name,e)),r.line("```"),r.blank(),e.positionals.length>0){r.line("| Argument | Description |"),r.line("| -------- | ----------- |");for(let t of e.positionals)r.line(`| \`<${t.name}>\` | ${h(t.description)} |`);r.blank()}e.flags.length>0&&B(r,e.flags);let o=[e.body===void 0?"":`Takes a JSON body${e.body.required?" (required)":""}: \`--json '<json>'\`, \`--json @file.json\`, or \`--json @-\` for stdin.`,e.unsupportedBody===void 0?"":`Takes a \`${e.unsupportedBody}\` body, which the CLI cannot build \u2014 call this operation through the generated client instead.`,e.paginated===!0?"Paginated: `--page-all` follows every page, printing one JSON page per line.":"",e.sse===!0?"Streams server-sent events as one JSON object per line.":"",e.blob===!0?"Returns binary content, so `--output <path>` is required.":""].filter(t=>t!=="");for(let t of o)r.line(t);o.length>0&&r.blank()}function R(r,e){let n=new S;e.frontmatter&&(n.line("---"),n.line(`title: ${e.title}`),n.line("---"),n.blank()),n.line(`# ${e.title}`),n.blank(),n.line(`Generated command-line reference for \`${e.name}\`, produced from the API description by \`redocly generate-client\`.`),n.line("Re-run generation to update it \u2014 this file is not hand-edited."),n.blank(),n.line("## Usage"),n.blank(),n.line("```sh"),n.line(`${e.name} <command> [flags]`),n.line(`${e.name} --help`),n.line(`${e.name} schema <command>   # request/response schemas`),n.line("```"),n.blank(),n.line("Install the file under any `bin` name: the command takes that name, and the credential variables below do not change."),n.blank(),n.line("## Global flags"),n.blank(),n.line("| Flag | Description |"),n.line("| ---- | ----------- |");let o=e.schemes.some(i=>i.kind==="bearer");for(let[i,s]of[["--server-url <url>","Override the server URL included in the client."],["--format <json\\|ndjson>","Output format."],["--dry-run","Print the prepared request, credentials redacted, without sending it."],["--page-all","Follow pagination, printing one JSON page per line."],["--output <path>","Write the response body to a file. Required for binary responses."],...o?[["--token <token>","Bearer token, overriding the environment."]]:[],["--json <json\\|@file\\|@->","Request body, inline or from a file or stdin."]])n.line(`| \`${i}\` | ${s} |`);n.blank();let t=p(e.name);if(n.line("## Credentials"),n.blank(),e.schemes.length===0)n.line("The description declares no security schemes, so no credentials are read.");else{n.line("Credentials come from the environment:"),n.blank(),n.line("| Scheme | Variable |"),n.line("| ------ | -------- |");for(let i of e.schemes){let s=i.kind==="bearer"?`\`${t}_TOKEN\` (or \`--token\`)`:i.kind==="basic"?`\`${t}_USERNAME\` and \`${t}_PASSWORD\``:`\`${t}_API_KEY_${p(i.key)}\``;n.line(`| ${i.kind} (\`${i.key}\`) | ${s} |`)}}n.blank(),n.line("## Exit codes"),n.blank(),n.line("| Code | Meaning |"),n.line("| ---- | ------- |");for(let[i,s]of[[0,"success"],[1,"API error (status other than 401 or 403)"],[2,"auth error (401 or 403)"],[3,"validation error"],[4,"usage error (unknown command or flag, bad `--json`)"]])n.line(`| ${i} | ${s} |`);n.blank(),n.line("Errors print one JSON object to stderr, so stdout stays clean for piping."),n.blank();let a=[...new Set(r.map(i=>i.group))];for(let i of a){let s=r.filter(l=>l.group===i);i===void 0?(n.line("## Commands"),n.blank()):(n.line(`## ${i}`),n.blank(),n.line(`Addressed as \`${e.name} ${u(i)} <command>\`.`),n.blank());for(let l of s)D(n,l,e)}return n.toString().replace(/\n{3,}/g,`
 
 `).trimEnd()+`
 `}function x(){return v["cli.ts"]}function E(){return j["cli.ts"]}var q="// Generated by @redocly/client-generator \u2014 do not edit by hand.\n// Source: OpenAPI description. Re-run `redocly generate-client` to update.";function P(r){return k.snake(r).replace(/_/g,"-")}function O(r){let e=r.schema,n=e.kind==="array"?"array":e.kind==="scalar"&&(e.scalar==="integer"||e.scalar==="number")?"number":e.kind==="scalar"&&e.scalar==="boolean"?"boolean":"string";return{name:P(r.name),param:r.name,type:n,required:r.required,...e.kind==="enum"?{enum:e.values.map(String)}:{},...r.description!==void 0?{description:r.description}:{}}}function F(r){let e=r.successResponses;return e.some(n=>n.contentType.toLowerCase().includes("json"))?!1:e.some(n=>C(n.contentType))}function M(r){return r.successResponses.find(e=>e.contentType.toLowerCase().includes("json"))?.schema}function U(r,e,n){if(n!=="flat")return{};let o=g(r,e.schemas);return"mergeBody"in o&&o.mergeBody?{merged:!0}:{}}function _(r,e,n){return n!=="flat"?{}:"collisions"in g(r,e.schemas)?{argsStyle:"grouped"}:{}}function f(r,e){let n=[];for(let o of r.services)for(let t of o.operations){let a=t.requestBody?.contentType.toLowerCase().includes("json")?t.requestBody:void 0,i=M(t);n.push({...t.tags.length>0?{group:t.tags[0]}:{},name:t.name,...t.summary!==void 0?{summary:t.summary}:{},method:t.method.toUpperCase(),path:t.path,positionals:t.pathParams.map(s=>({name:s.name,type:O(s).type,...s.description!==void 0?{description:s.description}:{}})),flags:t.queryParams.map(O),...a?{body:{required:a.required,...U(t,r,e.argsStyle)}}:{},...a===void 0&&t.requestBody!==void 0?{unsupportedBody:t.requestBody.contentType}:{},...e.pagination?.has(t.name)===!0?{paginated:!0}:{},..._(t,r,e.argsStyle),...t.sse!==void 0?{sse:!0}:{},...F(t)?{blob:!0}:{},...a!==void 0||i!==void 0?{schemas:{...a?{request:a.schema}:{},...i!==void 0?{response:i}:{}}}:{}})}return n}var A=`function isProcessEntry(): boolean {