@symbiote-native/engine 1.2.0 → 1.3.1

package/build/permissions-android/index.android.d.ts

@@ -0,0 +1,59 @@
+import { type IPermission, type IPermissionStatus, type IRationale } from './shared';
+export { PERMISSIONS, RESULTS, type IPermission, type IPermissionStatus, type IRationale, } from './shared';
+export declare const PermissionsAndroid: {
+    PERMISSIONS: Readonly<{
+        readonly READ_CALENDAR: "android.permission.READ_CALENDAR";
+        readonly WRITE_CALENDAR: "android.permission.WRITE_CALENDAR";
+        readonly CAMERA: "android.permission.CAMERA";
+        readonly READ_CONTACTS: "android.permission.READ_CONTACTS";
+        readonly WRITE_CONTACTS: "android.permission.WRITE_CONTACTS";
+        readonly GET_ACCOUNTS: "android.permission.GET_ACCOUNTS";
+        readonly ACCESS_FINE_LOCATION: "android.permission.ACCESS_FINE_LOCATION";
+        readonly ACCESS_COARSE_LOCATION: "android.permission.ACCESS_COARSE_LOCATION";
+        readonly ACCESS_BACKGROUND_LOCATION: "android.permission.ACCESS_BACKGROUND_LOCATION";
+        readonly RECORD_AUDIO: "android.permission.RECORD_AUDIO";
+        readonly READ_PHONE_STATE: "android.permission.READ_PHONE_STATE";
+        readonly CALL_PHONE: "android.permission.CALL_PHONE";
+        readonly READ_CALL_LOG: "android.permission.READ_CALL_LOG";
+        readonly WRITE_CALL_LOG: "android.permission.WRITE_CALL_LOG";
+        readonly ADD_VOICEMAIL: "com.android.voicemail.permission.ADD_VOICEMAIL";
+        readonly READ_VOICEMAIL: "com.android.voicemail.permission.READ_VOICEMAIL";
+        readonly WRITE_VOICEMAIL: "com.android.voicemail.permission.WRITE_VOICEMAIL";
+        readonly USE_SIP: "android.permission.USE_SIP";
+        readonly PROCESS_OUTGOING_CALLS: "android.permission.PROCESS_OUTGOING_CALLS";
+        readonly BODY_SENSORS: "android.permission.BODY_SENSORS";
+        readonly BODY_SENSORS_BACKGROUND: "android.permission.BODY_SENSORS_BACKGROUND";
+        readonly SEND_SMS: "android.permission.SEND_SMS";
+        readonly RECEIVE_SMS: "android.permission.RECEIVE_SMS";
+        readonly READ_SMS: "android.permission.READ_SMS";
+        readonly RECEIVE_WAP_PUSH: "android.permission.RECEIVE_WAP_PUSH";
+        readonly RECEIVE_MMS: "android.permission.RECEIVE_MMS";
+        readonly READ_EXTERNAL_STORAGE: "android.permission.READ_EXTERNAL_STORAGE";
+        readonly READ_MEDIA_IMAGES: "android.permission.READ_MEDIA_IMAGES";
+        readonly READ_MEDIA_VIDEO: "android.permission.READ_MEDIA_VIDEO";
+        readonly READ_MEDIA_AUDIO: "android.permission.READ_MEDIA_AUDIO";
+        readonly READ_MEDIA_VISUAL_USER_SELECTED: "android.permission.READ_MEDIA_VISUAL_USER_SELECTED";
+        readonly WRITE_EXTERNAL_STORAGE: "android.permission.WRITE_EXTERNAL_STORAGE";
+        readonly BLUETOOTH_CONNECT: "android.permission.BLUETOOTH_CONNECT";
+        readonly BLUETOOTH_SCAN: "android.permission.BLUETOOTH_SCAN";
+        readonly BLUETOOTH_ADVERTISE: "android.permission.BLUETOOTH_ADVERTISE";
+        readonly ACCESS_MEDIA_LOCATION: "android.permission.ACCESS_MEDIA_LOCATION";
+        readonly ACCEPT_HANDOVER: "android.permission.ACCEPT_HANDOVER";
+        readonly ACTIVITY_RECOGNITION: "android.permission.ACTIVITY_RECOGNITION";
+        readonly ANSWER_PHONE_CALLS: "android.permission.ANSWER_PHONE_CALLS";
+        readonly READ_PHONE_NUMBERS: "android.permission.READ_PHONE_NUMBERS";
+        readonly UWB_RANGING: "android.permission.UWB_RANGING";
+        readonly POST_NOTIFICATIONS: "android.permission.POST_NOTIFICATIONS";
+        readonly NEARBY_WIFI_DEVICES: "android.permission.NEARBY_WIFI_DEVICES";
+    }>;
+    RESULTS: Readonly<{
+        readonly GRANTED: "granted";
+        readonly DENIED: "denied";
+        readonly NEVER_ASK_AGAIN: "never_ask_again";
+    }>;
+    checkPermission(permission: IPermission): Promise<boolean>;
+    check(permission: IPermission): Promise<boolean>;
+    requestPermission(permission: IPermission, rationale?: IRationale): Promise<boolean>;
+    request(permission: IPermission, rationale?: IRationale): Promise<IPermissionStatus>;
+    requestMultiple(permissions: IPermission[]): Promise<Record<string, IPermissionStatus>>;
+};

package/build/permissions-android/index.android.js

