react-native-alarms 0.0.0-stage → 0.0.1

package/.bundle/config

@@ -0,0 +1,2 @@
+BUNDLE_PATH: "vendor/bundle"
+BUNDLE_FORCE_RUBY_PLATFORM: 1

package/.eslintrc.js

@@ -0,0 +1,4 @@
+module.exports = {
+  root: true,
+  extends: '@react-native',
+};

package/.prettierrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+  arrowParens: 'avoid',
+  singleQuote: true,
+  trailingComma: 'all',
+};

package/.watchmanconfig

@@ -0,0 +1 @@
+{}

package/AlarmDemo.tsx

@@ -0,0 +1,223 @@
+import React, { useCallback, useEffect, useState } from 'react';
+import {
+  View,
+  Text,
+  TouchableOpacity,
+  StyleSheet,
+  Alert,
+  AppState,
+  NativeEventEmitter,
+  NativeModules,
+  Platform,
+} from 'react-native';
+import type { AlarmEvent, AlarmPermission } from './specs/NativeAlarm';
+
+// Same module name and API on Android (AlarmModule.kt) and iOS (AlarmModule.swift).
+const { Alarm } = NativeModules;
+console.log(
+  '[AlarmDemo] NativeModules.Alarm =',
+  Alarm,
+  Object.keys(Alarm ?? {}),
+);
+
+// Guard: creating an emitter with an undefined module crashes the app
+const alarmEmitter = Alarm ? new NativeEventEmitter(Alarm) : null;
+
+const pad = (n: number) => n.toString().padStart(2, '0');
+
+export function AlarmDemo() {
+  const [perms, setPerms] = useState<AlarmPermission | null>(null);
+
+  const refreshPermissions = useCallback(async () => {
+    if (!Alarm) return;
+    try {
+      setPerms(await Alarm.checkPermission());
+    } catch {}
+  }, []);
+
+  useEffect(() => {
+    refreshPermissions();
+    // Re-check when coming back from a settings screen.
+    const sub = AppState.addEventListener('change', s => {
+      if (s === 'active') refreshPermissions();
+    });
+    return () => sub.remove();
+  }, [refreshPermissions]);
+
+  useEffect(() => {
+    if (!alarmEmitter) return;
+
+    const subscriptions = [
+      alarmEmitter.addListener('onAlarmFired', data => {
+        console.log('Alarm fired', (data as AlarmEvent)?.alarmId);
+      }),
+      alarmEmitter.addListener('onAlarmDismissed', data => {
+        console.log('Alarm dismissed', (data as AlarmEvent)?.alarmId);
+      }),
+      alarmEmitter.addListener('onAlarmSnoozed', data => {
+        console.log('Alarm snoozed', (data as AlarmEvent)?.alarmId);
+      }),
+    ];
+
+    return () => subscriptions.forEach(sub => sub.remove());
+  }, []);
+
+  const requestPermissions = async () => {
+    if (!Alarm) return;
+    try {
+      setPerms(await Alarm.requestPermission());
+    } catch (error: any) {
+      Alert.alert('Error', error?.message || 'Permission request failed');
+    }
+  };
+
+  const openAutoStart = async () => {
+    if (!Alarm) return;
+    try {
+      const opened = await Alarm.openAutoStartSettings();
+      if (!opened) {
+        Alert.alert(
+          'Not needed',
+          'This device has no vendor Autostart screen; nothing to change.',
+        );
+      }
+    } catch {}
+  };
+
+  const isAndroid = Platform.OS === 'android';
+
+  const allGranted =
+    !!perms &&
+    perms.notifications &&
+    perms.canScheduleExact &&
+    (!isAndroid || (perms.canDrawOverlays && perms.canUseFullScreenIntent));
+
+  const scheduleInOneMinute = async () => {
+    if (!Alarm) {
+      Alert.alert('Error', 'Alarm native module is not linked');
+      return;
+    }
+
+    try {
+      const alarmTime = new Date(Date.now() + 30 * 1000);
+      const label = `${pad(alarmTime.getHours())}:${pad(
+        alarmTime.getMinutes(),
+      )}`;
+
+      const alarmId = await Alarm.scheduleAlarm({
+        alarmId: `alarm_${Date.now()}`,
+        timestamp: alarmTime.getTime(),
+        enabled: true,
+        repeat: { type: 'none' },
+        title: `Alarm at ${label}`,
+        body: 'Test Alarm',
+        data: 'Test Alarm',
+        vibrate: true,
+        sound: 'default',
+        snoozeEnabled: true,
+        snoozeMinutes: 1,
+      });
+
+      Alert.alert('Alarm set', `Rings at ${label} (ID: ${alarmId})`);
+    } catch (error: any) {
+      Alert.alert('Error', error?.message || 'Failed to schedule alarm');
+    }
+  };
+
+  return (
+    <View style={styles.container}>
+      {perms && !allGranted ? (
+        <View style={styles.permBox}>
+          <Text style={styles.permTitle}>
+            Permissions needed to ring reliably
+          </Text>
+          {isAndroid ? (
+            <>
+              <Text style={styles.permLine}>
+                Notifications: {perms.notifications ? 'ok' : 'missing'}
+              </Text>
+              <Text style={styles.permLine}>
+                Exact alarms: {perms.canScheduleExact ? 'ok' : 'missing'}
+              </Text>
+              <Text style={styles.permLine}>
+                Display over other apps:{' '}
+                {perms.canDrawOverlays ? 'ok' : 'missing'}
+              </Text>
+              <Text style={styles.permLine}>
+                Full-screen intent:{' '}
+                {perms.canUseFullScreenIntent ? 'ok' : 'missing'}
+              </Text>
+            </>
+          ) : (
+            <Text style={styles.permLine}>
+              {perms.backend === 'alarmkit' ? 'Alarms' : 'Notifications'}:{' '}
+              {perms.status}
+            </Text>
+          )}
+          <TouchableOpacity
+            style={styles.permButton}
+            onPress={requestPermissions}
+          >
+            <Text style={styles.buttonText}>Grant next permission</Text>
+          </TouchableOpacity>
+        </View>
+      ) : null}
+
+      <TouchableOpacity style={styles.button} onPress={scheduleInOneMinute}>
+        <Text style={styles.buttonText}>Set alarm in 1 minute</Text>
+      </TouchableOpacity>
+
+      {isAndroid ? (
+        <TouchableOpacity style={styles.linkButton} onPress={openAutoStart}>
+          <Text style={styles.linkText}>
+            Xiaomi / Oppo / Vivo: enable Autostart for this app
+          </Text>
+        </TouchableOpacity>
+      ) : null}
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    justifyContent: 'center',
+    alignItems: 'center',
+    padding: 16,
+    backgroundColor: '#f5f5f5',
+  },
+  permBox: {
+    backgroundColor: '#FFF3E0',
+    borderRadius: 8,
+    padding: 16,
+    marginBottom: 24,
+    alignSelf: 'stretch',
+  },
+  permTitle: {
+    fontWeight: '600',
+    fontSize: 16,
+    marginBottom: 8,
+    color: '#333',
+  },
+  permLine: { color: '#555', marginBottom: 2 },
+  permButton: {
+    marginTop: 12,
+    backgroundColor: '#FB8C00',
+    paddingVertical: 12,
+    borderRadius: 8,
+    alignItems: 'center',
+  },
+  button: {
+    backgroundColor: '#007AFF',
+    paddingVertical: 14,
+    paddingHorizontal: 24,
+    borderRadius: 8,
+  },
+  buttonText: {
+    color: '#fff',
+    fontSize: 16,
+    fontWeight: '600',
+  },
+  linkButton: { marginTop: 20, padding: 8 },
+  linkText: { color: '#007AFF', textDecorationLine: 'underline' },
+});

