executorhttp

package

v0.3.0 Latest Latest Go to latest Published: Sep 1, 2026 License: MIT Imports: 10 Imported by: 0

Details

Package executorhttp adapts an Effectus HTTP verb target to a Go handler.

View Source

const (
	DirectionForward      = invocation.DirectionForward
	DirectionCompensation = invocation.DirectionCompensation
)

This section is empty.

func NewHandler(options Options, handler HandlerFunc) (http.Handler, error)

NewHandler creates a strict Effectus business executor endpoint.

func Permanent(err error) invocation.Outcome

Permanent reports a permanent business failure.

func Retryable(err error) invocation.Outcome

Retryable reports a failure that is known not to have committed.

func StaleFence(err error) invocation.Outcome

StaleFence reports a rejected stale fencing token.

func Success(result any) invocation.Outcome

Success reports a committed business operation.

func Unknown(err error) invocation.Outcome

Unknown reports a failure whose commit state is not known.

type Direction = invocation.Direction

Direction identifies forward and compensation calls.

type HandlerFunc func(context.Context, Request) Outcome

HandlerFunc performs one idempotent business operation.

type Options struct {
	MaxRequestBytes int64
}

Options controls the HTTP boundary.

type Outcome = invocation.Outcome

Outcome is the explicit result returned by a business executor.

type Request struct {
	Arguments    map[string]any
	Metadata     invocation.Context
	ArgumentHash string
	ContractHash string
}

Request contains business arguments and immutable Effectus metadata.