@redocly/client-generator 0.3.8 → 0.4.0

package/lib/{emitters/zod.js → generators/zod/schemas.js}

@@ -1,6 +1,6 @@
 // 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.
+// `export const <Name>Schema = z.<…>;` — source-text templates mirroring the
+// type renderer (`typescript/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.
 //
@@ -8,134 +8,105 @@
 // (`.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;
+import { allOperations, } from '@redocly/client-generator';
+import { codeLiteral, pascalCase, safeIdent } from '@redocly/client-generator/printers/typescript';
+const INDENT = '    ';
 /** `<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);
+/** Map an IR schema to the Zod expression (source text) that validates it. */
+export function schemaToZodExpression(schema, byName = NO_SCHEMAS, indent = '') {
+    return withRefinements(baseExpression(schema, byName, indent), schema);
 }
-function baseExpression(schema, byName) {
+function baseExpression(schema, byName, indent) {
     switch (schema.kind) {
         case 'scalar':
             return scalarExpression(schema.scalar, schema.metadata);
         case 'object':
-            return objectExpression(schema.properties, byName);
+            return objectExpression(schema.properties, byName, indent);
         case 'array':
-            return zCall('array', [schemaToZodExpression(schema.items, byName)]);
+            return `z.array(${schemaToZodExpression(schema.items, byName, indent)})`;
         case 'record':
-            return zCall('record', [zCall('string'), schemaToZodExpression(schema.value, byName)]);
+            return `z.record(z.string(), ${schemaToZodExpression(schema.value, byName, indent)})`;
         case 'ref':
-            return lazyRef(schema.name);
+            return `z.lazy(() => ${schemaConstName(schema.name)})`;
         case 'literal':
-            return zCall('literal', [literalExpression(schema.value)]);
+            return `z.literal(${codeLiteral(schema.value)})`;
         case 'enum':
             return enumExpression(schema.values);
         case 'union':
-            return unionExpression(schema.members, byName);
+            return unionExpression(schema.members, byName, indent);
         case 'intersection':
-            return intersectionExpression(schema.members, byName);
+            return schema.members
+                .map((member) => schemaToZodExpression(member, byName, indent))
+                .reduce((acc, next) => `${acc}.and(${next})`);
         case 'null':
-            return zCall('null');
+            return 'z.null()';
         case 'unknown':
-            return zCall('unknown');
+            return 'z.unknown()';
         case 'omit':
-            return omitExpression(schema.base, schema.keys, byName);
+            return omitExpression(schema.base, schema.keys, byName, indent);
     }
 }
 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');
+            // `format: binary` is typed as `Blob` (see typescript/types.ts); validate it as one so the
+            // zod schema agrees with the generated type instead of expecting a string.
+            return metadata?.format === 'binary' ? 'z.instanceof(Blob)' : 'z.string()';
         case 'integer':
-            return chain(zCall('number'), 'int');
+            return 'z.number().int()';
         case 'number':
-            return zCall('number');
+            return 'z.number()';
         case 'boolean':
-            return zCall('boolean');
+            return 'z.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)]);
+/** A bare identifier key when valid, a quoted key otherwise. */
+function propertyKeyText(name) {
+    return safeIdent(name) === name ? name : JSON.stringify(name);
 }
-/** `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]);
+/** `z.object({ <key>: <expr>(.optional() when !required), … })` — multiline when non-empty. */
+function objectExpression(properties, byName, indent) {
+    if (properties.length === 0)
+        return 'z.object({})';
+    const inner = indent + INDENT;
+    const lines = properties.map((property, index) => {
+        const expr = schemaToZodExpression(property.schema, byName, inner);
+        const value = property.required ? expr : `${expr}.optional()`;
+        const comma = index === properties.length - 1 ? '' : ',';
+        return `${inner}${propertyKeyText(property.name)}: ${value}${comma}`;
+    });
+    return `z.object({\n${lines.join('\n')}\n${indent}})`;
 }
 /** 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),
-        ]);
+    if (values.every((value) => typeof value === 'string')) {
+        return `z.enum([${values.map((value) => JSON.stringify(value)).join(', ')}])`;
     }
-    return zCall('union', [
-        factory.createArrayLiteralExpression(values.map((v) => zCall('literal', [literalExpression(v)])), false),
-    ]);
+    return `z.union([${values.map((value) => `z.literal(${codeLiteral(value)})`).join(', ')}])`;
 }
 /** `z.union([…])`; a single member collapses to that member's expression. */
-function unionExpression(members, byName) {
-    const exprs = members.map((member) => schemaToZodExpression(member, byName));
+function unionExpression(members, byName, indent) {
+    const exprs = members.map((member) => schemaToZodExpression(member, byName, indent));
     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]));
