@dimer47/capacitor-plugin-asam 2.0.0

package/CapacitorPluginAsam.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapacitorPluginAsam'
+  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/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target  = '15.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.9'
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 IACHI Dimitri
+
+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 @@
+# 📱 Capacitor Plugin ASAM (Autonomous Single App Mode)
+
+![Release](https://img.shields.io/github/package-json/v/dimer47/capacitor-plugin-asam?color=red&style=flat-square) ![Last update](https://img.shields.io/github/last-commit/dimer47/capacitor-plugin-asam?color=yellow&label=Last%20update&style=flat-square) ![Dependency size](https://img.shields.io/bundlephobia/minzip/capacitor-plugin-asam?color=green&label=dependency%20size&style=flat-square) ![Repo size](https://img.shields.io/github/repo-size/dimer47/capacitor-plugin-asam?style=flat-square) ![Downloads](https://img.shields.io/npm/dt/capacitor-plugin-asam?style=flat-square) ![License](https://img.shields.io/github/license/dimer47/capacitor-plugin-asam?style=flat-square) ![iOS 15+](https://img.shields.io/badge/iOS-15%2B-blue?style=flat-square&logo=apple) ![Capacitor 5+](https://img.shields.io/badge/Capacitor-5%2B-00BFFF?style=flat-square&logo=capacitor)
+
+**⚠️ iOS only** — This plugin uses native iOS APIs and is not available on Android or Web.
+
+Easily integrate **Autonomous Single App Mode** (ASAM) in your iOS app, allowing it to control Single App Mode sessions for focused, distraction-free user experiences. Ideal for educational, testing, or kiosk applications. 🎓🏪
+
+## 🎉 Features
+
+- 🔒 **Enable / Disable** Single App Mode programmatically
+- 🔍 **Check** if ASAM is currently enabled
+- ⚡ **Async/Await** support — all methods return Promises
+- 📦 **Compatible** with Capacitor 5, 6, 7 & 8
+- 🍎 **Supports** iOS 15 through iOS 26+
+
+## 📍 Install
+
+```bash
+npm install capacitor-plugin-asam
+npx cap sync
+```
+
+## ⚙️ Configuration
+
+To enable the Autonomous Single App Mode (ASAM) on iOS devices, administrators must utilize a **Mobile Device Management (MDM)** system or **Apple Configurator**.
+
+These tools are essential for setting up and managing ASAM, as they provide the ability to create and deploy specific configuration profiles to iOS devices.
+
+These profiles dictate which applications can run in ASAM, ensuring controlled and secure usage of the devices in environments like schools, businesses, or public kiosks. Without MDM or Apple Configurator, activating ASAM on iOS devices is not feasible.
+
+> 💡 **Tip:** Make sure to allowlist your app's bundle ID in the MDM configuration for Autonomous Single App Mode.
+
+## 🕹️ Usage
+
+```typescript
+// import the plugin
+import { Asam } from "capacitor-plugin-asam";
+
+// --------------------
+// ✅ Enable ASAM using setASAM
+
+let r = await Asam.setASAM({ enable: true });
+if (!r.success)
+    console.error("Failed to enable ASAM");
+
+let isEnabled = (await Asam.isASAMEnabled()).enabled;
+console.log("ASAM is enabled: " + isEnabled);
+
+// --------------------
+// ✅ Another way to enable ASAM using enableASAM
+
+r = await Asam.enableASAM();
+if (!r.success)
+    console.error("Failed to enable ASAM");
+
+isEnabled = (await Asam.isASAMEnabled()).enabled;
+console.log("ASAM is enabled: " + isEnabled);
+
+// --------------------
+// 🛑 Disable ASAM using disableASAM
+
+r = await Asam.disableASAM();
+if (!r.success)
+    console.error("Failed to disable ASAM");
+
+isEnabled = (await Asam.isASAMEnabled()).enabled;
+console.log("ASAM is enabled: " + isEnabled);
+
+// --------------------
+// 🛑 Another way to disable ASAM using setASAM
+
+r = await Asam.setASAM({ enable: false });
+if (!r.success)
+    console.error("Failed to disable ASAM");
+```
+
+## 🧮 API
+
+> 📖 **Full documentation with detailed examples:** [docs/api.md](docs/api.md)
+
+<docgen-index>
+
+* [`setASAM(...)`](#setasam)
+* [`enableASAM()`](#enableasam)
+* [`disableASAM()`](#disableasam)
+* [`isASAMEnabled()`](#isasamenabled)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### setASAM(...)
+
+```typescript
+setASAM(options: { enable: boolean; }) => Promise<{ success: boolean; }>
+```
+
+Enable or disable Autonomous Single App Mode (ASAM) based on the `enable` parameter.
+
+| Param         | Type                              | Description                                               |
+| ------------- | --------------------------------- | --------------------------------------------------------- |
+| **`options`** | <code>{ enable: boolean; }</code> | - `enable: true` to activate ASAM, `false` to deactivate. |
+
+**Returns:** <code>Promise&lt;{ success: boolean; }&gt;</code>
+
+--------------------
+
+
+### enableASAM()
+
+```typescript
+enableASAM() => Promise<{ success: boolean; }>
+```
+
+Enable Autonomous Single App Mode (ASAM) on the device.
+Shortcut for `setASAM({ enable: true })`.
+
+**Returns:** <code>Promise&lt;{ success: boolean; }&gt;</code>
+
+--------------------
+
+
+### disableASAM()
+
+```typescript
+disableASAM() => Promise<{ success: boolean; }>
+```
+
+Disable Autonomous Single App Mode (ASAM) on the device.
+Shortcut for `setASAM({ enable: false })`.
+
+**Returns:** <code>Promise&lt;{ success: boolean; }&gt;</code>
+
+--------------------
+
+
+### isASAMEnabled()
+
+```typescript
+isASAMEnabled() => Promise<{ enabled: boolean; }>
+```
+
+Check whether Autonomous Single App Mode (ASAM) is currently active on the device.
+
+**Returns:** <code>Promise&lt;{ enabled: boolean; }&gt;</code>
+
+--------------------
+
+</docgen-api>
+
+## 🧪 Testing
+
+```bash
+npm test
+```
+
+This runs the iOS unit tests via Xcode on the iOS Simulator.
+
+## 🧾 License
+
+[MIT](LICENSE)

package/dist/docs.json

@@ -0,0 +1,85 @@
+{
+  "api": {
+    "name": "AsamPlugin",
+    "slug": "asamplugin",
+    "docs": "",
+    "tags": [],
+    "methods": [
+      {
+        "name": "setASAM",
+        "signature": "(options: { enable: boolean; }) => Promise<{ success: boolean; }>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "- `enable: true` to activate ASAM, `false` to deactivate.",
+            "type": "{ enable: boolean; }"
+          }
+        ],
+        "returns": "Promise<{ success: boolean; }>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options - `enable: true` to activate ASAM, `false` to deactivate."
+          },
+          {
+            "name": "returns",
+            "text": "`{ success: true }` if the operation succeeded, `{ success: false }` otherwise."
+          }
+        ],
+        "docs": "Enable or disable Autonomous Single App Mode (ASAM) based on the `enable` parameter.",
+        "complexTypes": [],
+        "slug": "setasam"
+      },
+      {
+        "name": "enableASAM",
+        "signature": "() => Promise<{ success: boolean; }>",
+        "parameters": [],
+        "returns": "Promise<{ success: boolean; }>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "`{ success: true }` if ASAM was enabled successfully."
+          }
+        ],
+        "docs": "Enable Autonomous Single App Mode (ASAM) on the device.\nShortcut for `setASAM({ enable: true })`.",
+        "complexTypes": [],
+        "slug": "enableasam"
+      },
+      {
+        "name": "disableASAM",
+        "signature": "() => Promise<{ success: boolean; }>",
+        "parameters": [],
+        "returns": "Promise<{ success: boolean; }>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "`{ success: true }` if ASAM was disabled successfully."
+          }
+        ],
+        "docs": "Disable Autonomous Single App Mode (ASAM) on the device.\nShortcut for `setASAM({ enable: false })`.",
+        "complexTypes": [],
+        "slug": "disableasam"
+      },
+      {
+        "name": "isASAMEnabled",
+        "signature": "() => Promise<{ enabled: boolean; }>",
+        "parameters": [],
+        "returns": "Promise<{ enabled: boolean; }>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "`{ enabled: true }` if ASAM / Guided Access is currently active."
+          }
+        ],
+        "docs": "Check whether Autonomous Single App Mode (ASAM) is currently active on the device.",
+        "complexTypes": [],
+        "slug": "isasamenabled"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [],
+  "enums": [],
+  "typeAliases": [],
+  "pluginConfigs": []
+}

