runtime

type CapabilityID string

type CarrierKind string

type Descriptor struct {
	Platform PlatformID
	Event    EventID
	Carrier  CarrierKind
	Decode   func(Envelope) (any, string, error)
	Encode   func(any) Result
}

type DescriptorLookup func(platform PlatformID, event EventID) (Descriptor, bool)

type Engine struct {
	Args          []string
	IO            IO
	Env           Env
	Logger        Logger
	Resolver      Resolver
	Lookup        DescriptorLookup
	BuildEnvelope EnvelopeBuilder
	Handlers      *HandlerRegistry
	Middleware    []Middleware
}

type Env interface {
	LookupEnv(string) (string, bool)
}

type Envelope struct {
	Invocation Invocation
	Args       []string
	Stdin      []byte
	Env        Env
}

type EnvelopeBuilder func(ctx context.Context, inv Invocation, carrier CarrierKind, args []string, io IO, env Env) (Envelope, error)

type EventID string

type Handled struct {
	Value any
	Err   error
}

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

type IO interface {
	ReadStdin(ctx context.Context) ([]byte, error)
	WriteStdout([]byte) error
	WriteStderr(string) error
}

type Invocation struct {
	Platform PlatformID
	Event    EventID
	RawName  string
}

type InvocationContext struct {
	Context    context.Context
	Invocation Invocation
	Descriptor Descriptor
	Env        Env
	Logger     Logger
}

type InvocationKind string

type Logger interface {
	Info(string)
	Error(string)
}

type MaturityLevel string

type Middleware func(Next) Next

type Next func(InvocationContext) Handled

type NopLogger struct{}

type PlatformID string

type RegistrarBackend interface {
	Register(platform PlatformID, event EventID, handler TypedHandler)
	RegisterCustom(rawName string, desc Descriptor, handler TypedHandler) error
}

type Resolver func(args []string, env Env) (Invocation, error)

type Result struct {
	ExitCode int
	Stdout   []byte
	Stderr   string
}

type SupportEntry struct {
	Platform        PlatformID
	Event           EventID
	Status          SupportStatus
	Maturity        MaturityLevel
	V1Target        bool
	InvocationKind  InvocationKind
	Carrier         CarrierKind
	TransportModes  []TransportMode
	ScaffoldSupport bool
	ValidateSupport bool
	Capabilities    []CapabilityID
	Summary         string
	LiveTestProfile string
}

type SupportStatus string

type TransportMode string

type TypedHandler func(InvocationContext, any) Handled