@redocly/cli 2.62.1 → 2.63.0

package/lib/chunks/{5YW5LAGV.js → 7RQW6KPZ.js}

@@ -4,9 +4,9 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{c as x,ia as R}from"./22EANOP2.js";import{m}from"./UW4UC7ZI.js";function C(e){return e.flatMap(n=>n.operations)}function P(e,n,s){let r=e.specName??e.name;if(s?.exclude?.includes(r))return{};let a=s?.operations?.[r];if(a!==void 0)return y(e,n,a,`pagination.operations["${r}"]`,!0);if(e.paginationExtension!==void 0)return y(e,n,e.paginationExtension,"x-redoclyPagination",!0);if(s?.style!==void 0){let{exclude:o,operations:c,...t}=s;return y(e,n,t,"pagination convention",!1)}return{}}function H(e,n){let s=new Map,r=[];for(let a of C(e.services)){let o=P(a,e,n);o.error!==void 0?r.push(o.error):o.spec!==void 0&&s.set(a.name,{spec:o.spec,itemSchema:o.itemSchema})}if(r.length>0)throw new Error(["Invalid pagination configuration:",...r].join(`
-  - `));return s}function y(e,n,s,r,a){let o=`Pagination for operation "${e.name}" (${r})`,c=q(s);if(c!==void 0)return{error:`${o}: ${c}`};let t=s,d=i=>a?{error:`${o}: ${i}`}:{};if(e.sse!==void 0)return d("the operation is a Server-Sent Events stream");if(t.style!=="link"){let i=t.style==="cursor"?"cursorParam":"offsetParam",l=t.style==="cursor"?t.cursorParam:t.offsetParam,k=e.queryParams.find(u=>u.name===l);if(!k){let u=e.queryParams.map(E=>E.name).join(", ");return d(`query parameter "${l}" is not declared on the operation`+(u===""?"":` (declared: ${u})`))}let p=O(k.schema,n);if(!(p!==void 0&&(t.style==="cursor"?b(p,n):p.kind==="scalar"&&(p.scalar==="number"||p.scalar==="integer")))){let u=t.style==="cursor"?"a string":"a number";return d(`the "${i}" query parameter "${l}" must accept ${u} (got ${I(p)})`)}}let g=e.successResponses.find(i=>i.contentType.toLowerCase().includes("json"));if(!g)return d("the operation has no JSON success response");if(t.style==="link"){let i=e.successResponseHeaders?.some(l=>l.name==="link")===!0;if(!i&&!a)return{};i||R.warn(`generate-client: ${o.toLowerCase()} follows the Link header, but the success response does not document one.
-`)}let h=m(g.schema,t.items,n);if(h===void 0)return d(`the "items" pointer "${t.items}" does not resolve in the success response schema`);if(h.kind!=="array")return d(`the "items" pointer "${t.items}" must point at an array (got ${h.kind})`);if(t.style==="cursor"){let i=m(g.schema,t.nextCursor,n);if(i===void 0)return d(`the "nextCursor" pointer "${t.nextCursor}" does not resolve in the success response schema`);if(!b(i,n))return d(`the "nextCursor" pointer "${t.nextCursor}" must point at a string (got ${i.kind})`);if(t.hasMore!==void 0){let l=m(g.schema,t.hasMore,n);if(l===void 0)return d(`the "hasMore" pointer "${t.hasMore}" does not resolve in the success response schema`);if(l.kind!=="scalar"||l.scalar!=="boolean")return d(`the "hasMore" pointer "${t.hasMore}" must point at a boolean (got ${l.kind})`)}}let f=t.limitParam!==void 0?{limitParam:t.limitParam}:{};return{spec:t.style==="cursor"?{style:"cursor",param:t.cursorParam,...f,nextCursor:t.nextCursor,...t.hasMore!==void 0?{hasMore:t.hasMore}:{},items:t.items}:t.style==="link"?{style:"link",...f,items:t.items}:{style:t.style,param:t.offsetParam,...f,items:t.items},itemSchema:h.items}}function q(e){if(!x(e))return"the rule must be an object";let{style:n,cursorParam:s,nextCursor:r,hasMore:a,offsetParam:o,limitParam:c,items:t}=e;if(n!=="cursor"&&n!=="offset"&&n!=="page"&&n!=="link")return`"style" must be one of "cursor" | "offset" | "page" | "link" (got ${JSON.stringify(n)})`;if(typeof t!="string"||t!==""&&!t.startsWith("/"))return'"items" must be a JSON pointer starting with "/" (or "" when the response body is the item array itself)';if(n==="cursor"){if(typeof s!="string"||s==="")return'cursor style requires a "cursorParam" query parameter name';if(typeof r!="string"||!r.startsWith("/"))return'cursor style requires a "nextCursor" JSON pointer starting with "/"';if(a!==void 0&&(typeof a!="string"||!a.startsWith("/")))return'"hasMore" must be a JSON pointer starting with "/"'}else if((n==="offset"||n==="page")&&(typeof o!="string"||o===""))return`${n} style requires an "offsetParam" query parameter name`;if(c!==void 0&&typeof c!="string")return'"limitParam" must be a query parameter name'}function I(e){return e===void 0?"an unresolvable ref":e.kind==="scalar"||e.kind==="enum"?e.scalar:e.kind}function O(e,n){let s=new Set,r=e;for(;r.kind==="ref";){let{name:a}=r;if(s.has(a))return;s.add(a);let o=n.schemas.find(c=>c.name===a);if(o===void 0)return;r=o.schema}return r}function b(e,n){return e.kind==="scalar"||e.kind==="enum"?e.scalar==="string":e.kind==="literal"?typeof e.value=="string":e.kind==="union"?e.members.every(s=>{let r=O(s,n);return r!==void 0&&(r.kind==="null"||r.kind!=="union"&&b(r,n))}):!1}var G={"types.ts":`/**
+import{c as x,ia as R}from"./ACMV5RZA.js";import{m}from"./UW4UC7ZI.js";function C(e){return e.flatMap(n=>n.operations)}function P(e,n,o){let r=e.specName??e.name;if(o?.exclude?.includes(r))return{};let a=o?.operations?.[r];if(a!==void 0)return b(e,n,a,`pagination.operations["${r}"]`,!0);if(e.paginationExtension!==void 0)return b(e,n,e.paginationExtension,"x-redoclyPagination",!0);if(o?.style!==void 0){let{exclude:s,operations:c,...t}=o;return b(e,n,t,"pagination convention",!1)}return{}}function H(e,n){let o=new Map,r=[];for(let a of C(e.services)){let s=P(a,e,n);s.error!==void 0?r.push(s.error):s.spec!==void 0&&o.set(a.name,{spec:s.spec,itemSchema:s.itemSchema})}if(r.length>0)throw new Error(["Invalid pagination configuration:",...r].join(`
+  - `));return o}function b(e,n,o,r,a){let s=`Pagination for operation "${e.name}" (${r})`,c=q(o);if(c!==void 0)return{error:`${s}: ${c}`};let t=o,i=d=>a?{error:`${s}: ${d}`}:{};if(e.sse!==void 0)return i("the operation is a Server-Sent Events stream");if(t.style!=="link"&&t.style!=="body-link"){let d=t.style==="cursor"?"cursorParam":"offsetParam",l=t.style==="cursor"?t.cursorParam:t.offsetParam,k=e.queryParams.find(u=>u.name===l);if(!k){let u=e.queryParams.map(E=>E.name).join(", ");return i(`query parameter "${l}" is not declared on the operation`+(u===""?"":` (declared: ${u})`))}let p=O(k.schema,n);if(!(p!==void 0&&(t.style==="cursor"?y(p,n):p.kind==="scalar"&&(p.scalar==="number"||p.scalar==="integer")))){let u=t.style==="cursor"?"a string":"a number";return i(`the "${d}" query parameter "${l}" must accept ${u} (got ${I(p)})`)}}let g=e.successResponses.find(d=>d.contentType.toLowerCase().includes("json"));if(!g)return i("the operation has no JSON success response");if(t.style==="link"){let d=e.successResponseHeaders?.some(l=>l.name==="link")===!0;if(!d&&!a)return{};d||R.warn(`generate-client: ${s.toLowerCase()} follows the Link header, but the success response does not document one.
+`)}let h=m(g.schema,t.items,n);if(h===void 0)return i(`the "items" pointer "${t.items}" does not resolve in the success response schema`);if(h.kind!=="array")return i(`the "items" pointer "${t.items}" must point at an array (got ${h.kind})`);if(t.style==="body-link"){let d=m(g.schema,t.nextLink,n);if(d===void 0)return i(`the "nextLink" pointer "${t.nextLink}" does not resolve in the success response schema`);if(!y(d,n))return i(`the "nextLink" pointer "${t.nextLink}" must point at a string (got ${d.kind})`)}if(t.style==="cursor"){let d=m(g.schema,t.nextCursor,n);if(d===void 0)return i(`the "nextCursor" pointer "${t.nextCursor}" does not resolve in the success response schema`);if(!y(d,n))return i(`the "nextCursor" pointer "${t.nextCursor}" must point at a string (got ${d.kind})`);if(t.hasMore!==void 0){let l=m(g.schema,t.hasMore,n);if(l===void 0)return i(`the "hasMore" pointer "${t.hasMore}" does not resolve in the success response schema`);if(l.kind!=="scalar"||l.scalar!=="boolean")return i(`the "hasMore" pointer "${t.hasMore}" must point at a boolean (got ${l.kind})`)}}let f=t.limitParam!==void 0?{limitParam:t.limitParam}:{};return{spec:t.style==="cursor"?{style:"cursor",param:t.cursorParam,...f,nextCursor:t.nextCursor,...t.hasMore!==void 0?{hasMore:t.hasMore}:{},items:t.items}:t.style==="link"?{style:"link",...f,items:t.items}:t.style==="body-link"?{style:"body-link",...f,nextLink:t.nextLink,items:t.items}:{style:t.style,param:t.offsetParam,...f,items:t.items},itemSchema:h.items}}function q(e){if(!x(e))return"the rule must be an object";let{style:n,cursorParam:o,nextCursor:r,hasMore:a,offsetParam:s,nextLink:c,limitParam:t,items:i}=e;if(n!=="cursor"&&n!=="offset"&&n!=="page"&&n!=="link"&&n!=="body-link")return`"style" must be one of "cursor" | "offset" | "page" | "link" | "body-link" (got ${JSON.stringify(n)})`;if(typeof i!="string"||i!==""&&!i.startsWith("/"))return'"items" must be a JSON pointer starting with "/" (or "" when the response body is the item array itself)';if(n==="cursor"){if(typeof o!="string"||o==="")return'cursor style requires a "cursorParam" query parameter name';if(typeof r!="string"||!r.startsWith("/"))return'cursor style requires a "nextCursor" JSON pointer starting with "/"';if(a!==void 0&&(typeof a!="string"||!a.startsWith("/")))return'"hasMore" must be a JSON pointer starting with "/"'}else if(n==="offset"||n==="page"){if(typeof s!="string"||s==="")return`${n} style requires an "offsetParam" query parameter name`}else if(n==="body-link"&&(typeof c!="string"||!c.startsWith("/")))return'body-link style requires a "nextLink" JSON pointer starting with "/"';if(t!==void 0&&typeof t!="string")return'"limitParam" must be a query parameter name'}function I(e){return e===void 0?"an unresolvable ref":e.kind==="scalar"||e.kind==="enum"?e.scalar:e.kind}function O(e,n){let o=new Set,r=e;for(;r.kind==="ref";){let{name:a}=r;if(o.has(a))return;o.add(a);let s=n.schemas.find(c=>c.name===a);if(s===void 0)return;r=s.schema}return r}function y(e,n){return e.kind==="scalar"||e.kind==="enum"?e.scalar==="string":e.kind==="literal"?typeof e.value=="string":e.kind==="union"?e.members.every(o=>{let r=O(o,n);return r!==void 0&&(r.kind==="null"||r.kind!=="union"&&y(r,n))}):!1}var G={"types.ts":`/**
  * The public type surface of the client runtime \u2014 \`@redocly/client-generator\`'s
  * app-facing runtime module. Pure types, no runtime code (excluded from coverage).
  * The generator emits \`OPERATIONS\` literals typed
@@ -30,7 +30,7 @@ export type SecuritySpec =
 
 /**
  * How to auto-iterate a paginated operation (drives its \`.pages()\`/\`.items()\` members).
- * \`nextCursor\` and \`items\` are RFC 6901 JSON pointers into the page (response) value.
+ * \`nextCursor\`, \`nextLink\`, and \`items\` are RFC 6901 JSON pointers into the page (response) value.
  */
 export type PaginationSpec =
   | {
@@ -62,6 +62,16 @@ export type PaginationSpec =
       limitParam?: string;
       /** Pointer to the page's item array. */
       items: string;
+    }
+  | {
+      /** Follow the next page's URL at \`nextLink\` in the page; stop when it is absent. */
+      style: 'body-link';
+      /** Optional page-size query param (recorded for tooling; never set by the runtime). */
+      limitParam?: string;
+      /** Pointer to the next page's URL in the page. */
+      nextLink: string;
+      /** Pointer to the page's item array. */
+      items: string;
     };
 
 /** The frozen data contract between generated code and the runtime: one operation's wire shape. */
@@ -813,6 +823,42 @@ export function middlewareChain(config: ClientConfig): Middleware[] {
   return [...single, ...(config.middleware ?? [])];
 }
 
+/**
+ * \`AbortSignal.timeout()\` where the platform has it, else an \`AbortController\` armed by
+ * \`setTimeout\`: Chrome before 103, Safari before 16, and Firefox before 100 lack the
+ * static, and every request with a timeout would throw before \`fetch\` runs.
+ */
+function timeoutSignal(ms: number): AbortSignal {
+  if (typeof AbortSignal.timeout === 'function') return AbortSignal.timeout(ms);
+  const controller = new AbortController();
+  setTimeout(() => {
+    controller.abort(new DOMException(\`Timed out after \${ms} ms\`, 'TimeoutError'));
+  }, ms);
+  return controller.signal;
+}
+
+/**
+ * \`AbortSignal.any()\` where the platform has it, else a controller that follows whichever
+ * signal aborts first: Chrome before 116, Safari before 17.4, and Firefox before 124 lack
+ * the static. The listeners come off once one signal fires, so a caller's long-lived
+ * signal does not keep one per request.
+ */
+function anySignal(signals: AbortSignal[]): AbortSignal {
+  if (typeof AbortSignal.any === 'function') return AbortSignal.any(signals);
+  const controller = new AbortController();
+  const listeners = new Map<AbortSignal, () => void>();
+  const abort = (reason: unknown) => {
+    for (const [signal, listener] of listeners) signal.removeEventListener('abort', listener);
+    controller.abort(reason);
+  };
+  for (const signal of signals) {
+    const listener = () => abort(signal.reason);
+    listeners.set(signal, listener);
+    signal.addEventListener('abort', listener);
+  }
+  return controller.signal;
+}
+
 /**
  * The fetch core shared by every operation: default + config + per-call headers, the
  * \`onRequest\` chain (BEFORE body serialization, so mutations are sent), body
@@ -933,11 +979,8 @@ export async function send(
     if (signal?.aborted) throw abortError(signal);
     // A fresh timeout budget per attempt; the caller's signal still wins the race.
     // The composed signal also governs reading the response body.
-    const attemptSignal = timeout
-      ? signal
-        ? AbortSignal.any([signal, AbortSignal.timeout(timeout)])
-        : AbortSignal.timeout(timeout)
-      : signal;
+    const budget = timeout ? timeoutSignal(timeout) : undefined;
+    const attemptSignal = budget && signal ? anySignal([signal, budget]) : (budget ?? signal);
     let response: Response;
     try {
       response = await doFetch(context.url, {
@@ -950,6 +993,10 @@ export async function send(
         body: payload,
       });
     } catch (error) {
+      // Decided before any await, when no timer can have fired since \`fetch\` rejected: an
+      // aborted budget means this attempt timed out. The abort reason's name is no
+      // evidence, because Chrome 103 to 123 abort a timeout with \`AbortError\`.
+      const timedOut = timeout !== undefined && budget?.aborted && !signal?.aborted;
       if (
         attempt < maxAttempts &&
         !signal?.aborted &&
@@ -960,14 +1007,7 @@ export async function send(
       }
       // Our timeout fired (never the caller's own abort \u2014 that rethrows untouched):
       // wrap the bare DOMException with the context a log line needs.
-      if (
-        timeout &&
-        !signal?.aborted &&
-        error instanceof DOMException &&
-        error.name === 'TimeoutError'
-      ) {
-        throw new TimeoutError(op.id, timeout, attempt);
-      }
+      if (timedOut) throw new TimeoutError(op.id, timeout, attempt);
       throw error;
     }
     // Reverse order: the last-registered middleware wraps closest to the network (onion).
@@ -1228,6 +1268,7 @@ export type Capabilities = SendCapabilities & {
         args?: OperationArgs,
         init?: RequestOptions
       ) => Promise<{ page: unknown; linkHeader: string | null; url: string }>,
+      spec: PaginationSpec,
       args?: OperationArgs,
       init?: RequestOptions
     ) => AsyncGenerator<unknown>;
@@ -1675,11 +1716,12 @@ export function createClientCore<
       client[name] =
         spec === undefined
           ? method
-          : spec.style === 'link'
+          : spec.style === 'link' || spec.style === 'body-link'
             ? Object.assign(method, {
                 pages: (args?: OperationArgs, init?: RequestOptions) =>
                   paginateCapability(caps, op).pagesByLink(
                     linkPageCall(config, op, caps),
+                    spec,
                     inputOf(op, args ?? {}, config),
                     init
                   ),
@@ -1823,9 +1865,9 @@ export async function* pages<TPage>(
       }
       cursor = next;
     }
-  } else if (spec.style === 'link') {
-    // \`link\` iteration needs the response's \`Link\` header, which the parsed-page \`call\`
-    // cannot carry \u2014 the client wires those operations to \`pagesByLink\` instead.
+  } else if (spec.style === 'link' || spec.style === 'body-link') {
+    // Link iteration needs the response's \`Link\` header and the page URL, which the
+    // parsed-page \`call\` cannot carry \u2014 the client wires those operations to \`pagesByLink\`.
     throw new Error('link-style pagination iterates via pagesByLink');
   } else {
     // Coerce the starting position to a number: a caller may pass \`query[spec.param]\` as a
@@ -1874,7 +1916,7 @@ export async function* items<TItem>(
 
 /**
  * The per-page call the \`link\`-style iterators drive: the parsed page plus the raw
- * \`Link\` header and the page's own URL (for resolving a relative \`next\` target).
+ * \`Link\` header and the page's own URL (for resolving a relative next-page target).
  */
 export type LinkPageCall = (
   args?: OperationArgs,
@@ -1897,25 +1939,32 @@ export function linkNext(header: string | null): string | undefined {
 }
 
 /**
- * Iterate a \`link\`-style operation's pages: follow the \`Link\` header's \`rel="next"\`
- * target by merging ITS query params into the next call \u2014 every page goes through the
- * same declared endpoint, so auth, middleware, and \`serverUrl\` handling apply
+ * Iterate a \`link\`- or \`body-link\`-style operation's pages: follow the next page's URL \u2014
+ * the \`Link\` header's \`rel="next"\` target (\`link\`), or the value at the \`nextLink\` pointer
+ * (\`body-link\`) \u2014 by merging ITS query params into the next call. Every page goes through
+ * the same declared endpoint, so auth, middleware, and \`serverUrl\` handling apply
  * unchanged, and credentials can never be handed to a cross-origin \`next\` URL.
- * Stops when no \`rel="next"\` is present; throws when the link does not advance
- * (the same target twice, or a self-link \u2014 an infinite-loop guard).
+ * Stops when there is no next URL (\`body-link\`: \`undefined\`/\`null\`/\`''\`); throws when a
+ * \`nextLink\` value is not a string, or when the link does not advance (the same target
+ * twice, or a self-link \u2014 an infinite-loop guard).
  */
 export async function* pagesByLink<TPage>(
   call: LinkPageCall,
+  spec: PaginationSpec,
   args: OperationArgs = {},
   init?: RequestOptions
 ): AsyncGenerator<TPage> {
+  const pointer = spec.style === 'body-link' ? spec.nextLink : undefined;
   let query = args.query;
   let previous: string | undefined;
   while (true) {
     const { page, linkHeader, url } = await call({ ...args, query }, init);
     yield page as TPage;
-    const target = linkNext(linkHeader);
-    if (target === undefined) return;
+    const target = pointer === undefined ? linkNext(linkHeader) : resolvePointer(page, pointer);
+    if (target === undefined || target === null || target === '') return;
+    if (typeof target !== 'string') {
+      throw new Error(\`Pagination link at \${pointer} is not a string\`);
+    }
     // A relative target resolves against the page's own URL (RFC 8288 \xA73.1) \u2014 which may
     // itself be relative (relative \`serverUrl\`, mocked fetch), so both resolve against a
     // placeholder origin. It never reaches the wire: only the target's query params
@@ -1946,7 +1995,7 @@ export async function* itemsByLink<TItem>(
   args?: OperationArgs,
   init?: RequestOptions
 ): AsyncGenerator<TItem> {
-  for await (const page of pagesByLink(call, args, init)) {
+  for await (const page of pagesByLink(call, spec, args, init)) {
     const pageItems = resolvePointer(page, spec.items);
     if (Array.isArray(pageItems)) yield* pageItems as TItem[];
   }
@@ -2782,7 +2831,7 @@ export type SecuritySpec =
 
 /**
  * How to auto-iterate a paginated operation (drives its \`.pages()\`/\`.items()\` members).
- * \`nextCursor\` and \`items\` are RFC 6901 JSON pointers into the page (response) value.
+ * \`nextCursor\`, \`nextLink\`, and \`items\` are RFC 6901 JSON pointers into the page (response) value.
  */
 export type PaginationSpec =
   | {
@@ -2814,6 +2863,16 @@ export type PaginationSpec =
       limitParam?: string;
       /** Pointer to the page's item array. */
       items: string;
+    }
+  | {
+      /** Follow the next page's URL at \`nextLink\` in the page; stop when it is absent. */
+      style: 'body-link';
+      /** Optional page-size query param (recorded for tooling; never set by the runtime). */
+      limitParam?: string;
+      /** Pointer to the next page's URL in the page. */
+      nextLink: string;
+      /** Pointer to the page's item array. */
+      items: string;
     };
 
 /** The frozen data contract between generated code and the runtime: one operation's wire shape. */
@@ -3535,6 +3594,42 @@ function middlewareChain(config: ClientConfig): Middleware[] {
   return [...single, ...(config.middleware ?? [])];
 }
 
+/**
+ * \`AbortSignal.timeout()\` where the platform has it, else an \`AbortController\` armed by
+ * \`setTimeout\`: Chrome before 103, Safari before 16, and Firefox before 100 lack the
+ * static, and every request with a timeout would throw before \`fetch\` runs.
+ */
+function timeoutSignal(ms: number): AbortSignal {
+  if (typeof AbortSignal.timeout === 'function') return AbortSignal.timeout(ms);
+  const controller = new AbortController();
+  setTimeout(() => {
+    controller.abort(new DOMException(\`Timed out after \${ms} ms\`, 'TimeoutError'));
+  }, ms);
+  return controller.signal;
+}
+
+/**
+ * \`AbortSignal.any()\` where the platform has it, else a controller that follows whichever
+ * signal aborts first: Chrome before 116, Safari before 17.4, and Firefox before 124 lack
+ * the static. The listeners come off once one signal fires, so a caller's long-lived
+ * signal does not keep one per request.
+ */
+function anySignal(signals: AbortSignal[]): AbortSignal {
+  if (typeof AbortSignal.any === 'function') return AbortSignal.any(signals);
+  const controller = new AbortController();
+  const listeners = new Map<AbortSignal, () => void>();
+  const abort = (reason: unknown) => {
+    for (const [signal, listener] of listeners) signal.removeEventListener('abort', listener);
+    controller.abort(reason);
+  };
+  for (const signal of signals) {
+    const listener = () => abort(signal.reason);
+    listeners.set(signal, listener);
+    signal.addEventListener('abort', listener);
+  }
+  return controller.signal;
+}
+
 /**
  * The fetch core shared by every operation: default + config + per-call headers, the
  * \`onRequest\` chain (BEFORE body serialization, so mutations are sent), body
@@ -3655,11 +3750,8 @@ async function send(
     if (signal?.aborted) throw abortError(signal);
     // A fresh timeout budget per attempt; the caller's signal still wins the race.
     // The composed signal also governs reading the response body.
-    const attemptSignal = timeout
-      ? signal
-        ? AbortSignal.any([signal, AbortSignal.timeout(timeout)])
-        : AbortSignal.timeout(timeout)
-      : signal;
+    const budget = timeout ? timeoutSignal(timeout) : undefined;
+    const attemptSignal = budget && signal ? anySignal([signal, budget]) : (budget ?? signal);
     let response: Response;
     try {
       response = await doFetch(context.url, {
@@ -3672,6 +3764,10 @@ async function send(
         body: payload,
       });
     } catch (error) {
+      // Decided before any await, when no timer can have fired since \`fetch\` rejected: an
+      // aborted budget means this attempt timed out. The abort reason's name is no
+      // evidence, because Chrome 103 to 123 abort a timeout with \`AbortError\`.
+      const timedOut = timeout !== undefined && budget?.aborted && !signal?.aborted;
       if (
         attempt < maxAttempts &&
         !signal?.aborted &&
@@ -3682,14 +3778,7 @@ async function send(
       }
       // Our timeout fired (never the caller's own abort \u2014 that rethrows untouched):
       // wrap the bare DOMException with the context a log line needs.
-      if (
-        timeout &&
-        !signal?.aborted &&
-        error instanceof DOMException &&
-        error.name === 'TimeoutError'
-      ) {
-        throw new TimeoutError(op.id, timeout, attempt);
-      }
+      if (timedOut) throw new TimeoutError(op.id, timeout, attempt);
       throw error;
     }
     // Reverse order: the last-registered middleware wraps closest to the network (onion).
@@ -3919,6 +4008,7 @@ type Capabilities = SendCapabilities & {
         args?: OperationArgs,
         init?: RequestOptions
       ) => Promise<{ page: unknown; linkHeader: string | null; url: string }>,
+      spec: PaginationSpec,
       args?: OperationArgs,
       init?: RequestOptions
     ) => AsyncGenerator<unknown>;
@@ -4366,11 +4456,12 @@ function createClientCore<
       client[name] =
         spec === undefined
           ? method
-          : spec.style === 'link'
+          : spec.style === 'link' || spec.style === 'body-link'
             ? Object.assign(method, {
                 pages: (args?: OperationArgs, init?: RequestOptions) =>
                   paginateCapability(caps, op).pagesByLink(
                     linkPageCall(config, op, caps),
+                    spec,
                     inputOf(op, args ?? {}, config),
                     init
                   ),
@@ -4510,9 +4601,9 @@ async function* pages<TPage>(
       }
       cursor = next;
     }
-  } else if (spec.style === 'link') {
-    // \`link\` iteration needs the response's \`Link\` header, which the parsed-page \`call\`
-    // cannot carry \u2014 the client wires those operations to \`pagesByLink\` instead.
+  } else if (spec.style === 'link' || spec.style === 'body-link') {
+    // Link iteration needs the response's \`Link\` header and the page URL, which the
+    // parsed-page \`call\` cannot carry \u2014 the client wires those operations to \`pagesByLink\`.
     throw new Error('link-style pagination iterates via pagesByLink');
   } else {
     // Coerce the starting position to a number: a caller may pass \`query[spec.param]\` as a
@@ -4561,7 +4652,7 @@ async function* items<TItem>(
 
 /**
  * The per-page call the \`link\`-style iterators drive: the parsed page plus the raw
- * \`Link\` header and the page's own URL (for resolving a relative \`next\` target).
+ * \`Link\` header and the page's own URL (for resolving a relative next-page target).
  */
 type LinkPageCall = (
   args?: OperationArgs,
@@ -4584,25 +4675,32 @@ function linkNext(header: string | null): string | undefined {
 }
 
 /**
- * Iterate a \`link\`-style operation's pages: follow the \`Link\` header's \`rel="next"\`
- * target by merging ITS query params into the next call \u2014 every page goes through the
- * same declared endpoint, so auth, middleware, and \`serverUrl\` handling apply
+ * Iterate a \`link\`- or \`body-link\`-style operation's pages: follow the next page's URL \u2014
+ * the \`Link\` header's \`rel="next"\` target (\`link\`), or the value at the \`nextLink\` pointer
+ * (\`body-link\`) \u2014 by merging ITS query params into the next call. Every page goes through
+ * the same declared endpoint, so auth, middleware, and \`serverUrl\` handling apply
  * unchanged, and credentials can never be handed to a cross-origin \`next\` URL.
- * Stops when no \`rel="next"\` is present; throws when the link does not advance
- * (the same target twice, or a self-link \u2014 an infinite-loop guard).
+ * Stops when there is no next URL (\`body-link\`: \`undefined\`/\`null\`/\`''\`); throws when a
+ * \`nextLink\` value is not a string, or when the link does not advance (the same target
+ * twice, or a self-link \u2014 an infinite-loop guard).
  */
 async function* pagesByLink<TPage>(
   call: LinkPageCall,
+  spec: PaginationSpec,
   args: OperationArgs = {},
   init?: RequestOptions
 ): AsyncGenerator<TPage> {
+  const pointer = spec.style === 'body-link' ? spec.nextLink : undefined;
   let query = args.query;
   let previous: string | undefined;
   while (true) {
     const { page, linkHeader, url } = await call({ ...args, query }, init);
     yield page as TPage;
-    const target = linkNext(linkHeader);
-    if (target === undefined) return;
+    const target = pointer === undefined ? linkNext(linkHeader) : resolvePointer(page, pointer);
+    if (target === undefined || target === null || target === '') return;
+    if (typeof target !== 'string') {
+      throw new Error(\`Pagination link at \${pointer} is not a string\`);
+    }
     // A relative target resolves against the page's own URL (RFC 8288 \xA73.1) \u2014 which may
     // itself be relative (relative \`serverUrl\`, mocked fetch), so both resolve against a
     // placeholder origin. It never reaches the wire: only the target's query params
@@ -4633,7 +4731,7 @@ async function* itemsByLink<TItem>(
   args?: OperationArgs,
   init?: RequestOptions
 ): AsyncGenerator<TItem> {
-  for await (const page of pagesByLink(call, args, init)) {
+  for await (const page of pagesByLink(call, spec, args, init)) {
     const pageItems = resolvePointer(page, spec.items);
     if (Array.isArray(pageItems)) yield* pageItems as TItem[];
   }
@@ -5443,4 +5541,4 @@ async function runSingle(
     }
     return fail(1, detail);
   }
-}`},S=["ApiError","ApiErrorLike","AuthCredentials","BodyMethod","Capabilities","CliAuthScheme","CliCommand","CliFlag","CliGlobals","CliInvocation","CliWiring","Client","ClientConfig","ClientCore","CommandContext","CommandSource","CustomCommand","Envelope","EnvelopeResult","EnvelopeResultForKnownInit","FRAME_DELIMITER","GLOBAL_FLAGS","HeadersOf","IDEMPOTENT_METHODS","LAYERS","LAYER_OF","LinkPageCall","Middleware","NoRequiredKeys","OperationArgs","OperationContext","OperationDescriptor","OperationMethodIdentity","OpsShape","PageOf","Paginated","PaginationSpec","ParamSpec","ParseAs","QueryStyle","QueryValue","RequestContext","RequestOptions","ResolvedCommand","ResponseHeaderSpec","Result","RetryConfig","RetryContext","RetryStrategy","SecuritySpec","SendCapabilities","ServerSentEvent","SseOptions","SseParseError","TRANSIENT_STATUS","ThrowMethod","TimeoutError","TokenProvider","abortError","acceptFor","buildUrl","callInputs","coerceResponseHeader","commandContract","constantCase","createClientCore","defaultRetryOn","encodeBase64","encodeReserved","execute","groupSlug","inputOf","invokedName","isConfigured","items","itemsByLink","kindFor","linkNext","linkPageCall","loadBody","mergeSetup","middlewareChain","namespaceArgs","normalizeCommands","oneLine","pageCall","pages","pagesByLink","paginateCapability","parse","parseInvocation","parseSseFrame","prepareRequest","queryStyles","readEnvelopeHeaders","readError","redactHeaders","renderComposedHelp","renderHelp","resolveAuth","resolvePointer","resolveToken","retryDelay","runCli","runSingle","runSources","send","shadowedCommandName","sleep","splitArgs","sse","stringHeaders","substitutePath","toFormData","toHeaderRecord"];var j=["client","OPERATIONS","Ops","OperationId","OperationPath","OperationTag","createClient","mergeSetup","ApiError","TimeoutError","configure","use","auth","defaultRetryOn","ClientConfig","RequestOptions","SseOptions","Middleware","OperationDescriptor","ServerSentEvent","Result","Envelope","EnvelopeResult","TokenProvider","__redoclySetup"],$=["z","http","HttpResponse","handlers","faker","queryOptions","useSWR","useSWRMutation","__Writable"],N=["AbortSignal","Array","ArrayBuffer","ArrayBufferView","AsyncGenerator","AsyncIterable","Blob","BodyInit","Boolean","DOMException","Date","Error","Extract","FormData","Headers","HeadersInit","JSON","Map","Math","NonNullable","Number","Object","Omit","Partial","Promise","ReadableStream","Record","RegExp","RegExpExecArray","Request","RequestInit","Response","Set","String","Symbol","TextDecoder","TextEncoder","TypeError","Uint8Array","URL","URLSearchParams","btoa","clearTimeout","crypto","decodeURIComponent","document","encodeURIComponent","fetch","globalThis","setTimeout","undefined"],w;function Q(){return w===void 0&&(w=new Set([...j,...$,...N,...S])),w}var A={name:"@redocly/client-generator",version:"0.5.2",description:"Generate typed, zero-dependency TypeScript clients (fetch, auth, retries, middleware, SSE) from OpenAPI descriptions.",type:"module",types:"lib/index.d.ts",sideEffects:!1,exports:{".":{types:"./lib/index.d.ts",import:"./lib/index.js",default:"./lib/index.js"},"./generate":{types:"./lib/generate.d.ts",import:"./lib/generate.js",default:"./lib/generate.js"},"./printers/python":{types:"./lib/printers/python.d.ts",import:"./lib/printers/python.js",default:"./lib/printers/python.js"},"./printers/go":{types:"./lib/printers/go.d.ts",import:"./lib/printers/go.js",default:"./lib/printers/go.js"},"./printers/php":{types:"./lib/printers/php.d.ts",import:"./lib/printers/php.js",default:"./lib/printers/php.js"},"./printers/typescript":{types:"./lib/printers/typescript.d.ts",import:"./lib/printers/typescript.js",default:"./lib/printers/typescript.js"},"./printers":{types:"./lib/printers/index.d.ts",import:"./lib/printers/index.js",default:"./lib/printers/index.js"},"./contracts/typescript":{types:"./lib/contracts/typescript.d.ts",import:"./lib/contracts/typescript.js",default:"./lib/contracts/typescript.js"},"./runtime-sources":{types:"./lib/runtime-sources.d.ts",import:"./lib/runtime-sources.js",default:"./lib/runtime-sources.js"},"./package.json":"./package.json"},engines:{node:">=22.12.0 || >=20.19.0 <21.0.0",npm:">=10"},engineStrict:!0,scripts:{"examples:regen":"node scripts/regenerate-examples.mjs",prepare:"node scripts/generate-runtime-sources.mjs && node scripts/generate-eject-assets.mjs","typecheck:examples":"node scripts/typecheck-examples.mjs"},license:"MIT",repository:{type:"git",url:"git+https://github.com/Redocly/redocly-cli.git"},homepage:"https://github.com/Redocly/redocly-cli",keywords:["OpenAPI","Swagger","TypeScript","client","generator","codegen","fetch"],contributors:["Roman Marshevskyi <roman.marshevskyy@redocly.com> (https://redocly.com/)"],dependencies:{"@redocly/openapi-core":"2.62.1"},peerDependencies:{typescript:">=5.5.0"},peerDependenciesMeta:{typescript:{optional:!0}},devDependencies:{typescript:"6.0.2"},files:["lib","eject-assets"]};var ee=A.version;function T(e){let n=/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(e.trim());return n===null?void 0:[Number(n[1]),Number(n[2]),Number(n[3])]}function v(e,n){return e[0]-n[0]||e[1]-n[1]||e[2]-n[2]}function ne(e,n){let s=/^[\^~]|^>=/.exec(n.trim())?.[0]??"",r=T(n.trim().slice(s.length)),a=T(e);if(!(r===void 0||a===void 0))return v(a,r)<0?!1:s===">="?!0:s===""?v(a,r)===0:s==="~"?a[0]===r[0]&&a[1]===r[1]:r[0]!==0?a[0]===r[0]:r[1]!==0?a[0]===0&&a[1]===r[1]:v(a,r)===0}export{C as a,H as b,G as c,W as d,j as e,Q as f,ee as g,ne as h};
+}`},S=["ApiError","ApiErrorLike","AuthCredentials","BodyMethod","Capabilities","CliAuthScheme","CliCommand","CliFlag","CliGlobals","CliInvocation","CliWiring","Client","ClientConfig","ClientCore","CommandContext","CommandSource","CustomCommand","Envelope","EnvelopeResult","EnvelopeResultForKnownInit","FRAME_DELIMITER","GLOBAL_FLAGS","HeadersOf","IDEMPOTENT_METHODS","LAYERS","LAYER_OF","LinkPageCall","Middleware","NoRequiredKeys","OperationArgs","OperationContext","OperationDescriptor","OperationMethodIdentity","OpsShape","PageOf","Paginated","PaginationSpec","ParamSpec","ParseAs","QueryStyle","QueryValue","RequestContext","RequestOptions","ResolvedCommand","ResponseHeaderSpec","Result","RetryConfig","RetryContext","RetryStrategy","SecuritySpec","SendCapabilities","ServerSentEvent","SseOptions","SseParseError","TRANSIENT_STATUS","ThrowMethod","TimeoutError","TokenProvider","abortError","acceptFor","anySignal","buildUrl","callInputs","coerceResponseHeader","commandContract","constantCase","createClientCore","defaultRetryOn","encodeBase64","encodeReserved","execute","groupSlug","inputOf","invokedName","isConfigured","items","itemsByLink","kindFor","linkNext","linkPageCall","loadBody","mergeSetup","middlewareChain","namespaceArgs","normalizeCommands","oneLine","pageCall","pages","pagesByLink","paginateCapability","parse","parseInvocation","parseSseFrame","prepareRequest","queryStyles","readEnvelopeHeaders","readError","redactHeaders","renderComposedHelp","renderHelp","resolveAuth","resolvePointer","resolveToken","retryDelay","runCli","runSingle","runSources","send","shadowedCommandName","sleep","splitArgs","sse","stringHeaders","substitutePath","timeoutSignal","toFormData","toHeaderRecord"];var j=["client","OPERATIONS","Ops","OperationId","OperationPath","OperationTag","createClient","mergeSetup","ApiError","TimeoutError","configure","use","auth","defaultRetryOn","ClientConfig","RequestOptions","SseOptions","Middleware","OperationDescriptor","ServerSentEvent","Result","Envelope","EnvelopeResult","TokenProvider","__redoclySetup"],$=["z","http","HttpResponse","handlers","faker","queryOptions","useSWR","useSWRMutation","__Writable"],L=["AbortController","AbortSignal","Array","ArrayBuffer","ArrayBufferView","AsyncGenerator","AsyncIterable","Blob","BodyInit","Boolean","DOMException","Date","Error","Extract","FormData","Headers","HeadersInit","JSON","Map","Math","NonNullable","Number","Object","Omit","Partial","Promise","ReadableStream","Record","RegExp","RegExpExecArray","Request","RequestInit","Response","Set","String","Symbol","TextDecoder","TextEncoder","TypeError","Uint8Array","URL","URLSearchParams","btoa","clearTimeout","crypto","decodeURIComponent","document","encodeURIComponent","fetch","globalThis","setTimeout","undefined"],w;function Q(){return w===void 0&&(w=new Set([...j,...$,...L,...S])),w}var A={name:"@redocly/client-generator",version:"0.6.0",description:"Generate typed, zero-dependency TypeScript clients (fetch, auth, retries, middleware, SSE) from OpenAPI descriptions.",type:"module",types:"lib/index.d.ts",sideEffects:!1,exports:{".":{types:"./lib/index.d.ts",import:"./lib/index.js",default:"./lib/index.js"},"./generate":{types:"./lib/generate.d.ts",import:"./lib/generate.js",default:"./lib/generate.js"},"./printers/python":{types:"./lib/printers/python.d.ts",import:"./lib/printers/python.js",default:"./lib/printers/python.js"},"./printers/go":{types:"./lib/printers/go.d.ts",import:"./lib/printers/go.js",default:"./lib/printers/go.js"},"./printers/php":{types:"./lib/printers/php.d.ts",import:"./lib/printers/php.js",default:"./lib/printers/php.js"},"./printers/typescript":{types:"./lib/printers/typescript.d.ts",import:"./lib/printers/typescript.js",default:"./lib/printers/typescript.js"},"./printers":{types:"./lib/printers/index.d.ts",import:"./lib/printers/index.js",default:"./lib/printers/index.js"},"./contracts/typescript":{types:"./lib/contracts/typescript.d.ts",import:"./lib/contracts/typescript.js",default:"./lib/contracts/typescript.js"},"./runtime-sources":{types:"./lib/runtime-sources.d.ts",import:"./lib/runtime-sources.js",default:"./lib/runtime-sources.js"},"./package.json":"./package.json"},engines:{node:">=22.12.0 || >=20.19.0 <21.0.0",npm:">=10"},engineStrict:!0,scripts:{"examples:regen":"node scripts/regenerate-examples.mjs",prepare:"node scripts/generate-runtime-sources.mjs && node scripts/generate-eject-assets.mjs","typecheck:examples":"node scripts/typecheck-examples.mjs"},license:"MIT",repository:{type:"git",url:"git+https://github.com/Redocly/redocly-cli.git"},homepage:"https://github.com/Redocly/redocly-cli",keywords:["OpenAPI","Swagger","TypeScript","client","generator","codegen","fetch"],contributors:["Roman Marshevskyi <roman.marshevskyy@redocly.com> (https://redocly.com/)"],dependencies:{"@redocly/openapi-core":"2.63.0"},peerDependencies:{typescript:">=5.5.0"},peerDependenciesMeta:{typescript:{optional:!0}},devDependencies:{typescript:"6.0.2"},files:["lib","eject-assets"]};var ee=A.version;function T(e){let n=/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(e.trim());return n===null?void 0:[Number(n[1]),Number(n[2]),Number(n[3])]}function v(e,n){return e[0]-n[0]||e[1]-n[1]||e[2]-n[2]}function ne(e,n){let o=/^[\^~]|^>=/.exec(n.trim())?.[0]??"",r=T(n.trim().slice(o.length)),a=T(e);if(!(r===void 0||a===void 0))return v(a,r)<0?!1:o===">="?!0:o===""?v(a,r)===0:o==="~"?a[0]===r[0]&&a[1]===r[1]:r[0]!==0?a[0]===r[0]:r[1]!==0?a[0]===0&&a[1]===r[1]:v(a,r)===0}export{C as a,H as b,G as c,W as d,j as e,Q as f,ee as g,ne as h};

package/lib/chunks/{SLQPKXO2.js → A22GELRX.js}

@@ -4,4 +4,4 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{c as r}from"./22EANOP2.js";var s="components",p="paths",i="webhooks",O="x-webhooks",c="channels",f="operations";function e(o,n){if(r(o)){n(o);for(let t of Object.keys(o))e(o[t],n)}else if(Array.isArray(o))for(let t of o)e(t,n)}function S(o){return o.startsWith(`#/${s}/`)}export{s as a,p as b,i as c,O as d,c as e,f,e as g,S as h};
+import{c as r}from"./ACMV5RZA.js";var s="components",p="paths",i="webhooks",O="x-webhooks",c="channels",f="operations";function e(o,n){if(r(o)){n(o);for(let t of Object.keys(o))e(o[t],n)}else if(Array.isArray(o))for(let t of o)e(t,n)}function S(o){return o.startsWith(`#/${s}/`)}export{s as a,p as b,i as c,O as d,c as e,f,e as g,S as h};