@redocly/client-generator 0.0.0-snapshot.1784554531

package/lib/emitters/type-guards.js

@@ -0,0 +1,183 @@
+import { jsdoc, ts } from './ts.js';
+/**
+ * Emit `is<Member>(value): value is <Member>` type guards for every discriminated
+ * union with a usable discriminator — whether it is a top-level named schema
+ * (`MenuItem = A | B`) or nested inside one (e.g. the `items` of an array, the
+ * value of a property). Two discriminator sources:
+ *
+ * - Explicit: the union carries a `discriminator` (built from the spec).
+ * - Implicit: no discriminator, but every member is a ref to a named schema and
+ *   they all constrain one shared property to a distinct string `const`.
+ *
+ * Nested unions only qualify when every member is a ref to a named schema, so the
+ * `value` parameter is a clean union of exported types. Guard names are globally
+ * deduped (`is<Member>`), keeping the first in document order — so a top-level
+ * union wins its nicer `value: <UnionName>` parameter over a nested re-occurrence.
+ * Undiscriminated unions are skipped — TypeScript can't soundly narrow them.
+ * Returns the guard declarations as nodes (empty when no union narrows).
+ */
+export function typeGuardStatements(schemas) {
+    const byName = new Map(schemas.map((s) => [s.name, s.schema]));
+    const nodes = [];
+    const emitted = new Set();
+    for (const named of schemas) {
+        for (const site of collectUnionSites(named)) {
+            const discriminator = site.union.discriminator ?? detectImplicitDiscriminator(site.union, byName);
+            if (!discriminator)
+                continue;
+            // Group discriminant values by target schema so two mapping keys pointing at
+            // the same type produce one guard (a duplicate `is<Name>` would not compile).
+            const valuesByTarget = new Map();
+            for (const entry of discriminator.mapping) {
+                if (!byName.has(entry.schemaName))
+                    continue;
+                const existing = valuesByTarget.get(entry.schemaName);
+                if (existing)
+                    existing.push(entry.value);
+                else
+                    valuesByTarget.set(entry.schemaName, [entry.value]);
+            }
+            for (const [schemaName, values] of valuesByTarget) {
+                const guardName = `is${schemaName}`;
+                if (emitted.has(guardName))
+                    continue;
+                emitted.add(guardName);
+                nodes.push(buildTypeGuard(site.makeParamType(), site.label, discriminator.propertyName, schemaName, values));
+            }
+        }
+    }
+    return nodes;
+}
+const { factory } = ts;
+/**
+ * The discriminated-union sites reachable from a named schema, in a stable order:
+ * the schema itself (when it is a union), then any nested unions found by walking
+ * its tree. A top-level union keeps its name as the guard parameter; nested unions
+ * use their inline member union.
+ */
+function collectUnionSites(named) {
+    const sites = [];
+    const root = named.schema;
+    if (root.kind === 'union') {
+        sites.push({
+            union: root,
+            label: named.name,
+            makeParamType: () => factory.createTypeReferenceNode(named.name),
+        });
+        for (const member of root.members)
+            collectNestedSites(member, sites);
+    }
+    else {
+        collectNestedSites(root, sites);
+    }
+    return sites;
+}
+/** Walk a schema subtree, recording each nested all-named-ref union as a site. */
+function collectNestedSites(schema, sites) {
+    switch (schema.kind) {
+        case 'union': {
+            const names = schema.members.map((m) => (m.kind === 'ref' ? m.name : undefined));
+            if (names.every((n) => n !== undefined)) {
+                sites.push({
+                    union: schema,
+                    label: names.join(' | '),
+                    makeParamType: () => factory.createUnionTypeNode(names.map((n) => factory.createTypeReferenceNode(n))),
+                });
+            }
+            for (const member of schema.members)
+                collectNestedSites(member, sites);
+            break;
+        }
+        case 'array':
+            collectNestedSites(schema.items, sites);
+            break;
+        case 'record':
+            collectNestedSites(schema.value, sites);
+            break;
+        case 'object':
+            for (const prop of schema.properties)
+                collectNestedSites(prop.schema, sites);
+            break;
+        case 'intersection':
+            for (const member of schema.members)
+                collectNestedSites(member, sites);
+            break;
+        // scalar / literal / enum / ref / null / unknown / omit have no nested unions.
+    }
+}
+/** `(value as Record<string, unknown>)[<prop>]` — the narrowed property access. */
+function propertyAccess(propertyName) {
+    const recordType = factory.createTypeReferenceNode('Record', [
+        factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
+        factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword),
+    ]);
+    return factory.createElementAccessExpression(factory.createAsExpression(factory.createIdentifier('value'), recordType), factory.createStringLiteral(propertyName));
+}
+function buildTypeGuard(paramType, unionLabel, propertyName, schemaName, values) {
+    const access = propertyAccess(propertyName);
+    const check = values.length === 1
+        ? factory.createBinaryExpression(access, factory.createToken(ts.SyntaxKind.EqualsEqualsEqualsToken), factory.createStringLiteral(values[0]))
+        : // `([...values] as readonly unknown[]).includes(<access>)`
+            factory.createCallExpression(factory.createPropertyAccessExpression(factory.createParenthesizedExpression(factory.createAsExpression(factory.createArrayLiteralExpression(values.map((v) => factory.createStringLiteral(v))), factory.createTypeOperatorNode(ts.SyntaxKind.ReadonlyKeyword, factory.createArrayTypeNode(factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword))))), 'includes'), undefined, [access]);
+    const fn = factory.createFunctionDeclaration([factory.createModifier(ts.SyntaxKind.ExportKeyword)], undefined, `is${schemaName}`, undefined, [factory.createParameterDeclaration(undefined, undefined, 'value', undefined, paramType)], factory.createTypePredicateNode(undefined, 'value', factory.createTypeReferenceNode(schemaName)), factory.createBlock([factory.createReturnStatement(check)], true));
+    return jsdoc(fn, `Narrow a \`${unionLabel}\` to \`${schemaName}\` via its \`${propertyName}\` discriminant.`);
+}
+/**
+ * Detect an implicit discriminator: every member is a ref to a named schema,
+ * and they all pin one shared property to a distinct string literal. Returns
+ * `undefined` if no such property exists (so the union is left without guards).
+ */
+function detectImplicitDiscriminator(union, byName) {
+    const memberNames = [];
+    for (const member of union.members) {
+        if (member.kind !== 'ref')
+            return undefined;
+        const target = byName.get(member.name);
+        if (!target)
+            return undefined;
+        memberNames.push(member.name);
+    }
+    if (memberNames.length < 2)
+        return undefined;
+    const literalsPerMember = memberNames.map((name) => literalPropsOf(byName.get(name)));
+    for (const propName of Object.keys(literalsPerMember[0])) {
+        if (!literalsPerMember.every((props) => propName in props))
+            continue;
+        const values = literalsPerMember.map((props) => props[propName]);
+        if (!values.every((v) => typeof v === 'string'))
+            continue;
+        if (new Set(values).size !== values.length)
+            continue;
+        return {
+            propertyName: propName,
+            mapping: memberNames.map((name, i) => ({
+                value: values[i],
+                schemaName: name,
+            })),
+        };
+    }
+    return undefined;
+}
+/**
+ * Collect a schema's literal-valued properties (name → const value), descending
+ * through `intersection` members (the shape `allOf` produces). Only inline
+ * object/intersection members are inspected; nested refs are not resolved.
+ */
+function literalPropsOf(schema) {
+    const out = {};
+    const collect = (s) => {
+        if (s.kind === 'object') {
+            for (const prop of s.properties) {
+                if (prop.schema.kind === 'literal')
+                    out[prop.name] = prop.schema.value;
+            }
+        }
+        else if (s.kind === 'intersection') {
+            for (const member of s.members)
+                collect(member);
+        }
+    };
+    collect(schema);
+    return out;
+}
+//# sourceMappingURL=type-guards.js.map

