Expo Notifications Channel

The Expo channel allows you to send push notifications to mobile devices through Expo's push notification service. This channel is perfect for React Native applications built with Expo. It uses the Expo Push Notifications API (expo-server-sdk).

Batching

This channel supports batching with a maximum of 100 messages per batch. Opt in with .to(users).useDriverBatching().send(); normal bulk sends call the channel individually.

Configuration

import { createFacteur } from '@facteurjs/core'
import { expoChannel } from '@facteurjs/core/channels/expo'

export const facteur = createFacteur({
  discoverer: { searchDirectory: new URL('./notifications/', import.meta.url) },
  channels: {
    expo: expoChannel(),
  },
})

Configuration Options

The configuration accepts ExpoClientOptions from the installed expo-server-sdk, including accessToken, httpAgent and maxConcurrentRequests. It has no apiUrl option.

Current limitation: the channel validates accessToken using Expo.isExpoPushToken(), even though an access token is not a device push token. Authenticated Expo delivery needs a code fix; do not assume a valid access token will be accepted.

All configuration options are optional. The channel works out of the box without any configuration.

SDK version compatibility

Facteur supports expo-server-sdk 3.15 and later 3.x releases, as well as versions 4, 5, 6, and 7. Upgrading the SDK is optional; existing installations can keep their current supported version.

• useFcmV1 is only available in SDK versions 3 and 4. Remove it when upgrading to version 5 or later; FCM v1 is always used.
• httpAgent accepts a Node.js http.Agent in SDK versions 3 and 4, and an Undici Dispatcher in version 5 or later. Update custom agents when upgrading.
• SDK versions 6 and 7 are ESM-only. Version 7 requires Node.js 22.12 or later.

Targets

The Expo channel requires an Expo push token for the target device:

await facteur
  .notification(MyNotification)
  .via({
    expo: {
      // Expo push token (required)
      expoToken: 'ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]',
    },
  })
  .send()

Target Properties

• expoToken (required): A valid Expo push token obtained from the client device

Expo Push Token Format

Expo push tokens have a specific format:

• Format: ExponentPushToken[...] or ExpoPushToken[...]
• The channel forwards the target token to the Expo SDK; it does not independently validate targets.expoToken.

Message Features

When creating notifications for Expo, you can use rich push notification features:

import { Notification } from '@facteurjs/core/types'
import { ExpoMessage } from '@facteurjs/core/channels/expo'

export default class ExpoNotification extends Notification<undefined> {
  asExpoMessage() {
    return ExpoMessage.create()
      .setTitle('Notification Title')
      .setBody('This is the notification body')
      .setData({ customData: 'value' })
      .setSound('default')
      .setBadge(1)
      .setPriority('high')
      .setChannelId('default')
  }
}