Firebase

packages/firebase/README.md

@repo/firebase

Configuracion compartida de Firebase para entorno local y utilidades comunes.

1. Funcion del package

  • Exponer endpoints de emuladores (EMULATORS).
  • Aplicar automaticamente variables de entorno para Admin SDK en desarrollo.

API principal:

  • EMULATORS
  • applyAdminEmulatorsIfDev()

2. Ejemplo de uso

ts
import { applyAdminEmulatorsIfDev } from '@repo/firebase/emulators';

applyAdminEmulatorsIfDev();

3. Lineamientos de desarrollo

  1. Mantener este package sin dependencias de UI.
  2. Centralizar solo configuraciones transversales.
  3. Evitar logica de negocio; eso va en adapters o services.

4. Buenas practicas

  • Usar este package como fuente unica de puertos/hosts de emuladores.
  • No hardcodear puertos Firebase en apps.

5. Como contribuir

  1. Agregar utilidades en src/.
  2. Exportar desde src/index.ts.
  3. Ejecutar:
bash
pnpm build --filter @repo/firebase

6. Crear package nuevo basado en 01-base-package

Si necesitas un modulo Firebase con responsabilidades distintas (por ejemplo observabilidad), crear package propio desde 01-base-package y mantener este package enfocado en configuracion compartida.