await server.use(PrismVersioningMiddleware(
    strategy: .urlPrefix,
    supportedVersions: [
        PrismAPIVersion(major: 1),
        PrismAPIVersion(major: 2)
    ],
    defaultVersion: PrismAPIVersion(major: 1)
))

// GET /v1/users → version 1
// GET /v2/users → version 2
// GET /users → version 1 (default)

PrismAPIVersion.parse("v1")     // major: 1, minor: 0
PrismAPIVersion.parse("v2.1")   // major: 2, minor: 1
PrismAPIVersion.parse("1")      // major: 1, minor: 0
PrismAPIVersion.parse("1.3")    // major: 1, minor: 3

await server.get("/users") { request in
    let version = request.apiVersion  // PrismAPIVersion?

    if version?.major == 2 {
        return .json(["users": usersV2])
    }
    return .json(["users": usersV1])
}

var router = PrismVersionedRouter()

router.route(version: PrismAPIVersion(major: 1), .GET, "/users") { request in
    .json(["format": "v1", "users": usersArrayV1])
}

router.route(version: PrismAPIVersion(major: 2), .GET, "/users") { request in
    .json(["data": usersArrayV2, "meta": pagination])
}

await server.get("/users") { request in
    if let response = try await router.handle(request) {
        return response
    }
    return .json(["error": "Not found"], status: .notFound)
}

{
    "error": "UNSUPPORTED_VERSION",
    "message": "API version v3 is not supported. Supported: v1, v2"
}

// Request: GET /v2/users/123
await server.get("/users/:id") { request in
    let version = request.apiVersion         // v2
    let path = request.path                  // /users/123 (stripped)
    let original = request.userInfo["versionedPath"]  // /users/123
    // ...
}