@genesislcap/foundation-state-machine 14.94.2 → 14.96.0

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

@@ -3,7 +3,7 @@
 import { ActionArgs } from 'xstate';
 import { AnyActorContext } from 'xstate';
 import { AnyActorRef } from 'xstate';
-import type { AnyEventObject } from 'xstate';
+import { AnyEventObject } from 'xstate';
 import { AnyState } from 'xstate';
 import { Assigner } from 'xstate';
 import { BindingObserver } from '@microsoft/fast-element';
@@ -34,6 +34,7 @@ import type { ProvidedActor } from 'xstate';
 import type { ResolveTypegenMeta } from 'xstate';
 import { RetryPolicy } from 'cockatiel';
 import { SendExpr } from 'xstate';
+import type { State } from 'xstate';
 import type { StateMachine } from 'xstate';
 import type { StateNodeConfig } from 'xstate';
 import type { StateValue } from 'xstate';
@@ -56,6 +57,8 @@ export declare abstract class AbstractMachine<TContext extends MachineContext, T
     machine: StateMachine<TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta>;
     /** {@inheritDoc Machine.actor} */
     actor: InterpreterFrom<StateMachine<TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta>>;
+    /** {@inheritDoc Machine.snapshot} */
+    snapshot: State<TContext, TEvent, TActor, TResolvedTypesMeta>;
     /** {@inheritDoc Machine.state} */
     state: StateValue;
     /** {@inheritDoc Machine.startingState} */
@@ -64,6 +67,8 @@ export declare abstract class AbstractMachine<TContext extends MachineContext, T
     context: Partial<TContext>;
     /** {@inheritDoc Machine.startingContext} */
     startingContext: Partial<TContext>;
+    /** {@inheritDoc Machine.meta} */
+    meta: Record<string, any>;
     /** {@inheritDoc Machine.complete} */
     complete: boolean;
     /** {@inheritDoc Machine.output} */
@@ -88,6 +93,10 @@ export declare abstract class AbstractMachine<TContext extends MachineContext, T
      * @internal
      */
     protected subscribe(): void;
+    /**
+     * @internal
+     */
+    protected applySnapshot(snapshot?: typeof AbstractMachine.snapshot): void;
     /**
      * @internal
      */
@@ -106,6 +115,8 @@ export declare abstract class AbstractMachine<TContext extends MachineContext, T
     matches(value: StateValueFrom<typeof AbstractMachine.machine>): boolean;
     /** {@inheritDoc Machine.hasTag} */
     hasTag(tag: string): boolean;
+    /** {@inheritDoc Machine.getMetaValuesByKey} */
+    getMetaValuesByKey<T = string>(key?: string): T[];
     /** {@inheritDoc Machine.send} */
     send(event: TEvent): void;
     /** {@inheritDoc Machine.onSendEvent} */
@@ -126,6 +137,10 @@ export declare class APIError extends Error {
     status: number;
     data?: unknown;
     constructor(status: number, data?: unknown, message?: string);
+    /**
+     * @public
+     */
+    isUnauthorized(): boolean;
 }
 
 /**
@@ -240,7 +255,7 @@ export declare const errorWorkflowInput: (key: string) => ({ context }: {
 }) => ErrorWorkflowInput;
 
 /**
- * Escalate error action.
+ * Escalate context error action.
  * @remarks
  * Guard this call with a parent check to avoid warnings when there's no parent.
  * @public
@@ -432,7 +447,7 @@ export declare const isActorErrorEvent: <TData = any>(actorId: string, event: Ev
  * @param error - An error.
  * @public
  */
-export declare const isAPIError: (error: unknown) => boolean;
+export declare const isAPIError: (error: unknown) => error is APIError;
 
 /**
  * isDoneInvokeEvent.
@@ -464,23 +479,30 @@ export declare const isErrorEvent: <TData = any>(event: EventObject | ErrorEvent
  */
 export declare const isErrorType: <TType extends ErrorConstructor>(type: TType) => (event: any) => boolean;
 
+/**
+ * isEventWithParams.
+ * @param event - An event.
+ * @public
+ */
+export declare const isEventWithParams: (event: AnyEventObject) => event is ParameterizedObject;
+
 /**
  * @param error - An error.
  * @public
  */
