@genesislcap/foundation-state-machine 14.71.1-auth-mf.4 → 14.71.1-auth-mf.9

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

@@ -1,4 +1,4 @@
-import { DoneInvokeEvent, ErrorEvent, EventObject } from 'xstate';
+import { AnyEventObject, DoneInvokeEvent, ErrorEvent, EventObject, ParameterizedObject } from 'xstate';
 /**
  * assertEvent.
  * @privateRemarks
@@ -37,6 +37,12 @@ export declare const isErrorCustomEvent: <TData = any>(event: EventObject | Erro
  * @public
  */
 export declare const isActorErrorEvent: <TData = any>(actorId: string, event: EventObject | ErrorEvent<TData>) => event is ErrorEvent<TData>;
+/**
+ * isEventWithParams.
+ * @param event - An event.
+ * @public
+ */
+export declare const isEventWithParams: (event: AnyEventObject) => event is ParameterizedObject;
 /**
  * isErrorType.
  * @param type - An event type.

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

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../src/core/guards.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAElE;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,EAClE,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GACnB,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAI5D;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,+FAEuC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,YAAY,qFAE0C,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,qFAEkC,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,yBACnB,MAAM,uEAE8E,CAAC;AAEhG;;;;GAIG;AACH,eAAO,MAAM,WAAW,0EAOrB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,WAAW;;aAA+C,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,aAAa;;aAAiD,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,YAAY;;aAQxB,CAAC"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../src/core/guards.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,eAAe,EACf,UAAU,EACV,WAAW,EACX,mBAAmB,EACpB,MAAM,QAAQ,CAAC;AAEhB;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,EAClE,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GACnB,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAI5D;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,+FAEuC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,YAAY,qFAE0C,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,qFAEkC,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,yBACnB,MAAM,uEAE8E,CAAC;AAEhG;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,UAAW,cAAc,iCAC3B,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,WAAW,0EAOrB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,WAAW;;aAA+C,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,aAAa;;aAAiD,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,YAAY;;aAQxB,CAAC"}

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

@@ -1,7 +1,7 @@
 import { ErrorDetailMap, ErrorMap } from '@genesislcap/foundation-utils';
 import { BindingObserver, ExecutionContext } from '@microsoft/fast-element';
 import { Container } from '@microsoft/fast-foundation';
-import type { AnyEventObject, EventObject, InternalMachineImplementations, InterpreterFrom, InterpreterOptions, MachineContext as XMachineContext, NoInfer, ParameterizedObject, ProvidedActor, ResolveTypegenMeta, StateMachine, StateValue, StateValueFrom, TypegenDisabled } from 'xstate';
+import type { AnyEventObject, EventObject, InternalMachineImplementations, InterpreterFrom, InterpreterOptions, MachineContext as XMachineContext, NoInfer, ParameterizedObject, ProvidedActor, ResolveTypegenMeta, State, StateMachine, StateValue, StateValueFrom, TypegenDisabled } from 'xstate';
 import { SubscriberChangeCallback } from './binding';
 /**
  * MachineContext interface.
@@ -97,6 +97,10 @@ export interface Machine<TContext extends MachineContext, TEvent extends EventOb
      * 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.
      */
@@ -116,6 +120,10 @@ export interface Machine<TContext extends MachineContext, TEvent extends EventOb
      * 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.
      */
@@ -201,6 +209,15 @@ export interface Machine<TContext extends MachineContext, TEvent extends EventOb
      * @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.
      *
@@ -276,6 +293,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} */
@@ -284,6 +303,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} */
@@ -308,6 +329,10 @@ export declare abstract class AbstractMachine<TContext extends MachineContext, T
      * @internal
      */
     protected subscribe(): void;
+    /**
+     * @internal
+     */
+    protected applySnapshot(snapshot?: typeof this.snapshot): void;
     /**
      * @internal
      */
@@ -326,6 +351,8 @@ export declare abstract class AbstractMachine<TContext extends MachineContext, T
     matches(value: StateValueFrom<typeof this.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} */

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

