Function gatherClientResponseWrappers

pkg/codegen/gather.go:278–319

gatherClientResponseWrappers creates synthetic schema entries for each operation that would generate a client response wrapper type like ` Response`. These don't correspond to a real schema in the spec but they need names that don't collide with real types.

(spec *openapi3.T)

// `<OperationId>Response`. These don't correspond to a real schema in the
// spec but they need names that don't collide with real types.
func gatherClientResponseWrappers(spec *openapi3.T) []*GatheredSchema {
	if spec.Paths == nil {
		return nil
	}

	// Collect all operations sorted for determinism
	type opEntry struct {
		path   string
		method string
		op     *openapi3.Operation
	}
	var ops []opEntry

	pathKeys := SortedMapKeys(spec.Paths.Map())
	for _, path := range pathKeys {
		pathItem := spec.Paths.Find(path)
		if pathItem == nil {
			continue
		}
		for method, op := range pathItem.Operations() {
			if op != nil && op.OperationID != "" {
				ops = append(ops, opEntry{path: path, method: method, op: op})
			}
		}
	}

	// Sort by operationID for determinism
	slices.SortFunc(ops, func(a, b opEntry) int {
		return cmp.Compare(a.op.OperationID, b.op.OperationID)
	})

	result := make([]*GatheredSchema, 0, len(ops))
	for _, entry := range ops {
		result = append(result, &GatheredSchema{
			Path:        SchemaPath{"paths", entry.path, entry.method, "x-client-response-wrapper"},
			Context:     ContextClientResponseWrapper,
			OperationID: entry.op.OperationID,
		})
	}

	return result
}

// FormatPath returns a human-readable representation of the path for debugging.
func (gs *GatheredSchema) FormatPath() string {