dash

type APIHandler func(c context.Context, ns string, r *http.Request) (interface{}, error)

type Bug struct {
	Namespace  string
	Seq        int64 // sequences of the bug with the same title
	Title      string
	Status     int
	DupOf      string
	NumCrashes int64
	NumRepro   int64
	ReproLevel dashapi.ReproLevel
	HasReport  bool
	FirstTime  time.Time
	LastTime   time.Time
	Closed     time.Time
	Reporting  []BugReporting
	Commits    []string
	PatchedOn  []string
}

type BugReporting struct {
	Name       string // refers to Reporting.Name
	ID         string // unique ID per BUG/BugReporting used in commucation with external systems
	ExtID      string // arbitrary reporting ID that is passed back in dashapi.BugReport
	Link       string
	CC         string // additional emails added to CC list (|-delimited list)
	ReproLevel dashapi.ReproLevel
	Reported   time.Time
	Closed     time.Time
}

type Build struct {
	Namespace       string
	Manager         string
	ID              string // unique ID generated by syz-ci
	OS              string
	Arch            string
	VMArch          string
	SyzkallerCommit string
	CompilerID      string
	KernelRepo      string
	KernelBranch    string
	KernelCommit    string
	KernelConfig    int64 // reference to KernelConfig text entity
}

type Config struct {
	// Per-namespace clients that act only on a particular namespace.
	Clients map[string]string
	// A unique key for hashing, can be anything.
	Key string
	// Mail bugs without reports (e.g. "no output").
	MailWithoutReport bool
	// How long should we wait for a C repro before reporting a bug.
	WaitForRepro time.Duration
	// Reporting config.
	Reporting []Reporting
}

type Crash struct {
	Manager     string
	BuildID     string
	Time        time.Time
	Maintainers []string `datastore:",noindex"`
	Log         int64    // reference to CrashLog text entity
	Report      int64    // reference to CrashReport text entity
	ReproOpts   []byte   `datastore:",noindex"`
	ReproSyz    int64    // reference to ReproSyz text entity
	ReproC      int64    // reference to ReproC text entity
	ReportLen   int
}

type EmailConfig struct {
	Email           string
	Moderation      bool
	MailMaintainers bool
}

type ExternalConfig struct {
	ID string
}

type GlobalConfig struct {
	// Email suffix of authorized users (e.g. "@foobar.com").
	AuthDomain string
	// Global API clients that work across namespaces (e.g. external reporting).
	Clients map[string]string
	// Per-namespace config.
	// Namespaces are a mechanism to separate groups of different kernels.
	// E.g. Debian 4.4 kernels and Ubuntu 4.9 kernels.
	// Each namespace has own reporting config, own API clients
	// and bugs are not merged across namespaces.
	Namespaces map[string]*Config
}

type JSONHandler func(c context.Context, r *http.Request) (interface{}, error)

type Reporting struct {
	// A unique name (the app does not care about exact contents).
	Name string
	// See ReportingStatus below.
	Status ReportingStatus
	// How many new bugs report per day.
	DailyLimit int
	// Type of reporting and its configuration.
	// The app has one built-in type, EmailConfig, which reports bugs by email.
	// And ExternalConfig which can be used to attach any external reporting system (e.g. Bugzilla).
	Config ReportingType
}

type ReportingState struct {
	Entries []ReportingStateEntry
}

type ReportingStateEntry struct {
	Namespace string
	Name      string
	// Current reporting quota consumption.
	Sent int
	Date int
}

type ReportingStatus int

type ReportingType interface {
	// Type returns a unique string that identifies this reporting type (e.g. "email").
	Type() string
	// NeedMaintainers says if this reporting requires non-empty maintainers list.
	NeedMaintainers() bool
	// Validate validates the current object, this is called only during init.
	Validate() error
}

type Text struct {
	Namespace string
	Text      []byte `datastore:",noindex"` // gzip-compressed text
}