@alwatr/fsm 4.1.0 → 6.0.0

package/dist/main.cjs

@@ -1,144 +1,3 @@
-/* @alwatr/fsm v4.1.0 */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/main.ts
-var main_exports = {};
-__export(main_exports, {
-  AlwatrFluxStateMachine: () => AlwatrFluxStateMachine,
-  AlwatrFluxStateMachineBase: () => AlwatrFluxStateMachineBase
-});
-module.exports = __toCommonJS(main_exports);
-
-// src/base.ts
-var import_nanolib = require("@alwatr/nanolib");
-var import_observable = require("@alwatr/observable");
-__dev_mode__: import_nanolib.packageTracer.add("@alwatr/fsm", "4.1.0");
-var AlwatrFluxStateMachineBase = class extends import_observable.AlwatrObservable {
-  constructor(config) {
-    config.loggerPrefix ??= "flux-state-machine";
-    super(config);
-    /**
-     * States and transitions config.
-     */
-    this.stateRecord_ = {};
-    /**
-     * Bind actions name to class methods
-     */
-    this.actionRecord_ = {};
-    this.firstResetToInitialState__ = true;
-    this.initialState_ = config.initialState;
-    this.message_ = { state: this.initialState_ };
-    setTimeout(this.resetToInitialState_.bind(this), 0);
-  }
-  /**
-   * Reset machine to initial state without notify.
-   */
-  resetToInitialState_() {
-    this.logger_.logMethod?.("resetToInitialState_");
-    if (this.firstResetToInitialState__) {
-      this.firstResetToInitialState__ = false;
-      const eventDetail2 = { from: this.initialState_, event: "reset", to: this.initialState_ };
-      this.execAction__(`on_state_${this.initialState_}_enter`, eventDetail2);
-      return this.postTransition__(eventDetail2);
-    }
-    const from = this.message_.state;
-    this.message_ = { state: this.initialState_ };
-    const eventDetail = { from, event: "reset", to: this.initialState_ };
-    return this.postTransition__(eventDetail);
-  }
-  /**
-   * Transition condition.
-   */
-  shouldTransition_(_eventDetail) {
-    this.logger_.logMethodFull?.("shouldTransition_", _eventDetail, true);
-    return true;
-  }
-  /**
-   * Transition flux state machine instance to new state.
-   */
-  async transition_(event) {
-    const fromState = this.message_.state;
-    const toState = this.stateRecord_[fromState]?.[event];
-    this.logger_.logMethodArgs?.("transition_", { fromState, event, toState });
-    if (toState == null) {
-      this.logger_.incident?.("transition", "invalid_target_state", {
-        fromState,
-        event
-      });
-      return;
-    }
-    const eventDetail = { from: fromState, event, to: toState };
-    if (await this.shouldTransition_(eventDetail) !== true) return;
-    this.notify_({ state: toState });
-    this.postTransition__(eventDetail);
-  }
-  /**
-   * Execute all actions for current state.
-   */
-  async postTransition__(eventDetail) {
-    this.logger_.logMethodArgs?.("postTransition__", eventDetail);
-    await this.execAction__(`on_event_${eventDetail.event}`, eventDetail);
-    if (eventDetail.from !== eventDetail.to) {
-      await this.execAction__(`on_any_state_exit`, eventDetail);
-      await this.execAction__(`on_state_${eventDetail.from}_exit`, eventDetail);
-      await this.execAction__(`on_any_state_enter`, eventDetail);
-      await this.execAction__(`on_state_${eventDetail.to}_enter`, eventDetail);
-    }
-    this.execAction__(`on_state_${eventDetail.from}_event_${eventDetail.event}`, eventDetail);
-  }
-  /**
-   * Execute action name if defined in _actionRecord.
-   */
-  execAction__(name, eventDetail) {
-    const actionFn = this.actionRecord_[name];
-    if (typeof actionFn === "function") {
-      this.logger_.logMethodArgs?.("execAction__", name);
-      return actionFn.call(this, eventDetail);
-    }
-  }
-};
-
-// src/fsm.ts
-var AlwatrFluxStateMachine = class extends AlwatrFluxStateMachineBase {
-  /**
-   * Current state.
-   */
-  get state() {
-    return this.message_.state;
-  }
-  /**
-   * Transition flux state machine instance to new state.
-   */
-  transition(event) {
-    this.transition_(event);
-  }
-  /**
-   * Reset machine to initial state without notify.
-   */
-  resetToInitialState() {
-    this.resetToInitialState_();
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AlwatrFluxStateMachine,
-  AlwatrFluxStateMachineBase
-});
+/* @alwatr/fsm v6.0.0 */
+"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true})};var __copyProps=(to,from,except,desc)=>{if(from&&typeof from==="object"||typeof from==="function"){for(let key of __getOwnPropNames(from))if(!__hasOwnProp.call(to,key)&&key!==except)__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable})}return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:true}),mod);var main_exports={};__export(main_exports,{FsmService:()=>FsmService,createFsmService:()=>createFsmService});module.exports=__toCommonJS(main_exports);var import_logger=require("@alwatr/logger");var import_signal=require("@alwatr/signal");var FsmService=class{constructor(config_){this.config_=config_;this.logger_=(0,import_logger.createLogger)(`fsm:${this.config_.name}`);this.eventSignal=(0,import_signal.createEventSignal)({name:`fsm-event-${this.config_.name}`});this.stateSignal__=(0,import_signal.createStateSignal)({name:`fsm-state-${this.config_.name}`,initialValue:{name:this.config_.initial,context:this.config_.context}});this.stateSignal=this.stateSignal__.asReadonly();this.logger_.logMethodArgs?.("constructor",config_);this.eventSignal.subscribe(this.processTransition__.bind(this),{receivePrevious:false})}async processTransition__(event){const currentState=this.stateSignal__.get();this.logger_.logMethodArgs?.("processTransition__",{state:currentState.name,event});const transition=this.findTransition__(event,currentState.context);if(!transition){this.logger_.incident?.("processTransition__","ignored_event","No valid transition found for event",{state:currentState.name,event});return}const targetStateName=transition.target??currentState.name;if(targetStateName!==currentState.name){void this.executeEffects__(event,currentState.context,this.config_.states[currentState.name]?.exit)}const nextContext=this.applyAssigners__(event,currentState.context,transition.assigners);const nextState={name:targetStateName,context:nextContext};this.stateSignal__.set(nextState);if(nextState.name!==currentState.name){void this.executeEffects__(event,nextState.context,this.config_.states[nextState.name]?.entry)}}findTransition__(event,context){this.logger_.logMethod?.("findTransition__");const currentStateName=this.stateSignal__.get().name;const currentStateConfig=this.config_.states[currentStateName];const transitions=currentStateConfig?.on?.[event.type];if(!transitions)return void 0;const transitionsArray=Array.isArray(transitions)?transitions:[transitions];return transitionsArray.find((transition,index)=>{if(!transition.condition)return true;try{const conditionMet=transition.condition(event,context);this.logger_.logStep?.("findTransition__","check_condition",{state:currentStateName,eventType:event.type,transitionIndex:index,condition:transition.condition.name||"anonymous",result:conditionMet});return conditionMet}catch(error){this.logger_.error("findTransition__","condition_failed",error,{state:currentStateName,eventType:event.type,transitionIndex:index,condition:transition.condition.name||"anonymous"});return false}})}async executeEffects__(event,context,effects){if(!effects){this.logger_.logMethodArgs?.("executeEffects__//skipped",{count:0});return}const effectsArray=Array.isArray(effects)?effects:[effects];this.logger_.logMethodArgs?.("executeEffects__",{count:effectsArray.length});for(const effect of effectsArray){try{const result=await effect(event,context);if(result&&"type"in result){this.logger_.logStep?.("executeEffects__","new_event_from_effect",{effect:effect.name||"anonymous",state:this.stateSignal__.get().name,newEvent:result.type});this.eventSignal.dispatch(result)}}catch(error){this.logger_.error("executeEffects__","effect_failed",error,{effect:effect.name||"anonymous",state:this.stateSignal__.get().name,event,context})}}}applyAssigners__(event,context,assigners){if(!assigners){this.logger_.logMethodArgs?.("applyAssigners__//skipped",{count:0});return context}const assignersArray=Array.isArray(assigners)?assigners:[assigners];this.logger_.logMethodArgs?.("applyAssigners__",{count:assignersArray.length});try{return assignersArray.reduce((accContext,assigner)=>{const partialUpdate=assigner(event,accContext);this.logger_.logMethodFull?.(`event.${event.type}.action.${assigner.name||"anonymous"}`,{event,accContext},partialUpdate);if(typeof partialUpdate==="object"&&partialUpdate!==null){return{...accContext,...partialUpdate}}return accContext},context)}catch(error){this.logger_.error("applyAssigners__","assigner_failed_atomic",error,{event,context});return context}}destroy(){this.logger_.logMethod?.("destroy");this.eventSignal.destroy();this.stateSignal.destroy()}};function createFsmService(config){return new FsmService(config)}0&&(module.exports={FsmService,createFsmService});
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/main.ts", "../src/base.ts", "../src/fsm.ts"],
-  "sourcesContent": ["export * from './base.js';\nexport * from './fsm.js';\nexport * from './type.js';\n", "import {packageTracer} from '@alwatr/nanolib';\nimport {AlwatrObservable, type AlwatrObservableConfig} from '@alwatr/observable';\n\nimport type {ActionName, ActionRecord, StateEventDetail, StateRecord} from './type.js';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nexport interface AlwatrFluxStateMachineConfig<S extends string> extends AlwatrObservableConfig {\n  initialState: S;\n}\n\n/**\n * Flux (Finite) State Machine Base Class\n */\nexport abstract class AlwatrFluxStateMachineBase<S extends string, E extends string> extends AlwatrObservable<{state: S}> {\n  /**\n   * States and transitions config.\n   */\n  protected stateRecord_: StateRecord<S, E> = {};\n\n  /**\n   * Bind actions name to class methods\n   */\n  protected actionRecord_: ActionRecord<S, E> = {};\n\n  protected initialState_: S;\n\n  protected override message_: {state: S};\n\n  constructor(config: AlwatrFluxStateMachineConfig<S>) {\n    config.loggerPrefix ??= 'flux-state-machine';\n    super(config);\n\n    this.initialState_ = config.initialState;\n    this.message_ = {state: this.initialState_};\n    setTimeout(this.resetToInitialState_.bind(this), 0);\n  }\n\n  private firstResetToInitialState__ = true;\n  /**\n   * Reset machine to initial state without notify.\n   */\n  protected resetToInitialState_(): Promise<void> {\n    this.logger_.logMethod?.('resetToInitialState_');\n    if (this.firstResetToInitialState__) {\n      this.firstResetToInitialState__ = false;\n      const eventDetail: StateEventDetail<S, E> = {from: this.initialState_, event: 'reset', to: this.initialState_};\n      this.execAction__(`on_state_${this.initialState_}_enter`, eventDetail);\n      return this.postTransition__(eventDetail);\n    }\n    // else {\n    const from = this.message_.state;\n    this.message_ = {state: this.initialState_};\n    const eventDetail: StateEventDetail<S, E> = {from, event: 'reset', to: this.initialState_};\n    return this.postTransition__(eventDetail);\n  }\n\n  /**\n   * Transition condition.\n   */\n  protected shouldTransition_(_eventDetail: StateEventDetail<S, E>): Awaitable<boolean> {\n    this.logger_.logMethodFull?.('shouldTransition_', _eventDetail, true);\n    return true;\n  }\n\n  /**\n   * Transition flux state machine instance to new state.\n   */\n  protected async transition_(event: E): Promise<void> {\n    const fromState = this.message_.state;\n    const toState = this.stateRecord_[fromState]?.[event];\n\n    this.logger_.logMethodArgs?.('transition_', {fromState, event, toState});\n\n    if (toState == null) {\n      this.logger_.incident?.('transition', 'invalid_target_state', {\n        fromState,\n        event,\n      });\n      return;\n    }\n\n    const eventDetail: StateEventDetail<S, E> = {from: fromState, event, to: toState};\n\n    if ((await this.shouldTransition_(eventDetail)) !== true) return;\n\n    this.notify_({state: toState}); // message update but notify event delayed after execActions.\n\n    this.postTransition__(eventDetail);\n  }\n\n  /**\n   * Execute all actions for current state.\n   */\n  private async postTransition__(eventDetail: StateEventDetail<S, E>): Promise<void> {\n    this.logger_.logMethodArgs?.('postTransition__', eventDetail);\n\n    await this.execAction__(`on_event_${eventDetail.event}`, eventDetail);\n\n    if (eventDetail.from !== eventDetail.to) {\n      await this.execAction__(`on_any_state_exit`, eventDetail);\n      await this.execAction__(`on_state_${eventDetail.from}_exit`, eventDetail);\n      await this.execAction__(`on_any_state_enter`, eventDetail);\n      await this.execAction__(`on_state_${eventDetail.to}_enter`, eventDetail);\n    }\n\n    this.execAction__(`on_state_${eventDetail.from}_event_${eventDetail.event}`, eventDetail);\n  }\n\n  /**\n   * Execute action name if defined in _actionRecord.\n   */\n  private execAction__(name: ActionName<S, E | 'reset'>, eventDetail: StateEventDetail<S, E>): Awaitable<void> {\n    const actionFn = this.actionRecord_[name];\n    if (typeof actionFn === 'function') {\n      this.logger_.logMethodArgs?.('execAction__', name);\n      return actionFn.call(this, eventDetail);\n    }\n  }\n}\n", "import {AlwatrFluxStateMachineBase} from './base.js';\n\n/**\n * Flux (Finite) State Machine Base Class\n */\nexport abstract class AlwatrFluxStateMachine<S extends string, E extends string> extends AlwatrFluxStateMachineBase<S, E> {\n  /**\n   * Current state.\n   */\n  get state(): S {\n    return this.message_.state;\n  }\n\n  /**\n   * Transition flux state machine instance to new state.\n   */\n  transition(event: E): void {\n    this.transition_(event);\n  }\n\n  /**\n   * Reset machine to initial state without notify.\n   */\n  resetToInitialState(): void {\n    this.resetToInitialState_();\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["eventDetail"]
+  "sources": ["../src/main.ts", "../src/fsm-service.ts", "../src/facade.ts"],
+  "sourcesContent": ["export * from './facade.js';\nexport * from './fsm-service.js';\nexport type * from './type.js';\n", "import {createLogger} from '@alwatr/logger';\nimport {createStateSignal, createEventSignal} from '@alwatr/signal';\n\nimport type {StateMachineConfig, MachineState, MachineEvent, Transition, Effect, Assigner} from './type.js';\n\n/**\n * A generic, encapsulated service that creates, runs, and manages a finite state machine.\n * It handles signal creation, logic connection, and lifecycle management, providing a clean,\n * reactive API for interacting with the FSM.\n *\n * @template TState The union type of all possible state names.\n * @template TEvent The union type of all possible events.\n * @template TContext The type of the machine's context (extended state).\n */\nexport class FsmService<TState extends string, TEvent extends MachineEvent, TContext extends Record<string, unknown>> {\n  protected readonly logger_ = createLogger(`fsm:${this.config_.name}`);\n\n  /** The event signal for sending events to the FSM. */\n  public readonly eventSignal = createEventSignal<TEvent>({\n    name: `fsm-event-${this.config_.name}`,\n  });\n\n  private readonly stateSignal__ = createStateSignal<MachineState<TState, TContext>>({\n    name: `fsm-state-${this.config_.name}`,\n    initialValue: {\n      name: this.config_.initial,\n      context: this.config_.context,\n    },\n  });\n\n  /** The public, read-only state signal. Subscribe to react to state changes. */\n  public readonly stateSignal = this.stateSignal__.asReadonly();\n\n  public constructor(protected readonly config_: StateMachineConfig<TState, TEvent, TContext>) {\n    this.logger_.logMethodArgs?.('constructor', config_);\n    this.eventSignal.subscribe(this.processTransition__.bind(this), {receivePrevious: false});\n  }\n\n  /**\n   * The core FSM logic that processes a single event and transitions the machine to a new state.\n   * This process is atomic and follows the Run-to-Completion (RTC) model.\n   *\n   * @param event The event to process.\n   */\n  private async processTransition__(event: TEvent): Promise<void> {\n    const currentState = this.stateSignal__.get();\n    this.logger_.logMethodArgs?.('processTransition__', {state: currentState.name, event});\n\n    const transition = this.findTransition__(event, currentState.context);\n\n    if (!transition) {\n      this.logger_.incident?.('processTransition__', 'ignored_event', 'No valid transition found for event', {\n        state: currentState.name,\n        event,\n      });\n      return; // Event ignored, no transition occurs.\n    }\n\n    const targetStateName = transition.target ?? currentState.name;\n\n    // 1. Execute exit effects of the current state if transitioning to a new state.\n    if (targetStateName !== currentState.name) {\n      void this.executeEffects__(event, currentState.context, this.config_.states[currentState.name]?.exit);\n    }\n\n    // 2. Apply assigners to compute the next context. This is a pure function.\n    const nextContext = this.applyAssigners__(event, currentState.context, transition.assigners);\n\n    // 3. Create the final next state object.\n    const nextState: MachineState<TState, TContext> = {\n      name: targetStateName,\n      context: nextContext,\n    };\n\n    // 4. Set the new state, notifying all subscribers.\n    this.stateSignal__.set(nextState);\n\n    // 5. Execute entry effects of the new state if a transition occurred.\n    if (nextState.name !== currentState.name) {\n      void this.executeEffects__(event, nextState.context, this.config_.states[nextState.name]?.entry);\n    }\n  }\n\n  /**\n   * Finds the first valid transition for the given event and context by evaluating conditions.\n   *\n   * @param event The triggering event.\n   * @param context The current machine context.\n   * @returns The first matching transition or `undefined` if none are found.\n   */\n  private findTransition__(event: TEvent, context: Readonly<TContext>): Transition<TState, TEvent, TContext> | undefined {\n    this.logger_.logMethod?.('findTransition__');\n\n    const currentStateName = this.stateSignal__.get().name;\n    const currentStateConfig = this.config_.states[currentStateName];\n    const transitions = currentStateConfig?.on?.[event.type as TEvent['type']] as\n      | SingleOrArray<Transition<TState, TEvent, TContext>>\n      | undefined;\n\n    if (!transitions) return undefined;\n\n    // Normalize to an array to handle both single and multiple transitions uniformly.\n    const transitionsArray = Array.isArray(transitions) ? transitions : [transitions];\n\n    return transitionsArray.find((transition, index) => {\n      if (!transition.condition) return true; // A transition without a condition is always valid.\n\n      try {\n        const conditionMet = transition.condition(event, context);\n        this.logger_.logStep?.('findTransition__', 'check_condition', {\n          state: currentStateName,\n          eventType: event.type,\n          transitionIndex: index,\n          condition: transition.condition.name || 'anonymous',\n          result: conditionMet,\n        });\n        return conditionMet;\n      }\n      catch (error) {\n        this.logger_.error('findTransition__', 'condition_failed', error, {\n          state: currentStateName,\n          eventType: event.type,\n          transitionIndex: index,\n          condition: transition.condition.name || 'anonymous',\n        });\n        return false; // Treat a failing condition as not met.\n      }\n    });\n  }\n\n  /**\n   * Sequentially executes a list of effects (side-effects).\n   * Errors are caught and logged without stopping the FSM.\n   *\n   * @param event The event that triggered these effects.\n   * @param context The context at the time of execution.\n   * @param effects A single effect or an array of effects.\n   */\n  private async executeEffects__(\n    event: TEvent,\n    context: Readonly<TContext>,\n    effects?: SingleOrArray<Effect<TEvent, TContext>>,\n  ): Promise<void> {\n    if (!effects) {\n      this.logger_.logMethodArgs?.('executeEffects__//skipped', {count: 0});\n      return;\n    }\n    const effectsArray: Effect<TEvent, TContext>[] = Array.isArray(effects) ? effects : [effects];\n\n    this.logger_.logMethodArgs?.('executeEffects__', {count: effectsArray.length});\n\n    for (const effect of effectsArray) {\n      try {\n        const result = await effect(event, context);\n        // If an effect returns a new event, dispatch it to be processed next.\n        if (result && 'type' in result) {\n          this.logger_.logStep?.('executeEffects__', 'new_event_from_effect', {\n            effect: effect.name || 'anonymous',\n            state: this.stateSignal__.get().name,\n            newEvent: result.type,\n          });\n          this.eventSignal.dispatch(result);\n        }\n      }\n      catch (error) {\n        this.logger_.error('executeEffects__', 'effect_failed', error, {\n          effect: effect.name || 'anonymous',\n          state: this.stateSignal__.get().name,\n          event,\n          context,\n        });\n      }\n    }\n  }\n\n  /**\n   * Applies all assigner functions to the context to produce a new, updated context.\n   * This process is atomic (all-or-nothing). If any assigner fails, the original\n   * context is returned, and all updates are discarded.\n   *\n   * @param event The event that triggered the transition.\n   * @param context The current context.\n   * @param assigners A single assigner or an array of assigners.\n   * @returns The new, updated context, or the original context if any assigner fails.\n   */\n  private applyAssigners__(event: TEvent, context: Readonly<TContext>, assigners?: SingleOrArray<Assigner<TEvent, TContext>>): TContext {\n    if (!assigners) {\n      this.logger_.logMethodArgs?.('applyAssigners__//skipped', {count: 0});\n      return context;\n    }\n\n    const assignersArray: Assigner<TEvent, TContext>[] = Array.isArray(assigners) ? assigners : [assigners];\n\n    this.logger_.logMethodArgs?.('applyAssigners__', {count: assignersArray.length});\n\n    try {\n      // The entire reduce operation is wrapped in a single try/catch block\n      // to ensure atomic updates.\n      return assignersArray.reduce((accContext, assigner) => {\n        const partialUpdate = assigner(event, accContext);\n        this.logger_.logMethodFull?.(`event.${event.type}.action.${assigner.name || 'anonymous'}`, {event, accContext}, partialUpdate);\n        if (typeof partialUpdate === 'object' && partialUpdate !== null) {\n          // The next assigner receives the updated context from the previous one.\n          return {...accContext, ...partialUpdate};\n        }\n        // If an assigner returns nothing, pass the accumulated context along.\n        return accContext;\n      }, context);\n    }\n    catch (error) {\n      this.logger_.error('applyAssigners__', 'assigner_failed_atomic', error, {\n        event,\n        context, // Log the original context for debugging.\n      });\n      // On ANY failure, discard all changes and return the original context.\n      return context;\n    }\n  }\n\n  /**\n   * Destroys the service, cleaning up all internal signals and subscriptions\n   * to prevent memory leaks.\n   */\n  public destroy(): void {\n    this.logger_.logMethod?.('destroy');\n    this.eventSignal.destroy();\n    this.stateSignal.destroy();\n  }\n}\n", "import {FsmService} from './fsm-service.js';\n\nimport type {MachineEvent, StateMachineConfig} from './type.js';\n\n/**\n * A simple and clean factory function for creating an `FsmService` instance.\n * This is the recommended way to instantiate a new state machine.\n *\n * @template TState - The union type of all possible states.\n * @template TEvent - The union type of all possible events.\n * @template TContext - The type of the machine's context.\n *\n * @param config - The machine's configuration object.\n * @returns A new, ready-to-use instance of `FsmService`.\n *\n * @example\n * ```ts\n * import {createFsmService} from '@alwatr/fsm';\n * import type {StateMachineConfig} from '@alwatr/fsm';\n *\n * // 1. Define types\n * type LightContext = {brightness: number};\n * type LightState = 'on' | 'off';\n * type LightEvent = {type: 'TOGGLE'} | {type: 'SET_BRIGHTNESS'; level: number};\n *\n * // 2. Config the state machine\n * const lightMachineConfig: StateMachineConfig<LightState, LightEvent, LightContext> = {\n *   name: 'light-switch',\n *   initial: 'off',\n *   context: {brightness: 0},\n *   states: {\n *     off: {\n *       on: {\n *         TOGGLE: {\n *           target: 'on',\n *           assigners: [() => ({brightness: 100})],\n *         },\n *       },\n *     },\n *     on: {\n *       on: {\n *         TOGGLE: {target: 'off', assigners: [() => ({brightness: 0})]},\n *         SET_BRIGHTNESS: {assigners: [(event) => ({brightness: event.level})]},\n *       },\n *     },\n *   },\n * };\n *\n * // 3. Create the service\n * const lightService = createFsmService(lightMachineConfig);\n *\n * // 4. Use it in your application\n * lightService.stateSignal.subscribe((state) => {\n *   console.log(`Light is ${state.name} with brightness ${state.context.brightness}`);\n * });\n *\n * lightService.eventSignal.dispatch({type: 'TOGGLE'}); // Light is on with brightness 100\n *\n * lightService.eventSignal.dispatch({type: 'SET_BRIGHTNESS', level: 50}); // Light is on with brightness 50\n *\n * // 5. Cleanup\n * // lightService.destroy();\n * ```\n */\nexport function createFsmService<TState extends string, TEvent extends MachineEvent, TContext extends Record<string, unknown>>(\n  config: StateMachineConfig<TState, TEvent, TContext>,\n): FsmService<TState, TEvent, TContext> {\n  return new FsmService(config);\n}\n"],
+  "mappings": "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",
+  "names": []
 }

