let endpoints = [
    PrismAPIEndpoint(
        method: .GET, path: "/users",
        summary: "List all users",
        tags: ["Users"],
        responses: [PrismAPIResponse(statusCode: 200, description: "User list", contentType: "application/json")]
    ),
    PrismAPIEndpoint(
        method: .POST, path: "/users",
        summary: "Create a user",
        tags: ["Users"],
        requestBody: PrismAPIBody(description: "User data", schemaRef: "CreateUser"),
        responses: [PrismAPIResponse(statusCode: 201, description: "Created")]
    )
]

let generator = PrismOpenAPIGenerator(
    title: "My API",
    version: "1.0.0",
    description: "A sample API built with Prism",
    serverURL: "http://localhost:8080",
    endpoints: endpoints
)

await server.use(PrismOpenAPIMiddleware(generator: generator))
// GET /openapi.json → OpenAPI spec
// GET /docs → Swagger UI

PrismAPIEndpoint(
    method: .GET,
    path: "/users/:id",
    summary: "Get user by ID",
    description: "Returns a single user object.",
    tags: ["Users"],
    parameters: [
        PrismAPIParameter(name: "id", location: .path, required: true, type: "integer", description: "User ID")
    ],
    responses: [
        PrismAPIResponse(statusCode: 200, description: "Success", contentType: "application/json", schemaRef: "User"),
        PrismAPIResponse(statusCode: 404, description: "User not found")
    ]
)

// Path parameter: /users/{id}
PrismAPIParameter(name: "id", location: .path, required: true, type: "integer")

// Query parameter: /users?page=1&limit=20
PrismAPIParameter(name: "page", location: .query, type: "integer", description: "Page number")
PrismAPIParameter(name: "limit", location: .query, type: "integer", description: "Items per page")

// Header parameter
PrismAPIParameter(name: "X-API-Key", location: .header, required: true, type: "string")

PrismAPIBody(
    contentType: "application/json",
    description: "User registration data",
    schemaRef: "CreateUser"  // References #/components/schemas/CreateUser
)

let endpoints = [
    // List todos
    PrismAPIEndpoint(
        method: .GET, path: "/todos",
        summary: "List todos",
        tags: ["Todos"],
        parameters: [
            PrismAPIParameter(name: "completed", location: .query, type: "boolean", description: "Filter by completion status")
        ],
        responses: [PrismAPIResponse(statusCode: 200, description: "Todo list", contentType: "application/json")]
    ),
    // Create todo
    PrismAPIEndpoint(
        method: .POST, path: "/todos",
        summary: "Create a todo",
        tags: ["Todos"],
        requestBody: PrismAPIBody(description: "Todo data"),
        responses: [
            PrismAPIResponse(statusCode: 201, description: "Created"),
            PrismAPIResponse(statusCode: 422, description: "Validation error")
        ]
    ),
    // Update todo
    PrismAPIEndpoint(
        method: .PATCH, path: "/todos/:id",
        summary: "Update a todo",
        tags: ["Todos"],
        parameters: [PrismAPIParameter(name: "id", location: .path, required: true, type: "integer")],
        requestBody: PrismAPIBody(description: "Fields to update"),
        responses: [PrismAPIResponse(statusCode: 200, description: "Updated")]
    ),
    // Delete todo
    PrismAPIEndpoint(
        method: .DELETE, path: "/todos/:id",
        summary: "Delete a todo",
        tags: ["Todos"],
        parameters: [PrismAPIParameter(name: "id", location: .path, required: true, type: "integer")],
        responses: [PrismAPIResponse(statusCode: 204, description: "Deleted")]
    )
]

await server.use(PrismOpenAPIMiddleware(
    generator: generator,
    specPath: "/api/openapi.json",
    docsPath: "/api/docs"
))

let specData = try generator.generateJSON(prettyPrinted: true)
let specDict = generator.generate()  // [String: Any]