SendouQ · Modules

1 module · 8 exports · 2 repositories · 16 e2e tests · 9 routes

OverviewModulesRepositoriesPermissionsSearch params & storageE2E tests

Who imports who · hover a node

SendouQ

serverapp/features/sendouq/core/SendouQ.server.ts

No overview comment at the top of the file.

Imports

SeasonsSendouQMatch

Used by

5 loaders6 actions1 route2 modules1 component2 routines7 other

Types

type

SQUncensoredGroup

no JSDoc:43

export type SQUncensoredGroup = SerializeFrom<
	(typeof SendouQClass.prototype.groups)[number]
>;

Othersendouq-match/match.server.ts

type

SQGroup

no JSDoc:46

export type SQGroup = SerializeFrom<
	ReturnType<SendouQClass["lookingGroups"]>[number]
>;

Componentssendouq/GroupCard.tsx

Othersendouq/groups.tssendouq/q-utils.ts

type

SQOwnGroup

no JSDoc:49

export type SQOwnGroup = SerializeFrom<
	NonNullable<ReturnType<SendouQClass["findOwnGroup"]>>
>;

Componentssendouq/GroupCard.tsx

type

SQMatch

no JSDoc:52

export type SQMatch = SerializeFrom<ReturnType<SendouQClass["mapMatch"]>>;

Modulessendouq-match/RejoinVote.ts

Othersendouq-match/match.server.ts

type

SQGroupMember

no JSDoc:53

export type SQGroupMember = NonNullable<SQGroup["members"]>[number];

Componentssendouq/GroupCard.tsx

Functions & values

const

SendouQ

:601

Global SendouQ manager: all active groups and matchmaking state.

export let SendouQ = await freshSendouQInstance();

Unit tests (53)

• likesReceivedCount › returns 0 for a group nobody has liked
• likesReceivedCount › counts likes received, not given
• refreshSendouQInstance › notifies
  • the members of a group that received a like
  • the members of a group whose liker went stale
  • nobody when no group's received likes changed
• currentViewByUserId › returns
  • 'default' when user not in any group
  • 'preparing' when user in PREPARING group
  • 'match' when user in ACTIVE group with matchId
  • 'looking' when user in ACTIVE group without matchId
• findOwnGroup › returns
  • group when user is a member
  • undefined when user not in any group
  • correct group when multiple groups exist
• findOwnGroup › solo group has the same tier as the user's personal tier
• findGroupByInviteCode › returns
  • group when invite code is valid
  • undefined when invite code is invalid
  • correct group when multiple groups exist
• modePreferences › counts
  • each member's own preferences when the group is not a team's
  • the team's own preferences when the group is a team's
  • members' own preferences when only some of them share a team
• previewGroups › returns empty array when no groups exist
• previewGroups › censors
  • members for full groups
  • tier and sets tier range for full groups
• previewGroups › shows members for partial groups
• previewGroups › removes inviteCode and chatRoomId from all groups
• previewGroups › applies correct censoring for mix of full and partial groups
• previewGroups › tier
  • sorting › sorts full groups by tier when viewer has a tier
  • sorting › sorts partial groups by tier relative to viewer
  • sorting › full groups are sorted last regardless of tier
  • sorting › handles viewer without skill gracefully
• lookingGroups › filtering
  • › returns empty array when user not in a group
  • › only returns ACTIVE groups
  • › only returns groups without matchId
  • › excludes own group from results
  • › own group size 4 only shows size 4 groups
  • › own group size 3 only shows size 1 groups
  • › own group size 2 shows size 1 and 2 groups
  • › own group size 1 shows size 1, 2, and 3 groups
• lookingGroups › replay
  • detection › marks group as replay when 3+ members overlap
  • detection › does not mark as replay when less than 3 members overlap
  • detection › all groups have isReplay false when no recent matches
  • detection › non-full groups do not have isReplay even with 3+ overlapping members
• lookingGroups › censoring
  • › full groups have members undefined
  • › partial groups have members visible
  • › inviteCode and chatRoomId removed from all groups
• lookingGroups › skill-based
  • sorting › groups with closer skill sorted first
  • sorting › full groups sorted by average skill
  • sorting › full group one sub-tier away sorted above full group six sub-tiers away
  • sorting › newer groups sorted first when skill is equal
• mapMatch › counts
  • players with the current map in their pool as its voters
  • a team's group on the team's pool rather than its members' own
• mapMatch › leaves out a pool of a mode its owner avoids
• mapMatch › shows
  • what the concluded match did to each player's SP
  • the tiers snapshotted when the match was made

Loaders/q/looking/q/preparing/q/ready/q/q/match/:id

Actions/q/looking/q/preparing/q/ready/q/q/match/:id/settings

Routes/sendouq/active-match/:userId

Modulesuser-activity/UserActivity.server.ts

Othersendouq/likes.server.tssendouq/ready-check.server.tssendouq-streams/streams.server.ts

function

refreshSendouQInstance

:606

Reloads the global SendouQ instance from the database; call after any change to groups or matches. Notifies the groups whose received likes count changed, e.g. a liker left the looking pool or went stale since the last reload.

export async function refreshSendouQInstance()

Actions/q/looking/q/preparing/q/q/match/:id/settings

Routinesapp/routines/resolveStaleSQMatches.tsapp/routines/setOldGroupsAsInactive.ts

Otherapi-private/refresh-caches.server.tssendouq/likes.server.tssendouq/ready-check.server.ts

function

sqRedirectIfNeeded

:646

Throws a redirect when the user loads a page other than the one their SendouQ group status puts them on.

export async function sqRedirectIfNeeded({
	ownGroup,
	currentLocation,
}: {
	ownGroup?: SQOwnGroup;
	currentLocation: "default" | "preparing" | "looking" | "ready" | "match";
})

Loaders/q/looking/q/preparing/q/ready/q

Actions/q