@redocly/client-generator 0.0.0-snapshot.1787656839 → 0.0.0-snapshot.1787659732

package/README.md

@@ -11,7 +11,7 @@ See https://github.com/Redocly/redocly-cli for the full project.
 The generated client uses only web-standard APIs (`fetch`, `AbortController`, `URLSearchParams`), so by default it is a single self-contained file with zero runtime dependencies that runs in browsers, Node ≥ 18, Bun, Deno, and edge runtimes.
 (Running the generator itself requires the Node version in this package's `engines` field.)
 Code is produced through the TypeScript compiler AST, not string templates; `typescript` is the only peer dependency — optional, needed only when you run generation, and it must be 6.x there (TypeScript 7's native compiler has no compiler API).
-Apps that only consume a generated client don't need it at all, and can compile the generated code with any TypeScript, including 7.
+Apps that only consume a package-runtime client don't need it at all, and can compile the generated code with any TypeScript, including 7.
 
 This package is the engine behind the [`generate-client` command](https://redocly.com/docs/cli/commands/generate-client) — install [`@redocly/cli`](https://www.npmjs.com/package/@redocly/cli) to run it from the command line or `redocly.yaml`.
 How to use the generated client — auth, middleware, retries, pagination, Server-Sent Events, and the add-on generators (`zod`, `tanstack-query`, `swr`, `mock`, `transformers`) — is documented in [Use the generated client](https://redocly.com/docs/cli/guides/use-generated-client).
@@ -27,7 +27,7 @@ import { generateClient } from '@redocly/client-generator';
 const result = await generateClient({
   api: './openapi.yaml', // file path or URL; OpenAPI 3.0/3.1/3.2 or Swagger 2.0
   output: './src/api/client.ts',
-  generators: ['typescript', 'zod'],
+  generators: ['sdk', 'zod'],
 });
 
 console.log(`Wrote ${result.files.length} file(s), ${result.bytes} bytes.`);
@@ -41,7 +41,8 @@ For type-safe authoring of a standalone options object, annotate it with `satisf
 The generated module exports its operation descriptors, so an app can build additional instances with independent configuration and credentials over the same generated code:
 
 ```ts
-import { createClient, OPERATIONS, type Ops } from './client.ts';
+import { createClient } from '@redocly/client-generator';
+import { OPERATIONS, type Ops } from './client.ts';
 
 const internal = createClient<Ops>(OPERATIONS, {
   serverUrl: 'https://api.example.com',
@@ -49,35 +50,48 @@ const internal = createClient<Ops>(OPERATIONS, {
 });
 ```
 
+With `runtime: 'package'` the generated client also imports its whole engine from this package (instead of embedding it), so engine fixes arrive via `npm update` — install this package as a regular dependency of the consuming app.
+
 ### Write a custom generator
 
 A custom generator reads the same API model the built-ins consume, runs in the same pass, and returns files.
-Emitters print text: `Printer` handles indentation, and `tsType` is the same schema→type renderer the built-in sdk uses, so the mapping (refs, arrays, unions, formats, parenthesization) matches the generated client exactly:
+Build real TypeScript with the emit toolkit from `@redocly/client-generator/generate` — the same `ts.factory` + printer the built-in generators use, so the schema→type mapping matches the sdk's exactly:
 
 ```ts
 // response-map-generator.ts
-import { defineGenerator, Printer } from '@redocly/client-generator';
-import { tsType } from '@redocly/client-generator/generate';
+import { defineGenerator } from '@redocly/client-generator';
+import { printStatements, schemaToTypeNode, ts } from '@redocly/client-generator/generate';
+
+const { factory } = ts;
 
 export default defineGenerator({
   name: 'response-map',
-  requires: ['typescript'],
-  run({ model, output }) {
-    const printer = new Printer();
+  requires: ['sdk'],
+  run({ model, outputPath }) {
     // One `ResponseShapes` entry per operation with a JSON success body.
-    printer.block(
-      'export type ResponseShapes = {',
-      () => {
-        for (const service of model.services) {
-          for (const op of service.operations) {
-            const success = op.successResponses.find((r) => r.contentType.includes('json'));
-            if (success) printer.line(`${op.name}: ${tsType(success.schema)};`);
-          }
-        }
-      },
-      '};'
+    const members = model.services
+      .flatMap((service) => service.operations)
+      .flatMap((op) => {
+        const success = op.successResponses.find((r) => r.contentType.includes('json'));
+        if (!success) return [];
+        return [
+          factory.createPropertySignature(
+            undefined,
+            op.name,
+            undefined,
+            schemaToTypeNode(success.schema)
+          ),
+        ];
+      });
+    const alias = factory.createTypeAliasDeclaration(
+      [factory.createModifier(ts.SyntaxKind.ExportKeyword)],
+      'ResponseShapes',
+      undefined,
+      factory.createTypeLiteralNode(members)
     );
-    return [{ path: output.path.replace(/\.ts$/, '.responses.ts'), content: printer.toString() }];
+    return [
+      { path: outputPath.replace(/\.ts$/, '.responses.ts'), content: printStatements([alias]) },
+    ];
   },
 });
 ```
@@ -113,7 +127,7 @@ type GenerateClientResult = {
 ### `collectGeneratedFiles`
 
 Runs the configured generators against a built model and returns the files in memory, without writing to disk.
-Imported from `@redocly/client-generator/generate` — the generation-time entry; the package root stays a small authoring surface:
+Imported from `@redocly/client-generator/generate` — the generation-time entry; the package root stays runtime-only so package-mode clients never load the generator stack:
 
 ```ts
 function collectGeneratedFiles(
@@ -130,16 +144,13 @@ function collectGeneratedFiles(
 
 ### `defineGenerator`
 
-Authors a custom generator (`{ name, run }` plus optional `requires`/`errorModes`/`dateTypes` compatibility metadata, validated up front):
+Authors a custom generator (`{ name, run }` plus optional `requires`/`errorModes`/`dateTypes`/`runtimes` compatibility metadata, validated up front):
 
 ```ts
 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).
+The `@redocly/client-generator/generate` entry also exports the emit toolkit the built-ins use (`ts`, `printStatements`, `parseStatements`, `operationSignature`, `schemaToTypeNode`, `pascalCase`, …), and the package root exports the IR types, so a custom generator emits TypeScript exactly as the first-party ones do — see the [`ast-toolkit-generator` example](https://github.com/Redocly/redocly-cli/tree/main/tests/e2e/generate-client/examples/ast-toolkit-generator).
 
 ### `defineClientSetup`
 
@@ -154,9 +165,20 @@ function defineClientSetup(setup: {
 
 A setup module may import only from `@redocly/client-generator`, so it never adds a dependency to the client (the import is stripped at generation time).
 
+### `createClient`
+
+The runtime factory that `runtime: 'package'` clients import, also usable directly to build extra instances over generated descriptors (see [Basic usage](#build-extra-client-instances)):
+
+```ts
+function createClient<Ops>(
+  operations: Record<string, OperationDescriptor>,
+  config?: ClientConfig
+): Client<Ops>;
+```
+
 ## 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, custom generators, and the package runtime — live in [`tests/e2e/generate-client/examples`](https://github.com/Redocly/redocly-cli/tree/main/tests/e2e/generate-client/examples).
 Each is a standalone Vite app with a checked-in, drift-checked generated client.
 
 ## Documentation
@@ -177,4 +199,4 @@ npm run unit                    # unit tests (this package is held at 100% cover
 VITEST_SUITE=e2e npx vitest run tests/e2e/generate-client/   # behavioral e2e
 ```
 
-Each generator that embeds a runtime keeps its sources in its own folder (`src/generators/<name>/runtime/` — real, unit-testable modules that generation embeds), the IR lives in `src/intermediate-representation/`, and the generators in `src/generators/`.
+The client runtime lives in `src/runtime/` (real, unit-testable modules; package mode imports them, inline mode embeds them), the structural emitters in `src/emitters/`, the IR in `src/intermediate-representation/`, the generators in `src/generators/`, and the file-layout writers in `src/writers/`.

package/lib/emitters/auth.d.ts

@@ -0,0 +1,14 @@
+import type { SecuritySchemeModel } from '../intermediate-representation/model.js';
+/**
+ * Public setter name for an apiKey scheme: `setApiKey` when it's the only apiKey
+ * scheme (of any `in`), else `setApiKey<Key>` to disambiguate.
+ */
+export declare function apiKeySetterName(key: string, sole: boolean): string;
+/**
+ * The public credential-setter names the client exports for a set of schemes,
+ * in emission order (`setBearer`, then `setBasicAuth`, then each apiKey setter).
+ * Also seeds the reserved-identifier set (`packageIdents`) so operation names
+ * can't collide with a setter.
+ */
+export declare function authSetterNames(schemes: SecuritySchemeModel[]): string[];
+//# sourceMappingURL=auth.d.ts.map

package/lib/emitters/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/emitters/auth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAGnF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAWxE"}

package/lib/emitters/auth.js

@@ -0,0 +1,30 @@
+// The auth *naming* conventions of the generated surface. Credential injection itself
+// lives in the runtime (src/runtime/auth.ts); the wiring emitter only derives the
+// public setter names bound to the client instance's `auth` members.
+import { pascalCase } from './support.js';
+/**
+ * Public setter name for an apiKey scheme: `setApiKey` when it's the only apiKey
+ * scheme (of any `in`), else `setApiKey<Key>` to disambiguate.
+ */
+export function apiKeySetterName(key, sole) {
+    return sole ? 'setApiKey' : `setApiKey${pascalCase(key)}`;
+}
+/**
+ * The public credential-setter names the client exports for a set of schemes,
+ * in emission order (`setBearer`, then `setBasicAuth`, then each apiKey setter).
+ * Also seeds the reserved-identifier set (`packageIdents`) so operation names
+ * can't collide with a setter.
+ */
+export function authSetterNames(schemes) {
+    const names = [];
+    if (schemes.some((s) => s.kind === 'bearer'))
+        names.push('setBearer');
+    if (schemes.some((s) => s.kind === 'basic'))
+        names.push('setBasicAuth');
+    const apiKeySchemes = schemes.filter((s) => s.kind === 'apiKeyHeader' || s.kind === 'apiKeyQuery' || s.kind === 'apiKeyCookie');
+    for (const scheme of apiKeySchemes) {
+        names.push(apiKeySetterName(scheme.key, apiKeySchemes.length === 1));
+    }
+    return names;
+}
+//# sourceMappingURL=auth.js.map

package/lib/emitters/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/emitters/auth.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,kFAAkF;AAClF,qEAAqE;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,IAAa;IACzD,OAAO,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAA8B;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACxE,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAC1F,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/emitters/client-assembly.d.ts

@@ -0,0 +1,15 @@
+import { type ApiModel } from '../intermediate-representation/model.js';
+import { type EmitOptions } from './emit-options.js';
+export declare function emitClientSingleFile(model: ApiModel, options?: EmitOptions): string;
+/**
+ * `split` mode: the same client with the schema types + type guards carved out into a
+ * sibling `<stem>.schemas.ts`. The entry file re-exports the schemas module
+ * (`export *`) and type-imports exactly the schema names its own code references, so
+ * both files hold under `noUnusedLocals`. `schemas` is absent when the document
+ * declares no schema statements (the entry is then self-contained).
+ */
+export declare function emitClientSplit(model: ApiModel, options: EmitOptions, stem: string): {
+    entry: string;
+    schemas?: string;
+};
+//# sourceMappingURL=client-assembly.d.ts.map

package/lib/emitters/client-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-assembly.d.ts","sourceRoot":"","sources":["../../src/emitters/client-assembly.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,QAAQ,EAGd,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAU,KAAK,WAAW,EAA8B,MAAM,mBAAmB,CAAC;AA2BzF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAEvF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAErC"}

package/lib/emitters/client-assembly.js

@@ -0,0 +1,358 @@
+// Client assembly, shared by both runtime distributions and both output modes. The
+// wiring (descriptor map + `Ops` interface, emitters/descriptor.ts) is identical; only
+// the runtime block differs — `runtime: 'package'` imports `createClient` from
+// `@redocly/client-generator`, everything else (inline, the default) embeds the
+// assembled runtime sources in its place (emitters/inline-runtime.ts). Single-file
+// layout: runtime (import line | embedded block) → schema types → type guards →
+// `<Op>*` aliases → Ops → OPERATIONS → (baked setup) → client instance → sugar →
+// (package mode only) type re-exports — the embedded types are already exported in
+// place, so the embed arm needs none. Split mode moves the schema types + guards into
+// a sibling `<stem>.schemas.ts` the entry re-exports (`emitClientSplit`).
+import { allOperations, } from '../intermediate-representation/model.js';
+import { apiKeySetterName } from './auth.js';
+import { descriptorStatements, opsInterfaceStatements, packageIdents } from './descriptor.js';
+import { banner, HEADER, renderTitleComment } from './emit-options.js';
+import { codeString, isIdentifier } from './identifier.js';
+import { assembleInlineRuntime } from './inline-runtime.js';
+import { renderOperationAliases, sseAliases } from './operation-aliases.js';
+import { operationSignature } from './operation-signature.js';
+import { computeResponse, errorTypeNodes, isTypedMultipart } from './operation-types.js';
+import { renderArgList } from './operations.js';
+import { resolveModelPagination } from './pagination.js';
+import { responseHeadersTypeLiteral } from './response-headers.js';
+import { isSseOp } from './sse.js';
+import { pascalCase } from './support.js';
+import { arrow, exportConstStatement, parseStatements, printNodes, printStatements, ts, typedArrow, } from './ts.js';
+import { typeGuardStatements } from './type-guards.js';
+import { typesStatements } from './types.js';
+const { factory } = ts;
+const PACKAGE_SPECIFIER = '@redocly/client-generator';
+export function emitClientSingleFile(model, options = {}) {
+    return emitClient(model, options).entry;
+}
+/**
+ * `split` mode: the same client with the schema types + type guards carved out into a
+ * sibling `<stem>.schemas.ts`. The entry file re-exports the schemas module
+ * (`export *`) and type-imports exactly the schema names its own code references, so
+ * both files hold under `noUnusedLocals`. `schemas` is absent when the document
+ * declares no schema statements (the entry is then self-contained).
+ */
+export function emitClientSplit(model, options, stem) {
+    return emitClient(model, options, stem);
+}
+/** The shared assembly; `splitStem` (when given) selects the two-file split layout. */
+function emitClient(model, options, splitStem) {
+    const embed = options.runtime !== 'package';
+    const ops = allOperations(model.services);
+    const idents = packageIdents(model);
+    // Resolved (and VERIFIED) up front: an explicit rule that doesn't fit throws here,
+    // before any statement is built — one aggregated error for the whole model.
+    const pagination = resolveModelPagination(model, options.pagination);
+    const ctx = {
+        argsStyle: options.argsStyle ?? 'flat',
+        errorMode: options.errorMode ?? 'throw',
+        dateType: options.dateType ?? 'string',
+        schemaNames: new Set(model.schemas.map((s) => s.name)),
+        schemas: model.schemas,
+        pagination,
+    };
+    const flat = ctx.argsStyle === 'flat';
+    const hasSse = ops.some(isSseOp);
+    const hasRegular = ops.some((op) => !isSseOp(op));
+    const apiKeySchemes = model.securitySchemes.filter((s) => s.kind === 'apiKeyHeader' || s.kind === 'apiKeyQuery' || s.kind === 'apiKeyCookie');
+    const wiring = ops.length > 0
+        ? [
+            ...opsInterfaceStatements(model, idents, ctx),
+            ...descriptorStatements(model, idents, ctx.dateType, pagination),
+        ]
+        : // A spec with no operations still gets the uniform wiring shape.
+            parseStatements('export type Ops = Record<string, never>;\n' +
+                'export const OPERATIONS = {} as const satisfies Record<string, OperationDescriptor>;');
+    const runtimeSection = embed
+        ? assembleInlineRuntime({
+            multipart: ops.some((op) => op.requestBody && isTypedMultipart(op.requestBody)),
+            // Auth sugar needs schemes; `resolveAuth` fires when a descriptor carries
+            // `security` — a valid spec implies the former, but embed on either.
+            auth: model.securitySchemes.length > 0 || ops.some((op) => op.security.length > 0),
+            sse: hasSse,
+            setup: !!options.setup,
+            paginate: pagination.size > 0,
+        })
+        : importLine(options, ctx, {
+            hasFlatSse: hasSse && flat,
+            hasFlatRegular: hasRegular && flat,
+            hasRegular,
+            hasApiKey: apiKeySchemes.length > 0,
+        });
+    const schemaStatements = [
+        ...typesStatements(model.schemas, ctx.dateType),
+        ...typeGuardStatements(model.schemas),
+    ];
+    const bodyStatements = [...ops.flatMap((op) => aliasStatements(op, ctx)), ...wiring];
+    const sugar = printNodes(sugarStatements(ops, idents, ctx, model.securitySchemes, apiKeySchemes));
+    // Embed mode exports its whole public surface in place; only the package arm re-exports.
+    const reexports = embed ? '' : reexportLines(ctx, hasSse);
+    // Layout puts the reader's OWN API first (types → aliases → Ops → OPERATIONS) and the
+    // machinery after it. In embed mode the runtime block sits between the descriptors and
+    // the `client` initializer — after it for readability, before `client` so every
+    // declaration the module-init call chain touches (hoisted functions AND any future
+    // top-level const) is already evaluated; in package mode the import line leads.
+    if (splitStem === undefined) {
+        return {
+            entry: banner([
+                HEADER,
+                renderTitleComment(model),
+                ...(embed ? [] : [runtimeSection]),
+                printStatements([...schemaStatements, ...bodyStatements]),
+                ...(embed ? [runtimeSection] : []),
+                clientSection(options, ctx, model),
+                sugar,
+                reexports,
+            ]),
+        };
+    }
+    const body = printStatements(bodyStatements);
+    const hasSchemas = schemaStatements.length > 0;
+    return {
+        entry: banner([
+            HEADER,
+            renderTitleComment(model),
+            hasSchemas
+                ? schemaLinks(body + '\n' + sugar, ctx.schemaNames, `./${splitStem}.schemas.${options.importExt ?? 'js'}`)
+                : '',
+            ...(embed ? [] : [runtimeSection]),
+            body,
+            ...(embed ? [runtimeSection] : []),
+            clientSection(options, ctx, model),
+            sugar,
+            reexports,
+        ]),
+        schemas: hasSchemas
+            ? banner([HEADER, renderTitleComment(model), printStatements(schemaStatements)])
+            : undefined,
+    };
+}
+/**
+ * The entry ⇄ schemas linkage of the split layout: a type-only import of exactly the
+ * schema names the entry's own code references, plus the public `export *` re-export.
+ * Referenced names are found by walking the printed entry code's identifiers (an AST
+ * pass over the emitted text, not a substring search — operation JSDoc may mention a
+ * schema name, and importing an unreferenced type would trip `noUnusedLocals`).
+ */
+function schemaLinks(entryCode, schemaNames, specifier) {
+    const referenced = new Set();
+    // Only TYPE references count as uses of the type-only import: a value-position
+    // identifier that happens to share a schema's name (every descriptor's `id:` key,
+    // for a schema named `id`) must not drag the name in — strict consumer lint
+    // configs flag the resulting unused import.
+    const visit = (node) => {
+        if (ts.isTypeReferenceNode(node) && ts.isIdentifier(node.typeName)) {
+            if (schemaNames.has(node.typeName.text))
+                referenced.add(node.typeName.text);
+        }
+        node.forEachChild(visit);
+    };
+    for (const statement of parseStatements(entryCode))
+        visit(statement);
+    const names = [...referenced].sort();
+    const importLine = names.length > 0 ? `import type { ${names.join(', ')} } from '${specifier}';\n` : '';
+    return `${importLine}export * from '${specifier}';`;
+}
+/** The single import from the runtime package — only names the file actually references. */
+function importLine(options, ctx, refs) {
+    const values = ['createClient', ...(options.setup ? ['mergeSetup'] : [])];
+    const types = [
+        ...(options.setup ? ['ClientConfig', 'Middleware'] : []),
+        'OperationDescriptor',
+        // Flat sugar signatures reference the per-call option types.
+        ...(refs.hasFlatRegular ? ['RequestOptions'] : []),
+        // Flat throw-mode sugar return types vary with the inferred request-option type.
+        ...(refs.hasFlatRegular && ctx.errorMode !== 'result' ? ['EnvelopeResult'] : []),
+        // `Ops` wraps results in `Result` in result mode — but only NON-SSE members
+        // (an SSE-only spec would otherwise import it unused and fail noUnusedLocals).
+        ...(ctx.errorMode === 'result' && refs.hasRegular ? ['Result'] : []),
+        ...(refs.hasFlatSse ? ['SseOptions'] : []),
+        // The apiKey sugar closures take a `TokenProvider`.
+        ...(refs.hasApiKey ? ['TokenProvider'] : []),
+    ].sort();
+    const names = [...values, ...types.map((t) => `type ${t}`)].join(', ');
+    return `import { ${names} } from '${PACKAGE_SPECIFIER}';`;
+}
+/** One operation's `<Op>*` aliases — the same emitters and suppression rules as inline mode. */
+function aliasStatements(op, ctx) {
+    const { pathParams } = operationSignature(op);
+    const ordered = pathParams.map((p) => p.param);
+    const identMap = new Map(pathParams.map((p) => [p.param.name, p.ident]));
+    if (isSseOp(op))
+        return sseAliases(op, ordered, identMap, ctx, 'wire');
+    const { responseType } = computeResponse(op.successResponses, ctx.dateType);
+    const errorMembers = ctx.errorMode === 'result' ? errorTypeNodes(op.errorResponses, ctx.dateType) : [];
+    const errorAlias = errorMembers.length > 0 ? `${pascalCase(op.name)}Error` : '';
+    return renderOperationAliases(op, responseType, ordered, identMap, errorAlias, errorMembers, ctx, true, 'wire');
+}
+/** The (optional) baked setup + the default `client` instance. */
+function clientSection(options, ctx, model) {
+    const serverUrl = options.serverUrl ?? model.serverUrl;
+    const fields = [
+        // Always baked when the document declares one: the runtime's fallback is a
+        // relative URL, which Node's fetch rejects.
+        ...(serverUrl !== undefined ? [`serverUrl: ${codeString(serverUrl)}`] : []),
+        ...(ctx.errorMode === 'result' ? ['errorMode: "result"'] : []),
+        // Client identification for API-owner telemetry; the runtime sends it only
+        // outside browsers, and `configure({ clientHeader: false })` disables it.
+        'clientHeader: "redocly-client-generator"',
+    ];
+    const config = fields.length > 0 ? `{ ${fields.join(', ')} }` : '{}';
+    // Precedence, lowest → highest: spec defaults → baked publisher setup → app `configure()`.
+    // The inner merge flattens the setup into a ClientConfig; the outer layers it OVER the
+    // spec defaults (mergeSetup's second argument wins per-field; middleware composes).
+    const configArg = options.setup
+        ? `mergeSetup({ config: ${config} }, mergeSetup(__redoclySetup, {}))`
+        : config;
+    // The trailing type args narrow `ctx.operation` to the spec's literal unions.
+    // `OperationTag` mirrors descriptorStatements' gate: derived only when some
+    // operation is tagged (it would otherwise be `never`); zero-ops specs have no
+    // derived unions at all, so they keep the string defaults.
+    const ops = allOperations(model.services);
+    const hasTags = ops.some((op) => op.tags.length > 0);
+    const typeArgs = ops.length > 0
+        ? `<Ops, OperationId, OperationPath, ${hasTags ? 'OperationTag' : 'string'}>`
+        : '<Ops>';
+    const client = `export const client = createClient${typeArgs}(OPERATIONS, ${configArg});`;
+    if (!options.setup)
+        return client;
+    return ('// ─── Baked-in setup (--setup) ───\n' +
+        `const __redoclySetup: { config?: ClientConfig; middleware?: Middleware[] } = ${options.setup};\n` +
+        client);
+}
+/** Core destructure + per-scheme auth setters + per-operation call sugar. */
+function sugarStatements(ops, idents, ctx, schemes, apiKeySchemes) {
+    const statements = [...parseStatements('export const { configure, use } = client;')];
+    // Auth sugar in `authSetterNames` order: bearer, basic, then each apiKey scheme.
+    // The runtime's auth members close over the instance config (no `this`), so
+    // direct bindings are safe.
+    if (schemes.some((s) => s.kind === 'bearer')) {
+        statements.push(...parseStatements('export const setBearer = client.auth.bearer;'));
+    }
+    if (schemes.some((s) => s.kind === 'basic')) {
+        statements.push(...parseStatements('export const setBasicAuth = client.auth.basic;'));
+    }
+    for (const scheme of apiKeySchemes) {
+        const name = apiKeySetterName(scheme.key, apiKeySchemes.length === 1);
+        statements.push(...parseStatements(`export const ${name} = (value: TokenProvider) => client.auth.apiKey(${codeString(scheme.key)}, value);`));
+    }
+    if (ops.length === 0)
+        return statements;
+    if (ctx.argsStyle === 'grouped') {
+        // Grouped style: the client methods already take the grouped args shape.
+        const names = ops.map((op) => idents.get(op.name)).join(', ');
+        statements.push(...parseStatements(`export const { ${names} } = client;`));
+        return statements;
+    }
+    for (const op of ops)
+        statements.push(flatSugarStatement(op, idents.get(op.name), ctx));
+    return statements;
+}
+/**
+ * One flat one-liner: today's positional signature forwarding to the grouped client
+ * method. Path values are keyed by the WIRE name (the runtime routes
+ * `args[param.name]`); a path param literally named `params`/`body`/`headers` would
+ * collide with the slot keys — a spec-acknowledged runtime-contract limitation.
+ * A paginated operation's arrow is wrapped in `Object.assign(…, { pages, items })`
+ * so the flat sugar preserves the method-attached iterators.
+ * Throw-mode (non-SSE) arrows are generic over `init` so `{ envelope: true }` narrows
+ * the return type to `Envelope<…>` (plain `RequestOptions` would collapse the overload).
+ */
+function flatSugarStatement(op, ident, ctx) {
+    const { pathParams } = operationSignature(op);
+    const params = renderArgList(op, pathParams.map((p) => p.param), new Map(pathParams.map((p) => [p.param.name, p.ident])), ctx);
+    const props = pathParams.map(({ param, ident: paramIdent }) => param.name === paramIdent
+        ? factory.createShorthandPropertyAssignment(paramIdent)
+        : factory.createPropertyAssignment(isIdentifier(param.name) ? param.name : factory.createStringLiteral(param.name), factory.createIdentifier(paramIdent)));
+    if (op.queryParams.length > 0)
+        props.push(factory.createShorthandPropertyAssignment('params'));
+    if (op.requestBody)
+        props.push(factory.createShorthandPropertyAssignment('body'));
+    if (op.headerParams.length > 0) {
+        props.push(factory.createShorthandPropertyAssignment('headers'));
+    }
+    if (op.cookieParams.length > 0) {
+        props.push(factory.createShorthandPropertyAssignment('cookies'));
+    }
+    const call = factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier('client'), ident), undefined, [factory.createObjectLiteralExpression(props, false), factory.createIdentifier('init')]);
+    const fn = ctx.errorMode !== 'result' && !isSseOp(op)
+        ? envelopeAwareFlatArrow(op, params, call, ctx)
+        : arrow(params, call);
+    if (!ctx.pagination?.has(op.name))
+        return exportConstStatement(ident, fn);
+    const methodMember = (name) => factory.createPropertyAssignment(name, factory.createPropertyAccessExpression(factory.createPropertyAccessExpression(factory.createIdentifier('client'), ident), name));
+    return exportConstStatement(ident, factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier('Object'), 'assign'), undefined, [
+        fn,
+        factory.createObjectLiteralExpression([methodMember('pages'), methodMember('items')], false),
+    ]));
+}
+/**
+ * `<I extends RequestOptions | undefined = undefined>(…, init?: I) =>
+ * Promise<EnvelopeResult<Result, Headers, I>>`
+ */
+function envelopeAwareFlatArrow(op, params, call, ctx) {
+    // `renderArgList` always appends `init` last — retype it as optional generic `I`
+    // (no default: `init?: I = {}` is invalid, and `init: I = {}` fails under strict
+    // generic checks). Cast the call's Promise so the conditional return type sticks.
+    const initTyped = [
+        ...params.slice(0, -1),
+        factory.createParameterDeclaration(undefined, undefined, 'init', factory.createToken(ts.SyntaxKind.QuestionToken), factory.createTypeReferenceNode('I')),
+    ];
+    const resultType = flatResultType(op, ctx);
+    const headersType = flatHeadersType(op, ctx);
+    const returnType = factory.createTypeReferenceNode('Promise', [
+        factory.createTypeReferenceNode('EnvelopeResult', [
+            resultType,
+            headersType,
+            factory.createTypeReferenceNode('I'),
+        ]),
+    ]);
+    const typeParam = factory.createTypeParameterDeclaration(undefined, 'I', factory.createUnionTypeNode([
+        factory.createTypeReferenceNode('RequestOptions'),
+        factory.createKeywordTypeNode(ts.SyntaxKind.UndefinedKeyword),
+    ]), factory.createKeywordTypeNode(ts.SyntaxKind.UndefinedKeyword));
+    const castCall = factory.createAsExpression(call, returnType);
+    return typedArrow([typeParam], initTyped, returnType, castCall);
+}
+function flatResultType(op, ctx) {
+    const { responseType } = computeResponse(op.successResponses, ctx.dateType);
+    const resultName = `${pascalCase(op.name)}Result`;
+    return ctx.schemaNames.has(resultName)
+        ? responseType
+        : factory.createTypeReferenceNode(resultName);
+}
+function flatHeadersType(op, ctx) {
+    const headers = op.successResponseHeaders;
+    if (!headers || headers.length === 0) {
+        return factory.createTypeReferenceNode('Record', [
+            factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
+            factory.createKeywordTypeNode(ts.SyntaxKind.NeverKeyword),
+        ]);
+    }
+    const alias = `${pascalCase(op.name)}ResponseHeaders`;
+    return ctx.schemaNames.has(alias)
+        ? responseHeadersTypeLiteral(headers, ctx.schemas)
+        : factory.createTypeReferenceNode(alias);
+}
+/** Public type surface re-exported for single-import DX (plus the `ApiError` class). */
+function reexportLines(ctx, hasSse) {
+    const types = [
+        'ClientConfig',
+        'Envelope',
+        'Middleware',
+        'RequestOptions',
+        ...(ctx.errorMode === 'result' ? ['Result'] : []),
+        ...(hasSse ? ['ServerSentEvent', 'SseOptions'] : []),
+    ].sort();
+    return (
+    // `createClient` is re-exported so package-mode consumers can build additional
+    // instances from the generated module alone — symmetric with inline output.
+    `export { ApiError, createClient, defaultRetryOn, TimeoutError } from '${PACKAGE_SPECIFIER}';\n` +
+        `export type { ${types.join(', ')} } from '${PACKAGE_SPECIFIER}';`);
+}
+//# sourceMappingURL=client-assembly.js.map

package/lib/emitters/client-assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-assembly.js","sourceRoot":"","sources":["../../src/emitters/client-assembly.ts"],"names":[],"mappings":"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"}

package/lib/emitters/descriptor.d.ts

@@ -0,0 +1,22 @@
+import { type ApiModel } from '../intermediate-representation/model.js';
+import type { EmitContext } from './operations.js';
+import type { ModelPagination } from './pagination.js';
+import { ts } from './ts.js';
+import { type DateType } from './types.js';
+/**
+ * Operation-name → emitted-identifier plan. The full reserved set (wiring + imported
+ * bindings + auth sugar, computed from the model FIRST) is seeded before any operation
+ * is sanitized, so collisions rename the operation (`configure` → `configure_2`)
+ * deterministically regardless of document order.
+ */
+export declare function packageIdents(model: ApiModel): Map<string, string>;
+/** `export const OPERATIONS = {…} as const satisfies Record<string, OperationDescriptor>;` + unions. */
+export declare function descriptorStatements(model: ApiModel, idents: Map<string, string>, dateType: DateType, pagination?: ModelPagination): ts.Statement[];
+/**
+ * `export type Ops = { <ident>: { args: …; result: …; kind?: "sse" } }` — the type map
+ * `createClient<Ops>` consumes. A type alias (not an interface) on purpose: aliases get
+ * an implicit index signature, so `Ops` satisfies the runtime's `OpsShape` constraint;
+ * an interface would need an explicit `[key: string]` member.
+ */
+export declare function opsInterfaceStatements(model: ApiModel, idents: Map<string, string>, ctx: EmitContext): ts.Statement[];
+//# sourceMappingURL=descriptor.d.ts.map