fix: OpenAPI Converter was not parsing examples for request parameters

Merged
SH
4mo ago
+376-12

Summary by cubic

Fixes OpenAPI example handling and normalizes them into JSON Schema examples for parameters, request bodies, and responses. Also validates HTTP methods and skips unsupported ones to prevent crashes.

  • Bug Fixes
    • Extract and merge examples from example/examples at parameter, media type, and schema levels; resolve $ref, de-duplicate, ignore externalValue; normalize into JSON Schema examples and strip raw example/examples keys.
    • Validate HTTP method against a supported set and skip unsupported (OPTIONS, HEAD, TRACE) instead of erroring.
    • Tighten typing and attribute access; add tests for parameter/body/response examples, schema-level normalization, and unsupported-method skipping.