@symbiote-native/cellular 0.0.1

package/build/vue/index.js

@@ -0,0 +1,4 @@
+// @symbiote-native/cellular/vue: the Vue entry over the framework-agnostic core, plus
+// usePermissions — the only stateful surface this package needs a lifecycle wrapper for.
+export { usePermissions } from './composables/use-permissions/index.js';
+export * from '../core/index.js';

package/build-ngc/angular/index.d.ts

@@ -0,0 +1,2 @@
+export { PermissionsService } from './services/permissions.service';
+export * from '../core';

package/build-ngc/angular/index.js

@@ -0,0 +1,5 @@
+// @symbiote-native/cellular/angular: the Angular entry over the framework-agnostic core, plus
+// PermissionsService — the only stateful surface this package needs a lifecycle wrapper for.
+export { PermissionsService } from './services/permissions.service';
+export * from '../core';
+//# sourceMappingURL=index.js.map

package/build-ngc/angular/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,6FAA6F;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,11 @@
+import { type Signal } from '@angular/core';
+import { type PermissionResponse } from '../../../core';
+import * as i0 from "@angular/core";
+export declare class PermissionsService {
+    private readonly status;
+    connect(): Signal<PermissionResponse | null>;
+    get(): Promise<PermissionResponse>;
+    request(): Promise<PermissionResponse>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PermissionsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PermissionsService>;
+}

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

@@ -0,0 +1,35 @@
+// 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 }}
+import { Injectable, signal } from '@angular/core';
+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 */ []));
+    connect() {
+        if (this.status() === null) {
+            void this.get();
+        }
+        return this.status.asReadonly();
+    }
+    async get() {
+        const response = await getPermissionsAsync();
+        this.status.set(response);
+        return response;
+    }
+    async request() {
+        const response = await requestPermissionsAsync();
+        this.status.set(response);
+        return response;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: PermissionsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: PermissionsService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: PermissionsService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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,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;IAElE,OAAO;QACL,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QAClB,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,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,OAAO,QAAQ,CAAC;IAClB,CAAC;uGApBU,kBAAkB;2GAAlB,kBAAkB,cADL,MAAM;;2FACnB,kBAAkB;kBAD9B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}

package/build-ngc/core/cellular.d.ts

@@ -0,0 +1,40 @@
+import { type PermissionResponse } from 'expo-modules-core';
+import { CellularGeneration } from './types';
+/** Gets the generation of the device's current connection. */
+export declare function getCellularGenerationAsync(): Promise<CellularGeneration>;
+/**
+ * Tells if the carrier of the SIM card allows to make VoIP calls on its network.
+ * @deprecated This method is deprecated and will be removed in a future SDK version.
+ * @platform android
+ */
+export declare function allowsVoipAsync(): Promise<boolean | null>;
+/**
+ * Gets the ISO country code of the current registered operator's MCC (Mobile Country Code).
+ * @platform android
+ */
+export declare function getIsoCountryCodeAsync(): Promise<string | null>;
+/**
+ * Gets the name of the user's cellular service provider.
+ * @platform android
+ */
+export declare function getCarrierNameAsync(): Promise<string | null>;
+/**
+ * Gets the mobile country code (MCC) of the device's current registered operator.
+ * @platform android
+ */
+export declare function getMobileCountryCodeAsync(): Promise<string | null>;
+/**
+ * Gets the mobile network code (MNC) of the device's current registered operator.
+ * @platform android
+ */
+export declare function getMobileNetworkCodeAsync(): Promise<string | null>;
+/**
+ * Checks user's permissions for accessing cellular information. Android only — iOS/web need no
+ * permission for cellular info, so this always resolves granted there.
+ */
+export declare function getPermissionsAsync(): Promise<PermissionResponse>;
+/**
+ * Asks the user to grant permissions for accessing cellular information. Android only — iOS/web
+ * need no permission for cellular info, so this always resolves granted there.
+ */
+export declare function requestPermissionsAsync(): Promise<PermissionResponse>;

