@dubsdotapp/expo 0.5.20 → 0.5.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dubsdotapp/expo",
-  "version": "0.5.20",
+  "version": "0.5.22",
   "description": "React Native SDK for the Dubs betting platform",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/hooks/usePushNotifications.ts

@@ -3,11 +3,29 @@ import { Platform } from 'react-native';
 import { useDubs } from '../provider';
 
 export interface PushNotificationStatus {
-  /** Whether push notifications are enabled in the SDK configuration */
+  /**
+   * Whether push is currently delivering to this user — the right signal for
+   * UI bindings like a "Notifications: Enabled/Disabled" toggle.
+   *
+   * Equivalent to `enabled && !!pushToken`. Goes false after `unregister()`
+   * even though OS permission is still granted. Goes true after `register()`
+   * succeeds.
+   *
+   * Use this — NOT `hasPermission` — when binding switches/toggles.
+   */
+  isActive: boolean;
+  /** Whether push notifications are enabled in the SDK configuration (the `pushEnabled` prop on DubsProvider). */
   enabled: boolean;
-  /** Whether notification permission has been granted */
+  /**
+   * Whether OS-level notification permission has been granted on this device.
+   *
+   * Note: this stays true after `unregister()` because the OS doesn't revoke
+   * permission when a server token is dropped. Useful for permission-flow
+   * prompts (e.g. "Re-enable in Settings" hint), but NOT for "is push on" UI —
+   * use `isActive` for that.
+   */
   hasPermission: boolean;
-  /** The push token (native FCM/APNs), if registered */
+  /** The native device push token (FCM/APNs), if currently registered with the server. */
   pushToken: string | null;
   /**
    * @deprecated Use pushToken instead. Kept for backwards compatibility.
@@ -188,6 +206,7 @@ export function usePushNotifications(): PushNotificationStatus {
   }, []); // eslint-disable-line react-hooks/exhaustive-deps
 
   return {
+    isActive: pushEnabled && !!pushToken,
     enabled: pushEnabled,
     hasPermission,
     pushToken,