@redocly/client-generator 0.3.7 → 0.4.0

package/lib/generators/types.d.ts

@@ -1,7 +1,84 @@
-import type { EmitOptions } from '../emitters/emit-options.js';
-import type { ErrorMode } from '../emitters/operations.js';
-import type { DateType } from '../emitters/types.js';
-import type { ApiModel } from '../intermediate-representation/model.js';
+import type { DateType } from '../authoring/options.js';
+import type { ApiModel, OperationModel } from '../intermediate-representation/model.js';
+import type { ModelPagination } from '../pagination.js';
+export type { DateType } from '../authoring/options.js';
+/** Error-handling shape of the generated client: throw on non-2xx, or return a result union. */
+export type ErrorMode = 'throw' | 'result';
+/**
+ * How an operation's inputs are passed to the generated call.
+ * - `'flat'` (default): path params spread as positional args, then the
+ *   `params`/`body`/`headers` slots — one exported sugar arrow per operation.
+ * - `'grouped'`: the client methods' own shape — a single `args` object bundling
+ *   every input; the sugar is a plain destructure of the client. The per-call
+ *   `init: RequestOptions` stays a separate trailing argument in both styles.
+ */
+export type ArgsStyle = 'flat' | 'grouped';
+export type EmitOptions = {
+    /**
+     * Override the server URL baked into the generated client config. When omitted,
+     * the value is derived from `servers[0].url` in the source OpenAPI description.
+     */
+    serverUrl?: string;
+    /**
+     * How operation inputs are passed to each call. Defaults to `'flat'`;
+     * `'grouped'` bundles inputs into a single `args` object.
+     */
+    argsStyle?: ArgsStyle;
+    /** Error-handling shape of the generated client. Defaults to `'throw'`. */
+    errorMode?: 'throw' | 'result';
+    /**
+     * How `format: date-time`/`date` string fields are typed. `'string'` (default)
+     * keeps the ISO wire shape; `'Date'` emits a `Date` reference. Opt-in — pair with
+     * the `transformers` generator so the runtime value matches the type.
+     */
+    dateType?: DateType;
+    /**
+     * How the `mock` generator produces data. `'static'` (default) inlines deterministic
+     * literals (zero-dep, contract-faithful); `'faker'` emits `@faker-js/faker` calls for
+     * realistic data — reproducible when `mockSeed` is set. Only the mock module is affected.
+     */
+    mockData?: 'static' | 'faker';
+    /** Seed for faker-mode mocks: emits a top-level `faker.seed(<n>)` so runs reproduce. */
+    mockSeed?: number;
+    /** Leading element for every tanstack-query key — namespaces the cache when several
+     * generated APIs share one QueryClient (operationIds may collide across APIs). */
+    queryKeyPrefix?: string;
+    /**
+     * A pre-baked publisher setup block (from `bakeSetup`) merged into the client's config
+     * via `mergeSetup`. Absent when no `--setup` is given.
+     */
+    setup?: string;
+    /** Runtime distribution: `'inline'` (default) embeds the runtime in the generated
+     * file; `'module'` writes it as real files in a `runtime/` folder beside the client. */
+    runtime?: 'inline' | 'module';
+    /**
+     * Extension used in generated relative import specifiers (the split entry's schemas
+     * re-export and each satellite's sdk import). `'js'` (default) is the tsc/bundler
+     * convention; `'ts'` targets runtimes that resolve specifiers literally, like Node's
+     * built-in type stripping (`node client.ts`).
+     */
+    importExt?: 'js' | 'ts';
+    /**
+     * Package clause of the `go` generator's output. Defaults to `client` — a generated
+     * file usually lands in a package the consumer already owns, so the name is theirs
+     * to choose. An invalid Go package name fails generation.
+     */
+    goPackage?: string;
+    /**
+     * Auto-pagination RESOLVED by the pipeline (fit-verified, one answer per run),
+     * resolved together with each operation's `x-redoclyPagination` extension. Verified
+     * statically: an explicit rule that doesn't fit its operation fails generation.
+     */
+    pagination?: ModelPagination;
+    /**
+     * Also write the reference documentation for what each selected generator emits: one
+     * Markdown page per generator that implements the `docs` hook. One switch for the whole
+     * run, so a new documented language never needs a new flag.
+     */
+    docs?: boolean;
+    /** Emit YAML front matter carrying the title above each documentation page. */
+    docsFrontmatter?: boolean;
+};
 /**
  * How the generated client is partitioned across files.
  *
@@ -16,16 +93,73 @@ export type GeneratedFile = {
     content: string;
 };
 /** The first-party generators the registry knows. */
