// Package catalog 目录库服务（方案第一阶段 — 目录库独立查询层）。
//
// 方案定位：目录库负责存储 MA、Hash、片库文件 ID、省内内容编码等映射关系，
// 为标识查询接口提供统一入口。本包在 chain.Client 之上封装独立查询服务，
// 支持按 MA 码、Hash、省级编码、片库文件 ID 四种维度查询标识信息。
//
// 架构说明：
//   - MVP 阶段委托 chain.Client 获取数据（零数据冗余，单一真相源）
//   - 生产阶段可替换为独立 PostgreSQL 存储（通过 CatalogStore 接口注入）
//   - 对外接口不变，业务层零改动
package catalog

import (
	"github.com/tcs-iptv/tcs/internal/chain"
	"github.com/tcs-iptv/tcs/internal/model"
)

// Catalog 目录库查询服务。
// 提供四种维度的标识信息查询：CC码、Hash、省级编码、片库文件ID。
type Catalog struct {
	client chain.Client
	store  CatalogStore // 可选独立存储（为 nil 时委托 chain.Client）
}

// CatalogStore 目录库独立存储接口（生产阶段可替换为 PG 实现）。
type CatalogStore interface {
	FindByHash(fileHash string) (model.ContentQueryResult, error)
	FindByProvincialCode(code string) (model.ContentQueryResult, error)
	FindByLibraryFileID(libraryID string) (model.ContentQueryResult, error)
}

// New 创建目录库服务（委托 chain.Client）。
func New(c chain.Client) *Catalog {
	return &Catalog{client: c}
}

// NewWithStore 创建目录库服务（使用独立存储）。
func NewWithStore(c chain.Client, s CatalogStore) *Catalog {
	return &Catalog{client: c, store: s}
}

// QueryByMA 根据CC码查询标识信息及映射关系。
func (cat *Catalog) QueryByMA(ccCode string) (model.ContentQueryResult, error) {
	c, err := cat.client.QueryContent(ccCode)
	if err != nil {
		return model.ContentQueryResult{Found: false}, err
	}
	mr, _ := cat.client.QueryMappings(ccCode)
	eps, _ := cat.client.ListEpisodes(ccCode)
	bindings := eps
	return model.ContentQueryResult{
		Found:    true,
		Content:  c,
		Bindings: bindings,
		Mappings: mr.Mappings,
	}, nil
}

// QueryByHash 根据内容哈希反查标识信息。
func (cat *Catalog) QueryByHash(fileHash string) (model.ContentQueryResult, error) {
	if cat.store != nil {
		return cat.store.FindByHash(fileHash)
	}
	return cat.client.QueryByHash(fileHash)
}

// QueryByProvincialCode 根据省级内容编码反查标识信息。
func (cat *Catalog) QueryByProvincialCode(code string) (model.ContentQueryResult, error) {
	if cat.store != nil {
		return cat.store.FindByProvincialCode(code)
	}
	return cat.client.QueryByProvincialCode(code)
}

// QueryByLibraryFileID 根据片库文件 ID 反查标识信息。
func (cat *Catalog) QueryByLibraryFileID(libraryID string) (model.ContentQueryResult, error) {
	if cat.store != nil {
		return cat.store.FindByLibraryFileID(libraryID)
	}
	return cat.client.QueryByLibraryFileID(libraryID)
}

// QueryAll 批量查询：按 MA 码返回全部关联信息（含绑定、映射、集级哈希）。
func (cat *Catalog) QueryAll(ccCode string) (model.ContentQueryResult, error) {
	return cat.QueryByMA(ccCode)
}