service

Documentation

Index

• Variables
• type Account
• type Accounts
• type BaseAccount
  • func NewBaseAccount(username string, createdAt time.Time) *BaseAccount
  • func (r *BaseAccount) CreatedAt() time.Time
  • func (r *BaseAccount) Username() string
• type BaseDevice
  • func NewBaseDevice(deviceId DeviceID, hashedPass string) *BaseDevice
  • func (r *BaseDevice) HashedPass() string
  • func (r *BaseDevice) ID() DeviceID
  • func (r *BaseDevice) Verify(password string) bool
• type Device
• type DeviceID
  • func (i DeviceID) String() string
  • func (i DeviceID) UUID() uuid.UUID
• type Devices
• type Health
  • func HealthAggregator(healthChecks []HealthCheck) Health
• type HealthAggregation
• type HealthAggregationComponent
• type HealthCheck
• type HealthResult
  • func HealthResultFromBool(healthUp bool) HealthResult
  • func (r HealthResult) ToHTTPStatusCode() int
• type Module
• type Modules
• type ShareCode
  • func (c ShareCode) String() string
• type Sharing
• type UsernameGenerationStrategy
• type UsernameGenerator
  • func NewUsernameGenerator(_ UsernameGenerationStrategy) (UsernameGenerator, error)

Variables

var (
	ErrAccountAlreadyExists = errors.New("account already exists")
	ErrAccountNotFound      = errors.New("account not found")
	ErrShareCodeInvalid     = errors.New("share code is invalid")
)

var (
	ErrWritingModuleFailed = errors.New("module write failed")
	ErrReadingModule       = errors.New("module read failed")
)

var ErrDeviceNotFound = errors.New("device not found")

Types

type Account

type Account interface {
	Username() string
	CreatedAt() time.Time
}

type Accounts

type Accounts interface {
	Find(ctx context.Context, username string) (Account, error)
	Create(ctx context.Context, username string) (Account, error)

	HealthCheck() HealthCheck
}

type BaseAccount

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

func NewBaseAccount

func NewBaseAccount(username string, createdAt time.Time) *BaseAccount

func (*BaseAccount) CreatedAt

func (r *BaseAccount) CreatedAt() time.Time

func (*BaseAccount) Username

func (r *BaseAccount) Username() string

type BaseDevice

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

func NewBaseDevice

func NewBaseDevice(deviceId DeviceID, hashedPass string) *BaseDevice

func (*BaseDevice) HashedPass

func (r *BaseDevice) HashedPass() string

func (*BaseDevice) ID

func (r *BaseDevice) ID() DeviceID

func (*BaseDevice) Verify

func (r *BaseDevice) Verify(password string) bool

type Device

type Device interface {
	ID() DeviceID
	Verify(password string) bool
	HashedPass() string
}

type DeviceID

type DeviceID uuid.UUID

func (DeviceID) String

func (i DeviceID) String() string

func (DeviceID) UUID

func (i DeviceID) UUID() uuid.UUID

type Devices

type Devices interface {
	AddDevice(ctx context.Context, account Account, id DeviceID, password string) (Device, error)
	GetDevices(ctx context.Context, account Account) (map[DeviceID]Device, error)
	GetDevice(ctx context.Context, account Account, id DeviceID) (Device, error)
	DeleteDevice(ctx context.Context, account Account, id DeviceID) error

	HealthCheck() HealthCheck
}

type Health

type Health interface {
	Check(ctx context.Context) HealthAggregation
}

func HealthAggregator

func HealthAggregator(healthChecks []HealthCheck) Health

type HealthAggregation

type HealthAggregation struct {
	Health     HealthResult                 `yaml:"health"`
	Components []HealthAggregationComponent `yaml:"components"`
}

type HealthAggregationComponent

type HealthAggregationComponent struct {
	Name   string       `yaml:"name"`
	Health HealthResult `yaml:"health"`
}

type HealthCheck

type HealthCheck func(ctx context.Context) (string, bool)

type HealthResult

type HealthResult string

const (
	HealthUp   HealthResult = "Up"
	HealthDown HealthResult = "Down"
)

func HealthResultFromBool

func HealthResultFromBool(healthUp bool) HealthResult

func (HealthResult) ToHTTPStatusCode

func (r HealthResult) ToHTTPStatusCode() int

type Module

type Module interface {
	Raw() io.Reader
	Size() int
}

type Modules

type Modules interface {
	Set(ctx context.Context, name string, module Module) error
	Get(ctx context.Context, name string) (Module, error)
	HealthCheck() HealthCheck
}

type ShareCode

type ShareCode string

func (ShareCode) String

func (c ShareCode) String() string

type Sharing

type Sharing interface {
	Share(ctx context.Context, account Account) (string, error)
	ActiveShares(ctx context.Context, account Account) ([]string, error)
	IsShared(ctx context.Context, account Account, shareCode ShareCode) error
	Revoke(ctx context.Context, account Account, shareCode ShareCode) error
}

type UsernameGenerationStrategy

type UsernameGenerationStrategy string

const UUIDUsernameGeneration UsernameGenerationStrategy = "uuid"

type UsernameGenerator

type UsernameGenerator interface {
	Generate() (string, error)
}

func NewUsernameGenerator

func NewUsernameGenerator(_ UsernameGenerationStrategy) (UsernameGenerator, error)