@@ -1 +1 @@
-{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../src/core/machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,cAAc,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EACL,eAAe,EAEf,gBAAgB,EAGjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,8BAA8B,EAC9B,eAAe,EACf,kBAAkB,EAClB,cAAc,IAAI,eAAe,EACjC,OAAO,EACP,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,cAAc,EAEd,eAAe,EAChB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAe,wBAAwB,EAAoB,MAAM,WAAW,CAAC;AAEpF;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC1C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,OAAO,CACtB,QAAQ,SAAS,cAAc,EAC/B,MAAM,SAAS,WAAW,GAAG,cAAc,EAC3C,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EACzD,MAAM,SAAS,aAAa,GAAG,aAAa,EAC5C,MAAM,GAAG,GAAG,EACZ,kBAAkB,GAAG,kBAAkB,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC;IAE1F;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC9F;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAC9B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAC5E,CAAC;IACF;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC1C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,KAAK,CACH,OAAO,CAAC,EAAE,kBAAkB,CAC1B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAC5E,OACD;IACF;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IACb;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CACL,eAAe,EAAE,8BAA8B,CAC7C,QAAQ,EACR,MAAM,EACN,OAAO,EACP,MAAM,EACN,kBAAkB,EAClB,IAAI,CACL,GACA,IAAI,CAAC;IACR;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,KAAK,EAAE,cAAc,CACnB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAC5E,GACA,OAAO,CAAC;IACX;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,CAAC,GAAG,MAAM,IAAI,EAC/C,wBAAwB,CAAC,EAAE,wBAAwB,CAAC,OAAO,CAAC,GAAG,SAAS,EACxE,iBAAiB,CAAC,EAAE,OAAO,EAC3B,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,gBAAgB,IAAI,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,8BAAsB,eAAe,CACnC,QAAQ,SAAS,cAAc,EAC/B,MAAM,SAAS,WAAW,GAAG,cAAc,EAC3C,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EACzD,MAAM,SAAS,aAAa,GAAG,aAAa,EAC5C,MAAM,GAAG,GAAG,EACZ,kBAAkB,GAAG,kBAAkB,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAC1F,YAAW,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC;IAEjF;;OAEG;IACQ,SAAS,CAAC,SAAS,EAAG,SAAS,CAAC;IAE3C,oCAAoC;IACxB,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAEjG,kCAAkC;IACtB,KAAK,EAAE,eAAe,CAChC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAC5E,CAAC;IAEF,kCAAkC;IACtB,KAAK,EAAE,UAAU,CAAC;IAE9B,0CAA0C;IAC9B,aAAa,EAAE,UAAU,CAAC;IAEtC,oCAAoC;IACxB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,4CAA4C;IAChC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE/C,qCAAqC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAE9B,mCAAmC;IACvB,MAAM,EAAE,GAAG,CAAC;IAExB,mCAAmC;IACvB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAE7C,kCAAkC;IACtB,KAAK,EAAE,GAAG,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,YAAY,CAAe;IAEnC,kCAAkC;IAClC,KAAK,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC;IAMvD,iCAAiC;IACjC,IAAI;IAKJ;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,GAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,OAAO,CAAM;IA+BzE;;OAEG;IACH,SAAS,CAAC,SAAS;IAwBnB;;OAEG;IACH,SAAS,CAAC,WAAW;IAIrB;;OAEG;IACH,SAAS,CAAC,UAAU;IAMpB;;OAEG;IACH,SAAS,CAAC,SAAS;IAMnB,oCAAoC;IACpC,OAAO,CACL,eAAe,EAAE,8BAA8B,CAC7C,QAAQ,EACR,MAAM,EACN,OAAO,EACP,MAAM,EACN,kBAAkB,EAClB,IAAI,CACL;IAYH,oCAAoC;IACpC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC;IAOlD,mCAAmC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM;IAOlB,iCAAiC;IACjC,IAAI,CAAC,KAAK,EAAE,MAAM;IAIlB,wCAAwC;IACxC,WAAW,UAAW,YAAY,MAAM,CAAC,UAEvC;IAEF,oCAAoC;IACpC,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,CAAC,GAAG,MAAM,IAAI,EAC/C,wBAAwB,CAAC,EAAE,wBAAwB,CAAC,OAAO,CAAC,GAAG,SAAS,EACxE,iBAAiB,GAAE,OAAe,EAClC,OAAO,GAAE,gBAA0C,GAClD,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;IAc1C,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,IAAI,IAAI;CAClC"}
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../src/core/machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,cAAc,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EACL,eAAe,EAEf,gBAAgB,EAGjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,8BAA8B,EAC9B,eAAe,EACf,kBAAkB,EAClB,cAAc,IAAI,eAAe,EACjC,OAAO,EACP,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,KAAK,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EAEd,eAAe,EAChB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAe,wBAAwB,EAAoB,MAAM,WAAW,CAAC;AAEpF;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC1C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,OAAO,CACtB,QAAQ,SAAS,cAAc,EAC/B,MAAM,SAAS,WAAW,GAAG,cAAc,EAC3C,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EACzD,MAAM,SAAS,aAAa,GAAG,aAAa,EAC5C,MAAM,GAAG,GAAG,EACZ,kBAAkB,GAAG,kBAAkB,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC;IAE1F;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC9F;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAC9B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAC5E,CAAC;IACF;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACvE;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC1C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,KAAK,CACH,OAAO,CAAC,EAAE,kBAAkB,CAC1B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAC5E,OACD;IACF;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IACb;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CACL,eAAe,EAAE,8BAA8B,CAC7C,QAAQ,EACR,MAAM,EACN,OAAO,EACP,MAAM,EACN,kBAAkB,EAClB,IAAI,CACL,GACA,IAAI,CAAC;IACR;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,KAAK,EAAE,cAAc,CACnB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAC5E,GACA,OAAO,CAAC;IACX;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IAClD;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,CAAC,GAAG,MAAM,IAAI,EAC/C,wBAAwB,CAAC,EAAE,wBAAwB,CAAC,OAAO,CAAC,GAAG,SAAS,EACxE,iBAAiB,CAAC,EAAE,OAAO,EAC3B,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,gBAAgB,IAAI,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,8BAAsB,eAAe,CACnC,QAAQ,SAAS,cAAc,EAC/B,MAAM,SAAS,WAAW,GAAG,cAAc,EAC3C,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EACzD,MAAM,SAAS,aAAa,GAAG,aAAa,EAC5C,MAAM,GAAG,GAAG,EACZ,kBAAkB,GAAG,kBAAkB,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAC1F,YAAW,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC;IAEjF;;OAEG;IACQ,SAAS,CAAC,SAAS,EAAG,SAAS,CAAC;IAE3C,oCAAoC;IACxB,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAEjG,kCAAkC;IACtB,KAAK,EAAE,eAAe,CAChC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAC5E,CAAC;IAEF,qCAAqC;IACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAE1E,kCAAkC;IACtB,KAAK,EAAE,UAAU,CAAC;IAE9B,0CAA0C;IAC9B,aAAa,EAAE,UAAU,CAAC;IAEtC,oCAAoC;IACxB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,4CAA4C;IAChC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE/C,iCAAiC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEtC,qCAAqC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAE9B,mCAAmC;IACvB,MAAM,EAAE,GAAG,CAAC;IAExB,mCAAmC;IACvB,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAE7C,kCAAkC;IACtB,KAAK,EAAE,GAAG,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,YAAY,CAAe;IAEnC,kCAAkC;IAClC,KAAK,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC;IAMvD,iCAAiC;IACjC,IAAI;IAKJ;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,GAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,OAAO,CAAM;IAgCzE;;OAEG;IACH,SAAS,CAAC,SAAS;IAuBnB;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,QAAQ,GAAE,OAAO,IAAI,CAAC,QAAmC;IASjF;;OAEG;IACH,SAAS,CAAC,WAAW;IAIrB;;OAEG;IACH,SAAS,CAAC,UAAU;IAMpB;;OAEG;IACH,SAAS,CAAC,SAAS;IAMnB,oCAAoC;IACpC,OAAO,CACL,eAAe,EAAE,8BAA8B,CAC7C,QAAQ,EACR,MAAM,EACN,OAAO,EACP,MAAM,EACN,kBAAkB,EAClB,IAAI,CACL;IAYH,oCAAoC;IACpC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC;IAOlD,mCAAmC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM;IAOlB,+CAA+C;IAC/C,kBAAkB,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,GAAE,MAAkB,GAAG,CAAC,EAAE;IAU5D,iCAAiC;IACjC,IAAI,CAAC,KAAK,EAAE,MAAM;IAIlB,wCAAwC;IACxC,WAAW,UAAW,YAAY,MAAM,CAAC,UAEvC;IAEF,oCAAoC;IACpC,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,CAAC,GAAG,MAAM,IAAI,EAC/C,wBAAwB,CAAC,EAAE,wBAAwB,CAAC,OAAO,CAAC,GAAG,SAAS,EACxE,iBAAiB,GAAE,OAAe,EAClC,OAAO,GAAE,gBAA0C,GAClD,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;IAc1C,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,IAAI,IAAI;CAClC"}

package/dist/esm/core/guards.js

@@ -39,6 +39,12 @@ export const isErrorCustomEvent = (event) => /^xstate.error/.test(event.type);
  * @public
  */
 export const isActorErrorEvent = (actorId, event) => { var _a, _b; return ((_a = event.type) === null || _a === void 0 ? void 0 : _a.includes('error')) && ((_b = event.type) === null || _b === void 0 ? void 0 : _b.includes(actorId)); };
+/**
+ * isEventWithParams.
+ * @param event - An event.
+ * @public
+ */
+export const isEventWithParams = (event) => event.params !== undefined;
 /**
  * isErrorType.
  * @param type - An event type.

package/dist/esm/core/machine.js

@@ -42,12 +42,13 @@ export class AbstractMachine {
         this.startingContext = (options.input
             ? Object.assign(Object.assign({}, contextWithErrors), options.input) : contextWithErrors);
         this.actor = interpret(this.machine, Object.assign(Object.assign({}, options), { input: this.startingContext, state: this.startingState }));
-        const { value: currentValue, context: currentContext } = this.actor.getSnapshot();
-        this.state = currentValue;
-        this.context = currentContext;
+        this.snapshot = this.actor.getSnapshot();
+        this.state = this.snapshot.value;
+        this.context = this.snapshot.context;
+        this.meta = this.snapshot.meta;
         this.complete = false;
         this.output = undefined;
-        this.errors = currentContext.errors;
+        this.errors = this.context.errors;
         this.error = undefined;
     }
     /**
@@ -59,24 +60,34 @@ export class AbstractMachine {
         }
         this.subscription = this.actor.subscribe({
             next: (snapshot) => {
-                var _a;
-                this.state = snapshot.value;
-                this.context = snapshot.context;
-                this.errors = this.context.errors;
-                this.error = (_a = this.context.error) !== null && _a !== void 0 ? _a : this.errors.lastError;
+                this.applySnapshot(snapshot);
                 logger.debug(`${this.machine.id} changed, state:`, this.state, `context:`, this.context);
             },
             error: (err) => {
+                this.applySnapshot();
                 this.error = err;
                 logger.error(`${this.machine.id} error:`, err);
             },
             complete: () => {
+                this.applySnapshot();
                 this.complete = true;
-                this.output = this.actor.getSnapshot().output;
+                this.output = this.snapshot.output;
                 logger.debug(`${this.machine.id} complete:`, this.output);
             },
         });
     }
+    /**
+     * @internal
+     */
+    applySnapshot(snapshot = this.actor.getSnapshot()) {
+        var _a;
+        this.snapshot = snapshot;
+        this.state = this.snapshot.value;
+        this.context = this.snapshot.context;
+        this.meta = this.snapshot.meta;
+        this.errors = this.context.errors;
+        this.error = (_a = this.context.error) !== null && _a !== void 0 ? _a : this.errors.lastError;
+    }
     /**
      * @internal
      */
@@ -117,14 +128,24 @@ export class AbstractMachine {
         if (!this.actor) {
             throw new Error('Call interpret() before calling matches()');
         }
-        return this.actor.getSnapshot().matches(value);
+        return this.snapshot.matches(value);
     }
     /** {@inheritDoc Machine.hasTag} */
     hasTag(tag) {
         if (!this.actor) {
             throw new Error('Call interpret() before calling hasTag()');
         }
-        return this.actor.getSnapshot().hasTag(tag);
+        return this.snapshot.hasTag(tag);
+    }
+    /** {@inheritDoc Machine.getMetaValuesByKey} */
+    getMetaValuesByKey(key = 'content') {
+        const metaValues = [];
+        if (this.meta) {
+            for (const value of Object.values(this.meta)) {
+                metaValues.push(typeof value === 'object' ? value[key] : value);
+            }
+        }
+        return metaValues;
     }
     /** {@inheritDoc Machine.send} */
     send(event) {
@@ -154,6 +175,9 @@ __decorate([
 __decorate([
     observable
 ], AbstractMachine.prototype, "actor", void 0);
+__decorate([
+    observable
+], AbstractMachine.prototype, "snapshot", void 0);
 __decorate([
     observable
 ], AbstractMachine.prototype, "state", void 0);
@@ -166,6 +190,9 @@ __decorate([
 __decorate([
     observable
 ], AbstractMachine.prototype, "startingContext", void 0);
+__decorate([
+    observable
+], AbstractMachine.prototype, "meta", void 0);
 __decorate([
     observable
 ], AbstractMachine.prototype, "complete", void 0);

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

@@ -732,6 +732,75 @@
               "isAbstract": true,
               "name": "getFromContainer"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-state-machine!AbstractMachine#getMetaValuesByKey:member(1)",
+              "docComment": "/**\n * Get `meta` values by key.\n *\n * @remarks\n *\n * Meta is cumulative across all state nodes represented by the state value.\n *\n * @param key - A key within the `meta` object. Defaults to `content`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getMetaValuesByKey<T = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(key?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "T[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "T",
+                  "constraintTokenRange": {
+                    "startIndex": 0,
+                    "endIndex": 0
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  }
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "key",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getMetaValuesByKey"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/foundation-state-machine!AbstractMachine#hasTag:member(1)",
@@ -877,6 +946,41 @@
               "isAbstract": false,
               "name": "matches"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-state-machine!AbstractMachine#meta:member",
+              "docComment": "/**\n * The `meta` from the current `state`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "meta: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, any>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "meta",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/foundation-state-machine!AbstractMachine#onSendEvent:member",
@@ -1047,6 +1151,41 @@
               "isAbstract": false,
               "name": "send"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-state-machine!AbstractMachine#snapshot:member",
+              "docComment": "/**\n * The last `snapshot` from the actor.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "snapshot: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "State",
+                  "canonicalReference": "xstate!State:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TContext, TEvent, TActor, TResolvedTypesMeta>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "snapshot",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/foundation-state-machine!AbstractMachine#start:member(1)",
@@ -3684,6 +3823,52 @@
             "endIndex": 4
           }
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-state-machine!isEventWithParams:var",
+          "docComment": "/**\n * isEventWithParams.\n *\n * @param event - An event.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "isEventWithParams: "
+            },
+            {
+              "kind": "Content",
+              "text": "(event: "
+            },
+            {
+              "kind": "Reference",
+              "text": "AnyEventObject",
+              "canonicalReference": "xstate!AnyEventObject:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Reference",
+              "text": "event",
+              "canonicalReference": "@genesislcap/foundation-state-machine!~event"
+            },
+            {
+              "kind": "Content",
+              "text": " is "
+            },
+            {
+              "kind": "Reference",
+              "text": "ParameterizedObject",
+              "canonicalReference": "xstate!ParameterizedObject:interface"
+            }
+          ],
+          "fileUrlPath": "src/core/guards.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "isEventWithParams",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 7
+          }
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/foundation-state-machine!isGenesisServerError:var",
@@ -4468,6 +4653,72 @@
               "parameters": [],
               "name": "getFromContainer"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-state-machine!Machine#getMetaValuesByKey:member(1)",
+              "docComment": "/**\n * Get `meta` values by key.\n *\n * @remarks\n *\n * Meta is cumulative across all state nodes represented by the state value.\n *\n * @param key - A key within the `meta` object. Defaults to `content`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getMetaValuesByKey<T = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(key?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "T[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "key",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "T",
+                  "constraintTokenRange": {
+                    "startIndex": 0,
+                    "endIndex": 0
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  }
+                }
+              ],
+              "name": "getMetaValuesByKey"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/foundation-state-machine!Machine#hasTag:member(1)",
@@ -4604,6 +4855,38 @@
               ],
               "name": "matches"
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-state-machine!Machine#meta:member",
+              "docComment": "/**\n * The `meta` from the current `state`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly meta: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, any>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "meta",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/foundation-state-machine!Machine#onSendEvent:member(1)",
@@ -4776,6 +5059,38 @@
               ],
               "name": "send"
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-state-machine!Machine#snapshot:member",
+              "docComment": "/**\n * The last `snapshot` from the actor.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly snapshot: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "State",
+                  "canonicalReference": "xstate!State:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TContext, TEvent, TActor, TResolvedTypesMeta>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "snapshot",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/foundation-state-machine!Machine#start:member(1)",

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} */
@@ -469,6 +480,13 @@ 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
@@ -593,6 +611,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.
      */
