Struct Encryption 

pub struct Encryption { /* private fields */ }

Encryption settings for a Bark encrypted push.

The algorithm, mode, key, and IV mirror Bark’s CryptoSettingFields. Create this value with Encryption::new to generate a fresh IV for CBC or GCM automatically, or with Encryption::with_iv when an exact IV is needed for tests or interoperability checks.

The IV is not secret. For CBC and GCM this crate serializes it as the top-level APNs iv field so Bark’s notification service extension can use it instead of the IV stored in the app settings.

Implementations

impl Encryption

pub fn new<K>( algorithm: EncryptionAlgorithm, mode: EncryptionMode, key: K, ) -> Result<Self>

where K: Into<String>,

Creates encryption settings and generates a mode-appropriate IV.

CBC generates a 16-byte ASCII IV, GCM generates a 12-byte ASCII IV, and ECB stores no IV. The key is validated immediately against the selected algorithm’s required byte length.

Errors

Returns Error::InvalidKeyLength if the key length does not match the algorithm, or Error::Random if the operating system cannot provide randomness for an IV.

pub fn with_iv<K, I>( algorithm: EncryptionAlgorithm, mode: EncryptionMode, key: K, iv: I, ) -> Result<Self>

where K: Into<String>, I: Into<String>,

Creates encryption settings with an explicit IV.

Use this when reproducing Bark documentation examples or when the caller deliberately wants to control the IV. Normal sends should prefer Encryption::new so CBC and GCM do not reuse IVs.

For ECB, pass an empty string because Bark’s ECB mode does not use an IV.

Errors

Returns Error::InvalidKeyLength when the key has the wrong length, or Error::InvalidIvLength when the IV length does not match the selected mode.

pub const fn algorithm(&self) -> EncryptionAlgorithm

Returns the selected Bark encryption algorithm.

pub const fn mode(&self) -> EncryptionMode

Returns the selected Bark encryption mode.

pub fn key(&self) -> &str

Returns the shared encryption key.

This is the exact UTF-8 key string that must also be configured on the iOS device in Bark’s push encryption settings.

pub fn iv(&self) -> Option<&str>

Returns the IV that will be sent with the APNs payload.

CBC and GCM return Some, while ECB returns None because it has no IV.

Trait Implementations

impl Clone for Encryption

fn clone(&self) -> Encryption

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Encryption

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

Formats the value using the given formatter.

impl Eq for Encryption

impl PartialEq for Encryption

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Encryption