marvin

type AccessLevel int

type ActionSource interface {
	UserID() slack.UserID
	ChannelID() slack.ChannelID
	MsgTimestamp() slack.MessageTS
	AccessLevel() AccessLevel
	ArchiveLink() string
}

type ActionSourceUserMessage struct {
	Team Team
	Msg  slack.SlackTextMessage
}

type CommandArguments struct {
	Source            ActionSource
	Command           string
	Arguments         []string
	OriginalArguments []string
	Ctx               context.Context

	IsEdit         bool
	IsUndo         bool
	PreviousResult *CommandResult
	ModuleData     interface{}
}

type CommandRegistration interface {
	RegisterCommand(name string, c SubCommand)
	RegisterCommandFunc(name string, c SubCommandFunc, help string) SubCommand
	UnregisterCommand(name string)
}

type CommandResult struct {
	Args      *CommandArguments
	Message   string
	Err       error
	Code      CommandResultCode
	ReplyType ReplyType
	Sent      bool

	CanEdit util.TriValue
	CanUndo util.TriValue
}

type CommandResultCode int

type ErrConfNoDefault struct {
	Key string
}

type ErrConfProtected struct{ Key string }

type HTTPDoer interface {
	Do(*http.Request) (*http.Response, error)
}

type HasTeam interface {
	Team() Team
}

type Module interface {
	// Modules should declare a constant named 'Identifier' in their package
	// and return it from this function.
	Identifier() ModuleID

	// Load should declare dependencies.
	Load(t Team)
	// Enable has dependencies available.
	Enable(t Team)
	// Disable should shut down and unregister all resources.
	Disable(t Team)
}

type ModuleConfig interface {
	// Get gets a module configuration value.  The error will be set on
	// database errors.  Get() will panic if the key was not initialized with
	// Add() or AddProtect().
	Get(key string) (string, error)
	// GetIsDefault gets a module configuration value, but does not require the
	// key have been initialized.
	//
	// 1) If the key was not initialized with Add(), value is the empty string,
	// isDefault is true, and err is ErrConfNoDefault.
	//
	// 2) If the key was initialized, but has no override, value is the default
	// value, isDefault is true, and err is nil.
	//
	// 3) If the key has an override, value is the override, isDefault is
	// false, and err is nil.
	GetIsDefault(key string) (value string, isDefault bool, err error)
	// GetIsDefaultNotProtected acts like GetIsDefault, but returns ("", false,
	// ErrConfProtected) if the key is protected.
	GetIsDefaultNotProtected(key string) (value string, isDefault bool, err error)
	// Set sets an override for the given configuration key.
	Set(key, value string) error
	// SetDefault resets the configuration for the given key to the default.
	SetDefault(key string) error
	// Add initializes the default value for a key for use with Get().  This
	// must be called during the module Load phase.
	Add(key, defaultValue string)
	// Add initializes the default value for a key for use with Get(), and also
	// sets the key as protected.  This must be called during the module Load
	// phase.
	AddProtect(key, defaultValue string, protect bool)
	// OnModify registers a callback for when a key is modified.
	OnModify(f func(key string))

	// ListDefaults returns the defaults map.  This cannot be called during the
	// module Load phase.
	ListDefaults() map[string]string
	// ListDefaults returns the protected-keys map.  This cannot be called
	// during the module Load phase.
	ListProtected() map[string]bool
}

type ModuleConstructor func(team Team) Module

type ModuleID string

type ModuleState int

type ModuleStatus interface {
	Instance() Module
	State() ModuleState
	// Returns non-nil if Degraded returns true.
	Err() error

	IsLoaded() bool
	IsEnabled() bool
	Degraded() bool
}

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

type ReplyType int

type SendMessage interface {
	SendMessage(channelID slack.ChannelID, message string) (slack.MessageTS, slack.RTMRawMessage, error)
	SendComplexMessage(channelID slack.ChannelID, message slack.OutgoingSlackMessage) (slack.MessageTS, slack.RTMRawMessage, error)
}

type SubCommand interface {
	Handle(t Team, args *CommandArguments) CommandResult
	Help(t Team, args *CommandArguments) CommandResult
}

type SubCommandFunc func(t Team, args *CommandArguments) CommandResult