@@ -0,0 +1,47 @@
+// PermissionsAndroid, Android build: RN's PermissionsAndroid.js with `Platform.OS === 'android'`.
+// Every call reaches the native module and returns what it returns; a missing module is RN's
+// invariant. request() shows the rationale through DialogManagerAndroid first when native says to.
+import { dlog } from '../debug.js';
+import { invariant } from '../invariant.js';
+import { getNativeModule } from '../native-modules/index.js';
+import { CHECK_PERMISSION_DEPRECATED, PERMISSIONS, PERMISSIONS_ANDROID_MODULE, REQUEST_PERMISSION_DEPRECATED, RESULTS, } from './shared.js';
+export { PERMISSIONS, RESULTS, } from './shared.js';
+const NOT_INSTALLED = 'PermissionsAndroid is not installed correctly.';
+function requireModule() {
+    const module = getNativeModule(PERMISSIONS_ANDROID_MODULE);
+    dlog(`PermissionsAndroid: module ${module ? 'resolved' : 'NOT resolved (null)'}`);
+    invariant(module !== null, NOT_INSTALLED);
+    return module;
+}
+export const PermissionsAndroid = {
+    PERMISSIONS,
+    RESULTS,
+    checkPermission(permission) {
+        console.warn(CHECK_PERMISSION_DEPRECATED);
+        return requireModule().checkPermission(permission);
+    },
+    check(permission) {
+        return requireModule().checkPermission(permission);
+    },
+    async requestPermission(permission, rationale) {
+        console.warn(REQUEST_PERMISSION_DEPRECATED);
+        const response = await PermissionsAndroid.request(permission, rationale);
+        return response === RESULTS.GRANTED;
+    },
+    async request(permission, rationale) {
+        const module = requireModule();
+        if (rationale) {
+            const shouldShowRationale = await module.shouldShowRequestPermissionRationale(permission);
+            const dialog = getNativeModule('DialogManagerAndroid');
+            if (shouldShowRationale && dialog !== null) {
+                return new Promise((resolve, reject) => {
+                    dialog.showAlert({ ...rationale }, () => reject(new Error('Error showing rationale')), () => resolve(module.requestPermission(permission)));
+                });
+            }
+        }
+        return module.requestPermission(permission);
+    },
+    requestMultiple(permissions) {
+        return requireModule().requestMultiplePermissions(permissions);
+    },
+};

package/build/permissions-android/index.d.ts

