@redocly/client-generator 0.3.8 → 0.4.0

package/lib/generators/cli/docs.js

@@ -0,0 +1,187 @@
+// The cli-docs emitter: renders the Markdown reference for the generated CLI from the
+// SAME command table `runCli` dispatches on, and the same `groupSlug`/`constantCase` the
+// runtime addresses groups and reads credentials with. A second model would drift from
+// the tool the first time either side changed.
+import { constantCase, groupSlug, Printer, } from '@redocly/client-generator';
+/** Table-cell-safe text: one line, and pipes/backslashes escaped so they don't alter columns/escaping. */
+function cell(text) {
+    return (text ?? '').replace(/\s+/g, ' ').trim().replace(/\\/g, '\\\\').replace(/\|/g, '\\|');
+}
+/** How a command is typed at the prompt: `<group-slug> <name>`, or just `<name>`. */
+function address(command) {
+    return [command.group === undefined ? undefined : groupSlug(command.group), command.name]
+        .filter(Boolean)
+        .join(' ');
+}
+function usageLine(name, command) {
+    const words = [
+        name,
+        address(command),
+        ...command.positionals.map((positional) => `<${positional.name}>`),
+        ...command.flags.filter((flag) => flag.required).map((flag) => `--${flag.name} <${flag.type}>`),
+        ...(command.body ? [command.body.required ? "--json '<json>'" : "[--json '<json>']"] : []),
+    ];
+    return words.filter((word) => word !== '').join(' ');
+}
+function writeFlagTable(printer, flags) {
+    printer.line('| Flag | Type | Required | Description |');
+    printer.line('| ---- | ---- | -------- | ----------- |');
+    for (const flag of flags) {
+        const description = [
+            cell(flag.description),
+            flag.enum === undefined
+                ? ''
+                : `One of ${flag.enum.map((value) => `\`${value}\``).join(', ')}.`,
+            flag.type === 'array' ? 'Repeat the flag for multiple values.' : '',
+        ]
+            .filter((part) => part !== '')
+            .join(' ');
+        printer.line(`| \`--${flag.name}\` | ${flag.type} | ${flag.required ? 'yes' : 'no'} | ${description} |`);
+    }
+    printer.blank();
+}
+function writeCommand(printer, command, options) {
+    printer.line(`### \`${address(command)}\``);
+    printer.blank();
+    if (command.summary !== undefined) {
+        printer.line(cell(command.summary));
+        printer.blank();
+    }
+    printer.line(`\`${command.method} ${command.path}\``);
+    printer.blank();
+    printer.line('```sh');
+    printer.line(usageLine(options.name, command));
+    printer.line('```');
+    printer.blank();
+    if (command.positionals.length > 0) {
+        printer.line('| Argument | Description |');
+        printer.line('| -------- | ----------- |');
+        for (const positional of command.positionals) {
+            printer.line(`| \`<${positional.name}>\` | ${cell(positional.description)} |`);
+        }
+        printer.blank();
+    }
+    if (command.flags.length > 0)
+        writeFlagTable(printer, command.flags);
+    const notes = [
+        command.body === undefined
+            ? ''
+            : `Takes a JSON body${command.body.required ? ' (required)' : ''}: \`--json '<json>'\`, \`--json @file.json\`, or \`--json @-\` for stdin.`,
+        command.unsupportedBody === undefined
+            ? ''
+            : `Takes a \`${command.unsupportedBody}\` body, which the CLI cannot build — call this operation through the generated client instead.`,
+        command.paginated === true
+            ? 'Paginated: `--page-all` follows every page, printing one JSON page per line.'
+            : '',
+        command.sse === true ? 'Streams server-sent events as one JSON object per line.' : '',
+        command.blob === true ? 'Returns binary content, so `--output <path>` is required.' : '',
+    ].filter((note) => note !== '');
+    for (const note of notes)
+        printer.line(note);
+    if (notes.length > 0)
+        printer.blank();
+}
+/** The whole page: heading, global flags, credentials, exit codes, then every command. */
+export function renderCliDocs(commands, options) {
+    const printer = new Printer();
+    if (options.frontmatter) {
+        printer.line('---');
+        printer.line(`title: ${options.title}`);
+        printer.line('---');
+        printer.blank();
+    }
+    printer.line(`# ${options.title}`);
+    printer.blank();
+    printer.line(`Generated command-line reference for \`${options.name}\`, produced from the API description by \`redocly generate-client\`.`);
+    printer.line('Re-run generation to update it — this file is not hand-edited.');
+    printer.blank();
+    printer.line('## Usage');
+    printer.blank();
+    printer.line('```sh');
+    printer.line(`${options.name} <command> [flags]`);
+    printer.line(`${options.name} --help`);
+    printer.line(`${options.name} schema <command>   # request/response schemas`);
+    printer.line('```');
+    printer.blank();
+    printer.line('Install the file under any `bin` name: the command takes that name, and the credential variables below do not change.');
+    printer.blank();
+    printer.line('## Global flags');
+    printer.blank();
+    printer.line('| Flag | Description |');
+    printer.line('| ---- | ----------- |');
+    // `--token` mirrors the CLI itself: without a bearer scheme the tool rejects the flag,
+    // so the reference must not list it.
+    const hasBearer = options.schemes.some((scheme) => scheme.kind === 'bearer');
+    for (const [flag, description] of [
+        ['--server-url <url>', 'Override the server URL included in the client.'],
+        ['--format <json\\|ndjson>', 'Output format.'],
+        ['--dry-run', 'Print the prepared request, credentials redacted, without sending it.'],
+        ['--page-all', 'Follow pagination, printing one JSON page per line.'],
+        ['--output <path>', 'Write the response body to a file. Required for binary responses.'],
+        ...(hasBearer ? [['--token <token>', 'Bearer token, overriding the environment.']] : []),
+        ['--json <json\\|@file\\|@->', 'Request body, inline or from a file or stdin.'],
+    ]) {
+        printer.line(`| \`${flag}\` | ${description} |`);
+    }
+    printer.blank();
+    const prefix = constantCase(options.name);
+    printer.line('## Credentials');
+    printer.blank();
+    if (options.schemes.length === 0) {
+        printer.line('The description declares no security schemes, so no credentials are read.');
+    }
+    else {
+        printer.line('Credentials come from the environment:');
+        printer.blank();
+        printer.line('| Scheme | Variable |');
+        printer.line('| ------ | -------- |');
+        for (const scheme of options.schemes) {
+            const variable = scheme.kind === 'bearer'
+                ? `\`${prefix}_TOKEN\` (or \`--token\`)`
+                : scheme.kind === 'basic'
+                    ? `\`${prefix}_USERNAME\` and \`${prefix}_PASSWORD\``
+                    : `\`${prefix}_API_KEY_${constantCase(scheme.key)}\``;
+            printer.line(`| ${scheme.kind} (\`${scheme.key}\`) | ${variable} |`);
+        }
+    }
+    printer.blank();
+    printer.line('## Exit codes');
+    printer.blank();
+    printer.line('| Code | Meaning |');
+    printer.line('| ---- | ------- |');
+    for (const [code, meaning] of [
+        [0, 'success'],
+        [1, 'API error (status other than 401 or 403)'],
+        [2, 'auth error (401 or 403)'],
+        [3, 'validation error'],
+        [4, 'usage error (unknown command or flag, bad `--json`)'],
+    ]) {
+        printer.line(`| ${code} | ${meaning} |`);
+    }
+    printer.blank();
+    printer.line('Errors print one JSON object to stderr, so stdout stays clean for piping.');
+    printer.blank();
+    // One section per tag, in the order the description declares them, then the untagged
+    // commands — the same order `--help` lists them in.
+    const groups = [...new Set(commands.map((command) => command.group))];
+    for (const group of groups) {
+        const inGroup = commands.filter((command) => command.group === group);
+        if (group === undefined) {
+            printer.line('## Commands');
+            printer.blank();
+        }
+        else {
+            printer.line(`## ${group}`);
+            printer.blank();
+            printer.line(`Addressed as \`${options.name} ${groupSlug(group)} <command>\`.`);
+            printer.blank();
+        }
+        for (const command of inGroup)
+            writeCommand(printer, command, options);
+    }
+    return (printer
+        .toString()
+        .replace(/\n{3,}/g, '\n\n')
+        .trimEnd() + '\n');
+}
+//# sourceMappingURL=docs.js.map

