@symbiote-native/cellular 3.0.2 → 3.0.3

package/README.md

@@ -1,15 +1,15 @@
 # @symbiote-native/cellular
 
 A wrapper package for [SymbioteNative](../../README.md) that makes
-[`expo-cellular`](https://docs.expo.dev/versions/latest/sdk/cellular/) — cellular connection
-generation, carrier/SIM info, and VoIP-support detection — reachable from **every** adapter:
+[`expo-cellular`](https://docs.expo.dev/versions/latest/sdk/cellular/) - cellular connection
+generation, carrier/SIM info, and VoIP-support detection - reachable from **every** adapter:
 React, Vue, Svelte, Solid, and Angular, not just React. Like [`@symbiote-native/sensors`](../sensors) and
 unlike this repo's plain-RN-module/view wrappers ([`@symbiote-native/slider`](../slider),
 [`@symbiote-native/splash-screen`](../splash-screen)), `expo-cellular` is built on
 `expo-modules-core`, so its native code autolinks straight out of `node_modules` via
-`expo-modules-autolinking` — no proxy `react-native.config.cjs`/podspec to ship. `expo-cellular`'s
+`expo-modules-autolinking` - no proxy `react-native.config.cjs`/podspec to ship. `expo-cellular`'s
 own JS is never imported (it hard-imports the full `expo` meta-package, which this project never
-depends on) — every function is hand-ported into this package's own `core/`.
+depends on) - every function is hand-ported into this package's own `core/`.
 
 ## Install
 
@@ -25,39 +25,39 @@ npx @symbiote-native/cli new my-app --cellular
 npx @symbiote-native/cli add --cellular
 ```
 
-Either way: installs `@symbiote-native/cellular` and wires the native autolinking automatically —
+Either way: installs `@symbiote-native/cellular` and wires the native autolinking automatically,
 see [`@symbiote-native/cli`](../cli).
 
 <details>
-<summary>Manual install (no CLI — installing and wiring native autolinking by hand)</summary>
+<summary>Manual install (no CLI - installing and wiring native autolinking by hand)</summary>
 
 ```bash
 npm install @symbiote-native/cellular
 ```
 
 Depends on `expo-cellular` and `expo-modules-core` directly (regular dependencies, pinned to
-exact versions — never a caret range, since this package's `core/` is hand-ported against one
+exact versions - never a caret range, since this package's `core/` is hand-ported against one
 specific native API shape and a newer resolve could silently drift the two apart). Never install
-`expo-cellular` yourself, and never add the `expo` meta-package to this project — it bundles its
+`expo-cellular` yourself, and never add the `expo` meta-package to this project - it bundles its
 own Metro/Babel pipeline that conflicts with this project's own.
 
 ### Required one-time step: native autolinking wiring
 
 Unlike a plain RN native module, `expo-cellular`'s native code is discovered by
-`expo-modules-autolinking`, not RN's own `react-native.config.cjs` mechanism — this needs wiring
+`expo-modules-autolinking`, not RN's own `react-native.config.cjs` mechanism - this needs wiring
 into the native host app **once**, covering this package and every other `expo-modules-core`
 package with zero further changes:
 
 | Platform | Touches                                                                                                                                             |
 | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
-| iOS      | `ios/Podfile` — add `use_expo_modules!`                                                                                                             |
-| iOS      | `AppDelegate.swift` — Expo's runtime-bootstrap hook                                                                                                 |
-| Android  | `settings.gradle` / `app/build.gradle` — resolve and include the Expo Gradle projects                                                               |
-| Android  | `MainApplication.kt` — Expo's bootstrap hook, plus a hand-written native-module name map (there's no `expo` meta-package here to auto-generate one) |
-| Android  | `AndroidManifest.xml` — the `READ_PHONE_STATE` permission, needed to read carrier/SIM info                                                          |
-
-Full mechanics — the Podfile pieces that normally ship inside the `expo` package, the `expo`
-peer-dependency exclusion list, per-module permission strings — live in the
+| iOS      | `ios/Podfile` - add `use_expo_modules!`                                                                                                             |
+| iOS      | `AppDelegate.swift` - Expo's runtime-bootstrap hook                                                                                                 |
+| Android  | `settings.gradle` / `app/build.gradle` - resolve and include the Expo Gradle projects                                                               |
+| Android  | `MainApplication.kt` - Expo's bootstrap hook, plus a hand-written native-module name map (there's no `expo` meta-package here to auto-generate one) |
+| Android  | `AndroidManifest.xml` - the `READ_PHONE_STATE` permission, needed to read carrier/SIM info                                                          |
+
+Full mechanics - the Podfile pieces that normally ship inside the `expo` package, the `expo`
+peer-dependency exclusion list, per-module permission strings - live in the
 `symbiote-expo-native-module` project skill. This wiring is already done for all six
 `examples/expo-*` canary apps (React, Vue SFC, Vue TSX, Svelte, Solid, Angular).
 
@@ -69,16 +69,16 @@ peer-dependency exclusion list, per-module permission strings — live in the
 src/core/              cellular.ts (the free functions) + types.ts (CellularGeneration enum) +
                         native-module.ts, which resolves the native module by name through
                         expo-modules-core's requireNativeModule.
-src/react/hooks/        @symbiote-native/cellular/react   — usePermissions
-src/vue/composables/    @symbiote-native/cellular/vue     — usePermissions
-src/svelte/runes/       @symbiote-native/cellular/svelte  — usePermissions
-src/solid/primitives/   @symbiote-native/cellular/solid   — createPermissions (Solid says
+src/react/hooks/        @symbiote-native/cellular/react   - usePermissions
+src/vue/composables/    @symbiote-native/cellular/vue     - usePermissions
+src/svelte/runes/       @symbiote-native/cellular/svelte  - usePermissions
+src/solid/primitives/   @symbiote-native/cellular/solid   - createPermissions (Solid says
                                                             create*, not use*)
-src/angular/services/   @symbiote-native/cellular/angular — PermissionsService
+src/angular/services/   @symbiote-native/cellular/angular - PermissionsService
 ```
 
 Each adapter's `usePermissions` hook/composable/service is a thin lifecycle wrapper (fetch on