-export type GeneratorName = 'sdk' | 'zod' | 'tanstack-query' | 'tanstack-query-vue' | 'tanstack-query-svelte' | 'tanstack-query-solid' | 'swr' | 'transformers' | 'mock';
+export type GeneratorName = 'typescript' | 'zod' | 'tanstack-query' | 'tanstack-query-vue' | 'tanstack-query-svelte' | 'tanstack-query-solid' | 'swr' | 'transformers' | 'mock' | 'cli' | 'python' | 'go' | 'php';
+/**
+ * One option a generator accepts: a scalar, a closed set of values, or a list of scalars.
+ * Config values are scalars and lists of scalars, so the schema vocabulary stops there —
+ * nothing a `redocly.yaml` block can express is missing.
+ */
+export type GeneratorOptionSchema = {
+    default?: unknown;
+    description?: string;
+} & ({
+    type: 'string' | 'number' | 'boolean';
+} | {
+    type: 'array';
+    items: {
+        type: 'string' | 'number' | 'boolean';
+    };
+} | {
+    enum: Array<string | number | boolean>;
+});
+/** The options a generator declares, as the JSON Schema subset the config layer validates. */
+export type GeneratorOptionsSchema = {
+    type: 'object';
+    properties: Record<string, GeneratorOptionSchema>;
+    required?: string[];
+    /** Unknown keys are rejected unless this is `true` — a typo'd option is a config bug. */
+    additionalProperties?: boolean;
+};
+/**
+ * The `--output` anchor, parsed once by the pipeline: the full `path`, its `dir`,
+ * the `stem` (base name without the final extension), and the `ext` (with the dot).
+ * Generators derive sibling-file names from these instead of re-parsing the path.
+ */
+export type OutputAnchor = {
+    path: string;
+    dir: string;
+    stem: string;
+    ext: string;
+};
 /** Everything a generator needs to produce its files. */
 export type GeneratorInput = {
     model: ApiModel;
-    /** The `--output` anchor path. */
-    outputPath: string;
+    /** The `--output` anchor, parsed (see `OutputAnchor`). */
+    output: OutputAnchor;
+    /**
+     * The generated-by banner lines, free of comment markers — each generator prepends
+     * them in its own comment syntax, so every emitted file says the same thing.
+     */
+    banner: string[];
+    /**
+     * Pagination resolved ONCE by the pipeline — per-op config > `x-redoclyPagination` >
+     * convention, fit-verified, pointers resolved — keyed by operation name. Generators
+     * read this instead of re-resolving, so two of them cannot disagree about whether an
+     * operation paginates.
+     */
+    pagination?: ModelPagination;
     /** File partitioning the generator should honor. */
     outputMode: OutputMode;
     /** Emit options — serverUrl, runtime, and the generator knobs (dateType, mockData, …); see `EmitOptions`. */
     emit: EmitOptions;
+    /** Every generator name in the run — lets a generator adapt to co-selection (cli wires zod validation when `zod` is selected). */
+    selected?: string[];
+    /**
+     * This generator's own options from `client.options.<name>`, already validated against
+     * the schema it declares with defaults applied — a generator reads them without re-checking.
+     * Empty when the generator declares no options.
+     */
+    options?: Record<string, unknown>;
 };
 /**
  * A Generator turns the IR + options into a set of files. Each lives behind a
@@ -33,25 +167,62 @@ export type GeneratorInput = {
  * through the plugin API (see `CustomGenerator`).
  */
 export type Generator = (input: GeneratorInput) => GeneratedFile[];
