@redocly/client-generator 0.0.0-snapshot.1784554531 → 0.0.0-snapshot.manual

package/lib/emitters/client.d.ts

@@ -0,0 +1,71 @@
+import type { ApiModel } from '../intermediate-representation/model.js';
+import type { ArgsStyle } from './operations.js';
+import type { PaginationConfig } from './pagination.js';
+import type { DateType, EnumStyle } from './types.js';
+export type { ArgsStyle } from './operations.js';
+/** 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 document. Re-run `redocly generate-client` to update.";
+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 document.
+     */
+    serverUrl?: string;
+    /**
+     * How named string enums are emitted:
+     * - `'union'`: only the string-literal union type (`type X = "a" | "b"`).
+     * - `'const-object'` (default): the union type *and* a sibling
+     *   `export const X = { a: "a", b: "b" } as const;` so callers can reference
+     *   the values at runtime (`X.a`).
+     */
+    enumStyle?: EnumStyle;
+    /**
+     * 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;
+    /**
+     * TanStack Query adapter the generated module imports from
+     * (`@tanstack/${queryFramework}-query`). Defaults to `'react'`; the emitted body
+     * is byte-identical across frameworks — only the import specifier changes.
+     */
+    queryFramework?: 'react' | 'vue' | 'svelte' | 'solid';
+    /**
+     * How the `mock` generator produces data. `'baked'` (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?: 'baked' | 'faker';
+    /** Seed for faker-mode mocks: emits a top-level `faker.seed(<n>)` so runs reproduce. */
+    mockSeed?: number;
+    /**
+     * 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, self-contained) | 'package' (imports @redocly/client-generator). */
+    runtime?: 'inline' | 'package';
+    /**
+     * Auto-pagination rules (a convention rule + per-operation overrides + `exclude`),
+     * resolved together with each operation's `x-pagination` extension. Verified
+     * statically: an explicit rule that doesn't fit its operation fails generation.
+     */
+    pagination?: PaginationConfig;
+};
+/**
+ * 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=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/emitters/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAItD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,iEAAiE;AACjE,eAAO,MAAM,MAAM,oJACwD,CAAC;AAE5E,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gHAAgH;IAChH,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEjD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAY1D"}

package/lib/emitters/client.js

@@ -0,0 +1,28 @@
+import { splitLines } from './support.js';
+import { escapeJsDoc } from './ts.js';
+/** The generated-by banner prepended to every emitted module. */
+export const HEADER = `// Generated by @redocly/client-generator — do not edit by hand.
+// Source: OpenAPI document. 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 function banner(sections) {
+    return sections.filter((s) => s.length > 0).join('\n\n') + '\n';
+}
+export function renderTitleComment(model) {
+    // This banner is a raw string (it does not flow through `jsdoc()`), so escape
+    // `*/` here too — `info.title`/`info.description` are attacker-controllable and
+    // would otherwise close the comment and inject code at the top of every file.
+    const lines = [`/**`, ` * ${escapeJsDoc(`${model.title} (v${model.version})`)}`];
+    if (model.description) {
+        for (const line of splitLines(escapeJsDoc(model.description))) {
+            lines.push(` * ${line}`);
+        }
+    }
+    lines.push(' */');
+    return lines.join('\n');
+}
+//# sourceMappingURL=client.js.map

package/lib/emitters/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/emitters/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAOtC,iEAAiE;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG;2EACqD,CAAC;AA0D5E;;;;;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,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { ApiModel } from '../intermediate-representation/model.js';
+import { type EmitOptions } from './client.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=package-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-client.d.ts","sourceRoot":"","sources":["../../src/emitters/package-client.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,QAAQ,EAGT,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAU,KAAK,WAAW,EAA8B,MAAM,aAAa,CAAC;AAqCnF,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/package-client.js