package/dist/main.d.ts

@@ -1,4 +1,4 @@
-export * from './base.js';
-export * from './fsm.js';
-export * from './type.js';
+export * from './facade.js';
+export * from './fsm-service.js';
+export type * from './type.js';
 //# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,mBAAmB,WAAW,CAAC"}

package/dist/main.mjs

@@ -1,117 +1,3 @@
-/* @alwatr/fsm v4.1.0 */
-
-// src/base.ts
-import { packageTracer } from "@alwatr/nanolib";
-import { AlwatrObservable } from "@alwatr/observable";
-__dev_mode__: packageTracer.add("@alwatr/fsm", "4.1.0");
-var AlwatrFluxStateMachineBase = class extends AlwatrObservable {
-  constructor(config) {
-    config.loggerPrefix ??= "flux-state-machine";
-    super(config);
-    /**
-     * States and transitions config.
-     */
-    this.stateRecord_ = {};
-    /**
-     * Bind actions name to class methods
-     */
-    this.actionRecord_ = {};
-    this.firstResetToInitialState__ = true;
-    this.initialState_ = config.initialState;
-    this.message_ = { state: this.initialState_ };
-    setTimeout(this.resetToInitialState_.bind(this), 0);
-  }
-  /**
-   * Reset machine to initial state without notify.
-   */
-  resetToInitialState_() {
-    this.logger_.logMethod?.("resetToInitialState_");
-    if (this.firstResetToInitialState__) {
-      this.firstResetToInitialState__ = false;
-      const eventDetail2 = { from: this.initialState_, event: "reset", to: this.initialState_ };
-      this.execAction__(`on_state_${this.initialState_}_enter`, eventDetail2);
-      return this.postTransition__(eventDetail2);
-    }
-    const from = this.message_.state;
-    this.message_ = { state: this.initialState_ };
-    const eventDetail = { from, event: "reset", to: this.initialState_ };
-    return this.postTransition__(eventDetail);
-  }
-  /**
-   * Transition condition.
-   */
-  shouldTransition_(_eventDetail) {
-    this.logger_.logMethodFull?.("shouldTransition_", _eventDetail, true);
-    return true;
-  }
-  /**
-   * Transition flux state machine instance to new state.
-   */
-  async transition_(event) {
-    const fromState = this.message_.state;
-    const toState = this.stateRecord_[fromState]?.[event];
-    this.logger_.logMethodArgs?.("transition_", { fromState, event, toState });
-    if (toState == null) {
-      this.logger_.incident?.("transition", "invalid_target_state", {
-        fromState,
-        event
-      });
-      return;
-    }
-    const eventDetail = { from: fromState, event, to: toState };
-    if (await this.shouldTransition_(eventDetail) !== true) return;
-    this.notify_({ state: toState });
-    this.postTransition__(eventDetail);
-  }
-  /**
-   * Execute all actions for current state.
-   */
-  async postTransition__(eventDetail) {
-    this.logger_.logMethodArgs?.("postTransition__", eventDetail);
-    await this.execAction__(`on_event_${eventDetail.event}`, eventDetail);
-    if (eventDetail.from !== eventDetail.to) {
-      await this.execAction__(`on_any_state_exit`, eventDetail);
-      await this.execAction__(`on_state_${eventDetail.from}_exit`, eventDetail);
-      await this.execAction__(`on_any_state_enter`, eventDetail);
-      await this.execAction__(`on_state_${eventDetail.to}_enter`, eventDetail);
-    }
-    this.execAction__(`on_state_${eventDetail.from}_event_${eventDetail.event}`, eventDetail);
-  }
-  /**
-   * Execute action name if defined in _actionRecord.
-   */
-  execAction__(name, eventDetail) {
-    const actionFn = this.actionRecord_[name];
-    if (typeof actionFn === "function") {
-      this.logger_.logMethodArgs?.("execAction__", name);
-      return actionFn.call(this, eventDetail);
-    }
-  }
-};
-
-// src/fsm.ts
-var AlwatrFluxStateMachine = class extends AlwatrFluxStateMachineBase {
-  /**
-   * Current state.
-   */
-  get state() {
-    return this.message_.state;
-  }
-  /**
-   * Transition flux state machine instance to new state.
-   */
-  transition(event) {
-    this.transition_(event);
-  }
-  /**
-   * Reset machine to initial state without notify.
-   */
-  resetToInitialState() {
-    this.resetToInitialState_();
-  }
-};
-export {
-  AlwatrFluxStateMachine,
-  AlwatrFluxStateMachineBase
-};
+/* @alwatr/fsm v6.0.0 */
+import{createLogger}from"@alwatr/logger";import{createStateSignal,createEventSignal}from"@alwatr/signal";var FsmService=class{constructor(config_){this.config_=config_;this.logger_=createLogger(`fsm:${this.config_.name}`);this.eventSignal=createEventSignal({name:`fsm-event-${this.config_.name}`});this.stateSignal__=createStateSignal({name:`fsm-state-${this.config_.name}`,initialValue:{name:this.config_.initial,context:this.config_.context}});this.stateSignal=this.stateSignal__.asReadonly();this.logger_.logMethodArgs?.("constructor",config_);this.eventSignal.subscribe(this.processTransition__.bind(this),{receivePrevious:false})}async processTransition__(event){const currentState=this.stateSignal__.get();this.logger_.logMethodArgs?.("processTransition__",{state:currentState.name,event});const transition=this.findTransition__(event,currentState.context);if(!transition){this.logger_.incident?.("processTransition__","ignored_event","No valid transition found for event",{state:currentState.name,event});return}const targetStateName=transition.target??currentState.name;if(targetStateName!==currentState.name){void this.executeEffects__(event,currentState.context,this.config_.states[currentState.name]?.exit)}const nextContext=this.applyAssigners__(event,currentState.context,transition.assigners);const nextState={name:targetStateName,context:nextContext};this.stateSignal__.set(nextState);if(nextState.name!==currentState.name){void this.executeEffects__(event,nextState.context,this.config_.states[nextState.name]?.entry)}}findTransition__(event,context){this.logger_.logMethod?.("findTransition__");const currentStateName=this.stateSignal__.get().name;const currentStateConfig=this.config_.states[currentStateName];const transitions=currentStateConfig?.on?.[event.type];if(!transitions)return void 0;const transitionsArray=Array.isArray(transitions)?transitions:[transitions];return transitionsArray.find((transition,index)=>{if(!transition.condition)return true;try{const conditionMet=transition.condition(event,context);this.logger_.logStep?.("findTransition__","check_condition",{state:currentStateName,eventType:event.type,transitionIndex:index,condition:transition.condition.name||"anonymous",result:conditionMet});return conditionMet}catch(error){this.logger_.error("findTransition__","condition_failed",error,{state:currentStateName,eventType:event.type,transitionIndex:index,condition:transition.condition.name||"anonymous"});return false}})}async executeEffects__(event,context,effects){if(!effects){this.logger_.logMethodArgs?.("executeEffects__//skipped",{count:0});return}const effectsArray=Array.isArray(effects)?effects:[effects];this.logger_.logMethodArgs?.("executeEffects__",{count:effectsArray.length});for(const effect of effectsArray){try{const result=await effect(event,context);if(result&&"type"in result){this.logger_.logStep?.("executeEffects__","new_event_from_effect",{effect:effect.name||"anonymous",state:this.stateSignal__.get().name,newEvent:result.type});this.eventSignal.dispatch(result)}}catch(error){this.logger_.error("executeEffects__","effect_failed",error,{effect:effect.name||"anonymous",state:this.stateSignal__.get().name,event,context})}}}applyAssigners__(event,context,assigners){if(!assigners){this.logger_.logMethodArgs?.("applyAssigners__//skipped",{count:0});return context}const assignersArray=Array.isArray(assigners)?assigners:[assigners];this.logger_.logMethodArgs?.("applyAssigners__",{count:assignersArray.length});try{return assignersArray.reduce((accContext,assigner)=>{const partialUpdate=assigner(event,accContext);this.logger_.logMethodFull?.(`event.${event.type}.action.${assigner.name||"anonymous"}`,{event,accContext},partialUpdate);if(typeof partialUpdate==="object"&&partialUpdate!==null){return{...accContext,...partialUpdate}}return accContext},context)}catch(error){this.logger_.error("applyAssigners__","assigner_failed_atomic",error,{event,context});return context}}destroy(){this.logger_.logMethod?.("destroy");this.eventSignal.destroy();this.stateSignal.destroy()}};function createFsmService(config){return new FsmService(config)}export{FsmService,createFsmService};
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/base.ts", "../src/fsm.ts"],
-  "sourcesContent": ["import {packageTracer} from '@alwatr/nanolib';\nimport {AlwatrObservable, type AlwatrObservableConfig} from '@alwatr/observable';\n\nimport type {ActionName, ActionRecord, StateEventDetail, StateRecord} from './type.js';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nexport interface AlwatrFluxStateMachineConfig<S extends string> extends AlwatrObservableConfig {\n  initialState: S;\n}\n\n/**\n * Flux (Finite) State Machine Base Class\n */\nexport abstract class AlwatrFluxStateMachineBase<S extends string, E extends string> extends AlwatrObservable<{state: S}> {\n  /**\n   * States and transitions config.\n   */\n  protected stateRecord_: StateRecord<S, E> = {};\n\n  /**\n   * Bind actions name to class methods\n   */\n  protected actionRecord_: ActionRecord<S, E> = {};\n\n  protected initialState_: S;\n\n  protected override message_: {state: S};\n\n  constructor(config: AlwatrFluxStateMachineConfig<S>) {\n    config.loggerPrefix ??= 'flux-state-machine';\n    super(config);\n\n    this.initialState_ = config.initialState;\n    this.message_ = {state: this.initialState_};\n    setTimeout(this.resetToInitialState_.bind(this), 0);\n  }\n\n  private firstResetToInitialState__ = true;\n  /**\n   * Reset machine to initial state without notify.\n   */\n  protected resetToInitialState_(): Promise<void> {\n    this.logger_.logMethod?.('resetToInitialState_');\n    if (this.firstResetToInitialState__) {\n      this.firstResetToInitialState__ = false;\n      const eventDetail: StateEventDetail<S, E> = {from: this.initialState_, event: 'reset', to: this.initialState_};\n      this.execAction__(`on_state_${this.initialState_}_enter`, eventDetail);\n      return this.postTransition__(eventDetail);\n    }\n    // else {\n    const from = this.message_.state;\n    this.message_ = {state: this.initialState_};\n    const eventDetail: StateEventDetail<S, E> = {from, event: 'reset', to: this.initialState_};\n    return this.postTransition__(eventDetail);\n  }\n\n  /**\n   * Transition condition.\n   */\n  protected shouldTransition_(_eventDetail: StateEventDetail<S, E>): Awaitable<boolean> {\n    this.logger_.logMethodFull?.('shouldTransition_', _eventDetail, true);\n    return true;\n  }\n\n  /**\n   * Transition flux state machine instance to new state.\n   */\n  protected async transition_(event: E): Promise<void> {\n    const fromState = this.message_.state;\n    const toState = this.stateRecord_[fromState]?.[event];\n\n    this.logger_.logMethodArgs?.('transition_', {fromState, event, toState});\n\n    if (toState == null) {\n      this.logger_.incident?.('transition', 'invalid_target_state', {\n        fromState,\n        event,\n      });\n      return;\n    }\n\n    const eventDetail: StateEventDetail<S, E> = {from: fromState, event, to: toState};\n\n    if ((await this.shouldTransition_(eventDetail)) !== true) return;\n\n    this.notify_({state: toState}); // message update but notify event delayed after execActions.\n\n    this.postTransition__(eventDetail);\n  }\n\n  /**\n   * Execute all actions for current state.\n   */\n  private async postTransition__(eventDetail: StateEventDetail<S, E>): Promise<void> {\n    this.logger_.logMethodArgs?.('postTransition__', eventDetail);\n\n    await this.execAction__(`on_event_${eventDetail.event}`, eventDetail);\n\n    if (eventDetail.from !== eventDetail.to) {\n      await this.execAction__(`on_any_state_exit`, eventDetail);\n      await this.execAction__(`on_state_${eventDetail.from}_exit`, eventDetail);\n      await this.execAction__(`on_any_state_enter`, eventDetail);\n      await this.execAction__(`on_state_${eventDetail.to}_enter`, eventDetail);\n    }\n\n    this.execAction__(`on_state_${eventDetail.from}_event_${eventDetail.event}`, eventDetail);\n  }\n\n  /**\n   * Execute action name if defined in _actionRecord.\n   */\n  private execAction__(name: ActionName<S, E | 'reset'>, eventDetail: StateEventDetail<S, E>): Awaitable<void> {\n    const actionFn = this.actionRecord_[name];\n    if (typeof actionFn === 'function') {\n      this.logger_.logMethodArgs?.('execAction__', name);\n      return actionFn.call(this, eventDetail);\n    }\n  }\n}\n", "import {AlwatrFluxStateMachineBase} from './base.js';\n\n/**\n * Flux (Finite) State Machine Base Class\n */\nexport abstract class AlwatrFluxStateMachine<S extends string, E extends string> extends AlwatrFluxStateMachineBase<S, E> {\n  /**\n   * Current state.\n   */\n  get state(): S {\n    return this.message_.state;\n  }\n\n  /**\n   * Transition flux state machine instance to new state.\n   */\n  transition(event: E): void {\n    this.transition_(event);\n  }\n\n  /**\n   * Reset machine to initial state without notify.\n   */\n  resetToInitialState(): void {\n    this.resetToInitialState_();\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["eventDetail"]
+  "sources": ["../src/fsm-service.ts", "../src/facade.ts"],
+  "sourcesContent": ["import {createLogger} from '@alwatr/logger';\nimport {createStateSignal, createEventSignal} from '@alwatr/signal';\n\nimport type {StateMachineConfig, MachineState, MachineEvent, Transition, Effect, Assigner} from './type.js';\n\n/**\n * A generic, encapsulated service that creates, runs, and manages a finite state machine.\n * It handles signal creation, logic connection, and lifecycle management, providing a clean,\n * reactive API for interacting with the FSM.\n *\n * @template TState The union type of all possible state names.\n * @template TEvent The union type of all possible events.\n * @template TContext The type of the machine's context (extended state).\n */\nexport class FsmService<TState extends string, TEvent extends MachineEvent, TContext extends Record<string, unknown>> {\n  protected readonly logger_ = createLogger(`fsm:${this.config_.name}`);\n\n  /** The event signal for sending events to the FSM. */\n  public readonly eventSignal = createEventSignal<TEvent>({\n    name: `fsm-event-${this.config_.name}`,\n  });\n\n  private readonly stateSignal__ = createStateSignal<MachineState<TState, TContext>>({\n    name: `fsm-state-${this.config_.name}`,\n    initialValue: {\n      name: this.config_.initial,\n      context: this.config_.context,\n    },\n  });\n\n  /** The public, read-only state signal. Subscribe to react to state changes. */\n  public readonly stateSignal = this.stateSignal__.asReadonly();\n\n  public constructor(protected readonly config_: StateMachineConfig<TState, TEvent, TContext>) {\n    this.logger_.logMethodArgs?.('constructor', config_);\n    this.eventSignal.subscribe(this.processTransition__.bind(this), {receivePrevious: false});\n  }\n\n  /**\n   * The core FSM logic that processes a single event and transitions the machine to a new state.\n   * This process is atomic and follows the Run-to-Completion (RTC) model.\n   *\n   * @param event The event to process.\n   */\n  private async processTransition__(event: TEvent): Promise<void> {\n    const currentState = this.stateSignal__.get();\n    this.logger_.logMethodArgs?.('processTransition__', {state: currentState.name, event});\n\n    const transition = this.findTransition__(event, currentState.context);\n\n    if (!transition) {\n      this.logger_.incident?.('processTransition__', 'ignored_event', 'No valid transition found for event', {\n        state: currentState.name,\n        event,\n      });\n      return; // Event ignored, no transition occurs.\n    }\n\n    const targetStateName = transition.target ?? currentState.name;\n\n    // 1. Execute exit effects of the current state if transitioning to a new state.\n    if (targetStateName !== currentState.name) {\n      void this.executeEffects__(event, currentState.context, this.config_.states[currentState.name]?.exit);\n    }\n\n    // 2. Apply assigners to compute the next context. This is a pure function.\n    const nextContext = this.applyAssigners__(event, currentState.context, transition.assigners);\n\n    // 3. Create the final next state object.\n    const nextState: MachineState<TState, TContext> = {\n      name: targetStateName,\n      context: nextContext,\n    };\n\n    // 4. Set the new state, notifying all subscribers.\n    this.stateSignal__.set(nextState);\n\n    // 5. Execute entry effects of the new state if a transition occurred.\n    if (nextState.name !== currentState.name) {\n      void this.executeEffects__(event, nextState.context, this.config_.states[nextState.name]?.entry);\n    }\n  }\n\n  /**\n   * Finds the first valid transition for the given event and context by evaluating conditions.\n   *\n   * @param event The triggering event.\n   * @param context The current machine context.\n   * @returns The first matching transition or `undefined` if none are found.\n   */\n  private findTransition__(event: TEvent, context: Readonly<TContext>): Transition<TState, TEvent, TContext> | undefined {\n    this.logger_.logMethod?.('findTransition__');\n\n    const currentStateName = this.stateSignal__.get().name;\n    const currentStateConfig = this.config_.states[currentStateName];\n    const transitions = currentStateConfig?.on?.[event.type as TEvent['type']] as\n      | SingleOrArray<Transition<TState, TEvent, TContext>>\n      | undefined;\n\n    if (!transitions) return undefined;\n\n    // Normalize to an array to handle both single and multiple transitions uniformly.\n    const transitionsArray = Array.isArray(transitions) ? transitions : [transitions];\n\n    return transitionsArray.find((transition, index) => {\n      if (!transition.condition) return true; // A transition without a condition is always valid.\n\n      try {\n        const conditionMet = transition.condition(event, context);\n        this.logger_.logStep?.('findTransition__', 'check_condition', {\n          state: currentStateName,\n          eventType: event.type,\n          transitionIndex: index,\n          condition: transition.condition.name || 'anonymous',\n          result: conditionMet,\n        });\n        return conditionMet;\n      }\n      catch (error) {\n        this.logger_.error('findTransition__', 'condition_failed', error, {\n          state: currentStateName,\n          eventType: event.type,\n          transitionIndex: index,\n          condition: transition.condition.name || 'anonymous',\n        });\n        return false; // Treat a failing condition as not met.\n      }\n    });\n  }\n\n  /**\n   * Sequentially executes a list of effects (side-effects).\n   * Errors are caught and logged without stopping the FSM.\n   *\n   * @param event The event that triggered these effects.\n   * @param context The context at the time of execution.\n   * @param effects A single effect or an array of effects.\n   */\n  private async executeEffects__(\n    event: TEvent,\n    context: Readonly<TContext>,\n    effects?: SingleOrArray<Effect<TEvent, TContext>>,\n  ): Promise<void> {\n    if (!effects) {\n      this.logger_.logMethodArgs?.('executeEffects__//skipped', {count: 0});\n      return;\n    }\n    const effectsArray: Effect<TEvent, TContext>[] = Array.isArray(effects) ? effects : [effects];\n\n    this.logger_.logMethodArgs?.('executeEffects__', {count: effectsArray.length});\n\n    for (const effect of effectsArray) {\n      try {\n        const result = await effect(event, context);\n        // If an effect returns a new event, dispatch it to be processed next.\n        if (result && 'type' in result) {\n          this.logger_.logStep?.('executeEffects__', 'new_event_from_effect', {\n            effect: effect.name || 'anonymous',\n            state: this.stateSignal__.get().name,\n            newEvent: result.type,\n          });\n          this.eventSignal.dispatch(result);\n        }\n      }\n      catch (error) {\n        this.logger_.error('executeEffects__', 'effect_failed', error, {\n          effect: effect.name || 'anonymous',\n          state: this.stateSignal__.get().name,\n          event,\n          context,\n        });\n      }\n    }\n  }\n\n  /**\n   * Applies all assigner functions to the context to produce a new, updated context.\n   * This process is atomic (all-or-nothing). If any assigner fails, the original\n   * context is returned, and all updates are discarded.\n   *\n   * @param event The event that triggered the transition.\n   * @param context The current context.\n   * @param assigners A single assigner or an array of assigners.\n   * @returns The new, updated context, or the original context if any assigner fails.\n   */\n  private applyAssigners__(event: TEvent, context: Readonly<TContext>, assigners?: SingleOrArray<Assigner<TEvent, TContext>>): TContext {\n    if (!assigners) {\n      this.logger_.logMethodArgs?.('applyAssigners__//skipped', {count: 0});\n      return context;\n    }\n\n    const assignersArray: Assigner<TEvent, TContext>[] = Array.isArray(assigners) ? assigners : [assigners];\n\n    this.logger_.logMethodArgs?.('applyAssigners__', {count: assignersArray.length});\n\n    try {\n      // The entire reduce operation is wrapped in a single try/catch block\n      // to ensure atomic updates.\n      return assignersArray.reduce((accContext, assigner) => {\n        const partialUpdate = assigner(event, accContext);\n        this.logger_.logMethodFull?.(`event.${event.type}.action.${assigner.name || 'anonymous'}`, {event, accContext}, partialUpdate);\n        if (typeof partialUpdate === 'object' && partialUpdate !== null) {\n          // The next assigner receives the updated context from the previous one.\n          return {...accContext, ...partialUpdate};\n        }\n        // If an assigner returns nothing, pass the accumulated context along.\n        return accContext;\n      }, context);\n    }\n    catch (error) {\n      this.logger_.error('applyAssigners__', 'assigner_failed_atomic', error, {\n        event,\n        context, // Log the original context for debugging.\n      });\n      // On ANY failure, discard all changes and return the original context.\n      return context;\n    }\n  }\n\n  /**\n   * Destroys the service, cleaning up all internal signals and subscriptions\n   * to prevent memory leaks.\n   */\n  public destroy(): void {\n    this.logger_.logMethod?.('destroy');\n    this.eventSignal.destroy();\n    this.stateSignal.destroy();\n  }\n}\n", "import {FsmService} from './fsm-service.js';\n\nimport type {MachineEvent, StateMachineConfig} from './type.js';\n\n/**\n * A simple and clean factory function for creating an `FsmService` instance.\n * This is the recommended way to instantiate a new state machine.\n *\n * @template TState - The union type of all possible states.\n * @template TEvent - The union type of all possible events.\n * @template TContext - The type of the machine's context.\n *\n * @param config - The machine's configuration object.\n * @returns A new, ready-to-use instance of `FsmService`.\n *\n * @example\n * ```ts\n * import {createFsmService} from '@alwatr/fsm';\n * import type {StateMachineConfig} from '@alwatr/fsm';\n *\n * // 1. Define types\n * type LightContext = {brightness: number};\n * type LightState = 'on' | 'off';\n * type LightEvent = {type: 'TOGGLE'} | {type: 'SET_BRIGHTNESS'; level: number};\n *\n * // 2. Config the state machine\n * const lightMachineConfig: StateMachineConfig<LightState, LightEvent, LightContext> = {\n *   name: 'light-switch',\n *   initial: 'off',\n *   context: {brightness: 0},\n *   states: {\n *     off: {\n *       on: {\n *         TOGGLE: {\n *           target: 'on',\n *           assigners: [() => ({brightness: 100})],\n *         },\n *       },\n *     },\n *     on: {\n *       on: {\n *         TOGGLE: {target: 'off', assigners: [() => ({brightness: 0})]},\n *         SET_BRIGHTNESS: {assigners: [(event) => ({brightness: event.level})]},\n *       },\n *     },\n *   },\n * };\n *\n * // 3. Create the service\n * const lightService = createFsmService(lightMachineConfig);\n *\n * // 4. Use it in your application\n * lightService.stateSignal.subscribe((state) => {\n *   console.log(`Light is ${state.name} with brightness ${state.context.brightness}`);\n * });\n *\n * lightService.eventSignal.dispatch({type: 'TOGGLE'}); // Light is on with brightness 100\n *\n * lightService.eventSignal.dispatch({type: 'SET_BRIGHTNESS', level: 50}); // Light is on with brightness 50\n *\n * // 5. Cleanup\n * // lightService.destroy();\n * ```\n */\nexport function createFsmService<TState extends string, TEvent extends MachineEvent, TContext extends Record<string, unknown>>(\n  config: StateMachineConfig<TState, TEvent, TContext>,\n): FsmService<TState, TEvent, TContext> {\n  return new FsmService(config);\n}\n"],
+  "mappings": "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",
+  "names": []
 }

