Ilia Denisov
74 lines
3.0 KiB
Go
74 lines
3.0 KiB
Go
package ports
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
)
|
|
|
|
// ErrUserServiceUnavailable is returned by UserService implementations when
|
|
// the upstream User Service is unreachable, returns an unexpected status,
|
|
// or violates the contract in a way that callers must surface as
|
|
// service_unavailable. Service-layer code wraps it with the
|
|
// shared.ErrServiceUnavailable sentinel before bubbling up to transport.
|
|
var ErrUserServiceUnavailable = errors.New("user service unavailable")
|
|
|
|
// Eligibility stores the lobby-relevant subset of the User Service
|
|
// eligibility snapshot. only consumes Exists and CanJoinGame; the
|
|
// remaining fields are pre-plumbed for (race name registration)
|
|
// so that adding consumers later does not churn the port surface.
|
|
type Eligibility struct {
|
|
// Exists reports whether userID currently identifies a stored user.
|
|
// false maps to subject_not_found at the service layer.
|
|
Exists bool
|
|
|
|
// CanLogin reports whether the user may currently log in.
|
|
CanLogin bool
|
|
|
|
// CanCreatePrivateGame reports whether the user may currently create
|
|
// a private game.
|
|
CanCreatePrivateGame bool
|
|
|
|
// CanManagePrivateGame reports whether the user may currently manage
|
|
// a private game they own.
|
|
CanManagePrivateGame bool
|
|
|
|
// CanJoinGame reports whether the user may currently join a game
|
|
// (submit application or redeem invite). false surfaces as
|
|
// eligibility_denied for the
|
|
CanJoinGame bool
|
|
|
|
// CanUpdateProfile reports whether the user may currently update
|
|
// self-service profile and settings fields.
|
|
CanUpdateProfile bool
|
|
|
|
// PermanentBlocked reports whether the user carries an active
|
|
// permanent_block sanction. rejects the
|
|
// `lobby.race_name.register` call with `shared.ErrForbidden` ⇒
|
|
// HTTP `403 forbidden`; the dedicated `race_name_permanent_blocked`
|
|
// envelope code is reserved for the cascade flows. Stage
|
|
// 11 currently surfaces it indirectly through CanJoinGame=false
|
|
// (collapses every can_* marker to false on
|
|
// permanent_block).
|
|
PermanentBlocked bool
|
|
|
|
// MaxRegisteredRaceNames stores the snapshot value for the
|
|
// max_registered_race_names limit. A value of 0 denotes unlimited
|
|
// per the lifetime tariff. The race-name registration service
|
|
// enforces the quota; this port only carries the value through.
|
|
MaxRegisteredRaceNames int
|
|
}
|
|
|
|
//go:generate go run go.uber.org/mock/mockgen -destination=../adapters/mocks/mock_userservice.go -package=mocks galaxy/lobby/internal/ports UserService
|
|
|
|
// UserService is the synchronous lobby-facing User Service eligibility
|
|
// reader. The application flow consumes it via a single
|
|
// GetEligibility call before accepting an applicant.
|
|
type UserService interface {
|
|
// GetEligibility returns the lobby-relevant eligibility snapshot for
|
|
// userID. It returns Eligibility{Exists:false} for unknown users
|
|
// without an error so callers can distinguish missing users from
|
|
// transport failures. Transport, decode, and unexpected status code
|
|
// failures wrap ErrUserServiceUnavailable.
|
|
GetEligibility(ctx context.Context, userID string) (Eligibility, error)
|
|
}
|