Files
notarius/internal/framework/pipeline/producer_outcome.go

74 lines
2.8 KiB
Go

package pipeline
import (
"context"
"errors"
"fmt"
"gitea.maximumdirect.net/eric/notarius/internal/framework/contracts"
)
// FinishProducerFailure applies the resolved terminal mode without retrying
// production or running ordinary validators against a supported fallback.
func FinishProducerFailure[T any](ctx context.Context, mode contracts.ExecutionMode, cause error, fallback func(context.Context) (T, error)) (T, contracts.ProducerOutcome, error) {
var zero T
if ctx == nil {
return zero, contracts.ProducerOutcome{}, errors.New("producer context must not be nil")
}
if err := ctx.Err(); err != nil {
return zero, contracts.ProducerOutcome{}, err
}
if cause == nil {
cause = errors.New("producer did not yield an accepted result")
}
var captureErr *contracts.CaptureError
if errors.As(cause, &captureErr) {
return zero, contracts.ProducerOutcome{}, cause
}
switch mode {
case contracts.ModeStrict:
return zero, contracts.ProducerOutcome{}, cause
case contracts.ModePermissive:
if fallback == nil {
return zero, contracts.ProducerOutcome{}, fmt.Errorf("producer has no supported fallback: %w", cause)
}
value, err := fallback(ctx)
if canceled := ctx.Err(); canceled != nil {
return zero, contracts.ProducerOutcome{}, canceled
}
if err != nil {
return zero, contracts.ProducerOutcome{}, errors.Join(cause, fmt.Errorf("construct producer fallback: %w", err))
}
return value, contracts.ProducerOutcome{Disposition: contracts.ProducerFallback, FallbackReason: cause.Error(), ReuseEligible: false}, nil
default:
return zero, contracts.ProducerOutcome{}, fmt.Errorf("unsupported producer mode %q", mode)
}
}
// AssessProducer assesses a no-model result once, including deterministic
// short-circuits inside otherwise model-backed modules. It never constructs a
// native request or gives deterministic work a correction loop.
func AssessProducer[T any](ctx context.Context, operation contracts.ProducerOperation[T], value T, fallback func(context.Context) (T, error)) (T, contracts.ProducerOutcome, error) {
var zero T
if ctx == nil {
return zero, contracts.ProducerOutcome{}, errors.New("producer context must not be nil")
}
if err := ctx.Err(); err != nil {
return zero, contracts.ProducerOutcome{}, err
}
if operation.Assess == nil {
return zero, contracts.ProducerOutcome{}, errors.New("producer assessment must be supplied")
}
assessment, err := operation.Assess(ctx, value)
if err != nil {
return zero, contracts.ProducerOutcome{}, err
}
if err := ctx.Err(); err != nil {
return zero, contracts.ProducerOutcome{}, err
}
if !assessment.Accepted() {
return FinishProducerFailure(ctx, operation.Controls.Mode, assessment.Err(), fallback)
}
return value, contracts.ProducerOutcome{Disposition: contracts.ProducerAccepted, ReuseEligible: operation.ReuseEligible}, nil
}