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

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

@@ -18,9 +18,14 @@ 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. If done output is an error use it, or fallback to `context.error`
- * and set that under the provided key.
+ * 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`.
  * @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;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM;;;;;;;CAgBrC,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;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM;;;;;;;CAkBrC,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;CAA2C,CAAC"}

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

@@ -2,6 +2,10 @@ 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;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"}
+{"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"}

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;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"}
+{"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"}

package/dist/esm/core/actions.js

@@ -28,21 +28,28 @@ 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. If done output is an error use it, or fallback to `context.error`
- * and set that under the provided key.
+ * 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`.
  * @param key - The error key.
  * @public
  */
 export const setErrorByKey = (key) => assign(({ context, event }) => {
     var _a;
-    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;
+    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;
+        }
     }
     if (error) {
         const errors = (_a = context.errors) !== null && _a !== void 0 ? _a : createErrorMap(logger.error);

package/dist/esm/core/state.js

@@ -1,36 +1,26 @@
-import { escalateError, setErrorByKey } from './actions';
+import { 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`),
-            (args) => (hasParentMachine = args.self._parent !== undefined),
-        ],
-        always: [
-            {
-                guard: () => hasParentMachine && !sentToParentMachine,
-                actions: [escalateError, () => (sentToParentMachine = true)],
-            },
-        ],
+        entry: [setErrorByKey(`${key}-error`)],
         /**
          * 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,6 +92,12 @@ 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 * @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 * @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",
           "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.\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. 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",
           "excerptTokens": [
             {
               "kind": "Content",

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

@@ -166,6 +166,10 @@ 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.
@@ -914,9 +918,14 @@ 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. If done output is an error use it, or fallback to `context.error`
- * and set that under the provided key.
+ * 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`.
  * @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.23.3",
+  "version": "15.24.0-FUI-2603.10",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -54,18 +54,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.23.3",
-    "@genesislcap/genx": "15.23.3",
-    "@genesislcap/rollup-builder": "15.23.3",
-    "@genesislcap/ts-builder": "15.23.3",
-    "@genesislcap/uvu-playwright-builder": "15.23.3",
-    "@genesislcap/vite-builder": "15.23.3",
-    "@genesislcap/webpack-builder": "15.23.3"
+    "@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"
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "15.23.3",
-    "@genesislcap/foundation-logger": "15.23.3",
-    "@genesislcap/foundation-utils": "15.23.3",
+    "@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",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.50.0",
     "cockatiel": "^3.1.1",