@futdevpro/fsm-dynamo 1.15.11 → 1.15.12

package/src/_modules/state-machine/_models/state-transition.interface.ts

@@ -0,0 +1,30 @@
+/**
+ * Egyetlen atmenet (transition) leiras a `DyFM_StateMachine` transitionMap-jeben.
+ *
+ * `from` lehet:
+ *  - egy konkret state (TState)
+ *  - tobb state array-je
+ *  - `'*'` wildcard (barmely jelenlegi state)
+ *
+ * `guard` opcionalis pre-check: ha visszater `false` (vagy resolved-`false` Promise),
+ * az atmenet visszautasitva `'guard-rejected'` reason-nel.
+ *
+ * `onLeave` opcionalis side-effect ami a state-valtas ELOTT fut. Throw-ja
+ * `'on-leave-failed'` reason-t valt ki.
+ *
+ * `onEnter` opcionalis side-effect ami az uj state beallitasa UTAN, de a
+ * `persist` callback elott fut. Throw-ja `'on-enter-failed'` reason-t valt ki
+ * — ilyenkor a state visszaall (revert).
+ */
+export interface DyFM_StateTransition<TState extends string, TContext = unknown> {
+  /** Forras state(ek). Wildcard `'*'` = barmilyen jelenlegi state. */
+  from: TState | TState[] | '*';
+  /** Cel state. */
+  to: TState;
+  /** Optional pre-check; ha `false`-t ad, az atmenet elutasitva. */
+  guard?: (ctx?: TContext) => boolean | Promise<boolean>;
+  /** Optional side-effect a state-valtas ELOTT. */
+  onLeave?: (ctx?: TContext) => Promise<void>;
+  /** Optional side-effect a state-valtas UTAN, a `persist` elott. */
+  onEnter?: (ctx?: TContext) => Promise<void>;
+}

package/src/_modules/state-machine/index.ts

@@ -0,0 +1,6 @@
+// MODELS
+export * from './_models/state-machine.control-model';
+export * from './_models/state-machine-config.interface';
+export * from './_models/state-machine-event.interface';
+export * from './_models/state-transition.interface';
+export * from './_models/state-transition-result.interface';