@redocly/client-generator 0.0.0-snapshot.1784554531

package/lib/emitters/jsdoc.js

@@ -0,0 +1,83 @@
+import { splitLines } from './support.js';
+import { escapeJsDoc } from './ts.js';
+/**
+ * The JSDoc body for a description + metadata as a single `\n`-joined string,
+ * or `undefined` when there's nothing to document. The AST emitters feed this
+ * to `ts.ts`'s `jsdoc` helper (which owns the `*`-prefixing and indentation),
+ * so this returns only the raw body — no comment delimiters, no padding.
+ */
+export function jsdocText(text, metadata) {
+    const lines = jsdocLines(text, metadata);
+    return lines.length === 0 ? undefined : lines.join('\n');
+}
+/**
+ * Build the body of a JSDoc block from a description and an optional metadata
+ * bag. Description lines come first (trimmed of leading/trailing blanks); then
+ * the metadata tag lines in a stable, source-driven order.
+ *
+ * Returns `[]` when there's nothing to render — callers use the empty result
+ * to skip emitting any JSDoc at all.
+ */
+function jsdocLines(text, metadata) {
+    const lines = [];
+    if (text && text.trim()) {
+        lines.push(...trimLines(splitLines(text)));
+    }
+    if (metadata) {
+        lines.push(...formatMetadata(metadata));
+    }
+    return lines;
+}
+/**
+ * Project a SchemaMetadata bag into JSDoc tag lines.
+ *
+ * Order matches the (near-)spec order so generated output is deterministic and
+ * diff-stable. `pattern` is escaped so an embedded `*​/` cannot terminate the
+ * surrounding JSDoc block.
+ */
+function formatMetadata(metadata) {
+    const lines = [];
+    const push = (tag, value) => {
+        if (value === undefined) {
+            lines.push(`@${tag}`);
+        }
+        else {
+            lines.push(`@${tag} ${value}`);
+        }
+    };
+    if (metadata.minimum !== undefined)
+        push('minimum', metadata.minimum);
+    if (metadata.maximum !== undefined)
+        push('maximum', metadata.maximum);
+    if (metadata.exclusiveMinimum !== undefined)
+        push('exclusiveMinimum', metadata.exclusiveMinimum);
+    if (metadata.exclusiveMaximum !== undefined)
+        push('exclusiveMaximum', metadata.exclusiveMaximum);
+    if (metadata.minLength !== undefined)
+        push('minLength', metadata.minLength);
+    if (metadata.maxLength !== undefined)
+        push('maxLength', metadata.maxLength);
+    if (metadata.pattern !== undefined)
+        push('pattern', escapeJsDoc(metadata.pattern));
+    if (metadata.minItems !== undefined)
+        push('minItems', metadata.minItems);
+    if (metadata.maxItems !== undefined)
+        push('maxItems', metadata.maxItems);
+    if (metadata.uniqueItems === true)
+        push('uniqueItems');
+    if (metadata.format !== undefined)
+        push('format', metadata.format);
+    if (metadata.deprecated === true)
+        push('deprecated');
+    return lines;
+}
+function trimLines(lines) {
+    let start = 0;
+    let end = lines.length;
+    while (start < end && lines[start] === '')
+        start++;
+    while (end > start && lines[end - 1] === '')
+        end--;
+    return lines.slice(start, end);
+}
+//# sourceMappingURL=jsdoc.js.map

package/lib/emitters/jsdoc.js.map

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

package/lib/emitters/mock.d.ts

@@ -0,0 +1,22 @@
+import { type ApiModel } from '../intermediate-representation/model.js';
+import type { DateType } from './types.js';
+export type MockOptions = {
+    /** Import specifier for the sdk entry the schema types live in. */
+    sdkModule: string;
+    /** Must match the sdk's `--date-type`: under `'Date'` the sampler bakes date
+     *  fields as `new Date(...)` so the mock data matches the `Date`-typed sdk. */
+    dateType?: DateType;
+    /**
+     * How factory/handler bodies produce data. `'baked'` (default) inlines deterministic
+     * literals from the sampler (zero-dep, contract-faithful). `'faker'` emits
+     * `@faker-js/faker` calls for realistic data — reproducible when `mockSeed` is set —
+     * making `@faker-js/faker` the consumer's dev-dep. Factory signatures are identical
+     * across modes, so a consumer can flip this without changing call sites.
+     */
+    mockData?: 'baked' | 'faker';
+    /** When set in `'faker'` mode, emit a top-level `faker.seed(<n>);` so runs reproduce. */
+    mockSeed?: number;
+};
+/** Render the full `*.mocks.ts` source. `''` when the model has no operations. */
+export declare function renderMockModule(model: ApiModel, opts: MockOptions): string;
+//# sourceMappingURL=mock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/emitters/mock.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,QAAQ,EAKd,MAAM,yCAAyC,CAAC;AAMjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,MAAM,MAAM,WAAW,GAAG;IACxB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB;mFAC+E;IAC/E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAYF,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAqB3E"}