package/dist/esm/android.d.ts

@@ -0,0 +1,18 @@
+import { WebPlugin } from '@capacitor/core';
+import type { AsamPlugin } from './definitions';
+export declare class AsamAndroid extends WebPlugin implements AsamPlugin {
+    setASAM(_options: {
+        enable: boolean;
+    }): Promise<{
+        success: boolean;
+    }>;
+    enableASAM(): Promise<{
+        success: boolean;
+    }>;
+    disableASAM(): Promise<{
+        success: boolean;
+    }>;
+    isASAMEnabled(): Promise<{
+        enabled: boolean;
+    }>;
+}

package/dist/esm/android.js

@@ -0,0 +1,17 @@
+import { WebPlugin } from '@capacitor/core';
+export class AsamAndroid extends WebPlugin {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    setASAM(_options) {
+        throw this.unimplemented('setASAM is not implemented on web.');
+    }
+    enableASAM() {
+        throw this.unimplemented('enableASAM is not implemented on web.');
+    }
+    disableASAM() {
+        throw this.unimplemented('disableASAM is not implemented on web.');
+    }
+    isASAMEnabled() {
+        throw this.unimplemented('isASAMEnabled is not implemented on web.');
+    }
+}
+//# sourceMappingURL=android.js.map

package/dist/esm/android.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"android.js","sourceRoot":"","sources":["../../src/android.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxC,6DAA6D;IAC7D,OAAO,CAAC,QAA6B;QACnC,MAAM,IAAI,CAAC,aAAa,CAAC,oCAAoC,CAAC,CAAC;IACjE,CAAC;IAED,UAAU;QACR,MAAM,IAAI,CAAC,aAAa,CAAC,uCAAuC,CAAC,CAAC;IACpE,CAAC;IAED,WAAW;QACT,MAAM,IAAI,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;IACrE,CAAC;IAED,aAAa;QACX,MAAM,IAAI,CAAC,aAAa,CAAC,0CAA0C,CAAC,CAAC;IACvE,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { AsamPlugin } from './definitions';\n\nexport class AsamAndroid extends WebPlugin implements AsamPlugin {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  setASAM(_options: { enable: boolean }): Promise<{ success: boolean }> {\n    throw this.unimplemented('setASAM is not implemented on web.');\n  }\n\n  enableASAM(): Promise<{ success: boolean }> {\n    throw this.unimplemented('enableASAM is not implemented on web.');\n  }\n\n  disableASAM(): Promise<{ success: boolean }> {\n    throw this.unimplemented('disableASAM is not implemented on web.');\n  }\n\n  isASAMEnabled(): Promise<{ enabled: boolean }> {\n    throw this.unimplemented('isASAMEnabled is not implemented on web.');\n  }\n}\n"]}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,39 @@
+export interface AsamPlugin {
+    /**
+     * Enable or disable Autonomous Single App Mode (ASAM) based on the `enable` parameter.
+     *
+     * @param options - `enable: true` to activate ASAM, `false` to deactivate.
+     * @returns `{ success: true }` if the operation succeeded, `{ success: false }` otherwise.
+     */
+    setASAM(options: {
+        enable: boolean;
+    }): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Enable Autonomous Single App Mode (ASAM) on the device.
+     * Shortcut for `setASAM({ enable: true })`.
+     *
+     * @returns `{ success: true }` if ASAM was enabled successfully.
+     */
+    enableASAM(): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Disable Autonomous Single App Mode (ASAM) on the device.
+     * Shortcut for `setASAM({ enable: false })`.
+     *
+     * @returns `{ success: true }` if ASAM was disabled successfully.
+     */
+    disableASAM(): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Check whether Autonomous Single App Mode (ASAM) is currently active on the device.
+     *
+     * @returns `{ enabled: true }` if ASAM / Guided Access is currently active.
+     */
+    isASAMEnabled(): Promise<{
+        enabled: boolean;
+    }>;
+}

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":["export interface AsamPlugin {\n  /**\n   * Enable or disable Autonomous Single App Mode (ASAM) based on the `enable` parameter.\n   *\n   * @param options - `enable: true` to activate ASAM, `false` to deactivate.\n   * @returns `{ success: true }` if the operation succeeded, `{ success: false }` otherwise.\n   */\n  setASAM(options: { enable: boolean }): Promise<{ success: boolean }>;\n\n  /**\n   * Enable Autonomous Single App Mode (ASAM) on the device.\n   * Shortcut for `setASAM({ enable: true })`.\n   *\n   * @returns `{ success: true }` if ASAM was enabled successfully.\n   */\n  enableASAM(): Promise<{ success: boolean }>;\n\n  /**\n   * Disable Autonomous Single App Mode (ASAM) on the device.\n   * Shortcut for `setASAM({ enable: false })`.\n   *\n   * @returns `{ success: true }` if ASAM was disabled successfully.\n   */\n  disableASAM(): Promise<{ success: boolean }>;\n\n  /**\n   * Check whether Autonomous Single App Mode (ASAM) is currently active on the device.\n   *\n   * @returns `{ enabled: true }` if ASAM / Guided Access is currently active.\n   */\n  isASAMEnabled(): Promise<{ enabled: boolean }>;\n}\n"]}

