@cap-kit/test-plugin 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fabio Martino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Package.swift

@@ -0,0 +1,27 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "TestPlugin",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "TestPlugin",
+            targets: ["TestPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        .target(
+            name: "TestPlugin",
+            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

@@ -0,0 +1,131 @@
+<p align="center">
+  <img src="./logo.svg" alt="Capacitor Logo" width="128" height="128" />
+</p>
+
+<h3 align="center">Test</h3>
+<p align="center"><strong><code>@cap-kit/test-plugin</code></strong></p>
+
+<p align="center">
+  Test plugin for Cap-Kit.
+</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" /></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>
+  <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" /></a>
+  <img src="https://img.shields.io/maintenance/yes/2026?style=flat-square" />
+</p>
+
+<br>
+
+## Install
+
+```bash
+pnpm add @cap-kit/test-plugin
+npx cap sync
+
+```
+
+## Configuration
+
+<docgen-config>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+Configuration options for the Test plugin.
+
+| Prop                | Type                | Description                                                                                                                   | Default                       | Since |
+| ------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | ----- |
+| **`customMessage`** | <code>string</code> | A custom message to append to the echo response. This demonstrates how to pass data from `capacitor.config.ts` to the plugin. | <code>" (from config)"</code> | 0.0.1 |
+
+### Examples
+
+In `capacitor.config.json`:
+
+```json
+{
+  "plugins": {
+    "Test": {
+      "customMessage": " - Hello from Config!"
+    }
+  }
+}
+```
+
+In `capacitor.config.ts`:
+
+```ts
+/// <reference types="@cap-kit/test-plugin" />
+
+import { CapacitorConfig } from '@capacitor/cli';
+
+const config: CapacitorConfig = {
+  plugins: {
+    Test: {
+      customMessage: " - Hello from Config!",
+    },
+  },
+};
+
+export default config;
+```
+
+</docgen-config>
+
+
+## API
+
+<docgen-index>
+
+* [`echo(...)`](#echo)
+* [`getPluginVersion()`](#getpluginversion)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+Capacitor Test plugin interface.
+
+### echo(...)
+
+```typescript
+echo(options: { value: string; }) => Promise<{ value: string; }>
+```
+
+Echoes the provided value.
+
+If the plugin is configured with a `customMessage`, it will be appended
+to the response.
+
+| Param         | Type                            | Description                                                  |
+| ------------- | ------------------------------- | ------------------------------------------------------------ |
+| **`options`** | <code>{ value: string; }</code> | - An object containing a `value` property to be echoed back. |
+
+**Returns:** <code>Promise&lt;{ value: string; }&gt;</code>
+
+**Since:** 0.0.1
+
+--------------------
+
+
+### getPluginVersion()
+
+```typescript
+getPluginVersion() => Promise<{ version: string; }>
+```
+
+Get the native Capacitor plugin version.
+
+**Returns:** <code>Promise&lt;{ version: string; }&gt;</code>
+
+**Since:** 0.0.1
+
+--------------------
+
+</docgen-api>
+
+
+
+## Contributing
+
+Contributions are welcome! Please read the [contributing guide](CONTRIBUTING.md) before submitting a pull request.

package/TestPlugin.podspec

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

package/android/build.gradle

@@ -0,0 +1,98 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+    androidxCoreKTXVersion = project.hasProperty('androidxCoreKTXVersion') ? rootProject.ext.androidxCoreKTXVersion : '1.17.0'
+}
+
+buildscript {
+    ext.kotlin_version = project.hasProperty("kotlin_version") ? rootProject.ext.kotlin_version : '2.2.20'
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+apply plugin: 'kotlin-parcelize'
+
+import groovy.json.JsonSlurper
+
+def getPluginVersion() {
+    try {
+        def packageJsonFile = file('../package.json')
+        if (packageJsonFile.exists()) {
+            def packageJson = new JsonSlurper().parseText(packageJsonFile.text)
+            return packageJson.version
+        }
+    } catch (Exception e) {
+        // Ignore errors and fallback
+    }
+    return "0.0.1"
+}
+
+def pluginVersion = getPluginVersion()
+
+android {
+    namespace = "com.capkit.test"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion as Integer  : 36
+
+    // AGP 8.0+ disables BuildConfig by default for libraries. 
+    // We need to enable it to inject the plugin version.
+    buildFeatures {
+        buildConfig = true
+    }
+
+    defaultConfig {
+        minSdkVersion = project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion as Integer  : 24
+        targetSdkVersion = project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion as Integer  : 36
+        versionCode = 1
+
+        // Dynamic versioning (feature enabled)
+        versionName = pluginVersion
+
+        // Injects the version into the BuildConfig class ONLY if feature is enabled
+        buildConfigField "String", "PLUGIN_VERSION", "\"${pluginVersion}\""
+
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled = false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lint {
+        abortOnError = false
+    }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_21
+        targetCompatibility = JavaVersion.VERSION_21
+    }
+    kotlinOptions {
+        jvmTarget = JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+    implementation "androidx.core:core-ktx:$androidxCoreKTXVersion"
+
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/capkit/test/Logger.kt

@@ -0,0 +1,22 @@
+package com.capkit.test
+
+import android.util.Log
+
+/**
+ * Utility object for logging messages with a custom prefix.
+ */
+object Logger {
+    private const val TAG = "⚡️ Test"
+
+    fun debug(vararg messages: String) {
+        log(TAG, *messages)
+    }
+
+    fun log(tag: String, vararg messages: String) {
+        val sb = StringBuilder()
+        for (msg in messages) {
+            sb.append(msg).append(" ")
+        }
+        Log.d(tag, sb.toString())
+    }
+}

package/android/src/main/java/com/capkit/test/Test.kt

@@ -0,0 +1,23 @@
+package com.capkit.test
+
+import com.capkit.test.Logger
+
+/**
+ * Native implementation for the Test Capacitor plugin.
+ *
+ * This class contains platform logic only and does not depend on
+ * Capacitor plugin APIs.
+ */
+class Test {
+
+    /**
+     * Returns the provided string unchanged.
+     *
+     * @param value Input string.
+     * @return The same string.
+     */
+    fun echo(value: String): String {
+        Logger.debug(value)
+        return value
+    }
+}

package/android/src/main/java/com/capkit/test/TestConfig.kt

@@ -0,0 +1,17 @@
+package com.capkit.test
+
+import com.getcapacitor.Plugin
+
+/**
+ * Helper class to manage the plugin configuration.
+ * It parses the values from capacitor.config.json
+ */
+class TestConfig(plugin: Plugin) {
+
+    val customMessage: String
+
+    init {
+        // "customMessage" must match the key in capacitor.config.ts
+        customMessage = plugin.getConfig().getString("customMessage") ?: " (from config)"
+    }
+}

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

@@ -0,0 +1,61 @@
+package com.capkit.test
+
+import com.capkit.test.Logger
+import com.getcapacitor.JSObject
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
+import com.getcapacitor.annotation.CapacitorPlugin
+
+/**
+ * Capacitor bridge for the Test plugin.
+ *
+ * This class exposes native Android functionality to JavaScript
+ * and delegates all business logic to the implementation class.
+ */
+@CapacitorPlugin(
+    name = "Test")
+class TestPlugin : Plugin() {
+
+    private lateinit var config: TestConfig
+
+    override fun load() {
+        super.load()
+        Logger.debug("Loading plugin")
+        config = TestConfig(this)
+    }
+
+    /** Plugin version (injected by Gradle). */
+    private val pluginVersion: String = BuildConfig.PLUGIN_VERSION
+
+    /** Native implementation (business logic). */
+    private val implementation = Test()
+
+    /**
+     * Echoes a string back to JavaScript.
+     *
+     * @param call Capacitor plugin call containing the `value` parameter.
+     */
+    @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
+
+        val ret = JSObject()
+        ret.put("value", implementation.echo(value))
+        call.resolve(ret)
+    }
+
+    /**
+     * Returns the plugin version.
+     */
+    @PluginMethod
+    fun getPluginVersion(call: PluginCall) {
+        val ret = JSObject()
+        ret.put("version", pluginVersion)
+        call.resolve(ret)
+    }
+}

package/dist/docs.json

@@ -0,0 +1,103 @@
+{
+  "api": {
+    "name": "TestPlugin",
+    "slug": "testplugin",
+    "docs": "Capacitor Test plugin interface.",
+    "tags": [],
+    "methods": [
+      {
+        "name": "echo",
+        "signature": "(options: { value: string; }) => Promise<{ value: string; }>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "- An object containing a `value` property to be echoed back.",
+            "type": "{ value: string; }"
+          }
+        ],
+        "returns": "Promise<{ value: string; }>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options - An object containing a `value` property to be echoed back."
+          },
+          {
+            "name": "returns",
+            "text": "A promise resolving to an object containing the echoed `value`."
+          },
+          {
+            "name": "example",
+            "text": "```typescript\nimport { Test } from '@cap-kit/test-plugin';\n\nconst result = await Test.echo({ value: 'Hello, World!' });\nconsole.log(result.value); // Output: 'Hello, World!'\n```"
+          },
+          {
+            "name": "since",
+            "text": "0.0.1"
+          }
+        ],
+        "docs": "Echoes the provided value.\n\nIf the plugin is configured with a `customMessage`, it will be appended\nto the response.",
+        "complexTypes": [],
+        "slug": "echo"
+      },
+      {
+        "name": "getPluginVersion",
+        "signature": "() => Promise<{ version: string; }>",
+        "parameters": [],
+        "returns": "Promise<{ version: string; }>",
+        "tags": [
+          {
+            "name": "returns",
+            "text": "Promise that resolves with the plugin version"
+          },
+          {
+            "name": "throws",
+            "text": "Error if getting the version fails"
+          },
+          {
+            "name": "example",
+            "text": "```typescript\nimport { Test } from '@cap-kit/test-plugin';\n\nconst { version } = await Test.getPluginVersion();\nconsole.log('Plugin version:', version); // Output: Plugin version: 0.0.1\n```"
+          },
+          {
+            "name": "since",
+            "text": "0.0.1"
+          }
+        ],
+        "docs": "Get the native Capacitor plugin version.",
+        "complexTypes": [],
+        "slug": "getpluginversion"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [],
+  "enums": [],
+  "typeAliases": [],
+  "pluginConfigs": [
+    {
+      "name": "Test",
+      "slug": "test",
+      "properties": [
+        {
+          "name": "customMessage",
+          "tags": [
+            {
+              "text": "\" (from config)\"",
+              "name": "default"
+            },
+            {
+              "text": "\" - Hello from Config!\"",
+              "name": "example"
+            },
+            {
+              "text": "0.0.1",
+              "name": "since"
+            }
+          ],
+          "docs": "A custom message to append to the echo response.\nThis demonstrates how to pass data from `capacitor.config.ts` to the plugin.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ],
+      "docs": "Configuration options for the Test plugin."
+    }
+  ]
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Extend the PluginsConfig interface to include configuration options for the Test plugin.
+ */
+declare module '@capacitor/cli' {
+    interface PluginsConfig {
+        /**
+         * Configuration options for the Test plugin.
+         */
+        Test?: {
+            /**
+             * A custom message to append to the echo response.
+             * This demonstrates how to pass data from `capacitor.config.ts` to the plugin.
+             *
+             * @default " (from config)"
+             * @example " - Hello from Config!"
+             * @since 0.0.1
+             */
+            customMessage?: string;
+        };
+    }
+}
+/**
+ * Capacitor Test plugin interface.
+ */
+export interface TestPlugin {
+    /**
+     * Echoes the provided value.
+     *
+     * If the plugin is configured with a `customMessage`, it will be appended
+     * to the response.
+     *
+     * @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!'
+     * ```
+     *
+     * @since 0.0.1
+     */
+    echo(options: {
+        value: string;
+    }): Promise<{
+        value: string;
+    }>;
+    /**
+     * Get the native Capacitor plugin version.
+     *
+     * @returns Promise that resolves with the plugin version
+     * @throws Error if getting the version fails
+     *
+     * @example
+     * ```typescript
+     * import { Test } from '@cap-kit/test-plugin';
+     *
+     * const { version } = await Test.getPluginVersion();
+     * console.log('Plugin version:', version); // Output: Plugin version: 0.0.1
+     * ```
+     *
+     * @since 0.0.1
+     */
+    getPluginVersion(): Promise<{
+        version: string;
+    }>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,3 @@
+/// <reference types="@capacitor/cli" />
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\n/**\n * Extend the PluginsConfig interface to include configuration options for the Test plugin.\n */\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    /**\n     * Configuration options for the Test plugin.\n     */\n    Test?: {\n      /**\n       * A custom message to append to the echo response.\n       * This demonstrates how to pass data from `capacitor.config.ts` to the plugin.\n       *\n       * @default \" (from config)\"\n       * @example \" - Hello from Config!\"\n       * @since 0.0.1\n       */\n      customMessage?: string;\n    };\n  }\n}\n\n/**\n * Capacitor Test plugin interface.\n */\nexport interface TestPlugin {\n  /**\n   * Echoes the provided value.\n   *\n   * If the plugin is configured with a `customMessage`, it will be appended\n   * to the response.\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   * @since 0.0.1\n   */\n  echo(options: { value: string }): Promise<{ value: string }>;\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('Plugin version:', version); // Output: Plugin version: 0.0.1\n   * ```\n   *\n   * @since 0.0.1\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file index.ts
+ * This file exports the TestPlugin 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';
+/**
+ * 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.
+ */
+declare const Test: TestPlugin;
+export * from './definitions';
+export { Test };

package/dist/esm/index.js

@@ -0,0 +1,31 @@
+/**
+ * @file index.ts
+ * This file exports the TestPlugin and registers it with Capacitor.
+ * It acts as the main entry point for accessing the plugin's functionality
+ * across different platforms, including web.
+ */
+import { registerPlugin } from '@capacitor/core';
+/**
+ * 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.
+ */
+const Test = 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: () => import('./web').then((m) => new m.TestWeb()),
+});
+// Export the definitions from 'definitions.ts' for external use.
+// These exports allow users to directly use the types and interfaces
+// defined for the TestPlugin.
+export * from './definitions';
+// Export the registered TestPlugin instance.
+// This makes the plugin instance available for import in other modules.
+export { Test };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD;;;;;GAKG;AACH,MAAM,IAAI,GAAG,cAAc,CAAa,MAAM,EAAE;IAC9C;;;;;;OAMG;IACH,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;CACxD,CAAC,CAAC;AAEH,iEAAiE;AACjE,qEAAqE;AACrE,8BAA8B;AAC9B,cAAc,eAAe,CAAC;AAE9B,6CAA6C;AAC7C,wEAAwE;AACxE,OAAO,EAAE,IAAI,EAAE,CAAC","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 */\n\nimport { registerPlugin } from '@capacitor/core';\n\nimport type { TestPlugin } from './definitions';\n\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<TestPlugin>('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\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\n// Export the registered TestPlugin instance.\n// This makes the plugin instance available for import in other modules.\nexport { Test };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @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.
+ */
+import { WebPlugin } from '@capacitor/core';
+import type { TestPlugin } from './definitions';
+/**
+ * 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.
+ */
+export declare class TestWeb extends WebPlugin implements TestPlugin {
+    /**
+     * Echoes a value back for the web platform.
+     * This method is a basic implementation example, primarily for testing
+     * or validating communication with the plugin.
+     *
+     * @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!'
+     * ```
+     */
+    echo(options: {
+        value: string;
+    }): Promise<{
+        value: string;
+    }>;
+    /**
+     * Get the native Capacitor plugin version.
+     *
+     * @returns Promise that resolves with the plugin version
+     * @throws Error if getting the version fails
+     *
+     * @example
+     * ```typescript
+     * import { Test } from '@cap-kit/test-plugin';
+     *
+     * const version = await Test.getPluginVersion();
+     * console.log(version.version); // Output: 'web'
+     * ```
+     */
+    getPluginVersion(): Promise<{
+        version: string;
+    }>;
+}

package/dist/esm/web.js

@@ -0,0 +1,55 @@
+/**
+ * @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.
+ */
+import { WebPlugin } from '@capacitor/core';
+/**
+ * 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.
+ */
+export class TestWeb extends WebPlugin {
+    /**
+     * Echoes a value back for the web platform.
+     * This method is a basic implementation example, primarily for testing
+     * or validating communication with the plugin.
+     *
+     * @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);
+        // Note: On the web, reading 'capacitor.config.ts' requires specific build setups.
+        // We pass the value through as-is for parity, or you can implement logic to read
+        // from a global config object if your app exposes one.
+        return options;
+    }
+    /**
+     * Get the native Capacitor plugin version.
+     *
+     * @returns Promise that resolves with the plugin version
+     * @throws Error if getting the version fails
+     *
+     * @example
+     * ```typescript
+     * import { Test } from '@cap-kit/test-plugin';
+     *
+     * const version = await Test.getPluginVersion();
+     * console.log(version.version); // Output: 'web'
+     * ```
+     */
+    async getPluginVersion() {
+        return { version: 'web' };
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;;GAIG;AACH,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpC;;;;;;;;;;;;;;;OAeG;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;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF","sourcesContent":["/**\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\nimport type { TestPlugin } from './definitions';\n\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 implements TestPlugin {\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: { value: string }): Promise<{ value: string }> {\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  /**\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(): Promise<{ version: string }> {\n    return { version: 'web' };\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,88 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+/**
+ * @file index.ts
+ * This file exports the TestPlugin and registers it with Capacitor.
+ * It acts as the main entry point for accessing the plugin's functionality
+ * 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.
+ */
+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.
+ */
+class TestWeb extends core.WebPlugin {
+    /**
+     * Echoes a value back for the web platform.
+     * This method is a basic implementation example, primarily for testing
+     * or validating communication with the plugin.
+     *
+     * @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);
+        // Note: On the web, reading 'capacitor.config.ts' requires specific build setups.
+        // We pass the value through as-is for parity, or you can implement logic to read
+        // from a global config object if your app exposes one.
+        return options;
+    }
+    /**
+     * Get the native Capacitor plugin version.
+     *
+     * @returns Promise that resolves with the plugin version
+     * @throws Error if getting the version fails
+     *
+     * @example
+     * ```typescript
+     * import { Test } from '@cap-kit/test-plugin';
+     *
+     * const version = await Test.getPluginVersion();
+     * console.log(version.version); // Output: 'web'
+     * ```
+     */
+    async getPluginVersion() {
+        return { version: 'web' };
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    TestWeb: TestWeb
+});
+
+exports.Test = Test;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["/**\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;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,91 @@
+var capacitorTest = (function (exports, core) {
+    'use strict';
+
+    /**
+     * @file index.ts
+     * This file exports the TestPlugin and registers it with Capacitor.
+     * It acts as the main entry point for accessing the plugin's functionality
+     * 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.
+     */
+    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.
+     */
+    class TestWeb extends core.WebPlugin {
+        /**
+         * Echoes a value back for the web platform.
+         * This method is a basic implementation example, primarily for testing
+         * or validating communication with the plugin.
+         *
+         * @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);
+            // Note: On the web, reading 'capacitor.config.ts' requires specific build setups.
+            // We pass the value through as-is for parity, or you can implement logic to read
+            // from a global config object if your app exposes one.
+            return options;
+        }
+        /**
+         * Get the native Capacitor plugin version.
+         *
+         * @returns Promise that resolves with the plugin version
+         * @throws Error if getting the version fails
+         *
+         * @example
+         * ```typescript
+         * import { Test } from '@cap-kit/test-plugin';
+         *
+         * const version = await Test.getPluginVersion();
+         * console.log(version.version); // Output: 'web'
+         * ```
+         */
+        async getPluginVersion() {
+            return { version: 'web' };
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        TestWeb: TestWeb
+    });
+
+    exports.Test = Test;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["/**\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;;;;;;;;;;;;;;;"}

package/ios/Sources/TestPlugin/Logging.swift

@@ -0,0 +1,32 @@
+import Capacitor
+
+/**
+ * Utility function for logging messages with a custom prefix.
+ *
+ * This function is designed to format log messages for the Test plugin. It prepends the log output
+ * with a custom prefix (`⚡️  Test -`) to easily identify logs associated with this plugin.
+ *
+ * @param items - A variadic parameter accepting a list of items to log. Each item will be converted to a string and logged sequentially.
+ * @param separator - A string used to separate the logged items. Defaults to a single space (`" "`).
+ * @param terminator - A string appended to the end of the log message. Defaults to a newline (`"\n"`).
+ *
+ * Example Usage:
+ * ```
+ * log("This is a message", "with multiple parts", separator: ", ")
+ * // Output: ⚡️  Test - This is a message, with multiple parts
+ * ```
+ *
+ * Note:
+ * - This function uses Capacitor's `CAPLog.print` for outputting log messages.
+ * - If multiple items are logged, they will be separated by the specified `separator` and terminated by the `terminator`.
+ */
+func log(_ items: Any..., separator: String = " ", terminator: String = "\n") {
+    // Prefix the log with "⚡️  Test -"
+    CAPLog.print("⚡️  Test -", terminator: separator)
+
+    // Iterate over the provided items and print each one
+    for (itemIndex, item) in items.enumerated() {
+        // Use the specified separator between items, and the terminator for the final item
+        CAPLog.print(item, terminator: itemIndex == items.count - 1 ? terminator : separator)
+    }
+}

package/ios/Sources/TestPlugin/Test.swift

@@ -0,0 +1,19 @@
+import Foundation
+
+/**
+ * Native implementation for the Test Capacitor plugin.
+ *
+ * This class contains platform logic only and does not depend on Capacitor APIs.
+ */
+@objc public class Test: NSObject {
+    /**
+     * Returns the provided string unchanged.
+     *
+     * @param value Input string.
+     * @return The same string.
+     */
+    @objc public func echo(_ value: String) -> String {
+        log(value)
+        return value
+    }
+}

package/ios/Sources/TestPlugin/TestConfig.swift

@@ -0,0 +1,29 @@
+import Foundation
+
+/**
+ * Helper struct to manage the plugin configuration.
+ * It parses the values from capacitor.config.json
+ */
+public struct TestConfig {
+
+    // Define configuration keys for consistency
+    private struct Keys {
+        static let customMessage = "customMessage"
+    }
+
+    // Default values
+    private let defaultCustomMessage = " (from config)"
+
+    // Public accessible properties
+    public var customMessage: String
+
+    /**
+     * Initialize with the config dictionary from the plugin.
+     */
+    init(config: [AnyHashable: Any]?) {
+        let config = config ?? [:]
+
+        // Parse customMessage with a default fallback
+        self.customMessage = config[Keys.customMessage] as? String ?? defaultCustomMessage
+    }
+}

package/ios/Sources/TestPlugin/TestPlugin.swift

@@ -0,0 +1,77 @@
+import Foundation
+import Capacitor
+
+/**
+ * This file defines the Capacitor bridge for the Test plugin.
+ *
+ * Documentation reference:
+ * https://capacitorjs.com/docs/plugins/ios
+ */
+
+@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"
+    }
+
+    /// The unique identifier for the plugin.
+    public let identifier = "TestPlugin"
+
+    /// The name used to reference this plugin in JavaScript.
+    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.
+     */
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "echo", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getPluginVersion", returnType: CAPPluginReturnPromise)
+    ]
+
+    /// An instance of the implementation class that contains the plugin's core functionality.
+    private let implementation = Test()
+
+    /**
+     * Echoes a string back to JavaScript.
+     *
+     * @param call Capacitor plugin call containing the `value` parameter.
+     */
+    @objc func echo(_ call: CAPPluginCall) {
+        var value = call.getString("value", "")
+        log("Echoing value: \(value)")
+
+        // Append the custom message from the configuration
+        if let configMessage = config?.customMessage {
+            value = value + configMessage
+        }
+
+        call.resolve([
+            "value": implementation.echo(value)
+        ])
+    }
+
+    /**
+     * Returns the plugin version.
+     */
+    @objc func getPluginVersion(_ call: CAPPluginCall) {
+        call.resolve(["version": self.pluginVersion])
+    }
+}

package/ios/Tests/TestPluginTests/TestPluginTests.swift

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

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@cap-kit/test-plugin",
+  "version": "0.0.1",
+  "description": "Test plugin for Cap-Kit.",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "TestPlugin.podspec",
+    "LICENSE"
+  ],
+  "author": "Fabio Martino",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cap-kit/plugins.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cap-kit/plugins/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "devDependencies": {
+    "@capacitor/cli": "^8.0.0",
+    "@capacitor/android": "^8.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.3.1",
+    "@capacitor/ios": "^8.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "eslint": "^8.57.1",
+    "prettier": "^3.6.2",
+    "prettier-plugin-java": "^2.7.7",
+    "rimraf": "^6.1.2",
+    "rollup": "^4.53.5",
+    "swiftlint": "^2.0.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=8.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  },
+  "scripts": {
+    "verify": "pnpm run verify:ios && pnpm run verify:android && pnpm run verify:web",
+    "verify:ios": "xcodebuild -scheme TestPlugin -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "pnpm run build",
+    "lint": "pnpm run eslint --ext ts . && pnpm run prettier --check \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java && pnpm run swiftlint lint --strict",
+    "fmt": "pnpm run eslint --fix --ext ts . && pnpm run prettier --write \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java && pnpm run swiftlint --fix --format",
+    "eslint": "eslint",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api TestPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "pnpm run clean && pnpm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch"
+  }
+}