@redocly/client-generator 0.0.0-snapshot.1784554531

package/lib/emitters/zod.js

@@ -0,0 +1,344 @@
+// Emits Zod schemas from the IR. Each named schema becomes an
+// `export const <Name>Schema = z.<…>;` built with `ts.factory`, mirroring the
+// type emitter (`types.ts`) but targeting runtime validators instead of types.
+// Operations with a JSON request or response body additionally land in the
+// `operationSchemas` map, which powers the `zodValidation` client middleware.
+//
+// Only the refinement methods stable across zod 3.23 and 4 are emitted
+// (`.min/.max/.int/.gt/.lt/.regex`); format helpers (`.email/.uuid/.url`) diverge
+// between major versions and are deferred. Refs become `z.lazy(() => …Schema)`,
+// which sidesteps declaration ordering and recursion uniformly.
+import { allOperations, } from '../intermediate-representation/model.js';
+import { safeIdent } from './identifier.js';
+import { isSseOp } from './sse.js';
+import { pascalCase } from './support.js';
+import { jsdoc, literalExpression, printStatements, ts } from './ts.js';
+const { factory } = ts;
+/** `<Name>Schema` — the const identifier a named schema is bound to. */
+function schemaConstName(name) {
+    return `${pascalCase(name)}Schema`;
+}
+/** `z` member access: `z.<method>`. */
+function zMember(method) {
+    return factory.createPropertyAccessExpression(factory.createIdentifier('z'), method);
+}
+/** `z.<method>(...args)`. */
+function zCall(method, args = []) {
+    return factory.createCallExpression(zMember(method), undefined, args);
+}
+/** `<expr>.<method>(...args)` — chains a refinement onto a base expression. */
+function chain(expr, method, args = []) {
+    return factory.createCallExpression(factory.createPropertyAccessExpression(expr, method), undefined, args);
+}
+const NO_SCHEMAS = new Map();
+/** Map an IR schema to the Zod expression that validates it. */
+export function schemaToZodExpression(schema, byName = NO_SCHEMAS) {
+    return withRefinements(baseExpression(schema, byName), schema);
+}
+function baseExpression(schema, byName) {
+    switch (schema.kind) {
+        case 'scalar':
+            return scalarExpression(schema.scalar, schema.metadata);
+        case 'object':
+            return objectExpression(schema.properties, byName);
+        case 'array':
+            return zCall('array', [schemaToZodExpression(schema.items, byName)]);
+        case 'record':
+            return zCall('record', [zCall('string'), schemaToZodExpression(schema.value, byName)]);
+        case 'ref':
+            return lazyRef(schema.name);
+        case 'literal':
+            return zCall('literal', [literalExpression(schema.value)]);
+        case 'enum':
+            return enumExpression(schema.values);
+        case 'union':
+            return unionExpression(schema.members, byName);
+        case 'intersection':
+            return intersectionExpression(schema.members, byName);
+        case 'null':
+            return zCall('null');
+        case 'unknown':
+            return zCall('unknown');
+        case 'omit':
+            return omitExpression(schema.base, schema.keys, byName);
+    }
+}
+function scalarExpression(scalar, metadata) {
+    switch (scalar) {
+        case 'string':
+            // `format: binary` is typed as `Blob` (see types.ts); validate it as one so the zod
+            // schema agrees with the generated type instead of expecting a string.
+            if (metadata?.format === 'binary') {
+                return zCall('instanceof', [factory.createIdentifier('Blob')]);
+            }
+            return zCall('string');
+        case 'integer':
+            return chain(zCall('number'), 'int');
+        case 'number':
+            return zCall('number');
+        case 'boolean':
+            return zCall('boolean');
+    }
+}
+/** `z.object({ <key>: <expr>(.optional() when !required), … })`. */
+function objectExpression(properties, byName) {
+    const props = properties.map((p) => {
+        const value = p.required
+            ? schemaToZodExpression(p.schema, byName)
+            : chain(schemaToZodExpression(p.schema, byName), 'optional');
+        const safe = safeIdent(p.name);
+        const key = safe === p.name ? factory.createIdentifier(p.name) : factory.createStringLiteral(p.name);
+        return factory.createPropertyAssignment(key, value);
+    });
+    return zCall('object', [factory.createObjectLiteralExpression(props, props.length > 0)]);
+}
+/** `z.lazy(() => <Name>Schema)` — defers reference resolution to call time. */
+function lazyRef(name) {
+    const arrow = factory.createArrowFunction(undefined, undefined, [], undefined, factory.createToken(ts.SyntaxKind.EqualsGreaterThanToken), factory.createIdentifier(schemaConstName(name)));
+    return zCall('lazy', [arrow]);
+}
+/** All-string values → `z.enum([…])`; otherwise → a union of literals. */
+function enumExpression(values) {
+    if (values.every((v) => typeof v === 'string')) {
+        return zCall('enum', [
+            factory.createArrayLiteralExpression(values.map((v) => factory.createStringLiteral(v)), false),
+        ]);
+    }
+    return zCall('union', [
+        factory.createArrayLiteralExpression(values.map((v) => zCall('literal', [literalExpression(v)])), false),
+    ]);
+}
+/** `z.union([…])`; a single member collapses to that member's expression. */
+function unionExpression(members, byName) {
+    const exprs = members.map((member) => schemaToZodExpression(member, byName));
+    if (exprs.length === 1)
+        return exprs[0];
+    return zCall('union', [factory.createArrayLiteralExpression(exprs, false)]);
+}
+/** `a.and(b).and(c)` — left-folds `.and` over the members. */
+function intersectionExpression(members, byName) {
+    const exprs = members.map((member) => schemaToZodExpression(member, byName));
+    return exprs.reduce((acc, next) => chain(acc, 'and', [next]));
+}
+/**
+ * `<Base>Schema.omit({ k1: true, … })` when the base is a plain object schema.
+ * `.omit` exists only on `ZodObject` — for any other base (an `allOf` intersection,
+ * a union, …) the omission is distributed into the base's object members instead.
+ */
+function omitExpression(base, keys, byName) {
+    const target = byName.get(base);
+    if (target && target.kind !== 'object') {
+        return schemaToZodExpression(applyOmit(target, keys, byName, new Set([base])), byName);
+    }
+    const mask = factory.createObjectLiteralExpression(keys.map((k) => {
+        const safe = safeIdent(k);
+        const key = safe === k ? factory.createIdentifier(k) : factory.createStringLiteral(k);
+        return factory.createPropertyAssignment(key, factory.createTrue());
+    }), false);
+    return chain(factory.createIdentifier(schemaConstName(base)), 'omit', [mask]);
+}
+/**
+ * Remove `keys` from a schema that is not a plain object: objects drop the properties,
+ * union/intersection members recurse, and a ref to an object becomes `<Ref>Schema.omit`
+ * with only the keys that exist on it (zod's mask rejects unknown keys at the type
+ * level). Cycles and non-object leaves return unchanged — there is nothing to omit.
+ */
+function applyOmit(schema, keys, byName, seen) {
+    switch (schema.kind) {
+        case 'object':
+            return { ...schema, properties: schema.properties.filter((p) => !keys.includes(p.name)) };
+        case 'union':
+        case 'intersection':
+            return {
+                ...schema,
+                members: schema.members.map((member) => applyOmit(member, keys, byName, seen)),
+            };
+        case 'ref': {
+            if (seen.has(schema.name))
+                return schema;
+            const target = byName.get(schema.name);
+            if (!target)
+                return schema;
+            if (target.kind === 'object') {
+                const present = keys.filter((key) => target.properties.some((property) => property.name === key));
+                return present.length > 0 ? { kind: 'omit', base: schema.name, keys: present } : schema;
+            }
+            return applyOmit(target, keys, byName, new Set([...seen, schema.name]));
+        }
+        default:
+            return schema;
+    }
+}
+/**
+ * Chain the stable-subset metadata refinements onto `expr`. Order: numeric/length
+ * bounds, then `.regex` (the `.int()` for integers is already on the base).
+ * `.optional()` is NOT applied here — optionality is a property-level concern
+ * handled in `objectExpression`, so a top-level schema is never spuriously optional.
+ */
+function withRefinements(expr, schema) {
+    const m = schema.metadata;
+    if (!m)
+        return expr;
+    let out = expr;
+    if (schema.kind === 'scalar' && schema.scalar === 'string') {
+        if (m.minLength !== undefined)
+            out = chain(out, 'min', [literalExpression(m.minLength)]);
+        if (m.maxLength !== undefined)
+            out = chain(out, 'max', [literalExpression(m.maxLength)]);
+        if (m.pattern !== undefined)
+            out = chain(out, 'regex', [regexExpression(m.pattern)]);
+    }
+    if (schema.kind === 'scalar' && (schema.scalar === 'number' || schema.scalar === 'integer')) {
+        out = numericRefinements(out, m);
+    }
+    if (schema.kind === 'array') {
+        if (m.minItems !== undefined)
+            out = chain(out, 'min', [literalExpression(m.minItems)]);
+        if (m.maxItems !== undefined)
+            out = chain(out, 'max', [literalExpression(m.maxItems)]);
+    }
+    return out;
+}
+function numericRefinements(expr, m) {
+    let out = expr;
+    if (m.minimum !== undefined)
+        out = chain(out, 'min', [literalExpression(m.minimum)]);
+    if (m.maximum !== undefined)
+        out = chain(out, 'max', [literalExpression(m.maximum)]);
+    if (m.exclusiveMinimum !== undefined)
+        out = chain(out, 'gt', [literalExpression(m.exclusiveMinimum)]);
+    if (m.exclusiveMaximum !== undefined)
+        out = chain(out, 'lt', [literalExpression(m.exclusiveMaximum)]);
+    return out;
+}
+/** `new RegExp("<pattern>")` — robust across printers regardless of pattern content. */
+function regexExpression(pattern) {
+    return factory.createNewExpression(factory.createIdentifier('RegExp'), undefined, [
+        factory.createStringLiteral(pattern),
+    ]);
+}
+/** `export const <Name>Schema = <expr>;` for one named schema. */
+function schemaConstStatement(named, byName) {
+    return factory.createVariableStatement([factory.createModifier(ts.SyntaxKind.ExportKeyword)], factory.createVariableDeclarationList([
+        factory.createVariableDeclaration(schemaConstName(named.name), undefined, undefined, schemaToZodExpression(named.schema, byName)),
+    ], ts.NodeFlags.Const));
+}
+/** `import { z } from 'zod';` */
+function zodImport() {
+    return factory.createImportDeclaration(undefined, factory.createImportClause(false, undefined, factory.createNamedImports([
+        factory.createImportSpecifier(false, undefined, factory.createIdentifier('z')),
+    ])), factory.createStringLiteral('zod'));
+}
+function operationSchemaEntries(model, byName) {
+    const entries = [];
+    for (const op of allOperations(model.services)) {
+        if (isSseOp(op))
+            continue;
+        const requestBody = op.requestBody;
+        const request = requestBody && requestBody.contentType.toLowerCase().includes('json')
+            ? schemaToZodExpression(requestBody.schema, byName)
+            : undefined;
+        const jsonResponse = op.successResponses.find((response) => response.contentType.toLowerCase().includes('json'));
+        const response = jsonResponse ? schemaToZodExpression(jsonResponse.schema, byName) : undefined;
+        if (!request && !response)
+            continue;
+        entries.push({ name: op.name, request, response });
+    }
+    return entries;
+}
+function operationSchemasStatement(entries) {
+    const zodTypeNode = () => factory.createTypeReferenceNode(factory.createQualifiedName(factory.createIdentifier('z'), 'ZodType'));
+    // The explicit `z.ZodType` annotation keeps the declaration-emit size proportional to
+    // the operation count: the inferred type would serialize every schema's zod generics
+    // and overflow tsc's limit (TS7056) on large APIs under `declaration: true`.
+    const typeMembers = entries.map((entry) => factory.createPropertySignature(undefined, entry.name, undefined, factory.createTypeLiteralNode([
+        entry.request
+            ? factory.createPropertySignature(undefined, 'request', undefined, zodTypeNode())
+            : undefined,
+        entry.response
+            ? factory.createPropertySignature(undefined, 'response', undefined, zodTypeNode())
+            : undefined,
+    ].filter((member) => member !== undefined))));
+    const valueEntries = entries.map((entry) => factory.createPropertyAssignment(entry.name, factory.createObjectLiteralExpression([
+        entry.request ? factory.createPropertyAssignment('request', entry.request) : undefined,
+        entry.response ? factory.createPropertyAssignment('response', entry.response) : undefined,
+    ].filter((property) => property !== undefined), false)));
+    return jsdoc(factory.createVariableStatement([factory.createModifier(ts.SyntaxKind.ExportKeyword)], factory.createVariableDeclarationList([
+        factory.createVariableDeclaration('operationSchemas', undefined, factory.createTypeLiteralNode(typeMembers), factory.createObjectLiteralExpression(valueEntries, true)),
+    ], ts.NodeFlags.Const)), 'Request/response validators by operationId — powers `zodValidation`, or import one directly.');
+}
+// The validation middleware, spliced verbatim after the schemas (matches the printer's
+// double-quote/4-space style). Structurally compatible with the client's `Middleware`
+// without importing it, so the zod module keeps its single `zod` dependency.
+const VALIDATION_SUPPORT = `/** \`request\`/\`response\` validators for one operation (an absent side is not validated). */
+export type OperationSchemaSet = { request?: z.ZodType; response?: z.ZodType };
+
+const schemaIndex: Partial<Record<string, OperationSchemaSet>> = operationSchemas;
+
+/** A request or response payload failed validation. Always thrown, even on result-mode clients. */
+export class ZodValidationError extends Error {
+    constructor(
+        readonly operationId: string,
+        readonly direction: "request" | "response",
+        readonly issues: z.ZodError["issues"]
+    ) {
+        const detail = issues
+            .map((issue) => \`\${issue.path.join(".") || "(root)"}: \${issue.message}\`)
+            .join("; ");
+        super(\`\${direction === "request" ? "Request" : "Response"} validation failed for operation "\${operationId}": \${detail}\`);
+        this.name = "ZodValidationError";
+    }
+}
+
+/**
+ * Schema-validation middleware for the generated client: \`use(zodValidation())\`.
+ * Request bodies are validated before any network call; successful JSON responses are
+ * validated against the operation's response schema. Payloads are never mutated, and
+ * operations without a schema pass through untouched. A failure throws
+ * \`ZodValidationError\` — always, even on result-mode clients.
+ */
+export function zodValidation(options: { request?: boolean; response?: boolean } = {}) {
+    const { request = true, response = true } = options;
+    return {
+        onRequest(context: { body?: unknown; operation: { id: string } }): void {
+            if (!request || context.body === undefined) return;
+            const schema = schemaIndex[context.operation.id]?.request;
+            if (!schema) return;
+            const result = schema.safeParse(context.body);
+            if (!result.success) {
+                throw new ZodValidationError(context.operation.id, "request", result.error.issues);
+            }
+        },
+        async onResponse(incoming: Response, context: { operation: { id: string } }): Promise<void> {
+            if (!response || !incoming.ok) return;
+            const schema = schemaIndex[context.operation.id]?.response;
+            if (!schema) return;
+            const contentType = (incoming.headers.get("content-type") ?? "").toLowerCase();
+            if (!contentType.includes("json")) return;
+            const result = schema.safeParse(await incoming.clone().json());
+            if (!result.success) {
+                throw new ZodValidationError(context.operation.id, "response", result.error.issues);
+            }
+        },
+    };
+}`;
+/**
+ * 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 function renderZodModule(model) {
+    const byName = new Map(model.schemas.map((named) => [named.name, named.schema]));
+    const entries = operationSchemaEntries(model, byName);
+    if (model.schemas.length === 0 && entries.length === 0)
+        return '';
+    const statements = [
+        zodImport(),
+        ...model.schemas.map((named) => schemaConstStatement(named, byName)),
+    ];
+    if (entries.length === 0)
+        return printStatements(statements);
+    statements.push(operationSchemasStatement(entries));
+    return `${printStatements(statements)}\n${VALIDATION_SUPPORT}\n`;
+}
+//# sourceMappingURL=zod.js.map

package/lib/emitters/zod.js.map

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

package/lib/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class NotSupportedError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B"}

package/lib/errors.js

@@ -0,0 +1,7 @@
+export class NotSupportedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NotSupportedError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/lib/generators/anchor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Derive the directory and base name (stem, without `.ts`) from the `--output`
+ * anchor path. Generators build sibling-file paths from these.
+ */
+export declare function anchor(outputPath: string): {
+    dir: string;
+    stem: string;
+};
+//# sourceMappingURL=anchor.d.ts.map