@@ -1,115 +1 @@
-export declare const RESULTS: Readonly<{
-    readonly GRANTED: "granted";
-    readonly DENIED: "denied";
-    readonly NEVER_ASK_AGAIN: "never_ask_again";
-}>;
-export type IPermissionStatus = (typeof RESULTS)[keyof typeof RESULTS];
-export declare const PERMISSIONS: Readonly<{
-    readonly READ_CALENDAR: "android.permission.READ_CALENDAR";
-    readonly WRITE_CALENDAR: "android.permission.WRITE_CALENDAR";
-    readonly CAMERA: "android.permission.CAMERA";
-    readonly READ_CONTACTS: "android.permission.READ_CONTACTS";
-    readonly WRITE_CONTACTS: "android.permission.WRITE_CONTACTS";
-    readonly GET_ACCOUNTS: "android.permission.GET_ACCOUNTS";
-    readonly ACCESS_FINE_LOCATION: "android.permission.ACCESS_FINE_LOCATION";
-    readonly ACCESS_COARSE_LOCATION: "android.permission.ACCESS_COARSE_LOCATION";
-    readonly ACCESS_BACKGROUND_LOCATION: "android.permission.ACCESS_BACKGROUND_LOCATION";
-    readonly RECORD_AUDIO: "android.permission.RECORD_AUDIO";
-    readonly READ_PHONE_STATE: "android.permission.READ_PHONE_STATE";
-    readonly CALL_PHONE: "android.permission.CALL_PHONE";
-    readonly READ_CALL_LOG: "android.permission.READ_CALL_LOG";
-    readonly WRITE_CALL_LOG: "android.permission.WRITE_CALL_LOG";
-    readonly ADD_VOICEMAIL: "com.android.voicemail.permission.ADD_VOICEMAIL";
-    readonly READ_VOICEMAIL: "com.android.voicemail.permission.READ_VOICEMAIL";
-    readonly WRITE_VOICEMAIL: "com.android.voicemail.permission.WRITE_VOICEMAIL";
-    readonly USE_SIP: "android.permission.USE_SIP";
-    readonly PROCESS_OUTGOING_CALLS: "android.permission.PROCESS_OUTGOING_CALLS";
-    readonly BODY_SENSORS: "android.permission.BODY_SENSORS";
-    readonly BODY_SENSORS_BACKGROUND: "android.permission.BODY_SENSORS_BACKGROUND";
-    readonly SEND_SMS: "android.permission.SEND_SMS";
-    readonly RECEIVE_SMS: "android.permission.RECEIVE_SMS";
-    readonly READ_SMS: "android.permission.READ_SMS";
-    readonly RECEIVE_WAP_PUSH: "android.permission.RECEIVE_WAP_PUSH";
-    readonly RECEIVE_MMS: "android.permission.RECEIVE_MMS";
-    readonly READ_EXTERNAL_STORAGE: "android.permission.READ_EXTERNAL_STORAGE";
-    readonly READ_MEDIA_IMAGES: "android.permission.READ_MEDIA_IMAGES";
-    readonly READ_MEDIA_VIDEO: "android.permission.READ_MEDIA_VIDEO";
-    readonly READ_MEDIA_AUDIO: "android.permission.READ_MEDIA_AUDIO";
-    readonly READ_MEDIA_VISUAL_USER_SELECTED: "android.permission.READ_MEDIA_VISUAL_USER_SELECTED";
-    readonly WRITE_EXTERNAL_STORAGE: "android.permission.WRITE_EXTERNAL_STORAGE";
-    readonly BLUETOOTH_CONNECT: "android.permission.BLUETOOTH_CONNECT";
-    readonly BLUETOOTH_SCAN: "android.permission.BLUETOOTH_SCAN";
-    readonly BLUETOOTH_ADVERTISE: "android.permission.BLUETOOTH_ADVERTISE";
-    readonly ACCESS_MEDIA_LOCATION: "android.permission.ACCESS_MEDIA_LOCATION";
-    readonly ACCEPT_HANDOVER: "android.permission.ACCEPT_HANDOVER";
-    readonly ACTIVITY_RECOGNITION: "android.permission.ACTIVITY_RECOGNITION";
-    readonly ANSWER_PHONE_CALLS: "android.permission.ANSWER_PHONE_CALLS";
-    readonly READ_PHONE_NUMBERS: "android.permission.READ_PHONE_NUMBERS";
-    readonly UWB_RANGING: "android.permission.UWB_RANGING";
-    readonly POST_NOTIFICATIONS: "android.permission.POST_NOTIFICATIONS";
-    readonly NEARBY_WIFI_DEVICES: "android.permission.NEARBY_WIFI_DEVICES";
-}>;
-export type IPermission = (typeof PERMISSIONS)[keyof typeof PERMISSIONS];
-export type IRationale = {
-    title: string;
-    message: string;
-    buttonPositive?: string;
-    buttonNegative?: string;
-    buttonNeutral?: string;
-};
-export declare const PermissionsAndroid: {
-    PERMISSIONS: Readonly<{
-        readonly READ_CALENDAR: "android.permission.READ_CALENDAR";
-        readonly WRITE_CALENDAR: "android.permission.WRITE_CALENDAR";
-        readonly CAMERA: "android.permission.CAMERA";
-        readonly READ_CONTACTS: "android.permission.READ_CONTACTS";
-        readonly WRITE_CONTACTS: "android.permission.WRITE_CONTACTS";
-        readonly GET_ACCOUNTS: "android.permission.GET_ACCOUNTS";
-        readonly ACCESS_FINE_LOCATION: "android.permission.ACCESS_FINE_LOCATION";
-        readonly ACCESS_COARSE_LOCATION: "android.permission.ACCESS_COARSE_LOCATION";
-        readonly ACCESS_BACKGROUND_LOCATION: "android.permission.ACCESS_BACKGROUND_LOCATION";
-        readonly RECORD_AUDIO: "android.permission.RECORD_AUDIO";
-        readonly READ_PHONE_STATE: "android.permission.READ_PHONE_STATE";
-        readonly CALL_PHONE: "android.permission.CALL_PHONE";
-        readonly READ_CALL_LOG: "android.permission.READ_CALL_LOG";
-        readonly WRITE_CALL_LOG: "android.permission.WRITE_CALL_LOG";
-        readonly ADD_VOICEMAIL: "com.android.voicemail.permission.ADD_VOICEMAIL";
-        readonly READ_VOICEMAIL: "com.android.voicemail.permission.READ_VOICEMAIL";
-        readonly WRITE_VOICEMAIL: "com.android.voicemail.permission.WRITE_VOICEMAIL";
-        readonly USE_SIP: "android.permission.USE_SIP";
-        readonly PROCESS_OUTGOING_CALLS: "android.permission.PROCESS_OUTGOING_CALLS";
-        readonly BODY_SENSORS: "android.permission.BODY_SENSORS";
-        readonly BODY_SENSORS_BACKGROUND: "android.permission.BODY_SENSORS_BACKGROUND";
-        readonly SEND_SMS: "android.permission.SEND_SMS";
-        readonly RECEIVE_SMS: "android.permission.RECEIVE_SMS";
-        readonly READ_SMS: "android.permission.READ_SMS";
-        readonly RECEIVE_WAP_PUSH: "android.permission.RECEIVE_WAP_PUSH";
-        readonly RECEIVE_MMS: "android.permission.RECEIVE_MMS";
-        readonly READ_EXTERNAL_STORAGE: "android.permission.READ_EXTERNAL_STORAGE";
-        readonly READ_MEDIA_IMAGES: "android.permission.READ_MEDIA_IMAGES";
-        readonly READ_MEDIA_VIDEO: "android.permission.READ_MEDIA_VIDEO";
-        readonly READ_MEDIA_AUDIO: "android.permission.READ_MEDIA_AUDIO";
-        readonly READ_MEDIA_VISUAL_USER_SELECTED: "android.permission.READ_MEDIA_VISUAL_USER_SELECTED";
-        readonly WRITE_EXTERNAL_STORAGE: "android.permission.WRITE_EXTERNAL_STORAGE";
-        readonly BLUETOOTH_CONNECT: "android.permission.BLUETOOTH_CONNECT";
-        readonly BLUETOOTH_SCAN: "android.permission.BLUETOOTH_SCAN";
-        readonly BLUETOOTH_ADVERTISE: "android.permission.BLUETOOTH_ADVERTISE";
-        readonly ACCESS_MEDIA_LOCATION: "android.permission.ACCESS_MEDIA_LOCATION";
-        readonly ACCEPT_HANDOVER: "android.permission.ACCEPT_HANDOVER";
-        readonly ACTIVITY_RECOGNITION: "android.permission.ACTIVITY_RECOGNITION";
-        readonly ANSWER_PHONE_CALLS: "android.permission.ANSWER_PHONE_CALLS";
-        readonly READ_PHONE_NUMBERS: "android.permission.READ_PHONE_NUMBERS";
-        readonly UWB_RANGING: "android.permission.UWB_RANGING";
-        readonly POST_NOTIFICATIONS: "android.permission.POST_NOTIFICATIONS";
-        readonly NEARBY_WIFI_DEVICES: "android.permission.NEARBY_WIFI_DEVICES";
-    }>;
-    RESULTS: Readonly<{
-        readonly GRANTED: "granted";
-        readonly DENIED: "denied";
-        readonly NEVER_ASK_AGAIN: "never_ask_again";
-    }>;
-    check(permission: IPermission): Promise<boolean>;
-    request(permission: IPermission, rationale?: IRationale): Promise<IPermissionStatus>;
-    requestMultiple(permissions: IPermission[]): Promise<Record<string, IPermissionStatus>>;
-    shouldShowRequestPermissionRationale(permission: IPermission): Promise<boolean>;
-};
+export * from './index.ios';

