Simplify requestPermissionBackgroundLocation and requestPermissionBatteryOptimization responses

CHANGELOG.md

@@ -1,5 +1,12 @@
 # CHANGELOG
 
+## v4.2.0 - TBD
+
+-   `requestPermissionBackgroundLocation`: response simplified to
+    `status: "granted" | "denied"` (removed `settings_change_required`)
+-   `requestPermissionBatteryOptimization`: response simplified to
+    `status: "granted" | "denied"` (removed `settings_change_required`)
+
 ## v4.1.0 - 2026-02-27
 
 -   Family Locator SDK request permission methods: `requestPermissionLocation`,

README.md

@@ -1894,7 +1894,7 @@ Request background location permission from the user.
 
 ```ts
 requestPermissionBackgroundLocation: () => Promise<{
-    status: 'granted' | 'denied' | 'settings_change_required';
+    status: 'granted' | 'denied';
 }>;
 ```
 
@@ -1957,7 +1957,7 @@ Request permission to disable battery optimization (Android only).
 
 ```ts
 requestPermissionBatteryOptimization: () => Promise<{
-    status: 'denied' | 'settings_change_required';
+    status: 'granted' | 'denied';
 }>;
 ```
 

src/__tests__/family-locator-test.ts

@@ -256,12 +256,12 @@ test('requestPermissionBackgroundLocation', async () => {
         getResponse: (msg) => ({
             type: 'REQUEST_PERMISSION_BACKGROUND_LOCATION',
             id: msg.id,
-            payload: {status: 'settings_change_required'},
+            payload: {status: 'granted'},
         }),
     });
 
     const res = await requestPermissionBackgroundLocation();
-    expect(res).toEqual({status: 'settings_change_required'});
+    expect(res).toEqual({status: 'granted'});
 });
 
 test('requestPermissionMicrophone', async () => {
@@ -320,10 +320,10 @@ test('requestPermissionBatteryOptimization', async () => {
         getResponse: (msg) => ({
             type: 'REQUEST_PERMISSION_BATTERY_OPTIMIZATION',
             id: msg.id,
-            payload: {status: 'settings_change_required'},
+            payload: {status: 'denied'},
         }),
     });
 
     const res = await requestPermissionBatteryOptimization();
-    expect(res).toEqual({status: 'settings_change_required'});
+    expect(res).toEqual({status: 'denied'});
 });

src/family-locator.ts

@@ -129,7 +129,7 @@ export const requestPermissionLocation = (): Promise<{
 }> => postMessageToNativeApp({type: 'REQUEST_PERMISSION_LOCATION'});
 
 export const requestPermissionBackgroundLocation = (): Promise<{
-    status: PermissionStatus | 'settings_change_required';
+    status: PermissionStatus;
 }> => postMessageToNativeApp({type: 'REQUEST_PERMISSION_BACKGROUND_LOCATION'});
 
 export const requestPermissionMicrophone = (): Promise<{
@@ -145,5 +145,5 @@ export const requestPermissionCriticalAlerts = (): Promise<{
 }> => postMessageToNativeApp({type: 'REQUEST_PERMISSION_CRITICAL_ALERTS'});
 
 export const requestPermissionBatteryOptimization = (): Promise<{
-    status: 'denied' | 'settings_change_required';
+    status: PermissionStatus;
 }> => postMessageToNativeApp({type: 'REQUEST_PERMISSION_BATTERY_OPTIMIZATION'});

src/post-message.ts

@@ -180,7 +180,7 @@ export type ResponsesFromNativeApp = {
         id: string;
         type: 'REQUEST_PERMISSION_BACKGROUND_LOCATION';
         payload: {
-            status: 'granted' | 'denied' | 'settings_change_required';
+            status: 'granted' | 'denied';
         };
     };
     REQUEST_PERMISSION_MICROPHONE: {
@@ -208,7 +208,7 @@ export type ResponsesFromNativeApp = {
         id: string;
         type: 'REQUEST_PERMISSION_BATTERY_OPTIMIZATION';
         payload: {
-            status: 'denied' | 'settings_change_required';
+            status: 'granted' | 'denied';
         };
     };
     INTERNAL_NAVIGATION: {