Consolidated state management module providing functional, process-based, and ETS-backed state handling.

This module provides multiple state management strategies with automatic selection:

• Functional: Simple map-based transformations (no processes)
• Process-based: Supervised GenServer state with Agent or GenServer backing
• ETS-backed: High-performance state with ETS storage for large datasets
• Domain-specific: Delegation to specialized domain managers

Configuration

Set the default strategy in application config:

config :raxol, :state_manager,
  default_strategy: :functional,  # :functional, :process, :ets
  ets_enabled: true,
  process_supervision: true

Or control per-call with options:

StateManager.put(state, :key, value, strategy: :ets)
StateManager.start_managed(:app_state, %{}, strategy: :process)

Migration from Previous Modules

Replace:

Raxol.Core.UnifiedStateManager.get_state(:key)
Raxol.Core.StateManager.Unified.update_managed(:id, fun)
Raxol.Core.StateManager.Default.put(state, :key, value)

With:

Raxol.Core.StateManager.get_state(:key, strategy: :ets)
Raxol.Core.StateManager.update_managed(:id, fun, strategy: :process)
Raxol.Core.StateManager.put(state, :key, value, strategy: :functional)

Examples

# Functional state (no processes, good for simple transformations)
state = %{count: 0}
{:ok, new_state} = StateManager.put(state, :count, 1)

# Process-based managed state (supervised processes)
{:ok, state_id} = StateManager.start_managed(:app_state, %{count: 0})
StateManager.update_managed(:app_state, fn s -> %{s | count: s.count + 1} end)

# ETS-backed state (high performance for large datasets)
StateManager.set_state(:global_config, %{theme: "dark"}, strategy: :ets)
config = StateManager.get_state(:global_config, strategy: :ets)