package main

// 附件相关的两个小助手。
//
// 单独一个文件而不是塞进 plugin.go：它们是纯函数、有独立测试，
// 而 plugin.go 已经是这个插件里最长的文件。

import (
	"fmt"
	"strings"
)

// stringList 把工具参数里的数组取成 []string。
//
// # 为什么不能直接断言 []string
//
// SDK 把工具参数当 JSON 解出来交给插件，所以数组一律是 `[]interface{}`，
// 元素一律是 `interface{}`（字符串元素的动态类型是 `string`）。
// 写 `args["attachment_ids"].([]string)` 永远失败 —— 而失败是静默的：
// 类型断言的第二个返回值一丢，附件字段就消失了，发出去的邮件没有附件，
// HTTP 仍是 200。这正是 `attachments` 字段名写错时发生过的事故形状。
//
// # 逐项校验而非整体放弃
//
// 模型偶尔会混进 null 或数字。丢掉坏元素、保留好元素，比整批丢弃好：
// 后者会让「三个附件里有一个写错」变成「一个附件都没发出」。
// 空字符串一并丢掉 —— 服务端的 parseAttachmentIDs 也跳过空串，
// 与它保持一致，免得插件放过去的东西在服务端换个形状再失败一次。
//
// 也接受单个字符串（不带数组）：那是模型常见的偷懒写法，
// 拒绝它只会换来一次重试，而意图毫无歧义。
func stringList(v interface{}) []string {
	switch t := v.(type) {
	case nil:
		return nil
	case string:
		s := strings.TrimSpace(t)
		if s == "" {
			return nil
		}
		return []string{s}
	case []string:
		// 单测里手写参数时会走到这一支；运行时走不到（见上）
		out := make([]string, 0, len(t))
		for _, s := range t {
			if s = strings.TrimSpace(s); s != "" {
				out = append(out, s)
			}
		}
		return out
	case []interface{}:
		out := make([]string, 0, len(t))
		for _, e := range t {
			s, ok := e.(string)
			if !ok {
				continue
			}
			if s = strings.TrimSpace(s); s != "" {
				out = append(out, s)
			}
		}
		return out
	default:
		return nil
	}
}

// formatSize 把字节数写成人类可读的大小。
//
// 与三个 Node 插件的 formatSize 同形（B / KB / MB，一位小数）。
// 原先这里直接写 `size/1024` 加 "KB"：一个 800 字节的附件显示成 `0KB`,
// 而模型会据此认为上传失败了。
func formatSize(n int64) string {
	switch {
	case n < 0:
		return "0 B"
	case n < 1024:
		return fmt.Sprintf("%d B", n)
	case n < 1024*1024:
		return fmt.Sprintf("%.1f KB", float64(n)/1024)
	default:
		return fmt.Sprintf("%.1f MB", float64(n)/(1024*1024))
	}
}