package httpapi

// contract_test.go — HTTP 契约快照(支柱 2:契约单源)。
//
// 冻结 GET /v1/me 响应的字段面(JSON key)。后端加/删/改字段会让本测试失败,逼开发者
// 同步客户端 model + 文档,避免控制面与客户端悄悄分叉。
//
// ⚠️ 与客户端冻结集对账:client/test/contract/api_contract_test.dart 的 _frozenMeKeys
// (9 个)。后端这里多发 uuid / dp_uuid(客户端故意忽略);expire_at 已废弃移除——
// 无 web 用户中心后,两端统一只用 expires_at。改任一端都要回看另一端。

import (
	"reflect"
	"strings"
	"testing"
)

func jsonTagSet(v any) map[string]struct{} {
	t := reflect.TypeOf(v)
	if t.Kind() == reflect.Ptr {
		t = t.Elem()
	}
	set := map[string]struct{}{}
	for i := 0; i < t.NumField(); i++ {
		tag := t.Field(i).Tag.Get("json")
		if tag == "" || tag == "-" {
			continue
		}
		name := strings.SplitN(tag, ",", 2)[0]
		if name != "" {
			set[name] = struct{}{}
		}
	}
	return set
}

func assertFrozenKeys(t *testing.T, name string, got map[string]struct{}, want ...string) {
	t.Helper()
	wantSet := make(map[string]struct{}, len(want))
	for _, k := range want {
		wantSet[k] = struct{}{}
	}
	for k := range got {
		if _, ok := wantSet[k]; !ok {
			t.Errorf("%s: 出现未冻结字段 %q —— 改契约需同步另一端(客户端 model)+ 文档", name, k)
		}
	}
	for _, k := range want {
		if _, ok := got[k]; !ok {
			t.Errorf("%s: 缺失冻结字段 %q", name, k)
		}
	}
}

func TestContractMeResponse(t *testing.T) {
	assertFrozenKeys(t, "/v1/me", jsonTagSet(meResponse{}),
		"uuid", "email", "dp_uuid", "plan", "expires_at",
		"devices_used", "devices_max",
		"quota_today_min", "quota_cap_min", "data_today_gb", "weekly_gb", "totp_enabled",
	)
}