FSM & States

from pyrogram_patch.fsm import StatesGroup, State

class Registration(StatesGroup):
    name  = State()
    email = State()
    phone = State()

# State names are <Group>:<field>
# Registration.name  → "Registration:name"
# Registration.email → "Registration:email"

from pyrogram_patch.fsm import FSMContext

@router.on_command("register")
async def start_registration(client, message, state: FSMContext):
    await state.set_state(Registration.name)
    await message.reply("Enter your name:")

@router.on_message(StateFilter(Registration.name))
async def got_name(client, message, state: FSMContext):
    await state.update_data(name=message.text)
    await state.set_state(Registration.email)
    await message.reply("Enter your email:")

@router.on_message(StateFilter(Registration.email))
async def got_email(client, message, state: FSMContext):
    data = await state.get_data()
    await state.clear_state()
    await message.reply(
        f"Registered: {data['name']} <{message.text}>"
    )

from pyrogram_patch.fsm.filters import StateFilter

# Match a specific state
@router.on_message(StateFilter(Registration.name))
async def handler(client, message, state: FSMContext): ...

# Match any state in the group
@router.on_message(StateFilter(Registration))
async def any_reg_state(client, message, state: FSMContext): ...

# Match no state (user is outside any flow)
@router.on_message(StateFilter(state=None))
async def no_state(client, message, state: FSMContext): ...