/**
 * Copyright (c) 2025-2026, Michael Yang 杨福海 (fuhai999@gmail.com).
 * <p>
 * Licensed under the GNU Lesser General Public License (LGPL) ,Version 3.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * <p>
 * http://www.gnu.org/licenses/lgpl-3.0.txt
 * <p>
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.easyagents.flow.core.chain;

import java.util.Locale;

/**
 * 多入边节点的触发汇聚模式。
 */
public enum NodeJoinMode {

    /** 任意一条直接入边到达即可执行。 */
    ANY("any"),
    /** 全部直接入边到达后才执行。 */
    ALL("all");

    private final String value;

    NodeJoinMode(String value) {
        this.value = value;
    }

    public String getValue() {
        return value;
    }

    /**
     * 按工作流 JSON 值解析汇聚模式。
     *
     * @param value 配置值
     * @return 汇聚模式
     * @throws IllegalArgumentException 配置为空或不受支持
     */
    public static NodeJoinMode ofValue(String value) {
        if (value == null || value.trim().isEmpty()) {
            throw new IllegalArgumentException("joinMode must be 'any' or 'all'");
        }
        String normalized = value.trim().toLowerCase(Locale.ROOT);
        for (NodeJoinMode mode : values()) {
            if (mode.value.equals(normalized)) {
                return mode;
            }
        }
        throw new IllegalArgumentException(
                "Unsupported joinMode: " + value + "; expected 'any' or 'all'");
    }
}
