@cap-kit/test-plugin 0.1.2 → 1.0.1

package/dist/plugin.cjs.js

@@ -2,6 +2,31 @@
 
 var core = require('@capacitor/core');
 
+/// <reference types="@capacitor/cli" />
+/**
+ * Standardized error codes used by the Test plugin.
+ *
+ * These codes are returned as part of structured error objects
+ * and allow consumers to implement programmatic error handling.
+ *
+ * Note:
+ * On iOS (Swift Package Manager), errors are returned as data
+ * objects rather than rejected Promises.
+ *
+ * @since 1.0.0
+ */
+exports.TestErrorCode = void 0;
+(function (TestErrorCode) {
+    /** The device does not have the requested hardware. */
+    TestErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+    /** The user denied the permission or the feature is disabled in settings. */
+    TestErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /** The test plugin failed to initialize (e.g., runtime error or Looper failure). */
+    TestErrorCode["INIT_FAILED"] = "INIT_FAILED";
+    /** The requested test plugin type is not valid or not supported by the plugin. */
+    TestErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+})(exports.TestErrorCode || (exports.TestErrorCode = {}));
+
 /**
  * @file index.ts
  * This file exports the TestPlugin and registers it with Capacitor.
@@ -9,34 +34,29 @@ var core = require('@capacitor/core');
  * across different platforms, including web.
  */
 /**
- * Test Capacitor plugin instance.
- * This instance is registered with Capacitor using the `registerPlugin` function,
- * making it accessible through the Capacitor runtime. It dynamically loads the
- * web implementation when needed.
+ * Main entry point for the Test Capacitor plugin.
+ *
+ * This file registers the plugin with Capacitor and exports
+ * both the runtime instance and the public TypeScript types.
  */
 const Test = core.registerPlugin('Test', {
-    /**
-     * Dynamically imports the web implementation of the plugin.
-     * The `web` option provides a fallback for web environments,
-     * ensuring platform-specific implementations can be used seamlessly.
-     *
-     * @returns A promise resolving to the web implementation of the plugin.
-     */
     web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.TestWeb()),
 });
 
 /**
- * @file web.ts
- * This file contains the web implementation of the TestPlugin.
- * It defines a class that extends the WebPlugin class and implements the
- * TestPlugin interface, providing the required functionality for web platforms.
- */
-/**
- * Class representing the web implementation of the TestPlugin.
- * This class extends the WebPlugin class and implements the TestPlugin interface.
- * It provides a base implementation for web-based functionality of the plugin.
+ * Web implementation of the Test plugin.
+ *
+ * This implementation exists primarily to satisfy Capacitor's
+ * multi-platform contract and to allow usage in browser-based
+ * environments.
+ *
+ * Native-only features may be unavailable on Web.
  */
 class TestWeb extends core.WebPlugin {
+    constructor() {
+        super();
+    }
+    // --- Echo Method ---
     /**
      * Echoes a value back for the web platform.
      * This method is a basic implementation example, primarily for testing
@@ -44,14 +64,6 @@ class TestWeb extends core.WebPlugin {
      *
      * @param options - An object containing a `value` property to be echoed back.
      * @returns A promise resolving to an object containing the echoed `value`.
-     *
-     * @example
-     * ```typescript
-     * import { Test } from '@cap-kit/test-plugin';
-     *
-     * const result = await Test.echo({ value: 'Hello, World!' });
-     * console.log(result.value); // Output: 'Hello, World!'
-     * ```
      */
     async echo(options) {
         console.log('ECHO', options);
@@ -60,22 +72,25 @@ class TestWeb extends core.WebPlugin {
         // from a global config object if your app exposes one.
         return options;
     }
+    // --- App Settings ---
     /**
-     * Get the native Capacitor plugin version.
-     *
-     * @returns Promise that resolves with the plugin version
-     * @throws Error if getting the version fails
+     * Opens the app settings page.
+     * On Web, this is not applicable.
      *
-     * @example
-     * ```typescript
-     * import { Test } from '@cap-kit/test-plugin';
+     * @returns A promise that resolves when the operation is complete.
+     */
+    async openAppSettings() {
+        console.warn('Test: openAppSettings is not available on Web.');
+        return this.unimplemented('Not implemented on Web.');
+    }
+    // --- Plugin Info ---
+    /**
+     * Returns the plugin version.
      *
-     * const version = await Test.getPluginVersion();
-     * console.log(version.version); // Output: 'web'
-     * ```
+     * @returns The current plugin version.
      */
     async getPluginVersion() {
-        return { version: 'web' };
+        return { version: 'web-1.0.0' };
     }
 }
 

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["/**\n * @file index.ts\n * This file exports the TestPlugin and registers it with Capacitor.\n * It acts as the main entry point for accessing the plugin's functionality\n * across different platforms, including web.\n */\nimport { registerPlugin } from '@capacitor/core';\n/**\n * Test Capacitor plugin instance.\n * This instance is registered with Capacitor using the `registerPlugin` function,\n * making it accessible through the Capacitor runtime. It dynamically loads the\n * web implementation when needed.\n */\nconst Test = registerPlugin('Test', {\n    /**\n     * Dynamically imports the web implementation of the plugin.\n     * The `web` option provides a fallback for web environments,\n     * ensuring platform-specific implementations can be used seamlessly.\n     *\n     * @returns A promise resolving to the web implementation of the plugin.\n     */\n    web: () => import('./web').then((m) => new m.TestWeb()),\n});\n// Export the definitions from 'definitions.ts' for external use.\n// These exports allow users to directly use the types and interfaces\n// defined for the TestPlugin.\nexport * from './definitions';\n// Export the registered TestPlugin instance.\n// This makes the plugin instance available for import in other modules.\nexport { Test };\n//# sourceMappingURL=index.js.map","/**\n * @file web.ts\n * This file contains the web implementation of the TestPlugin.\n * It defines a class that extends the WebPlugin class and implements the\n * TestPlugin interface, providing the required functionality for web platforms.\n */\nimport { WebPlugin } from '@capacitor/core';\n/**\n * Class representing the web implementation of the TestPlugin.\n * This class extends the WebPlugin class and implements the TestPlugin interface.\n * It provides a base implementation for web-based functionality of the plugin.\n */\nexport class TestWeb extends WebPlugin {\n    /**\n     * Echoes a value back for the web platform.\n     * This method is a basic implementation example, primarily for testing\n     * or validating communication with the plugin.\n     *\n     * @param options - An object containing a `value` property to be echoed back.\n     * @returns A promise resolving to an object containing the echoed `value`.\n     *\n     * @example\n     * ```typescript\n     * import { Test } from '@cap-kit/test-plugin';\n     *\n     * const result = await Test.echo({ value: 'Hello, World!' });\n     * console.log(result.value); // Output: 'Hello, World!'\n     * ```\n     */\n    async echo(options) {\n        console.log('ECHO', options);\n        // Note: On the web, reading 'capacitor.config.ts' requires specific build setups.\n        // We pass the value through as-is for parity, or you can implement logic to read\n        // from a global config object if your app exposes one.\n        return options;\n    }\n    /**\n     * Get the native Capacitor plugin version.\n     *\n     * @returns Promise that resolves with the plugin version\n     * @throws Error if getting the version fails\n     *\n     * @example\n     * ```typescript\n     * import { Test } from '@cap-kit/test-plugin';\n     *\n     * const version = await Test.getPluginVersion();\n     * console.log(version.version); // Output: 'web'\n     * ```\n     */\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACK,MAAC,IAAI,GAAGA,mBAAc,CAAC,MAAM,EAAE;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3D,CAAC;;ACtBD;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACO,MAAM,OAAO,SAASC,cAAS,CAAC;AACvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE;AACxB,QAAQ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;AACpC;AACA;AACA;AACA,QAAQ,OAAO,OAAO;AACtB,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;AACjC,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n/**\n * Standardized error codes used by the Test plugin.\n *\n * These codes are returned as part of structured error objects\n * and allow consumers to implement programmatic error handling.\n *\n * Note:\n * On iOS (Swift Package Manager), errors are returned as data\n * objects rather than rejected Promises.\n *\n * @since 1.0.0\n */\nexport var TestErrorCode;\n(function (TestErrorCode) {\n    /** The device does not have the requested hardware. */\n    TestErrorCode[\"UNAVAILABLE\"] = \"UNAVAILABLE\";\n    /** The user denied the permission or the feature is disabled in settings. */\n    TestErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The test plugin failed to initialize (e.g., runtime error or Looper failure). */\n    TestErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** The requested test plugin type is not valid or not supported by the plugin. */\n    TestErrorCode[\"UNKNOWN_TYPE\"] = \"UNKNOWN_TYPE\";\n})(TestErrorCode || (TestErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","/**\n * @file index.ts\n * This file exports the TestPlugin and registers it with Capacitor.\n * It acts as the main entry point for accessing the plugin's functionality\n * across different platforms, including web.\n */\nimport { registerPlugin } from '@capacitor/core';\n/**\n * Main entry point for the Test Capacitor plugin.\n *\n * This file registers the plugin with Capacitor and exports\n * both the runtime instance and the public TypeScript types.\n */\nconst Test = registerPlugin('Test', {\n    web: () => import('./web').then((m) => new m.TestWeb()),\n});\nexport * from './definitions';\nexport { Test };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the Test plugin.\n *\n * This implementation exists primarily to satisfy Capacitor's\n * multi-platform contract and to allow usage in browser-based\n * environments.\n *\n * Native-only features may be unavailable on Web.\n */\nexport class TestWeb extends WebPlugin {\n    constructor() {\n        super();\n    }\n    // --- Echo Method ---\n    /**\n     * Echoes a value back for the web platform.\n     * This method is a basic implementation example, primarily for testing\n     * or validating communication with the plugin.\n     *\n     * @param options - An object containing a `value` property to be echoed back.\n     * @returns A promise resolving to an object containing the echoed `value`.\n     */\n    async echo(options) {\n        console.log('ECHO', options);\n        // Note: On the web, reading 'capacitor.config.ts' requires specific build setups.\n        // We pass the value through as-is for parity, or you can implement logic to read\n        // from a global config object if your app exposes one.\n        return options;\n    }\n    // --- App Settings ---\n    /**\n     * Opens the app settings page.\n     * On Web, this is not applicable.\n     *\n     * @returns A promise that resolves when the operation is complete.\n     */\n    async openAppSettings() {\n        console.warn('Test: openAppSettings is not available on Web.');\n        return this.unimplemented('Not implemented on Web.');\n    }\n    // --- Plugin Info ---\n    /**\n     * Returns the plugin version.\n     *\n     * @returns The current plugin version.\n     */\n    async getPluginVersion() {\n        return { version: 'web-1.0.0' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["TestErrorCode","registerPlugin","WebPlugin"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACWA;AACX,CAAC,UAAU,aAAa,EAAE;AAC1B;AACA,IAAI,aAAa,CAAC,aAAa,CAAC,GAAG,aAAa;AAChD;AACA,IAAI,aAAa,CAAC,mBAAmB,CAAC,GAAG,mBAAmB;AAC5D;AACA,IAAI,aAAa,CAAC,aAAa,CAAC,GAAG,aAAa;AAChD;AACA,IAAI,aAAa,CAAC,cAAc,CAAC,GAAG,cAAc;AAClD,CAAC,EAAEA,qBAAa,KAAKA,qBAAa,GAAG,EAAE,CAAC,CAAC;;ACvBzC;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACK,MAAC,IAAI,GAAGC,mBAAc,CAAC,MAAM,EAAE;AACpC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3D,CAAC;;ACdD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,OAAO,SAASC,cAAS,CAAC;AACvC,IAAI,WAAW,GAAG;AAClB,QAAQ,KAAK,EAAE;AACf,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE;AACxB,QAAQ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;AACpC;AACA;AACA;AACA,QAAQ,OAAO,OAAO;AACtB,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,eAAe,GAAG;AAC5B,QAAQ,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC;AACtE,QAAQ,OAAO,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC5D,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE;AACvC,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -1,6 +1,31 @@
 var capacitorTest = (function (exports, core) {
     'use strict';
 
+    /// <reference types="@capacitor/cli" />
+    /**
+     * Standardized error codes used by the Test plugin.
+     *
+     * These codes are returned as part of structured error objects
+     * and allow consumers to implement programmatic error handling.
+     *
+     * Note:
+     * On iOS (Swift Package Manager), errors are returned as data
+     * objects rather than rejected Promises.
+     *
+     * @since 1.0.0
+     */
+    exports.TestErrorCode = void 0;
+    (function (TestErrorCode) {
+        /** The device does not have the requested hardware. */
+        TestErrorCode["UNAVAILABLE"] = "UNAVAILABLE";
+        /** The user denied the permission or the feature is disabled in settings. */
+        TestErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+        /** The test plugin failed to initialize (e.g., runtime error or Looper failure). */
+        TestErrorCode["INIT_FAILED"] = "INIT_FAILED";
+        /** The requested test plugin type is not valid or not supported by the plugin. */
+        TestErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+    })(exports.TestErrorCode || (exports.TestErrorCode = {}));
+
     /**
      * @file index.ts
      * This file exports the TestPlugin and registers it with Capacitor.
@@ -8,34 +33,29 @@ var capacitorTest = (function (exports, core) {
      * across different platforms, including web.
      */
     /**
-     * Test Capacitor plugin instance.
-     * This instance is registered with Capacitor using the `registerPlugin` function,
-     * making it accessible through the Capacitor runtime. It dynamically loads the
-     * web implementation when needed.
+     * Main entry point for the Test Capacitor plugin.
+     *
+     * This file registers the plugin with Capacitor and exports
+     * both the runtime instance and the public TypeScript types.
      */
     const Test = core.registerPlugin('Test', {
-        /**
-         * Dynamically imports the web implementation of the plugin.
-         * The `web` option provides a fallback for web environments,
-         * ensuring platform-specific implementations can be used seamlessly.
-         *
-         * @returns A promise resolving to the web implementation of the plugin.
-         */
         web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.TestWeb()),
     });
 
     /**
-     * @file web.ts
-     * This file contains the web implementation of the TestPlugin.
-     * It defines a class that extends the WebPlugin class and implements the
-     * TestPlugin interface, providing the required functionality for web platforms.
-     */
-    /**
-     * Class representing the web implementation of the TestPlugin.
-     * This class extends the WebPlugin class and implements the TestPlugin interface.
-     * It provides a base implementation for web-based functionality of the plugin.
+     * Web implementation of the Test plugin.
+     *
+     * This implementation exists primarily to satisfy Capacitor's
+     * multi-platform contract and to allow usage in browser-based
+     * environments.
+     *
+     * Native-only features may be unavailable on Web.
      */
     class TestWeb extends core.WebPlugin {
+        constructor() {
+            super();
+        }
+        // --- Echo Method ---
         /**
          * Echoes a value back for the web platform.
          * This method is a basic implementation example, primarily for testing
@@ -43,14 +63,6 @@ var capacitorTest = (function (exports, core) {
          *
          * @param options - An object containing a `value` property to be echoed back.
          * @returns A promise resolving to an object containing the echoed `value`.
-         *
-         * @example
-         * ```typescript
-         * import { Test } from '@cap-kit/test-plugin';
-         *
-         * const result = await Test.echo({ value: 'Hello, World!' });
-         * console.log(result.value); // Output: 'Hello, World!'
-         * ```
          */
         async echo(options) {
             console.log('ECHO', options);
@@ -59,22 +71,25 @@ var capacitorTest = (function (exports, core) {
             // from a global config object if your app exposes one.
             return options;
         }
+        // --- App Settings ---
         /**
-         * Get the native Capacitor plugin version.
-         *
-         * @returns Promise that resolves with the plugin version
-         * @throws Error if getting the version fails
+         * Opens the app settings page.
+         * On Web, this is not applicable.
          *
-         * @example
-         * ```typescript
-         * import { Test } from '@cap-kit/test-plugin';
+         * @returns A promise that resolves when the operation is complete.
+         */
+        async openAppSettings() {
+            console.warn('Test: openAppSettings is not available on Web.');
+            return this.unimplemented('Not implemented on Web.');
+        }
+        // --- Plugin Info ---
+        /**
+         * Returns the plugin version.
          *
-         * const version = await Test.getPluginVersion();
-         * console.log(version.version); // Output: 'web'
-         * ```
+         * @returns The current plugin version.
          */
         async getPluginVersion() {
-            return { version: 'web' };
+            return { version: 'web-1.0.0' };
         }
     }
 

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["/**\n * @file index.ts\n * This file exports the TestPlugin and registers it with Capacitor.\n * It acts as the main entry point for accessing the plugin's functionality\n * across different platforms, including web.\n */\nimport { registerPlugin } from '@capacitor/core';\n/**\n * Test Capacitor plugin instance.\n * This instance is registered with Capacitor using the `registerPlugin` function,\n * making it accessible through the Capacitor runtime. It dynamically loads the\n * web implementation when needed.\n */\nconst Test = registerPlugin('Test', {\n    /**\n     * Dynamically imports the web implementation of the plugin.\n     * The `web` option provides a fallback for web environments,\n     * ensuring platform-specific implementations can be used seamlessly.\n     *\n     * @returns A promise resolving to the web implementation of the plugin.\n     */\n    web: () => import('./web').then((m) => new m.TestWeb()),\n});\n// Export the definitions from 'definitions.ts' for external use.\n// These exports allow users to directly use the types and interfaces\n// defined for the TestPlugin.\nexport * from './definitions';\n// Export the registered TestPlugin instance.\n// This makes the plugin instance available for import in other modules.\nexport { Test };\n//# sourceMappingURL=index.js.map","/**\n * @file web.ts\n * This file contains the web implementation of the TestPlugin.\n * It defines a class that extends the WebPlugin class and implements the\n * TestPlugin interface, providing the required functionality for web platforms.\n */\nimport { WebPlugin } from '@capacitor/core';\n/**\n * Class representing the web implementation of the TestPlugin.\n * This class extends the WebPlugin class and implements the TestPlugin interface.\n * It provides a base implementation for web-based functionality of the plugin.\n */\nexport class TestWeb extends WebPlugin {\n    /**\n     * Echoes a value back for the web platform.\n     * This method is a basic implementation example, primarily for testing\n     * or validating communication with the plugin.\n     *\n     * @param options - An object containing a `value` property to be echoed back.\n     * @returns A promise resolving to an object containing the echoed `value`.\n     *\n     * @example\n     * ```typescript\n     * import { Test } from '@cap-kit/test-plugin';\n     *\n     * const result = await Test.echo({ value: 'Hello, World!' });\n     * console.log(result.value); // Output: 'Hello, World!'\n     * ```\n     */\n    async echo(options) {\n        console.log('ECHO', options);\n        // Note: On the web, reading 'capacitor.config.ts' requires specific build setups.\n        // We pass the value through as-is for parity, or you can implement logic to read\n        // from a global config object if your app exposes one.\n        return options;\n    }\n    /**\n     * Get the native Capacitor plugin version.\n     *\n     * @returns Promise that resolves with the plugin version\n     * @throws Error if getting the version fails\n     *\n     * @example\n     * ```typescript\n     * import { Test } from '@cap-kit/test-plugin';\n     *\n     * const version = await Test.getPluginVersion();\n     * console.log(version.version); // Output: 'web'\n     * ```\n     */\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;IAAA;IACA;IACA;IACA;IACA;IACA;IAEA;IACA;IACA;IACA;IACA;IACA;AACK,UAAC,IAAI,GAAGA,mBAAc,CAAC,MAAM,EAAE;IACpC;IACA;IACA;IACA;IACA;IACA;IACA;IACA,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC;;ICtBD;IACA;IACA;IACA;IACA;IACA;IAEA;IACA;IACA;IACA;IACA;IACO,MAAM,OAAO,SAASC,cAAS,CAAC;IACvC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE;IACxB,QAAQ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IACpC;IACA;IACA;IACA,QAAQ,OAAO,OAAO;IACtB,IAAI;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;IACjC,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n/**\n * Standardized error codes used by the Test plugin.\n *\n * These codes are returned as part of structured error objects\n * and allow consumers to implement programmatic error handling.\n *\n * Note:\n * On iOS (Swift Package Manager), errors are returned as data\n * objects rather than rejected Promises.\n *\n * @since 1.0.0\n */\nexport var TestErrorCode;\n(function (TestErrorCode) {\n    /** The device does not have the requested hardware. */\n    TestErrorCode[\"UNAVAILABLE\"] = \"UNAVAILABLE\";\n    /** The user denied the permission or the feature is disabled in settings. */\n    TestErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The test plugin failed to initialize (e.g., runtime error or Looper failure). */\n    TestErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** The requested test plugin type is not valid or not supported by the plugin. */\n    TestErrorCode[\"UNKNOWN_TYPE\"] = \"UNKNOWN_TYPE\";\n})(TestErrorCode || (TestErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","/**\n * @file index.ts\n * This file exports the TestPlugin and registers it with Capacitor.\n * It acts as the main entry point for accessing the plugin's functionality\n * across different platforms, including web.\n */\nimport { registerPlugin } from '@capacitor/core';\n/**\n * Main entry point for the Test Capacitor plugin.\n *\n * This file registers the plugin with Capacitor and exports\n * both the runtime instance and the public TypeScript types.\n */\nconst Test = registerPlugin('Test', {\n    web: () => import('./web').then((m) => new m.TestWeb()),\n});\nexport * from './definitions';\nexport { Test };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the Test plugin.\n *\n * This implementation exists primarily to satisfy Capacitor's\n * multi-platform contract and to allow usage in browser-based\n * environments.\n *\n * Native-only features may be unavailable on Web.\n */\nexport class TestWeb extends WebPlugin {\n    constructor() {\n        super();\n    }\n    // --- Echo Method ---\n    /**\n     * Echoes a value back for the web platform.\n     * This method is a basic implementation example, primarily for testing\n     * or validating communication with the plugin.\n     *\n     * @param options - An object containing a `value` property to be echoed back.\n     * @returns A promise resolving to an object containing the echoed `value`.\n     */\n    async echo(options) {\n        console.log('ECHO', options);\n        // Note: On the web, reading 'capacitor.config.ts' requires specific build setups.\n        // We pass the value through as-is for parity, or you can implement logic to read\n        // from a global config object if your app exposes one.\n        return options;\n    }\n    // --- App Settings ---\n    /**\n     * Opens the app settings page.\n     * On Web, this is not applicable.\n     *\n     * @returns A promise that resolves when the operation is complete.\n     */\n    async openAppSettings() {\n        console.warn('Test: openAppSettings is not available on Web.');\n        return this.unimplemented('Not implemented on Web.');\n    }\n    // --- Plugin Info ---\n    /**\n     * Returns the plugin version.\n     *\n     * @returns The current plugin version.\n     */\n    async getPluginVersion() {\n        return { version: 'web-1.0.0' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["TestErrorCode","registerPlugin","WebPlugin"],"mappings":";;;IAAA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;AACWA;IACX,CAAC,UAAU,aAAa,EAAE;IAC1B;IACA,IAAI,aAAa,CAAC,aAAa,CAAC,GAAG,aAAa;IAChD;IACA,IAAI,aAAa,CAAC,mBAAmB,CAAC,GAAG,mBAAmB;IAC5D;IACA,IAAI,aAAa,CAAC,aAAa,CAAC,GAAG,aAAa;IAChD;IACA,IAAI,aAAa,CAAC,cAAc,CAAC,GAAG,cAAc;IAClD,CAAC,EAAEA,qBAAa,KAAKA,qBAAa,GAAG,EAAE,CAAC,CAAC;;ICvBzC;IACA;IACA;IACA;IACA;IACA;IAEA;IACA;IACA;IACA;IACA;IACA;AACK,UAAC,IAAI,GAAGC,mBAAc,CAAC,MAAM,EAAE;IACpC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC;;ICdD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACO,MAAM,OAAO,SAASC,cAAS,CAAC;IACvC,IAAI,WAAW,GAAG;IAClB,QAAQ,KAAK,EAAE;IACf,IAAI;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE;IACxB,QAAQ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IACpC;IACA;IACA;IACA,QAAQ,OAAO,OAAO;IACtB,IAAI;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA,IAAI,MAAM,eAAe,GAAG;IAC5B,QAAQ,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC;IACtE,QAAQ,OAAO,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC5D,IAAI;IACJ;IACA;IACA;IACA;IACA;IACA;IACA,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE;IACvC,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/TestPlugin/Test.swift

@@ -1,19 +1,51 @@
 import Foundation
+import Capacitor
 
 /**
- * Native implementation for the Test Capacitor plugin.
- *
- * This class contains platform logic only and does not depend on Capacitor APIs.
+ Native implementation for the Test Capacitor plugin.
+
+ This class contains platform-specific logic only and MUST NOT:
+ - access CAPPluginCall
+ - interact directly with the Capacitor bridge
+ - depend on JavaScript concepts
+
+ The Capacitor plugin class is responsible for delegating work to this class.
  */
 @objc public class Test: NSObject {
+
+    // Properties
+    private var config: TestConfig?
+
+    // Initializer
+    override init() {
+        super.init()
+    }
+
+    // MARK: - Configuration
+
     /**
-     * Returns the provided string unchanged.
-     *
-     * @param value Input string.
-     * @return The same string.
+     Applies the plugin configuration.
+
+     This method should be called exactly once during plugin initialization.
+     Its responsibility is to translate configuration values into runtime
+     behavior (e.g. enabling verbose logging).
+     */
+    func applyConfig(_ config: TestConfig) {
+        self.config = config
+        TestLogger.verbose = config.verboseLogging
+        TestLogger.debug("Configuration applied. Verbose logging enabled.")
+    }
+
+    // MARK: - Echo Method
+
+    /**
+     Returns the provided value unchanged.
+
+     This method represents a simple synchronous native operation
+     and is intentionally side-effect free.
      */
     @objc public func echo(_ value: String) -> String {
-        log(value)
+        TestLogger.debug("Echoing value:", value)
         return value
     }
 }

package/ios/Sources/TestPlugin/TestConfig.swift

@@ -1,29 +1,72 @@
 import Foundation
+import Capacitor
 
 /**
- * Helper struct to manage the plugin configuration.
- * It parses the values from capacitor.config.json
+ Plugin configuration container.
+
+ This struct is responsible for reading and exposing static configuration
+ values defined under the `Test` key in `capacitor.config.ts`.
+
+ Configuration is:
+ - read once during plugin initialization
+ - treated as immutable runtime input
+ - consumed only by native code (never by JavaScript)
  */
 public struct TestConfig {
 
+    // MARK: - Configuration Keys
+
     // Define configuration keys for consistency
     private struct Keys {
+        static let verboseLogging = "verboseLogging"
         static let customMessage = "customMessage"
     }
 
+    // MARK: - Public Config Values
+
+    /**
+     Enables verbose native logging.
+
+     When enabled, additional debug information is printed
+     to the Xcode console via the plugin logger.
+
+     Default: false
+     */
+    public let verboseLogging: Bool
+
+    /**
+     Custom message appended to echoed values.
+
+     This property exists primarily for demonstration purposes and
+     shows how to pass static configuration values from JavaScript
+     to native code.
+
+     Default: " (from config)"
+     */
+    public let customMessage: String?
+
+    // MARK: - Private Defaults
+
     // Default values
+    private let defaultVerboseLogging = false
     private let defaultCustomMessage = " (from config)"
 
-    // Public accessible properties
-    public var customMessage: String
+    // MARK: - Init
 
     /**
-     * Initialize with the config dictionary from the plugin.
+     Initializes the configuration by reading values from the Capacitor bridge.
+
+     - Parameter plugin: The CAPPlugin instance used to access typed configuration.
      */
-    init(config: [AnyHashable: Any]?) {
-        let config = config ?? [:]
+    init(plugin: CAPPlugin) {
+        let config = plugin.getConfig()
+
+        // Bool
+        verboseLogging =
+            (config.value(forKey: Keys.verboseLogging) as? Bool) ?? defaultVerboseLogging
 
-        // Parse customMessage with a default fallback
-        self.customMessage = config[Keys.customMessage] as? String ?? defaultCustomMessage
+        // String
+        customMessage =
+            (config.value(forKey: Keys.customMessage) as? String) ?? defaultCustomMessage
     }
 }

package/ios/Sources/TestPlugin/TestPlugin.swift

@@ -2,33 +2,22 @@ import Foundation
 import Capacitor
 
 /**
- * This file defines the Capacitor bridge for the Test plugin.
- *
- * Documentation reference:
- * https://capacitorjs.com/docs/plugins/ios
- */
+ Capacitor bridge for the Test plugin.
 
+ This class represents the boundary between JavaScript and native iOS code.
+ Responsibilities include:
+ - reading plugin configuration
+ - handling CAPPluginCall objects
+ - delegating logic to the native implementation
+ */
 @objc(TestPlugin)
 public class TestPlugin: CAPPlugin, CAPBridgedPlugin {
 
     // Configuration instance
     private var config: TestConfig?
 
-    /**
-     * Called when the plugin is loaded.
-     */
-    override public func load() {
-        log("Loading plugin")
-        self.config = TestConfig(
-            config: self.getConfig() as? [String: Any] ?? [:]
-        )
-    }
-
-    /// Plugin version (Dynamic read from the Bundle Info.plist)
-    private var pluginVersion: String {
-        let bundle = Bundle(for: type(of: self))
-        return bundle.infoDictionary?["CFBundleShortVersionString"] as? String ?? "0.0.1"
-    }
+    /// An instance of the implementation class that contains the plugin's core functionality.
+    private let implementation = Test()
 
     /// The unique identifier for the plugin.
     public let identifier = "TestPlugin"
@@ -37,26 +26,49 @@ public class TestPlugin: CAPPlugin, CAPBridgedPlugin {
     public let jsName = "Test"
 
     /**
-     * A list of methods exposed by this plugin. These methods can be called from the JavaScript side.
-     * - `echo`: A method that accepts a string and returns the same string.
-     * - `getPluginVersion`: A method that returns the version of the plugin.
+     A list of methods exposed by this plugin. These methods can be called from the JavaScript side.
+     - `echo`: A method that accepts a string and returns the same string.
+     - `getPluginVersion`: A method that returns the version of the plugin.
+     - `openAppSettings`: A method that opens the app's settings page.
      */
     public let pluginMethods: [CAPPluginMethod] = [
         CAPPluginMethod(name: "echo", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "getPluginVersion", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "getPluginVersion", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "openAppSettings", returnType: CAPPluginReturnPromise)
     ]
 
-    /// An instance of the implementation class that contains the plugin's core functionality.
-    private let implementation = Test()
+    /**
+     Plugin lifecycle entry point.
+
+     Called once when the plugin is loaded by the Capacitor bridge.
+     This is the correct place to:
+     - read configuration values
+     - initialize native resources
+     - configure the implementation instance
+     */
+    override public func load() {
+        // Initialize TestConfig with the correct type
+        let cfg = TestConfig(plugin: self)
+        self.config = cfg
+        implementation.applyConfig(cfg)
+
+        // Log if verbose logging is enabled
+        TestLogger.debug("Test plugin loaded with config:", cfg)
+    }
+
+    // MARK: - Echo
 
     /**
-     * Echoes a string back to JavaScript.
-     *
-     * @param call Capacitor plugin call containing the `value` parameter.
+     Echoes a string back to JavaScript.
+
+     This method validates input, applies configuration-derived behavior,
+     and delegates the core logic to the native implementation.
      */
     @objc func echo(_ call: CAPPluginCall) {
         var value = call.getString("value", "")
-        log("Echoing value: \(value)")
+
+        // Log input only if verbose logging is enabled
+        TestLogger.debug("Echoing value:", value)
 
         // Append the custom message from the configuration
         if let configMessage = config?.customMessage {
@@ -68,10 +80,47 @@ public class TestPlugin: CAPPlugin, CAPBridgedPlugin {
         ])
     }
 
-    /**
-     * Returns the plugin version.
-     */
+    // MARK: - Version
+
+    /// Retrieves the plugin version from the bundle.
     @objc func getPluginVersion(_ call: CAPPluginCall) {
-        call.resolve(["version": self.pluginVersion])
+        let version = Bundle(for: type(of: self)).infoDictionary?["CFBundleShortVersionString"] as? String ?? "0.0.1"
+        call.resolve(["version": version])
+    }
+
+    // MARK: - Settings
+
+    /// Opens the iOS Settings app specifically for this application.
+    @objc func openAppSettings(_ call: CAPPluginCall) {
+        DispatchQueue.main.async(execute: DispatchWorkItem {
+            guard let settingsUrl = URL(string: UIApplication.openSettingsURLString) else {
+                call.resolve([
+                    "success": false,
+                    "error": "Cannot open settings URL",
+                    "code": "UNAVAILABLE"
+                ])
+                return
+            }
+
+            if UIApplication.shared.canOpenURL(settingsUrl) {
+                UIApplication.shared.open(settingsUrl, options: [:]) { success in
+                    if success {
+                        call.resolve()
+                    } else {
+                        call.resolve([
+                            "success": false,
+                            "error": "Failed to open settings",
+                            "code": "UNAVAILABLE"
+                        ])
+                    }
+                }
+            } else {
+                call.resolve([
+                    "success": false,
+                    "error": "Cannot open settings URL",
+                    "code": "UNAVAILABLE"
+                ])
+            }
+        })
     }
 }