package/build/permissions-android/index.ios.d.ts

@@ -0,0 +1,59 @@
+import { type IPermission, type IPermissionStatus, type IRationale } from './shared';
+export { PERMISSIONS, RESULTS, type IPermission, type IPermissionStatus, type IRationale, } from './shared';
+export declare const PermissionsAndroid: {
+    PERMISSIONS: Readonly<{
+        readonly READ_CALENDAR: "android.permission.READ_CALENDAR";
+        readonly WRITE_CALENDAR: "android.permission.WRITE_CALENDAR";
+        readonly CAMERA: "android.permission.CAMERA";
+        readonly READ_CONTACTS: "android.permission.READ_CONTACTS";
+        readonly WRITE_CONTACTS: "android.permission.WRITE_CONTACTS";
+        readonly GET_ACCOUNTS: "android.permission.GET_ACCOUNTS";
+        readonly ACCESS_FINE_LOCATION: "android.permission.ACCESS_FINE_LOCATION";
+        readonly ACCESS_COARSE_LOCATION: "android.permission.ACCESS_COARSE_LOCATION";
+        readonly ACCESS_BACKGROUND_LOCATION: "android.permission.ACCESS_BACKGROUND_LOCATION";
+        readonly RECORD_AUDIO: "android.permission.RECORD_AUDIO";
+        readonly READ_PHONE_STATE: "android.permission.READ_PHONE_STATE";
+        readonly CALL_PHONE: "android.permission.CALL_PHONE";
+        readonly READ_CALL_LOG: "android.permission.READ_CALL_LOG";
+        readonly WRITE_CALL_LOG: "android.permission.WRITE_CALL_LOG";
+        readonly ADD_VOICEMAIL: "com.android.voicemail.permission.ADD_VOICEMAIL";
+        readonly READ_VOICEMAIL: "com.android.voicemail.permission.READ_VOICEMAIL";
+        readonly WRITE_VOICEMAIL: "com.android.voicemail.permission.WRITE_VOICEMAIL";
+        readonly USE_SIP: "android.permission.USE_SIP";
+        readonly PROCESS_OUTGOING_CALLS: "android.permission.PROCESS_OUTGOING_CALLS";
+        readonly BODY_SENSORS: "android.permission.BODY_SENSORS";
+        readonly BODY_SENSORS_BACKGROUND: "android.permission.BODY_SENSORS_BACKGROUND";
+        readonly SEND_SMS: "android.permission.SEND_SMS";
+        readonly RECEIVE_SMS: "android.permission.RECEIVE_SMS";
+        readonly READ_SMS: "android.permission.READ_SMS";
+        readonly RECEIVE_WAP_PUSH: "android.permission.RECEIVE_WAP_PUSH";
+        readonly RECEIVE_MMS: "android.permission.RECEIVE_MMS";
+        readonly READ_EXTERNAL_STORAGE: "android.permission.READ_EXTERNAL_STORAGE";
+        readonly READ_MEDIA_IMAGES: "android.permission.READ_MEDIA_IMAGES";
+        readonly READ_MEDIA_VIDEO: "android.permission.READ_MEDIA_VIDEO";
+        readonly READ_MEDIA_AUDIO: "android.permission.READ_MEDIA_AUDIO";
+        readonly READ_MEDIA_VISUAL_USER_SELECTED: "android.permission.READ_MEDIA_VISUAL_USER_SELECTED";
+        readonly WRITE_EXTERNAL_STORAGE: "android.permission.WRITE_EXTERNAL_STORAGE";
+        readonly BLUETOOTH_CONNECT: "android.permission.BLUETOOTH_CONNECT";
+        readonly BLUETOOTH_SCAN: "android.permission.BLUETOOTH_SCAN";
+        readonly BLUETOOTH_ADVERTISE: "android.permission.BLUETOOTH_ADVERTISE";
+        readonly ACCESS_MEDIA_LOCATION: "android.permission.ACCESS_MEDIA_LOCATION";
+        readonly ACCEPT_HANDOVER: "android.permission.ACCEPT_HANDOVER";
+        readonly ACTIVITY_RECOGNITION: "android.permission.ACTIVITY_RECOGNITION";
+        readonly ANSWER_PHONE_CALLS: "android.permission.ANSWER_PHONE_CALLS";
+        readonly READ_PHONE_NUMBERS: "android.permission.READ_PHONE_NUMBERS";
+        readonly UWB_RANGING: "android.permission.UWB_RANGING";
+        readonly POST_NOTIFICATIONS: "android.permission.POST_NOTIFICATIONS";
+        readonly NEARBY_WIFI_DEVICES: "android.permission.NEARBY_WIFI_DEVICES";
+    }>;
+    RESULTS: Readonly<{
+        readonly GRANTED: "granted";
+        readonly DENIED: "denied";
+        readonly NEVER_ASK_AGAIN: "never_ask_again";
+    }>;
+    checkPermission(_permission: IPermission): Promise<boolean>;
+    check(_permission: IPermission): Promise<boolean>;
+    requestPermission(_permission: IPermission, _rationale?: IRationale): Promise<boolean>;
+    request(_permission: IPermission, _rationale?: IRationale): Promise<IPermissionStatus>;
+    requestMultiple(_permissions: IPermission[]): Promise<Record<string, IPermissionStatus>>;
+};

package/build/permissions-android/index.ios.js

