tunnel

type Agent struct {
	// RelayURL is the relay's connect endpoint, e.g.
	// "wss://tunnel.nimbusgo.space/connect".
	RelayURL string
	// Token is the Nimbus Cloud CLI token from `nimbus login`.
	Token string
	// LocalAddr is the app being exposed, e.g. "127.0.0.1:3333".
	LocalAddr string
	// Subdomain asks for a fixed name (Pro plans); "" gets a random one.
	Subdomain string
	// KeepHost forwards the public Host header instead of LocalAddr. Useful
	// for apps that build absolute URLs from the request host.
	KeepHost bool
	// OnRequest, when set, is called after each proxied request.
	OnRequest func(RequestLog)
}

type AuthError struct {
	Status  int
	Message string
}

type Authorizer func(ctx context.Context, token, subdomain string) (Grant, error)

type ConnectError struct {
	Status  int
	Message string
}

type Grant struct {
	UserID uint   `json:"user_id"`
	Plan   string `json:"plan"`
	// Subdomain, when set, is the name the relay MUST publish under: the
	// authorizer resolved the agent's request against its own records (a
	// reservation the account owns). It is authoritative — the relay does
	// not second-guess it — and empty when no name was requested.
	Subdomain string `json:"subdomain"`
	// MaxTunnels caps concurrent tunnels for the account (0 = one).
	MaxTunnels int `json:"max_tunnels"`
	// SessionTTLSeconds closes the tunnel after this long (0 = unlimited).
	SessionTTLSeconds int `json:"session_ttl_seconds"`
	// CustomSubdomain allows choosing the name instead of a random one.
	CustomSubdomain bool `json:"custom_subdomain"`
}

type Relay struct {
	// Domain is the suffix under which tunnels are published, e.g.
	// "tunnel.nimbusgo.space" publishes "brisk-otter-3f9a.tunnel.nimbusgo.space".
	Domain    string
	Authorize Authorizer
	// Logf receives one line per tunnel open/close (nil = silent).
	Logf func(format string, args ...any)
	// contains filtered or unexported fields
}

type RequestLog struct {
	Method   string
	Path     string
	Status   int
	Duration time.Duration
}

type Session struct {
	// URL is the public address visitors use.
	URL string
	// Expires is when the relay will close the session (zero = never).
	Expires time.Time
	// contains filtered or unexported fields
}