package/lib/emitters/mock.js

@@ -0,0 +1,243 @@
+// Emits a `*.mocks.ts` module: a `create<Schema>(overrides?)` data factory per
+// named schema, an `<op>Handler(override?)` MSW request handler per operation
+// (its primary success response), and an aggregated `handlers` array. Response
+// data is baked at codegen time via the sampler (`sampleValue`) and printed as
+// TypeScript literals through `ts.factory`, so the generated module depends only
+// on `msw` — the real client stays zero-dependency.
+import { isPlainObject } from '@redocly/openapi-core';
+import { allOperations, } from '../intermediate-representation/model.js';
+import { fakerExpression } from './faker.js';
+import { safeIdent } from './identifier.js';
+import { sampleValue, SampleExpression } from './sample.js';
+import { pascalCase } from './support.js';
+import { literalExpression, parseExpression, printStatements, ts } from './ts.js';
+const { factory } = ts;
+/** The body expression for `schema` under the active data mode: a baked literal tree
+ *  (`'baked'`) or a tree of `@faker-js/faker` calls (`'faker'`). Both honor `dateType`
+ *  and the binary/Blob type demand; the faker path inlines refs with the same cycle
+ *  guard as the baked sampler, so neither recurses forever on a cyclic schema. */
+function bodyExpression(schema, model, opts) {
+    return opts.mockData === 'faker'
+        ? fakerExpression(schema, model.schemas, { dateType: opts.dateType })
+        : literal(sampleValue(schema, model.schemas, { dateType: opts.dateType }));
+}
+/** Render the full `*.mocks.ts` source. `''` when the model has no operations. */
+export function renderMockModule(model, opts) {
+    const operations = allOperations(model.services);
+    if (operations.length === 0)
+        return '';
+    const factories = model.schemas.map((s) => factoryFor(s, model, opts));
+    const handlers = operations.flatMap((op) => [
+        handlerFor(op, model, opts),
+        ...(op.errorResponses.length > 0 ? [errorHandlerFor(op, model, opts)] : []),
+    ]);
+    const typeImport = schemaTypeImport(model, opts);
+    // Faker mode imports `faker` (the consumer's dev-dep) and, with a seed, pins it once
+    // at module top so every run reproduces. Baked mode emits neither (stays zero-dep).
+    const fakerImport = opts.mockData === 'faker' ? "import { faker } from '@faker-js/faker';\n" : '';
+    const seed = opts.mockData === 'faker' && opts.mockSeed !== undefined ? [seedStatement(opts.mockSeed)] : [];
+    return `import { http, HttpResponse } from 'msw';\n${fakerImport}\n${printStatements([
+        ...typeImport,
+        ...seed,
+        ...factories,
+        ...handlers,
+        handlersArray(operations),
+    ])}`;
+}
+/** `faker.seed(<n>);` — pins faker's PRNG so a seeded faker-mode module reproduces. */
+function seedStatement(seed) {
+    return factory.createExpressionStatement(factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier('faker'), 'seed'), undefined, [factory.createNumericLiteral(seed)]));
+}
+/**
+ * `import type { A, B, … } from '<sdkModule>';` — the named-schema types the factories
+ * reference (`create<Pascal>` returns/accepts `<Pascal>`). Sorted for stable output.
+ * Empty when the model has no named schemas (so no type import is emitted). Importing
+ * the schema types also shadows globals of the same name (e.g. an `Error` schema) so the
+ * factory return types resolve to the generated type, not `globalThis.Error`.
+ */
+function schemaTypeImport(model, opts) {
+    if (model.schemas.length === 0)
+        return [];
+    const names = model.schemas.map((s) => pascalCase(s.name)).sort();
+    return [
+        factory.createImportDeclaration(undefined, factory.createImportClause(true, undefined, factory.createNamedImports(names.map((name) => factory.createImportSpecifier(false, undefined, factory.createIdentifier(name))))), factory.createStringLiteral(opts.sdkModule)),
+    ];
+}
+/** `export function create<Pascal>(overrides?: Partial<Pascal>): Pascal { return { …sampled, ...overrides }; }`. */
+function factoryFor(named, model, opts) {
+    const pascal = pascalCase(named.name);
+    const sampled = bodyExpression(named.schema, model, opts);
+    const typeRef = factory.createTypeReferenceNode(pascal);
+    // Spreading `Partial<Union>` (the override type of a union schema) distributes into
+    // `Partial<A> | Partial<B>`, which widens any discriminant property (e.g. `category`)
+    // and defeats narrowing — TS can no longer place the literal in a single union member.
+    // The sampled object is already a complete, correct member, so re-assert the type.
+    const body = named.schema.kind === 'union'
+        ? factory.createAsExpression(spreadOverrides(sampled, 'overrides'), typeRef)
+        : spreadOverrides(sampled, 'overrides');
+    return factory.createFunctionDeclaration([factory.createModifier(ts.SyntaxKind.ExportKeyword)], undefined, `create${pascal}`, undefined, [
+        factory.createParameterDeclaration(undefined, undefined, 'overrides', factory.createToken(ts.SyntaxKind.QuestionToken), factory.createTypeReferenceNode('Partial', [typeRef])),
+    ], typeRef, factory.createBlock([factory.createReturnStatement(body)], true));
+}
+/** `export const <op>Handler = (override?: <OverrideType>) => http.<method>('<path>', () => <response>);`. */
+function handlerFor(op, model, opts) {
+    const arrow = factory.createArrowFunction(undefined, undefined, [
+        factory.createParameterDeclaration(undefined, undefined, 'override', factory.createToken(ts.SyntaxKind.QuestionToken), overrideType(op)),
+    ], undefined, factory.createToken(ts.SyntaxKind.EqualsGreaterThanToken), handlerCall(op, model, opts));
+    return factory.createVariableStatement([factory.createModifier(ts.SyntaxKind.ExportKeyword)], factory.createVariableDeclarationList([factory.createVariableDeclaration(`${op.name}Handler`, undefined, undefined, arrow)], ts.NodeFlags.Const));
+}
+/**
+ * `export const <op>ErrorHandler = (status: <StatusUnion>, body?: <BodyType>) =>
+ *    http.<method>("<mswPath>", () => HttpResponse.json(body ?? <bakedSample>, { status }));`
+ *
+ * Opt-in (not added to `handlers`): `server.use(getPetErrorHandler(404))` overrides the
+ * happy path with an error. `<StatusUnion>` is the declared error statuses as literals
+ * (plus `number` when a `default` error is present, so any status is allowed). The baked
+ * fallback samples the FIRST error response's schema.
+ */
+function errorHandlerFor(op, model, opts) {
+    const first = op.errorResponses[0];
+    const baked = bodyExpression(first.schema, model, opts);
+    const body = factory.createBinaryExpression(factory.createIdentifier('body'), factory.createToken(ts.SyntaxKind.QuestionQuestionToken), baked);
+    const resolver = factory.createArrowFunction(undefined, undefined, [], undefined, factory.createToken(ts.SyntaxKind.EqualsGreaterThanToken), factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier('HttpResponse'), 'json'), undefined, [
+        body,
+        factory.createObjectLiteralExpression([factory.createShorthandPropertyAssignment('status')], false),
+    ]));
+    const call = factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier('http'), op.method), undefined, [factory.createStringLiteral(mswPath(op.path)), resolver]);
+    const arrow = factory.createArrowFunction(undefined, undefined, [
+        factory.createParameterDeclaration(undefined, undefined, 'status', undefined, errorStatusType(op)),
+        factory.createParameterDeclaration(undefined, undefined, 'body', factory.createToken(ts.SyntaxKind.QuestionToken), errorBodyType(op)),
+    ], undefined, factory.createToken(ts.SyntaxKind.EqualsGreaterThanToken), call);
+    return factory.createVariableStatement([factory.createModifier(ts.SyntaxKind.ExportKeyword)], factory.createVariableDeclarationList([factory.createVariableDeclaration(`${op.name}ErrorHandler`, undefined, undefined, arrow)], ts.NodeFlags.Const));
+}
+/**
+ * A union of the op's declared numeric error statuses (as literals); `number` is used in place
+ * of a literal whenever a `default` error is present, so any status is accepted. De-duped, since
+ * a multi-media-type error contributes the same status more than once.
+ */
+function errorStatusType(op) {
+    const codes = [
+        ...new Set(op.errorResponses.filter((r) => r.status !== 'default').map((r) => r.status)),
+    ];
+    const members = codes.map((c) => factory.createLiteralTypeNode(factory.createNumericLiteral(c)));
+    // A `default` error means any status is valid, so widen the union with `number`.
+    if (op.errorResponses.some((r) => r.status === 'default')) {
+        members.push(factory.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword));
+    }
+    return members.length === 1 ? members[0] : factory.createUnionTypeNode(members);
+}
+/**
+ * The `body?` type: the union of the error responses' body types — `ref` bodies map to their
+ * named type, anything else to `unknown` (matching how the success handler types its override
+ * loosely). De-duped by printed name.
+ */
+function errorBodyType(op) {
+    const names = new Set();
+    let hasUnknown = false;
+    for (const r of op.errorResponses) {
+        if (r.schema.kind === 'ref')
+            names.add(pascalCase(r.schema.name));
+        else
+            hasUnknown = true;
+    }
+    const members = [...names].map((n) => factory.createTypeReferenceNode(n));
+    if (hasUnknown || members.length === 0) {
+        members.push(factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword));
+    }
+    return members.length === 1 ? members[0] : factory.createUnionTypeNode(members);
+}
+/**
+ * The static type of a handler's `override?` parameter, matching how the response uses it.
+ * A `ref` success body forwards `override` to `create<Schema>(override)` (whose parameter is
+ * `Partial<Schema>`), so the override is `Partial<Schema>`. Otherwise `override` is either spread
+ * into an inline object literal or unused, so `Record<string, unknown>` types it without error.
+ */
+function overrideType(op) {
+    const success = op.successResponses[0];
+    if (success?.schema.kind === 'ref') {
+        return factory.createTypeReferenceNode('Partial', [
+            factory.createTypeReferenceNode(pascalCase(success.schema.name)),
+        ]);
+    }
+    return factory.createTypeReferenceNode('Record', [
+        factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
+        factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword),
+    ]);
+}
+/** `http.<method>('<mswPath>', () => <responseExpr>)`. */
+function handlerCall(op, model, opts) {
+    const resolver = factory.createArrowFunction(undefined, undefined, [], undefined, factory.createToken(ts.SyntaxKind.EqualsGreaterThanToken), responseExpression(op, model, opts));
+    return factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier('http'), op.method), undefined, [factory.createStringLiteral(mswPath(op.path)), resolver]);
+}
+/**
+ * The handler's response. A primary success body becomes `HttpResponse.json(…)`:
+ * a `ref` body calls its named `create<Schema>(override)` factory; an inline body
+ * is sampled and printed in place with `...override` spread in. A success with no
+ * usable body (an `unknown` schema, or no success response at all) becomes a
+ * body-less `new HttpResponse(null, { status })`. The status is the success
+ * response's declared code, or 200 when it's `default`/absent.
+ */
+function responseExpression(op, model, opts) {
+    const success = op.successResponses[0];
+    const status = statusCode(success?.status);
+    if (!success || success.schema.kind === 'unknown')
+        return emptyResponse(status);
+    const data = success.schema.kind === 'ref'
+        ? factory.createCallExpression(factory.createIdentifier(`create${pascalCase(success.schema.name)}`), undefined, [factory.createIdentifier('override')])
+        : spreadOverrides(bodyExpression(success.schema, model, opts), 'override');
+    // `HttpResponse.json(x)` already defaults to 200, so only pass `{ status }` when it differs.
+    const args = status === 200 ? [data] : [data, statusInit(status)];
+    return factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier('HttpResponse'), 'json'), undefined, args);
+}
+/** Numeric status for a response, mapping `default`/absent to 200. */
+function statusCode(status) {
+    return typeof status === 'number' ? status : 200;
+}
+/** `{ status: <n> }`. */
+function statusInit(status) {
+    return factory.createObjectLiteralExpression([factory.createPropertyAssignment('status', factory.createNumericLiteral(status))], false);
+}
+/** `new HttpResponse(null, { status: <n> })`. */
+function emptyResponse(status) {
+    return factory.createNewExpression(factory.createIdentifier('HttpResponse'), undefined, [
+        factory.createNull(),
+        statusInit(status),
+    ]);
+}
+/** `export const handlers = [<op>Handler(), …];`. */
+function handlersArray(operations) {
+    const elements = operations.map((op) => factory.createCallExpression(factory.createIdentifier(`${op.name}Handler`), undefined, []));
+    return factory.createVariableStatement([factory.createModifier(ts.SyntaxKind.ExportKeyword)], factory.createVariableDeclarationList([
+        factory.createVariableDeclaration('handlers', undefined, undefined, factory.createArrayLiteralExpression(elements, false)),
+    ], ts.NodeFlags.Const));
+}
+/** Spread `<spreadName>` into an object literal; non-object values pass through unchanged. */
+function spreadOverrides(value, spreadName) {
+    if (!ts.isObjectLiteralExpression(value))
+        return value;
+    return factory.createObjectLiteralExpression([...value.properties, factory.createSpreadAssignment(factory.createIdentifier(spreadName))], true);
+}
+/** `/pets/{petId}` → `*​/pets/:petId` — MSW path with a wildcard origin and `:param` segments. */
+function mswPath(path) {
+    return `*${path.replace(/\{([^{}]+)\}/g, ':$1')}`;
+}
+/** Recursively print a sampled JS value as a TypeScript literal expression. Containers
+ *  stay local rather than delegating to the shared `literalExpression`: sampled trees
+ *  print multiline and may nest a `SampleExpression` at any depth. */
+function literal(value) {
+    if (value instanceof SampleExpression)
+        return parseExpression(value.code);
+    if (Array.isArray(value)) {
+        return factory.createArrayLiteralExpression(value.map(literal), true);
+    }
+    if (isPlainObject(value)) {
+        const entries = Object.entries(value);
+        return factory.createObjectLiteralExpression(entries.map(([key, v]) => {
+            const safe = safeIdent(key);
+            const name = safe === key ? factory.createIdentifier(key) : factory.createStringLiteral(key);
+            return factory.createPropertyAssignment(name, literal(v));
+        }), true);
+    }
+    return literalExpression(value);
+}
+//# sourceMappingURL=mock.js.map

