callbacks service draft

api/edge/callbacks/internal/events/module.go

@@ -0,0 +1,33 @@
+package events
+
+import (
+	"context"
+	"encoding/json"
+	"time"
+)
+
+// Envelope is the canonical incoming event envelope.
+type Envelope struct {
+	EventID     string          `json:"event_id"`
+	Type        string          `json:"type"`
+	ClientID    string          `json:"client_id"`
+	OccurredAt  time.Time       `json:"occurred_at"`
+	PublishedAt time.Time       `json:"published_at,omitempty"`
+	Data        json.RawMessage `json:"data"`
+}
+
+// Service parses incoming messages and builds outbound payload bytes.
+type Service interface {
+	Parse(data []byte) (*Envelope, error)
+	BuildPayload(ctx context.Context, envelope *Envelope) ([]byte, error)
+}
+
+// Payload is the stable outbound JSON body.
+type Payload struct {
+	EventID     string          `json:"event_id"`
+	Type        string          `json:"type"`
+	ClientID    string          `json:"client_id"`
+	OccurredAt  string          `json:"occurred_at"`
+	PublishedAt string          `json:"published_at,omitempty"`
+	Data        json.RawMessage `json:"data"`
+}