Documentation
¶
Index ¶
- func RegisterLauncherAuthRoutes(mux *http.ServeMux, opts LauncherAuthRouteOpts)
- type Handler
- func (h *Handler) EnsurePicoChannel() (bool, error)
- func (h *Handler) RegisterRoutes(mux *http.ServeMux)
- func (h *Handler) RestartGateway() (int, error)
- func (h *Handler) SetDebug(debug bool)
- func (h *Handler) SetServerBindHost(hostInput string, explicit bool)
- func (h *Handler) SetServerOptions(port int, public bool, publicExplicit bool, allowedCIDRs []string)
- func (h *Handler) Shutdown()
- func (h *Handler) StopGateway()
- func (h *Handler) TryAutoStartGateway()
- type LauncherAuthRouteOpts
- type LogBuffer
- type PasswordStore
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func RegisterLauncherAuthRoutes ¶ added in v0.2.5
func RegisterLauncherAuthRoutes(mux *http.ServeMux, opts LauncherAuthRouteOpts)
RegisterLauncherAuthRoutes registers /api/auth/login|logout|status|setup.
Types ¶
type Handler ¶
type Handler struct {
// contains filtered or unexported fields
}
Handler serves HTTP API requests.
func NewHandler ¶
NewHandler creates an instance of the API handler.
func (*Handler) EnsurePicoChannel ¶ added in v0.2.4
EnsurePicoChannel enables the Pico channel with sane defaults if it isn't already configured. Returns true when the config was modified.
func (*Handler) RegisterRoutes ¶
RegisterRoutes binds all API endpoint handlers to the ServeMux.
func (*Handler) RestartGateway ¶ added in v0.2.4
RestartGateway restarts the gateway process. This is a non-blocking operation that stops the current gateway (if running) and starts a new one. Returns the PID of the new gateway process or an error.
func (*Handler) SetServerBindHost ¶ added in v0.2.7
SetServerBindHost stores the launcher's effective bind host. When explicit is true, hostInput is the normalized -host / PICOCLAW_LAUNCHER_HOST value.
func (*Handler) SetServerOptions ¶
func (h *Handler) SetServerOptions(port int, public bool, publicExplicit bool, allowedCIDRs []string)
SetServerOptions stores current backend listen options for fallback behavior.
func (*Handler) Shutdown ¶ added in v0.2.4
func (h *Handler) Shutdown()
Shutdown gracefully shuts down the handler, stopping the gateway if it was started by this handler.
func (*Handler) StopGateway ¶ added in v0.2.4
func (h *Handler) StopGateway()
StopGateway stops the gateway process if it was started by this handler. This method is called during application shutdown to ensure the gateway subprocess is properly terminated. It only stops processes that were started by this handler, not processes that were attached to from existing instances.
func (*Handler) TryAutoStartGateway ¶
func (h *Handler) TryAutoStartGateway()
TryAutoStartGateway checks whether gateway start preconditions are met and starts it when possible. Intended to be called by the backend at startup.
type LauncherAuthRouteOpts ¶ added in v0.2.5
type LauncherAuthRouteOpts struct {
SessionCookie string
SecureCookie func(*http.Request) bool
// PasswordStore enables password login. It must be non-nil for auth to work.
PasswordStore PasswordStore
// StoreError holds the error returned when opening the password store. When
// non-nil and PasswordStore is nil, auth endpoints fail closed with a
// recovery message.
StoreError error
}
LauncherAuthRouteOpts configures dashboard auth handlers.
type LogBuffer ¶
type LogBuffer struct {
// contains filtered or unexported fields
}
LogBuffer is a thread-safe ring buffer that stores the most recent N log lines. It supports incremental reads via LinesSince and tracks a runID that increments whenever the buffer is reset or cleared so clients can detect log history resets.
func NewLogBuffer ¶
NewLogBuffer creates a LogBuffer with the given capacity.
func (*LogBuffer) Append ¶
Append adds a line to the buffer. If the buffer is full, the oldest line is evicted.
func (*LogBuffer) Clear ¶ added in v0.2.2
func (b *LogBuffer) Clear()
Clear removes all buffered lines and increments the runID so clients treat subsequent reads as a new log stream.
func (*LogBuffer) LinesSince ¶
LinesSince returns lines appended after the given offset, the current total count, and the runID. If offset >= total, no lines are returned. If offset is too old (evicted), all buffered lines are returned.
type PasswordStore ¶ added in v0.2.7
type PasswordStore interface {
IsInitialized(ctx context.Context) (bool, error)
SetPassword(ctx context.Context, plain string) error
VerifyPassword(ctx context.Context, plain string) (bool, error)
}
PasswordStore is the interface for dashboard password persistence. Implemented by dashboardauth.Store and launcherconfig.PasswordStore.
Source Files