@symbiote-native/cellular 0.0.1 → 0.1.0

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

@@ -38,7 +38,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
 //   readonly status = inject(PermissionsService).connect();
 //   // template: {{ status()?.granted }}
 import { Injectable, signal } from '@angular/core';
-import { getPermissionsAsync, requestPermissionsAsync, } from '../../../core';
+import { getPermissionsAsync, requestPermissionsAsync, } from '../../../core/index.js';
 let PermissionsService = (() => {
     let _classDecorators = [Injectable({ providedIn: 'root' })];
     let _classDescriptor;

package/build/core/cellular.js

@@ -6,8 +6,8 @@
 // all and resolves a plain GRANTED literal. Upstream's web branch (navigator.connection) is out
 // of scope — this repo has no web target for this package's native-module resolution path.
 import { Platform, PermissionStatus, UnavailabilityError, } from 'expo-modules-core';
-import { expoCellular } from './native-module';
-import { CellularGeneration } from './types';
+import { expoCellular } from './native-module.js';
+import { CellularGeneration } from './types.js';
 const NATIVE_MODULE_NAME = 'expo-cellular';
 const GRANTED_PERMISSION_RESPONSE = {
     status: PermissionStatus.GRANTED,

package/build/react/hooks/use-permissions/index.js

@@ -1,7 +1,7 @@
 // React lifecycle wiring over the framework-agnostic core (core/cellular.ts) — fetches the
 // current permission status on mount, then exposes request/get to re-check imperatively.
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { getPermissionsAsync, requestPermissionsAsync, } from '../../../core';
+import { getPermissionsAsync, requestPermissionsAsync, } from '../../../core/index.js';
 export function usePermissions() {
     const isMounted = useRef(true);
     const [status, setStatus] = useState(null);

package/build/vue/composables/use-permissions/index.js

@@ -1,7 +1,7 @@
 // Vue lifecycle wiring over the framework-agnostic core (core/cellular.ts) — fetches the
 // current permission status on mount, then exposes request/get to re-check imperatively.
 import { onMounted, ref } from '@vue/runtime-core';
-import { getPermissionsAsync, requestPermissionsAsync, } from '../../../core';
+import { getPermissionsAsync, requestPermissionsAsync, } from '../../../core/index.js';
 export function usePermissions() {
     const status = ref(null);
     const get = async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/cellular",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "expo-cellular wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, 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": {
@@ -40,7 +40,10 @@
     "src",
     "build",
     "build-ngc",
-    "native-link.json"
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
   ],
   "publishConfig": {
     "access": "public"
@@ -56,7 +59,7 @@
     "react": ">=19.0.0",
     "react-native": ">=0.86",
     "vue": ">=3.5.0",
-    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/angular": "0.6.2",
     "@symbiote-native/react": "0.2.8",
     "@symbiote-native/vue": "0.3.8"
   },
@@ -92,11 +95,11 @@
     "@vue/runtime-core": "^3.5.13",
     "react": "19.2.3",
     "typescript": "~6.0.0",
-    "@symbiote-native/vue": "0.3.8",
-    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/angular": "0.6.2",
+    "@symbiote-native/engine": "0.1.7",
     "@symbiote-native/react": "0.2.8",
     "@symbiote-native/test-utils": "0.1.6",
-    "@symbiote-native/engine": "0.1.7"
+    "@symbiote-native/vue": "0.3.8"
   },
   "scripts": {
     "typecheck": "tsc --build",

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

@@ -1,109 +0,0 @@
-// Co-located Angular-driven test (ADR 0025) for PermissionsService. See
-// packages/battery/src/angular/services/battery-state.service/battery-state.service.test.ts for
-// the shared rationale, adapted here to test the get/request permission pair instead of a
-// listener subscription.
-
-import '@angular/compiler';
-import { Component, inject, type Signal } from '@angular/core';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount } from '@symbiote-native/angular';
-import { installFabric } from '@symbiote-native/test-utils';
-import { PermissionsService } from './index';
-
-type IPermissionResponse = {
-  status: string;
-  expires: 'never';
-  granted: boolean;
-  canAskAgain: boolean;
-};
-
-const GRANTED: IPermissionResponse = {
-  status: 'granted',
-  expires: 'never',
-  granted: true,
-  canAskAgain: true,
-};
-const DENIED: IPermissionResponse = {
-  status: 'denied',
-  expires: 'never',
-  granted: false,
-  canAskAgain: true,
-};
-
-const getPermissionsAsyncMock = vi.fn(async () => GRANTED);
-const requestPermissionsAsyncMock = vi.fn(async () => GRANTED);
-
-vi.mock('../../../core', () => ({
-  getPermissionsAsync: () => getPermissionsAsyncMock(),
-  requestPermissionsAsync: () => requestPermissionsAsyncMock(),
-}));
-
-const ROOT_TAG = 973;
-const fabric = installFabric();
-const tick = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));
-
-let capturedResult: Signal<IPermissionResponse | null> | undefined;
-let capturedService: PermissionsService | undefined;
-
-@Component({
-  selector: 'symbiote-permissions-host',
-  standalone: true,
-  template: '',
-})
-class PermissionsHost {
-  private readonly service = inject(PermissionsService);
-  readonly status = this.service.connect();
-
-  constructor() {
-    capturedResult = this.status;
-    capturedService = this.service;
-  }
-}
-
-beforeEach(() => {
-  fabric.reset();
-  capturedResult = undefined;
-  capturedService = undefined;
-  getPermissionsAsyncMock.mockClear();
-  requestPermissionsAsyncMock.mockClear();
-  getPermissionsAsyncMock.mockResolvedValue(GRANTED);
-  requestPermissionsAsyncMock.mockResolvedValue(GRANTED);
-});
-
-afterEach(() => unmount(ROOT_TAG));
-
-describe('PermissionsService.connect', () => {
-  it('starts at null before the initial get() resolves', () => {
-    mount(ROOT_TAG, PermissionsHost);
-
-    expect(capturedResult?.()).toBeNull();
-  });
-
-  it('fetches the permission status once connect() is called', async () => {
-    mount(ROOT_TAG, PermissionsHost);
-    await tick();
-
-    expect(capturedResult?.()).toEqual(GRANTED);
-    expect(getPermissionsAsyncMock).toHaveBeenCalledTimes(1);
-  });
-
-  it('request() re-fetches and updates the signal', async () => {
-    mount(ROOT_TAG, PermissionsHost);
-    await tick();
-
-    requestPermissionsAsyncMock.mockResolvedValueOnce(DENIED);
-    await capturedService?.request();
-
-    expect(capturedResult?.()).toEqual(DENIED);
-  });
-
-  it('get() re-fetches and updates the signal', async () => {
-    mount(ROOT_TAG, PermissionsHost);
-    await tick();
-
-    getPermissionsAsyncMock.mockResolvedValueOnce(DENIED);
-    await capturedService?.get();
-
-    expect(capturedResult?.()).toEqual(DENIED);
-  });
-});

package/src/core/cellular.test.ts

@@ -1,193 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-
-const FAKE_NATIVE_CELLULAR = {
-  getCellularGenerationAsync: vi.fn(async () => 3),
-  allowsVoipAsync: vi.fn(async () => true),
-  getIsoCountryCodeAsync: vi.fn(async () => 'us'),
-  getCarrierNameAsync: vi.fn(async () => 'Fake Carrier'),
-  getMobileCountryCodeAsync: vi.fn(async () => '310'),
-  getMobileNetworkCodeAsync: vi.fn(async () => '260'),
-  getPermissionsAsync: vi.fn(async () => ({
-    status: 'granted',
-    expires: 'never',
-    granted: true,
-    canAskAgain: true,
-  })),
-  requestPermissionsAsync: vi.fn(async () => ({
-    status: 'granted',
-    expires: 'never',
-    granted: true,
-    canAskAgain: true,
-  })),
-};
-
-// The real ExpoCellular native module only exists on device — resolving it via
-// requireNativeModule() at import time would throw in this headless test run, so the
-// module-lookup file is faked in place of expo-modules-core's runtime resolution, same pattern
-// packages/haptics/src/core/haptics.test.ts uses.
-vi.mock('./native-module', () => ({
-  expoCellular: FAKE_NATIVE_CELLULAR,
-}));
-
-// expo-modules-core's real entry transitively imports 'react-native' for Platform/
-// TurboModuleRegistry, whose Flow-typed source Vitest's Oxc transform can't parse — same fake
-// packages/haptics/src/core/haptics.test.ts uses. PermissionStatus/UnavailabilityError are faked
-// alongside it for the same reason.
-const fakePlatform = { OS: 'android' as 'ios' | 'android' };
-
-vi.mock('expo-modules-core', () => ({
-  Platform: fakePlatform,
-  PermissionStatus: { GRANTED: 'granted', DENIED: 'denied', UNDETERMINED: 'undetermined' },
-  UnavailabilityError: class UnavailabilityError extends Error {
-    constructor(moduleName: string, propertyName: string) {
-      super(`${propertyName} is not available on ${moduleName}`);
-    }
-  },
-}));
-
-const {
-  getCellularGenerationAsync,
-  allowsVoipAsync,
-  getIsoCountryCodeAsync,
-  getCarrierNameAsync,
-  getMobileCountryCodeAsync,
-  getMobileNetworkCodeAsync,
-  getPermissionsAsync,
-  requestPermissionsAsync,
-} = await import('./cellular');
-
-afterEach(() => {
-  fakePlatform.OS = 'android';
-  vi.clearAllMocks();
-});
-
-describe('getCellularGenerationAsync', () => {
-  it('delegates to the native module unconditionally (no platform gate)', async () => {
-    await expect(getCellularGenerationAsync()).resolves.toBe(3);
-  });
-
-  it('still delegates on iOS', async () => {
-    fakePlatform.OS = 'ios';
-    await expect(getCellularGenerationAsync()).resolves.toBe(3);
-  });
-
-  it('throws an UnavailabilityError-shaped error when the native method is absent', async () => {
-    const { getCellularGenerationAsync: native } = FAKE_NATIVE_CELLULAR;
-    // @ts-expect-error -- simulating a platform where the native module has no such method
-    FAKE_NATIVE_CELLULAR.getCellularGenerationAsync = undefined;
-
-    await expect(getCellularGenerationAsync()).rejects.toThrow(
-      'getCellularGenerationAsync is not available on expo-cellular',
-    );
-
-    FAKE_NATIVE_CELLULAR.getCellularGenerationAsync = native;
-  });
-});
-
-describe('allowsVoipAsync', () => {
-  it('resolves null on iOS without calling the native module', async () => {
-    fakePlatform.OS = 'ios';
-    await expect(allowsVoipAsync()).resolves.toBeNull();
-    expect(FAKE_NATIVE_CELLULAR.allowsVoipAsync).not.toHaveBeenCalled();
-  });
-
-  it('delegates to the native module on Android', async () => {
-    await expect(allowsVoipAsync()).resolves.toBe(true);
-  });
-
-  it('throws an UnavailabilityError-shaped error when the native method is absent on Android', async () => {
-    const { allowsVoipAsync: native } = FAKE_NATIVE_CELLULAR;
-    // @ts-expect-error -- simulating a platform where the native module has no such method
-    FAKE_NATIVE_CELLULAR.allowsVoipAsync = undefined;
-
-    await expect(allowsVoipAsync()).rejects.toThrow(
-      'allowsVoipAsync is not available on expo-cellular',
-    );
-
-    FAKE_NATIVE_CELLULAR.allowsVoipAsync = native;
-  });
-});
-
-describe('getIsoCountryCodeAsync', () => {
-  it('resolves null on iOS without calling the native module', async () => {
-    fakePlatform.OS = 'ios';
-    await expect(getIsoCountryCodeAsync()).resolves.toBeNull();
-    expect(FAKE_NATIVE_CELLULAR.getIsoCountryCodeAsync).not.toHaveBeenCalled();
-  });
-
-  it('delegates to the native module on Android', async () => {
-    await expect(getIsoCountryCodeAsync()).resolves.toBe('us');
-  });
-});
-
-describe('getCarrierNameAsync', () => {
-  it('resolves null on iOS without calling the native module', async () => {
-    fakePlatform.OS = 'ios';
-    await expect(getCarrierNameAsync()).resolves.toBeNull();
-    expect(FAKE_NATIVE_CELLULAR.getCarrierNameAsync).not.toHaveBeenCalled();
-  });
-
-  it('delegates to the native module on Android', async () => {
-    await expect(getCarrierNameAsync()).resolves.toBe('Fake Carrier');
-  });
-});
-
-describe('getMobileCountryCodeAsync', () => {
-  it('resolves null on iOS without calling the native module', async () => {
-    fakePlatform.OS = 'ios';
-    await expect(getMobileCountryCodeAsync()).resolves.toBeNull();
-    expect(FAKE_NATIVE_CELLULAR.getMobileCountryCodeAsync).not.toHaveBeenCalled();
-  });
-
-  it('delegates to the native module on Android', async () => {
-    await expect(getMobileCountryCodeAsync()).resolves.toBe('310');
-  });
-});
-
-describe('getMobileNetworkCodeAsync', () => {
-  it('resolves null on iOS without calling the native module', async () => {
-    fakePlatform.OS = 'ios';
-    await expect(getMobileNetworkCodeAsync()).resolves.toBeNull();
-    expect(FAKE_NATIVE_CELLULAR.getMobileNetworkCodeAsync).not.toHaveBeenCalled();
-  });
-
-  it('delegates to the native module on Android', async () => {
-    await expect(getMobileNetworkCodeAsync()).resolves.toBe('260');
-  });
-});
-
-describe('getPermissionsAsync', () => {
-  it('delegates to the native module on Android', async () => {
-    await getPermissionsAsync();
-    expect(FAKE_NATIVE_CELLULAR.getPermissionsAsync).toHaveBeenCalledTimes(1);
-  });
-
-  it('resolves a plain GRANTED literal on iOS without calling the native module', async () => {
-    fakePlatform.OS = 'ios';
-    await expect(getPermissionsAsync()).resolves.toEqual({
-      status: 'granted',
-      expires: 'never',
-      granted: true,
-      canAskAgain: true,
-    });
-    expect(FAKE_NATIVE_CELLULAR.getPermissionsAsync).not.toHaveBeenCalled();
-  });
-});
-
-describe('requestPermissionsAsync', () => {
-  it('delegates to the native module on Android', async () => {
-    await requestPermissionsAsync();
-    expect(FAKE_NATIVE_CELLULAR.requestPermissionsAsync).toHaveBeenCalledTimes(1);
-  });
-
-  it('resolves a plain GRANTED literal on iOS without calling the native module', async () => {
-    fakePlatform.OS = 'ios';
-    await expect(requestPermissionsAsync()).resolves.toEqual({
-      status: 'granted',
-      expires: 'never',
-      granted: true,
-      canAskAgain: true,
-    });
-    expect(FAKE_NATIVE_CELLULAR.requestPermissionsAsync).not.toHaveBeenCalled();
-  });
-});

package/src/react/hooks/use-permissions/use-permissions.test.tsx

@@ -1,115 +0,0 @@
-// Co-located React-driven test (ADR 0025) for usePermissions. See
-// packages/battery/src/react/hooks/use-battery-state/use-battery-state.test.tsx for the shared
-// rationale (mocks `core`, not expo-modules-core internals), adapted here to test the
-// get/request permission pair instead of a listener subscription.
-
-import { createElement, type ReactElement } from 'react';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount, View } from '@symbiote-native/react';
-import { installFabric } from '@symbiote-native/test-utils';
-import { usePermissions } from './index';
-
-type IPermissionResponse = {
-  status: string;
-  expires: 'never';
-  granted: boolean;
-  canAskAgain: boolean;
-};
-
-const GRANTED: IPermissionResponse = {
-  status: 'granted',
-  expires: 'never',
-  granted: true,
-  canAskAgain: true,
-};
-const DENIED: IPermissionResponse = {
-  status: 'denied',
-  expires: 'never',
-  granted: false,
-  canAskAgain: true,
-};
-
-const { getPermissionsAsync, requestPermissionsAsync } = vi.hoisted(() => ({
-  getPermissionsAsync: vi.fn(async () => GRANTED),
-  requestPermissionsAsync: vi.fn(async () => GRANTED),
-}));
-
-vi.mock('../../../core', () => ({
-  getPermissionsAsync,
-  requestPermissionsAsync,
-}));
-
-const ROOT_TAG = 953;
-
-let latestStatus: IPermissionResponse | null = null;
-let requestFn: (() => Promise<IPermissionResponse>) | undefined;
-let getFn: (() => Promise<IPermissionResponse>) | undefined;
-
-function Probe(): ReactElement {
-  const [status, request, get] = usePermissions();
-  latestStatus = status;
-  requestFn = request;
-  getFn = get;
-  return createElement(View);
-}
-
-const fabric = installFabric();
-
-beforeEach(() => {
-  fabric.reset();
-  latestStatus = null;
-  requestFn = undefined;
-  getFn = undefined;
-  vi.clearAllMocks();
-  getPermissionsAsync.mockResolvedValue(GRANTED);
-  requestPermissionsAsync.mockResolvedValue(GRANTED);
-});
-
-afterEach(() => unmount(ROOT_TAG));
-
-describe('usePermissions', () => {
-  it('starts at null before the initial getPermissionsAsync() resolves', () => {
-    mount(ROOT_TAG, createElement(Probe));
-
-    expect(latestStatus).toBeNull();
-  });
-
-  it('fetches the permission status on mount', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-
-    await vi.waitFor(() => expect(latestStatus).toEqual(GRANTED));
-    expect(getPermissionsAsync).toHaveBeenCalledTimes(1);
-  });
-
-  it('requestPermission() re-fetches and updates the status', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-    await vi.waitFor(() => expect(latestStatus).toEqual(GRANTED));
-
-    requestPermissionsAsync.mockResolvedValueOnce(DENIED);
-    await requestFn?.();
-
-    await vi.waitFor(() => expect(latestStatus).toEqual(DENIED));
-  });
-
-  it('getPermission() re-fetches and updates the status', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-    await vi.waitFor(() => expect(latestStatus).toEqual(GRANTED));
-
-    getPermissionsAsync.mockResolvedValueOnce(DENIED);
-    await getFn?.();
-
-    await vi.waitFor(() => expect(latestStatus).toEqual(DENIED));
-  });
-
-  it('does not update state after unmount', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-    await vi.waitFor(() => expect(latestStatus).toEqual(GRANTED));
-
-    unmount(ROOT_TAG);
-    getPermissionsAsync.mockResolvedValueOnce(DENIED);
-    await getFn?.();
-
-    // state setter is guarded by isMounted, so the captured value from before unmount stands
-    expect(latestStatus).toEqual(GRANTED);
-  });
-});