package/lib/emitters/type-guards.js.map

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

package/lib/emitters/types.d.ts

@@ -0,0 +1,23 @@
+import type { NamedSchemaModel, SchemaModel } from '../intermediate-representation/model.js';
+import { ts } from './ts.js';
+/**
+ * How named string enums are emitted:
+ * - `'union'`: only the string-literal union type (`type X = "a" | "b"`).
+ * - `'const-object'`: the union type *and* a sibling
+ *   `export const X = { a: "a", b: "b" } as const;` so callers can reference
+ *   the values at runtime (`X.a`).
+ */
+export type EnumStyle = 'union' | 'const-object';
+/**
+ * How `format: date-time`/`date` string fields are typed:
+ * - `'string'` (default): the wire shape — an ISO string.
+ * - `'Date'`: a `Date` reference. Opt-in; pair with the `transformers` generator
+ *   so the runtime value matches (the client stays zero-dep — `Date` is standard).
+ */
+export type DateType = 'string' | 'Date';
+/** The model type aliases (and const-object enum companions) as nodes. */
+export declare function typesStatements(schemas: NamedSchemaModel[], enumStyle: EnumStyle, dateType?: DateType): ts.Statement[];
+export declare function renderSchema(schema: SchemaModel, dateType?: DateType): string;
+/** Build the TypeScript type node for an IR schema. */
+export declare function schemaToTypeNode(schema: SchemaModel, dateType?: DateType): ts.TypeNode;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/emitters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAIhB,WAAW,EACZ,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAwC,EAAE,EAAE,MAAM,SAAS,CAAC;AAInE;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzC,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,SAAS,EAAE,SAAS,EACpB,QAAQ,GAAE,QAAmB,GAC5B,EAAE,CAAC,SAAS,EAAE,CAqBhB;AAwCD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAmB,GAAG,MAAM,CAEvF;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAE,QAAmB,GAAG,EAAE,CAAC,QAAQ,CA6ChG"}

