blaze

type Blob struct {
	Type  string `json:"type"`
	Bytes []byte `json:"bytes"`
}

type ClaimKey struct {
	heat.Base `json:"-" heat:"fire/blaze.claim,1h"`

	// The uploaded file.
	File coal.ID
}

type CleanupJob struct {
	axe.Base `json:"-" axe:"fire/blaze.cleanup"`
	stick.NoValidation
}

type Download interface {
	// Seek(offset int64, whence int) (int64, error)
	Read(buf []byte) (int, error)
	Close() error
}

type File struct {
	coal.Base `json:"-" bson:",inline" coal:"files"`

	// The current state of the file e.g. "uploading".
	State State `json:"state"`

	// The last time the file was updated.
	Updated time.Time `json:"updated-at" bson:"updated_at"`

	// The MIME type of the file e.g. "image/png".
	Type string `json:"type"`

	// The total length of the file.
	Length int64 `json:"length"`

	// The service specific blob handle.
	Handle Handle `json:"handle"`
}

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

type Handle map[string]interface{}

type Link struct {
	// The type of the linked file.
	Type string `json:"type"`

	// The length of the linked file.
	Length int64 `json:"length"`

	// The key for claiming the linked file.
	ClaimKey string `json:"claim-key" bson:"-"`

	// The key for viewing the linked file.
	ViewKey string `json:"view-key" bson:"-"`

	// The reference to the linked file.
	File *coal.ID `json:"-" bson:"file_id"`
}

type Memory struct {
	// The stored blobs.
	Blobs map[string]*Blob

	// The next id.
	Next int
}

type Service interface {
	// Prepare should return a new handle for uploading a blob.
	Prepare(ctx context.Context) (Handle, error)

	// Upload should initiate the upload of a blob.
	Upload(ctx context.Context, handle Handle, contentType string) (Upload, error)

	// Download should initiate the download of a blob.
	Download(ctx context.Context, handle Handle) (Download, error)

	// Delete should delete the blob.
	Delete(ctx context.Context, handle Handle) (bool, error)

	// Cleanup is called periodically and allows the service to cleanup its
	// storage until the context is cancelled.
	Cleanup(ctx context.Context) error
}

type State string

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

type Upload interface {
	// Resume() (int64, error)
	Write(data []byte) (int, error)
	// Suspend() (int64, error)
	Abort() error
	Close() error
}

type ViewKey struct {
	heat.Base `json:"-" heat:"fire/blaze.view,24h"`

	// The viewable file.
	File coal.ID
}