@cap-kit/test-plugin 1.0.2 → 5.0.0

package/{CapKitTest.podspec → CapKitTestPlugin.podspec}

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

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Fabio Martino
+Copyright (c) 2026 CapKit Team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/Package.swift

@@ -2,12 +2,12 @@
 import PackageDescription
 
 let package = Package(
-    name: "CapKitTest",
+    name: "CapKitTestPlugin",
     platforms: [.iOS(.v15)],
     products: [
         .library(
-            name: "CapKitTest",
-            targets: ["TestPlugin"]
+            name: "CapKitTestPlugin",
+            targets: ["CapKitTestPlugin"]
         )
     ],
     dependencies: [
@@ -15,16 +15,12 @@ let package = Package(
     ],
     targets: [
         .target(
-            name: "TestPlugin",
+            name: "CapKitTestPlugin",
             dependencies: [
                 .product(name: "Capacitor", package: "capacitor-swift-pm"),
                 .product(name: "Cordova", package: "capacitor-swift-pm")
             ],
             path: "ios/Sources/TestPlugin"
-        ),
-        .testTarget(
-            name: "TestPluginTests",
-            dependencies: ["TestPlugin"],
-            path: "ios/Tests/TestPluginTests")
+        )
     ]
 )

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/build.gradle

@@ -71,7 +71,7 @@ android {
     buildTypes {
         release {
             minifyEnabled = false
-            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
         }
     }
     lint {

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

@@ -32,8 +32,11 @@ class TestImpl(
    */
   fun updateConfig(newConfig: TestConfig) {
     this.config = newConfig
-    TestLogger.verbose = this.config.verboseLogging
-    TestLogger.debug("Configuration updated. Verbose logging: ${this.config.verboseLogging}")
+    TestLogger.verbose = newConfig.verboseLogging
+    TestLogger.debug(
+      "Configuration applied. Verbose logging:",
+      newConfig.verboseLogging.toString(),
+    )
   }
 
   /**

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.TestLogger
 
 /**
  * Capacitor bridge for the Test plugin.
@@ -51,7 +48,7 @@ class TestPlugin : Plugin() {
     implementation.updateConfig(config)
   }
 
-  // --- ---
+  // --- Echo ---
 
   /**
    * Echoes a string back to JavaScript.
@@ -60,21 +57,24 @@ class TestPlugin : Plugin() {
    */
   @PluginMethod
   fun echo(call: PluginCall) {
-    var value = call.getString("value") ?: ""
-    TestLogger.debug("Echoing value: $value")
+    val jsValue = call.getString("value") ?: ""
 
-    // Append the custom message from the configuration
-    value += config.customMessage
+    val valueToEcho =
+      if (jsValue.isNotEmpty()) {
+        jsValue
+      } else {
+        config.customMessage ?: ""
+      }
 
     val ret = JSObject()
-    ret.put("value", implementation.echo(value))
+    ret.put("value", implementation.echo(valueToEcho))
     call.resolve(ret)
   }
 
-  // ---  Version ---
+  // --- Version ---
 
   /**
-   * Returns the plugin version.
+   * Returns the native plugin version.
    */
   @PluginMethod
   fun getPluginVersion(call: PluginCall) {
@@ -95,22 +95,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/TestLogger.kt

@@ -5,7 +5,7 @@ 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

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,10 +1,10 @@
 /**
  * @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.
  */
-import type { TestPlugin } from './definitions';
+import { TestPlugin } from './definitions';
 /**
  * Main entry point for the Test Capacitor plugin.
  *

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 { 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/TestConfig.swift

@@ -59,14 +59,12 @@ public struct TestConfig {
      - Parameter plugin: The CAPPlugin instance used to access typed configuration.
      */
     init(plugin: CAPPlugin) {
-        let config = plugin.getConfig()
+        let pluginId = plugin.pluginId
 
         // Bool
-        verboseLogging =
-            (config.value(forKey: Keys.verboseLogging) as? Bool) ?? defaultVerboseLogging
+        verboseLogging = plugin.getConfigValue(Keys.verboseLogging) as? Bool ?? defaultVerboseLogging
 
         // String
-        customMessage =
-            (config.value(forKey: Keys.customMessage) as? String) ?? defaultCustomMessage
+        customMessage = plugin.getConfigValue(Keys.customMessage) as? String ?? defaultCustomMessage
     }
 }

package/ios/Sources/TestPlugin/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 TestImpl: 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,14 +4,13 @@ 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?
@@ -65,18 +64,20 @@ public class TestPlugin: CAPPlugin, CAPBridgedPlugin {
      and delegates the core logic to the native implementation.
      */
     @objc func echo(_ call: CAPPluginCall) {
-        var value = call.getString("value", "")
+        let jsValue = call.getString("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 {
-            value += configMessage
+        let valueToEcho: String
+        if !jsValue.isEmpty {
+            valueToEcho = jsValue
+        } else {
+            valueToEcho = config?.customMessage ?? ""
         }
 
+        // Log input only if verbose logging is enabled
+        TestLogger.debug("Echoing value:", valueToEcho)
+
         call.resolve([
-            "value": implementation.echo(value)
+            "value": implementation.echo(valueToEcho)
         ])
     }
 
@@ -94,32 +95,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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cap-kit/test-plugin",
-  "version": "1.0.2",
-  "description": "Test plugin for Cap-Kit.",
+  "version": "5.0.0",
+  "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,10 +13,10 @@
     "ios/Sources",
     "ios/Tests",
     "Package.swift",
-    "CapKitTest.podspec",
+    "CapKitTestPlugin.podspec",
     "LICENSE"
   ],
-  "author": "Fabio Martino",
+  "author": "CapKit Team",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -46,11 +46,11 @@
     "@eslint/js": "^9.39.2",
     "eslint": "^9.39.2",
     "eslint-plugin-import": "^2.32.0",
-    "globals": "^17.0.0",
-    "prettier": "^3.8.0",
+    "globals": "^17.1.0",
+    "prettier": "^3.8.1",
     "prettier-plugin-java": "^2.8.1",
     "rimraf": "^6.1.2",
-    "rollup": "^4.55.2",
+    "rollup": "^4.56.0",
     "swiftlint": "^2.0.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.53.1"
@@ -68,7 +68,7 @@
   },
   "scripts": {
     "verify": "pnpm run verify:ios && pnpm run verify:android && pnpm run verify:web",
-    "verify:ios": "xcodebuild -scheme CapKitTest -destination generic/platform=iOS",
+    "verify:ios": "xcodebuild -scheme CapKitTestPlugin -destination generic/platform=iOS",
     "verify:android": "cd android && ./gradlew clean build test && cd ..",
     "verify:web": "pnpm run build",
     "lint:android": "cd android && ./gradlew ktlintCheck",

package/ios/Tests/TestPluginTests/TestPluginTests.swift

@@ -1,21 +0,0 @@
-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 = TestImpl()
-        let value = "Hello, World!"
-        let result = implementation.echo(value)
-
-        XCTAssertEqual(value, result)
-    }
-}