package/lib/emitters/mock.js.map

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

package/lib/emitters/operation-aliases.d.ts

@@ -0,0 +1,27 @@
+import type { OperationModel, ParamModel } from '../intermediate-representation/model.js';
+import type { EmitContext } from './operations.js';
+import { ts } from './ts.js';
+/**
+ * Emit derived type aliases for an operation so callers can name intermediate
+ * values without re-deriving via `Awaited<ReturnType<...>>` plumbing.
+ *
+ * `*Result` is always emitted (even for `void`). The others are conditional on
+ * the operation actually having the corresponding inputs — emitting empty
+ * `*Params = {}` or `*Body = unknown` aliases would just be noise.
+ */
+export declare function renderOperationAliases(op: OperationModel, responseType: ts.TypeNode, orderedPathParams: ParamModel[], pathParamIdent: Map<string, string>, errorAlias: string, errorMembers: ts.TypeNode[], ctx: EmitContext, emitResultAndError?: boolean, pathKeys?: 'ident' | 'wire'): ts.Statement[];
+/**
+ * An SSE op's input aliases (`*Params` / `*Body` / `*Headers` / `*Variables`) — but NOT
+ * `*Result`/`*Error`, which describe a one-shot response an event stream has no equivalent of.
+ * Passes the real `schemaNames` so the input aliases still get collision suppression, and sets
+ * `emitResultAndError = false` to omit the result/error pair.
+ */
+export declare function sseAliases(op: OperationModel, orderedPathParams: ParamModel[], pathParamIdent: Map<string, string>, ctx: EmitContext, pathKeys?: 'ident' | 'wire'): ts.Statement[];
+/**
+ * The `<Op>Variables` object type literal (the body of the alias, reused inline by the grouped
+ * signature when the alias name itself collides). Each `params`/`body`/`headers` property
+ * references its `<Op>X` alias, or inlines the type when that alias name collides with a schema
+ * (so a suppressed alias is never referenced).
+ */
+export declare function variablesTypeLiteral(op: OperationModel, name: string, orderedPathParams: ParamModel[], pathParamIdent: Map<string, string>, ctx: EmitContext, pathKeys?: 'ident' | 'wire'): ts.TypeNode;
+//# sourceMappingURL=operation-aliases.d.ts.map

