Enum Recipient 

pub enum Recipient {
    Apns {
        device_token: String,
    },
    Fcm {
        registration_token: String,
    },
    WebPush {
        endpoint: String,
        p256dh: String,
        auth: String,
    },
}

Where a notification is sent. One variant per push transport, because the three do not share a shape: APNs and FCM take an opaque token, Web Push takes a subscription of three parts (RFC 8291).

Every variant holds credential material. A device token and an FCM registration token address one device; a Web Push endpoint is a bearer capability URL (whoever holds it can push to that browser) and auth is the RFC 8291 shared secret the payload is encrypted under. Hence the hand-written Debug, which prints fingerprints and never the values: core’s log redaction keys off the field name (is_secret_field) and cannot see inside a {:?} of this enum.

Serialize/Deserialize stay, because a subscription has to be persisted and read back — but a serialised Recipient is the credential: store it where secrets go, never in a log, an event payload, or an error body.

Variants

Apns

An APNs device token (hex, from application:didRegister...).

Fields

device_token: String

Fcm

An FCM registration token.

Fields

registration_token: String

WebPush

A Web Push subscription: the push service URL plus the two RFC 8291 keys, both base64url as the browser hands them over.

Fields

endpoint: String

p256dh: String

auth: String

Implementations

impl Recipient

pub fn apns(device_token: impl Into<String>) -> Self

An APNs recipient.

pub fn fcm(registration_token: impl Into<String>) -> Self

An FCM recipient.

pub fn web_push( endpoint: impl Into<String>, p256dh: impl Into<String>, auth: impl Into<String>, ) -> Self

A Web Push recipient (RFC 8291 keys, base64url).

pub fn platform(&self) -> Platform

The transport this recipient is reached over. A transport fact, not a device fact (ADR 0015).

Trait Implementations

impl Clone for Recipient

fn clone(&self) -> Recipient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Recipient

Prints the transport and a short fingerprint of each part, never the parts themselves — the same rule Es256Signer, Rs256Signer and CachedToken follow in cratefield-push-auth. The RFC 8291 auth secret is not even fingerprinted: nothing about it is safe to correlate on.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Recipient

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Recipient

impl Hash for Recipient

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Recipient

fn eq(&self, other: &Recipient) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Recipient

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Recipient