-mount, expose `request`/`get` to re-check imperatively) over the same `core` functions — the
+mount, expose `request`/`get` to re-check imperatively) over the same `core` functions - the
 permission-fetch logic is written once and shared by every adapter.
 
 ## Use it
@@ -267,7 +267,7 @@ export class CellularScreen {
 }
 ```
 
-Trimmed from the real demo screens — `examples/expo-react/screens/CellularScreen.tsx` and its
+Trimmed from the real demo screens - `examples/expo-react/screens/CellularScreen.tsx` and its
 Vue SFC, Vue TSX, Svelte, Solid, and Angular twins (`examples/expo-vue-sfc/screens/CellularScreen.vue`,
 `examples/expo-vue-tsx/screens/CellularScreen.tsx`, `examples/expo-svelte/screens/CellularScreen.svelte`,
 `examples/expo-solid/screens/CellularScreen.tsx`, `examples/expo-angular/src/screens/CellularScreen.ts`),
@@ -276,12 +276,12 @@ which also cover `allowsVoipAsync`/`getIsoCountryCodeAsync`/`getMobileCountryCod
 
 ## API
 
-Mostly stateless async functions, no event stream — plus one stateful pair,
+Mostly stateless async functions, no event stream - plus one stateful pair,
 `getPermissionsAsync`/`requestPermissionsAsync`, which gets its own lifecycle
 hook/composable/service (`usePermissions`) so a component can re-check permission status
 imperatively without re-wiring the fetch itself.
 
-Carrier/SIM info and VoIP support are **Android only** — every one of those functions resolves
+Carrier/SIM info and VoIP support are **Android only** - every one of those functions resolves
 `null` on iOS without touching the native module at all, since iOS doesn't expose this
 information. `getPermissionsAsync`/`requestPermissionsAsync` need no real permission grant on
 iOS either (cellular info requires none there), so they resolve a plain `GRANTED` response
