firebase-engine

firebase-engine

Unlock Peak Performance for Your Firebase Project: A Dynamic Engine for Effortless Backup, Thorough Cleaning, and Seamless Restoration. Tailored for Firebase Firestore, Firebase Storage, and Firebase Auth. Streamline Your Workflow with Unrivaled Efficiency!

Install

 npm i firebase-engine -g

Launch parameters

Name	Short name	Description
operations	o	backup (b), restore (r) or clean (c). Default: backup
path	p	Path to service account JSON file
services	s	firestore (f), storage (s), auth (a), can be separated by commas. Default: all
backup	b	Path to backup or restore file. Default: ./{$PROJECT_ID + $TIMESTAMP}.backup
collections	coll	Apply to Collections (in Firestore service). Default: all, if it is not set
buckets	buck	Apply to Buckets (in Storage service). Default: all, if it is not set
--nocompress	-nc	Do not use data compression
--emulators	-em	Use firebase emulators (work for firestore)

• collections - the rule also applies to all nested collections and documents

Launch parameters (only for password recovery for users in Firebase.Auth)

Name	Short name	Description
algorithm	alg	The password hashing information (algorithm, only SCRYPT). Default: SCRYPT
base64_signer_key	bsk	The password hashing information (key in base64 encoding). Default: user passwords are not restored if not set.
base64_salt_separator	bss	The password hashing information (salt separator in base64). Default: Bw==
rounds	rnd	The password hashing information (rounds). Default: 8
mem_cost	mc	The password hashing information (memory cost). Default: 14

Use

With full names

 firebase-engine operations="clean, restore" path="./test.json" services="firestore, storage" backup="test.backup"

With one bucket

 firebase-engine operations="clean" path="./test.json" services="storage" buckets="test.appspott.com"

With collection & subcollection

 firebase-engine operations="backup" path="./test.json" services="firestore" collections="authors,books.pages"

With short names and use emulators

 firebase-engine o="b, c" s="f" p="./test.json" b="test.backup" -em

With password recovery for users

 firebase-engine operations="restore" path="./test.json" services="firestore, auth" backup="test.backup" bsk="nMyNs6sFWp0GZ/JSW2tsNGvGZ70oiv13gxO7ub7rxPwK271P945BiZmjrdsBRbgZmzPPgwATLR6FaXq3rUspVg=="

Copy data from project to emulators or from emulators to project

Name	Short name	Description
--to-emulators	-to	Copy data from project to emulators (only firestore)
--from-emulators	-from	Copy data from emulators to project (only firestore)
path	p	Path to service account JSON file

With full names

 firebase-engine-emulators path="./test.json" --to-emulators

With short names

 firebase-engine-emulators p="./test.json" -from

Open Source

See source docs

See source

Service Account Key

Get your service account key from IAM Open google IAM

Or from the FIREBASE project Open official firebase docs

WARNING (Password hashes of users)

Firebase API also returns the passwordSalt and passwordHash hashed by the Firebase Auth backend for password users if the user/service account used to generate the request OAuth access token has the firebaseauth.configs.getHashConfig permission. Otherwise the passwordHash and passwordSalt will not be set. Open official firebase docs

WARNING (restoration of subcollections)

I recommend using only the top collection level in the collections parameter. Because you can get shadow document by restoring a subcollection in a non-existent document. To a full database cleanup, including shadow documents, use the command in firebase tools

 firebase firestore:delete -r

LICENSE

Apache-2.0