package/dist/esm/index.d.ts

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

package/dist/esm/index.js

@@ -0,0 +1,8 @@
+import { registerPlugin } from '@capacitor/core';
+const Asam = registerPlugin('Asam', {
+    web: () => import('./web').then(m => new m.AsamWeb()),
+    android: () => import('./android').then(m => new m.AsamAndroid()),
+});
+export * from './definitions';
+export { Asam };
+//# 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,IAAI,GAAG,cAAc,CAAa,MAAM,EAAE;IAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACrD,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;CAClE,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { AsamPlugin } from './definitions';\n\nconst Asam = registerPlugin<AsamPlugin>('Asam', {\n  web: () => import('./web').then(m => new m.AsamWeb()),\n  android: () => import('./android').then(m => new m.AsamAndroid()),\n});\n\nexport * from './definitions';\nexport { Asam };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,18 @@
+import { WebPlugin } from '@capacitor/core';
+import type { AsamPlugin } from './definitions';
+export declare class AsamWeb extends WebPlugin implements AsamPlugin {
+    setASAM(_options: {
+        enable: boolean;
+    }): Promise<{
+        success: boolean;
+    }>;
+    enableASAM(): Promise<{
+        success: boolean;
+    }>;
+    disableASAM(): Promise<{
+        success: boolean;
+    }>;
+    isASAMEnabled(): Promise<{
+        enabled: boolean;
+    }>;
+}