type Team interface {
	// Domain returns the leftmost component of the Slack domain name.
	Domain() string
	DB() *database.Conn
	TeamConfig() *TeamConfig
	ModuleConfig(mod ModuleID) ModuleConfig
	// ModuleConfigList returns a list of all ModuleIDs with configs
	ModuleConfigList() []ModuleID

	// BotUser returns the user ID that Marvin is signed in as.
	BotUser() slack.UserID
	// TeamID returns the Slack Team ID of the connected Slack team.
	TeamID() slack.TeamID

	// EnableModules loads every module and attempts to transition them to
	// the state listed in the configuration.
	EnableModules() bool
	Shutdown()

	// DependModule places the instance of the requested module in the given
	// pointer.
	//
	// If the requested module is already enabled, the pointer is filled
	// immediately and the function returns 1. If the requested module has
	// errored, the pointer is left alone and the function returns -2.
	//
	// During loading, when the requested module has not been enabled yet, the
	// function returns 0 and remembers the pointer. If the requested module is
	// not known, the function returns -1.
	DependModule(self Module, dependencyID ModuleID, ptr *Module) int
	// GetModule returns the Module instance for a module directly.
	GetModule(modID ModuleID) Module
	GetModuleStatus(modID ModuleID) ModuleStatus
	// GetAllModules() returns the status of all modules.
	GetAllModules() []ModuleStatus
	// GetAllModules() returns the status of all enabled modules.
	GetAllEnabledModules() []ModuleStatus

	SendMessage
	ReactMessage(msgID slack.MessageID, emojiName string) error

	// SlackAPIPost makes a Slack API call by adding the token to the form.  If
	// the token parameter is already defined, the existing value is used.
	SlackAPIPostRaw(method string, form url.Values) (*http.Response, error)
	SlackAPIPostJSON(method string, form url.Values, result interface{}) error

	ArchiveURL(msgID slack.MessageID) string

	OnEveryEvent(mod ModuleID, f func(slack.RTMRawMessage))
	OnEvent(mod ModuleID, event string, f func(slack.RTMRawMessage))
	OnNormalMessage(mod ModuleID, f func(slack.RTMRawMessage))
	OnSpecialMessage(mod ModuleID, msgSubtype []string, f func(slack.RTMRawMessage))
	OffAllEvents(mod ModuleID)
	GetRTMClient() interface{}

	CommandRegistration
	DispatchCommand(args *CommandArguments) CommandResult

	// Add a new HTTP route handler.
	HandleHTTP(path string, handler http.Handler) *mux.Route
	// Get the Router object to add new routes.
	Router() *mux.Router
	// Inject middleware for every HTTP request. This is processed before CSRF
	// protection.
	HTTPMiddleware(f func(http.Handler) http.Handler)
	// Resolve a relative path to an absolute URL, taking into account
	// subfolder configuration.
	AbsoluteURL(path string) string

	ReportError(err error, source ActionSource)

	ResolveChannelName(input string) slack.ChannelID
	ChannelName(channel slack.ChannelID) string
	FormatChannel(channel slack.ChannelID) string
	ResolveUserName(input string) slack.UserID
	UserName(user slack.UserID) string
	UserLevel(user slack.UserID) AccessLevel
	GetIM(user slack.UserID) (slack.ChannelID, error)
	GetIMOtherUser(channel slack.ChannelID) (slack.UserID, error)
	PublicChannelInfo(channel slack.ChannelID) (*slack.Channel, error)
	PrivateChannelInfo(channel slack.ChannelID) (*slack.Channel, error)
	ChannelIDByName(chName string) slack.ChannelID
	ChannelMemberCount(channel slack.ChannelID) int
	ChannelMemberList(channel slack.ChannelID) []slack.UserID
	UserInfo(user slack.UserID) (*slack.User, error)
	// Only supports private channels
	UserInChannels(user slack.UserID, channels ...slack.ChannelID) map[slack.ChannelID]bool
}

type TeamConfig struct {
	TeamDomain      string
	ClientID        string
	ClientSecret    string
	CookieSecretKey string
	IntraUID        string
	IntraSecret     string
	DatabaseURL     string
	UserToken       string
	LogChannel      slack.ChannelID
	HTTPListen      string
	HTTPURL         string
	Controllers     []slack.UserID
	ChannelPrefix   slack.ChannelID
	IsSlackAdmin    bool
	IsDevelopment   bool
	IsReadOnly      bool
}