hosts

type Dependencies struct {
	Mysql  *gorm.DB
	Redis  *redis.Client
	Mailer mail.Mailer
	Queue  *queue.Client
}

type EventType string

type Host interface {
	// CreateFromLinks create shared links based on the input original links.
	CreateFromLinks(ctx context.Context, userID string, originalLinks []string, createBy string) (sharedLinks map[string]*share.Share, err error)

	// GetStatuses return the statuses of each host shared link.
	GetStatuses(ctx context.Context, userID string, hostSharedLinks []string) (statuses map[string]share.State, err error)

	// GetStatistics return the statistics of each host shared link.
	GetStatistics(ctx context.Context, userID string, hostSharedLinks []string) (details map[string]share.Statistics, err error)

	// Delete delete shared links by original links.
	Delete(ctx context.Context, userID string, originalLinks []string) error

	// HostInfo returns basic information of the host.
	HostInfo(ctx context.Context, userID string, options map[string]any) (resp map[string]any, err error)

	// AddEventListener add an event listener to the host.
	AddEventListener(event EventType, callback ListenerCallback)
}

type HostWithProperties struct {
	Host
	// contains filtered or unexported fields
}

type ListenerCallback func(userID, originalLinkHash string)

type Properties struct {
	// Name is the host's name.
	// The name must match this regular expression: `^[0-9A-Za-z_]{1,32}$`
	Name string

	// New is the function to create a Host instance.
	New func(d *Dependencies) Host

	// CreateTableStatements return the statements to create tables in mysql database.
	// The name of tables must be prefixed with the host provider's name.
	// If the host do not need mysql database, this property can be empty.
	CreateTableStatements []string
}