@genesislcap/foundation-state-machine 15.24.0-FUI-2603.10 → 15.24.0

package/dist/dts/core/actions.d.ts

@@ -18,14 +18,9 @@ export declare const setError: {
  * Set error by key action.
  * @remarks
  * Used to set an error in the {@link @genesislcap/foundation-utils#ErrorMap} by key.
- * Prefers an existing `context.error` over the current event. Callers that start a new
- * operation must clear the previous error first (e.g. `clearErrors` / `resetContext`);
- * otherwise a stale `context.error` is re-keyed under this key and a later done-output
- * Error is ignored. When `setError` matches no branch it returns `undefined` and leaves
- * the prior `context.error` in place — which is what makes clearing mandatory.
  * @privateRemarks
- * Contains done event handling to deal with 200 Nacks. Precedence: `context.error`, then
- * `event.data` (error event), then done `event.output` when it is an `Error`.
+ * Contains done event handling to deal with 200 Nacks. If done output is an error use it, or fallback to `context.error`
+ * and set that under the provided key.
  * @param key - The error key.
  * @public
  */

package/dist/dts/core/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/core/actions.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;;;CAYnB,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM;;;;;;;CAkBrC,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;CAA2C,CAAC"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/core/actions.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;;;CAYnB,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM;;;;;;;CAgBrC,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;CAA2C,CAAC"}

package/dist/dts/core/state.d.ts

@@ -2,10 +2,6 @@ import type { StateNodeConfig } from 'xstate';
 /**
  * Creates an error state node.
  *
- * @remarks
- * Entry runs {@link setErrorByKey}, which prefers an existing `context.error`. Ensure
- * the prior error was cleared before entering a new operation that may land here.
- *
  * @param key - An error state key.
  * @param metaContent - An optional meta content value.
  * @param final - An optional flag which adds final with output functionality.

package/dist/dts/core/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/core/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAG9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAC/B,KAAK,MAAM,EACX,cAAc,MAAM,EACpB,QAAO,OAAc,KACpB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAcpC,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/core/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAI9C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,KAAK,MAAM,EACX,cAAc,MAAM,EACpB,QAAO,OAAc,KACpB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CA4BpC,CAAC"}

package/dist/dts/machines/fetch/machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../../src/machines/fetch/machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,OAAO,EACL,eAAe,EAOf,OAAO,EAER,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAEjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3C;;OAEG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;OAEG;IACH,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,mEAAoC,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;CAAG;AAExF;;;GAGG;AACH,qBAAa,mBACX,SAAQ,eAAe,CAAC,mBAAmB,EAAE,iBAAiB,CAC9D,YAAW,YAAY;IAEY,OAAO,CAAC,MAAM;gBAAN,MAAM,cAAqB;IAwLtE,kCAAkC;IAClC,KAAK,CACH,OAAO,GAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,OAAO,CAE9C;IAKH,6CAA6C;IAC7C,gBAAgB,IAAI,IAAI;CAGzB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,oEAExB,CAAC"}
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../../src/machines/fetch/machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,OAAO,EACL,eAAe,EAOf,OAAO,EAER,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAEjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3C;;OAEG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;OAEG;IACH,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,mEAAoC,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;CAAG;AAExF;;;GAGG;AACH,qBAAa,mBACX,SAAQ,eAAe,CAAC,mBAAmB,EAAE,iBAAiB,CAC9D,YAAW,YAAY;IAEY,OAAO,CAAC,MAAM;gBAAN,MAAM,cAAqB;IAkLtE,kCAAkC;IAClC,KAAK,CACH,OAAO,GAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,OAAO,CAE9C;IAKH,6CAA6C;IAC7C,gBAAgB,IAAI,IAAI;CAGzB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,oEAExB,CAAC"}

package/dist/esm/core/actions.js

@@ -28,28 +28,21 @@ export const setError = assign(({ event }) => {
  * Set error by key action.
  * @remarks
  * Used to set an error in the {@link @genesislcap/foundation-utils#ErrorMap} by key.
- * Prefers an existing `context.error` over the current event. Callers that start a new
- * operation must clear the previous error first (e.g. `clearErrors` / `resetContext`);
- * otherwise a stale `context.error` is re-keyed under this key and a later done-output
- * Error is ignored. When `setError` matches no branch it returns `undefined` and leaves
- * the prior `context.error` in place — which is what makes clearing mandatory.
  * @privateRemarks
- * Contains done event handling to deal with 200 Nacks. Precedence: `context.error`, then
- * `event.data` (error event), then done `event.output` when it is an `Error`.
+ * Contains done event handling to deal with 200 Nacks. If done output is an error use it, or fallback to `context.error`
+ * and set that under the provided key.
  * @param key - The error key.
  * @public
  */
 export const setErrorByKey = (key) => assign(({ context, event }) => {
     var _a;
-    let error = context.error;
-    if (!error) {
-        if (isErrorEvent(event)) {
-            error = event.data;
-        }
-        else if (isDoneInvokeEvent(event)) {
-            logger.debug(`setErrorByKey action called with non error event type.`, event);
-            error = event.output instanceof Error ? event.output : undefined;
-        }
+    let error;
+    if (isErrorEvent(event)) {
+        error = event.data;
+    }
+    else if (isDoneInvokeEvent(event)) {
+        logger.debug(`setErrorByKey action called with non error event type.`, event);
+        error = event.output instanceof Error ? event.output : context.error;
     }
     if (error) {
         const errors = (_a = context.errors) !== null && _a !== void 0 ? _a : createErrorMap(logger.error);

package/dist/esm/core/state.js

@@ -1,26 +1,36 @@
-import { setErrorByKey } from './actions';
+import { escalateError, setErrorByKey } from './actions';
 /**
  * Creates an error state node.
  *
- * @remarks
- * Entry runs {@link setErrorByKey}, which prefers an existing `context.error`. Ensure
- * the prior error was cleared before entering a new operation that may land here.
- *
  * @param key - An error state key.
  * @param metaContent - An optional meta content value.
  * @param final - An optional flag which adds final with output functionality.
  * @public
  */
 export const createErrorStateNode = (key, metaContent, final = true) => {
+    /**
+     * Raised question on reuse and dynamic parent detection, regarding error escalation.
+     * https://github.com/statelyai/xstate/discussions/4268
+     */
+    let hasParentMachine = false;
+    let sentToParentMachine = false;
     return {
         tags: ['error', key],
         meta: {
             content: metaContent ? metaContent : `${key} error.`,
         },
-        entry: [setErrorByKey(`${key}-error`)],
+        entry: [
+            setErrorByKey(`${key}-error`),
+            (args) => (hasParentMachine = args.self._parent !== undefined),
+        ],
+        always: [
+            {
+                guard: () => hasParentMachine && !sentToParentMachine,
+                actions: [escalateError, () => (sentToParentMachine = true)],
+            },
+        ],
         /**
          * Provide final output to parent machines.
-         * Notification of invoked parents is via this output / top-level `failed`, not escalate closures.
          */
         type: final ? 'final' : 'atomic',
         output: ({ context }) => context.error,

package/dist/esm/machines/fetch/machine.js

@@ -92,12 +92,6 @@ let DefaultFetchMachine = class DefaultFetchMachine extends AbstractMachine {
                         abort: createErrorStateNode('abort', 'Abort error.'),
                         syntax: createErrorStateNode('syntax', 'Syntax error.'),
                     },
-                    onDone: 'failed',
-                },
-                failed: {
-                    tags: ['error'],
-                    type: 'final',
-                    output: ({ context }) => context.error,
                 },
             },
             on: {

package/dist/foundation-state-machine.api.json

@@ -1715,7 +1715,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-state-machine!createErrorStateNode:function(1)",
-          "docComment": "/**\n * Creates an error state node.\n *\n * @remarks\n *\n * Entry runs {@link setErrorByKey}, which prefers an existing `context.error`. Ensure the prior error was cleared before entering a new operation that may land here.\n *\n * @param key - An error state key.\n *\n * @param metaContent - An optional meta content value.\n *\n * @param final - An optional flag which adds final with output functionality.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Creates an error state node.\n *\n * @param key - An error state key.\n *\n * @param metaContent - An optional meta content value.\n *\n * @param final - An optional flag which adds final with output functionality.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -6424,7 +6424,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-state-machine!setErrorByKey:function(1)",
-          "docComment": "/**\n * Set error by key action.\n *\n * @remarks\n *\n * Used to set an error in the {@link @genesislcap/foundation-utils#ErrorMap} by key. Prefers an existing `context.error` over the current event. Callers that start a new operation must clear the previous error first (e.g. `clearErrors` / `resetContext`); otherwise a stale `context.error` is re-keyed under this key and a later done-output Error is ignored. When `setError` matches no branch it returns `undefined` and leaves the prior `context.error` in place — which is what makes clearing mandatory.\n *\n * @param key - The error key.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Set error by key action.\n *\n * @remarks\n *\n * Used to set an error in the {@link @genesislcap/foundation-utils#ErrorMap} by key.\n *\n * @param key - The error key.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",

package/dist/foundation-state-machine.d.ts

@@ -166,10 +166,6 @@ export { assign }
 /**
  * Creates an error state node.
  *
- * @remarks
- * Entry runs {@link setErrorByKey}, which prefers an existing `context.error`. Ensure
- * the prior error was cleared before entering a new operation that may land here.
- *
  * @param key - An error state key.
  * @param metaContent - An optional meta content value.
  * @param final - An optional flag which adds final with output functionality.
@@ -918,14 +914,9 @@ export declare const setError: {
  * Set error by key action.
  * @remarks
  * Used to set an error in the {@link @genesislcap/foundation-utils#ErrorMap} by key.
- * Prefers an existing `context.error` over the current event. Callers that start a new
- * operation must clear the previous error first (e.g. `clearErrors` / `resetContext`);
- * otherwise a stale `context.error` is re-keyed under this key and a later done-output
- * Error is ignored. When `setError` matches no branch it returns `undefined` and leaves
- * the prior `context.error` in place — which is what makes clearing mandatory.
  * @privateRemarks
- * Contains done event handling to deal with 200 Nacks. Precedence: `context.error`, then
- * `event.data` (error event), then done `event.output` when it is an `Error`.
+ * Contains done event handling to deal with 200 Nacks. If done output is an error use it, or fallback to `context.error`
+ * and set that under the provided key.
  * @param key - The error key.
  * @public
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-state-machine",
   "description": "Genesis Foundation State Machine",
-  "version": "15.24.0-FUI-2603.10",
+  "version": "15.24.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -54,18 +54,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.24.0-FUI-2603.10",
-    "@genesislcap/genx": "15.24.0-FUI-2603.10",
-    "@genesislcap/rollup-builder": "15.24.0-FUI-2603.10",
-    "@genesislcap/ts-builder": "15.24.0-FUI-2603.10",
-    "@genesislcap/uvu-playwright-builder": "15.24.0-FUI-2603.10",
-    "@genesislcap/vite-builder": "15.24.0-FUI-2603.10",
-    "@genesislcap/webpack-builder": "15.24.0-FUI-2603.10"
+    "@genesislcap/foundation-testing": "15.24.0",
+    "@genesislcap/genx": "15.24.0",
+    "@genesislcap/rollup-builder": "15.24.0",
+    "@genesislcap/ts-builder": "15.24.0",
+    "@genesislcap/uvu-playwright-builder": "15.24.0",
+    "@genesislcap/vite-builder": "15.24.0",
+    "@genesislcap/webpack-builder": "15.24.0"
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "15.24.0-FUI-2603.10",
-    "@genesislcap/foundation-logger": "15.24.0-FUI-2603.10",
-    "@genesislcap/foundation-utils": "15.24.0-FUI-2603.10",
+    "@genesislcap/foundation-comms": "15.24.0",
+    "@genesislcap/foundation-logger": "15.24.0",
+    "@genesislcap/foundation-utils": "15.24.0",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.50.0",
     "cockatiel": "^3.1.1",