@capawesome/capacitor-sim 0.0.1

package/CapawesomeCapacitorSim.podspec

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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robin Genz
+
+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,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapawesomeCapacitorSim",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "CapawesomeCapacitorSim",
+            targets: ["SimPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        .target(
+            name: "SimPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Plugin"),
+        .testTarget(
+            name: "SimPluginTests",
+            dependencies: ["SimPlugin"],
+            path: "ios/PluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,202 @@
+# @capawesome/capacitor-sim
+
+Capacitor plugin for reading SIM card and carrier information.
+
+<div class="capawesome-z29o10a">
+  <a href="https://cloud.capawesome.io/" target="_blank">
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
+  </a>
+</div>
+
+## Features
+
+- 📇 **SIM cards**: Read information about the SIM cards installed on the device.
+- 🔀 **Multi-SIM**: Supports devices with multiple SIM slots.
+- 🌐 **Carrier details**: Read carrier name, country code, MCC and MNC.
+- 🔒 **Permissions**: Built-in handling of the required runtime permission.
+- 🔁 **Up-to-date**: Always supports the latest Capacitor version.
+
+Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
+
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
+## Compatibility
+
+| Plugin Version | Capacitor Version | Status         |
+| -------------- | ----------------- | -------------- |
+| 0.x.x          | >=8.x.x           | Active support |
+
+## Installation
+
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills --skill capacitor-plugins
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-sim` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
+```bash
+npm install @capawesome/capacitor-sim
+npx cap sync
+```
+
+This plugin is only available on **Android**. On iOS and Web, all methods reject as unimplemented (see [iOS](#ios) below).
+
+### Android
+
+The `READ_PHONE_STATE` permission is declared in the plugin's `AndroidManifest.xml` and is merged into your app automatically. You must request it at runtime via the `requestPermissions(...)` method before calling `getSimCards(...)`.
+
+### iOS
+
+Reading SIM card and carrier information is **not supported** on iOS. Apple deprecated the `CTCarrier` APIs of the Core Telephony framework with iOS 16, and they return placeholder values (e.g. `"--"` and `65535`) on iOS 16.4 and later. Because there is no reliable system API left, all methods reject as unimplemented on iOS.
+
+## Configuration
+
+No configuration required for this plugin.
+
+## Usage
+
+```typescript
+import { Sim } from '@capawesome/capacitor-sim';
+
+const checkPermissions = async () => {
+  const { readSimCards } = await Sim.checkPermissions();
+  return readSimCards;
+};
+
+const requestPermissions = async () => {
+  const { readSimCards } = await Sim.requestPermissions();
+  return readSimCards;
+};
+
+const getSimCards = async () => {
+  const { simCards } = await Sim.getSimCards();
+  return simCards;
+};
+```
+
+## API
+
+<docgen-index>
+
+* [`checkPermissions()`](#checkpermissions)
+* [`getSimCards()`](#getsimcards)
+* [`requestPermissions()`](#requestpermissions)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### checkPermissions()
+
+```typescript
+checkPermissions() => Promise<PermissionStatus>
+```
+
+Check the permission to read the SIM cards.
+
+Only available on Android.
+
+**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### getSimCards()
+
+```typescript
+getSimCards() => Promise<GetSimCardsResult>
+```
+
+Get information about the SIM cards installed on the device.
+
+On devices with multiple SIM slots, all active SIM cards are returned.
+
+Only available on Android.
+
+**Returns:** <code>Promise&lt;<a href="#getsimcardsresult">GetSimCardsResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### requestPermissions()
+
+```typescript
+requestPermissions() => Promise<PermissionStatus>
+```
+
+Request the permission to read the SIM cards.
+
+Only available on Android.
+
+**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### Interfaces
+
+
+#### PermissionStatus
+
+| Prop               | Type                                                        | Description                                    | Since |
+| ------------------ | ----------------------------------------------------------- | ---------------------------------------------- | ----- |
+| **`readSimCards`** | <code><a href="#permissionstate">PermissionState</a></code> | The permission state of reading the SIM cards. | 0.1.0 |
+
+
+#### GetSimCardsResult
+
+| Prop           | Type                   | Description                            | Since |
+| -------------- | ---------------------- | -------------------------------------- | ----- |
+| **`simCards`** | <code>SimCard[]</code> | The SIM cards installed on the device. | 0.1.0 |
+
+
+#### SimCard
+
+| Prop                    | Type                         | Description                                                                                                                                                                         | Since |
+| ----------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`carrierName`**       | <code>string \| null</code>  | The name of the carrier. Returns `null` if the carrier name is not available.                                                                                                       | 0.1.0 |
+| **`displayName`**       | <code>string \| null</code>  | The user-editable display name of the SIM card. Returns `null` if the display name is not available.                                                                                | 0.1.0 |
+| **`isEmbedded`**        | <code>boolean \| null</code> | Whether the SIM card is an embedded SIM (eSIM). Returns `null` if the information is not available.                                                                                 | 0.1.0 |
+| **`isoCountryCode`**    | <code>string \| null</code>  | The two-letter ISO 3166-1 country code of the carrier. Returns `null` if the country code is not available.                                                                         | 0.1.0 |
+| **`mobileCountryCode`** | <code>string \| null</code>  | The Mobile Country Code (MCC) of the carrier. Returns `null` if the mobile country code is not available.                                                                           | 0.1.0 |
+| **`mobileNetworkCode`** | <code>string \| null</code>  | The Mobile Network Code (MNC) of the carrier. Returns `null` if the mobile network code is not available.                                                                           | 0.1.0 |
+| **`phoneNumber`**       | <code>string \| null</code>  | The phone number associated with the SIM card. This value is often empty because carriers do not reliably store the phone number on the SIM card. In that case, `null` is returned. | 0.1.0 |
+| **`slotIndex`**         | <code>number</code>          | The index of the SIM slot on the device.                                                                                                                                            | 0.1.0 |
+
+
+### Type Aliases
+
+
+#### PermissionState
+
+<code>'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'</code>
+
+</docgen-api>
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/sim/CHANGELOG.md).
+
+## License
+
+See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/sim/LICENSE).

package/android/build.gradle

@@ -0,0 +1,58 @@
+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'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace = "io.capawesome.capacitorjs.plugins.sim"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError = false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    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,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
+</manifest>

package/android/src/main/java/io/capawesome/capacitorjs/plugins/sim/Sim.java

@@ -0,0 +1,126 @@
+package io.capawesome.capacitorjs.plugins.sim;
+
+import android.content.Context;
+import android.os.Build;
+import android.telephony.SubscriptionInfo;
+import android.telephony.SubscriptionManager;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import io.capawesome.capacitorjs.plugins.sim.classes.results.GetSimCardsResult;
+import io.capawesome.capacitorjs.plugins.sim.classes.results.SimCard;
+import io.capawesome.capacitorjs.plugins.sim.interfaces.NonEmptyResultCallback;
+import java.util.ArrayList;
+import java.util.List;
+
+public class Sim {
+
+    @NonNull
+    private final SimPlugin plugin;
+
+    public Sim(@NonNull SimPlugin plugin) {
+        this.plugin = plugin;
+    }
+
+    public void getSimCards(@NonNull NonEmptyResultCallback<GetSimCardsResult> callback) {
+        try {
+            List<SimCard> simCards = new ArrayList<>();
+            SubscriptionManager subscriptionManager = getSubscriptionManager();
+            if (subscriptionManager != null) {
+                List<SubscriptionInfo> subscriptionInfos = subscriptionManager.getActiveSubscriptionInfoList();
+                if (subscriptionInfos != null) {
+                    for (SubscriptionInfo subscriptionInfo : subscriptionInfos) {
+                        simCards.add(createSimCard(subscriptionManager, subscriptionInfo));
+                    }
+                }
+            }
+            callback.success(new GetSimCardsResult(simCards));
+        } catch (Exception exception) {
+            callback.error(exception);
+        }
+    }
+
+    @Nullable
+    private String charSequenceToString(@Nullable CharSequence value) {
+        if (value == null) {
+            return null;
+        }
+        return emptyToNull(value.toString());
+    }
+
+    @NonNull
+    private SimCard createSimCard(@NonNull SubscriptionManager subscriptionManager, @NonNull SubscriptionInfo subscriptionInfo) {
+        int slotIndex = subscriptionInfo.getSimSlotIndex();
+        String carrierName = charSequenceToString(subscriptionInfo.getCarrierName());
+        String displayName = charSequenceToString(subscriptionInfo.getDisplayName());
+        String isoCountryCode = emptyToNull(subscriptionInfo.getCountryIso());
+        String mobileCountryCode = getMobileCountryCode(subscriptionInfo);
+        String mobileNetworkCode = getMobileNetworkCode(subscriptionInfo);
+        Boolean isEmbedded = getIsEmbedded(subscriptionInfo);
+        String phoneNumber = getPhoneNumber(subscriptionManager, subscriptionInfo);
+        return new SimCard(
+            slotIndex,
+            carrierName,
+            displayName,
+            isoCountryCode,
+            mobileCountryCode,
+            mobileNetworkCode,
+            isEmbedded,
+            phoneNumber
+        );
+    }
+
+    @Nullable
+    private String emptyToNull(@Nullable String value) {
+        if (value == null || value.isEmpty()) {
+            return null;
+        }
+        return value;
+    }
+
+    @Nullable
+    private Boolean getIsEmbedded(@NonNull SubscriptionInfo subscriptionInfo) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.P) {
+            return null;
+        }
+        return subscriptionInfo.isEmbedded();
+    }
+
+    @Nullable
+    private String getMobileCountryCode(@NonNull SubscriptionInfo subscriptionInfo) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            return emptyToNull(subscriptionInfo.getMccString());
+        }
+        int mcc = subscriptionInfo.getMcc();
+        return mcc == 0 ? null : String.valueOf(mcc);
+    }
+
+    @Nullable
+    private String getMobileNetworkCode(@NonNull SubscriptionInfo subscriptionInfo) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            return emptyToNull(subscriptionInfo.getMncString());
+        }
+        int mnc = subscriptionInfo.getMnc();
+        return mnc == 0 ? null : String.valueOf(mnc);
+    }
+
+    @Nullable
+    private String getPhoneNumber(@NonNull SubscriptionManager subscriptionManager, @NonNull SubscriptionInfo subscriptionInfo) {
+        try {
+            String phoneNumber;
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                phoneNumber = subscriptionManager.getPhoneNumber(subscriptionInfo.getSubscriptionId());
+            } else {
+                phoneNumber = subscriptionInfo.getNumber();
+            }
+            return emptyToNull(phoneNumber);
+        } catch (Exception exception) {
+            return null;
+        }
+    }
+
+    @Nullable
+    private SubscriptionManager getSubscriptionManager() {
+        Context context = plugin.getContext();
+        return (SubscriptionManager) context.getSystemService(Context.TELEPHONY_SUBSCRIPTION_SERVICE);
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/sim/SimPlugin.java

@@ -0,0 +1,77 @@
+package io.capawesome.capacitorjs.plugins.sim;
+
+import android.Manifest;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.Logger;
+import com.getcapacitor.PermissionState;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import com.getcapacitor.annotation.Permission;
+import io.capawesome.capacitorjs.plugins.sim.classes.results.GetSimCardsResult;
+import io.capawesome.capacitorjs.plugins.sim.interfaces.NonEmptyResultCallback;
+import io.capawesome.capacitorjs.plugins.sim.interfaces.Result;
+
+@CapacitorPlugin(
+    name = "Sim",
+    permissions = { @Permission(strings = { Manifest.permission.READ_PHONE_STATE }, alias = SimPlugin.PERMISSION_READ_SIM_CARDS) }
+)
+public class SimPlugin extends Plugin {
+
+    public static final String ERROR_PERMISSION_DENIED = "Permission to read the SIM cards is denied.";
+    public static final String ERROR_UNKNOWN_ERROR = "An unknown error occurred.";
+    public static final String PERMISSION_READ_SIM_CARDS = "readSimCards";
+    public static final String TAG = "Sim";
+
+    private Sim implementation;
+
+    @Override
+    public void load() {
+        implementation = new Sim(this);
+    }
+
+    @PluginMethod
+    public void getSimCards(PluginCall call) {
+        try {
+            if (getPermissionState(PERMISSION_READ_SIM_CARDS) != PermissionState.GRANTED) {
+                rejectCall(call, new Exception(ERROR_PERMISSION_DENIED));
+                return;
+            }
+
+            NonEmptyResultCallback<GetSimCardsResult> callback = new NonEmptyResultCallback<>() {
+                @Override
+                public void success(@NonNull GetSimCardsResult result) {
+                    resolveCall(call, result);
+                }
+
+                @Override
+                public void error(@NonNull Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+
+            implementation.getSimCards(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    private void rejectCall(@NonNull PluginCall call, @NonNull Exception exception) {
+        String message = exception.getMessage();
+        if (message == null) {
+            message = ERROR_UNKNOWN_ERROR;
+        }
+        Logger.error(TAG, message, exception);
+        call.reject(message);
+    }
+
+    private void resolveCall(@NonNull PluginCall call, @Nullable Result result) {
+        if (result == null) {
+            call.resolve();
+        } else {
+            call.resolve(result.toJSObject());
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/sim/classes/results/GetSimCardsResult.java

@@ -0,0 +1,29 @@
+package io.capawesome.capacitorjs.plugins.sim.classes.results;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSArray;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.sim.interfaces.Result;
+import java.util.List;
+
+public class GetSimCardsResult implements Result {
+
+    @NonNull
+    private final List<SimCard> simCards;
+
+    public GetSimCardsResult(@NonNull List<SimCard> simCards) {
+        this.simCards = simCards;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSArray simCardsArray = new JSArray();
+        for (SimCard simCard : simCards) {
+            simCardsArray.put(simCard.toJSObject());
+        }
+        JSObject result = new JSObject();
+        result.put("simCards", simCardsArray);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/sim/classes/results/SimCard.java

@@ -0,0 +1,68 @@
+package io.capawesome.capacitorjs.plugins.sim.classes.results;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.sim.interfaces.Result;
+import org.json.JSONObject;
+
+public class SimCard implements Result {
+
+    @Nullable
+    private final String carrierName;
+
+    @Nullable
+    private final String displayName;
+
+    @Nullable
+    private final Boolean isEmbedded;
+
+    @Nullable
+    private final String isoCountryCode;
+
+    @Nullable
+    private final String mobileCountryCode;
+
+    @Nullable
+    private final String mobileNetworkCode;
+
+    @Nullable
+    private final String phoneNumber;
+
+    private final int slotIndex;
+
+    public SimCard(
+        int slotIndex,
+        @Nullable String carrierName,
+        @Nullable String displayName,
+        @Nullable String isoCountryCode,
+        @Nullable String mobileCountryCode,
+        @Nullable String mobileNetworkCode,
+        @Nullable Boolean isEmbedded,
+        @Nullable String phoneNumber
+    ) {
+        this.slotIndex = slotIndex;
+        this.carrierName = carrierName;
+        this.displayName = displayName;
+        this.isoCountryCode = isoCountryCode;
+        this.mobileCountryCode = mobileCountryCode;
+        this.mobileNetworkCode = mobileNetworkCode;
+        this.isEmbedded = isEmbedded;
+        this.phoneNumber = phoneNumber;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("slotIndex", slotIndex);
+        result.put("carrierName", carrierName == null ? JSONObject.NULL : carrierName);
+        result.put("displayName", displayName == null ? JSONObject.NULL : displayName);
+        result.put("isoCountryCode", isoCountryCode == null ? JSONObject.NULL : isoCountryCode);
+        result.put("mobileCountryCode", mobileCountryCode == null ? JSONObject.NULL : mobileCountryCode);
+        result.put("mobileNetworkCode", mobileNetworkCode == null ? JSONObject.NULL : mobileNetworkCode);
+        result.put("isEmbedded", isEmbedded == null ? JSONObject.NULL : isEmbedded);
+        result.put("phoneNumber", phoneNumber == null ? JSONObject.NULL : phoneNumber);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/sim/interfaces/Callback.java

@@ -0,0 +1,5 @@
+package io.capawesome.capacitorjs.plugins.sim.interfaces;
+
+public interface Callback {
+    void error(Exception exception);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/sim/interfaces/NonEmptyResultCallback.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.sim.interfaces;
+
+import androidx.annotation.NonNull;
+
+public interface NonEmptyResultCallback<T extends Result> extends Callback {
+    void success(@NonNull T result);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/sim/interfaces/Result.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.sim.interfaces;
+
+import com.getcapacitor.JSObject;
+
+public interface Result {
+    JSObject toJSObject();
+}