package search

import "strings"

// 本文件是「搜索提供商」页的**数据面**：表格行与下拉选项的来源。
//
// 它只做**翻译**（事实 → 面板要的形状），不读文件、不开路由、不鉴权 —— 那些是插件管理器
// 与宿主端点的事（design/09 §5.2.1 B）。放这里的理由只有一个：`state` 与选项值的语义
// 属于 provider 领域（要问 `Configured` / `KnownNames`），散到宿主里就会与面板声明各写一套。

// 表格 `state` 列的取值（design/09 §5.2 示例：「ok | 未配置 | 凭据失效 | 未知」）。
//
// 「凭据失效」不在这里：它只能由一次真实调用得知（那是 plugin.testProvider 的结论，
// 见 probe.go），列表接口不该为了它去逐家发请求。
const (
	// StateOK 表示这家可以用了（名字已登记且已配齐且启用）。
	StateOK = "ok"
	// StateNotConfigured 表示这个名字已登记，但没配齐（云家缺 key、searxng 缺地址）。
	StateNotConfigured = "not_configured"
	// StateDisabled 表示这条已被显式停用（enabled=false）。
	StateDisabled = "disabled"
	// StateUnknown 表示这个名字本期没登记（写错了 / 还没做，如 tavily）。
	StateUnknown = "unknown"
)

// ProviderInput 是构造一行所需的最小事实（一条 provider 配置）。
//
// 刻意用平铺字段而不是引用 runtimeconfig 的类型：search 包是插件实现，不该认识宿主的
// 配置文件形状（那份形状属于宿主，见 internal/config/runtimeconfig/websearch.go）。
type ProviderInput struct {
	// Provider 是 provider 名。
	Provider string
	// APIKey 是上游凭据（判定是否配齐用，**绝不进行数据**）。
	APIKey string
	// BaseURL 是上游基地址（同上，判定用）。
	BaseURL string
	// Enabled 是启用态。
	Enabled bool
}

// ProviderRow 是「已配置的提供商」表格的一行。字段名即表格列的 key（panel.go 的 columns）。
//
// 凭据与基地址**都不进行数据**：列表只需要状态，凭据读侧无明文（design/09 §5.4.2），
// 而基地址可能带用户名口令。要看地址就点「重配凭据」，由表单一对一带回。
type ProviderRow struct {
	Provider string `json:"provider"`
	State    string `json:"state"`
	Enabled  bool   `json:"enabled"`
}

// BuildRows 把各条配置翻译成表格行。
//
// 判定顺序是把「根因」排在前面：名字没登记（写错了）> 显式停用 > 没配齐 > 可用。
// 一个停用的陌生名字报 `unknown` —— 名字错了才是要修的那处。
func BuildRows(inputs []ProviderInput) []ProviderRow {
	out := make([]ProviderRow, 0, len(inputs))
	for _, in := range inputs {
		out = append(out, ProviderRow{
			Provider: strings.ToLower(strings.TrimSpace(in.Provider)),
			State:    providerState(in),
			Enabled:  in.Enabled,
		})
	}
	return out
}

// providerState 判定一条配置的表格状态。
func providerState(in ProviderInput) string {
	name := strings.ToLower(strings.TrimSpace(in.Provider))
	if !Known(name) {
		return StateUnknown
	}
	if !in.Enabled {
		return StateDisabled
	}
	if !Configured(name, in.APIKey, in.BaseURL) {
		return StateNotConfigured
	}
	return StateOK
}

// ProviderOptions 返回 `optionsFrom: plugin:providers` 的选项值 —— 本期**全部已登记**的
// provider 名（含尚未配置的家），稳定排序。
//
// 为什么给全部而不是「已配置的家」：表单的用途就是**新增**一家，只列已配置的会让
// 「第一次配置」无从选起。可用性不靠下拉限制，靠列表的 `state` 列如实呈现。
func ProviderOptions() []string { return KnownNames() }