firebase-module

✨ New

* Firebase Auth in Universal Mode: Added functionality that automatically creates a cookie that gets sent to the server in the initial request that can be used for server-side authentication
* getAuthUserFromCookie() Helper: Added helper that supports parsing the cookie into an authUser object

For more information refer to the updated documentation.

⚙️ Maintenance

• Docs: Split up Helpers & Advanced in two categories

✨ New

• Added new option functions.emulatorPort (https://github.com/lupas/nuxt-fire/issues/64):
  This option sets up useFunctionsEmulator(...) to test Cloud Functions locally. More information here.

Thanks to @Ferrasil for the suggestion.

✨ New

• New Options: Added static, preload & chunkName options to all services. See documentation.
• Chunk Names: In development mode, dynamically imported chunks are now named vendors.firebase-${serviceName}.js by default.

🐜 Bug Fixes

• Fixed bug that all services were loaded instead of just the activated ones.

⚙️ Maintenance

• Code refactoring, updated ES-Lint

✨ New

• Firestore: You can now enable persistence by simply setting the enablePersistance option to true:

firestore: {
  enablePersistence: true
}

See: https://nuxtfire.netlify.com/guide/options/#firestore

☘️ Small Improvements

• Added types to context.app and context.store (#61)

Thanks to @aaharu for the PR.

⚙️ Maintenance

• Updated peerDependency and service-worker version of the Firebase SDK from v7.4.0 to v7.5.0

🐜 Bug Fixes

• messaging/createServiceWorker:
  Fixed missing path in path.resolve() to generate the service-worker file in the static folder in all cases.

Thanks to @dr3tt for the PR. 👍

Hi there 👋

We made quite some changes to nuxt-fire with this update, mostly under the hood by restructuring the entire repository structure, but also some changes in the config that will affect you and need action from your side.

In the long run, we believe these changes will make life with nuxt-fire easier, so we hope you appreciate the changes.

‼️ Breaking 1

New layout of the options object and addition of new options.

We got rid of the useOnly option. Services must now be enabled via the services object like so:

services: {
   auth: true,
   firestore: true
   // ... and so on
}

Make sure to re-configure your nuxt.config.js according to the new layout of the nuxt-fire options as you can see in our beautiful new updated Documentation.

‼️ Breaking 2

Since we updated the folder structure of the entire repository, you might get a Nuxt Fatal error when updating to v3.0.0.

To solve this, simple remove your package.json.lock and node_modules folder and do a clean install of your modules with npm install.

‼️ Breaking 3

Helper functions now need to be imported from 'nuxt-fire/src/helpers' instead of 'nuxt-fire/helpers'

Changes

✨ Improvements

• Improved error handling (#5)
• The helper movePluginBeforeInitAuthPlugin(plugins, pluginName) now also accepts plugin arrays that contain just plugin name strings, not only the objects. (#55)
• The messaging service worker can now load stripts directly from Firebase Hosting via the onFirebaseHosting flag.
• Using a different package.json for our docs and the main module eliminates the need for installing docs dependencies with the main module.

⚙️ Maintenance

• Complete revamp of the folder structure & files of this repository.
• Various small and big updates in documentation and README's.

✨ New

• Easier Setup: If you only use one environment / Firebase project, you wont have to specify your Firebase Config for production and development anymore! Simply add your configuration to the config objects without wrapping it in an environment objects, and you're good to go!

Old (still supported)

config: {
  production: {
    apiKey: '<apiKey>',
    authDomain: '<authDomain>',
    databaseURL: '<databaseURL>',
    projectId: '<projectId>',
    storageBucket: '<storageBucket>',
    messagingSenderId: '<messagingSenderId>',
    appId: '<appId>',
    measurementId: '<measurementId>'
  },
  development: {
    apiKey: '<apiKey>',
    authDomain: '<authDomain>',
    databaseURL: '<databaseURL>',
    projectId: '<projectId>',
    storageBucket: '<storageBucket>',
    messagingSenderId: '<messagingSenderId>',
    appId: '<appId>',
    measurementId: '<measurementId>'
  }
}

New

config: {
  apiKey: '<apiKey>',
  authDomain: '<authDomain>',
  databaseURL: '<databaseURL>',
  projectId: '<projectId>',
  storageBucket: '<storageBucket>',
  messagingSenderId: '<messagingSenderId>',
  appId: '<appId>',
  measurementId: '<measurementId>'
}

⚙️ Maintenance

• Improved firebase-messaging-sw.js
• Added more documentation for messagingInit config

✨ New

• When fcmPublicVapidKeyis added to config[environment|, the method messaging.usePublicVapidKey(key) gets called by nuxt-fire after FCM initialization - so you can delete it from your code and don't have to handle different keys for different environments yourself.

⚙️ Maintenance

• Bugfixes in initMessaging functionality

✨ New (Experimental)

• Added the initMessaging feature that, for now, helps you create the service-worker file for FCM. Additional functionality, such as automatic initialization, is to come.

‼️ Important: This feature has not been fully tested for all cases, use it with care. It might get changed completely in future updates. Use it at your own risk. If you have any issues with the initMessaging feature please let us know here and help us improve it.

⚙️ Maintenance

• Small fixes in movePluginBeforeInitAuthPlugin() helper.

✨ New (Experimental)

• Added the initAuth feature that lets you set up onAuthStateChanged() for Firebase Authentication without writing any boilerplate code by simply providing the names of the vuex mutations/actions that shall be called.
• Added helper function movePluginBeforeInitAuthPlugin .

‼️ Important: This feature has not been fully tested for all cases, use it with care. It might get changed completely in future updates. If you have any issues with the initAuth feature please let us know here and help us improve it.

⚙️ Maintenance

• Updated Folder Structure

‼️ Important: Since we updated the folder structure in this update, you might get a Nuxt Fatal error of the following kind when updating to v2.4.0. To solve this, simple remove your package.json.lock and node_modules folder and do a clean install of your modules with npm i.

✖ Nuxt Fatal Error
Error: Template src not found:
/Users/<path>/node_modules/nuxt-fire/plugin.js

• Added support for Firebase RemoteConfig (Beta).

Thanks to @fachrihawari for the PR.

• Added Firebase Performance to TypeScript definition

Thanks to @fachrihawari for the PR.

Starting with v.2.2.0, nuxt-fire uses dynamic import() as mentioned in this video from the Firebase Summit 2019, which should lead to faster page loads.

✨ Improvement

• Added Firebase Analytics accessible via this.$fireAnalytics and this.$fireAnalyticsObj.

Thanks to @lesharris again for the contribution!

✨ Improvement

• Added check for Firebase Messaging whether it is supported by browser or not before instantiating.

Thanks to @lesharris for the pull request!