xds-client: add canonical xdstp resource-name parsing

xds-client/Cargo.toml

@@ -17,6 +17,7 @@ bytes = "1.11.0"
 thiserror = "2"
 tokio = { version = "1", features = ["sync", "macros"] }
 rand = "0.10"
+percent-encoding = "2.3"
 
 # Optional dependencies for tonic transport
 tonic = { version = "0.14", optional = true }

xds-client/src/error.rs

@@ -61,6 +61,13 @@ pub enum Error {
     /// This indicates the resource has been deleted or was never created.
     #[error("resource does not exist")]
     ResourceDoesNotExist,
+
+    /// An `xdstp:` resource name could not be parsed.
+    #[error("unable to parse resource name {name:?}")]
+    InvalidResourceName {
+        /// The invalid resource name.
+        name: String,
+    },
 }
 
 /// Result type alias for xDS client operations.

xds-client/src/lib.rs

@@ -83,6 +83,7 @@ pub mod metrics;
 pub mod resource;
 pub mod runtime;
 pub mod transport;
+pub mod uri;
 
 pub use client::config::{ClientConfig, ServerConfig};
 pub use client::retry::{Backoff, RetryPolicy};
@@ -93,6 +94,7 @@ pub use error::{Error, Result};
 pub use message::{DiscoveryRequest, DiscoveryResponse, ErrorDetail, Locality, Node, ResourceAny};
 pub use metrics::{Instrument, InstrumentKind, KeyValue, MetricsRecorder, StringValue, Value};
 
+pub use resource::name::{AuthorityKey, ResourceName};
 pub use resource::{DecodeResult, DecodedResource, Resource};
 pub use runtime::Runtime;
 pub use transport::{Transport, TransportBuilder, TransportStream};

xds-client/src/resource/mod.rs

@@ -29,6 +29,8 @@ use bytes::Bytes;
 use std::any::Any;
 use std::sync::Arc;
 
+pub mod name;
+
 #[cfg(feature = "codegen-prost")]
 pub mod prost;