Firebase Client Adapter
packages/firebase-client-adapter/README.md
@repo/firebase-client-adapter
Adaptador client-side para Firebase en aplicaciones web.
1. Funcion del package
- Centralizar integraciones de cliente para Auth, Firestore, Storage y Functions.
- Evitar que cada app implemente wrappers propios.
- Exponer tipos y helpers reutilizables.
2. API publica
Exporta:
- Firestore (
core,document,collection,snapshots,aggregates) - Storage (
upload,metadata,get-file-url,upload-file-with-progress,delete-file) - Auth (
core,auth-user,sign-in,observer,password-reset,account) - Functions (
core,callable-functions,constants-functions)
3. Lineamientos de desarrollo
- Mantener interfaces orientadas a cliente/browser.
- Evitar dependencias de Node-only APIs.
- Mantener wrappers pequeños y composables.
4. Buenas practicas
- Encapsular detalles del SDK en funciones de alto nivel.
- Exponer tipos junto con helpers para reducir errores de uso.
5. Como contribuir
bash
pnpm lint --filter @repo/firebase-client-adapter
pnpm build --filter @repo/firebase-client-adapter
pnpm type-check --filter @repo/firebase-client-adapter
pnpm test --filter @repo/firebase-client-adapter
6. Crear package nuevo basado en 01-base-package
Si aparece un cliente especializado (por ejemplo analytics), iniciar package dedicado desde 01-base-package.