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 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) (code, fullURL string, err error)
	// ShareBytes 内存内容建文件分享（MCP 通道：落存储 + 配额/审核/白名单链路）。
	ShareBytes(ctx context.Context, opts FileShareOpts) (code, fullURL string, err error)
	// ShareFiles 取分享的子文件清单。
	ShareFiles(ctx context.Context, code string) ([]ShareFileInfo, error)
}

type ShareFileInfo struct {
	Name string
	Size int64
}

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
}