@repo/firebase-admin-adapter

Adaptador server-side para Firebase Admin (Auth, Firestore y Storage).

1. Funcion del package

• Encapsular acceso administrativo a Firebase.
• Exponer funciones reutilizables para backends, route handlers y server actions.
• Unificar tipos y contratos de acceso.

2. API publica

Exporta modulos de:

• Auth (core, verification, claims, tenant-auth, user)
• Firestore (core, document, collection, aggregates, transactions, field-value)
• Storage (core, upload, delete-file, get-file-url)
• Helpers (server-timestamp, getAdminAppCheckInstance)

3. Lineamientos de desarrollo

1. Este package solo debe usarse en server.
2. Validar input/output con tipos o Zod cuando aplique.
3. Mantener funciones idempotentes cuando sea posible.

4. Buenas practicas

• Separar funciones por dominio en carpetas (auth, firestore, storage).
• No mezclar reglas de UI con capa de infraestructura.
• Reutilizar tipos SDK exportados por el package.

5. Como contribuir

pnpm lint --filter @repo/firebase-admin-adapter
pnpm build --filter @repo/firebase-admin-adapter
pnpm type-check --filter @repo/firebase-admin-adapter
pnpm test --filter @repo/firebase-admin-adapter

Actualizar este README al agregar nuevos modulos exportados.

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

Para un adapter server adicional (ejemplo: cola de jobs), crear package aparte desde 01-base-package y mantener boundaries claras.