@redocly/cli 2.62.2 → 2.64.0

package/lib/eject-assets/generators/go/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "go" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator go --update`.

package/lib/eject-assets/generators/mock/faker.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "mock" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator mock --update`.

package/lib/eject-assets/generators/mock/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "mock" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator mock --update`.
@@ -31,5 +31,5 @@ export default {
   name: 'mock',
   run: mockGenerator,
   requires: ["typescript"],
-  requiresGenerator: '^0.5.3',
+  requiresGenerator: '^0.7.0',
 };

package/lib/eject-assets/generators/mock/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "mock" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator mock --update`.

package/lib/eject-assets/generators/mock/sample.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "mock" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator mock --update`.

package/lib/eject-assets/generators/mock/values.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "mock" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator mock --update`.

package/lib/eject-assets/generators/php/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.

package/lib/eject-assets/generators/php/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.
@@ -36,6 +36,7 @@ export function phpPaginationLiteral(rule: NeutralPaginationRule): string {
     ...(rule.param !== undefined ? [`'param' => ${phpString(rule.param)}`] : []),
     ...(rule.nextCursor !== undefined ? [`'nextCursor' => ${phpString(rule.nextCursor)}`] : []),
     ...(rule.hasMore !== undefined ? [`'hasMore' => ${phpString(rule.hasMore)}`] : []),
+    ...(rule.nextLink !== undefined ? [`'nextLink' => ${phpString(rule.nextLink)}`] : []),
     ...(rule.limitParam !== undefined ? [`'limitParam' => ${phpString(rule.limitParam)}`] : []),
     ...(rule.items !== undefined ? [`'items' => ${phpString(rule.items)}`] : []),
   ];

package/lib/eject-assets/generators/php/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.
@@ -234,5 +234,5 @@ export default {
     "argsStyle": "inputs follow the target language's own idiom",
     "importExt": "the generated file has no relative imports"
   },
-  requiresGenerator: '^0.5.3',
+  requiresGenerator: '^0.7.0',
 };

package/lib/eject-assets/generators/php/models.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.

package/lib/eject-assets/generators/php/naming.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.

package/lib/eject-assets/generators/php/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.

package/lib/eject-assets/generators/php/pagination.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.

package/lib/eject-assets/generators/php/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.

package/lib/eject-assets/generators/python/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/lib/eject-assets/generators/python/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.
@@ -31,6 +31,7 @@ export function paginationSpec(
     ...(rule.param !== undefined ? { param: rule.param } : {}),
     ...(rule.nextCursor !== undefined ? { next_cursor: rule.nextCursor } : {}),
     ...(rule.hasMore !== undefined ? { has_more: rule.hasMore } : {}),
+    ...(rule.nextLink !== undefined ? { next_link: rule.nextLink } : {}),
     ...(rule.limitParam !== undefined ? { limit_param: rule.limitParam } : {}),
     ...(rule.items !== undefined ? { items: rule.items } : {}),
   };

package/lib/eject-assets/generators/python/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.
@@ -247,5 +247,5 @@ export default {
     "argsStyle": "inputs follow the target language's own idiom",
     "importExt": "the generated file has no relative imports"
   },
-  requiresGenerator: '^0.5.3',
+  requiresGenerator: '^0.7.0',
 };

package/lib/eject-assets/generators/python/models.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/lib/eject-assets/generators/python/naming.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/lib/eject-assets/generators/python/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/lib/eject-assets/generators/python/pagination.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/lib/eject-assets/generators/python/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/lib/eject-assets/generators/swr/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "swr" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "swr" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator swr --update`.
@@ -33,5 +33,5 @@ export default {
   run: swrGenerator,
   requires: ["typescript"],
   errorModes: ["throw"],
-  requiresGenerator: '^0.5.3',
+  requiresGenerator: '^0.7.0',
 };

package/lib/eject-assets/generators/swr/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "swr" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "swr" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator swr --update`.