@@ -612,6 +634,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.
      */
@@ -697,6 +723,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.
      *

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.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.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

@@ -58,6 +58,7 @@
 |  [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) |  |

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;
@@ -270,6 +276,9 @@ 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) => error is GenesisServerError;
 
@@ -312,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.71.1-auth-mf.4",
+  "version": "14.71.1-auth-mf.9",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -34,13 +34,13 @@
     "test": "genx test"
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.71.1-auth-mf.4",
-    "@genesislcap/genx": "14.71.1-auth-mf.4",
+    "@genesislcap/foundation-testing": "14.71.1-auth-mf.9",
+    "@genesislcap/genx": "14.71.1-auth-mf.9",
     "rimraf": "^3.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-comms": "14.71.1-auth-mf.4",
-    "@genesislcap/foundation-utils": "14.71.1-auth-mf.4",
+    "@genesislcap/foundation-comms": "14.71.1-auth-mf.9",
+    "@genesislcap/foundation-utils": "14.71.1-auth-mf.9",
     "@microsoft/fast-element": "^1.7.0",
     "@microsoft/fast-foundation": "^2.33.2",
     "cockatiel": "^3.1.1",
@@ -56,5 +56,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "349e46c5dc26cf11b292dc5cc9c24e88908f3333"
+  "gitHead": "2b76c57d885f0f1cecb509a1e9ee32f6bd527055"
 }