@zulfio/react-native-alarm-kit 1.0.0

package/Alarmkit.podspec

@@ -0,0 +1,35 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "AlarmKit"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/raphckrman/react-native-alarmkit.git", :tag => "#{s.version}" }
+
+
+  s.source_files = [
+    "ios/**/*.{swift}",
+    "ios/**/*.{m,mm}",
+    "cpp/**/*.{hpp,cpp}",
+  ]
+
+  s.pod_target_xcconfig = {
+    # C++ compiler flags, mainly for folly.
+    "GCC_PREPROCESSOR_DEFINITIONS" => "$(inherited) FOLLY_NO_CONFIG FOLLY_CFG_NO_COROUTINES"
+  }
+
+  s.dependency 'React-jsi'
+  s.dependency 'React-callinvoker'
+
+  load 'nitrogen/generated/ios/AlarmKit+autolinking.rb'
+  add_nitrogen_files(s)
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 raphckrman
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,163 @@
+For testing only, Fork of @raphckrman/react-native-alarm-kit.
+
+# 📱 react-native-alarmkit
+
+> [!WARNING]
+> This library is still under development. Use at your own risk.
+
+This library provides a simple and modern interface for working with alarms in your React Native app using Apple's latest AlarmKit framework (requires **iOS 26.0+**).
+
+## ⚙️ Installation
+
+### React Native
+> [!NOTE]
+> `react-native-nitro-modules` is required because this library leverages [Nitro Modules](https://nitro.margelo.com/).
+```sh
+npm install @raphckrman/react-native-alarm-kit react-native-nitro-modules
+```
+
+### Expo
+```sh
+npx expo add @raphckrman/react-native-alarm-kit react-native-nitro-modules
+npx expo prebuild
+```
+
+## 🚀 Usage
+
+### Permissions
+
+```js
+import { requestAlarmPermission } from '@raphckrman/react-native-alarm-kit';
+
+const granted = await requestAlarmPermission();
+```
+
+### Schedule a Fixed Alarm (one-time, by timestamp)
+
+```js
+import {
+  createAlarmButton,
+  scheduleFixedAlarm,
+} from '@raphckrman/react-native-alarm-kit';
+
+const stopBtn = await createAlarmButton('Stop', '#FF0000', 'stop.circle');
+const secondBtn = await createAlarmButton('Repeat', '#000000', 'play.circle');
+
+// Trigger at a specific Unix timestamp
+const timestamp = Date.now() / 1000 + 60; // 60 seconds from now
+const alarmId = await scheduleFixedAlarm('Morning Alarm', stopBtn, '#FFFFFF', secondBtn, timestamp);
+```
+
+### Schedule a Fixed Alarm (timer/countdown)
+
+```js
+import {
+  createAlarmButton,
+  createAlarmCountdown,
+  scheduleFixedAlarm,
+} from '@raphckrman/react-native-alarm-kit';
+
+const stopBtn = await createAlarmButton('Stop', '#FF0000', 'stop.circle');
+const countdown = await createAlarmCountdown(3, 15); // preAlert: 3s, postAlert: 15s
+
+// Triggers in 3 seconds, repeats after 15 seconds
+const alarmId = await scheduleFixedAlarm('Timer', stopBtn, '#FFFFFF', undefined, undefined, countdown);
+```
+
+### Schedule a Relative Alarm (recurring, by time of day)
+
+```js
+import {
+  createAlarmButton,
+  scheduleRelativeAlarm,
+} from '@raphckrman/react-native-alarm-kit';
+
+const stopBtn = await createAlarmButton('Stop', '#FF0000', 'stop.circle');
+
+// Triggers at 10:00 every Monday, Thursday, and Friday
+const alarmId = await scheduleRelativeAlarm(
+  'Daily Standup',
+  stopBtn,
+  '#FFFFFF',
+  10,       // hour
+  0,        // minute
+  ['monday', 'thursday', 'friday']
+);
+```
+
+Both schedule functions return a `string` — the alarm's UUID — which you should persist to cancel or query the alarm later.
+
+### Cancel an Alarm
+
+```js
+import { cancelAlarm } from '@raphckrman/react-native-alarm-kit';
+
+const success = await cancelAlarm(alarmId);
+```
+
+### Cancel All Alarms
+
+```js
+import { cancelAllAlarms } from '@raphckrman/react-native-alarm-kit';
+
+const success = await cancelAllAlarms();
+```
+
+### Get a Single Alarm
+
+Returns the alarm's current state (`"scheduled"`, `"ringing"`, `"snoozed"`, `"unknown"`), or `null` if no alarm with that ID exists.
+
+```js
+import { getAlarm } from '@raphckrman/react-native-alarm-kit';
+
+const state = await getAlarm(alarmId);
+// "scheduled" | "ringing" | "snoozed" | "unknown" | null
+```
+
+### Get All Alarms
+
+Returns an array of UUID strings for every alarm currently tracked by the system.
+
+```js
+import { getAllAlarms } from '@raphckrman/react-native-alarm-kit';
+
+const ids = await getAllAlarms();
+// ["uuid-1", "uuid-2", ...]
+```
+
+## 📖 API Reference
+
+### `requestAlarmPermission(): Promise<boolean>`
+Requests authorization to schedule alarms. Returns `true` if granted.
+
+### `scheduleFixedAlarm(title, stopBtn, tintColor, secondaryBtn?, timestamp?, countdown?): Promise<string>`
+Schedules a one-time alarm at a fixed date/time or as a countdown timer. Either `timestamp` (Unix seconds) or `countdown` must be provided. Returns the alarm UUID.
+
+### `scheduleRelativeAlarm(title, stopBtn, tintColor, hour, minute, repeats, secondaryBtn?, countdown?): Promise<string>`
+Schedules a recurring alarm at a specific time of day on the given weekdays. Returns the alarm UUID.
+
+### `cancelAlarm(id: string): Promise<boolean>`
+Cancels a scheduled alarm by its UUID. Returns `true` on success.
+
+### `cancelAllAlarms(): Promise<boolean>`
+Cancels every scheduled alarm tracked by `AlarmManager`. Returns `true` on success.
+
+### `getAlarm(id: string): Promise<string | null>`
+Returns the state of an alarm (`"scheduled"`, `"ringing"`, `"snoozed"`, `"unknown"`), or `null` if not found.
+
+### `getAllAlarms(): Promise<string[]>`
+Returns the UUIDs of all alarms currently tracked by `AlarmManager`.
+
+### `createAlarmButton(text, textColor, icon): Promise<CustomizableAlarmButton>`
+Helper to build a `CustomizableAlarmButton` object. `icon` is an SF Symbol name (e.g. `"stop.circle"`).
+
+### `createAlarmCountdown(preAlert, postAlert): Promise<AlarmCountdown>`
+Helper to build an `AlarmCountdown` object. Both values are in seconds.
+
+## 🤝 Contributing
+
+We welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md) to learn how to get started, report issues, or suggest improvements.
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE.md).

