react-native-alarms 0.0.6 → 0.0.8

package/android/local.properties

@@ -0,0 +1,8 @@
+## This file must *NOT* be checked into Version Control Systems,
+# as it contains information specific to your local configuration.
+#
+# Location of the SDK. This is only used by Gradle.
+# For customization when using a Version Control System, please read the
+# header note.
+#Fri Oct 23 16:38:30 IST 2026
+sdk.dir=/Users/apple/Library/Android/sdk

package/android-lib/src/main/AndroidManifest.xml

@@ -1,5 +1,6 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
 
+    <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
     <uses-permission android:name="android.permission.USE_EXACT_ALARM" />
     <uses-permission

package/index.ts

@@ -8,13 +8,15 @@
 export type {
   AlarmRepeat,
   AlarmConfig,
-  Alarm,
+  AlarmProp,
   AlarmPermission,
   AlarmEvent,
-  Spec as AlarmModuleSpec,
-} from './specs/NativeAlarm';
+  AlarmEventMap,
+  AlarmEventName,
+} from './src/types';
 
 export { AlarmService } from './AlarmService';
 
-import NativeAlarm from './specs/NativeAlarm';
-export default NativeAlarm;
+import Alarm from './specs/NativeAlarm';
+
+export default Alarm;

package/ios/.xcode.env.local

@@ -1 +1 @@
-export NODE_BINARY=/opt/homebrew/Cellar/node/26.10.0_1/bin/node
+export NODE_BINARY=/opt/homebrew/bin/node

package/ios/ReactNativeAlarm/Info.plist

@@ -26,6 +26,8 @@
 	<string>$(CURRENT_PROJECT_VERSION)</string>
 	<key>LSRequiresIPhoneOS</key>
 	<true/>
+	<key>NSAlarmKitUsageDescription</key>
+	<string>This app needs access to alarms to wake you up on time.</string>
 	<key>NSAppTransportSecurity</key>
 	<dict>
 		<key>NSAllowsArbitraryLoads</key>
@@ -73,7 +75,5 @@
 	</array>
 	<key>UIViewControllerBasedStatusBarAppearance</key>
 	<false/>
-	<key>NSAlarmKitUsageDescription</key>
-	<string>This app needs access to alarms to wake you up on time.</string>
 </dict>
 </plist>

package/ios/ReactNativeAlarm.xcodeproj/project.pbxproj

@@ -223,10 +223,14 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-ReactNativeAlarm/Pods-ReactNativeAlarm-frameworks-${CONFIGURATION}-input-files.xcfilelist",
 			);
+			inputPaths = (
+			);
 			name = "[CP] Embed Pods Frameworks";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-ReactNativeAlarm/Pods-ReactNativeAlarm-frameworks-${CONFIGURATION}-output-files.xcfilelist",
 			);
+			outputPaths = (
+			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-ReactNativeAlarm/Pods-ReactNativeAlarm-frameworks.sh\"\n";
@@ -262,10 +266,14 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-ReactNativeAlarm/Pods-ReactNativeAlarm-resources-${CONFIGURATION}-input-files.xcfilelist",
 			);
+			inputPaths = (
+			);
 			name = "[CP] Copy Pods Resources";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-ReactNativeAlarm/Pods-ReactNativeAlarm-resources-${CONFIGURATION}-output-files.xcfilelist",
 			);