package/lib/emitters/operation-aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-aliases.d.ts","sourceRoot":"","sources":["../../src/emitters/operation-aliases.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAK1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAS,EAAE,EAAE,MAAM,SAAS,CAAC;AAKpC;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,cAAc,EAClB,YAAY,EAAE,EAAE,CAAC,QAAQ,EACzB,iBAAiB,EAAE,UAAU,EAAE,EAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,EAAE,CAAC,QAAQ,EAAE,EAC3B,GAAG,EAAE,WAAW,EAGhB,kBAAkB,UAAO,EAEzB,QAAQ,GAAE,OAAO,GAAG,MAAgB,GACnC,EAAE,CAAC,SAAS,EAAE,CA2DhB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,cAAc,EAClB,iBAAiB,EAAE,UAAU,EAAE,EAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,GAAG,EAAE,WAAW,EAChB,QAAQ,GAAE,OAAO,GAAG,MAAgB,GACnC,EAAE,CAAC,SAAS,EAAE,CAYhB;AA6CD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,UAAU,EAAE,EAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,GAAG,EAAE,WAAW,EAIhB,QAAQ,GAAE,OAAO,GAAG,MAAgB,GACnC,EAAE,CAAC,QAAQ,CAoDb"}

package/lib/emitters/operation-aliases.js