-export declare const isGenesisServerError: (error: unknown) => boolean;
+export declare const isGenesisServerError: (error: unknown) => error is GenesisServerError;
 
 /**
  * @param error - An error.
  * @public
  */
-export declare const isMappingError: (error: unknown) => boolean;
+export declare const isMappingError: (error: unknown) => error is MappingError;
 
 /**
  * @param error - An error.
  * @public
  */
-export declare const isNetworkError: (error: unknown) => boolean;
+export declare const isNetworkError: (error: unknown) => error is NetworkError;
 
 /**
  * @param error - An error.
@@ -488,7 +510,7 @@ export declare const isNetworkError: (error: unknown) => boolean;
  */
 export declare const isNotFoundError: (error: {
     status?: number;
-}) => boolean;
+}) => error is APIError;
 
 /**
  * isSyntaxError.
@@ -506,6 +528,14 @@ export declare const isTypeError: ({ event }: {
     event: any;
 }) => boolean;
 
+/**
+ * @param error - An error.
+ * @public
+ */
+export declare const isUnauthorizedError: (error: {
+    status?: number;
+}) => error is APIError;
+
 /**
  * @public
  */
@@ -580,6 +610,10 @@ export declare interface Machine<TContext extends MachineContext, TEvent extends
      * Callers can decide to reuse/reference if set or create their own.
      */
     readonly actor?: InterpreterFrom<StateMachine<TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta>>;
+    /**
+     * The last `snapshot` from the actor.
+     */
+    readonly snapshot: State<TContext, TEvent, TActor, TResolvedTypesMeta>;
     /**
      * The current `state` of the machine itself. This is not to be confused with state in the data or store sense.
      */
@@ -599,6 +633,10 @@ export declare interface Machine<TContext extends MachineContext, TEvent extends
      * The `context` of the machine when started.
      */
     readonly startingContext: Partial<TContext>;
+    /**
+     * The `meta` from the current `state`.
+     */
+    readonly meta: Record<string, any>;
     /**
      * Indicates if the machine has completed the happy path.
      */
@@ -684,6 +722,15 @@ export declare interface Machine<TContext extends MachineContext, TEvent extends
      * @param tag - A tag.
      */
     hasTag(tag: string): boolean;
