@redocly/client-generator 0.3.8 → 0.4.0

package/lib/cli-contract.d.ts

@@ -0,0 +1,126 @@
+/** One flag derived from a query parameter. */
+export type CliFlag = {
+    /** Kebab-cased flag name (`--page-size`). */
+    name: string;
+    /** Original wire parameter name. */
+    param: string;
+    type: 'string' | 'number' | 'boolean' | 'array';
+    required: boolean;
+    enum?: string[];
+    description?: string;
+};
+/** One executable command, derived from the IR at generate time. Pure data. */
+export type CliCommand = {
+    /** Tag; absent = flat/untagged. */
+    group?: string;
+    name: string;
+    summary?: string;
+    method: string;
+    path: string;
+    /** Path params, in path-template order. Always required — that is what a path is. */
+    positionals: Array<{
+        name: string;
+        type?: CliFlag['type'];
+        description?: string;
+    }>;
+    flags: CliFlag[];
+    /**
+     * Present when the operation takes a JSON request body. `merged` marks a body whose own
+     * properties a flat-style call spells at the top level (the generator decides this from
+     * the schema, so the CLI and the client can never disagree).
+     */
+    body?: {
+        required: boolean;
+        merged?: boolean;
+    };
+    /**
+     * The content type of a request body that is NOT JSON (multipart, url-encoded, binary).
+     * `--json` cannot build one, so the command is reported as library-only rather than
+     * offered as if it were runnable.
+     */
+    unsupportedBody?: string;
+    paginated?: boolean;
+    /** `'grouped'` marks a command whose client method takes namespaced inputs even on a
+     * flat-style client, because its merged names would collide. */
+    argsStyle?: 'grouped';
+    sse?: boolean;
+    blob?: boolean;
+    /** IR schemas for the `schema` command, serialized verbatim. */
+    schemas?: {
+        request?: unknown;
+        response?: unknown;
+    };
+};
+export type CliAuthScheme = {
+    key: string;
+    kind: 'bearer' | 'basic' | 'apiKey';
+};
+export type CliWiring = {
+    /** The name the CLI is invoked as, for help output only. The generated entry reads it
+     * from `process.argv[1]`, so help never names a command that is not installed. */
+    name: string;
+    /** Credential variable prefix, constant-cased: `CAFE` gives `CAFE_TOKEN`. Fixed at
+     * generation from the output file name, so renaming the binary keeps the variables
+     * a published CLI already documents. A composed entry sets one per api alias. */
+    envPrefix: string;
+    /** The generated instance client. */
+    client: Record<string, unknown>;
+    /** How that client takes its inputs. Defaults to `'grouped'`, the generated default. */
+    argsStyle?: 'grouped' | 'flat';
+    configure: (config: Record<string, unknown>) => void;
+    /** Security schemes of the API — drives env-var credential resolution. */
+    schemes?: CliAuthScheme[];
+    env?: Record<string, string | undefined>;
+    stdin?: () => string;
+    readFile?: (path: string) => string;
+    writeFile?: (path: string, data: Uint8Array) => void;
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+};
+export type CliGlobals = {
+    serverUrl?: string;
+    format?: 'json' | 'ndjson';
+    dryRun?: boolean;
+    pageAll?: boolean;
+    output?: string;
+    token?: string;
+    json?: string;
+};
+/**
+ * A hand-written command composed NEXT TO the generated ones: the same data shape plus a
+ * `handler`, so it inherits help, parsing, `schema`, and the exit-code contract. This is
+ * how behavior that is not in the description (a `login`, a doctor command) joins the
+ * binary without the generator ever learning what it does.
+ */
+export type CustomCommand = {
+    name: string;
+    group?: string;
+    summary?: string;
+    positionals?: CliCommand['positionals'];
+    flags?: CliFlag[];
+    /** Returns the process exit code; throwing exits 1 with the standard error JSON. */
+    handler: (context: CommandContext) => number | Promise<number>;
+};
+export type CommandContext = {
+    positionals: Record<string, string>;
+    params: Record<string, unknown>;
+    globals: CliGlobals;
+    wiring: CliWiring;
+};
+/** One API's contribution to a composed binary: its commands behind a namespace, with its
+ * OWN wiring (base URL, schemes, credentials). A namespace-less source sits at the root. */
+export type CommandSource = {
+    namespace?: string;
+    commands: Array<CliCommand | CustomCommand>;
+    /** Absent = inherit the first wired source's — a root `login` shares the binary's identity. */
+    wiring?: CliWiring;
+};
+/**
+ * The shell-typable form of a group name: an OpenAPI tag can contain spaces ("Some
+ * multi-word tag"), which only resolves if the user quotes it. Commands are addressed by
+ * this slug; help still shows the original tag.
+ */
+export declare function groupSlug(group: string): string;
+/** `cafe-api` → `CAFE_API`: the casing of every credential variable this CLI reads. */
+export declare function constantCase(value: string): string;
+//# sourceMappingURL=cli-contract.d.ts.map

