Replace okapi_operation with utoipa

The dependency okapi_operation is no longer actively maintained and blocks Restate
from upgrading the schemars dependency. Moreover, it only generates OpenAPI 3.0 specs.

To solve this problem, this commit replaces the okapi_operation dependency with the
more actively maintained utoipa dependency which allows us to generate OpenAPI 3.1.
Moreover, it will allow us to eventually drop the restate-utoipa fork once we upstream
the added changes.

As part of this rework, we added the SQL query endpoint to the OpenAPI documentation
and removed the feature gate.

Author: tillrohrmann

Cargo.lock

@@ -264,6 +264,8 @@ typify = { version = "0.5.0" }
 ulid = { version = "1.2.1" }
 url = { version = "2.5" }
 urlencoding = { version = "2.1" }
+utoipa = { version = "5.4" }
+utoipa-axum = "0.2"
 uuid = { version = "1.19.0", features = ["v7", "serde"] }
 vergen = { version = "8.0.0", default-features = false }
 xxhash-rust = { version = "0.8", features = ["xxh3"] }

Cargo.toml

@@ -9,7 +9,7 @@ publish = false
 
 [features]
 default = []
-schema = ["dep:schemars", "restate-serde-util/schema", "restate-types/schemars"]
+schema = ["dep:utoipa", "restate-serde-util/utoipa-schema", "restate-types/utoipa-schema"]
 
 [dependencies]
 restate-workspace-hack = { workspace = true }
@@ -23,7 +23,7 @@ derive_more = { workspace = true }
 http = { workspace = true }
 http-serde = { workspace = true }
 humantime = { workspace = true }
-schemars = { workspace = true, optional = true }
+utoipa = { workspace = true, optional = true }
 serde = { workspace = true }
 serde_json = { workspace = true }
 serde_with = { workspace = true }