+    /**
+     * Get `meta` values by key.
+     *
+     * @remarks
+     * Meta is cumulative across all state nodes represented by the state value.
+     *
+     * @param key - A key within the `meta` object. Defaults to `content`.
+     */
+    getMetaValuesByKey<T = string>(key?: string): T[];
     /**
      * An api to send events to the machine.
      *
@@ -821,6 +868,8 @@ export declare type ResponseOkChecker = (response: Response) => boolean;
  * Set error action.
  * @remarks
  * Used to set a top level error on the machine. This may equal to {@link @genesislcap/foundation-utils#ErrorMap} `lastError` in the `errors` property.
+ * @privateRemarks
+ * Contains done event handling to deal with 200 Nacks.
  * @public
  */
 export declare const setError: {
@@ -836,6 +885,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.
+ * @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.
  * @param key - The error key.
  * @public
  */

package/docs/api/foundation-state-machine.abstractmachine.getmetavaluesbykey.md

@@ -0,0 +1,28 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-state-machine](./foundation-state-machine.md) &gt; [AbstractMachine](./foundation-state-machine.abstractmachine.md) &gt; [getMetaValuesByKey](./foundation-state-machine.abstractmachine.getmetavaluesbykey.md)
+
+## AbstractMachine.getMetaValuesByKey() method
+
+Get `meta` values by key.
+
+**Signature:**
+
+```typescript
+getMetaValuesByKey<T = string>(key?: string): T[];
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  key | string | _(Optional)_ A key within the <code>meta</code> object. Defaults to <code>content</code>. |
+
+**Returns:**
+
+T\[\]
+
+## Remarks
+
+Meta is cumulative across all state nodes represented by the state value.
+

package/docs/api/foundation-state-machine.abstractmachine.md

@@ -23,8 +23,10 @@ export declare abstract class AbstractMachine<TContext extends MachineContext, T
 |  [error](./foundation-state-machine.abstractmachine.error.md) |  | any | A general machine error. Likely equal to <code>errors.lastError</code>. |
 |  [errors](./foundation-state-machine.abstractmachine.errors.md) |  | ErrorMap&lt;ErrorDetailMap&gt; | An  of errors that may have occurred during the machine's workflows. |
 |  [machine](./foundation-state-machine.abstractmachine.machine.md) |  | StateMachine&lt;TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta&gt; | Mandatory machine property. |
+|  [meta](./foundation-state-machine.abstractmachine.meta.md) |  | Record&lt;string, any&gt; | The <code>meta</code> from the current <code>state</code>. |
 |  [onSendEvent](./foundation-state-machine.abstractmachine.onsendevent.md) |  | (event: CustomEvent&lt;TEvent&gt;) =&gt; void | A custom event handler to send events to the machine. |
 |  [output](./foundation-state-machine.abstractmachine.output.md) |  | any | Holds successful machine output if any. |
+|  [snapshot](./foundation-state-machine.abstractmachine.snapshot.md) |  | State&lt;TContext, TEvent, TActor, TResolvedTypesMeta&gt; | The last <code>snapshot</code> from the actor. |
 |  [startingContext](./foundation-state-machine.abstractmachine.startingcontext.md) |  | Partial&lt;TContext&gt; | The <code>context</code> of the machine when started. |
 |  [startingState](./foundation-state-machine.abstractmachine.startingstate.md) |  | StateValue | The <code>state</code> of the machine when started. Allows consumers to start a machine from a persisted state. |
 |  [state](./foundation-state-machine.abstractmachine.state.md) |  | StateValue | The current <code>state</code> of the machine itself. This is not to be confused with state in the data or store sense. |
@@ -35,6 +37,7 @@ export declare abstract class AbstractMachine<TContext extends MachineContext, T
 |  --- | --- | --- |
 |  [binding(token, subscriberChangeCallback, isVolatileBinding, context)](./foundation-state-machine.abstractmachine.binding.md) |  | An api to allow the observation of values and arbitrary bindings outside the template engine. |
 |  [getFromContainer()](./foundation-state-machine.abstractmachine.getfromcontainer.md) | <code>abstract</code> | Gets the machine from the container. |
+|  [getMetaValuesByKey(key)](./foundation-state-machine.abstractmachine.getmetavaluesbykey.md) |  | Get <code>meta</code> values by key. |
 |  [hasTag(tag)](./foundation-state-machine.abstractmachine.hastag.md) |  | Check <code>tags</code> contain provided tag. |
 |  [matches(value)](./foundation-state-machine.abstractmachine.matches.md) |  | Check <code>state</code> matches provided value. |
 |  [provide(implementations)](./foundation-state-machine.abstractmachine.provide.md) |  | Recreate the internal machine with the provided implementations. |

package/docs/api/foundation-state-machine.abstractmachine.meta.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-state-machine](./foundation-state-machine.md) &gt; [AbstractMachine](./foundation-state-machine.abstractmachine.md) &gt; [meta](./foundation-state-machine.abstractmachine.meta.md)
+
+## AbstractMachine.meta property
+
+The `meta` from the current `state`<!-- -->.
+
+**Signature:**
+
+```typescript
+meta: Record<string, any>;
+```

package/docs/api/foundation-state-machine.abstractmachine.snapshot.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-state-machine](./foundation-state-machine.md) &gt; [AbstractMachine](./foundation-state-machine.abstractmachine.md) &gt; [snapshot](./foundation-state-machine.abstractmachine.snapshot.md)
+
+## AbstractMachine.snapshot property
+
+The last `snapshot` from the actor.
+
+**Signature:**
+
+```typescript
+snapshot: State<TContext, TEvent, TActor, TResolvedTypesMeta>;
+```

package/docs/api/foundation-state-machine.apierror.isunauthorized.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-state-machine](./foundation-state-machine.md) &gt; [APIError](./foundation-state-machine.apierror.md) &gt; [isUnauthorized](./foundation-state-machine.apierror.isunauthorized.md)
+
+## APIError.isUnauthorized() method
+
+
+**Signature:**
+
+```typescript
+isUnauthorized(): boolean;
+```
+**Returns:**
+
+boolean
+

package/docs/api/foundation-state-machine.apierror.md

@@ -30,3 +30,9 @@ Bad server `Response`<!-- -->.
 |  [data?](./foundation-state-machine.apierror.data.md) |  | unknown | _(Optional)_ |
 |  [status](./foundation-state-machine.apierror.status.md) |  | number |  |
 
+## Methods
+
+|  Method | Modifiers | Description |
+|  --- | --- | --- |
+|  [isUnauthorized()](./foundation-state-machine.apierror.isunauthorized.md) |  |  |
+

package/docs/api/foundation-state-machine.escalateerror.md

@@ -4,7 +4,7 @@
 
 ## escalateError variable
 
-Escalate error action.
+Escalate context error action.
 
 **Signature:**
 

package/docs/api/foundation-state-machine.isapierror.md

@@ -7,5 +7,5 @@
 **Signature:**
 
 ```typescript
