n8n-nodes-firestore
v1.6.1
Published
Your complete Cloud Firestore toolkit for n8n. Go beyond simple CRUD with powerful search operations, wildcard queries, and real-time triggers featuring built-in data validation. Handles native data types like Timestamps and GeoPoints seamlessly.
Readme
🔥 n8n Firebase (Firestore & Storage) Node
🚀 Seu toolkit completo Firebase para n8n
- CRUD avançado e queries dinâmicas no Cloud Firestore
- Upload de arquivos binários direto para o Firebase Storage
- Triggers em tempo real com filtros inteligentes
- Tratamento nativo de tipos de dados e serialização JSON
Tudo em um único pacote usando apenas uma credencial de Service Account.
✨ Core Features
🔹 1. Action Node (Firestore & Storage)
Gerencie tanto banco de dados quanto arquivos em um único node.
📂 Firestore (Database):
- Create: Criação de documentos (ID automático ou customizado).
- Read: Leitura de documentos com suporte a
Timestamps,GeoPointseReferences. - Update: Atualização parcial de campos.
- Delete: Exclusão permanente.
- Advanced Search: Queries complexas com UI dinâmica (Strings, Números, Booleans, Datas, Referências etc.).
🗂️ Firebase Storage (Files):
- Upload File: Upload binário direto do n8n.
- Geração automática de Download Token (UUID).
- Retorna a URL pública oficial
firebasestorage.googleapis.com.
🔹 2. Real-Time Trigger Node (Firestore)
- On Document Created: dispara ao criar um documento.
- On Document Modified: dispara ao alterar um documento específico.
- On Collection Modified: dispara quando qualquer documento da coleção é alterado.
🔹 3. Advanced Features (Diferenciais)
- ⚡ Wildcard Collection Group Search: busque em todos os sub-collections (
parentCollection/{}/subCollectionName). - 🛡️ Trigger Filtering: evite ruídos! Adicione filtros nos triggers para rodar o fluxo só se o documento atender às condições.
- 🔄 Error Handling Inteligente: detecta erros de índice (
FAILED_PRECONDITION) e mostra a URL de criação automática no próprio n8n. - 📐 Native Data Type Handling: converte tipos Firestore para JSON legível (
Timestamp → ISO,GeoPoint → {lat, lon},DocumentReference → string path). - 🔗 Nested Path Support: suporte a dot notation (
user.address.city) em filtros e triggers.
⚙️ Instalação
Requisito: além do @google-cloud/firestore, este node requer @google-cloud/storage. A instalação via npm cuida disso automaticamente.
✅ 1. Instalação via n8n Community (Recomendada)
- Acesse sua instância do n8n.
- Vá em Settings > Community Nodes.
- Clique em Install a community node.
- Informe o nome do pacote:
