@alwatr/fsm 6.0.1 → 6.0.2

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [6.0.2](https://github.com/Alwatr/flux/compare/v6.0.1...v6.0.2) (2025-09-21)
+
+### 🔗 Dependencies update
+
+* update dependencies for @alwatr/nano-build, @alwatr/logger, @alwatr/debounce, and @alwatr/delay ([e7cfed5](https://github.com/Alwatr/flux/commit/e7cfed56bd6a7e7cd402e6f38c415de5737f5b24))
+
 ## [6.0.1](https://github.com/Alwatr/flux/compare/v6.0.0...v6.0.1) (2025-09-20)
 
 ### 🐛 Bug Fixes

package/dist/main.cjs

@@ -1,3 +1,4 @@
-/** 📦 @alwatr/fsm v6.0.1 */ __dev_mode__: console.log("📦 @alwatr/fsm v6.0.1");
+/** 📦 @alwatr/fsm v6.0.2 */
+__dev_mode__: console.debug("📦 @alwatr/fsm v6.0.2");
 "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

@@ -2,6 +2,6 @@
   "version": 3,
   "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  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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",
+  "mappings": "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",
   "names": []
 }

package/dist/main.mjs

@@ -1,3 +1,4 @@
-/** 📦 @alwatr/fsm v6.0.1 */ __dev_mode__: console.log("📦 @alwatr/fsm v6.0.1");
+/** 📦 @alwatr/fsm v6.0.2 */
+__dev_mode__: console.debug("📦 @alwatr/fsm v6.0.2");
 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

@@ -2,6 +2,6 @@
   "version": 3,
   "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  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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",
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@alwatr/fsm",
   "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.1",
+  "version": "6.0.2",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com> (https://ali.mihandoost.com)",
   "bugs": "https://github.com/Alwatr/flux/issues",
   "dependencies": {
-    "@alwatr/logger": "^6.0.4",
-    "@alwatr/signal": "6.0.1"
+    "@alwatr/logger": "^6.0.5",
+    "@alwatr/signal": "6.0.2"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^6.3.0",
+    "@alwatr/nano-build": "^6.3.1",
     "@alwatr/prettier-config": "^5.0.4",
     "@alwatr/tsconfig-base": "^6.0.2",
     "@alwatr/type-helper": "^6.1.1",
@@ -69,5 +69,5 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/main.d.ts",
-  "gitHead": "b6a3387394fa7af607051514f9a3a8982467080b"
+  "gitHead": "2737f7356db922ed1985d0779f0503fdb09996a4"
 }