mcp

type AdminAPI interface {
	DeleteShareByID(ctx context.Context, id uint) error
	SystemStats(ctx context.Context) (*SystemStats, error)
	StorageStatus(ctx context.Context) (*StorageStatusInfo, error)
	Users(ctx context.Context, page, pageSize int) ([]UserRow, int64, error)
	CleanExpired(ctx context.Context) (count, freed int64, err error)
}

type Caller struct {
	Admin  bool
	UserID uint
	IP     string
}

type FederationAPI interface {
	Status() FederationStatus
	Resolve(code string) (*FederationResolve, error)
}

type FederationResolve struct {
	NodeID    string
	URL       string
	Name      string
	ExpiresAt time.Time
	SizeHint  int64
}

type FederationStatus struct {
	Enabled    bool
	NodeID     string
	Healthy    bool
	Registries []string
}

type FileShareOpts struct {
	FileName     string
	Content      []byte
	ExpireValue  int
	ExpireStyle  string
	PasswordHash string
	CustomCode   string
	UserID       *uint // 归属（游客=nil 匿名归因；登录用户配额记账）
	OwnerIP      string
}

type P2pAPI interface {
	// P2pPeers 在线名录（opt-in 可发现节点）。
	P2pPeers(ctx context.Context) ([]P2pPeerInfo, error)
	// P2pInvites 待收邀请箱快照。
	P2pInvites(ctx context.Context) ([]P2pInviteInfo, error)
	// P2pAccept 认领邀请（纯信封：出箱 + 返回信封）。
	P2pAccept(ctx context.Context, inviteID string) (P2pInviteInfo, error)
}

type P2pInviteInfo struct {
	ID        string `json:"id"`
	Code      string `json:"code"`
	FromName  string `json:"from_name"`
	Note      string `json:"note"`
	ExpiresIn int64  `json:"expires_in"`
}

type P2pPeerInfo struct {
	NodeID      string `json:"node_id"`
	Name        string `json:"name"`
	URL         string `json:"url"`
	BoxPub      string `json:"box_pub"`
	OnlineSince int64  `json:"online_since"`
}

type PreviewAPI interface {
	Preview(ctx context.Context, req PreviewReq) (*PreviewResult, error)
}

type PreviewReq struct {
	Code     string
	UserID   *uint
	ClientIP string
	Password string
}

type PreviewResult struct {
	PreviewType string
	MimeType    string
	TextContent string
	FileSize    int64
	Width       int
	Height      int
	PageCount   int
	Duration    int
}

type RequestAPI interface {
	Create(ctx context.Context, userID uint, req RequestCreate) (token string, expiredAt time.Time, err error)
}

type RequestCreate struct {
	Title       string
	MaxFiles    int
	MaxBytes    int64
	ExpireValue int
	ExpireStyle string
}

type Service struct {
	// contains filtered or unexported fields
}

type ShareAPI interface {
	// CreateTextShare 创建文本分享。userID=nil 匿名归因。
	CreateTextShare(ctx context.Context, text string, expireValue int, expireStyle string,
		requireAuth bool, passwordHash string, userID *uint, ownerIP, customCode string) (ShareCreated, error)
	// ShareBytes 内存内容建文件分享（MCP 通道：落存储 + 配额/审核/白名单链路）。
	ShareBytes(ctx context.Context, opts FileShareOpts) (ShareCreated, error)
	// ShareFiles 取分享的子文件清单。
	ShareFiles(ctx context.Context, code string) ([]ShareFileInfo, error)
}

type ShareCreated struct {
	Code         string
	PickupCode   string
	FullShareURL string
}

type ShareFileInfo struct {
	Name string
	Size int64
}

type ShareGate struct {
	// ReadsShare 本工具是否对外交付分享内容或元信息（true ⇒ 必须守次数闸）。
	ReadsShare bool
	// Exhausted 次数耗尽时的判定（错误文案/业务码口径）；ReadsShare=false 时留空。
	Exhausted string
	// CoveredBy 覆盖该策略的行为测试函数名（守卫机械校验其真实存在）。
	CoveredBy string
}

type StorageAPI interface {
	GetFileSize(ctx context.Context, filePath string) (int64, error)
	GetFile(ctx context.Context, filePath string) ([]byte, error)
}

type StorageStatusInfo struct {
	StorageType  string
	TotalSpace   int64
	UsedSpace    int64
	UsagePercent float64
	FileCount    int64
}

type SystemStats struct {
	TotalFiles   int64
	TotalUsers   int64
	TotalSize    int64
	TodayUploads int64
	ExpiredFiles int64
}

type UserRow struct {
	ID       uint
	Username string
	Email    string
	Status   string
}