fsm-state-manager

State Transition Manager is a lightweight library that implements a finite state machine (FSM) pattern for TypeScript and Angular applications. It provides a structured way to define states, events, and transition rules, ensuring predictable and type-safe state management for complex workflows like HTTP request lifecycles or UI interactions.

Key Features

• Strongly-Typed Transitions — Leverages TypeScript generics for compile-time safety when defining states, events, and transition rules.
• Transition Guards — Allows conditional blocking of state changes via guard functions, enabling validation or authorization checks.
• State Subscriptions — Provides optional subscription mode to listen for specific state changes and execute callbacks reactively.
• Dev Tools & Logging — Includes development mode and transition logging to debug and monitor state changes in real-time.
• Flexible Configuration — Supports custom FSM configurations for different use cases (e.g., HTTP requests, UI filters) with reusable transition rules.

Philosophy

The library emphasizes simplicity, predictability, and reusability, making state machines easy to test and integrate while keeping transitions fast and explicit.