package/lib/generators/anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../src/generators/anchor.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAGxE"}

package/lib/generators/anchor.js

@@ -0,0 +1,10 @@
+import { parse } from 'node:path';
+/**
+ * Derive the directory and base name (stem, without `.ts`) from the `--output`
+ * anchor path. Generators build sibling-file paths from these.
+ */
+export function anchor(outputPath) {
+    const { dir, name } = parse(outputPath);
+    return { dir, stem: name };
+}
+//# sourceMappingURL=anchor.js.map

package/lib/generators/anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.js","sourceRoot":"","sources":["../../src/generators/anchor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,UAAkB;IACvC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC"}

package/lib/generators/index.d.ts

@@ -0,0 +1,15 @@
+import type { EmitOptions } from '../emitters/emit-options.js';
+import type { GeneratorDescriptor } from './types.js';
+export type { CustomGenerator, Generator, GeneratorDescriptor, GeneratorInput, GeneratorName, } from './types.js';
+/**
+ * A fresh registry of the built-in generators keyed by name. The plugin resolver seeds from this
+ * and adds custom generators to the copy, so mutating the result never affects the built-in table.
+ */
+export declare function builtinGenerators(): Map<string, GeneratorDescriptor>;
+/**
+ * Validate a generator selection against every selected generator's declared
+ * contract, throwing the first violation with an actionable message. Runs before
+ * any file is produced so an incompatible combination never reaches the printer.
+ */
+export declare function validateGenerators(names: string[], emit: EmitOptions, registry?: Map<string, GeneratorDescriptor>): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAO/D,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,YAAY,CAAC;AAGrE,YAAY,EACV,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAkBpB;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,WAAW,EACjB,QAAQ,GAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAuB,GAC/D,IAAI,CAkCN"}