package/dist/type.d.ts

@@ -1,10 +1,99 @@
-export interface StateEventDetail<S extends string, E extends string> {
-    from: S;
-    event: E | 'reset';
-    to: S;
-}
-export type StateRecord<S extends string, E extends string> = Partial<Record<S, Partial<Record<E | 'reset', S>>>>;
-export type Action<S extends string, E extends string> = (eventDetail?: StateEventDetail<S, E | 'reset'>) => Awaitable<void>;
-export type ActionName<S extends string, E extends string> = `on_event_${E}` | `on_any_state_exit` | `on_any_state_enter` | `on_state_${S}_exit` | `on_state_${S}_enter` | `on_state_${S}_event_${E}`;
-export type ActionRecord<S extends string, E extends string> = Partial<Record<ActionName<S, E | 'reset'>, Action<S, E | 'reset'>>>;
+import type { SignalConfig } from '@alwatr/signal';
+/**
+ * Represents the state of a state machine, including its current finite state value
+ * and its extended state (context).
+ *
+ * @template TState The union type of the finite state values.
+ * @template TContext The type of the context object (extended state).
+ */
+export interface MachineState<TState extends string, TContext extends Record<string, unknown>> {
+    /** The current finite state value. */
+    readonly name: TState;
+    /** The context (extended state) of the machine, holding quantitative data. */
+    readonly context: TContext;
+}
+/**
+ * Represents an event that can be sent to the state machine.
+ * It must have a `type` property, which acts as a discriminator.
+ *
+ * @template TEventType The union type of event names.
+ */
+export interface MachineEvent<TEventType extends string = string> {
+    /** The unique type of the event. */
+    readonly type: TEventType;
+    /** An event can carry an optional payload. */
+    [key: string]: unknown;
+}
+/**
+ * Defines an assigner (synchronous action) that updates the context during transitions.
+ * It must return a partial context object to merge.
+ *
+ * @template TContext The type of the machine's context.
+ * @template TEvent The type of the event that triggered this assigner.
+ * @returns A partial context object to be merged into the machine's context.
+ */
+export type Assigner<TEvent extends MachineEvent, TContext extends Record<string, unknown>> = (event: Readonly<TEvent>, context: Readonly<TContext>) => Partial<TContext> | void;
+/**
+ * Defines an effect (asynchronous side-effect action) executed on state entry/exit.
+ * It can interact with the outside world and can dispatch new events.
+ *
+ * @template TContext The type of the machine's context.
+ * @template TEvent The type of the event that triggered this effect.
+ * @returns void or a Promise<void>.
+ */
+export type Effect<TEvent extends MachineEvent, TContext extends Record<string, unknown>> = (event: Readonly<TEvent>, context: Readonly<TContext>) => Awaitable<TEvent | void>;
+/**
+ * Defines a conditional guard function for a transition.
+ * The transition is only taken if this function returns true.
+ *
+ * @template TContext The type of the machine's context.
+ * @template TEvent The type of the event.
+ * @returns `true` if the transition should be taken, `false` otherwise.
+ */
+export type Condition<TEvent extends MachineEvent, TContext extends Record<string, unknown>> = (event: Readonly<TEvent>, context: Readonly<TContext>) => boolean;
+/**
+ * Defines a transition for a given state and event. It specifies the target state,
+ * actions, and an optional condition.
+ *
+ * @template TState The type of the state.
+ * @template TEvent The type of the event.
+ * @template TContext The type of the machine's context.
+ */
+export interface Transition<TState extends string, TEvent extends MachineEvent, TContext extends Record<string, unknown>> {
+    /** The target state to transition to. If undefined, it's an internal transition. */
+    readonly target?: TState;
+    /** A condition function that must return true for the transition to occur. */
+    readonly condition?: Condition<TEvent, TContext>;
+    /** An array of assigners to execute. These update context synchronously. */
+    readonly assigners?: SingleOrArray<Assigner<TEvent, TContext>>;
+}
+/**
+ * The declarative configuration object for creating a state machine.
+ * This object defines the entire behavior of the machine.
+ *
+ * @template TState The union type of all possible states.
+ * @template TEvent The union type of all possible events.
+ * @template TContext The type of the context object.
+ */
+export interface StateMachineConfig<TState extends string, TEvent extends MachineEvent, TContext extends Record<string, unknown>> extends Pick<SignalConfig, 'name'> {
+    /** The initial finite state value. */
+    readonly initial: TState;
+    /** The initial context (extended state) of the machine. */
+    readonly context: TContext;
+    /** An object defining all possible states and their transitions. */
+    readonly states: {
+        readonly [S in TState]?: {
+            /** An object mapping event types to transitions for the current state. */
+            readonly on?: {
+                readonly [E in TEvent['type']]?: SingleOrArray<Transition<TState, Extract<TEvent, {
+                    type: E;
+                }>, TContext>>;
+            };
+            /** An array of side-effect effects to execute upon entering this state. */
+            readonly entry?: SingleOrArray<Effect<TEvent, TContext>>;
+            /** An array of side-effect effects to execute upon exiting this state. */
+            readonly exit?: SingleOrArray<Effect<TEvent, TContext>>;
+        };
+    };
+}
 //# sourceMappingURL=type.d.ts.map