@@ -0,0 +1,138 @@
+// The `<Op>*` derived type-alias builders (`<Op>Result`/`Error`/`Params`/`Body`/`Headers`/`Variables`).
+// Split out of operations.ts: this is the cohesive cluster the sdk emits so callers can name
+// intermediate values. Reuses the shared type builders (operation-types.ts) and the block-wide
+// `EmitContext` (a type-only import from operations.ts — erased, so there is no runtime cycle).
+import { safeIdent } from './identifier.js';
+import { jsdocText } from './jsdoc.js';
+import { operationSignature } from './operation-signature.js';
+import { bodyTypeNode, paramsTypeLiteral, propertyKey } from './operation-types.js';
+import { pascalCase } from './support.js';
+import { jsdoc, ts } from './ts.js';
+import { schemaToTypeNode } from './types.js';
+const { factory } = ts;
+/**
+ * Emit derived type aliases for an operation so callers can name intermediate
+ * values without re-deriving via `Awaited<ReturnType<...>>` plumbing.
+ *
+ * `*Result` is always emitted (even for `void`). The others are conditional on
+ * the operation actually having the corresponding inputs — emitting empty
+ * `*Params = {}` or `*Body = unknown` aliases would just be noise.
+ */
+export function renderOperationAliases(op, responseType, orderedPathParams, pathParamIdent, errorAlias, errorMembers, ctx, 
+// SSE ops have no one-shot response, so they omit `*Result`/`*Error` and keep only the input
+// aliases.
+emitResultAndError = true, 
+// Threaded to the `<Op>Variables` body — see `variablesTypeLiteral`.
+pathKeys = 'ident') {
+    const { dateType, schemaNames } = ctx;
+    const name = pascalCase(op.name);
+    const aliases = [];
+    // Every derived alias is suppressed when its name collides with an exported schema (a
+    // duplicate `export type` is a TS2300 error). References to a suppressed alias inline the
+    // underlying type instead — see `renderOperationParts` (Result/Error) and `renderVariablesAlias`
+    // / the grouped signature (Params/Body/Headers/Variables).
+    // Emit `export type <Op>Result = …` unless its name collides with an exported schema. Two
+    // cases collide: self-referential (operation `search` returning schema `SearchResult` →
+    // `export type SearchResult = SearchResult;`, circular) and plain (operation `login` returning
+    // some other type while a `LoginResult` schema also exists). In both, call sites reference the
+    // response type directly (`renderOperationParts`), so the alias is redundant.
+    const resultName = `${name}Result`;
+    if (emitResultAndError && !schemaNames.has(resultName)) {
+        aliases.push(exportType(resultName, responseType));
+    }
+    // Result mode only, and only when the operation declares error responses: the typed `error`.
+    if (emitResultAndError && errorAlias && !schemaNames.has(errorAlias)) {
+        aliases.push(exportType(errorAlias, errorMembers.length === 1 ? errorMembers[0] : factory.createUnionTypeNode(errorMembers)));
+    }
+    if (op.queryParams.length > 0 && !schemaNames.has(`${name}Params`)) {
+        // Reuse the params type-literal builder so the alias body picks up per-prop
+        // JSDoc automatically — no second renderer to keep in sync.
+        aliases.push(exportType(`${name}Params`, paramsTypeLiteral(op.queryParams, dateType)));
+    }
+    if (op.requestBody && !schemaNames.has(`${name}Body`)) {
+        // Use the same content-type → TS-type mapping as the function signature, so
+        // `<Op>Body` matches the second-positional arg of the function exactly.
+        aliases.push(exportType(`${name}Body`, bodyTypeNode(op.requestBody, dateType)));
+    }
+    if (op.headerParams.length > 0 && !schemaNames.has(`${name}Headers`)) {
+        aliases.push(exportType(`${name}Headers`, paramsTypeLiteral(op.headerParams, dateType)));
+    }
+    if (!schemaNames.has(`${name}Variables`)) {
+        const variables = renderVariablesAlias(op, name, orderedPathParams, pathParamIdent, ctx, pathKeys);
+        if (variables)
+            aliases.push(variables);
+    }
+    return aliases;
+}
+/**
+ * An SSE op's input aliases (`*Params` / `*Body` / `*Headers` / `*Variables`) — but NOT
+ * `*Result`/`*Error`, which describe a one-shot response an event stream has no equivalent of.
+ * Passes the real `schemaNames` so the input aliases still get collision suppression, and sets
+ * `emitResultAndError = false` to omit the result/error pair.
+ */
+export function sseAliases(op, orderedPathParams, pathParamIdent, ctx, pathKeys = 'ident') {
+    return renderOperationAliases(op, factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword), orderedPathParams, pathParamIdent, '', [], ctx, false, pathKeys);
+}
+/** `export type <name> = <type>;` */
+function exportType(name, type) {
+    return factory.createTypeAliasDeclaration([factory.createModifier(ts.SyntaxKind.ExportKeyword)], name, undefined, type);
+}
+/**
+ * Combined inputs alias — a single object that bundles every positional input
+ * the operation function accepts. The seam React Query / SWR wrappers use:
+ *
+ *   useMutation({ mutationFn: (vars: UpdateOrderVariables) => updateOrder(vars.orderId, vars.params, vars.body) })
+ *
+ * Conventions:
+ * - Property order: path params (URL-template order), then `params`, then `body`,
+ *   then `headers`. Mirrors the function's positional argument order.
+ * - Path-param props carry the same JSDoc (description + schema metadata) the
+ *   function declaration omits.
+ * - `params?` is optional iff the function signature defaults to `= {}` (all query
+ *   params optional). Same rule for `body?` / `headers?`.
+ * - References `<Op>Params` / `<Op>Body` / `<Op>Headers` when those aliases were
+ *   also emitted, so the aliases stay in sync without duplicating their bodies.
+ *
+ * Returns `undefined` for operations with no inputs at all.
+ */
+function renderVariablesAlias(op, name, orderedPathParams, pathParamIdent, ctx, pathKeys) {
+    if (!operationSignature(op).hasInputs)
+        return undefined;
+    return exportType(name + 'Variables', variablesTypeLiteral(op, name, orderedPathParams, pathParamIdent, ctx, pathKeys));
+}
+/**
+ * The `<Op>Variables` object type literal (the body of the alias, reused inline by the grouped
+ * signature when the alias name itself collides). Each `params`/`body`/`headers` property
+ * references its `<Op>X` alias, or inlines the type when that alias name collides with a schema
+ * (so a suppressed alias is never referenced).
+ */
+export function variablesTypeLiteral(op, name, orderedPathParams, pathParamIdent, ctx, 
+// How path-param properties are keyed: `'ident'` (default) uses the sanitized identifier
+// that doubles as the flat positional argument; `'wire'` (package mode) uses the spec's
+// param name — quoted when needed — because the runtime routes `args[param.name]`.
+pathKeys = 'ident') {
+    const { dateType, schemaNames } = ctx;
+    const props = [];
+    for (const p of orderedPathParams) {
+        // Ident mode: same safe identifier the function uses, so a wrapper can map
+        // `vars.<ident>` straight onto the positional argument.
+        const sig = factory.createPropertySignature(undefined, pathKeys === 'wire' ? propertyKey(safeIdent(p.name)) : pathParamIdent.get(p.name), undefined, schemaToTypeNode(p.schema, dateType));
+        const doc = jsdocText(p.description, p.schema.metadata);
+        props.push(doc === undefined ? sig : jsdoc(sig, doc));
+    }
+    if (op.queryParams.length > 0) {
+        props.push(inputProp('params', `${name}Params`, () => paramsTypeLiteral(op.queryParams, dateType), op.queryParams.some((p) => p.required), schemaNames));
+    }
+    if (op.requestBody) {
+        props.push(inputProp('body', `${name}Body`, () => bodyTypeNode(op.requestBody, dateType), op.requestBody.required, schemaNames));
+    }
+    if (op.headerParams.length > 0) {
+        props.push(inputProp('headers', `${name}Headers`, () => paramsTypeLiteral(op.headerParams, dateType), op.headerParams.some((p) => p.required), schemaNames));
+    }
+    return factory.createTypeLiteralNode(props);
+}
+/** A `<key>(?): <Alias>` property, or an inline-typed one when `<Alias>` collides with a schema. */
+function inputProp(key, alias, inlineType, required, schemaNames) {
+    return factory.createPropertySignature(undefined, key, required ? undefined : factory.createToken(ts.SyntaxKind.QuestionToken), schemaNames.has(alias) ? inlineType() : factory.createTypeReferenceNode(alias));
+}
+//# sourceMappingURL=operation-aliases.js.map