package/lib/generators/cli/docs.js.map

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

package/lib/generators/cli/engine-source.d.ts

@@ -0,0 +1,5 @@
+/** The cli engine (`runCli` + types) stripped for embedding into `<stem>.cli.ts`. */
+export declare function embedCliRuntime(): string;
+/** The cli engine RAW, for `runtime: 'module'` (written as `runtime/cli.ts`). */
+export declare function cliRuntimeSource(): string;
+//# sourceMappingURL=engine-source.d.ts.map

package/lib/generators/cli/engine-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-source.d.ts","sourceRoot":"","sources":["../../../src/generators/cli/engine-source.ts"],"names":[],"mappings":"AAQA,qFAAqF;AACrF,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/lib/generators/cli/engine-source.js

@@ -0,0 +1,12 @@
+// The cli engine's embeddable source, snapshotted at prepare time (see
+// scripts/generate-runtime-sources.mjs).
+import { RUNTIME_SOURCES, RUNTIME_SOURCES_STRIPPED, } from '@redocly/client-generator/runtime-sources';
+/** The cli engine (`runCli` + types) stripped for embedding into `<stem>.cli.ts`. */
+export function embedCliRuntime() {
+    return RUNTIME_SOURCES_STRIPPED['cli.ts'];
+}
+/** The cli engine RAW, for `runtime: 'module'` (written as `runtime/cli.ts`). */
+export function cliRuntimeSource() {
+    return RUNTIME_SOURCES['cli.ts'];
+}
+//# sourceMappingURL=engine-source.js.map