package/dist/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IAClE,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACnB,EAAE,EAAE,CAAC,CAAC;CACP;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAElH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC;AAE7H,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IACrD,YAAY,CAAC,EAAE,GACf,mBAAmB,GACnB,oBAAoB,GACpB,YAAY,CAAC,OAAO,GACpB,YAAY,CAAC,QAAQ,GACrB,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;AAE/B,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@alwatr/fsm",
-  "description": "A robust TypeScript library for implementing Flux (Finite) State Machines, enabling clear and organized management of application state and transitions.",
-  "version": "4.1.0",
+  "description": "A tiny, type-safe, declarative, and reactive finite state machine (FSM) library for modern TypeScript applications, built on top of Alwatr Signals.",
+  "version": "6.0.0",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com> (https://ali.mihandoost.com)",
   "bugs": "https://github.com/Alwatr/flux/issues",
   "dependencies": {
-    "@alwatr/nanolib": "^6.0.1",
-    "@alwatr/observable": "^4.1.0"
+    "@alwatr/logger": "^6.0.3",
+    "@alwatr/signal": "6.0.0"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^6.1.0",
-    "@alwatr/prettier-config": "^5.0.2",
-    "@alwatr/tsconfig-base": "^6.0.0",
-    "@alwatr/type-helper": "^6.0.0",
-    "@types/node": "^22.18.1",
+    "@alwatr/nano-build": "^6.2.1",
+    "@alwatr/prettier-config": "^5.0.3",
+    "@alwatr/tsconfig-base": "^6.0.1",
+    "@alwatr/type-helper": "^6.1.0",
+    "@types/node": "^22.18.6",
     "jest": "^30.1.3",
     "typescript": "^5.9.2"
   },
@@ -68,5 +68,5 @@
   },
   "type": "module",
   "types": "./dist/main.d.ts",
-  "gitHead": "200dcb5e63a3330a3060b51778dd920963b20763"
+  "gitHead": "ca38674339f4836ffcce1e1801c7ccb6b58c90f2"
 }