@@ -290,26 +290,26 @@ without a native call.
 ```ts
 getCellularGenerationAsync(): Promise<CellularGeneration>
 // UNKNOWN/CELLULAR_2G/CELLULAR_3G/CELLULAR_4G/CELLULAR_5G. Delegates to the native module on
-// every platform — no iOS gate, unlike every other function below.
+// every platform - no iOS gate, unlike every other function below.
 
 allowsVoipAsync(): Promise<boolean | null>
 // @deprecated (upstream is deprecating this). null on iOS, native call on Android.
 
-getIsoCountryCodeAsync(): Promise<string | null>       // Android only — null on iOS.
-getCarrierNameAsync(): Promise<string | null>           // Android only — null on iOS.
-getMobileCountryCodeAsync(): Promise<string | null>     // Android only — null on iOS.
-getMobileNetworkCodeAsync(): Promise<string | null>     // Android only — null on iOS.
+getIsoCountryCodeAsync(): Promise<string | null>       // Android only - null on iOS.
+getCarrierNameAsync(): Promise<string | null>           // Android only - null on iOS.
+getMobileCountryCodeAsync(): Promise<string | null>     // Android only - null on iOS.
+getMobileNetworkCodeAsync(): Promise<string | null>     // Android only - null on iOS.
 
 getPermissionsAsync(): Promise<PermissionResponse>
 // Android delegates to the native module; every other platform resolves a plain GRANTED
-// literal — no permission is needed there for cellular info.
+// literal - no permission is needed there for cellular info.
 
 requestPermissionsAsync(): Promise<PermissionResponse>
 // Same split as getPermissionsAsync.
 ```
 
 Plus `CellularGeneration` (enum) and `PermissionResponse`/`PermissionStatus`/
-`PermissionExpiration` — the latter three re-exported straight from `expo-modules-core`, not
+`PermissionExpiration` - the latter three re-exported straight from `expo-modules-core`, not
 ported by hand.
 
 ```ts
@@ -329,41 +329,50 @@ import { PermissionsService } from '@symbiote-native/cellular/angular';
 ### `usePermissions`
 
 Fetches the current permission status on mount, then exposes `request`/`get` to re-check it
-imperatively — every adapter follows the same shape as its sibling `PermissionsService`/
+imperatively - every adapter follows the same shape as its sibling `PermissionsService`/
 composable in `@symbiote-native/brightness`, the other package in this repo needing the same
 get/request permission pair.
 
 ```tsx
-// React — a [status, request, get] tuple, mirroring upstream's own usePermissions hooks
+// React - a [status, request, get] tuple, mirroring upstream's own usePermissions hooks
 const [status, requestPermission, getPermission] = usePermissions();
 ```
 
 ```ts
-// Vue — a { status, request, get } object; status is a Ref
+// Vue - a { status, request, get } object; status is a Ref
 const { status, request, get } = usePermissions();
 ```
 
 ```ts
-// Svelte — the same object, boxed as getters: permissions.status
+// Svelte - the same object, boxed as getters: permissions.status
 const permissions = usePermissions();
 ```
 
 ```ts
-// Solid — createPermissions, and status/error are accessors: status()
+// Solid - createPermissions, and status/error are accessors: status()
 const { status, request, get } = createPermissions();
 ```
 
 ```ts
