mobx-state-tree 6.0.0-pre.2 → 6.0.0

package/dist/mobx-state-tree.js

@@ -356,7 +356,7 @@ function protect(target) {
     assertIsStateTreeNode(target, 1);
     var node = getStateTreeNode(target);
     if (!node.isRoot)
-        throw fail("`protect` can only be invoked on root nodes");
+        throw new MstError("`protect` can only be invoked on root nodes");
     node.isProtectionEnabled = true;
 }
 /**
@@ -388,7 +388,7 @@ function unprotect(target) {
     assertIsStateTreeNode(target, 1);
     var node = getStateTreeNode(target);
     if (!node.isRoot)
-        throw fail("`unprotect` can only be invoked on root nodes");
+        throw new MstError("`unprotect` can only be invoked on root nodes");
     node.isProtectionEnabled = false;
 }
 /**
@@ -471,7 +471,7 @@ function getParent(target, depth) {
             return parent.storedValue;
         parent = parent.parent;
     }
-    throw fail("Failed to find the parent of ".concat(getStateTreeNode(target), " at depth ").concat(depth));
+    throw new MstError("Failed to find the parent of ".concat(getStateTreeNode(target), " at depth ").concat(depth));
 }
 /**
  * Given a model instance, returns `true` if the object has a parent of given type, that is, is part of another object, map or array
@@ -509,7 +509,7 @@ function getParentOfType(target, type) {
             return parent.storedValue;
         parent = parent.parent;
     }
-    throw fail("Failed to find the parent of ".concat(getStateTreeNode(target), " of a given type"));
+    throw new MstError("Failed to find the parent of ".concat(getStateTreeNode(target), " of a given type"));
 }
 /**
  * Given an object in a model tree, returns the root object of that tree.
@@ -626,7 +626,7 @@ function tryReference(getter, checkIfAlive) {
             }
         }
         else {
-            throw fail("The reference to be checked is not one of node, null or undefined");
+            throw new MstError("The reference to be checked is not one of node, null or undefined");
         }
     }
     catch (e) {
@@ -654,7 +654,7 @@ function isValidReference(getter, checkIfAlive) {
             return checkIfAlive ? isAlive(node) : true;
         }
         else {
-            throw fail("The reference to be checked is not one of node, null or undefined");
+            throw new MstError("The reference to be checked is not one of node, null or undefined");
         }
     }
     catch (e) {
@@ -811,7 +811,7 @@ function getEnv(target) {
     var node = getStateTreeNode(target);
     var env = node.root.environment;
     if (!env)
-        throw fail("Failed to find the environment of ".concat(node, " ").concat(node.path));
+        throw new MstError("Failed to find the environment of ".concat(node, " ").concat(node.path));
     return env;
 }
 /**
@@ -825,7 +825,7 @@ function hasEnv(target) {
     // check all arguments
     if (process.env.NODE_ENV !== "production") {
         if (!isStateTreeNode(target))
-            fail("expected first argument to be a mobx-state-tree node, got " + target + " instead");
+            throw new MstError("expected first argument to be a mobx-state-tree node, got " + target + " instead");
     }
     var node = getStateTreeNode(target);
     var env = node.root.environment;
@@ -894,14 +894,18 @@ function getMembers(target) {
                 reflected.volatile.push(key);
             return;
         }
-        if (descriptor.value._isMSTAction === true)
-            reflected.actions.push(key);
-        if (descriptor.value._isFlowAction === true)
+        if (descriptor.value._isFlowAction === true) {
             reflected.flowActions.push(key);
-        else if (mobx.isObservableProp(target, key))
+        }
+        if (descriptor.value._isMSTAction === true) {
+            reflected.actions.push(key);
+        }
+        else if (mobx.isObservableProp(target, key)) {
             reflected.volatile.push(key);
-        else
+        }
+        else {
             reflected.views.push(key);
+        }
     });
     return reflected;
 }
@@ -1255,7 +1259,7 @@ var BaseNode = /** @class */ (function () {
             if (devMode()) {
                 if (!this.isAlive) {
                     // istanbul ignore next
-                    throw fail("assertion failed: cannot finalize the creation of a node that is already dead");
+                    throw new MstError("assertion failed: cannot finalize the creation of a node that is already dead");
                 }
             }
             // goal: afterCreate hooks runs depth-first. After attach runs parent first, so on afterAttach the parent has completed already
@@ -1326,7 +1330,7 @@ var ScalarNode = /** @class */ (function (_super) {
         get: function () {
             // future optimization: store root ref in the node and maintain it
             if (!this.parent)
-                throw fail("This scalar node is not part of a tree");
+                throw new MstError("This scalar node is not part of a tree");
             return this.parent.root;
         },
         enumerable: false,
@@ -1345,15 +1349,15 @@ var ScalarNode = /** @class */ (function (_super) {
             if (devMode()) {
                 if (!subpath) {
                     // istanbul ignore next
-                    throw fail("assertion failed: subpath expected");
+                    throw new MstError("assertion failed: subpath expected");
                 }
                 if (!newParent) {
                     // istanbul ignore next
-                    throw fail("assertion failed: parent expected");
+                    throw new MstError("assertion failed: parent expected");
                 }
                 if (parentChanged) {
                     // istanbul ignore next
-                    throw fail("assertion failed: scalar nodes cannot change their parent");
+                    throw new MstError("assertion failed: scalar nodes cannot change their parent");
                 }
             }
             this.environment = undefined; // use parent's
@@ -1432,6 +1436,21 @@ var ScalarNode = /** @class */ (function (_super) {
 ScalarNode.prototype.die = mobx.action(ScalarNode.prototype.die);
 
 var nextNodeId = 1;
+var ObservableInstanceLifecycle;
+(function (ObservableInstanceLifecycle) {
+    // the actual observable instance has not been created yet
+    ObservableInstanceLifecycle[ObservableInstanceLifecycle["UNINITIALIZED"] = 0] = "UNINITIALIZED";
+    // the actual observable instance is being created
+    ObservableInstanceLifecycle[ObservableInstanceLifecycle["CREATING"] = 1] = "CREATING";
+    // the actual observable instance has been created
+    ObservableInstanceLifecycle[ObservableInstanceLifecycle["CREATED"] = 2] = "CREATED";
+})(ObservableInstanceLifecycle || (ObservableInstanceLifecycle = {}));
+var InternalEvents;
+(function (InternalEvents) {
+    InternalEvents["Dispose"] = "dispose";
+    InternalEvents["Patch"] = "patch";
+    InternalEvents["Snapshot"] = "snapshot";
+})(InternalEvents || (InternalEvents = {}));
 var snapshotReactionOptions = {
     onError: function (e) {
         throw e;
@@ -1527,7 +1546,7 @@ var ObjectNode = /** @class */ (function (_super) {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: 0 /* ObservableInstanceLifecycle.UNINITIALIZED */
+            value: ObservableInstanceLifecycle.UNINITIALIZED
         });
         Object.defineProperty(_this, "_childNodes", {
             enumerable: true,
@@ -1594,7 +1613,7 @@ var ObjectNode = /** @class */ (function (_super) {
                 }
             }
             if (typeof id !== "string" && typeof id !== "number") {
-                throw fail("Instance identifier '".concat(_this.identifierAttribute, "' for type '").concat(_this.type.name, "' must be a string or a number"));
+                throw new MstError("Instance identifier '".concat(_this.identifierAttribute, "' for type '").concat(_this.type.name, "' must be a string or a number"));
             }
             // normalize internal identifier to string
             _this.identifier = normalizeIdentifier(id);
@@ -1632,7 +1651,7 @@ var ObjectNode = /** @class */ (function (_super) {
         writable: true,
         value: function (fireHooks) {
             if (fireHooks === void 0) { fireHooks = true; }
-            if (this._observableInstanceState === 0 /* ObservableInstanceLifecycle.UNINITIALIZED */) {
+            if (this._observableInstanceState === ObservableInstanceLifecycle.UNINITIALIZED) {
                 this.createObservableInstance(fireHooks);
             }
         }
@@ -1647,10 +1666,10 @@ var ObjectNode = /** @class */ (function (_super) {
             if (devMode()) {
                 if (this.state !== NodeLifeCycle.INITIALIZING) {
                     // istanbul ignore next
-                    throw fail("assertion failed: the creation of the observable instance must be done on the initializing phase");
+                    throw new MstError("assertion failed: the creation of the observable instance must be done on the initializing phase");
                 }
             }
-            this._observableInstanceState = 1 /* ObservableInstanceLifecycle.CREATING */;
+            this._observableInstanceState = ObservableInstanceLifecycle.CREATING;
             // make sure the parent chain is created as well
             // array with parent chain from parent to child
             var parentChain = [];
@@ -1660,7 +1679,7 @@ var ObjectNode = /** @class */ (function (_super) {
             // this is done to avoid traversing the whole tree to the root when using
             // the same reference again
             while (parent &&
-                parent._observableInstanceState === 0 /* ObservableInstanceLifecycle.UNINITIALIZED */) {
+                parent._observableInstanceState === ObservableInstanceLifecycle.UNINITIALIZED) {
                 parentChain.unshift(parent);
                 parent = parent.parent;
             }
@@ -1694,7 +1713,7 @@ var ObjectNode = /** @class */ (function (_super) {
             finally {
                 this._isRunningAction = false;
             }
-            this._observableInstanceState = 2 /* ObservableInstanceLifecycle.CREATED */;
+            this._observableInstanceState = ObservableInstanceLifecycle.CREATED;
             this._snapshotComputed.trackAndCompute();
             if (this.isRoot)
                 this._addSnapshotReaction();
@@ -1770,20 +1789,20 @@ var ObjectNode = /** @class */ (function (_super) {
             if (devMode()) {
                 if (!subpath) {
                     // istanbul ignore next
-                    throw fail("assertion failed: subpath expected");
+                    throw new MstError("assertion failed: subpath expected");
                 }
                 if (!newParent) {
                     // istanbul ignore next
-                    throw fail("assertion failed: new parent expected");
+                    throw new MstError("assertion failed: new parent expected");
                 }
                 if (this.parent && parentChanged) {
-                    throw fail("A node cannot exists twice in the state tree. Failed to add ".concat(this, " to path '").concat(newParent.path, "/").concat(subpath, "'."));
+                    throw new MstError("A node cannot exists twice in the state tree. Failed to add ".concat(this, " to path '").concat(newParent.path, "/").concat(subpath, "'."));
                 }
                 if (!this.parent && newParent.root === this) {
-                    throw fail("A state tree is not allowed to contain itself. Cannot assign ".concat(this, " to path '").concat(newParent.path, "/").concat(subpath, "'"));
+                    throw new MstError("A state tree is not allowed to contain itself. Cannot assign ".concat(this, " to path '").concat(newParent.path, "/").concat(subpath, "'"));
                 }
                 if (!this.parent && !!this.environment && this.environment !== newParent.root.environment) {
-                    throw fail("A state tree cannot be made part of another state tree as long as their environments are different.");
+                    throw new MstError("A state tree cannot be made part of another state tree as long as their environments are different.");
                 }
             }
             if (parentChanged) {
@@ -1839,7 +1858,7 @@ var ObjectNode = /** @class */ (function (_super) {
         value: function () {
             if (!this.isAlive)
                 return this._snapshotUponDeath;
-            return this._observableInstanceState === 2 /* ObservableInstanceLifecycle.CREATED */
+            return this._observableInstanceState === ObservableInstanceLifecycle.CREATED
                 ? this._getActualSnapshot()
                 : this._getCachedInitialSnapshot();
         }
@@ -1889,7 +1908,7 @@ var ObjectNode = /** @class */ (function (_super) {
                 var error = this._getAssertAliveError(context);
                 switch (livelinessChecking) {
                     case "error":
-                        throw fail(error);
+                        throw new MstError(error);
                     case "warn":
                         warnError(error);
                 }
@@ -1927,7 +1946,7 @@ var ObjectNode = /** @class */ (function (_super) {
             });
             this._autoUnbox = false;
             try {
-                return this._observableInstanceState === 2 /* ObservableInstanceLifecycle.CREATED */
+                return this._observableInstanceState === ObservableInstanceLifecycle.CREATED
                     ? this.type.getChildNode(this, subpath)
                     : this._childNodes[subpath];
             }
@@ -1944,7 +1963,7 @@ var ObjectNode = /** @class */ (function (_super) {
             this.assertAlive(EMPTY_OBJECT);
             this._autoUnbox = false;
             try {
-                return this._observableInstanceState === 2 /* ObservableInstanceLifecycle.CREATED */
+                return this._observableInstanceState === ObservableInstanceLifecycle.CREATED
                     ? this.type.getChildren(this)
                     : convertChildNodesToArray(this._childNodes);
             }
@@ -1975,7 +1994,7 @@ var ObjectNode = /** @class */ (function (_super) {
         value: function (context) {
             this.assertAlive(context);
             if (!this.isRunningAction() && this.isProtected) {
-                throw fail("Cannot modify '".concat(this, "', the object is protected and can only be modified by using an action."));
+                throw new MstError("Cannot modify '".concat(this, "', the object is protected and can only be modified by using an action."));
             }
         }
     });
@@ -2042,7 +2061,7 @@ var ObjectNode = /** @class */ (function (_super) {
         writable: true,
         value: function () {
             if (!this.isAlive)
-                throw fail("Error while detaching, node is not alive.");
+                throw new MstError("Error while detaching, node is not alive.");
             this.clearParent();
         }
     });
@@ -2090,7 +2109,7 @@ var ObjectNode = /** @class */ (function (_super) {
         configurable: true,
         writable: true,
         value: function () {
-            if (this._observableInstanceState === 0 /* ObservableInstanceLifecycle.UNINITIALIZED */) {
+            if (this._observableInstanceState === ObservableInstanceLifecycle.UNINITIALIZED) {
                 return;
             }
             this.getChildren().forEach(function (node) {
@@ -2099,8 +2118,8 @@ var ObjectNode = /** @class */ (function (_super) {
             // beforeDestroy should run before the disposers since else we could end up in a situation where
             // a disposer added with addDisposer at this stage (beforeDestroy) is actually never released
             this.baseAboutToDie();
-            this._internalEventsEmit("dispose" /* InternalEvents.Dispose */);
-            this._internalEventsClear("dispose" /* InternalEvents.Dispose */);
+            this._internalEventsEmit(InternalEvents.Dispose);
+            this._internalEventsClear(InternalEvents.Dispose);
         }
     });
     Object.defineProperty(ObjectNode.prototype, "finalizeDeath", {
@@ -2126,7 +2145,7 @@ var ObjectNode = /** @class */ (function (_super) {
         writable: true,
         value: function (onChange) {
             this._addSnapshotReaction();
-            return this._internalEventsRegister("snapshot" /* InternalEvents.Snapshot */, onChange);
+            return this._internalEventsRegister(InternalEvents.Snapshot, onChange);
         }
     });
     Object.defineProperty(ObjectNode.prototype, "emitSnapshot", {
@@ -2134,7 +2153,7 @@ var ObjectNode = /** @class */ (function (_super) {
         configurable: true,
         writable: true,
         value: function (snapshot) {
-            this._internalEventsEmit("snapshot" /* InternalEvents.Snapshot */, snapshot);
+            this._internalEventsEmit(InternalEvents.Snapshot, snapshot);
         }
     });
     Object.defineProperty(ObjectNode.prototype, "onPatch", {
@@ -2142,7 +2161,7 @@ var ObjectNode = /** @class */ (function (_super) {
         configurable: true,
         writable: true,
         value: function (handler) {
-            return this._internalEventsRegister("patch" /* InternalEvents.Patch */, handler);
+            return this._internalEventsRegister(InternalEvents.Patch, handler);
         }
     });
     Object.defineProperty(ObjectNode.prototype, "emitPatch", {
@@ -2150,12 +2169,12 @@ var ObjectNode = /** @class */ (function (_super) {
         configurable: true,
         writable: true,
         value: function (basePatch, source) {
-            if (this._internalEventsHasSubscribers("patch" /* InternalEvents.Patch */)) {
+            if (this._internalEventsHasSubscribers(InternalEvents.Patch)) {
                 // calculate the relative path of the patch
                 var path = source.path.substr(this.path.length) + (basePatch.path ? "/" + basePatch.path : "");
                 var localizedPatch = extend({}, basePatch, { path: path });
                 var _a = __read(splitPatch(localizedPatch), 2), patch = _a[0], reversePatch = _a[1];
-                this._internalEventsEmit("patch" /* InternalEvents.Patch */, patch, reversePatch);
+                this._internalEventsEmit(InternalEvents.Patch, patch, reversePatch);
             }
             if (this.parent)
                 this.parent.emitPatch(basePatch, source);
@@ -2166,7 +2185,7 @@ var ObjectNode = /** @class */ (function (_super) {
         configurable: true,
         writable: true,
         value: function (disposer) {
-            return this._internalEventsHas("dispose" /* InternalEvents.Dispose */, disposer);
+            return this._internalEventsHas(InternalEvents.Dispose, disposer);
         }
     });
     Object.defineProperty(ObjectNode.prototype, "addDisposer", {
@@ -2175,10 +2194,10 @@ var ObjectNode = /** @class */ (function (_super) {
         writable: true,
         value: function (disposer) {
             if (!this.hasDisposer(disposer)) {
-                this._internalEventsRegister("dispose" /* InternalEvents.Dispose */, disposer, true);
+                this._internalEventsRegister(InternalEvents.Dispose, disposer, true);
                 return;
             }
-            throw fail("cannot add a disposer when it is already registered for execution");
+            throw new MstError("cannot add a disposer when it is already registered for execution");
         }
     });
     Object.defineProperty(ObjectNode.prototype, "removeDisposer", {
@@ -2186,10 +2205,10 @@ var ObjectNode = /** @class */ (function (_super) {
         configurable: true,
         writable: true,
         value: function (disposer) {
-            if (!this._internalEventsHas("dispose" /* InternalEvents.Dispose */, disposer)) {
-                throw fail("cannot remove a disposer which was never registered for execution");
+            if (!this._internalEventsHas(InternalEvents.Dispose, disposer)) {
+                throw new MstError("cannot remove a disposer which was never registered for execution");
             }
-            this._internalEventsUnregister("dispose" /* InternalEvents.Dispose */, disposer);
+            this._internalEventsUnregister(InternalEvents.Dispose, disposer);
         }
     });
     Object.defineProperty(ObjectNode.prototype, "removeMiddleware", {
@@ -2433,7 +2452,7 @@ var BaseType = /** @class */ (function () {
         writable: true,
         value: function (node, applyPostProcess) {
             // istanbul ignore next
-            throw fail("unimplemented method");
+            throw new MstError("unimplemented method");
         }
     });
     Object.defineProperty(BaseType.prototype, "isAssignableFrom", {
@@ -2471,7 +2490,7 @@ var BaseType = /** @class */ (function () {
     Object.defineProperty(BaseType.prototype, "Type", {
         get: function () {
             // istanbul ignore next
-            throw fail("Factory.Type should not be actually called. It is just a Type signature that can be used at compile time with Typescript, by using `typeof type.Type`");
+            throw new MstError("Factory.Type should not be actually called. It is just a Type signature that can be used at compile time with Typescript, by using `typeof type.Type`");
         },
         enumerable: false,
         configurable: true
@@ -2479,7 +2498,7 @@ var BaseType = /** @class */ (function () {
     Object.defineProperty(BaseType.prototype, "TypeWithoutSTN", {
         get: function () {
             // istanbul ignore next
-            throw fail("Factory.TypeWithoutSTN should not be actually called. It is just a Type signature that can be used at compile time with Typescript, by using `typeof type.TypeWithoutSTN`");
+            throw new MstError("Factory.TypeWithoutSTN should not be actually called. It is just a Type signature that can be used at compile time with Typescript, by using `typeof type.TypeWithoutSTN`");
         },
         enumerable: false,
         configurable: true
@@ -2487,7 +2506,7 @@ var BaseType = /** @class */ (function () {
     Object.defineProperty(BaseType.prototype, "SnapshotType", {
         get: function () {
             // istanbul ignore next
-            throw fail("Factory.SnapshotType should not be actually called. It is just a Type signature that can be used at compile time with Typescript, by using `typeof type.SnapshotType`");
+            throw new MstError("Factory.SnapshotType should not be actually called. It is just a Type signature that can be used at compile time with Typescript, by using `typeof type.SnapshotType`");
         },
         enumerable: false,
         configurable: true
@@ -2495,7 +2514,7 @@ var BaseType = /** @class */ (function () {
     Object.defineProperty(BaseType.prototype, "CreationType", {
         get: function () {
             // istanbul ignore next
-            throw fail("Factory.CreationType should not be actually called. It is just a Type signature that can be used at compile time with Typescript, by using `typeof type.CreationType`");
+            throw new MstError("Factory.CreationType should not be actually called. It is just a Type signature that can be used at compile time with Typescript, by using `typeof type.CreationType`");
         },
         enumerable: false,
         configurable: true
@@ -2985,7 +3004,7 @@ function applyAction(target, actions) {
 function baseApplyAction(target, action) {
     var resolvedTarget = tryResolve(target, action.path || "");
     if (!resolvedTarget)
-        throw fail("Invalid action path: ".concat(action.path || ""));
+        throw new MstError("Invalid action path: ".concat(action.path || ""));
     var node = getStateTreeNode(resolvedTarget);
     // Reserved functions
     if (action.name === "@APPLY_PATCHES") {
@@ -2995,7 +3014,7 @@ function baseApplyAction(target, action) {
         return applySnapshot.call(null, resolvedTarget, action.args[0]);
     }
     if (!(typeof resolvedTarget[action.name] === "function"))
-        throw fail("Action '".concat(action.name, "' does not exist in '").concat(node.path, "'"));
+        throw new MstError("Action '".concat(action.name, "' does not exist in '").concat(node.path, "'"));
     return resolvedTarget[action.name].apply(resolvedTarget, action.args ? action.args.map(function (v) { return deserializeArgument(node, v); }) : []);
 }
 /**
@@ -3356,11 +3375,11 @@ function runMiddleWares(node, baseCall, originalFn) {
         if (devMode()) {
             if (!nextInvoked && !abortInvoked) {
                 var node2 = getStateTreeNode(call.tree);
-                throw fail("Neither the next() nor the abort() callback within the middleware ".concat(handler.name, " for the action: \"").concat(call.name, "\" on the node: ").concat(node2.type.name, " was invoked."));
+                throw new MstError("Neither the next() nor the abort() callback within the middleware ".concat(handler.name, " for the action: \"").concat(call.name, "\" on the node: ").concat(node2.type.name, " was invoked."));
             }
             else if (nextInvoked && abortInvoked) {
                 var node2 = getStateTreeNode(call.tree);
-                throw fail("The next() and abort() callback within the middleware ".concat(handler.name, " for the action: \"").concat(call.name, "\" on the node: ").concat(node2.type.name, " were invoked."));
+                throw new MstError("The next() and abort() callback within the middleware ".concat(handler.name, " for the action: \"").concat(call.name, "\" on the node: ").concat(node2.type.name, " were invoked."));
             }
         }
         return result;
@@ -3507,7 +3526,7 @@ function typecheckInternal(type, value) {
 function typecheck(type, value) {
     var errors = type.validate(value, [{ path: "", type: type }]);
     if (errors.length > 0) {
-        throw fail(validationErrorsToString(type, value, errors));
+        throw new MstError(validationErrorsToString(type, value, errors));
     }
 }
 function validationErrorsToString(type, value, errors) {
@@ -3578,7 +3597,7 @@ var IdentifierCache = /** @class */ (function () {
                 }
                 var set = this.cache.get(identifier);
                 if (set.indexOf(node) !== -1)
-                    throw fail("Already registered");
+                    throw new MstError("Already registered");
                 set.push(node);
                 if (lastCacheUpdate) {
                     this.updateLastCacheModificationPerId(identifier);
@@ -3677,7 +3696,7 @@ var IdentifierCache = /** @class */ (function () {
                 case 1:
                     return matches[0];
                 default:
-                    throw fail("Cannot resolve a reference to type '".concat(type.name, "' with id: '").concat(identifier, "' unambigously, there are multiple candidates: ").concat(matches
+                    throw new MstError("Cannot resolve a reference to type '".concat(type.name, "' with id: '").concat(identifier, "' unambigously, there are multiple candidates: ").concat(matches
                         .map(function (n) { return n.path; })
                         .join(", ")));
             }
@@ -3695,7 +3714,7 @@ function createObjectNode(type, parent, subpath, environment, initialValue) {
     if (existingNode) {
         if (existingNode.parent) {
             // istanbul ignore next
-            throw fail("Cannot add an object to a state tree if it is already part of the same or another state tree. Tried to assign an object to '".concat(parent ? parent.path : "", "/").concat(subpath, "', but it lives already at '").concat(existingNode.path, "'"));
+            throw new MstError("Cannot add an object to a state tree if it is already part of the same or another state tree. Tried to assign an object to '".concat(parent ? parent.path : "", "/").concat(subpath, "', but it lives already at '").concat(existingNode.path, "'"));
         }
         if (parent) {
             existingNode.setParent(parent, subpath);
@@ -3758,7 +3777,7 @@ function assertIsStateTreeNode(value, argNumber) {
 function getStateTreeNode(value) {
     if (!isStateTreeNode(value)) {
         // istanbul ignore next
-        throw fail("Value ".concat(value, " is no MST Node"));
+        throw new MstError("Value ".concat(value, " is no MST Node"));
     }
     return value.$treenode;
 }
@@ -3784,7 +3803,7 @@ var doubleDot = function (_) { return ".."; };
 function getRelativePathBetweenNodes(base, target) {
     // PRE condition target is (a child of) base!
     if (base.root !== target.root) {
-        throw fail("Cannot calculate relative path: objects '".concat(base, "' and '").concat(target, "' are not part of the same object tree"));
+        throw new MstError("Cannot calculate relative path: objects '".concat(base, "' and '").concat(target, "' are not part of the same object tree"));
     }
     var baseParts = splitJsonPath(base.path);
     var targetParts = splitJsonPath(target.path);
@@ -3841,7 +3860,7 @@ function resolveNodeByPathParts(base, pathParts, failIfResolveFails) {
                     }
                 }
             }
-            throw fail("Could not resolve '".concat(part, "' in path '").concat(joinJsonPath(pathParts.slice(0, i)) || "/", "' while resolving '").concat(joinJsonPath(pathParts), "'"));
+            throw new MstError("Could not resolve '".concat(part, "' in path '").concat(joinJsonPath(pathParts.slice(0, i)) || "/", "' while resolving '").concat(joinJsonPath(pathParts), "'"));
         }
     }
     catch (e) {
@@ -3917,10 +3936,14 @@ Object.freeze(mobxShallow);
  * @internal
  * @hidden
  */
-function fail(message) {
-    if (message === void 0) { message = "Illegal state"; }
-    return new Error("[mobx-state-tree] " + message);
-}
+var MstError = /** @class */ (function (_super) {
+    __extends(MstError, _super);
+    function MstError(message) {
+        if (message === void 0) { message = "Illegal state"; }
+        return _super.call(this, "[mobx-state-tree] ".concat(message)) || this;
+    }
+    return MstError;
+}(Error));
 /**
  * @internal
  * @hidden
@@ -4324,7 +4347,7 @@ function assertArg(value, fn, typeName, argNumber) {
     if (devMode()) {
         if (!fn(value)) {
             // istanbul ignore next
-            throw fail("expected ".concat(typeName, " as argument ").concat(asArray(argNumber).join(" or "), ", got ").concat(value, " instead"));
+            throw new MstError("expected ".concat(typeName, " as argument ").concat(asArray(argNumber).join(" or "), ", got ").concat(value, " instead"));
         }
     }
 }
@@ -4469,11 +4492,11 @@ function createFlowSpawner(name, generator) {
         var runId = getNextActionId();
         var parentContext = getCurrentActionContext();
         if (!parentContext) {
-            throw fail("a mst flow must always have a parent context");
+            throw new MstError("a mst flow must always have a parent context");
         }
         var parentActionContext = getParentActionContext(parentContext);
         if (!parentActionContext) {
-            throw fail("a mst flow must always have a parent action context");
+            throw new MstError("a mst flow must always have a parent action context");
         }
         var contextBase = {
             name: name,
@@ -4544,7 +4567,7 @@ function createFlowSpawner(name, generator) {
                 // TODO: support more type of values? See https://github.com/tj/co/blob/249bbdc72da24ae44076afd716349d2089b31c4c/index.js#L100
                 if (!ret.value || typeof ret.value.then !== "function") {
                     // istanbul ignore next
-                    throw fail("Only promises can be yielded to `async`, got: " + ret);
+                    throw new MstError("Only promises can be yielded to `async`, got: " + ret);
                 }
                 return ret.value.then(onFulfilled, onRejected);
             }
@@ -4560,7 +4583,7 @@ function createFlowSpawner(name, generator) {
  */
 function splitPatch(patch) {
     if (!("oldValue" in patch))
-        throw fail("Patches without `oldValue` field cannot be inversed");
+        throw new MstError("Patches without `oldValue` field cannot be inversed");
     return [stripPatch(patch), invertPatch(patch)];
 }
 /**
@@ -4661,7 +4684,7 @@ function splitJsonPath(path) {
         stringStartsWith(path, "./") ||
         stringStartsWith(path, "../");
     if (!valid) {
-        throw fail("a json path must be either rooted, empty or relative, but got '".concat(path, "'"));
+        throw new MstError("a json path must be either rooted, empty or relative, but got '".concat(path, "'"));
     }
     // '/a/b/c' -> ["a", "b", "c"]
     // '../../b/c' -> ["..", "..", "b", "c"]
@@ -4916,11 +4939,11 @@ function snapshotProcessor(type, processors, name) {
     if (devMode()) {
         if (processors.postProcessor && typeof processors.postProcessor !== "function") {
             // istanbul ignore next
-            throw fail("postSnapshotProcessor must be a function");
+            throw new MstError("postSnapshotProcessor must be a function");
         }
         if (processors.preProcessor && typeof processors.preProcessor !== "function") {
             // istanbul ignore next
-            throw fail("preSnapshotProcessor must be a function");
+            throw new MstError("preSnapshotProcessor must be a function");
         }
     }
     return new SnapshotProcessor(type, processors, name);
@@ -5009,28 +5032,28 @@ var MSTMap = /** @class */ (function (_super) {
         writable: true,
         value: function (value) {
             if (!value)
-                throw fail("Map.put cannot be used to set empty values");
+                throw new MstError("Map.put cannot be used to set empty values");
             if (isStateTreeNode(value)) {
                 var node = getStateTreeNode(value);
                 if (devMode()) {
                     if (!node.identifierAttribute) {
-                        throw fail(needsIdentifierError);
+                        throw new MstError(needsIdentifierError);
                     }
                 }
                 if (node.identifier === null) {
-                    throw fail(needsIdentifierError);
+                    throw new MstError(needsIdentifierError);
                 }
                 this.set(node.identifier, value);
                 return value;
             }
             else if (!isMutable(value)) {
-                throw fail("Map.put can only be used to store complex values");
+                throw new MstError("Map.put can only be used to store complex values");
             }
             else {
                 var mapNode = getStateTreeNode(this);
                 var mapType = mapNode.type;
                 if (mapType.identifierMode !== MapIdentifierMode.YES) {
-                    throw fail(needsIdentifierError);
+                    throw new MstError(needsIdentifierError);
                 }
                 var idAttr = mapType.mapIdentifierAttribute;
                 var id = value[idAttr];
@@ -5123,7 +5146,7 @@ var MapType = /** @class */ (function (_super) {
                     if (!type.identifierAttribute)
                         return current;
                     if (current && current !== type.identifierAttribute) {
-                        throw fail("The objects in a map should all have the same identifier attribute, expected '".concat(current, "', but child of type '").concat(type.name, "' declared attribute '").concat(type.identifierAttribute, "' as identifier"));
+                        throw new MstError("The objects in a map should all have the same identifier attribute, expected '".concat(current, "', but child of type '").concat(type.name, "' declared attribute '").concat(type.identifierAttribute, "' as identifier"));
                     }
                     return type.identifierAttribute;
                 }, undefined);
@@ -5202,7 +5225,7 @@ var MapType = /** @class */ (function (_super) {
         value: function (node, key) {
             var childNode = node.storedValue.get("" + key);
             if (!childNode)
-                throw fail("Not a child " + key);
+                throw new MstError("Not a child " + key);
             return childNode;
         }
     });
@@ -5247,7 +5270,7 @@ var MapType = /** @class */ (function (_super) {
             if (this.identifierMode === MapIdentifierMode.YES && node instanceof ObjectNode) {
                 var identifier = node.identifier;
                 if (identifier !== expected)
-                    throw fail("A map of objects containing an identifier should always store the object under their own identifier. Trying to store key '".concat(identifier, "', but expected: '").concat(expected, "'"));
+                    throw new MstError("A map of objects containing an identifier should always store the object under their own identifier. Trying to store key '".concat(identifier, "', but expected: '").concat(expected, "'"));
             }
         }
     });
@@ -5545,7 +5568,7 @@ var ArrayType = /** @class */ (function (_super) {
             var index = Number(key);
             if (index < node.storedValue.length)
                 return node.storedValue[index];
-            throw fail("Not a child: " + key);
+            throw new MstError("Not a child: " + key);
         }
     });
     Object.defineProperty(ArrayType.prototype, "willChange", {
@@ -5779,7 +5802,7 @@ function reconcileArrayChildren(parent, childType, oldNodes, newValues, newPaths
             // check if already belongs to the same parent. if so, avoid pushing item in. only swapping can occur.
             if (isStateTreeNode(newValue) && getStateTreeNode(newValue).parent === parent) {
                 // this node is owned by this parent, but not in the reconcilable set, so it must be double
-                throw fail("Cannot add an object to a state tree if it is already part of the same or another state tree. Tried to assign an object to '".concat(parent.path, "/").concat(newPath, "', but it lives already at '").concat(getStateTreeNode(newValue).path, "'"));
+                throw new MstError("Cannot add an object to a state tree if it is already part of the same or another state tree. Tried to assign an object to '".concat(parent.path, "/").concat(newPath, "', but it lives already at '").concat(getStateTreeNode(newValue).path, "'"));
             }
             nothingChanged = false;
             var newNode = valueAsNode(childType, parent, newPath, newValue);
@@ -5895,7 +5918,7 @@ function toPropertiesObject(declaredProps) {
     var alreadySeenKeys = new Set();
     keysList.forEach(function (key) {
         if (alreadySeenKeys.has(key)) {
-            throw fail("".concat(key, " is declared twice in the model. Model should not contain the same keys"));
+            throw new MstError("".concat(key, " is declared twice in the model. Model should not contain the same keys"));
         }
         alreadySeenKeys.add(key);
     });
@@ -5903,17 +5926,17 @@ function toPropertiesObject(declaredProps) {
     return keysList.reduce(function (props, key) {
         // warn if user intended a HOOK
         if (key in Hook) {
-            throw fail("Hook '".concat(key, "' was defined as property. Hooks should be defined as part of the actions"));
+            throw new MstError("Hook '".concat(key, "' was defined as property. Hooks should be defined as part of the actions"));
         }
         // the user intended to use a view
         var descriptor = Object.getOwnPropertyDescriptor(declaredProps, key);
         if ("get" in descriptor) {
-            throw fail("Getters are not supported as properties. Please use views instead");
+            throw new MstError("Getters are not supported as properties. Please use views instead");
         }
         // undefined and null are not valid
         var value = descriptor.value;
         if (value === null || value === undefined) {
-            throw fail("The default value of an attribute cannot be null or undefined as the type cannot be inferred. Did you mean `types.maybe(someType)`?");
+            throw new MstError("The default value of an attribute cannot be null or undefined as the type cannot be inferred. Did you mean `types.maybe(someType)`?");
         }
         // its a primitive, convert to its type
         else if (isPrimitive(value)) {
@@ -5930,17 +5953,17 @@ function toPropertiesObject(declaredProps) {
         else if (isType(value)) ;
         // its a function, maybe the user wanted a view?
         else if (devMode() && typeof value === "function") {
-            throw fail("Invalid type definition for property '".concat(key, "', it looks like you passed a function. Did you forget to invoke it, or did you intend to declare a view / action?"));
+            throw new MstError("Invalid type definition for property '".concat(key, "', it looks like you passed a function. Did you forget to invoke it, or did you intend to declare a view / action?"));
         }
         // no other complex values
         else if (devMode() && typeof value === "object") {
-            throw fail("Invalid type definition for property '".concat(key, "', it looks like you passed an object. Try passing another model type or a types.frozen."));
+            throw new MstError("Invalid type definition for property '".concat(key, "', it looks like you passed an object. Try passing another model type or a types.frozen."));
         }
         else {
-            throw fail("Invalid type definition for property '".concat(key, "', cannot infer a type from a value like '").concat(value, "' (").concat(typeof value, ")"));
+            throw new MstError("Invalid type definition for property '".concat(key, "', cannot infer a type from a value like '").concat(value, "' (").concat(typeof value, ")"));
         }
         return props;
-    }, declaredProps);
+    }, __assign({}, declaredProps));
 }
 /**
  * @internal
@@ -6050,7 +6073,7 @@ var ModelType = /** @class */ (function (_super) {
             this.forAllProps(function (propName, propType) {
                 if (propType.flags & TypeFlags.Identifier) {
                     if (identifierAttribute)
-                        throw fail("Cannot define property '".concat(propName, "' as object identifier, property '").concat(identifierAttribute, "' is already defined as identifier property"));
+                        throw new MstError("Cannot define property '".concat(propName, "' as object identifier, property '").concat(identifierAttribute, "' is already defined as identifier property"));
                     identifierAttribute = propName;
                 }
             });
@@ -6091,15 +6114,15 @@ var ModelType = /** @class */ (function (_super) {
         value: function (self, actions) {
             // check if return is correct
             if (!isPlainObject(actions))
-                throw fail("actions initializer should return a plain object containing actions");
+                throw new MstError("actions initializer should return a plain object containing actions");
             // bind actions to the object created
             Object.keys(actions).forEach(function (name) {
                 // warn if preprocessor was given
                 if (name === PRE_PROCESS_SNAPSHOT)
-                    throw fail("Cannot define action '".concat(PRE_PROCESS_SNAPSHOT, "', it should be defined using 'type.preProcessSnapshot(fn)' instead"));
+                    throw new MstError("Cannot define action '".concat(PRE_PROCESS_SNAPSHOT, "', it should be defined using 'type.preProcessSnapshot(fn)' instead"));
                 // warn if postprocessor was given
                 if (name === POST_PROCESS_SNAPSHOT)
-                    throw fail("Cannot define action '".concat(POST_PROCESS_SNAPSHOT, "', it should be defined using 'type.postProcessSnapshot(fn)' instead"));
+                    throw new MstError("Cannot define action '".concat(POST_PROCESS_SNAPSHOT, "', it should be defined using 'type.postProcessSnapshot(fn)' instead"));
                 var action2 = actions[name];
                 // apply hook composition
                 var baseAction = self[name];
@@ -6129,7 +6152,7 @@ var ModelType = /** @class */ (function (_super) {
         value: function (fn) {
             var _this = this;
             if (typeof fn !== "function") {
-                throw fail("You passed an ".concat(typeof fn, " to volatile state as an argument, when function is expected"));
+                throw new MstError("You passed an ".concat(typeof fn, " to volatile state as an argument, when function is expected"));
             }
             var stateInitializer = function (self) {
                 _this.instantiateVolatileState(self, fn(self));
@@ -6145,7 +6168,7 @@ var ModelType = /** @class */ (function (_super) {
         value: function (self, state) {
             // check views return
             if (!isPlainObject(state))
-                throw fail("volatile state initializer should return a plain object containing state");
+                throw new MstError("volatile state initializer should return a plain object containing state");
             mobx.set(self, state);
         }
     });
@@ -6158,7 +6181,7 @@ var ModelType = /** @class */ (function (_super) {
             var initializer = function (self) {
                 var _a = fn(self), actions = _a.actions, views = _a.views, state = _a.state, rest = __rest(_a, ["actions", "views", "state"]);
                 for (var key in rest)
-                    throw fail("The `extend` function should return an object with a subset of the fields 'actions', 'views' and 'state'. Found invalid key '".concat(key, "'"));
+                    throw new MstError("The `extend` function should return an object with a subset of the fields 'actions', 'views' and 'state'. Found invalid key '".concat(key, "'"));
                 if (state)
                     _this.instantiateVolatileState(self, state);
                 if (views)
@@ -6190,7 +6213,7 @@ var ModelType = /** @class */ (function (_super) {
         value: function (self, views) {
             // check views return
             if (!isPlainObject(views))
-                throw fail("views initializer should return a plain object containing views");
+                throw new MstError("views initializer should return a plain object containing views");
             Object.getOwnPropertyNames(views).forEach(function (key) {
                 var _a;
                 // is this a computed property?
@@ -6203,7 +6226,7 @@ var ModelType = /** @class */ (function (_super) {
                     (!devMode() ? addHiddenFinalProp : addHiddenWritableProp)(self, key, descriptor.value);
                 }
                 else {
-                    throw fail("A view member should either be a function or getter based property");
+                    throw new MstError("A view member should either be a function or getter based property");
                 }
             });
         }
@@ -6319,11 +6342,11 @@ var ModelType = /** @class */ (function (_super) {
         value: function (node, key) {
             var _a;
             if (!(key in this.properties))
-                throw fail("Not a value property: " + key);
+                throw new MstError("Not a value property: " + key);
             var adm = mobx._getAdministration(node.storedValue, key);
             var childNode = (_a = adm.raw) === null || _a === void 0 ? void 0 : _a.call(adm);
             if (!childNode)
-                throw fail("Node not available for property " + key);
+                throw new MstError("Node not available for property " + key);
             return childNode;
         }
     });
@@ -6342,7 +6365,7 @@ var ModelType = /** @class */ (function (_super) {
                     atom.reportObserved();
                 }
                 catch (e) {
-                    throw fail("".concat(name, " property is declared twice"));
+                    throw new MstError("".concat(name, " property is declared twice"));
                 }
                 res[name] = _this.getChildNode(node, name).snapshot;
             });
@@ -6370,7 +6393,7 @@ var ModelType = /** @class */ (function (_super) {
         writable: true,
         value: function (node, subpath, patch) {
             if (!(patch.op === "replace" || patch.op === "add")) {
-                throw fail("object does not support operation ".concat(patch.op));
+                throw new MstError("object does not support operation ".concat(patch.op));
             }
             node.storedValue[subpath] = patch.value;
         }
@@ -6482,7 +6505,7 @@ function model() {
         args[_i] = arguments[_i];
     }
     if (devMode() && typeof args[0] !== "string" && args[1]) {
-        throw fail("Model creation failed. First argument must be a string when two arguments are provided");
+        throw new MstError("Model creation failed. First argument must be a string when two arguments are provided");
     }
     var name = typeof args[0] === "string" ? args.shift() : "AnonymousModel";
     var properties = args.shift() || {};
@@ -6729,7 +6752,7 @@ function getPrimitiveFactoryFromValue(value) {
             if (value instanceof Date)
                 return DatePrimitive;
     }
-    throw fail("Cannot determine primitive type from value " + value);
+    throw new MstError("Cannot determine primitive type from value " + value);
 }
 /**
  * Returns if a given value represents a primitive type.
@@ -7049,7 +7072,7 @@ var Union = /** @class */ (function (_super) {
         value: function (parent, subpath, environment, initialValue) {
             var type = this.determineType(initialValue, undefined);
             if (!type)
-                throw fail("No matching type for union " + this.describe()); // can happen in prod builds
+                throw new MstError("No matching type for union " + this.describe()); // can happen in prod builds
             return type.instantiate(parent, subpath, environment, initialValue);
         }
     });
@@ -7060,7 +7083,7 @@ var Union = /** @class */ (function (_super) {
         value: function (current, newValue, parent, subpath) {
             var type = this.determineType(newValue, current.getReconciliationType());
             if (!type)
-                throw fail("No matching type for union " + this.describe()); // can happen in prod builds
+                throw new MstError("No matching type for union " + this.describe()); // can happen in prod builds
             return type.reconcile(current, newValue, parent, subpath);
         }
     });
@@ -7275,7 +7298,7 @@ var OptionalValue = /** @class */ (function (_super) {
 function checkOptionalPreconditions(type, defaultValueOrFunction) {
     // make sure we never pass direct instances
     if (typeof defaultValueOrFunction !== "function" && isStateTreeNode(defaultValueOrFunction)) {
-        throw fail("default value cannot be an instance, pass a snapshot or a function that creates an instance/snapshot instead");
+        throw new MstError("default value cannot be an instance, pass a snapshot or a function that creates an instance/snapshot instead");
     }
     assertIsType(type, 1);
     if (devMode()) {
@@ -7414,10 +7437,10 @@ var Late = /** @class */ (function (_super) {
                         throw e;
                 }
                 if (mustSucceed && t === undefined)
-                    throw fail("Late type seems to be used too early, the definition (still) returns undefined");
+                    throw new MstError("Late type seems to be used too early, the definition (still) returns undefined");
                 if (t) {
                     if (devMode() && !isType(t))
-                        throw fail("Failed to determine subtype, make sure types.late returns a type definition.");
+                        throw new MstError("Failed to determine subtype, make sure types.late returns a type definition.");
                     this._subType = t;
                 }
             }
@@ -7504,7 +7527,7 @@ function late(nameOrType, maybeType) {
     // checks that the type is actually a late type
     if (devMode()) {
         if (!(typeof type === "function" && type.length === 0))
-            throw fail("Invalid late type, expected a function with zero arguments that returns a type, got: " +
+            throw new MstError("Invalid late type, expected a function with zero arguments that returns a type, got: " +
                 type);
     }
     return new Late(name, type);
@@ -7787,15 +7810,15 @@ var StoredReference = /** @class */ (function () {
         else if (isStateTreeNode(value)) {
             var targetNode = getStateTreeNode(value);
             if (!targetNode.identifierAttribute)
-                throw fail("Can only store references with a defined identifier attribute.");
+                throw new MstError("Can only store references with a defined identifier attribute.");
             var id = targetNode.unnormalizedIdentifier;
             if (id === null || id === undefined) {
-                throw fail("Can only store references to tree nodes with a defined identifier.");
+                throw new MstError("Can only store references to tree nodes with a defined identifier.");
             }
             this.identifier = id;
         }
         else {
-            throw fail("Can only store references to tree nodes or identifiers, got: '".concat(value, "'"));
+            throw new MstError("Can only store references to tree nodes or identifiers, got: '".concat(value, "'"));
         }
     }
     Object.defineProperty(StoredReference.prototype, "updateResolvedReference", {
@@ -8177,7 +8200,7 @@ function reference(subType, options) {
     if (devMode()) {
         if (arguments.length === 2 && typeof arguments[1] === "string") {
             // istanbul ignore next
-            throw fail("References with base path are no longer supported. Please remove the base path.");
+            throw new MstError("References with base path are no longer supported. Please remove the base path.");
         }
     }
     var getSetOptions = options ? options : undefined;
@@ -8187,7 +8210,7 @@ function reference(subType, options) {
     if (getSetOptions && (getSetOptions.get || getSetOptions.set)) {
         if (devMode()) {
             if (!getSetOptions.get || !getSetOptions.set) {
-                throw fail("reference options must either contain both a 'get' and a 'set' method or none of them");
+                throw new MstError("reference options must either contain both a 'get' and a 'set' method or none of them");
             }
         }
         return new CustomReferenceType(subType, {
@@ -8265,7 +8288,7 @@ var BaseIdentifierType = /** @class */ (function (_super) {
         writable: true,
         value: function (parent, subpath, environment, initialValue) {
             if (!parent || !(parent.type instanceof ModelType))
-                throw fail("Identifier types can only be instantiated as direct child of a model type");
+                throw new MstError("Identifier types can only be instantiated as direct child of a model type");
             return createScalarNode(this, parent, subpath, environment, initialValue);
         }
     });
@@ -8276,7 +8299,7 @@ var BaseIdentifierType = /** @class */ (function (_super) {
         value: function (current, newValue, parent, subpath) {
             // we don't consider detaching here since identifier are scalar nodes, and scalar nodes cannot be detached
             if (current.storedValue !== newValue)
-                throw fail("Tried to change identifier from '".concat(current.storedValue, "' to '").concat(newValue, "'. Changing identifiers is not allowed."));
+                throw new MstError("Tried to change identifier from '".concat(current.storedValue, "' to '").concat(newValue, "'. Changing identifiers is not allowed."));
             current.setParent(parent, subpath);
             return current;
         }