necessary 11.8.5 → 11.9.2

package/README.md

@@ -22,6 +22,7 @@ These can be used both on Node and in the browser:
 * [Path utilities](#path-utilities)
 * [Array utilities](#array-utilities)
 * [HTTP utilities](#http-utilities)
+* [Version utilities](#version-utilities)
 * [Template utilities](#template-utilities)
 * [Asynchronous utilities](#asynchronous-utilities)
 
@@ -834,6 +835,78 @@ urlFromHostURIAndQuery(host, uri, query); // returns "https://site.com/user?name
 
 Ideally the `host` argument should not include a trailing forward slash whereas `uri` arguments should always start with a leading forward slash.
 
+## Version utilities
+
+- `migrate()`
+
+A single `migrate()` function to handle the migration of JSON files with a required `version` entry. This function can be used in conjunction with the configuration utilities but does not have to be.
+
+* The `migrate` function takes `json`, `migrationMap` and `latestVersion` arguments. The easiest way to demonstrate its use is by an extensive example.
+
+Your application should maintain a list of version numbers. A new version number should be used every time the format of the requisite JSON file needs to be migrated:
+
+```
+const VERSION_1_5 = "1.5",
+      VERSION_2_0 = "2.0",
+      VERSION_5_0 = "5.0",
+      VERSION_5_1 = "5.1";
+
+module.exports = {
+  VERSION_1_5,
+  VERSION_2_0,
+  VERSION_5_0,
+  VERSION_5_1
+};
+```
+
+These version numbers, together with their corresponding migration functions should then be required or imported for use by the function that handles the migration:
+
+```
+const { migrateConfigurationToVersion_2_0 } = require("./configuration/version_2_0"),
+      { migrateConfigurationToVersion_5_0 } = require("./configuration/version_5_0"),
+      { migrateConfigurationToVersion_5_1 } = require("./configuration/version_5_1"),
+      { VERSION_1_5, VERSION_2_0, VERSION_5_0, VERSION_5_1 } = require("./versions");
+```
+
+A map must then be created that is passed to the `migrate()` function along with the JSON and the latest version:
+
+```
+function migrateConfigurationFile() {
+  let json = readRCFile();
+
+  const migrationMap = {
+          [ VERSION_1_5 ]: migrateConfigurationToVersion_2_0,
+          [ VERSION_2_0 ]: migrateConfigurationToVersion_5_0,
+          [ VERSION_5_0 ] :migrateConfigurationToVersion_5_1
+        },
+        latestVersion = VERSION_5_1;
+
+  json = migrate(json, migrationMap, latestVersion);
+
+  writeRCFile(json);
+}
+```
+
+Note carefully the matching of the keys to their corresponding values. Each key matches the version that the `migrate()` function finds in the JSON. It therefore must apply the requisite migration function to migrate the JSON to the next version. 
+
+Lastly, the migration function must have the prescribed signature and return the migrated JSON. Again an example will suffice:
+
+```
+const { VERSION_2_0 } = require("../versions");
+
+function migrateConfigurationToVersion_2_0(configuration) {
+  const version = VERSION_2_0;
+
+  Object.assign(configuration, {
+    version
+  });
+
+  return configuration;
+}
+```
+
+In this admittedly somewhat trivial example, all the migration function does is to update the version number. Exactly how the JSON otherwise changes is immaterial but the version number must be updated in this way otherwise the `migrate()` function will loop indefinitely.
+
 ## Template utilities
 
 - `parseFile()`

package/lib/browser.js

@@ -48,6 +48,9 @@ _export(exports, {
     arrayUtilities: function() {
         return _array.default;
     },
+    versionUtilities: function() {
+        return _version.default;
+    },
     asynchronousUtilities: function() {
         return _asynchronous.default;
     }
@@ -65,6 +68,7 @@ var _ajax = /*#__PURE__*/ _interop_require_default(require("./utilities/ajax"));
 var _path = /*#__PURE__*/ _interop_require_default(require("./utilities/path"));
 var _http = /*#__PURE__*/ _interop_require_default(require("./utilities/http"));
 var _array = /*#__PURE__*/ _interop_require_default(require("./utilities/array"));
+var _version = /*#__PURE__*/ _interop_require_default(require("./utilities/version"));
 var _asynchronous = /*#__PURE__*/ _interop_require_default(require("./utilities/asynchronous"));
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
@@ -72,4 +76,4 @@ function _interop_require_default(obj) {
     };
 }
 
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uL3NyYy9icm93c2VyLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5leHBvcnQgeyBkZWZhdWx0IGFzIGxldmVscyB9IGZyb20gXCIuL2xldmVsc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBtZXRob2RzIH0gZnJvbSBcIi4vbWV0aG9kc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBoZWFkZXJzIH0gZnJvbSBcIi4vaGVhZGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBrZXlDb2RlcyB9IGZyb20gXCIuL2tleUNvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGVuY29kaW5ncyB9IGZyb20gXCIuL2VuY29kaW5nc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjaGFyYWN0ZXJzIH0gZnJvbSBcIi4vY2hhcmFjdGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNDb2RlcyB9IGZyb20gXCIuL3N0YXR1c0NvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGNvbnRlbnRUeXBlcyB9IGZyb20gXCIuL2NvbnRlbnRUeXBlc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNNZXNzYWdlcyB9IGZyb20gXCIuL3N0YXR1c01lc3NhZ2VzXCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgYWpheFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hamF4XCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGF0aFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYXRoXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGh0dHBVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvaHR0cFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhcnJheVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hcnJheVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhc3luY2hyb25vdXNVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvYXN5bmNocm9ub3VzXCI7XG4iXSwibmFtZXMiOlsibGV2ZWxzIiwibWV0aG9kcyIsImhlYWRlcnMiLCJrZXlDb2RlcyIsImVuY29kaW5ncyIsImNoYXJhY3RlcnMiLCJzdGF0dXNDb2RlcyIsImNvbnRlbnRUeXBlcyIsInN0YXR1c01lc3NhZ2VzIiwiYWpheFV0aWxpdGllcyIsInBhdGhVdGlsaXRpZXMiLCJodHRwVXRpbGl0aWVzIiwiYXJyYXlVdGlsaXRpZXMiLCJhc3luY2hyb25vdXNVdGlsaXRpZXMiXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7OztJQUVvQkEsTUFBTTtlQUFOQSxlQUFNOztJQUNOQyxPQUFPO2VBQVBBLGdCQUFPOztJQUNQQyxPQUFPO2VBQVBBLGdCQUFPOztJQUNQQyxRQUFRO2VBQVJBLGlCQUFROztJQUNSQyxTQUFTO2VBQVRBLGtCQUFTOztJQUNUQyxVQUFVO2VBQVZBLG1CQUFVOztJQUNWQyxXQUFXO2VBQVhBLG9CQUFXOztJQUNYQyxZQUFZO2VBQVpBLHFCQUFZOztJQUNaQyxjQUFjO2VBQWRBLHVCQUFjOztJQUVkQyxhQUFhO2VBQWJBLGFBQWE7O0lBRWJDLGFBQWE7ZUFBYkEsYUFBYTs7SUFDYkMsYUFBYTtlQUFiQSxhQUFhOztJQUNiQyxjQUFjO2VBQWRBLGNBQWM7O0lBQ2RDLHFCQUFxQjtlQUFyQkEscUJBQXFCOzs7NkRBZlA7OERBQ0M7OERBQ0E7K0RBQ0M7Z0VBQ0M7aUVBQ0M7a0VBQ0M7bUVBQ0M7cUVBQ0U7MkRBRUQ7MkRBRUE7MkRBQ0E7NERBQ0M7bUVBQ08ifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uL3NyYy9icm93c2VyLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5leHBvcnQgeyBkZWZhdWx0IGFzIGxldmVscyB9IGZyb20gXCIuL2xldmVsc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBtZXRob2RzIH0gZnJvbSBcIi4vbWV0aG9kc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBoZWFkZXJzIH0gZnJvbSBcIi4vaGVhZGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBrZXlDb2RlcyB9IGZyb20gXCIuL2tleUNvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGVuY29kaW5ncyB9IGZyb20gXCIuL2VuY29kaW5nc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjaGFyYWN0ZXJzIH0gZnJvbSBcIi4vY2hhcmFjdGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNDb2RlcyB9IGZyb20gXCIuL3N0YXR1c0NvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGNvbnRlbnRUeXBlcyB9IGZyb20gXCIuL2NvbnRlbnRUeXBlc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNNZXNzYWdlcyB9IGZyb20gXCIuL3N0YXR1c01lc3NhZ2VzXCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgYWpheFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hamF4XCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGF0aFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYXRoXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGh0dHBVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvaHR0cFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhcnJheVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hcnJheVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyB2ZXJzaW9uVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3ZlcnNpb25cIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgYXN5bmNocm9ub3VzVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL2FzeW5jaHJvbm91c1wiO1xuIl0sIm5hbWVzIjpbImxldmVscyIsIm1ldGhvZHMiLCJoZWFkZXJzIiwia2V5Q29kZXMiLCJlbmNvZGluZ3MiLCJjaGFyYWN0ZXJzIiwic3RhdHVzQ29kZXMiLCJjb250ZW50VHlwZXMiLCJzdGF0dXNNZXNzYWdlcyIsImFqYXhVdGlsaXRpZXMiLCJwYXRoVXRpbGl0aWVzIiwiaHR0cFV0aWxpdGllcyIsImFycmF5VXRpbGl0aWVzIiwidmVyc2lvblV0aWxpdGllcyIsImFzeW5jaHJvbm91c1V0aWxpdGllcyJdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7O0lBRW9CQSxNQUFNO2VBQU5BLGVBQU07O0lBQ05DLE9BQU87ZUFBUEEsZ0JBQU87O0lBQ1BDLE9BQU87ZUFBUEEsZ0JBQU87O0lBQ1BDLFFBQVE7ZUFBUkEsaUJBQVE7O0lBQ1JDLFNBQVM7ZUFBVEEsa0JBQVM7O0lBQ1RDLFVBQVU7ZUFBVkEsbUJBQVU7O0lBQ1ZDLFdBQVc7ZUFBWEEsb0JBQVc7O0lBQ1hDLFlBQVk7ZUFBWkEscUJBQVk7O0lBQ1pDLGNBQWM7ZUFBZEEsdUJBQWM7O0lBRWRDLGFBQWE7ZUFBYkEsYUFBYTs7SUFFYkMsYUFBYTtlQUFiQSxhQUFhOztJQUNiQyxhQUFhO2VBQWJBLGFBQWE7O0lBQ2JDLGNBQWM7ZUFBZEEsY0FBYzs7SUFDZEMsZ0JBQWdCO2VBQWhCQSxnQkFBZ0I7O0lBQ2hCQyxxQkFBcUI7ZUFBckJBLHFCQUFxQjs7OzZEQWhCUDs4REFDQzs4REFDQTsrREFDQztnRUFDQztpRUFDQztrRUFDQzttRUFDQztxRUFDRTsyREFFRDsyREFFQTsyREFDQTs0REFDQzs4REFDRTttRUFDSyJ9

package/lib/main.js

@@ -45,6 +45,9 @@ _export(exports, {
     arrayUtilities: function() {
         return _array.default;
     },
+    versionUtilities: function() {
+        return _version.default;
+    },
     packageUtilities: function() {
         return _package.default;
     },
@@ -82,6 +85,7 @@ var _statusMessages = /*#__PURE__*/ _interop_require_default(require("./statusMe
 var _path = /*#__PURE__*/ _interop_require_default(require("./utilities/path"));
 var _http = /*#__PURE__*/ _interop_require_default(require("./utilities/http"));
 var _array = /*#__PURE__*/ _interop_require_default(require("./utilities/array"));
+var _version = /*#__PURE__*/ _interop_require_default(require("./utilities/version"));
 var _package = /*#__PURE__*/ _interop_require_default(require("./utilities/package"));
 var _asynchronous = /*#__PURE__*/ _interop_require_default(require("./utilities/asynchronous"));
 var _shell = /*#__PURE__*/ _interop_require_default(require("./utilities/shell"));
@@ -96,4 +100,4 @@ function _interop_require_default(obj) {
     };
 }
 
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uL3NyYy9tYWluLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5leHBvcnQgeyBkZWZhdWx0IGFzIGxldmVscyB9IGZyb20gXCIuL2xldmVsc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBtZXRob2RzIH0gZnJvbSBcIi4vbWV0aG9kc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBoZWFkZXJzIH0gZnJvbSBcIi4vaGVhZGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBrZXlDb2RlcyB9IGZyb20gXCIuL2tleUNvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGVuY29kaW5ncyB9IGZyb20gXCIuL2VuY29kaW5nc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjaGFyYWN0ZXJzIH0gZnJvbSBcIi4vY2hhcmFjdGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNDb2RlcyB9IGZyb20gXCIuL3N0YXR1c0NvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGNvbnRlbnRUeXBlcyB9IGZyb20gXCIuL2NvbnRlbnRUeXBlc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNNZXNzYWdlcyB9IGZyb20gXCIuL3N0YXR1c01lc3NhZ2VzXCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGF0aFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYXRoXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGh0dHBVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvaHR0cFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhcnJheVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hcnJheVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBwYWNrYWdlVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3BhY2thZ2VcIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgYXN5bmNocm9ub3VzVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL2FzeW5jaHJvbm91c1wiO1xuXG5leHBvcnQgeyBkZWZhdWx0IGFzIHNoZWxsVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3NoZWxsXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIHJlcXVlc3RVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvcmVxdWVzdFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBsb2dnaW5nVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL2xvZ2dpbmdcIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgdGVtcGxhdGVVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvdGVtcGxhdGVcIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgZmlsZVN5c3RlbVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9maWxlU3lzdGVtXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGNvbmZpZ3VyYXRpb25VdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvY29uZmlndXJhdGlvblwiO1xuIl0sIm5hbWVzIjpbImxldmVscyIsIm1ldGhvZHMiLCJoZWFkZXJzIiwia2V5Q29kZXMiLCJlbmNvZGluZ3MiLCJjaGFyYWN0ZXJzIiwic3RhdHVzQ29kZXMiLCJjb250ZW50VHlwZXMiLCJzdGF0dXNNZXNzYWdlcyIsInBhdGhVdGlsaXRpZXMiLCJodHRwVXRpbGl0aWVzIiwiYXJyYXlVdGlsaXRpZXMiLCJwYWNrYWdlVXRpbGl0aWVzIiwiYXN5bmNocm9ub3VzVXRpbGl0aWVzIiwic2hlbGxVdGlsaXRpZXMiLCJyZXF1ZXN0VXRpbGl0aWVzIiwibG9nZ2luZ1V0aWxpdGllcyIsInRlbXBsYXRlVXRpbGl0aWVzIiwiZmlsZVN5c3RlbVV0aWxpdGllcyIsImNvbmZpZ3VyYXRpb25VdGlsaXRpZXMiXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7OztJQUVvQkEsTUFBTTtlQUFOQSxlQUFNOztJQUNOQyxPQUFPO2VBQVBBLGdCQUFPOztJQUNQQyxPQUFPO2VBQVBBLGdCQUFPOztJQUNQQyxRQUFRO2VBQVJBLGlCQUFROztJQUNSQyxTQUFTO2VBQVRBLGtCQUFTOztJQUNUQyxVQUFVO2VBQVZBLG1CQUFVOztJQUNWQyxXQUFXO2VBQVhBLG9CQUFXOztJQUNYQyxZQUFZO2VBQVpBLHFCQUFZOztJQUNaQyxjQUFjO2VBQWRBLHVCQUFjOztJQUVkQyxhQUFhO2VBQWJBLGFBQWE7O0lBQ2JDLGFBQWE7ZUFBYkEsYUFBYTs7SUFDYkMsY0FBYztlQUFkQSxjQUFjOztJQUNkQyxnQkFBZ0I7ZUFBaEJBLGdCQUFnQjs7SUFDaEJDLHFCQUFxQjtlQUFyQkEscUJBQXFCOztJQUVyQkMsY0FBYztlQUFkQSxjQUFjOztJQUNkQyxnQkFBZ0I7ZUFBaEJBLGdCQUFnQjs7SUFDaEJDLGdCQUFnQjtlQUFoQkEsZ0JBQWdCOztJQUNoQkMsaUJBQWlCO2VBQWpCQSxpQkFBaUI7O0lBQ2pCQyxtQkFBbUI7ZUFBbkJBLG1CQUFtQjs7SUFDbkJDLHNCQUFzQjtlQUF0QkEsc0JBQXNCOzs7NkRBckJSOzhEQUNDOzhEQUNBOytEQUNDO2dFQUNDO2lFQUNDO2tFQUNDO21FQUNDO3FFQUNFOzJEQUVEOzJEQUNBOzREQUNDOzhEQUNFO21FQUNLOzREQUVQOzhEQUNFOzhEQUNBOytEQUNDO2lFQUNFO29FQUNHIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uL3NyYy9tYWluLmpzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuXG5leHBvcnQgeyBkZWZhdWx0IGFzIGxldmVscyB9IGZyb20gXCIuL2xldmVsc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBtZXRob2RzIH0gZnJvbSBcIi4vbWV0aG9kc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBoZWFkZXJzIH0gZnJvbSBcIi4vaGVhZGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBrZXlDb2RlcyB9IGZyb20gXCIuL2tleUNvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGVuY29kaW5ncyB9IGZyb20gXCIuL2VuY29kaW5nc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjaGFyYWN0ZXJzIH0gZnJvbSBcIi4vY2hhcmFjdGVyc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNDb2RlcyB9IGZyb20gXCIuL3N0YXR1c0NvZGVzXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGNvbnRlbnRUeXBlcyB9IGZyb20gXCIuL2NvbnRlbnRUeXBlc1wiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBzdGF0dXNNZXNzYWdlcyB9IGZyb20gXCIuL3N0YXR1c01lc3NhZ2VzXCI7XG5cbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGF0aFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYXRoXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGh0dHBVdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvaHR0cFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBhcnJheVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hcnJheVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyB2ZXJzaW9uVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3ZlcnNpb25cIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgcGFja2FnZVV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9wYWNrYWdlXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGFzeW5jaHJvbm91c1V0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9hc3luY2hyb25vdXNcIjtcblxuZXhwb3J0IHsgZGVmYXVsdCBhcyBzaGVsbFV0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9zaGVsbFwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyByZXF1ZXN0VXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3JlcXVlc3RcIjtcbmV4cG9ydCB7IGRlZmF1bHQgYXMgbG9nZ2luZ1V0aWxpdGllcyB9IGZyb20gXCIuL3V0aWxpdGllcy9sb2dnaW5nXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIHRlbXBsYXRlVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL3RlbXBsYXRlXCI7XG5leHBvcnQgeyBkZWZhdWx0IGFzIGZpbGVTeXN0ZW1VdGlsaXRpZXMgfSBmcm9tIFwiLi91dGlsaXRpZXMvZmlsZVN5c3RlbVwiO1xuZXhwb3J0IHsgZGVmYXVsdCBhcyBjb25maWd1cmF0aW9uVXRpbGl0aWVzIH0gZnJvbSBcIi4vdXRpbGl0aWVzL2NvbmZpZ3VyYXRpb25cIjtcbiJdLCJuYW1lcyI6WyJsZXZlbHMiLCJtZXRob2RzIiwiaGVhZGVycyIsImtleUNvZGVzIiwiZW5jb2RpbmdzIiwiY2hhcmFjdGVycyIsInN0YXR1c0NvZGVzIiwiY29udGVudFR5cGVzIiwic3RhdHVzTWVzc2FnZXMiLCJwYXRoVXRpbGl0aWVzIiwiaHR0cFV0aWxpdGllcyIsImFycmF5VXRpbGl0aWVzIiwidmVyc2lvblV0aWxpdGllcyIsInBhY2thZ2VVdGlsaXRpZXMiLCJhc3luY2hyb25vdXNVdGlsaXRpZXMiLCJzaGVsbFV0aWxpdGllcyIsInJlcXVlc3RVdGlsaXRpZXMiLCJsb2dnaW5nVXRpbGl0aWVzIiwidGVtcGxhdGVVdGlsaXRpZXMiLCJmaWxlU3lzdGVtVXRpbGl0aWVzIiwiY29uZmlndXJhdGlvblV0aWxpdGllcyJdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7O0lBRW9CQSxNQUFNO2VBQU5BLGVBQU07O0lBQ05DLE9BQU87ZUFBUEEsZ0JBQU87O0lBQ1BDLE9BQU87ZUFBUEEsZ0JBQU87O0lBQ1BDLFFBQVE7ZUFBUkEsaUJBQVE7O0lBQ1JDLFNBQVM7ZUFBVEEsa0JBQVM7O0lBQ1RDLFVBQVU7ZUFBVkEsbUJBQVU7O0lBQ1ZDLFdBQVc7ZUFBWEEsb0JBQVc7O0lBQ1hDLFlBQVk7ZUFBWkEscUJBQVk7O0lBQ1pDLGNBQWM7ZUFBZEEsdUJBQWM7O0lBRWRDLGFBQWE7ZUFBYkEsYUFBYTs7SUFDYkMsYUFBYTtlQUFiQSxhQUFhOztJQUNiQyxjQUFjO2VBQWRBLGNBQWM7O0lBQ2RDLGdCQUFnQjtlQUFoQkEsZ0JBQWdCOztJQUNoQkMsZ0JBQWdCO2VBQWhCQSxnQkFBZ0I7O0lBQ2hCQyxxQkFBcUI7ZUFBckJBLHFCQUFxQjs7SUFFckJDLGNBQWM7ZUFBZEEsY0FBYzs7SUFDZEMsZ0JBQWdCO2VBQWhCQSxnQkFBZ0I7O0lBQ2hCQyxnQkFBZ0I7ZUFBaEJBLGdCQUFnQjs7SUFDaEJDLGlCQUFpQjtlQUFqQkEsaUJBQWlCOztJQUNqQkMsbUJBQW1CO2VBQW5CQSxtQkFBbUI7O0lBQ25CQyxzQkFBc0I7ZUFBdEJBLHNCQUFzQjs7OzZEQXRCUjs4REFDQzs4REFDQTsrREFDQztnRUFDQztpRUFDQztrRUFDQzttRUFDQztxRUFDRTsyREFFRDsyREFDQTs0REFDQzs4REFDRTs4REFDQTttRUFDSzs0REFFUDs4REFDRTs4REFDQTsrREFDQztpRUFDRTtvRUFDRyJ9

package/lib/utilities/version.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    migrate: function() {
+        return migrate;
+    },
+    default: function() {
+        return _default;
+    }
+});
+function migrate(json, migrationMap, latestVersion) {
+    var version = json.version;
+    while(version !== latestVersion){
+        var migrateFunction = migrationMap[version];
+        json = migrateFunction(json);
+        version = json.version;
+    }
+    return json;
+}
+var _default = {
+    migrate: migrate
+};
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlsaXRpZXMvdmVyc2lvbi5qcyJdLCJzb3VyY2VzQ29udGVudCI6WyJcInVzZSBzdHJpY3RcIjtcblxuZXhwb3J0IGZ1bmN0aW9uIG1pZ3JhdGUoanNvbiwgbWlncmF0aW9uTWFwLCBsYXRlc3RWZXJzaW9uKSB7XG4gIGxldCB7IHZlcnNpb24gfSA9IGpzb247XG5cbiAgd2hpbGUgKHZlcnNpb24gIT09IGxhdGVzdFZlcnNpb24pIHtcbiAgICBjb25zdCBtaWdyYXRlRnVuY3Rpb24gPSBtaWdyYXRpb25NYXBbdmVyc2lvbl07XG5cbiAgICBqc29uID0gbWlncmF0ZUZ1bmN0aW9uKGpzb24pO1xuXG4gICAgKHsgdmVyc2lvbiB9ID0ganNvbik7XG4gIH1cblxuICByZXR1cm4ganNvbjtcbn1cblxuZXhwb3J0IGRlZmF1bHQge1xuICBtaWdyYXRlXG59O1xuIl0sIm5hbWVzIjpbIm1pZ3JhdGUiLCJqc29uIiwibWlncmF0aW9uTWFwIiwibGF0ZXN0VmVyc2lvbiIsInZlcnNpb24iLCJtaWdyYXRlRnVuY3Rpb24iXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7OztJQUVnQkEsT0FBTztlQUFQQTs7SUFjaEIsT0FFRTtlQUZGOzs7QUFkTyxTQUFTQSxRQUFRQyxJQUFJLEVBQUVDLFlBQVksRUFBRUMsYUFBYTtJQUN2RCxJQUFJLEFBQUVDLFVBQVlILEtBQVpHO0lBRU4sTUFBT0EsWUFBWUQsY0FBZTtRQUNoQyxJQUFNRSxrQkFBa0JILFlBQVksQ0FBQ0UsUUFBUTtRQUU3Q0gsT0FBT0ksZ0JBQWdCSjtRQUVwQkcsVUFBWUgsS0FBWkc7SUFDTDtJQUVBLE9BQU9IO0FBQ1Q7SUFFQSxXQUFlO0lBQ2JELFNBQUFBO0FBQ0YifQ==

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "necessary",
   "author": "James Smith",
-  "version": "11.8.5",
+  "version": "11.9.2",
   "license": "MIT, Anti-996",
   "homepage": "https://github.com/djalbat/necessary",
   "description": "A collection of utility functions.",

package/src/browser.js

@@ -15,4 +15,5 @@ export { default as ajaxUtilities } from "./utilities/ajax";
 export { default as pathUtilities } from "./utilities/path";
 export { default as httpUtilities } from "./utilities/http";
 export { default as arrayUtilities } from "./utilities/array";
+export { default as versionUtilities } from "./utilities/version";
 export { default as asynchronousUtilities } from "./utilities/asynchronous";

package/src/main.js

@@ -13,6 +13,7 @@ export { default as statusMessages } from "./statusMessages";
 export { default as pathUtilities } from "./utilities/path";
 export { default as httpUtilities } from "./utilities/http";
 export { default as arrayUtilities } from "./utilities/array";
+export { default as versionUtilities } from "./utilities/version";
 export { default as packageUtilities } from "./utilities/package";
 export { default as asynchronousUtilities } from "./utilities/asynchronous";
 

package/src/utilities/version.js

@@ -0,0 +1,19 @@
+"use strict";
+
+export function migrate(json, migrationMap, latestVersion) {
+  let { version } = json;
+
+  while (version !== latestVersion) {
+    const migrateFunction = migrationMap[version];
+
+    json = migrateFunction(json);
+
+    ({ version } = json);
+  }
+
+  return json;
+}
+
+export default {
+  migrate
+};