package/AlarmRingScreen.tsx

@@ -0,0 +1,117 @@
+import React, { useEffect } from 'react';
+import {
+  BackHandler,
+  NativeModules,
+  StyleSheet,
+  Text,
+  TouchableOpacity,
+  View,
+} from 'react-native';
+
+const { Alarm } = NativeModules;
+
+/**
+ * Initial props come from the native AlarmRingActivity (AlarmData.toBundle()).
+ */
+type Props = {
+  alarmId?: string;
+  title?: string;
+  body?: string;
+  snoozeEnabled?: boolean;
+  snoozeMinutes?: number;
+  data?: string;
+};
+
+const pad = (n: number) => n.toString().padStart(2, '0');
+
+export function AlarmRingScreen({
+  alarmId = '',
+  title = 'Alarm',
+  body = '',
+  snoozeEnabled = true,
+  snoozeMinutes = 5,
+}: Props) {
+  // The only ways out are Stop and Snooze: swallow the back button.
+  useEffect(() => {
+    const sub = BackHandler.addEventListener('hardwareBackPress', () => true);
+    return () => sub.remove();
+  }, []);
+
+  const now = new Date();
+  const clock = `${pad(now.getHours())}:${pad(now.getMinutes())}`;
+
+  const stop = () => {
+    Alarm?.stopAlarm(alarmId).catch(() => {});
+  };
+
+  const snooze = () => {
+    Alarm?.snoozeAlarm(alarmId, snoozeMinutes).catch(() => {});
+  };
+
+  return (
+    <View style={styles.root}>
+      <Text style={styles.clock}>{clock}</Text>
+      <Text style={styles.title}>{title}</Text>
+      {body ? <Text style={styles.body}>{body}</Text> : null}
+
+      <View style={styles.actions}>
+        {snoozeEnabled ? (
+          <TouchableOpacity
+            style={[styles.button, styles.snooze]}
+            onPress={snooze}
+          >
+            <Text style={styles.buttonText}>Snooze {snoozeMinutes} min</Text>
+          </TouchableOpacity>
+        ) : null}
+        <TouchableOpacity style={[styles.button, styles.stop]} onPress={stop}>
+          <Text style={styles.buttonText}>Stop</Text>
+        </TouchableOpacity>
+      </View>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  root: {
+    flex: 1,
+    backgroundColor: '#0F1430',
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: 24,
+  },
+  clock: {
+    color: '#fff',
+    fontSize: 72,
+    fontWeight: '200',
+    marginBottom: 16,
+  },
+  title: {
+    color: '#fff',
+    fontSize: 26,
+    fontWeight: '600',
+    textAlign: 'center',
+  },
+  body: {
+    color: '#C5CAE9',
+    fontSize: 16,
+    marginTop: 8,
+    textAlign: 'center',
+  },
+  actions: {
+    position: 'absolute',
+    bottom: 48,
+    left: 24,
+    right: 24,
+    gap: 12,
+  },
+  button: {
+    paddingVertical: 18,
+    borderRadius: 14,
+    alignItems: 'center',
+  },
+  snooze: { backgroundColor: '#2E3560' },
+  stop: { backgroundColor: '#FF8F2E' },
+  buttonText: { color: '#fff', fontSize: 18, fontWeight: '600' },
+});
+
+export default AlarmRingScreen;