package/dist/esm/web.js

@@ -0,0 +1,17 @@
+import { WebPlugin } from '@capacitor/core';
+export class AsamWeb extends WebPlugin {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    setASAM(_options) {
+        throw this.unavailable('setASAM is not available on web.');
+    }
+    enableASAM() {
+        throw this.unavailable('enableASAM is not available on web.');
+    }
+    disableASAM() {
+        throw this.unavailable('disableASAM is not available on web.');
+    }
+    isASAMEnabled() {
+        throw this.unavailable('isASAMEnabled is not available on web.');
+    }
+}
+//# 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;AAI5C,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpC,6DAA6D;IAC7D,OAAO,CAAC,QAA6B;QACnC,MAAM,IAAI,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC;IAC7D,CAAC;IAED,UAAU;QACR,MAAM,IAAI,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAChE,CAAC;IAED,WAAW;QACT,MAAM,IAAI,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC;IACjE,CAAC;IAED,aAAa;QACX,MAAM,IAAI,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;IACnE,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { AsamPlugin } from './definitions';\n\nexport class AsamWeb extends WebPlugin implements AsamPlugin {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  setASAM(_options: { enable: boolean }): Promise<{ success: boolean }> {\n    throw this.unavailable('setASAM is not available on web.');\n  }\n\n  enableASAM(): Promise<{ success: boolean }> {\n    throw this.unavailable('enableASAM is not available on web.');\n  }\n\n  disableASAM(): Promise<{ success: boolean }> {\n    throw this.unavailable('disableASAM is not available on web.');\n  }\n\n  isASAMEnabled(): Promise<{ enabled: boolean }> {\n    throw this.unavailable('isASAMEnabled is not available on web.');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,55 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@capacitor/core');
+
+const Asam = core.registerPlugin('Asam', {
+    web: () => Promise.resolve().then(function () { return web; }).then(m => new m.AsamWeb()),
+    android: () => Promise.resolve().then(function () { return android; }).then(m => new m.AsamAndroid()),
+});
+
+class AsamWeb extends core.WebPlugin {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    setASAM(_options) {
+        throw this.unavailable('setASAM is not available on web.');
+    }
+    enableASAM() {
+        throw this.unavailable('enableASAM is not available on web.');
+    }
+    disableASAM() {
+        throw this.unavailable('disableASAM is not available on web.');
+    }
+    isASAMEnabled() {
+        throw this.unavailable('isASAMEnabled is not available on web.');
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    AsamWeb: AsamWeb
+});
+
+class AsamAndroid extends core.WebPlugin {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    setASAM(_options) {
+        throw this.unimplemented('setASAM is not implemented on web.');
+    }
+    enableASAM() {
+        throw this.unimplemented('enableASAM is not implemented on web.');
+    }
+    disableASAM() {
+        throw this.unimplemented('disableASAM is not implemented on web.');
+    }
+    isASAMEnabled() {
+        throw this.unimplemented('isASAMEnabled is not implemented on web.');
+    }
+}
+
+var android = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    AsamAndroid: AsamAndroid
+});
+
+exports.Asam = Asam;
+//# 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","esm/android.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Asam = registerPlugin('Asam', {\n    web: () => import('./web').then(m => new m.AsamWeb()),\n    android: () => import('./android').then(m => new m.AsamAndroid()),\n});\nexport * from './definitions';\nexport { Asam };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AsamWeb extends WebPlugin {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    setASAM(_options) {\n        throw this.unavailable('setASAM is not available on web.');\n    }\n    enableASAM() {\n        throw this.unavailable('enableASAM is not available on web.');\n    }\n    disableASAM() {\n        throw this.unavailable('disableASAM is not available on web.');\n    }\n    isASAMEnabled() {\n        throw this.unavailable('isASAMEnabled is not available on web.');\n    }\n}\n//# sourceMappingURL=web.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AsamAndroid extends WebPlugin {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    setASAM(_options) {\n        throw this.unimplemented('setASAM is not implemented on web.');\n    }\n    enableASAM() {\n        throw this.unimplemented('enableASAM is not implemented on web.');\n    }\n    disableASAM() {\n        throw this.unimplemented('disableASAM is not implemented on web.');\n    }\n    isASAMEnabled() {\n        throw this.unimplemented('isASAMEnabled is not implemented on web.');\n    }\n}\n//# sourceMappingURL=android.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;;;AACK,MAAC,IAAI,GAAGA,mBAAc,CAAC,MAAM,EAAE;AACpC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACzD,IAAI,OAAO,EAAE,MAAM,uDAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AACrE,CAAC;;ACHM,MAAM,OAAO,SAASC,cAAS,CAAC;AACvC;AACA,IAAI,OAAO,CAAC,QAAQ,EAAE;AACtB,QAAQ,MAAM,IAAI,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC;AACnE,KAAK;AACL,IAAI,UAAU,GAAG;AACjB,QAAQ,MAAM,IAAI,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;AACtE,KAAK;AACL,IAAI,WAAW,GAAG;AAClB,QAAQ,MAAM,IAAI,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC;AACvE,KAAK;AACL,IAAI,aAAa,GAAG;AACpB,QAAQ,MAAM,IAAI,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;AACzE,KAAK;AACL;;;;;;;ACdO,MAAM,WAAW,SAASA,cAAS,CAAC;AAC3C;AACA,IAAI,OAAO,CAAC,QAAQ,EAAE;AACtB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,oCAAoC,CAAC,CAAC;AACvE,KAAK;AACL,IAAI,UAAU,GAAG;AACjB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,uCAAuC,CAAC,CAAC;AAC1E,KAAK;AACL,IAAI,WAAW,GAAG;AAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;AAC3E,KAAK;AACL,IAAI,aAAa,GAAG;AACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,0CAA0C,CAAC,CAAC;AAC7E,KAAK;AACL;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,58 @@
+var capacitorAsam = (function (exports, core) {
+    'use strict';
+
+    const Asam = core.registerPlugin('Asam', {
+        web: () => Promise.resolve().then(function () { return web; }).then(m => new m.AsamWeb()),
+        android: () => Promise.resolve().then(function () { return android; }).then(m => new m.AsamAndroid()),
+    });
+
+    class AsamWeb extends core.WebPlugin {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        setASAM(_options) {
+            throw this.unavailable('setASAM is not available on web.');
+        }
+        enableASAM() {
+            throw this.unavailable('enableASAM is not available on web.');
+        }
+        disableASAM() {
+            throw this.unavailable('disableASAM is not available on web.');
+        }
+        isASAMEnabled() {
+            throw this.unavailable('isASAMEnabled is not available on web.');
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        AsamWeb: AsamWeb
+    });
+
+    class AsamAndroid extends core.WebPlugin {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        setASAM(_options) {
+            throw this.unimplemented('setASAM is not implemented on web.');
+        }
+        enableASAM() {
+            throw this.unimplemented('enableASAM is not implemented on web.');
+        }
+        disableASAM() {
+            throw this.unimplemented('disableASAM is not implemented on web.');
+        }
+        isASAMEnabled() {
+            throw this.unimplemented('isASAMEnabled is not implemented on web.');
+        }
+    }
+
+    var android = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        AsamAndroid: AsamAndroid
+    });
+
+    exports.Asam = Asam;
+
+    Object.defineProperty(exports, '__esModule', { value: true });
+
+    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","esm/android.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Asam = registerPlugin('Asam', {\n    web: () => import('./web').then(m => new m.AsamWeb()),\n    android: () => import('./android').then(m => new m.AsamAndroid()),\n});\nexport * from './definitions';\nexport { Asam };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AsamWeb extends WebPlugin {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    setASAM(_options) {\n        throw this.unavailable('setASAM is not available on web.');\n    }\n    enableASAM() {\n        throw this.unavailable('enableASAM is not available on web.');\n    }\n    disableASAM() {\n        throw this.unavailable('disableASAM is not available on web.');\n    }\n    isASAMEnabled() {\n        throw this.unavailable('isASAMEnabled is not available on web.');\n    }\n}\n//# sourceMappingURL=web.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AsamAndroid extends WebPlugin {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    setASAM(_options) {\n        throw this.unimplemented('setASAM is not implemented on web.');\n    }\n    enableASAM() {\n        throw this.unimplemented('enableASAM is not implemented on web.');\n    }\n    disableASAM() {\n        throw this.unimplemented('disableASAM is not implemented on web.');\n    }\n    isASAMEnabled() {\n        throw this.unimplemented('isASAMEnabled is not implemented on web.');\n    }\n}\n//# sourceMappingURL=android.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,IAAI,GAAGA,mBAAc,CAAC,MAAM,EAAE;IACpC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACzD,IAAI,OAAO,EAAE,MAAM,uDAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,CAAC;;ICHM,MAAM,OAAO,SAASC,cAAS,CAAC;IACvC;IACA,IAAI,OAAO,CAAC,QAAQ,EAAE;IACtB,QAAQ,MAAM,IAAI,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC;IACnE,KAAK;IACL,IAAI,UAAU,GAAG;IACjB,QAAQ,MAAM,IAAI,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IACtE,KAAK;IACL,IAAI,WAAW,GAAG;IAClB,QAAQ,MAAM,IAAI,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC;IACvE,KAAK;IACL,IAAI,aAAa,GAAG;IACpB,QAAQ,MAAM,IAAI,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;IACzE,KAAK;IACL;;;;;;;ICdO,MAAM,WAAW,SAASA,cAAS,CAAC;IAC3C;IACA,IAAI,OAAO,CAAC,QAAQ,EAAE;IACtB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,oCAAoC,CAAC,CAAC;IACvE,KAAK;IACL,IAAI,UAAU,GAAG;IACjB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,uCAAuC,CAAC,CAAC;IAC1E,KAAK;IACL,IAAI,WAAW,GAAG;IAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,wCAAwC,CAAC,CAAC;IAC3E,KAAK;IACL,IAAI,aAAa,GAAG;IACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,0CAA0C,CAAC,CAAC;IAC7E,KAAK;IACL;;;;;;;;;;;;;;;;;"}