package/lib/generators/cli/engine-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-source.js","sourceRoot":"","sources":["../../../src/generators/cli/engine-source.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yCAAyC;AAEzC,OAAO,EACL,eAAe,EACf,wBAAwB,GACzB,MAAM,2CAA2C,CAAC;AAEnD,qFAAqF;AACrF,MAAM,UAAU,eAAe;IAC7B,OAAO,wBAAwB,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/lib/generators/cli/index.d.ts

@@ -0,0 +1,18 @@
+import { type CodeSample, type Generator, type OperationModel, type SampleContext } from '@redocly/client-generator';
+/**
+ * The cli generator: a bin-ready `<stem>.cli.ts` — a zero-dependency, typed
+ * command-line interface over the sibling client (typed flags, `--json`
+ * bodies, env auth, `--page-all`, SSE/blob output, a documented exit-code
+ * contract). Requires `typescript` (throw mode); wires zod validation when co-selected.
+ */
+export declare const cliGenerator: Generator;
+/**
+ * The CLI's own reference page, written when `client.docs` is on: the usage line, the
+ * global flags, the credential variables, the exit codes, and one section per command.
+ * It renders from `commandData` — the same table `runCli` dispatches on — so the page
+ * cannot describe a tool other than the one beside it.
+ */
+export declare const cliDocs: Generator;
+/** One shell invocation per operation — feeds `x-codeSamples` for docs. */
+export declare function cliSample(op: OperationModel, ctx: SampleContext): CodeSample | undefined;
+//# sourceMappingURL=index.d.ts.map

package/lib/generators/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EAEd,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAOnC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,SAmB1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,SAQrB,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS,CAkBxF"}

package/lib/generators/cli/index.js

