Files
mesh-sdk/go/buscompose/seatqueue.go
T
jschoubben 6852228000 Derive a seat's work queue and its worker from the seat definition
An accepted kind names its work queue's settings (max-age,
duplicates-window, ack-wait, in-progress, max-msgs, max-ack-pending,
max-deliveries); buscompose.SeatQueue derives the seat's work-queue stream
and its one shared worker from them, once, for the grants part to take.

Builds: design 47 H2 §777; H-A-350 DMC-1, H-A-362, H-A-340 (1)
2026-11-21 23:18:34 +01:00

98 lines
3.9 KiB
Go

package buscompose
import (
"fmt"
"strings"
"time"
"git.novox.be/novox/mesh-sdk/go/seatdef"
)
// The work queue's settings where a seat's accepted kinds name none: a week of asks, a delivery given up after five
// handings, a minute before an unacknowledged one is handed again.
const (
SeatQueueDefaultMaxAge = 7 * 24 * time.Hour
SeatQueueDefaultAckWait = time.Minute
SeatQueueDefaultDelivers = 5
)
// SeatQueueStreamName is the stream holding a seat's inbound work, named after the seat, never its holder.
func SeatQueueStreamName(seat string) string { return "SEAT_" + seatUpper(seat) }
// SeatQueueWorkerName is the one worker a seat's holders share on its work queue.
func SeatQueueWorkerName(seat string) string { return "SEAT_" + seatUpper(seat) + "_worker" }
func seatUpper(seat string) string {
return strings.ToUpper(strings.NewReplacer("-", "_", ".", "_").Replace(seat))
}
// SeatQueue derives a seat's work-queue stream and its one shared worker from its accepted kinds' work-queue settings
// (design 47 H2 §777; H-A-350 DMC-1, H-A-362), the one derivation every part takes: max-age, max-msgs and
// duplicates-window bound the stream; ack-wait, max-deliveries, max-ack-pending and in-progress the worker. A setting
// named by two accepted kinds with two values is refused: one stream and one worker carry one value. A seat that
// accepts nothing has no queue (ok false).
func SeatQueue(seat string, accepts []seatdef.Message) (stream Stream, worker Consumer, ok bool, err error) {
if len(accepts) == 0 {
return Stream{}, Consumer{}, false, nil
}
durations := map[string]string{}
counts := map[string]int{}
for _, a := range accepts {
if ps := a.QueueProblems("accepts " + a.Name); len(ps) > 0 {
return Stream{}, Consumer{}, false, fmt.Errorf("the seat %s's work queue: %w", seat, ps)
}
for name, v := range map[string]string{"max-age": a.MaxAge, "duplicates-window": a.DuplicatesWindow,
"ack-wait": a.AckWait, "in-progress": a.InProgress} {
if v == "" {
continue
}
if was, seen := durations[name]; seen && was != v {
return Stream{}, Consumer{}, false, fmt.Errorf("the seat %s's work queue: %s is %s and %s in two accepted kinds", seat, name, was, v)
}
durations[name] = v
}
for name, v := range map[string]int{"max-msgs": a.MaxMsgs, "max-ack-pending": a.MaxAckPending, "max-deliveries": a.MaxDeliveries} {
if v == 0 {
continue
}
if was, seen := counts[name]; seen && was != v {
return Stream{}, Consumer{}, false, fmt.Errorf("the seat %s's work queue: %s is %d and %d in two accepted kinds", seat, name, was, v)
}
counts[name] = v
}
}
seconds := func(name string, def time.Duration) int {
if v, set := durations[name]; set {
d, _ := time.ParseDuration(v) // QueueProblems read it
return int(d / time.Second)
}
return int(def / time.Second)
}
delivers := SeatQueueDefaultDelivers
if v, set := counts["max-deliveries"]; set {
delivers = v
}
subject := "mesh.seat." + seat + ".accept.>"
stream = Stream{
Name: SeatQueueStreamName(seat),
Subjects: []string{subject},
Retention: RetentionWorkQueue,
MaxAge: seconds("max-age", SeatQueueDefaultMaxAge),
MaxMsgs: counts["max-msgs"],
DuplicatesSeconds: seconds("duplicates-window", 0),
Why: fmt.Sprintf("work submitted to the %s seat; one holder consumes it, and it queues while nobody does", seat),
}
worker = Consumer{
Name: SeatQueueWorkerName(seat),
Stream: stream.Name,
Filters: []string{subject},
AckWaitSeconds: seconds("ack-wait", SeatQueueDefaultAckWait),
MaxDeliver: delivers,
MaxAckPending: counts["max-ack-pending"],
InProgressSeconds: seconds("in-progress", 0),
Why: fmt.Sprintf("every holder of %s pulls its asks from this one worker and acknowledges after the work is "+
"done, so a crash mid-work redelivers rather than loses", seat),
}
return stream, worker, true, nil
}