🏠 Overview › 🧩 Components ›🧩 FirebaseMessagingClient

FirebaseMessagingClient

Component Detail

Infrastructure medium complexity backendmobile
0
Dependencies
0
Dependents
0
Entities
0
Integrations

Description

Thin infrastructure wrapper around the Firebase Cloud Messaging SDK for sending push notification payloads to registered device tokens. Abstracts FCM-specific API details from PushNotificationService and manages device token registration and refresh lifecycle.

Feature: Push Notifications

firebase-messaging-client

Sources & reasoning

Notifications is a named bottom-nav tab (line 290), establishing it as a first-class MVP surface. HLF follow-up dissatisfaction data (line 116) confirms urgency. Blueprint marks push-notifications [MVP]. First phase ordinal = MVP.

  • Bottom nav with 5 tabs: Home, Contacts, Add (modal launcher for Activity and Event wizards), Work, Notifications
  • Oppfølging av likepersoner: 40 % var ikke fornøyd med oppfølgingen i spørreundersøkelse. Scenariobaserte push-meldinger og kalendersynkronisering.

Responsibilities

  • Send push notification payloads to individual or batched device tokens via FCM
  • Register and refresh device tokens on app launch and token rotation events
  • Handle FCM error codes and surface delivery failures to the service layer
  • Support topic-based messaging for role-targeted broadcast notifications

Interfaces

sendToDevice(token: string, payload: FcmPayload): Promise<FcmResult>
sendToTopic(topic: string, payload: FcmPayload): Promise<FcmResult>
registerDeviceToken(userId: string, token: string): Promise<void>
refreshDeviceToken(oldToken: string, newToken: string): Promise<void>