Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ make demo

| What | Path |
| --- | --- |
| Send event | `POST /v1/events` (header `X-Signature`, optional `X-Key-Id`) |
| Send event | `POST /v1/events` (header `X-Signature`, optional `X-Key-Id`; `schema_version` omitted or `1`) |
| Rotate HMAC | `POST /v1/hmac/rotate` (header `X-API-Key`; overlap for that brand only) |
| Read player | `GET /v1/players/{id}` (header `X-API-Key`) |
| List dead letters | `GET /v1/dlq` (header `X-API-Key`) |
Expand Down
2 changes: 1 addition & 1 deletion docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ loadgen / partner
|
v
POST /v1/events
- check JSON
- check JSON (`schema_version` omitted or 1; unknown versions 400)
- check brand secret (HMAC signature, optional X-Key-Id)
- save row in outbox table
- reply 202 Accepted
Expand Down
107 changes: 107 additions & 0 deletions internal/api/httpapi/schema_test.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
package httpapi_test

import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"strings"
"testing"
"time"

"github.com/o-mid/engagepulse/internal/domain"
"github.com/o-mid/engagepulse/internal/ingest"
)

func TestIngestRejectsUnknownSchemaVersion(t *testing.T) {
st, srv := newSecurityTestServer(t)
defer st.Close()
defer srv.Close()

suffix := fmt.Sprintf("%d", time.Now().UnixNano())
evt := domain.Event{
EventID: "schema-bad-" + suffix,
TenantID: "acme-casino",
PlayerID: "schema-player-" + suffix,
Type: domain.EventDeposit,
Amount: 50,
SchemaVersion: 2,
OccurredAt: time.Now().UTC(),
}
body, err := json.Marshal(evt)
if err != nil {
t.Fatalf("marshal: %v", err)
}
req, err := http.NewRequest(http.MethodPost, srv.URL+"/v1/events", bytes.NewReader(body))
if err != nil {
t.Fatalf("request: %v", err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-Signature", ingest.Sign("hmac_acme_dev_secret", body))

resp, err := http.DefaultClient.Do(req)
if err != nil {
t.Fatalf("do: %v", err)
}
defer func() { _ = resp.Body.Close() }()
if resp.StatusCode != http.StatusBadRequest {
b, _ := io.ReadAll(resp.Body)
t.Fatalf("status=%d want 400 body=%s", resp.StatusCode, b)
}
b, _ := io.ReadAll(resp.Body)
if !strings.Contains(string(b), "schema_version") {
t.Fatalf("body=%s", b)
}
}

func TestIngestAcceptsV1SchemaAndHeartbeat(t *testing.T) {
st, srv := newSecurityTestServer(t)
defer st.Close()
defer srv.Close()

suffix := fmt.Sprintf("%d", time.Now().UnixNano())
deposit := domain.Event{
EventID: "schema-v1-" + suffix,
TenantID: "acme-casino",
PlayerID: "schema-player-" + suffix,
Type: domain.EventDeposit,
Amount: 50,
SchemaVersion: domain.EventSchemaV1,
OccurredAt: time.Now().UTC(),
}
postAccepted(t, srv.URL, deposit)

hb := domain.Event{
EventID: "schema-hb-" + suffix,
TenantID: "acme-casino",
PlayerID: deposit.PlayerID,
Type: domain.EventSessionHeartbeat,
SchemaVersion: domain.EventSchemaV1,
OccurredAt: time.Now().UTC(),
}
postAccepted(t, srv.URL, hb)
}

func postAccepted(t *testing.T, base string, evt domain.Event) {
t.Helper()
body, err := json.Marshal(evt)
if err != nil {
t.Fatalf("marshal: %v", err)
}
req, err := http.NewRequest(http.MethodPost, base+"/v1/events", bytes.NewReader(body))
if err != nil {
t.Fatalf("request: %v", err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-Signature", ingest.Sign("hmac_acme_dev_secret", body))
resp, err := http.DefaultClient.Do(req)
if err != nil {
t.Fatalf("do: %v", err)
}
defer func() { _ = resp.Body.Close() }()
if resp.StatusCode != http.StatusAccepted {
b, _ := io.ReadAll(resp.Body)
t.Fatalf("status=%d want 202 body=%s", resp.StatusCode, b)
}
}
14 changes: 8 additions & 6 deletions internal/domain/event.go
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,15 @@ const (
EventDeposit = "deposit"
EventBetPlaced = "bet_placed"
EventSessionHeartbeat = "session_heartbeat"
EventSchemaV1 = 1
)

type Event struct {
OccurredAt time.Time `json:"occurred_at"`
EventID string `json:"event_id"`
TenantID string `json:"tenant_id"`
PlayerID string `json:"player_id"`
Type string `json:"type"`
Amount int64 `json:"amount,omitempty"`
OccurredAt time.Time `json:"occurred_at"`
EventID string `json:"event_id"`
TenantID string `json:"tenant_id"`
PlayerID string `json:"player_id"`
Type string `json:"type"`
Amount int64 `json:"amount,omitempty"`
SchemaVersion int `json:"schema_version,omitempty"`
}
3 changes: 3 additions & 0 deletions internal/ingest/validate.go
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,9 @@ func ValidateEvent(evt domain.Event) error {
return fmt.Errorf("amount must be positive for %s", evt.Type)
}
}
if evt.SchemaVersion != 0 && evt.SchemaVersion != domain.EventSchemaV1 {
return fmt.Errorf("unsupported schema_version %d", evt.SchemaVersion)
}
return nil
}

Expand Down
52 changes: 52 additions & 0 deletions internal/ingest/validate_test.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
package ingest

import (
"strings"
"testing"
"time"

"github.com/o-mid/engagepulse/internal/domain"
)

func TestValidateEventAcceptsMissingAndV1Schema(t *testing.T) {
base := domain.Event{
EventID: "schema-ok",
TenantID: "acme-casino",
PlayerID: "p1",
Type: domain.EventDeposit,
Amount: 50,
OccurredAt: time.Now().UTC(),
}
if err := ValidateEvent(base); err != nil {
t.Fatalf("missing version: %v", err)
}
base.SchemaVersion = domain.EventSchemaV1
if err := ValidateEvent(base); err != nil {
t.Fatalf("v1: %v", err)
}
hb := base
hb.Type = domain.EventSessionHeartbeat
hb.Amount = 0
if err := ValidateEvent(hb); err != nil {
t.Fatalf("heartbeat: %v", err)
}
}

func TestValidateEventRejectsUnknownSchema(t *testing.T) {
evt := domain.Event{
EventID: "schema-bad",
TenantID: "acme-casino",
PlayerID: "p1",
Type: domain.EventDeposit,
Amount: 50,
SchemaVersion: 2,
OccurredAt: time.Now().UTC(),
}
err := ValidateEvent(evt)
if err == nil {
t.Fatal("expected error")
}
if !strings.Contains(err.Error(), "schema_version") {
t.Fatalf("err=%v", err)
}
}
7 changes: 7 additions & 0 deletions internal/rules/engine_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,13 @@ func TestApplyWelcome(t *testing.T) {
wantTag: false,
credit: 0,
},
{
name: "heartbeat",
evt: domain.Event{Type: domain.EventSessionHeartbeat, SchemaVersion: domain.EventSchemaV1},
st: store.PlayerState{},
wantTag: false,
credit: 0,
},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
Expand Down
Loading