-// Angular — connect() returns a readonly Signal; request()/get() live on the service itself
+// Angular - connect() returns a readonly Signal; request()/get() live on the service itself
 readonly status = inject(PermissionsService).connect();
 // later: inject(PermissionsService).request()
 ```
 
+## Common questions
+
+- **Carrier name is `null`.** The user never configured a carrier.
+- **`--` or `65535` on iOS 16.4+.** `CTCarrier` is deprecated with no replacement; treat as unknown.
+- **Deprecated properties.** Use the async getters instead of `allowsVoip` and `carrier`.
+
+Sources: [Expo docs: Cellular](https://docs.expo.dev/versions/v54.0.0/sdk/cellular/),
+[iOS 16 CTCarrier deprecation](https://developer.apple.com/forums/thread/714876).
+
 ## Test it
 
-No Fabric/Descriptor angle at all — cellular info is a pure async-function + permission surface,
+No Fabric/Descriptor angle at all - cellular info is a pure async-function + permission surface,
 never a view. Tests inject a fake native-module object in place of the real
 `requireNativeModule` resolution (`src/core/cellular.test.ts`,
-`src/{react,vue,svelte,solid,angular}/**/*.test.{ts,tsx}`, run via `vitest`) — no `installFabric()`, no
+`src/{react,vue,svelte,solid,angular}/**/*.test.{ts,tsx}`, run via `vitest`) - no `installFabric()`, no
 ViewConfig. Native rendering itself is verified on-device (see the parent
 [README](../../README.md)).

package/build/angular/services/permissions.service/index.d.ts

@@ -1,12 +1,5 @@
-import { type Signal } from '@angular/core';
+import { PermissionsServiceBase } from '@symbiote-native/angular';
 import { type PermissionResponse } from '../../../core';
-export declare class PermissionsService {
-    private readonly status;
-    private readonly fetchError;
-    private isAutoFetchStarted;
-    /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
-    readonly error: Signal<Error | null>;
-    connect(): Signal<PermissionResponse | null>;
-    get(): Promise<PermissionResponse>;
-    request(): Promise<PermissionResponse>;
+export declare class PermissionsService extends PermissionsServiceBase<PermissionResponse> {
+    constructor();
 }

package/build/angular/services/permissions.service/index.js

@@ -1,3 +1,4 @@
+// Angular twin of React's `usePermissions`: `inject(PermissionsService).connect()` gives a signal
 var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
     function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
     var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
@@ -32,60 +33,26 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-// Angular twin of React's `usePermissions` hook and Vue's `usePermissions` composable —
-// see BatteryStateService's connect() pattern for the shape rationale.
-//
-//   readonly status = inject(PermissionsService).connect();
-//   // template: {{ status()?.granted }}
-//
-// The auto-fetch has nobody to reject to, so its failure lands in the `error` signal instead of
-// escaping as an unhandled rejection: a null status with a non-null error is how a consumer tells
-// "the fetch failed" from "not fetched yet". get()/request() still reject to their direct caller —
-// only the automatic call is made safe.
-import { Injectable, signal } from '@angular/core';
+import { Injectable } from '@angular/core';
+import { PermissionsServiceBase } from '@symbiote-native/angular';
 import { getPermissionsAsync, requestPermissionsAsync, } from '../../../core/index.js';
 let PermissionsService = (() => {
     let _classDecorators = [Injectable({ providedIn: 'root' })];
     let _classDescriptor;
     let _classExtraInitializers = [];
     let _classThis;
-    var PermissionsService = class {
+    let _classSuper = PermissionsServiceBase;
+    var PermissionsService = class extends _classSuper {
         static { _classThis = this; }
         static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
             __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
             PermissionsService = _classThis = _classDescriptor.value;
             if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
             __runInitializers(_classThis, _classExtraInitializers);
         }
-        status = signal(null);
-        fetchError = signal(null);
-        isAutoFetchStarted = false;
-        /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
-        error = this.fetchError.asReadonly();
-        connect() {
-            // Latched rather than guarded on `status() === null`: a failed fetch leaves status null
-            // forever, so the old guard turned every later connect() into another native call — unbounded
-            // once connect() is reached from a change-detected expression instead of a field initializer.
-            if (!this.isAutoFetchStarted) {
-                this.isAutoFetchStarted = true;
-                this.get().catch((cause) => {
-                    this.fetchError.set(cause instanceof Error ? cause : new Error(String(cause)));
-                });
-            }
-            return this.status.asReadonly();
-        }
-        async get() {
-            const response = await getPermissionsAsync();
-            this.status.set(response);
-            this.fetchError.set(null);
-            return response;
-        }
-        async request() {
-            const response = await requestPermissionsAsync();
-            this.status.set(response);
-            this.fetchError.set(null);
-            return response;
+        constructor() {
+            super(getPermissionsAsync, requestPermissionsAsync);
         }
     };
     return PermissionsService = _classThis;

package/build-ngc/angular/services/permissions.service/index.d.ts

@@ -1,15 +1,8 @@
-import { type Signal } from '@angular/core';
+import { PermissionsServiceBase } from '@symbiote-native/angular';
 import { type PermissionResponse } from '../../../core';
 import * as i0 from "@angular/core";
-export declare class PermissionsService {
-    private readonly status;
-    private readonly fetchError;
-    private isAutoFetchStarted;
-    /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
-    readonly error: Signal<Error | null>;
-    connect(): Signal<PermissionResponse | null>;
-    get(): Promise<PermissionResponse>;
-    request(): Promise<PermissionResponse>;
+export declare class PermissionsService extends PermissionsServiceBase<PermissionResponse> {
+    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<PermissionsService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<PermissionsService>;
 }

package/build-ngc/angular/services/permissions.service/index.js

@@ -1,47 +1,11 @@
-// Angular twin of React's `usePermissions` hook and Vue's `usePermissions` composable —
-// see BatteryStateService's connect() pattern for the shape rationale.
-//
-//   readonly status = inject(PermissionsService).connect();
-//   // template: {{ status()?.granted }}
-//
-// The auto-fetch has nobody to reject to, so its failure lands in the `error` signal instead of
-// escaping as an unhandled rejection: a null status with a non-null error is how a consumer tells
-// "the fetch failed" from "not fetched yet". get()/request() still reject to their direct caller —
-// only the automatic call is made safe.
-import { Injectable, signal } from '@angular/core';
+// Angular twin of React's `usePermissions`: `inject(PermissionsService).connect()` gives a signal
+import { Injectable } from '@angular/core';
+import { PermissionsServiceBase } from '@symbiote-native/angular';
 import { getPermissionsAsync, requestPermissionsAsync, } from '../../../core';
 import * as i0 from "@angular/core";
-export class PermissionsService {
-    status = signal(null, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "status" }] : /* istanbul ignore next */ []));
-    fetchError = signal(null, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "fetchError" }] : /* istanbul ignore next */ []));
-    isAutoFetchStarted = false;
-    /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
-    error = this.fetchError.asReadonly();
-    connect() {
-        // Latched rather than guarded on `status() === null`: a failed fetch leaves status null
-        // forever, so the old guard turned every later connect() into another native call — unbounded
-        // once connect() is reached from a change-detected expression instead of a field initializer.
-        if (!this.isAutoFetchStarted) {
-            this.isAutoFetchStarted = true;
-            this.get().catch((cause) => {
-                this.fetchError.set(cause instanceof Error ? cause : new Error(String(cause)));
-            });
-        }
-        return this.status.asReadonly();
-    }
-    async get() {
-        const response = await getPermissionsAsync();
-        this.status.set(response);
-        this.fetchError.set(null);
-        return response;
-    }
-    async request() {
-        const response = await requestPermissionsAsync();
-        this.status.set(response);
-        this.fetchError.set(null);
-        return response;
+export class PermissionsService extends PermissionsServiceBase {
+    constructor() {
+        super(getPermissionsAsync, requestPermissionsAsync);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: PermissionsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: PermissionsService, providedIn: 'root' });
@@ -49,5 +13,5 @@ export class PermissionsService {
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: PermissionsService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
-        }] });
+        }], ctorParameters: () => [] });
 //# sourceMappingURL=index.js.map

package/build-ngc/angular/services/permissions.service/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/angular/services/permissions.service/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,uEAAuE;AACvE,EAAE;AACF,4DAA4D;AAC5D,yCAAyC;AACzC,EAAE;AACF,gGAAgG;AAChG,kGAAkG;AAClG,mGAAmG;AACnG,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,eAAe,CAAC;;AAGvB,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAG,MAAM,CAA4B,IAAI;+EAAC,CAAC;IACjD,UAAU,GAAG,MAAM,CAAe,IAAI;mFAAC,CAAC;IACjD,kBAAkB,GAAG,KAAK,CAAC;IAEnC,gGAAgG;IACvF,KAAK,GAAyB,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;IAEpE,OAAO;QACL,wFAAwF;QACxF,8FAA8F;QAC9F,8FAA8F;QAC9F,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CACjB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,uBAAuB,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;uGAnCU,kBAAkB;2GAAlB,kBAAkB,cADL,MAAM;;2FACnB,kBAAkB;kBAD9B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/angular/services/permissions.service/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAElG,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,eAAe,CAAC;;AAGvB,MAAM,OAAO,kBAAmB,SAAQ,sBAA0C;IAChF;QACE,KAAK,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC;IACtD,CAAC;uGAHU,kBAAkB;2GAAlB,kBAAkB,cADL,MAAM;;2FACnB,kBAAkB;kBAD9B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/cellular",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "expo-cellular wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Cellular generation (2G/3G/4G/5G), carrier/SIM info on Android (ISO country code, carrier name, MCC/MNC), VoIP-support detection, and the permission get/request pair gating carrier info on Android.",
   "license": "MIT",
   "repository": {
@@ -70,7 +70,7 @@
   },
   "dependencies": {
     "expo-cellular": "57.0.1",
-    "expo-modules-core": "57.0.5"
+    "expo-modules-core": "57.0.20"
   },
   "peerDependencies": {
     "@angular/core": ">=20",
@@ -80,12 +80,12 @@
     "solid-js": ">=1.9.0",
     "svelte": ">=5.56.0",
     "vue": ">=3.5.0",
-    "@symbiote-native/angular": "^3.1.2",
-    "@symbiote-native/engine": "^1.3.1",
-    "@symbiote-native/react": "^3.0.4",
-    "@symbiote-native/solid": "^3.0.4",
-    "@symbiote-native/svelte": "^3.0.4",
-    "@symbiote-native/vue": "^3.0.4"
+    "@symbiote-native/angular": "^3.2.0",
+    "@symbiote-native/engine": "^1.5.0",
+    "@symbiote-native/react": "^3.2.0",
+    "@symbiote-native/solid": "^3.1.0",
+    "@symbiote-native/svelte": "^3.1.0",
+    "@symbiote-native/vue": "^3.2.0"
   },
   "peerDependenciesMeta": {
     "@symbiote-native/angular": {
@@ -133,13 +133,13 @@
     "solid-js": "^1.9.14",
     "svelte": "^5.56.0",
     "typescript": "~6.0.0",
-    "@symbiote-native/angular": "3.1.2",
-    "@symbiote-native/engine": "1.3.1",
-    "@symbiote-native/react": "3.0.4",
-    "@symbiote-native/solid": "3.0.4",
-    "@symbiote-native/svelte": "3.0.4",
-    "@symbiote-native/test-utils": "0.4.4",
-    "@symbiote-native/vue": "3.0.4"
+    "@symbiote-native/angular": "3.2.0",
+    "@symbiote-native/engine": "1.5.0",
+    "@symbiote-native/react": "3.2.0",
+    "@symbiote-native/solid": "3.1.0",
+    "@symbiote-native/svelte": "3.1.0",
+    "@symbiote-native/test-utils": "0.4.6",
+    "@symbiote-native/vue": "3.2.0"
   },
   "scripts": {
     "typecheck": "tsc --build",

package/src/angular/services/permissions.service/index.ts

@@ -1,14 +1,7 @@
-// Angular twin of React's `usePermissions` hook and Vue's `usePermissions` composable —
-// see BatteryStateService's connect() pattern for the shape rationale.
-//
-//   readonly status = inject(PermissionsService).connect();
-//   // template: {{ status()?.granted }}
-//
-// The auto-fetch has nobody to reject to, so its failure lands in the `error` signal instead of
-// escaping as an unhandled rejection: a null status with a non-null error is how a consumer tells
-// "the fetch failed" from "not fetched yet". get()/request() still reject to their direct caller —
-// only the automatic call is made safe.
-import { Injectable, signal, type Signal } from '@angular/core';
+// Angular twin of React's `usePermissions`: `inject(PermissionsService).connect()` gives a signal
+
+import { Injectable } from '@angular/core';
+import { PermissionsServiceBase } from '@symbiote-native/angular';
 import {
   getPermissionsAsync,
   requestPermissionsAsync,
@@ -16,40 +9,8 @@ import {
 } from '../../../core';
 
 @Injectable({ providedIn: 'root' })
-export class PermissionsService {
-  private readonly status = signal<PermissionResponse | null>(null);
-  private readonly fetchError = signal<Error | null>(null);
-  private isAutoFetchStarted = false;
-
-  /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
-  readonly error: Signal<Error | null> = this.fetchError.asReadonly();
-
-  connect(): Signal<PermissionResponse | null> {
-    // Latched rather than guarded on `status() === null`: a failed fetch leaves status null
-    // forever, so the old guard turned every later connect() into another native call — unbounded
-    // once connect() is reached from a change-detected expression instead of a field initializer.
-    if (!this.isAutoFetchStarted) {
-      this.isAutoFetchStarted = true;
-      this.get().catch((cause: unknown) => {
-        this.fetchError.set(
-          cause instanceof Error ? cause : new Error(String(cause)),
-        );
-      });
-    }
-    return this.status.asReadonly();
-  }
-
-  async get(): Promise<PermissionResponse> {
-    const response = await getPermissionsAsync();
-    this.status.set(response);
-    this.fetchError.set(null);
-    return response;
-  }
-
-  async request(): Promise<PermissionResponse> {
-    const response = await requestPermissionsAsync();
-    this.status.set(response);
-    this.fetchError.set(null);
-    return response;
+export class PermissionsService extends PermissionsServiceBase<PermissionResponse> {
+  constructor() {
+    super(getPermissionsAsync, requestPermissionsAsync);
   }
 }