Link json_schema extra_state to OpenAPI requestBody and responses

[Taure]

Summary

• Routes with extra_state => #{json_schema => "./schemas/post.json"} now generate $ref links in the OpenAPI spec
• POST/PUT/PATCH methods get a requestBody with application/json content referencing the schema
• All methods with a schema get response 200 content with the $ref
• Routes without json_schema in extra_state are unchanged

Example

{"/posts", fun posts_controller:create/1, #{
    methods => [post],
    extra_state => #{json_schema => "./schemas/post.json"}
}}

Produces:

"post": {
  "operationId": "posts_controller.create",
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": { "$ref": "#/components/schemas/post" }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful response",
      "content": {
        "application/json": {
          "schema": { "$ref": "#/components/schemas/post" }
        }
      }
    }
  }
}

Test plan

• Compiled clean with rebar3 compile
• rebar3 xref passes
• rebar3 dialyzer — no new warnings (all 9 are pre-existing)
• Tested with openapi_test project: routes with json_schema get $ref links, routes without are unchanged

🤖 Generated with Claude Code