Support database upgrades in `Database.open`

js/modules/database.js

@@ -4,18 +4,31 @@
 // and using promises. Revisit use of `idb` dependency as it might cover
 // this functionality.
 
-const { isObject } = require('lodash');
+const { isObject, isNumber } = require('lodash');
 
 
-exports.open = (name, version) => {
+exports.open = (name, version, { onUpgradeNeeded } = {}) => {
   const request = indexedDB.open(name, version);
   return new Promise((resolve, reject) => {
     request.onblocked = () =>
       reject(new Error('Database blocked'));
 
-    request.onupgradeneeded = event =>
-      reject(new Error('Unexpected database upgrade required:' +
-        ` oldVersion: ${event.oldVersion}, newVersion: ${event.newVersion}`));
+    request.onupgradeneeded = (event) => {
+      const hasRequestedSpecificVersion = isNumber(version);
+      if (!hasRequestedSpecificVersion) {
+        return;
+      }
+
+      const { newVersion, oldVersion } = event;
+      if (onUpgradeNeeded) {
+        const { transaction } = event.target;
+        onUpgradeNeeded({ oldVersion, transaction });
+        return;
+      }
+
+      reject(new Error('Database upgrade required:' +
+        ` oldVersion: ${oldVersion}, newVersion: ${newVersion}`));
+    };
 
     request.onerror = event =>
       reject(event.target.error);

js/modules/migrations/migrations_0_database_with_attachment_data.js

@@ -147,8 +147,15 @@ const database = {
   migrations,
 };
 
-exports.run = ({ Backbone } = {}) =>
-  runMigrations({ Backbone, database });
+exports.run = ({ Backbone, databaseName } = {}) =>
+  runMigrations({
+    Backbone,
+    database: Object.assign(
+      {},
+      database,
+      isString(databaseName) ? { id: databaseName } : {}
+    ),
+  });
 
 exports.getDatabase = () => ({
   name: database.id,