@@ -0,0 +1,300 @@
+// 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 '../writers/util.js';
+import { apiKeySetterName } from './auth.js';
+import { banner, HEADER, renderTitleComment } from './client.js';
+import { descriptorStatements, opsInterfaceStatements, packageIdents } from './descriptor.js';
+import { 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 { isSseOp } from './sse.js';
+import { pascalCase } from './support.js';
+import { arrow, exportConstStatement, parseStatements, printNodes, printStatements, ts, } from './ts.js';
+import { typeGuardStatements } from './type-guards.js';
+import { typesStatements } from './types.js';
+const { factory } = ts;
+const PACKAGE_SPECIFIER = '@redocly/client-generator';
+/**
+ * A double-quoted TS string literal for generated code. `JSON.stringify` alone leaves
+ * U+2028/U+2029 raw (legal JSON, line terminators in code contexts) — escape them so a
+ * hostile spec value can never alter the shape of the emitted statement.
+ */
+function codeString(value) {
+    return JSON.stringify(value)
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+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',
+        queryAuthKeys: new Set(model.securitySchemes.filter((s) => s.kind === 'apiKeyQuery').map((s) => s.key)),
+        schemaNames: new Set(model.schemas.map((s) => s.name)),
+        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, options.enumStyle ?? 'const-object', 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.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();
+    const visit = (node) => {
+        if (ts.isIdentifier(node) && schemaNames.has(node.text))
+            referenced.add(node.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'] : []),
+        // `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"'] : []),
+    ];
+    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.
+ */
+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'));
+    }
+    const call = factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier('client'), ident), undefined, [factory.createObjectLiteralExpression(props, false), factory.createIdentifier('init')]);
+    const fn = 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),
+    ]));
+}
+/** Public type surface re-exported for single-import DX (plus the `ApiError` class). */
+function reexportLines(ctx, hasSse) {
+    const types = [
+        'ClientConfig',
+        '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 } from '${PACKAGE_SPECIFIER}';\n` +
+        `export type { ${types.join(', ')} } from '${PACKAGE_SPECIFIER}';`);
+}
+//# sourceMappingURL=package-client.js.map

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

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

package/lib/writers/index.d.ts

@@ -0,0 +1,5 @@
+import type { OutputMode, Writer } from './types.js';
+export type { GeneratedFile, OutputMode, Writer, WriterInput } from './types.js';
+/** Select the writer for an output mode. */
+export declare function getWriter(mode: OutputMode): Writer;
+//# sourceMappingURL=index.d.ts.map

package/lib/writers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/writers/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAErD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAOjF,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAElD"}

package/lib/writers/index.js

@@ -0,0 +1,11 @@
+import { singleFileWriter } from './single-file-writer.js';
+import { splitWriter } from './split-writer.js';
+const WRITERS = {
+    single: singleFileWriter,
+    split: splitWriter,
+};
+/** Select the writer for an output mode. */
+export function getWriter(mode) {
+    return WRITERS[mode];
+}
+//# sourceMappingURL=index.js.map

package/lib/writers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/writers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,MAAM,OAAO,GAA+B;IAC1C,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE,WAAW;CACnB,CAAC;AAEF,4CAA4C;AAC5C,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}

package/lib/writers/single-file-writer.d.ts

@@ -0,0 +1,8 @@
+import type { Writer } from './types.js';
+/**
+ * The default writer: the whole client in one file at the `--output` path. The shared
+ * emitter branches on `emit.runtime` internally — `inline` (the default) embeds the
+ * runtime sources, `package` imports them from `@redocly/client-generator`.
+ */
+export declare const singleFileWriter: Writer;
+//# sourceMappingURL=single-file-writer.d.ts.map

package/lib/writers/single-file-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-file-writer.d.ts","sourceRoot":"","sources":["../../src/writers/single-file-writer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAE9B,CAAC"}

package/lib/writers/single-file-writer.js

@@ -0,0 +1,10 @@
+import { emitClientSingleFile } from '../emitters/package-client.js';
+/**
+ * The default writer: the whole client in one file at the `--output` path. The shared
+ * emitter branches on `emit.runtime` internally — `inline` (the default) embeds the
+ * runtime sources, `package` imports them from `@redocly/client-generator`.
+ */
+export const singleFileWriter = ({ model, outputPath, emit }) => [
+    { path: outputPath, content: emitClientSingleFile(model, emit) },
+];
+//# sourceMappingURL=single-file-writer.js.map

package/lib/writers/single-file-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-file-writer.js","sourceRoot":"","sources":["../../src/writers/single-file-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGrE;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACvE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE;CACjE,CAAC"}

package/lib/writers/split-writer.d.ts

@@ -0,0 +1,14 @@
+import type { Writer } from './types.js';
+/**
+ * `split` mode: two sibling files derived from the `--output` anchor, for both
+ * runtime distributions.
+ *
+ *   <stem>.schemas.ts  model types, enums, const-objects, and type guards
+ *   <stem>.ts          everything else (runtime, wiring, client, sugar), which
+ *                      `export *`s the schemas module and type-imports exactly
+ *                      the schema names it references
+ *
+ * The schemas file is skipped entirely when the document declares no schemas.
+ */
+export declare const splitWriter: Writer;
+//# sourceMappingURL=split-writer.d.ts.map

package/lib/writers/split-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-writer.d.ts","sourceRoot":"","sources":["../../src/writers/split-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,EAAE,MAOzB,CAAC"}

package/lib/writers/split-writer.js