package/lib/cli-contract.d.ts.map

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

package/lib/cli-contract.js

@@ -0,0 +1,25 @@
+// The generated-CLI authoring contract: the command/wiring shapes a wrapper around a
+// generated or composed CLI is written against, plus the two casing helpers the cli
+// generator shares with the engine. Defined at package level (ADR-0022: contracts own
+// their types); the engine re-exports them, and the prepare-time snapshot splices the
+// definitions back into the embedded module so generated CLIs stay self-contained.
+/**
+ * The shell-typable form of a group name: an OpenAPI tag can contain spaces ("Some
+ * multi-word tag"), which only resolves if the user quotes it. Commands are addressed by
+ * this slug; help still shows the original tag.
+ */
+export function groupSlug(group) {
+    return group
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean)
+        .join('-');
+}
+/** `cafe-api` → `CAFE_API`: the casing of every credential variable this CLI reads. */
+export function constantCase(value) {
+    return value
+        .replace(/[^A-Za-z0-9]+/g, '_')
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .toUpperCase();
+}
+//# sourceMappingURL=cli-contract.js.map

package/lib/cli-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-contract.js","sourceRoot":"","sources":["../src/cli-contract.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,oFAAoF;AACpF,sFAAsF;AACtF,sFAAsF;AACtF,mFAAmF;AAsHnF;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK;SACT,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,WAAW,EAAE,CAAC;AACnB,CAAC"}

package/lib/{emitters/wrapper-support.d.ts → contracts/typescript.d.ts}

@@ -1,5 +1,4 @@
 import type { ApiModel, OperationModel } from '../intermediate-representation/model.js';
-import { ts } from './ts.js';
 /**
  * The operations a wrapper generator can wrap, with skips reported to the user under
  * `label` (the generator name). Two kinds are dropped:
@@ -18,27 +17,17 @@ export declare function isQuery(op: OperationModel): boolean;
 export declare function hasInputs(op: OperationModel): boolean;
 /** The operation's `<Op>Variables` type name (the sdk's grouped-input alias). */
 export declare function variablesName(op: OperationModel): string;
-/** A `vars: <Op>Variables` parameter. */
-export declare function varsParam(op: OperationModel): ts.ParameterDeclaration;
-/**
- * An `init?: Omit<RequestOptions, "envelope">` parameter. The wrappers cache the
- * fetched body, so the throw-only `envelope` option is excluded from the type and
- * stripped at runtime by `sdkCall`.
- */
-export declare function initParam(): ts.ParameterDeclaration;
-/**
- * The forwarding call to the sdk operation function; argument order comes from the
- * shared `operationSignature`. `grouped` passes the source object — `{}` for a
+/** The forwarding-call ARGUMENT LIST to the sdk operation function, as text. Argument
+ * order comes from the shared `operationSignature`, so it lines up with the sdk's
+ * parameter list by construction. `grouped` passes the source object — `{}` for a
  * no-input op with an init, which must not land in the `(args?, init?)` args slot;
- * `flat` spreads `<source>.<pathIdent>`, then `.params` / `.body` / `.headers`.
- * `withInit` appends `{ ...init, envelope: undefined }` — a runtime strip, since
- * `initParam`'s `Omit` is type-only.
- */
-export declare function sdkCall(op: OperationModel, argsStyle: 'flat' | 'grouped', source: string, withInit: boolean): ts.Expression;
-/**
- * The named import from the sdk module: the wrapped opFns as value specifiers, then
- * the referenced `<Op>Variables` types + `RequestOptions` (when any query op) as
- * `type` specifiers, each group sorted.
- */
-export declare function sdkNamedImport(ops: OperationModel[], sdkModule: string, hasQuery: boolean): ts.Statement;
-//# sourceMappingURL=wrapper-support.d.ts.map
+ * `flat` spreads `<source>.<pathIdent>` (URL-template order), then the slots the op
+ * has. `withInit` appends `{ ...init, envelope: undefined }` — a runtime strip, since
+ * the wrappers cache the fetched body and their `Omit`-typed init is type-only. */
+export declare function sdkCallText(op: OperationModel, source: string, withInit: boolean): string;
+/** The named import from the sdk module: wrapped opFns, then the referenced
+ * `<Op>Variables` types + `RequestOptions` (when any query op) as `type` specifiers. */
+export declare function sdkNamedImportText(ops: OperationModel[], sdkModule: string, hasQuery: boolean): string;
+export { operationSignature, templatePathParams, type OperationSignature, } from '../generators/typescript/operation-signature.js';
+export { flatInputShape } from '../generators/typescript/operations.js';
+//# sourceMappingURL=typescript.d.ts.map

