Feature/dvt_notifications (#31)

* "feat: Monitor memory and app notifications  "

* "[MOD] treat both as the negative and positive representation of the channel code in the response"

* "feat: dvt add the notifications to Monitor memory and app notifications"

* "[MOD]print the notifications in tools"

* PR cleanup

* Fix clippy warning

---------

Co-authored-by: Jackson Coxson <jkcoxson@gmail.com>

idevice/src/services/dvt/message.rs

@@ -405,7 +405,9 @@ impl Message {
                 length: u32::from_le_bytes([buf[12], buf[13], buf[14], buf[15]]),
                 identifier: u32::from_le_bytes([buf[16], buf[17], buf[18], buf[19]]),
                 conversation_index: u32::from_le_bytes([buf[20], buf[21], buf[22], buf[23]]),
-                channel: u32::from_le_bytes([buf[24], buf[25], buf[26], buf[27]]),
+                //treat both as the negative and positive representation of the channel code in the response
+                // the same when performing fragmentation
+                channel: i32::abs(i32::from_le_bytes([buf[24], buf[25], buf[26], buf[27]])) as u32,
                 expects_reply: u32::from_le_bytes([buf[28], buf[29], buf[30], buf[31]]) == 1,
             };
             if header.fragment_count > 1 && header.fragment_id == 0 {

idevice/src/services/dvt/mod.rs

@@ -7,6 +7,7 @@ use crate::{Idevice, IdeviceError, ReadWrite, RsdService, obf};
 #[cfg(feature = "location_simulation")]
 pub mod location_simulation;
 pub mod message;
+pub mod notifications;
 pub mod process_control;
 pub mod remote_server;
 pub mod screenshot;

idevice/src/services/dvt/notifications.rs

@@ -0,0 +1,163 @@
+//! Notificaitons service client for iOS instruments protocol.
+//!
+//! Monitor memory and app notifications
+
+use crate::{
+    IdeviceError, ReadWrite,
+    dvt::{
+        message::AuxValue,
+        remote_server::{Channel, RemoteServerClient},
+    },
+    obf,
+};
+use log::warn;
+use plist::Value;
+
+#[derive(Debug)]
+pub struct NotificationInfo {
+    notification_type: String,
+    mach_absolute_time: i64,
+    exec_name: String,
+    app_name: String,
+    pid: u32,
+    state_description: String,
+}
+
+pub struct NotificationsClient<'a, R: ReadWrite> {
+    /// The underlying channel used for communication
+    pub channel: Channel<'a, R>,
+}
+
+impl<'a, R: ReadWrite> NotificationsClient<'a, R> {
+    /// Opens a new channel on the remote server client for app notifications
+    ///
+    /// # Arguments
+    /// * `client` - The remote server client to connect with
+    ///
+    /// # Returns
+    /// The client on success, IdeviceError on failure
+    pub async fn new(client: &'a mut RemoteServerClient<R>) -> Result<Self, IdeviceError> {
+        let channel = client
+            .make_channel(obf!(
+                "com.apple.instruments.server.services.mobilenotifications"
+            ))
+            .await?; // Drop `&mut client` before continuing
+
+        Ok(Self { channel })
+    }
+
+    /// set the applicaitons and memory notifications enabled
+    pub async fn start_notifications(&mut self) -> Result<(), IdeviceError> {
+        let application_method = Value::String("setApplicationStateNotificationsEnabled:".into());
+        self.channel
+            .call_method(
+                Some(application_method),
+                Some(vec![AuxValue::archived_value(true)]),
+                false,
+            )
+            .await?;
+        let memory_method = Value::String("setMemoryNotificationsEnabled:".into());
+        self.channel
+            .call_method(
+                Some(memory_method),
+                Some(vec![AuxValue::archived_value(true)]),
+                false,
+            )
+            .await?;
+        Ok(())
+    }
+
+    /// Reads the next notification from the service
+    pub async fn get_notification(&mut self) -> Result<NotificationInfo, IdeviceError> {
+        let message = self.channel.read_message().await?;
+        let mut notification = NotificationInfo {
+            notification_type: "".to_string(),
+            mach_absolute_time: 0,
+            exec_name: String::new(),
+            app_name: String::new(),
+            pid: 0,
+            state_description: String::new(),
+        };
+        if let Some(aux) = message.aux {
+            for v in aux.values {
+                match v {
+                    AuxValue::Array(a) => match ns_keyed_archive::decode::from_bytes(&a) {
+                        Ok(archive) => {
+                            if let Some(dict) = archive.into_dictionary() {
+                                for (key, value) in dict.into_iter() {
+                                    match key.as_str() {
+                                        "mach_absolute_time" => {
+                                            if let Value::Integer(time) = value {
+                                                notification.mach_absolute_time =
+                                                    time.as_signed().unwrap_or(0);
+                                            }
+                                        }
+                                        "execName" => {
+                                            if let Value::String(name) = value {
+                                                notification.exec_name = name;
+                                            }
+                                        }
+                                        "appName" => {
+                                            if let Value::String(name) = value {
+                                                notification.app_name = name;
+                                            }
+                                        }
+                                        "pid" => {
+                                            if let Value::Integer(pid) = value {
+                                                notification.pid =
+                                                    pid.as_unsigned().unwrap_or(0) as u32;
+                                            }
+                                        }
+                                        "state_description" => {
+                                            if let Value::String(desc) = value {
+                                                notification.state_description = desc;
+                                            }
+                                        }
+                                        _ => {
+                                            warn!("Unknown notificaton key: {} = {:?}", key, value);
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                        Err(e) => {
+                            warn!("Failed to decode archive: {:?}", e);
+                        }
+                    },
+                    _ => {
+                        warn!("Non-array aux value: {:?}", v);
+                    }
+                }
+            }
+        }
+
+        if let Some(Value::String(data)) = message.data {
+            notification.notification_type = data;
+            Ok(notification)
+        } else {
+            Err(IdeviceError::UnexpectedResponse)
+        }
+    }
+
+    /// set the applicaitons and memory notifications disable
+    pub async fn stop_notifications(&mut self) -> Result<(), IdeviceError> {
+        let application_method = Value::String("setApplicationStateNotificationsEnabled:".into());
+        self.channel
+            .call_method(
+                Some(application_method),
+                Some(vec![AuxValue::archived_value(false)]),
+                false,
+            )
+            .await?;
+        let memory_method = Value::String("setMemoryNotificationsEnabled:".into());
+        self.channel
+            .call_method(
+                Some(memory_method),
+                Some(vec![AuxValue::archived_value(false)]),
+                false,
+            )
+            .await?;
+
+        Ok(())
+    }
+}

idevice/src/services/dvt/remote_server.rs

@@ -201,6 +201,7 @@ impl<R: ReadWrite> RemoteServerClient<R> {
 
         let message = Message::new(mheader, pheader, aux, data);
         debug!("Sending message: {message:#?}");
+
         self.idevice.write_all(&message.serialize()).await?;
         self.idevice.flush().await?;