package/App.tsx

@@ -0,0 +1,14 @@
+import { StatusBar } from 'react-native';
+import { SafeAreaProvider } from 'react-native-safe-area-context';
+import { AlarmDemo } from './AlarmDemo';
+
+function App() {
+  return (
+    <SafeAreaProvider>
+      <StatusBar barStyle="dark-content" />
+      <AlarmDemo />
+    </SafeAreaProvider>
+  );
+}
+
+export default App;

package/Gemfile

@@ -0,0 +1,17 @@
+source 'https://rubygems.org'
+
+# You may use http://rbenv.org/ or https://rvm.io/ to install and use this version
+ruby ">= 2.6.10"
+
+# Exclude problematic versions of cocoapods and activesupport that causes build failures.
+gem 'cocoapods', '>= 1.13', '!= 1.15.0', '!= 1.15.1'
+gem 'activesupport', '>= 6.1.7.5', '!= 7.1.0'
+gem 'xcodeproj', '< 1.26.0'
+gem 'concurrent-ruby', '< 1.3.4'
+
+# Ruby 3.4.0 has removed some libraries from the standard library.
+gem 'bigdecimal'
+gem 'logger'
+gem 'benchmark'
+gem 'mutex_m'
+gem 'nkf'

package/Gemfile.lock