package/lib/contracts/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/contracts/typescript.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAExF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CAoBpF;AAQD,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAEnD;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAErD;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAExD;AAED;;;;;;mFAMmF;AACnF,wBAAgB,WAAW,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAQzF;AAED;wFACwF;AACxF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,cAAc,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,GAChB,MAAM,CAMR;AAKD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC"}

package/lib/contracts/typescript.js

@@ -0,0 +1,87 @@
+// The published output ABI of the `typescript` generator — what its emitted SDK
+// exports and how a call is spelled. Importable ONLY along a declared `requires`
+// edge (`swr`, `tanstack-query`, and `cli` require `typescript`): duplicating these
+// answers in each wrapper would put the SDK's calling convention in several places,
+// which is exactly the drift this module exists to prevent.
+import { logger } from '@redocly/openapi-core';
+import { operationSignature } from '../generators/typescript/operation-signature.js';
+/**
+ * The operations a wrapper generator can wrap, with skips reported to the user under
+ * `label` (the generator name). Two kinds are dropped:
+ *
+ * - **SSE operations** — the sdk exposes these as async generators (streams), not
+ *   request/response functions, so a query/mutation hook cannot wrap them.
+ * - **`<Op>Variables` name collisions** — a wrapper types its inputs as the sdk's
+ *   `<Op>Variables`; when that name collides with a schema the sdk suppresses the alias,
+ *   so the import would resolve to the schema (a wrong/broken type). The sdk function still
+ *   works; renaming the schema or the operation restores the wrapper.
+ */
+export function wrappableOperations(model, label) {
+    const all = model.services.flatMap((s) => s.operations);
+    const sse = all.filter((op) => op.sse !== undefined);
+    if (sse.length > 0) {
+        logger.warn(`generate-client: ${label} skipped ${sse.length} server-sent-events operation(s) — iterate the sdk's exported async generators directly: ${sse
+            .map((op) => op.name)
+            .join(', ')}.\n`);
+    }
+    const schemaNames = new Set(model.schemas.map((s) => s.name));
+    const clashing = all.filter((op) => op.sse === undefined && collides(op, schemaNames));
+    if (clashing.length > 0) {
+        logger.warn(`generate-client: ${label} skipped ${clashing.length} operation(s) whose variables type name collides with a schema — rename the schema or the operation: ${clashing
+            .map((op) => op.name)
+            .join(', ')}.\n`);
+    }
+    return all.filter((op) => op.sse === undefined && !collides(op, schemaNames));
+}
+/** Whether the operation's `<Op>Variables` type name collides with a named schema. */
+function collides(op, schemaNames) {
+    const sig = operationSignature(op);
+    return sig.hasInputs && schemaNames.has(sig.variablesTypeName);
+}
+/** Query operations are the safe, cacheable methods. Everything else is a mutation. */
+export function isQuery(op) {
+    return op.method === 'get' || op.method === 'head';
+}
+/** Whether the operation has any inputs — i.e. a `<Op>Variables` type exists in the sdk. */
+export function hasInputs(op) {
+    return operationSignature(op).hasInputs;
+}
+/** The operation's `<Op>Variables` type name (the sdk's grouped-input alias). */
+export function variablesName(op) {
+    return operationSignature(op).variablesTypeName;
+}
+/** The forwarding-call ARGUMENT LIST to the sdk operation function, as text. Argument
+ * order comes from the shared `operationSignature`, so it lines up with the sdk's
+ * parameter list by construction. `grouped` passes the source object — `{}` for a
+ * no-input op with an init, which must not land in the `(args?, init?)` args slot;
+ * `flat` spreads `<source>.<pathIdent>` (URL-template order), then the slots the op
+ * has. `withInit` appends `{ ...init, envelope: undefined }` — a runtime strip, since
+ * the wrappers cache the fetched body and their `Omit`-typed init is type-only. */
+export function sdkCallText(op, source, withInit) {
+    const args = [];
+    // Every style takes ONE input object, so a wrapper forwards its `<Op>Variables` verbatim
+    // and never has to know which style the sdk was generated with.
+    if (operationSignature(op).hasInputs)
+        args.push(source);
+    else if (withInit)
+        args.push('{}');
+    if (withInit)
+        args.push('{ ...init, envelope: undefined }');
+    return `${op.name}(${args.join(', ')})`;
+}
+/** The named import from the sdk module: wrapped opFns, then the referenced
+ * `<Op>Variables` types + `RequestOptions` (when any query op) as `type` specifiers. */
+export function sdkNamedImportText(ops, sdkModule, hasQuery) {
+    const values = ops.map((op) => op.name).sort();
+    const types = ops.filter(hasInputs).map(variablesName).sort();
+    if (hasQuery)
+        types.push('RequestOptions');
+    const specifiers = [...values, ...types.map((name) => `type ${name}`)].join(', ');
+    return `import { ${specifiers} } from ${JSON.stringify(sdkModule)};`;
+}
+// The pieces the typescript generator decides itself, published for the generators
+// that must agree with it: the per-operation signature facts and whether an
+// operation's inputs merge into one flat object (`cli` renders the same call shape).
+export { operationSignature, templatePathParams, } from '../generators/typescript/operation-signature.js';
+export { flatInputShape } from '../generators/typescript/operations.js';
+//# sourceMappingURL=typescript.js.map

