feat: generate OpenAPI from API contracts

Cargo.lock

@@ -175,7 +175,9 @@ dependencies = [
  "api-macros-impl",
  "axum",
  "futures",
+ "oas3",
  "reqwest",
+ "schemars",
  "serde",
  "serde_json",
  "serde_urlencoded",
@@ -1086,6 +1088,7 @@ dependencies = [
  "quote",
  "rustc_version",
  "syn 2.0.117",
+ "unicode-xid",
 ]
 
 [[package]]
@@ -2806,6 +2809,24 @@ version = "0.2.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6aa2c4e539b869820a2b82e1aef6ff40aa85e65decdd5185e83fb4b1249cd00f"
 
+[[package]]
+name = "oas3"
+version = "0.22.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "da5a5aa72eddcc53edfd06f287a2c10f872d88e8b72c650234cd8a227572424a"
+dependencies = [
+ "derive_more",
+ "http",
+ "indexmap",
+ "log",
+ "once_cell",
+ "regex",
+ "semver",
+ "serde",
+ "serde_json",
+ "url",
+]
+
 [[package]]
 name = "oid-registry"
 version = "0.7.1"