@@ -0,0 +1,114 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (3.0.9)
+    activesupport (6.1.7.10)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
+    algoliasearch (1.27.5)
+      httpclient (~> 2.8, >= 2.8.3)
+      json (>= 1.5.1)
+    atomos (0.1.3)
+    benchmark (0.5.0)
+    bigdecimal (4.1.3)
+    claide (1.1.0)
+    cocoapods (1.15.2)
+      addressable (~> 2.8)
+      claide (>= 1.0.2, < 2.0)
+      cocoapods-core (= 1.15.2)
+      cocoapods-deintegrate (>= 1.0.3, < 2.0)
+      cocoapods-downloader (>= 2.1, < 3.0)
+      cocoapods-plugins (>= 1.0.0, < 2.0)
+      cocoapods-search (>= 1.0.0, < 2.0)
+      cocoapods-trunk (>= 1.6.0, < 2.0)
+      cocoapods-try (>= 1.1.0, < 2.0)
+      colored2 (~> 3.1)
+      escape (~> 0.0.4)
+      fourflusher (>= 2.3.0, < 3.0)
+      gh_inspector (~> 1.0)
+      molinillo (~> 0.8.0)
+      nap (~> 1.0)
+      ruby-macho (>= 2.3.0, < 3.0)
+      xcodeproj (>= 1.23.0, < 2.0)
+    cocoapods-core (1.15.2)
+      activesupport (>= 5.0, < 8)
+      addressable (~> 2.8)
+      algoliasearch (~> 1.0)
+      concurrent-ruby (~> 1.1)
+      fuzzy_match (~> 2.0.4)
+      nap (~> 1.0)
+      netrc (~> 0.11)
+      public_suffix (~> 4.0)
+      typhoeus (~> 1.0)
+    cocoapods-deintegrate (1.0.5)
+    cocoapods-downloader (2.1)
+    cocoapods-plugins (1.0.0)
+      nap
+    cocoapods-search (1.0.1)
+    cocoapods-trunk (1.6.0)
+      nap (>= 0.8, < 2.0)
+      netrc (~> 0.11)
+    cocoapods-try (1.2.0)
+    colored2 (3.1.2)
+    concurrent-ruby (1.3.3)
+    escape (0.0.4)
+    ethon (0.18.0)
+      ffi (>= 1.15.0)
+      logger
+    ffi (1.17.4)
+    fourflusher (2.3.1)
+    fuzzy_match (2.0.4)
+    gh_inspector (1.1.3)
+    httpclient (2.9.0)
+      mutex_m
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
+    json (2.7.6)
+    logger (1.7.0)
+    minitest (5.25.4)
+    molinillo (0.8.0)
+    mutex_m (0.3.0)
+    nanaimo (0.3.0)
+    nap (1.1.0)
+    netrc (0.11.0)
+    nkf (0.3.0)
+    public_suffix (4.0.7)
+    rexml (3.4.4)
+    ruby-macho (2.5.1)
+    typhoeus (1.6.0)
+      ethon (>= 0.18.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    xcodeproj (1.25.1)
+      CFPropertyList (>= 2.3.3, < 4.0)
+      atomos (~> 0.1.3)
+      claide (>= 1.0.2, < 2.0)
+      colored2 (~> 3.1)
+      nanaimo (~> 0.3.0)
+      rexml (>= 3.3.6, < 4.0)
+    zeitwerk (2.6.18)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 6.1.7.5, != 7.1.0)
+  benchmark
+  bigdecimal
+  cocoapods (>= 1.13, != 1.15.1, != 1.15.0)
+  concurrent-ruby (< 1.3.4)
+  logger
+  mutex_m
+  nkf
+  xcodeproj (< 1.26.0)
+
+RUBY VERSION
+   ruby 2.6.10p210
+
+BUNDLED WITH
+   1.17.2