package/lib/contracts/typescript.js.map

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

package/lib/generate.d.ts

@@ -1,13 +1,12 @@
-import type { EmitOptions } from './emitters/emit-options.js';
-import type { GeneratedFile, GeneratorDescriptor, OutputMode } from './generators/types.js';
+import type { EmitOptions, GeneratedFile, GeneratorDescriptor, OutputMode } from './generators/types.js';
 import type { ApiModel } from './intermediate-representation/model.js';
-import type { GenerateClientOptions, GenerateClientResult } from './types.js';
-export { arrow, constArray, exportConstStatement, jsdoc, parseStatements, printNodes, printStatements, ts, } from './emitters/ts.js';
-export { operationSignature } from './emitters/operation-signature.js';
-export type { OperationSignature } from './emitters/operation-signature.js';
-export { schemaToTypeNode } from './emitters/types.js';
-export { pascalCase } from './emitters/support.js';
-export { safeIdent } from './emitters/identifier.js';
+export { tsJsdoc, tsType } from './generators/typescript/types.js';
+export { codeLiteral } from './printers/typescript.js';
+export * from './authoring/index.js';
+export { operationSignature } from './contracts/typescript.js';
+export type { OperationSignature } from './contracts/typescript.js';
+export { pascalCase } from './printers/typescript.js';
+export { safeIdent } from './printers/typescript.js';
 /**
  * Validate the generator selection (see `validateGenerators`), then run each
  * configured generator against the IR and concatenate their files. Throws on a
@@ -21,5 +20,6 @@ export declare function collectGeneratedFiles(model: ApiModel, options: {
     /** The resolved registry (built-ins + custom). Defaults to the built-ins. */
     registry?: Map<string, GeneratorDescriptor>;
 }): GeneratedFile[];
-export declare function generateClient(options: GenerateClientOptions): Promise<GenerateClientResult>;
+export { generateClient } from './pipeline.js';
+export { renderComposedCliEntry, type ComposedCliSource } from './generators/cli/render.js';
 //# sourceMappingURL=generate.d.ts.map

package/lib/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAK9D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAGvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG9E,OAAO,EACL,KAAK,EACL,UAAU,EACV,oBAAoB,EACpB,KAAK,EACL,eAAe,EACf,UAAU,EACV,eAAe,EACf,EAAE,GACH,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC7C,GACA,aAAa,EAAE,CAuBjB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA+E/B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,UAAU,EACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAQvE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC7C,GACA,aAAa,EAAE,CAMjB;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}

package/lib/generate.js