package/build-ngc/core/cellular.js

@@ -0,0 +1,117 @@
+// Hand-ported from .vendors/expo/packages/expo-cellular/src/Cellular.ts (sdk-57). Carrier/SIM
+// info (ISO country code, carrier name, MCC/MNC) and allowsVoipAsync are Android-only upstream —
+// each short-circuits to `null` on iOS before ever reaching the native module, since iOS exposes
+// none of this. getPermissionsAsync/requestPermissionsAsync mirror that same split: Android
+// delegates to the native module, every other platform needs no permission for cellular info at
+// 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';
+const NATIVE_MODULE_NAME = 'expo-cellular';
+const GRANTED_PERMISSION_RESPONSE = {
+    status: PermissionStatus.GRANTED,
+    expires: 'never',
+    granted: true,
+    canAskAgain: true,
+};
+/** Gets the generation of the device's current connection. */
+export async function getCellularGenerationAsync() {
+    if (!expoCellular.getCellularGenerationAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getCellularGenerationAsync');
+    }
+    return expoCellular.getCellularGenerationAsync();
+}
+/**
+ * Tells if the carrier of the SIM card allows to make VoIP calls on its network.
+ * @deprecated This method is deprecated and will be removed in a future SDK version.
+ * @platform android
+ */
+export async function allowsVoipAsync() {
+    if (Platform.OS === 'ios') {
+        return null;
+    }
+    if (!expoCellular.allowsVoipAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'allowsVoipAsync');
+    }
+    return expoCellular.allowsVoipAsync();
+}
+/**
+ * Gets the ISO country code of the current registered operator's MCC (Mobile Country Code).
+ * @platform android
+ */
+export async function getIsoCountryCodeAsync() {
+    if (Platform.OS === 'ios') {
+        return null;
+    }
+    if (!expoCellular.getIsoCountryCodeAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getIsoCountryCodeAsync');
+    }
+    return expoCellular.getIsoCountryCodeAsync();
+}
+/**
+ * Gets the name of the user's cellular service provider.
+ * @platform android
+ */
+export async function getCarrierNameAsync() {
+    if (Platform.OS === 'ios') {
+        return null;
+    }
+    if (!expoCellular.getCarrierNameAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getCarrierNameAsync');
+    }
+    return expoCellular.getCarrierNameAsync();
+}
+/**
+ * Gets the mobile country code (MCC) of the device's current registered operator.
+ * @platform android
+ */
+export async function getMobileCountryCodeAsync() {
+    if (Platform.OS === 'ios') {
+        return null;
+    }
+    if (!expoCellular.getMobileCountryCodeAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getMobileCountryCodeAsync');
+    }
+    return expoCellular.getMobileCountryCodeAsync();
+}
+/**
+ * Gets the mobile network code (MNC) of the device's current registered operator.
+ * @platform android
+ */
+export async function getMobileNetworkCodeAsync() {
+    if (Platform.OS === 'ios') {
+        return null;
+    }
+    if (!expoCellular.getMobileNetworkCodeAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getMobileNetworkCodeAsync');
+    }
+    return expoCellular.getMobileNetworkCodeAsync();
+}
+/**
+ * Checks user's permissions for accessing cellular information. Android only — iOS/web need no
+ * permission for cellular info, so this always resolves granted there.
+ */
+export async function getPermissionsAsync() {
+    if (Platform.OS === 'android') {
+        if (!expoCellular.getPermissionsAsync) {
+            throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getPermissionsAsync');
+        }
+        return expoCellular.getPermissionsAsync();
+    }
+    return GRANTED_PERMISSION_RESPONSE;
+}
+/**
+ * Asks the user to grant permissions for accessing cellular information. Android only — iOS/web
+ * need no permission for cellular info, so this always resolves granted there.
+ */
+export async function requestPermissionsAsync() {
+    if (Platform.OS === 'android') {
+        if (!expoCellular.requestPermissionsAsync) {
+            throw new UnavailabilityError(NATIVE_MODULE_NAME, 'requestPermissionsAsync');
+        }
+        return expoCellular.requestPermissionsAsync();
+    }
+    return GRANTED_PERMISSION_RESPONSE;
+}
+//# sourceMappingURL=cellular.js.map

