Ilia Denisov
635f2fd9fc
- #3 nudge-on-own-turn: distinct result code nudge_own_turn + i18n (was reused 'not_your_turn') - #2 sanitize connector registration name to the editable format; Player/Игрок-XXXXX fallback - #5 variant-aware robot name pools (composed full/colloquial first + surname forms; ru gets <=20% latin) - #4 move-number-aware robot move timing (early 1-5min -> late 10-90min, skew k=4) - #7 emit move event to the actor too (multi-device sync); opponent_moved stays in-app only - #1 live game_move_duration{variant,phase} histogram + admin console per-user min/avg/max columns and an inline-SVG move-time-by-move-number chart (offline from the journal) - ProvisionRobot bypasses editor name validation (system names like 'Peter J.')
70 lines
3.1 KiB
Go
70 lines
3.1 KiB
Go
// Package lobby forms games: an in-memory matchmaking pool that pairs two humans
|
|
// for an auto-match, and friend-game invitations (invite -> accept) that start a
|
|
// 2-4 player game once every invitee has accepted. Both produce a game through the
|
|
// game domain (a GameCreator); neither imports the engine. The matchmaking pool
|
|
// is in-memory and lost on restart (players re-queue); the robot that substitutes
|
|
// for a missing human after a short wait is added in a later stage.
|
|
package lobby
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
|
|
"github.com/google/uuid"
|
|
|
|
"scrabble/backend/internal/engine"
|
|
"scrabble/backend/internal/game"
|
|
)
|
|
|
|
// GameCreator is the slice of the game domain the lobby needs: starting a seated
|
|
// game. game.Service satisfies it.
|
|
type GameCreator interface {
|
|
Create(ctx context.Context, params game.CreateParams) (game.Game, error)
|
|
}
|
|
|
|
// RobotProvider supplies a robot account to substitute for a missing human in
|
|
// auto-match. robot.Service satisfies it; it returns an error when no robot is
|
|
// available so the matchmaker can defer substitution.
|
|
type RobotProvider interface {
|
|
Pick(variant engine.Variant) (uuid.UUID, error)
|
|
}
|
|
|
|
// Blocker reports whether two accounts have a block between them (either
|
|
// direction). social.Service satisfies it; the lobby uses it to refuse
|
|
// invitations between blocked accounts.
|
|
type Blocker interface {
|
|
IsBlocked(ctx context.Context, a, b uuid.UUID) (bool, error)
|
|
}
|
|
|
|
// Auto-match defaults: a casual two-player game on the longest move clock with one
|
|
// hint per player (docs/ARCHITECTURE.md §6). The drop-out tile disposition is moot
|
|
// for two players, so the engine default (remove) applies.
|
|
const (
|
|
autoMatchHintsAllowed = true
|
|
autoMatchHintsPerPlayer = 1
|
|
)
|
|
|
|
// Sentinel errors returned by the lobby.
|
|
var (
|
|
// ErrAlreadyQueued is returned when an account already waits in a pool.
|
|
ErrAlreadyQueued = errors.New("lobby: account already in the matchmaking pool")
|
|
// ErrInvalidInvitation is returned for a malformed invitation (bad player
|
|
// count, duplicate or self invitee, or unacceptable settings).
|
|
ErrInvalidInvitation = errors.New("lobby: invalid invitation")
|
|
// ErrInvitationBlocked is returned when a block stands between the inviter and
|
|
// an invitee.
|
|
ErrInvitationBlocked = errors.New("lobby: invitation blocked between accounts")
|
|
// ErrInvitationNotFound is returned when no invitation matches the lookup.
|
|
ErrInvitationNotFound = errors.New("lobby: invitation not found")
|
|
// ErrInvitationNotPending is returned when an invitation is no longer open.
|
|
ErrInvitationNotPending = errors.New("lobby: invitation is not pending")
|
|
// ErrInvitationExpired is returned when an invitation has passed its deadline.
|
|
ErrInvitationExpired = errors.New("lobby: invitation has expired")
|
|
// ErrNotInvited is returned when an account is not an invitee of the invitation.
|
|
ErrNotInvited = errors.New("lobby: account was not invited")
|
|
// ErrAlreadyResponded is returned when an invitee has already accepted or declined.
|
|
ErrAlreadyResponded = errors.New("lobby: invitee has already responded")
|
|
// ErrNotInviter is returned when a non-inviter tries to cancel an invitation.
|
|
ErrNotInviter = errors.New("lobby: only the inviter may cancel")
|
|
)
|