+/** One idiomatic call snippet for an operation, rendered for docs (`x-codeSamples`). */
+export type CodeSample = {
+    lang: string;
+    label?: string;
+    source: string;
+};
+/**
+ * What a `sample` hook receives besides the operation. `outputPath` is the `--output`
+ * anchor: a snippet has to import the module this run actually writes, and each language
+ * derives that name from the anchor its own way (`openapi.client.ts` becomes
+ * `openapi_client.py`), so a hardcoded module name is wrong for most stems.
+ */
+export type SampleContext = {
+    model: ApiModel;
+    emit: EmitOptions;
+    outputPath: string;
+    /** The run's resolved pagination (see `GeneratorInput.pagination`). */
+    pagination?: ModelPagination;
+};
 /**
  * A generator plus its declared compatibility contract. `validateGenerators`
  * checks these *before* anything is emitted, so an incompatible selection fails
  * fast with an actionable message instead of producing a client that won't compile.
  *
  * - `requires`: other generators that must also be selected (e.g. `tanstack-query`
- *   imports the sdk's operation functions, so it requires `sdk`).
- * - `errorModes` / `dateTypes` / `runtimes`: the subset this generator supports;
+ *   imports the client's operation functions, so it requires `typescript`).
+ * - `errorModes` / `dateTypes`: the subset this generator supports;
  *   `undefined` means "all". (`tanstack-query` wraps throw-mode functions, so it
- *   supports only `throw` mode; `transformers` only type-checks when the sdk types
+ *   supports only `throw` mode; `transformers` only type-checks when the client types
  *   date fields as `Date`, so it supports only `dateType: 'Date'`.)
  */
 export type GeneratorDescriptor = {
     run: Generator;
+    /** The options this generator accepts, validated before `run` (see `GeneratorOptionsSchema`). */
+    options?: GeneratorOptionsSchema;
+    /** Optional: one idiomatic call snippet per operation for docs (`x-codeSamples`);
+     * collected into an overlay when `codeSamples` is enabled. Return undefined to skip. */
+    sample?: (operation: OperationModel, ctx: SampleContext) => CodeSample | undefined;
+    /**
+     * Optional: the reference documentation for what `run` emits — a Markdown page per
+     * generated artifact, returned like `run`'s files. Called only when `client.docs` (or
+     * `--docs`) is on, so documentation is one switch for the whole run instead of a
+     * generator name per language. A generator documents ITSELF: nothing else knows its
+     * call syntax, and ejecting the generator takes its page with it.
+     */
+    docs?: Generator;
     requires?: string[];
     errorModes?: ErrorMode[];
     dateTypes?: DateType[];
-    /** Runtime modes this generator supports; absent = compatible with both. */
-    runtimes?: ('inline' | 'package')[];
+    /**
+     * Options this generator does not apply, mapped to the reason it doesn't. Setting
+     * one explicitly warns instead of being silently dropped — a global option
+     * (`outputMode`, `runtime`, …) may be meaningful for one selected generator and
+     * meaningless for another, so this informs rather than rejects.
+     */
+    notApplicable?: Partial<Record<keyof EmitOptions | 'outputMode', string>>;
 };
 /**
  * A user-authored generator (the public, experimental plugin contract): a `GeneratorDescriptor`
@@ -62,5 +233,12 @@ export type GeneratorDescriptor = {
 export type CustomGenerator = GeneratorDescriptor & {
     /** Unique name, used in `generators` selection, `requires`, and collision detection. */
     name: string;
