// Package chain 定义可信数据空间（联盟链）的客户端抽象。
// MVP 提供内存 mock 实现，使业务逻辑可在无真实 ChainMaker 网络时开发与测试；
// 后续以 ChainMaker Go SDK 实现替换，接口不变。
// 对应需求：需求16（智能合约方法）、需求3/4（签发与验真）、需求14（权限）。
package chain

import (
	"errors"

	"github.com/tcs-iptv/tcs/internal/model"
)

// Role 调用方角色，用于合约级权限控制（需求14）。
type Role string

const (
	RoleRegulator Role = "regulator" // 监管主体：唯一可 issueMA / 下架
	RoleReviewer  Role = "reviewer"  // 审核主体（CSPS/媒资库）
	RoleCP        Role = "cp"        // 内容提供商
	RoleOperator  Role = "operator"  // 运营商
)

// 错误定义。
var (
	ErrPermissionDenied = errors.New("chain: permission denied")
	ErrMANotIssued      = errors.New("chain: MA not issued")
	ErrMAAlreadyIssued  = errors.New("chain: MA already issued (1:1 binding immutable)")
	ErrHashExists       = errors.New("chain: content hash already exists")
	ErrNotFound         = errors.New("chain: not found")
)

// IssueRequest 签发 MA 码并强绑定哈希包。
type IssueRequest struct {
	MACode         string
	ContentTwinID  string
	MerkleRoot     string
	FileHash       string
	PerceptualHash string
	Episodes       []model.EpisodeHash // 集级哈希（分集内容）
	Content        model.Content
}

// VerifyResult 哈希验真结果（需求4-AC4）。
type VerifyResult struct {
	Valid         bool   `json:"valid"`
	MACode        string `json:"ma_code"`
	BoundHash     string `json:"bound_hash"`
	SubmittedHash string `json:"submitted_hash"`
	Match         bool   `json:"match"`
	Version       string `json:"version"`
}

// MappingsResult 映射查询结果（需求11/17）。
type MappingsResult struct {
	MACode       string          `json:"ma_code"`
	Mappings     []model.Mapping `json:"mappings"`
	CDNEndpoints []string        `json:"cdn_endpoints"`
}

// Client 是可信数据空间的统一访问接口。
// 业务服务只依赖此接口，不感知底层是 mock 还是 ChainMaker。
type Client interface {
	// IssueMA 签发 MA 码并与哈希包 1:1 强绑定（仅监管主体）。
	IssueMA(role Role, req IssueRequest) (txID string, err error)
	// RegisterHashBinding 追加哈希绑定（如转码版，建立父子关系）。
	RegisterHashBinding(role Role, b model.HashBinding) (txID string, err error)
	// RegisterMapping 注册三方编码映射（MA 必须已签发）。
	RegisterMapping(role Role, m model.Mapping) (txID string, err error)
	// VerifyHash 按 MA 码校验提交哈希是否与绑定哈希一致。
	VerifyHash(maCode, fileHash string) (VerifyResult, error)
	// VerifyEpisodeHash 按 MA 码+集号校验该集哈希。
	VerifyEpisodeHash(maCode string, episode int, fileHash string) (VerifyResult, error)
	// ListEpisodes 返回某 MA 码下的全部集级哈希绑定。
	ListEpisodes(maCode string) ([]model.HashBinding, error)
	// HashExists 判断内容哈希是否已存在（防换壳重发）。
	HashExists(fileHash string) (maCode string, exists bool)
	// QueryContent 查询内容主记录。
	QueryContent(maCode string) (model.Content, error)
	// ListContents 按状态列出内容（空状态返回全部）。
	ListContents(status string) ([]model.Content, error)
	// QueryMappings 查询 MA 码绑定的全部三方映射与 CDN 端点。
	QueryMappings(maCode string) (MappingsResult, error)
	// RecordVersionChange 记录版本变更（绑定断裂触发重审）。
	RecordVersionChange(vc model.VersionChange) (txID string, err error)
	// Revoke 下架（仅监管主体），返回受影响的映射。
	Revoke(role Role, maCode, reason string) (MappingsResult, error)
	// RevokeEpisode 集级下架（仅监管主体）：只下架指定集，整剧其他集不受影响。
	RevokeEpisode(role Role, maCode string, episode int, reason string) error
	// Restore 恢复上架整剧（仅监管主体）：下架状态恢复为流通中。
	Restore(role Role, maCode string) error
	// RestoreEpisode 恢复上架指定集（仅监管主体）。
	RestoreEpisode(role Role, maCode string, episode int) error
	// SetContentStatus 更新内容状态。
	SetContentStatus(maCode, status string) error
}