@@ -1,24 +1,24 @@
-// The generate entry (`@redocly/client-generator/generate`): everything that runs at
-// GENERATION time — `generateClient`, `collectGeneratedFiles`, and the TypeScript-emitting
-// toolkit for custom generators. It loads `typescript` and `@redocly/openapi-core`, so it
-// must never be reached statically from the package root: package-mode clients import the
-// root at app runtime, and the root reaches this module only through the dynamic import
-// inside its `generateClient` facade.
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
-import { bakeSetup } from './emitters/setup-bake.js';
-import { NotSupportedError } from './errors.js';
+// The generate entry (`@redocly/client-generator/generate`): the TypeScript-emitting
+// text toolkit for custom generators plus `collectGeneratedFiles` and a `generateClient`
+// re-export. It loads `@redocly/openapi-core` (and, only for `--setup` baking,
+// `typescript` — lazily), so it must never be reached statically from the package
+// root: package-mode clients import the root at app runtime, and the root reaches
+// the pipeline only through a dynamic import.
 import { builtinGenerators, validateGenerators } from './generators/index.js';
-import { resolveGenerators } from './generators/resolve.js';
-import { buildApiModel } from './intermediate-representation/build.js';
-import { normalizeSwagger2 } from './intermediate-representation/normalize-swagger2.js';
-import { loadSpec } from './loader.js';
+import { runGenerators } from './pipeline.js';
 // --- Codegen toolkit: build TypeScript the same way the built-in generators do -----------------
