@cap-kit/test-plugin 1.0.1 → 1.0.3

package/{TestPlugin.podspec → CapKitTest.podspec}

@@ -3,7 +3,7 @@ require 'json'
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 
 Pod::Spec.new do |s|
-  s.name = 'TestPlugin'
+  s.name = 'CapKitTest'
   s.version = package['version']
   s.summary = package['description']
   s.license = package['license']

package/Package.swift

@@ -2,12 +2,13 @@
 import PackageDescription
 
 let package = Package(
-    name: "TestPlugin",
+    name: "CapKitTest",
     platforms: [.iOS(.v15)],
     products: [
         .library(
-            name: "TestPlugin",
-            targets: ["TestPlugin"])
+            name: "CapKitTest",
+            targets: ["TestPlugin"]
+        )
     ],
     dependencies: [
         .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
@@ -17,8 +18,10 @@ let package = Package(
             name: "TestPlugin",
             dependencies: [
                 .product(name: "Capacitor", package: "capacitor-swift-pm"),
-                .product(name: "Cordova", package: "capacitor-swift-pm")            ],
-            path: "ios/Sources/TestPlugin"        ),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/TestPlugin"
+        ),
         .testTarget(
             name: "TestPluginTests",
             dependencies: ["TestPlugin"],

package/README.md

@@ -13,21 +13,31 @@
   </strong>
 </p>
 
-<p align="center">Test plugin for Cap-Kit.</p>
+<p align="center">
+  The <strong>architectural reference implementation</strong> for the Cap-Kit ecosystem.<br>
+  This package serves as the definitive <strong>boilerplate and validation ground</strong> for creating new Capacitor plugins.<br>
+  It demonstrates the enforced monorepo structure, build configuration, and native bridges (Swift/Kotlin) required by our standards.<br>
+  <em>Note: This is an internal reference package, primarily used for CI verification and scaffolding.</em>
+</p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@cap-kit/test-plugin">
-    <img src="https://img.shields.io/npm/v/@cap-kit/test-plugin?style=flat-square" />
+    <img src="https://img.shields.io/npm/v/@cap-kit/test-plugin?color=blue&label=npm&logo=npm&style=flat-square" alt="npm version">
   </a>
-  <a href="https://www.npmjs.com/package/@cap-kit/test-plugin">
-    <img src="https://img.shields.io/npm/dm/@cap-kit/test-plugin?style=flat-square" />
+  <a href="https://github.com/cap-kit/capacitor-plugins/actions">
+    <img src="https://img.shields.io/github/actions/workflow/status/cap-kit/capacitor-plugins/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" />
+  </a>
+  <a href="https://capacitorjs.com/">
+    <img src="https://img.shields.io/badge/Capacitor-Plugin-blue?logo=capacitor&style=flat-square" alt="Capacitor Plugin">
   </a>
   <a href="https://www.npmjs.com/package/@cap-kit/test-plugin">
-    <img src="https://img.shields.io/npm/l/@cap-kit/test-plugin?style=flat-square" />
+    <img src="https://img.shields.io/npm/dm/@cap-kit/test-plugin?style=flat-square" alt="Downloads" />
   </a>
-  <img src="https://img.shields.io/maintenance/yes/2026?style=flat-square" />
+  <a href="./LICENSE">
+    <img src="https://img.shields.io/npm/l/@cap-kit/test-plugin?style=flat-square&logo=open-source-initiative&logoColor=white&color=green" alt="License" />
+  </a>
+  <img src="https://img.shields.io/maintenance/yes/2026?style=flat-square" alt="Maintained" />
 </p>
-
 <br>
 
 ## Install
@@ -219,3 +229,21 @@ Result object returned by the `getPluginVersion()` method.
 ## Contributing
 
 Contributions are welcome! Please read the [contributing guide](CONTRIBUTING.md) before submitting a pull request.
+
+---
+
+## Credits
+
+This plugin is based on prior work from the Community and
+has been refactored and modernized for **Capacitor v8** and
+**Swift Package Manager** compatibility.
+
+Original inspiration:
+
+- [https://github.com/](https://github.com/)
+
+---
+
+## License
+
+MIT

package/android/src/main/java/io/capkit/test/{Test.kt → TestImpl.kt}

@@ -1,7 +1,7 @@
 package io.capkit.test
 
 import android.content.Context
-import io.capkit.test.utils.Logger
+import io.capkit.test.utils.TestLogger
 
 /**
  * Platform-specific native implementation for the Test plugin.
@@ -14,7 +14,7 @@ import io.capkit.test.utils.Logger
  * - handling PluginCall objects
  * - delegating logic to this implementation
  */
-class Test(
+class TestImpl(
   private val context: Context,
 ) {
   /**
@@ -32,8 +32,11 @@ class Test(
    */
   fun updateConfig(newConfig: TestConfig) {
     this.config = newConfig
-    Logger.verbose = this.config.verboseLogging
-    Logger.debug("Configuration updated. Verbose logging: ${this.config.verboseLogging}")
+    TestLogger.verbose = newConfig.verboseLogging
+    TestLogger.debug(
+      "Configuration applied. Verbose logging:",
+      newConfig.verboseLogging.toString(),
+    )
   }
 
   /**
@@ -43,7 +46,7 @@ class Test(
    * and is intentionally side-effect free.
    */
   fun echo(value: String): String {
-    Logger.debug(value)
+    TestLogger.debug(value)
     return value
   }
 

package/android/src/main/java/io/capkit/test/TestPlugin.kt

@@ -3,14 +3,11 @@ package io.capkit.test
 import android.content.Intent
 import android.net.Uri
 import android.provider.Settings
-import androidx.activity.result.ActivityResult
 import com.getcapacitor.JSObject
 import com.getcapacitor.Plugin
 import com.getcapacitor.PluginCall
 import com.getcapacitor.PluginMethod
-import com.getcapacitor.annotation.ActivityCallback
 import com.getcapacitor.annotation.CapacitorPlugin
-import io.capkit.test.utils.Logger
 
 /**
  * Capacitor bridge for the Test plugin.
@@ -33,7 +30,7 @@ class TestPlugin : Plugin() {
   /**
    * Native implementation containing platform logic.
    */
-  private lateinit var implementation: Test
+  private lateinit var implementation: TestImpl
 
   /**
    * Called once when the plugin is loaded by the Capacitor bridge.
@@ -47,11 +44,11 @@ class TestPlugin : Plugin() {
     super.load()
 
     config = TestConfig(this)
-    implementation = Test(context)
+    implementation = TestImpl(context)
     implementation.updateConfig(config)
   }
 
-  // --- ---
+  // --- Echo ---
 
   /**
    * Echoes a string back to JavaScript.
@@ -61,7 +58,6 @@ class TestPlugin : Plugin() {
   @PluginMethod
   fun echo(call: PluginCall) {
     var value = call.getString("value") ?: ""
-    Logger.debug("Echoing value: $value")
 
     // Append the custom message from the configuration
     value += config.customMessage
@@ -71,10 +67,10 @@ class TestPlugin : Plugin() {
     call.resolve(ret)
   }
 
-  // ---  Version ---
+  // --- Version ---
 
   /**
-   * Returns the plugin version.
+   * Returns the native plugin version.
    */
   @PluginMethod
   fun getPluginVersion(call: PluginCall) {
@@ -95,22 +91,30 @@ class TestPlugin : Plugin() {
       val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
       val uri = Uri.fromParts("package", context.packageName, null)
       intent.data = uri
-      startActivityForResult(call, intent, "openSettingsResult")
+      context.startActivity(intent)
       call.resolve()
     } catch (e: Exception) {
+      // NOTE:
+      // On Android, PluginCall.reject(...) is fully supported and correctly used here.
+      // However, this plugin is designed with a cross-platform, state-based API mindset
+      // to remain compatible with iOS when using Swift Package Manager (SPM),
+      // where Promise rejection is not reliably available.
+      //
+      // For this reason:
+      // - JavaScript consumers SHOULD NOT rely on try/catch for this method
+      // - Errors should be handled by inspecting resolved result states instead
+      //
+      // This reject() call is intentionally kept on Android to:
+      // - preserve native correctness
+      // - document the platform capability
+      // - avoid hiding real failures during development
+      //
+      // When extending this plugin, consider mirroring error semantics across platforms
+      // to keep the public JS API predictable and consistent.
       call.reject(
         "Failed to open settings",
         "UNAVAILABLE",
       )
     }
   }
-
-  @ActivityCallback
-  private fun openSettingsResult(
-    call: PluginCall,
-    result: ActivityResult,
-  ) {
-    // No-op, just to satisfy the callback requirement if needed
-    call.resolve()
-  }
 }

package/android/src/main/java/io/capkit/test/utils/{Logger.kt → TestLogger.kt}

@@ -5,13 +5,13 @@ import android.util.Log
 /**
  * Centralized logging utility for the Test plugin.
  *
- * This logger provides a single entry point for all native logs
+ * This logging provides a single entry point for all native logs
  * and supports runtime-controlled verbose logging.
  *
  * The goal is to avoid scattering `if (verbose)` checks across
  * business logic and keep logging behavior consistent.
  */
-object Logger {
+object TestLogger {
   /**
    * Logcat tag used for all plugin logs.
    * Helps filtering logs during debugging.

package/dist/esm/definitions.d.ts

@@ -70,11 +70,11 @@ export interface TestConfig {
 export declare enum TestErrorCode {
     /** The device does not have the requested hardware. */
     UNAVAILABLE = "UNAVAILABLE",
-    /** The user denied the permission or the feature is disabled in settings. */
+    /** The user denied the permission or the feature is disabled. */
     PERMISSION_DENIED = "PERMISSION_DENIED",
-    /** The test plugin failed to initialize (e.g., runtime error or Looper failure). */
+    /** The TestPlugin failed to initialize (e.g., runtime error or Looper failure). */
     INIT_FAILED = "INIT_FAILED",
-    /** The requested test plugin type is not valid or not supported by the plugin. */
+    /** The requested TestPlugin type is not valid or not supported by the plugin. */
     UNKNOWN_TYPE = "UNKNOWN_TYPE"
 }
 /**

package/dist/esm/definitions.js

@@ -15,11 +15,11 @@ export var TestErrorCode;
 (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. */
+    /** The user denied the permission or the feature is disabled. */
     TestErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
-    /** The test plugin failed to initialize (e.g., runtime error or Looper failure). */
+    /** The TestPlugin 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. */
+    /** The requested TestPlugin type is not valid or not supported by the plugin. */
     TestErrorCode["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
 })(TestErrorCode || (TestErrorCode = {}));
 //# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC;AA8DxC;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IACvB,uDAAuD;IACvD,4CAA2B,CAAA;IAC3B,6EAA6E;IAC7E,wDAAuC,CAAA;IACvC,oFAAoF;IACpF,4CAA2B,CAAA;IAC3B,kFAAkF;IAClF,8CAA6B,CAAA;AAC/B,CAAC,EATW,aAAa,KAAb,aAAa,QASxB"}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC;AA8DxC;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IACvB,uDAAuD;IACvD,4CAA2B,CAAA;IAC3B,iEAAiE;IACjE,wDAAuC,CAAA;IACvC,mFAAmF;IACnF,4CAA2B,CAAA;IAC3B,iFAAiF;IACjF,8CAA6B,CAAA;AAC/B,CAAC,EATW,aAAa,KAAb,aAAa,QASxB"}

package/dist/esm/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @file index.ts
- * This file exports the TestPlugin and registers it with Capacitor.
+ * This file exports the Test and registers it with Capacitor.
  * It acts as the main entry point for accessing the plugin's functionality
  * across different platforms, including web.
  */

package/dist/esm/index.js

@@ -1,6 +1,6 @@
 /**
  * @file index.ts
- * This file exports the TestPlugin and registers it with Capacitor.
+ * This file exports the Test and registers it with Capacitor.
  * It acts as the main entry point for accessing the plugin's functionality
  * across different platforms, including web.
  */

package/dist/esm/web.d.ts

@@ -1,5 +1,5 @@
 import { WebPlugin } from '@capacitor/core';
-import type { TestPlugin } from './definitions';
+import type { TestPlugin, EchoOptions, EchoResult, PluginVersionResult } from './definitions';
 /**
  * Web implementation of the Test plugin.
  *
@@ -19,11 +19,7 @@ export declare class TestWeb extends WebPlugin implements TestPlugin {
      * @param options - An object containing a `value` property to be echoed back.
      * @returns A promise resolving to an object containing the echoed `value`.
      */
-    echo(options: {
-        value: string;
-    }): Promise<{
-        value: string;
-    }>;
+    echo(options: EchoOptions): Promise<EchoResult>;
     /**
      * Opens the app settings page.
      * On Web, this is not applicable.
@@ -34,9 +30,8 @@ export declare class TestWeb extends WebPlugin implements TestPlugin {
     /**
      * Returns the plugin version.
      *
-     * @returns The current plugin version.
+     * On the Web, this value represents the JavaScript package version
+     * rather than a native implementation.
      */
-    getPluginVersion(): Promise<{
-        version: string;
-    }>;
+    getPluginVersion(): Promise<PluginVersionResult>;
 }

package/dist/esm/web.js

@@ -37,16 +37,18 @@ export class TestWeb extends WebPlugin {
      */
     async openAppSettings() {
         console.warn('Test: openAppSettings is not available on Web.');
+        // Rule: Unsupported methods MUST call this.unimplemented()
         return this.unimplemented('Not implemented on Web.');
     }
     // --- Plugin Info ---
     /**
      * Returns the plugin version.
      *
-     * @returns The current plugin version.
+     * On the Web, this value represents the JavaScript package version
+     * rather than a native implementation.
      */
     async getPluginVersion() {
-        return { version: 'web-1.0.0' };
+        return { version: 'web' };
     }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;;;;;;GAQG;AACH,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpC;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,sBAAsB;IAEtB;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,OAA0B;QACnC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,kFAAkF;QAClF,iFAAiF;QACjF,uDAAuD;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,uBAAuB;IAEvB;;;;;OAKG;IACH,KAAK,CAAC,eAAe;QACnB,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAU,CAAC;IAChE,CAAC;IAED,sBAAsB;IAEtB;;;;OAIG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;CACF"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;;;;;;GAQG;AACH,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpC;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,sBAAsB;IAEtB;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,OAAoB;QAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,kFAAkF;QAClF,iFAAiF;QACjF,uDAAuD;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,uBAAuB;IAEvB;;;;;OAKG;IACH,KAAK,CAAC,eAAe;QACnB,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC/D,2DAA2D;QAC3D,OAAO,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAU,CAAC;IAChE,CAAC;IAED,sBAAsB;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/plugin.cjs.js

@@ -19,17 +19,17 @@ 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. */
+    /** The user denied the permission or the feature is disabled. */
     TestErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
-    /** The test plugin failed to initialize (e.g., runtime error or Looper failure). */
+    /** The TestPlugin 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. */
+    /** The requested TestPlugin 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.
+ * This file exports the Test and registers it with Capacitor.
  * It acts as the main entry point for accessing the plugin's functionality
  * across different platforms, including web.
  */
@@ -81,16 +81,18 @@ class TestWeb extends core.WebPlugin {
      */
     async openAppSettings() {
         console.warn('Test: openAppSettings is not available on Web.');
+        // Rule: Unsupported methods MUST call this.unimplemented()
         return this.unimplemented('Not implemented on Web.');
     }
     // --- Plugin Info ---
     /**
      * Returns the plugin version.
      *
-     * @returns The current plugin version.
+     * On the Web, this value represents the JavaScript package version
+     * rather than a native implementation.
      */
     async getPluginVersion() {
-        return { version: 'web-1.0.0' };
+        return { version: 'web' };
     }
 }
 

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"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;;;;;;;;;"}
+{"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. */\n    TestErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The TestPlugin failed to initialize (e.g., runtime error or Looper failure). */\n    TestErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** The requested TestPlugin 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 Test 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        // Rule: Unsupported methods MUST call this.unimplemented()\n        return this.unimplemented('Not implemented on Web.');\n    }\n    // --- Plugin Info ---\n    /**\n     * Returns the plugin version.\n     *\n     * On the Web, this value represents the JavaScript package version\n     * rather than a native implementation.\n     */\n    async getPluginVersion() {\n        return { version: 'web' };\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;AACA,QAAQ,OAAO,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC5D,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;AACjC,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -18,17 +18,17 @@ var capacitorTest = (function (exports, core) {
     (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. */
+        /** The user denied the permission or the feature is disabled. */
         TestErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
-        /** The test plugin failed to initialize (e.g., runtime error or Looper failure). */
+        /** The TestPlugin 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. */
+        /** The requested TestPlugin 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.
+     * This file exports the Test and registers it with Capacitor.
      * It acts as the main entry point for accessing the plugin's functionality
      * across different platforms, including web.
      */
@@ -80,16 +80,18 @@ var capacitorTest = (function (exports, core) {
          */
         async openAppSettings() {
             console.warn('Test: openAppSettings is not available on Web.');
+            // Rule: Unsupported methods MUST call this.unimplemented()
             return this.unimplemented('Not implemented on Web.');
         }
         // --- Plugin Info ---
         /**
          * Returns the plugin version.
          *
-         * @returns The current plugin version.
+         * On the Web, this value represents the JavaScript package version
+         * rather than a native implementation.
          */
         async getPluginVersion() {
-            return { version: 'web-1.0.0' };
+            return { version: 'web' };
         }
     }
 

package/dist/plugin.js.map

@@ -1 +1 @@
-{"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;;;;;;;;;;;;;;;"}
+{"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. */\n    TestErrorCode[\"PERMISSION_DENIED\"] = \"PERMISSION_DENIED\";\n    /** The TestPlugin failed to initialize (e.g., runtime error or Looper failure). */\n    TestErrorCode[\"INIT_FAILED\"] = \"INIT_FAILED\";\n    /** The requested TestPlugin 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 Test 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        // Rule: Unsupported methods MUST call this.unimplemented()\n        return this.unimplemented('Not implemented on Web.');\n    }\n    // --- Plugin Info ---\n    /**\n     * Returns the plugin version.\n     *\n     * On the Web, this value represents the JavaScript package version\n     * rather than a native implementation.\n     */\n    async getPluginVersion() {\n        return { version: 'web' };\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;IACA,QAAQ,OAAO,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC5D,IAAI;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;IACjC,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/TestPlugin/{Test.swift → TestImpl.swift}

@@ -1,17 +1,14 @@
 import Foundation
-import Capacitor
 
 /**
- Native implementation for the Test Capacitor plugin.
+ Native iOS implementation for the Test plugin.
 
- This class contains platform-specific logic only and MUST NOT:
+ This class contains ONLY platform logic 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.
+ - depend on Capacitor
+ - perform mapping logic
  */
-@objc public class Test: NSObject {
+@objc public final class TestImpl: NSObject {
 
     // Properties
     private var config: TestConfig?
@@ -33,7 +30,7 @@ import Capacitor
     func applyConfig(_ config: TestConfig) {
         self.config = config
         TestLogger.verbose = config.verboseLogging
-        TestLogger.debug("Configuration applied. Verbose logging enabled.")
+        TestLogger.debug("Configuration applied. Verbose logging:", "\(config.verboseLogging)")
     }
 
     // MARK: - Echo Method

package/ios/Sources/TestPlugin/TestPlugin.swift

@@ -4,20 +4,19 @@ import Capacitor
 /**
  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
+ This file MUST:
+ - read input from CAPPluginCall
+ - delegate logic to TestImpl
+ - resolve calls using state-based results
  */
 @objc(TestPlugin)
-public class TestPlugin: CAPPlugin, CAPBridgedPlugin {
+public final class TestPlugin: CAPPlugin, CAPBridgedPlugin {
 
     // Configuration instance
     private var config: TestConfig?
 
     /// An instance of the implementation class that contains the plugin's core functionality.
-    private let implementation = Test()
+    private let implementation = TestImpl()
 
     /// The unique identifier for the plugin.
     public let identifier = "TestPlugin"
@@ -94,32 +93,21 @@ public class TestPlugin: CAPPlugin, CAPBridgedPlugin {
     @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"
-                ])
+                TestLogger.error("Cannot create settings URL")
+                call.resolve()
                 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"
-                        ])
+                    if !success {
+                        TestLogger.error("Failed to open app settings")
                     }
+                    call.resolve()
                 }
             } else {
-                call.resolve([
-                    "success": false,
-                    "error": "Cannot open settings URL",
-                    "code": "UNAVAILABLE"
-                ])
+                TestLogger.error("Cannot open settings URL")
+                call.resolve()
             }
         })
     }

package/ios/Tests/TestPluginTests/TestPluginTests.swift

@@ -1,12 +1,18 @@
 import XCTest
 @testable import TestPlugin
 
+/**
+ Basic functional tests for the Test plugin native implementation.
+
+ These tests validate the core behavior of the implementation
+ independently from the Capacitor bridge.
+ */
 class TestTests: 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 = Test()
+        let implementation = TestImpl()
         let value = "Hello, World!"
         let result = implementation.echo(value)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cap-kit/test-plugin",
-  "version": "1.0.1",
-  "description": "Test plugin for Cap-Kit.",
+  "version": "1.0.3",
+  "description": "Architectural reference and boilerplate for Cap-Kit plugins.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
   "types": "dist/esm/index.d.ts",
@@ -13,7 +13,7 @@
     "ios/Sources",
     "ios/Tests",
     "Package.swift",
-    "TestPlugin.podspec",
+    "CapKitTest.podspec",
     "LICENSE"
   ],
   "author": "Fabio Martino",
@@ -68,7 +68,7 @@
   },
   "scripts": {
     "verify": "pnpm run verify:ios && pnpm run verify:android && pnpm run verify:web",
-    "verify:ios": "xcodebuild -scheme TestPlugin -destination generic/platform=iOS",
+    "verify:ios": "xcodebuild -scheme CapKitTest -destination generic/platform=iOS",
     "verify:android": "cd android && ./gradlew clean build test && cd ..",
     "verify:web": "pnpm run build",
     "lint:android": "cd android && ./gradlew ktlintCheck",