47 lines
2.0 KiB
Go
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)
|
|
}
|