+    return `z.union([${exprs.join(', ')}])`;
 }
 /**
  * `<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) {
+function omitExpression(base, keys, byName, indent) {
     const target = byName.get(base);
     if (target && target.kind !== 'object') {
-        return schemaToZodExpression(applyOmit(target, keys, byName, new Set([base])), byName);
+        return schemaToZodExpression(applyOmit(target, keys, byName, new Set([base])), byName, indent);
     }
-    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]);
+    const mask = keys.map((key) => `${propertyKeyText(key)}: true`).join(', ');
+    return `${schemaConstName(base)}.omit({ ${mask} })`;
 }
 /**
  * Remove `keys` from a schema that is not a plain object: objects drop the properties,
@@ -182,64 +153,43 @@ function withRefinements(expr, schema) {
     let out = expr;
     if (schema.kind === 'scalar' && schema.scalar === 'string') {
         if (m.minLength !== undefined)
-            out = chain(out, 'min', [literalExpression(m.minLength)]);
+            out = `${out}.min(${m.minLength})`;
         if (m.maxLength !== undefined)
-            out = chain(out, 'max', [literalExpression(m.maxLength)]);
+            out = `${out}.max(${m.maxLength})`;
         if (m.pattern !== undefined)
-            out = chain(out, 'regex', [regexExpression(m.pattern)]);
+            out = `${out}.regex(new RegExp(${JSON.stringify(m.pattern)}))`;
     }
     if (schema.kind === 'scalar' && (schema.scalar === 'number' || schema.scalar === 'integer')) {
-        out = numericRefinements(out, m);
+        if (m.minimum !== undefined)
+            out = `${out}.min(${m.minimum})`;
+        if (m.maximum !== undefined)
+            out = `${out}.max(${m.maximum})`;
+        if (m.exclusiveMinimum !== undefined)
+            out = `${out}.gt(${m.exclusiveMinimum})`;
+        if (m.exclusiveMaximum !== undefined)
+            out = `${out}.lt(${m.exclusiveMaximum})`;
     }
     if (schema.kind === 'array') {
         if (m.minItems !== undefined)
-            out = chain(out, 'min', [literalExpression(m.minItems)]);
+            out = `${out}.min(${m.minItems})`;
         if (m.maxItems !== undefined)
-            out = chain(out, 'max', [literalExpression(m.maxItems)]);
+            out = `${out}.max(${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))
+        if (op.sse !== undefined)
             continue;
         const requestBody = op.requestBody;
         const request = requestBody && requestBody.contentType.toLowerCase().includes('json')
-            ? schemaToZodExpression(requestBody.schema, byName)
+            ? schemaToZodExpression(requestBody.schema, byName, INDENT)
             : undefined;
         const jsonResponse = op.successResponses.find((response) => response.contentType.toLowerCase().includes('json'));
-        const response = jsonResponse ? schemaToZodExpression(jsonResponse.schema, byName) : undefined;
+        const response = jsonResponse
+            ? schemaToZodExpression(jsonResponse.schema, byName, INDENT)
+            : undefined;
         if (!request && !response)
             continue;
         // The SPEC operationId — the middleware looks entries up by `ctx.operation.id`,
@@ -248,32 +198,34 @@ function operationSchemaEntries(model, byName) {
     }
     return entries;
 }
-/** An entry key as a printable property name: bare when a safe identifier, quoted otherwise. */
-function entryKey(name) {
-    return safeIdent(name) === name
-        ? factory.createIdentifier(name)
-        : factory.createStringLiteral(name);
-}
-function operationSchemasStatement(entries) {
-    const zodTypeNode = () => factory.createTypeReferenceNode(factory.createQualifiedName(factory.createIdentifier('z'), 'ZodType'));
+function operationSchemasBlock(entries) {
     // 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, entryKey(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(entryKey(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.');
+    const typeLines = entries.flatMap((entry) => [
+        `${INDENT}${propertyKeyText(entry.name)}: {`,
+        ...(entry.request ? [`${INDENT}${INDENT}request: z.ZodType;`] : []),
+        ...(entry.response ? [`${INDENT}${INDENT}response: z.ZodType;`] : []),
+        `${INDENT}};`,
+    ]);
+    const valueLines = entries.map((entry, index) => {
+        const fields = [
+            ...(entry.request ? [`request: ${entry.request}`] : []),
+            ...(entry.response ? [`response: ${entry.response}`] : []),
+        ].join(', ');
+        const comma = index === entries.length - 1 ? '' : ',';
+        return `${INDENT}${propertyKeyText(entry.name)}: { ${fields} }${comma}`;
+    });
+    return [
+        '/**',
+        ' * Request/response validators by operationId — powers `zodValidation`, or import one directly.',
+        ' */',
+        'export const operationSchemas: {',
+        ...typeLines,
+        '} = {',
+        ...valueLines,
+        '};',
+    ].join('\n');
 }
 // The validation middleware, spliced verbatim after the schemas (matches the printer's
 // double-quote/4-space style). Structurally compatible with the client's `Middleware`
@@ -288,11 +240,19 @@ export type ZodViolation = { path: string; message: string; received: string };
 
 /** A request or response payload failed validation. Requests throw it; response handling is configurable. */
 export class ZodValidationError extends Error {
+    // Declared and assigned in the body, NOT as constructor parameter properties: those
+    // need a transform, so they break \`node --experimental-strip-types\` for anything
+    // importing this module (the generated CLI runs that way).
+    readonly operationId: string;
+    readonly direction: "request" | "response";
+    readonly issues: z.ZodError["issues"];
+    readonly violations: ZodViolation[];
+
     constructor(
-        readonly operationId: string,
-        readonly direction: "request" | "response",
-        readonly issues: z.ZodError["issues"],
-        readonly violations: ZodViolation[]
+        operationId: string,
+        direction: "request" | "response",
+        issues: z.ZodError["issues"],
+        violations: ZodViolation[]
     ) {
         const detail = violations
             .slice(0, 5)
@@ -300,6 +260,10 @@ export class ZodValidationError extends Error {
             .join("; ");
         const more = violations.length > 5 ? \`; …and \${violations.length - 5} more\` : "";
         super(\`\${direction === "request" ? "Request" : "Response"} validation failed for operation "\${operationId}": \${detail}\${more}\`);
+        this.operationId = operationId;
+        this.direction = direction;
+        this.issues = issues;
+        this.violations = violations;
         this.name = "ZodValidationError";
     }
 }
@@ -434,13 +398,13 @@ export function renderZodModule(model) {
     const entries = operationSchemaEntries(model, byName);
     if (model.schemas.length === 0 && entries.length === 0)
         return '';
-    const statements = [
-        zodImport(),
-        ...model.schemas.map((named) => schemaConstStatement(named, byName)),
+    const blocks = [
+        'import { z } from "zod";',
+        ...model.schemas.map((named) => `export const ${schemaConstName(named.name)} = ${schemaToZodExpression(named.schema, byName)};`),
     ];
     if (entries.length === 0)
-        return printStatements(statements);
-    statements.push(operationSchemasStatement(entries));
-    return `${printStatements(statements)}\n${VALIDATION_SUPPORT}\n`;
+        return blocks.join('\n\n');
+    blocks.push(operationSchemasBlock(entries));
+    return `${blocks.join('\n\n')}\n${VALIDATION_SUPPORT}\n`;
 }
-//# sourceMappingURL=zod.js.map
+//# sourceMappingURL=schemas.js.map

package/lib/generators/zod/schemas.js.map

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

package/lib/index.d.ts

@@ -1,9 +1,14 @@
+export * from './authoring/index.js';
 export { NotSupportedError } from './errors.js';
 export { defineClientSetup } from './runtime-contract.js';
 export type { ClientSetup, ClientSetupConfig, Middleware, OperationContext, RequestContext, RetryConfig, RetryContext, RetryStrategy, } from './runtime-contract.js';
-export { ApiError, createClient, defaultRetryOn, mergeSetup, TimeoutError, } from './runtime/index.js';
-export type { ApiErrorLike, AuthCredentials, Client, ClientConfig, ClientCore, Envelope, EnvelopeResult, OperationDescriptor, OperationMethodIdentity, OpsShape, ParamSpec, ParseAs, QueryValue, RequestOptions, Result, SecuritySpec, ServerSentEvent, SseOptions, TokenProvider, } from './runtime/index.js';
-export type { PaginationConfig, PaginationRule, PaginationStyle } from './emitters/pagination.js';
+export type { ResponseHeaderSpec } from './runtime-contract.js';
+export type { ModelPagination, PaginationSpec } from './pagination.js';
+export { resolveSchemaPointer } from './pagination.js';
+export { WIRING_NAMES } from './reserved-names.js';
+export { constantCase, groupSlug } from './cli-contract.js';
+export type { CliAuthScheme, CliCommand, CliFlag, CliGlobals, CliWiring, CommandContext, CommandSource, CustomCommand, } from './cli-contract.js';
+export type { PaginationConfig, PaginationRule, PaginationStyle } from './pagination.js';
 export type { GenerateClientConfig, GenerateClientOptions, GenerateClientResult, LoadResult, } from './types.js';
 export { mergeConfig } from './config-file.js';
 export * from './plugin.js';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,EACZ,eAAe,EACf,MAAM,EACN,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,cAAc,EACd,MAAM,EACN,YAAY,EACZ,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAClG,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,cAAc,aAAa,CAAC;AAE5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE9E,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAG/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EACV,aAAa,EACb,UAAU,EACV,OAAO,EACP,UAAU,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACzF,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,cAAc,aAAa,CAAC;AAE5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE9E,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAG/B"}

package/lib/index.js

@@ -1,20 +1,27 @@
-// The package ROOT entry — what package-mode clients load at app runtime, so its static
-// import graph stays runtime-only (no `typescript`, no `@redocly/openapi-core`, no Node
-// builtins; guarded by entry-weight.test.ts). The generation stack lives behind the dynamic
-// import inside `generateClient` and the `@redocly/client-generator/generate` entry.
+// The package ROOT entry — the authoring surface: the language-neutral toolkit, the
+// plugin API, the user-facing config types, and the setup contract. Nothing imports
+// this entry at app runtime — generated clients embed their runtime (ADR-0022) — and
+// the TypeScript-emitting stack lives behind the dynamic import inside `generateClient`
+// and the `@redocly/client-generator/generate` entry.
+// The language-neutral generator-authoring toolkit — pure functions over the IR.
+export * from './authoring/index.js';
 export { NotSupportedError } from './errors.js';
 export { defineClientSetup } from './runtime-contract.js';
-// The app-facing client runtime (package-mode clients import these from the package root).
-// The setup-contract names above (Middleware, OperationContext, RequestContext, RetryConfig,
-// RetryContext, RetryStrategy) are re-exports of the same runtime types — one definition,
-// two entry points; the rest of the runtime's type surface is re-exported here.
-export { ApiError, createClient, defaultRetryOn, mergeSetup, TimeoutError, } from './runtime/index.js';
+export { resolveSchemaPointer } from './pagination.js';
+// Names the generated sdk wiring reserves — the typescript descriptor keeps schema
+// identifiers clear of them.
+export { WIRING_NAMES } from './reserved-names.js';
+// The generated-CLI authoring contract — the command/wiring shapes a wrapper around a
+// generated or composed CLI is written against, plus the two casing helpers CLI-flavored
+// generators share; the engine itself (`runCli`) is embedded in, and re-exported by,
+// every generated cli module.
+export { constantCase, groupSlug } from './cli-contract.js';
 export { mergeConfig } from './config-file.js';
 // The custom-generator authoring API (`defineGenerator` + the IR types); the
 // TypeScript-emitting toolkit lives in `@redocly/client-generator/generate`.
 export * from './plugin.js';
 export async function generateClient(options) {
-    const generate = await import('./generate.js');
-    return generate.generateClient(options);
+    const pipeline = await import('./pipeline.js');
+    return pipeline.generateClient(options);
 }
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,wFAAwF;AACxF,4FAA4F;AAC5F,qFAAqF;AAErF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAW1D,2FAA2F;AAC3F,6FAA6F;AAC7F,0FAA0F;AAC1F,gFAAgF;AAChF,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AA8B5B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,6EAA6E;AAC7E,6EAA6E;AAC7E,cAAc,aAAa,CAAC;AAI5B,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA8B;IAE9B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,oFAAoF;AACpF,qFAAqF;AACrF,wFAAwF;AACxF,sDAAsD;AAEtD,iFAAiF;AACjF,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAc1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,mFAAmF;AACnF,6BAA6B;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,sFAAsF;AACtF,yFAAyF;AACzF,qFAAqF;AACrF,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAmB5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,6EAA6E;AAC7E,6EAA6E;AAC7E,cAAc,aAAa,CAAC;AAI5B,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA8B;IAE9B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/lib/intermediate-representation/build.d.ts

@@ -1,4 +1,11 @@
 import { type Oas3Definition } from '@redocly/openapi-core';
-import type { ApiModel } from './model.js';
+import type { ApiModel, ResponseBodyModel, SseModel } from './model.js';
 export declare function buildApiModel(doc: Oas3Definition): ApiModel;
+/**
+ * The operation's SSE facts, from its `text/event-stream` success response (exact media
+ * type, parameters and case ignored). The event schema prefers the 3.2 `itemSchema` over
+ * the response `schema`, skipping typeless slots; structured kinds stream as JSON,
+ * scalar-ish ones as raw text.
+ */
+export declare function sseFromResponses(successResponses: ResponseBodyModel[]): SseModel | undefined;
 //# sourceMappingURL=build.d.ts.map

package/lib/intermediate-representation/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/intermediate-representation/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EAQpB,MAAM,uBAAuB,CAAC;AAS/B,OAAO,KAAK,EACV,QAAQ,EAcT,MAAM,YAAY,CAAC;AAsLpB,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,QAAQ,CA8B3D"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/intermediate-representation/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EAQpB,MAAM,uBAAuB,CAAC;AAS/B,OAAO,KAAK,EACV,QAAQ,EAOR,iBAAiB,EACjB,QAAQ,EAOT,MAAM,YAAY,CAAC;AAkLpB,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,QAAQ,CAuC3D;AAsTD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,GAAG,QAAQ,GAAG,SAAS,CAoB5F"}

package/lib/intermediate-representation/build.js

@@ -1,6 +1,6 @@
 import { isPlainObject, isRef, logger, } from '@redocly/openapi-core';
 import { NotSupportedError } from '../errors.js';
-import { assertPathParamsAvoidArgSlots, assertSafeIdentifiers, sanitizeIdentifiers, } from './sanitize-identifiers.js';
+import { assertSafeIdentifiers, sanitizeIdentifiers } from './sanitize-identifiers.js';
 const HTTP_METHODS = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options'];
 function resolveRef(doc, ref) {
     if (!ref.startsWith('#/')) {
@@ -162,6 +162,15 @@ export function buildApiModel(doc) {
     const version = doc.info?.version ?? '0.0.0';
     const description = doc.info?.description;
     const serverUrl = resolveServerUrl(doc.servers?.[0]);
+    const servers = (doc.servers ?? []).map((server) => ({
+        url: server.url,
+        description: server.description,
+        variables: Object.entries(server.variables ?? {}).map(([name, variable]) => ({
+            name,
+            default: variable.default,
+            description: variable.description,
+        })),
+    }));
     const schemas = buildNamedSchemas(doc);
     const securitySchemes = buildSecuritySchemes(doc);
     const services = buildServices(doc, securitySchemes);
@@ -170,6 +179,7 @@ export function buildApiModel(doc) {
         version,
         description,
         serverUrl,
+        servers,
         services,
         schemas,
         securitySchemes,
@@ -182,7 +192,6 @@ export function buildApiModel(doc) {
     // Hard gate: no unsafe name may reach the printer (see sanitize-identifiers.ts).
     assertSafeIdentifiers(model);
     // A path parameter named like a request-args slot cannot be routed — fail loudly.
-    assertPathParamsAvoidArgSlots(model);
     return model;
 }
 /**
@@ -421,7 +430,9 @@ function buildOperation(method, path, operation, name, pathLevelParams, doc, inj
     const errorResponses = buildErrorResponses(operation, path, doc);
     const security = resolveOperationSecurity(operation, doc, injectable);
     // Extensions aren't in the @redocly operation type — read loosely, like `deprecated`.
-    const paginationExtension = operation['x-redocly-pagination'];
+    const extensions = operation;
+    const paginationExtension = extensions['x-redoclyPagination'];
+    const sse = sseFromResponses(successResponses);
     return {
         name,
         method,
@@ -439,8 +450,34 @@ function buildOperation(method, path, operation, name, pathLevelParams, doc, inj
         security,
         tags: Array.isArray(operation.tags) ? operation.tags.filter((t) => typeof t === 'string') : [],
         ...(paginationExtension !== undefined ? { paginationExtension } : {}),
+        ...(sse === undefined ? {} : { sse }),
     };
 }
+/**
+ * The operation's SSE facts, from its `text/event-stream` success response (exact media
+ * type, parameters and case ignored). The event schema prefers the 3.2 `itemSchema` over
+ * the response `schema`, skipping typeless slots; structured kinds stream as JSON,
+ * scalar-ish ones as raw text.
+ */
+export function sseFromResponses(successResponses) {
+    const response = successResponses.find((candidate) => candidate.contentType.split(';')[0].trim().toLowerCase() === 'text/event-stream');
+    if (response === undefined)
+        return undefined;
+    const declared = response.itemSchema && response.itemSchema.kind !== 'unknown'
+        ? response.itemSchema
+        : response.schema.kind !== 'unknown'
+            ? response.schema
+            : undefined;
+    if (declared === undefined)
+        return { dataKind: 'text' };
+    const streamsJson = declared.kind === 'object' ||
+        declared.kind === 'ref' ||
+        declared.kind === 'array' ||
+        declared.kind === 'record' ||
+        declared.kind === 'union' ||
+        declared.kind === 'intersection';
+    return { eventSchema: declared, dataKind: streamsJson ? 'json' : 'text' };
+}
 function buildParameter(param, location, doc) {
     if (!param.in) {
         throw new NotSupportedError(`Parameter ${param.name} at ${location} is missing "in"`);
@@ -774,11 +811,29 @@ function scalarForEnumValues(values, location) {
         return 'boolean';
     return 'string';
 }
+/**
+ * Whether keywords beside a `$ref` apply. OpenAPI 3.1 is JSON Schema 2020-12, where
+ * `$ref` is an ordinary keyword and its siblings take effect; 3.0 and 2.0 predate that
+ * and a `$ref` replaces the whole schema object, so siblings mean nothing (the
+ * `spec-ref-siblings` lint rule reports them). Swagger 2 arrives here normalized to
+ * `3.0.3`, so it takes the 3.0 path.
+ */
+function refSiblingsApply(doc) {
+    return !(doc.openapi ?? '').startsWith('3.0');
+}
 function buildProperties(schema, location, doc) {
     const props = schema.properties ?? {};
     const required = new Set(schema.required ?? []);
+    const siblingsApply = refSiblingsApply(doc);
     return Object.entries(props).map(([name, sub]) => {
-        const readOnly = !isRef(sub) && sub.readOnly === true;
+        const declared = sub.readOnly === true;
+        // A `readOnly` sibling on a 3.0 `$ref` is a no-op the author almost certainly did
+        // not intend — it leaves a server-computed property in every request body — so it
+        // is reported rather than dropped in silence.
+        if (declared && isRef(sub) && !siblingsApply) {
+            logger.warn(`generate-client: "${name}" declares readOnly beside a $ref, which OpenAPI ${doc.openapi} ignores — the property stays in request bodies. Inline the schema, wrap the $ref in allOf, or move the description to OpenAPI 3.1.\n`);
+        }
+        const readOnly = declared && (siblingsApply || !isRef(sub));
         return {
             name,
             schema: schemaFromSlot(sub, `${location}.${name}`, doc),