<?php

namespace app\flow\vo;

use app\flow\enum\VoiceMessage;

/**
 * 节点能否处理的判断结果
 * 封装 canHandle 方法的返回值（不可变）
 */
readonly class CanHandleResult
{
    public function __construct(
        /** 是否能处理 */
        public bool $canHandle,
        /** 如果不能处理，期望的下一步提示 */
        public VoiceMessage $expectedNextStep = VoiceMessage::NONE,
    ) {}

    /**
     * 创建可以处理的结果
     */
    public static function yes(): self
    {
        return new self(canHandle: true);
    }

    /**
     * 创建不能处理的结果
     */
    public static function no(?VoiceMessage $expectedNextStep = null): self
    {
        return new self(
            canHandle: false,
            expectedNextStep: $expectedNextStep ?? VoiceMessage::NONE
        );
    }

    /**
     * 是否能处理
     */
    public function isCanHandle(): bool
    {
        return $this->canHandle;
    }

    /**
     * 是否有期望下一步提示
     */
    public function hasExpectedNextStep(): bool
    {
        return $this->expectedNextStep !== VoiceMessage::NONE;
    }
}