Files
OwnCord/Server/ws/dm_handlers_test.go
T
J3vbandClaude 9eba6969d2 B1-5: ownership moves (RL-09 / L-09, RL-10 / L-10, RL-11 / L-11, RL-13 / L-12) (#1417)
* refactor: move the protocol schema to protocol/schema.json (RL-09)

The WebSocket message-type schema is the one artifact in this repository that
neither component owns: `Server/ws/message_types.go` and
`Client/src/lib/protocolTypes.ts` are both generated from it, and neither may
be hand-edited. It nonetheless lived at `docs/protocol-schema.json` — filed
under the directory for prose, whose own README calls it "Reference" material
— and its generator lived at `Server/scripts/genprotocol/`, i.e. inside one of
the two consumers. Ownership was legible from neither location.

The obvious fix — move the generator to the repository root alongside the
schema, so the whole tool is at the cross-component boundary — is wrong here.
The generator is a Go `package main`, and Go modules are directory-rooted:
`Server/go.mod` roots at `Server/`, so a root-level Go program needs a second
module or a `go.work`. That second module would sit outside every path filter
this repository already has — `golangci-lint` runs with `working-directory:
Server/` (ci.yml), `go vet ./...` runs from `Server/` (scripts/run.mjs,
.githooks/pre-commit), `.githooks/pre-commit` selects Go files with
`^Server/.*\.go$`, `.githooks/pre-push` sets `server_changed` on `^Server/`,
setup-go caches on `Server/go.sum`, and dependabot has one gomod block for
`/Server`. Six gates would silently stop covering the generator, each failing
open. The schema is data and moves freely; the generator is Go and stays where
the Go toolchain already runs.

Done instead:
- `docs/protocol-schema.json` -> `protocol/schema.json`. A new top-level
  `protocol/` is the cross-component boundary, with a `README.md` naming the
  two generated consumers, the one command, and the four gates.
- `Server/scripts/genprotocol/` -> `Server/cmd/genprotocol/`, the module's
  conventional home for an executable. This also empties `Server/scripts/` of
  Go entry points except `seed.go`, which RL-10 moves next.
- `Server/cmd/` added to `Server/.dockerignore` and `Server/.air.toml`, which
  both already excluded `Server/scripts/`. Without this the move would have
  silently widened the Docker build context and the air watch set.

27 files, 115 insertions, 76 deletions. Two runtime path resolvers re-pointed
(`cmd/genprotocol/main.go:41` `-schema` default, `ws/protocol_contract_test.go:67`
`filepath.Join`); two git-hook grep patterns (`pre-commit:53`, `pre-push:57`);
eight generator call sites across five files (Makefile x2, scripts/run.mjs x2,
pre-commit x2, ci-check skill, bughunt-fix.js); two broken relative markdown
links (docs/README.md:47, docs/protocol.md:1497); two generated files
regenerated, header lines only, zero constants changed; two ledger prose hits
plus a `render-ledger.mjs` re-render. No new verify was written: the
regenerate-and-diff check is already enforced three times (CI `make
protocol-verify`, `.githooks/pre-commit`, `npm run check:server`) and
`ws/protocol_contract_test.go` independently checks the schema against the
constants a fourth time.

Verified: both directions, for both resolvers. With `protocol/schema.json`
removed, `go test ./ws/ -run TestProtocol` fails with `reading protocol schema
at /home/user/OwnCord/protocol/schema.json: no such file or directory` (two
tests) and `go run ./cmd/genprotocol` exits 1 with `read schema: open
../protocol/schema.json: no such file or directory`; with the file restored
both pass. So the new path is genuinely resolved, not merely spelled in a
comment. The hook patterns were exercised directly: the pre-commit pattern
matches `protocol/schema.json` and `Server/cmd/genprotocol/main.go` and no
longer matches `docs/protocol-schema.json`; the pre-push pattern matches
`protocol/schema.json`. `go run ./cmd/genprotocol` twice in a row leaves
`git diff --exit-code ws/message_types.go ../Client/src/lib/protocolTypes.ts`
clean, so the committed outputs are exactly what the generator emits.
`go build ./...` and `go vet ./...` pass; `npx prettier --check .`,
`npm run typecheck` and `npm run lint` pass; `node .superpowers/render-ledger.mjs
--check` reports 348 findings valid.

Not included: the four dated `docs/audit-*.md` files, the older
`docs/plans/*`, and `CHANGELOG.md` keep the old path — they are point-in-time
records, and `.prettierignore` and `scripts/check-doc-counts.mjs` already
treat them as deliberately unmaintained. The B1 plan itself keeps its own
wording, since it states intent rather than current state. `Server/scripts/`
is not deleted: it still holds `seed.go` (RL-10), `k6/`, `toxiproxy/` and two
shell scripts. `Server/telemetry/metrics.go:19` declares a scope for a
`Server/voice` package that does not exist — spotted here, unrelated to this
move, left for RL-13's sweep to carry forward verbatim rather than fixed
inside a relocation. No `seed:` Make target was added.

Refs RL-09, L-09

* refactor: move the seed tool under Server/cmd/seed (RL-10)

`Server/scripts/seed.go` was a `package main` sitting directly in
`Server/scripts/`, which made `Server/scripts` itself one of the module's
three main packages — a developer tool in the module's build graph under a
directory name that says "loose scripts". It also did filesystem work in
`func init()`: `os.MkdirAll("data", 0o750)` ran before `flag.Parse()`, so the
directory appeared even when the tool immediately refused to run.

The audit row (RL-10) claims that `init()` fires "during test discovery". It
does not, and the obvious fix aimed at that claim would be aimed at nothing:
`Server/scripts/` contains zero `_test.go` files, so Go never builds a test
binary there and `go test ./...` never runs the `init()`. The residual defect
is narrower and real — an untagged `package main` in the build graph, plus a
side effect on a path (`go run ./cmd/seed -h`) that has nothing to do with
tests.

Done:
- `Server/scripts/seed.go` -> `Server/cmd/seed/main.go`, joining
  `cmd/genprotocol/` from RL-09. `Server/scripts/` now holds shell and JS
  tooling only (docker-smoke.sh, k6/, toxiproxy/, voice-test.sh) and no Go
  entry point at all.
- The `os.MkdirAll` moved out of `init()` to immediately before `db.Open` in
  `main()` — the one call that needs the directory, since `db.Open` ->
  `OpenWithMaxReaders` -> `openFile` creates no intermediate directories.
- The package doc comment's usage lines were wrong in two ways, not one: they
  named `go run scripts/seed.go`, which no longer exists, and they omitted
  the mandatory `-confirm-dev`, so neither documented command could ever have
  run. Both corrected, and `seed.go is a standalone tool` became the
  conventional `Command seed populates ...`.
- `Server/CLAUDE.md`'s Layout list now names `cmd/` and states that no Go
  entry point lives in `scripts/`.

Two files, 20 insertions, 17 deletions. `go list` main packages go from
`{server, server/cmd/genprotocol, server/scripts}` to `{server,
server/cmd/genprotocol, server/cmd/seed}` — the count is unchanged at three,
which is the honest framing: this relocates a main package to a conventional
path, it does not remove one from the build graph.

Verified: both directions, by building the pre-change file and the
post-change file and running each in a fresh empty directory. Before, `seed`
with no flags exits 1 *and leaves a `data/` directory behind*; `seed -h`
exits 0 and also leaves `data/` behind. After, both exit the same way and
create nothing — `data/ exists=NO` in each case. The happy path is unchanged:
`seed -confirm-dev` in an empty directory creates `data/` at mode 0750,
writes `data/chatserver.db`, and reports 4 users / 5 channels / 31 messages;
a second run reports 0 new rows, so idempotence survives. The old documented
invocation now fails loudly (`go run scripts/seed.go` -> `stat
scripts/seed.go: no such file or directory`) and the new one is what the
comment says. All four build-tag variants compile, `go vet ./...` passes,
`gofmt -l` is clean outside `db/dbgen`, and `npx prettier --check .` passes.

Behaviour delta, called out rather than left silent: the two cases above
(`-h`, and a missing `-confirm-dev`) no longer create `./data`. That is a
change, not a pure relocation. It is the change RL-10 asks for — the remedy
text is "remove import/test-time filesystem side effects" — and the
alternative that preserves the old behaviour exactly, making the `MkdirAll`
the first statement of `main()` before `flag.Parse()`, would keep precisely
the side effect the item exists to remove.

Not included: `Server/scripts/genprotocol` was moved to `Server/cmd/` by the
RL-09 commit rather than here, so the "executable tooling under conventional
command ownership" class is closed across the two commits, not this one
alone. `filepath.Dir(*dbPath)` was evaluated for the `MkdirAll` and rejected:
it would fix a real gap (`-db /elsewhere/x.db` still creates a useless
`./data` and does not create `/elsewhere`) but it means creating an arbitrary
directory from CLI input, and that is a behaviour change past "shift it out
of `init()`" — worth its own item. No `make seed` target was added, and the
dated `docs/audit-*.md` rows naming `Server/scripts/seed.go` keep the old
path. The findings ledger has zero references to this file, so no re-render
was needed.

Refs RL-10, L-10

* test: give the cross-stack contracts a named tier (RL-11)

`Client/tests/unit/admin-static-channel-perms.test.ts` reads and executes
`Server/admin/static/index.html`. Filed under `tests/unit`, nothing about its
location or name said it locks a server-owned artifact, so a Go developer
editing the admin SPA got a red check called "Client Unit Tests" with no clue
why.

The register describes this as one file. It is not, and the measured set does
not match the description in either direction:
- Client -> Server: exactly ONE test crosses by filesystem read, not two.
  `main-page.test.ts` was named in the plan but only carries a prose comment
  citing `Server/admin/update_handlers.go:181` at line 1046 — no read, no
  import, nothing to move.
- Server -> Client: the four tests the plan named do not cross.
  `waf_test.go`/`waf_crs_test.go` set a `User-Agent: OwnCordClient/1.0`
  literal that appears nowhere under `Client/`; `ws_integration_test.go:289`
  and `sanitize_content_fuzz_test.go:46` are comments. The real crossing is
  one the register never named: `Server/updater/updater_test.go:630` does
  `os.ReadFile` on `Client/src-tauri/tauri.conf.json`.

The obvious fixes are both wrong. Moving the invariant "to the owning server
test" cannot work: `Server/go.mod` carries no JavaScript engine (no goja,
otto, v8go, quickjs, rogchap, duktape), so a Go port could only assert at the
text level like `admin/perm_grid_test.go` does — and that is not a
substitute. Flipping the guard at `admin/static/index.html:1182` to
`targetIsTouchedRole=false` reintroduces OC-0154 in full while leaving every
greppable identifier intact, so a text-level test passes on a broken file.
Relocating it to the e2e admin journey is worse: that job is
`continue-on-error: true` and deliberately unpinned ("requiring it is
theatre" — `docs/plans/b0-dev-branch-protection.sh`), so it would convert a
blocking, pinned gate into one that is green regardless. And the journey does
not cover the invariant today: `grep -Eic "perm|access|role|override|matrix"`
over its 142 lines returns 0, so the "if e2e already covers it, delete"
branch never fires.

Done — one tier, applied to the whole set, defined by artifact coupling and
placed by runtime capability:
- New `Client/tests/contract/`, holding
  `server-admin-static-channel-perms.test.ts`. Same directory depth, so
  `../../../Server/...` still resolves; the body is byte-identical apart from
  a header naming the owner and the runner.
- `Server/updater/tauri_key_contract_test.go` splits the one cross-component
  Go test out of `updater_test.go` verbatim, same `package updater`. It stays
  in Go — placement follows capability, and Go parses JSON fine — so only the
  file name has to declare the crossing. Without this the item would have
  been "moved one file and declared the class closed".
- `npm run test:contract`, and the tier, the membership rule and a
  blocking/non-blocking table in `docs/contributing.md#testing`, which
  previously described no tiers at all.
- `Client/CLAUDE.md`'s tier list was missing `tests/e2e/admin` and
  `tests/e2e/native` before this; it now lists all seven and states the rule.
  `Server/CLAUDE.md` records why the SPA's execution-level invariant is
  locked from the client tree, so nobody "fixes" it into a regex.
- Ledger `OC-0154.fix.test` re-pointed and `FINDINGS.md` re-rendered;
  `.claude/workflows/bughunt.js` — the workflow that produced OC-0154 — no
  longer describes the TS test surface as `tests/unit/*.test.ts` only.
- Three stale cross-stack pointers of exactly the class this item is about:
  `tests/e2e/helpers.ts:348,351` and `tests/unit/types.test.ts:13` named
  `docs/brain/06-Specs/PROTOCOL.md`, which does not exist (`docs/brain/` is a
  gitignored path); all now name `docs/protocol.md`.

15 files, 125 insertions, 33 deletions. No CI job, workflow, vitest,
tsconfig, eslint, knip or stryker change, and no new pinned check —
`ci.yml`'s `npx vitest run --coverage` has no path filter and
`vitest.config.ts` includes `tests/**/*.test.ts`, so enforcement after the
move is bit-identical to enforcement before it. That is deliberate: `dev`
pins 11 contexts and a 12th is a branch-protection API write, not something a
PR can do, so any new job would be advisory until someone separately changed
repository settings — strictly less protection than today.

Verified: both directions, and the assertion was not weakened. Flipping
`admin/static/index.html:1182` to `const targetIsTouchedRole=false;` makes
the moved test fail (`AssertionError: expected 'DELETE' not to be 'DELETE'`);
`git checkout` of that file makes it pass again — so the invariant survived
the move intact rather than becoming a test that passes anywhere. The split
Go test's cross-boundary read is live too: with
`Client/src-tauri/tauri.conf.json` moved away, `go test ./updater/` fails
with `ReadFile(../../Client/src-tauri/tauri.conf.json): no such file or
directory` from `tauri_key_contract_test.go:20`, and passes once restored.
The full client suite is 192 files / 5257 tests passing, identical to the
count before the move; `npm run typecheck` passes, which proves
`tests/contract/` is inside the tsconfig graph and that `tests/types/jsdom.d.ts`
still resolves the moved test's `import { JSDOM }`. `npm run lint`,
`npx prettier --check .`, `go vet ./...` and `go test ./updater/` all pass.
`git grep "tests/unit/admin-static-channel-perms"` finds no survivor outside
the B1 plan itself.

Not included: nothing was deleted, because no e2e sibling covers OC-0154.
`Client/tests/types/jsdom.d.ts` was neither moved nor deleted — it is still
the only type source for the moved test's `jsdom` import. `capabilities-scope.test.ts`
and `tauri-conf-webview2-args.test.ts` read `src-tauri/` and stay in
`tests/unit`: `src-tauri` is inside the `Client` component, so they are not
contract tests, and the rule earns that rather than hand-waving it — moving
them would have forced repoints of ledger entry OC-0089 and
`docs/security.md:64` for no gain. Each gained a one-line header saying why.
`Server/admin/perm_grid_test.go` and `emoji_section_test.go` read their own
package's embedded asset and are unchanged; they are the text-level
complement to the execution-level test, not duplicates. No JS engine was
added to `go.mod`, no npm root was created under `Server/`, and no root-level
`tests/` tier was created — there is no runner for one and no way to make it
blocking from a PR. Separately noticed and NOT fixed here:
`docs/contributing.md:221` still says "All ten required checks" while
`docs/plans/b0-dev-branch-protection.sh` pins eleven since B1-3 added
`Repository Hygiene`, and `docs/plans/hp-0-scorecard-2026-08-25.md:109` is
stale the same way — that is the branch-protection item's to fix, not this
one's, and one register item per commit.

Refs RL-11, L-11

* refactor: rename the Go module to github.com/J3vb/OwnCord/Server (RL-13)

`Server/go.mod` declared `github.com/owncord/server` while the public
repository is `github.com/J3vb/OwnCord`. Nothing resolves that path — there is
no `owncord` GitHub org and no vanity-import host serving go-import metadata
for it — so every import line in the tree named a location that does not
exist. It compiles because a main module's own path is never fetched, which is
exactly why it went unnoticed.

The obvious fix — an AST-aware import rewriter (`gomvpkg`, `go mod edit`) —
is wrong here, and provably so. Six of the 722 occurrences are not imports at
all: `api/main_test.go:20` (a goleak `IgnoreTopFunction` pattern),
`telemetry/metrics.go:17-19` (three OTel instrumentation-scope names),
`invariants/syncutil_locks.go:73` (a diagnostic message), and
`invariants/syncutil_locks_test.go:56` (an import line inside a raw-string Go
fixture). An import rewriter touches none of them, and the compiler cannot
see any of them either.

Done as one scripted substitution over `git ls-files`, anchored on the full
`github.com/owncord/server` string. The anchor matters: `owncord-server` is a
different identifier — the OTel `service.name` (`config/config.go`,
`telemetry/telemetry_otel.go`) and the GHCR image name
(`.github/workflows/release.yml`, `docker-compose.yml`) — and a looser pattern
would have moved it. It is untouched: 10 occurrences across 9 files, before
and after.

350 files, 728 insertions, 728 deletions. 722 occurrences in 344 Go files,
plus `go.mod:1`, the `sed` at `Makefile:67`, `Server/CLAUDE.md:3`,
`docs/architecture/server.md:5`, and the ledger pair
(`findings-ledger.json:3758` plus a `render-ledger.mjs` re-render of
`FINDINGS.md`). Zero in any workflow, zero in the Dockerfile, zero in
`Server/.golangci.yml` (no `local-prefixes`, `gci`, `importas` or `depguard`
rule keys on the module path, so import grouping is not configured anywhere).

The plan's blast-radius estimate missed one thing, and it is the one that
would have gone red: **gofmt**. `J` (0x4A) sorts before every lowercase
letter, so in the 36 files where a module-local import shares a contiguous
group with a third-party one, the module's imports must move above
`github.com/go-chi/...`. `gofmt -l` was clean before the substitution and
listed exactly 36 files after it; `gofmt -w` on those 36 restores it to
clean. `gofmt` is an enforced gate — the `formatters` block in
`Server/.golangci.yml`, which is S-05 — so a substitution-only commit fails
Lint.

Verified: both directions, and the line accounting is exact. Every added line
in this diff contains the new module path (728) and every removed line
contains the old one (728); the count of changed lines containing neither is
**zero**, so the gofmt re-sort moved module-path lines only and touched no
third-party import. The residual check
(`git ls-files -z | xargs -0 grep -n 'github\.com/owncord/server'`) returns
exactly two hits, both deliberately out of scope: the RL-13 row in
`docs/audit-2026-08-23-repository-layout.md` and the measurement row in this
phase's own plan. The compiler-invisible half was proven by reverting *only*
`api/main_test.go:20` to the old path on the otherwise-renamed tree:
`go build ./...` and `go vet ./api/` both still pass — they see nothing wrong
— while `go test ./api/` FAILS, because the runtime function name now carries
the new path and goleak stops ignoring `ws.(*Hub).Run.func1`. Restoring the
line makes it pass. `go.sum` is byte-identical (no `go mod tidy` was run and
none was needed). All four build-tag variants compile; `go vet ./...`,
`go vet -tags otel,wazero ./...` and `go vet -tags deadlock ./...` pass;
`go test -race ./...` is 16/16 packages green; `go test -tags deadlock ./...`
passes; the tag-gated `./plugin/...` (wazero) and `./telemetry/...` (otel)
runs pass. `golangci-lint` v2.11.3 — the pinned CI version, rebuilt locally
against Go 1.26 because the packaged binary cannot load a 1.26 config —
reports **0 issues**. `go run ./cmd/genprotocol` leaves
`git diff --exit-code ws/message_types.go ../Client/src/lib/protocolTypes.ts`
clean, so the rename does not reach the generated protocol constants.
`npx prettier --check .` and `node .superpowers/render-ledger.mjs --check`
pass.

Not included: `docs/audit-2026-08-23-repository-layout.md` and
`docs/plans/b1-repository-foundation-2026-08-25.md` keep the old path — they
are the audit row and the measurement that motivated this change, and
rewriting them would erase the record of what was measured. They are why the
residual check needs a two-path allowance rather than being empty; that
allowance is stated above rather than hidden in a pathspec.
`telemetry/metrics.go:19` declares `scopeVoice` for a `Server/voice` package
that does not exist; the substitution carried the dead path forward verbatim
as `github.com/J3vb/OwnCord/Server/voice` rather than fixing it, because
correcting a real observability bug inside a mechanical rename would hide it
in a 350-file diff. It needs its own item. No `go.work`, no second module,
and no vanity-import host was set up — the new path resolves against the real
repository, but nothing imports this module as a library, so `go get`
reachability was not exercised either way.

Refs RL-13, L-12

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-08-27 07:11:18 +02:00

721 lines
24 KiB
Go

package ws_test
import (
"context"
"encoding/json"
"fmt"
"testing"
"time"
"github.com/J3vb/OwnCord/Server/db"
"github.com/J3vb/OwnCord/Server/ws"
)
// ─── DM test helpers ────────────────────────────────────────────────────────
// seedDMChannel creates a DM channel between two users and returns the channel ID.
func seedDMChannel(t *testing.T, database *db.DB, user1ID, user2ID int64) int64 {
t.Helper()
ch, _, err := database.GetOrCreateDMChannel(context.Background(), user1ID, user2ID)
if err != nil {
t.Fatalf("seedDMChannel: %v", err)
}
return ch.ID
}
// dmChatSendMsg constructs a raw chat_send WebSocket envelope for a DM channel.
func dmChatSendMsg(channelID int64, content string) []byte {
raw, _ := json.Marshal(map[string]any{
"type": "chat_send",
"payload": map[string]any{
"channel_id": channelID,
"content": content,
},
})
return raw
}
// dmChatEditMsg constructs a raw chat_edit WebSocket envelope.
func dmChatEditMsg(msgID int64, content string) []byte {
raw, _ := json.Marshal(map[string]any{
"type": "chat_edit",
"payload": map[string]any{
"message_id": msgID,
"content": content,
},
})
return raw
}
// dmChatDeleteMsg constructs a raw chat_delete WebSocket envelope.
func dmChatDeleteMsg(msgID int64) []byte {
raw, _ := json.Marshal(map[string]any{
"type": "chat_delete",
"payload": map[string]any{
"message_id": msgID,
},
})
return raw
}
// dmTypingMsg constructs a raw typing_start WebSocket envelope.
func dmTypingMsg(channelID int64) []byte {
raw, _ := json.Marshal(map[string]any{
"type": "typing_start",
"payload": map[string]any{
"channel_id": channelID,
},
})
return raw
}
// dmChannelFocusMsg constructs a raw channel_focus WebSocket envelope.
func dmChannelFocusMsg(channelID int64) []byte {
raw, _ := json.Marshal(map[string]any{
"type": "channel_focus",
"payload": map[string]any{
"channel_id": channelID,
},
})
return raw
}
// dmReactionAddMsg constructs a raw reaction_add WebSocket envelope.
func dmReactionAddMsg(msgID int64, emoji string) []byte {
raw, _ := json.Marshal(map[string]any{
"type": "reaction_add",
"payload": map[string]any{
"message_id": msgID,
"emoji": emoji,
},
})
return raw
}
// dmReactionRemoveMsg constructs a raw reaction_remove WebSocket envelope.
func dmReactionRemoveMsg(msgID int64, emoji string) []byte {
raw, _ := json.Marshal(map[string]any{
"type": "reaction_remove",
"payload": map[string]any{
"message_id": msgID,
"emoji": emoji,
},
})
return raw
}
// dmDrainAll non-blocking drains all messages currently in the channel buffer.
func dmDrainAll(ch <-chan []byte) []map[string]any {
var result []map[string]any
for {
select {
case raw := <-ch:
var env map[string]any
if err := json.Unmarshal(raw, &env); err == nil {
result = append(result, env)
}
default:
return result
}
}
}
// dmWaitMsgType blocks until a message with the given type arrives on ch,
// returning its envelope, or returns nil when the timeout expires.
func dmWaitMsgType(ch <-chan []byte, msgType string, timeout time.Duration) map[string]any {
timer := time.NewTimer(timeout)
defer timer.Stop()
for {
select {
case raw := <-ch:
var env map[string]any
if err := json.Unmarshal(raw, &env); err != nil {
continue
}
if env["type"] == msgType {
return env
}
case <-timer.C:
return nil
}
}
}
// dmCollectAll reads messages for the full window d and returns the decoded
// envelopes. Use for absence assertions — the window always elapses.
func dmCollectAll(ch <-chan []byte, d time.Duration) []map[string]any {
var result []map[string]any
timer := time.NewTimer(d)
defer timer.Stop()
for {
select {
case raw := <-ch:
var env map[string]any
if err := json.Unmarshal(raw, &env); err == nil {
result = append(result, env)
}
case <-timer.C:
return result
}
}
}
// dmFindMsgType returns the first message of the given type from a slice of envelopes.
func dmFindMsgType(msgs []map[string]any, msgType string) map[string]any {
for _, m := range msgs {
if m["type"] == msgType {
return m
}
}
return nil
}
// dmFindErrorCode returns the error code from the first error message, or "".
func dmFindErrorCode(msgs []map[string]any) string {
for _, m := range msgs {
if m["type"] == "error" {
if payload, ok := m["payload"].(map[string]any); ok {
code, _ := payload["code"].(string)
return code
}
}
}
return ""
}
// ─── chat_send DM branch ───────────────────────────────────────────────────
func TestDM_ChatSend_ParticipantSuccess(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-send-alice")
bob := seedMemberUser(t, database, "dm-send-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
sendAlice := make(chan []byte, 64)
sendBob := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
cBob := ws.NewTestClientWithUser(hub, bob, dmChID, sendBob)
hub.Register(cAlice)
hub.Register(cBob)
waitRegistered(t, hub, cBob)
hub.HandleMessageForTest(cAlice, dmChatSendMsg(dmChID, "hello bob"))
// Alice should get chat_send_ok ack.
if dmWaitMsgType(sendAlice, "chat_send_ok", waitTimeout) == nil {
t.Error("Alice did not receive chat_send_ok")
}
// Bob should get a chat_message via SendToUser.
if dmWaitMsgType(sendBob, "chat_message", waitTimeout) == nil {
t.Error("Bob did not receive chat_message")
}
}
func TestDM_ChatSend_SequencedAndReplayBuffered(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-seq-alice")
bob := seedMemberUser(t, database, "dm-seq-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
sendAlice := make(chan []byte, 128)
sendBob := make(chan []byte, 128)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
cBob := ws.NewTestClientWithUser(hub, bob, dmChID, sendBob)
hub.Register(cAlice)
hub.Register(cBob)
waitRegistered(t, hub, cBob)
hub.HandleMessageForTest(cAlice, dmChatSendMsg(dmChID, "m1"))
hub.HandleMessageForTest(cAlice, dmChatSendMsg(dmChID, "m2"))
hub.HandleMessageForTest(cAlice, dmChatSendMsg(dmChID, "m3"))
chat := dmWaitMsgType(sendBob, "chat_message", waitTimeout)
if chat == nil {
t.Fatal("Bob did not receive any DM chat_message")
}
if _, ok := chat["seq"]; !ok {
t.Fatal("DM chat_message is missing seq")
}
oldest := hub.ReplayBuffer().OldestSeq()
if oldest == 0 {
t.Fatal("replay buffer did not record DM events (oldest seq is 0)")
}
replayed := hub.ReplayBuffer().EventsSinceFiltered(oldest+1, map[int64]bool{dmChID: true})
if len(replayed) == 0 {
t.Fatal("expected DM replay events after oldest+1, got none")
}
}
func TestDM_ChatSend_NonParticipantForbidden(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-forbid-alice")
bob := seedMemberUser(t, database, "dm-forbid-bob")
charlie := seedMemberUser(t, database, "dm-forbid-charlie")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
sendCharlie := make(chan []byte, 64)
cCharlie := ws.NewTestClientWithUser(hub, charlie, 0, sendCharlie)
hub.Register(cCharlie)
waitRegistered(t, hub, cCharlie)
hub.HandleMessageForTest(cCharlie, dmChatSendMsg(dmChID, "intruder"))
// Error replies are sent synchronously by handleMessage — already buffered.
msgs := dmDrainAll(sendCharlie)
code := dmFindErrorCode(msgs)
if code != "FORBIDDEN" {
t.Errorf("non-participant chat_send: error code = %q, want FORBIDDEN", code)
}
}
func TestDM_ChatSend_AutoReopenForRecipient(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-reopen-alice")
bob := seedMemberUser(t, database, "dm-reopen-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
// Bob closes the DM.
if err := database.CloseDM(context.Background(), bob.ID, dmChID); err != nil {
t.Fatalf("CloseDM: %v", err)
}
sendAlice := make(chan []byte, 64)
sendBob := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
cBob := ws.NewTestClientWithUser(hub, bob, 0, sendBob)
hub.Register(cAlice)
hub.Register(cBob)
waitRegistered(t, hub, cBob)
// Alice sends a message — should auto-reopen for Bob.
hub.HandleMessageForTest(cAlice, dmChatSendMsg(dmChID, "hey bob"))
// Bob should receive both a dm_channel_open and the chat_message.
if dmWaitMsgType(sendBob, "dm_channel_open", waitTimeout) == nil {
t.Error("Bob did not receive dm_channel_open on auto-reopen")
}
if dmWaitMsgType(sendBob, "chat_message", waitTimeout) == nil {
t.Error("Bob did not receive chat_message after auto-reopen")
}
}
// ─── chat_edit DM branch ────────────────────────────────────────────────────
func TestDM_ChatEdit_ParticipantCanEdit(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-edit-alice")
bob := seedMemberUser(t, database, "dm-edit-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
// Create a message directly in the DB.
msgID, err := database.CreateMessage(context.Background(), dmChID, alice.ID, "original", nil)
if err != nil {
t.Fatalf("CreateMessage: %v", err)
}
sendAlice := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
hub.Register(cAlice)
waitRegistered(t, hub, cAlice)
hub.HandleMessageForTest(cAlice, dmChatEditMsg(msgID, "edited"))
// Alice should receive the chat_edited broadcast (via the sequenced DM event path).
if dmWaitMsgType(sendAlice, "chat_edited", waitTimeout) == nil {
t.Error("participant did not receive chat_edited for DM")
}
}
func TestDM_ChatEdit_NonParticipantForbidden(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-editforbid-alice")
bob := seedMemberUser(t, database, "dm-editforbid-bob")
charlie := seedMemberUser(t, database, "dm-editforbid-charlie")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
// Alice creates a message.
msgID, err := database.CreateMessage(context.Background(), dmChID, alice.ID, "private", nil)
if err != nil {
t.Fatalf("CreateMessage: %v", err)
}
sendCharlie := make(chan []byte, 64)
cCharlie := ws.NewTestClientWithUser(hub, charlie, 0, sendCharlie)
hub.Register(cCharlie)
waitRegistered(t, hub, cCharlie)
hub.HandleMessageForTest(cCharlie, dmChatEditMsg(msgID, "hacked"))
// Error replies are sent synchronously by handleMessage — already buffered.
msgs := dmDrainAll(sendCharlie)
code := dmFindErrorCode(msgs)
if code != "FORBIDDEN" {
t.Errorf("non-participant chat_edit: error code = %q, want FORBIDDEN", code)
}
}
// ─── chat_delete DM branch ──────────────────────────────────────────────────
func TestDM_ChatDelete_ParticipantCanDeleteOwn(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-del-alice")
bob := seedMemberUser(t, database, "dm-del-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
msgID, err := database.CreateMessage(context.Background(), dmChID, alice.ID, "to delete", nil)
if err != nil {
t.Fatalf("CreateMessage: %v", err)
}
sendAlice := make(chan []byte, 64)
sendBob := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
cBob := ws.NewTestClientWithUser(hub, bob, dmChID, sendBob)
hub.Register(cAlice)
hub.Register(cBob)
waitRegistered(t, hub, cBob)
hub.HandleMessageForTest(cAlice, dmChatDeleteMsg(msgID))
// Both participants should receive chat_deleted.
if dmWaitMsgType(sendAlice, "chat_deleted", waitTimeout) == nil {
t.Error("Alice did not receive chat_deleted")
}
if dmWaitMsgType(sendBob, "chat_deleted", waitTimeout) == nil {
t.Error("Bob did not receive chat_deleted")
}
}
func TestDM_ChatDelete_NonParticipantForbidden(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-delforbid-alice")
bob := seedMemberUser(t, database, "dm-delforbid-bob")
charlie := seedMemberUser(t, database, "dm-delforbid-charlie")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
msgID, err := database.CreateMessage(context.Background(), dmChID, alice.ID, "protected", nil)
if err != nil {
t.Fatalf("CreateMessage: %v", err)
}
sendCharlie := make(chan []byte, 64)
cCharlie := ws.NewTestClientWithUser(hub, charlie, 0, sendCharlie)
hub.Register(cCharlie)
waitRegistered(t, hub, cCharlie)
hub.HandleMessageForTest(cCharlie, dmChatDeleteMsg(msgID))
// Error replies are sent synchronously by handleMessage — already buffered.
msgs := dmDrainAll(sendCharlie)
code := dmFindErrorCode(msgs)
if code != "FORBIDDEN" {
t.Errorf("non-participant chat_delete: error code = %q, want FORBIDDEN", code)
}
}
func TestDM_ChatDelete_NoModeratorOverride(t *testing.T) {
hub, database := newHandlerHub(t)
// Even a moderator/owner cannot delete another user's message in a DM.
alice := seedOwnerUser(t, database, "dm-nomod-alice")
bob := seedMemberUser(t, database, "dm-nomod-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
// Bob's message.
msgID, err := database.CreateMessage(context.Background(), dmChID, bob.ID, "bob says hi", nil)
if err != nil {
t.Fatalf("CreateMessage: %v", err)
}
sendAlice := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
hub.Register(cAlice)
waitRegistered(t, hub, cAlice)
// Alice (Owner role) tries to delete Bob's message — should fail because
// DMs disable moderator override.
hub.HandleMessageForTest(cAlice, dmChatDeleteMsg(msgID))
// Error replies are sent synchronously by handleMessage — already buffered.
msgs := dmDrainAll(sendAlice)
code := dmFindErrorCode(msgs)
if code != "FORBIDDEN" {
t.Errorf("DM mod override: error code = %q, want FORBIDDEN (no mod override in DMs)", code)
}
}
// ─── typing DM branch ──────────────────────────────────────────────────────
func TestDM_Typing_ParticipantBroadcasts(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-type-alice")
bob := seedMemberUser(t, database, "dm-type-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
sendAlice := make(chan []byte, 64)
sendBob := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
cBob := ws.NewTestClientWithUser(hub, bob, dmChID, sendBob)
hub.Register(cAlice)
hub.Register(cBob)
waitRegistered(t, hub, cBob)
hub.HandleMessageForTest(cAlice, dmTypingMsg(dmChID))
// Bob should receive typing broadcast (type is "typing", not "typing_start").
if dmWaitMsgType(sendBob, "typing", waitTimeout) == nil {
t.Error("Bob did not receive typing in DM")
}
}
func TestDM_Typing_NonParticipantSilentlyDropped(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-typedrop-alice")
bob := seedMemberUser(t, database, "dm-typedrop-bob")
charlie := seedMemberUser(t, database, "dm-typedrop-charlie")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
sendCharlie := make(chan []byte, 64)
sendAlice := make(chan []byte, 64)
sendBob := make(chan []byte, 64)
cCharlie := ws.NewTestClientWithUser(hub, charlie, 0, sendCharlie)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
cBob := ws.NewTestClientWithUser(hub, bob, dmChID, sendBob)
hub.Register(cCharlie)
hub.Register(cAlice)
hub.Register(cBob)
waitRegistered(t, hub, cBob)
hub.HandleMessageForTest(cCharlie, dmTypingMsg(dmChID))
// Alice and Bob should NOT receive typing from Charlie. The bounded window
// on Alice's channel doubles as the settle time for Bob's (a wrongly routed
// typing broadcast would be fanned out to both in the same delivery pass).
aliceMsgs := dmCollectAll(sendAlice, 100*time.Millisecond)
if dmFindMsgType(aliceMsgs, "typing") != nil {
t.Error("Alice received typing from non-participant Charlie")
}
bobMsgs := dmDrainAll(sendBob)
if dmFindMsgType(bobMsgs, "typing") != nil {
t.Error("Bob received typing from non-participant Charlie")
}
// Charlie should NOT receive an error — typing from non-participants is
// silently dropped (error replies would have been sent synchronously).
charlieMsgs := dmDrainAll(sendCharlie)
if code := dmFindErrorCode(charlieMsgs); code != "" {
t.Errorf("non-participant typing should be silently dropped, got error: %s", code)
}
}
// ─── channel_focus DM branch ────────────────────────────────────────────────
func TestDM_ChannelFocus_ParticipantAllowed(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-focus-alice")
bob := seedMemberUser(t, database, "dm-focus-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
sendAlice := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, 0, sendAlice)
hub.Register(cAlice)
waitRegistered(t, hub, cAlice)
hub.HandleMessageForTest(cAlice, dmChannelFocusMsg(dmChID))
// No error should be sent (error replies are synchronous — already buffered).
msgs := dmDrainAll(sendAlice)
if code := dmFindErrorCode(msgs); code != "" {
t.Errorf("participant channel_focus got error: %s", code)
}
}
func TestDM_ChannelFocus_NonParticipantRejected(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-focusforbid-alice")
bob := seedMemberUser(t, database, "dm-focusforbid-bob")
charlie := seedMemberUser(t, database, "dm-focusforbid-charlie")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
sendCharlie := make(chan []byte, 64)
cCharlie := ws.NewTestClientWithUser(hub, charlie, 0, sendCharlie)
hub.Register(cCharlie)
waitRegistered(t, hub, cCharlie)
hub.HandleMessageForTest(cCharlie, dmChannelFocusMsg(dmChID))
// Error replies are sent synchronously by handleMessage — already buffered.
msgs := dmDrainAll(sendCharlie)
code := dmFindErrorCode(msgs)
if code != "FORBIDDEN" {
t.Errorf("non-participant channel_focus: error code = %q, want FORBIDDEN", code)
}
}
// ─── reaction DM branch ────────────────────────────────────────────────────
func TestDM_ReactionAdd_ParticipantSuccess(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-react-alice")
bob := seedMemberUser(t, database, "dm-react-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
msgID, err := database.CreateMessage(context.Background(), dmChID, alice.ID, "react to me", nil)
if err != nil {
t.Fatalf("CreateMessage: %v", err)
}
sendAlice := make(chan []byte, 64)
sendBob := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
cBob := ws.NewTestClientWithUser(hub, bob, dmChID, sendBob)
hub.Register(cAlice)
hub.Register(cBob)
waitRegistered(t, hub, cBob)
hub.HandleMessageForTest(cBob, dmReactionAddMsg(msgID, "👍"))
// Both participants should get reaction_update broadcast.
if dmWaitMsgType(sendAlice, "reaction_update", waitTimeout) == nil {
t.Error("Alice did not receive reaction_update in DM")
}
if dmWaitMsgType(sendBob, "reaction_update", waitTimeout) == nil {
t.Error("Bob did not receive reaction_update in DM")
}
}
func TestDM_ReactionAdd_NonParticipantError(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-reactforbid-alice")
bob := seedMemberUser(t, database, "dm-reactforbid-bob")
charlie := seedMemberUser(t, database, "dm-reactforbid-charlie")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
msgID, err := database.CreateMessage(context.Background(), dmChID, alice.ID, "private msg", nil)
if err != nil {
t.Fatalf("CreateMessage: %v", err)
}
sendCharlie := make(chan []byte, 64)
cCharlie := ws.NewTestClientWithUser(hub, charlie, 0, sendCharlie)
hub.Register(cCharlie)
waitRegistered(t, hub, cCharlie)
hub.HandleMessageForTest(cCharlie, dmReactionAddMsg(msgID, "👎"))
// Error replies are sent synchronously by handleMessage — already buffered.
msgs := dmDrainAll(sendCharlie)
code := dmFindErrorCode(msgs)
// Non-participant reaction returns BAD_REQUEST (normalized to prevent IDOR info leak).
if code != "BAD_REQUEST" {
t.Errorf("non-participant reaction: error code = %q, want BAD_REQUEST", code)
}
}
func TestDM_ReactionRemove_ParticipantSuccess(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-reactrm-alice")
bob := seedMemberUser(t, database, "dm-reactrm-bob")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
msgID, err := database.CreateMessage(context.Background(), dmChID, bob.ID, "remove reaction", nil)
if err != nil {
t.Fatalf("CreateMessage: %v", err)
}
sendBob := make(chan []byte, 64)
cBob := ws.NewTestClientWithUser(hub, bob, dmChID, sendBob)
hub.Register(cBob)
waitRegistered(t, hub, cBob)
// Add a reaction first and consume its reaction_update broadcast.
hub.HandleMessageForTest(cBob, dmReactionAddMsg(msgID, "🔥"))
if dmWaitMsgType(sendBob, "reaction_update", waitTimeout) == nil {
t.Fatal("participant did not receive reaction_update (add) in DM")
}
// Remove the reaction.
hub.HandleMessageForTest(cBob, dmReactionRemoveMsg(msgID, "🔥"))
if dmWaitMsgType(sendBob, "reaction_update", waitTimeout) == nil {
t.Error("participant did not receive reaction_update (remove) in DM")
}
}
// ─── DM message delivery uses SendToUser, not BroadcastToChannel ────────────
func TestDM_ChatSend_DeliveredViaSendToUser(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-delivery-alice")
bob := seedMemberUser(t, database, "dm-delivery-bob")
charlie := seedMemberUser(t, database, "dm-delivery-charlie")
dmChID := seedDMChannel(t, database, alice.ID, bob.ID)
sendAlice := make(chan []byte, 64)
sendBob := make(chan []byte, 64)
sendCharlie := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, dmChID, sendAlice)
cBob := ws.NewTestClientWithUser(hub, bob, dmChID, sendBob)
// Charlie is focused on the same channel ID (shouldn't get DM messages).
cCharlie := ws.NewTestClientWithUser(hub, charlie, dmChID, sendCharlie)
hub.Register(cAlice)
hub.Register(cBob)
hub.Register(cCharlie)
waitRegistered(t, hub, cCharlie)
hub.HandleMessageForTest(cAlice, dmChatSendMsg(dmChID, "private to bob"))
// Bob SHOULD receive it.
if dmWaitMsgType(sendBob, "chat_message", waitTimeout) == nil {
t.Error("Bob did not receive DM chat_message")
}
// Charlie should NOT receive the DM message — bounded absence window after
// Bob's copy has already been delivered.
charlieMsgs := dmCollectAll(sendCharlie, 50*time.Millisecond)
if dmFindMsgType(charlieMsgs, "chat_message") != nil {
t.Error("Charlie (non-participant) received DM chat_message — should be delivered only via SendToUser")
}
}
// ─── Multiple DM channels isolation ─────────────────────────────────────────
func TestDM_MultipleChannels_IsolatedDelivery(t *testing.T) {
hub, database := newHandlerHub(t)
alice := seedOwnerUser(t, database, "dm-iso-alice")
bob := seedMemberUser(t, database, "dm-iso-bob")
charlie := seedMemberUser(t, database, "dm-iso-charlie")
dmAB := seedDMChannel(t, database, alice.ID, bob.ID)
dmAC := seedDMChannel(t, database, alice.ID, charlie.ID)
_ = dmAC // charlie's DM is separate
sendAlice := make(chan []byte, 64)
sendBob := make(chan []byte, 64)
sendCharlie := make(chan []byte, 64)
cAlice := ws.NewTestClientWithUser(hub, alice, dmAB, sendAlice)
cBob := ws.NewTestClientWithUser(hub, bob, dmAB, sendBob)
cCharlie := ws.NewTestClientWithUser(hub, charlie, dmAC, sendCharlie)
hub.Register(cAlice)
hub.Register(cBob)
hub.Register(cCharlie)
waitRegistered(t, hub, cCharlie)
// Alice sends to Alice-Bob DM.
hub.HandleMessageForTest(cAlice, dmChatSendMsg(dmAB, fmt.Sprintf("only for bob %d", dmAB)))
// Bob's copy arriving proves delivery completed; then Charlie gets a
// bounded absence window.
if dmWaitMsgType(sendBob, "chat_message", waitTimeout) == nil {
t.Fatal("Bob did not receive the Alice-Bob DM message")
}
// Charlie should NOT get this message.
charlieMsgs := dmCollectAll(sendCharlie, 50*time.Millisecond)
if dmFindMsgType(charlieMsgs, "chat_message") != nil {
t.Error("Charlie received message from Alice-Bob DM")
}
}