@@ -0,0 +1,67 @@
+import { groupSlug, } from '@redocly/client-generator';
+import { join } from 'node:path';
+import { renderCliDocs } from "./docs.js";
+import { cliRuntimeSource } from "./engine-source.js";
+import { cliAuthSchemes, commandData, renderCliModule } from "./render.js";
+/**
+ * The cli generator: a bin-ready `<stem>.cli.ts` — a zero-dependency, typed
+ * command-line interface over the sibling client (typed flags, `--json`
+ * bodies, env auth, `--page-all`, SSE/blob output, a documented exit-code
+ * contract). Requires `typescript` (throw mode); wires zod validation when co-selected.
+ */
+export const cliGenerator = ({ model, output, banner, emit, selected, pagination }) => {
+    const content = renderCliModule(model, {
+        stem: output.stem,
+        importExt: emit.importExt ?? 'js',
+        zodSelected: selected?.includes('zod') ?? false,
+        pagination,
+        argsStyle: emit.argsStyle ?? 'grouped',
+        runtime: emit.runtime ?? 'inline',
+    });
+    const entry = { path: join(output.dir, `${output.stem}.cli.ts`), content };
+    if (emit.runtime !== 'module')
+        return [entry];
+    const header = banner.map((line) => `// ${line}`).join('\n');
+    return [
+        entry,
+        {
+            path: join(output.dir, 'runtime', 'cli.ts'),
+            content: `${header}\n\n${cliRuntimeSource().trim()}\n`,
+        },
+    ];
+};
+/**
+ * The CLI's own reference page, written when `client.docs` is on: the usage line, the
+ * global flags, the credential variables, the exit codes, and one section per command.
+ * It renders from `commandData` — the same table `runCli` dispatches on — so the page
+ * cannot describe a tool other than the one beside it.
+ */
+export const cliDocs = ({ model, output, emit, pagination }) => {
+    const content = renderCliDocs(commandData(model, { pagination }), {
+        title: `${model.title} command-line reference`,
+        frontmatter: emit.docsFrontmatter === true,
+        name: output.stem,
+        schemes: cliAuthSchemes(model),
+    });
+    return [{ path: join(output.dir, `${output.stem}.cli.md`), content }];
+};
+/** One shell invocation per operation — feeds `x-codeSamples` for docs. */
+export function cliSample(op, ctx) {
+    const command = commandData(ctx.model, { pagination: ctx.pagination }).find((candidate) => candidate.name === op.name);
+    if (command === undefined)
+        return undefined;
+    const words = [
+        'client',
+        ...(command.group ? [groupSlug(command.group)] : []),
+        command.name,
+        ...command.positionals.map((positional) => `<${positional.name}>`),
+        ...command.flags.filter((flag) => flag.required).map((flag) => `--${flag.name} <${flag.type}>`),
+        ...(command.body ? ["--json '<json>'"] : []),
+    ];
+    return {
+        lang: 'shell',
+        label: 'CLI',
+        source: `npx tsx client.cli.ts ${words.slice(1).join(' ')}\n`,
+    };
+}
+//# sourceMappingURL=index.js.map

package/lib/generators/cli/index.js.map

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

package/lib/generators/cli/render.d.ts

@@ -0,0 +1,39 @@
+import { type ApiModel, type CliAuthScheme, type CliCommand, type ModelPagination } from '@redocly/client-generator';
+/** Every operation as pure command data — the table `runCli` interprets. */
+export declare function commandData(model: ApiModel, emit: {
+    pagination?: ModelPagination;
+    argsStyle?: 'grouped' | 'flat';
+}): CliCommand[];
+export type CliModuleOptions = {
+    stem: string;
+    importExt: string;
+    zodSelected: boolean;
+    pagination?: ModelPagination;
+    /** The sibling client's call shape, which the dispatcher builds its inputs for. */
+    argsStyle?: 'grouped' | 'flat';
+    /** `'module'` imports the engine from `./runtime/cli` instead of embedding it. */
+    runtime?: 'inline' | 'module';
+};
+/**
+ * The auth schemes as the CLI sees them: every apiKey placement is one `apiKey` kind,
+ * since the credential is read from the same env variable either way. Exported so the
+ * docs generator names the same variables the runtime reads.
+ */
+export declare function cliAuthSchemes(model: ApiModel): CliAuthScheme[];
+/** The whole `<stem>.cli.ts` file. */
+export declare function renderCliModule(model: ApiModel, options: CliModuleOptions): string;
+export type ComposedCliSource = {
+    /** The api alias from `apis:` — it becomes the namespace the shell types. */
+    alias: string;
+    /** Relative specifier of that api's generated cli module, extension included. */
+    modulePath: string;
+};
+/**
+ * The composed entry `client.cliOutput` produces: one binary over every api that selected
+ * `cli`, each behind its alias as the namespace, with `<BINNAME>_<ALIAS>` credential
+ * prefixes. It imports `runCli` from the first source's module — generated code, so the
+ * inline runtime's zero-dependency promise holds — and exports `SOURCES` so an adopter
+ * layers custom commands (a `login`) around it without editing a generated file.
+ */
+export declare function renderComposedCliEntry(sources: ComposedCliSource[], stem: string): string;
+//# sourceMappingURL=render.d.ts.map

package/lib/generators/cli/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/generators/cli/render.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,aAAa,EAClB,KAAK,UAAU,EAIf,KAAK,eAAe,EAIrB,MAAM,2BAA2B,CAAC;AAiFnC,4EAA4E;AAC5E,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,eAAe,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CAAE,GACrE,UAAU,EAAE,CA0Cd;AA0BD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,mFAAmF;IACnF,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,kFAAkF;IAClF,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,EAAE,CAK/D;AA2BD,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA2DlF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAkDzF"}

