@redocly/client-generator 0.3.8 → 0.4.0

package/lib/generators/typescript/descriptor.js

@@ -0,0 +1,97 @@
+// Package-mode descriptor emission: the identifier plan for a generated module that
+// shares scope with the `@redocly/client-generator` wiring, plus the `OPERATIONS`
+// descriptor map (`satisfies Record<string, OperationDescriptor>` — the semver skew
+// guard against the runtime contract in src/runtime/types.ts). Text templates.
+import { allOperations, securityRequirements, WIRING_NAMES, } from '@redocly/client-generator';
+import { codeLiteral, uniqueIdent } from '@redocly/client-generator/printers/typescript';
+import { isTypedMultipart } from "./operation-types.js";
+import { flatInputShape, responseText } from "./operations.js";
+import { responseHeaderSpecs } from "./response-headers.js";
+import { tsJsdoc } from "./types.js";
+/**
+ * Operation-name → emitted-identifier plan. The full reserved set (wiring + imported
+ * bindings, computed from the model FIRST) is seeded before any operation
+ * is sanitized, so collisions rename the operation (`configure` → `configure_2`)
+ * deterministically regardless of document order.
+ */
+export function packageIdents(model) {
+    const used = new Set(WIRING_NAMES);
+    const idents = new Map();
+    for (const op of allOperations(model.services))
+        idents.set(op.name, uniqueIdent(op.name, used));
+    return idents;
+}
+/** One operation's OperationDescriptor as plain data (only non-default fields present). */
+function descriptorValue(op, schemes, dateType, pagination, schemas = [], argsStyle = 'grouped') {
+    const params = [...op.pathParams, ...op.queryParams, ...op.headerParams, ...op.cookieParams].map((p) => ({
+        name: p.name,
+        in: p.in,
+        ...(p.style !== undefined ? { style: p.style } : {}),
+        ...(p.explode !== undefined ? { explode: p.explode } : {}),
+        ...(p.allowReserved !== undefined ? { allowReserved: p.allowReserved } : {}),
+    }));
+    const security = securityRequirements(op, { securitySchemes: schemes });
+    const sse = op.sse !== undefined;
+    const responseKind = sse ? 'sse' : responseText(op.successResponses, dateType).kind;
+    const responseHeaders = responseHeaderSpecs(op.successResponseHeaders, schemas);
+    return {
+        // The spec's operationId, NOT the (possibly renamed) map key: `id` drives middleware
+        // targeting (`ctx.operation.id`) and must match inline mode's `operationMetaExpr`.
+        // The wire/middleware identity stays the SPEC operationId even when the emitted
+        // function name was renamed away from a collision (`configure` → `configure_2`).
+        id: op.specName ?? op.name,
+        method: op.method.toUpperCase(),
+        path: op.path,
+        ...(op.tags.length > 0 ? { tags: op.tags } : {}),
+        ...(params.length > 0 ? { params } : {}),
+        ...(op.requestBody
+            ? {
+                body: {
+                    contentType: op.requestBody.contentType,
+                    ...(isTypedMultipart(op.requestBody) ? { multipart: true } : {}),
+                },
+            }
+            : {}),
+        ...(responseKind !== 'json' ? { responseKind } : {}),
+        ...(op.sse === undefined ? {} : { sseDataKind: op.sse.dataKind }),
+        ...(security.length > 0 ? { security } : {}),
+        ...(responseHeaders === undefined ? {} : { responseHeaders }),
+        // The resolved spec is already normalized with stable key order (see pagination.ts).
+        ...(pagination?.has(op.name) ? { pagination: pagination.get(op.name).spec } : {}),
+        // A merged call cannot carry one name for two layers, so an operation whose names
+        // collide keeps the namespaced shape — its `<Op>Variables` says so, and the runtime
+        // has to agree or the typed call would be rejected.
+        ...(argsStyle === 'flat' && 'collisions' in flatInputShape(op, schemas)
+            ? { argsStyle: 'grouped' }
+            : {}),
+    };
+}
+/** `export const OPERATIONS = {…} as const satisfies …` + the derived unions. */
+export function renderDescriptors(model, idents, dateType, pagination, argsStyle = 'grouped') {
+    const ops = allOperations(model.services);
+    if (ops.length === 0)
+        return '';
+    const entryLines = ops.map((op, index) => {
+        const value = codeLiteral(descriptorValue(op, model.securitySchemes, dateType, pagination, model.schemas, argsStyle));
+        return `    ${idents.get(op.name)}: ${value}${index === ops.length - 1 ? '' : ','}`;
+    });
+    const blocks = [
+        [
+            ...tsJsdoc('The wire-shape descriptor for every operation, keyed by operationId — the data the\n' +
+                'runtime routes requests by. Also minification-safe static metadata (method, path,\n' +
+                'tags) for cache keys, tracing span names, and request logging.', undefined, ''),
+            'export const OPERATIONS = {',
+            ...entryLines,
+            '} as const satisfies Record<string, OperationDescriptor>;',
+        ].join('\n'),
+        'export type OperationId = (typeof OPERATIONS)[keyof typeof OPERATIONS]["id"];',
+        'export type OperationPath = (typeof OPERATIONS)[keyof typeof OPERATIONS]["path"];',
+    ];
+    if (ops.some((op) => op.tags.length > 0)) {
+        blocks.push('export type OperationTag = Extract<(typeof OPERATIONS)[keyof typeof OPERATIONS], {\n' +
+            '    tags: readonly string[];\n' +
+            '}>["tags"][number];');
+    }
+    return blocks.join('\n\n');
+}
+//# sourceMappingURL=descriptor.js.map

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

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

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