package/build-ngc/core/cellular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellular.js","sourceRoot":"","sources":["../../src/core/cellular.ts"],"names":[],"mappings":"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"}

package/build-ngc/core/index.d.ts

@@ -0,0 +1,2 @@
+export { getCellularGenerationAsync, allowsVoipAsync, getIsoCountryCodeAsync, getCarrierNameAsync, getMobileCountryCodeAsync, getMobileNetworkCodeAsync, getPermissionsAsync, requestPermissionsAsync, } from './cellular';
+export { CellularGeneration, PermissionStatus, type PermissionResponse, type PermissionExpiration, } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,3 @@
+export { getCellularGenerationAsync, allowsVoipAsync, getIsoCountryCodeAsync, getCarrierNameAsync, getMobileCountryCodeAsync, getMobileNetworkCodeAsync, getPermissionsAsync, requestPermissionsAsync, } from './cellular';
+export { CellularGeneration, PermissionStatus, } from './types';
+//# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GAGjB,MAAM,SAAS,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -0,0 +1,13 @@
+import type { PermissionResponse } from 'expo-modules-core';
+import type { CellularGeneration } from './types';
+export type INativeCellularModule = {
+    getCellularGenerationAsync?(): Promise<CellularGeneration>;
+    allowsVoipAsync?(): Promise<boolean>;
+    getIsoCountryCodeAsync?(): Promise<string | null>;
+    getCarrierNameAsync?(): Promise<string | null>;
+    getMobileCountryCodeAsync?(): Promise<string | null>;
+    getMobileNetworkCodeAsync?(): Promise<string | null>;
+    getPermissionsAsync?(): Promise<PermissionResponse>;
+    requestPermissionsAsync?(): Promise<PermissionResponse>;
+};
+export declare const expoCellular: INativeCellularModule;

package/build-ngc/core/native-module.js