-export { arrow, constArray, exportConstStatement, jsdoc, parseStatements, printNodes, printStatements, ts, } from './emitters/ts.js';
-export { operationSignature } from './emitters/operation-signature.js';
-export { schemaToTypeNode } from './emitters/types.js';
-export { pascalCase } from './emitters/support.js';
-export { safeIdent } from './emitters/identifier.js';
+// Source-text templates, not an AST: the `ts.factory`/printer exports were removed
+// when every built-in generator migrated to text (one authoring model for every
+// output language). `tsType`/`tsJsdoc`/`codeLiteral` are the TypeScript-specific
+// text renderers the sdk itself uses.
+export { tsJsdoc, tsType } from './generators/typescript/types.js';
+export { codeLiteral } from './printers/typescript.js';
+// The language-neutral authoring helpers, re-exported here so both toolkit
+// entries offer the full authoring surface (the root offers them TS-free).
+export * from './authoring/index.js';
+export { operationSignature } from './contracts/typescript.js';
+export { pascalCase } from './printers/typescript.js';
+export { safeIdent } from './printers/typescript.js';
 /**
  * Validate the generator selection (see `validateGenerators`), then run each
  * configured generator against the IR and concatenate their files. Throws on a
@@ -28,92 +28,11 @@ export function collectGeneratedFiles(model, options) {
     const registry = options.registry ?? builtinGenerators();
     // Fail fast on an incompatible selection (missing prerequisite, unsupported
     // error-mode/date-type/runtime) before producing any file.
-    validateGenerators(options.generators, options.emit, registry);
-    const files = [];
-    const seen = new Set();
-    for (const name of options.generators) {
-        const generator = registry.get(name);
-        for (const file of generator.run({
-            model,
-            outputPath: options.outputPath,
-            outputMode: options.outputMode,
-            emit: options.emit,
-        })) {
-            if (seen.has(file.path)) {
-                throw new Error(`Generator conflict: ${file.path} already emitted by an earlier generator`);
-            }
-            seen.add(file.path);
-            files.push(file);
-        }
-    }
-    return files;
-}
-export async function generateClient(options) {
-    // A path segment that is literally "undefined"/"null" is the telltale of an
-    // interpolation bug in the caller (`\`${dir}/client.ts\`` with `dir` unset) — reject
-    // it instead of silently creating an `undefined/` directory.
-    if (options.output.split(/[\\/]/).some((segment) => segment === 'undefined' || segment === 'null')) {
-        throw new Error(`output path "${options.output}" contains a literal "undefined" or "null" segment — this looks like an interpolation bug in the caller`);
-    }
-    // Setup is a LOCAL module (its code is baked into the generated client) — reject
-    // URL-ish specifiers upfront, before any spec loading, instead of failing later as
-    // an unreadable file path. Two+ letter scheme, so Windows drive paths don't match.
-    if (options.setup && /^[a-z][a-z0-9+.-]+:/i.test(options.setup)) {
-        throw new NotSupportedError(`setup must be a local file path — remote setup modules are not supported (got: ${options.setup})`);
-    }
-    const outputPath = resolve(options.output);
-    const { document, version } = await loadSpec(options.api, options.config);
-    const normalized = version === 'oas2'
-        ? normalizeSwagger2(document)
-        : document;
-    const model = buildApiModel(normalized);
-    // A publisher `--setup` module is read, validated, and transformed into the neutral setup
-    // expression baked into the client. Applied across all output modes by the emitter.
-    let setupBlock;
-    if (options.setup) {
-        // A relative setup path resolves against `configDir` (cwd when absent), like
-        // generator specifiers. The CLI pre-resolves its inputs, so they arrive absolute.
-        const setupPath = resolve(options.configDir ?? process.cwd(), options.setup);
-        setupBlock = bakeSetup(await readFile(setupPath, 'utf-8'));
-    }
-    // Resolve the selection into a registry: built-in names pass through, inline `customGenerators`
-    // register, and any other entry is imported as a plugin specifier (path/package).
-    // An empty list (e.g. `generators: []` in config, or no `--generator` flags) means
-    // "unspecified" — fall back to the default sdk client rather than emitting nothing.
-    const requested = options.generators?.length ? options.generators : ['sdk'];
-    const { selected, registry } = await resolveGenerators(requested, {
-        customGenerators: options.customGenerators,
-        configDir: options.configDir,
-    });
-    const files = collectGeneratedFiles(model, {
-        outputPath,
-        outputMode: options.outputMode ?? 'single',
-        emit: {
-            serverUrl: options.serverUrl,
-            argsStyle: options.argsStyle,
-            errorMode: options.errorMode,
-            dateType: options.dateType,
-            mockData: options.mockData,
-            mockSeed: options.mockSeed,
-            queryKeyPrefix: options.queryKeyPrefix,
-            setup: setupBlock,
-            runtime: options.runtime,
-            importExt: options.importExt,
-            pagination: options.pagination,
-        },
-        generators: selected,
-        registry,
-    });
-    const written = [];
-    for (const file of files) {
-        await mkdir(dirname(file.path), { recursive: true });
-        await writeFile(file.path, file.content, 'utf-8');
-        written.push({ path: file.path, bytes: Buffer.byteLength(file.content, 'utf-8') });
-    }
-    return {
-        outputPath,
-        bytes: written.reduce((sum, file) => sum + file.bytes, 0),
-        files: written,
-    };
+    validateGenerators(options.generators, options.emit, registry, options.outputMode);
+    return runGenerators(model, { ...options, registry });
 }
+export { generateClient } from './pipeline.js';
+// The composed-cli entry renderer: consumed by the redocly CLI across apis (it needs the
+// embedded runtime text, which must stay off the runtime-only root barrel).
+export { renderComposedCliEntry } from './generators/cli/render.js';
 //# sourceMappingURL=generate.js.map

package/lib/generate.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,yFAAyF;AACzF,+EAA+E;AAC/E,kFAAkF;AAClF,kFAAkF;AAClF,8CAA8C;AAE9C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAQ9E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,kGAAkG;AAClG,mFAAmF;AACnF,gFAAgF;AAChF,iFAAiF;AACjF,sCAAsC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,2EAA2E;AAC3E,2EAA2E;AAC3E,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAe,EACf,OAOC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,EAAE,CAAC;IACzD,4EAA4E;IAC5E,2DAA2D;IAC3D,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACnF,OAAO,aAAa,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,yFAAyF;AACzF,4EAA4E;AAC5E,OAAO,EAAE,sBAAsB,EAA0B,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,19 @@
+import { type CliCommand } from '@redocly/client-generator';
+export type CliDocsOptions = {
+    /** Page heading. */
+    title: string;
+    /** Emit YAML front matter carrying the title, for docs sites that expect it. */
+    frontmatter: boolean;
+    /** The generated file's stem: what the page calls the command, and what its credential
+     * variables derive from. A reader who installs it under another bin name renames only
+     * the command — the variables are fixed at generation. */
+    name: string;
+    /** Auth schemes the description declares, in the order the CLI resolves them. */
+    schemes: Array<{
+        key: string;
+        kind: 'bearer' | 'basic' | 'apiKey';
+    }>;
+};
+/** The whole page: heading, global flags, credentials, exit codes, then every command. */
+export declare function renderCliDocs(commands: CliCommand[], options: CliDocsOptions): string;
+//# sourceMappingURL=docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/generators/cli/docs.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,UAAU,EAKhB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,cAAc,GAAG;IAC3B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB;;8DAE0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;KAAE,CAAC,CAAC;CACtE,CAAC;AAoFF,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CA8GrF"}