@@ -0,0 +1,31 @@
+// PermissionsAndroid off Android: RN's PermissionsAndroid.js `Platform.OS !== 'android'` branches.
+// Each call warns that the module is Android-only (RN's own user-facing warning) and resolves a
+// fixed answer; nothing reaches native.
+import { ANDROID_ONLY_WARNING, CHECK_PERMISSION_DEPRECATED, PERMISSIONS, REQUEST_PERMISSION_DEPRECATED, RESULTS, } from './shared.js';
+export { PERMISSIONS, RESULTS, } from './shared.js';
+export const PermissionsAndroid = {
+    PERMISSIONS,
+    RESULTS,
+    checkPermission(_permission) {
+        console.warn(CHECK_PERMISSION_DEPRECATED);
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve(false);
+    },
+    check(_permission) {
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve(false);
+    },
+    requestPermission(_permission, _rationale) {
+        console.warn(REQUEST_PERMISSION_DEPRECATED);
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve(false);
+    },
+    request(_permission, _rationale) {
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve(RESULTS.DENIED);
+    },
+    requestMultiple(_permissions) {
+        console.warn(ANDROID_ONLY_WARNING);
+        return Promise.resolve({});
+    },
+};

package/build/permissions-android/index.js

@@ -1,184 +1,3 @@
-// PermissionsAndroid module: JS wrapper over Android's runtime-permissions
-// model. Mirrors RN's Libraries/PermissionsAndroid/PermissionsAndroid.js,
-// exposing the modern API: check / request / requestMultiple /
-// shouldShowRequestPermissionRationale, plus the frozen PERMISSIONS and RESULTS
-// constant maps. Imperative JS->native calls with no Fabric view of their own,
-// like Vibration / Keyboard.
-//
-// symbiote is iOS-first and this module is Android-only, so it MUST degrade
-// gracefully when the native module is absent (on iOS, or headless). RN throws
-// "works only for Android"; we instead resolve a safe default + dlog so a
-// cross-platform smoke never hard-crashes the process. Never reject/throw
-// synchronously on a missing module.
-//
-// The native contract is confirmed from RN's TurboModule spec at
-// specs_DEPRECATED/modules/INativePermissionsAndroid.js (`'PermissionsAndroid'`):
-//   checkPermission(permission): Promise<boolean>
-//   requestPermission(permission): Promise<string>
-//   shouldShowRequestPermissionRationale(permission): Promise<boolean>
-//   requestMultiplePermissions(permissions): Promise<{[permission]: string}>
-import { getNativeModule } from '../native-modules/index.js';
-import { dlog } from '../debug.js';
-import { isBoolean } from '../type-guards.js';
-// The native module name RN registers this TurboModule under
-// (`TurboModuleRegistry.get<Spec>('PermissionsAndroid')`). NOTE: a module name is
-// only provable on a real host (a headless fake answers to any name); this name
-// is device-verify-pending.
-const PERMISSIONS_ANDROID_MODULE = 'PermissionsAndroid';
-// The runtime-permission result strings Android can return. Modeled as a frozen
-// `as const` map: the generated-style constant-map exception to "no magic
-// strings".
-export const RESULTS = Object.freeze({
-    GRANTED: 'granted',
-    DENIED: 'denied',
-    NEVER_ASK_AGAIN: 'never_ask_again',
-});
-// The full Android permission-string map, copied verbatim from RN's source.
-// Frozen `as const` constant map (the same string-map exception as RESULTS).
-export const PERMISSIONS = Object.freeze({
-    READ_CALENDAR: 'android.permission.READ_CALENDAR',
-    WRITE_CALENDAR: 'android.permission.WRITE_CALENDAR',
-    CAMERA: 'android.permission.CAMERA',
-    READ_CONTACTS: 'android.permission.READ_CONTACTS',
-    WRITE_CONTACTS: 'android.permission.WRITE_CONTACTS',
-    GET_ACCOUNTS: 'android.permission.GET_ACCOUNTS',
-    ACCESS_FINE_LOCATION: 'android.permission.ACCESS_FINE_LOCATION',
-    ACCESS_COARSE_LOCATION: 'android.permission.ACCESS_COARSE_LOCATION',
-    ACCESS_BACKGROUND_LOCATION: 'android.permission.ACCESS_BACKGROUND_LOCATION',
-    RECORD_AUDIO: 'android.permission.RECORD_AUDIO',
-    READ_PHONE_STATE: 'android.permission.READ_PHONE_STATE',
-    CALL_PHONE: 'android.permission.CALL_PHONE',
-    READ_CALL_LOG: 'android.permission.READ_CALL_LOG',
-    WRITE_CALL_LOG: 'android.permission.WRITE_CALL_LOG',
-    ADD_VOICEMAIL: 'com.android.voicemail.permission.ADD_VOICEMAIL',
-    READ_VOICEMAIL: 'com.android.voicemail.permission.READ_VOICEMAIL',
-    WRITE_VOICEMAIL: 'com.android.voicemail.permission.WRITE_VOICEMAIL',
-    USE_SIP: 'android.permission.USE_SIP',
-    PROCESS_OUTGOING_CALLS: 'android.permission.PROCESS_OUTGOING_CALLS',
-    BODY_SENSORS: 'android.permission.BODY_SENSORS',
-    BODY_SENSORS_BACKGROUND: 'android.permission.BODY_SENSORS_BACKGROUND',
-    SEND_SMS: 'android.permission.SEND_SMS',
-    RECEIVE_SMS: 'android.permission.RECEIVE_SMS',
-    READ_SMS: 'android.permission.READ_SMS',
-    RECEIVE_WAP_PUSH: 'android.permission.RECEIVE_WAP_PUSH',
-    RECEIVE_MMS: 'android.permission.RECEIVE_MMS',
-    READ_EXTERNAL_STORAGE: 'android.permission.READ_EXTERNAL_STORAGE',
-    READ_MEDIA_IMAGES: 'android.permission.READ_MEDIA_IMAGES',
-    READ_MEDIA_VIDEO: 'android.permission.READ_MEDIA_VIDEO',
-    READ_MEDIA_AUDIO: 'android.permission.READ_MEDIA_AUDIO',
-    READ_MEDIA_VISUAL_USER_SELECTED: 'android.permission.READ_MEDIA_VISUAL_USER_SELECTED',
-    WRITE_EXTERNAL_STORAGE: 'android.permission.WRITE_EXTERNAL_STORAGE',
-    BLUETOOTH_CONNECT: 'android.permission.BLUETOOTH_CONNECT',
-    BLUETOOTH_SCAN: 'android.permission.BLUETOOTH_SCAN',
-    BLUETOOTH_ADVERTISE: 'android.permission.BLUETOOTH_ADVERTISE',
-    ACCESS_MEDIA_LOCATION: 'android.permission.ACCESS_MEDIA_LOCATION',
-    ACCEPT_HANDOVER: 'android.permission.ACCEPT_HANDOVER',
-    ACTIVITY_RECOGNITION: 'android.permission.ACTIVITY_RECOGNITION',
-    ANSWER_PHONE_CALLS: 'android.permission.ANSWER_PHONE_CALLS',
-    READ_PHONE_NUMBERS: 'android.permission.READ_PHONE_NUMBERS',
-    UWB_RANGING: 'android.permission.UWB_RANGING',
-    POST_NOTIFICATIONS: 'android.permission.POST_NOTIFICATIONS',
-    NEARBY_WIFI_DEVICES: 'android.permission.NEARBY_WIFI_DEVICES',
-});
-// Narrow the native string result into a known RESULTS value. Any unrecognized
-// string is passed through as a IPermissionStatus only when it matches; otherwise
-// we fall back to DENIED: a runtime guard at the trust boundary, not an `as`.
-function toPermissionStatus(value) {
-    if (value === RESULTS.GRANTED ||
-        value === RESULTS.DENIED ||
-        value === RESULTS.NEVER_ASK_AGAIN) {
-        return value;
-    }
-    return RESULTS.DENIED;
-}
-// Narrow the native requestMultiplePermissions() return into a per-permission
-// status map. Each value is run through toPermissionStatus; non-object returns
-// yield an empty map.
-function toStatusMap(value) {
-    const result = {};
-    if (typeof value !== 'object' || value === null)
-        return result;
-    for (const key of Object.keys(value)) {
-        result[key] = toPermissionStatus(Reflect.get(value, key));
-    }
-    return result;
-}
-// Resolved FRESH on every call, deliberately NOT memoized at module load. The original
-// self-contained module resolved once at import, but moving it into the engine made it a
-// shared singleton; a cached null would survive a module being linked later (or the headless
-// smoke flipping a fake module on after its first import). getNativeModule is a cheap proxy
-// lookup, so per-call resolution costs nothing and stays correct. Returns null on iOS / headless.
-function getModule() {
-    const module = getNativeModule(PERMISSIONS_ANDROID_MODULE);
-    dlog(`PermissionsAndroid: module ${module ? 'resolved' : 'NOT resolved (null)'}`);
-    return module;
-}
-export const PermissionsAndroid = {
-    PERMISSIONS,
-    RESULTS,
-    // Resolve whether a permission has already been granted. Without a native
-    // module (iOS / headless) resolve false. Never throw.
-    async check(permission) {
-        const permissionsModule = getModule();
-        if (permissionsModule === null) {
-            dlog('PermissionsAndroid.check -> module unavailable, resolving false');
-            return false;
-        }
-        dlog(`PermissionsAndroid.check -> ${permission}`);
-        const granted = await permissionsModule.checkPermission(permission);
-        return isBoolean(granted) ? granted : false;
-    },
-    // Prompt the user for a permission, resolving a RESULTS status. If a rationale
-    // is supplied and DialogManagerAndroid is present, show it first; otherwise
-    // proceed straight to the native request (dlog the skip). Without the
-    // PermissionsAndroid module resolve RESULTS.DENIED. Never throw.
-    async request(permission, rationale) {
-        const permissionsModule = getModule();
-        if (permissionsModule === null) {
-            dlog('PermissionsAndroid.request -> module unavailable, resolving DENIED');
-            return RESULTS.DENIED;
-        }
-        dlog(`PermissionsAndroid.request -> ${permission}`);
-        if (rationale !== undefined) {
-            const shouldShow = await permissionsModule.shouldShowRequestPermissionRationale(permission);
-            const dialogModule = getNativeModule('DialogManagerAndroid');
-            if (isBoolean(shouldShow) && shouldShow && dialogModule !== null) {
-                return new Promise((resolve, reject) => {
-                    dialogModule.showAlert(rationale, () => reject(new Error('Error showing rationale')), () => {
-                        permissionsModule
-                            .requestPermission(permission)
-                            .then(status => resolve(toPermissionStatus(status)))
-                            .catch(reject);
-                    });
-                });
-            }
-            dlog('PermissionsAndroid.request -> rationale skipped (DialogManagerAndroid unavailable)');
-        }
-        const status = await permissionsModule.requestPermission(permission);
-        return toPermissionStatus(status);
-    },
-    // Prompt for several permissions at once, resolving a per-permission status
-    // map. Without a native module resolve an empty map. Never throw.
-    async requestMultiple(permissions) {
-        const permissionsModule = getModule();
-        if (permissionsModule === null) {
-            dlog('PermissionsAndroid.requestMultiple -> module unavailable, resolving {}');
-            return {};
-        }
-        dlog(`PermissionsAndroid.requestMultiple -> ${permissions.join(', ')}`);
-        const statuses = await permissionsModule.requestMultiplePermissions(permissions);
-        return toStatusMap(statuses);
-    },
-    // Whether the OS recommends showing a rationale before re-requesting. Without
-    // a native module resolve false. Never throw.
-    async shouldShowRequestPermissionRationale(permission) {
-        const permissionsModule = getModule();
-        if (permissionsModule === null) {
-            dlog('PermissionsAndroid.shouldShowRequestPermissionRationale -> module unavailable, resolving false');
-            return false;
-        }
-        dlog(`PermissionsAndroid.shouldShowRequestPermissionRationale -> ${permission}`);
-        const shouldShow = await permissionsModule.shouldShowRequestPermissionRationale(permission);
-        return isBoolean(shouldShow) ? shouldShow : false;
-    },
-};
+// PermissionsAndroid: base / headless build. Metro picks index.android.ts / index.ios.ts on a
+// device; off those, RN's non-Android branch is the default.
+export * from './index.ios.js';

