expo-pusher-push-notifications 0.4.2 → 0.5.0

package/README.md

@@ -1,6 +1,11 @@
 # expo-pusher-push-notifications
 
-Push notifications for Expo and React Native, powered by [Pusher Beams](https://pusher.com/beams). Subscribe devices to topics, bind them to your signed-in users, and get custom sounds, Android channels, badges, and local notifications along the way.
+Push notifications for Expo and React Native. Two ways to use it:
+
+1. **Pusher Beams** — subscribe devices to interests (topics) and/or bind them to your signed-in users. Uses [Pusher Beams](https://pusher.com/beams).
+2. **Device token** — get the raw FCM (Android) / APNs (iOS) token for your own push path. No Beams, no `expo-notifications`, no EAS.
+
+Both get custom sounds, Android channels, badges, and local notifications.
 
 ```sh
 npx expo install expo-pusher-push-notifications
@@ -27,7 +32,9 @@ await Interests.subscribe('news');
 
 That device now gets pushes sent to `news`. Full console steps (APNs, Firebase, Beams) are in [Setup](docs/setup.md).
 
-## Subscribe to interests (topics)
+## Path 1: Pusher Beams
+
+### Subscribe to interests (topics)
 
 Interests are topics like `news`, `order-42`, or `team-7`. Every device subscribed to one gets the push.
 
@@ -38,7 +45,7 @@ await Interests.unsubscribe('order-42');
 
 More in [Interests](docs/interests.md).
 
-## Bind a device to a user
+### Bind a device to a user
 
 To get pushes meant for a specific signed-in user on all their devices, bind the device to that user.
 
@@ -59,6 +66,20 @@ await Users.logout();
 
 You can use interests and users together. More in [Users](docs/users.md).
 
+## Path 2: Device token
+
+No Beams instance needed (leave `instanceId` out of the plugin config).
+
+```ts
+import { DeviceToken } from 'expo-pusher-push-notifications';
+
+const token = await DeviceToken.start(); // { type: 'fcm' | 'apns', platform, token }
+DeviceToken.onChange((t) => { /* token rotated */ });
+await DeviceToken.delete(); // on sign-out
+```
+
+You get the token in the app; sending it to your backend and pushing from there is up to you. More in [Device token](docs/direct.md).
+
 ## Extras
 
 ```ts
@@ -77,6 +98,7 @@ Custom sounds go in the plugin's `sounds` option. Details in [Extras](docs/extra
 - [Setup](docs/setup.md)
 - [Interests](docs/interests.md)
 - [Users](docs/users.md)
+- [Device token](docs/direct.md)
 - [Sounds, channels, badges, local notifications](docs/extras.md)
 - [Full API](docs/api.md)
 - [Migrating from react-native-pusher-push-notifications](docs/migrating.md)
@@ -84,7 +106,6 @@ Custom sounds go in the plugin's `sounds` option. Details in [Extras](docs/extra
 ## Good to know
 
 - This module owns the iOS notification delegate and the Android FCM service, so don't run it alongside `expo-notifications` or `@react-native-firebase/messaging`.
-- Want a raw FCM / APNs token without Beams? Use [`expo-notifications`](https://docs.expo.dev/versions/latest/sdk/notifications/) instead.
 - Need realtime Pusher **Channels** (websockets)? Use [`pusher-js`](https://github.com/pusher/pusher-js).
 
 ## License

package/android/src/main/java/expo/modules/pusherpushnotifications/ExpoPusherPushNotificationsModule.kt

@@ -9,6 +9,7 @@ import android.content.Intent
 import android.os.Build
 import android.os.SystemClock
 import androidx.core.app.NotificationManagerCompat
+import com.google.firebase.messaging.FirebaseMessaging
 import com.pusher.pushnotifications.BeamsCallback
 import com.pusher.pushnotifications.PushNotifications
 import com.pusher.pushnotifications.PusherCallbackError
@@ -75,6 +76,24 @@ class ExpoPusherPushNotificationsModule : Module() {
     AsyncFunction("clearAllState") { PushNotifications.clearAllState() }
     AsyncFunction("stop") { PushNotifications.stop() }
 
+    // ---- Raw device token (FCM) ----
+    AsyncFunction("registerForDeviceToken") { promise: Promise ->
+      FirebaseMessaging.getInstance().token.addOnCompleteListener { t ->
+        if (t.isSuccessful && t.result != null) {
+          NotificationHelper.saveToken(context, t.result)
+          sendEvent("registered", mapOf("deviceToken" to t.result, "type" to "fcm"))
+          promise.resolve(tokenMap(t.result))
+        } else promise.reject("E_FCM_TOKEN", t.exception?.message ?: "Failed to get FCM token", t.exception)
+      }
+    }
+    AsyncFunction("getDevicePushToken") { -> NotificationHelper.savedToken(context)?.let { tokenMap(it) } }
+    AsyncFunction("deleteDevicePushToken") { promise: Promise ->
+      FirebaseMessaging.getInstance().deleteToken().addOnCompleteListener { t ->
+        NotificationHelper.saveToken(context, null)
+        if (t.isSuccessful) promise.resolve(null) else promise.reject("E_FCM_DELETE", t.exception?.message, t.exception)
+      }
+    }
+
     // ---- Permissions ----
     AsyncFunction("requestPermission") { promise: Promise ->
       val perms = appContext.permissions
@@ -140,6 +159,8 @@ class ExpoPusherPushNotificationsModule : Module() {
     override fun onFailure(error: PusherCallbackError) = promise.reject("E_SET_USER_ID", error.message, null)
   }
 
+  private fun tokenMap(token: String) = mapOf("type" to "fcm", "platform" to "android", "token" to token)
+
   private fun status(): String =
     if (NotificationManagerCompat.from(context).areNotificationsEnabled()) PermissionsStatus.GRANTED.status
     else if (Build.VERSION.SDK_INT >= 33) PermissionsStatus.UNDETERMINED.status else PermissionsStatus.DENIED.status

package/android/src/main/java/expo/modules/pusherpushnotifications/NotificationHelper.kt

@@ -106,6 +106,10 @@ object NotificationHelper {
     if (n <= 0) NotificationManagerCompat.from(ctx).cancelAll()
   }
 
+  fun saveToken(ctx: Context, token: String?) =
+    ctx.getSharedPreferences(PREFS, Context.MODE_PRIVATE).edit().putString("fcm_token", token).apply()
+  fun savedToken(ctx: Context) = ctx.getSharedPreferences(PREFS, Context.MODE_PRIVATE).getString("fcm_token", null)
+
   fun show(ctx: Context, id: Int, title: String?, body: String?, data: Map<String, String>, sound: String?, channelId: String?) {
     ensureChannels(ctx)
     val launch = ctx.packageManager.getLaunchIntentForPackage(ctx.packageName)?.apply {

package/android/src/main/java/expo/modules/pusherpushnotifications/PusherMessagingService.kt

@@ -4,8 +4,8 @@ import com.google.firebase.messaging.RemoteMessage
 import com.pusher.pushnotifications.fcm.MessagingService
 
 /**
- * The app's FCM service. Extends the Beams MessagingService so Beams keeps working,
- * and adds foreground display, custom sounds/channels and badge handling on top.
+ * Single FCM service for all three modes. Extends the Beams MessagingService so Beams keeps working
+ * in `interests`/`users` mode; in `device` mode it simply receives raw FCM messages from your server.
  */
 class PusherMessagingService : MessagingService() {
   companion object { @Volatile var module: ExpoPusherPushNotificationsModule? = null }
@@ -39,6 +39,7 @@ class PusherMessagingService : MessagingService() {
 
   override fun onNewToken(token: String) {
     super.onNewToken(token)
+    NotificationHelper.saveToken(this, token)
     module?.emit("registered", mapOf("deviceToken" to token, "type" to "fcm"))
   }
 }

package/build/ExpoPusherPushNotifications.types.d.ts

@@ -1,14 +1,16 @@
 /**
- * Which Beams auth path the app uses.
+ * Delivery mode.
  *
- * - `interests`: devices subscribe to named interests; your server calls Beams `publishToInterests`.
- * - `users`: the device is bound to a user via `setUserId`; your server calls Beams `publishToUsers`.
+ * - `interests`: Pusher Beams interests. Devices subscribe to named interests; server calls Beams `publishToInterests`.
+ * - `users`: Pusher Beams Authenticated Users. Device is bound to a user via `setUserId`; server calls Beams `publishToUsers`.
+ * - `device`: Raw device-token push. Beams is NOT started. The module obtains the native FCM (Android) /
+ *   APNs (iOS) device token and hands it to you; your server sends directly to FCM / APNs.
  */
-export type PusherTransportMode = 'interests' | 'users';
+export type PusherTransportMode = 'interests' | 'users' | 'device';
 export interface PusherConfig {
-    /** Pusher Beams instance ID. */
-    instanceId: string;
-    /** Beams auth path: `interests` (default) or `users`. */
+    /** Pusher Beams instance ID. Required for `interests` and `users`; ignored for `device`. */
+    instanceId?: string;
+    /** Defaults to `interests`. */
     mode?: PusherTransportMode;
     /** Ask for notification permission (iOS alert/sound/badge, Android 13+ POST_NOTIFICATIONS) during start. Default true. */
     requestPermission?: boolean;
@@ -25,6 +27,13 @@ export interface BeamsTokenProvider {
  * (the b8ne `setUserId(userId, token)` style).
  */
 export type BeamsAuth = BeamsTokenProvider | string;
+export type DevicePushTokenType = 'fcm' | 'apns';
+export interface DevicePushToken {
+    type: DevicePushTokenType;
+    /** FCM registration token (Android) or hex-encoded APNs token (iOS). */
+    token: string;
+    platform: 'android' | 'ios';
+}
 export interface PusherNotification {
     title?: string;
     body?: string;
@@ -33,9 +42,9 @@ export interface PusherNotification {
     appState: 'foreground' | 'background' | 'opened';
 }
 export interface RegisteredEvent {
-    /** Native token the device registered with (FCM on Android, hex APNs on iOS). Beams handles it for you. */
+    /** Native device token. In `device` mode this is the token your server sends to. */
     deviceToken: string;
-    type: 'fcm' | 'apns';
+    type: DevicePushTokenType;
 }
 export interface SubscriptionsChangedEvent {
     interests: string[];

package/build/ExpoPusherPushNotifications.types.d.ts.map

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

package/build/ExpoPusherPushNotifications.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoPusherPushNotifications.types.js","sourceRoot":"","sources":["../src/ExpoPusherPushNotifications.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Which Beams auth path the app uses.\n *\n * - `interests`: devices subscribe to named interests; your server calls Beams `publishToInterests`.\n * - `users`: the device is bound to a user via `setUserId`; your server calls Beams `publishToUsers`.\n */\nexport type PusherTransportMode = 'interests' | 'users';\n\nexport interface PusherConfig {\n  /** Pusher Beams instance ID. */\n  instanceId: string;\n  /** Beams auth path: `interests` (default) or `users`. */\n  mode?: PusherTransportMode;\n  /** Ask for notification permission (iOS alert/sound/badge, Android 13+ POST_NOTIFICATIONS) during start. Default true. */\n  requestPermission?: boolean;\n}\n\n/** Remote token endpoint used by the Beams SDK when binding a device to a user. */\nexport interface BeamsTokenProvider {\n  /** HTTPS endpoint on your backend that returns `{ token: string }`. */\n  url: string;\n  headers?: Record<string, string>;\n  queryParams?: Record<string, string>;\n}\n\n/**\n * User auth: either a remote token provider (recommended), or a pre-fetched Beams token string\n * (the b8ne `setUserId(userId, token)` style).\n */\nexport type BeamsAuth = BeamsTokenProvider | string;\n\nexport interface PusherNotification {\n  title?: string;\n  body?: string;\n  data: Record<string, unknown>;\n  /** `foreground`: received while running; `background`: received in background; `opened`: user tapped it. */\n  appState: 'foreground' | 'background' | 'opened';\n}\n\nexport interface RegisteredEvent {\n  /** Native token the device registered with (FCM on Android, hex APNs on iOS). Beams handles it for you. */\n  deviceToken: string;\n  type: 'fcm' | 'apns';\n}\n\nexport interface SubscriptionsChangedEvent {\n  interests: string[];\n}\n\nexport interface PusherErrorEvent {\n  code: string;\n  message: string;\n}\n\nexport type PermissionStatus = 'granted' | 'denied' | 'undetermined' | 'provisional';\n\nexport type AndroidImportance = 'min' | 'low' | 'default' | 'high' | 'max';\n\nexport interface AndroidNotificationChannel {\n  id: string;\n  name: string;\n  description?: string;\n  importance?: AndroidImportance;\n  /** Bundled sound file name WITHOUT path, e.g. `ding.wav` or `ding`. Must be listed in the plugin's `sounds`. `null` = silent. */\n  sound?: string | null;\n  vibrate?: boolean;\n  lightColor?: string;\n  showBadge?: boolean;\n}\n\nexport interface LocalNotification {\n  title?: string;\n  body?: string;\n  data?: Record<string, string>;\n  /** Bundled sound file name, e.g. `ding.wav`; `default` for system sound. On Android 8+ the channel's sound wins. */\n  sound?: string;\n  /** Android channel id. Defaults to the plugin's default channel. */\n  channelId?: string;\n  /** iOS badge to set with this notification. */\n  badge?: number;\n}\n\nexport interface ScheduledNotification extends LocalNotification {\n  /** Stable id; reuse to replace. Generated if omitted. */\n  id?: string;\n  /** Fire after this many seconds (>= 1). */\n  seconds: number;\n}\n\nexport type ExpoPusherPushNotificationsModuleEvents = {\n  notification: (event: PusherNotification) => void;\n  registered: (event: RegisteredEvent) => void;\n  subscriptionsChanged: (event: SubscriptionsChangedEvent) => void;\n  error: (event: PusherErrorEvent) => void;\n};\n\nexport type PusherEventName = keyof ExpoPusherPushNotificationsModuleEvents;\n"]}
+{"version":3,"file":"ExpoPusherPushNotifications.types.js","sourceRoot":"","sources":["../src/ExpoPusherPushNotifications.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Delivery mode.\n *\n * - `interests`: Pusher Beams interests. Devices subscribe to named interests; server calls Beams `publishToInterests`.\n * - `users`: Pusher Beams Authenticated Users. Device is bound to a user via `setUserId`; server calls Beams `publishToUsers`.\n * - `device`: Raw device-token push. Beams is NOT started. The module obtains the native FCM (Android) /\n *   APNs (iOS) device token and hands it to you; your server sends directly to FCM / APNs.\n */\nexport type PusherTransportMode = 'interests' | 'users' | 'device';\n\nexport interface PusherConfig {\n  /** Pusher Beams instance ID. Required for `interests` and `users`; ignored for `device`. */\n  instanceId?: string;\n  /** Defaults to `interests`. */\n  mode?: PusherTransportMode;\n  /** Ask for notification permission (iOS alert/sound/badge, Android 13+ POST_NOTIFICATIONS) during start. Default true. */\n  requestPermission?: boolean;\n}\n\n/** Remote token endpoint used by the Beams SDK when binding a device to a user. */\nexport interface BeamsTokenProvider {\n  /** HTTPS endpoint on your backend that returns `{ token: string }`. */\n  url: string;\n  headers?: Record<string, string>;\n  queryParams?: Record<string, string>;\n}\n\n/**\n * User auth: either a remote token provider (recommended), or a pre-fetched Beams token string\n * (the b8ne `setUserId(userId, token)` style).\n */\nexport type BeamsAuth = BeamsTokenProvider | string;\n\nexport type DevicePushTokenType = 'fcm' | 'apns';\n\nexport interface DevicePushToken {\n  type: DevicePushTokenType;\n  /** FCM registration token (Android) or hex-encoded APNs token (iOS). */\n  token: string;\n  platform: 'android' | 'ios';\n}\n\nexport interface PusherNotification {\n  title?: string;\n  body?: string;\n  data: Record<string, unknown>;\n  /** `foreground`: received while running; `background`: received in background; `opened`: user tapped it. */\n  appState: 'foreground' | 'background' | 'opened';\n}\n\nexport interface RegisteredEvent {\n  /** Native device token. In `device` mode this is the token your server sends to. */\n  deviceToken: string;\n  type: DevicePushTokenType;\n}\n\nexport interface SubscriptionsChangedEvent {\n  interests: string[];\n}\n\nexport interface PusherErrorEvent {\n  code: string;\n  message: string;\n}\n\nexport type PermissionStatus = 'granted' | 'denied' | 'undetermined' | 'provisional';\n\nexport type AndroidImportance = 'min' | 'low' | 'default' | 'high' | 'max';\n\nexport interface AndroidNotificationChannel {\n  id: string;\n  name: string;\n  description?: string;\n  importance?: AndroidImportance;\n  /** Bundled sound file name WITHOUT path, e.g. `ding.wav` or `ding`. Must be listed in the plugin's `sounds`. `null` = silent. */\n  sound?: string | null;\n  vibrate?: boolean;\n  lightColor?: string;\n  showBadge?: boolean;\n}\n\nexport interface LocalNotification {\n  title?: string;\n  body?: string;\n  data?: Record<string, string>;\n  /** Bundled sound file name, e.g. `ding.wav`; `default` for system sound. On Android 8+ the channel's sound wins. */\n  sound?: string;\n  /** Android channel id. Defaults to the plugin's default channel. */\n  channelId?: string;\n  /** iOS badge to set with this notification. */\n  badge?: number;\n}\n\nexport interface ScheduledNotification extends LocalNotification {\n  /** Stable id; reuse to replace. Generated if omitted. */\n  id?: string;\n  /** Fire after this many seconds (>= 1). */\n  seconds: number;\n}\n\nexport type ExpoPusherPushNotificationsModuleEvents = {\n  notification: (event: PusherNotification) => void;\n  registered: (event: RegisteredEvent) => void;\n  subscriptionsChanged: (event: SubscriptionsChangedEvent) => void;\n  error: (event: PusherErrorEvent) => void;\n};\n\nexport type PusherEventName = keyof ExpoPusherPushNotificationsModuleEvents;\n"]}

package/build/ExpoPusherPushNotificationsModule.d.ts

@@ -1,5 +1,5 @@
 import { NativeModule } from 'expo';
-import type { AndroidNotificationChannel, BeamsTokenProvider, ExpoPusherPushNotificationsModuleEvents, LocalNotification, PermissionStatus, PusherNotification, ScheduledNotification } from './ExpoPusherPushNotifications.types';
+import type { AndroidNotificationChannel, BeamsTokenProvider, DevicePushToken, ExpoPusherPushNotificationsModuleEvents, LocalNotification, PermissionStatus, PusherNotification, ScheduledNotification } from './ExpoPusherPushNotifications.types';
 declare class ExpoPusherPushNotificationsNativeModule extends NativeModule<ExpoPusherPushNotificationsModuleEvents> {
     start(instanceId: string): Promise<void>;
     addDeviceInterest(interest: string): Promise<void>;
@@ -11,6 +11,9 @@ declare class ExpoPusherPushNotificationsNativeModule extends NativeModule<ExpoP
     setUserIdWithToken(userId: string, token: string): Promise<void>;
     clearAllState(): Promise<void>;
     stop(): Promise<void>;
+    registerForDeviceToken(): Promise<DevicePushToken>;
+    getDevicePushToken(): Promise<DevicePushToken | null>;
+    deleteDevicePushToken(): Promise<void>;
     requestPermission(): Promise<PermissionStatus>;
     getPermissionStatus(): Promise<PermissionStatus>;
     createChannel(channel: AndroidNotificationChannel): Promise<void>;

package/build/ExpoPusherPushNotificationsModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoPusherPushNotificationsModule.d.ts","sourceRoot":"","sources":["../src/ExpoPusherPushNotificationsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,KAAK,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,uCAAuC,EACvC,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,OAAO,uCAAwC,SAAQ,YAAY,CAAC,uCAAuC,CAAC;IACjH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACrD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IACtD,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IACvC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3E,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAChE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAC9C,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAEhD,aAAa,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IACjE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxC,WAAW,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAEpD,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAChC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C,wBAAwB,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/D,yBAAyB,CAAC,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IACpE,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACtD,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC;IAChD,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IACxC,sBAAsB,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CAC7D;;AAED,wBAA2G"}
+{"version":3,"file":"ExpoPusherPushNotificationsModule.d.ts","sourceRoot":"","sources":["../src/ExpoPusherPushNotificationsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,KAAK,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,uCAAuC,EACvC,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,OAAO,uCAAwC,SAAQ,YAAY,CAAC,uCAAuC,CAAC;IACjH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACrD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IACtD,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IACvC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3E,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAChE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,sBAAsB,IAAI,OAAO,CAAC,eAAe,CAAC;IAClD,kBAAkB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IACrD,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtC,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAC9C,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAEhD,aAAa,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IACjE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxC,WAAW,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAEpD,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAChC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C,wBAAwB,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/D,yBAAyB,CAAC,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IACpE,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACtD,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC;IAChD,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IACxC,sBAAsB,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CAC7D;;AAED,wBAA2G"}

package/build/ExpoPusherPushNotificationsModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoPusherPushNotificationsModule.js","sourceRoot":"","sources":["../src/ExpoPusherPushNotificationsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AA0CzD,eAAe,mBAAmB,CAA0C,6BAA6B,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from 'expo';\n\nimport type {\n  AndroidNotificationChannel,\n  BeamsTokenProvider,\n  ExpoPusherPushNotificationsModuleEvents,\n  LocalNotification,\n  PermissionStatus,\n  PusherNotification,\n  ScheduledNotification,\n} from './ExpoPusherPushNotifications.types';\n\ndeclare class ExpoPusherPushNotificationsNativeModule extends NativeModule<ExpoPusherPushNotificationsModuleEvents> {\n  start(instanceId: string): Promise<void>;\n  addDeviceInterest(interest: string): Promise<void>;\n  removeDeviceInterest(interest: string): Promise<void>;\n  setDeviceInterests(interests: string[]): Promise<void>;\n  getDeviceInterests(): Promise<string[]>;\n  clearDeviceInterests(): Promise<void>;\n  setUserId(userId: string, tokenProvider: BeamsTokenProvider): Promise<void>;\n  setUserIdWithToken(userId: string, token: string): Promise<void>;\n  clearAllState(): Promise<void>;\n  stop(): Promise<void>;\n  // permissions\n  requestPermission(): Promise<PermissionStatus>;\n  getPermissionStatus(): Promise<PermissionStatus>;\n  // channels (Android; no-ops on iOS)\n  createChannel(channel: AndroidNotificationChannel): Promise<void>;\n  deleteChannel(id: string): Promise<void>;\n  getChannels(): Promise<AndroidNotificationChannel[]>;\n  // badge\n  getBadgeCount(): Promise<number>;\n  setBadgeCount(count: number): Promise<void>;\n  // local\n  presentLocalNotification(n: LocalNotification): Promise<string>;\n  scheduleLocalNotification(n: ScheduledNotification): Promise<string>;\n  cancelScheduledNotification(id: string): Promise<void>;\n  cancelAllScheduledNotifications(): Promise<void>;\n  dismissAllNotifications(): Promise<void>;\n  getInitialNotification(): Promise<PusherNotification | null>;\n}\n\nexport default requireNativeModule<ExpoPusherPushNotificationsNativeModule>('ExpoPusherPushNotifications');\n"]}
+{"version":3,"file":"ExpoPusherPushNotificationsModule.js","sourceRoot":"","sources":["../src/ExpoPusherPushNotificationsModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AA+CzD,eAAe,mBAAmB,CAA0C,6BAA6B,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from 'expo';\n\nimport type {\n  AndroidNotificationChannel,\n  BeamsTokenProvider,\n  DevicePushToken,\n  ExpoPusherPushNotificationsModuleEvents,\n  LocalNotification,\n  PermissionStatus,\n  PusherNotification,\n  ScheduledNotification,\n} from './ExpoPusherPushNotifications.types';\n\ndeclare class ExpoPusherPushNotificationsNativeModule extends NativeModule<ExpoPusherPushNotificationsModuleEvents> {\n  start(instanceId: string): Promise<void>;\n  addDeviceInterest(interest: string): Promise<void>;\n  removeDeviceInterest(interest: string): Promise<void>;\n  setDeviceInterests(interests: string[]): Promise<void>;\n  getDeviceInterests(): Promise<string[]>;\n  clearDeviceInterests(): Promise<void>;\n  setUserId(userId: string, tokenProvider: BeamsTokenProvider): Promise<void>;\n  setUserIdWithToken(userId: string, token: string): Promise<void>;\n  clearAllState(): Promise<void>;\n  stop(): Promise<void>;\n  // device-token mode\n  registerForDeviceToken(): Promise<DevicePushToken>;\n  getDevicePushToken(): Promise<DevicePushToken | null>;\n  deleteDevicePushToken(): Promise<void>;\n  // permissions\n  requestPermission(): Promise<PermissionStatus>;\n  getPermissionStatus(): Promise<PermissionStatus>;\n  // channels (Android; no-ops on iOS)\n  createChannel(channel: AndroidNotificationChannel): Promise<void>;\n  deleteChannel(id: string): Promise<void>;\n  getChannels(): Promise<AndroidNotificationChannel[]>;\n  // badge\n  getBadgeCount(): Promise<number>;\n  setBadgeCount(count: number): Promise<void>;\n  // local\n  presentLocalNotification(n: LocalNotification): Promise<string>;\n  scheduleLocalNotification(n: ScheduledNotification): Promise<string>;\n  cancelScheduledNotification(id: string): Promise<void>;\n  cancelAllScheduledNotifications(): Promise<void>;\n  dismissAllNotifications(): Promise<void>;\n  getInitialNotification(): Promise<PusherNotification | null>;\n}\n\nexport default requireNativeModule<ExpoPusherPushNotificationsNativeModule>('ExpoPusherPushNotifications');\n"]}

package/build/index.d.ts

@@ -1,8 +1,13 @@
 import type { EventSubscription } from 'expo-modules-core';
-import type { AndroidNotificationChannel, BeamsAuth, ExpoPusherPushNotificationsModuleEvents, LocalNotification, PermissionStatus, PusherConfig, PusherEventName, PusherNotification, PusherTransportMode, ScheduledNotification } from './ExpoPusherPushNotifications.types';
+import type { AndroidNotificationChannel, BeamsAuth, DevicePushToken, ExpoPusherPushNotificationsModuleEvents, LocalNotification, PermissionStatus, PusherConfig, PusherEventName, PusherNotification, PusherTransportMode, ScheduledNotification } from './ExpoPusherPushNotifications.types';
 export * from './ExpoPusherPushNotifications.types';
-/** Starts Pusher Beams. */
-export declare function start(config: PusherConfig): Promise<void>;
+/**
+ * Starts the module.
+ * - Pusher Beams (`interests` / `users`): starts the Beams SDK (requires `instanceId`).
+ * - Device token (`device`): does NOT start Beams; registers with FCM/APNs and resolves the raw device token.
+ * Resolves with the device token in `device` mode, otherwise `null`.
+ */
+export declare function start(config: PusherConfig): Promise<DevicePushToken | null>;
 export declare function getMode(): PusherTransportMode;
 export declare function subscribe(interest: string): Promise<void>;
 export declare function unsubscribe(interest: string): Promise<void>;
@@ -11,6 +16,12 @@ export declare function getSubscriptions(): Promise<string[]>;
 export declare function clearSubscriptions(): Promise<void>;
 /** Pass a token provider `{ url, headers?, queryParams? }` or a pre-fetched Beams token string. */
 export declare function setUserId(userId: string, auth: BeamsAuth): Promise<void>;
+/** Registers with FCM/APNs (if needed) and returns the native token. Works in any mode. */
+export declare function registerForDeviceToken(): Promise<DevicePushToken>;
+/** Last known native token, or null if not registered yet. */
+export declare function getDevicePushToken(): Promise<DevicePushToken | null>;
+/** Android: deletes the FCM token (a new one is issued on next register). iOS: unregisters from APNs. */
+export declare function deleteDevicePushToken(): Promise<void>;
 export declare function requestPermission(): Promise<PermissionStatus>;
 export declare function getPermissionStatus(): Promise<PermissionStatus>;
 export declare function createChannel(channel: AndroidNotificationChannel): Promise<void>;
@@ -41,7 +52,7 @@ export declare const Interests: {
     /** Start Beams. */
     readonly start: (instanceId: string, opts?: {
         requestPermission?: boolean;
-    }) => Promise<void>;
+    }) => Promise<undefined>;
     readonly subscribe: typeof subscribe;
     readonly unsubscribe: typeof unsubscribe;
     readonly set: typeof setSubscriptions;
@@ -60,19 +71,35 @@ export declare const Users: {
     /** Start Beams. Call `login()` after your own sign-in. */
     readonly start: (instanceId: string, opts?: {
         requestPermission?: boolean;
-    }) => Promise<void>;
+    }) => Promise<undefined>;
     /** Bind this device to `userId`. `auth` is your token endpoint, or a Beams token you already fetched. */
     readonly login: typeof setUserId;
     /** Unbind the device (call on sign-out). */
     readonly logout: typeof clearAllState;
     readonly stop: typeof stop;
 };
+/**
+ * Mode 3 — **direct FCM / APNs** (no Pusher at all).
+ * Use when your server already talks to FCM HTTP v1 / APNs, or you use another provider.
+ * You get the raw native token; send it to your backend and keep it fresh via the `registered` event.
+ */
+export declare const DeviceToken: {
+    /** Register with FCM/APNs and resolve the native token. */
+    readonly start: (opts?: {
+        requestPermission?: boolean;
+    }) => Promise<DevicePushToken>;
+    readonly get: typeof getDevicePushToken;
+    /** Fires whenever the token is issued or rotated. */
+    readonly onChange: (cb: (token: DevicePushToken) => void) => EventSubscription;
+    /** Delete the token (call on sign-out). */
+    readonly delete: typeof deleteDevicePushToken;
+};
 declare const _default: {
     readonly Interests: {
         /** Start Beams. */
         readonly start: (instanceId: string, opts?: {
             requestPermission?: boolean;
-        }) => Promise<void>;
+        }) => Promise<undefined>;
         readonly subscribe: typeof subscribe;
         readonly unsubscribe: typeof unsubscribe;
         readonly set: typeof setSubscriptions;
@@ -86,13 +113,24 @@ declare const _default: {
         /** Start Beams. Call `login()` after your own sign-in. */
         readonly start: (instanceId: string, opts?: {
             requestPermission?: boolean;
-        }) => Promise<void>;
+        }) => Promise<undefined>;
         /** Bind this device to `userId`. `auth` is your token endpoint, or a Beams token you already fetched. */
         readonly login: typeof setUserId;
         /** Unbind the device (call on sign-out). */
         readonly logout: typeof clearAllState;
         readonly stop: typeof stop;
     };
+    readonly DeviceToken: {
+        /** Register with FCM/APNs and resolve the native token. */
+        readonly start: (opts?: {
+            requestPermission?: boolean;
+        }) => Promise<DevicePushToken>;
+        readonly get: typeof getDevicePushToken;
+        /** Fires whenever the token is issued or rotated. */
+        readonly onChange: (cb: (token: DevicePushToken) => void) => EventSubscription;
+        /** Delete the token (call on sign-out). */
+        readonly delete: typeof deleteDevicePushToken;
+    };
     readonly start: typeof start;
     readonly getMode: typeof getMode;
     readonly subscribe: typeof subscribe;
@@ -101,6 +139,9 @@ declare const _default: {
     readonly getSubscriptions: typeof getSubscriptions;
     readonly clearSubscriptions: typeof clearSubscriptions;
     readonly setUserId: typeof setUserId;
+    readonly registerForDeviceToken: typeof registerForDeviceToken;
+    readonly getDevicePushToken: typeof getDevicePushToken;
+    readonly deleteDevicePushToken: typeof deleteDevicePushToken;
     readonly requestPermission: typeof requestPermission;
     readonly getPermissionStatus: typeof getPermissionStatus;
     readonly createChannel: typeof createChannel;

package/build/index.d.ts.map

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

package/build/index.js

@@ -6,16 +6,31 @@ const PREFIX = 'expo-pusher-push-notifications';
 function assertBeams(fn) {
     if (!started)
         throw new Error(`${PREFIX}: call start() before ${fn}().`);
+    if (currentMode === 'device') {
+        throw new Error(`${PREFIX}: ${fn}() is a Pusher Beams API and is unavailable in 'device' mode.`);
+    }
 }
-/** Starts Pusher Beams. */
+/**
+ * Starts the module.
+ * - Pusher Beams (`interests` / `users`): starts the Beams SDK (requires `instanceId`).
+ * - Device token (`device`): does NOT start Beams; registers with FCM/APNs and resolves the raw device token.
+ * Resolves with the device token in `device` mode, otherwise `null`.
+ */
 export async function start(config) {
-    if (!config.instanceId)
-        throw new Error(`${PREFIX}: instanceId is required.`);
+    const mode = config.mode ?? 'interests';
     if (config.requestPermission !== false)
         await Native.requestPermission();
-    currentMode = config.mode ?? 'interests';
+    currentMode = mode;
+    if (mode === 'device') {
+        const token = await Native.registerForDeviceToken();
+        started = true;
+        return token;
+    }
+    if (!config.instanceId)
+        throw new Error(`${PREFIX}: instanceId is required for '${mode}' mode.`);
     await Native.start(config.instanceId);
     started = true;
+    return null;
 }
 export function getMode() {
     return currentMode;
@@ -50,6 +65,19 @@ export async function setUserId(userId, auth) {
     else
         await Native.setUserId(userId, auth);
 }
+// ---- Mode 3: raw device token (direct FCM / APNs) ----
+/** Registers with FCM/APNs (if needed) and returns the native token. Works in any mode. */
+export async function registerForDeviceToken() {
+    return Native.registerForDeviceToken();
+}
+/** Last known native token, or null if not registered yet. */
+export async function getDevicePushToken() {
+    return Native.getDevicePushToken();
+}
+/** Android: deletes the FCM token (a new one is issued on next register). iOS: unregisters from APNs. */
+export async function deleteDevicePushToken() {
+    await Native.deleteDevicePushToken();
+}
 // ---- Permissions ----
 export function requestPermission() {
     return Native.requestPermission();
@@ -103,10 +131,14 @@ export function getInitialNotification() {
 }
 // ---- Common ----
 export async function clearAllState() {
-    await Native.clearAllState();
+    if (currentMode !== 'device')
+        await Native.clearAllState();
 }
 export async function stop() {
-    await Native.stop();
+    if (currentMode === 'device')
+        await Native.deleteDevicePushToken();
+    else
+        await Native.stop();
     started = false;
 }
 /** Adds an event listener. Events fire for interests and users alike. */
@@ -116,8 +148,8 @@ export function addListener(eventName, listener) {
 /** Alias for `addListener` (old package's `on()`). */
 export const on = addListener;
 // ---------------------------------------------------------------------------
-// Convenience objects. Use either or both; everything else (sounds,
-// channels, badges, local notifications, events) works the same either way.
+// Two paths: Pusher Beams (Interests / Users) or DeviceToken (raw FCM/APNs).
+// Sounds, channels, badges, local notifications and events work on both.
 // ---------------------------------------------------------------------------
 /**
  * Pusher Beams **interests** (topic broadcast).
@@ -126,7 +158,7 @@ export const on = addListener;
  */
 export const Interests = {
     /** Start Beams. */
-    start: (instanceId, opts = {}) => start({ ...opts, instanceId, mode: 'interests' }),
+    start: (instanceId, opts = {}) => start({ ...opts, instanceId, mode: 'interests' }).then(() => undefined),
     subscribe,
     unsubscribe,
     set: setSubscriptions,
@@ -143,18 +175,33 @@ export const Interests = {
  */
 export const Users = {
     /** Start Beams. Call `login()` after your own sign-in. */
-    start: (instanceId, opts = {}) => start({ ...opts, instanceId, mode: 'users' }),
+    start: (instanceId, opts = {}) => start({ ...opts, instanceId, mode: 'users' }).then(() => undefined),
     /** Bind this device to `userId`. `auth` is your token endpoint, or a Beams token you already fetched. */
     login: setUserId,
     /** Unbind the device (call on sign-out). */
     logout: clearAllState,
     stop,
 };
+/**
+ * Mode 3 — **direct FCM / APNs** (no Pusher at all).
+ * Use when your server already talks to FCM HTTP v1 / APNs, or you use another provider.
+ * You get the raw native token; send it to your backend and keep it fresh via the `registered` event.
+ */
+export const DeviceToken = {
+    /** Register with FCM/APNs and resolve the native token. */
+    start: async (opts = {}) => (await start({ ...opts, mode: 'device' })),
+    get: getDevicePushToken,
+    /** Fires whenever the token is issued or rotated. */
+    onChange: (cb) => addListener('registered', ({ deviceToken, type }) => cb({ token: deviceToken, type, platform: type === 'fcm' ? 'android' : 'ios' })),
+    /** Delete the token (call on sign-out). */
+    delete: deleteDevicePushToken,
+};
 export default {
-    Interests, Users,
+    Interests, Users, DeviceToken,
     start, getMode,
     subscribe, unsubscribe, setSubscriptions, getSubscriptions, clearSubscriptions,
     setUserId,
+    registerForDeviceToken, getDevicePushToken, deleteDevicePushToken,
     requestPermission, getPermissionStatus,
     createChannel, deleteChannel, getChannels,
     getBadgeCount, setBadgeCount, incrementBadgeCount,

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from 'expo-modules-core';\n\nimport Native from './ExpoPusherPushNotificationsModule';\nimport type {\n  AndroidNotificationChannel,\n  BeamsAuth,\n  ExpoPusherPushNotificationsModuleEvents,\n  LocalNotification,\n  PermissionStatus,\n  PusherConfig,\n  PusherEventName,\n  PusherNotification,\n  PusherTransportMode,\n  ScheduledNotification,\n} from './ExpoPusherPushNotifications.types';\n\nexport * from './ExpoPusherPushNotifications.types';\n\nlet currentMode: PusherTransportMode = 'interests';\nlet started = false;\n\nconst PREFIX = 'expo-pusher-push-notifications';\n\nfunction assertBeams(fn: string): void {\n  if (!started) throw new Error(`${PREFIX}: call start() before ${fn}().`);\n}\n\n/** Starts Pusher Beams. */\nexport async function start(config: PusherConfig): Promise<void> {\n  if (!config.instanceId) throw new Error(`${PREFIX}: instanceId is required.`);\n  if (config.requestPermission !== false) await Native.requestPermission();\n  currentMode = config.mode ?? 'interests';\n  await Native.start(config.instanceId);\n  started = true;\n}\n\nexport function getMode(): PusherTransportMode {\n  return currentMode;\n}\n\n// ---- Interests (topics) ----\nexport async function subscribe(interest: string): Promise<void> {\n  assertBeams('subscribe');\n  await Native.addDeviceInterest(interest);\n}\nexport async function unsubscribe(interest: string): Promise<void> {\n  assertBeams('unsubscribe');\n  await Native.removeDeviceInterest(interest);\n}\nexport async function setSubscriptions(interests: string[]): Promise<void> {\n  assertBeams('setSubscriptions');\n  await Native.setDeviceInterests(interests);\n}\nexport async function getSubscriptions(): Promise<string[]> {\n  assertBeams('getSubscriptions');\n  return Native.getDeviceInterests();\n}\nexport async function clearSubscriptions(): Promise<void> {\n  assertBeams('clearSubscriptions');\n  await Native.clearDeviceInterests();\n}\n\n// ---- Bind a device to a user ----\n/** Pass a token provider `{ url, headers?, queryParams? }` or a pre-fetched Beams token string. */\nexport async function setUserId(userId: string, auth: BeamsAuth): Promise<void> {\n  assertBeams('setUserId');\n  if (typeof auth === 'string') await Native.setUserIdWithToken(userId, auth);\n  else await Native.setUserId(userId, auth);\n}\n\n// ---- Permissions ----\nexport function requestPermission(): Promise<PermissionStatus> {\n  return Native.requestPermission();\n}\nexport function getPermissionStatus(): Promise<PermissionStatus> {\n  return Native.getPermissionStatus();\n}\n\n// ---- Android notification channels (no-ops on iOS) ----\nexport function createChannel(channel: AndroidNotificationChannel): Promise<void> {\n  return Native.createChannel(channel);\n}\nexport function deleteChannel(id: string): Promise<void> {\n  return Native.deleteChannel(id);\n}\nexport function getChannels(): Promise<AndroidNotificationChannel[]> {\n  return Native.getChannels();\n}\n\n// ---- Badge ----\nexport function getBadgeCount(): Promise<number> {\n  return Native.getBadgeCount();\n}\nexport function setBadgeCount(count: number): Promise<void> {\n  return Native.setBadgeCount(Math.max(0, Math.floor(count)));\n}\nexport async function incrementBadgeCount(by = 1): Promise<number> {\n  const next = (await Native.getBadgeCount()) + by;\n  await setBadgeCount(next);\n  return Math.max(0, next);\n}\n\n// ---- Local notifications ----\nexport function presentLocalNotification(n: LocalNotification): Promise<string> {\n  return Native.presentLocalNotification(n);\n}\nexport function scheduleLocalNotification(n: ScheduledNotification): Promise<string> {\n  if (!(n.seconds >= 1)) throw new Error(`${PREFIX}: seconds must be >= 1.`);\n  return Native.scheduleLocalNotification(n);\n}\nexport function cancelScheduledNotification(id: string): Promise<void> {\n  return Native.cancelScheduledNotification(id);\n}\nexport function cancelAllScheduledNotifications(): Promise<void> {\n  return Native.cancelAllScheduledNotifications();\n}\nexport function dismissAllNotifications(): Promise<void> {\n  return Native.dismissAllNotifications();\n}\n/** The notification whose tap launched the app (cold start), if any. */\nexport function getInitialNotification(): Promise<PusherNotification | null> {\n  return Native.getInitialNotification();\n}\n\n// ---- Common ----\nexport async function clearAllState(): Promise<void> {\n  await Native.clearAllState();\n}\nexport async function stop(): Promise<void> {\n  await Native.stop();\n  started = false;\n}\n\n/** Adds an event listener. Events fire for interests and users alike. */\nexport function addListener<E extends PusherEventName>(\n  eventName: E,\n  listener: ExpoPusherPushNotificationsModuleEvents[E]\n): EventSubscription {\n  return Native.addListener(eventName, listener);\n}\n/** Alias for `addListener` (old package's `on()`). */\nexport const on = addListener;\n\n// ---------------------------------------------------------------------------\n// Convenience objects. Use either or both; everything else (sounds,\n// channels, badges, local notifications, events) works the same either way.\n// ---------------------------------------------------------------------------\n\n/**\n * Pusher Beams **interests** (topic broadcast).\n * Use when many devices should get the same push: \"news\", \"order-42\", \"team-7\".\n * Server: `beams.publishToInterests([...], payload)`.\n */\nexport const Interests = {\n  /** Start Beams. */\n  start: (instanceId: string, opts: { requestPermission?: boolean } = {}) =>\n    start({ ...opts, instanceId, mode: 'interests' }),\n  subscribe,\n  unsubscribe,\n  set: setSubscriptions,\n  get: getSubscriptions,\n  clear: clearSubscriptions,\n  /** Forget everything (call on logout). */\n  reset: clearAllState,\n  stop,\n} as const;\n\n/**\n * Pusher Beams **authenticated users** (push to a person, across all their devices).\n * Use when your backend thinks in user ids: \"send to user-123\".\n * Server: `beams.publishToUsers(['user-123'], payload)` + a token endpoint (`beams.generateToken`).\n */\nexport const Users = {\n  /** Start Beams. Call `login()` after your own sign-in. */\n  start: (instanceId: string, opts: { requestPermission?: boolean } = {}) =>\n    start({ ...opts, instanceId, mode: 'users' }),\n  /** Bind this device to `userId`. `auth` is your token endpoint, or a Beams token you already fetched. */\n  login: setUserId,\n  /** Unbind the device (call on sign-out). */\n  logout: clearAllState,\n  stop,\n} as const;\n\nexport default {\n  Interests, Users,\n  start, getMode,\n  subscribe, unsubscribe, setSubscriptions, getSubscriptions, clearSubscriptions,\n  setUserId,\n  requestPermission, getPermissionStatus,\n  createChannel, deleteChannel, getChannels,\n  getBadgeCount, setBadgeCount, incrementBadgeCount,\n  presentLocalNotification, scheduleLocalNotification, cancelScheduledNotification,\n  cancelAllScheduledNotifications, dismissAllNotifications, getInitialNotification,\n  clearAllState, stop, addListener, on,\n} as const;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from 'expo-modules-core';\n\nimport Native from './ExpoPusherPushNotificationsModule';\nimport type {\n  AndroidNotificationChannel,\n  BeamsAuth,\n  DevicePushToken,\n  ExpoPusherPushNotificationsModuleEvents,\n  LocalNotification,\n  PermissionStatus,\n  PusherConfig,\n  PusherEventName,\n  PusherNotification,\n  PusherTransportMode,\n  ScheduledNotification,\n} from './ExpoPusherPushNotifications.types';\n\nexport * from './ExpoPusherPushNotifications.types';\n\nlet currentMode: PusherTransportMode = 'interests';\nlet started = false;\n\nconst PREFIX = 'expo-pusher-push-notifications';\n\nfunction assertBeams(fn: string): void {\n  if (!started) throw new Error(`${PREFIX}: call start() before ${fn}().`);\n  if (currentMode === 'device') {\n    throw new Error(`${PREFIX}: ${fn}() is a Pusher Beams API and is unavailable in 'device' mode.`);\n  }\n}\n\n/**\n * Starts the module.\n * - Pusher Beams (`interests` / `users`): starts the Beams SDK (requires `instanceId`).\n * - Device token (`device`): does NOT start Beams; registers with FCM/APNs and resolves the raw device token.\n * Resolves with the device token in `device` mode, otherwise `null`.\n */\nexport async function start(config: PusherConfig): Promise<DevicePushToken | null> {\n  const mode = config.mode ?? 'interests';\n  if (config.requestPermission !== false) await Native.requestPermission();\n  currentMode = mode;\n  if (mode === 'device') {\n    const token = await Native.registerForDeviceToken();\n    started = true;\n    return token;\n  }\n  if (!config.instanceId) throw new Error(`${PREFIX}: instanceId is required for '${mode}' mode.`);\n  await Native.start(config.instanceId);\n  started = true;\n  return null;\n}\n\nexport function getMode(): PusherTransportMode {\n  return currentMode;\n}\n\n// ---- Interests (topics) ----\nexport async function subscribe(interest: string): Promise<void> {\n  assertBeams('subscribe');\n  await Native.addDeviceInterest(interest);\n}\nexport async function unsubscribe(interest: string): Promise<void> {\n  assertBeams('unsubscribe');\n  await Native.removeDeviceInterest(interest);\n}\nexport async function setSubscriptions(interests: string[]): Promise<void> {\n  assertBeams('setSubscriptions');\n  await Native.setDeviceInterests(interests);\n}\nexport async function getSubscriptions(): Promise<string[]> {\n  assertBeams('getSubscriptions');\n  return Native.getDeviceInterests();\n}\nexport async function clearSubscriptions(): Promise<void> {\n  assertBeams('clearSubscriptions');\n  await Native.clearDeviceInterests();\n}\n\n// ---- Bind a device to a user ----\n/** Pass a token provider `{ url, headers?, queryParams? }` or a pre-fetched Beams token string. */\nexport async function setUserId(userId: string, auth: BeamsAuth): Promise<void> {\n  assertBeams('setUserId');\n  if (typeof auth === 'string') await Native.setUserIdWithToken(userId, auth);\n  else await Native.setUserId(userId, auth);\n}\n\n// ---- Mode 3: raw device token (direct FCM / APNs) ----\n/** Registers with FCM/APNs (if needed) and returns the native token. Works in any mode. */\nexport async function registerForDeviceToken(): Promise<DevicePushToken> {\n  return Native.registerForDeviceToken();\n}\n/** Last known native token, or null if not registered yet. */\nexport async function getDevicePushToken(): Promise<DevicePushToken | null> {\n  return Native.getDevicePushToken();\n}\n/** Android: deletes the FCM token (a new one is issued on next register). iOS: unregisters from APNs. */\nexport async function deleteDevicePushToken(): Promise<void> {\n  await Native.deleteDevicePushToken();\n}\n\n// ---- Permissions ----\nexport function requestPermission(): Promise<PermissionStatus> {\n  return Native.requestPermission();\n}\nexport function getPermissionStatus(): Promise<PermissionStatus> {\n  return Native.getPermissionStatus();\n}\n\n// ---- Android notification channels (no-ops on iOS) ----\nexport function createChannel(channel: AndroidNotificationChannel): Promise<void> {\n  return Native.createChannel(channel);\n}\nexport function deleteChannel(id: string): Promise<void> {\n  return Native.deleteChannel(id);\n}\nexport function getChannels(): Promise<AndroidNotificationChannel[]> {\n  return Native.getChannels();\n}\n\n// ---- Badge ----\nexport function getBadgeCount(): Promise<number> {\n  return Native.getBadgeCount();\n}\nexport function setBadgeCount(count: number): Promise<void> {\n  return Native.setBadgeCount(Math.max(0, Math.floor(count)));\n}\nexport async function incrementBadgeCount(by = 1): Promise<number> {\n  const next = (await Native.getBadgeCount()) + by;\n  await setBadgeCount(next);\n  return Math.max(0, next);\n}\n\n// ---- Local notifications ----\nexport function presentLocalNotification(n: LocalNotification): Promise<string> {\n  return Native.presentLocalNotification(n);\n}\nexport function scheduleLocalNotification(n: ScheduledNotification): Promise<string> {\n  if (!(n.seconds >= 1)) throw new Error(`${PREFIX}: seconds must be >= 1.`);\n  return Native.scheduleLocalNotification(n);\n}\nexport function cancelScheduledNotification(id: string): Promise<void> {\n  return Native.cancelScheduledNotification(id);\n}\nexport function cancelAllScheduledNotifications(): Promise<void> {\n  return Native.cancelAllScheduledNotifications();\n}\nexport function dismissAllNotifications(): Promise<void> {\n  return Native.dismissAllNotifications();\n}\n/** The notification whose tap launched the app (cold start), if any. */\nexport function getInitialNotification(): Promise<PusherNotification | null> {\n  return Native.getInitialNotification();\n}\n\n// ---- Common ----\nexport async function clearAllState(): Promise<void> {\n  if (currentMode !== 'device') await Native.clearAllState();\n}\nexport async function stop(): Promise<void> {\n  if (currentMode === 'device') await Native.deleteDevicePushToken();\n  else await Native.stop();\n  started = false;\n}\n\n/** Adds an event listener. Events fire for interests and users alike. */\nexport function addListener<E extends PusherEventName>(\n  eventName: E,\n  listener: ExpoPusherPushNotificationsModuleEvents[E]\n): EventSubscription {\n  return Native.addListener(eventName, listener);\n}\n/** Alias for `addListener` (old package's `on()`). */\nexport const on = addListener;\n\n// ---------------------------------------------------------------------------\n// Two paths: Pusher Beams (Interests / Users) or DeviceToken (raw FCM/APNs).\n// Sounds, channels, badges, local notifications and events work on both.\n// ---------------------------------------------------------------------------\n\n/**\n * Pusher Beams **interests** (topic broadcast).\n * Use when many devices should get the same push: \"news\", \"order-42\", \"team-7\".\n * Server: `beams.publishToInterests([...], payload)`.\n */\nexport const Interests = {\n  /** Start Beams. */\n  start: (instanceId: string, opts: { requestPermission?: boolean } = {}) =>\n    start({ ...opts, instanceId, mode: 'interests' }).then(() => undefined),\n  subscribe,\n  unsubscribe,\n  set: setSubscriptions,\n  get: getSubscriptions,\n  clear: clearSubscriptions,\n  /** Forget everything (call on logout). */\n  reset: clearAllState,\n  stop,\n} as const;\n\n/**\n * Pusher Beams **authenticated users** (push to a person, across all their devices).\n * Use when your backend thinks in user ids: \"send to user-123\".\n * Server: `beams.publishToUsers(['user-123'], payload)` + a token endpoint (`beams.generateToken`).\n */\nexport const Users = {\n  /** Start Beams. Call `login()` after your own sign-in. */\n  start: (instanceId: string, opts: { requestPermission?: boolean } = {}) =>\n    start({ ...opts, instanceId, mode: 'users' }).then(() => undefined),\n  /** Bind this device to `userId`. `auth` is your token endpoint, or a Beams token you already fetched. */\n  login: setUserId,\n  /** Unbind the device (call on sign-out). */\n  logout: clearAllState,\n  stop,\n} as const;\n\n/**\n * Mode 3 — **direct FCM / APNs** (no Pusher at all).\n * Use when your server already talks to FCM HTTP v1 / APNs, or you use another provider.\n * You get the raw native token; send it to your backend and keep it fresh via the `registered` event.\n */\nexport const DeviceToken = {\n  /** Register with FCM/APNs and resolve the native token. */\n  start: async (opts: { requestPermission?: boolean } = {}): Promise<DevicePushToken> =>\n    (await start({ ...opts, mode: 'device' })) as DevicePushToken,\n  get: getDevicePushToken,\n  /** Fires whenever the token is issued or rotated. */\n  onChange: (cb: (token: DevicePushToken) => void): EventSubscription =>\n    addListener('registered', ({ deviceToken, type }) =>\n      cb({ token: deviceToken, type, platform: type === 'fcm' ? 'android' : 'ios' })\n    ),\n  /** Delete the token (call on sign-out). */\n  delete: deleteDevicePushToken,\n} as const;\n\nexport default {\n  Interests, Users, DeviceToken,\n  start, getMode,\n  subscribe, unsubscribe, setSubscriptions, getSubscriptions, clearSubscriptions,\n  setUserId,\n  registerForDeviceToken, getDevicePushToken, deleteDevicePushToken,\n  requestPermission, getPermissionStatus,\n  createChannel, deleteChannel, getChannels,\n  getBadgeCount, setBadgeCount, incrementBadgeCount,\n  presentLocalNotification, scheduleLocalNotification, cancelScheduledNotification,\n  cancelAllScheduledNotifications, dismissAllNotifications, getInitialNotification,\n  clearAllState, stop, addListener, on,\n} as const;\n"]}

package/docs/api.md

@@ -1,19 +1,20 @@
 # Full API
 
-`Interests` and `Users` are thin wrappers over these flat functions. Use whichever you like. The flat ones are kept for people coming from the old packages.
+`Interests`, `Users` and `DeviceToken` are thin wrappers over these flat functions. Use whichever you like. The flat ones are kept for people coming from the old packages.
 
 | Function | Used for | Notes |
 |---|---|---|
-| `start({ instanceId, mode?, requestPermission? })` | everything | `mode` (optional) is the Beams auth path: `interests` (default) or `users`. |
+| `start({ instanceId?, mode?, requestPermission? })` | everything | `mode`: `interests` (default) or `users` for Beams, `device` for a raw token (no `instanceId`). Resolves the token in `device` mode, otherwise `null`. |
 | `getMode()` | everything | |
 | `subscribe` / `unsubscribe` / `setSubscriptions` / `getSubscriptions` / `clearSubscriptions` | interests | Work on both platforms. |
 | `setUserId(userId, { url, headers?, queryParams? } \| token)` | binding a user | |
+| `registerForDeviceToken()` / `getDevicePushToken()` / `deleteDevicePushToken()` | device token | |
 | `requestPermission()` / `getPermissionStatus()` | everything | |
 | `createChannel` / `deleteChannel` / `getChannels` | Android only | |
 | `getBadgeCount` / `setBadgeCount` / `incrementBadgeCount` | everything | |
 | `presentLocalNotification` / `scheduleLocalNotification` / `cancelScheduledNotification` / `cancelAllScheduledNotifications` / `dismissAllNotifications` | everything | |
 | `getInitialNotification()` | everything | |
-| `clearAllState()` / `stop()` | everything | |
+| `clearAllState()` / `stop()` | everything | In `device` mode, `stop()` deletes the device token. |
 | `addListener(event, cb)` / `on(event, cb)` | everything | Return an `EventSubscription`. |
 
 

package/docs/direct.md

@@ -0,0 +1,42 @@
+# Device token (raw FCM / APNs, no Beams)
+
+**Use this when** your app has its own push path: your backend (or another provider) sends to FCM and APNs directly.
+No Beams instance needed. You get the raw native token and do what you want with it.
+
+## Client
+
+```ts
+import { DeviceToken } from 'expo-pusher-push-notifications';
+
+const token = await DeviceToken.start();
+// { type: 'fcm', platform: 'android', token: 'dYz…' }
+// { type: 'apns', platform: 'ios', token: 'a1b2…' }
+await api.saveDevice(token);
+
+// Tokens rotate. Keep your backend in sync.
+DeviceToken.onChange((t) => api.saveDevice(t));
+
+await DeviceToken.get();    // last known token, or null
+await DeviceToken.delete(); // on sign-out
+```
+
+Calling a Beams function (`Interests.*`, `Users.*`) in this mode throws.
+
+## Sending
+
+Your backend stores the token and sends to FCM (Android) or APNs (iOS) itself. This module only gets the token and shows the notifications it receives; it doesn't need Beams, `expo-notifications`, or EAS.
+
+Data-only FCM messages with `title`/`body` in `data` (plus optional `sound`, `android_channel_id`, `incrementBadge: "true"`) are shown with the right channel and sound, including in the background.
+
+## API
+
+| Call | What it does |
+|---|---|
+| `DeviceToken.start({ requestPermission? })` | Registers with FCM/APNs, resolves the token. |
+| `DeviceToken.get()` | Last known token or `null`. |
+| `DeviceToken.onChange(cb)` | Fires when the token is issued or rotated. |
+| `DeviceToken.delete()` | Android: FCM `deleteToken`. iOS: unregister. |
+
+
+---
+[← Back to README](../README.md)

package/docs/migrating.md

@@ -19,9 +19,9 @@ Here is what the ZeptInc and b8ne packages had, and where it lives now:
 
 Neither original had custom sounds, notification channels, or local and scheduled notifications. Those are new here.
 
-## Coming from 0.3
+## Coming from 0.4
 
-0.4 removes raw device-token support (`DeviceToken`, `registerForDeviceToken`, `getDevicePushToken`, `deleteDevicePushToken`, and `mode: 'device'`). This package is Pusher Beams only now. If you need a raw FCM / APNs token, use [`expo-notifications`](https://docs.expo.dev/versions/latest/sdk/notifications/) and `getDevicePushTokenAsync()` instead.
+0.5 brings back device-token support (`DeviceToken`, `registerForDeviceToken`, `getDevicePushToken`, `deleteDevicePushToken`, and `mode: 'device'`), same API as 0.3. Beams code from 0.4 keeps working unchanged.
 
 ## Steps
 

package/docs/setup.md

@@ -37,8 +37,8 @@ Then run `npx expo prebuild` and build a development build. Expo Go cannot load
 
 | Option | Default | What it does |
 |---|---|---|
-| `mode` | `interests` | Which Beams auth path your app uses: `interests`, or `users` if you bind devices to signed-in users. Written to Info.plist and the manifest. You can leave it out. |
-| `instanceId` | none | Beams instance ID. |
+| `mode` | `interests` | `interests` or `users` for Beams, or `device` for a raw device token. Written to Info.plist and the manifest. You can leave it out. |
+| `instanceId` | none | Beams instance ID. Not needed for `device`. |
 | `apsEnvironment` | `development` | Sets the `aps-environment` entitlement. Use `production` for TestFlight and App Store builds. |
 | `sounds` | `[]` | Sound files to bundle. **Android:** copied to `res/raw` with names lower-cased to `[a-z0-9_]`. **iOS:** copied into the app target and added to its resources. iOS needs `.wav`, `.caf`, or `.aiff` under 30 s. |
 | `androidChannels` | `[]` | Channels created at startup. Set `sound` to a file name from `sounds`, or `null` for a silent channel. |
@@ -51,7 +51,7 @@ The plugin also adds the `remote-notification` background mode on iOS. On Androi
 
 1. **iOS:** enable the Push Notifications capability. The plugin sets the entitlement. Create an APNs auth key (.p8).
 2. **Android:** create a Firebase project, download `google-services.json`, and point `android.googleServicesFile` at it.
-3. **Beams:** create a Beams instance in the [Pusher dashboard](https://dashboard.pusher.com/beams), then upload your APNs key and your FCM service account to it.
+3. **Beams path only:** create a Beams instance in the [Pusher dashboard](https://dashboard.pusher.com/beams), then upload your APNs key and your FCM service account to it.
 
 ## Permissions
 

package/ios/ExpoPusherPushNotificationsModule.swift

@@ -26,6 +26,7 @@ struct LocalNotificationRecord: Record {
 public class ExpoPusherPushNotificationsModule: Module {
   private let beams = PushNotifications.shared
   private var beamsStarted = false
+  private var tokenWaiters: [Promise] = []
   private var initialNotification: [String: Any]?
   private lazy var centerDelegate = NotificationCenterDelegate(module: self)
 
@@ -39,6 +40,8 @@ public class ExpoPusherPushNotificationsModule: Module {
       ExpoPusherAppDelegateSubscriber.onTokenError = { [weak self] error in
         guard let self = self else { return }
         self.sendEvent("error", ["code": "E_APNS_REGISTRATION", "message": error.localizedDescription])
+        let waiters = self.tokenWaiters; self.tokenWaiters = []
+        waiters.forEach { $0.reject("E_APNS_REGISTRATION", error.localizedDescription) }
       }
       ExpoPusherAppDelegateSubscriber.onNotification = { [weak self] userInfo, state in
         self?.handleRemote(userInfo, state: state)
@@ -84,6 +87,22 @@ public class ExpoPusherPushNotificationsModule: Module {
       self.beams.stop { self.beamsStarted = false; promise.resolve(nil) }
     }
 
+    // ---- Raw device token (APNs) ----
+    AsyncFunction("registerForDeviceToken") { (promise: Promise) in
+      if let token = ExpoPusherAppDelegateSubscriber.lastToken {
+        promise.resolve(Self.tokenDict(token)); return
+      }
+      self.tokenWaiters.append(promise)
+      DispatchQueue.main.async { UIApplication.shared.registerForRemoteNotifications() }
+    }
+    AsyncFunction("getDevicePushToken") { () -> [String: Any]? in
+      ExpoPusherAppDelegateSubscriber.lastToken.map(Self.tokenDict)
+    }
+    AsyncFunction("deleteDevicePushToken") {
+      ExpoPusherAppDelegateSubscriber.lastToken = nil
+      DispatchQueue.main.async { UIApplication.shared.unregisterForRemoteNotifications() }
+    }
+
     // ---- Permissions ----
     AsyncFunction("requestPermission") { (promise: Promise) in
       UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound, .badge]) { _, _ in
@@ -130,8 +149,10 @@ public class ExpoPusherPushNotificationsModule: Module {
 
   private func handleToken(_ token: Data) {
     if beamsStarted { beams.registerDeviceToken(token) }
-    let hex = token.map { String(format: "%02x", $0) }.joined()
-    sendEvent("registered", ["deviceToken": hex, "type": "apns"])
+    let dict = Self.tokenDict(token)
+    sendEvent("registered", ["deviceToken": dict["token"]!, "type": "apns"])
+    let waiters = tokenWaiters; tokenWaiters = []
+    waiters.forEach { $0.resolve(dict) }
   }
 
   fileprivate func handleRemote(_ userInfo: [AnyHashable: Any], state: String) {
@@ -176,6 +197,10 @@ public class ExpoPusherPushNotificationsModule: Module {
     return UNNotificationSound(named: UNNotificationSoundName(rawValue: name))
   }
 
+  static func tokenDict(_ token: Data) -> [String: Any] {
+    ["type": "apns", "platform": "ios", "token": token.map { String(format: "%02x", $0) }.joined()]
+  }
+
   static func payload(userInfo: [AnyHashable: Any], state: String) -> [String: Any] {
     let alertAny = (userInfo["aps"] as? [String: Any])?["alert"]
     let alert = alertAny as? [String: Any]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "expo-pusher-push-notifications",
-  "version": "0.4.2",
-  "description": "Pusher Beams push notifications for Expo (interests and authenticated users), with custom sounds, Android channels, badges and local notifications",
+  "version": "0.5.0",
+  "description": "Push notifications for Expo: Pusher Beams (interests / users) or raw FCM/APNs device tokens (no EAS needed), with custom sounds, channels, badges and local notifications",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "scripts": {
@@ -24,7 +24,8 @@
     "push-notifications",
     "config-plugin",
     "fcm",
-    "apns"
+    "apns",
+    "device-token"
   ],
   "repository": "https://github.com/baraa-rasheed/expo-pusher-push-notifications",
   "bugs": {

package/plugin/build/index.d.ts

@@ -10,12 +10,12 @@ export interface PusherPluginChannel {
     showBadge?: boolean;
 }
 export interface PusherPluginProps {
-    /** Pusher Beams instance ID. */
+    /** Pusher Beams instance ID (not needed for `device` mode). */
     instanceId?: string;
     /** APNs environment for the aps-environment entitlement. Defaults to "development". */
     apsEnvironment?: 'development' | 'production';
-    /** Beams auth path written to native config (`interests` or `users`). Defaults to "interests". */
-    mode?: 'interests' | 'users';
+    /** Default mode written to native config. Defaults to "interests". */
+    mode?: 'interests' | 'users' | 'device';
     /**
      * Sound files (paths relative to the project root) to bundle. Android: copied to res/raw
      * (lower-cased, must be [a-z0-9_]). iOS: added to the main bundle. Use .wav/.caf/.aiff for iOS (<30s).