package/android/CMakeLists.txt

@@ -0,0 +1,24 @@
+project(alarmkit)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(PACKAGE_NAME alarmkit)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+# Define C++ library and add all sources
+add_library(${PACKAGE_NAME} SHARED src/main/cpp/cpp-adapter.cpp)
+
+# Add Nitrogen specs :)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/alarmkit+autolinking.cmake)
+
+# Set up local includes
+include_directories("src/main/cpp" "../cpp")
+
+find_library(LOG_LIB log)
+
+# Link all libraries together
+target_link_libraries(
+        ${PACKAGE_NAME}
+        ${LOG_LIB}
+        android # <-- Android core
+)

package/android/build.gradle

@@ -0,0 +1,129 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['AlarmKit_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+apply from: '../nitrogen/generated/android/alarmkit+autolinking.gradle'
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["AlarmKit_" + name]).toInteger()
+}
+
+android {
+  namespace "com.margelo.nitro.alarmkit"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+
+        buildTypes {
+          debug {
+            cppFlags "-O1 -g"
+          }
+          release {
+            cppFlags "-O2"
+          }
+        }
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  packagingOptions {
+    excludes = [
+            "META-INF",
+            "META-INF/**",
+            "**/libc++_shared.so",
+            "**/libfbjni.so",
+            "**/libjsi.so",
+            "**/libfolly_json.so",
+            "**/libfolly_runtime.so",
+            "**/libglog.so",
+            "**/libhermes.so",
+            "**/libhermes-executor-debug.so",
+            "**/libhermes_executor.so",
+            "**/libreactnative.so",
+            "**/libreactnativejni.so",
+            "**/libturbomodulejsijni.so",
+            "**/libreact_nativemodule_core.so",
+            "**/libjscexecutor.so"
+    ]
+  }
+
+  buildFeatures {
+    buildConfig true
+    prefab true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation project(":react-native-nitro-modules")
+}
+

package/android/gradle.properties

@@ -0,0 +1,5 @@
+AlarmKit_kotlinVersion=2.0.21
+AlarmKit_minSdkVersion=24
+AlarmKit_targetSdkVersion=34
+AlarmKit_compileSdkVersion=35
+AlarmKit_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,6 @@
+#include <jni.h>
+#include "alarmkitOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return margelo::nitro::alarmkit::initialize(vm);
+}

package/android/src/main/java/com/alarmkit/AlarmkitPackage.kt

@@ -0,0 +1,22 @@
+package com.alarmkit
+
+import com.facebook.react.TurboReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfoProvider
+
+class AlarmKitPackage : TurboReactPackage() {
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+        return null
+    }
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+        return ReactModuleInfoProvider { HashMap() }
+    }
+
+    companion object {
+        init {
+            System.loadLibrary("alarmkit")
+        }
+    }
+}

package/android/src/main/java/com/margelo/nitro/alarmkit/Alarmkit.kt

@@ -0,0 +1,7 @@
+package com.margelo.nitro.alarmkit
+  
+import com.facebook.proguard.annotations.DoNotStrip
+
+@DoNotStrip
+class AlarmKit : HybridAlarmKitSpec() {
+}