preview

type GWClient struct {
	// contains filtered or unexported fields
}

type Kind string

type Manager struct {
	// contains filtered or unexported fields
}

type Options struct {
	// IdleTimeout is how long a running server can go without proxy
	// traffic before the reaper stops it. Zero uses DefaultIdleTimeout.
	IdleTimeout time.Duration

	// StopGrace is the SIGTERM→SIGKILL window. Zero uses DefaultStopGrace.
	StopGrace time.Duration

	// Log is the logger; nil falls back to the default logger.
	Log *log.Logger

	// GWClient mints + revokes public tokens with the gateway. Nil
	// (or a disabled client) leaves Status.Token/URL empty — useful
	// for laptop dev where there's no gateway to register with.
	GWClient *GWClient
}

type ReadyProbe struct {
	Path           string
	ExpectedSubstr string
}

type RegisterRequest struct {
	WorktreeID   string `json:"worktree_id"`
	ServiceName  string `json:"service_name"`
	InternalPort int    `json:"internal_port"`
}

type RegisterResponse struct {
	Token      string            `json:"token"`
	URL        string            `json:"url"`
	Visibility tokens.Visibility `json:"visibility"`
	ExpiresAt  time.Time         `json:"expires_at"`
}

type RevokeRequest struct {
	WorktreeID  string `json:"worktree_id"`
	ServiceName string `json:"service_name"`
}

type SetupRequiredError struct {
	ProjectConfigPath string
	Prompt            string
}

type Spec struct {
	// Kind identifies which client integration to use.
	Kind Kind

	// CmdTemplate is the argv template. "%d" is replaced with the
	// allocated port only when ShouldSubstitutePort is true.
	CmdTemplate []string

	// ShouldSubstitutePort enables the legacy Expo argv template. Configured
	// web commands receive the port only through the PORT environment variable.
	ShouldSubstitutePort bool

	// Environment contains configured web environment values. Clank expands its
	// runtime placeholders immediately before spawning the child process.
	Environment map[string]string

	// ReadyProbe is the HTTP poll Manager runs after spawn to flip
	// State from Starting to Ready. Concrete contract beats stdout-
	// scanning: the probe only passes when the dev server is actually
	// serving traffic, vs. the print-then-bind race we had earlier
	// with substring matching.
	ReadyProbe ReadyProbe
}

type State string

type Status struct {
	Available         bool       `json:"available"`
	SetupRequired     bool       `json:"setup_required,omitempty"`
	SetupPrompt       string     `json:"setup_prompt,omitempty"`
	ProjectConfigPath string     `json:"project_config_path,omitempty"`
	Kind              Kind       `json:"kind,omitempty"`
	ServiceName       string     `json:"service_name,omitempty"`
	State             State      `json:"state"`
	Port              int        `json:"port,omitempty"`
	StartedAt         *time.Time `json:"started_at,omitempty"`
	LastErr           string     `json:"last_err,omitempty"`

	// Token is the gateway-minted token for this preview's public URL.
	// Empty when the manager's GWClient is disabled (laptop dev).
	Token string `json:"token,omitempty"`

	// URL is the public preview URL — preview-<Token>.<root>. Empty
	// when Token is empty. Clients pass this verbatim to whatever
	// renders the bundle.
	URL string `json:"url,omitempty"`

	// ExpiresAt is when the gateway will stop honoring the token.
	// Re-register (re-call /preview/start) before this to refresh.
	ExpiresAt *time.Time `json:"expires_at,omitempty"`
}