Struct WebPushClient 

pub struct WebPushClient { /* private fields */ }

WebPush client.

Cheap to clone (all fields are Arc-backed).

Implementations

impl WebPushClient

pub fn new( vapid_pem: Option<&[u8]>, admin_email: &str, ) -> Result<Self, WebPushError>

Construct from an existing PEM-encoded P-256 EC private key.

If vapid_pem is None, a fresh key is generated in memory.

pub fn new_with_persistence( key_path: Option<&Path>, admin_email: &str, ) -> Result<Self, WebPushError>

Load or generate the VAPID key, optionally persisting it.

• If key_path is Some and the file exists: loads the PEM.
• If key_path is Some and the file does NOT exist: generates a new key and writes it to the path so subsequent restarts use the same key.
• If key_path is None: generates an ephemeral in-memory key.

pub fn vapid_pubkey_base64url(&self) -> &str

Return the base64url-encoded uncompressed VAPID public key.

This is the value that must be shared with push endpoints so they can verify VAPID JWTs. Exposed for tests and for generating the VAPID public key header in Crypto-Key.

pub async fn send( &self, subscription: &PushSubscription, payload: &[u8], ) -> Result<(), WebPushError>

Send a WebPush message to subscription.

When subscription.keys is None (or RFC 8291 encryption is not yet implemented) the body is left empty (tickle semantics). The VAPID JWT is always included in the Authorization header per RFC 8444.

Trait Implementations

impl Clone for WebPushClient

fn clone(&self) -> WebPushClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WebPushClient

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

Formats the value using the given formatter.