chore(release): bump plugin to 3.0.2

Use predictive_<epochMillis> for reminders (next-occurrence ms), testAlarm
fire time, and scheduleNotifications; persist predictiveEpochMillis in
UserDefaults for cancel/update alignment.

clearAllNotifications removes only predictive_* pending and delivered
entries. scheduleNotifications is additive (no global clear) and skips
past timestamps.

CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to the Daily Notification Plugin will be documented in this
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.2] - 2026-05-05
+
+### Changed
+
+- **iOS**: Predictive notification identifiers use epoch **milliseconds** (`predictive_<timestamp>`). Daily reminders persist `predictiveEpochMillis` for cancel/update alignment.
+- **iOS**: `clearAllNotifications` removes only **`predictive_*`** pending and delivered notifications (dual/org IDs unchanged).
+- **iOS**: `scheduleNotifications` is additive only (no automatic clear); skips stale timestamps in the past.
+
+### Added
+
+- **iOS**: `clearAllNotifications` and `scheduleNotifications` batch APIs on `DailyNotification` (Capacitor).
+
 ## [3.0.1] - 2026-04-16
 
 ### Fixed

ios/Plugin/DailyNotificationPlugin.swift

@@ -32,7 +32,7 @@ public class DailyNotificationPlugin: CAPPlugin {
     // Background task identifiers
     private let fetchTaskIdentifier = "org.timesafari.dailynotification.fetch"
     private let notifyTaskIdentifier = "org.timesafari.dailynotification.notify"
-    /// Prefix for deterministic UNNotificationRequest identifiers built as `predictive_\(Int(timestamp))` so rescheduling the same slot replaces instead of stacking.
+    /// Prefix for deterministic UNNotificationRequest identifiers: `predictive_\(Int(timestamp))` with `timestamp` in epoch milliseconds.
     private let predictiveNotificationPrefix = "predictive_"
     /// Stable identifier for the dual (New Activity) user notification. Used for replace and cancelDualSchedule; must not conflict with Daily Reminder (`predictive_*`).
     private let dualNotificationRequestIdentifier = "org.timesafari.dailynotification.dual"
@@ -1085,53 +1085,93 @@ public class DailyNotificationPlugin: CAPPlugin {
         return interval > 0 ? interval : (24 * 60 * 60)
     }
 
-    /// Seconds since local midnight for the daily reminder slot; stable for the same HH:mm so re-schedules overwrite.
-    private func predictiveReminderTimestamp(hour: Int, minute: Int) -> Int {
-        hour * 3600 + minute * 60
+    /// Epoch milliseconds for the next local occurrence of `hour`:`minute` (used only to build predictive IDs from HH:mm schedules).
+    private func epochMillisNextDailyOccurrence(hour: Int, minute: Int) -> Int64 {
+        var comp = DateComponents()
+        comp.hour = hour
+        comp.minute = minute
+        comp.second = 0
+        guard let next = Calendar.current.nextDate(after: Date(), matching: comp, matchingPolicy: .nextTime) else {
+            return Int64(Date().timeIntervalSince1970 * 1000)
+        }
+        return Int64(next.timeIntervalSince1970 * 1000)
     }
 
-    private func predictiveReminderRequestId(hour: Int, minute: Int) -> String {
-        let timestamp = predictiveReminderTimestamp(hour: hour, minute: minute)
-        return "\(predictiveNotificationPrefix)\(timestamp)"
+    private func predictiveNotificationId(epochMillis: Int64) -> String {
+        "\(predictiveNotificationPrefix)\(epochMillis)"
     }
 
-    private func predictiveReminderRequestId(fromTimeHHmm time: String) -> String? {
-        let timeComponents = time.components(separatedBy: ":")
-        guard timeComponents.count == 2,
-              let hour = Int(timeComponents[0]),
-              let minute = Int(timeComponents[1]),
+    /// Reads persisted millis for a reminder, or derives from stored `time` (HH:mm) for legacy rows.
+    private func predictiveEpochMillis(from reminder: [String: Any]) -> Int64? {
+        if let n = reminder["predictiveEpochMillis"] as? NSNumber {
+            return n.int64Value
+        }
+        guard let time = reminder["time"] as? String else { return nil }
+        let parts = time.components(separatedBy: ":")
+        guard parts.count == 2,
+              let hour = Int(parts[0]),
+              let minute = Int(parts[1]),
               hour >= 0, hour <= 23,
               minute >= 0, minute <= 59 else {
             return nil
         }
-        return predictiveReminderRequestId(hour: hour, minute: minute)
+        return epochMillisNextDailyOccurrence(hour: hour, minute: minute)
     }
 
     // MARK: - Predictive batch API (replace-all UNUserNotificationCenter)
 
-    /// Clears all pending and delivered user notifications. Parallel to the DB/scheduler stack; does not clear stored schedules elsewhere.
+    /// Removes only pending and delivered notifications whose identifiers begin with `predictive_`. Does not touch dual/org IDs or other stacks.
     @objc func clearAllNotifications(_ call: CAPPluginCall) {
-        NSLog("DNP-BATCH: clearAllNotifications — removing all pending and delivered notifications")
-        print("DNP-BATCH: clearAllNotifications — removing all pending and delivered notifications")
-        notificationCenter.removeAllPendingNotificationRequests()
-        notificationCenter.removeAllDeliveredNotifications()
-        call.resolve()
+        NSLog("DNP-BATCH: clearAllNotifications — removing predictive_* pending and delivered only")
+        print("DNP-BATCH: clearAllNotifications — removing predictive_* pending and delivered only")
+        let center = notificationCenter
+        let prefix = predictiveNotificationPrefix
+        let group = DispatchGroup()
+
+        group.enter()
+        center.getPendingNotificationRequests { requests in
+            let ids = requests.map { $0.identifier }.filter { $0.hasPrefix(prefix) }
+            center.removePendingNotificationRequests(withIdentifiers: ids)
+            NSLog("DNP-BATCH: cleared \(ids.count) pending predictive id(s)")
+            print("DNP-BATCH: cleared \(ids.count) pending predictive id(s)")
+            group.leave()
+        }
+
+        group.enter()
+        center.getDeliveredNotifications { notifications in
+            let ids = notifications.map { $0.request.identifier }.filter { $0.hasPrefix(prefix) }
+            center.removeDeliveredNotifications(withIdentifiers: ids)
+            NSLog("DNP-BATCH: cleared \(ids.count) delivered predictive id(s)")
+            print("DNP-BATCH: cleared \(ids.count) delivered predictive id(s)")
+            group.leave()
+        }
+
+        group.notify(queue: .main) {
+            call.resolve()
+        }
     }
 
-    /// Replaces all pending notifications with one-shot reminders at the given epoch millis. Clears pending first.
+    /// Add one-shot reminders at epoch-ms timestamps. Does not remove other requests; identical IDs replace pending entries. Caller should clear first if needed.
+    /// Adds/overwrites predictive notifications using deterministic IDs.
+    /// Does NOT clear existing notifications. Caller is responsible for lifecycle.
     @objc func scheduleNotifications(_ call: CAPPluginCall) {
         guard let timestamps = call.getArray("timestamps", Double.self) else {
             call.reject("Missing timestamps")
             return
         }
 
-        NSLog("DNP-BATCH: scheduleNotifications — removeAllPending then scheduling \(timestamps.count) request(s)")
-        print("DNP-BATCH: scheduleNotifications — removeAllPending then scheduling \(timestamps.count) request(s)")
-        notificationCenter.removeAllPendingNotificationRequests()
+        NSLog("DNP-BATCH: scheduleNotifications — additive scheduling for \(timestamps.count) timestamp(s)")
+        print("DNP-BATCH: scheduleNotifications — additive scheduling for \(timestamps.count) timestamp(s)")
 
         for ts in timestamps {
             let date = Date(timeIntervalSince1970: ts / 1000)
-            let interval = max(date.timeIntervalSinceNow, 1)
+            guard date.timeIntervalSinceNow > 0 else {
+                NSLog("DNP-BATCH: skip stale timestamp ts=\(ts) (not in the future)")
+                print("DNP-BATCH: skip stale timestamp ts=\(ts) (not in the future)")
+                continue
+            }
+
+            let interval = date.timeIntervalSinceNow
 
             let trigger = UNTimeIntervalNotificationTrigger(
                 timeInterval: interval,
@@ -1142,7 +1182,7 @@ public class DailyNotificationPlugin: CAPPlugin {
             content.title = "Reminder"
             content.body = "You have a scheduled notification"
 
-            let id = "predictive_\(Int(ts))"
+            let id = "\(predictiveNotificationPrefix)\(Int(ts))"
 
             NSLog("DNP-BATCH: scheduling ts=\(ts) interval=\(interval)s id=\(id)")
             print("DNP-BATCH: scheduling ts=\(ts) interval=\(interval)s id=\(id)")
@@ -1221,7 +1261,9 @@ public class DailyNotificationPlugin: CAPPlugin {
             repeats: repeatDaily
         )
 
-        let requestId = predictiveReminderRequestId(hour: hour, minute: minute)
+        let epochMillis = epochMillisNextDailyOccurrence(hour: hour, minute: minute)
+        let requestId = predictiveNotificationId(epochMillis: epochMillis)
+
         let request = UNNotificationRequest(
             identifier: requestId,
             content: content,
@@ -1238,7 +1280,8 @@ public class DailyNotificationPlugin: CAPPlugin {
             vibration: vibration,
             priority: priority,
             repeatDaily: repeatDaily,
-            timezone: timezone
+            timezone: timezone,
+            predictiveEpochMillis: epochMillis
         )
 
         // Delegate to UNUserNotificationCenter to schedule notification
@@ -1259,11 +1302,11 @@ public class DailyNotificationPlugin: CAPPlugin {
             return
         }
 
-        // Cancel the notification (deterministic id from stored HH:mm)
+        // Cancel the notification (ID from stored epoch millis)
         let reminders = getRemindersFromUserDefaults()
         if let stored = reminders.first(where: { ($0["id"] as? String) == reminderId }),
-           let time = stored["time"] as? String,
-           let requestId = predictiveReminderRequestId(fromTimeHHmm: time) {
+           let epochMillis = predictiveEpochMillis(from: stored) {
+            let requestId = predictiveNotificationId(epochMillis: epochMillis)
             notificationCenter.removePendingNotificationRequests(withIdentifiers: [requestId])
         }
 
@@ -1285,10 +1328,9 @@ public class DailyNotificationPlugin: CAPPlugin {
 
             var result: [[String: Any]] = []
             for reminder in reminders {
-                let expectedId: String? = {
-                    guard let time = reminder["time"] as? String else { return nil }
-                    return self.predictiveReminderRequestId(fromTimeHHmm: time)
-                }()
+                let expectedId: String? = self.predictiveEpochMillis(from: reminder).map {
+                    self.predictiveNotificationId(epochMillis: $0)
+                }
                 let isScheduled = reminderRequests.contains { expectedId != nil && $0.identifier == expectedId }
                 var reminderInfo = reminder
                 reminderInfo["isScheduled"] = isScheduled
@@ -1307,11 +1349,11 @@ public class DailyNotificationPlugin: CAPPlugin {
             return
         }
 
-        // Cancel existing reminder (slot before UserDefaults update)
+        // Cancel existing reminder (before UserDefaults update)
         let remindersBeforeUpdate = getRemindersFromUserDefaults()
         if let stored = remindersBeforeUpdate.first(where: { ($0["id"] as? String) == reminderId }),
-           let oldTime = stored["time"] as? String,
-           let oldRequestId = predictiveReminderRequestId(fromTimeHHmm: oldTime) {
+           let epochMillis = predictiveEpochMillis(from: stored) {
+            let oldRequestId = predictiveNotificationId(epochMillis: epochMillis)
             notificationCenter.removePendingNotificationRequests(withIdentifiers: [oldRequestId])
         }
 
@@ -1378,7 +1420,9 @@ public class DailyNotificationPlugin: CAPPlugin {
                 repeats: repeatDaily ?? true
             )
 
-            let requestId = predictiveReminderRequestId(hour: hour, minute: minute)
+            let epochMillis = epochMillisNextDailyOccurrence(hour: hour, minute: minute)
+            let requestId = predictiveNotificationId(epochMillis: epochMillis)
+
             let request = UNNotificationRequest(
                 identifier: requestId,
                 content: content,
@@ -1391,6 +1435,18 @@ public class DailyNotificationPlugin: CAPPlugin {
                     if let error = error {
                         call.reject("Failed to reschedule updated reminder: \(error.localizedDescription)")
                     } else {
+                        self.updateReminderInUserDefaults(
+                            id: reminderId,
+                            title: nil,
+                            body: nil,
+                            time: nil,
+                            sound: nil,
+                            vibration: nil,
+                            priority: nil,
+                            repeatDaily: nil,
+                            timezone: nil,
+                            predictiveEpochMillis: epochMillis
+                        )
                         call.resolve()
                     }
                 }
@@ -1411,7 +1467,8 @@ public class DailyNotificationPlugin: CAPPlugin {
         vibration: Bool,
         priority: String,
         repeatDaily: Bool,
-        timezone: String?
+        timezone: String?,
+        predictiveEpochMillis: Int64
     ) {
         let reminderData: [String: Any] = [
             "id": id,
@@ -1423,6 +1480,7 @@ public class DailyNotificationPlugin: CAPPlugin {
             "priority": priority,
             "repeatDaily": repeatDaily,
             "timezone": timezone ?? "",
+            "predictiveEpochMillis": predictiveEpochMillis,
             "createdAt": Date().timeIntervalSince1970,
             "lastTriggered": 0
         ]
@@ -1455,7 +1513,8 @@ public class DailyNotificationPlugin: CAPPlugin {
         vibration: Bool?,
         priority: String?,
         repeatDaily: Bool?,
-        timezone: String?
+        timezone: String?,
+        predictiveEpochMillis: Int64? = nil
     ) {
         var reminders = UserDefaults.standard.array(forKey: "daily_reminders") as? [[String: Any]] ?? []
         
@@ -1469,6 +1528,9 @@ public class DailyNotificationPlugin: CAPPlugin {
                 if let priority = priority { reminders[i]["priority"] = priority }
                 if let repeatDaily = repeatDaily { reminders[i]["repeatDaily"] = repeatDaily }
                 if let timezone = timezone { reminders[i]["timezone"] = timezone }
+                if let predictiveEpochMillis = predictiveEpochMillis {
+                    reminders[i]["predictiveEpochMillis"] = predictiveEpochMillis
+                }
                 break
             }
         }
@@ -1637,9 +1699,9 @@ public class DailyNotificationPlugin: CAPPlugin {
                 // Create time interval trigger (fires in X seconds)
                 let trigger = UNTimeIntervalNotificationTrigger(timeInterval: TimeInterval(validSeconds), repeats: false)
                 
-                // Deterministic id from scheduled fire time (Unix seconds) so repeat scheduling replaces instead of stacking
-                let timestamp = Int(Date().timeIntervalSince1970) + validSeconds
-                let requestId = "\(predictiveNotificationPrefix)\(timestamp)"
+                let fireDate = Date().addingTimeInterval(TimeInterval(validSeconds))
+                let epochMillis = Int64(fireDate.timeIntervalSince1970 * 1000)
+                let requestId = predictiveNotificationId(epochMillis: epochMillis)
                 let request = UNNotificationRequest(
                     identifier: requestId,
                     content: notificationContent,

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@timesafari/daily-notification-plugin",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@timesafari/daily-notification-plugin",
-      "version": "3.0.1",
+      "version": "3.0.2",
       "license": "MIT",
       "workspaces": [
         "packages/*"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timesafari/daily-notification-plugin",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "TimeSafari Daily Notification Plugin - Enterprise-grade daily notification functionality with dual scheduling, callback support, TTL-at-fire logic, and comprehensive observability across Mobile (Capacitor) and Desktop (Electron) platforms",
   "main": "dist/plugin.js",
   "module": "dist/esm/index.js",