@redocly/cli 2.59.0 → 2.61.0

package/lib/chunks/{2U6O26CV.js → XJE2OFDN.js}

@@ -259,12 +259,14 @@ func retryDelay(retry RetryConfig, attempt int, retryAfter string) time.Duration
 }
 
 type requestSpec struct {
-	OperationID    string
-	Method         string
-	URL            string
-	Headers        map[string]string
-	Query          url.Values
-	Body           io.Reader
+	OperationID string
+	Method      string
+	URL         string
+	Headers     map[string]string
+	Query       url.Values
+	Body        io.Reader
+	// Stream sends Body as is: no buffering, one attempt, the caller's Content-Type.
+	Stream         bool
 	ContentType    string
 	Timeout        time.Duration
 	Retry          *RetryConfig
@@ -303,7 +305,7 @@ func send(ctx context.Context, config *Config, spec requestSpec) (*http.Response
 	if httpClient == nil {
 		httpClient = http.DefaultClient
 	}
-	if spec.Body != nil {
+	if spec.Body != nil && !spec.Stream {
 		payload, err := io.ReadAll(spec.Body)
 		if err != nil {
 			return nil, err
@@ -319,6 +321,10 @@ func send(ctx context.Context, config *Config, spec requestSpec) (*http.Response
 		fullURL += separator + spec.Query.Encode()
 	}
 	maxAttempts := 1 + retry.Retries
+	if spec.Stream {
+		// The first attempt consumes the reader, so there is nothing to replay.
+		maxAttempts = 1
+	}
 	for attempt := 1; ; attempt++ {
 		attemptCtx := ctx
 		var cancel context.CancelFunc
@@ -326,7 +332,10 @@ func send(ctx context.Context, config *Config, spec requestSpec) (*http.Response
 			attemptCtx, cancel = context.WithTimeout(ctx, timeout)
 		}
 		var bodyReader io.Reader
-		if spec.bodyBytes != nil {
+		switch {
+		case spec.Stream:
+			bodyReader = spec.Body
+		case spec.bodyBytes != nil:
 			bodyReader = bytes.NewReader(spec.bodyBytes)
 		}
 		req, err := http.NewRequestWithContext(attemptCtx, method, fullURL, bodyReader)
@@ -339,7 +348,7 @@ func send(ctx context.Context, config *Config, spec requestSpec) (*http.Response
 		for key, value := range headers {
 			req.Header.Set(key, value)
 		}
-		if spec.ContentType != "" && spec.bodyBytes != nil {
+		if spec.ContentType != "" && bodyReader != nil && req.Header.Get("Content-Type") == "" {
 			req.Header.Set("Content-Type", spec.ContentType)
 		}
 		for _, mw := range config.Middleware {
@@ -863,6 +872,41 @@ func toMultipart(body any) (string, io.Reader, error) {
 	}
 	return writer.FormDataContentType(), buffer, nil
 }
+
+// multipartBody prepares the body of an untyped multipart operation: an io.Reader is
+// streamed and a []byte or string sent as is, all under the caller's Content-Type (the
+// boundary is theirs to set); any other value goes through toMultipart.
+func multipartBody(body any) (string, io.Reader, bool, error) {
+	if reader, stream, raw := rawBody(body); raw {
+		return "", reader, stream, nil
+	}
+	contentType, reader, err := toMultipart(body)
+	return contentType, reader, false, err
+}
+
+// binaryBody prepares the body of a binary operation: an io.Reader is streamed, a
+// []byte or string sent as is, and any other value JSON-marshalled.
+func binaryBody(body any) (io.Reader, bool, error) {
+	if reader, stream, raw := rawBody(body); raw {
+		return reader, stream, nil
+	}
+	payload, err := json.Marshal(body)
+	return bytes.NewReader(payload), false, err
+}
+
+// rawBody recognizes a body that needs no encoding: an io.Reader streams through in one
+// attempt, a []byte or a string is replayable bytes.
+func rawBody(body any) (io.Reader, bool, bool) {
+	switch typed := body.(type) {
+	case io.Reader:
+		return typed, true, true
+	case []byte:
+		return bytes.NewReader(typed), false, true
+	case string:
+		return strings.NewReader(typed), false, true
+	}
+	return nil, false, false
+}
 `;var t=`<?php
 
 // @redocly/client-generator PHP runtime \u2014 embedded into generated clients.
@@ -1080,8 +1124,17 @@ function rawSend(Config $config, array $request): array
             return strlen($line);
         },
     ]);
-    if (($request['body'] ?? null) !== null) {
-        curl_setopt($handle, CURLOPT_POSTFIELDS, $request['body']);
+    $body = $request['body'] ?? null;
+    if (is_resource($body)) {
+        curl_setopt_array($handle, [CURLOPT_UPLOAD => true, CURLOPT_INFILE => $body]);
+        // php://input and wrappers without stream_stat report seekable but fstat() fails (with a
+        // warning for the wrappers): those go chunked.
+        $stat = @fstat($body);
+        if (stream_get_meta_data($body)['seekable'] && $stat !== false) {
+            curl_setopt($handle, CURLOPT_INFILESIZE, $stat['size'] - ftell($body));
+        }
+    } elseif ($body !== null) {
+        curl_setopt($handle, CURLOPT_POSTFIELDS, $body);
     }
     if ($config->timeout !== null) {
         curl_setopt($handle, CURLOPT_TIMEOUT_MS, (int) round($config->timeout * 1000));
@@ -1120,7 +1173,8 @@ function send(Config $config, array $request): array
 {
     $headers = $request['headers'] ?? [];
     $headers['X-Redocly-Client'] = $config->clientHeader;
-    if (($request['contentType'] ?? null) !== null) {
+    $callerContentType = in_array('content-type', array_map('strtolower', array_keys($headers)), true);
+    if (($request['contentType'] ?? null) !== null && !$callerContentType) {
         $headers['Content-Type'] = $request['contentType'];
     }
     if (($request['idempotencyKey'] ?? null) !== null) {
@@ -1134,7 +1188,8 @@ function send(Config $config, array $request): array
         $handler = fn (array $req): array => $middleware($req, $next);
     }
 
-    $attempts = max(1, (int) ($config->retry['attempts'] ?? 3));
+    // The first attempt consumes a stream resource, so there is nothing to replay.
+    $attempts = is_resource($request['body'] ?? null) ? 1 : max(1, (int) ($config->retry['attempts'] ?? 3));
     $retryOn = $config->retry['retryOn'] ?? __NAMESPACE__ . '\\\\defaultRetryOn';
     $response = null;
     for ($attempt = 1; $attempt <= $attempts; $attempt++) {
@@ -1367,6 +1422,22 @@ function toMultipart(array $body): array
     $parts .= "--{$boundary}--\\r\\n";
     return ['multipart/form-data; boundary=' . $boundary, $parts];
 }
+
+/**
+ * The body of an untyped multipart operation: a stream resource or a string passes through
+ * under the caller's Content-Type (the boundary is theirs to set); an array is encoded.
+ * Returns \`[contentType, body]\`.
+ */
+function multipartBody(mixed $body): array
+{
+    return is_array($body) ? toMultipart($body) : [null, $body];
+}
+
+/** The body of an octet-stream operation: a stream resource or a string passes through; anything else is JSON. */
+function binaryBody(mixed $body): mixed
+{
+    return is_resource($body) || is_string($body) ? $body : json_encode($body);
+}
 `;var n={"_errors.py":`# Runtime errors and the result-mode envelope for generated Python clients.
 # Hand-authored once, embedded into every generated client (see
 # scripts/generate-runtime-sources.mjs) \u2014 mirror of the TypeScript runtime's
@@ -1706,6 +1777,7 @@ def send(
     params: Optional[Dict[str, Any]] = None,
     json_body: Any = None,
     content: Any = None,
+    content_type: Optional[str] = None,
     data: Any = None,
     files: Any = None,
     timeout: Optional[float] = None,
@@ -1727,6 +1799,9 @@ def send(
         merged_headers["Idempotency-Key"] = (
             key if isinstance(key, str) else key() if callable(key) else str(uuid.uuid4())
         )
+    # The declared content type fills the gap; a caller-provided header always wins.
+    if content_type is not None and not any(name.lower() == "content-type" for name in merged_headers):
+        merged_headers["Content-Type"] = content_type
 
     context = {
         "url": url,
@@ -1741,7 +1816,9 @@ def send(
         if on_request:
             on_request(context)
 
-    max_attempts = 1 + int(merged_retry.get("retries", 0))
+    # A file-like object or iterator is consumed by the first attempt and cannot be replayed, so it never retries.
+    replayable = content is None or isinstance(content, (bytes, bytearray, str))
+    max_attempts = 1 + int(merged_retry.get("retries", 0)) if replayable else 1
     retry_on = merged_retry.get("retry_on") or (
         lambda ctx: _default_retry_on(context["method"], context["headers"], ctx.get("response"))
     )
@@ -1800,6 +1877,7 @@ async def send_async(
     params: Optional[Dict[str, Any]] = None,
     json_body: Any = None,
     content: Any = None,
+    content_type: Optional[str] = None,
     data: Any = None,
     files: Any = None,
     timeout: Optional[float] = None,
@@ -1819,6 +1897,8 @@ async def send_async(
         merged_headers["Idempotency-Key"] = (
             key if isinstance(key, str) else key() if callable(key) else str(uuid.uuid4())
         )
+    if content_type is not None and not any(name.lower() == "content-type" for name in merged_headers):
+        merged_headers["Content-Type"] = content_type
     context = {
         "url": url,
         "method": method.upper(),
@@ -1831,7 +1911,9 @@ async def send_async(
         on_request = getattr(mw, "on_request", None) or (mw.get("on_request") if isinstance(mw, dict) else None)
         if on_request:
             on_request(context)
-    max_attempts = 1 + int(merged_retry.get("retries", 0))
+    # A file-like object or iterator is consumed by the first attempt and cannot be replayed, so it never retries.
+    replayable = content is None or isinstance(content, (bytes, bytearray, str))
+    max_attempts = 1 + int(merged_retry.get("retries", 0)) if replayable else 1
     retry_on = merged_retry.get("retry_on") or (
         lambda ctx: _default_retry_on(context["method"], context["headers"], ctx.get("response"))
     )
@@ -2244,7 +2326,9 @@ async def aiter_sse(
 `,"_multipart.py":`# Multipart bodies for generated Python clients \u2014 a typed dict/dataclass body is
 # split into httpx's (data, files): bytes and file-like values upload as parts,
 # everything else is form data (nested values JSON-encoded, mirroring the
-# TypeScript runtime's FormData serialization).
+# TypeScript runtime's FormData serialization). A body that is already bytes, a
+# \`str\`, a file-like object, or an (async) iterator of bytes passes through as httpx
+# \`content=\` untouched; the caller sets its Content-Type.
 from __future__ import annotations
 
 import json
@@ -2265,4 +2349,20 @@ def to_multipart(body: Any) -> Tuple[Dict[str, Any], Dict[str, Any]]:
         else:
             data[key] = value
     return data, files
+
+
+def is_stream_body(body: Any) -> bool:
+    return (
+        isinstance(body, (bytes, bytearray, str))
+        or callable(getattr(body, "read", None))
+        or hasattr(body, "__next__")
+        or hasattr(body, "__aiter__")
+    )
+
+
+def multipart_arguments(body: Any) -> Dict[str, Any]:
+    if is_stream_body(body):
+        return {"content": body}
+    data, files = to_multipart(body)
+    return {"data": data, "files": files}
 `};export{e as a,t as b,n as c};

package/lib/chunks/{6IOZ5LPA.js → YEOWW3LR.js}

@@ -4,5 +4,5 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{l as t}from"./NC5GB4G5.js";import"./LRUXN6H5.js";import{ga as o}from"./PHV3T4WH.js";import"./NEWT5A6S.js";import"./RFWIIJFG.js";async function i({version:n}){new t(n).logout(),o.output(`Logged out from the Redocly account. \u270B 
+import{l as t}from"./3TBVUHVH.js";import"./LRUXN6H5.js";import{ia as o}from"./22EANOP2.js";import"./NEWT5A6S.js";import"./RFWIIJFG.js";async function i({version:n}){new t(n).logout(),o.output(`Logged out from the Redocly account. \u270B 
 `)}export{i as handleLogout};

package/lib/chunks/{7W4L5LRS.js → ZH5HJBCG.js}

@@ -4,4 +4,4 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{a,b,c,d,e,f}from"./IDDPOAAO.js";import"./2U6O26CV.js";import"./DBWAOHZO.js";import"./J56XVM43.js";import"./WZXA5XPB.js";import"./PHV3T4WH.js";import"./NEWT5A6S.js";import"./UW4UC7ZI.js";import"./RFWIIJFG.js";export{f as pythonDocs,d as pythonGenerator,c as pythonOptions,e as pythonSample,a as pythonType,b as renderPythonModels};
+import{a,b,c,d,e,f}from"./WCWEP2X5.js";import"./XJE2OFDN.js";import"./ERFYZ47T.js";import"./V5CIDI6D.js";import"./WZXA5XPB.js";import"./22EANOP2.js";import"./NEWT5A6S.js";import"./UW4UC7ZI.js";import"./RFWIIJFG.js";export{f as pythonDocs,d as pythonGenerator,c as pythonOptions,e as pythonSample,a as pythonType,b as renderPythonModels};

package/lib/chunks/ZOE6CZ74.js

@@ -0,0 +1,8 @@
+import { createRequire as __createRequire } from 'node:module';
+import { fileURLToPath as __fileURLToPath } from 'node:url';
+import { dirname as __pathDirname } from 'node:path';
+const require = __createRequire(import.meta.url);
+var __filename = __fileURLToPath(import.meta.url);
+var __dirname = __pathDirname(__filename);
+import{u as o}from"./F6IXS3RL.js";import{ba as t}from"./22EANOP2.js";var r="    ",a="  ";function g(i){let p=Math.max(...i.map(n=>o(n).length)),e=p+a.length*2,c=r+t("\u2551"+" ".repeat(e)+"\u2551");return["",r+t("\u2554"+"\u2550".repeat(e)+"\u2557"),c,...i.map(n=>{let h=" ".repeat(p-o(n).length);return`${r}${t("\u2551")}${a}${n}${h}${a}${t("\u2551")}`}),c,r+t("\u255A"+"\u2550".repeat(e)+"\u255D"),"",""].join(`
+`)}export{g as a};

package/lib/eject-assets/AGENTS.md

@@ -91,29 +91,30 @@ discriminated union on `kind`: `scalar`, `array`, `object`, `record`, `ref`,
 
 ## Helpers (import from '@redocly/client-generator')
 
-| Helper                                                  | Use                                                                                                                              |
-| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `flattenAllOf(schema, model)`                           | The merged property view of allOf compositions — languages without intersection types render this.                               |
-| `deref(schema, model)`                                  | Follow a `ref` chain to the schema it names (cycle-guarded).                                                                     |
-| `jsonSuccessSchema(op)` / `sseResponse(op)`             | The primary JSON success schema; the `text/event-stream` response when the operation streams.                                    |
-| `isMultipartBody(op)`                                   | Whether the request body is multipart.                                                                                           |
-| `isBinaryContentType(contentType)`                      | Whether a body of this content type is bytes (archives, PDF, images, media) — decode it as a Blob, not JSON or text.             |
-| `serverUrlParts(server)`                                | A server-URL template as literal/variable parts, ready for any concatenation syntax.                                             |
-| `securityRequirements(op, model)`                       | The operation's security as OR-alternatives of AND-sets, denormalized against the declared schemes.                              |
-| `paginationItemSchema(pageSchema, itemsPointer, model)` | The raw element schema behind a pagination rule's `items` pointer — a `ref` element keeps its name.                              |
-| `discriminatorCases(schema, model)`                     | `{ property, cases }` dispatch table for discriminated unions.                                                                   |
-| `isNullable(schema)` / `unwrapNullable(schema)`         | Detect and strip `null` union members (`Optional[T]`, pointers, `Option<T>`).                                                    |
-| `enumValues(schema)`                                    | Values plus SCREAMING_SNAKE member-name suggestions.                                                                             |
-| `headerCoerceType(schema, model)`                       | Response-header coerce hint (`integer`/`number`/`boolean`/`string`) through refs, nullables, and allOf wrappers.                 |
-| `casing` / `identifierFor(name, { style, reserved })`   | camel/pascal/snake/screaming; keyword-safe identifiers (`RESERVED_WORDS.python/go/typescript` shipped).                          |
-| `uniqueIdentifiers(names, { style, reserved, taken })`  | The same, made unique among themselves and among names you already took — for a signature that takes one argument per parameter. |
-| `Printer`                                               | Indentation-aware text builder — no manual whitespace bookkeeping.                                                               |
-| `docText(description)`                                  | Description as trimmed lines for any comment syntax.                                                                             |
-| `schemaAtPointer(schema, pointer, model)`               | Resolve an RFC 6901 JSON pointer over a schema (through refs and allOf) — e.g. a pagination `items` pointer to its element type. |
-| `paginationRuleFor(op, config)`                         | The pagination rule that applies to an operation (per-op config > extension > fitting convention), normalized.                   |
-| `renderReferencePage(model, options)`                   | The Markdown reference page a generator's `docs` hook returns — your `sample` hook supplies its call snippets.                   |
-| `NotSupportedError`                                     | Throw it to reject an option the generator can't honor — the CLI prints the message as a user error, not a crash.                |
-| `AUTHORING_HELPER_NAMES`                                | The list of the above (introspection).                                                                                           |
+| Helper                                                  | Use                                                                                                                                  |
+| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `flattenAllOf(schema, model)`                           | The merged property view of allOf compositions — languages without intersection types render this.                                   |
+| `deref(schema, model)`                                  | Follow a `ref` chain to the schema it names (cycle-guarded).                                                                         |
+| `jsonSuccessSchema(op)` / `sseResponse(op)`             | The primary JSON success schema; the `text/event-stream` response when the operation streams.                                        |
+| `isMultipartBody(op)`                                   | Whether the request body is multipart.                                                                                               |
+| `isUntypedMultipartBody(op)`                            | Whether the request body is multipart with a schema that is neither an object nor a `$ref`, so the caller supplies the encoded body. |
+| `isBinaryContentType(contentType)`                      | Whether a body of this content type is bytes (archives, PDF, images, media) — decode it as a Blob, not JSON or text.                 |
+| `serverUrlParts(server)`                                | A server-URL template as literal/variable parts, ready for any concatenation syntax.                                                 |
+| `securityRequirements(op, model)`                       | The operation's security as OR-alternatives of AND-sets, denormalized against the declared schemes.                                  |
+| `paginationItemSchema(pageSchema, itemsPointer, model)` | The raw element schema behind a pagination rule's `items` pointer — a `ref` element keeps its name.                                  |
+| `discriminatorCases(schema, model)`                     | `{ property, cases }` dispatch table for discriminated unions.                                                                       |
+| `isNullable(schema)` / `unwrapNullable(schema)`         | Detect and strip `null` union members (`Optional[T]`, pointers, `Option<T>`).                                                        |
+| `enumValues(schema)`                                    | Values plus SCREAMING_SNAKE member-name suggestions.                                                                                 |
+| `headerCoerceType(schema, model)`                       | Response-header coerce hint (`integer`/`number`/`boolean`/`string`) through refs, nullables, and allOf wrappers.                     |
+| `casing` / `identifierFor(name, { style, reserved })`   | camel/pascal/snake/screaming; keyword-safe identifiers (`RESERVED_WORDS.python/go/typescript` shipped).                              |
+| `uniqueIdentifiers(names, { style, reserved, taken })`  | The same, made unique among themselves and among names you already took — for a signature that takes one argument per parameter.     |
+| `Printer`                                               | Indentation-aware text builder — no manual whitespace bookkeeping.                                                                   |
+| `docText(description)`                                  | Description as trimmed lines for any comment syntax.                                                                                 |
+| `schemaAtPointer(schema, pointer, model)`               | Resolve an RFC 6901 JSON pointer over a schema (through refs and allOf) — e.g. a pagination `items` pointer to its element type.     |
+| `paginationRuleFor(op, config)`                         | The pagination rule that applies to an operation (per-op config > extension > fitting convention), normalized.                       |
+| `renderReferencePage(model, options)`                   | The Markdown reference page a generator's `docs` hook returns — your `sample` hook supplies its call snippets.                       |
+| `NotSupportedError`                                     | Throw it to reject an option the generator can't honor — the CLI prints the message as a user error, not a crash.                    |
+| `AUTHORING_HELPER_NAMES`                                | The list of the above (introspection).                                                                                               |
 
 Worked example: the built-in `python` generator
 (`packages/client-generator/src/generators/python/index.ts` in the Redocly CLI repo) is

package/lib/eject-assets/generators/cli/docs.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "cli" 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 cli --update`.

package/lib/eject-assets/generators/cli/engine-source.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "cli" 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 cli --update`.

package/lib/eject-assets/generators/cli/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "cli" 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 cli --update`.
@@ -86,5 +86,5 @@ export default {
   docs: cliDocs,
   requires: ["typescript","zod"],
   errorModes: ["throw"],
-  requiresGenerator: '^0.4.24',
+  requiresGenerator: '^0.5.0',
 };

package/lib/eject-assets/generators/cli/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "cli" 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 cli --update`.

package/lib/eject-assets/generators/go/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "go" 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 go --update`.

package/lib/eject-assets/generators/go/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "go" 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 go --update`.

package/lib/eject-assets/generators/go/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "go" 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 go --update`.
@@ -332,5 +332,5 @@ export default {
     "argsStyle": "inputs follow the target language's own idiom",
     "importExt": "the generated file has no relative imports"
   },
-  requiresGenerator: '^0.4.24',
+  requiresGenerator: '^0.5.0',
 };

package/lib/eject-assets/generators/go/models.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "go" 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 go --update`.

package/lib/eject-assets/generators/go/naming.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "go" 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 go --update`.

package/lib/eject-assets/generators/go/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "go" 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 go --update`.
@@ -9,7 +9,9 @@ import {
   type ApiModel,
   type DateType,
   headerCoerceType,
+  isBinaryContentType,
   isMultipartBody,
+  isUntypedMultipartBody,
   jsonSuccessSchema,
   type OperationModel,
   type ParamModel,
@@ -97,6 +99,10 @@ export function writeGoMethod(
   const success = jsonSuccessSchema(op);
   const returnType = success === undefined ? undefined : goType(success, dateType);
   const headerPlan = envelope ? envelopeHeaderPlan(op, model!) : [];
+  // An untyped multipart or a binary body is `any`: the runtime sorts out what it got.
+  const passThrough =
+    isUntypedMultipartBody(op) ||
+    (op.requestBody !== undefined && isBinaryContentType(op.requestBody.contentType));
   if (envelope) {
     printer.line(
       `// ${ident}Headers carries the declared response headers of ${ident}WithHeaders (nil when absent or unparsable).`
@@ -113,7 +119,9 @@ export function writeGoMethod(
   const args = [
     'ctx context.Context',
     ...pathArgs.map(({ go, type }) => `${go} ${type}`),
-    ...(op.requestBody ? [`body ${goType(op.requestBody.schema, dateType)}`] : []),
+    ...(op.requestBody
+      ? [`body ${passThrough ? 'any' : goType(op.requestBody.schema, dateType)}`]
+      : []),
     ...(hasParams ? [`params *${ident}Params`] : []),
   ];
   const sse = sseResponse(op);
@@ -225,7 +233,31 @@ export function writeGoMethod(
         'Headers: authHeaders',
         'Query: query',
       ];
-      if (op.requestBody && isMultipartBody(op)) {
+      if (isUntypedMultipartBody(op)) {
+        printer.line('contentType, reader, stream, err := multipartBody(body)');
+        printer.block(
+          'if err != nil {',
+          () => {
+            printer.line(fail('err'));
+          },
+          '}'
+        );
+        specFields.push('Body: reader', 'Stream: stream', 'ContentType: contentType');
+      } else if (op.requestBody && passThrough) {
+        printer.line('reader, stream, err := binaryBody(body)');
+        printer.block(
+          'if err != nil {',
+          () => {
+            printer.line(fail('err'));
+          },
+          '}'
+        );
+        specFields.push(
+          'Body: reader',
+          'Stream: stream',
+          `ContentType: ${naming.string(op.requestBody.contentType)}`
+        );
+      } else if (op.requestBody && isMultipartBody(op)) {
         printer.line('contentType, reader, err := toMultipart(body)');
         printer.block(
           'if err != nil {',

package/lib/eject-assets/generators/go/pagination.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "go" 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 go --update`.

package/lib/eject-assets/generators/go/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "go" 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 go --update`.

package/lib/eject-assets/generators/mock/faker.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "mock" 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 mock --update`.

package/lib/eject-assets/generators/mock/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "mock" 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 mock --update`.
@@ -31,5 +31,5 @@ export default {
   name: 'mock',
   run: mockGenerator,
   requires: ["typescript"],
-  requiresGenerator: '^0.4.24',
+  requiresGenerator: '^0.5.0',
 };

package/lib/eject-assets/generators/mock/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "mock" 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 mock --update`.

package/lib/eject-assets/generators/mock/sample.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "mock" 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 mock --update`.

package/lib/eject-assets/generators/mock/values.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.5.0 — the built-in "mock" 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 mock --update`.

package/lib/eject-assets/generators/php/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.5.0 — 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`.

package/lib/eject-assets/generators/php/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.5.0 — 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`.

package/lib/eject-assets/generators/php/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.5.0 — 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`.
@@ -234,5 +234,5 @@ export default {
     "argsStyle": "inputs follow the target language's own idiom",
     "importExt": "the generated file has no relative imports"
   },
-  requiresGenerator: '^0.4.24',
+  requiresGenerator: '^0.5.0',
 };

package/lib/eject-assets/generators/php/models.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.5.0 — 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`.

package/lib/eject-assets/generators/php/naming.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.24 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.5.0 — 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`.