File storage rewrite (#2676)

* Restructure data layer part 2 (#2599)
* Refactor and separate image model
* Refactor image query builder
* Handle relationships in image query builder
* Remove relationship management methods
* Refactor gallery model/query builder
* Add scenes to gallery model
* Convert scene model
* Refactor scene models
* Remove unused methods
* Add unit tests for gallery
* Add image tests
* Add scene tests
* Convert unnecessary scene value pointers to values
* Convert unnecessary pointer values to values
* Refactor scene partial
* Add scene partial tests
* Refactor ImagePartial
* Add image partial tests
* Refactor gallery partial update
* Add partial gallery update tests
* Use zero/null package for null values
* Add files and scan system
* Add sqlite implementation for files/folders
* Add unit tests for files/folders
* Image refactors
* Update image data layer
* Refactor gallery model and creation
* Refactor scene model
* Refactor scenes
* Don't set title from filename
* Allow galleries to freely add/remove images
* Add multiple scene file support to graphql and UI
* Add multiple file support for images in graphql/UI
* Add multiple file for galleries in graphql/UI
* Remove use of some deprecated fields
* Remove scene path usage
* Remove gallery path usage
* Remove path from image
* Move funscript to video file
* Refactor caption detection
* Migrate existing data
* Add post commit/rollback hook system
* Lint. Comment out import/export tests
* Add WithDatabase read only wrapper
* Prepend tasks to list
* Add 32 pre-migration
* Add warnings in release and migration notes

pkg/file/folder.go

@@ -0,0 +1,66 @@
+package file
+
+import (
+	"context"
+	"io/fs"
+	"strconv"
+	"time"
+)
+
+// FolderID represents an ID of a folder.
+type FolderID int32
+
+// String converts the ID to a string.
+func (i FolderID) String() string {
+	return strconv.Itoa(int(i))
+}
+
+// Folder represents a folder in the file system.
+type Folder struct {
+	ID FolderID `json:"id"`
+	DirEntry
+	Path           string    `json:"path"`
+	ParentFolderID *FolderID `json:"parent_folder_id"`
+
+	CreatedAt time.Time `json:"created_at"`
+	UpdatedAt time.Time `json:"updated_at"`
+}
+
+func (f *Folder) Info(fs FS) (fs.FileInfo, error) {
+	return f.info(fs, f.Path)
+}
+
+// FolderGetter provides methods to find Folders.
+type FolderGetter interface {
+	FindByPath(ctx context.Context, path string) (*Folder, error)
+	FindByZipFileID(ctx context.Context, zipFileID ID) ([]*Folder, error)
+	FindAllInPaths(ctx context.Context, p []string, limit, offset int) ([]*Folder, error)
+	FindByParentFolderID(ctx context.Context, parentFolderID FolderID) ([]*Folder, error)
+}
+
+type FolderCounter interface {
+	CountAllInPaths(ctx context.Context, p []string) (int, error)
+}
+
+// FolderCreator provides methods to create Folders.
+type FolderCreator interface {
+	Create(ctx context.Context, f *Folder) error
+}
+
+// FolderUpdater provides methods to update Folders.
+type FolderUpdater interface {
+	Update(ctx context.Context, f *Folder) error
+}
+
+type FolderDestroyer interface {
+	Destroy(ctx context.Context, id FolderID) error
+}
+
+// FolderStore provides methods to find, create and update Folders.
+type FolderStore interface {
+	FolderGetter
+	FolderCounter
+	FolderCreator
+	FolderUpdater
+	FolderDestroyer
+}