package/lib/generators/index.js

@@ -0,0 +1,62 @@
+import { NotSupportedError } from '../errors.js';
+import { mockGenerator } from './mock.js';
+import { sdkGenerator } from './sdk.js';
+import { swrGenerator } from './swr.js';
+import { tanstackQueryGenerator } from './tanstack-query.js';
+import { transformersGenerator } from './transformers.js';
+import { zodGenerator } from './zod.js';
+const GENERATORS = {
+    // sdk is the base client; zod emits a standalone schema module importing nothing from it.
+    sdk: { run: sdkGenerator },
+    zod: { run: zodGenerator },
+    // transformers import the schema *types* from the sdk entry module (so sdk must run) and
+    // assign `Date` values to those fields, which only type-checks when the sdk types dates as `Date`.
+    transformers: { run: transformersGenerator, requires: ['sdk'], dateTypes: ['Date'] },
+    // tanstack-query wraps the sdk's exported, throw-mode operation functions — present in
+    // both runtime distributions, so no runtime restriction.
+    'tanstack-query': { run: tanstackQueryGenerator, requires: ['sdk'], errorModes: ['throw'] },
+    // swr wraps the sdk's exported, throw-mode operation functions as SWR hooks.
+    swr: { run: swrGenerator, requires: ['sdk'], errorModes: ['throw'] },
+    // mock emits a standalone MSW handlers/factories module referencing the sdk's types.
+    mock: { run: mockGenerator, requires: ['sdk'] },
+};
+/**
+ * A fresh registry of the built-in generators keyed by name. The plugin resolver seeds from this
+ * and adds custom generators to the copy, so mutating the result never affects the built-in table.
+ */
+export function builtinGenerators() {
+    return new Map(Object.entries(GENERATORS));
+}
+/**
+ * Validate a generator selection against every selected generator's declared
+ * contract, throwing the first violation with an actionable message. Runs before
+ * any file is produced so an incompatible combination never reaches the printer.
+ */
+export function validateGenerators(names, emit, registry = builtinGenerators()) {
+    const selected = new Set(names);
+    const errorMode = emit.errorMode ?? 'throw';
+    const dateType = emit.dateType ?? 'string';
+    const runtime = emit.runtime ?? 'inline';
+    for (const name of names) {
+        const descriptor = registry.get(name);
+        if (!descriptor) {
+            throw new NotSupportedError(`Unknown generator: ${name}`);
+        }
+        for (const required of descriptor.requires ?? []) {
+            if (!selected.has(required)) {
+                const fixed = [...new Set([required, ...names])].map((g) => `--generator ${g}`).join(' ');
+                throw new NotSupportedError(`The "${name}" generator requires the "${required}" generator. Add it, e.g. ${fixed}.`);
+            }
+        }
+        if (descriptor.errorModes && !descriptor.errorModes.includes(errorMode)) {
+            throw new NotSupportedError(`The "${name}" generator does not support --error-mode "${errorMode}" (supported: ${descriptor.errorModes.join(', ')}).`);
+        }
+        if (descriptor.dateTypes && !descriptor.dateTypes.includes(dateType)) {
+            throw new NotSupportedError(`The "${name}" generator requires --date-type ${descriptor.dateTypes.join(' or ')} (got "${dateType}") so the runtime values match the generated types.`);
+        }
+        if (descriptor.runtimes && !descriptor.runtimes.includes(runtime)) {
+            throw new NotSupportedError(`The "${name}" generator does not support runtime "${runtime}" (supported: ${descriptor.runtimes.join(', ')}).`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/generators/index.js.map

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

package/lib/generators/mock.d.ts

@@ -0,0 +1,9 @@
+import type { Generator } from './types.js';
+/**
+ * The mock generator: a standalone `<stem>.mocks.ts` module of MSW handlers and
+ * data factories baked from the spec. Imports `msw` (the consumer's dev-dep); the
+ * sdk client stays dependency-free. Output-mode-agnostic in v1 — one module beside
+ * the client. Emits nothing when there are no operations.
+ */
+export declare const mockGenerator: Generator;
+//# sourceMappingURL=mock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/generators/mock.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAU3B,CAAC"}

package/lib/generators/mock.js

@@ -0,0 +1,23 @@
+import { join } from 'node:path';
+import { HEADER } from '../emitters/emit-options.js';
+import { renderMockModule } from '../emitters/mock.js';
+import { anchor } from './anchor.js';
+/**
+ * The mock generator: a standalone `<stem>.mocks.ts` module of MSW handlers and
+ * data factories baked from the spec. Imports `msw` (the consumer's dev-dep); the
+ * sdk client stays dependency-free. Output-mode-agnostic in v1 — one module beside
+ * the client. Emits nothing when there are no operations.
+ */
+export const mockGenerator = ({ model, outputPath, emit }) => {
+    const { dir, stem } = anchor(outputPath);
+    const content = renderMockModule(model, {
+        sdkModule: `./${stem}.js`,
+        dateType: emit.dateType,
+        mockData: emit.mockData,
+        mockSeed: emit.mockSeed,
+    });
+    if (content === '')
+        return [];
+    return [{ path: join(dir, `${stem}.mocks.ts`), content: `${HEADER}\n\n${content}` }];
+};
+//# sourceMappingURL=mock.js.map

package/lib/generators/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../src/generators/mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAc,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;IACtE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE;QACtC,SAAS,EAAE,KAAK,IAAI,KAAK;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IACH,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,OAAO,EAAE,EAAE,CAAC,CAAC;AACvF,CAAC,CAAC"}

package/lib/generators/resolve.d.ts

@@ -0,0 +1,19 @@
+import type { CustomGenerator, GeneratorDescriptor } from './types.js';
+export type ResolvedGenerators = {
+    /** Generator names to run, in selection order. */
+    selected: string[];
+    /** Every available generator (built-ins + registered customs) keyed by name. */
+    registry: Map<string, GeneratorDescriptor>;
+};
+export type ResolveOptions = {
+    /** Inline custom generators (via the programmatic `generateClient` API) registered before resolution. */
+    customGenerators?: CustomGenerator[];
+    /** Directory relative-path specifiers resolve against (the config's location). Defaults to cwd. */
+    configDir?: string;
+};
+/**
+ * Build the run list + registry for a `generators` selection. Each entry is, in order of preference,
+ * a built-in name, an already-registered custom name, or an import specifier (path or package).
+ */
+export declare function resolveGenerators(entries: string[], options?: ResolveOptions): Promise<ResolvedGenerators>;
+//# sourceMappingURL=resolve.d.ts.map

package/lib/generators/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/generators/resolve.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,yGAAyG;IACzG,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAe7B"}