xstate 6.0.0-beta.2 → 6.0.0-beta.3

package/docs/actor-logic.md

@@ -63,7 +63,7 @@ Choose logic by lifecycle:
 - Use callback logic for a WebSocket, DOM listener or callback API.
 - Use observable logic for a stream such as location or sensor updates.
 
-Async logic produces a final output or error but does not receive events. Callback logic can receive and send events but does not emit snapshots. Machine logic supports both events and snapshots.
+Async logic produces a final output or error but does not receive events. Callback logic can receive and send events. Each `sendBack(event)` enters the callback actor's mailbox and forwards the event to its parent in a transition. This transition publishes a new snapshot with the same content. Machine logic supports both events and snapshots.
 
 Callback logic can receive events and return cleanup:
 

package/docs/api-stability.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "xstateVersion": "6.0.0-beta.2",
+  "xstateVersion": "6.0.0-beta.3",
   "entries": [
     {
       "entry": "packages/core/src/index.ts",
       "package": "xstate",
-      "version": "6.0.0-beta.2",
+      "version": "6.0.0-beta.3",
       "counts": {
         "public": 302,
         "experimental": 44,
@@ -239,7 +239,7 @@
           "name": "advanceSystemTime",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:1217"
+          "location": "packages/core/src/systemTransition.ts:1235"
         },
         {
           "name": "AfterEvent",
@@ -431,13 +431,13 @@
           "name": "CallbackActorLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:37"
+          "location": "packages/core/src/actors/callback.ts:39"
         },
         {
           "name": "CallbackActorRef",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:86"
+          "location": "packages/core/src/actors/callback.ts:88"
         },
         {
           "name": "CallbackActors",
@@ -449,19 +449,19 @@
           "name": "CallbackLogicConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:132"
+          "location": "packages/core/src/actors/callback.ts:134"
         },
         {
           "name": "CallbackLogicFunction",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:98"
+          "location": "packages/core/src/actors/callback.ts:100"
         },
         {
           "name": "CallbackSnapshot",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:26"
+          "location": "packages/core/src/actors/callback.ts:28"
         },
         {
           "name": "CancelExecutableEffect",
@@ -521,7 +521,7 @@
           "name": "createCallbackLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:213"
+          "location": "packages/core/src/actors/callback.ts:215"
         },
         {
           "name": "CreatedInvoke",
@@ -539,7 +539,7 @@
           "name": "createEventObservableLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:393"
+          "location": "packages/core/src/actors/observable.ts:396"
         },
         {
           "name": "CreateInvokeConfig",
@@ -563,7 +563,7 @@
           "name": "createObservableLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:208"
+          "location": "packages/core/src/actors/observable.ts:211"
         },
         {
           "name": "createStateConfig",
@@ -755,13 +755,13 @@
           "name": "EventObservableLogicConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:150"
+          "location": "packages/core/src/actors/observable.ts:153"
         },
         {
           "name": "EventObservableLogicFunction",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:133"
+          "location": "packages/core/src/actors/observable.ts:136"
         },
         {
           "name": "EventPayloadPattern",
@@ -929,13 +929,13 @@
           "name": "initialSystemTransition",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:1174"
+          "location": "packages/core/src/systemTransition.ts:1192"
         },
         {
           "name": "InitialSystemTransitionOptions",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:129"
+          "location": "packages/core/src/systemTransition.ts:130"
         },
         {
           "name": "initialTransition",
@@ -1241,31 +1241,31 @@
           "name": "ObservableActorLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:43"
+          "location": "packages/core/src/actors/observable.ts:46"
         },
         {
           "name": "ObservableActorRef",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:91"
+          "location": "packages/core/src/actors/observable.ts:94"
         },
         {
           "name": "ObservableLogicConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:119"
+          "location": "packages/core/src/actors/observable.ts:122"
         },
         {
           "name": "ObservableLogicFunction",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:102"
+          "location": "packages/core/src/actors/observable.ts:105"
         },
         {
           "name": "ObservableSnapshot",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:27"
+          "location": "packages/core/src/actors/observable.ts:30"
         },
         {
           "name": "Observer",
@@ -1889,13 +1889,13 @@
           "name": "SystemActorReference",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:45"
+          "location": "packages/core/src/systemTransition.ts:46"
         },
         {
           "name": "SystemActorState",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:51"
+          "location": "packages/core/src/systemTransition.ts:52"
         },
         {
           "name": "SystemConfig",
@@ -1907,25 +1907,25 @@
           "name": "SystemEffectResult",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:103"
+          "location": "packages/core/src/systemTransition.ts:104"
         },
         {
           "name": "SystemExternalEffect",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:91"
+          "location": "packages/core/src/systemTransition.ts:92"
         },
         {
           "name": "SystemLogic",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:32"
+          "location": "packages/core/src/systemTransition.ts:33"
         },
         {
           "name": "SystemMessage",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:66"
+          "location": "packages/core/src/systemTransition.ts:67"
         },
         {
           "name": "SystemRegistry",
@@ -1943,19 +1943,19 @@
           "name": "SystemSnapshot",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:110"
+          "location": "packages/core/src/systemTransition.ts:111"
         },
         {
           "name": "SystemTimer",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:76"
+          "location": "packages/core/src/systemTransition.ts:77"
         },
         {
           "name": "systemTransition",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/core/src/systemTransition.ts:1205"
+          "location": "packages/core/src/systemTransition.ts:1223"
         },
         {
           "name": "TagsFrom",
@@ -2172,7 +2172,7 @@
     {
       "entry": "packages/core/src/actors/index.ts",
       "package": "xstate",
-      "version": "6.0.0-beta.2",
+      "version": "6.0.0-beta.3",
       "counts": {
         "public": 46,
         "experimental": 0,
@@ -2226,31 +2226,31 @@
           "name": "CallbackActorLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:37"
+          "location": "packages/core/src/actors/callback.ts:39"
         },
         {
           "name": "CallbackActorRef",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:86"
+          "location": "packages/core/src/actors/callback.ts:88"
         },
         {
           "name": "CallbackLogicConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:132"
+          "location": "packages/core/src/actors/callback.ts:134"
         },
         {
           "name": "CallbackLogicFunction",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:98"
+          "location": "packages/core/src/actors/callback.ts:100"
         },
         {
           "name": "CallbackSnapshot",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:26"
+          "location": "packages/core/src/actors/callback.ts:28"
         },
         {
           "name": "createAsyncLogic",
@@ -2262,7 +2262,7 @@
           "name": "createCallbackLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/callback.ts:213"
+          "location": "packages/core/src/actors/callback.ts:215"
         },
         {
           "name": "createEmptyActor",
@@ -2274,7 +2274,7 @@
           "name": "createEventObservableLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:393"
+          "location": "packages/core/src/actors/observable.ts:396"
         },
         {
           "name": "createListenerLogic",
@@ -2286,7 +2286,7 @@
           "name": "createObservableLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:208"
+          "location": "packages/core/src/actors/observable.ts:211"
         },
         {
           "name": "createStepLogic",
@@ -2304,13 +2304,13 @@
           "name": "EventObservableLogicConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:150"
+          "location": "packages/core/src/actors/observable.ts:153"
         },
         {
           "name": "EventObservableLogicFunction",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:133"
+          "location": "packages/core/src/actors/observable.ts:136"
         },
         {
           "name": "ListenerActorLogic",
@@ -2340,31 +2340,31 @@
           "name": "ObservableActorLogic",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:43"
+          "location": "packages/core/src/actors/observable.ts:46"
         },
         {
           "name": "ObservableActorRef",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:91"
+          "location": "packages/core/src/actors/observable.ts:94"
         },
         {
           "name": "ObservableLogicConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:119"
+          "location": "packages/core/src/actors/observable.ts:122"
         },
         {
           "name": "ObservableLogicFunction",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:102"
+          "location": "packages/core/src/actors/observable.ts:105"
         },
         {
           "name": "ObservableSnapshot",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/actors/observable.ts:27"
+          "location": "packages/core/src/actors/observable.ts:30"
         },
         {
           "name": "StepActorLogic",
@@ -2461,7 +2461,7 @@
     {
       "entry": "packages/core/src/graph/index.ts",
       "package": "xstate",
-      "version": "6.0.0-beta.2",
+      "version": "6.0.0-beta.3",
       "counts": {
         "public": 33,
         "experimental": 0,
@@ -2672,7 +2672,7 @@
     {
       "entry": "packages/core/src/fsm/index.ts",
       "package": "xstate",
-      "version": "6.0.0-beta.2",
+      "version": "6.0.0-beta.3",
       "counts": {
         "public": 15,
         "experimental": 0,
@@ -2684,85 +2684,85 @@
           "name": "createFSM",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:414"
+          "location": "packages/core/src/fsm.ts:415"
         },
         {
           "name": "FSM",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:157"
+          "location": "packages/core/src/fsm.ts:164"
         },
         {
           "name": "FSMArgs",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:11"
+          "location": "packages/core/src/fsm.ts:13"
         },
         {
           "name": "FSMConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:91"
+          "location": "packages/core/src/fsm.ts:98"
         },
         {
           "name": "FSMContextPatch",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:20"
+          "location": "packages/core/src/fsm.ts:22"
         },
         {
           "name": "FSMSetupConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:377"
+          "location": "packages/core/src/fsm.ts:378"
         },
         {
           "name": "FSMSetupReturn",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:386"
+          "location": "packages/core/src/fsm.ts:387"
         },
         {
           "name": "FSMSnapshot",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:126"
+          "location": "packages/core/src/fsm.ts:133"
         },
         {
           "name": "FSMStateConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:74"
+          "location": "packages/core/src/fsm.ts:75"
         },
         {
           "name": "FSMTransition",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:49"
+          "location": "packages/core/src/fsm.ts:51"
         },
         {
           "name": "FSMTransitionConfig",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:24"
+          "location": "packages/core/src/fsm.ts:26"
         },
         {
           "name": "FSMTransitionFunction",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:33"
+          "location": "packages/core/src/fsm.ts:35"
         },
         {
           "name": "FSMTransitionResult",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:145"
+          "location": "packages/core/src/fsm.ts:152"
         },
         {
           "name": "setup",
           "stability": "public",
           "deprecated": false,
-          "location": "packages/core/src/fsm.ts:402"
+          "location": "packages/core/src/fsm.ts:403"
         },
         {
           "name": "types",
@@ -2775,7 +2775,7 @@
     {
       "entry": "packages/core/src/durable/index.ts",
       "package": "xstate",
-      "version": "6.0.0-beta.2",
+      "version": "6.0.0-beta.3",
       "counts": {
         "public": 0,
         "experimental": 13,
@@ -2866,7 +2866,7 @@
     {
       "entry": "packages/core/src/persist/index.ts",
       "package": "xstate",
-      "version": "6.0.0-beta.2",
+      "version": "6.0.0-beta.3",
       "counts": {
         "public": 4,
         "experimental": 0,
@@ -2915,7 +2915,7 @@
     {
       "entry": "packages/core/src/validation/index.ts",
       "package": "xstate",
-      "version": "6.0.0-beta.2",
+      "version": "6.0.0-beta.3",
       "counts": {
         "public": 0,
         "experimental": 10,
@@ -3774,10 +3774,10 @@
     {
       "entry": "packages/xstate-effect/src/index.ts",
       "package": "@xstate/effect",
-      "version": "1.0.0-beta.1",
+      "version": "1.0.0-beta.2",
       "counts": {
         "public": 1,
-        "experimental": 48,
+        "experimental": 50,
         "internal": 0,
         "deprecated": 1
       },
@@ -3794,6 +3794,12 @@
           "deprecated": false,
           "location": "packages/xstate-effect/src/errors.ts:50"
         },
+        {
+          "name": "causeFromError",
+          "stability": "experimental",
+          "deprecated": false,
+          "location": "packages/xstate-effect/src/errors.ts:79"
+        },
         {
           "name": "createEffectActor",
           "stability": "experimental",
@@ -3804,19 +3810,19 @@
           "name": "createEffectEventStreamLogic",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:651"
+          "location": "packages/xstate-effect/src/effectLogic.ts:655"
         },
         {
           "name": "createEffectLogic",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:250"
+          "location": "packages/xstate-effect/src/effectLogic.ts:254"
         },
         {
           "name": "createEffectStreamLogic",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:514"
+          "location": "packages/xstate-effect/src/effectLogic.ts:518"
         },
         {
           "name": "createSnapshotCodec",
@@ -3852,7 +3858,7 @@
           "name": "EffectActorLogic",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:141"
+          "location": "packages/xstate-effect/src/effectLogic.ts:145"
         },
         {
           "name": "EffectActorOptions",
@@ -3876,7 +3882,7 @@
           "name": "EffectLogicBrand",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:43"
+          "location": "packages/xstate-effect/src/effectLogic.ts:47"
         },
         {
           "name": "EffectSchema",
@@ -3912,37 +3918,37 @@
           "name": "EffectSnapshot",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:57"
+          "location": "packages/xstate-effect/src/effectLogic.ts:61"
         },
         {
           "name": "EffectSource",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:86"
+          "location": "packages/xstate-effect/src/effectLogic.ts:90"
         },
         {
           "name": "EffectSourceArgs",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:71"
+          "location": "packages/xstate-effect/src/effectLogic.ts:75"
         },
         {
           "name": "EffectStreamActorLogic",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:170"
+          "location": "packages/xstate-effect/src/effectLogic.ts:174"
         },
         {
           "name": "EffectStreamSnapshot",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:156"
+          "location": "packages/xstate-effect/src/effectLogic.ts:160"
         },
         {
           "name": "EffectStreamSource",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/effectLogic.ts:454"
+          "location": "packages/xstate-effect/src/effectLogic.ts:458"
         },
         {
           "name": "emitted",
@@ -3966,7 +3972,7 @@
           "name": "EventRejectedError",
           "stability": "experimental",
           "deprecated": false,
-          "location": "packages/xstate-effect/src/errors.ts:90"
+          "location": "packages/xstate-effect/src/errors.ts:100"
         },
         {
           "name": "inspect",
@@ -4058,6 +4064,12 @@
           "deprecated": false,
           "location": "packages/xstate-effect/src/schema.ts:156"
         },
+        {
+          "name": "UnwrapEffectFailure",
+          "stability": "experimental",
+          "deprecated": false,
+          "location": "packages/xstate-effect/src/errors.ts:92"
+        },
         {
           "name": "waitFor",
           "stability": "experimental",
@@ -4081,7 +4093,7 @@
     {
       "entry": "packages/xstate-effect/src/atom.ts",
       "package": "@xstate/effect",
-      "version": "1.0.0-beta.1",
+      "version": "1.0.0-beta.2",
       "counts": {
         "public": 0,
         "experimental": 3,
@@ -4112,7 +4124,7 @@
     {
       "entry": "packages/xstate-effect/src/test.ts",
       "package": "@xstate/effect",
-      "version": "1.0.0-beta.1",
+      "version": "1.0.0-beta.2",
       "counts": {
         "public": 0,
         "experimental": 1,
@@ -4131,7 +4143,7 @@
     {
       "entry": "packages/xstate-effect/src/oxlint.ts",
       "package": "@xstate/effect",
-      "version": "1.0.0-beta.1",
+      "version": "1.0.0-beta.2",
       "counts": {
         "public": 0,
         "experimental": 1,