@redocly/client-generator 0.7.10 → 0.7.12

package/eject-assets/generators/php/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.
@@ -18,7 +18,7 @@ import {
 } from '@redocly/client-generator';
 import type { PhpPrinter } from '@redocly/client-generator/printers/php';
 
-import { envelopeHeaderSpecs } from './descriptor.ts';
+import { envelopeHeaderSpecs, phpSecurityArg } from './descriptor.ts';
 import { hydration, serialization } from './models.ts';
 import { PHP, phpString } from './naming.ts';
 import { phpElementType, phpNullable, phpType } from './types.ts';
@@ -94,10 +94,15 @@ export function methodArgs(
 }
 
 /** The shared prologue: resolve auth, build query/url, merge headers. */
-function writeRequestSetup(printer: PhpPrinter, op: OperationModel, args: MethodArgs): void {
+function writeRequestSetup(
+  printer: PhpPrinter,
+  op: OperationModel,
+  model: ApiModel,
+  args: MethodArgs
+): void {
   printer.line(`$op = self::OPERATIONS[${phpString(op.specName ?? op.name)}];`);
   printer.line(
-    "[$authHeaders, $query, $cookies] = resolveAuth($op['security'] ?? [], $this->config->auth);"
+    `[$authHeaders, $query, $cookies] = resolveAuth(${phpSecurityArg(op, model)}, $this->config->auth);`
   );
   for (const { php, wire, value } of args.queryArgs) {
     printer.block(
@@ -154,13 +159,13 @@ export function writePhpMethod(
     envelope
       ? `Like ${ident}(), returning an Envelope with the declared response headers.`
       : (op.summary ?? `${op.method.toUpperCase()} ${op.path}`),
-    element === undefined ? [] : [`@return ${element}[]`]
+    element === undefined ? [] : [`@return ${element.includes('|') ? `(${element})` : element}[]`]
   );
   printer.line(`public function ${name}(${args.signature.join(', ')}): ${returnType}`);
   printer.block(
     '{',
     () => {
-      writeRequestSetup(printer, op, args);
+      writeRequestSetup(printer, op, model, args);
       if (sse !== undefined) {
         const jsonData = sse.schema !== undefined && sse.schema.kind !== 'unknown';
         printer.line('$url = appendQuery($url, $query);');

package/eject-assets/generators/php/pagination.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.
@@ -13,6 +13,7 @@ import {
 } from '@redocly/client-generator';
 import type { PhpPrinter } from '@redocly/client-generator/printers/php';
 
+import { phpSecurityArg } from './descriptor.ts';
 import { phpString } from './naming.ts';
 import { methodArgs } from './operations.ts';
 import { phpType } from './types.ts';
@@ -51,7 +52,7 @@ export function writePhpPaginationWrappers(
       '$call = function (array $params) use ($op, $headers): array {',
       () => {
         printer.line(
-          "[$authHeaders, $authQuery, $cookies] = resolveAuth($op['security'] ?? [], $this->config->auth);"
+          `[$authHeaders, $authQuery, $cookies] = resolveAuth(${phpSecurityArg(op, model)}, $this->config->auth);`
         );
         printer.line(`$url = buildUrl($this->config->serverUrl, $op['path'], [${pathDict}]);`);
         printer.line('$requestHeaders = array_merge($authHeaders, $headers ?? []);');

package/eject-assets/generators/php/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "php" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator php --update`.
@@ -9,6 +9,7 @@ import {
   type ApiModel,
   type DateType,
   deref,
+  discriminatorCases,
   enumValues,
   flattenAllOf,
   isNullable,
@@ -61,7 +62,16 @@ export function phpType(
       const kind = classify(schema.name, model);
       if (kind === 'class' || kind === 'enum') return className(schema.name);
       const target = deref(schema, model);
-      return target === undefined ? 'mixed' : phpType(target, model, dateType);
+      if (target === undefined) return 'mixed';
+      const type = phpType(target, model, dateType);
+      // A discriminated union hydrates through `unmarshalX`, which hands a value with an
+      // unknown discriminator back as the raw array.
+      // A nullable type drops its `?` first, because PHP forbids `?` inside a union.
+      const raw = discriminatorCases(target, model) !== undefined;
+      if (!raw || type === 'mixed' || type.split('|').includes('array')) return type;
+      const nullable = type.startsWith('?') || type.endsWith('|null');
+      const bare = type.startsWith('?') ? type.slice(1) : type.replace(/\|null$/, '');
+      return nullable ? phpNullable(`${bare}|array`) : `${bare}|array`;
     }
     case 'enum':
       // Anonymous (inline) enums keep the wire scalar; only NAMED enums get types.

package/eject-assets/generators/python/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/eject-assets/generators/python/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/eject-assets/generators/python/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.
@@ -138,7 +138,7 @@ export const pythonGenerator: Generator = ({
   for (const { op, ident } of operationIdents(model)) {
     paginationSpecs.set(ident, paginationSpec(pagination?.get(op.name)?.spec));
   }
-  printer.line('_OPERATIONS = {');
+  printer.line('_OPERATIONS: Dict[str, Dict[str, Any]] = {');
   printer.indent(() => {
     for (const { op, ident } of operationIdents(model)) {
       const descriptor = {
@@ -247,5 +247,5 @@ export default {
     "argsStyle": "inputs follow the target language's own idiom",
     "importExt": "the generated file has no relative imports"
   },
-  requiresGenerator: '^0.7.10',
+  requiresGenerator: '^0.7.12',
 };

package/eject-assets/generators/python/models.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.
@@ -84,6 +84,11 @@ function writeDataclass(
   /** The discriminator value this class is mapped to, pinned as a `Literal` (pydantic). */
   pinned?: DiscriminatorPin
 ): void {
+  // A response never carries a `writeOnly` property, and responses decode into this same
+  // class, so the property is optional even when the description requires it.
+  const fields = properties.map((property) =>
+    property.writeOnly ? { ...property, required: false } : property
+  );
   const pydantic = models === 'pydantic';
   if (!pydantic) printer.line('@dataclass');
   const header = pydantic ? `class ${className(name)}(BaseModel):` : `class ${className(name)}:`;
@@ -97,8 +102,8 @@ function writeDataclass(
     }
     // Required fields first — a dataclass field without a default may not follow one with.
     const ordered = [
-      ...properties.filter((property) => property.required),
-      ...properties.filter((property) => !property.required),
+      ...fields.filter((property) => property.required),
+      ...fields.filter((property) => !property.required),
     ];
     const fieldMap: Array<[string, string]> = [];
     if (ordered.length === 0) printer.line('pass');
@@ -157,6 +162,7 @@ export function renderPythonModels(
     'Optional',
     'Tuple',
     'Union',
+    'cast',
   ];
   if (models === 'dataclass') typingNames.splice(2, 0, 'ClassVar');
   if (unions.size > 0) typingNames.unshift('Annotated');

package/eject-assets/generators/python/naming.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/eject-assets/generators/python/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.
@@ -72,7 +72,7 @@ export function writeMethod(
     : sse !== undefined
       ? `${isAsync ? 'AsyncIterator' : 'Iterator'}[ServerSentEvent]`
       : errorMode === 'result'
-        ? 'Result'
+        ? `Result[${success === undefined ? 'None' : pythonType(success, dateType)}, Any]`
         : success === undefined
           ? 'None'
           : pythonType(success, dateType);
@@ -103,7 +103,7 @@ export function writeMethod(
     printer.line(`url = build_url(self._server_url, op["path"], {${pathDict}})`);
     if (sse !== undefined) {
       const dataKind = sse.schema !== undefined && sse.schema.kind !== 'unknown' ? 'json' : 'text';
-      printer.block('def _open(extra_headers: Dict[str, str]):', () => {
+      printer.block('def _open(extra_headers: Dict[str, str]) -> Any:', () => {
         printer.line(
           'return self._http.stream(op["method"], url, ' +
             'headers={**auth_headers, **(headers or {}), **extra_headers}, params=params, timeout=timeout)'
@@ -129,10 +129,11 @@ export function writeMethod(
         `headers={**auth_headers, **(headers or {})}, params=params${bodyKw}, ` +
         'timeout=timeout, retry=retry, idempotency_key=idempotency_key)'
     );
+    const successType = success === undefined ? undefined : pythonType(success, dateType);
     const decoded =
-      success === undefined
+      successType === undefined
         ? 'None'
-        : `decode(${pythonType(success, dateType)}, _safe_json(response))`;
+        : `cast(${successType}, decode(${successType}, _safe_json(response)))`;
     if (envelope) {
       printer.block('if not response.is_success:', () => {
         printer.line(

package/eject-assets/generators/python/pagination.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/eject-assets/generators/python/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "python" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator python --update`.

package/eject-assets/generators/swr/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "swr" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "swr" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator swr --update`.
@@ -33,5 +33,5 @@ export default {
   run: swrGenerator,
   requires: ["typescript"],
   errorModes: ["throw"],
-  requiresGenerator: '^0.7.10',
+  requiresGenerator: '^0.7.12',
 };

package/eject-assets/generators/swr/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "swr" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "swr" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator swr --update`.

package/eject-assets/generators/tanstack-query/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "tanstack-query" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "tanstack-query" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator tanstack-query --update`.
@@ -44,5 +44,5 @@ export default {
   run: tanstackQueryGenerator('react'),
   requires: ["typescript"],
   errorModes: ["throw"],
-  requiresGenerator: '^0.7.10',
+  requiresGenerator: '^0.7.12',
 };

package/eject-assets/generators/tanstack-query/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "tanstack-query" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "tanstack-query" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator tanstack-query --update`.
@@ -236,12 +236,13 @@ function infiniteMember(
     );
   }
   // The cursor is a query parameter, so it lands in the sdk's own spelling for one:
-  // inside the `query` layer, or at the top level of a merged call.
-  const cursor = safeIdent(spec.param);
+  // inside the `query` layer, or at the top level of a merged call. A first page without
+  // a cursor leaves the key out, so `exactOptionalPropertyTypes` accepts the call.
+  const cursor = `...(pageParam === undefined ? {} : { ${safeIdent(spec.param)}: pageParam })`;
   const override =
     argsStyle === 'flat'
-      ? `{ ...vars, ${cursor}: pageParam }`
-      : `{ ...vars, query: { ...vars.query, ${cursor}: pageParam } }`;
+      ? `{ ...vars, ${cursor} }`
+      : `{ ...vars, query: { ...vars.query, ${cursor} } }`;
   return (
     `    ${op.name}InfiniteOptions: (${params}) => infiniteQueryOptions({\n` +
     `        queryKey: [...${op.name}QueryKey(${keyArg}), "infinite"] as const,\n` +

package/eject-assets/generators/transformers/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "transformers" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "transformers" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator transformers --update`.
@@ -42,5 +42,5 @@ export default {
   run: transformersGenerator,
   requires: ["typescript"],
   dateTypes: ["Date"],
-  requiresGenerator: '^0.7.10',
+  requiresGenerator: '^0.7.12',
 };

package/eject-assets/generators/transformers/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "transformers" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "transformers" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator transformers --update`.
@@ -13,7 +13,12 @@
 // `transformPet` calls `transformOwner(data["owner"])` when `Pet.owner` is an
 // `Owner` that has dates. Source-text templates throughout.
 
-import type { ApiModel, NamedSchemaModel, SchemaModel } from '@redocly/client-generator';
+import {
+  type ApiModel,
+  flattenAllOf,
+  type NamedSchemaModel,
+  type SchemaModel,
+} from '@redocly/client-generator';
 import { pascalCase, safeIdent } from '@redocly/client-generator/printers/typescript';
 
 const INDENT = '    ';
@@ -467,8 +472,17 @@ function convertCollection(
   );
 }
 
-/** `export const transform<Name> = (data: <Name>): <Name> => { … };`. */
-function transformBlock(named: NamedSchemaModel, byName: Map<string, SchemaModel>): string {
+/**
+ * `export const transform<Name> = (data: <Name>): <Name> => { … };`. A schema with
+ * `writeOnly` properties is never returned whole: its responses are typed
+ * `Omit<Name, …>`. Its transform takes that shape and returns the type it was given:
+ * `<T extends Omit<Name, …>>(input: T): T`.
+ */
+function transformBlock(
+  named: NamedSchemaModel,
+  model: ApiModel,
+  byName: Map<string, SchemaModel>
+): string {
   // The sdk exports the type verbatim; only the `transform<Pascal>` NAME is PascalCased.
   const typeName = named.name;
   const data = ident('data');
@@ -476,10 +490,23 @@ function transformBlock(named: NamedSchemaModel, byName: Map<string, SchemaModel
     named.schema.kind === 'ref'
       ? convertRef(data, named.schema.name, byName, new Set(), INDENT)
       : convert(data, named.schema, byName, new Set(), 'data', INDENT);
+  const writeOnly = (flattenAllOf(named.schema, model)?.properties ?? [])
+    .filter((property) => property.writeOnly)
+    .map((property) => JSON.stringify(property.name));
+  if (writeOnly.length === 0) {
+    return [
+      `export const ${transformName(named.name)} = (data: ${typeName}): ${typeName} => {`,
+      ...body,
+      `${INDENT}return data;`,
+      '};',
+    ].join('\n');
+  }
+  const response = `Omit<${typeName}, ${writeOnly.join(' | ')}>`;
   return [
-    `export const ${transformName(named.name)} = (data: ${typeName}): ${typeName} => {`,
+    `export const ${transformName(named.name)} = <T extends ${response}>(input: T): T => {`,
+    `${INDENT}const data: ${response} = input;`,
     ...body,
-    `${INDENT}return data;`,
+    `${INDENT}return input;`,
     '};',
   ].join('\n');
 }
@@ -496,7 +523,7 @@ export function renderTransformersModule(model: ApiModel, opts: { sdkModule: str
   if (dated.length === 0) return '';
   const types = dated.map((s) => safeIdent(s.name)).join(', ');
   writableUsed = false; // reset the per-render flag `writableLhs` sets
-  const transforms = dated.map((s) => transformBlock(s, byName));
+  const transforms = dated.map((s) => transformBlock(s, model, byName));
   const blocks = [
     `import type { ${types} } from ${JSON.stringify(opts.sdkModule)};`,
     ...(writableUsed ? [WRITABLE_DECL] : []),

package/eject-assets/generators/typescript/banner.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/typescript/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/typescript/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/typescript/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.
@@ -123,5 +123,5 @@ export default {
   run: typescriptGenerator,
   sample: typescriptSample,
   docs: typescriptDocs,
-  requiresGenerator: '^0.7.10',
+  requiresGenerator: '^0.7.12',
 };

package/eject-assets/generators/typescript/inline-runtime.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/typescript/operation-signature.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/typescript/operation-types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/typescript/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/typescript/response-headers.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/typescript/type-guards.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/typescript/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "typescript" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator typescript --update`.

package/eject-assets/generators/zod/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "zod" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "zod" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator zod --update`.
@@ -28,5 +28,5 @@ export const zodGenerator: Generator = ({ model, output, banner }) => {
 export default {
   name: 'zod',
   run: zodGenerator,
-  requiresGenerator: '^0.7.10',
+  requiresGenerator: '^0.7.12',
 };

package/eject-assets/generators/zod/schemas.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.10 — the built-in "zod" generator.
+// Ejected from @redocly/client-generator@0.7.12 — the built-in "zod" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator zod --update`.

package/eject-assets/skills/go-generator/SKILL.md

@@ -19,6 +19,9 @@ runtime. Go ≥ 1.21, standard library only — zero dependencies.
 
 - **Models are structs**: required fields by value, optionals as pointers with
   `,omitempty`; the `json` tag always carries the exact wire name.
+- **A `writeOnly` property is optional** even when required: requests and responses share
+  one struct, and a response never carries it. A pointer with `,omitempty` still sends it
+  in a request, and leaves it `nil` in a response instead of claiming a zero value.
 - **Package clause:** `package client` by default, `goPackage` to override — a generated
   file usually lands in a package the consumer already owns. The value is checked against
   Go's own rule (lowercase letters, digits, `_`, no leading digit, not a keyword) and an

package/eject-assets/skills/mock-generator/SKILL.md

@@ -22,6 +22,28 @@ A standalone MSW module: `create<Name>()` data factories, `<op>Handler()` /
 - **Interpolated identifiers are gated** (`codeIdent`): an operation name or method
   reaching a code position is validated, never trusted, even though the pipeline
   sanitizes upstream.
+- **Mock data satisfies the description** it came from, so it passes the zod schemas
+  generated from the same description:
+  - Numeric samples respect `minimum`, `maximum`, `exclusiveMinimum`,
+    `exclusiveMaximum`, and `multipleOf`. A static sample is `0` when `0` is in range,
+    else the lowest valid value (the highest one when only an upper bound is set).
+    Faker mode passes the same inclusive range to `faker.number.*`; when only one side
+    is set, the other side is 100 steps away, because faker's own defaults can sit on
+    the wrong side of the bound.
+  - Mocks are response data, and responses never carry `writeOnly` properties. An
+    optional one is never emitted. A required one stays in the factories, because the
+    named type (and its zod schema) demands it. A handler whose response leaves the
+    `writeOnly` properties out (an `omit` body) samples that shape inline, typed
+    `Partial<Omit<Name, …>>`, so its body leaves them out too.
+  - The default handler of a paginated operation ends the walk. A cursor page is the
+    last page: the next cursor is `null` when nullable, absent when optional, and `""`
+    otherwise, and `hasMore` is `false`. A `body-link` page is the last page the same
+    way, through its next link. So `.pages()` ends after one page. Offset and
+    page-number styles stop only on an empty page, so the handler answers any position
+    past the first with an empty item list, and `.pages()` ends after that empty page.
+    The handler's `override` sets the first page: it is spread into an object page, or
+    replaces a page that is the item array. The empty page sets its items after the
+    spread, so an override cannot refill it.
 - Handlers are opt-in overrides: `<op>ErrorHandler` is NOT in `handlers`.
 - The module references the sdk's TYPES only — never its runtime.
 

package/eject-assets/skills/php-generator/SKILL.md

@@ -23,8 +23,15 @@ extension — zero Composer dependencies. The namespace derives from the API tit
   `fromArray(array $data): self` and `toArray(): array` (wire names inline; nulls
   skipped on serialize) — no reflection. `omit` schemas hydrate/serialize through their
   base class. A property or response typed as a DISCRIMINATED union hydrates through the
-  union's `unmarshalX` dispatcher, so consumers can narrow with `instanceof`;
-  undiscriminated unions stay raw arrays.
+  union's `unmarshalX` dispatcher, so consumers can narrow with `instanceof`; its type
+  includes `array`, because a value with an unknown discriminator stays the raw array.
+  Undiscriminated unions stay raw arrays.
+- **The file passes PHPStan level 5.** It lands in the user's own project, so their
+  analyser reads it. The operations table is a constant PHPStan knows exactly, so a method
+  reads `$op['security']` only when the table has that entry, and passes `[]` otherwise.
+- **A `writeOnly` property is optional** even when required: requests and responses share
+  one class, and a response never carries it. It is nullable `= null`, so `fromArray`
+  hydrates a response without it and `toArray` still sends it in a request.
 - The `Client` class is NOT `final` — PHP test suites mock concrete classes
   (`createMock(Client::class)`), and `final` would force a wrapper interface on every
   consumer. Model classes stay `final`.

package/eject-assets/skills/python-generator/SKILL.md

@@ -26,6 +26,12 @@ One self-contained `<stem>.py`: typed dataclass models, a sync `Client` and an a
 - **Models are dataclasses by default**, required fields first (a dataclass constraint),
   optionals `Optional[T] = None`. Wire names live in a `_field_map: ClassVar[Dict[str, str]]`;
   decode/encode is reflective (`_decode.py`, `get_type_hints`) — no per-model codecs.
+- **The file passes `mypy --strict`.** It lands in the user's own package, so their
+  strictest checker reads it: every function is annotated, the operation table is typed,
+  and a decoded body is `cast` to the declared return type (`decode` returns `Any`).
+- **A `writeOnly` property is optional** even when required: requests and responses share
+  one model, and a response never carries it. It is `Optional[T] = None`, so a response
+  decodes without it and a request still sends it.
 - **`models: pydantic` emits `BaseModel` classes instead**, for the FastAPI-shaped half of
   the ecosystem that expects them. A wire name becomes `Field(alias=…)` with
   `populate_by_name=True`, so `_field_map` is not emitted in this mode — the alias is the

package/eject-assets/skills/tanstack-query-generator/SKILL.md

@@ -25,7 +25,8 @@ query keys. One generator, four framework variants (`react` default, `-vue`,
   `body-link` rule gets one when the operation has a query parameter: the next page's
   URL is the page param, and each later page merges the URL's query parameters over
   `vars`. A `Link` header is invisible to a `queryFn`, so `link`-style operations get
-  only the sdk's `.pages()`/`.items()`.
+  only the sdk's `.pages()`/`.items()`. A page without a page parameter leaves the key
+  out of the call, so `exactOptionalPropertyTypes` holds.
 - **`envelope` is excluded and stripped** — cached data is the plain body.
 - Requires `typescript`; throw-mode only (it wraps thrown errors into query errors).
 

package/eject-assets/skills/transformers-generator/SKILL.md

@@ -22,6 +22,10 @@ values and back — the bridge for `dateType: Date` clients.
 - **Imports the sdk's schema TYPES** (so `typescript` is required) and nothing else.
 - Converters are pure and total: every named schema gets a pair, nested structures
   recurse, and a missing optional stays missing.
+- **A transform takes response data.** A response never carries `writeOnly`
+  properties, so the sdk types it `Omit<Name, …>`. The transform of a schema with
+  `writeOnly` properties takes that shape and returns the type it was given:
+  `<T extends Omit<Name, …>>(input: T): T`. Other transforms keep `(data: Name): Name`.
 
 ## The stage files
 

package/eject-assets/skills/typescript-generator/SKILL.md

@@ -30,6 +30,11 @@ it with `use(telemetry({ sdkName, sdkVersion, client }))`.
   an entry that `export *`s it; the entry type-imports only the schema names it
   references (`collectEntrySchemaRefs`).
 - **Zero runtime dependencies.** `Date`, `Blob`, `fetch` — nothing else.
+- **It type-checks under the strictest common settings.** The output compiles as part of
+  the user's sources, so `skipLibCheck` does not cover it: `strict`,
+  `noUncheckedIndexedAccess`, and `exactOptionalPropertyTypes` must all pass. Guard an
+  index access explicitly instead of asserting it, and leave an absent optional key out
+  (a conditional spread) instead of setting it to `undefined`.
 - **Timeouts need no platform statics.** `send()` uses `AbortSignal.timeout()` and
   `AbortSignal.any()` where they exist and builds the same signal from an `AbortController`
   and `setTimeout` where they do not (Chrome before 116, Safari before 17.4, Firefox before

package/lib/authoring/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/authoring/schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,WAAW,EACZ,MAAM,yCAAyC,CAAC;AAGjD,4FAA4F;AAC5F,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAYnF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,QAAQ,GACd;IAAE,UAAU,EAAE,aAAa,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAcnE;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,QAAQ,GAEb;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;CAAE,GAC9F,SAAS,CAUZ;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEvD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAI/D;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,GAClB;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAcjG;AAED,2FAA2F;AAC3F,wBAAgB,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMtD;AAuBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,GACd,WAAW,GAAG,SAAS,CAYzB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE;IAAE,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,EAC/C,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAoC7C"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/authoring/schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,WAAW,EACZ,MAAM,yCAAyC,CAAC;AAGjD,4FAA4F;AAC5F,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAYnF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,QAAQ,GACd;IAAE,UAAU,EAAE,aAAa,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAcnE;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,QAAQ,GAEb;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;CAAE,GAC9F,SAAS,CAUZ;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEvD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAI/D;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,GAClB;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAcjG;AAED,2FAA2F;AAC3F,wBAAgB,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMtD;AAuBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,GACd,WAAW,GAAG,SAAS,CAezB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE;IAAE,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,EAC/C,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAoC7C"}