xstate 5.0.2 → 5.2.0

package/dist/xstate.cjs.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.cjs.js');
-var guards_dist_xstateGuards = require('./raise-34e25c2c.cjs.js');
-var log = require('./log-5e226275.cjs.js');
+var guards_dist_xstateGuards = require('./raise-746abff7.cjs.js');
+var log = require('./log-74467f02.cjs.js');
 require('../dev/dist/xstate-dev.cjs.js');
 
 class SimulatedClock {
@@ -12,6 +12,8 @@ class SimulatedClock {
     this.timeouts = new Map();
     this._now = 0;
     this._id = 0;
+    this._flushing = false;
+    this._flushingInvalidated = false;
   }
   now() {
     return this._now;
@@ -20,6 +22,7 @@ class SimulatedClock {
     return this._id++;
   }
   setTimeout(fn, timeout) {
+    this._flushingInvalidated = this._flushing;
     const id = this.getId();
     this.timeouts.set(id, {
       start: this.now(),
@@ -29,6 +32,7 @@ class SimulatedClock {
     return id;
   }
   clearTimeout(id) {
+    this._flushingInvalidated = this._flushing;
     this.timeouts.delete(id);
   }
   set(time) {
@@ -39,16 +43,29 @@ class SimulatedClock {
     this.flushTimeouts();
   }
   flushTimeouts() {
-    [...this.timeouts].sort(([_idA, timeoutA], [_idB, timeoutB]) => {
+    if (this._flushing) {
+      this._flushingInvalidated = true;
+      return;
+    }
+    this._flushing = true;
+    const sorted = [...this.timeouts].sort(([_idA, timeoutA], [_idB, timeoutB]) => {
       const endA = timeoutA.start + timeoutA.timeout;
       const endB = timeoutB.start + timeoutB.timeout;
       return endB > endA ? -1 : 1;
-    }).forEach(([id, timeout]) => {
+    });
+    for (const [id, timeout] of sorted) {
+      if (this._flushingInvalidated) {
+        this._flushingInvalidated = false;
+        this._flushing = false;
+        this.flushTimeouts();
+        return;
+      }
       if (this.now() - timeout.start >= timeout.timeout) {
         this.timeouts.delete(id);
         timeout.fn.call(null);
       }
-    });
+    }
+    this._flushing = false;
   }
   increment(ms) {
     this._now += ms;
@@ -390,6 +407,7 @@ class StateMachine {
     this.version = this.config.version;
     this.transition = this.transition.bind(this);
     this.getInitialSnapshot = this.getInitialSnapshot.bind(this);
+    this.getPersistedSnapshot = this.getPersistedSnapshot.bind(this);
     this.restoreSnapshot = this.restoreSnapshot.bind(this);
     this.start = this.start.bind(this);
     this.root = new StateNode(config, {
@@ -692,6 +710,39 @@ function setup({
   };
 }
 
+/**
+ * Returns a promise that resolves to the `output` of the actor when it is done.
+ *
+ * @example
+ * ```ts
+ * const machine = createMachine({
+ *   // ...
+ *   output: {
+ *     count: 42
+ *   }
+ * });
+ *
+ * const actor = createActor(machine);
+ *
+ * actor.start();
+ *
+ * const output = await toPromise(actor);
+ *
+ * console.log(output);
+ * // logs { count: 42 }
+ * ```
+ */
+function toPromise(actor) {
+  return new Promise((resolve, reject) => {
+    actor.subscribe({
+      complete: () => {
+        resolve(actor.getSnapshot().output);
+      },
+      error: reject
+    });
+  });
+}
+
 exports.createEmptyActor = actors_dist_xstateActors.createEmptyActor;
 exports.fromCallback = actors_dist_xstateActors.fromCallback;
 exports.fromEventObservable = actors_dist_xstateActors.fromEventObservable;
@@ -728,4 +779,5 @@ exports.StateMachine = StateMachine;
 exports.StateNode = StateNode;
 exports.createMachine = createMachine;
 exports.setup = setup;
+exports.toPromise = toPromise;
 exports.waitFor = waitFor;

package/dist/xstate.cjs.mjs

@@ -35,5 +35,6 @@ export {
   stop,
   stopChild,
   toObserver,
+  toPromise,
   waitFor
 } from "./xstate.cjs.js";

package/dist/xstate.development.cjs.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var actors_dist_xstateActors = require('../actors/dist/xstate-actors.development.cjs.js');
-var guards_dist_xstateGuards = require('./raise-62704519.development.cjs.js');
-var log = require('./log-641cd926.development.cjs.js');
+var guards_dist_xstateGuards = require('./raise-6fb30f8b.development.cjs.js');
+var log = require('./log-a56e34a9.development.cjs.js');
 require('../dev/dist/xstate-dev.development.cjs.js');
 
 class SimulatedClock {
@@ -12,6 +12,8 @@ class SimulatedClock {
     this.timeouts = new Map();
     this._now = 0;
     this._id = 0;
+    this._flushing = false;
+    this._flushingInvalidated = false;
   }
   now() {
     return this._now;
@@ -20,6 +22,7 @@ class SimulatedClock {
     return this._id++;
   }
   setTimeout(fn, timeout) {
+    this._flushingInvalidated = this._flushing;
     const id = this.getId();
     this.timeouts.set(id, {
       start: this.now(),
@@ -29,6 +32,7 @@ class SimulatedClock {
     return id;
   }
   clearTimeout(id) {
+    this._flushingInvalidated = this._flushing;
     this.timeouts.delete(id);
   }
   set(time) {
@@ -39,16 +43,29 @@ class SimulatedClock {
     this.flushTimeouts();
   }
   flushTimeouts() {
-    [...this.timeouts].sort(([_idA, timeoutA], [_idB, timeoutB]) => {
+    if (this._flushing) {
+      this._flushingInvalidated = true;
+      return;
+    }
+    this._flushing = true;
+    const sorted = [...this.timeouts].sort(([_idA, timeoutA], [_idB, timeoutB]) => {
       const endA = timeoutA.start + timeoutA.timeout;
       const endB = timeoutB.start + timeoutB.timeout;
       return endB > endA ? -1 : 1;
-    }).forEach(([id, timeout]) => {
+    });
+    for (const [id, timeout] of sorted) {
+      if (this._flushingInvalidated) {
+        this._flushingInvalidated = false;
+        this._flushing = false;
+        this.flushTimeouts();
+        return;
+      }
       if (this.now() - timeout.start >= timeout.timeout) {
         this.timeouts.delete(id);
         timeout.fn.call(null);
       }
-    });
+    }
+    this._flushing = false;
   }
   increment(ms) {
     this._now += ms;
@@ -390,6 +407,7 @@ class StateMachine {
     this.version = this.config.version;
     this.transition = this.transition.bind(this);
     this.getInitialSnapshot = this.getInitialSnapshot.bind(this);
+    this.getPersistedSnapshot = this.getPersistedSnapshot.bind(this);
     this.restoreSnapshot = this.restoreSnapshot.bind(this);
     this.start = this.start.bind(this);
     this.root = new StateNode(config, {
@@ -698,6 +716,39 @@ function setup({
   };
 }
 
+/**
+ * Returns a promise that resolves to the `output` of the actor when it is done.
+ *
+ * @example
+ * ```ts
+ * const machine = createMachine({
+ *   // ...
+ *   output: {
+ *     count: 42
+ *   }
+ * });
+ *
+ * const actor = createActor(machine);
+ *
+ * actor.start();
+ *
+ * const output = await toPromise(actor);
+ *
+ * console.log(output);
+ * // logs { count: 42 }
+ * ```
+ */
+function toPromise(actor) {
+  return new Promise((resolve, reject) => {
+    actor.subscribe({
+      complete: () => {
+        resolve(actor.getSnapshot().output);
+      },
+      error: reject
+    });
+  });
+}
+
 exports.createEmptyActor = actors_dist_xstateActors.createEmptyActor;
 exports.fromCallback = actors_dist_xstateActors.fromCallback;
 exports.fromEventObservable = actors_dist_xstateActors.fromEventObservable;
@@ -734,4 +785,5 @@ exports.StateMachine = StateMachine;
 exports.StateNode = StateNode;
 exports.createMachine = createMachine;
 exports.setup = setup;
+exports.toPromise = toPromise;
 exports.waitFor = waitFor;

package/dist/xstate.development.cjs.mjs

@@ -35,5 +35,6 @@ export {
   stop,
   stopChild,
   toObserver,
+  toPromise,
   waitFor
 } from "./xstate.development.cjs.js";

package/dist/xstate.development.esm.js

@@ -1,8 +1,8 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.development.esm.js';
-import { S as STATE_DELIMITER, m as mapValues, t as toArray, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as isStateId, w as getStateNodeByPath, x as getPersistedSnapshot, y as resolveReferencedActor, z as createActor, $ as $$ACTOR_TYPE } from './raise-89c581c4.development.esm.js';
-export { A as Actor, G as __unsafe_getAllOwnEventDescriptors, H as and, L as cancel, z as createActor, j as getStateNodes, B as interpret, C as isMachineSnapshot, D as matchesState, I as not, J as or, E as pathToStateValue, M as raise, O as spawnChild, K as stateIn, P as stop, Q as stopChild, F as toObserver } from './raise-89c581c4.development.esm.js';
-import { a as assign } from './log-f196f85f.development.esm.js';
-export { S as SpecialTargets, a as assign, e as enqueueActions, f as forwardTo, l as log, s as sendParent, b as sendTo } from './log-f196f85f.development.esm.js';
+import { S as STATE_DELIMITER, m as mapValues, t as toArray, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as isStateId, w as getStateNodeByPath, x as getPersistedSnapshot, y as resolveReferencedActor, z as createActor, $ as $$ACTOR_TYPE } from './raise-0ff85b7b.development.esm.js';
+export { A as Actor, H as __unsafe_getAllOwnEventDescriptors, D as and, L as cancel, z as createActor, j as getStateNodes, B as interpret, C as isMachineSnapshot, I as matchesState, E as not, F as or, J as pathToStateValue, M as raise, O as spawnChild, G as stateIn, P as stop, Q as stopChild, K as toObserver } from './raise-0ff85b7b.development.esm.js';
+import { a as assign } from './log-557e5fa3.development.esm.js';
+export { S as SpecialTargets, a as assign, e as enqueueActions, f as forwardTo, l as log, s as sendParent, b as sendTo } from './log-557e5fa3.development.esm.js';
 import '../dev/dist/xstate-dev.development.esm.js';
 
 class SimulatedClock {
@@ -10,6 +10,8 @@ class SimulatedClock {
     this.timeouts = new Map();
     this._now = 0;
     this._id = 0;
+    this._flushing = false;
+    this._flushingInvalidated = false;
   }
   now() {
     return this._now;
@@ -18,6 +20,7 @@ class SimulatedClock {
     return this._id++;
   }
   setTimeout(fn, timeout) {
+    this._flushingInvalidated = this._flushing;
     const id = this.getId();
     this.timeouts.set(id, {
       start: this.now(),
@@ -27,6 +30,7 @@ class SimulatedClock {
     return id;
   }
   clearTimeout(id) {
+    this._flushingInvalidated = this._flushing;
     this.timeouts.delete(id);
   }
   set(time) {
@@ -37,16 +41,29 @@ class SimulatedClock {
     this.flushTimeouts();
   }
   flushTimeouts() {
-    [...this.timeouts].sort(([_idA, timeoutA], [_idB, timeoutB]) => {
+    if (this._flushing) {
+      this._flushingInvalidated = true;
+      return;
+    }
+    this._flushing = true;
+    const sorted = [...this.timeouts].sort(([_idA, timeoutA], [_idB, timeoutB]) => {
       const endA = timeoutA.start + timeoutA.timeout;
       const endB = timeoutB.start + timeoutB.timeout;
       return endB > endA ? -1 : 1;
-    }).forEach(([id, timeout]) => {
+    });
+    for (const [id, timeout] of sorted) {
+      if (this._flushingInvalidated) {
+        this._flushingInvalidated = false;
+        this._flushing = false;
+        this.flushTimeouts();
+        return;
+      }
       if (this.now() - timeout.start >= timeout.timeout) {
         this.timeouts.delete(id);
         timeout.fn.call(null);
       }
-    });
+    }
+    this._flushing = false;
   }
   increment(ms) {
     this._now += ms;
@@ -388,6 +405,7 @@ class StateMachine {
     this.version = this.config.version;
     this.transition = this.transition.bind(this);
     this.getInitialSnapshot = this.getInitialSnapshot.bind(this);
+    this.getPersistedSnapshot = this.getPersistedSnapshot.bind(this);
     this.restoreSnapshot = this.restoreSnapshot.bind(this);
     this.start = this.start.bind(this);
     this.root = new StateNode(config, {
@@ -696,4 +714,37 @@ function setup({
   };
 }
 
-export { SimulatedClock, StateMachine, StateNode, createMachine, setup, waitFor };
+/**
+ * Returns a promise that resolves to the `output` of the actor when it is done.
+ *
+ * @example
+ * ```ts
+ * const machine = createMachine({
+ *   // ...
+ *   output: {
+ *     count: 42
+ *   }
+ * });
+ *
+ * const actor = createActor(machine);
+ *
+ * actor.start();
+ *
+ * const output = await toPromise(actor);
+ *
+ * console.log(output);
+ * // logs { count: 42 }
+ * ```
+ */
+function toPromise(actor) {
+  return new Promise((resolve, reject) => {
+    actor.subscribe({
+      complete: () => {
+        resolve(actor.getSnapshot().output);
+      },
+      error: reject
+    });
+  });
+}
+
+export { SimulatedClock, StateMachine, StateNode, createMachine, setup, toPromise, waitFor };

package/dist/xstate.esm.js

@@ -1,8 +1,8 @@
 export { createEmptyActor, fromCallback, fromEventObservable, fromObservable, fromPromise, fromTransition } from '../actors/dist/xstate-actors.esm.js';
-import { S as STATE_DELIMITER, m as mapValues, t as toArray, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as isStateId, w as getStateNodeByPath, x as getPersistedSnapshot, y as resolveReferencedActor, z as createActor, $ as $$ACTOR_TYPE } from './raise-8bc422d1.esm.js';
-export { A as Actor, G as __unsafe_getAllOwnEventDescriptors, H as and, L as cancel, z as createActor, j as getStateNodes, B as interpret, C as isMachineSnapshot, D as matchesState, I as not, J as or, E as pathToStateValue, M as raise, O as spawnChild, K as stateIn, P as stop, Q as stopChild, F as toObserver } from './raise-8bc422d1.esm.js';
-import { a as assign } from './log-22e678c5.esm.js';
-export { S as SpecialTargets, a as assign, e as enqueueActions, f as forwardTo, l as log, s as sendParent, b as sendTo } from './log-22e678c5.esm.js';
+import { S as STATE_DELIMITER, m as mapValues, t as toArray, f as formatTransitions, a as toTransitionConfigArray, b as formatTransition, N as NULL_EVENT, e as evaluateGuard, c as createInvokeId, g as getDelayedTransitions, d as formatInitialTransition, h as getCandidates, r as resolveStateValue, i as getAllStateNodes, j as getStateNodes, k as createMachineSnapshot, l as isInFinalState, n as macrostep, o as transitionNode, p as resolveActionsAndContext, q as createInitEvent, s as microstep, u as getInitialStateNodes, v as isStateId, w as getStateNodeByPath, x as getPersistedSnapshot, y as resolveReferencedActor, z as createActor, $ as $$ACTOR_TYPE } from './raise-5d7ae4b7.esm.js';
+export { A as Actor, H as __unsafe_getAllOwnEventDescriptors, D as and, L as cancel, z as createActor, j as getStateNodes, B as interpret, C as isMachineSnapshot, I as matchesState, E as not, F as or, J as pathToStateValue, M as raise, O as spawnChild, G as stateIn, P as stop, Q as stopChild, K as toObserver } from './raise-5d7ae4b7.esm.js';
+import { a as assign } from './log-5409ee89.esm.js';
+export { S as SpecialTargets, a as assign, e as enqueueActions, f as forwardTo, l as log, s as sendParent, b as sendTo } from './log-5409ee89.esm.js';
 import '../dev/dist/xstate-dev.esm.js';
 
 class SimulatedClock {
@@ -10,6 +10,8 @@ class SimulatedClock {
     this.timeouts = new Map();
     this._now = 0;
     this._id = 0;
+    this._flushing = false;
+    this._flushingInvalidated = false;
   }
   now() {
     return this._now;
@@ -18,6 +20,7 @@ class SimulatedClock {
     return this._id++;
   }
   setTimeout(fn, timeout) {
+    this._flushingInvalidated = this._flushing;
     const id = this.getId();
     this.timeouts.set(id, {
       start: this.now(),
@@ -27,6 +30,7 @@ class SimulatedClock {
     return id;
   }
   clearTimeout(id) {
+    this._flushingInvalidated = this._flushing;
     this.timeouts.delete(id);
   }
   set(time) {
@@ -37,16 +41,29 @@ class SimulatedClock {
     this.flushTimeouts();
   }
   flushTimeouts() {
-    [...this.timeouts].sort(([_idA, timeoutA], [_idB, timeoutB]) => {
+    if (this._flushing) {
+      this._flushingInvalidated = true;
+      return;
+    }
+    this._flushing = true;
+    const sorted = [...this.timeouts].sort(([_idA, timeoutA], [_idB, timeoutB]) => {
       const endA = timeoutA.start + timeoutA.timeout;
       const endB = timeoutB.start + timeoutB.timeout;
       return endB > endA ? -1 : 1;
-    }).forEach(([id, timeout]) => {
+    });
+    for (const [id, timeout] of sorted) {
+      if (this._flushingInvalidated) {
+        this._flushingInvalidated = false;
+        this._flushing = false;
+        this.flushTimeouts();
+        return;
+      }
       if (this.now() - timeout.start >= timeout.timeout) {
         this.timeouts.delete(id);
         timeout.fn.call(null);
       }
-    });
+    }
+    this._flushing = false;
   }
   increment(ms) {
     this._now += ms;
@@ -388,6 +405,7 @@ class StateMachine {
     this.version = this.config.version;
     this.transition = this.transition.bind(this);
     this.getInitialSnapshot = this.getInitialSnapshot.bind(this);
+    this.getPersistedSnapshot = this.getPersistedSnapshot.bind(this);
     this.restoreSnapshot = this.restoreSnapshot.bind(this);
     this.start = this.start.bind(this);
     this.root = new StateNode(config, {
@@ -690,4 +708,37 @@ function setup({
   };
 }
 
-export { SimulatedClock, StateMachine, StateNode, createMachine, setup, waitFor };
+/**
+ * Returns a promise that resolves to the `output` of the actor when it is done.
+ *
+ * @example
+ * ```ts
+ * const machine = createMachine({
+ *   // ...
+ *   output: {
+ *     count: 42
+ *   }
+ * });
+ *
+ * const actor = createActor(machine);
+ *
+ * actor.start();
+ *
+ * const output = await toPromise(actor);
+ *
+ * console.log(output);
+ * // logs { count: 42 }
+ * ```
+ */
+function toPromise(actor) {
+  return new Promise((resolve, reject) => {
+    actor.subscribe({
+      complete: () => {
+        resolve(actor.getSnapshot().output);
+      },
+      error: reject
+    });
+  });
+}
+
+export { SimulatedClock, StateMachine, StateNode, createMachine, setup, toPromise, waitFor };