@redocly/client-generator 0.6.0 → 0.7.1

package/README.md

@@ -108,7 +108,7 @@ type GenerateClientResult = {
 };
 ```
 
-`GenerateClientOptions` is the options type ([`src/types.ts`](https://github.com/Redocly/redocly-cli/blob/main/packages/client-generator/src/types.ts)) (`api` and `output` required; `outputMode`, `runtime`, `importExt`, `argsStyle`, `errorMode`, `dateType`, `serverUrl`, `mockData`, `mockSeed`, `generators`, `customGenerators`, `options`, `setup`, `pagination`, `queryKeyPrefix`, `goPackage`, `cliOutput`, `codeSamples`, `docs`, `docsFrontmatter` optional) plus an optional resolved Redocly `config` used to load the description.
+`GenerateClientOptions` is the options type ([`src/types.ts`](https://github.com/Redocly/redocly-cli/blob/main/packages/client-generator/src/types.ts)) (`api` and `output` required; `outputMode`, `runtime`, `importExt`, `argsStyle`, `errorMode`, `dateType`, `serverUrl`, `mockData`, `mockSeed`, `generators`, `customGenerators`, `options`, `setup`, `pagination`, `queryKeyPrefix`, `goPackage`, `cliOutput`, `codeSamples`, `docs`, `docsFrontmatter`, `telemetry` optional) plus an optional resolved Redocly `config` used to load the description.
 
 ### `collectGeneratedFiles`
 
@@ -139,7 +139,7 @@ function defineGenerator(generator: CustomGenerator): CustomGenerator;
 The `@redocly/client-generator/generate` entry also exports the TypeScript renderers the built-ins use (`tsType`, `tsJsdoc`, `codeLiteral`, `operationSignature`, `pascalCase`, `safeIdent`).
 The package root exports the IR types plus the language-neutral toolkit.
 A custom generator emits TypeScript exactly as the first-party ones do.
-See the [`typescript-types-generator` example](https://github.com/Redocly/redocly-cli/tree/main/tests/e2e/generate-client/examples/typescript-types-generator).
+See the [`typescript-types-generator` example](https://github.com/Redocly/redocly-cli/tree/main/packages/client-generator/examples/typescript-types-generator).
 
 ### `defineClientSetup`
 
@@ -156,7 +156,7 @@ A setup module may import only from `@redocly/client-generator`, so it never add
 
 ## Examples
 
-Runnable examples — from a zero-install quickstart to middleware, publisher setup, SSE streaming, pagination, and custom generators — live in [`tests/e2e/generate-client/examples`](https://github.com/Redocly/redocly-cli/tree/main/tests/e2e/generate-client/examples).
+Runnable examples — from a zero-install quickstart to middleware, publisher setup, SSE streaming, pagination, and custom generators — live in [`packages/client-generator/examples`](https://github.com/Redocly/redocly-cli/tree/main/packages/client-generator/examples).
 Each is a standalone Vite app with a checked-in, drift-checked generated client.
 
 ## Documentation

package/eject-assets/generators/cli/docs.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.7.1 — the built-in "cli" 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 cli --update`.

package/eject-assets/generators/cli/engine-source.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.7.1 — the built-in "cli" 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 cli --update`.

package/eject-assets/generators/cli/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.7.1 — the built-in "cli" 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 cli --update`.
@@ -86,5 +86,5 @@ export default {
   docs: cliDocs,
   requires: ["typescript","zod"],
   errorModes: ["throw"],
-  requiresGenerator: '^0.6.0',
+  requiresGenerator: '^0.7.1',
 };

package/eject-assets/generators/cli/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.7.1 — the built-in "cli" 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 cli --update`.

package/eject-assets/generators/go/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/go/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/go/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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`.
@@ -332,5 +332,5 @@ export default {
     "argsStyle": "inputs follow the target language's own idiom",
     "importExt": "the generated file has no relative imports"
   },
-  requiresGenerator: '^0.6.0',
+  requiresGenerator: '^0.7.1',
 };

package/eject-assets/generators/go/models.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/go/naming.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/go/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/go/pagination.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/go/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/mock/faker.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/mock/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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.6.0',
+  requiresGenerator: '^0.7.1',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/mock/sample.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/mock/values.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/php/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/php/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/php/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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.6.0',
+  requiresGenerator: '^0.7.1',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/php/naming.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/php/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/php/pagination.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/php/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/python/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/python/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/python/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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.6.0',
+  requiresGenerator: '^0.7.1',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/python/naming.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/python/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/python/pagination.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/python/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/swr/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "swr" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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.6.0',
+  requiresGenerator: '^0.7.1',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "swr" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/tanstack-query/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "tanstack-query" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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.6.0',
+  requiresGenerator: '^0.7.1',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "tanstack-query" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "transformers" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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.6.0',
+  requiresGenerator: '^0.7.1',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "transformers" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/banner.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/index.ts

@@ -1,16 +1,21 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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.6.0',
+  requiresGenerator: '^0.7.1',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/operation-signature.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/operation-types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/response-headers.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/type-guards.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/typescript/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/eject-assets/generators/zod/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "zod" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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.6.0',
+  requiresGenerator: '^0.7.1',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.6.0 — the built-in "zod" generator.
+// Ejected from @redocly/client-generator@0.7.1 — 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/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;
@@ -61,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`.
@@ -82,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
 

package/lib/generators/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/generators/meta.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9F,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,GAAG;IAC/E,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC;CAC3E,CAAC;AAyBF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,CAuF3D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,GAAG,mBAAmB,CAAC,EAG7E,UAAU,CAAC,EAAE,UAAU,GACtB,IAAI,CA6CN"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/generators/meta.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9F,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,GAAG;IAC/E,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC;CAC3E,CAAC;AAyBF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,CAuF3D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,GAAG,mBAAmB,CAAC,EAG7E,UAAU,CAAC,EAAE,UAAU,GACtB,IAAI,CAkDN"}

package/lib/generators/meta.js

@@ -125,6 +125,9 @@ outputMode) {
     if (emit.goPackage !== undefined && !selected.has('go')) {
         logger.warn('generate-client: goPackage is ignored — it declares the Go package clause, and no selected generator uses it (add --generator go).\n');
     }
+    if (emit.telemetry === 'on' && !selected.has('typescript')) {
+        logger.warn('generate-client: telemetry is ignored — the typescript generator writes the telemetry module, and it is not selected (add --generator typescript).\n');
+    }
     const errorMode = emit.errorMode ?? 'throw';
     const dateType = emit.dateType ?? 'string';
     for (const name of names) {