package/README.md

@@ -1,3 +1,97 @@
-# Temporary Holding Version
+This is a new [**React Native**](https://reactnative.dev) project, bootstrapped using [`@react-native-community/cli`](https://github.com/react-native-community/cli).
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Getting Started
+
+> **Note**: Make sure you have completed the [Set Up Your Environment](https://reactnative.dev/docs/set-up-your-environment) guide before proceeding.
+
+## Step 1: Start Metro
+
+First, you will need to run **Metro**, the JavaScript build tool for React Native.
+
+To start the Metro dev server, run the following command from the root of your React Native project:
+
+```sh
+# Using npm
+npm start
+
+# OR using Yarn
+yarn start
+```
+
+## Step 2: Build and run your app
+
+With Metro running, open a new terminal window/pane from the root of your React Native project, and use one of the following commands to build and run your Android or iOS app:
+
+### Android
+
+```sh
+# Using npm
+npm run android
+
+# OR using Yarn
+yarn android
+```
+
+### iOS
+
+For iOS, remember to install CocoaPods dependencies (this only needs to be run on first clone or after updating native deps).
+
+The first time you create a new project, run the Ruby bundler to install CocoaPods itself:
+
+```sh
+bundle install
+```
+
+Then, and every time you update your native dependencies, run:
+
+```sh
+bundle exec pod install
+```
+
+For more information, please visit [CocoaPods Getting Started guide](https://guides.cocoapods.org/using/getting-started.html).
+
+```sh
+# Using npm
+npm run ios
+
+# OR using Yarn
+yarn ios
+```
+
+If everything is set up correctly, you should see your new app running in the Android Emulator, iOS Simulator, or your connected device.
+
+This is one way to run your app — you can also build it directly from Android Studio or Xcode.
+
+## Step 3: Modify your app
+
+Now that you have successfully run the app, let's make changes!
+
+Open `App.tsx` in your text editor of choice and make some changes. When you save, your app will automatically update and reflect these changes — this is powered by [Fast Refresh](https://reactnative.dev/docs/fast-refresh).
+
+When you want to forcefully reload, for example to reset the state of your app, you can perform a full reload:
+
+- **Android**: Press the <kbd>R</kbd> key twice or select **"Reload"** from the **Dev Menu**, accessed via <kbd>Ctrl</kbd> + <kbd>M</kbd> (Windows/Linux) or <kbd>Cmd ⌘</kbd> + <kbd>M</kbd> (macOS).
+- **iOS**: Press <kbd>R</kbd> in iOS Simulator.
+
+## Congratulations! :tada:
+
+You've successfully run and modified your React Native App. :partying_face:
+
+### Now what?
+
+- If you want to add this new React Native code to an existing application, check out the [Integration guide](https://reactnative.dev/docs/integration-with-existing-apps).
+- If you're curious to learn more about React Native, check out the [docs](https://reactnative.dev/docs/getting-started).
+
+# Troubleshooting
+
+If you're having issues getting the above steps to work, see the [Troubleshooting](https://reactnative.dev/docs/troubleshooting) page.
+
+# Learn More
+
+To learn more about React Native, take a look at the following resources:
+
+- [React Native Website](https://reactnative.dev) - learn more about React Native.
+- [Getting Started](https://reactnative.dev/docs/environment-setup) - an **overview** of React Native and how setup your environment.
+- [Learn the Basics](https://reactnative.dev/docs/getting-started) - a **guided tour** of the React Native **basics**.
+- [Blog](https://reactnative.dev/blog) - read the latest official React Native **Blog** posts.
+- [`@facebook/react-native`](https://github.com/facebook/react-native) - the Open Source; GitHub **repository** for React Native.

package/__tests__/App.test.tsx

@@ -0,0 +1,13 @@
+/**
+ * @format
+ */
+
+import React from 'react';
+import ReactTestRenderer from 'react-test-renderer';
+import App from '../App';
+
+test('renders correctly', async () => {
+  await ReactTestRenderer.act(() => {
+    ReactTestRenderer.create(<App />);
+  });
+});