package/ios/Plugin/Asam.swift

@@ -0,0 +1,58 @@
+import Foundation
+import UIKit
+
+/// Protocol abstracting Guided Access operations for testability.
+public protocol GuidedAccessProvider {
+    func requestGuidedAccessSession(enabled: Bool) async -> Bool
+    var isGuidedAccessEnabled: Bool { get }
+}
+
+/// Default implementation using UIAccessibility system APIs.
+public struct SystemGuidedAccessProvider: GuidedAccessProvider {
+    public init() {}
+
+    @MainActor
+    public func requestGuidedAccessSession(enabled: Bool) async -> Bool {
+        await withCheckedContinuation { continuation in
+            UIAccessibility.requestGuidedAccessSession(enabled: enabled) { success in
+                continuation.resume(returning: success)
+            }
+        }
+    }
+
+    @MainActor
+    public var isGuidedAccessEnabled: Bool {
+        UIAccessibility.isGuidedAccessEnabled
+    }
+}
+
+@objc public class Asam: NSObject {
+    private let provider: GuidedAccessProvider
+
+    public init(provider: GuidedAccessProvider = SystemGuidedAccessProvider()) {
+        self.provider = provider
+    }
+
+    @objc public func setASAM(_ enable: Bool, completion: @escaping (Bool) -> Void) {
+        Task { @MainActor in
+            let success = await provider.requestGuidedAccessSession(enabled: enable)
+            print("From Native -> ASAM requested to be \(enable ? "enabled" : "disabled").")
+            print("From Native -> ASAM is \(success ? "enabled" : "disabled").")
+            completion(success)
+        }
+    }
+
+    @objc public func enableASAM(completion: @escaping (Bool) -> Void) {
+        setASAM(true, completion: completion)
+    }
+
+    @objc public func disableASAM(completion: @escaping (Bool) -> Void) {
+        setASAM(false, completion: completion)
+    }
+
+    @objc public func isASAMEnabled(_ callback: @escaping (Bool) -> Void) {
+        Task { @MainActor in
+            callback(provider.isGuidedAccessEnabled)
+        }
+    }
+}

