services

type BaseServices struct {
	Logger   *log.Logger
	Database GormDB
}

type EmailService interface {
	Send(email string, subject string, body string) error
}

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

type FileStorageService interface {
	CreateStub(user *User) (*FileMetadata, error)
	// generally not very useful, will be served by a static server either way
	// FileMetadata, mimetype, error
	GetData(id string) (*os.File, string, error)
	// TODO how to recive an os.File from gin? data perhaps should be changed to reader
	Upload(fileMetadata FileMetadata, data io.Reader, mimetype string) (*FileMetadata, error)
	RemoveFile(fileMetadata FileMetadata) error
	// NOTE it's responsibility of the caller to make sure that all references to this FileMetadata are removed
	RemoveMetadata(fileMetadata FileMetadata) error
}

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

type TokenService interface {
	// Creates a new token. Returns database.Token and token secret (hashed secret is stored in the database).
	// Token secret is confidential and should not be stored on the backend.
	// purpose controls Check behavior.
	// If TokenPurpose is TokenPurposeEmail, token is invalidated after Check is called on the token.
	// If TokenPurpose is TokenPurposeSession, token expiration date is changed on each Check call
	// (the date is moved exactly a week from call date, although that could change any time).
	Create(user *User, purpose TokenPurposeEnum, expiration time.Time) (*Token, string, error)

	// Checks if token with tokenId exists in the database.
	// Returns it if tokenSecret matches database.Token.TokenHash.
	Check(tokenId string, tokenSecret string) (*Token, error)

	// Invalidates the token - the token cannot be used after that, Check will return ErrUnknownToken.
	Invalidate(token *Token) (*Token, error)

	// Returns TokenService that will execute queries within transaction tx.
	// NOTE This won't work as expected if TokenService is using a different database.
	// Maybe returning a rollback func would be a good idea. On the other hand, currently
	// not deleting a token is not the worst thing that can happen.
	WithTransaction(tx GormDB) (TokenService, error)
}

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