Struct PcsExternalClient 

pub struct PcsExternalClient<S: PcsExternalScopeSet> { /* private fields */ }

Phantom-typed gRPC client for the PCS External Developer Platform.

The type parameter S: PcsExternalScopeSet constrains which methods are callable at compile time. Construct via crate::PcsExternalClientBuilder.

Capability gating

Method	Required capability
send_alert	S: SendAlertCapable
get_send_status	S: GetSendStatusCapable

Calling a method your scope set doesn’t satisfy is a compile-time E0277 — see crate::scopes for the compile_fail doctest.

Implementations

impl<S: SendAlertCapable> PcsExternalClient<S>

pub async fn send_alert( &self, template: &TemplateId, recipients: &RecipientList, poll: Option<&PollConfig>, ) -> Result<SendOutcome, Error>

Send a batch of templated messages to recipients.

Translates to ExternalMessageService::CreateSendRequest.

Errors

• Error::TokenRefresh — JWT acquisition failed before the call.
• Error::Rejected — PCS rejected the request (bad template, quota, etc.).
• Error::ServerError — PCS 5xx, retry-eligible.
• Error::Transport — network-level failure.

impl<S: GetSendStatusCapable> PcsExternalClient<S>

pub async fn get_send_status( &self, id: &SendRequestId, ) -> Result<SendStatus, Error>

Poll aggregate delivery status for a previously-issued send request.

Translates to ExternalMessageService::GetSendRequestStatus.

Errors

Same shape as PcsExternalClient::send_alert.

pub async fn stream_send_request_events( &self, send_request_id: Option<&SendRequestId>, after_event_id: Option<&str>, ) -> Result<DeliveryStream, Error>

Open a server-streaming delivery event channel.

Streams per-recipient lifecycle events for all send requests issued by this app. Pass after_event_id to resume from a cursor after a reconnect so no events are replayed.

Errors

Returns crate::Error::TokenRefresh if the JWT cannot be acquired, crate::Error::Rejected / crate::Error::Transport if the initial RPC handshake fails. Stream-level errors surface through DeliveryStream::message.

Trait Implementations

impl<S: PcsExternalScopeSet> Clone for PcsExternalClient<S>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.