package/build/permissions-android/shared.d.ts

@@ -0,0 +1,63 @@
+export declare const PERMISSIONS_ANDROID_MODULE = "PermissionsAndroid";
+export declare const ANDROID_ONLY_WARNING = "\"PermissionsAndroid\" module works only for Android platform.";
+export declare const CHECK_PERMISSION_DEPRECATED = "\"PermissionsAndroid.checkPermission\" is deprecated. Use \"PermissionsAndroid.check\" instead";
+export declare const REQUEST_PERMISSION_DEPRECATED = "\"PermissionsAndroid.requestPermission\" is deprecated. Use \"PermissionsAndroid.request\" instead";
+export declare const RESULTS: Readonly<{
+    readonly GRANTED: "granted";
+    readonly DENIED: "denied";
+    readonly NEVER_ASK_AGAIN: "never_ask_again";
+}>;
+export type IPermissionStatus = (typeof RESULTS)[keyof typeof RESULTS];
+export declare const PERMISSIONS: Readonly<{
+    readonly READ_CALENDAR: "android.permission.READ_CALENDAR";
+    readonly WRITE_CALENDAR: "android.permission.WRITE_CALENDAR";
+    readonly CAMERA: "android.permission.CAMERA";
+    readonly READ_CONTACTS: "android.permission.READ_CONTACTS";
+    readonly WRITE_CONTACTS: "android.permission.WRITE_CONTACTS";
+    readonly GET_ACCOUNTS: "android.permission.GET_ACCOUNTS";
+    readonly ACCESS_FINE_LOCATION: "android.permission.ACCESS_FINE_LOCATION";
+    readonly ACCESS_COARSE_LOCATION: "android.permission.ACCESS_COARSE_LOCATION";
+    readonly ACCESS_BACKGROUND_LOCATION: "android.permission.ACCESS_BACKGROUND_LOCATION";
+    readonly RECORD_AUDIO: "android.permission.RECORD_AUDIO";
+    readonly READ_PHONE_STATE: "android.permission.READ_PHONE_STATE";
+    readonly CALL_PHONE: "android.permission.CALL_PHONE";
+    readonly READ_CALL_LOG: "android.permission.READ_CALL_LOG";
+    readonly WRITE_CALL_LOG: "android.permission.WRITE_CALL_LOG";
+    readonly ADD_VOICEMAIL: "com.android.voicemail.permission.ADD_VOICEMAIL";
+    readonly READ_VOICEMAIL: "com.android.voicemail.permission.READ_VOICEMAIL";
+    readonly WRITE_VOICEMAIL: "com.android.voicemail.permission.WRITE_VOICEMAIL";
+    readonly USE_SIP: "android.permission.USE_SIP";
+    readonly PROCESS_OUTGOING_CALLS: "android.permission.PROCESS_OUTGOING_CALLS";
+    readonly BODY_SENSORS: "android.permission.BODY_SENSORS";
+    readonly BODY_SENSORS_BACKGROUND: "android.permission.BODY_SENSORS_BACKGROUND";
+    readonly SEND_SMS: "android.permission.SEND_SMS";
+    readonly RECEIVE_SMS: "android.permission.RECEIVE_SMS";
+    readonly READ_SMS: "android.permission.READ_SMS";
+    readonly RECEIVE_WAP_PUSH: "android.permission.RECEIVE_WAP_PUSH";
+    readonly RECEIVE_MMS: "android.permission.RECEIVE_MMS";
+    readonly READ_EXTERNAL_STORAGE: "android.permission.READ_EXTERNAL_STORAGE";
+    readonly READ_MEDIA_IMAGES: "android.permission.READ_MEDIA_IMAGES";
+    readonly READ_MEDIA_VIDEO: "android.permission.READ_MEDIA_VIDEO";
+    readonly READ_MEDIA_AUDIO: "android.permission.READ_MEDIA_AUDIO";
+    readonly READ_MEDIA_VISUAL_USER_SELECTED: "android.permission.READ_MEDIA_VISUAL_USER_SELECTED";
+    readonly WRITE_EXTERNAL_STORAGE: "android.permission.WRITE_EXTERNAL_STORAGE";
+    readonly BLUETOOTH_CONNECT: "android.permission.BLUETOOTH_CONNECT";
+    readonly BLUETOOTH_SCAN: "android.permission.BLUETOOTH_SCAN";
+    readonly BLUETOOTH_ADVERTISE: "android.permission.BLUETOOTH_ADVERTISE";
+    readonly ACCESS_MEDIA_LOCATION: "android.permission.ACCESS_MEDIA_LOCATION";
+    readonly ACCEPT_HANDOVER: "android.permission.ACCEPT_HANDOVER";
+    readonly ACTIVITY_RECOGNITION: "android.permission.ACTIVITY_RECOGNITION";
+    readonly ANSWER_PHONE_CALLS: "android.permission.ANSWER_PHONE_CALLS";
+    readonly READ_PHONE_NUMBERS: "android.permission.READ_PHONE_NUMBERS";
+    readonly UWB_RANGING: "android.permission.UWB_RANGING";
+    readonly POST_NOTIFICATIONS: "android.permission.POST_NOTIFICATIONS";
+    readonly NEARBY_WIFI_DEVICES: "android.permission.NEARBY_WIFI_DEVICES";
+}>;
+export type IPermission = (typeof PERMISSIONS)[keyof typeof PERMISSIONS];
+export type IRationale = {
+    title: string;
+    message: string;
+    buttonPositive?: string;
+    buttonNegative?: string;
+    buttonNeutral?: string;
+};

