snapshot of https://github.com/ThreeDotsLabs/watermill.git (master, 2026-09-15; blobs > 131072B omitted)

2026-09-15 21:27:46 +05:00
commit ce933d1277
538 changed files with 46504 additions and 0 deletions
--- a/_examples/real-world-examples/consumer-groups/.validate_example.yml
+++ b/_examples/real-world-examples/consumer-groups/.validate_example.yml
@@ -0,0 +1,4 @@
+validation_cmd: "docker compose up"
+teardown_cmd: "docker compose down"
+timeout: 180
+expected_output: "Starting handler"
--- a/_examples/real-world-examples/consumer-groups/README.md
+++ b/_examples/real-world-examples/consumer-groups/README.md
@@ -0,0 +1,35 @@
+# Interactive Consumer Groups Example (Routing Events)
+
+This example shows how Customer Groups work, i.e. how to decide which handlers receive which events.
+
+Consumer Group is a concept used in Apache Kafka®, but many other Pub/Subs use a similar mechanism.
+
+The example uses Watermill and Redis Streams Pub/Sub, but the same idea applies to other Pub/Subs as well.
+
+## Live video
+
+This example was showcased on the Watermill v1.2 Launch Event. You can see the [recording on YouTube](https://www.youtube.com/live/wjnd0Hj6CaM?t=1020) (starts at 17:00).
+
+[![Live Recording](https://img.youtube.com/vi/wjnd0Hj6CaM/0.jpg)](https://www.youtube.com/live/wjnd0Hj6CaM?t=1020)
+
+## Running
+
+```
+docker-compose up
+```
+
+Then visit [localhost:8080](http://localhost:8080) and check the examples in each tab.
+
+## Screenshots
+
+![](docs/screen2.png)
+
+![](docs/screen1.png)
+
+## Code
+
+See [crm-service](crm-service) and [newsletter-service](newsletter-service) for the Watermill handlers setup.
+
+## How does it work?
+
+This example uses SSE for pushing events to the frontend UI. See the [other example on SEE](../server-sent-events) for more details.
--- a/_examples/real-world-examples/consumer-groups/api/http.go
+++ b/_examples/real-world-examples/consumer-groups/api/http.go
@@ -0,0 +1,151 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"strings"
+
+	"github.com/ThreeDotsLabs/watermill"
+	watermillHTTP "github.com/ThreeDotsLabs/watermill-http/pkg/http"
+	"github.com/ThreeDotsLabs/watermill-routing-example/server/common"
+	"github.com/ThreeDotsLabs/watermill/message"
+	"github.com/go-chi/chi/v5"
+)
+
+type Handler struct {
+	storage *storage
+
+	subscriber message.Subscriber
+	publisher  message.Publisher
+	logger     watermill.LoggerAdapter
+
+	lastIDs map[string]int
+}
+
+func (h Handler) Mux() *chi.Mux {
+	r := chi.NewRouter()
+
+	fileServer(r, "/", http.Dir("./public"))
+
+	sseRouter, err := watermillHTTP.NewSSERouter(
+		watermillHTTP.SSERouterConfig{
+			UpstreamSubscriber: h.subscriber,
+		},
+		h.logger,
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	messagesHandler := sseRouter.AddHandler(common.UpdatesTopic, messagesStream{
+		logger:  h.logger,
+		storage: h.storage,
+	})
+
+	r.Route("/api", func(r chi.Router) {
+		r.Use(requestIDMiddleware)
+		r.Get("/messages", messagesHandler)
+		r.Post("/messages/{topic}", h.SendMessage)
+	})
+
+	go func() {
+		err = sseRouter.Run(context.Background())
+		if err != nil {
+			panic(err)
+		}
+	}()
+
+	<-sseRouter.Running()
+
+	return r
+}
+
+func (h Handler) SendMessage(w http.ResponseWriter, r *http.Request) {
+	topic := chi.URLParam(r, "topic")
+
+	h.lastIDs[topic]++
+
+	msgID := fmt.Sprintf("%v", h.lastIDs[topic])
+
+	event := common.UserSignedUp{
+		UserID: watermill.NewUUID(),
+		Consents: common.Consents{
+			Marketing: true,
+			News:      true,
+		},
+	}
+
+	payload, err := json.Marshal(event)
+	if err != nil {
+		logAndWriteError(h.logger, w, err)
+		return
+	}
+
+	msg := message.NewMessage(msgID, payload)
+	msg.Metadata.Set("name", "UserSignedUp")
+
+	err = h.publisher.Publish(topic, msg)
+	if err != nil {
+		logAndWriteError(h.logger, w, err)
+		return
+	}
+
+	w.WriteHeader(204)
+}
+
+type messagesStream struct {
+	storage *storage
+	logger  watermill.LoggerAdapter
+}
+
+func (p messagesStream) GetResponse(w http.ResponseWriter, r *http.Request) (response interface{}, ok bool) {
+	reqID := r.Context().Value("request_id").(string)
+	messages := p.storage.PopAll(reqID)
+	return messages, true
+}
+
+func (p messagesStream) Validate(r *http.Request, msg *message.Message) (ok bool) {
+	var payload common.MessageReceived
+	err := json.Unmarshal(msg.Payload, &payload)
+	if err != nil {
+		return false
+	}
+
+	p.storage.Append(payload)
+
+	return true
+}
+
+func fileServer(r chi.Router, path string, root http.FileSystem) {
+	if strings.ContainsAny(path, "{}*") {
+		panic("FileServer does not permit URL parameters.")
+	}
+
+	fs := http.StripPrefix(path, http.FileServer(root))
+
+	if path != "/" && path[len(path)-1] != '/' {
+		r.Get(path, http.RedirectHandler(path+"/", 301).ServeHTTP)
+		path += "/"
+	}
+	path += "*"
+
+	r.Get(path, func(w http.ResponseWriter, r *http.Request) {
+		fs.ServeHTTP(w, r)
+	})
+}
+
+func logAndWriteError(logger watermill.LoggerAdapter, w http.ResponseWriter, err error) {
+	logger.Error("Error", err, nil)
+	w.WriteHeader(500)
+}
+
+func requestIDMiddleware(next http.Handler) http.Handler {
+	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		ctx := r.Context()
+		requestID := watermill.NewUUID()
+		ctx = context.WithValue(ctx, "request_id", requestID)
+		next.ServeHTTP(w, r.WithContext(ctx))
+	})
+}
--- a/_examples/real-world-examples/consumer-groups/api/main.go
+++ b/_examples/real-world-examples/consumer-groups/api/main.go
@@ -0,0 +1,75 @@
+package main
+
+import (
+	"context"
+	"net/http"
+	"sync"
+
+	"github.com/ThreeDotsLabs/watermill"
+	"github.com/ThreeDotsLabs/watermill-redisstream/pkg/redisstream"
+	"github.com/ThreeDotsLabs/watermill-routing-example/server/common"
+	"github.com/ThreeDotsLabs/watermill/message"
+	"github.com/ThreeDotsLabs/watermill/message/router/middleware"
+	"github.com/redis/go-redis/v9"
+)
+
+func main() {
+	logger := watermill.NewStdLogger(false, false)
+
+	router, err := message.NewRouter(message.RouterConfig{}, logger)
+	if err != nil {
+		panic(err)
+	}
+
+	router.AddMiddleware(middleware.Recoverer)
+
+	pubClient := redis.NewClient(&redis.Options{
+		Addr: "redis:6379",
+	})
+	publisher, err := redisstream.NewPublisher(
+		redisstream.PublisherConfig{
+			Client: pubClient,
+		},
+		logger,
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	subClient := redis.NewClient(&redis.Options{
+		Addr: "redis:6379",
+	})
+	subscriber, err := redisstream.NewSubscriber(
+		redisstream.SubscriberConfig{
+			Client: subClient,
+		},
+		logger,
+	)
+
+	go func() {
+		err = router.Run(context.Background())
+		if err != nil {
+			panic(err)
+		}
+	}()
+
+	<-router.Running()
+
+	storage := &storage{
+		lock:             &sync.Mutex{},
+		receivedMessages: map[string][]common.MessageReceived{},
+	}
+
+	httpRouter := Handler{
+		storage:    storage,
+		subscriber: subscriber,
+		publisher:  publisher,
+		logger:     logger,
+		lastIDs:    map[string]int{},
+	}
+
+	err = http.ListenAndServe(":8080", httpRouter.Mux())
+	if err != nil {
+		panic(err)
+	}
+}
--- a/_examples/real-world-examples/consumer-groups/api/public/index.html
+++ b/_examples/real-world-examples/consumer-groups/api/public/index.html
--- a/_examples/real-world-examples/consumer-groups/api/storage.go
+++ b/_examples/real-world-examples/consumer-groups/api/storage.go
@@ -0,0 +1,35 @@
+package main
+
+import (
+	"sync"
+
+	"github.com/ThreeDotsLabs/watermill-routing-example/server/common"
+)
+
+type storage struct {
+	lock             *sync.Mutex
+	receivedMessages map[string][]common.MessageReceived
+}
+
+func (s *storage) Append(message common.MessageReceived) {
+	s.lock.Lock()
+	defer s.lock.Unlock()
+
+	for k, v := range s.receivedMessages {
+		s.receivedMessages[k] = append(v, message)
+	}
+}
+
+func (s *storage) PopAll(key string) []common.MessageReceived {
+	s.lock.Lock()
+	defer s.lock.Unlock()
+
+	if _, ok := s.receivedMessages[key]; !ok {
+		s.receivedMessages[key] = []common.MessageReceived{}
+		return []common.MessageReceived{}
+	}
+
+	messages := s.receivedMessages[key]
+	s.receivedMessages[key] = []common.MessageReceived{}
+	return messages
+}
--- a/_examples/real-world-examples/consumer-groups/common/events.go
+++ b/_examples/real-world-examples/consumer-groups/common/events.go
@@ -0,0 +1,18 @@
+package common
+
+type UserSignedUp struct {
+	UserID   string   `json:"id"`
+	Consents Consents `json:"consents"`
+}
+
+type Consents struct {
+	Marketing bool `json:"marketing"`
+	News      bool `json:"news"`
+}
+
+type MessageReceived struct {
+	ID      string `json:"id"`
+	Service string `json:"service"`
+	Handler string `json:"handler"`
+	Topic   string `json:"topic"`
+}
--- a/_examples/real-world-examples/consumer-groups/common/messaging.go
+++ b/_examples/real-world-examples/consumer-groups/common/messaging.go
@@ -0,0 +1,46 @@
+package common
+
+import (
+	"encoding/json"
+	"strings"
+
+	"github.com/ThreeDotsLabs/watermill"
+	"github.com/ThreeDotsLabs/watermill/message"
+)
+
+const UpdatesTopic = "updates"
+
+func NotifyMiddleware(pub message.Publisher, serviceName string) func(message.HandlerFunc) message.HandlerFunc {
+	return func(next message.HandlerFunc) message.HandlerFunc {
+		return func(msg *message.Message) ([]*message.Message, error) {
+			topic := message.SubscribeTopicFromCtx(msg.Context())
+			handler := strings.Split(message.HandlerNameFromCtx(msg.Context()), "-")[0]
+
+			msgs, err := next(msg)
+			if err != nil {
+				return msgs, err
+			}
+
+			payload := MessageReceived{
+				ID:      msg.UUID,
+				Service: serviceName,
+				Handler: handler,
+				Topic:   topic,
+			}
+
+			jsonPayload, err := json.Marshal(payload)
+			if err != nil {
+				return nil, err
+			}
+
+			newMsg := message.NewMessage(watermill.NewUUID(), jsonPayload)
+
+			err = pub.Publish(UpdatesTopic, newMsg)
+			if err != nil {
+				return nil, err
+			}
+
+			return msgs, nil
+		}
+	}
+}
--- a/_examples/real-world-examples/consumer-groups/crm-service/main.go
+++ b/_examples/real-world-examples/consumer-groups/crm-service/main.go
@@ -0,0 +1,163 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"os"
+	"strings"
+
+	"github.com/ThreeDotsLabs/watermill"
+	"github.com/ThreeDotsLabs/watermill-redisstream/pkg/redisstream"
+	"github.com/ThreeDotsLabs/watermill-routing-example/server/common"
+	"github.com/ThreeDotsLabs/watermill/components/cqrs"
+	"github.com/ThreeDotsLabs/watermill/message"
+	"github.com/ThreeDotsLabs/watermill/message/router/middleware"
+	"github.com/redis/go-redis/v9"
+)
+
+var (
+	replica                = os.Getenv("REPLICA")
+	serviceName            = "crm-service"
+	serviceNameWithReplica = serviceName + "-" + replica
+)
+
+func main() {
+	logger := watermill.NewStdLogger(false, false)
+
+	router, err := message.NewRouter(message.RouterConfig{}, logger)
+	if err != nil {
+		panic(err)
+	}
+
+	pubClient := redis.NewClient(&redis.Options{
+		Addr: "redis:6379",
+	})
+	publisher, err := redisstream.NewPublisher(
+		redisstream.PublisherConfig{
+			Client: pubClient,
+		},
+		logger,
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	router.AddMiddleware(middleware.Recoverer)
+	router.AddMiddleware(common.NotifyMiddleware(publisher, serviceNameWithReplica))
+
+	subClient := redis.NewClient(&redis.Options{
+		Addr: "redis:6379",
+	})
+
+	subscriber, err := redisstream.NewSubscriber(
+		redisstream.SubscriberConfig{
+			Client:        subClient,
+			ConsumerGroup: "",
+		},
+		logger,
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	if replica == "1" {
+		router.AddConsumerHandler(
+			"OnUserSignedUp-2",
+			"UserSignedUp-2",
+			subscriber,
+			func(msg *message.Message) error {
+				var event common.UserSignedUp
+				err := json.Unmarshal(msg.Payload, &event)
+				if err != nil {
+					return err
+				}
+
+				fmt.Println("Adding user", event.UserID, "to the CRM")
+
+				return nil
+			},
+		)
+	}
+
+	if replica == "1" {
+		eventProc8, err := cqrs.NewEventProcessorWithConfig(router, cqrs.EventProcessorConfig{
+			GenerateSubscribeTopic: func(params cqrs.EventProcessorGenerateSubscribeTopicParams) (string, error) {
+				return fmt.Sprintf("%s-8", params.EventName), nil
+			},
+			SubscriberConstructor: func(params cqrs.EventProcessorSubscriberConstructorParams) (message.Subscriber, error) {
+				handlerName := strings.Split(params.HandlerName, "-")[0]
+				return redisstream.NewSubscriber(
+					redisstream.SubscriberConfig{
+						Client:        subClient,
+						ConsumerGroup: fmt.Sprintf("%s_%s", serviceName, handlerName),
+					},
+					logger,
+				)
+			},
+			Marshaler: cqrs.JSONMarshaler{
+				GenerateName: cqrs.StructName,
+			},
+			Logger: logger,
+		})
+		if err != nil {
+			panic(err)
+		}
+
+		err = eventProc8.AddHandlers(
+			cqrs.NewEventHandler("AddToCRM-8", HandleCRM),
+			cqrs.NewEventHandler("AddToSupport-8", HandleSupport),
+		)
+		if err != nil {
+			panic(err)
+		}
+	}
+
+	eventProc9, err := cqrs.NewEventProcessorWithConfig(router, cqrs.EventProcessorConfig{
+		GenerateSubscribeTopic: func(params cqrs.EventProcessorGenerateSubscribeTopicParams) (string, error) {
+			return fmt.Sprintf("%s-9", params.EventName), nil
+		},
+		SubscriberConstructor: func(params cqrs.EventProcessorSubscriberConstructorParams) (message.Subscriber, error) {
+			handlerName := strings.Split(params.HandlerName, "-")[0]
+			return redisstream.NewSubscriber(
+				redisstream.SubscriberConfig{
+					Client:        subClient,
+					ConsumerGroup: fmt.Sprintf("%s_%s", serviceName, handlerName),
+				},
+				logger,
+			)
+		},
+		Marshaler: cqrs.JSONMarshaler{
+			GenerateName: cqrs.StructName,
+		},
+		Logger: logger,
+	})
+	if err != nil {
+		panic(err)
+	}
+
+	err = eventProc9.AddHandlers(
+		cqrs.NewEventHandler("AddToCRM-9", HandleCRM),
+		cqrs.NewEventHandler("AddToSupport-9", HandleSupport),
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	err = router.Run(context.Background())
+	if err != nil {
+		panic(err)
+	}
+}
+
+func HandleCRM(ctx context.Context, e *common.UserSignedUp) error {
+	fmt.Println("Adding user", e.UserID, "to the CRM")
+
+	return nil
+}
+
+func HandleSupport(ctx context.Context, e *common.UserSignedUp) error {
+	fmt.Println("Adding user", e.UserID, "to the support channel")
+
+	return nil
+}
--- a/_examples/real-world-examples/consumer-groups/docker-compose.yml
+++ b/_examples/real-world-examples/consumer-groups/docker-compose.yml
@@ -0,0 +1,66 @@
+services:
+  api:
+    image: golang:1.25
+    restart: unless-stopped
+    depends_on:
+      - redis
+    volumes:
+      - .:/app
+    working_dir: /app/api
+    ports:
+      - "8080:8080"
+    command: go run .
+
+  newsletter-1:
+    image: golang:1.25
+    restart: unless-stopped
+    depends_on:
+      - redis
+    volumes:
+      - .:/app
+    working_dir: /app/newsletter-service
+    command: go run .
+    environment:
+      REPLICA: 1
+
+  newsletter-2:
+    image: golang:1.25
+    restart: unless-stopped
+    depends_on:
+      - redis
+    volumes:
+      - .:/app
+    working_dir: /app/newsletter-service
+    command: go run .
+    environment:
+      REPLICA: 2
+
+  crm-1:
+    image: golang:1.25
+    restart: unless-stopped
+    depends_on:
+      - redis
+    volumes:
+      - .:/app
+    working_dir: /app/crm-service
+    command: go run .
+    environment:
+      REPLICA: 1
+
+  crm-2:
+    image: golang:1.25
+    restart: unless-stopped
+    depends_on:
+      - redis
+    volumes:
+      - .:/app
+    working_dir: /app/crm-service
+    command: go run .
+    environment:
+      REPLICA: 2
+
+  redis:
+    image: redis:7
+    ports:
+      - "6379:6379"
+    restart: unless-stopped
--- a/_examples/real-world-examples/consumer-groups/go.mod
+++ b/_examples/real-world-examples/consumer-groups/go.mod
@@ -0,0 +1,35 @@
+module github.com/ThreeDotsLabs/watermill-routing-example/server
+
+go 1.25
+
+require (
+	github.com/ThreeDotsLabs/watermill v1.5.1
+	github.com/ThreeDotsLabs/watermill-http v1.1.4
+	github.com/go-chi/chi/v5 v5.2.5
+	github.com/go-chi/render v1.0.3 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+)
+
+require (
+	github.com/ThreeDotsLabs/watermill-redisstream v1.4.5
+	github.com/redis/go-redis/v9 v9.19.0
+)
+
+require (
+	github.com/Rican7/retry v0.3.1 // indirect
+	github.com/ajg/form v1.7.1 // indirect
+	github.com/cenkalti/backoff/v5 v5.0.3 // indirect
+	github.com/cespare/xxhash/v2 v2.3.0 // indirect
+	github.com/go-chi/chi v4.1.2+incompatible // indirect
+	github.com/gogo/protobuf v1.3.2 // indirect
+	github.com/golang/protobuf v1.5.4 // indirect
+	github.com/lithammer/shortuuid/v3 v3.0.7 // indirect
+	github.com/oklog/ulid v1.3.1 // indirect
+	github.com/pkg/errors v0.9.1 // indirect
+	github.com/sony/gobreaker v1.0.0 // indirect
+	github.com/vmihailenco/msgpack v4.0.4+incompatible // indirect
+	go.uber.org/atomic v1.11.0 // indirect
+	google.golang.org/appengine v1.6.8 // indirect
+	google.golang.org/protobuf v1.36.11 // indirect
+	gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c // indirect
+)
--- a/_examples/real-world-examples/consumer-groups/go.sum
+++ b/_examples/real-world-examples/consumer-groups/go.sum
@@ -0,0 +1,176 @@
+github.com/Rican7/retry v0.3.1 h1:scY4IbO8swckzoA/11HgBwaZRJEyY9vaNJshcdhp1Mc=
+github.com/Rican7/retry v0.3.1/go.mod h1:CxSDrhAyXmTMeEuRAnArMu1FHu48vtfjLREWqVl7Vw0=
+github.com/ThreeDotsLabs/watermill v1.1.0/go.mod h1:Qd1xNFxolCAHCzcMrm6RnjW0manbvN+DJVWc1MWRFlI=
+github.com/ThreeDotsLabs/watermill v1.5.1 h1:t5xMivyf9tpmU3iozPqyrCZXHvoV1XQDfihas4sV0fY=
+github.com/ThreeDotsLabs/watermill v1.5.1/go.mod h1:Uop10dA3VeJWsSvis9qO3vbVY892LARrKAdki6WtXS4=
+github.com/ThreeDotsLabs/watermill-http v1.1.4 h1:wRM54z/BPnIWjGbXMrOnwOlrCAESzoSNxTAHiLysFA4=
+github.com/ThreeDotsLabs/watermill-http v1.1.4/go.mod h1:mkQ9CC0pxTZerNwr281rBoOy355vYt/lePkmYSX/BRg=
+github.com/ThreeDotsLabs/watermill-redisstream v1.4.5 h1:SCETqsAYo/CRBb7H3+zWCcSqhMpDrQA4I6dCqC7UPR4=
+github.com/ThreeDotsLabs/watermill-redisstream v1.4.5/go.mod h1:Da3wqG1OcvHPODjuJcxSCY1O7D4loIZQpVbZ5u94xRo=
+github.com/ajg/form v1.5.1/go.mod h1:uL1WgH+h2mgNtvBq0339dVnzXdBETtL2LeUXaIv25UY=
+github.com/ajg/form v1.7.1 h1:OsnBDzTkrWdrxvEnO68I72ZVGJGNaMwPhoAm0V+llgc=
+github.com/ajg/form v1.7.1/go.mod h1:HL757PzLyNkj5AIfptT6L+iGNeXTlnrr/oDePGc/y7Q=
+github.com/alecthomas/template v0.0.0-20160405071501-a0175ee3bccc/go.mod h1:LOuyumcjzFXgccqObfd/Ljyb9UuFJ6TxHnclSeseNhc=
+github.com/alecthomas/units v0.0.0-20151022065526-2efee857e7cf/go.mod h1:ybxpYRFXyAe+OPACYpWeL0wqObRcbAqCMya13uyzqw0=
+github.com/beorn7/perks v0.0.0-20180321164747-3a771d992973/go.mod h1:Dwedo/Wpr24TaqPxmxbtue+5NUziq4I4S80YR8gNf3Q=
+github.com/beorn7/perks v1.0.0/go.mod h1:KWe93zE9D1o94FZ5RNwFwVgaQK1VOXiVxmqh+CedLV8=
+github.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs=
+github.com/bsm/ginkgo/v2 v2.12.0/go.mod h1:SwYbGRRDovPVboqFv0tPTcG1sN61LM1Z4ARdbAV9g4c=
+github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=
+github.com/bsm/gomega v1.27.10/go.mod h1:JyEr/xRbxbtgWNi8tIEVPUYZ5Dzef52k01W3YH0H+O0=
+github.com/cenkalti/backoff/v3 v3.0.0/go.mod h1:cIeZDE3IrqwwJl6VUwCN6trj1oXrTS4rc0ij+ULvLYs=
+github.com/cenkalti/backoff/v5 v5.0.3 h1:ZN+IMa753KfX5hd8vVaMixjnqRZ3y8CuJKRKj1xcsSM=
+github.com/cenkalti/backoff/v5 v5.0.3/go.mod h1:rkhZdG3JZukswDf7f0cwqPNk4K0sa+F97BxZthm/crw=
+github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
+github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/go-chi/chi v4.0.2+incompatible/go.mod h1:eB3wogJHnLi3x/kFX2A+IbTBlXxmMeXJVKy9tTv1XzQ=
+github.com/go-chi/chi v4.1.2+incompatible h1:fGFk2Gmi/YKXk0OmGfBh0WgmN3XB8lVnEyNz34tQRec=
+github.com/go-chi/chi v4.1.2+incompatible/go.mod h1:eB3wogJHnLi3x/kFX2A+IbTBlXxmMeXJVKy9tTv1XzQ=
+github.com/go-chi/chi/v5 v5.2.5 h1:Eg4myHZBjyvJmAFjFvWgrqDTXFyOzjj7YIm3L3mu6Ug=
+github.com/go-chi/chi/v5 v5.2.5/go.mod h1:X7Gx4mteadT3eDOMTsXzmI4/rwUpOwBHLpAfupzFJP0=
+github.com/go-chi/render v1.0.1/go.mod h1:pq4Rr7HbnsdaeHagklXub+p6Wd16Af5l9koip1OvJns=
+github.com/go-chi/render v1.0.3 h1:AsXqd2a1/INaIfUSKq3G5uA8weYx20FOsM7uSoCyyt4=
+github.com/go-chi/render v1.0.3/go.mod h1:/gr3hVkmYR0YlEy3LxCuVRFzEu9Ruok+gFqbIofjao0=
+github.com/go-kit/kit v0.8.0/go.mod h1:xBxKIO96dXMWWy0MnWVtmwkA9/13aqxPnvrjFYMA2as=
+github.com/go-logfmt/logfmt v0.3.0/go.mod h1:Qt1PoO58o5twSAckw1HlFXLmHsOX5/0LbT9GBnD5lWE=
+github.com/go-stack/stack v1.8.0/go.mod h1:v0f6uXyyMGvRgIKkXu+yp6POWl0qKG85gN/melR3HDY=
+github.com/gogo/protobuf v1.1.1/go.mod h1:r8qH/GZQm5c6nD/R0oafs1akxWv10x8SbQlK7atdtwQ=
+github.com/gogo/protobuf v1.2.1/go.mod h1:hp+jE20tsWTFYpLwKvXlhS1hjn+gTNwPg2I6zVXpSg4=
+github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q=
+github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q=
+github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
+github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
+github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk=
+github.com/golang/protobuf v1.5.2/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY=
+github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=
+github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=
+github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/google/uuid v1.1.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/google/uuid v1.2.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/hashicorp/errwrap v1.0.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
+github.com/hashicorp/go-multierror v1.0.0/go.mod h1:dHtQlpGsu+cZNNAkkCN/P3hoUDHhCYQXV3UM06sGGrk=
+github.com/json-iterator/go v1.1.6/go.mod h1:+SdeFBvtyEkXs7REEP0seUULqWtbJapLOCVDaaPEHmU=
+github.com/julienschmidt/httprouter v1.2.0/go.mod h1:SYymIcj16QtmaHHD7aYtjjsJG7VTCxuUUipMqKk8s4w=
+github.com/kisielk/errcheck v1.1.0/go.mod h1:EZBBE59ingxPouuu3KfxchcWSUPOHkagtvWXihfKN4Q=
+github.com/kisielk/errcheck v1.5.0/go.mod h1:pFxgyoBC7bSaBwPgfKdkLd5X25qrDl4LWUI2bnpBCr8=
+github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
+github.com/konsorten/go-windows-terminal-sequences v1.0.1/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ=
+github.com/kr/logfmt v0.0.0-20140226030751-b84e30acd515/go.mod h1:+0opPa2QZZtGFBFZlji/RkVcI2GknAs/DXo4wKdlNEc=
+github.com/kr/pretty v0.2.1 h1:Fmg33tUaq4/8ym9TJN1x7sLJnHVwhP33CNkpYV/7rwI=
+github.com/kr/pretty v0.2.1/go.mod h1:ipq/a2n7PKx3OHsz4KJII5eveXtPO4qwEXGdVfWzfnI=
+github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
+github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/lithammer/shortuuid/v3 v3.0.4/go.mod h1:RviRjexKqIzx/7r1peoAITm6m7gnif/h+0zmolKJjzw=
+github.com/lithammer/shortuuid/v3 v3.0.7 h1:trX0KTHy4Pbwo/6ia8fscyHoGA+mf1jWbPJVuvyJQQ8=
+github.com/lithammer/shortuuid/v3 v3.0.7/go.mod h1:vMk8ke37EmiewwolSO1NLW8vP4ZaKlRuDIi8tWWmAts=
+github.com/matttproud/golang_protobuf_extensions v1.0.1/go.mod h1:D8He9yQNgCq6Z5Ld7szi9bcBfOoFv/3dc6xSMkL2PC0=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/reflect2 v1.0.1/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0=
+github.com/mwitkow/go-conntrack v0.0.0-20161129095857-cc309e4a2223/go.mod h1:qRWi+5nqEBWmkhHvq77mSJWrCKwh8bxhgT7d/eI7P4U=
+github.com/oklog/ulid v1.3.1 h1:EGfNDEx6MqHz8B3uNV6QAib1UR2Lm97sHi3ocA6ESJ4=
+github.com/oklog/ulid v1.3.1/go.mod h1:CirwcVhetQ6Lv90oh/F+FBtV6XMibvdAFo93nm5qn4U=
+github.com/pkg/errors v0.8.0/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
+github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
+github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
+github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/prometheus/client_golang v0.9.1/go.mod h1:7SWBe2y4D6OKWSNQJUaRYU/AaXPKyh/dDVn+NZz0KFw=
+github.com/prometheus/client_golang v1.0.0/go.mod h1:db9x61etRT2tGnBNRi70OPL5FsnadC4Ky3P0J6CfImo=
+github.com/prometheus/client_model v0.0.0-20180712105110-5c3871d89910/go.mod h1:MbSGuTsp3dbXC40dX6PRTWyKYBIrTGTE9sqQNg2J8bo=
+github.com/prometheus/client_model v0.0.0-20190129233127-fd36f4220a90/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA=
+github.com/prometheus/common v0.4.1/go.mod h1:TNfzLD0ON7rHzMJeJkieUDPYmFC7Snx/y86RQel1bk4=
+github.com/prometheus/procfs v0.0.0-20181005140218-185b4288413d/go.mod h1:c3At6R/oaqEKCNdg8wHV1ftS6bRYblBhIjjI8uT2IGk=
+github.com/prometheus/procfs v0.0.2/go.mod h1:TjEm7ze935MbeOT/UhFTIMYKhuLP4wbCsTZCD3I8kEA=
+github.com/redis/go-redis/v9 v9.19.0 h1:XPVaaPSnG6RhYf7p+rmSa9zZfeVAnWsH5h3lxthOm/k=
+github.com/redis/go-redis/v9 v9.19.0/go.mod h1:v/M13XI1PVCDcm01VtPFOADfZtHf8YW3baQf57KlIkA=
+github.com/sirupsen/logrus v1.2.0/go.mod h1:LxeOpSwHxABJmUn/MG1IvRgCAasNZTLOkJPxbbu5VWo=
+github.com/sony/gobreaker v1.0.0 h1:feX5fGGXSl3dYd4aHZItw+FpHLvvoaqkawKjVNiFMNQ=
+github.com/sony/gobreaker v1.0.0/go.mod h1:ZKptC7FHNvhBz7dN2LGjPVBz2sZJmc0/PkyDJOjmxWY=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/objx v0.1.1/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.11.0 h1:ib4sjIrwZKxE5u/Japgo/7SJV3PvgjGiRNAvTVGqQl8=
+github.com/stretchr/testify v1.11.0/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+github.com/vmihailenco/msgpack v4.0.4+incompatible h1:dSLoQfGFAo3F6OoNhwUmLwVgaUXK79GlxNBwueZn0xI=
+github.com/vmihailenco/msgpack v4.0.4+incompatible/go.mod h1:fy3FlTQTDXWkZ7Bh6AcGMlsjHatGryHQYUTf1ShIgkk=
+github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
+github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
+github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=
+github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
+github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
+go.uber.org/atomic v1.11.0 h1:ZvwS0R+56ePWxUNi+Atn9dWONBPp/AUETXlHW0DxSjE=
+go.uber.org/atomic v1.11.0/go.mod h1:LUxbIzbOniOlMKjJjyPfpl4v+PKK2cNJn91OQbhoJI0=
+golang.org/x/crypto v0.0.0-20180904163835-0709b304e793/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
+golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
+golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
+golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
+golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
+golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=
+golang.org/x/net v0.0.0-20181114220301-adae6a3d119a/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
+golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
+golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
+golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
+golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c=
+golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sys v0.0.0-20180905080454-ebe1bf3edb33/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20181116152217-5ac8a444bdc5/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.35.0 h1:vz1N37gP5bs89s7He8XuIYXpyY0+QlsKmzipCbUtyxI=
+golang.org/x/sys v0.35.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
+golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
+golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
+golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
+golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
+golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ=
+golang.org/x/tools v0.0.0-20180221164845-07fd8470d635/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
+golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
+golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
+golang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=
+golang.org/x/tools v0.0.0-20210106214847-113979e3529a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
+golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc=
+golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+google.golang.org/appengine v1.6.8 h1:IhEN5q69dyKagZPYMSdIjS2HqprW324FRQZJcGqPAsM=
+google.golang.org/appengine v1.6.8/go.mod h1:1jJ3jBArFh5pcgW8gCtRJnepW8FzD1V44FJffLiz/Ds=
+google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw=
+google.golang.org/protobuf v1.26.0/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc=
+google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
+google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
+gopkg.in/alecthomas/kingpin.v2 v2.2.6/go.mod h1:FMv+mEhP44yOT+4EoQTLFTRgOQ1FBLkstjWtayDeSgw=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
+gopkg.in/yaml.v2 v2.2.1/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
--- a/_examples/real-world-examples/consumer-groups/newsletter-service/main.go
+++ b/_examples/real-world-examples/consumer-groups/newsletter-service/main.go
@@ -0,0 +1,395 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"os"
+	"strings"
+
+	"github.com/ThreeDotsLabs/watermill"
+	"github.com/ThreeDotsLabs/watermill-redisstream/pkg/redisstream"
+	"github.com/ThreeDotsLabs/watermill-routing-example/server/common"
+	"github.com/ThreeDotsLabs/watermill/components/cqrs"
+	"github.com/ThreeDotsLabs/watermill/message"
+	"github.com/ThreeDotsLabs/watermill/message/router/middleware"
+	"github.com/redis/go-redis/v9"
+)
+
+var (
+	replica                = os.Getenv("REPLICA")
+	serviceName            = "newsletter-service"
+	serviceNameWithReplica = serviceName + "-" + replica
+)
+
+func main() {
+	logger := watermill.NewStdLogger(false, false)
+
+	router, err := message.NewRouter(message.RouterConfig{}, logger)
+	if err != nil {
+		panic(err)
+	}
+
+	pubClient := redis.NewClient(&redis.Options{
+		Addr: "redis:6379",
+	})
+	publisher, err := redisstream.NewPublisher(
+		redisstream.PublisherConfig{
+			Client: pubClient,
+		},
+		logger,
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	router.AddMiddleware(middleware.Recoverer)
+	router.AddMiddleware(common.NotifyMiddleware(publisher, serviceNameWithReplica))
+
+	subClient := redis.NewClient(&redis.Options{
+		Addr: "redis:6379",
+	})
+	subscriber, err := redisstream.NewSubscriber(
+		redisstream.SubscriberConfig{
+			Client:        subClient,
+			ConsumerGroup: "",
+		},
+		logger,
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	newsletterServiceGroupSubscriber, err := redisstream.NewSubscriber(
+		redisstream.SubscriberConfig{
+			Client:        subClient,
+			ConsumerGroup: "newsletter-service",
+		},
+		logger,
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	addToPromotionsListGroupSubscriber, err := redisstream.NewSubscriber(
+		redisstream.SubscriberConfig{
+			Client:        subClient,
+			ConsumerGroup: "AddToPromotionsList",
+		},
+		logger,
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	addToNewsListGroupSubscriber, err := redisstream.NewSubscriber(
+		redisstream.SubscriberConfig{
+			Client:        subClient,
+			ConsumerGroup: "AddToNewsList",
+		},
+		logger,
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	if replica == "1" {
+		router.AddConsumerHandler(
+			"OnUserSignedUp-1",
+			"UserSignedUp-1",
+			subscriber,
+			func(msg *message.Message) error {
+				var event common.UserSignedUp
+				err := json.Unmarshal(msg.Payload, &event)
+				if err != nil {
+					return err
+				}
+
+				if !event.Consents.Marketing {
+					return nil
+				}
+
+				fmt.Println("Adding user", event.UserID, "to the promotions list")
+
+				return nil
+			},
+		)
+
+		router.AddConsumerHandler(
+			"OnUserSignedUp-2",
+			"UserSignedUp-2",
+			subscriber,
+			func(msg *message.Message) error {
+				var event common.UserSignedUp
+				err := json.Unmarshal(msg.Payload, &event)
+				if err != nil {
+					return err
+				}
+
+				if !event.Consents.Marketing {
+					return nil
+				}
+
+				fmt.Println("Adding user", event.UserID, "to the promotions list")
+
+				return nil
+			},
+		)
+
+		router.AddConsumerHandler(
+			"AddToPromotionsList-5",
+			"UserSignedUp-5",
+			newsletterServiceGroupSubscriber,
+			func(msg *message.Message) error {
+				var event common.UserSignedUp
+				err := json.Unmarshal(msg.Payload, &event)
+				if err != nil {
+					return err
+				}
+
+				if !event.Consents.Marketing {
+					return nil
+				}
+
+				fmt.Println("Adding user", event.UserID, "to the promotions list")
+
+				return nil
+			},
+		)
+
+		router.AddConsumerHandler(
+			"AddToNewsList-5",
+			"UserSignedUp-5",
+			newsletterServiceGroupSubscriber,
+			func(msg *message.Message) error {
+				var event common.UserSignedUp
+				err := json.Unmarshal(msg.Payload, &event)
+				if err != nil {
+					return err
+				}
+
+				if !event.Consents.News {
+					return nil
+				}
+
+				fmt.Println("Adding user", event.UserID, "to the news list")
+
+				return nil
+			},
+		)
+
+		router.AddConsumerHandler(
+			"AddToPromotionsList-6",
+			"UserSignedUp-6",
+			addToPromotionsListGroupSubscriber,
+			func(msg *message.Message) error {
+				var event common.UserSignedUp
+				err := json.Unmarshal(msg.Payload, &event)
+				if err != nil {
+					return err
+				}
+
+				if !event.Consents.Marketing {
+					return nil
+				}
+
+				fmt.Println("Adding user", event.UserID, "to the promotions list")
+
+				return nil
+			},
+		)
+
+		router.AddConsumerHandler(
+			"AddToNewsList-6",
+			"UserSignedUp-6",
+			addToNewsListGroupSubscriber,
+			func(msg *message.Message) error {
+				var event common.UserSignedUp
+				err := json.Unmarshal(msg.Payload, &event)
+				if err != nil {
+					return err
+				}
+
+				if !event.Consents.News {
+					return nil
+				}
+
+				fmt.Println("Adding user", event.UserID, "to the news list")
+
+				return nil
+			},
+		)
+	}
+
+	router.AddConsumerHandler(
+		"OnUserSignedUp-3",
+		"UserSignedUp-3",
+		subscriber,
+		func(msg *message.Message) error {
+			var event common.UserSignedUp
+			err := json.Unmarshal(msg.Payload, &event)
+			if err != nil {
+				return err
+			}
+
+			if !event.Consents.Marketing {
+				return nil
+			}
+
+			fmt.Println("Adding user", event.UserID, "to the promotions list")
+
+			return nil
+		},
+	)
+
+	router.AddConsumerHandler(
+		"OnUserSignedUp-4",
+		"UserSignedUp-4",
+		newsletterServiceGroupSubscriber,
+		func(msg *message.Message) error {
+			var event common.UserSignedUp
+			err := json.Unmarshal(msg.Payload, &event)
+			if err != nil {
+				return err
+			}
+
+			if !event.Consents.Marketing {
+				return nil
+			}
+
+			fmt.Println("Adding user", event.UserID, "to the promotions list")
+
+			return nil
+		},
+	)
+
+	router.AddConsumerHandler(
+		"AddToPromotionsList-7",
+		"UserSignedUp-7",
+		addToPromotionsListGroupSubscriber,
+		func(msg *message.Message) error {
+			var event common.UserSignedUp
+			err := json.Unmarshal(msg.Payload, &event)
+			if err != nil {
+				return err
+			}
+
+			if !event.Consents.Marketing {
+				return nil
+			}
+
+			fmt.Println("Adding user", event.UserID, "to the promotions list")
+
+			return nil
+		},
+	)
+
+	router.AddConsumerHandler(
+		"AddToNewsList-7",
+		"UserSignedUp-7",
+		addToNewsListGroupSubscriber,
+		func(msg *message.Message) error {
+			var event common.UserSignedUp
+			err := json.Unmarshal(msg.Payload, &event)
+			if err != nil {
+				return err
+			}
+
+			if !event.Consents.News {
+				return nil
+			}
+
+			fmt.Println("Adding user", event.UserID, "to the news list")
+
+			return nil
+		},
+	)
+
+	if replica == "1" {
+		eventProc8, err := cqrs.NewEventProcessorWithConfig(router, cqrs.EventProcessorConfig{
+			GenerateSubscribeTopic: func(params cqrs.EventProcessorGenerateSubscribeTopicParams) (string, error) {
+				return fmt.Sprintf("%s-8", params.EventName), nil
+			},
+			SubscriberConstructor: func(params cqrs.EventProcessorSubscriberConstructorParams) (message.Subscriber, error) {
+				handlerName := strings.Split(params.HandlerName, "-")[0]
+				return redisstream.NewSubscriber(
+					redisstream.SubscriberConfig{
+						Client:        subClient,
+						ConsumerGroup: fmt.Sprintf("%s_%s", serviceName, handlerName),
+					},
+					logger,
+				)
+			},
+			Marshaler: cqrs.JSONMarshaler{
+				GenerateName: cqrs.StructName,
+			},
+			Logger: logger,
+		})
+		if err != nil {
+			panic(err)
+		}
+		err = eventProc8.AddHandlers(
+			cqrs.NewEventHandler("AddToPromotionsList-8", HandlePromotions),
+			cqrs.NewEventHandler("AddToNewsList-8", HandleNews),
+		)
+		if err != nil {
+			panic(err)
+		}
+	}
+
+	eventProc9, err := cqrs.NewEventProcessorWithConfig(router, cqrs.EventProcessorConfig{
+		GenerateSubscribeTopic: func(params cqrs.EventProcessorGenerateSubscribeTopicParams) (string, error) {
+			return fmt.Sprintf("%s-9", params.EventName), nil
+		},
+		SubscriberConstructor: func(params cqrs.EventProcessorSubscriberConstructorParams) (message.Subscriber, error) {
+			handlerName := strings.Split(params.HandlerName, "-")[0]
+			return redisstream.NewSubscriber(
+				redisstream.SubscriberConfig{
+					Client:        subClient,
+					ConsumerGroup: fmt.Sprintf("%s_%s", serviceName, handlerName),
+				},
+				logger,
+			)
+		},
+		Marshaler: cqrs.JSONMarshaler{
+			GenerateName: cqrs.StructName,
+		},
+		Logger: logger,
+	})
+	if err != nil {
+		panic(err)
+	}
+
+	err = eventProc9.AddHandlers(
+		cqrs.NewEventHandler("AddToPromotionsList-9", HandlePromotions),
+		cqrs.NewEventHandler("AddToNewsList-9", HandleNews),
+	)
+	if err != nil {
+		panic(err)
+	}
+
+	err = router.Run(context.Background())
+	if err != nil {
+		panic(err)
+	}
+}
+
+func HandleNews(ctx context.Context, e *common.UserSignedUp) error {
+	if !e.Consents.News {
+		return nil
+	}
+
+	fmt.Println("Adding user", e.UserID, "to the news list")
+
+	return nil
+}
+
+func HandlePromotions(ctx context.Context, e *common.UserSignedUp) error {
+	if !e.Consents.Marketing {
+		return nil
+	}
+
+	fmt.Println("Adding user", e.UserID, "to the promotions list")
+
+	return nil
+}