feat: add sneekpeak functionality

Author: robertherber

apps/example/screens/AllTheThings.tsx

@@ -285,6 +285,83 @@ export function AllTheThings() {
           }}
         />
 
+        <Button
+          title="Test sneakpeak"
+          onPress={() => {
+            /*ReactNativeDeviceActivity.configureActions({
+              activityName: "sneek-peak",
+              callbackName: "intervalDidEnd",
+              actions: [
+                {
+                  type: "sendNotification",
+                  payload: {
+                    title: "sneek-peak ended!!!",
+                    body: "You have reached the end of the sneek-peak!",
+                  },
+                },
+                {
+                  type: "enableBlockAllMode",
+                },
+                {
+                  type: "clearWhitelistAndUpdateBlock",
+                },
+              ],
+            });*/
+
+            ReactNativeDeviceActivity.configureActions({
+              activityName: "sneekpeak",
+              callbackName: "intervalDidStart",
+              actions: [
+                {
+                  type: "sendNotification",
+                  payload: {
+                    title: "sneek-peak ended!!!",
+                    body: "You have reached the end of the sneek-peak!",
+                  },
+                },
+                {
+                  type: "enableBlockAllMode",
+                },
+                {
+                  type: "clearWhitelistAndUpdateBlock",
+                },
+                {
+                  type: "stopMonitoring",
+                  activityNames: ["sneekpeak"],
+                }
+              ],
+            });
+            ReactNativeDeviceActivity.updateShield(
+              {
+                title: "take a sneekpeak!",
+                primaryButtonLabel: "do it now!",
+              },
+              {
+                primary: {
+                  behavior: "defer",
+                  actions: [
+                    {
+                      type: "disableBlockAllMode",
+                    },
+                    {
+                      type: "clearWhitelistAndUpdateBlock",
+                    },
+                    {
+                      type: "startMonitoring",
+                      activityName: "sneekpeak",
+                      intervalStartDelayMs: 10000,
+                      intervalEndDelayMs: 60 * 15 * 1000 + 10000,
+                      deviceActivityEvents: [],
+                    },
+                  ],
+                },
+              },
+            );
+            console.log("done!");
+            console.log(ReactNativeDeviceActivity.getEvents())
+          }}
+        />
+
         <TextInput
           placeholder="Enter shield title"
           onChangeText={(text) => setShieldTitle(text)}

packages/react-native-device-activity/ios/Shared.swift

@@ -238,6 +238,25 @@ func executeGenericAction(
       // required for it to have time to trigger before process/callback ends
       sleep(ms: 1000)
     }
+  } else if type == "startMonitoring" {
+    if let activityName = action["activityName"] as? String,
+      let deviceActivityEvents = action["deviceActivityEvents"] as? [[String: Any]] {
+
+      startMonitoringAction(
+        activityName: activityName,
+        deviceActivityEvents: deviceActivityEvents,
+        intervalStartDelayMs: action["intervalStartDelayMs"] as? Int,
+        intervalEndDelayMs: action["intervalEndDelayMs"] as? Int,
+        triggeredBy: triggeredBy
+      )
+    }
+  } else if type == "stopMonitoring" {
+    let activityNames = action["activityNames"] as? [String]
+
+    stopMonitoringAction(
+      activityNames: activityNames,
+      triggeredBy: triggeredBy
+    )
   }
 
   if let sleepAfter = action["sleepAfter"] as? Int {
@@ -1423,3 +1442,114 @@ func getAppGroupDirectory() -> URL? {
   }
   return nil
 }
