restate

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

type BuilderFunc = func(*Builder)

type Config struct {
	// Addr is the listen address of the service endpoint. The default is
	// ":9080".
	//
	// Example:
	//
	//	fmt.Println(Config{Addr: ":9080"}.Addr)
	Addr string

	// IngressURL is the base URL of the Restate ingress. The default is
	// "http://localhost:8080".
	//
	// Example:
	//
	//	fmt.Println(Config{IngressURL: "http://localhost:8080"}.IngressURL)
	IngressURL string

	// AdminURL is the base URL of the Restate admin API. The default is
	// "http://localhost:9070".
	//
	// Example:
	//
	//	fmt.Println(Config{AdminURL: "http://localhost:9070"}.AdminURL)
	AdminURL string

	// AdvertisedURL is the URL the Restate server uses to reach the endpoint.
	// The default is "http://localhost" followed by Addr.
	//
	// Example:
	//
	//	fmt.Println(Config{AdvertisedURL: "http://localhost:9080"}.AdvertisedURL)
	AdvertisedURL string

	// Register makes [Host.Serve] register the deployment with the admin API
	// once the endpoint is serving.
	//
	// Example:
	//
	//	fmt.Println(Config{Register: true}.Register)
	Register bool

	// RegisterForce sends force=true with the registration, which overwrites
	// a deployment that serves the same URL. Use it only when no invocation
	// of the old deployment is in flight.
	//
	// Example:
	//
	//	fmt.Println(Config{}.RegisterForce) // False: replacement is not forced.
	RegisterForce bool

	// RegisterBreaking sends breaking=true with the registration, which
	// accepts a deployment that removes services or handlers of an earlier
	// deployment under the same URL.
	//
	// Example:
	//
	//	fmt.Println(Config{}.RegisterBreaking) // False: breaking removal is not allowed.
	RegisterBreaking bool

	// ClientOnly makes the host a pure client of the Restate server:
	// [Host.Start] opens no listener, [Host.Serve] registers nothing, and
	// [Host.Bind] returns [ErrClientOnly]. A host with nothing bound behaves
	// the same way.
	//
	// Example:
	//
	//	fmt.Println(Config{ClientOnly: true}.ClientOnly)
	ClientOnly bool

	// IdentityKeys are the Restate request-identity public keys
	// ("publickeyv1_...") the endpoint accepts. The Restate server signs each
	// request to the endpoint, and the endpoint rejects requests that are
	// not signed by one of these keys. Take them from the Restate server
	// configuration (request identity). Empty leaves the endpoint
	// unauthenticated, which [Host.Start] refuses unless AllowInsecure is set.
	// This reporting record does not validate native key syntax or own its slice.
	//
	// Example:
	//
	//	fmt.Println(len(Config{IdentityKeys: []string{"publickeyv1_example"}}.IdentityKeys))
	IdentityKeys []string

	// AllowInsecure lets [Host.Start] open a service endpoint without
	// IdentityKeys. Use it only for local development and tests: anyone who
	// can reach the listener can invoke the bound handlers. The default is
	// false.
	//
	// Example:
	//
	//	fmt.Println(Config{}.AllowInsecure) // False: unsigned serving is not permitted.
	AllowInsecure bool

	// AuthKey is the bearer token sent to the ingress. Empty sends none.
	// Ordinary Config formatting redacts it; direct field access does not.
	//
	// Example:
	//
	//	slog.InfoContext(ctx, "settings", "config", Config{AuthKey: "example"})
	AuthKey string

	// AdminAuthKey is the bearer token sent to the admin API. Empty sends
	// none.
	// Ordinary Config formatting redacts it; direct field access does not.
	//
	// Example:
	//
	//	slog.InfoContext(ctx, "settings", "config", Config{AdminAuthKey: "example"})
	AdminAuthKey string

	// HTTPClient is used for ingress and admin calls. Nil uses a client with
	// default settings.
	// The native client remains shared; Host.Stop does not close its transport.
	//
	// Example:
	//
	//	record := Config{HTTPClient: http.DefaultClient}
	//	_ = record.HTTPClient
	HTTPClient *http.Client

	// Logger receives Host log lines. Nil uses [slog.Default].
	//
	// Example:
	//
	//	record := Config{Logger: slog.Default()}
	//	record.Logger.InfoContext(ctx, "configured host")
	Logger *slog.Logger
}

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