Struct Profile 

pub struct Profile<'a> { /* private fields */ }

Feature handle for profile operations.

Implementations

impl<'a> Profile<'a>

pub async fn set_status_text(&self, text: &str) -> Result<(), ProfileError>

Set the user’s status text (about).

Uses the stable IQ-based approach matching WhatsApp Web’s WAWebSetAboutJob:

<iq type="set" xmlns="status" to="s.whatsapp.net">
  <status>Hello world!</status>
</iq>

Note: This sets the profile “About” text, not ephemeral text status updates.

pub async fn set_push_name(&self, name: &str) -> Result<(), ProfileError>

Set the user’s push name (display name).

Updates the local device store, sends a presence stanza with the new name, and propagates the change via app state sync (setting_pushName mutation in the critical_block collection) for cross-device synchronization.

Matches WhatsApp Web’s WAWebPushNameBridge behavior:

1. Send <presence name="..."/> immediately (no type attribute)
2. Sync via app state mutation to critical_block collection

Wire Format

<presence name="New Name"/>

pub async fn set_profile_picture( &self, image_data: Vec<u8>, ) -> Result<SetProfilePictureResponse, ProfileError>

Set the user’s own profile picture.

Sends a JPEG image as the new profile picture. The image should already be properly sized/cropped by the caller (WhatsApp typically uses 640x640).

Passing empty image_data removes the picture (matching WhatsApp Web); call Profile::remove_profile_picture when removal is the intent.

Wire Format

<iq type="set" xmlns="w:profile:picture" to="s.whatsapp.net">
  <picture type="image">{jpeg bytes}</picture>
</iq>

pub async fn remove_profile_picture( &self, ) -> Result<SetProfilePictureResponse, ProfileError>

Remove the user’s own profile picture.