npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

firestore-backup-restore

v1.3.1

Published

Google Firebase Firestore backup and restore tool

Downloads

43

Readme

firestore-backup-restore

A Google Firebase Firestore backup and restore tool. This project was forked from https://github.com/steadyequipment/node-firestore-backup.git and extended.

You can backup your Firestore documents to disk, clone data from one Firestore to another, and restore from disk.

Installation

Install using npm.

npm install -g firestore-backup-restore

or yarn

yarn global add firestore-backup-restore

or on the fly

npx firestore-backup-restore

Alternatively download the source.

git clone https://github.com/willhlaw/node-firestore-backup-restore/commits/master

Retrieving Google Cloud Account Credentials

  1. Visit the Firebase Console
  2. Select your project
  3. Navigate to Project Settings (at the time of writing the gear icon button at the top left of the page).
  4. Navigate to Service Accounts
  5. Click Generate New Private Key

This downloaded json file contains the proper credentials needed for firestore-backup-restore to authenticate.

Usage

Options:

Usage: firestore-backup-restore [options]

Options:

  • -V, --version output the version number
  • -a, --accountCredentials <path> Google Cloud account credentials JSON file.
  • -B, --backupPath <path> Path to store backup.
  • -a2, --restoreAccountCredentials <path> Google Cloud account credentials JSON file for restoring documents.
  • -P, --prettyPrint JSON backups done with pretty-printing.
  • -S, --stable JSON backups done with stable-stringify.
  • -J, --plainJSONBackup JSON backups done without preserving any type information. - Lacks full fidelity restore to Firestore. - Can be used for other export purposes.
  • -h, --help output usage information

Backup:

Retrieves data from Firestore specified in accountCredentials and saves files to backupPath.

As of version 1.2, the default is to save files with each field converted to a {value, type} object so that the type information can be preserved and used when restoring to Firestore. Otherwise, a timestamp or reference would be restored as a string. See -J or --plainJSONBackup to change this default behavior.

Example backup:

firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase

Clone:

Move data from Firestore in accountCredentials to Firestore specified in accountRestoreCredentials.

As of version 1.2, this process still requires --backupPath option. This may be a simple change and tested. In fact, there is an issue marked good first issue to fix this if there are any takers.

Example clone:

firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase --restoreAccountCredentials path/to/restore/credentials/file.json

Restore:

If a backup has already been performed, then later, you can restore the backup in --backupPath to Firestore specified in --restoreAccountCredentials.

Example restore:

firestore-backup-restore --backupPath /backups/myDatabase --restoreAccountCredentials path/to/restore/credentials/file.json

Backup with pretty printing:

If you want the documents to look pretty on disk and don't mind giving up extra disk space, then use the --prettyPrint option.

  • -P, --prettyPrint - JSON backups done with pretty-printing.

Example:

firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase --prettyPrint

Backup with stable stringify:

If you want the json documents to have sorted keys, then use the --stable option.

  • -S, --stable - JSON backups done with stable-stringify.

Example:

firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase --stable

Backup without type information as plain JSON documents:

To change the default behavior and backup the Firestore documents as plain JSON documents, use --plainJSONBackup.

The default is to save type information. In order for restore to work with full fidelity for field types and to work with clone for references to be changed from the original Firestore to the destination Firestore, then documents need to be saved to disk in a format that preserves the type information (that is gleaned through inspection by constructDocumentObjectToBackup during save). If this default behavior is not wanted and you want the regular JSON document to be saved to disk instead, then use --plainJSONBackup.

  • -J, --plainJSONBackup - JSON backups done without preserving any type information
    • Lacks full fidelity restore to Firestore
    • Can be used for other export purposes

Example:

firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase --plainJSONBackup

Document saved with -J or --plainJSONBackup option:

{
  name: 'UserCreationError',
  type: 'error',
  // undefined fields are ignored for Firestore types
  fooWillBeIgnored: undefined,
  message: {
    code: 'ValidationError',
    _embedded: {
      errors: [
        {
          _links: {},
          code: 'NotAllowed',
          path: '/dateOfBirth',
          message: 'DateOfBirth value not allowed.'
        }
      ]
    },
    message:
      'Validation error(s) present. See embedded errors list for more details.'
  },
  status: 'read',
  identifier: 'provider'
};

Document saved with type information (Default)

{
  name: { value: 'UserCreationError', type: 'string' },
  type: { value: 'error', type: 'string' },
  message: {
    value: {
      code: { value: 'ValidationError', type: 'string' },
      _embedded: {
        value: {
          errors: {
            value: [
              {
                value: {
                  path: { value: '/dateOfBirth', type: 'string' },
                  message: {
                    value: 'DateOfBirth value not allowed.',
                    type: 'string'
                  },
                  _links: { value: {}, type: 'object' },
                  code: { value: 'NotAllowed', type: 'string' }
                },
                type: 'object'
              }
            ],
            type: 'array'
          }
        },
        type: 'object'
      },
      message: {
        value:
          'Validation error(s) present. See embedded errors list for more details.',
        type: 'string'
      }
    },
    type: 'object'
  },
  status: { value: 'read', type: 'string' },
  identifier: { value: 'provider', type: 'string' }

Contributions

Feel free to report bugs in the Issue Tracker, fork and create pull requests!