state_machine

type AnyMapStateMachine = StateMachine[map[string]interface{}]

type State struct {
	ID          string
	Name        string // Human-readable name
	Description string
	IsInitial   bool
	IsFinal     bool
	Data        map[string]interface{} // Additional metadata
}

type StateMachine[T any] struct {
	Name         string
	States       map[string]*State
	Transitions  []Transition[T]
	CurrentState *State
	Context      T // Shared context for the state machine
}

type StateRef[T any] interface {
	// ID returns the unique identifier of the state
	ID() string

	// Name returns the human-readable name of the state
	Name() string

	// Description returns the human-readable description of the state
	Description() string

	// IsInitial returns whether this is an initial state
	IsInitial() bool

	// IsFinal returns whether this is a final state
	IsFinal() bool

	// GetData returns the data associated with the state
	GetData() map[string]interface{}

	// SetData sets data for the state
	SetData(key string, value interface{})
}

type Transition[T any] struct {
	From      string
	To        string
	Event     string
	Condition func(*T) bool  // Optional condition function
	Action    func(*T) error // Optional action to execute during transition
}