matchmaking

type Attr map[string]any

type FirstN struct {
	N int
}

type Match struct {
	Members []Member
	Solo    bool
}

type Matcher interface {
	Match(candidates []Member) []Member
}

type MatcherFunc func(candidates []Member) []Member

type Member struct {
	ID       MemberID
	Attrs    Attr
	Enqueued time.Time
}

type MemberID string

type Pool struct {
	// contains filtered or unexported fields
}

type PoolConfig struct {
	// Name is an optional label used in logs / metrics.
	Name string

	// GroupSize is the exact party size produced by a full match. The
	// Matcher is expected to return slices of this length.
	GroupSize int

	// Matcher decides who pairs with whom. Required.
	Matcher Matcher

	// SoloFallback is the duration after which a queued member is emitted
	// as a Match with Solo=true. Zero disables solo fallback.
	SoloFallback time.Duration

	// TickInterval controls how often Run scans for matches. Defaults to
	// 100ms if unset.
	TickInterval time.Duration

	// Clock supplies the current time; defaults to time.Now if nil.
	Clock func() time.Time
}

type SameAttribute struct {
	N       int
	AttrKey string
}