+
+@available(iOS 15.0, *)
+func startMonitoringAction(
+  activityName: String,
+  deviceActivityEvents: [[String: Any]],
+  intervalStartDelayMs: Int?,
+  intervalEndDelayMs: Int?,
+  triggeredBy: String
+) {
+  // Create date components for schedule
+  let now = Date()
+  let calendar = Calendar.current
+
+  var intervalStart = DateComponents()
+  var intervalEnd = DateComponents()
+
+  if let startDelayMs = intervalStartDelayMs {
+    let startDate = now.addingTimeInterval(TimeInterval(startDelayMs) / 1000.0)
+    intervalStart = calendar.dateComponents([.hour, .minute, .second], from: startDate)
+  }
+
+  if let endDelayMs = intervalEndDelayMs {
+    let endDate = now.addingTimeInterval(TimeInterval(endDelayMs) / 1000.0)
+    intervalEnd = calendar.dateComponents([.hour, .minute, .second], from: endDate)
+  } else {
+    // Default to 24 hours from start if not specified
+    let defaultEndMs = (intervalStartDelayMs ?? 0) + (24 * 60 * 60 * 1000)
+    let endDate = now.addingTimeInterval(TimeInterval(defaultEndMs) / 1000.0)
+    intervalEnd = calendar.dateComponents([.hour, .minute, .second], from: endDate)
+  }
+
+  let schedule = DeviceActivitySchedule(
+    intervalStart: intervalStart,
+    intervalEnd: intervalEnd,
+    repeats: false
+  )
+
+  // Create DeviceActivityEvent dictionary
+  var eventDict: [DeviceActivityEvent.Name: DeviceActivityEvent] = [:]
+
+  for eventData in deviceActivityEvents {
+    guard let eventName = eventData["eventName"] as? String,
+      let threshold = eventData["threshold"] as? [String: Any],
+      let familyActivitySelection = eventData["familyActivitySelection"] as? String
+    else {
+      continue
+    }
+
+    let selection = deserializeFamilyActivitySelection(
+      familyActivitySelectionStr: familyActivitySelection)
+
+    // Convert threshold to DateComponents
+    var thresholdComponents = DateComponents()
+    if let hour = threshold["hour"] as? Int { thresholdComponents.hour = hour }
+    if let minute = threshold["minute"] as? Int { thresholdComponents.minute = minute }
+    if let second = threshold["second"] as? Int { thresholdComponents.second = second }
+
+    let includesPastActivity = eventData["includesPastActivity"] as? Bool ?? false
+
+    var event: DeviceActivityEvent
+    if #available(iOS 17.4, *) {
+      event = DeviceActivityEvent(
+        applications: selection.applicationTokens,
+        categories: selection.categoryTokens,
+        webDomains: selection.webDomainTokens,
+        threshold: thresholdComponents,
+        includesPastActivity: includesPastActivity
+      )
+    } else {
+      event = DeviceActivityEvent(
+        applications: selection.applicationTokens,
+        categories: selection.categoryTokens,
+        webDomains: selection.webDomainTokens,
+        threshold: thresholdComponents
+      )
+    }
+
+    eventDict[DeviceActivityEvent.Name(eventName)] = event
+  }
+
+  let activityName = DeviceActivityName(activityName)
+
+  do {
+    try center.startMonitoring(activityName, during: schedule, events: eventDict)
+    logger.log(
+      "✅ Successfully started monitoring activity: \(activityName.rawValue) from \(triggeredBy)")
+  } catch {
+    logger.log(
+      "❌ Failed to start monitoring activity: \(activityName.rawValue, privacy: .public) - \(error.localizedDescription, privacy: .public)"
+    )
+  }
+}
+
+@available(iOS 15.0, *)
+func stopMonitoringAction(
+  activityNames: [String]?,
+  triggeredBy: String
+) {
+  if let activityNames = activityNames {
+    // Stop specific activities
+    let deviceActivityNames = activityNames.map { DeviceActivityName($0) }
+    center.stopMonitoring(deviceActivityNames)
+    logger.log(
+      "✅ Successfully stopped monitoring activities: \(activityNames.joined(separator: ", ")) from \(triggeredBy)"
+    )
+  } else {
+    // Stop all monitoring
+    center.stopMonitoring()
+    logger.log("✅ Successfully stopped all monitoring from \(triggeredBy)")
+  }
+}

packages/react-native-device-activity/src/ReactNativeDeviceActivity.types.ts

@@ -287,6 +287,24 @@ export type Action =
     } & CommonTypeParams)
   | ({
       type: "removeAllDeliveredNotifications";
+    } & CommonTypeParams)
+  | ({
+      type: "startMonitoring";
+      activityName: string;
+      deviceActivityEvents: DeviceActivityEvent[];
+      /**
+       * Optional delay in milliseconds from now for intervalStart.
+       * If provided, will override deviceActivitySchedule.intervalStart.
+       */
+      intervalStartDelayMs?: number;
+      intervalEndDelayMs?: number;
+    } & CommonTypeParams)
+  | ({
+      type: "stopMonitoring";
+      /**
+       * Optional array of activity names to stop. If not provided, stops all monitoring.
+       */
+      activityNames?: string[];
     } & CommonTypeParams);
 
 export type DeviceActivityEventRaw = Omit<