@capgo/capacitor-sim 7.1.0 → 7.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -2,11 +2,15 @@
|
|
|
2
2
|
<a href="https://capgo.app/"><img src='https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png' alt='Capgo - Instant updates for capacitor'/></a>
|
|
3
3
|
|
|
4
4
|
<div align="center">
|
|
5
|
-
<h2><a href="https://capgo.app/?ref=
|
|
6
|
-
<h2><a href="https://capgo.app/consulting/?ref=
|
|
5
|
+
<h2><a href="https://capgo.app/?ref=plugin_sim"> ➡️ Get Instant updates for your App with Capgo</a></h2>
|
|
6
|
+
<h2><a href="https://capgo.app/consulting/?ref=plugin_sim"> Missing a feature? We’ll build the plugin for you 💪</a></h2>
|
|
7
7
|
</div>
|
|
8
8
|
Capacitor plugin to get information from device's sim cards
|
|
9
9
|
|
|
10
|
+
## Documentation
|
|
11
|
+
|
|
12
|
+
The most complete doc is available here: https://capgo.app/docs/plugins/sim/
|
|
13
|
+
|
|
10
14
|
## Install
|
|
11
15
|
|
|
12
16
|
```bash
|
|
@@ -39,6 +43,7 @@ Starting with iOS 16.4 Apple restricts access to several carrier fields returned
|
|
|
39
43
|
* [`getSimCards()`](#getsimcards)
|
|
40
44
|
* [`checkPermissions()`](#checkpermissions)
|
|
41
45
|
* [`requestPermissions()`](#requestpermissions)
|
|
46
|
+
* [`getPluginVersion()`](#getpluginversion)
|
|
42
47
|
* [Interfaces](#interfaces)
|
|
43
48
|
* [Type Aliases](#type-aliases)
|
|
44
49
|
|
|
@@ -47,6 +52,11 @@ Starting with iOS 16.4 Apple restricts access to several carrier fields returned
|
|
|
47
52
|
<docgen-api>
|
|
48
53
|
<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
|
|
49
54
|
|
|
55
|
+
Capacitor SIM Plugin for retrieving information from device SIM cards.
|
|
56
|
+
|
|
57
|
+
This plugin provides access to SIM card information such as carrier name,
|
|
58
|
+
country code, mobile network codes, and more. Supports dual-SIM devices.
|
|
59
|
+
|
|
50
60
|
### getSimCards()
|
|
51
61
|
|
|
52
62
|
```typescript
|
|
@@ -55,6 +65,10 @@ getSimCards() => Promise<GetSimCardsResult>
|
|
|
55
65
|
|
|
56
66
|
Get information from the device's SIM cards.
|
|
57
67
|
|
|
68
|
+
Retrieves details about all SIM cards installed in the device.
|
|
69
|
+
On dual-SIM devices, returns information for both SIM cards.
|
|
70
|
+
Requires READ_PHONE_STATE permission on Android.
|
|
71
|
+
|
|
58
72
|
**Returns:** <code>Promise<<a href="#getsimcardsresult">GetSimCardsResult</a>></code>
|
|
59
73
|
|
|
60
74
|
**Since:** 1.0.0
|
|
@@ -70,7 +84,10 @@ checkPermissions() => Promise<PermissionStatus>
|
|
|
70
84
|
|
|
71
85
|
Check permission to access SIM card information.
|
|
72
86
|
|
|
73
|
-
|
|
87
|
+
Checks if the app has permission to read SIM card data.
|
|
88
|
+
On Android, checks READ_PHONE_STATE permission.
|
|
89
|
+
On iOS, the status is always granted.
|
|
90
|
+
On Web, the status is always denied.
|
|
74
91
|
|
|
75
92
|
**Returns:** <code>Promise<<a href="#permissionstatus">PermissionStatus</a>></code>
|
|
76
93
|
|
|
@@ -87,7 +104,10 @@ requestPermissions() => Promise<PermissionStatus>
|
|
|
87
104
|
|
|
88
105
|
Request permission to access SIM card information.
|
|
89
106
|
|
|
90
|
-
|
|
107
|
+
Prompts the user to grant permission to read SIM card data.
|
|
108
|
+
On Android, requests READ_PHONE_STATE permission.
|
|
109
|
+
On iOS, the status is always granted without prompting.
|
|
110
|
+
On Web, the status remains denied.
|
|
91
111
|
|
|
92
112
|
**Returns:** <code>Promise<<a href="#permissionstatus">PermissionStatus</a>></code>
|
|
93
113
|
|
|
@@ -96,6 +116,21 @@ On iOS the status is always granted. On Web the status remains denied.
|
|
|
96
116
|
--------------------
|
|
97
117
|
|
|
98
118
|
|
|
119
|
+
### getPluginVersion()
|
|
120
|
+
|
|
121
|
+
```typescript
|
|
122
|
+
getPluginVersion() => Promise<{ version: string; }>
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Get the native Capacitor plugin version.
|
|
126
|
+
|
|
127
|
+
**Returns:** <code>Promise<{ version: string; }></code>
|
|
128
|
+
|
|
129
|
+
**Since:** 1.0.0
|
|
130
|
+
|
|
131
|
+
--------------------
|
|
132
|
+
|
|
133
|
+
|
|
99
134
|
### Interfaces
|
|
100
135
|
|
|
101
136
|
|
|
@@ -123,10 +158,6 @@ A SIM card description.
|
|
|
123
158
|
| **`mobileCountryCode`** | <code>string</code> | Mobile Country Code (MCC) of the service provider. On iOS 16.4+ the system may return placeholder values such as `65535`. See https://github.com/jonz94/capacitor-sim/issues/8 for details. | 1.0.0 |
|
|
124
159
|
| **`mobileNetworkCode`** | <code>string</code> | Mobile Network Code (MNC) of the service provider. On iOS 16.4+ the system may return placeholder values such as `65535`. See https://github.com/jonz94/capacitor-sim/issues/8 for details. | 1.0.0 |
|
|
125
160
|
|
|
126
|
-
| Method | Signature | Description |
|
|
127
|
-
| -------------------- | -------------------------------------------- | --------------------------------------- |
|
|
128
|
-
| **getPluginVersion** | () => Promise<{ version: string; }> | Get the native Capacitor plugin version |
|
|
129
|
-
|
|
130
161
|
|
|
131
162
|
#### PermissionStatus
|
|
132
163
|
|
|
@@ -28,7 +28,7 @@ import java.util.List;
|
|
|
28
28
|
)
|
|
29
29
|
public class SimPlugin extends Plugin {
|
|
30
30
|
|
|
31
|
-
private final String PLUGIN_VERSION = "7.1.
|
|
31
|
+
private final String PLUGIN_VERSION = "7.1.6";
|
|
32
32
|
|
|
33
33
|
static final String READ_PHONE_STATE = "readPhoneState";
|
|
34
34
|
static final String READ_PHONE_NUMBERS = "readPhoneNumbers";
|
package/dist/docs.json
CHANGED
|
@@ -2,8 +2,13 @@
|
|
|
2
2
|
"api": {
|
|
3
3
|
"name": "SimPlugin",
|
|
4
4
|
"slug": "simplugin",
|
|
5
|
-
"docs": "",
|
|
6
|
-
"tags": [
|
|
5
|
+
"docs": "Capacitor SIM Plugin for retrieving information from device SIM cards.\n\nThis plugin provides access to SIM card information such as carrier name,\ncountry code, mobile network codes, and more. Supports dual-SIM devices.",
|
|
6
|
+
"tags": [
|
|
7
|
+
{
|
|
8
|
+
"text": "1.0.0",
|
|
9
|
+
"name": "since"
|
|
10
|
+
}
|
|
11
|
+
],
|
|
7
12
|
"methods": [
|
|
8
13
|
{
|
|
9
14
|
"name": "getSimCards",
|
|
@@ -11,12 +16,24 @@
|
|
|
11
16
|
"parameters": [],
|
|
12
17
|
"returns": "Promise<GetSimCardsResult>",
|
|
13
18
|
"tags": [
|
|
19
|
+
{
|
|
20
|
+
"name": "returns",
|
|
21
|
+
"text": "Promise that resolves with SIM cards information"
|
|
22
|
+
},
|
|
23
|
+
{
|
|
24
|
+
"name": "throws",
|
|
25
|
+
"text": "Error if permission is denied or reading SIM info fails"
|
|
26
|
+
},
|
|
14
27
|
{
|
|
15
28
|
"name": "since",
|
|
16
29
|
"text": "1.0.0"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"name": "example",
|
|
33
|
+
"text": "```typescript\nconst { simCards } = await SimPlugin.getSimCards();\nsimCards.forEach((sim, index) => {\n console.log(`SIM ${index + 1}:`);\n console.log(` Carrier: ${sim.carrierName}`);\n console.log(` Country: ${sim.isoCountryCode}`);\n console.log(` MCC: ${sim.mobileCountryCode}`);\n console.log(` MNC: ${sim.mobileNetworkCode}`);\n});\n```"
|
|
17
34
|
}
|
|
18
35
|
],
|
|
19
|
-
"docs": "Get information from the device's SIM cards.",
|
|
36
|
+
"docs": "Get information from the device's SIM cards.\n\nRetrieves details about all SIM cards installed in the device.\nOn dual-SIM devices, returns information for both SIM cards.\nRequires READ_PHONE_STATE permission on Android.",
|
|
20
37
|
"complexTypes": [
|
|
21
38
|
"GetSimCardsResult"
|
|
22
39
|
],
|
|
@@ -28,12 +45,24 @@
|
|
|
28
45
|
"parameters": [],
|
|
29
46
|
"returns": "Promise<PermissionStatus>",
|
|
30
47
|
"tags": [
|
|
48
|
+
{
|
|
49
|
+
"name": "returns",
|
|
50
|
+
"text": "Promise that resolves with permission status"
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
"name": "throws",
|
|
54
|
+
"text": "Error if checking permissions fails"
|
|
55
|
+
},
|
|
31
56
|
{
|
|
32
57
|
"name": "since",
|
|
33
58
|
"text": "1.0.0"
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
"name": "example",
|
|
62
|
+
"text": "```typescript\nconst status = await SimPlugin.checkPermissions();\nif (status.readSimCard === 'granted') {\n console.log('Permission granted');\n} else {\n console.log('Permission not granted');\n}\n```"
|
|
34
63
|
}
|
|
35
64
|
],
|
|
36
|
-
"docs": "Check permission to access SIM card information.\n\nOn
|
|
65
|
+
"docs": "Check permission to access SIM card information.\n\nChecks if the app has permission to read SIM card data.\nOn Android, checks READ_PHONE_STATE permission.\nOn iOS, the status is always granted.\nOn Web, the status is always denied.",
|
|
37
66
|
"complexTypes": [
|
|
38
67
|
"PermissionStatus"
|
|
39
68
|
],
|
|
@@ -45,16 +74,55 @@
|
|
|
45
74
|
"parameters": [],
|
|
46
75
|
"returns": "Promise<PermissionStatus>",
|
|
47
76
|
"tags": [
|
|
77
|
+
{
|
|
78
|
+
"name": "returns",
|
|
79
|
+
"text": "Promise that resolves with permission status after the request"
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"name": "throws",
|
|
83
|
+
"text": "Error if the permission request fails"
|
|
84
|
+
},
|
|
48
85
|
{
|
|
49
86
|
"name": "since",
|
|
50
87
|
"text": "1.0.0"
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"name": "example",
|
|
91
|
+
"text": "```typescript\nconst status = await SimPlugin.requestPermissions();\nif (status.readSimCard === 'granted') {\n // Now you can call getSimCards()\n const simCards = await SimPlugin.getSimCards();\n}\n```"
|
|
51
92
|
}
|
|
52
93
|
],
|
|
53
|
-
"docs": "Request permission to access SIM card information.\n\nOn iOS the status is always granted
|
|
94
|
+
"docs": "Request permission to access SIM card information.\n\nPrompts the user to grant permission to read SIM card data.\nOn Android, requests READ_PHONE_STATE permission.\nOn iOS, the status is always granted without prompting.\nOn Web, the status remains denied.",
|
|
54
95
|
"complexTypes": [
|
|
55
96
|
"PermissionStatus"
|
|
56
97
|
],
|
|
57
98
|
"slug": "requestpermissions"
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"name": "getPluginVersion",
|
|
102
|
+
"signature": "() => Promise<{ version: string; }>",
|
|
103
|
+
"parameters": [],
|
|
104
|
+
"returns": "Promise<{ version: string; }>",
|
|
105
|
+
"tags": [
|
|
106
|
+
{
|
|
107
|
+
"name": "returns",
|
|
108
|
+
"text": "Promise that resolves with the plugin version"
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
"name": "throws",
|
|
112
|
+
"text": "Error if getting the version fails"
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
"name": "since",
|
|
116
|
+
"text": "1.0.0"
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
"name": "example",
|
|
120
|
+
"text": "```typescript\nconst { version } = await SimPlugin.getPluginVersion();\nconsole.log('Plugin version:', version);\n```"
|
|
121
|
+
}
|
|
122
|
+
],
|
|
123
|
+
"docs": "Get the native Capacitor plugin version.",
|
|
124
|
+
"complexTypes": [],
|
|
125
|
+
"slug": "getpluginversion"
|
|
58
126
|
}
|
|
59
127
|
],
|
|
60
128
|
"properties": []
|
|
@@ -93,27 +161,7 @@
|
|
|
93
161
|
"name": "since"
|
|
94
162
|
}
|
|
95
163
|
],
|
|
96
|
-
"methods": [
|
|
97
|
-
{
|
|
98
|
-
"name": "getPluginVersion",
|
|
99
|
-
"signature": "() => Promise<{ version: string; }>",
|
|
100
|
-
"parameters": [],
|
|
101
|
-
"returns": "Promise<{ version: string; }>",
|
|
102
|
-
"tags": [
|
|
103
|
-
{
|
|
104
|
-
"name": "returns",
|
|
105
|
-
"text": "an Promise with version for this device"
|
|
106
|
-
},
|
|
107
|
-
{
|
|
108
|
-
"name": "throws",
|
|
109
|
-
"text": "An error if the something went wrong"
|
|
110
|
-
}
|
|
111
|
-
],
|
|
112
|
-
"docs": "Get the native Capacitor plugin version",
|
|
113
|
-
"complexTypes": [],
|
|
114
|
-
"slug": "getpluginversion"
|
|
115
|
-
}
|
|
116
|
-
],
|
|
164
|
+
"methods": [],
|
|
117
165
|
"properties": [
|
|
118
166
|
{
|
|
119
167
|
"name": "number",
|
|
@@ -7,29 +7,96 @@ import type { PermissionState } from '@capacitor/core';
|
|
|
7
7
|
export interface PermissionStatus {
|
|
8
8
|
readSimCard: PermissionState;
|
|
9
9
|
}
|
|
10
|
+
/**
|
|
11
|
+
* Capacitor SIM Plugin for retrieving information from device SIM cards.
|
|
12
|
+
*
|
|
13
|
+
* This plugin provides access to SIM card information such as carrier name,
|
|
14
|
+
* country code, mobile network codes, and more. Supports dual-SIM devices.
|
|
15
|
+
*
|
|
16
|
+
* @since 1.0.0
|
|
17
|
+
*/
|
|
10
18
|
export interface SimPlugin {
|
|
11
19
|
/**
|
|
12
20
|
* Get information from the device's SIM cards.
|
|
13
21
|
*
|
|
22
|
+
* Retrieves details about all SIM cards installed in the device.
|
|
23
|
+
* On dual-SIM devices, returns information for both SIM cards.
|
|
24
|
+
* Requires READ_PHONE_STATE permission on Android.
|
|
25
|
+
*
|
|
26
|
+
* @returns Promise that resolves with SIM cards information
|
|
27
|
+
* @throws Error if permission is denied or reading SIM info fails
|
|
14
28
|
* @since 1.0.0
|
|
29
|
+
* @example
|
|
30
|
+
* ```typescript
|
|
31
|
+
* const { simCards } = await SimPlugin.getSimCards();
|
|
32
|
+
* simCards.forEach((sim, index) => {
|
|
33
|
+
* console.log(`SIM ${index + 1}:`);
|
|
34
|
+
* console.log(` Carrier: ${sim.carrierName}`);
|
|
35
|
+
* console.log(` Country: ${sim.isoCountryCode}`);
|
|
36
|
+
* console.log(` MCC: ${sim.mobileCountryCode}`);
|
|
37
|
+
* console.log(` MNC: ${sim.mobileNetworkCode}`);
|
|
38
|
+
* });
|
|
39
|
+
* ```
|
|
15
40
|
*/
|
|
16
41
|
getSimCards(): Promise<GetSimCardsResult>;
|
|
17
42
|
/**
|
|
18
43
|
* Check permission to access SIM card information.
|
|
19
44
|
*
|
|
20
|
-
*
|
|
45
|
+
* Checks if the app has permission to read SIM card data.
|
|
46
|
+
* On Android, checks READ_PHONE_STATE permission.
|
|
47
|
+
* On iOS, the status is always granted.
|
|
48
|
+
* On Web, the status is always denied.
|
|
21
49
|
*
|
|
50
|
+
* @returns Promise that resolves with permission status
|
|
51
|
+
* @throws Error if checking permissions fails
|
|
22
52
|
* @since 1.0.0
|
|
53
|
+
* @example
|
|
54
|
+
* ```typescript
|
|
55
|
+
* const status = await SimPlugin.checkPermissions();
|
|
56
|
+
* if (status.readSimCard === 'granted') {
|
|
57
|
+
* console.log('Permission granted');
|
|
58
|
+
* } else {
|
|
59
|
+
* console.log('Permission not granted');
|
|
60
|
+
* }
|
|
61
|
+
* ```
|
|
23
62
|
*/
|
|
24
63
|
checkPermissions(): Promise<PermissionStatus>;
|
|
25
64
|
/**
|
|
26
65
|
* Request permission to access SIM card information.
|
|
27
66
|
*
|
|
28
|
-
*
|
|
67
|
+
* Prompts the user to grant permission to read SIM card data.
|
|
68
|
+
* On Android, requests READ_PHONE_STATE permission.
|
|
69
|
+
* On iOS, the status is always granted without prompting.
|
|
70
|
+
* On Web, the status remains denied.
|
|
29
71
|
*
|
|
72
|
+
* @returns Promise that resolves with permission status after the request
|
|
73
|
+
* @throws Error if the permission request fails
|
|
30
74
|
* @since 1.0.0
|
|
75
|
+
* @example
|
|
76
|
+
* ```typescript
|
|
77
|
+
* const status = await SimPlugin.requestPermissions();
|
|
78
|
+
* if (status.readSimCard === 'granted') {
|
|
79
|
+
* // Now you can call getSimCards()
|
|
80
|
+
* const simCards = await SimPlugin.getSimCards();
|
|
81
|
+
* }
|
|
82
|
+
* ```
|
|
31
83
|
*/
|
|
32
84
|
requestPermissions(): Promise<PermissionStatus>;
|
|
85
|
+
/**
|
|
86
|
+
* Get the native Capacitor plugin version.
|
|
87
|
+
*
|
|
88
|
+
* @returns Promise that resolves with the plugin version
|
|
89
|
+
* @throws Error if getting the version fails
|
|
90
|
+
* @since 1.0.0
|
|
91
|
+
* @example
|
|
92
|
+
* ```typescript
|
|
93
|
+
* const { version } = await SimPlugin.getPluginVersion();
|
|
94
|
+
* console.log('Plugin version:', version);
|
|
95
|
+
* ```
|
|
96
|
+
*/
|
|
97
|
+
getPluginVersion(): Promise<{
|
|
98
|
+
version: string;
|
|
99
|
+
}>;
|
|
33
100
|
}
|
|
34
101
|
/**
|
|
35
102
|
* Result returned by {@link SimPlugin.getSimCards}.
|
|
@@ -105,13 +172,4 @@ export interface SimCard {
|
|
|
105
172
|
* @since 1.0.0
|
|
106
173
|
*/
|
|
107
174
|
mobileNetworkCode: string;
|
|
108
|
-
/**
|
|
109
|
-
* Get the native Capacitor plugin version
|
|
110
|
-
*
|
|
111
|
-
* @returns {Promise<{ id: string }>} an Promise with version for this device
|
|
112
|
-
* @throws An error if the something went wrong
|
|
113
|
-
*/
|
|
114
|
-
getPluginVersion(): Promise<{
|
|
115
|
-
version: string;
|
|
116
|
-
}>;
|
|
117
175
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState } from '@capacitor/core';\n\n/**\n * Result of a permission check or request.\n *\n * @since 1.0.0\n */\nexport interface PermissionStatus {\n readSimCard: PermissionState;\n}\n\nexport interface SimPlugin {\n /**\n * Get information from the device's SIM cards.\n *\n * @since 1.0.0\n */\n getSimCards(): Promise<GetSimCardsResult>;\n\n /**\n * Check permission to access SIM card information.\n *\n * On
|
|
1
|
+
{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState } from '@capacitor/core';\n\n/**\n * Result of a permission check or request.\n *\n * @since 1.0.0\n */\nexport interface PermissionStatus {\n readSimCard: PermissionState;\n}\n\n/**\n * Capacitor SIM Plugin for retrieving information from device SIM cards.\n *\n * This plugin provides access to SIM card information such as carrier name,\n * country code, mobile network codes, and more. Supports dual-SIM devices.\n *\n * @since 1.0.0\n */\nexport interface SimPlugin {\n /**\n * Get information from the device's SIM cards.\n *\n * Retrieves details about all SIM cards installed in the device.\n * On dual-SIM devices, returns information for both SIM cards.\n * Requires READ_PHONE_STATE permission on Android.\n *\n * @returns Promise that resolves with SIM cards information\n * @throws Error if permission is denied or reading SIM info fails\n * @since 1.0.0\n * @example\n * ```typescript\n * const { simCards } = await SimPlugin.getSimCards();\n * simCards.forEach((sim, index) => {\n * console.log(`SIM ${index + 1}:`);\n * console.log(` Carrier: ${sim.carrierName}`);\n * console.log(` Country: ${sim.isoCountryCode}`);\n * console.log(` MCC: ${sim.mobileCountryCode}`);\n * console.log(` MNC: ${sim.mobileNetworkCode}`);\n * });\n * ```\n */\n getSimCards(): Promise<GetSimCardsResult>;\n\n /**\n * Check permission to access SIM card information.\n *\n * Checks if the app has permission to read SIM card data.\n * On Android, checks READ_PHONE_STATE permission.\n * On iOS, the status is always granted.\n * On Web, the status is always denied.\n *\n * @returns Promise that resolves with permission status\n * @throws Error if checking permissions fails\n * @since 1.0.0\n * @example\n * ```typescript\n * const status = await SimPlugin.checkPermissions();\n * if (status.readSimCard === 'granted') {\n * console.log('Permission granted');\n * } else {\n * console.log('Permission not granted');\n * }\n * ```\n */\n checkPermissions(): Promise<PermissionStatus>;\n\n /**\n * Request permission to access SIM card information.\n *\n * Prompts the user to grant permission to read SIM card data.\n * On Android, requests READ_PHONE_STATE permission.\n * On iOS, the status is always granted without prompting.\n * On Web, the status remains denied.\n *\n * @returns Promise that resolves with permission status after the request\n * @throws Error if the permission request fails\n * @since 1.0.0\n * @example\n * ```typescript\n * const status = await SimPlugin.requestPermissions();\n * if (status.readSimCard === 'granted') {\n * // Now you can call getSimCards()\n * const simCards = await SimPlugin.getSimCards();\n * }\n * ```\n */\n requestPermissions(): Promise<PermissionStatus>;\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 * @since 1.0.0\n * @example\n * ```typescript\n * const { version } = await SimPlugin.getPluginVersion();\n * console.log('Plugin version:', version);\n * ```\n */\n getPluginVersion(): Promise<{ version: string }>;\n}\n\n/**\n * Result returned by {@link SimPlugin.getSimCards}.\n *\n * @since 1.0.0\n */\nexport interface GetSimCardsResult {\n simCards: SimCard[];\n}\n\n/**\n * A SIM card description.\n *\n * @since 1.0.0\n */\nexport interface SimCard {\n /**\n * Android only: Phone number for this SIM slot, when available.\n *\n * @since 1.0.0\n */\n number?: string;\n\n /**\n * Android only: Unique subscription identifier.\n *\n * @since 1.1.0\n */\n subscriptionId?: string;\n\n /**\n * Android only: Physical SIM slot index for this subscription.\n *\n * @since 1.1.0\n */\n simSlotIndex?: number;\n\n /**\n * iOS only: Indicates whether the carrier supports VoIP.\n *\n * @since 1.0.0\n */\n allowsVOIP?: boolean;\n\n /**\n * Display name of the cellular service provider.\n *\n * On iOS 16.4+ the system may return placeholder values such as `--`.\n * See https://github.com/jonz94/capacitor-sim/issues/8 for details.\n *\n * @since 1.0.0\n */\n carrierName: string;\n\n /**\n * ISO 3166-1 alpha-2 country code of the service provider.\n *\n * On iOS 16.4+ the system may return an empty string or `--`.\n * See https://github.com/jonz94/capacitor-sim/issues/8 for details.\n *\n * @since 1.0.0\n */\n isoCountryCode: string;\n\n /**\n * Mobile Country Code (MCC) of the service provider.\n *\n * On iOS 16.4+ the system may return placeholder values such as `65535`.\n * See https://github.com/jonz94/capacitor-sim/issues/8 for details.\n *\n * @since 1.0.0\n */\n mobileCountryCode: string;\n\n /**\n * Mobile Network Code (MNC) of the service provider.\n *\n * On iOS 16.4+ the system may return placeholder values such as `65535`.\n * See https://github.com/jonz94/capacitor-sim/issues/8 for details.\n *\n * @since 1.0.0\n */\n mobileNetworkCode: string;\n}\n"]}
|
|
@@ -4,7 +4,7 @@ import Foundation
|
|
|
4
4
|
|
|
5
5
|
@objc(SimPlugin)
|
|
6
6
|
public class SimPlugin: CAPPlugin, CAPBridgedPlugin {
|
|
7
|
-
private let PLUGIN_VERSION: String = "7.1.
|
|
7
|
+
private let PLUGIN_VERSION: String = "7.1.6"
|
|
8
8
|
public let identifier = "SimPlugin"
|
|
9
9
|
public let jsName = "Sim"
|
|
10
10
|
public let pluginMethods: [CAPPluginMethod] = [
|