package/src/vue/composables/use-permissions/use-permissions.test.ts

@@ -1,103 +0,0 @@
-// Co-located Vue-driven test (ADR 0025) for usePermissions. See
-// packages/battery/src/vue/composables/use-battery-state/use-battery-state.test.ts for the
-// shared rationale, adapted here to test the get/request permission pair instead of a listener
-// subscription.
-
-import { defineComponent, h } from '@vue/runtime-core';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount } from '@symbiote-native/vue';
-import { installFabric } from '@symbiote-native/test-utils';
-import { usePermissions } from './index';
-
-type IPermissionResponse = {
-  status: string;
-  expires: 'never';
-  granted: boolean;
-  canAskAgain: boolean;
-};
-
-const GRANTED: IPermissionResponse = {
-  status: 'granted',
-  expires: 'never',
-  granted: true,
-  canAskAgain: true,
-};
-const DENIED: IPermissionResponse = {
-  status: 'denied',
-  expires: 'never',
-  granted: false,
-  canAskAgain: true,
-};
-
-const getPermissionsAsyncMock = vi.fn(async () => GRANTED);
-const requestPermissionsAsyncMock = vi.fn(async () => GRANTED);
-
-vi.mock('../../../core', () => ({
-  getPermissionsAsync: () => getPermissionsAsyncMock(),
-  requestPermissionsAsync: () => requestPermissionsAsyncMock(),
-}));
-
-const ROOT_TAG = 9953;
-const fabric = installFabric();
-
-beforeEach(() => {
-  fabric.reset();
-  getPermissionsAsyncMock.mockClear();
-  requestPermissionsAsyncMock.mockClear();
-  getPermissionsAsyncMock.mockResolvedValue(GRANTED);
-  requestPermissionsAsyncMock.mockResolvedValue(GRANTED);
-});
-
-afterEach(() => unmount(ROOT_TAG));
-
-function mountPermissions(): ReturnType<typeof usePermissions> {
-  let result: ReturnType<typeof usePermissions> | undefined;
-  mount(
-    ROOT_TAG,
-    defineComponent({
-      setup: () => {
-        result = usePermissions();
-        return () => h('symbiote-text', {}, 'cellular');
-      },
-    }),
-  );
-  if (result === undefined) {
-    throw new Error('setup() did not run');
-  }
-  return result;
-}
-
-describe('usePermissions (Vue)', () => {
-  it('starts at null before the initial get() resolves', () => {
-    const { status } = mountPermissions();
-
-    expect(status.value).toBeNull();
-  });
-
-  it('fetches the permission status on mount', async () => {
-    const { status } = mountPermissions();
-
-    await vi.waitFor(() => expect(status.value).toEqual(GRANTED));
-    expect(getPermissionsAsyncMock).toHaveBeenCalledTimes(1);
-  });
-
-  it('request() re-fetches and updates the ref', async () => {
-    const { status, request } = mountPermissions();
-    await vi.waitFor(() => expect(status.value).toEqual(GRANTED));
-
-    requestPermissionsAsyncMock.mockResolvedValueOnce(DENIED);
-    await request();
-
-    expect(status.value).toEqual(DENIED);
-  });
-
-  it('get() re-fetches and updates the ref', async () => {
-    const { status, get } = mountPermissions();
-    await vi.waitFor(() => expect(status.value).toEqual(GRANTED));
-
-    getPermissionsAsyncMock.mockResolvedValueOnce(DENIED);
-    await get();
-
-    expect(status.value).toEqual(DENIED);
-  });
-});