@futdevpro/fsm-dynamo 1.15.11 → 1.15.13

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

@@ -0,0 +1,53 @@
+import { DyFM_Error } from '../../../_models/control-models/error.control-model';
+
+/**
+ * Failure reason-ok a `DyFM_StateMachineTransition_Result.reason` mezohoz.
+ *
+ *  - `invalid-transition`: nincs olyan transition a config-ban ami a jelenlegi
+ *    state-bol a kert `to`-ba vezet.
+ *  - `guard-rejected`: a transition `guard` callback-je `false`-t adott.
+ *  - `on-leave-failed`: a transition `onLeave` callback-je throw-olt; state NEM valtozott.
+ *  - `on-enter-failed`: az `onEnter` callback throw-olt az uj state beallitasa utan; state revert-elve a from-ra.
+ *  - `persist-failed`: a `persist` callback throw-olt; state revert-elve a from-ra.
+ */
+export type DyFM_StateMachineTransition_FailureReason =
+  | 'invalid-transition'
+  | 'guard-rejected'
+  | 'on-leave-failed'
+  | 'on-enter-failed'
+  | 'persist-failed';
+
+
+/**
+ * Sikeres atmenet eredmenye.
+ */
+export interface DyFM_StateMachineTransition_SuccessResult<TState extends string> {
+  ok: true;
+  from: TState;
+  to: TState;
+  /** A frissitett state-version szam (>= 1). */
+  stateVersion: number;
+}
+
+
+/**
+ * Sikertelen atmenet eredmenye.
+ */
+export interface DyFM_StateMachineTransition_FailureResult<TState extends string> {
+  ok: false;
+  reason: DyFM_StateMachineTransition_FailureReason;
+  /** A jelenlegi state amikor a sikertelenseg torent. */
+  currentState: TState;
+  /** A megkiserelt cel-state. */
+  attemptedTo: TState;
+  /** Opcionalis hiba ha az atmenet error-ral bukott (pl. on-enter throw, persist throw). */
+  error?: DyFM_Error | Error;
+}
+
+
+/**
+ * Discriminated union — `ok` flag-gel branchol.
+ */
+export type DyFM_StateMachineTransition_Result<TState extends string> =
+  | DyFM_StateMachineTransition_SuccessResult<TState>
+  | DyFM_StateMachineTransition_FailureResult<TState>;

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';