package/ios/Plugin/AsamPlugin.h

@@ -0,0 +1,10 @@
+#import <UIKit/UIKit.h>
+
+//! Project version number for Plugin.
+FOUNDATION_EXPORT double PluginVersionNumber;
+
+//! Project version string for Plugin.
+FOUNDATION_EXPORT const unsigned char PluginVersionString[];
+
+// In this header, you should import all the public headers of your framework using statements like #import <Plugin/PublicHeader.h>
+

package/ios/Plugin/AsamPlugin.m

@@ -0,0 +1,11 @@
+#import <Foundation/Foundation.h>
+#import <Capacitor/Capacitor.h>
+
+// Define the plugin using the CAP_PLUGIN Macro, and
+// each method the plugin supports using the CAP_PLUGIN_METHOD macro.
+CAP_PLUGIN(AsamPlugin, "Asam",
+    CAP_PLUGIN_METHOD(setASAM, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(enableASAM, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(disableASAM, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(isASAMEnabled, CAPPluginReturnPromise);
+)

package/ios/Plugin/AsamPlugin.swift

@@ -0,0 +1,45 @@
+import Foundation
+import Capacitor
+
+/**
+ * Please read the Capacitor iOS Plugin Development Guide
+ * here: https://capacitorjs.com/docs/plugins/ios
+ */
+@objc(AsamPlugin)
+public class AsamPlugin: CAPPlugin {
+    private let implementation = Asam()
+
+    @objc func setASAM(_ call: CAPPluginCall) {
+        let enable = call.getBool("enable") ?? false
+
+        implementation.setASAM(enable, completion: { success in
+            call.resolve([
+                "success": success
+            ])
+        })
+    }
+
+    @objc func enableASAM(_ call: CAPPluginCall) {
+        implementation.setASAM(true, completion: { success in
+            call.resolve([
+                "success": success
+            ])
+        })
+    }
+
+    @objc func disableASAM(_ call: CAPPluginCall) {
+        implementation.setASAM(false, completion: { success in
+            call.resolve([
+                "success": success
+            ])
+        })
+    }
+
+    @objc func isASAMEnabled(_ call: CAPPluginCall) {
+        implementation.isASAMEnabled { enabled in
+            call.resolve([
+                "enabled": enabled
+            ])
+        }
+    }
+}

package/ios/Plugin/Info.plist

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+</dict>
+</plist>

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@dimer47/capacitor-plugin-asam",
+  "version": "2.0.0",
+  "description": "Easily integrate Autonomous Single App Mode in your app, allowing it to control Single App Mode sessions for focused, distraction-free user experiences. Ideal for educational, testing, or kiosk applications.",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "dist/",
+    "ios/Plugin/",
+    "CapacitorPluginAsam.podspec"
+  ],
+  "author": "Dimer47",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dimer47/capacitor-plugin-asam.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dimer47/capacitor-plugin-asam/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:web",
+    "verify:ios": "cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..",
+    "verify:web": "npm run build",
+    "test": "cd ios && pod install && xcodebuild test -workspace Plugin.xcworkspace -scheme Plugin -destination 'platform=iOS Simulator,name=iPhone 17 Pro,OS=latest' && cd ..",
+    "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}\"",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api AsamPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.js",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^8.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.0.18",
+    "@capacitor/ios": "^8.0.0",
+    "@ionic/eslint-config": "^0.3.0",
+    "@ionic/prettier-config": "^1.0.1",
+    "@ionic/swiftlint-config": "^1.1.2",
+    "eslint": "^7.11.0",
+    "prettier": "~2.3.0",
+    "prettier-plugin-java": "~1.0.2",
+    "rimraf": "^3.0.2",
+    "rollup": "^2.32.0",
+    "swiftlint": "^1.0.1",
+    "typescript": "~4.1.5"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=5.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    }
+  }
+}