handlers

type Config ¶

type Config struct {
	BasePath       string
	Title          string
	Theme          string
	CustomCSS      string
	EnableExport   bool
	EnableRealtime bool
	EnableSearch   bool
	EnableSettings bool
	EnableBridge   bool
	EnableAuth     bool
	ExportFormats  []string
}

Config mirrors the dashboard config fields needed by handlers.

type Deps ¶

type Deps struct {
	Registry   *contributor.ContributorRegistry
	Collector  *collector.DataCollector
	History    *collector.DataHistory
	TraceStore *collector.TraceStore
	Config     Config
}

Deps holds shared dependencies for all handlers.

type PrincipalOptions ¶ added in v1.6.4

type PrincipalOptions struct {
	AuthEnabled   bool
	LoginPath     string
	RequiredRoles []string
}

PrincipalOptions configures the principal endpoint. AuthEnabled toggles between two response shapes:

• false: always 200 with `{authenticated:false}` (auth disabled, the shell skips the login gate and renders the layout for an anonymous user).
• true: 200 with the populated principal when a user is in context, or 401 with `{code:"UNAUTHENTICATED",loginPath:...}` when not — the shell interprets that as "render the LoginScreen".

LoginPath is the absolute URL the shell should send users to for sign-in (e.g. /<basePath>/login). Only included in the 401 envelope; ignored when auth is disabled.

RequiredRoles, if non-empty, restricts dashboard access to users carrying at least one of the listed roles. Authenticated users without any matching role get a 403 with `{code:"PERMISSION_DENIED"}` so the React shell can render an "access denied" panel instead of the dashboard. Slice (l.5) added this so authsome can wire role-gated dashboards via config.