+    /**
+     * The `@redocly/client-generator` version range this module was written against —
+     * `^1.2.0`, `~1.2.0`, `>=1.2.0`, or an exact version. A CLI outside the range is
+     * rejected at resolve time with the fix path; omitting it accepts the generator as
+     * current (friction-free hand authoring). Ejected generators carry it automatically.
+     */
+    requiresGenerator?: string;
 };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generators/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5C,sDAAsD;AACtD,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,qDAAqD;AACrD,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,KAAK,GACL,gBAAgB,GAChB,oBAAoB,GACpB,uBAAuB,GACvB,sBAAsB,GACtB,KAAK,GACL,cAAc,GACd,MAAM,CAAC;AAEX,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,UAAU,CAAC;IACvB,6GAA6G;IAC7G,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,aAAa,EAAE,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,SAAS,CAAC;IAGf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG;IAClD,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generators/types.ts"],"names":[],"mappings":"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"}

package/lib/generators/typescript/banner.d.ts

@@ -0,0 +1,12 @@
+import type { ApiModel } from '@redocly/client-generator';
+/** The generated-by banner prepended to every emitted module. */
+export declare const HEADER = "// Generated by @redocly/client-generator \u2014 do not edit by hand.\n// Source: OpenAPI description. Re-run `redocly generate-client` to update.";
+/**
+ * Assemble file content from a header banner and a printed body: the leading
+ * `// Generated by …` comment and the `/** title *​/` block are structural
+ * banners (not part of the printed AST), prepended with blank-line separation.
+ * Trailing newline mirrors a hand-authored file.
+ */
+export declare function banner(sections: string[]): string;
+export declare function renderTitleComment(model: ApiModel): string;
+//# sourceMappingURL=banner.d.ts.map

package/lib/generators/typescript/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../../src/generators/typescript/banner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,iEAAiE;AACjE,eAAO,MAAM,MAAM,uJAC2D,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEjD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAa1D"}

package/lib/{emitters/emit-options.js → generators/typescript/banner.js}

@@ -1,5 +1,4 @@
-import { splitLines } from './support.js';
-import { escapeJsDoc } from './ts.js';
+import { escapeJsDoc, splitLines } from '@redocly/client-generator/printers/typescript';
 /** The generated-by banner prepended to every emitted module. */
 export const HEADER = `// Generated by @redocly/client-generator — do not edit by hand.
 // Source: OpenAPI description. Re-run \`redocly generate-client\` to update.`;
@@ -26,4 +25,4 @@ export function renderTitleComment(model) {
     lines.push(' */');
     return lines.join('\n');
 }
-//# sourceMappingURL=emit-options.js.map
+//# sourceMappingURL=banner.js.map

package/lib/generators/typescript/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../../src/generators/typescript/banner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAExF,iEAAiE;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG;8EACwD,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,QAAkB;IACvC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAe;IAChD,8EAA8E;IAC9E,gFAAgF;IAChF,8EAA8E;IAC9E,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,MAAM,WAAW,CAAC,GAAG,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YAC9D,kFAAkF;YAClF,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/lib/generators/typescript/client.d.ts

