files

type AudioMetadataResponse struct {
	Title       string `json:"title,omitempty"`
	Artist      string `json:"artist,omitempty"`
	Album       string `json:"album,omitempty"`
	AlbumArtist string `json:"album_artist,omitempty"`
	Composer    string `json:"composer,omitempty"`
	Genre       string `json:"genre,omitempty"`
	Year        int    `json:"year,omitempty"`
	Track       int    `json:"track,omitempty"`
	TrackTotal  int    `json:"track_total,omitempty"`
	Disc        int    `json:"disc,omitempty"`
	DiscTotal   int    `json:"disc_total,omitempty"`
	Duration    int    `json:"duration,omitempty"` // 秒
	Lyrics      string `json:"lyrics,omitempty"`   // 内嵌歌词
	Format      string `json:"format,omitempty"`   // MP3, FLAC, etc.
	FileType    string `json:"file_type,omitempty"`
	HasPicture  bool   `json:"has_picture"`
}

type BookmarkItem struct {
	Icon  string `json:"icon"`
	Label string `json:"label"`
	Path  string `json:"path"`
}

type BookmarksResponse struct {
	Default  []BookmarkItem `json:"default"`
	System   []BookmarkItem `json:"system"`
	HomePath string         `json:"home_path"`
}

type CompleteUploadRequest struct {
	UploadID string `json:"upload_id"`
}

type CreateRequest struct {
	Path    string `json:"path" binding:"required"`
	Name    string `json:"name"`
	IsDir   bool   `json:"is_dir"`
	Content string `json:"content,omitempty"`
}

type DiskUsage struct {
	Path    string  `json:"path"`
	Total   int64   `json:"total"`
	Used    int64   `json:"used"`
	Free    int64   `json:"free"`
	UsedPct float64 `json:"used_percent"`
}

type DownloadRequest struct {
	Files  []string `json:"files" form:"files"`   // 文件列表
	Format string   `json:"format" form:"format"` // 压缩格式: zip, tar, targz
}

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

type ElevationSession struct {
	UserID    string    `json:"user_id"`
	Username  string    `json:"username"`
	ExpiresAt time.Time `json:"expires_at"`
}

type FileInfo struct {
	Name       string                 `json:"name"`
	Path       string                 `json:"path"`
	Size       int64                  `json:"size"`
	IsDir      bool                   `json:"is_dir"`
	IsSymlink  bool                   `json:"is_symlink,omitempty"`
	LinkTarget string                 `json:"link_target,omitempty"`
	ModTime    time.Time              `json:"modified"`
	Mode       string                 `json:"mode,omitempty"`
	Owner      string                 `json:"owner,omitempty"`
	Group      string                 `json:"group,omitempty"`
	MimeType   string                 `json:"mime_type,omitempty"`
	Extensions map[string]interface{} `json:"extensions,omitempty"`
}

type FileItem struct {
	Path          string `json:"path" binding:"required"`
	Size          int64  `json:"size"`
	ProcessedSize int64  `json:"processed_size"`
	Finished      bool   `json:"finished"`
}

type FileOperation struct {
	Type          string     `json:"type" binding:"required"` // move, copy
	Items         []FileItem `json:"items" binding:"required"`
	Destination   string     `json:"destination" binding:"required"`
	ConflictStyle string     `json:"conflict_style"` // skip, overwrite
	TotalSize     int64      `json:"total_size"`
	ProcessedSize int64      `json:"processed_size"`
	Finished      bool       `json:"finished"`
	Username      string     `json:"-"` // 执行操作的用户名，不从 JSON 读取
}

type FileStats struct {
	TotalFiles int64 `json:"total_files"`
	TotalDirs  int64 `json:"total_dirs"`
	TotalSize  int64 `json:"total_size"`
}

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

type InitUploadRequest struct {
	Path      string `json:"path"`
	Filename  string `json:"filename"`
	Size      int64  `json:"size"`
	ChunkSize int64  `json:"chunk_size"`
}

type ListRequest struct {
	Path       string `json:"path" form:"path"`
	Index      int    `json:"index" form:"index"`             // 页码，从1开始
	Size       int    `json:"size" form:"size"`               // 每页数量
	ShowHidden bool   `json:"show_hidden" form:"show_hidden"` // 是否显示隐藏文件
}

type ListResponse struct {
	Content      []FileInfo `json:"content"`
	Total        int64      `json:"total"`
	Index        int        `json:"index"`
	Size         int        `json:"size"`
	ResolvedPath string     `json:"resolved_path,omitempty"` // 符号链接解析后的真实路径
}

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

type MountChecker interface {
	IsMounted(path string) bool
}

type OperationStatus struct {
	ID            string `json:"id"`
	Type          string `json:"type"`
	TotalSize     int64  `json:"total_size"`
	ProcessedSize int64  `json:"processed_size"`
	Progress      int    `json:"progress"` // 0-100
	Finished      bool   `json:"finished"`
}

type RenameRequest struct {
	OldPath string `json:"old_path" binding:"required"`
	NewPath string `json:"new_path" binding:"required"`
}

type SearchRequest struct {
	Path       string `json:"path" form:"path"`
	Keyword    string `json:"keyword" form:"keyword" binding:"required"`
	Recursive  bool   `json:"recursive" form:"recursive"`
	FileType   string `json:"file_type" form:"file_type"` // all, file, dir
	MaxResults int    `json:"max_results" form:"max_results"`
}

type SearchResult struct {
	Files []FileInfo `json:"files"`
	Total int        `json:"total"`
}

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

type ThumbnailResult struct {
	Path      string
	Data      []byte
	MimeType  string
	Width     int
	Height    int
	FromCache bool
}

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

type ThumbnailSize int

type UpdateContentRequest struct {
	Path    string `json:"path" binding:"required"`
	Content string `json:"content" binding:"required"`
}

type UploadChunkInfo struct {
	FileName     string `json:"filename" form:"filename"`
	RelativePath string `json:"relative_path" form:"relativePath"`
	ChunkNumber  int    `json:"chunk_number" form:"chunkNumber"`
	TotalChunks  int    `json:"total_chunks" form:"totalChunks"`
	Path         string `json:"path" form:"path"` // 目标目录
}

type UploadMeta struct {
	Path        string
	Filename    string
	Size        int64
	TotalChunks int
	CreatedAt   time.Time
}