{"id":17766427,"url":"https://github.com/jonz94/capacitor-sim","last_synced_at":"2025-09-04T09:45:35.422Z","repository":{"id":65388018,"uuid":"474492152","full_name":"jonz94/capacitor-sim","owner":"jonz94","description":"⚡️ Capacitor plugin to get information from device's sim cards.","archived":false,"fork":false,"pushed_at":"2025-01-22T05:28:30.000Z","size":897,"stargazers_count":19,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-14T20:51:15.956Z","etag":null,"topics":["android","capacitor","capacitor-android","capacitor-ios","capacitor-plugin","ios","sim-card"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@jonz94/capacitor-sim","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"0bsd","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonz94.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-26T23:43:44.000Z","updated_at":"2025-02-05T09:10:40.000Z","dependencies_parsed_at":"2023-02-08T20:00:55.458Z","dependency_job_id":"338caa8f-d709-44c2-9a85-e7121d77756f","html_url":"https://github.com/jonz94/capacitor-sim","commit_stats":{"total_commits":30,"total_committers":1,"mean_commits":30.0,"dds":0.0,"last_synced_commit":"78f8f972c35576a12b7811578f6444a2cd95071a"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonz94%2Fcapacitor-sim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonz94%2Fcapacitor-sim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonz94%2Fcapacitor-sim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonz94%2Fcapacitor-sim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonz94","download_url":"https://codeload.github.com/jonz94/capacitor-sim/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243646581,"owners_count":20324584,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","capacitor","capacitor-android","capacitor-ios","capacitor-plugin","ios","sim-card"],"created_at":"2024-10-26T20:29:27.907Z","updated_at":"2025-03-15T12:30:37.257Z","avatar_url":"https://github.com/jonz94.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cbr\u003e\u003cimg src=\"https://user-images.githubusercontent.com/236501/85893648-1c92e880-b7a8-11ea-926d-95355b8175c7.png\" width=\"128\" height=\"128\" /\u003e\u003c/p\u003e\n\u003ch3 align=\"center\"\u003eSim\u003c/h3\u003e\n\u003cp align=\"center\"\u003e\u003cstrong\u003e\u003ccode\u003e@jonz94/capacitor-sim\u003c/code\u003e\u003c/strong\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  Capacitor plugin to get information from device's sim cards.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/jonz94/capacitor-sim/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/jonz94/capacitor-sim/ci.yml?branch=main\u0026logo=github\u0026style=flat-square\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@jonz94/capacitor-sim\"\u003e\u003cimg src=\"https://img.shields.io/npm/l/@jonz94/capacitor-sim?style=flat-square\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@jonz94/capacitor-sim\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@jonz94/capacitor-sim?style=flat-square\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Install\n\n```shell\nnpm install @jonz94/capacitor-sim\nnpx cap sync\n```\n\n## Android\n\n### Variables\n\nThis plugin will use the following project variables (defined in your app's `variables.gradle` file):\n- `androidxCoreKTXVersion` version of `androidx.core:core-ktx` (default: `1.10.0`)\n- `kotlin_version` version of `org.jetbrains.kotlin:kotlin-stdlib` (default: `1.8.20`)\n\n## Configuration\n\nNo configuration required for this plugin.\n\n## Demo\n\nA working example can be found here: [jonz94/capacitor-sim-demo](https://github.com/jonz94/capacitor-sim-demo)\n\n## Usage\n\n```typescript\nimport { Sim } from '@jonz94/capacitor-sim';\n\nconst getSimCards = async () =\u003e {\n  const { simCards } = await Sim.getSimCards();\n\n  // console.log(simCards);\n\n  return simCards;\n}\n```\n\n## API\n\n\u003cdocgen-index\u003e\n\n* [`getSimCards()`](#getsimcards)\n* [`checkPermissions()`](#checkpermissions)\n* [`requestPermissions()`](#requestpermissions)\n* [Interfaces](#interfaces)\n* [Type Aliases](#type-aliases)\n\n\u003c/docgen-index\u003e\n\n\u003cdocgen-api\u003e\n\u003c!--Update the source file JSDoc comments and rerun docgen to update the docs below--\u003e\n\n### getSimCards()\n\n```typescript\ngetSimCards() =\u003e Promise\u003cGetSimCardsResult\u003e\n```\n\nGet information from device's sim cards.\n\n**Returns:** \u003ccode\u003ePromise\u0026lt;\u003ca href=\"#getsimcardsresult\"\u003eGetSimCardsResult\u003c/a\u003e\u0026gt;\u003c/code\u003e\n\n**Since:** 1.0.0\n\n--------------------\n\n\n### checkPermissions()\n\n```typescript\ncheckPermissions() =\u003e Promise\u003cPermissionStatus\u003e\n```\n\nCheck permission to get information from device's sim cards.\n\nOn iOS the status is always granted.\n\n**Returns:** \u003ccode\u003ePromise\u0026lt;\u003ca href=\"#permissionstatus\"\u003ePermissionStatus\u003c/a\u003e\u0026gt;\u003c/code\u003e\n\n**Since:** 1.0.0\n\n--------------------\n\n\n### requestPermissions()\n\n```typescript\nrequestPermissions() =\u003e Promise\u003cPermissionStatus\u003e\n```\n\nRequest permission to get information from device's sim cards.\n\nOn iOS the status is always granted.\n\n**Returns:** \u003ccode\u003ePromise\u0026lt;\u003ca href=\"#permissionstatus\"\u003ePermissionStatus\u003c/a\u003e\u0026gt;\u003c/code\u003e\n\n**Since:** 1.0.0\n\n--------------------\n\n\n### Interfaces\n\n\n#### GetSimCardsResult\n\n| Prop           | Type                   |\n| -------------- | ---------------------- |\n| **`simCards`** | \u003ccode\u003eSimCard[]\u003c/code\u003e |\n\n\n#### SimCard\n\n| Prop                    | Type                 | Description                                                                                       | Since |\n| ----------------------- | -------------------- | ------------------------------------------------------------------------------------------------- | ----- |\n| **`number`**            | \u003ccode\u003estring\u003c/code\u003e  | Android only: Phone number.                                                                       | 1.0.0 |\n| **`allowsVOIP`**        | \u003ccode\u003eboolean\u003c/code\u003e | iOS only: If this carrier allows VOIP calls to be made on its network.                            | 1.0.0 |\n| **`carrierName`**       | \u003ccode\u003estring\u003c/code\u003e  | The name of the cellular service provider.                                                        | 1.0.0 |\n| **`isoCountryCode`**    | \u003ccode\u003estring\u003c/code\u003e  | Country code for the cellular service provider, represented as an ISO 3166-1 country code string. | 1.0.0 |\n| **`mobileCountryCode`** | \u003ccode\u003estring\u003c/code\u003e  | Mobile country code (MCC) for the cellular service provider, in its numeric representation.       | 1.0.0 |\n| **`mobileNetworkCode`** | \u003ccode\u003estring\u003c/code\u003e  | Mobile network code (MNC) for the cellular service provider, in its numeric representation.       | 1.0.0 |\n\n\n#### PermissionStatus\n\n| Prop              | Type                                                        |\n| ----------------- | ----------------------------------------------------------- |\n| **`readSimCard`** | \u003ccode\u003e\u003ca href=\"#permissionstate\"\u003ePermissionState\u003c/a\u003e\u003c/code\u003e |\n\n\n### Type Aliases\n\n\n#### PermissionState\n\n\u003ccode\u003e'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'\u003c/code\u003e\n\n\u003c/docgen-api\u003e\n\n## Changelog\n\nSee [CHANGELOG.md](https://github.com/jonz94/capacitor-sim/blob/main/CHANGELOG.md).\n\n## License\n\nSee [LICENSE](https://github.com/jonz94/capacitor-sim/blob/main/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonz94%2Fcapacitor-sim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonz94%2Fcapacitor-sim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonz94%2Fcapacitor-sim/lists"}