package/lib/generators/cli/render.js

@@ -0,0 +1,281 @@
+// The cli emitter: derives pure `CliCommand[]` data from the IR and renders
+// `<stem>.cli.ts` — a shebang entry that embeds (inline) or imports (package)
+// the `runCli` engine and dispatches through the sibling generated client.
+import { casing, constantCase, groupSlug, } from '@redocly/client-generator';
+import { flatInputShape } from '@redocly/client-generator/contracts/typescript';
+import { logger } from '@redocly/openapi-core';
+import { embedCliRuntime } from "./engine-source.js";
+// The generated-by banner every emitted module carries (same lines as the pipeline's
+// `input.banner`, rendered in `//` syntax).
+const HEADER = `// Generated by @redocly/client-generator — do not edit by hand.
+// Source: OpenAPI description. Re-run \`redocly generate-client\` to update.`;
+function kebab(name) {
+    return casing.snake(name).replace(/_/g, '-');
+}
+function flagFor(param) {
+    const schema = param.schema;
+    const type = schema.kind === 'array'
+        ? 'array'
+        : schema.kind === 'scalar' && (schema.scalar === 'integer' || schema.scalar === 'number')
+            ? 'number'
+            : schema.kind === 'scalar' && schema.scalar === 'boolean'
+                ? 'boolean'
+                : 'string';
+    return {
+        name: kebab(param.name),
+        param: param.name,
+        type,
+        required: param.required,
+        ...(schema.kind === 'enum' ? { enum: schema.values.map(String) } : {}),
+        ...(param.description !== undefined ? { description: param.description } : {}),
+    };
+}
+/** Mirrors `computeResponse`: a blob operation has binary success content and no JSON alternative. */
+function isBlobOp(op) {
+    const responses = op.successResponses;
+    if (responses.some((response) => response.contentType.toLowerCase().includes('json'))) {
+        return false;
+    }
+    return responses.some((response) => response.contentType.startsWith('image/') ||
+        response.contentType === 'application/octet-stream');
+}
+function jsonSuccessSchema(op) {
+    return op.successResponses.find((response) => response.contentType.toLowerCase().includes('json'))
+        ?.schema;
+}
+/**
+ * Whether a flat-style call spells this operation's body as its own properties — the same
+ * decision the client's types make, so the dispatcher never has to guess from a value.
+ */
+function mergedBodyFlag(op, model, argsStyle) {
+    if (argsStyle !== 'flat')
+        return {};
+    const shape = flatInputShape(op, model.schemas);
+    return 'mergeBody' in shape && shape.mergeBody ? { merged: true } : {};
+}
+/**
+ * The operations a flat-style run still addresses by layer: their merged names would
+ * collide, so the client's own input type keeps the namespaced shape and the dispatcher
+ * has to build that shape too.
+ */
+function groupedInputFlag(op, model, argsStyle) {
+    if (argsStyle !== 'flat')
+        return {};
+    return 'collisions' in flatInputShape(op, model.schemas) ? { argsStyle: 'grouped' } : {};
+}
+/** Every operation as pure command data — the table `runCli` interprets. */
+export function commandData(model, emit) {
+    const commands = [];
+    for (const service of model.services) {
+        for (const op of service.operations) {
+            const jsonBody = op.requestBody?.contentType.toLowerCase().includes('json')
+                ? op.requestBody
+                : undefined;
+            const responseSchema = jsonSuccessSchema(op);
+            commands.push({
+                ...(op.tags.length > 0 ? { group: op.tags[0] } : {}),
+                name: op.name,
+                ...(op.summary !== undefined ? { summary: op.summary } : {}),
+                method: op.method.toUpperCase(),
+                path: op.path,
+                positionals: op.pathParams.map((param) => ({
+                    name: param.name,
+                    type: flagFor(param).type,
+                    ...(param.description !== undefined ? { description: param.description } : {}),
+                })),
+                flags: op.queryParams.map(flagFor),
+                ...(jsonBody
+                    ? { body: { required: jsonBody.required, ...mergedBodyFlag(op, model, emit.argsStyle) } }
+                    : {}),
+                ...(jsonBody === undefined && op.requestBody !== undefined
+                    ? { unsupportedBody: op.requestBody.contentType }
+                    : {}),
+                ...(emit.pagination?.has(op.name) === true ? { paginated: true } : {}),
+                ...groupedInputFlag(op, model, emit.argsStyle),
+                ...(op.sse !== undefined ? { sse: true } : {}),
+                ...(isBlobOp(op) ? { blob: true } : {}),
+                ...(jsonBody !== undefined || responseSchema !== undefined
+                    ? {
+                        schemas: {
+                            ...(jsonBody ? { request: jsonBody.schema } : {}),
+                            ...(responseSchema !== undefined ? { response: responseSchema } : {}),
+                        },
+                    }
+                    : {}),
+            });
+        }
+    }
+    return commands;
+}
+/**
+ * The self-execution guard both generated entries share. Realpath on both sides: some
+ * runners resolve symlinks in `import.meta.url` but not in `argv[1]` (macOS temp dirs,
+ * installed bin symlinks); the catch covers an entry that is not a file (REPL, node -e).
+ */
+const ENTRY_GUARD = `function isProcessEntry(): boolean {
+  if (process.argv[1] === undefined) return false;
+  try {
+    return realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1]);
+  } catch {
+    return false;
+  }
+}
+if (isProcessEntry()) {
+  process.exit(await run());
+}`;
+/** JSON as a TS expression: U+2028/U+2029 are line terminators in code contexts. */
+function codeJson(value, indent) {
+    return JSON.stringify(value, null, indent)
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+/**
+ * The auth schemes as the CLI sees them: every apiKey placement is one `apiKey` kind,
+ * since the credential is read from the same env variable either way. Exported so the
+ * docs generator names the same variables the runtime reads.
+ */
+export function cliAuthSchemes(model) {
+    return model.securitySchemes.map((scheme) => ({
+        key: scheme.key,
+        kind: scheme.kind === 'bearer' || scheme.kind === 'basic' ? scheme.kind : 'apiKey',
+    }));
+}
+/** How an operation named after a tag is reached — the two halves of `parseInvocation`. */
+function shadowedAddress(command) {
+    return command.group === undefined
+        ? `${command.name} (keeps the bare word, so the "${command.name}" group has no help page)`
+        : `${command.name} (run it as "${groupSlug(command.group)} ${command.name}")`;
+}
+/**
+ * A leading group name is read as the group, so an operation whose name is also a tag name
+ * resolves unusually: a tagged one loses the bare form and runs as `<its group> <name>`,
+ * and an untagged one keeps the bare form and hides that group's help. Nothing becomes
+ * unreachable either way, but only the description's author can rename a side of the
+ * collision, so say it once at generation time.
+ */
+function warnShadowedCommands(commands) {
+    const slugs = new Set(commands.filter((c) => c.group).map((c) => groupSlug(c.group)));
+    const shadowed = commands.filter((command) => slugs.has(command.name));
+    if (shadowed.length === 0)
+        return;
+    logger.warn(`generate-client: cli reads a leading group name as the group, so ${shadowed.length} operation(s) named after a tag resolve unusually — rename the operation or the tag: ${shadowed
+        .map(shadowedAddress)
+        .join(', ')}.\n`);
+}
+/** The whole `<stem>.cli.ts` file. */
+export function renderCliModule(model, options) {
+    const commands = commandData(model, {
+        pagination: options.pagination,
+        argsStyle: options.argsStyle,
+    });
+    warnShadowedCommands(commands);
+    const schemes = cliAuthSchemes(model);
+    const clientModule = `./${options.stem}.${options.importExt}`;
+    const clientImports = ['client', 'configure', ...(options.zodSelected ? ['use'] : [])];
+    const parts = [
+        '#!/usr/bin/env node',
+        HEADER,
+        'import { readFileSync, realpathSync, writeFileSync } from "node:fs";\nimport { fileURLToPath } from "node:url";',
+        [
+            `import { ${clientImports.join(', ')} } from "${clientModule}";`,
+            ...(options.zodSelected
+                ? [`import { zodValidation } from "./${options.stem}.zod.${options.importExt}";`]
+                : []),
+        ].join('\n'),
+        options.runtime === 'module'
+            ? `import { invokedName, runCli, type CliCommand, type CliWiring } from "./runtime/cli.${options.importExt}";`
+            : '// ─── Embedded cli engine (@redocly/client-generator) ───\n' + embedCliRuntime(),
+        `export const COMMANDS: CliCommand[] = ${codeJson(commands, 2)};`,
+        ...(options.zodSelected
+            ? [
+                // A dry run never sends the request, so its "response" is the stub the dry-run
+                // fetch returns — validating that reports drift that does not exist. Request
+                // validation still runs, which is what makes `--dry-run` a useful preflight.
+                `use(zodValidation(process.argv.includes("--dry-run") ? { response: false } : {}));`,
+            ]
+            : []),
+        `export const wiring: CliWiring = {
+  name: invokedName(process.argv[1], ${codeJson(options.stem)}),
+  envPrefix: ${codeJson(constantCase(options.stem))},
+  client,
+${options.argsStyle === 'flat' ? '  argsStyle: "flat",\n' : ''}  configure,
+  schemes: ${codeJson(schemes)},
+  env: process.env,
+  stdin: () => readFileSync(0, "utf-8"),
+  readFile: (path: string) => readFileSync(path, "utf-8"),
+  writeFile: (path: string, data: Uint8Array) => writeFileSync(path, data),
+  stdout: (line: string) => console.log(line),
+  stderr: (line: string) => console.error(line),
+};
+
+/** Run this CLI programmatically; defaults to the process argv. */
+export const run = (argv: string[] = process.argv.slice(2)): Promise<number> =>
+  runCli(COMMANDS, wiring, argv);
+
+// Re-exported so a composed entry can run these commands without its own runtime copy.
+export { runCli };
+
+// Self-execute only as the process entry, so importing this module is side-effect-safe:
+// composed binaries and login-style wrappers import COMMANDS/wiring/run instead of
+// editing this generated file.
+${ENTRY_GUARD}`,
+    ];
+    return parts.join('\n\n') + '\n';
+}
+/**
+ * The composed entry `client.cliOutput` produces: one binary over every api that selected
+ * `cli`, each behind its alias as the namespace, with `<BINNAME>_<ALIAS>` credential
+ * prefixes. It imports `runCli` from the first source's module — generated code, so the
+ * inline runtime's zero-dependency promise holds — and exports `SOURCES` so an adopter
+ * layers custom commands (a `login`) around it without editing a generated file.
+ */
+export function renderComposedCliEntry(sources, stem) {
+    const prefix = constantCase(stem);
+    // An identifier can't start with a digit, and two aliases can sanitize identically —
+    // the underscore and the index keep every import binding legal and unique.
+    const idents = new Map();
+    sources.forEach(({ alias }, index) => {
+        const sanitized = alias.replace(/[^A-Za-z0-9]/g, '_');
+        const legal = /^[A-Za-z_]/.test(sanitized) ? sanitized : `_${sanitized}`;
+        idents.set(alias, [...idents.values()].includes(legal) ? `${legal}_${index}` : legal);
+    });
+    const identFor = (alias) => idents.get(alias);
+    const imports = sources.map(({ alias, modulePath }, index) => {
+        const ident = identFor(alias);
+        const runtime = index === 0 ? ', runCli' : '';
+        return `import { COMMANDS as ${ident}Commands, wiring as ${ident}Wiring${runtime} } from ${JSON.stringify(modulePath)};`;
+    });
+    const entries = sources.map(({ alias }) => {
+        const ident = identFor(alias);
+        const namespace = kebab(alias);
+        const aliasPrefix = `${prefix}_${constantCase(alias)}`;
+        return `  {
+    namespace: ${JSON.stringify(namespace)},
+    commands: ${ident}Commands,
+    wiring: { ...${ident}Wiring, envPrefix: ${JSON.stringify(aliasPrefix)} },
+  },`;
+    });
+    return ([
+        '#!/usr/bin/env node',
+        HEADER,
+        [
+            'import { realpathSync } from "node:fs";',
+            'import { fileURLToPath } from "node:url";',
+            ...imports,
+        ].join('\n'),
+        `/** The composed sources — import SOURCES to layer custom commands around this binary. */
+export const SOURCES = [
+${entries.join('\n')}
+];
+
+/** Run the composed CLI programmatically; defaults to the process argv. */
+export const run = (argv: string[] = process.argv.slice(2)): Promise<number> =>
+  runCli(SOURCES, argv);
+
+// Re-exported so a wrapper (a custom \`login\` command) can run these sources itself.
+export { runCli };
+
+${ENTRY_GUARD}`,
+    ].join('\n\n') + '\n');
+}
+//# sourceMappingURL=render.js.map