fileupload

type BuildSetting = func(o *uploadBuilder)

type Builder interface {
	NewBuffer() []byte
	Free([]byte)
}

type Downloader interface {
	// GetFileHeader retrieves the file header after the file has been downloaded.
	GetFileHeader(ctx context.Context) (FileHeader, error)
	// DownloadFile downloads the file first and then retrieves the header.
	DownloadFile(ctx context.Context) (io.Reader, error)
	// Finalize finalizes the download process.
	Finalize(ctx context.Context, resp UploadResponse) error
}

type FileHeader interface {
	// GetFilename returns the name of the file.
	GetFilename() string

	// GetSize returns the size of the file in bytes.
	GetSize() uint32

	// GetModTime returns the last modified time of the file as a string.
	GetModTime() uint32

	// GetModTimeString returns the last modified time of the file as a Unix timestamp.
	GetModTimeString() string

	// GetContentType returns the MIME type of the file.
	GetContentType() string

	// GetHeader returns a map of additional file headers.
	GetHeader() map[string]string

	// GetIsDir returns true if the file is a directory.
	GetIsDir() bool
}

type FileInfo interface {
	fs.FileInfo
	ContentType() string
}

type UploadResponse interface {
	// GetSuccess indicates whether the file upload was successful.
	GetSuccess() bool

	// GetHash returns the hash of the uploaded file.
	GetHash() string

	// GetPath returns the path where the file was uploaded.
	GetPath() string

	// GetSize returns the size of the uploaded file in bytes.
	GetSize() uint32

	// GetFailReason returns the failure reason of the file upload.
	GetFailReason() string
}

type Uploader interface {
	// SetFileHeader sets the file header after the file has been uploaded.
	SetFileHeader(ctx context.Context, header FileHeader) error
	// UploadFile uploads the file first and then sets the header.
	UploadFile(ctx context.Context, rd io.Reader) error
	// Finalize finalizes the upload process.
	Finalize(ctx context.Context) (UploadResponse, error)
}