package/lib/emitters/operation-aliases.js.map

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

package/lib/emitters/operation-signature.d.ts

@@ -0,0 +1,23 @@
+import type { OperationModel, ParamModel } from '../intermediate-representation/model.js';
+/** A path parameter paired with the unique JS identifier used for it in flat mode. */
+export type SignaturePathParam = {
+    param: ParamModel;
+    ident: string;
+};
+export type OperationSignature = {
+    /** Path params in URL-template order, each with its unique JS identifier. */
+    pathParams: SignaturePathParam[];
+    /** Slot presence, in the order flat-mode arguments follow the path params. */
+    hasQuery: boolean;
+    hasBody: boolean;
+    hasHeaders: boolean;
+    /** Any input at all — i.e. a `<Op>Variables` type exists for the operation. */
+    hasInputs: boolean;
+    /** Grouped mode: whether `vars` is required (else it defaults to `= {}`). */
+    varsRequired: boolean;
+    /** The `<Op>Variables` type-alias name. */
+    variablesTypeName: string;
+};
+/** 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/emitters/operation-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-signature.d.ts","sourceRoot":"","sources":["../../src/emitters/operation-signature.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAI1F,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6EAA6E;IAC7E,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,YAAY,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,GAAG,kBAAkB,CA0BzE"}

package/lib/emitters/operation-signature.js

@@ -0,0 +1,34 @@
+// The shared calling-convention description for an operation. Both the sdk (which
+// emits each operation's parameter list) and the wrapper generators (which emit the
+// forwarding call) derive their argument *order*, slot presence, and `<Op>Variables`
+// naming from this one source — so a flat-mode signature and its call site can never drift.
+import { uniqueIdent } from './identifier.js';
+import { pascalCase } from './support.js';
+/** Compute the calling-convention description for `op`. Pure; no AST. */
+export function operationSignature(op) {
+    const byName = new Map(op.pathParams.map((p) => [p.name, p]));
+    const ordered = [];
+    for (const match of op.path.matchAll(/\{([^{}]+)\}/g)) {
+        const p = byName.get(match[1]);
+        if (p)
+            ordered.push(p);
+    }
+    const used = new Set();
+    const pathParams = ordered.map((param) => ({ param, ident: uniqueIdent(param.name, used) }));
+    const hasQuery = op.queryParams.length > 0;
+    const hasBody = Boolean(op.requestBody);
+    const hasHeaders = op.headerParams.length > 0;
+    return {
+        pathParams,
+        hasQuery,
+        hasBody,
+        hasHeaders,
+        hasInputs: pathParams.length > 0 || hasQuery || hasBody || hasHeaders,
+        varsRequired: pathParams.length > 0 ||
+            op.queryParams.some((p) => p.required) ||
+            (op.requestBody?.required ?? false) ||
+            op.headerParams.some((p) => p.required),
+        variablesTypeName: `${pascalCase(op.name)}Variables`,
+    };
+}
+//# sourceMappingURL=operation-signature.js.map