+			outputPaths = (
+			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-ReactNativeAlarm/Pods-ReactNativeAlarm-resources.sh\"\n";

package/ios/alarm/AlarmData.swift

@@ -7,6 +7,7 @@ struct AlarmData: Codable {
   var timestamp: Double // ms since epoch
   var title: String
   var body: String
+  var image: String? = nil
   var sound: String
   var vibrate: Bool
   var snoozeEnabled: Bool
@@ -16,11 +17,25 @@ struct AlarmData: Codable {
   var intervalMs: Double
   var data: String
   var enabled: Bool = true
-
+  var componentName: String = "AlarmRing"
+  var componentPropsJSON: String = "{}"
+  
   static func now() -> Double { Date().timeIntervalSince1970 * 1000 }
-
+  
   var date: Date { Date(timeIntervalSince1970: timestamp / 1000) }
 
+   var componentProps: [String: Any] {
+        guard
+            let jsonData = componentPropsJSON.data(using: .utf8),
+            let object = try? JSONSerialization.jsonObject(with: jsonData),
+            let props = object as? [String: Any]
+        else {
+            return [:]
+        }
+
+        return props
+    }
+  
   /// Next time this alarm should ring, in ms since epoch, or 0 if never.
   func nextTrigger(from: Double = AlarmData.now()) -> Double {
     if !enabled { return 0 }
@@ -37,7 +52,7 @@ struct AlarmData: Codable {
       return timestamp > from ? timestamp : 0
     }
   }
-
+  
   private func nextMatching(from: Double, ok: (Int) -> Bool) -> Double {
     let cal = Calendar.current
     let base = cal.dateComponents([.hour, .minute], from: date)
@@ -55,15 +70,16 @@ struct AlarmData: Codable {
     }
     return 0
   }
-
+  
   // MARK: - JS bridge shape (same keys as Android)
-
+  
   func toDictionary() -> [String: Any] {
     [
       "alarmId": id,
       "timestamp": timestamp,
       "title": title,
       "body": body,
+      "image": image ?? "",
       "sound": sound,
       "vibrate": vibrate,
       "snoozeEnabled": snoozeEnabled,
@@ -74,7 +90,7 @@ struct AlarmData: Codable {
       "nextTriggerAt": nextTrigger(),
     ]
   }
-
+  
   /// Parses the `AlarmConfig` object JS passes to `scheduleAlarm` / `updateAlarm`.
   static func from(config m: [String: Any], id: String) -> AlarmData {
     let r = m["repeat"] as? [String: Any]
@@ -83,6 +99,7 @@ struct AlarmData: Codable {
       timestamp: (m["timestamp"] as? NSNumber)?.doubleValue ?? 0,
       title: m["title"] as? String ?? "",
       body: m["body"] as? String ?? "",
+      image: m["image"] as? String,
       sound: m["sound"] as? String ?? "default",
       vibrate: (m["vibrate"] as? NSNumber)?.boolValue ?? true,
       snoozeEnabled: (m["snoozeEnabled"] as? NSNumber)?.boolValue ?? true,

package/ios/alarm/AlarmKitBackend.swift

@@ -20,13 +20,13 @@ struct OpenAlarmAppIntent: LiveActivityIntent {
   static let description = IntentDescription("Opens the ringing alarm's screen")
   static let openAppWhenRun: Bool = true
   static let isDiscoverable: Bool = false
-
+  
   @Parameter(title: "alarmID")
   var alarmID: String
-
+  
   init() {}
   init(alarmID: String) { self.alarmID = alarmID }
-
+  
   func perform() async throws -> some IntentResult {
     AlarmKitBackend.shared.openFromAlert(alarmID)
     return .result()
@@ -39,11 +39,11 @@ struct OpenAlarmAppIntent: LiveActivityIntent {
 @available(iOS 26.0, *)
 final class AlarmKitBackend {
   static let shared = AlarmKitBackend()
-
+  
   private let manager = AlarmManager.shared
   /// Wired by `AlarmModule` so native events reach JS.
   var onEvent: ((String, AlarmData) -> Void)?
-
+  
   private var observer: Task<Void, Never>?
   private var lastStates: [UUID: Alarm.State] = [:]
   /// Alarms we are stopping as part of a programmatic snooze (so the observer
@@ -53,15 +53,15 @@ final class AlarmKitBackend {
   /// (with its own TTS) is showing. The ring session stays alive until JS calls
   /// stop/snooze, so the observer must not report these as dismissed.
   private var silenced: [UUID: AlarmData] = [:]
-
+  
   private static let allWeekdays: [Locale.Weekday] = [
     .sunday, .monday, .tuesday, .wednesday, .thursday, .friday, .saturday,
   ]
-
+  
   // MARK: - Authorization
-
+  
   var isAuthorized: Bool { manager.authorizationState == .authorized }
-
+  
   /// 'granted' | 'denied' | 'notDetermined', same vocabulary as Android.
   var status: String {
     switch manager.authorizationState {
@@ -70,13 +70,13 @@ final class AlarmKitBackend {
     default: return "notDetermined"
     }
   }
-
+  
   func requestAuthorization() async -> Bool {
     (try? await manager.requestAuthorization()) == .authorized
   }
-
+  
   // MARK: - Ids
-
+  
   /// Android ids are free-form strings; AlarmKit wants UUIDs. Real UUIDs pass through,
   /// anything else is hashed deterministically so cancel/stop can find it again.
   static func uuid(for id: String, snooze: Bool = false) -> UUID {
@@ -85,20 +85,20 @@ final class AlarmKitBackend {
     let bytes = Array(SHA256.hash(data: Data(key.utf8)).prefix(16))
     return bytes.withUnsafeBufferPointer { NSUUID(uuidBytes: $0.baseAddress!) as UUID }
   }
-
+  
   private func stored(for uuid: UUID) -> AlarmData? {
     AlarmStore.all().first {
       Self.uuid(for: $0.id) == uuid || Self.uuid(for: $0.id, snooze: true) == uuid
     }
   }
-
+  
   // MARK: - Scheduling
-
+  
   func schedule(_ a: AlarmData) async throws {
     cancel(a.id)
     let next = a.nextTrigger()
     guard next > 0 else { return } // nothing in the future; Android skips too
-
+    
     let hm = Calendar.current.dateComponents([.hour, .minute], from: a.date)
     let time = Alarm.Schedule.Relative.Time(hour: hm.hour ?? 0, minute: hm.minute ?? 0)
     let schedule: Alarm.Schedule
@@ -107,21 +107,21 @@ final class AlarmKitBackend {
       schedule = .relative(.init(time: time, repeats: .weekly(Self.allWeekdays)))
     case "weekly":
       let days = a.weekdays.isEmpty
-        ? Self.allWeekdays
-        : a.weekdays.filter { (1...7).contains($0) }.map { Self.allWeekdays[$0 - 1] }
+      ? Self.allWeekdays
+      : a.weekdays.filter { (1...7).contains($0) }.map { Self.allWeekdays[$0 - 1] }
       schedule = .relative(.init(time: time, repeats: .weekly(days)))
     default:
       // none: one exact ring. interval: one exact ring, re-armed by the observer
       // after it is dismissed (only while the app process is alive).
       schedule = .fixed(Date(timeIntervalSince1970: next / 1000))
     }
-
+    
     _ = try await manager.schedule(id: Self.uuid(for: a.id), configuration: configuration(for: a, schedule: schedule))
     startObserving()
   }
-
+  
   private func configuration(for a: AlarmData, schedule: Alarm.Schedule)
-    -> AlarmManager.AlarmConfiguration<RNAlarmMetadata>
+  -> AlarmManager.AlarmConfiguration<RNAlarmMetadata>
   {
     let title = LocalizedStringResource(stringLiteral: a.title.isEmpty ? "Alarm" : a.title)
     let stop = AlarmButton(text: "Stop", textColor: .white, systemImageName: "stop.fill")
@@ -132,15 +132,15 @@ final class AlarmKitBackend {
     let alert = AlarmPresentation.Alert(
       title: title, stopButton: stop, secondaryButton: open, secondaryButtonBehavior: .custom
     )
-
+    
     let attributes = AlarmAttributes<RNAlarmMetadata>(
       presentation: AlarmPresentation(alert: alert),
       metadata: RNAlarmMetadata(),
       tintColor: .blue
     )
     let sound: AlertConfiguration.AlertSound =
-      (a.sound.isEmpty || a.sound == "default") ? .default : .named(a.sound)
-
+    (a.sound.isEmpty || a.sound == "default") ? .default : .named(a.sound)
+    
     return AlarmManager.AlarmConfiguration(
       schedule: schedule,
       attributes: attributes,
@@ -148,18 +148,18 @@ final class AlarmKitBackend {
       sound: sound
     )
   }
-
+  
   func cancel(_ id: String) {
     for uuid in [Self.uuid(for: id), Self.uuid(for: id, snooze: true)] {
       try? manager.cancel(id: uuid)
       silenced.removeValue(forKey: uuid)
     }
   }
-
+  
   func cancelAll() {
     for alarm in (try? manager.alarms) ?? [] { try? manager.cancel(id: alarm.id) }
   }
-
+  
   func stop(_ id: String) {
     for uuid in [Self.uuid(for: id), Self.uuid(for: id, snooze: true)] {
       try? manager.stop(id: uuid)
@@ -171,7 +171,7 @@ final class AlarmKitBackend {
       }
     }
   }
-
+  
   /// "Open" tapped on the system alert (OpenAlarmAppIntent). The tap stops the
   /// AlarmKit alarm, so adopt the session as `silenced` — still ringing as far as
   /// JS is concerned — and show the React ring screen once the app is frontmost.
@@ -179,7 +179,7 @@ final class AlarmKitBackend {
     guard let a = AlarmStore.get(id) else { return }
     let current = (try? manager.alarms) ?? []
     for uuid in [Self.uuid(for: a.id), Self.uuid(for: a.id, snooze: true)]
-    where current.contains(where: { $0.id == uuid && $0.state == .alerting }) {
+          where current.contains(where: { $0.id == uuid && $0.state == .alerting }) {
       silenced[uuid] = a
       try? manager.stop(id: uuid)
     }
@@ -187,20 +187,23 @@ final class AlarmKitBackend {
     if !silenced.values.contains(where: { $0.id == a.id }) {
       silenced[Self.uuid(for: a.id)] = a
     }
-    DispatchQueue.main.async { AlarmRingPresenter.present(a, bridge: nil) }
+    DispatchQueue.main.async { AlarmRingPresenter.present(a, bridge: nil,
+                                                          componentName: a.componentName,
+                                                          componentProps: a.componentProps
+    ) }
   }
-
+  
   /// Stops the system alert's sound/UI while the in-app ring screen takes over.
   /// The session stays "ringing" (see `silenced`) until JS stops or snoozes it.
   func silence(_ id: String) {
     let current = (try? manager.alarms) ?? []
     for uuid in [Self.uuid(for: id), Self.uuid(for: id, snooze: true)]
-    where current.contains(where: { $0.id == uuid && $0.state == .alerting }) {
+          where current.contains(where: { $0.id == uuid && $0.state == .alerting }) {
       silenced[uuid] = stored(for: uuid)
       try? manager.stop(id: uuid)
     }
   }
-
+  
   /// Silences the ringing alarm (if any) and re-rings once in `minutes`,
   /// equivalent to Android's `AlarmScheduler.scheduleSnooze`.
   func snooze(_ a: AlarmData, minutes: Int) async throws {
@@ -222,7 +225,7 @@ final class AlarmKitBackend {
     )
     startObserving()
   }
-
+  
   func ringingAlarm() -> AlarmData? {
     if let alerting = ((try? manager.alarms) ?? []).first(where: { $0.state == .alerting }) {
       return stored(for: alerting.id)
@@ -230,9 +233,9 @@ final class AlarmKitBackend {
     // Sound silenced for the in-app ring screen, but the session is still live.
     return silenced.values.first
   }
-
+  
   // MARK: - Events
-
+  
   /// Translates AlarmKit state changes into the Android-style events.
   func startObserving() {
     guard observer == nil else { return }
@@ -243,11 +246,11 @@ final class AlarmKitBackend {
       }
     }
   }
-
+  
   private func handle(_ alarms: [Alarm]) {
     var states: [UUID: Alarm.State] = [:]
     for alarm in alarms { states[alarm.id] = alarm.state }
-
+    
     for (uuid, state) in states where lastStates[uuid] != state {
       guard let a = stored(for: uuid) else { continue }
       if state == .alerting {
@@ -258,7 +261,7 @@ final class AlarmKitBackend {
         onEvent?(state == .countdown ? AlarmModule.eventSnoozed : AlarmModule.eventDismissed, a)
       }
     }
-
+    
     // One-off (`.fixed`) alarms disappear once stopped.
     for (uuid, previous) in lastStates where states[uuid] == nil && previous == .alerting {
       if silenced[uuid] != nil { continue } // silenced for the ring screen, not over yet
@@ -272,7 +275,7 @@ final class AlarmKitBackend {
         }
       }
     }
-
+    
     lastStates = states
   }
 }