tunnel

type CloudflaredProvider struct{}

type ExposeOptions struct {
	// Name identifies the tunnel in the state map (e.g. "my-app", "controlcenter").
	// Falls back to ServiceName when empty.
	Name string

	// Provider is the explicit provider name ("cloudflared" or "ngrok").
	// Empty means auto-select.
	Provider string

	// Token is passed to Provider.Authenticate when non-empty.
	Token string

	// LocalPort overrides auto-detection when non-zero.
	LocalPort int

	// ServiceName is the Kubernetes service name to port-forward to as a
	// fallback (e.g. "my-app-orkestra-svc", "orkestra-cc").
	ServiceName string

	// Namespace is the target namespace for the service port-forward.
	Namespace string

	// ServicePort is the container port on the service (default "80").
	ServicePort string

	// PortForward is kept for compatibility but has no effect when ServiceName
	// and Namespace are set — port-forward is always preferred in that case.
	// Left here so callers that explicitly set it true do not break.
	PortForward bool
}

type NgrokProvider struct{}

type Provider interface {
	// Name returns the provider identifier used in state files and output.
	Name() string

	// Available reports whether the provider binary is in PATH or ~/.orkestra/bin.
	Available() bool

	// Install downloads and installs the provider binary when not available.
	Install(ctx context.Context) error

	// Authenticate stores credentials (no-op for cloudflared).
	Authenticate(ctx context.Context, token string) error

	// Start launches a background tunnel to localPort and returns the public URL
	// once it is available. The daemon outlives the process that called Start.
	Start(ctx context.Context, localPort int) (url string, pid int, err error)

	// Stop terminates the daemon identified by pid.
	Stop(pid int) error
}

type State struct {
	Name           string    `json:"name"`
	Provider       string    `json:"provider"`
	PID            int       `json:"pid"`
	PortForwardPID int       `json:"portForwardPid,omitempty"`
	URL            string    `json:"url"`
	LocalPort      int       `json:"localPort"`
	StartedAt      time.Time `json:"startedAt"`
}