@capgo/capacitor-alarm 7.0.0

package/CapgoCapacitorAlarm.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapgoCapacitorAlarm'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '14.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapgoCapacitorAlarm",
+    platforms: [.iOS(.v14)],
+    products: [
+        .library(
+            name: "CapgoCapacitorAlarm",
+            targets: ["CapgoAlarmPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "7.0.0")
+    ],
+    targets: [
+        .target(
+            name: "CapgoAlarmPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/CapgoAlarmPlugin"),
+        .testTarget(
+            name: "CapgoAlarmPluginTests",
+            dependencies: ["CapgoAlarmPlugin"],
+            path: "ios/Tests/CapgoAlarmPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,159 @@
+# @capgo/capacitor-alarm
+ <a href="https://capgo.app/"><img src='https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png' alt='Capgo - Instant updates for capacitor'/></a>
+
+<div align="center">
+  <h2><a href="https://capgo.app/?ref=plugin"> ➡️ Get Instant updates for your App with Capgo</a></h2>
+  <h2><a href="https://capgo.app/consulting/?ref=plugin"> Missing a feature? We’ll build the plugin for you 💪</a></h2>
+</div>
+
+Manage native alarm Capacitor plugin
+
+## Install
+
+```bash
+npm install @capgo/capacitor-alarm
+npx cap sync
+```
+
+## Requirements
+
+- iOS: iOS 26+ only. This plugin relies on AlarmKit APIs and will report unsupported on earlier versions or when the framework is unavailable.
+- Android: Uses `AlarmClock` intents; behavior depends on the default Clock app and OEM policies.
+
+Note: This plugin only exposes native alarm actions (create/open). It does not implement any custom in-app alarm scheduling/CRUD.
+
+## API
+
+<docgen-index>
+
+* [`createAlarm(...)`](#createalarm)
+* [`openAlarms()`](#openalarms)
+* [`getOSInfo()`](#getosinfo)
+* [`requestPermissions(...)`](#requestpermissions)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### createAlarm(...)
+
+```typescript
+createAlarm(options: NativeAlarmCreateOptions) => Promise<NativeActionResult>
+```
+
+Create a native OS alarm using the platform clock app.
+On Android this uses the Alarm Clock intent; on iOS this is not supported.
+
+| Param         | Type                                                                          |
+| ------------- | ----------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#nativealarmcreateoptions">NativeAlarmCreateOptions</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#nativeactionresult">NativeActionResult</a>&gt;</code>
+
+--------------------
+
+
+### openAlarms()
+
+```typescript
+openAlarms() => Promise<NativeActionResult>
+```
+
+Open the platform's native alarm list UI, if available.
+
+**Returns:** <code>Promise&lt;<a href="#nativeactionresult">NativeActionResult</a>&gt;</code>
+
+--------------------
+
+
+### getOSInfo()
+
+```typescript
+getOSInfo() => Promise<OSInfo>
+```
+
+Get information about the OS and capabilities.
+
+**Returns:** <code>Promise&lt;<a href="#osinfo">OSInfo</a>&gt;</code>
+
+--------------------
+
+
+### requestPermissions(...)
+
+```typescript
+requestPermissions(options?: { exactAlarm?: boolean | undefined; } | undefined) => Promise<PermissionResult>
+```
+
+Request relevant permissions for alarm usage on the platform.
+On Android, may route to settings for exact alarms.
+
+| Param         | Type                                   |
+| ------------- | -------------------------------------- |
+| **`options`** | <code>{ exactAlarm?: boolean; }</code> |
+
+**Returns:** <code>Promise&lt;<a href="#permissionresult">PermissionResult</a>&gt;</code>
+
+--------------------
+
+
+### Interfaces
+
+
+#### NativeActionResult
+
+| Prop          | Type                 |
+| ------------- | -------------------- |
+| **`success`** | <code>boolean</code> |
+| **`message`** | <code>string</code>  |
+
+
+#### NativeAlarmCreateOptions
+
+Options for creating a native OS alarm via the platform clock app.
+
+| Prop          | Type                 | Description                                  |
+| ------------- | -------------------- | -------------------------------------------- |
+| **`hour`**    | <code>number</code>  | Hour of day in 24h format (0-23)             |
+| **`minute`**  | <code>number</code>  | Minute of hour (0-59)                        |
+| **`label`**   | <code>string</code>  | Optional label for the alarm                 |
+| **`skipUi`**  | <code>boolean</code> | Android only: attempt to skip UI if possible |
+| **`vibrate`** | <code>boolean</code> | Android only: set alarm to vibrate           |
+
+
+#### OSInfo
+
+Returned info about current OS and capabilities.
+
+| Prop                                 | Type                 | Description                                                 |
+| ------------------------------------ | -------------------- | ----------------------------------------------------------- |
+| **`platform`**                       | <code>string</code>  | 'ios' \| 'android' \| 'web'                                 |
+| **`version`**                        | <code>string</code>  | OS version string                                           |
+| **`supportsNativeAlarms`**           | <code>boolean</code> | Whether the platform exposes a native alarm app integration |
+| **`supportsScheduledNotifications`** | <code>boolean</code> | Whether scheduling local notifications is supported         |
+| **`canScheduleExactAlarms`**         | <code>boolean</code> | Android only: whether exact alarms are allowed              |
+
+
+#### PermissionResult
+
+Result of a permissions request.
+
+| Prop          | Type                                                             | Description                        |
+| ------------- | ---------------------------------------------------------------- | ---------------------------------- |
+| **`granted`** | <code>boolean</code>                                             | Overall grant for requested scope  |
+| **`details`** | <code><a href="#record">Record</a>&lt;string, boolean&gt;</code> | Optional details by permission key |
+
+
+### Type Aliases
+
+
+#### Record
+
+Construct a type with a set of properties K of type T
+
+<code>{
 [P in K]: T;
 }</code>
+
+</docgen-api>

package/android/build.gradle

@@ -0,0 +1,58 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.7.2'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace "app.capgo.capacitor.alarm"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

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/java/app/capgo/capacitor/alarm/CapgoAlarmPlugin.java

@@ -0,0 +1,107 @@
+package app.capgo.capacitor.alarm;
+
+import android.app.AlarmManager;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Build;
+import android.provider.AlarmClock;
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+
+@CapacitorPlugin(name = "CapgoAlarm")
+public class CapgoAlarmPlugin extends Plugin {
+
+    // ===== Native OS Alarm helpers (Android) =====
+    @PluginMethod
+    public void createAlarm(PluginCall call) {
+        Integer hour = call.getInt("hour");
+        Integer minute = call.getInt("minute");
+        if (hour == null || minute == null) {
+            call.reject("hour and minute are required");
+            return;
+        }
+        String label = call.getString("label");
+        boolean skipUi = call.getBoolean("skipUi", false);
+        boolean vibrate = call.getBoolean("vibrate", false);
+
+        Intent intent = new Intent(AlarmClock.ACTION_SET_ALARM)
+            .putExtra(AlarmClock.EXTRA_HOUR, hour)
+            .putExtra(AlarmClock.EXTRA_MINUTES, minute)
+            .putExtra(AlarmClock.EXTRA_VIBRATE, vibrate);
+        if (label != null) intent.putExtra(AlarmClock.EXTRA_MESSAGE, label);
+        if (skipUi) intent.putExtra(AlarmClock.EXTRA_SKIP_UI, true);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+
+        try {
+            getContext().startActivity(intent);
+            JSObject ret = new JSObject();
+            ret.put("success", true);
+            call.resolve(ret);
+        } catch (Exception e) {
+            JSObject ret = new JSObject();
+            ret.put("success", false);
+            ret.put("message", e.getMessage());
+            call.resolve(ret);
+        }
+    }
+
+    @PluginMethod
+    public void openAlarms(PluginCall call) {
+        Intent intent = new Intent(AlarmClock.ACTION_SHOW_ALARMS);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        try {
+            getContext().startActivity(intent);
+            JSObject ret = new JSObject();
+            ret.put("success", true);
+            call.resolve(ret);
+        } catch (Exception e) {
+            JSObject ret = new JSObject();
+            ret.put("success", false);
+            ret.put("message", e.getMessage());
+            call.resolve(ret);
+        }
+    }
+
+    @PluginMethod
+    public void getOSInfo(PluginCall call) {
+        JSObject ret = new JSObject();
+        ret.put("platform", "android");
+        ret.put("version", Build.VERSION.RELEASE);
+        ret.put("supportsNativeAlarms", true);
+        ret.put("supportsScheduledNotifications", true);
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+            AlarmManager am = (AlarmManager) getContext().getSystemService(Context.ALARM_SERVICE);
+            boolean can = am != null && am.canScheduleExactAlarms();
+            ret.put("canScheduleExactAlarms", can);
+        }
+        call.resolve(ret);
+    }
+
+    @PluginMethod
+    public void requestPermissions(PluginCall call) {
+        boolean requestExact = call.getBoolean("exactAlarm", false);
+        JSObject ret = new JSObject();
+        if (requestExact && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+            AlarmManager am = (AlarmManager) getContext().getSystemService(Context.ALARM_SERVICE);
+            boolean can = am != null && am.canScheduleExactAlarms();
+            if (!can) {
+                Intent i = new Intent(android.provider.Settings.ACTION_REQUEST_SCHEDULE_EXACT_ALARM);
+                i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                try {
+                    getContext().startActivity(i);
+                } catch (Exception ignored) {}
+                ret.put("granted", false);
+                JSObject details = new JSObject();
+                details.put("exactAlarm", false);
+                ret.put("details", details);
+                call.resolve(ret);
+                return;
+            }
+        }
+        ret.put("granted", true);
+        call.resolve(ret);
+    }
+}

package/dist/docs.json

@@ -0,0 +1,228 @@
+{
+  "api": {
+    "name": "CapgoAlarmPlugin",
+    "slug": "capgoalarmplugin",
+    "docs": "",
+    "tags": [],
+    "methods": [
+      {
+        "name": "createAlarm",
+        "signature": "(options: NativeAlarmCreateOptions) => Promise<NativeActionResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "NativeAlarmCreateOptions"
+          }
+        ],
+        "returns": "Promise<NativeActionResult>",
+        "tags": [],
+        "docs": "Create a native OS alarm using the platform clock app.\nOn Android this uses the Alarm Clock intent; on iOS this is not supported.",
+        "complexTypes": [
+          "NativeActionResult",
+          "NativeAlarmCreateOptions"
+        ],
+        "slug": "createalarm"
+      },
+      {
+        "name": "openAlarms",
+        "signature": "() => Promise<NativeActionResult>",
+        "parameters": [],
+        "returns": "Promise<NativeActionResult>",
+        "tags": [],
+        "docs": "Open the platform's native alarm list UI, if available.",
+        "complexTypes": [
+          "NativeActionResult"
+        ],
+        "slug": "openalarms"
+      },
+      {
+        "name": "getOSInfo",
+        "signature": "() => Promise<OSInfo>",
+        "parameters": [],
+        "returns": "Promise<OSInfo>",
+        "tags": [],
+        "docs": "Get information about the OS and capabilities.",
+        "complexTypes": [
+          "OSInfo"
+        ],
+        "slug": "getosinfo"
+      },
+      {
+        "name": "requestPermissions",
+        "signature": "(options?: { exactAlarm?: boolean | undefined; } | undefined) => Promise<PermissionResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "{ exactAlarm?: boolean | undefined; } | undefined"
+          }
+        ],
+        "returns": "Promise<PermissionResult>",
+        "tags": [],
+        "docs": "Request relevant permissions for alarm usage on the platform.\nOn Android, may route to settings for exact alarms.",
+        "complexTypes": [
+          "PermissionResult"
+        ],
+        "slug": "requestpermissions"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [
+    {
+      "name": "NativeActionResult",
+      "slug": "nativeactionresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "success",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "message",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "NativeAlarmCreateOptions",
+      "slug": "nativealarmcreateoptions",
+      "docs": "Options for creating a native OS alarm via the platform clock app.",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "hour",
+          "tags": [],
+          "docs": "Hour of day in 24h format (0-23)",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "minute",
+          "tags": [],
+          "docs": "Minute of hour (0-59)",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "label",
+          "tags": [],
+          "docs": "Optional label for the alarm",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "skipUi",
+          "tags": [],
+          "docs": "Android only: attempt to skip UI if possible",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        },
+        {
+          "name": "vibrate",
+          "tags": [],
+          "docs": "Android only: set alarm to vibrate",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        }
+      ]
+    },
+    {
+      "name": "OSInfo",
+      "slug": "osinfo",
+      "docs": "Returned info about current OS and capabilities.",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "platform",
+          "tags": [],
+          "docs": "'ios' | 'android' | 'web'",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "version",
+          "tags": [],
+          "docs": "OS version string",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "supportsNativeAlarms",
+          "tags": [],
+          "docs": "Whether the platform exposes a native alarm app integration",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "supportsScheduledNotifications",
+          "tags": [],
+          "docs": "Whether scheduling local notifications is supported",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "canScheduleExactAlarms",
+          "tags": [],
+          "docs": "Android only: whether exact alarms are allowed",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        }
+      ]
+    },
+    {
+      "name": "PermissionResult",
+      "slug": "permissionresult",
+      "docs": "Result of a permissions request.",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "granted",
+          "tags": [],
+          "docs": "Overall grant for requested scope",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "details",
+          "tags": [],
+          "docs": "Optional details by permission key",
+          "complexTypes": [
+            "Record"
+          ],
+          "type": "Record<string, boolean>"
+        }
+      ]
+    }
+  ],
+  "enums": [],
+  "typeAliases": [
+    {
+      "name": "Record",
+      "slug": "record",
+      "docs": "Construct a type with a set of properties K of type T",
+      "types": [
+        {
+          "text": "{\r\n    [P in K]: T;\r\n}",
+          "complexTypes": [
+            "K",
+            "T"
+          ]
+        }
+      ]
+    }
+  ],
+  "pluginConfigs": []
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,59 @@
+/** Options for creating a native OS alarm via the platform clock app. */
+export interface NativeAlarmCreateOptions {
+    /** Hour of day in 24h format (0-23) */
+    hour: number;
+    /** Minute of hour (0-59) */
+    minute: number;
+    /** Optional label for the alarm */
+    label?: string;
+    /** Android only: attempt to skip UI if possible */
+    skipUi?: boolean;
+    /** Android only: set alarm to vibrate */
+    vibrate?: boolean;
+}
+export interface NativeActionResult {
+    success: boolean;
+    message?: string;
+}
+/** Returned info about current OS and capabilities. */
+export interface OSInfo {
+    /** 'ios' | 'android' | 'web' */
+    platform: string;
+    /** OS version string */
+    version: string;
+    /** Whether the platform exposes a native alarm app integration */
+    supportsNativeAlarms: boolean;
+    /** Whether scheduling local notifications is supported */
+    supportsScheduledNotifications: boolean;
+    /** Android only: whether exact alarms are allowed */
+    canScheduleExactAlarms?: boolean;
+}
+/** Result of a permissions request. */
+export interface PermissionResult {
+    /** Overall grant for requested scope */
+    granted: boolean;
+    /** Optional details by permission key */
+    details?: Record<string, boolean>;
+}
+export interface CapgoAlarmPlugin {
+    /**
+     * Create a native OS alarm using the platform clock app.
+     * On Android this uses the Alarm Clock intent; on iOS this is not supported.
+     */
+    createAlarm(options: NativeAlarmCreateOptions): Promise<NativeActionResult>;
+    /**
+     * Open the platform's native alarm list UI, if available.
+     */
+    openAlarms(): Promise<NativeActionResult>;
+    /**
+     * Get information about the OS and capabilities.
+     */
+    getOSInfo(): Promise<OSInfo>;
+    /**
+     * Request relevant permissions for alarm usage on the platform.
+     * On Android, may route to settings for exact alarms.
+     */
+    requestPermissions(options?: {
+        exactAlarm?: boolean;
+    }): Promise<PermissionResult>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["/** Options for creating a native OS alarm via the platform clock app. */\nexport interface NativeAlarmCreateOptions {\n  /** Hour of day in 24h format (0-23) */\n  hour: number;\n  /** Minute of hour (0-59) */\n  minute: number;\n  /** Optional label for the alarm */\n  label?: string;\n  /** Android only: attempt to skip UI if possible */\n  skipUi?: boolean;\n  /** Android only: set alarm to vibrate */\n  vibrate?: boolean;\n}\n\nexport interface NativeActionResult {\n  success: boolean;\n  message?: string;\n}\n\n/** Returned info about current OS and capabilities. */\nexport interface OSInfo {\n  /** 'ios' | 'android' | 'web' */\n  platform: string;\n  /** OS version string */\n  version: string;\n  /** Whether the platform exposes a native alarm app integration */\n  supportsNativeAlarms: boolean;\n  /** Whether scheduling local notifications is supported */\n  supportsScheduledNotifications: boolean;\n  /** Android only: whether exact alarms are allowed */\n  canScheduleExactAlarms?: boolean;\n}\n\n/** Result of a permissions request. */\nexport interface PermissionResult {\n  /** Overall grant for requested scope */\n  granted: boolean;\n  /** Optional details by permission key */\n  details?: Record<string, boolean>;\n}\n\nexport interface CapgoAlarmPlugin {\n  /**\n   * Create a native OS alarm using the platform clock app.\n   * On Android this uses the Alarm Clock intent; on iOS this is not supported.\n   */\n  createAlarm(options: NativeAlarmCreateOptions): Promise<NativeActionResult>;\n\n  /**\n   * Open the platform's native alarm list UI, if available.\n   */\n  openAlarms(): Promise<NativeActionResult>;\n\n  /**\n   * Get information about the OS and capabilities.\n   */\n  getOSInfo(): Promise<OSInfo>;\n\n  /**\n   * Request relevant permissions for alarm usage on the platform.\n   * On Android, may route to settings for exact alarms.\n   */\n  requestPermissions(options?: { exactAlarm?: boolean }): Promise<PermissionResult>;\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { CapgoAlarmPlugin } from './definitions';
+declare const CapgoAlarm: CapgoAlarmPlugin;
+export * from './definitions';
+export { CapgoAlarm };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const CapgoAlarm = registerPlugin('CapgoAlarm', {
+    web: () => import('./web').then((m) => new m.CapgoAlarmWeb()),
+});
+export * from './definitions';
+export { CapgoAlarm };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,UAAU,GAAG,cAAc,CAAmB,YAAY,EAAE;IAChE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;CAC9D,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { CapgoAlarmPlugin } from './definitions';\n\nconst CapgoAlarm = registerPlugin<CapgoAlarmPlugin>('CapgoAlarm', {\n  web: () => import('./web').then((m) => new m.CapgoAlarmWeb()),\n});\n\nexport * from './definitions';\nexport { CapgoAlarm };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,10 @@
+import { WebPlugin } from '@capacitor/core';
+import type { CapgoAlarmPlugin, NativeAlarmCreateOptions, NativeActionResult, OSInfo, PermissionResult } from './definitions';
+export declare class CapgoAlarmWeb extends WebPlugin implements CapgoAlarmPlugin {
+    createAlarm(_options: NativeAlarmCreateOptions): Promise<NativeActionResult>;
+    openAlarms(): Promise<NativeActionResult>;
+    getOSInfo(): Promise<OSInfo>;
+    requestPermissions(_options?: {
+        exactAlarm?: boolean;
+    }): Promise<PermissionResult>;
+}

package/dist/esm/web.js

@@ -0,0 +1,21 @@
+import { WebPlugin } from '@capacitor/core';
+export class CapgoAlarmWeb extends WebPlugin {
+    async createAlarm(_options) {
+        return { success: false, message: 'Native alarm not supported on web' };
+    }
+    async openAlarms() {
+        return { success: false, message: 'Native alarm UI not available on web' };
+    }
+    async getOSInfo() {
+        return {
+            platform: 'web',
+            version: navigator.userAgent,
+            supportsNativeAlarms: false,
+            supportsScheduledNotifications: false,
+        };
+    }
+    async requestPermissions(_options) {
+        return { granted: true };
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,KAAK,CAAC,WAAW,CAAC,QAAkC;QAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,SAAS,CAAC,SAAS;YAC5B,oBAAoB,EAAE,KAAK;YAC3B,8BAA8B,EAAE,KAAK;SACtC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAAmC;QAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  CapgoAlarmPlugin,\n  NativeAlarmCreateOptions,\n  NativeActionResult,\n  OSInfo,\n  PermissionResult,\n} from './definitions';\n\nexport class CapgoAlarmWeb extends WebPlugin implements CapgoAlarmPlugin {\n  async createAlarm(_options: NativeAlarmCreateOptions): Promise<NativeActionResult> {\n    return { success: false, message: 'Native alarm not supported on web' };\n  }\n\n  async openAlarms(): Promise<NativeActionResult> {\n    return { success: false, message: 'Native alarm UI not available on web' };\n  }\n\n  async getOSInfo(): Promise<OSInfo> {\n    return {\n      platform: 'web',\n      version: navigator.userAgent,\n      supportsNativeAlarms: false,\n      supportsScheduledNotifications: false,\n    };\n  }\n\n  async requestPermissions(_options?: { exactAlarm?: boolean }): Promise<PermissionResult> {\n    return { granted: true };\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,35 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const CapgoAlarm = core.registerPlugin('CapgoAlarm', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.CapgoAlarmWeb()),
+});
+
+class CapgoAlarmWeb extends core.WebPlugin {
+    async createAlarm(_options) {
+        return { success: false, message: 'Native alarm not supported on web' };
+    }
+    async openAlarms() {
+        return { success: false, message: 'Native alarm UI not available on web' };
+    }
+    async getOSInfo() {
+        return {
+            platform: 'web',
+            version: navigator.userAgent,
+            supportsNativeAlarms: false,
+            supportsScheduledNotifications: false,
+        };
+    }
+    async requestPermissions(_options) {
+        return { granted: true };
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    CapgoAlarmWeb: CapgoAlarmWeb
+});
+
+exports.CapgoAlarm = CapgoAlarm;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst CapgoAlarm = registerPlugin('CapgoAlarm', {\n    web: () => import('./web').then((m) => new m.CapgoAlarmWeb()),\n});\nexport * from './definitions';\nexport { CapgoAlarm };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapgoAlarmWeb extends WebPlugin {\n    async createAlarm(_options) {\n        return { success: false, message: 'Native alarm not supported on web' };\n    }\n    async openAlarms() {\n        return { success: false, message: 'Native alarm UI not available on web' };\n    }\n    async getOSInfo() {\n        return {\n            platform: 'web',\n            version: navigator.userAgent,\n            supportsNativeAlarms: false,\n            supportsScheduledNotifications: false,\n        };\n    }\n    async requestPermissions(_options) {\n        return { granted: true };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,UAAU,GAAGA,mBAAc,CAAC,YAAY,EAAE;AAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;AACjE,CAAC;;ACFM,MAAM,aAAa,SAASC,cAAS,CAAC;AAC7C,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE;AAChC,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mCAAmC,EAAE;AAC/E,IAAI;AACJ,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,sCAAsC,EAAE;AAClF,IAAI;AACJ,IAAI,MAAM,SAAS,GAAG;AACtB,QAAQ,OAAO;AACf,YAAY,QAAQ,EAAE,KAAK;AAC3B,YAAY,OAAO,EAAE,SAAS,CAAC,SAAS;AACxC,YAAY,oBAAoB,EAAE,KAAK;AACvC,YAAY,8BAA8B,EAAE,KAAK;AACjD,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE;AACvC,QAAQ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;AAChC,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,38 @@
+var capacitorCapgoAlarm = (function (exports, core) {
+    'use strict';
+
+    const CapgoAlarm = core.registerPlugin('CapgoAlarm', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.CapgoAlarmWeb()),
+    });
+
+    class CapgoAlarmWeb extends core.WebPlugin {
+        async createAlarm(_options) {
+            return { success: false, message: 'Native alarm not supported on web' };
+        }
+        async openAlarms() {
+            return { success: false, message: 'Native alarm UI not available on web' };
+        }
+        async getOSInfo() {
+            return {
+                platform: 'web',
+                version: navigator.userAgent,
+                supportsNativeAlarms: false,
+                supportsScheduledNotifications: false,
+            };
+        }
+        async requestPermissions(_options) {
+            return { granted: true };
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        CapgoAlarmWeb: CapgoAlarmWeb
+    });
+
+    exports.CapgoAlarm = CapgoAlarm;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst CapgoAlarm = registerPlugin('CapgoAlarm', {\n    web: () => import('./web').then((m) => new m.CapgoAlarmWeb()),\n});\nexport * from './definitions';\nexport { CapgoAlarm };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapgoAlarmWeb extends WebPlugin {\n    async createAlarm(_options) {\n        return { success: false, message: 'Native alarm not supported on web' };\n    }\n    async openAlarms() {\n        return { success: false, message: 'Native alarm UI not available on web' };\n    }\n    async getOSInfo() {\n        return {\n            platform: 'web',\n            version: navigator.userAgent,\n            supportsNativeAlarms: false,\n            supportsScheduledNotifications: false,\n        };\n    }\n    async requestPermissions(_options) {\n        return { granted: true };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,UAAU,GAAGA,mBAAc,CAAC,YAAY,EAAE;IAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;IACjE,CAAC;;ICFM,MAAM,aAAa,SAASC,cAAS,CAAC;IAC7C,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE;IAChC,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mCAAmC,EAAE;IAC/E,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,sCAAsC,EAAE;IAClF,IAAI;IACJ,IAAI,MAAM,SAAS,GAAG;IACtB,QAAQ,OAAO;IACf,YAAY,QAAQ,EAAE,KAAK;IAC3B,YAAY,OAAO,EAAE,SAAS,CAAC,SAAS;IACxC,YAAY,oBAAoB,EAAE,KAAK;IACvC,YAAY,8BAA8B,EAAE,KAAK;IACjD,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE;IACvC,QAAQ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IAChC,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/CapgoAlarmPlugin/AlarmKitBridge.swift

@@ -0,0 +1,57 @@
+import Foundation
+
+#if canImport(AlarmKit)
+import AlarmKit
+#endif
+
+class AlarmKitBridge {
+    static func isAvailable() -> Bool {
+#if canImport(AlarmKit)
+        if #available(iOS 26.0, *) { return true } else { return false }
+#else
+        return false
+#endif
+    }
+
+    static func requestAuthorization(completion: @escaping (Bool, String?) -> Void) {
+#if canImport(AlarmKit)
+        if #available(iOS 26.0, *) {
+            Task {
+                do {
+                    // Acquire the AlarmKit manager; many Apple frameworks use a shared singleton.
+                    let alarmManager = AlarmManager.shared
+                    let state = try await alarmManager.requestAuthorization()
+                    completion(state == .authorized, nil)
+                } catch {
+                    completion(false, "Authorization error: \(error.localizedDescription)")
+                }
+            }
+            return
+        }
+#endif
+        completion(false, "AlarmKit not available on this device/SDK")
+    }
+
+    static func createAlarm(hour: Int, minute: Int, label: String?, completion: @escaping (Bool, String?) -> Void) {
+#if canImport(AlarmKit)
+        if #available(iOS 26.0, *) {
+            // TODO: Replace with real AlarmKit calls.
+            // We intentionally avoid guessing API surface to prevent compilation/runtime issues.
+            completion(false, "AlarmKit integrated but no concrete API wired. Provide exact AlarmKit API usage.")
+            return
+        }
+#endif
+        completion(false, "AlarmKit not available on this device/SDK")
+    }
+
+    static func openAlarms(completion: @escaping (Bool, String?) -> Void) {
+        #if canImport(AlarmKit)
+        if #available(iOS 26.0, *) {
+            // TODO: Replace with real AlarmKit calls.
+            completion(false, "AlarmKit integrated but no concrete API wired. Provide exact AlarmKit API usage.")
+            return
+        }
+        #endif
+        completion(false, "AlarmKit not available on this device/SDK")
+    }
+}

package/ios/Sources/CapgoAlarmPlugin/CapgoAlarmPlugin.swift

@@ -0,0 +1,67 @@
+import Foundation
+import Capacitor
+
+/**
+ * Please read the Capacitor iOS Plugin Development Guide
+ * here: https://capacitorjs.com/docs/plugins/ios
+ */
+@objc(CapgoAlarmPlugin)
+public class CapgoAlarmPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "CapgoAlarmPlugin"
+    public let jsName = "CapgoAlarm"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "createAlarm", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "openAlarms", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getOSInfo", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "requestPermissions", returnType: CAPPluginReturnPromise)
+    ]
+
+    @objc func createAlarm(_ call: CAPPluginCall) {
+        let hour = call.getInt("hour") ?? -1
+        let minute = call.getInt("minute") ?? -1
+        if hour < 0 || minute < 0 { call.reject("hour and minute are required"); return }
+        let label = call.getString("label")
+
+        AlarmKitBridge.createAlarm(hour: hour, minute: minute, label: label) { success, message in
+            call.resolve(["success": success, "message": message ?? NSNull()])
+        }
+    }
+
+    @objc func openAlarms(_ call: CAPPluginCall) {
+        AlarmKitBridge.openAlarms { success, message in
+            call.resolve(["success": success, "message": message ?? NSNull()])
+        }
+    }
+
+    @objc func getOSInfo(_ call: CAPPluginCall) {
+        let version = UIDevice.current.systemVersion
+        let supportsNative = AlarmKitBridge.isAvailable()
+        call.resolve([
+            "platform": "ios",
+            "version": version,
+            "supportsNativeAlarms": supportsNative,
+            "supportsScheduledNotifications": true
+        ])
+    }
+
+    // Capacitor permission lifecycle
+    public override func checkPermissions(_ call: CAPPluginCall) {
+        // No explicit runtime permission needed for AlarmKit; always granted when available
+        call.resolve(["granted": true])
+    }
+
+    public override func requestPermissions(_ call: CAPPluginCall) {
+        // Request AlarmKit authorization when available
+        if !AlarmKitBridge.isAvailable() {
+            call.resolve(["granted": false])
+            return
+        }
+        AlarmKitBridge.requestAuthorization { granted, message in
+            var result: [String: Any] = ["granted": granted]
+            if let message = message { result["message"] = message }
+            call.resolve(result)
+        }
+    }
+
+    // No data conversion helpers needed for native-only operations
+}

package/ios/Tests/CapgoAlarmPluginTests/CapgoAlarmPluginTests.swift

@@ -0,0 +1,15 @@
+import XCTest
+@testable import CapgoAlarmPlugin
+
+class CapgoAlarmTests: XCTestCase {
+    func testEcho() {
+        // This is an example of a functional test case for a plugin.
+        // Use XCTAssert and related functions to verify your tests produce the correct results.
+
+        let implementation = CapgoAlarm()
+        let value = "Hello, World!"
+        let result = implementation.echo(value)
+
+        XCTAssertEqual(value, result)
+    }
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@capgo/capacitor-alarm",
+  "version": "7.0.0",
+  "description": "Manage native alarm Capacitor plugin",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "CapgoCapacitorAlarm.podspec"
+  ],
+  "author": "Martin Donadieu <martin@capgo.app>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cap-go/capacitor-alarm.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Cap-go/capacitor-alarm/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme CapgoCapacitorAlarm -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api CapgoAlarmPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^7.0.0",
+    "@capacitor/core": "^7.0.0",
+    "@capacitor/docgen": "^0.3.0",
+    "@capacitor/ios": "^7.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.4.2",
+    "prettier-plugin-java": "^2.6.6",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.30.1",
+    "swiftlint": "^2.0.0",
+    "typescript": "~4.1.5"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=7.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}