package/lib/eject-assets/generators/tanstack-query/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "tanstack-query" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "tanstack-query" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator tanstack-query --update`.
@@ -44,5 +44,5 @@ export default {
   run: tanstackQueryGenerator('react'),
   requires: ["typescript"],
   errorModes: ["throw"],
-  requiresGenerator: '^0.5.3',
+  requiresGenerator: '^0.7.0',
 };

package/lib/eject-assets/generators/tanstack-query/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "tanstack-query" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "tanstack-query" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator tanstack-query --update`.
@@ -11,7 +11,7 @@
 // `<op>InfiniteOptions(vars, init?)` with `initialPageParam`/`getNextPageParam` compiled
 // from the pagination rule's JSON pointers. Per mutation: `<op>Mutation(init?)`. Calls go
 // through the client instance's methods, which take one input object in either
-// `--args-style`; only the infinite query's cursor override differs between them.
+// `--args-style`; only the infinite query's page-param override differs between them.
 //
 // The factory bodies are authored as source text — the emitted module verbatim
 // and normalizes everything to the printer's canonical style. Every interpolated piece
@@ -58,6 +58,7 @@ export function renderTanstackModule(model: ApiModel, opts: TanstackOptions): st
   const pagination = opts.pagination ?? new Map();
   const source = [
     importHeader(ops, opts, pagination),
+    ...(ops.some((op) => isBodyLinkInfinite(op, pagination)) ? [NEXT_LINK_QUERY] : []),
     ...ops.filter(isQuery).map((op) => queryKeySource(op, opts.queryKeyPrefix)),
     factoriesSource(model, ops, pagination, opts.queryKeyPrefix, opts.argsStyle),
     ...defaultBindings(ops, pagination),
@@ -69,14 +70,36 @@ export function renderTanstackModule(model: ApiModel, opts: TanstackOptions): st
  * Whether the op gets an `<op>InfiniteOptions` factory: a paginated query operation.
  * `link`-style pagination is excluded — its next page lives in the `Link` response
  * HEADER, which a TanStack `queryFn` (body-only) cannot see; use the sdk's
- * `.pages()`/`.items()` iterators for those operations instead.
+ * `.pages()`/`.items()` iterators for those operations instead. `body-link` qualifies
+ * when the operation has a query parameter to carry the link's parameters.
  */
 function isInfinite(op: OperationModel, pagination: ModelPagination): boolean {
   if (!isQuery(op)) return false;
   const paginated = pagination.get(op.name);
-  return paginated !== undefined && paginated.spec.style !== 'link';
+  if (paginated === undefined || paginated.spec.style === 'link') return false;
+  return paginated.spec.style !== 'body-link' || op.queryParams.length > 0;
 }
 
+/** A query op whose `body-link` pagination gets an `<op>InfiniteOptions` factory. */
+function isBodyLinkInfinite(op: OperationModel, pagination: ModelPagination): boolean {
+  return isInfinite(op, pagination) && pagination.get(op.name)?.spec.style === 'body-link';
+}
+
+/**
+ * The module-private helper a body-link `queryFn` merges the next page's query
+ * parameters with, the way the sdk's link iterator does: a repeated key becomes an array.
+ */
+const NEXT_LINK_QUERY =
+  '/** The query parameters of a next-page link; a repeated key becomes an array. */\n' +
+  'const nextLinkQuery = (link: string) => {\n' +
+  '    const query: Record<string, string | string[]> = {};\n' +
+  '    for (const [key, value] of new URL(link, "http://relative.invalid").searchParams) {\n' +
+  '        const seen = query[key];\n' +
+  '        query[key] = seen === undefined ? value : Array.isArray(seen) ? [...seen, value] : [seen, value];\n' +
+  '    }\n' +
+  '    return query;\n' +
+  '};';
+
 /**
  * The import header: the option helpers from `@tanstack/${framework}-query` (only the
  * ones used), then the sdk's `client` instance plus the referenced types.
@@ -133,9 +156,9 @@ function factoriesSource(
 ): string {
   const members = ops.flatMap((op) => {
     if (!isQuery(op)) return [mutationMember(op, prefix)];
-    const paginated = pagination.get(op.name);
-    return paginated !== undefined && paginated.spec.style !== 'link'
-      ? [optionsMember(op), infiniteMember(model, op, paginated.spec, argsStyle)]
+    const spec = pagination.get(op.name)?.spec;
+    return spec !== undefined && spec.style !== 'link' && isInfinite(op, pagination)
+      ? [optionsMember(op), infiniteMember(model, op, spec, argsStyle)]
       : [optionsMember(op)];
   });
   return (
@@ -179,7 +202,8 @@ function mutationMember(op: OperationModel, prefix: string | undefined): string
  * page param rides the rule's advance query parameter, `initialPageParam` resumes from
  * the caller's own value, and `getNextPageParam` mirrors the runtime iterators' stop
  * conditions (cursor: absent/`null`/`''`, plus the optional `hasMore === false`;
- * offset/page: an empty items page).
+ * offset/page: an empty items page). A body link is the page param itself: the first
+ * page sends `vars` as given, later pages merge the link's query parameters over them.
  */
 function infiniteMember(
   model: ApiModel,
@@ -188,6 +212,29 @@ function infiniteMember(
   argsStyle: TanstackOptions['argsStyle']
 ): string {
   const { params, keyArg } = varsPieces(op);
+  if (spec.style === 'body-link') {
+    const merged =
+      argsStyle === 'flat'
+        ? '{ ...vars, ...nextLinkQuery(pageParam) }'
+        : '{ ...vars, query: { ...vars.query, ...nextLinkQuery(pageParam) } }';
+    const pointer = spec.nextLink;
+    const checks = cursorStopChecks(model, op, pointer);
+    const next =
+      checks.length === 0
+        ? `            return lastPage${pointerChain(pointer)};\n`
+        : `            const next = lastPage${pointerChain(pointer)};\n` +
+          `            return ${checks.join(' || ')} ? undefined : next;\n`;
+    return (
+      `    ${op.name}InfiniteOptions: (${params}) => infiniteQueryOptions({\n` +
+      `        queryKey: [...${op.name}QueryKey(${keyArg}), "infinite"] as const,\n` +
+      `        queryFn: ({ pageParam, signal }) => instance.${op.name}(pageParam === undefined ? vars : ${merged} as ${variablesName(op)}, { ...init, signal, envelope: undefined }),\n` +
+      `        initialPageParam: undefined as string | undefined,\n` +
+      `        getNextPageParam: (lastPage) => {\n` +
+      next +
+      `        },\n` +
+      `    })`
+    );
+  }
   // The cursor is a query parameter, so it lands in the sdk's own spelling for one:
   // inside the `query` layer, or at the top level of a merged call.
   const cursor = safeIdent(spec.param);
@@ -208,7 +255,7 @@ function infiniteMember(
 function nextPageSource(
   model: ApiModel,
   op: OperationModel,
-  spec: Exclude<PaginationSpec, { style: 'link' }>,
+  spec: Exclude<PaginationSpec, { style: 'link' | 'body-link' }>,
   argsStyle: TanstackOptions['argsStyle']
 ): string {
   const advance = paramsAccess(spec.param);

package/lib/eject-assets/generators/transformers/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "transformers" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "transformers" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator transformers --update`.
@@ -42,5 +42,5 @@ export default {
   run: transformersGenerator,
   requires: ["typescript"],
   dateTypes: ["Date"],
-  requiresGenerator: '^0.5.3',
+  requiresGenerator: '^0.7.0',
 };

package/lib/eject-assets/generators/transformers/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "transformers" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "transformers" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator transformers --update`.

package/lib/eject-assets/generators/typescript/banner.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/typescript/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/typescript/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/typescript/index.ts

@@ -1,16 +1,21 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.
 import {
   type CodeSample,
+  type EmitOptions,
   type Generator,
+  GENERATOR_VERSION,
+  type GeneratedFile,
   type OperationModel,
   renderReferencePage,
   type SampleContext,
 } from '@redocly/client-generator';
+import { TELEMETRY_RUNTIME_SOURCE } from '@redocly/client-generator/runtime-sources';
 import { join } from 'node:path';
 
+import { HEADER } from './banner.ts';
 import { emitClientSingleFile, emitClientSplit, emitRuntimeFiles } from './client.ts';
 import { packageIdents } from './descriptor.ts';
 
@@ -29,6 +34,10 @@ export const typescriptGenerator: Generator = ({ model, output, outputMode, emit
     path: join(output.dir, 'runtime', name),
     content,
   }));
+  const telemetry: GeneratedFile[] = [];
+  if (emit.telemetry === 'on') {
+    telemetry.push(telemetryFile(output.dir, output.stem, emit));
+  }
   if (outputMode === 'split') {
     const { dir, stem } = output;
     const { entry, schemas } = emitClientSplit(model, emit, stem);
@@ -38,11 +47,28 @@ export const typescriptGenerator: Generator = ({ model, output, outputMode, emit
         : [{ path: join(dir, `${stem}.schemas.ts`), content: schemas }]),
       { path: output.path, content: entry },
       ...runtime,
+      ...telemetry,
     ];
   }
-  return [{ path: output.path, content: emitClientSingleFile(model, emit) }, ...runtime];
+  return [
+    { path: output.path, content: emitClientSingleFile(model, emit) },
+    ...runtime,
+    ...telemetry,
+  ];
 };
 
+function telemetryFile(dir: string, stem: string, emit: EmitOptions): GeneratedFile {
+  const clientModule = `./${stem}.${emit.importExt ?? 'js'}`;
+  const content = TELEMETRY_RUNTIME_SOURCE.replace(
+    "from '../../../runtime-contract.js';",
+    () => `from '${clientModule}';`
+  ).replace(
+    "const GENERATOR_VERSION: string = 'dev';",
+    () => `const GENERATOR_VERSION: string = '${GENERATOR_VERSION}';`
+  );
+  return { path: join(dir, `${stem}.telemetry.ts`), content: `${HEADER}\n\n${content}` };
+}
+
 /**
  * The client's own reference page, written when `client.docs` is on. Its snippets come from
  * `typescriptSample` below, so the page shows the calling convention this run generated —
@@ -97,5 +123,5 @@ export default {
   run: typescriptGenerator,
   sample: typescriptSample,
   docs: typescriptDocs,
-  requiresGenerator: '^0.5.3',
+  requiresGenerator: '^0.7.0',
 };

package/lib/eject-assets/generators/typescript/inline-runtime.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/typescript/operation-signature.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/typescript/operation-types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/typescript/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/typescript/response-headers.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/typescript/type-guards.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/typescript/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/lib/eject-assets/generators/zod/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "zod" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "zod" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator zod --update`.
@@ -28,5 +28,5 @@ export const zodGenerator: Generator = ({ model, output, banner }) => {
 export default {
   name: 'zod',
   run: zodGenerator,
-  requiresGenerator: '^0.5.3',
+  requiresGenerator: '^0.7.0',
 };

package/lib/eject-assets/generators/zod/schemas.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.5.3 — the built-in "zod" generator.
+// Ejected from @redocly/client-generator@0.7.0 — the built-in "zod" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator zod --update`.

package/lib/eject-assets/skills/tanstack-query-generator/SKILL.md

@@ -21,8 +21,11 @@ query keys. One generator, four framework variants (`react` default, `-vue`,
 - **Options factories, not hooks:** consumers call `useQuery(<op>Options(...))`, so the
   output works with any of the framework adapters and stays testable.
 - **`queryKeyPrefix`** namespaces every key when several clients share a cache.
-- **Infinite queries** derive `getNextPageParam` from the resolved pagination rule; a
-  `link`-style rule reads the `Link` header the descriptor declares.
+- **Infinite queries** derive `getNextPageParam` from the resolved pagination rule. A
+  `body-link` rule gets one when the operation has a query parameter: the next page's
+  URL is the page param, and each later page merges the URL's query parameters over
+  `vars`. A `Link` header is invisible to a `queryFn`, so `link`-style operations get
+  only the sdk's `.pages()`/`.items()`.
 - **`envelope` is excluded and stripped** — cached data is the plain body.
 - Requires `typescript`; throw-mode only (it wraps thrown errors into query errors).
 

package/lib/eject-assets/skills/typescript-generator/SKILL.md

@@ -17,6 +17,10 @@ operation, and the runtime — embedded in the file (`runtime: inline`, the defa
 written as real modules in a `runtime/` folder beside it that the client imports
 relatively (`runtime: module`).
 
+With `client.telemetry: on`, it also writes `<stem>.telemetry.ts`: the usage telemetry
+middleware. The module exports `telemetry()` and `flush()`, and the application registers
+it with `use(telemetry({ sdkName, sdkVersion, client }))`.
+
 ## Design decisions that must hold
 
 - **Descriptor-driven:** generated code is DATA (`OPERATIONS` + `Ops`) plus wiring;
@@ -26,6 +30,11 @@ relatively (`runtime: module`).
   an entry that `export *`s it; the entry type-imports only the schema names it
   references (`collectEntrySchemaRefs`).
 - **Zero runtime dependencies.** `Date`, `Blob`, `fetch` — nothing else.
+- **Timeouts need no platform statics.** `send()` uses `AbortSignal.timeout()` and
+  `AbortSignal.any()` where they exist and builds the same signal from an `AbortController`
+  and `setTimeout` where they do not (Chrome before 116, Safari before 17.4, Firefox before
+  124). A timed-out attempt is recognized by its own timeout signal having fired, never by
+  the abort reason's name, because Chrome 103 to 123 abort a timeout with `AbortError`.
 - **Names are collision-safe:** `packageIdents` seeds every reserved wiring name before
   any operation is sanitized, so renames are deterministic (`configure` → `configure_2`).
   A rename becomes part of the SDK's public API, so the warning must say WHICH cause it
@@ -56,6 +65,18 @@ relatively (`runtime: module`).
   derives, boundary included), `send()` sets the operation's declared content type only
   when the caller set none, the same rule the JSON branch already follows. A forwarded
   multipart boundary therefore survives, and a binary upload is never sent untyped.
+- **`onSettled` sees every sent call once.** `send()` calls it after the last attempt
+  with the final response, the error, or both, the attempt count, and the duration from
+  the first attempt to the end of the `onResponse` hooks on the final response. A call
+  that fails in `onRequest` or in body serialization does not reach it. A call whose
+  signal is already aborted reaches it with 0 attempts.
+  Every hook runs. The first hook error rejects a successful call; on a failed call, the
+  original error wins.
+- **Telemetry is opt-in at generation time.** Without `telemetry: on`, the output holds
+  no telemetry code, and the client file does not change. An event holds only the
+  operation id, the counts, the window, and the SDK identity. The kill switches and a
+  browser turn the middleware off. The module embeds on its own, not in
+  `RUNTIME_SOURCES`, so `telemetry` and `flush` never become reserved names of a client.
 - **Throw mode returns the body**; `{ envelope: true }` opts into
   `{ data, headers, response }` with typed declared headers. Result mode returns
   `{ data, error, response }` and ignores `envelope`.
@@ -77,6 +98,9 @@ inside the package and reach the generator through
 `@redocly/client-generator/runtime-sources` (in this repo they live in `runtime/` beside
 these files). Naming and string escaping live in the TypeScript printer
 (`@redocly/client-generator/printers/typescript`).
+The telemetry middleware ships the same way, as `TELEMETRY_RUNTIME_SOURCE` (in this repo
+it lives in `telemetry/`); `index.ts` writes it with the contract import pointed at the
+client entry and the generator version baked in.
 
 ## Ejecting it