feat: domain availability + suggest via spec-generated client

rust/Cargo.toml

@@ -6,7 +6,7 @@ description = "GoDaddy developer CLI"
 license = "Proprietary"
 
 [workspace]
-members = [".", "tools/generate-api-catalog"]
+members = [".", "tools/generate-api-catalog", "domains-client"]
 
 [[bin]]
 name = "gddy"
@@ -16,8 +16,9 @@ path = "src/main.rs"
 async-trait = "0.1"
 chrono = { version = "0.4", default-features = false, features = ["clock", "serde"] }
 clap = { version = "4.5", features = ["std", "string"] }
-cli-engine = { features = ["pkce-auth"], version = "0.2.1" }
+cli-engine = { features = ["pkce-auth"], version = "0.2.2" }
 dirs = "6"
+domains-client = { path = "domains-client" }
 fancy-regex = "0.14"
 regex = { version = "1", features = ["std"] }
 reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] }

rust/domains-client/Cargo.toml

@@ -0,0 +1,30 @@
+[package]
+name = "domains-client"
+version = "0.1.0"
+edition = "2024"
+license = "Proprietary"
+description = "Generated GoDaddy Domains API client (availability + suggest), produced from the vendored OpenAPI 3.0 spec by progenitor at build time."
+
+[dependencies]
+# Pinned to 0.11 (the latest progenitor on reqwest 0.12): keeps the whole
+# workspace on one reqwest + ring-based rustls-tls stack as cli-engine/the main
+# crate, which avoids aws-lc-rs (reqwest 0.13's only rustls provider) and keeps
+# the Windows-msvc cross-build clean.
+progenitor-client = "0.11"
+reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls", "stream"] }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+futures = "0.3"
+bytes = "1"
+thiserror = "2"
+
+[build-dependencies]
+progenitor = "0.11"
+openapiv3 = "2"
+serde_json = "1"
+prettyplease = "0.2"
+syn = "2"
+
+[dev-dependencies]
+httpmock = "0.7"
+tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

rust/domains-client/build.rs

@@ -0,0 +1,31 @@
+//! Generates the typed Domains API client from the vendored OpenAPI 3.0 spec.
+//!
+//! The spec (`openapi/domains.oas3.json`) is committed and trimmed to the
+//! availability + suggest operations (see `scripts/regenerate-spec.sh`); this
+//! build step is hermetic and never touches the network.
+
+use std::{env, fs, path::Path};
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let spec_path = "openapi/domains.oas3.json";
+    println!("cargo:rerun-if-changed={spec_path}");
+    println!("cargo:rerun-if-changed=build.rs");
+
+    let spec_text = fs::read_to_string(spec_path)?;
+    let spec: openapiv3::OpenAPI = serde_json::from_str(&spec_text)?;
+
+    // Builder interface: each operation gets a fluent builder with named setters
+    // (e.g. `client.suggest().query(..).limit(..).send()`) instead of positional
+    // args, so call sites read clearly without an IDE and unused optional params
+    // are simply omitted rather than passed as `None`.
+    let mut settings = progenitor::GenerationSettings::new();
+    settings.with_interface(progenitor::InterfaceStyle::Builder);
+    let mut generator = progenitor::Generator::new(&settings);
+    let tokens = generator.generate_tokens(&spec)?;
+    let ast = syn::parse2(tokens)?;
+    let formatted = prettyplease::unparse(&ast);
+
+    let out_dir = env::var("OUT_DIR")?;
+    fs::write(Path::new(&out_dir).join("codegen.rs"), formatted)?;
+    Ok(())
+}