@@ -0,0 +1,25 @@
+import { type ApiModel, type EmitOptions } from '@redocly/client-generator';
+import { type InlineRuntimeNeeds } from './inline-runtime.ts';
+export declare function emitClientSingleFile(model: ApiModel, options?: EmitOptions): string;
+/** Which optional runtime capabilities this API needs (drives both distribution modes). */
+export declare function runtimeNeeds(model: ApiModel, options: EmitOptions): InlineRuntimeNeeds;
+/**
+ * `runtime: 'module'`: the runtime files written into `runtime/` beside the client —
+ * the raw per-needs modules plus the generated factory, each under the standard banner.
+ */
+export declare function emitRuntimeFiles(model: ApiModel, options: EmitOptions): Array<{
+    name: string;
+    content: 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.d.ts.map

package/lib/generators/typescript/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/generators/typescript/client.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,WAAW,EAEjB,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,qBAAqB,CAAC;AAW7B,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAEvF;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,kBAAkB,CAWtF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,WAAW,GACnB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAK1C;AAqBD;;;;;;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/generators/typescript/client.js

@@ -0,0 +1,207 @@
+// Client assembly, shared by both output modes. The generated file embeds the
+// assembled runtime sources (./inline-runtime.ts). Single-file layout:
+// schema types → type guards → `<Op>*` aliases → Ops → OPERATIONS → embedded
+// runtime → (baked setup) → client instance → sugar — the embedded types are
+// already exported in place, so no re-exports. Split mode moves the schema types +
+// guards into a sibling `<stem>.schemas.ts` the entry re-exports (`emitClientSplit`).
+// Text templates throughout — no `typescript` at generate time.
+import { allOperations, } from '@redocly/client-generator';
+import { codeString } from '@redocly/client-generator/printers/typescript';
+import { banner, HEADER, renderTitleComment } from "./banner.js";
+import { packageIdents, renderDescriptors } from "./descriptor.js";
+import { assembleInlineRuntime, runtimeModuleFiles, } from "./inline-runtime.js";
+import { isTypedMultipart } from "./operation-types.js";
+import { collectEntrySchemaRefs, renderAliases, renderOpsType, } from "./operations.js";
+import { renderTypeGuards } from "./type-guards.js";
+import { renderTypeAliases } from "./types.js";
+export function emitClientSingleFile(model, options = {}) {
+    return emitClient(model, options).entry;
+}
+/** Which optional runtime capabilities this API needs (drives both distribution modes). */
+export function runtimeNeeds(model, options) {
+    const ops = allOperations(model.services);
+    return {
+        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: ops.some((op) => op.sse !== undefined),
+        setup: !!options.setup,
+        paginate: (options.pagination ?? new Map()).size > 0,
+    };
+}
+/**
+ * `runtime: 'module'`: the runtime files written into `runtime/` beside the client —
+ * the raw per-needs modules plus the generated factory, each under the standard banner.
+ */
+export function emitRuntimeFiles(model, options) {
+    if (options.runtime !== 'module')
+        return [];
+    return runtimeModuleFiles(runtimeNeeds(model, options), options.importExt ?? 'js').map(({ name, content }) => ({ name, content: `${HEADER}\n\n${content.trim()}\n` }));
+}
+/**
+ * The module-mode replacement for the embedded block: the entry imports what its own
+ * code references and re-exports the factory's public surface (the same names the
+ * inline embed leaves in module scope).
+ */
+function runtimeImports(options, ctx, hasOps) {
+    const ext = options.importExt ?? 'js';
+    const typeNames = [
+        'OperationDescriptor',
+        ...(options.setup ? ['ClientConfig', 'Middleware'] : []),
+        ...(ctx.errorMode === 'result' && hasOps ? ['Result'] : []),
+    ].sort();
+    return [
+        `import { createClient${options.setup ? ', mergeSetup' : ''} } from './runtime/factory.${ext}';`,
+        `import type { ${typeNames.join(', ')} } from './runtime/types.${ext}';`,
+        `export * from './runtime/factory.${ext}';`,
+    ].join('\n');
+}
+/**
+ * `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 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 = options.pagination ?? new Map();
+    const ctx = {
+        argsStyle: options.argsStyle ?? 'grouped',
+        errorMode: options.errorMode ?? 'throw',
+        dateType: options.dateType ?? 'string',
+        schemaNames: new Set(model.schemas.map((s) => s.name)),
+        schemas: model.schemas,
+        pagination,
+    };
+    const wiring = ops.length > 0
+        ? [
+            renderOpsType(model, idents, ctx),
+            renderDescriptors(model, idents, ctx.dateType, pagination, ctx.argsStyle),
+        ]
+        : // A spec with no operations still gets the uniform wiring shape.
+            [
+                'export type Ops = Record<string, never>;',
+                'export const OPERATIONS = {} as const satisfies Record<string, OperationDescriptor>;',
+            ];
+    const runtimeSection = options.runtime === 'module'
+        ? runtimeImports(options, ctx, ops.length > 0)
+        : assembleInlineRuntime(runtimeNeeds(model, options));
+    const schemaSection = [
+        renderTypeAliases(model.schemas, ctx.dateType),
+        renderTypeGuards(model.schemas),
+    ]
+        .filter((section) => section.length > 0)
+        .join('\n\n');
+    const bodySection = [...ops.map((op) => renderAliases(op, ctx)), ...wiring]
+        .filter((section) => section.length > 0)
+        .join('\n\n');
+    const sugar = sugarSection(ops, idents);
+    // Layout puts the reader's OWN API first (types → aliases → Ops → OPERATIONS) and the
+    // machinery after it. 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.
+    const moduleMode = options.runtime === 'module';
+    if (splitStem === undefined) {
+        return {
+            entry: banner([
+                HEADER,
+                renderTitleComment(model),
+                ...(moduleMode ? [runtimeSection] : []),
+                [schemaSection, bodySection].filter((section) => section.length > 0).join('\n\n'),
+                ...(moduleMode ? [] : [runtimeSection]),
+                clientSection(options, ctx, model),
+                sugar,
+            ]),
+        };
+    }
+    const hasSchemas = schemaSection.length > 0;
+    return {
+        entry: banner([
+            HEADER,
+            renderTitleComment(model),
+            ...(moduleMode ? [runtimeSection] : []),
+            hasSchemas
+                ? schemaLinks(model, ctx, `./${splitStem}.schemas.${options.importExt ?? 'js'}`)
+                : '',
+            bodySection,
+            ...(moduleMode ? [] : [runtimeSection]),
+            clientSection(options, ctx, model),
+            sugar,
+        ]),
+        schemas: hasSchemas ? banner([HEADER, renderTitleComment(model), schemaSection]) : undefined,
+    };
+}
+/**
+ * The entry ⇄ schemas linkage of the split layout: a type-only import of exactly the
+ * schema names the entry's own code references (derived from the IR — the same
+ * sources the alias/Ops renderers type), plus the public `export *` re-export.
+ */
+function schemaLinks(model, ctx, specifier) {
+    const names = collectEntrySchemaRefs(model, ctx);
+    const importLine = names.length > 0 ? `import type { ${names.join(', ')} } from '${specifier}';\n` : '';
+    return `${importLine}export * from '${specifier}';`;
+}
+/** 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"'] : []),
+        // The runtime converts a merged call to the namespaced shape, so it has to know
+        // which style this module's types promise.
+        ...(ctx.argsStyle === 'flat' ? ['argsStyle: "flat"'] : []),
+        // 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 the descriptor block's 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 sugarSection(ops, idents) {
+    // Credentials go through `configure({ auth })` or `client.auth.*` — one way per act.
+    // Per-scheme setters used to be exported here too, which gave the same act three
+    // spellings and a name per scheme that operation names then had to avoid.
+    const lines = ['export const { configure, use } = client;'];
+    if (ops.length === 0)
+        return lines.join('\n');
+    // Bindings, never wrappers: `updateOrder` IS `client.updateOrder`, so importing the name
+    // and reaching through the instance cannot disagree about the arguments. `argsStyle`
+    // shapes the method itself, which is why one binding serves both styles.
+    const names = ops.map((op) => idents.get(op.name)).join(', ');
+    lines.push(`export const { ${names} } = client;`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=client.js.map

package/lib/generators/typescript/client.js.map

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

package/lib/generators/typescript/descriptor.d.ts

@@ -0,0 +1,11 @@
+import { type ApiModel, type ArgsStyle, type DateType, type ModelPagination } from '@redocly/client-generator';
+/**
+ * Operation-name → emitted-identifier plan. The full reserved set (wiring + imported
+ * bindings, 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 …` + the derived unions. */
+export declare function renderDescriptors(model: ApiModel, idents: Map<string, string>, dateType: DateType, pagination?: ModelPagination, argsStyle?: ArgsStyle): string;
+//# sourceMappingURL=descriptor.d.ts.map

package/lib/generators/typescript/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../src/generators/typescript/descriptor.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,eAAe,EAMrB,MAAM,2BAA2B,CAAC;AAQnC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKlE;AAyDD,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,EAAE,QAAQ,EAClB,UAAU,CAAC,EAAE,eAAe,EAC5B,SAAS,GAAE,SAAqB,GAC/B,MAAM,CAiCR"}