@@ -0,0 +1,20 @@
+import { type CodeSample, type Generator, type OperationModel, type SampleContext } from '@redocly/client-generator';
+/**
+ * The default generator: the full typed client (model types + runtime + endpoints).
+ * Other generators (zod, framework hooks) emit *additional* files alongside.
+ *
+ * `single` mode writes the whole client to the `--output` path. `split` mode derives
+ * two sibling files from that anchor — `<stem>.schemas.ts` (model types, enums,
+ * const-objects, type guards; skipped when the document declares no schemas) and
+ * `<stem>.ts` (everything else, which `export *`s the schemas module).
+ */
+export declare const typescriptGenerator: Generator;
+/**
+ * The client's own reference page, written when `client.docs` is on. Its snippets come from
+ * `typescriptSample` below, so the page shows the calling convention this run generated —
+ * `argsStyle` included.
+ */
+export declare const typescriptDocs: Generator;
+/** One idiomatic TS call per operation, for `x-codeSamples` and the SDK reference pages. */
+export declare function typescriptSample(op: OperationModel, ctx: SampleContext): CodeSample;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/typescript/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EAEnB,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAMnC;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAkBjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAgB5B,CAAC;AAEF,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,aAAa,GAAG,UAAU,CAuBnF"}

package/lib/generators/typescript/index.js