package/lib/emitters/types.js

@@ -0,0 +1,127 @@
+import { isIdentifier, safeIdent } from './identifier.js';
+import { jsdocText } from './jsdoc.js';
+import { jsdoc, literalExpression, printNodes, ts } from './ts.js';
+const { factory } = ts;
+/** The model type aliases (and const-object enum companions) as nodes. */
+export function typesStatements(schemas, enumStyle, dateType = 'string') {
+    const nodes = [];
+    for (const s of schemas) {
+        nodes.push(jsdocOn(factory.createTypeAliasDeclaration([factory.createModifier(ts.SyntaxKind.ExportKeyword)], s.name, undefined, schemaToTypeNode(s.schema, dateType)), s.schema.description ?? s.description, s.schema.metadata));
+        if (enumStyle === 'const-object') {
+            const constObject = enumConstObject(s);
+            if (constObject)
+                nodes.push(constObject);
+        }
+    }
+    return nodes;
+}
+/**
+ * For a named **string** enum, build a runtime companion
+ * `export const X = { a: "a", … } as const;` that cohabits with the same-named
+ * type (TypeScript allows a type and value to share an identifier). This lets
+ * callers reference values at runtime (`X.a`) instead of retyping literals.
+ *
+ * Returns `undefined` (so only the type union is emitted) when:
+ * - the schema isn't a string enum (integer/boolean enums gain nothing), or
+ * - any value isn't a valid JS identifier (e.g. `"menu:read"`) — we don't emit
+ *   a half-usable object with quoted keys.
+ */
+function enumConstObject(named) {
+    const schema = named.schema;
+    if (schema.kind !== 'enum' || schema.scalar !== 'string')
+        return undefined;
+    if (!schema.values.every((v) => typeof v === 'string' && isIdentifier(v)))
+        return undefined;
+    const object = factory.createObjectLiteralExpression(schema.values.map((v) => factory.createPropertyAssignment(v, factory.createStringLiteral(v))), true);
+    return factory.createVariableStatement([factory.createModifier(ts.SyntaxKind.ExportKeyword)], factory.createVariableDeclarationList([
+        factory.createVariableDeclaration(named.name, undefined, undefined, factory.createAsExpression(object, factory.createTypeReferenceNode('const'))),
+    ], ts.NodeFlags.Const));
+}
+export function renderSchema(schema, dateType = 'string') {
+    return printNodes([schemaToTypeNode(schema, dateType)]);
+}
+/** Build the TypeScript type node for an IR schema. */
+export function schemaToTypeNode(schema, dateType = 'string') {
+    switch (schema.kind) {
+        case 'scalar':
+            return scalarTypeNode(schema.scalar, schema.metadata, dateType);
+        case 'ref':
+            return factory.createTypeReferenceNode(schema.name);
+        case 'literal':
+            return factory.createLiteralTypeNode(literalExpression(schema.value));
+        case 'enum': {
+            const members = schema.values.map((v) => factory.createLiteralTypeNode(literalExpression(v)));
+            // A single-value enum is just that literal — wrapping it in a one-member
+            // union would make the printer parenthesize it inside `T[]` (`("a")[]`).
+            return members.length === 1 ? members[0] : factory.createUnionTypeNode(members);
+        }
+        case 'null':
+            return factory.createLiteralTypeNode(factory.createNull());
+        case 'unknown':
+            return factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
+        case 'array':
+            // The printer parenthesizes union/intersection element types itself
+            // (`(string | null)[]`), so just hand it the element node.
+            return factory.createArrayTypeNode(schemaToTypeNode(schema.items, dateType));
+        case 'record':
+            return factory.createTypeReferenceNode('Record', [
+                factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
+                schemaToTypeNode(schema.value, dateType),
+            ]);
+        case 'object':
+            return factory.createTypeLiteralNode(schema.properties.map((p) => propertySignature(p, dateType)));
+        case 'union':
+            return factory.createUnionTypeNode(schema.members.map((m) => schemaToTypeNode(m, dateType)));
+        case 'intersection':
+            return factory.createIntersectionTypeNode(schema.members.map((m) => schemaToTypeNode(m, dateType)));
+        case 'omit':
+            return factory.createTypeReferenceNode('Omit', [
+                factory.createTypeReferenceNode(schema.base),
+                factory.createUnionTypeNode(schema.keys.map((k) => factory.createLiteralTypeNode(factory.createStringLiteral(k)))),
+            ]);
+    }
+}
+function propertySignature(p, dateType) {
+    // `readOnly` (server-managed) props get the `readonly` modifier so consumer
+    // write-type utilities (OmitReadOnly<T>) can strip them and assignment is
+    // flagged. Request-body types already drop these via `Omit` in the IR.
+    const modifiers = p.readOnly
+        ? [factory.createModifier(ts.SyntaxKind.ReadonlyKeyword)]
+        : undefined;
+    const sig = factory.createPropertySignature(modifiers, propertyName(p.name), p.required ? undefined : factory.createToken(ts.SyntaxKind.QuestionToken), schemaToTypeNode(p.schema, dateType));
+    return jsdocOn(sig, p.description, p.schema.metadata);
+}
+/** A property name: a bare identifier when valid, a quoted string literal otherwise. */
+function propertyName(name) {
+    const safe = safeIdent(name);
+    return safe === name ? factory.createIdentifier(name) : factory.createStringLiteral(name);
+}
+function scalarTypeNode(kind, metadata, dateType) {
+    switch (kind) {
+        case 'string':
+            // `format: binary` is raw byte content (file uploads / octet-stream), not text —
+            // surface it as `Blob` (the web standard; a `File` is assignable to it). `byte`
+            // (base64) stays a `string`.
+            if (metadata?.format === 'binary') {
+                return factory.createTypeReferenceNode('Blob');
+            }
+            // Opt-in: a `date-time`/`date` string surfaces as `Date` under `dateType:
+            // 'Date'`; everything else (and the default) stays the `string` keyword.
+            if (dateType === 'Date' &&
+                (metadata?.format === 'date-time' || metadata?.format === 'date')) {
+                return factory.createTypeReferenceNode('Date');
+            }
+            return factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword);
+        case 'number':
+        case 'integer':
+            return factory.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword);
+        case 'boolean':
+            return factory.createKeywordTypeNode(ts.SyntaxKind.BooleanKeyword);
+    }
+}
+/** Attach a JSDoc block (description + metadata tags) to `node`, if any. */
+function jsdocOn(node, text, metadata) {
+    const body = jsdocText(text, metadata);
+    return body === undefined ? node : jsdoc(node, body);
+}
+//# sourceMappingURL=types.js.map