-isAPIError: (error: unknown) => boolean
+isAPIError: (error: unknown) => error is APIError
 ```

package/docs/api/foundation-state-machine.iseventwithparams.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-state-machine](./foundation-state-machine.md) &gt; [isEventWithParams](./foundation-state-machine.iseventwithparams.md)
+
+## isEventWithParams variable
+
+isEventWithParams.
+
+**Signature:**
+
+```typescript
+isEventWithParams: (event: AnyEventObject) => event is ParameterizedObject
+```

package/docs/api/foundation-state-machine.isgenesisservererror.md

@@ -7,5 +7,5 @@
 **Signature:**
 
 ```typescript
-isGenesisServerError: (error: unknown) => boolean
+isGenesisServerError: (error: unknown) => error is GenesisServerError
 ```

package/docs/api/foundation-state-machine.ismappingerror.md

@@ -7,5 +7,5 @@
 **Signature:**
 
 ```typescript
-isMappingError: (error: unknown) => boolean
+isMappingError: (error: unknown) => error is MappingError
 ```

package/docs/api/foundation-state-machine.isnetworkerror.md

@@ -7,5 +7,5 @@
 **Signature:**
 
 ```typescript
-isNetworkError: (error: unknown) => boolean
+isNetworkError: (error: unknown) => error is NetworkError
 ```

package/docs/api/foundation-state-machine.isnotfounderror.md

@@ -9,5 +9,5 @@
 ```typescript
 isNotFoundError: (error: {
     status?: number;
-}) => boolean
+}) => error is APIError
 ```

package/docs/api/foundation-state-machine.isunauthorizederror.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-state-machine](./foundation-state-machine.md) &gt; [isUnauthorizedError](./foundation-state-machine.isunauthorizederror.md)
+
+## isUnauthorizedError variable
+
+**Signature:**
+
+```typescript
+isUnauthorizedError: (error: {
+    status?: number;
+}) => error is APIError
+```

package/docs/api/foundation-state-machine.machine.getmetavaluesbykey.md

@@ -0,0 +1,28 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-state-machine](./foundation-state-machine.md) &gt; [Machine](./foundation-state-machine.machine.md) &gt; [getMetaValuesByKey](./foundation-state-machine.machine.getmetavaluesbykey.md)
+
+## Machine.getMetaValuesByKey() method
+
+Get `meta` values by key.
+
+**Signature:**
+
+```typescript
+getMetaValuesByKey<T = string>(key?: string): T[];
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  key | string | _(Optional)_ A key within the <code>meta</code> object. Defaults to <code>content</code>. |
+
+**Returns:**
+
+T\[\]
+
+## Remarks
+
+Meta is cumulative across all state nodes represented by the state value.
+

package/docs/api/foundation-state-machine.machine.md

