Files
archie/internal/domain/eda/playbook/coordinator.go
T

47 lines
2.0 KiB
Go

package playbook
import (
"context"
"errors"
"fmt"
"log/slog"
"strconv"
"github.com/samcharles93/archie-core/internal/domain/storecontract"
)
// InvokeOnce runs one playbook action at most once per
// (playbook, version, event, action) tuple, record-before-invoke: the ledger
// row is committed before fn runs, so a redelivered action (the same
// structural key) skips without repeating a non-revocable side effect
// (docs/prds/eda-playbook-engine.md gap 2). The structural key is computed
// from Decision.PlaybookID, Decision.Version, input.TaskID (the event_id) and
// Decision.ActionID; when the action declares no id the 1-based
// Decision.ActionPosition is used instead -- it is never a CEL expression. A
// key with an empty component (or no fallback position) is rejected before
// the ledger write rather than recorded as a degenerate row that collapses
// distinct events onto one key.
func InvokeOnce(ctx context.Context, ledger storecontract.PlaybookDispatcher, log *slog.Logger, decision Decision, input DispatchInput, fn func(context.Context) error) error {
if decision.ActionID == "" && decision.ActionPosition < 1 {
return fmt.Errorf("playbook action has no id and no 1-based position (playbook_id=%q)", decision.PlaybookID)
}
actionID := decision.ActionID
if actionID == "" {
actionID = strconv.Itoa(decision.ActionPosition)
}
if decision.PlaybookID == "" || decision.Version == "" || input.TaskID == "" || actionID == "" {
return fmt.Errorf("playbook dispatch key has an empty component (playbook_id=%q, version=%q, event_id=%q, action_id=%q)", decision.PlaybookID, decision.Version, input.TaskID, actionID)
}
err := ledger.RecordPlaybookDispatch(ctx, decision.PlaybookID, decision.Version, input.TaskID, actionID)
if err != nil {
if errors.Is(err, storecontract.ErrAlreadyDispatched) {
if log != nil {
log.Debug("playbook action already dispatched; skipping", "playbook", decision.PlaybookID, "version", decision.Version, "event_id", input.TaskID, "action_id", actionID)
}
return nil
}
return err
}
return fn(ctx)
}