@redocly/cli 0.0.0-snapshot.1787132334 → 0.0.0-snapshot.1787213166

package/lib/chunks/3DFTNVIZ.js

@@ -0,0 +1,875 @@
+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{a as C,b as I,c as U}from"./VYAPZWZF.js";import{a as P}from"./WZXA5XPB.js";import{a as D,b as T,c as $,d as E,e as q,f as x,g as L,h as A,i as J,j as B,k as H,l as M}from"./L6CYFTBX.js";var j=`// Package client \u2014 the embedded runtime for generated Go SDKs. Hand-authored
+// once and stitched into every generated client (see
+// scripts/generate-runtime-sources.mjs), semantically in lockstep with the
+// TypeScript runtime: auth OR-alternatives, a retry loop with Retry-After and
+// full-jitter backoff, per-attempt timeouts, idempotency keys, and middleware
+// hooks. Standard library only \u2014 a generated Go SDK has zero dependencies.
+package client
+
+import (
+	"bytes"
+	"context"
+	"encoding/base64"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"io"
+	"math/rand"
+	"mime/multipart"
+	"net/http"
+	"net/url"
+	"strconv"
+	"strings"
+	"time"
+)
+
+// APIError is returned for a non-2xx response, carrying the decoded error body.
+type APIError struct {
+	URL        string
+	Status     int
+	StatusText string
+	Body       any
+}
+
+func (e *APIError) Error() string {
+	return fmt.Sprintf("request failed with status %d", e.Status)
+}
+
+// TimeoutError is returned when a request attempt exceeds the configured
+// timeout \u2014 carrying the context a log line needs.
+type TimeoutError struct {
+	OperationID string
+	Timeout     time.Duration
+	Attempt     int
+}
+
+func (e *TimeoutError) Error() string {
+	return fmt.Sprintf("request %q timed out after %s (attempt %d)", e.OperationID, e.Timeout, e.Attempt)
+}
+
+// SecuritySpec mirrors the descriptor table's security entries.
+type SecuritySpec struct {
+	Scheme string
+	Kind   string // "bearer" | "basic" | "apiKey"
+	Name   string // header/query/cookie name for apiKey
+	In     string // "header" | "query" | "cookie"
+}
+
+// Auth holds the client credentials; zero value = anonymous.
+type Auth struct {
+	Bearer func() string
+	Basic  *BasicAuth
+	APIKey map[string]func() string
+}
+
+type BasicAuth struct {
+	Username string
+	Password string
+}
+
+// RetryConfig mirrors the TypeScript runtime's retry policy knobs.
+type RetryConfig struct {
+	Retries       int
+	RetryDelay    time.Duration // base; default 1s
+	RetryStrategy string        // "" (exponential) | "fixed"
+	NoJitter      bool
+	// RetryOn fully replaces the default predicate when set.
+	RetryOn func(attempt int, resp *http.Response, err error) bool
+}
+
+// Middleware hooks run around every request (OnRequest before serialization order
+// is N/A in Go \u2014 bodies are values; OnResponse runs in reverse registration order).
+type Middleware struct {
+	OnRequest  func(req *http.Request)
+	OnResponse func(resp *http.Response)
+}
+
+// Date is an RFC 3339 full-date \u2014 a calendar date with no time component. Fields
+// typed \`date\` under \`dateType: Date\` use it because encoding/json speaks only
+// RFC 3339 date-time for time.Time, which a bare "2006-01-02" fails to satisfy.
+type Date struct {
+	time.Time
+}
+
+const dateLayout = "2006-01-02"
+
+// UnmarshalJSON parses a "2006-01-02" string; an empty string leaves the zero value.
+func (d *Date) UnmarshalJSON(data []byte) error {
+	var raw string
+	if err := json.Unmarshal(data, &raw); err != nil {
+		return err
+	}
+	if raw == "" {
+		return nil
+	}
+	parsed, err := time.Parse(dateLayout, raw)
+	if err != nil {
+		return err
+	}
+	d.Time = parsed
+	return nil
+}
+
+// MarshalJSON writes the date back without a time component.
+func (d Date) MarshalJSON() ([]byte, error) {
+	return json.Marshal(d.Format(dateLayout))
+}
+
+// Config is the per-client configuration shared by every operation method.
+type Config struct {
+	ServerURL      string
+	HTTPClient     *http.Client
+	Headers        map[string]string
+	Timeout        time.Duration
+	Retry          RetryConfig
+	Middleware     []Middleware
+	IdempotencyKey func() string
+	Auth           Auth
+}
+
+func resolveToken(provider func() string) string {
+	if provider == nil {
+		return ""
+	}
+	return provider()
+}
+
+func schemeConfigured(spec SecuritySpec, auth Auth) bool {
+	switch spec.Kind {
+	case "apiKey":
+		_, ok := auth.APIKey[spec.Scheme]
+		return ok
+	case "bearer":
+		return auth.Bearer != nil
+	default:
+		return auth.Basic != nil
+	}
+}
+
+// resolveAuth applies the first fully-configured OR-alternative; when none is,
+// the first alternative's configured schemes are still sent (the server rejects
+// the request \u2014 same behavior as the TypeScript runtime).
+func resolveAuth(security [][]SecuritySpec, auth Auth) (map[string]string, url.Values) {
+	headers := map[string]string{}
+	query := url.Values{}
+	if len(security) == 0 {
+		return headers, query
+	}
+	alternative := security[0]
+	for _, candidate := range security {
+		all := true
+		for _, spec := range candidate {
+			if !schemeConfigured(spec, auth) {
+				all = false
+				break
+			}
+		}
+		if all {
+			alternative = candidate
+			break
+		}
+	}
+	var cookies []string
+	for _, spec := range alternative {
+		switch spec.Kind {
+		case "apiKey":
+			provider, ok := auth.APIKey[spec.Scheme]
+			if !ok {
+				continue
+			}
+			value := resolveToken(provider)
+			switch spec.In {
+			case "query":
+				query.Set(spec.Name, value)
+			case "cookie":
+				cookies = append(cookies, spec.Name+"="+url.QueryEscape(value))
+			default:
+				headers[spec.Name] = value
+			}
+		case "bearer":
+			if auth.Bearer != nil {
+				headers["Authorization"] = "Bearer " + resolveToken(auth.Bearer)
+			}
+		default:
+			if auth.Basic != nil {
+				token := base64.StdEncoding.EncodeToString([]byte(auth.Basic.Username + ":" + auth.Basic.Password))
+				headers["Authorization"] = "Basic " + token
+			}
+		}
+	}
+	if len(cookies) > 0 {
+		headers["Cookie"] = strings.Join(cookies, "; ")
+	}
+	return headers, query
+}
+
+// buildURL substitutes {param} path placeholders with percent-encoded values.
+func buildURL(serverURL, path string, pathParams map[string]string) string {
+	filled := path
+	for name, value := range pathParams {
+		filled = strings.ReplaceAll(filled, "{"+name+"}", url.PathEscape(value))
+	}
+	return strings.TrimRight(serverURL, "/") + filled
+}
+
+var transientStatus = map[int]bool{408: true, 429: true, 500: true, 502: true, 503: true, 504: true}
+
+func defaultRetryOn(method string, headers map[string]string, resp *http.Response, err error) bool {
+	safe := false
+	switch strings.ToUpper(method) {
+	case "GET", "HEAD", "PUT", "DELETE", "OPTIONS":
+		safe = true
+	}
+	if _, ok := headers["Idempotency-Key"]; ok {
+		safe = true
+	}
+	if !safe {
+		return false
+	}
+	if err != nil {
+		return true
+	}
+	return resp != nil && transientStatus[resp.StatusCode]
+}
+
+func retryDelay(retry RetryConfig, attempt int, retryAfter string) time.Duration {
+	if retryAfter != "" {
+		if seconds, err := strconv.ParseFloat(retryAfter, 64); err == nil {
+			return time.Duration(seconds * float64(time.Second))
+		}
+	}
+	base := retry.RetryDelay
+	if base == 0 {
+		base = time.Second
+	}
+	raw := base
+	if retry.RetryStrategy != "fixed" {
+		raw = base * time.Duration(1<<(attempt-1))
+	}
+	if retry.NoJitter {
+		return raw
+	}
+	return time.Duration(rand.Int63n(int64(raw) + 1))
+}
+
+type requestSpec struct {
+	OperationID    string
+	Method         string
+	URL            string
+	Headers        map[string]string
+	Query          url.Values
+	Body           io.Reader
+	ContentType    string
+	Timeout        time.Duration
+	Retry          *RetryConfig
+	IdempotencyKey string
+	// bodyBytes is retained so retries can replay the body.
+	bodyBytes []byte
+}
+
+// send is the request core: header merge, idempotency keys, the retry loop
+// (fresh timeout budget per attempt), and the middleware onion.
+func send(ctx context.Context, config *Config, spec requestSpec) (*http.Response, error) {
+	retry := config.Retry
+	if spec.Retry != nil {
+		retry = *spec.Retry
+	}
+	timeout := config.Timeout
+	if spec.Timeout != 0 {
+		timeout = spec.Timeout
+	}
+	headers := map[string]string{}
+	for key, value := range config.Headers {
+		headers[key] = value
+	}
+	for key, value := range spec.Headers {
+		headers[key] = value
+	}
+	method := strings.ToUpper(spec.Method)
+	if (method == "POST" || method == "PATCH") && headers["Idempotency-Key"] == "" {
+		if spec.IdempotencyKey != "" {
+			headers["Idempotency-Key"] = spec.IdempotencyKey
+		} else if config.IdempotencyKey != nil {
+			headers["Idempotency-Key"] = config.IdempotencyKey()
+		}
+	}
+	httpClient := config.HTTPClient
+	if httpClient == nil {
+		httpClient = http.DefaultClient
+	}
+	if spec.Body != nil {
+		payload, err := io.ReadAll(spec.Body)
+		if err != nil {
+			return nil, err
+		}
+		spec.bodyBytes = payload
+	}
+	fullURL := spec.URL
+	if len(spec.Query) > 0 {
+		separator := "?"
+		if strings.Contains(fullURL, "?") {
+			separator = "&"
+		}
+		fullURL += separator + spec.Query.Encode()
+	}
+	maxAttempts := 1 + retry.Retries
+	for attempt := 1; ; attempt++ {
+		attemptCtx := ctx
+		var cancel context.CancelFunc
+		if timeout > 0 {
+			attemptCtx, cancel = context.WithTimeout(ctx, timeout)
+		}
+		var bodyReader io.Reader
+		if spec.bodyBytes != nil {
+			bodyReader = bytes.NewReader(spec.bodyBytes)
+		}
+		req, err := http.NewRequestWithContext(attemptCtx, method, fullURL, bodyReader)
+		if err != nil {
+			if cancel != nil {
+				cancel()
+			}
+			return nil, err
+		}
+		for key, value := range headers {
+			req.Header.Set(key, value)
+		}
+		if spec.ContentType != "" && spec.bodyBytes != nil {
+			req.Header.Set("Content-Type", spec.ContentType)
+		}
+		for _, mw := range config.Middleware {
+			if mw.OnRequest != nil {
+				mw.OnRequest(req)
+			}
+		}
+		resp, err := httpClient.Do(req)
+		shouldRetry := retry.RetryOn
+		retryable := false
+		if shouldRetry != nil {
+			retryable = shouldRetry(attempt, resp, err)
+		} else {
+			retryable = defaultRetryOn(method, headers, resp, err)
+		}
+		if err != nil {
+			if cancel != nil {
+				cancel()
+			}
+			timedOut := errors.Is(err, context.DeadlineExceeded) && ctx.Err() == nil
+			if attempt < maxAttempts && retryable {
+				time.Sleep(retryDelay(retry, attempt, ""))
+				continue
+			}
+			if timedOut {
+				return nil, &TimeoutError{OperationID: spec.OperationID, Timeout: timeout, Attempt: attempt}
+			}
+			return nil, err
+		}
+		for i := len(config.Middleware) - 1; i >= 0; i-- {
+			if config.Middleware[i].OnResponse != nil {
+				config.Middleware[i].OnResponse(resp)
+			}
+		}
+		if resp.StatusCode >= 400 && attempt < maxAttempts && retryable {
+			after := resp.Header.Get("Retry-After")
+			io.Copy(io.Discard, resp.Body)
+			resp.Body.Close()
+			if cancel != nil {
+				cancel()
+			}
+			time.Sleep(retryDelay(retry, attempt, after))
+			continue
+		}
+		// The response body outlives this call; tie the attempt context's lifetime to it.
+		if cancel != nil {
+			resp.Body = &cancelOnClose{ReadCloser: resp.Body, cancel: cancel}
+		}
+		return resp, nil
+	}
+}
+
+type cancelOnClose struct {
+	io.ReadCloser
+	cancel context.CancelFunc
+}
+
+func (c *cancelOnClose) Close() error {
+	c.cancel()
+	return c.ReadCloser.Close()
+}
+
+// decodeJSON decodes a response body into target; a nil target drains and closes.
+func decodeJSON(resp *http.Response, target any) error {
+	defer resp.Body.Close()
+	if target == nil {
+		_, err := io.Copy(io.Discard, resp.Body)
+		return err
+	}
+	return json.NewDecoder(resp.Body).Decode(target)
+}
+
+// headerString returns the named response header, or nil when absent.
+func headerString(header http.Header, name string) *string {
+	value := header.Get(name)
+	if value == "" {
+		return nil
+	}
+	return &value
+}
+
+// headerInt64 parses the named header as an integer; nil when absent or unparsable.
+func headerInt64(header http.Header, name string) *int64 {
+	raw := strings.TrimSpace(header.Get(name))
+	if raw == "" {
+		return nil
+	}
+	value, err := strconv.ParseInt(raw, 10, 64)
+	if err != nil {
+		return nil
+	}
+	return &value
+}
+
+// headerFloat64 parses the named header as a number; nil when absent or unparsable.
+func headerFloat64(header http.Header, name string) *float64 {
+	raw := strings.TrimSpace(header.Get(name))
+	if raw == "" {
+		return nil
+	}
+	value, err := strconv.ParseFloat(raw, 64)
+	if err != nil {
+		return nil
+	}
+	return &value
+}
+
+// headerBool parses a \`true\`/\`false\` header; nil when absent or anything else.
+func headerBool(header http.Header, name string) *bool {
+	raw := strings.ToLower(strings.TrimSpace(header.Get(name)))
+	if raw != "true" && raw != "false" {
+		return nil
+	}
+	value := raw == "true"
+	return &value
+}
+
+// apiErrorFrom builds the structured error for a non-2xx response.
+func apiErrorFrom(resp *http.Response, requestURL string) error {
+	defer resp.Body.Close()
+	var body any
+	data, _ := io.ReadAll(resp.Body)
+	if len(data) > 0 {
+		if err := json.Unmarshal(data, &body); err != nil {
+			body = string(data)
+		}
+	}
+	return &APIError{URL: requestURL, Status: resp.StatusCode, StatusText: resp.Status, Body: body}
+}
+
+// \u2500\u2500\u2500 Pagination \u2500\u2500\u2500
+
+// PaginationSpec mirrors the descriptor table's pagination entries.
+type PaginationSpec struct {
+	Style      string
+	Param      string
+	NextCursor string
+	HasMore    string
+	LimitParam string
+	Items      string
+}
+
+// resolvePointer walks an RFC 6901 JSON pointer over decoded JSON; nil on any miss.
+func resolvePointer(data any, pointer string) any {
+	if pointer == "" {
+		return data
+	}
+	if !strings.HasPrefix(pointer, "/") {
+		return nil
+	}
+	current := data
+	for _, token := range strings.Split(pointer[1:], "/") {
+		key := strings.ReplaceAll(strings.ReplaceAll(token, "~1", "/"), "~0", "~")
+		switch typed := current.(type) {
+		case map[string]any:
+			current = typed[key]
+		case []any:
+			index, err := strconv.Atoi(key)
+			if err != nil || index < 0 || index >= len(typed) {
+				return nil
+			}
+			current = typed[index]
+		default:
+			return nil
+		}
+		if current == nil {
+			return nil
+		}
+	}
+	return current
+}
+
+// reencode converts decoded JSON (maps/slices) into a typed value via a JSON round-trip.
+func reencode(raw any, target any) error {
+	data, err := json.Marshal(raw)
+	if err != nil {
+		return err
+	}
+	return json.Unmarshal(data, target)
+}
+
+type pageCall func(params url.Values) (any, *http.Response, error)
+
+// iterPages yields raw page JSON per the pagination spec \u2014 the same stop
+// conditions and infinite-loop guards as the TypeScript runtime. The returned
+// function is a range-over-func iterator (Go 1.23+) and plainly callable before that.
+func iterPages(call pageCall, spec PaginationSpec, base url.Values) func(yield func(any, error) bool) {
+	return func(yield func(any, error) bool) {
+		switch spec.Style {
+		case "cursor":
+			var cursor any
+			if values, ok := base[spec.Param]; ok && len(values) > 0 {
+				cursor = values[0]
+			}
+			for {
+				params := cloneValues(base)
+				if cursor != nil {
+					params.Set(spec.Param, fmt.Sprint(cursor))
+				}
+				page, _, err := call(params)
+				if err != nil {
+					yield(nil, err)
+					return
+				}
+				if !yield(page, nil) {
+					return
+				}
+				if spec.HasMore != "" {
+					if more, ok := resolvePointer(page, spec.HasMore).(bool); ok && !more {
+						return
+					}
+				}
+				next := resolvePointer(page, spec.NextCursor)
+				if next == nil || next == "" {
+					return
+				}
+				switch next.(type) {
+				case string, float64:
+				default:
+					yield(nil, fmt.Errorf("pagination cursor at %s is not a string or number", spec.NextCursor))
+					return
+				}
+				if cursor != nil && fmt.Sprint(next) == fmt.Sprint(cursor) {
+					yield(nil, errors.New("pagination did not advance: the operation returned the same cursor twice"))
+					return
+				}
+				cursor = next
+			}
+		case "link":
+			params := cloneValues(base)
+			previous := ""
+			for {
+				page, resp, err := call(params)
+				if err != nil {
+					yield(nil, err)
+					return
+				}
+				if !yield(page, nil) {
+					return
+				}
+				target := linkNext(resp.Header.Get("Link"))
+				if target == "" {
+					return
+				}
+				pageURL := ""
+				if resp.Request != nil && resp.Request.URL != nil {
+					pageURL = resp.Request.URL.String()
+				}
+				baseURL, err := url.Parse(pageURL)
+				if err != nil || pageURL == "" {
+					baseURL, _ = url.Parse("http://relative.invalid")
+				}
+				targetURL, err := baseURL.Parse(target)
+				if err != nil {
+					yield(nil, err)
+					return
+				}
+				next := targetURL.String()
+				if next == previous || next == pageURL {
+					yield(nil, errors.New(\`pagination did not advance: the Link rel="next" target repeats\`))
+					return
+				}
+				previous = next
+				params = cloneValues(base)
+				for key, values := range targetURL.Query() {
+					for _, value := range values {
+						params.Add(key, value)
+					}
+				}
+			}
+		default: // offset / page
+			position := 0
+			if spec.Style == "page" {
+				position = 1
+			}
+			if values, ok := base[spec.Param]; ok && len(values) > 0 && values[0] != "" {
+				if parsed, err := strconv.Atoi(values[0]); err == nil {
+					position = parsed
+				}
+			}
+			previousItems := ""
+			for {
+				params := cloneValues(base)
+				params.Set(spec.Param, strconv.Itoa(position))
+				page, _, err := call(params)
+				if err != nil {
+					yield(nil, err)
+					return
+				}
+				items, _ := resolvePointer(page, spec.Items).([]any)
+				serialized := ""
+				if items != nil {
+					serialized = fmt.Sprint(items)
+					if serialized == previousItems {
+						yield(nil, errors.New("pagination did not advance: the operation returned the same page twice"))
+						return
+					}
+				}
+				if !yield(page, nil) {
+					return
+				}
+				if len(items) == 0 {
+					return
+				}
+				previousItems = serialized
+				if spec.Style == "page" {
+					position++
+				} else {
+					position += len(items)
+				}
+			}
+		}
+	}
+}
+
+func cloneValues(values url.Values) url.Values {
+	out := url.Values{}
+	for key, entries := range values {
+		for _, entry := range entries {
+			out.Add(key, entry)
+		}
+	}
+	return out
+}
+
+func linkNext(header string) string {
+	if header == "" {
+		return ""
+	}
+	for _, entry := range strings.Split(header, ",") {
+		parts := strings.Split(entry, ";")
+		if len(parts) < 2 {
+			continue
+		}
+		target := strings.TrimSpace(parts[0])
+		if !strings.HasPrefix(target, "<") || !strings.HasSuffix(target, ">") {
+			continue
+		}
+		for _, param := range parts[1:] {
+			trimmed := strings.TrimSpace(param)
+			if strings.HasPrefix(trimmed, "rel=") {
+				rel := strings.Trim(strings.TrimPrefix(trimmed, "rel="), \`"\`)
+				for _, kind := range strings.Fields(rel) {
+					if kind == "next" {
+						return strings.Trim(target, "<>")
+					}
+				}
+			}
+		}
+	}
+	return ""
+}
+
+// \u2500\u2500\u2500 Server-Sent Events \u2500\u2500\u2500
+
+// ServerSentEvent is one decoded event; Data is the raw text (or parsed JSON
+// for operations that declare a JSON event stream).
+type ServerSentEvent struct {
+	Event string
+	Data  any
+	ID    string
+	Retry int
+}
+
+func parseSSEFrame(raw string, jsonData bool) (ServerSentEvent, bool, error) {
+	event := ServerSentEvent{Retry: -1}
+	sawField := false
+	var dataLines []string
+	normalized := strings.ReplaceAll(strings.ReplaceAll(raw, "\\r\\n", "\\n"), "\\r", "\\n")
+	for _, line := range strings.Split(normalized, "\\n") {
+		if line == "" || strings.HasPrefix(line, ":") {
+			continue
+		}
+		field, value, _ := strings.Cut(line, ":")
+		value = strings.TrimPrefix(value, " ")
+		sawField = true
+		switch field {
+		case "event":
+			event.Event = value
+		case "data":
+			dataLines = append(dataLines, value)
+		case "id":
+			event.ID = value
+		case "retry":
+			if parsed, err := strconv.Atoi(value); err == nil && parsed >= 0 && value != "" {
+				event.Retry = parsed
+			}
+		}
+	}
+	if !sawField {
+		return event, false, nil
+	}
+	text := strings.Join(dataLines, "\\n")
+	event.Data = text
+	if jsonData && text != "" {
+		var parsed any
+		if err := json.Unmarshal([]byte(text), &parsed); err != nil {
+			return event, false, err
+		}
+		event.Data = parsed
+	}
+	return event, true, nil
+}
+
+// iterSSE streams events, reconnecting on dropped connections with Last-Event-ID
+// (a fresh open call = fresh auth); a 4xx/5xx or a bad JSON payload is definitive.
+func iterSSE(open func(extraHeaders map[string]string) (*http.Response, error), jsonData bool) func(yield func(ServerSentEvent, error) bool) {
+	return func(yield func(ServerSentEvent, error) bool) {
+		lastEventID := ""
+		serverRetry := -1
+		failures := 0
+		for {
+			headers := map[string]string{"Accept": "text/event-stream"}
+			if lastEventID != "" {
+				headers["Last-Event-ID"] = lastEventID
+			}
+			resp, err := open(headers)
+			if err == nil && resp.StatusCode >= 400 {
+				yield(ServerSentEvent{}, apiErrorFrom(resp, ""))
+				return
+			}
+			if err == nil {
+				failures = 0
+				buffer := ""
+				chunk := make([]byte, 4096)
+				clean := false
+				for {
+					n, readErr := resp.Body.Read(chunk)
+					buffer += string(chunk[:n])
+					for {
+						frame, rest, found := strings.Cut(buffer, "\\n\\n")
+						if !found {
+							break
+						}
+						buffer = rest
+						event, ok, parseErr := parseSSEFrame(frame, jsonData)
+						if parseErr != nil {
+							resp.Body.Close()
+							yield(ServerSentEvent{}, parseErr)
+							return
+						}
+						if ok {
+							if event.ID != "" {
+								lastEventID = event.ID
+							}
+							if event.Retry >= 0 {
+								serverRetry = event.Retry
+							}
+							if !yield(event, nil) {
+								resp.Body.Close()
+								return
+							}
+						}
+					}
+					if readErr == io.EOF {
+						clean = true
+						break
+					}
+					if readErr != nil {
+						break
+					}
+				}
+				resp.Body.Close()
+				if clean {
+					if strings.TrimSpace(buffer) != "" {
+						if event, ok, parseErr := parseSSEFrame(buffer, jsonData); parseErr == nil && ok {
+							yield(event, nil)
+						}
+					}
+					return
+				}
+			}
+			failures++
+			base := time.Second
+			if serverRetry >= 0 {
+				base = time.Duration(serverRetry) * time.Millisecond
+			}
+			delay := base * time.Duration(1<<(failures-1))
+			if delay > 30*time.Second {
+				delay = 30 * time.Second
+			}
+			time.Sleep(time.Duration(rand.Int63n(int64(delay) + 1)))
+		}
+	}
+}
+
+// \u2500\u2500\u2500 Multipart \u2500\u2500\u2500
+
+// toMultipart splits a typed body into a multipart/form-data payload: []byte
+// values upload as file parts, everything else as form fields (nested values
+// JSON-encoded) \u2014 mirroring the TypeScript runtime's FormData serialization.
+func toMultipart(body any) (string, io.Reader, error) {
+	var wire map[string]any
+	if err := reencode(body, &wire); err != nil {
+		return "", nil, err
+	}
+	buffer := &bytes.Buffer{}
+	writer := multipart.NewWriter(buffer)
+	for key, value := range wire {
+		switch typed := value.(type) {
+		case string:
+			if err := writer.WriteField(key, typed); err != nil {
+				return "", nil, err
+			}
+		case float64, bool:
+			if err := writer.WriteField(key, fmt.Sprint(typed)); err != nil {
+				return "", nil, err
+			}
+		default:
+			encoded, err := json.Marshal(typed)
+			if err != nil {
+				return "", nil, err
+			}
+			if err := writer.WriteField(key, string(encoded)); err != nil {
+				return "", nil, err
+			}
+		}
+	}
+	if err := writer.Close(); err != nil {
+		return "", nil, err
+	}
+	return writer.FormDataContentType(), buffer, nil
+}
+`;var S=T.go;function Z(t){if(t===void 0)return"client";if(!/^[a-z_][a-z0-9_]*$/.test(t)||S.has(t))throw new P(`goPackage "${t}" is not a valid Go package name: use lowercase letters, digits, and underscores, don't start with a digit, and avoid Go keywords.`);return t}function p(t){let r=$(t,{style:"pascal",reserved:S});return r.startsWith("_")?`N${r.slice(1)}`:r}function h(t,r="string"){if(L(t)){let e=h(A(t),r);return e.startsWith("*")||e==="any"?e:`*${e}`}switch(t.kind){case"scalar":if(r==="Date"&&t.scalar==="string"){if(t.metadata?.format==="date-time")return"time.Time";if(t.metadata?.format==="date")return"Date"}return{string:"string",integer:"int64",number:"float64",boolean:"bool"}[t.scalar];case"array":return`[]${h(t.items,r)}`;case"record":return`map[string]${h(t.value,r)}`;case"ref":return p(t.name);case"literal":return typeof t.value=="string"?"string":typeof t.value=="boolean"?"bool":"float64";case"enum":return{string:"string",integer:"int64",number:"float64",boolean:"bool"}[t.scalar];case"omit":return p(t.base);case"union":case"null":case"object":case"intersection":case"unknown":return"any"}}function R(t,r,e){let n=B(e);if(n.length===0)return;t.line(`// ${r} \u2014 ${n[0]}`);let a=!1;for(let i of n.slice(1)){if(i===""){a||t.line("//"),a=!0;continue}t.line(`// ${i}`),a=!1}}function Y(t,r,e,n,a){R(t,p(r),a),t.block(`type ${p(r)} struct {`,()=>{for(let i of e){let l=p(i.name),s=h(i.schema,n),c=`\`json:"${i.name}"\``;i.required||(!s.startsWith("*")&&!s.startsWith("[]")&&!s.startsWith("map[")&&s!=="any"&&(s=`*${s}`),c=`\`json:"${i.name},omitempty"\``),t.line(`${l} ${s} ${c}`)}},"}"),t.blank()}function K(t){return`${t.replace(/\n{3,}/g,`
+
+`).trimEnd()}
+`}function X(t,r="string"){let e=new C("	");e.line("package client"),e.blank(),t.schemas.some(({schema:i})=>x(i,t)!==void 0)&&(e.line('import "encoding/json"'),e.blank());let a=tt(t,r);return r==="Date"&&a.includes("time.Time")&&(e.line('import "time"'),e.blank()),e.line(a),K(W(e.toString()))}function tt(t,r){let e=new C("	");for(let{name:n,schema:a}of t.schemas){let i=J(a);if(i!==void 0){let s=i.scalar==="string"?"string":"int64";R(e,p(n),a.description),e.line(`type ${p(n)} ${s}`),e.blank(),e.block("const (",()=>{i.values.forEach(c=>{let o=p(n)+D.pascal(String(c));e.line(`${o} ${p(n)} = ${JSON.stringify(c)}`)})},")"),e.blank();continue}if(a.kind==="object"||a.kind==="intersection"){let s=q(a,t);if(s!==void 0){Y(e,n,s.properties,r,s.description??a.description);continue}}let l=x(a,t);if(l!==void 0){let s=p(n),c=l.cases.map(o=>`${o.value} -> ${p(o.schemaName)}`).join(", ");e.line(`// ${s} is a discriminated union ("${l.property}"): ${c}.`),e.line(`type ${s} = any`),e.blank(),e.line(`// Unmarshal${s} decodes into the member selected by "${l.property}".`),e.block(`func Unmarshal${s}(data []byte) (${s}, error) {`,()=>{e.block("var probe struct {",()=>{e.line(`Discriminant string \`json:"${l.property}"\``)},"}"),e.block("if err := json.Unmarshal(data, &probe); err != nil {",()=>{e.line("return nil, err")},"}"),e.line("switch probe.Discriminant {");for(let o of l.cases)e.block(`case ${JSON.stringify(o.value)}:`,()=>{e.line(`var value ${p(o.schemaName)}`),e.line("err := json.Unmarshal(data, &value)"),e.line("return value, err")});e.line("}"),e.line("var fallback any"),e.line("err := json.Unmarshal(data, &fallback)"),e.line("return fallback, err")},"}"),e.blank();continue}R(e,p(n),a.description),e.line(`type ${p(n)} = ${h(a,r)}`),e.blank()}return e.toString()}function G(t){return t.successResponses.find(r=>r.contentType.toLowerCase().includes("json"))?.schema}function et(t,r){let e=t.security.map(n=>n.flatMap(a=>{let i=r.securitySchemes.find(c=>c.key===a);if(i===void 0)return[];if(i.kind==="bearer"||i.kind==="basic")return[`{Scheme: ${JSON.stringify(a)}, Kind: ${JSON.stringify(i.kind)}}`];let l=i.kind==="apiKeyHeader"?i.headerName:i.kind==="apiKeyQuery"?i.paramName:i.cookieName,s=i.kind==="apiKeyHeader"?"header":i.kind==="apiKeyQuery"?"query":"cookie";return[`{Scheme: ${JSON.stringify(a)}, Kind: "apiKey", Name: ${JSON.stringify(l)}, In: ${JSON.stringify(s)}}`]})).filter(n=>n.length>0);if(e.length!==0)return`[][]SecuritySpec{${e.map(n=>`{${n.join(", ")}}`).join(", ")}}`}function N(t){let r=new Set,e=[];for(let n of t.services)for(let a of n.operations){let i=p(a.name),l=2;for(;r.has(i);)i=`${p(a.name)}${l++}`;r.add(i),e.push({op:a,ident:i})}return e}function O(t,r){if(r==="string")return t;let e=t.startsWith("*")?`(${t})`:t;return r==="time.Time"?`${e}.Format(time.RFC3339)`:r==="Date"?`${e}.Format("2006-01-02")`:r==="int64"?`strconv.FormatInt(${t}, 10)`:r==="float64"?`strconv.FormatFloat(${t}, 'f', -1, 64)`:r==="bool"?`strconv.FormatBool(${t})`:`fmt.Sprint(${t})`}function W(t){let r=t.split(`
+`),e=[...r],n=/^(\t+)([A-Za-z_]\w*) (\S+)( `[^`]*`)?$/,a=/^(\t+)([A-Za-z_]\w*) (\S+) = (.+)$/,i=/^(\t+)("(?:[^"\\]|\\.)*":) (.+)$/,l=o=>{if(o.length<2)return;let u=[];for(let{parts:d}of o)d.forEach((f,m)=>{m<d.length-1&&(u[m]=Math.max(u[m]??0,f.length))});for(let{index:d,parts:f,indent:m}of o){let g=f.map((b,y)=>y<f.length-1?b.padEnd(u[y]??0):b);e[d]=m+g.join(" ").trimEnd()}},s=[],c;return r.forEach((o,u)=>{let d=i.exec(o),f=d===null?a.exec(o):null,m=d===null&&f===null?n.exec(o):null,g=m!==null&&!S.has(m[2])?m:null,b=d!==null?"entry":f!==null?"const":g!==null?"field":void 0;if((b===void 0||b!==c)&&(l(s),s=[],c=b),d!==null){s.push({index:u,indent:d[1],parts:[d[2],d[3]]});return}if(f!==null){s.push({index:u,indent:f[1],parts:[f[2],f[3],"=",f[4]]});return}if(g!==null){let y=[g[2],g[3]];g[4]!==void 0&&y.push(g[4].trimStart()),s.push({index:u,indent:g[1],parts:y})}}),l(s),e.join(`
+`)}function F(t){let r=t.split(`
+`),e=[],n=!1;for(let a of r)if(!a.startsWith("package ")){if(a.startsWith("import (")){n=!0;continue}if(n){a.startsWith(")")&&(n=!1);continue}a.startsWith("import ")||e.push(a)}return e.join(`
+`).trim()}function z(t){return t.successResponses.find(r=>r.contentType.toLowerCase().includes("text/event-stream"))}function nt(t){return t.requestBody?.contentType.toLowerCase().includes("multipart")??!1}function rt(t){return`&PaginationSpec{${[`Style: ${JSON.stringify(t.style)}`,...t.param!==void 0?[`Param: ${JSON.stringify(t.param)}`]:[],...t.nextCursor!==void 0?[`NextCursor: ${JSON.stringify(t.nextCursor)}`]:[],...t.hasMore!==void 0?[`HasMore: ${JSON.stringify(t.hasMore)}`]:[],...t.limitParam!==void 0?[`LimitParam: ${JSON.stringify(t.limitParam)}`]:[],...t.items!==void 0?[`Items: ${JSON.stringify(t.items)}`]:[]].join(", ")}}`}var at=["c","ctx","body","params","out","op"];function V(t,r){let e=E(t.pathParams.map(n=>n.name),{style:"camel",reserved:S,taken:at});return t.pathParams.map((n,a)=>({param:n,go:e[a],type:h(n.schema,r)}))}function it(t,r){let e=new Set;return(t.successResponseHeaders??[]).map(n=>{let a=p(n.name),i=a,l=2;for(;e.has(i);)i=`${a}${l++}`;e.add(i);let s=M(n.schema,r),c={integer:{goType:"*int64",helper:"headerInt64"},number:{goType:"*float64",helper:"headerFloat64"},boolean:{goType:"*bool",helper:"headerBool"},string:{goType:"*string",helper:"headerString"}}[s];return{field:i,name:n.name,...c}})}function _(t,r,e,n,a,i=!1){let l=V(r,n),s=r.queryParams.length>0,c=G(r),o=c===void 0?void 0:h(c,n),u=i?it(r,a):[];i&&(t.line(`// ${e}Headers carries the declared response headers of ${e}WithHeaders (nil when absent or unparsable).`),t.block(`type ${e}Headers struct {`,()=>{for(let y of u)t.line(`${y.field} ${y.goType}`)},"}"),t.blank());let d=["ctx context.Context",...l.map(({go:y,type:k})=>`${y} ${k}`),...r.requestBody?[`body ${h(r.requestBody.schema,n)}`]:[],...s?[`params *${e}Params`]:[]],f=z(r),m=i?o===void 0?`(${e}Headers, error)`:`(${o}, ${e}Headers, error)`:f!==void 0?"func(yield func(ServerSentEvent, error) bool)":o===void 0?"error":`(${o}, error)`,g=y=>i?o===void 0?`return headers, ${y}`:`return out, headers, ${y}`:o===void 0?`return ${y}`:`return out, ${y}`,b=i?`${e}WithHeaders`:e;R(t,b,i?`Like ${e}, also returning the declared response headers.`:r.summary),t.block(`func (c *Client) ${b}(${d.join(", ")}) ${m} {`,()=>{f===void 0&&o!==void 0&&t.line(`var out ${o}`),i&&t.line(`var headers ${e}Headers`),t.line(`op := operations[${JSON.stringify(r.specName??r.name)}]`),t.line("authHeaders, query := resolveAuth(op.Security, c.config.Auth)"),s&&t.block("if params != nil {",()=>{for(let v of r.queryParams){let w=p(v.name);t.block(`if params.${w} != nil {`,()=>{t.line(`query.Set(${JSON.stringify(v.name)}, ${O(`*params.${w}`,h(v.schema,n))})`)},"}")}},"}");let y=l.map(({param:v,go:w,type:Q})=>`${JSON.stringify(v.name)}: ${O(w,Q)}`).join(", ");if(t.line(`requestURL := buildURL(c.config.ServerURL, op.Path, map[string]string{${y}})`),f!==void 0){t.block("open := func(extraHeaders map[string]string) (*http.Response, error) {",()=>{t.line("merged := map[string]string{}"),t.block("for key, value := range authHeaders {",()=>{t.line("merged[key] = value")},"}"),t.block("for key, value := range extraHeaders {",()=>{t.line("merged[key] = value")},"}"),t.line("return send(ctx, &c.config, requestSpec{OperationID: op.ID, Method: op.Method, URL: requestURL, Headers: merged, Query: query})")},"}"),t.line(`return iterSSE(open, ${f.schema!==void 0&&f.schema.kind!=="unknown"})`);return}let k=["OperationID: op.ID","Method: op.Method","URL: requestURL","Headers: authHeaders","Query: query"];if(r.requestBody&&nt(r)?(t.line("contentType, reader, err := toMultipart(body)"),t.block("if err != nil {",()=>{t.line(g("err"))},"}"),k.push("Body: reader"),k.push("ContentType: contentType")):r.requestBody&&(t.line("payload, err := json.Marshal(body)"),t.block("if err != nil {",()=>{t.line(g("err"))},"}"),k.push("Body: bytes.NewReader(payload)"),k.push(`ContentType: ${JSON.stringify(r.requestBody.contentType)}`)),t.line(`resp, err := send(ctx, &c.config, requestSpec{${k.join(", ")}})`),t.block("if err != nil {",()=>{t.line(g("err"))},"}"),t.block("if resp.StatusCode >= 400 {",()=>{t.line(g("apiErrorFrom(resp, requestURL)"))},"}"),i){t.block(`if err := decodeJSON(resp, ${o===void 0?"nil":"&out"}); err != nil {`,()=>{t.line(g("err"))},"}");for(let v of u)t.line(`headers.${v.field} = ${v.helper}(resp.Header, ${JSON.stringify(v.name)})`);t.line(o===void 0?"return headers, nil":"return out, headers, nil")}else o===void 0?t.line("return decodeJSON(resp, nil)"):(t.block("if err := decodeJSON(resp, &out); err != nil {",()=>{t.line("return out, err")},"}"),t.line("return out, nil"))},"}"),t.blank()}function st(t,r,e,n,a,i){let l=V(r,n),s=r.queryParams.length>0,c=["ctx context.Context",...l.map(({go:u,type:d})=>`${u} ${d}`),...s?[`params *${e}Params`]:[]].join(", "),o=()=>{t.line(`op := operations[${JSON.stringify(r.specName??r.name)}]`),t.line("base := url.Values{}"),s&&t.block("if params != nil {",()=>{for(let u of r.queryParams){let d=p(u.name);t.block(`if params.${d} != nil {`,()=>{t.line(`base.Set(${JSON.stringify(u.name)}, ${O(`*params.${d}`,h(u.schema,n))})`)},"}")}},"}"),t.block("call := func(pageParams url.Values) (any, *http.Response, error) {",()=>{t.line("authHeaders, query := resolveAuth(op.Security, c.config.Auth)"),t.block("for key, values := range pageParams {",()=>{t.block("for _, value := range values {",()=>{t.line("query.Set(key, value)")},"}")},"}");let u=l.map(({param:d,go:f,type:m})=>`${JSON.stringify(d.name)}: ${O(f,m)}`).join(", ");t.line(`requestURL := buildURL(c.config.ServerURL, op.Path, map[string]string{${u}})`),t.line("resp, err := send(ctx, &c.config, requestSpec{OperationID: op.ID, Method: op.Method, URL: requestURL, Headers: authHeaders, Query: query})"),t.block("if err != nil {",()=>{t.line("return nil, nil, err")},"}"),t.block("if resp.StatusCode >= 400 {",()=>{t.line("return nil, resp, apiErrorFrom(resp, requestURL)")},"}"),t.line("var raw any"),t.block("if err := decodeJSON(resp, &raw); err != nil {",()=>{t.line("return nil, resp, err")},"}"),t.line("return raw, resp, nil")},"}"),t.line("pages := iterPages(call, *op.Pagination, base)")};t.line(`// ${e}Pages iterates ${e} response pages; use with \`for page, err := range\`.`),t.block(`func (c *Client) ${e}Pages(${c}) func(yield func(${a}, error) bool) {`,()=>{o(),t.block(`return func(yield func(${a}, error) bool) {`,()=>{t.block("pages(func(raw any, err error) bool {",()=>{t.line(`var page ${a}`),t.block("if err == nil {",()=>{t.line("err = reencode(raw, &page)")},"}"),t.line("return yield(page, err)")},"})")},"}")},"}"),t.blank(),t.line(`// ${e}Items iterates the items of every ${e} page.`),t.block(`func (c *Client) ${e}Items(${c}) func(yield func(${i}, error) bool) {`,()=>{o(),t.block(`return func(yield func(${i}, error) bool) {`,()=>{t.block("pages(func(raw any, err error) bool {",()=>{t.block("if err != nil {",()=>{t.line(`var zero ${i}`),t.line("return yield(zero, err)")},"}"),t.line("pageItems, _ := resolvePointer(raw, op.Pagination.Items).([]any)"),t.block("for _, item := range pageItems {",()=>{t.line(`var typed ${i}`),t.block("if err := reencode(item, &typed); err != nil {",()=>{t.line("return yield(typed, err)")},"}"),t.block("if !yield(typed, nil) {",()=>{t.line("return false")},"}")},"}"),t.line("return true")},"})")},"}")},"}"),t.blank()}function ot(t){let r=new Set(t.variables.map(l=>l.name)),e=[],n="",a=t.url,i=/\{([^{}]+)\}/;for(let l=i.exec(a);l!==null;l=i.exec(a))n+=a.slice(0,l.index),r.has(l[1])?(n!==""&&e.push(JSON.stringify(n)),n="",e.push($(l[1],{style:"camel",reserved:S}))):n+=l[0],a=a.slice(l.index+l[0].length);return n+=a,(n!==""||e.length===0)&&e.push(JSON.stringify(n)),e.join(" + ")}function lt(t,r){let e=r.servers??[];if(e.length===0)return;let n=new Set;e.forEach((a,i)=>{let l=`${p(a.description??`server${i+1}`)}URL`;n.has(l)&&(l=`${l}${i+1}`),n.add(l);let s=a.variables.map(o=>`${$(o.name,{style:"camel",reserved:S})} string`),c=a.variables.map(o=>`${$(o.name,{style:"camel",reserved:S})} default: ${JSON.stringify(o.default)}`).join(", ");t.line(`// ${l} returns the ${JSON.stringify(a.description??a.url)} base URL${c===""?".":` (${c}).`}`),t.block(`func ${l}(${s.join(", ")}) string {`,()=>{t.line(`return ${ot(a)}`)},"}"),t.blank()})}var pt=({model:t,outputPath:r,emit:e})=>{let n=new C("	"),a=e.dateType??"string",i=Z(e.goPackage),l=new Map;for(let{op:s,ident:c}of N(t)){let o=I(s,e.pagination);o!==void 0&&l.set(c,o)}n.line(`// Code generated by @redocly/client-generator (go) from "${t.title}" ${t.version}. DO NOT EDIT.`),n.line("// Regenerate with `redocly generate-client`. Standard library only \u2014 zero dependencies."),n.line(`package ${i}`),n.blank(),n.block("import (",()=>{for(let s of["bytes","context","encoding/base64","encoding/json","errors","fmt","io","math/rand","mime/multipart","net/http","net/url","strconv","strings","time"])n.line(JSON.stringify(s))},")"),n.blank(),n.line(F(X(t,a))),n.blank(),lt(n,t),n.line("// \u2500\u2500\u2500 Embedded runtime (@redocly/client-generator go runtime) \u2500\u2500\u2500"),n.line(F(j)),n.blank(),n.block("type operationMeta struct {",()=>{n.line("ID         string"),n.line("Method     string"),n.line("Path       string"),n.line("Security   [][]SecuritySpec"),n.line("Pagination *PaginationSpec")},"}"),n.blank(),n.block("var operations = map[string]operationMeta{",()=>{for(let{op:s,ident:c}of N(t)){let o=s.specName??s.name,u=et(s,t),d=l.get(c),f=[`ID: ${JSON.stringify(o)}`,`Method: ${JSON.stringify(s.method.toUpperCase())}`,`Path: ${JSON.stringify(s.path)}`,...u!==void 0?[`Security: ${u}`]:[],...d!==void 0?[`Pagination: ${rt(d)}`]:[]];n.line(`${JSON.stringify(o)}: {${f.join(", ")}},`)}},"}"),n.blank();for(let{op:s,ident:c}of N(t))s.queryParams.length!==0&&(n.block(`type ${c}Params struct {`,()=>{for(let o of s.queryParams){let u=h(o.schema,a);n.line(`${p(o.name)} ${u.startsWith("*")?u:`*${u}`}`)}},"}"),n.blank());R(n,"Client",`Client for ${t.title} (${t.version}).`),n.block("type Client struct {",()=>{n.line("config Config")},"}"),n.blank(),n.block("func New(config Config) *Client {",()=>{n.block('if config.ServerURL == "" {',()=>{n.line(`config.ServerURL = ${JSON.stringify(e.serverUrl??t.serverUrl??"")}`)},"}"),n.line("return &Client{config: config}")},"}"),n.blank();for(let{op:s,ident:c}of N(t)){_(n,s,c,a),z(s)===void 0&&(s.successResponseHeaders?.length??0)>0&&_(n,s,c,a,t,!0);let o=l.get(c);if(o===void 0)continue;let u=G(s),d=u===void 0?"any":h(u,a),f=u!==void 0&&o.items!==void 0?H(u,o.items,t):void 0,m=f?.kind==="array"?f.items:void 0;st(n,s,c,a,d,m===void 0?"any":h(m,a))}return[{path:r.replace(/\.[^.\\/]+$/,".go"),content:K(W(n.toString()))}]};function ct(t,r){let e=r.emit.dateType??"string",n=r.emit.goPackage??"client",a=p(t.name),i=["ctx",...t.pathParams.map(l=>`"<${$(l.name,{style:"camel",reserved:S})}>"`),...t.requestBody?[`${h(t.requestBody.schema,e)}{ /* \u2026 */ }`]:[],...t.queryParams.length>0?["nil"]:[]];return{lang:"go",label:"Go SDK",source:`client := ${n}.New(${n}.Config{})
+result, err := client.${a}(${i.join(", ")})
+`}}var yt=({model:t,outputPath:r,emit:e})=>[{path:r.replace(/\.[^.\\/]+$/,".go.md"),content:U(t,{title:`${t.title} Go SDK reference`,frontmatter:e.docsFrontmatter===!0,language:{name:"go",label:"Go",fence:"go",requires:"The SDK needs the standard library only."},sample:n=>ct(n,{model:t,emit:e,outputPath:r}),pagination:e.pagination})}];export{h as a,X as b,pt as c,ct as d,yt as e};