web

type ACMEAdmin interface {
	// Waiting counts orders whose certificate waits for the unseal.
	Waiting(ctx context.Context) (int64, error)
	// Pending counts accounts and names that wait for an admin.
	Pending(ctx context.Context) (accounts, names int64, err error)
	Accounts(ctx context.Context, who keys.Who) ([]acme.AccountInfo, error)
	Account(ctx context.Context, who keys.Who, id string) (*acme.AccountInfo, error)
	SetAccountPredecessor(ctx context.Context, id string, policy *predecessor.Policy, who keys.Who) error
	ApproveAccount(ctx context.Context, id string, who keys.Who) error
	Names(ctx context.Context, who keys.Who) ([]acme.NameInfo, error)
	DecideName(ctx context.Context, name string, approve bool, who keys.Who) error
	Orders(ctx context.Context, who keys.Who) ([]acme.OrderInfo, error)
	EABKeys(ctx context.Context, who keys.Who) ([]acme.EABKeyInfo, error)
	CreateEABKey(ctx context.Context, label string, days int, who keys.Who) (*acme.NewEABKey, error)
}

type AlertSource interface {
	List(ctx context.Context, who keys.Who, now time.Time) (open, resolved []monitor.Alert, err error)
}

type AnalysisSource interface {
	Get(ctx context.Context, who keys.Who) (*analysis.Analysis, error)
}

type AppDeps struct {
	Auth    *auth.Service
	Engine  *ca.Engine
	Keys    *keys.Keyring
	Presets *preset.Set
	Clock   clock.Clock
	// TrustedProxies may set X-Forwarded-For (auth.trusted_proxies).
	TrustedProxies []netip.Prefix
	Demo           bool
	Tenant         string // the tenant of this instance (phase 1: one)
	// Settings, TenantAudit and InstanceAudit serve the pages of step 19
	// (tenant settings, audit log); nil hides those pages.
	Settings                   *tenant.Store
	TenantAudit, InstanceAudit *sql.DB
	// Agents is the agent service (v0.3); nil while agent.base_url is empty.
	Agents *agents.Service
	// AgentDist, AgentBaseURL and AgentTLSIssuer drive guided installation.
	AgentDist      *agentdist.Store
	AgentBaseURL   string
	AgentTLSIssuer string
	ServerVersion  string
	// ACME is the ACME server (PHASE2); nil while ACME is off.
	ACME ACMEAdmin
	// ACMEDirectory is the directory URL clients use (shown with EAB keys).
	ACMEDirectory string
	// ServerAttention reports the state of the server itself for the
	// dashboard: the certificates it issues for its listeners
	// (admin.tls_issuer, acme.tls_issuer) and the scheduled backups; nil =
	// nothing to report.
	ServerAttention func(sealed bool) []view.Message
	// Alerts are the open alerts of the monitoring (v0.3.3); nil hides them.
	Alerts AlertSource
	// Notifier tests the notification channels (v0.3.3); nil hides the button.
	Notifier NotifyTester
	// Endpoints are the TLS scan endpoints (v0.3.4); nil hides the page.
	Endpoints EndpointAdmin
	// Reports and Analysis are the report and analysis services (v0.3.8);
	// nil hides the pages and the dashboard charts.
	Reports  ReportSource
	Analysis AnalysisSource
}

type EndpointAdmin interface {
	List(ctx context.Context, who keys.Who) ([]monitor.EndpointState, error)
	Create(ctx context.Context, who keys.Who, req tlsscan.Request) (*tlsscan.Endpoint, error)
	Delete(ctx context.Context, who keys.Who, id string) error
	ScanNow(ctx context.Context, who keys.Who, id string) error
	// Settings are the monitor.scan_* keys: the ports, the limit, off.
	Settings() tlsscan.Settings
}

type NotifyTester interface {
	Names() []string
	Send(ctx context.Context, who keys.Who) ([]notify.Result, error)
}

type Options struct {
	// Dev shows the DEV MODE banner on every page and enables the UI
	// prototype on fixture data.
	Dev    bool
	Logger *slog.Logger
	// App, if set, serves the real UI on the services (phase 1 step 14)
	// instead of the gallery; Dev and App are exclusive.
	App *AppDeps
}

type ReportSource interface {
	Get(ctx context.Context, who keys.Who) (*report.Report, error)
}