@@ -0,0 +1,4 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_CELLULAR_MODULE_NAME = 'ExpoCellular';
+export const expoCellular = requireNativeModule(EXPO_CELLULAR_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

package/build-ngc/core/native-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIxD,MAAM,yBAAyB,GAAG,cAAc,CAAC;AAmBjD,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAwB,yBAAyB,CAAC,CAAC"}

package/build-ngc/core/types.d.ts

@@ -0,0 +1,14 @@
+export { PermissionStatus, type PermissionResponse, type PermissionExpiration, } from 'expo-modules-core';
+/** Telecommunication technology used to establish a cellular connection. */
+export declare enum CellularGeneration {
+    /** The device's connection generation could not be determined. */
+    UNKNOWN = 0,
+    /** 2nd generation (GPRS/EDGE-class) connection. */
+    CELLULAR_2G = 1,
+    /** 3rd generation (UMTS/HSPA-class) connection. */
+    CELLULAR_3G = 2,
+    /** 4th generation (LTE-class) connection. */
+    CELLULAR_4G = 3,
+    /** 5th generation (NR-class) connection. */
+    CELLULAR_5G = 4
+}

package/build-ngc/core/types.js

@@ -0,0 +1,20 @@
+// Hand-ported from .vendors/expo/packages/expo-cellular/src/Cellular.types.ts (sdk-57).
+// PermissionResponse/PermissionStatus/PermissionExpiration come straight from
+// expo-modules-core (which re-exports PermissionsInterface) — never from the `expo`
+// meta-package, unlike upstream's own Cellular.ts.
+export { PermissionStatus, } from 'expo-modules-core';
+/** Telecommunication technology used to establish a cellular connection. */
+export var CellularGeneration;
+(function (CellularGeneration) {
+    /** The device's connection generation could not be determined. */
+    CellularGeneration[CellularGeneration["UNKNOWN"] = 0] = "UNKNOWN";
+    /** 2nd generation (GPRS/EDGE-class) connection. */
+    CellularGeneration[CellularGeneration["CELLULAR_2G"] = 1] = "CELLULAR_2G";
+    /** 3rd generation (UMTS/HSPA-class) connection. */
+    CellularGeneration[CellularGeneration["CELLULAR_3G"] = 2] = "CELLULAR_3G";
+    /** 4th generation (LTE-class) connection. */
+    CellularGeneration[CellularGeneration["CELLULAR_4G"] = 3] = "CELLULAR_4G";
+    /** 5th generation (NR-class) connection. */
+    CellularGeneration[CellularGeneration["CELLULAR_5G"] = 4] = "CELLULAR_5G";
+})(CellularGeneration || (CellularGeneration = {}));
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,8EAA8E;AAC9E,oFAAoF;AACpF,mDAAmD;AACnD,OAAO,EACL,gBAAgB,GAGjB,MAAM,mBAAmB,CAAC;AAE3B,4EAA4E;AAC5E,MAAM,CAAN,IAAY,kBAWX;AAXD,WAAY,kBAAkB;IAC5B,kEAAkE;IAClE,iEAAW,CAAA;IACX,mDAAmD;IACnD,yEAAe,CAAA;IACf,mDAAmD;IACnD,yEAAe,CAAA;IACf,6CAA6C;IAC7C,yEAAe,CAAA;IACf,4CAA4C;IAC5C,yEAAe,CAAA;AACjB,CAAC,EAXW,kBAAkB,KAAlB,kBAAkB,QAW7B"}

package/native-link.json

@@ -0,0 +1,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-cellular",
+    "modules": [
+      {
+        "importPath": "expo.modules.cellular.CellularModule",
+        "className": "CellularModule",
+        "nativeName": "ExpoCellular"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,107 @@
+{
+  "name": "@symbiote-native/cellular",
+  "version": "0.0.1",
+  "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": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/cellular"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/cellular#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/vue/index.d.ts",
+      "default": "./build/vue/index.js"
+    },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "default": "./build/react/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-cellular": "57.0.1",
+    "expo-modules-core": "57.0.5"
+  },
+  "peerDependencies": {
+    "@symbiote-native/engine": ">=0.1.7",
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "vue": ">=3.5.0",
+    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/react": "0.2.8",
+    "@symbiote-native/vue": "0.3.8"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "^22",
+    "@angular/compiler-cli": "^22",
+    "@angular/core": "^22",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@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/react": "0.2.8",
+    "@symbiote-native/test-utils": "0.1.6",
+    "@symbiote-native/engine": "0.1.7"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,4 @@
+// @symbiote-native/cellular/angular: the Angular entry over the framework-agnostic core, plus
+// PermissionsService — the only stateful surface this package needs a lifecycle wrapper for.
+export { PermissionsService } from './services/permissions.service';
+export * from '../core';

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

@@ -0,0 +1,35 @@
+// 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 }}
+import { Injectable, signal, type Signal } from '@angular/core';
+import {
+  getPermissionsAsync,
+  requestPermissionsAsync,
+  type PermissionResponse,
+} from '../../../core';
+
+@Injectable({ providedIn: 'root' })
+export class PermissionsService {
+  private readonly status = signal<PermissionResponse | null>(null);
+
+  connect(): Signal<PermissionResponse | null> {
+    if (this.status() === null) {
+      void this.get();
+    }
+    return this.status.asReadonly();
+  }
+
+  async get(): Promise<PermissionResponse> {
+    const response = await getPermissionsAsync();
+    this.status.set(response);
+    return response;
+  }
+
+  async request(): Promise<PermissionResponse> {
+    const response = await requestPermissionsAsync();
+    this.status.set(response);
+    return response;
+  }
+}

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

@@ -0,0 +1,109 @@
+// 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);
+  });
+});