Push Notifications

Visión general

Las notificaciones push se gestionan mediante expo-notifications (v0.31.4), con un servicio singleton que encapsula toda la funcionalidad.

Servicio de notificaciones

El servicio singleton se encuentra en src/modules/profile/services/notificationsService.ts y expone los siguientes métodos:

Método	Descripción
`getPermissionStatus()`	Consulta el estado actual de permisos de notificación
`requestPermissions()`	Solicita permisos de notificación al usuario
`getExpoPushToken()`	Obtiene el push token de Expo para el dispositivo
`setAppBadgeCount(count)`	Establece el número del badge de la app
`clearAppBadge()`	Limpia el badge de la app (equivale a `setAppBadgeCount(0)`)

Permisos
Push token
Badge

import { notificationsService } from '@/modules/profile/services/notificationsService';

// Consultar estado actual
const status = await notificationsService.getPermissionStatus();

// Solicitar permisos
const granted = await notificationsService.requestPermissions();

import { notificationsService } from '@/modules/profile/services/notificationsService';

// Obtener el token para registrar en el backend
const token = await notificationsService.getExpoPushToken();

import { notificationsService } from '@/modules/profile/services/notificationsService';

// Establecer badge
await notificationsService.setAppBadgeCount(5);

// Limpiar badge
await notificationsService.clearAppBadge();

Configuración iOS

Habilitado

Alertas - Badges - Sonidos - Display en CarPlay

Deshabilitado

Critical alerts - Provisional permissions

Comportamiento de notificación mostrada

Cuando la app está en primer plano y llega una notificación, se aplica la siguiente configuración:

Propiedad	Valor	Descripción
Alertas/banners	Habilitado	Se muestran alertas visuales
Sonido	Deshabilitado	Sin sonido en la notificación individual
Badge	Deshabilitado	No actualiza el badge por notificación individual
Lista de notificaciones	Visible	Aparece en la lista de notificaciones del sistema

La configuración de badge deshabilitado en notificaciones individuales significa que el badge se gestiona manualmente a través del servicio, no automáticamente por cada notificación recibida.

Deep linking desde notificaciones

Las notificaciones push pueden contener un campo deep_link en sus datos. Cuando el usuario toca la notificación, el enlace se procesa a través del linkingService para navegar a la pantalla correspondiente.

// Estructura de datos de una notificación con deep link
{
  title: "Nueva reserva",
  body: "Tienes una nueva reserva pendiente",
  data: {
    deep_link: "/stays/123/details"
  }
}

El deep link se rutea a través del linkingService, que se encarga de validar la ruta y manejar casos donde el usuario no está autenticado (preservando el deep link para después del login).

Plugin en app.config.ts

La configuración del plugin de expo-notifications en app.config.ts:

Parámetro	Valor
Canal por defecto	`"default"`
Background remote notifications	Deshabilitado

plugins: [
  [
    'expo-notifications',
    {
      defaultChannel: 'default',
      // Background remote notifications deshabilitado
    },
  ],
],

Integración con linkingService

El flujo completo de una notificación push con deep link es:

El dispositivo recibe la notificación push
El usuario toca la notificación
Se extraen los datos de deep_link del payload
El linkingService recibe la ruta
Si el usuario está autenticado, se navega directamente
Si no está autenticado, el deep link se preserva y se ejecuta después del login

Archivos clave

Archivo	Responsabilidad
`src/modules/profile/services/notificationsService.ts`	Servicio singleton de notificaciones
`app.config.ts`	Configuración del plugin expo-notifications

Overview

Architecture

Modules

Shared

Integrations

Guides

Visión general

Servicio de notificaciones

Configuración iOS

Habilitado

Deshabilitado

Comportamiento de notificación mostrada

Deep linking desde notificaciones

Plugin en app.config.ts

Integración con linkingService

Archivos clave

​Visión general

​Servicio de notificaciones

​Configuración iOS

Habilitado

Deshabilitado

​Comportamiento de notificación mostrada

​Deep linking desde notificaciones

​Plugin en app.config.ts

​Integración con linkingService

​Archivos clave

Visión general

Servicio de notificaciones

Configuración iOS

Comportamiento de notificación mostrada

Deep linking desde notificaciones

Plugin en app.config.ts

Integración con linkingService

Archivos clave