@@ -0,0 +1,23 @@
+import { join } from 'node:path';
+import { emitClientSplit } from '../emitters/package-client.js';
+import { anchor } from './util.js';
+/**
+ * `split` mode: two sibling files derived from the `--output` anchor, for both
+ * runtime distributions.
+ *
+ *   <stem>.schemas.ts  model types, enums, const-objects, and type guards
+ *   <stem>.ts          everything else (runtime, wiring, client, sugar), which
+ *                      `export *`s the schemas module and type-imports exactly
+ *                      the schema names it references
+ *
+ * The schemas file is skipped entirely when the document declares no schemas.
+ */
+export const splitWriter = ({ model, outputPath, emit }) => {
+    const { dir, stem } = anchor(outputPath);
+    const { entry, schemas } = emitClientSplit(model, emit, stem);
+    return [
+        ...(schemas === undefined ? [] : [{ path: join(dir, `${stem}.schemas.ts`), content: schemas }]),
+        { path: outputPath, content: entry },
+    ];
+};
+//# sourceMappingURL=split-writer.js.map

package/lib/writers/split-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-writer.js","sourceRoot":"","sources":["../../src/writers/split-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;IACjE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9D,OAAO;QACL,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/F,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE;KACrC,CAAC;AACJ,CAAC,CAAC"}

package/lib/writers/types.d.ts

@@ -0,0 +1,31 @@
+import type { EmitOptions } from '../emitters/client.js';
+import type { ApiModel } from '../intermediate-representation/model.js';
+/**
+ * How the generated client is partitioned across files.
+ *
+ * - `single` (default): one self-contained file.
+ * - `split`: schema types + guards in a sibling `<stem>.schemas.ts`; everything
+ *   else in the entry file, which re-exports the schemas module.
+ */
+export type OutputMode = 'single' | 'split';
+/** A single file the generator will write to disk. */
+export type GeneratedFile = {
+    path: string;
+    content: string;
+};
+export type WriterInput = {
+    model: ApiModel;
+    /**
+     * The `--output` anchor path (ends in `.ts`). Multi-file writers derive sibling
+     * and per-tag-folder paths from its directory and base name (stem).
+     */
+    outputPath: string;
+    emit: EmitOptions;
+};
+/**
+ * A Writer turns the IR + emit options into the set of files to write. This is
+ * the one seam output modes vary at; the emitter (which renders code) stays
+ * mode-agnostic.
+ */
+export type Writer = (input: WriterInput) => GeneratedFile[];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/writers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,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,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,aAAa,EAAE,CAAC"}

package/lib/writers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/writers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/writers/types.ts"],"names":[],"mappings":""}

package/lib/writers/util.d.ts

@@ -0,0 +1,14 @@
+import type { OperationModel } from '../intermediate-representation/model.js';
+/**
+ * Derive the directory and base name (stem, without `.ts`) from the `--output`
+ * anchor path. Multi-file writers build sibling/per-tag paths from these.
+ */
+export declare function anchor(outputPath: string): {
+    dir: string;
+    stem: string;
+};
+/** All operations across the model's services, flattened. */
+export declare function allOperations(operationsByService: {
+    operations: OperationModel[];
+}[]): OperationModel[];
+//# sourceMappingURL=util.d.ts.map

package/lib/writers/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/writers/util.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAGxE;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAC3B,mBAAmB,EAAE;IAAE,UAAU,EAAE,cAAc,EAAE,CAAA;CAAE,EAAE,GACtD,cAAc,EAAE,CAElB"}

package/lib/writers/util.js

@@ -0,0 +1,14 @@
+import { parse } from 'node:path';
+/**
+ * Derive the directory and base name (stem, without `.ts`) from the `--output`
+ * anchor path. Multi-file writers build sibling/per-tag paths from these.
+ */
+export function anchor(outputPath) {
+    const { dir, name } = parse(outputPath);
+    return { dir, stem: name };
+}
+/** All operations across the model's services, flattened. */
+export function allOperations(operationsByService) {
+    return operationsByService.flatMap((service) => service.operations);
+}
+//# sourceMappingURL=util.js.map

package/lib/writers/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/writers/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAIlC;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,UAAkB;IACvC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAC3B,mBAAuD;IAEvD,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACtE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/client-generator",
-  "version": "0.0.0-snapshot.1784554531",
+  "version": "0.0.0-snapshot.manual",
   "description": "Generate typed, zero-dependency TypeScript clients (fetch, auth, retries, middleware, SSE) from OpenAPI descriptions.",
   "type": "module",
   "types": "lib/index.d.ts",
@@ -45,7 +45,7 @@
     "Roman Marshevskyi <roman.marshevskyy@redocly.com> (https://redocly.com/)"
   ],
   "dependencies": {
-    "@redocly/openapi-core": "0.0.0-snapshot.1784554531"
+    "@redocly/openapi-core": "2.39.0"
   },
   "peerDependencies": {
     "typescript": ">=5.5.0"