file

type Handler interface {
	// BeginWrite creates an empty file.
	BeginWrite(ctx context.Context, fileName string) (uuid.UUID, error)

	// WriteChunk writes a chunk of data to a file identified by its ID.
	WriteChunk(ctx context.Context, sessionID uuid.UUID, chunk []byte) (err error)

	// EndWrite is called to finalize the file writing.
	EndWrite(ctx context.Context, sessionID uuid.UUID) (fileHash []byte, err error)

	// AbortWrite is called to abort the file writing process.
	AbortWrite(ctx context.Context, sessionID uuid.UUID) (err error)

	// ReadChunks reads a file by chunk and calls the callback for each chunk.
	ReadChunks(ctx context.Context, fileHash []byte, chunkSize int, reader Reader) error

	// Read returns the content of a file given its hash.
	Read(ctx context.Context, fileHash []byte) ([]byte, error)

	// Exists returns whether the file with the given hash exists in the handler db.
	Exists(ctx context.Context, fileHash []byte) (bool, error)
}

type Reader interface {
	OnChunk(chunk []byte, filePath string) error
}