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

  1. Mantener interfaces orientadas a cliente/browser.
  2. Evitar dependencias de Node-only APIs.
  3. 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.