// Package service — library / media bookkeeping. package service import ( "context" "errors" "fmt" "os" "path/filepath" "strings" "go.uber.org/zap" "github.com/ShukeBta/MediaStationGo/internal/config" "github.com/ShukeBta/MediaStationGo/internal/model" "github.com/ShukeBta/MediaStationGo/internal/repository" ) // MediaService offers high-level CRUD over libraries and media items. type MediaService struct { cfg *config.Config log *zap.Logger repo *repository.Container } type MediaVisibility struct { IncludeNSFW bool AllowedLibraryIDs []string HiddenLibraryIDs []string } const maxMediaSearchLimit = 50000 const maxMediaSearchPageSize = 2000 func (v MediaVisibility) Allows(media *model.Media) bool { if media == nil { return false } if !v.IncludeNSFW && media.NSFW { return false } for _, id := range v.HiddenLibraryIDs { if id == media.LibraryID { return false } } if len(v.AllowedLibraryIDs) == 0 { return true } for _, id := range v.AllowedLibraryIDs { if id == media.LibraryID { return true } } return false } // NewMediaService is the constructor. func NewMediaService(cfg *config.Config, log *zap.Logger, repo *repository.Container) *MediaService { return &MediaService{cfg: cfg, log: log, repo: repo} } // CreateLibrary persists a library after validating that its path exists. func (s *MediaService) CreateLibrary(ctx context.Context, name, path, kind string) (*model.Library, error) { if name == "" || path == "" { return nil, errors.New("name and path required") } abs, err := resolveAccessibleLibraryPath(path) if err != nil { return nil, err } kind = inferLibraryKind(name, abs, kind) lib := &model.Library{Name: name, Path: abs, Type: kind, Enabled: true} if err := s.repo.Library.Create(ctx, lib); err != nil { return nil, err } return lib, nil } func inferLibraryKind(name, path, requested string) string { requested = normalizeOrganizeMediaType(requested) text := strings.ToLower(name + " " + filepath.ToSlash(path)) switch { case containsAnyText(text, "成人", "番号", "jav", "9kg", "adult", "nsfw"): return "adult" case containsAnyText(text, "综艺", "真人秀", "variety"): return "variety" case containsAnyText(text, "国漫", "日漫", "日番", "动漫", "动画", "anime", "bangumi") && !containsAnyText(text, "动画电影"): return "anime" case containsAnyText(text, "电视剧", "国产剧", "欧美剧", "日韩剧", "日剧", "韩剧", "剧集", "tv", "series"): return "tv" case containsAnyText(text, "电影", "movie", "film"): return "movie" } if requested != "" { return requested } return "movie" } func resolveAccessibleLibraryPath(path string) (string, error) { input := strings.TrimSpace(path) if input == "" { return "", errors.New("path required") } for _, candidate := range mappedPathCandidates(input) { if isAccessibleDir(candidate) { return filepath.Clean(candidate), nil } } abs, err := filepath.Abs(input) if err != nil { return "", fmt.Errorf("invalid path: %w", err) } return "", fmt.Errorf("path is not an accessible directory: %s", abs) } func resolveAccessibleMappedPath(path string) (string, os.FileInfo, error) { input := strings.TrimSpace(path) if input == "" { return "", nil, errors.New("path required") } candidates := mappedPathCandidates(input) for _, candidate := range candidates { if info, err := os.Stat(candidate); err == nil { return filepath.Clean(candidate), info, nil } } abs, err := filepath.Abs(input) if err != nil { return "", nil, fmt.Errorf("invalid path: %w", err) } return "", nil, fmt.Errorf("path is not accessible: %s", abs) } func resolveMappedDestinationPath(path string) string { path = strings.TrimSpace(path) if path == "" { return "" } clean := filepath.Clean(path) if _, err := os.Stat(clean); err == nil { return clean } for _, candidate := range mappedPathCandidates(clean) { if candidate == clean { continue } return filepath.Clean(candidate) } return clean } func mappedPathCandidates(input string) []string { var candidates []string add := func(candidate string) { candidate = filepath.Clean(filepath.FromSlash(strings.TrimSpace(candidate))) if candidate == "" || candidate == "." { return } for _, existing := range candidates { if sameLibraryPath(existing, candidate) { return } } candidates = append(candidates, candidate) } clean := filepath.Clean(input) add(clean) for _, candidate := range dockerVolumePathCandidates(input) { add(candidate) } for _, candidate := range dockerVolumePathCandidates(clean) { add(candidate) } if slashClean := cleanPathForVolumeMapping(input); slashClean != "" { add(slashClean) } if abs, err := filepath.Abs(input); err == nil { add(abs) for _, candidate := range dockerVolumePathCandidates(abs) { add(candidate) } } return candidates } func isAccessibleDir(path string) bool { info, err := os.Stat(path) return err == nil && info.IsDir() } func dockerVolumePathCandidates(path string) []string { normalized := cleanPathForVolumeMapping(path) var candidates []string addCandidate := func(candidate string) { candidate = filepath.Clean(filepath.FromSlash(candidate)) for _, existing := range candidates { if sameLibraryPath(existing, candidate) { return } } candidates = append(candidates, candidate) } for _, mapping := range []struct { env string container string }{ {env: "MEDIASTATION_MEDIA_DIR", container: envOrDefault("MEDIASTATION_MEDIA_CONTAINER_DIR", "/media")}, {env: "MEDIASTATION_DOWNLOAD_DIR", container: envOrDefault("MEDIASTATION_DOWNLOAD_CONTAINER_DIR", "/downloads")}, } { host := cleanPathForVolumeMapping(os.Getenv(mapping.env)) if host == "." || host == "" || strings.HasPrefix(host, ".") { continue } if normalized == host { addCandidate(mapping.container) continue } if strings.HasPrefix(normalized, host+"/") { addCandidate(mapping.container + strings.TrimPrefix(normalized, host)) } } for _, marker := range []struct { part string container string }{ {part: "/media", container: envOrDefault("MEDIASTATION_MEDIA_CONTAINER_DIR", "/media")}, {part: "/downloads", container: envOrDefault("MEDIASTATION_DOWNLOAD_CONTAINER_DIR", "/downloads")}, } { part := strings.TrimRight(marker.part, "/") container := strings.TrimRight(filepath.ToSlash(marker.container), "/") markerPath := pathAfterWindowsDrivePrefix(normalized) if markerPath == part { addCandidate(container) continue } if strings.HasPrefix(markerPath, part+"/") { addCandidate(container + strings.TrimPrefix(markerPath, part)) } } return candidates } func cleanPathForVolumeMapping(path string) string { path = strings.TrimSpace(path) if path == "" { return "" } path = strings.ReplaceAll(path, "\\", "/") path = trimEmbeddedWindowsDrive(path) return filepath.ToSlash(filepath.Clean(filepath.FromSlash(path))) } func pathAfterWindowsDrivePrefix(path string) string { if len(path) >= 3 && path[1] == ':' && path[2] == '/' && isASCIIAlpha(path[0]) { return path[2:] } return path } func trimEmbeddedWindowsDrive(path string) string { for i := 0; i+2 < len(path); i++ { if !isASCIIAlpha(path[i]) || path[i+1] != ':' || path[i+2] != '/' { continue } if i == 0 || path[i-1] == '/' { return path[i:] } } return path } func isASCIIAlpha(ch byte) bool { return (ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') } func sameLibraryPath(a, b string) bool { return filepath.Clean(a) == filepath.Clean(b) } func envOrDefault(key, fallback string) string { if value := strings.TrimSpace(os.Getenv(key)); value != "" { return value } return fallback } // ListLibraries returns every library configured on the server. func (s *MediaService) ListLibraries(ctx context.Context) ([]model.Library, error) { return s.repo.Library.List(ctx) } // DeleteLibrary removes a library and its media rows. The on-disk files are // left untouched. func (s *MediaService) DeleteLibrary(ctx context.Context, id string) error { lib, err := s.repo.Library.FindByID(ctx, id) if err != nil { return err } if lib != nil { if _, ok := ParseCloudLibraryMount(lib.Path); ok { if err := s.repo.Media.PurgeByLibrary(ctx, id); err != nil { return err } return s.repo.DB.WithContext(ctx).Unscoped().Where("id = ?", id).Delete(&model.Library{}).Error } } if err := s.repo.Media.DeleteByLibrary(ctx, id); err != nil { return err } return s.repo.Library.Delete(ctx, id) } // ListMedia paginates media items inside a library. func (s *MediaService) ListMedia(ctx context.Context, libraryID string, page, pageSize int) ([]model.Media, int64, error) { return s.ListMediaVisible(ctx, libraryID, page, pageSize, MediaVisibility{IncludeNSFW: true}) } func (s *MediaService) ListMediaVisible(ctx context.Context, libraryID string, page, pageSize int, visibility MediaVisibility) ([]model.Media, int64, error) { if pageSize <= 0 { pageSize = 50 } if pageSize > 2000 { pageSize = 2000 } if page < 1 { page = 1 } visibility = ExpandMediaVisibilityForMergedCloudLibraries(ctx, s.repo, visibility) libraryIDs, err := MergedLibraryIDsForLibrary(ctx, s.repo, libraryID) if err != nil { return nil, 0, err } return s.repo.Media.ListByLibrariesFiltered(ctx, libraryIDs, (page-1)*pageSize, pageSize, repository.MediaQueryFilter{ IncludeNSFW: visibility.IncludeNSFW, AllowedLibraryIDs: visibility.AllowedLibraryIDs, HiddenLibraryIDs: visibility.HiddenLibraryIDs, }) } // SearchMedia performs a simple LIKE search across titles. func (s *MediaService) SearchMedia(ctx context.Context, query string, limit int) ([]model.Media, error) { return s.SearchMediaVisible(ctx, query, limit, MediaVisibility{IncludeNSFW: true}) } func (s *MediaService) SearchMediaVisible(ctx context.Context, query string, limit int, visibility MediaVisibility) ([]model.Media, error) { if limit <= 0 { limit = 50 } else if limit > maxMediaSearchLimit { limit = maxMediaSearchLimit } visibility = ExpandMediaVisibilityForMergedCloudLibraries(ctx, s.repo, visibility) return s.repo.Media.SearchFiltered(ctx, query, limit, repository.MediaQueryFilter{ IncludeNSFW: visibility.IncludeNSFW, AllowedLibraryIDs: visibility.AllowedLibraryIDs, HiddenLibraryIDs: visibility.HiddenLibraryIDs, }) } func (s *MediaService) SearchMediaVisiblePage(ctx context.Context, query string, page, pageSize int, visibility MediaVisibility) ([]model.Media, int64, error) { if pageSize <= 0 { pageSize = 50 } if pageSize > maxMediaSearchPageSize { pageSize = maxMediaSearchPageSize } if page < 1 { page = 1 } visibility = ExpandMediaVisibilityForMergedCloudLibraries(ctx, s.repo, visibility) return s.repo.Media.SearchFilteredPage(ctx, query, (page-1)*pageSize, pageSize, repository.MediaQueryFilter{ IncludeNSFW: visibility.IncludeNSFW, AllowedLibraryIDs: visibility.AllowedLibraryIDs, HiddenLibraryIDs: visibility.HiddenLibraryIDs, }) } // GetMedia returns a single media row. func (s *MediaService) GetMedia(ctx context.Context, id string) (*model.Media, error) { return s.repo.Media.FindByID(ctx, id) } // SoftDelete moves a media row to the recycle bin (gorm soft delete). // The on-disk file is kept; admins can purge it later. func (s *MediaService) SoftDelete(ctx context.Context, id string) error { media, err := s.repo.Media.FindByID(ctx, id) if err != nil { return err } if media != nil && isCloudMediaPath(media.Path) { return s.repo.DB.WithContext(ctx).Unscoped().Where("id = ?", id).Delete(&model.Media{}).Error } return s.repo.DB.Where("id = ?", id).Delete(&model.Media{}).Error } // RestoreDeleted unsets DeletedAt for a single media row. func (s *MediaService) RestoreDeleted(ctx context.Context, id string) error { return s.repo.DB.Unscoped().Model(&model.Media{}). Where("id = ?", id).Update("deleted_at", nil).Error } // ListRecycleBin returns every soft-deleted row, newest first. func (s *MediaService) ListRecycleBin(ctx context.Context, limit int) ([]model.Media, error) { if limit <= 0 || limit > 500 { limit = 100 } var rows []model.Media err := s.repo.DB.Unscoped(). Where("deleted_at IS NOT NULL"). Order("deleted_at desc"). Limit(limit). Find(&rows).Error return rows, err } // PurgeDeleted permanently removes a soft-deleted row from the database. func (s *MediaService) PurgeDeleted(ctx context.Context, id string) error { return s.repo.DB.Unscoped().Where("id = ?", id).Delete(&model.Media{}).Error }