@@ -0,0 +1,80 @@
+import { renderReferencePage, } from '@redocly/client-generator';
+import { join } from 'node:path';
+import { emitClientSingleFile, emitClientSplit, emitRuntimeFiles } from "./client.js";
+import { packageIdents } from "./descriptor.js";
+/**
+ * The default generator: the full typed client (model types + runtime + endpoints).
+ * Other generators (zod, framework hooks) emit *additional* files alongside.
+ *
+ * `single` mode writes the whole client to the `--output` path. `split` mode derives
+ * two sibling files from that anchor — `<stem>.schemas.ts` (model types, enums,
+ * const-objects, type guards; skipped when the document declares no schemas) and
+ * `<stem>.ts` (everything else, which `export *`s the schemas module).
+ */
+export const typescriptGenerator = ({ model, output, outputMode, emit }) => {
+    // `runtime: 'module'` adds the per-needs runtime files beside the client.
+    const runtime = emitRuntimeFiles(model, emit).map(({ name, content }) => ({
+        path: join(output.dir, 'runtime', name),
+        content,
+    }));
+    if (outputMode === 'split') {
+        const { dir, stem } = output;
+        const { entry, schemas } = emitClientSplit(model, emit, stem);
+        return [
+            ...(schemas === undefined
+                ? []
+                : [{ path: join(dir, `${stem}.schemas.ts`), content: schemas }]),
+            { path: output.path, content: entry },
+            ...runtime,
+        ];
+    }
+    return [{ path: output.path, content: emitClientSingleFile(model, emit) }, ...runtime];
+};
+/**
+ * The client's own reference page, written when `client.docs` is on. Its snippets come from
+ * `typescriptSample` below, so the page shows the calling convention this run generated —
+ * `argsStyle` included.
+ */
+export const typescriptDocs = ({ model, output, emit, pagination }) => [
+    {
+        path: output.path.replace(/\.[^.\\/]+$/, '.typescript.md'),
+        content: renderReferencePage(model, {
+            title: `${model.title} TypeScript client reference`,
+            frontmatter: emit.docsFrontmatter === true,
+            language: {
+                name: 'typescript',
+                label: 'TypeScript',
+                fence: 'typescript',
+                requires: 'The client has no dependencies.',
+            },
+            sample: (op) => typescriptSample(op, { model, emit, outputPath: output.path }),
+            paginated: new Set(pagination?.keys() ?? []),
+        }),
+    },
+];
+/** One idiomatic TS call per operation, for `x-codeSamples` and the SDK reference pages. */
+export function typescriptSample(op, ctx) {
+    const ident = packageIdents(ctx.model).get(op.name) ?? op.name;
+    // The module this run writes, with the run's import extension — `./client` would be
+    // both the wrong name for most stems and extensionless under ESM resolution.
+    const stem = ctx.outputPath.replace(/^.*[\\/]/, '').replace(/\.[^.]+$/, '');
+    const specifier = `./${stem}.${ctx.emit.importExt ?? 'js'}`;
+    const requiredQuery = op.queryParams.filter((param) => param.required);
+    const merged = ctx.emit.argsStyle === 'flat';
+    const path = op.pathParams.map((param) => `${param.name}: '<${param.name}>'`);
+    const query = requiredQuery.map((param) => `${param.name}: /* … */`);
+    const parts = merged
+        ? [...path, ...query, ...(op.requestBody ? ['/* body properties */'] : [])]
+        : [
+            ...(path.length > 0 ? [`path: { ${path.join(', ')} }`] : []),
+            ...(query.length > 0 ? [`query: { ${query.join(', ')} }`] : []),
+            ...(op.requestBody ? ['body: { /* … */ }'] : []),
+        ];
+    const args = parts.length > 0 ? [`{ ${parts.join(', ')} }`] : [];
+    return {
+        lang: 'typescript',
+        label: 'TypeScript SDK',
+        source: `import { ${ident} } from '${specifier}';\n\nconst result = await ${ident}(${args.join(', ')});\n`,
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/typescript/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,mBAAmB,GAEpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;IACpF,0EAA0E;IAC1E,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC;QACvC,OAAO;KACR,CAAC,CAAC,CAAC;IACJ,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAC7B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9D,OAAO;YACL,GAAG,CAAC,OAAO,KAAK,SAAS;gBACvB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;YACrC,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;AACzF,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAChF;QACE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,gBAAgB,CAAC;QAC1D,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE;YAClC,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,8BAA8B;YACnD,WAAW,EAAE,IAAI,CAAC,eAAe,KAAK,IAAI;YAC1C,QAAQ,EAAE;gBACR,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,YAAY;gBACnB,QAAQ,EAAE,iCAAiC;aAC5C;YACD,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9E,SAAS,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;SAC7C,CAAC;KACH;CACF,CAAC;AAEF,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,EAAkB,EAAE,GAAkB;IACrE,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC;IAC/D,oFAAoF;IACpF,6EAA6E;IAC7E,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;IAC5D,MAAM,aAAa,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC;IAC7C,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,MAAM;QAClB,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC,CAAC;YACE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC;IACN,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,YAAY,KAAK,YAAY,SAAS,8BAA8B,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;KAC3G,CAAC;AACJ,CAAC"}

package/lib/generators/typescript/inline-runtime.d.ts

@@ -0,0 +1,21 @@
+/** Which optional runtime capabilities the generated client must embed. */
+export type InlineRuntimeNeeds = {
+    multipart: boolean;
+    auth: boolean;
+    sse: boolean;
+    setup: boolean;
+    paginate: boolean;
+};
+/** The embedded runtime source block: stripped modules in dependency order + the factory. */
+export declare function assembleInlineRuntime(needs: InlineRuntimeNeeds): string;
+/**
+ * The runtime as real files (`runtime: 'module'`): the same per-needs modules, RAW —
+ * imports intact, exactly as authored — plus `factory.ts`, the per-needs `createClient`
+ * wiring as a module importing what it references from its siblings. `importExt`
+ * rewrites the intra-runtime specifiers for consumers that resolve them literally.
+ */
+export declare function runtimeModuleFiles(needs: InlineRuntimeNeeds, importExt?: 'js' | 'ts'): Array<{
+    name: string;
+    content: string;
+}>;
+//# sourceMappingURL=inline-runtime.d.ts.map

package/lib/generators/typescript/inline-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-runtime.d.ts","sourceRoot":"","sources":["../../../src/generators/typescript/inline-runtime.ts"],"names":[],"mappings":"AAaA,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAsBF,6FAA6F;AAC7F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,EACzB,SAAS,GAAE,IAAI,GAAG,IAAW,GAC5B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAU1C"}

package/lib/generators/typescript/inline-runtime.js

@@ -0,0 +1,114 @@
+// Assembles the embedded runtime block for inline-mode clients: the real
+// `src/runtime/` sources — stripped of module syntax at PREPARE time (see
+// scripts/generate-runtime-sources.mjs, which owns the kept-export surface) — in
+// import-graph order, followed by a local `createClient` factory wiring only the
+// capabilities this API needs. Pure string concatenation: no `typescript` at
+// generate time.
+import { RUNTIME_SOURCES, RUNTIME_SOURCES_STRIPPED, } from '@redocly/client-generator/runtime-sources';
+const HEADER = "// ─── Embedded runtime (@redocly/client-generator, assembled per this API's needs) ───";
+/** The per-needs module set, in import-graph topological order (both modes share it). */
+function runtimeModules(needs) {
+    // The optional capability modules slot in where the runtime barrel would import
+    // them (core never imports them statically).
+    const modules = ['types.ts', 'errors.ts', 'url.ts', 'parse.ts', 'retry.ts'];
+    if (needs.multipart)
+        modules.push('multipart.ts');
+    if (needs.auth)
+        modules.push('auth.ts');
+    if (needs.setup)
+        modules.push('setup.ts');
+    // paginate.ts has only type imports (types.ts + create-client.ts's OperationArgs),
+    // so it can sit anywhere; keep it with the other capability modules, before send.ts.
+    if (needs.paginate)
+        modules.push('paginate.ts');
+    modules.push('send.ts');
+    if (needs.sse)
+        modules.push('sse.ts');
+    modules.push('create-client.ts');
+    return modules;
+}
+/** The embedded runtime source block: stripped modules in dependency order + the factory. */
+export function assembleInlineRuntime(needs) {
+    return [
+        HEADER,
+        ...runtimeModules(needs).map((name) => RUNTIME_SOURCES_STRIPPED[name]),
+        clientFactory(needs),
+    ].join('\n\n');
+}
+/**
+ * The runtime as real files (`runtime: 'module'`): the same per-needs modules, RAW —
+ * imports intact, exactly as authored — plus `factory.ts`, the per-needs `createClient`
+ * wiring as a module importing what it references from its siblings. `importExt`
+ * rewrites the intra-runtime specifiers for consumers that resolve them literally.
+ */
+export function runtimeModuleFiles(needs, importExt = 'js') {
+    const files = [
+        ...runtimeModules(needs).map((name) => ({ name, content: RUNTIME_SOURCES[name] })),
+        { name: 'factory.ts', content: moduleFactory(needs) },
+    ];
+    if (importExt === 'js')
+        return files;
+    return files.map(({ name, content }) => ({
+        name,
+        content: content.replace(/(from '\.\/[a-z-]+)\.js'/g, "$1.ts'"),
+    }));
+}
+/** `factory.ts`: the sibling-module equivalent of the inline factory block. */
+function moduleFactory(needs) {
+    const imports = [
+        "import { createClientCore } from './create-client.js';",
+        ...(needs.multipart ? ["import { toFormData } from './multipart.js';"] : []),
+        ...(needs.auth ? ["import { resolveAuth } from './auth.js';"] : []),
+        ...(needs.paginate
+            ? ["import { items, itemsByLink, pages, pagesByLink } from './paginate.js';"]
+            : []),
+        ...(needs.sse ? ["import { sse } from './sse.js';"] : []),
+        `import type {
+  Client,
+  ClientConfig,
+  OperationContext,
+  OperationDescriptor,
+  OpsShape,
+} from './types.js';`,
+    ];
+    // The client entry re-exports this module, so the factory carries the same public
+    // surface the inline embed leaves in module scope (the kept-export set).
+    const reexports = [
+        "export { ApiError, TimeoutError } from './errors.js';",
+        "export { defaultRetryOn } from './retry.js';",
+        ...(needs.setup ? ["export { mergeSetup } from './setup.js';"] : []),
+        "export type * from './types.js';",
+    ];
+    return [imports.join('\n'), clientFactory(needs), reexports.join('\n')].join('\n\n');
+}
+// The embedded equivalent of the package barrel's `createClient`: `createClientCore`
+// with only the included capabilities wired. EXPORTED — the design spec promises the
+// generated module re-exports `createClient`/`OPERATIONS`/`Ops` so apps can build
+// additional per-tenant instances over the same descriptors.
+function clientFactory(needs) {
+    const caps = [
+        ...(needs.multipart ? ['serializeMultipart: toFormData'] : []),
+        ...(needs.auth ? ['resolveAuth'] : []),
+        ...(needs.sse ? ['sse'] : []),
+        ...(needs.paginate ? ['paginate: { pages, items, pagesByLink, itemsByLink }'] : []),
+    ];
+    const wired = caps.length > 0 ? `{ ${caps.join(', ')} }` : '{}';
+    return `/**
+ * The client factory: \`createClientCore\` wired with the capabilities this API needs.
+ * Exported so apps can build additional instances (per-tenant, per-environment) over
+ * the same \`OPERATIONS\`/\`Ops\`. The trailing string params carry the wiring's literal
+ * unions (\`OperationId\`/\`OperationPath\`/\`OperationTag\`) into \`ctx.operation\`.
+ */
+export function createClient<
+  Ops extends OpsShape,
+  Id extends string = string,
+  Path extends string = string,
+  Tag extends string = string,
+>(
+  operations: Record<string, OperationDescriptor>,
+  config?: ClientConfig<OperationContext<Id, Path, Tag>>
+): Client<Ops, OperationContext<Id, Path, Tag>> {
+  return createClientCore<Ops, Id, Path, Tag>(operations, config, ${wired});
+}`;
+}
+//# sourceMappingURL=inline-runtime.js.map

package/lib/generators/typescript/inline-runtime.js.map

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

package/lib/generators/typescript/operation-signature.d.ts

@@ -0,0 +1,23 @@
+import type { OperationModel, ParamModel } from '@redocly/client-generator';
+export type OperationSignature = {
+    /** Slot presence — which input layers the operation has. */
+    hasQuery: boolean;
+    hasBody: boolean;
+    hasHeaders: boolean;
+    hasCookies: boolean;
+    /** Any input at all — i.e. a `<Op>Variables` type exists for the operation. */
+    hasInputs: boolean;
+    /** Whether the input argument is required (else it defaults to `= {}`). */
+    varsRequired: boolean;
+    /** The `<Op>Variables` type-alias name. */
+    variablesTypeName: string;
+};
+/**
+ * Path parameters in URL-template order — the order a reader sees them in the path, and the
+ * order the old positional signature used. A parameter declared but absent from the template
+ * is dropped: it has nowhere to go in the URL, so asking for a value would mislead.
+ */
+export declare function templatePathParams(op: OperationModel): ParamModel[];
+/** Compute the calling-convention description for `op`. Pure; no AST. */
+export declare function operationSignature(op: OperationModel): OperationSignature;
+//# sourceMappingURL=operation-signature.d.ts.map

package/lib/generators/typescript/operation-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-signature.d.ts","sourceRoot":"","sources":["../../../src/generators/typescript/operation-signature.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,YAAY,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,GAAG,UAAU,EAAE,CAQnE;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,GAAG,kBAAkB,CAoBzE"}

package/lib/generators/typescript/operation-signature.js

@@ -0,0 +1,41 @@
+// The shared calling-convention description for an operation. The sdk (which emits each
+// operation's input type) and the wrapper generators (which forward it) read slot presence
+// and `<Op>Variables` naming from this one source, so a call and its type cannot drift.
+import { pascalCase } from '@redocly/client-generator/printers/typescript';
+/**
+ * Path parameters in URL-template order — the order a reader sees them in the path, and the
+ * order the old positional signature used. A parameter declared but absent from the template
+ * is dropped: it has nowhere to go in the URL, so asking for a value would mislead.
+ */
+export function templatePathParams(op) {
+    const byName = new Map(op.pathParams.map((param) => [param.name, param]));
+    const ordered = [];
+    for (const match of op.path.matchAll(/\{([^{}]+)\}/g)) {
+        const param = byName.get(match[1]);
+        if (param !== undefined)
+            ordered.push(param);
+    }
+    return ordered;
+}
+/** Compute the calling-convention description for `op`. Pure; no AST. */
+export function operationSignature(op) {
+    const pathParams = templatePathParams(op);
+    const hasQuery = op.queryParams.length > 0;
+    const hasBody = Boolean(op.requestBody);
+    const hasHeaders = op.headerParams.length > 0;
+    const hasCookies = op.cookieParams.length > 0;
+    return {
+        hasQuery,
+        hasBody,
+        hasHeaders,
+        hasCookies,
+        hasInputs: pathParams.length > 0 || hasQuery || hasBody || hasHeaders || hasCookies,
+        varsRequired: pathParams.length > 0 ||
+            op.queryParams.some((p) => p.required) ||
+            (op.requestBody?.required ?? false) ||
+            op.headerParams.some((p) => p.required) ||
+            op.cookieParams.some((p) => p.required),
+        variablesTypeName: `${pascalCase(op.name)}Variables`,
+    };
+}
+//# sourceMappingURL=operation-signature.js.map

package/lib/generators/typescript/operation-signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-signature.js","sourceRoot":"","sources":["../../../src/generators/typescript/operation-signature.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,2FAA2F;AAC3F,wFAAwF;AAGxF,OAAO,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAgB3E;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAkB;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAU,CAAC,CAAC,CAAC;IACnF,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,EAAkB;IACnD,MAAM,UAAU,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9C,OAAO;QACL,QAAQ;QACR,OAAO;QACP,UAAU;QACV,UAAU;QACV,SAAS,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,IAAI,OAAO,IAAI,UAAU,IAAI,UAAU;QACnF,YAAY,EACV,UAAU,CAAC,MAAM,GAAG,CAAC;YACrB,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YACtC,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,IAAI,KAAK,CAAC;YACnC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YACvC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACzC,iBAAiB,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW;KACrD,CAAC;AACJ,CAAC"}

package/lib/generators/typescript/operation-types.d.ts

@@ -0,0 +1,9 @@
+import type { RequestBodyModel } from '@redocly/client-generator';
+/**
+ * A multipart body whose schema is a concrete object — the case worth typing. Such a body
+ * is emitted as its object shape (binary fields → `Blob`); the runtime serializes it to
+ * `FormData` (`runtime/multipart.ts`) after the onRequest chain. Multipart bodies with a
+ * non-object schema can't be typed field-by-field, so they keep the raw `FormData` escape hatch.
+ */
+export declare function isTypedMultipart(rb: RequestBodyModel): boolean;
+//# sourceMappingURL=operation-types.d.ts.map

package/lib/generators/typescript/operation-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.d.ts","sourceRoot":"","sources":["../../../src/generators/typescript/operation-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAE9D"}

package/lib/generators/typescript/operation-types.js

@@ -0,0 +1,11 @@
+// Shared operation-shape predicates.
+/**
+ * A multipart body whose schema is a concrete object — the case worth typing. Such a body
+ * is emitted as its object shape (binary fields → `Blob`); the runtime serializes it to
+ * `FormData` (`runtime/multipart.ts`) after the onRequest chain. Multipart bodies with a
+ * non-object schema can't be typed field-by-field, so they keep the raw `FormData` escape hatch.
+ */
+export function isTypedMultipart(rb) {
+    return rb.contentType === 'multipart/form-data' && rb.schema.kind === 'object';
+}
+//# sourceMappingURL=operation-types.js.map

package/lib/generators/typescript/operation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.js","sourceRoot":"","sources":["../../../src/generators/typescript/operation-types.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAIrC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAoB;IACnD,OAAO,EAAE,CAAC,WAAW,KAAK,qBAAqB,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,60 @@
+import { type ApiModel, type ArgsStyle, type DateType, type ErrorMode, type ModelPagination, type NamedSchemaModel, type OperationModel, type ParamModel, type RequestBodyModel, type ResponseBodyModel } from '@redocly/client-generator';
+/**
+ * The emit configuration every operation shares. Bundling it into one value keeps
+ * it out of the positional parameter lists of the operation emitters (which would
+ * otherwise thread the same arguments through every layer, inviting transposition
+ * bugs). Per-call structural data (response type, ordered path params, …) stays an
+ * explicit argument; only this cross-cutting config travels as `ctx`.
+ */
+export type EmitContext = {
+    argsStyle: ArgsStyle;
+    errorMode: ErrorMode;
+    dateType: DateType;
+    /** Names of every exported schema, used for `<Op>*` alias collision suppression. */
+    schemaNames: Set<string>;
+    /** Named schemas — used to resolve `$ref` / `allOf` wrappers on response-header types. */
+    schemas?: readonly NamedSchemaModel[];
+    /** Resolved auto-pagination per operation name (absent ⇒ nothing paginates). */
+    pagination?: ModelPagination;
+};
+/** The request-body TS type: special wrapper types per content-type, else the schema. */
+export declare function bodyTypeText(rb: RequestBodyModel, dateType: DateType, indent?: string): string;
+/** The `{ … }` type literal for a params object (query or headers), with per-prop JSDoc. */
+export declare function paramsTypeText(params: ParamModel[], dateType: DateType, indent?: string): string;
+/** The success-response type + kind (JSON preferred; binary/text fall back; deduped union). */
+export declare function responseText(responses: ResponseBodyModel[], dateType: DateType, indent?: string): {
+    type: string;
+    kind: 'json' | 'blob' | 'text' | 'void';
+};
+/** The deduped error-response body types, or `[]` when none. */
+export declare function errorTypeTexts(responses: ResponseBodyModel[], dateType: DateType, indent?: string): string[];
+/**
+ * How a flat-style call spells one operation's inputs. Every parameter sits at one level,
+ * and a REQUIRED object body contributes its own properties — an optional body cannot
+ * (omitting it and omitting its required properties would look the same), and neither can
+ * an array, scalar, or binary body, so those keep the `body` key.
+ *
+ * When one name appears in two layers (a path and a query parameter of the same name, which
+ * OpenAPI permits) a merged call cannot say which is which, so that operation keeps the
+ * namespaced shape. The caller reports it once.
+ */
+export declare function flatInputShape(op: OperationModel, schemas: readonly NamedSchemaModel[] | undefined): {
+    mergeBody: boolean;
+} | {
+    collisions: string[];
+};
+/** The `<Op>Variables` object type literal (see operation-aliases.ts for the contract). */
+export declare function variablesTypeText(op: OperationModel, name: string, ctx: EmitContext, indent?: string): string;
+/** `export type Ops = { <ident>: { args; result; item?; page?; kind? } }` — what `createClient<Ops>` consumes. */
+export declare function renderOpsType(model: ApiModel, idents: Map<string, string>, ctx: EmitContext): string;
+/** One operation's `<Op>*` aliases (Result/Error/Path/Query/Body/Headers/Cookies/Variables), collision-suppressed. */
+export declare function renderAliases(op: OperationModel, ctx: EmitContext): string;
+/**
+ * Schema names the ENTRY file's own types reference — the split layout's type-only
+ * import list. Derived from the IR (the exact sources the alias/Ops renderers type):
+ * every ref reachable from operation inputs, success responses, error responses
+ * (result mode only — throw mode never renders them), and pagination item schemas.
+ * Named schema BODIES are not expanded: a ref renders as its bare name.
+ */
+export declare function collectEntrySchemaRefs(model: ApiModel, ctx: EmitContext): string[];
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/generators/typescript/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAEvB,MAAM,2BAA2B,CAAC;AAWnC;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,oFAAoF;IACpF,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,gFAAgF;IAChF,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B,CAAC;AAIF,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAK,GAAG,MAAM,CAY1F;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAK,GAAG,MAAM,CAO5F;AAED,+FAA+F;AAC/F,wBAAgB,YAAY,CAC1B,SAAS,EAAE,iBAAiB,EAAE,EAC9B,QAAQ,EAAE,QAAQ,EAClB,MAAM,SAAK,GACV;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CAAE,CA2B3D;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,iBAAiB,EAAE,EAC9B,QAAQ,EAAE,QAAQ,EAClB,MAAM,SAAK,GACV,MAAM,EAAE,CAUV;AA+DD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,GAC/C;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAqBnD;AAUD,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,WAAW,EAChB,MAAM,SAAK,GACV,MAAM,CAsER;AAyDD,kHAAkH;AAClH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,GAAG,EAAE,WAAW,GACf,MAAM,CA6CR;AAED,sHAAsH;AACtH,wBAAgB,aAAa,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAiD1E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAiDlF"}