playgroundserver

type Config struct {
	Addr                string
	AuthSecret          string
	ExecutionProfile    string
	ReadTimeout         time.Duration
	WriteTimeout        time.Duration
	IdleTimeout         time.Duration
	ShutdownTimeout     time.Duration
	MaxBodyBytes        int64
	RateLimit           int
	RateWindow          time.Duration
	RateCleanup         time.Duration
	TrustProxy          bool
	CookieSecure        bool
	SessionTTL          time.Duration
	EvalMaxDepth        int
	EvalMaxSteps        int64
	EvalMaxHeapMB       int64
	EvalTimeoutMS       int64
	RenderAllowURLs     bool
	RenderAllowURLHosts []string
	RenderMode          string
	RenderMaxBytes      int64
	// DevMode is an explicit opt-out of the production-safety guard below.
	// When true, the server is allowed to bind to a non-loopback address
	// without an authentication secret and/or secure cookies configured -
	// intended only for local development, CI, and tests. It defaults to
	// false, so production-style deployments (bound to a non-loopback
	// address) must either configure auth + secure cookies or explicitly
	// set PLAYGROUND_DEV_MODE=true to acknowledge the reduced security.
	DevMode bool
}

type Variant struct {
	// Name labels the variant in logs (e.g. "full").
	Name string
	// ExtraCapabilities are additional untrusted-profile capabilities
	// granted on top of the shared baseline (filesystem_read, async,
	// scheduler, server) - e.g. cmd/interpreter's --playground mode adds
	// CapabilityDB and CapabilityNetwork.
	ExtraCapabilities []string
	// ExampleOverrides replaces specific keys in the shared base example
	// set (see examples.go) - used for scripts whose content depends on
	// which builtins are linked (image-values, query-builder).
	ExampleOverrides map[string]string
	// ExtraExamples adds example keys unique to this variant (e.g.
	// "pdf-tools", only meaningful when builtins/pdf is linked).
	ExtraExamples map[string]string
	// IDERunner configures the Projects-mode process manager (which
	// interpreter binary to build/run projects with, and the default
	// scaffold kind) - see pkg/ide.RunnerConfig.
	IDERunner ide.RunnerConfig
}