package/lib/emitters/types.js.map

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

package/lib/emitters/wrapper-support.d.ts

@@ -0,0 +1,40 @@
+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:
+ *
+ * - **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 declare function wrappableOperations(model: ApiModel, label: string): OperationModel[];
+/** Query operations are the safe, cacheable methods. Everything else is a mutation. */
+export declare function isQuery(op: OperationModel): boolean;
+/** Whether the operation has any inputs — i.e. a `<Op>Variables` type exists in the sdk. */
+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?: RequestOptions` parameter. */
+export declare function initParam(): ts.ParameterDeclaration;
+/**
+ * The forwarding call to the sdk operation function. Argument order comes from the
+ * shared `operationSignature`, so it lines up with the sdk's parameter list by
+ * construction. `grouped` passes the source object (when inputs); `flat` spreads
+ * `<source>.<pathIdent>` (URL-template order), then `<source>.params` / `.body` /
+ * `.headers` for the slots the op has. `init` is appended last when `withInit`
+ * (the sdk function's trailing `RequestOptions`).
+ */
+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

package/lib/emitters/wrapper-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper-support.d.ts","sourceRoot":"","sources":["../../src/emitters/wrapper-support.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAGxF,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAI7B;;;;;;;;;;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,yCAAyC;AACzC,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,GAAG,EAAE,CAAC,oBAAoB,CAQrE;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,IAAI,EAAE,CAAC,oBAAoB,CAQnD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,GAChB,EAAE,CAAC,UAAU,CAkBf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,GAChB,EAAE,CAAC,SAAS,CAkBd"}

package/lib/emitters/wrapper-support.js

@@ -0,0 +1,112 @@
+// Shared support for the data-fetching wrapper generators (`swr`, `tanstack-query`).
+// Both wrap the sdk's exported operation functions, so they agree on which operations
+// are wrappable and on the `vars`/`init` parameter shape. Keeping that agreement in one
+// place stops the two emitters from drifting (and makes a third adapter cheap). The
+// per-operation factory/hook bodies stay in each emitter — only the cross-cutting
+// calling-convention pieces live here.
+import { logger } from '@redocly/openapi-core';
+import { operationSignature } from './operation-signature.js';
+import { isSseOp } from './sse.js';
+import { ts } from './ts.js';
+const { factory } = ts;
+/**
+ * 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(isSseOp);
+    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) => !isSseOp(op) && 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) => !isSseOp(op) && !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;
+}
+/** A `vars: <Op>Variables` parameter. */
+export function varsParam(op) {
+    return factory.createParameterDeclaration(undefined, undefined, 'vars', undefined, factory.createTypeReferenceNode(variablesName(op)));
+}
+/** An `init?: RequestOptions` parameter. */
+export function initParam() {
+    return factory.createParameterDeclaration(undefined, undefined, 'init', factory.createToken(ts.SyntaxKind.QuestionToken), factory.createTypeReferenceNode('RequestOptions'));
+}
+/**
+ * The forwarding call to the sdk operation function. Argument order comes from the
+ * shared `operationSignature`, so it lines up with the sdk's parameter list by
+ * construction. `grouped` passes the source object (when inputs); `flat` spreads
+ * `<source>.<pathIdent>` (URL-template order), then `<source>.params` / `.body` /
+ * `.headers` for the slots the op has. `init` is appended last when `withInit`
+ * (the sdk function's trailing `RequestOptions`).
+ */
+export function sdkCall(op, argsStyle, source, withInit) {
+    const sig = operationSignature(op);
+    const sourceIdent = factory.createIdentifier(source);
+    const args = [];
+    if (argsStyle === 'grouped') {
+        if (sig.hasInputs)
+            args.push(sourceIdent);
+    }
+    else {
+        for (const { ident } of sig.pathParams) {
+            args.push(factory.createPropertyAccessExpression(sourceIdent, ident));
+        }
+        if (sig.hasQuery)
+            args.push(factory.createPropertyAccessExpression(sourceIdent, 'params'));
+        if (sig.hasBody)
+            args.push(factory.createPropertyAccessExpression(sourceIdent, 'body'));
+        if (sig.hasHeaders)
+            args.push(factory.createPropertyAccessExpression(sourceIdent, 'headers'));
+    }
+    if (withInit)
+        args.push(factory.createIdentifier('init'));
+    return factory.createCallExpression(factory.createIdentifier(op.name), undefined, args);
+}
+/**
+ * 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 function sdkNamedImport(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.map((name) => factory.createImportSpecifier(false, undefined, factory.createIdentifier(name))),
+        ...types.map((name) => factory.createImportSpecifier(true, undefined, factory.createIdentifier(name))),
+    ];
+    return factory.createImportDeclaration(undefined, factory.createImportClause(false, undefined, factory.createNamedImports(specifiers)), factory.createStringLiteral(sdkModule));
+}
+//# sourceMappingURL=wrapper-support.js.map

package/lib/emitters/wrapper-support.js.map

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

package/lib/emitters/zod.d.ts

@@ -0,0 +1,13 @@
+import { type ApiModel, type SchemaModel } from '../intermediate-representation/model.js';
+import { ts } from './ts.js';
+type SchemaByName = ReadonlyMap<string, SchemaModel>;
+/** Map an IR schema to the Zod expression that validates it. */
+export declare function schemaToZodExpression(schema: SchemaModel, byName?: SchemaByName): ts.Expression;
+/**
+ * Render the full zod module source: the component schemas, then — when any operation
+ * has a JSON body — the `operationSchemas` map and the `zodValidation` middleware.
+ * `''` when there is nothing to emit.
+ */
+export declare function renderZodModule(model: ApiModel): string;
+export {};
+//# sourceMappingURL=zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/emitters/zod.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,QAAQ,EAKb,KAAK,WAAW,EACjB,MAAM,yCAAyC,CAAC;AAIjD,OAAO,EAA6C,EAAE,EAAE,MAAM,SAAS,CAAC;AA4BxE,KAAK,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAIrD,gEAAgE;AAChE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,MAAM,GAAE,YAAyB,GAChC,EAAE,CAAC,UAAU,CAEf;AA6XD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAWvD"}