package com.battery.device.api.credentials;

import java.io.IOException;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.Map;
import java.util.Properties;
import java.util.function.Function;
import com.battery.device.api.DeviceAdapterException;

/**
 * 来源凭据的取值顺序（ADR-0065）：进程工作目录下的 {@code config/vendor-credentials.properties}
 * → 同名环境变量 → 同名 JVM 启动参数。
 *
 * <p>凭据不进数据库、不进仓库，也不打包；仓库只提交 {@code .example} 模板。
 * 文件优先是为了让部署只做"复制模板填一行"这一件事；保留环境变量与启动参数两条，
 * 是因为交付形态可能只提供其中某一种。三者都没有时装配失败，错误信息同时点名文件路径与键名，
 * 使"忘了放凭据"是可见的失败而不是沉默的缺失。
 *
 * <p>直连厂商库的口令（{@code NEWARE_MYSQL}）与推式来源的接收端点令牌（{@code PUSH_INGEST}）
 * 都是来源凭据，因此共用同一个文件与同一套取值顺序。
 */
public final class LocalCredentials
{
    /** 相对进程工作目录定位，使开发（仓库根）与交付（应用目录）用同一个位置。 */
    public static final Path DEFAULT_FILE = Path.of("config", "vendor-credentials.properties");

    private LocalCredentials() { }

    /** 按默认位置与进程环境取值；取不到时抛出 {@link DeviceAdapterException}。 */
    public static String resolve(String key)
    {
        return resolve(key, DEFAULT_FILE.toAbsolutePath(), System.getenv(), System::getProperty);
    }

    /**
     * 取值顺序：文件 → 环境变量 → 启动参数。文件里的空白值不算配置过，
     * 否则一个空模板会把失败推到连接阶段。
     */
    public static String resolve(String key, Path credentialsFile, Map<String, String> environment,
            Function<String, String> startupParameters)
    {
        if (key == null || key.isBlank()) throw new DeviceAdapterException("未配置来源凭据的取值名");
        String fromFile = fromFile(key, credentialsFile);
        if (fromFile != null) return fromFile;
        String fromEnvironment = environment == null ? null : environment.get(key);
        if (fromEnvironment != null && !fromEnvironment.isBlank()) return fromEnvironment.trim();
        String fromParameter = startupParameters == null ? null : startupParameters.apply(key);
        if (fromParameter != null && !fromParameter.isBlank()) return fromParameter.trim();
        throw new DeviceAdapterException("缺少来源凭据：" + credentialsFile
                + " 中没有键 " + key + "，环境变量与启动参数 -D" + key + " 也都没有");
    }

    /** 凭据文件缺失不是错误：交付形态可能只用环境变量，所以这里只负责"读到了就返回"。 */
    private static String fromFile(String key, Path credentialsFile)
    {
        if (credentialsFile == null || !Files.isRegularFile(credentialsFile)) return null;
        Properties properties = new Properties();
        try (InputStream input = Files.newInputStream(credentialsFile))
        {
            properties.load(input);
        }
        catch (IOException exception)
        {
            throw new DeviceAdapterException("来源凭据文件无法读取：" + credentialsFile, exception);
        }
        String value = properties.getProperty(key);
        return value == null || value.isBlank() ? null : value.trim();
    }
}