storage

type ArticleStore interface {
	// Backend returns BackendDB or BackendFS.
	Backend() string

	// ListAttachments returns the article's attachments in index order.
	ListAttachments(ctx context.Context, articleID int64) ([]Attachment, error)

	// GetAttachment returns one attachment and its content, or ErrNotFound.
	GetAttachment(ctx context.Context, articleID, fileID int64) (Attachment, []byte, error)

	// WriteAttachment stores an attachment. A filename already used by the
	// article gets an OTRS-style "-N" suffix.
	WriteAttachment(ctx context.Context, articleID int64, a NewAttachment) (Attachment, error)

	// DeleteAttachment removes one attachment, or returns ErrNotFound.
	DeleteAttachment(ctx context.Context, articleID, fileID int64) error

	// WritePlain stores the raw email of an article, replacing any previous one.
	WritePlain(ctx context.Context, articleID int64, raw []byte, createBy int) error

	// ReadPlain returns the raw email of an article, or ErrNotFound.
	ReadPlain(ctx context.Context, articleID int64) ([]byte, error)

	// DeleteArticle removes every attachment and the raw email of an article.
	DeleteArticle(ctx context.Context, articleID int64) error

	// WithTx returns a store whose database work runs on tx.
	WithTx(tx *sql.Tx) ArticleStore
}

type Attachment struct {
	ArticleID int64
	// FileID addresses the attachment within its article: the
	// article_data_mime_attachment id for DB, the 1-based OTRS index (position
	// in the sorted file list) for FS.
	FileID             int64
	Filename           string
	ContentType        string
	ContentID          string
	ContentAlternative string
	Disposition        string
	Size               int64
	// CreateTime is the row's create_time (DB) or the file's modification time (FS).
	CreateTime time.Time
	// CreateBy is the creating user (DB); 0 for FS, which does not record it.
	CreateBy int
}

type Config struct {
	// Backend is BackendDB or BackendFS (case-insensitive).
	Backend string
	// ArticleDir is the ArticleStorageFS root (OTRS ArticleDataDir); FS only.
	ArticleDir string
}

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

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

type NewAttachment struct {
	Filename           string
	ContentType        string
	ContentID          string
	ContentAlternative string
	Disposition        string
	Content            []byte
	CreateBy           int
}