@@ -80,7 +80,9 @@ this.myMachine.binding((x) => x.context.data, (value) => {
 |  [error](./foundation-state-machine.machine.error.md) | <code>readonly</code> | any | A general machine error. Likely equal to <code>errors.lastError</code>. |
 |  [errors](./foundation-state-machine.machine.errors.md) | <code>readonly</code> | ErrorMap&lt;ErrorDetailMap&gt; | An  of errors that may have occurred during the machine's workflows. |
 |  [machine](./foundation-state-machine.machine.machine.md) | <code>readonly</code> | StateMachine&lt;TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta&gt; | Mandatory machine property. |
+|  [meta](./foundation-state-machine.machine.meta.md) | <code>readonly</code> | Record&lt;string, any&gt; | The <code>meta</code> from the current <code>state</code>. |
 |  [output](./foundation-state-machine.machine.output.md) | <code>readonly</code> | any | Holds successful machine output if any. |
+|  [snapshot](./foundation-state-machine.machine.snapshot.md) | <code>readonly</code> | State&lt;TContext, TEvent, TActor, TResolvedTypesMeta&gt; | The last <code>snapshot</code> from the actor. |
 |  [startingContext](./foundation-state-machine.machine.startingcontext.md) | <code>readonly</code> | Partial&lt;TContext&gt; | The <code>context</code> of the machine when started. |
 |  [startingState](./foundation-state-machine.machine.startingstate.md) | <code>readonly</code> | StateValue | The <code>state</code> of the machine when started. Allows consumers to start a machine from a persisted state. |
 |  [state](./foundation-state-machine.machine.state.md) | <code>readonly</code> | StateValue | The current <code>state</code> of the machine itself. This is not to be confused with state in the data or store sense. |
@@ -91,6 +93,7 @@ this.myMachine.binding((x) => x.context.data, (value) => {
 |  --- | --- |
 |  [binding(token, subscriberChangeCallback, isVolatileBinding, context)](./foundation-state-machine.machine.binding.md) | An api to allow the observation of values and arbitrary bindings outside the template engine. |
 |  [getFromContainer()](./foundation-state-machine.machine.getfromcontainer.md) | Gets the machine from the container. |
+|  [getMetaValuesByKey(key)](./foundation-state-machine.machine.getmetavaluesbykey.md) | Get <code>meta</code> values by key. |
 |  [hasTag(tag)](./foundation-state-machine.machine.hastag.md) | Check <code>tags</code> contain provided tag. |
 |  [matches(value)](./foundation-state-machine.machine.matches.md) | Check <code>state</code> matches provided value. |
 |  [onSendEvent(event)](./foundation-state-machine.machine.onsendevent.md) | A custom event handler to send events to the machine. |

package/docs/api/foundation-state-machine.machine.meta.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-state-machine](./foundation-state-machine.md) &gt; [Machine](./foundation-state-machine.machine.md) &gt; [meta](./foundation-state-machine.machine.meta.md)
+
+## Machine.meta property
+
+The `meta` from the current `state`<!-- -->.
+
+**Signature:**
+
+```typescript
+readonly meta: Record<string, any>;
+```

package/docs/api/foundation-state-machine.machine.snapshot.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-state-machine](./foundation-state-machine.md) &gt; [Machine](./foundation-state-machine.machine.md) &gt; [snapshot](./foundation-state-machine.machine.snapshot.md)
+
+## Machine.snapshot property
+
+The last `snapshot` from the actor.
+
+**Signature:**
+
+```typescript
+readonly snapshot: State<TContext, TEvent, TActor, TResolvedTypesMeta>;
+```

package/docs/api/foundation-state-machine.md

@@ -50,7 +50,7 @@
 |  [defaultResponseOkChecker](./foundation-state-machine.defaultresponseokchecker.md) | ResponseOkChecker type. |
 |  [defaultRetryStatsCodes](./foundation-state-machine.defaultretrystatscodes.md) | Default retry stats codes. |
 |  [errorWorkflowInput](./foundation-state-machine.errorworkflowinput.md) | Error workflow input. |
-|  [escalateError](./foundation-state-machine.escalateerror.md) | Escalate error action. |
+|  [escalateError](./foundation-state-machine.escalateerror.md) | Escalate context error action. |
 |  [isAbortError](./foundation-state-machine.isaborterror.md) | isAbortError. |
 |  [isActorErrorEvent](./foundation-state-machine.isactorerrorevent.md) | isActorErrorEvent. |
 |  [isAPIError](./foundation-state-machine.isapierror.md) |  |
@@ -58,12 +58,14 @@
 |  [isErrorCustomEvent](./foundation-state-machine.iserrorcustomevent.md) | isErrorCustomEvent. |
 |  [isErrorEvent](./foundation-state-machine.iserrorevent.md) | isErrorEvent. |
 |  [isErrorType](./foundation-state-machine.iserrortype.md) | isErrorType. |
+|  [isEventWithParams](./foundation-state-machine.iseventwithparams.md) | isEventWithParams. |
 |  [isGenesisServerError](./foundation-state-machine.isgenesisservererror.md) |  |
 |  [isMappingError](./foundation-state-machine.ismappingerror.md) |  |
 |  [isNetworkError](./foundation-state-machine.isnetworkerror.md) |  |
 |  [isNotFoundError](./foundation-state-machine.isnotfounderror.md) |  |
 |  [isSyntaxError](./foundation-state-machine.issyntaxerror.md) | isSyntaxError. |
 |  [isTypeError](./foundation-state-machine.istypeerror.md) | isTypeError. |
+|  [isUnauthorizedError](./foundation-state-machine.isunauthorizederror.md) |  |
 |  [logger](./foundation-state-machine.logger.md) |  |
 |  [setError](./foundation-state-machine.seterror.md) | Set error action. |
 |  [setErrorByKey](./foundation-state-machine.seterrorbykey.md) | Set error by key action. |

package/docs/api-report.md

@@ -9,7 +9,7 @@
 import { ActionArgs } from 'xstate';
 import { AnyActorContext } from 'xstate';
 import { AnyActorRef } from 'xstate';
-import type { AnyEventObject } from 'xstate';
+import { AnyEventObject } from 'xstate';
 import { AnyState } from 'xstate';
 import { Assigner } from 'xstate';
 import { BindingObserver } from '@microsoft/fast-element';
@@ -40,6 +40,7 @@ import type { ProvidedActor } from 'xstate';
 import type { ResolveTypegenMeta } from 'xstate';
 import { RetryPolicy } from 'cockatiel';
 import { SendExpr } from 'xstate';
+import type { State } from 'xstate';
 import type { StateMachine } from 'xstate';
 import type { StateNodeConfig } from 'xstate';
 import type { StateValue } from 'xstate';
@@ -52,6 +53,8 @@ import { UnifiedArg } from 'xstate';
 // @public
 export abstract class AbstractMachine<TContext extends MachineContext, TEvent extends EventObject = AnyEventObject, TAction extends ParameterizedObject = ParameterizedObject, TActor extends ProvidedActor = ProvidedActor, TInput = any, TResolvedTypesMeta = ResolveTypegenMeta<TypegenDisabled, NoInfer<TEvent>, TAction, TActor>> implements Machine<TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta> {
     actor: InterpreterFrom<StateMachine<TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta>>;
+    // @internal (undocumented)
+    protected applySnapshot(snapshot?: typeof AbstractMachine.snapshot): void;
     // Warning: (ae-incompatible-release-tags) The symbol "binding" is marked as @public, but its signature references "SubscriberChangeCallback" which is marked as @internal
     binding<TReturn = any, TParent = any>(token: ((target: this) => TReturn) | keyof this, subscriberChangeCallback?: SubscriberChangeCallback<TReturn> | undefined, isVolatileBinding?: boolean, context?: ExecutionContext): BindingObserver<this, TReturn, TParent>;
     complete: boolean;
@@ -61,15 +64,18 @@ export abstract class AbstractMachine<TContext extends MachineContext, TEvent ex
     error: any;
     errors: ErrorMap<ErrorDetailMap>;
     abstract getFromContainer(): this;
+    getMetaValuesByKey<T = string>(key?: string): T[];
     hasTag(tag: string): boolean;
     // @internal (undocumented)
     protected interpret(options?: InterpreterOptions<typeof AbstractMachine.machine>): void;
     machine: StateMachine<TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta>;
     matches(value: StateValueFrom<typeof AbstractMachine.machine>): boolean;
+    meta: Record<string, any>;
     onSendEvent: (event: CustomEvent<TEvent>) => void;
     output: any;
     provide(implementations: InternalMachineImplementations<TContext, TEvent, TAction, TActor, TResolvedTypesMeta, true>): void;
     send(event: TEvent): void;
+    snapshot: State<TContext, TEvent, TActor, TResolvedTypesMeta>;
     start(options?: InterpreterOptions<typeof AbstractMachine.machine>): void;
     // @internal (undocumented)
     protected startActor(): void;
@@ -91,6 +97,8 @@ export class APIError extends Error {
     // (undocumented)
     data?: unknown;
     // (undocumented)
+    isUnauthorized(): boolean;
+    // (undocumented)
     status: number;
 }
 
@@ -254,7 +262,7 @@ export const isAbortError: ({ event }: {
 export const isActorErrorEvent: <TData = any>(actorId: string, event: EventObject | ErrorEvent_2<TData>) => event is ErrorEvent_2<TData>;
 
 // @public (undocumented)
-export const isAPIError: (error: unknown) => boolean;
+export const isAPIError: (error: unknown) => error is APIError;
 
 // @public
 export const isDoneInvokeEvent: <TData = any>(event: EventObject | DoneInvokeEvent<TData>) => event is DoneInvokeEvent<TData>;
@@ -268,19 +276,22 @@ export const isErrorEvent: <TData = any>(event: EventObject | ErrorEvent_2<TData
 // @public
 export const isErrorType: <TType extends ErrorConstructor>(type: TType) => (event: any) => boolean;
 
+// @public
+export const isEventWithParams: (event: AnyEventObject) => event is ParameterizedObject;
+
 // @public (undocumented)
-export const isGenesisServerError: (error: unknown) => boolean;
+export const isGenesisServerError: (error: unknown) => error is GenesisServerError;
 
 // @public (undocumented)
-export const isMappingError: (error: unknown) => boolean;
+export const isMappingError: (error: unknown) => error is MappingError;
 
 // @public (undocumented)
-export const isNetworkError: (error: unknown) => boolean;
+export const isNetworkError: (error: unknown) => error is NetworkError;
 
 // @public (undocumented)
 export const isNotFoundError: (error: {
     status?: number;
-}) => boolean;
+}) => error is APIError;
 
 // @public
 export const isSyntaxError: ({ event }: {
@@ -292,6 +303,11 @@ export const isTypeError: ({ event }: {
     event: any;
 }) => boolean;
 
+// @public (undocumented)
+export const isUnauthorizedError: (error: {
+    status?: number;
+}) => error is APIError;
+
 // @public (undocumented)
 export const logger: Logger;
 
@@ -305,13 +321,16 @@ export interface Machine<TContext extends MachineContext, TEvent extends EventOb
     readonly error: any;
     readonly errors: ErrorMap<ErrorDetailMap>;
     getFromContainer(): this;
+    getMetaValuesByKey<T = string>(key?: string): T[];
     hasTag(tag: string): boolean;
     readonly machine: StateMachine<TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta>;
     matches(value: StateValueFrom<StateMachine<TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta>>): boolean;
+    readonly meta: Record<string, any>;
     onSendEvent(event: CustomEvent<TEvent>): void;
     readonly output: any;
     provide(implementations: InternalMachineImplementations<TContext, TEvent, TAction, TActor, TResolvedTypesMeta, true>): void;
     send(event: TEvent): void;
+    readonly snapshot: State<TContext, TEvent, TActor, TResolvedTypesMeta>;
     start(options?: InterpreterOptions<StateMachine<TContext, TEvent, TAction, TActor, TInput, TResolvedTypesMeta>>): any;
     readonly startingContext: Partial<TContext>;
     readonly startingState: StateValue;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-state-machine",
   "description": "Genesis Foundation State Machine",
-  "version": "14.94.2",
+  "version": "14.96.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -34,14 +34,14 @@
     "test": "genx test"
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.94.2",
-    "@genesislcap/genx": "14.94.2",
+    "@genesislcap/foundation-testing": "14.96.0",
+    "@genesislcap/genx": "14.96.0",
     "rimraf": "^3.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "14.94.2",
-    "@genesislcap/foundation-logger": "14.94.2",
-    "@genesislcap/foundation-utils": "14.94.2",
+    "@genesislcap/foundation-comms": "14.96.0",
+    "@genesislcap/foundation-logger": "14.96.0",
+    "@genesislcap/foundation-utils": "14.96.0",
     "@microsoft/fast-element": "^1.7.0",
     "@microsoft/fast-foundation": "^2.33.2",
     "cockatiel": "^3.1.1",
@@ -57,5 +57,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8f234d54d3f4baf8f21a036b93dd6ba07eb59158"
+  "gitHead": "65b7a0ee750748ce8a8a5ac374e56fd50623118e"
 }