package/build/permissions-android/shared.js

@@ -0,0 +1,66 @@
+// PermissionsAndroid, platform-neutral half: the frozen PERMISSIONS / RESULTS maps and the public
+// types, copied verbatim from RN's Libraries/PermissionsAndroid/PermissionsAndroid.js. The behavior
+// is per platform, as in RN: index.android.ts talks to the native module, index.ios.ts is RN's
+// `Platform.OS !== 'android'` branch.
+//
+// The native contract, from RN's TurboModule spec (`'PermissionsAndroid'`):
+//   checkPermission(permission): Promise<boolean>
+//   requestPermission(permission): Promise<string>
+//   shouldShowRequestPermissionRationale(permission): Promise<boolean>
+//   requestMultiplePermissions(permissions): Promise<{[permission]: string}>
+export const PERMISSIONS_ANDROID_MODULE = 'PermissionsAndroid';
+export const ANDROID_ONLY_WARNING = '"PermissionsAndroid" module works only for Android platform.';
+export const CHECK_PERMISSION_DEPRECATED = '"PermissionsAndroid.checkPermission" is deprecated. Use "PermissionsAndroid.check" instead';
+export const REQUEST_PERMISSION_DEPRECATED = '"PermissionsAndroid.requestPermission" is deprecated. Use "PermissionsAndroid.request" instead';
+// The runtime-permission result strings Android can return.
+export const RESULTS = Object.freeze({
+    GRANTED: 'granted',
+    DENIED: 'denied',
+    NEVER_ASK_AGAIN: 'never_ask_again',
+});
+// The full Android permission-string map, copied verbatim from RN's source.
+export const PERMISSIONS = Object.freeze({
+    READ_CALENDAR: 'android.permission.READ_CALENDAR',
+    WRITE_CALENDAR: 'android.permission.WRITE_CALENDAR',
+    CAMERA: 'android.permission.CAMERA',
+    READ_CONTACTS: 'android.permission.READ_CONTACTS',
+    WRITE_CONTACTS: 'android.permission.WRITE_CONTACTS',
+    GET_ACCOUNTS: 'android.permission.GET_ACCOUNTS',
+    ACCESS_FINE_LOCATION: 'android.permission.ACCESS_FINE_LOCATION',
+    ACCESS_COARSE_LOCATION: 'android.permission.ACCESS_COARSE_LOCATION',
+    ACCESS_BACKGROUND_LOCATION: 'android.permission.ACCESS_BACKGROUND_LOCATION',
+    RECORD_AUDIO: 'android.permission.RECORD_AUDIO',
+    READ_PHONE_STATE: 'android.permission.READ_PHONE_STATE',
+    CALL_PHONE: 'android.permission.CALL_PHONE',
+    READ_CALL_LOG: 'android.permission.READ_CALL_LOG',
+    WRITE_CALL_LOG: 'android.permission.WRITE_CALL_LOG',
+    ADD_VOICEMAIL: 'com.android.voicemail.permission.ADD_VOICEMAIL',
+    READ_VOICEMAIL: 'com.android.voicemail.permission.READ_VOICEMAIL',
+    WRITE_VOICEMAIL: 'com.android.voicemail.permission.WRITE_VOICEMAIL',
+    USE_SIP: 'android.permission.USE_SIP',
+    PROCESS_OUTGOING_CALLS: 'android.permission.PROCESS_OUTGOING_CALLS',
+    BODY_SENSORS: 'android.permission.BODY_SENSORS',
+    BODY_SENSORS_BACKGROUND: 'android.permission.BODY_SENSORS_BACKGROUND',
+    SEND_SMS: 'android.permission.SEND_SMS',
+    RECEIVE_SMS: 'android.permission.RECEIVE_SMS',
+    READ_SMS: 'android.permission.READ_SMS',
+    RECEIVE_WAP_PUSH: 'android.permission.RECEIVE_WAP_PUSH',
+    RECEIVE_MMS: 'android.permission.RECEIVE_MMS',
+    READ_EXTERNAL_STORAGE: 'android.permission.READ_EXTERNAL_STORAGE',
+    READ_MEDIA_IMAGES: 'android.permission.READ_MEDIA_IMAGES',
+    READ_MEDIA_VIDEO: 'android.permission.READ_MEDIA_VIDEO',
+    READ_MEDIA_AUDIO: 'android.permission.READ_MEDIA_AUDIO',
+    READ_MEDIA_VISUAL_USER_SELECTED: 'android.permission.READ_MEDIA_VISUAL_USER_SELECTED',
+    WRITE_EXTERNAL_STORAGE: 'android.permission.WRITE_EXTERNAL_STORAGE',
+    BLUETOOTH_CONNECT: 'android.permission.BLUETOOTH_CONNECT',
+    BLUETOOTH_SCAN: 'android.permission.BLUETOOTH_SCAN',
+    BLUETOOTH_ADVERTISE: 'android.permission.BLUETOOTH_ADVERTISE',
+    ACCESS_MEDIA_LOCATION: 'android.permission.ACCESS_MEDIA_LOCATION',
+    ACCEPT_HANDOVER: 'android.permission.ACCEPT_HANDOVER',
+    ACTIVITY_RECOGNITION: 'android.permission.ACTIVITY_RECOGNITION',
+    ANSWER_PHONE_CALLS: 'android.permission.ANSWER_PHONE_CALLS',
+    READ_PHONE_NUMBERS: 'android.permission.READ_PHONE_NUMBERS',
+    UWB_RANGING: 'android.permission.UWB_RANGING',
+    POST_NOTIFICATIONS: 'android.permission.POST_NOTIFICATIONS',
+    NEARBY_WIFI_DEVICES: 'android.permission.NEARBY_WIFI_DEVICES',
+});