sendou.ink/app/utils/urls.ts
Kalle fef1ffc955
Design refresh + a bunch of stuff (#2864)
Co-authored-by: hfcRed <hfcred@gmx.net>
2026-03-19 17:51:42 +02:00

554 lines
18 KiB
TypeScript

import slugify from "slugify";
import type { GearType, Preference, Tables } from "~/db/tables";
import type { ArtSource } from "~/features/art/art-types";
import type { AuthErrorCode } from "~/features/auth/core/errors";
import { serializeBuild } from "~/features/build-analyzer/core/utils";
import type { CalendarFilters } from "~/features/calendar/calendar-types";
import type { MapPool } from "~/features/map-list-generator/core/map-pool";
import type { StageBackgroundStyle } from "~/features/map-planner";
import type { TierName } from "~/features/mmr/mmr-constants";
import { JOIN_CODE_SEARCH_PARAM_KEY } from "~/features/sendouq/q-constants";
import type {
Ability,
AbilityWithUnknown,
BrandId,
BuildAbilitiesTupleWithUnknown,
MainWeaponId,
ModeShort,
ModeShortWithSpecial,
SpecialWeaponId,
StageId,
SubWeaponId,
} from "~/modules/in-game-lists/types";
import type { weaponCategories } from "~/modules/in-game-lists/weapon-ids";
import type { DayMonthYear } from "~/utils/zod";
const staticAssetsUrl = ({
folder,
fileName,
}: {
folder: string;
fileName: string;
}) =>
`https://raw.githubusercontent.com/sendou-ink/assets/main/${folder}/${fileName}`;
export const discordAvatarUrl = ({
discordId,
discordAvatar,
size,
}: {
discordId: string;
discordAvatar: string;
size: "lg" | "sm";
}) =>
`https://cdn.discordapp.com/avatars/${discordId}/${
discordAvatar
}.webp${size === "lg" ? "?size=240" : "?size=80"}`;
export const SENDOU_INK_BASE_URL = "https://sendou.ink";
export const BADGES_DOC_LINK =
"https://github.com/sendou-ink/sendou.ink/blob/rewrite/docs/badges.md";
export const API_DOC_LINK =
"https://github.com/sendou-ink/sendou.ink/blob/rewrite/docs/dev/api.md";
export const CREATING_TOURNAMENT_DOC_LINK =
"https://github.com/sendou-ink/sendou.ink/blob/rewrite/docs/tournament-creation.md";
export const PLUS_SERVER_DISCORD_URL = "https://discord.gg/FW4dKrY";
export const SENDOU_INK_DISCORD_URL = "https://discord.gg/sendou";
export const SENDOU_INK_PATREON_URL = "https://patreon.com/sendou";
export const NINTENDO_COMMUNITY_TOURNAMENTS_GUIDELINES_URL =
"https://en-americas-support.nintendo.com/app/answers/detail/a_id/63454";
export const PATREON_HOW_TO_CONNECT_DISCORD_URL =
"https://support.patreon.com/hc/en-us/articles/212052266-How-do-I-connect-Discord-to-Patreon-Patron-";
export const SENDOU_INK_GITHUB_URL = "https://github.com/sendou-ink/sendou.ink";
export const GITHUB_CONTRIBUTORS_URL =
"https://github.com/sendou-ink/sendou.ink/graphs/contributors";
export const ipLabsMaps = (pool: string) =>
`https://maps.iplabs.ink/?3&pool=${pool}`;
export const SPLATOON_3_INK = "https://splatoon3.ink/";
export const RHODESMAS_FREESOUND_PROFILE_URL =
"https://freesound.org/people/rhodesmas/";
export const SPR_INFO_URL =
"https://web.archive.org/web/20250513034545/https://www.pgstats.com/articles/introducing-spr-and-uf";
export const SPLATOON3_INK_SCHEDULES_URL =
"https://splatoon3.ink/data/schedules.json";
export const bskyUrl = (accountName: string) =>
`https://bsky.app/profile/${accountName}`;
export const twitchUrl = (accountName: string) =>
`https://twitch.tv/${accountName}`;
export const youtubeUrl = (channelId: string) =>
`https://youtube.com/channel/${channelId}`;
export const LOG_IN_URL = "/auth";
export const LOG_OUT_URL = "/auth/logout";
export const ADMIN_PAGE = "/admin";
export const API_PAGE = "/api";
export const ARTICLES_MAIN_PAGE = "/a";
export const FAQ_PAGE = "/faq";
export const PRIVACY_POLICY_PAGE = "/privacy-policy";
export const SUPPORT_PAGE = "/support";
export const CONTRIBUTIONS_PAGE = "/contributions";
export const BADGES_PAGE = "/badges";
export const BUILDS_PAGE = "/builds";
export const TEAM_SEARCH_PAGE = "/t";
export const NEW_TEAM_PAGE = "/t/new";
export const CALENDAR_PAGE = "/calendar";
export const CALENDAR_NEW_PAGE = "/calendar/new";
export const TOURNAMENT_NEW_PAGE = "/calendar/new?tournament=true";
export const ORGANIZATION_NEW_PAGE = "/org/new";
export const STOP_IMPERSONATING_URL = "/auth/impersonate/stop";
export const SEED_URL = "/seed";
export const PLANNER_URL = "/plans";
export const MAPS_URL = "/maps";
export const TIER_LIST_MAKER_URL = "/tier-list-maker";
export const ANALYZER_URL = "/analyzer";
export const COMP_ANALYZER_URL = "/comp-analyzer";
export const OBJECT_DAMAGE_CALCULATOR_URL = "/object-damage-calculator";
export const VODS_PAGE = "/vods";
export const LEADERBOARDS_PAGE = "/leaderboards";
export const LINKS_PAGE = "/links";
export const SENDOUQ_PAGE = "/q";
export const SENDOUQ_RULES_PAGE = "/q/rules";
export const SENDOUQ_INFO_PAGE = "/q/info";
export const SENDOUQ_SETTINGS_PAGE = "/q/settings";
export const SENDOUQ_PREPARING_PAGE = "/q/preparing";
export const SENDOUQ_LOOKING_PAGE = "/q/looking";
export const SENDOUQ_LOOKING_PREVIEW_PAGE = "/q/looking?preview=true";
export const SENDOUQ_STREAMS_PAGE = "/q/streams";
export const TIERS_PAGE = "/tiers";
export const SUSPENDED_PAGE = "/suspended";
export const LFG_PAGE = "/lfg";
export const EVENTS_PAGE = "/events";
export const FRIENDS_PAGE = "/friends";
export const SETTINGS_PAGE = "/settings";
export const LUTI_PAGE = "/luti";
export const PLUS_VOTING_PAGE = "/plus/voting";
export const BLANK_IMAGE_URL = "/static-assets/img/blank.gif";
export const COMMON_PREVIEW_IMAGE =
"/static-assets/img/layout/common-preview.png";
export const ERROR_GIRL_IMAGE_PATH = "/static-assets/img/layout/error-girl";
export const SENDOU_LOVE_EMOJI_PATH = "/static-assets/img/layout/sendou_love";
export const FIRST_PLACEMENT_ICON_PATH =
"/static-assets/svg/placements/first.svg";
export const SECOND_PLACEMENT_ICON_PATH =
"/static-assets/svg/placements/second.svg";
export const THIRD_PLACEMENT_ICON_PATH =
"/static-assets/svg/placements/third.svg";
export const soundPath = (fileName: string) =>
`/static-assets/sounds/${fileName}.wav`;
export const GET_FRIENDS_FOR_ADDING_ROUTE = "/friends-for-adding";
export const PATRONS_LIST_ROUTE = "/patrons-list";
export const NOTIFICATIONS_URL = "/notifications";
export const NOTIFICATIONS_MARK_AS_SEEN_ROUTE = "/notifications/seen";
interface UserLinkArgs {
discordId: Tables["User"]["discordId"];
customUrl?: Tables["User"]["customUrl"];
}
export const userPage = (user: UserLinkArgs) =>
`/u/${user.customUrl ?? user.discordId}`;
export const userSeasonsPage = ({
user,
season,
}: {
user: UserLinkArgs;
season?: number;
}) =>
`${userPage(user)}/seasons${
typeof season === "number" ? `?season=${season}` : ""
}`;
export const userEditProfilePage = (user: UserLinkArgs) =>
`${userPage(user)}/edit`;
export const userBuildsPage = (user: UserLinkArgs) =>
`${userPage(user)}/builds`;
export const userResultsPage = (user: UserLinkArgs, showAll?: boolean) =>
`${userPage(user)}/results${showAll ? "?all=true" : ""}`;
export const userVodsPage = (user: UserLinkArgs) => `${userPage(user)}/vods`;
export const newVodPage = (vodToEditId?: number) =>
`${VODS_PAGE}/new${vodToEditId ? `?vod=${vodToEditId}` : ""}`;
export const userResultsEditHighlightsPage = (user: UserLinkArgs) =>
`${userResultsPage(user)}/highlights`;
export const userAdminPage = (user: UserLinkArgs) => `${userPage(user)}/admin`;
export const artPage = (tag?: string) => `/art${tag ? `?tag=${tag}` : ""}`;
export const userArtPage = (
user: UserLinkArgs,
source?: ArtSource,
bigArtId?: number,
) =>
`${userPage(user)}/art${source ? `?source=${source}` : ""}${bigArtId ? `?big=${bigArtId}` : ""}`;
export const newArtPage = (artId?: Tables["Art"]["id"]) =>
`${artPage()}/new${artId ? `?art=${artId}` : ""}`;
export const userNewBuildPage = (
user: UserLinkArgs,
params?: { weapon: MainWeaponId; build: BuildAbilitiesTupleWithUnknown },
) =>
`${userBuildsPage(user)}/new${
params
? `?${String(
new URLSearchParams({
weapon: String(params.weapon),
build: serializeBuild(params.build),
}),
)}`
: ""
}`;
export const teamPage = (customUrl: string) => `/t/${customUrl}`;
export const editTeamPage = (customUrl: string) =>
`${teamPage(customUrl)}/edit`;
export const manageTeamRosterPage = (customUrl: string) =>
`${teamPage(customUrl)}/roster`;
export const joinTeamPage = ({
customUrl,
inviteCode,
}: {
customUrl: string;
inviteCode: string;
}) => `${teamPage(customUrl)}/join?code=${inviteCode}`;
export const topSearchPage = (args?: {
month: number;
year: number;
mode: ModeShort;
region: Tables["XRankPlacement"]["region"];
}) =>
args
? `/xsearch?month=${args.month}&year=${args.year}&mode=${args.mode}&region=${args.region}`
: "/xsearch";
export const topSearchPlayerPage = (playerId: number) =>
`${topSearchPage()}/player/${playerId}`;
export const leaderboardsPage = (args: {
season?: number;
type?: "USER" | "TEAM";
}) => {
const params = new URLSearchParams();
if (args.season) {
params.set("season", String(args.season));
}
if (args.type) {
params.set("type", args.type);
}
return `${LEADERBOARDS_PAGE}${params.size > 0 ? `?${params.toString()}` : ""}`;
};
export const authErrorUrl = (errorCode: AuthErrorCode) =>
`/?authError=${errorCode}`;
export const impersonateUrl = (idToLogInAs: number) =>
`/auth/impersonate?id=${idToLogInAs}`;
export const badgePage = (badgeId: number) => `${BADGES_PAGE}/${badgeId}`;
export const plusSuggestionPage = ({
tier,
showAlert,
}: {
tier?: string | number;
showAlert?: boolean;
} = {}) => {
const params = new URLSearchParams();
if (tier) {
params.set("tier", String(tier));
}
if (showAlert) {
params.set("alert", "true");
}
return `/plus/suggestions${params.toString() ? `?${params.toString()}` : ""}`;
};
export const plusSuggestionsNewPage = (tier?: string | number) =>
`/plus/suggestions/new${tier ? `?tier=${tier}` : ""}`;
export const weaponBuildPage = (weaponSlug: string) =>
`${BUILDS_PAGE}/${weaponSlug}`;
export const weaponBuildStatsPage = (weaponSlug: string) =>
`${weaponBuildPage(weaponSlug)}/stats`;
export const weaponBuildPopularPage = (weaponSlug: string) =>
`${weaponBuildPage(weaponSlug)}/popular`;
export const calendarPage = (args?: {
filters?: CalendarFilters;
dayMonthYear?: DayMonthYear;
}) => {
const params = new URLSearchParams();
if (args?.filters) {
params.set("filters", JSON.stringify(args.filters));
}
if (args?.dayMonthYear) {
params.set("day", String(args.dayMonthYear.day));
params.set("month", String(args.dayMonthYear.month));
params.set("year", String(args.dayMonthYear.year));
}
return `${CALENDAR_PAGE}${params.toString() ? `?${params.toString()}` : ""}`;
};
export const calendarIcalFeed = (filters?: CalendarFilters) => {
const params = new URLSearchParams();
if (filters) {
params.set("filters", JSON.stringify(filters));
}
return `${SENDOU_INK_BASE_URL}/calendar.ics${params.toString() ? `?${params.toString()}` : ""}`;
};
export const calendarEventPage = (eventId: number) => `/calendar/${eventId}`;
export const calendarEditPage = (eventId?: number) =>
`/calendar/new${eventId ? `?eventId=${eventId}` : ""}`;
export const tournamentEditPage = (eventId: number) =>
`${calendarEditPage(eventId)}&tournament=true`;
export const calendarReportWinnersPage = (eventId: number) =>
`/calendar/${eventId}/report-winners`;
export const tournamentPage = (tournamentId: number) => `/to/${tournamentId}`;
export const tournamentTeamsPage = (tournamentId: number) =>
`/to/${tournamentId}/teams`;
export const tournamentTeamPage = ({
tournamentId,
tournamentTeamId,
}: {
tournamentId: number;
tournamentTeamId: number;
}) => `/to/${tournamentId}/teams/${tournamentTeamId}`;
export const tournamentRegisterPage = (tournamentId: number) =>
`/to/${tournamentId}/register`;
export const tournamentAdminPage = (tournamentId: number) =>
`/to/${tournamentId}/admin`;
export const tournamentBracketsPage = ({
tournamentId,
bracketIdx,
groupId,
}: {
tournamentId: number;
bracketIdx?: number | null;
groupId?: number;
}) => {
const query = new URLSearchParams();
if (typeof bracketIdx === "number") {
query.set("idx", String(bracketIdx));
}
if (typeof groupId === "number") {
query.set("group", String(groupId));
}
return `/to/${tournamentId}/brackets${
query.size > 0 ? `?${query.toString()}` : ""
}`;
};
export const tournamentDivisionsPage = (tournamentId: number) =>
`/to/${tournamentId}/divisions`;
export const tournamentResultsPage = (tournamentId: number) =>
`/to/${tournamentId}/results`;
export const tournamentMatchPage = ({
tournamentId,
matchId,
}: {
tournamentId: number;
matchId: number;
}) => `/to/${tournamentId}/matches/${matchId}`;
export const tournamentJoinPage = ({
tournamentId,
inviteCode,
}: {
tournamentId: number;
inviteCode: string;
}) => `/to/${tournamentId}/join?code=${inviteCode}`;
export const tournamentSubsPage = (tournamentId: number) => {
return `/to/${tournamentId}/looking`;
};
export const tournamentStreamsPage = (tournamentId: number) => {
return `/to/${tournamentId}/streams`;
};
export const tournamentOrganizationPage = ({
organizationSlug,
tournamentName,
}: {
organizationSlug: string;
tournamentName?: string;
}) =>
`/org/${organizationSlug}${tournamentName ? `?source=${decodeURIComponent(tournamentName)}` : ""}`;
export const tournamentOrganizationEditPage = (organizationSlug: string) =>
`${tournamentOrganizationPage({ organizationSlug })}/edit`;
export const sendouQInviteLink = (inviteCode: string) =>
`${SENDOUQ_PAGE}?${JOIN_CODE_SEARCH_PARAM_KEY}=${inviteCode}`;
export const sendouQMatchPage = (id: Tables["GroupMatch"]["id"]) => {
return `${SENDOUQ_PAGE}/match/${id}`;
};
export const scrimsPage = () => {
return "/scrims";
};
export const scrimPage = (id: number) => {
return `${scrimsPage()}/${id}`;
};
export const newScrimPostPage = () => {
return "/scrims/new";
};
export const associationsPage = (inviteCode?: string) => {
return `/associations${inviteCode ? `?inviteCode=${inviteCode}` : ""}`;
};
export const newAssociationsPage = () => {
return "/associations/new";
};
export const getWeaponUsage = ({
userId,
season,
modeShort,
stageId,
}: {
userId: number;
season: number;
modeShort: ModeShort;
stageId: StageId;
}) => {
return `/weapon-usage?userId=${userId}&season=${season}&modeShort=${modeShort}&stageId=${stageId}`;
};
export const mapsPageWithMapPool = (mapPool: MapPool) =>
`${MAPS_URL}?readonly&pool=${mapPool.serialized}`;
export const articlePage = (slug: string) => `${ARTICLES_MAIN_PAGE}/${slug}`;
export const analyzerPage = (args?: {
weaponId: MainWeaponId;
abilities: Ability[];
}) =>
`/analyzer${
args
? `?weapon=${args.weaponId}&build=${encodeURIComponent(
args.abilities.join(","),
)}`
: ""
}`;
export const objectDamageCalculatorPage = (weaponId?: MainWeaponId) =>
`/object-damage-calculator${
typeof weaponId === "number" ? `?weapon=${weaponId}` : ""
}`;
export const uploadImagePage = (
args:
| { type: "team-pfp" | "team-banner"; teamCustomUrl: string }
| { type: "org-pfp"; slug: string },
) =>
args.type === "org-pfp"
? `/upload?type=${args.type}&slug=${args.slug}`
: `/upload?type=${args.type}&team=${args.teamCustomUrl}`;
export const vodVideoPage = (videoId: number) => `${VODS_PAGE}/${videoId}`;
export const lfgNewPostPage = (postId?: number) =>
`${LFG_PAGE}/new${postId ? `?postId=${postId}` : ""}`;
export const badgeUrl = ({
code,
extension,
}: {
code: Tables["Badge"]["code"];
extension?: "gif";
}) => `/static-assets/badges/${code}${extension ? `.${extension}` : ""}`;
export const gameBadgeUrl = (id: string) =>
`/static-assets/img/badges/${id}.avif`;
export const articlePreviewUrl = (slug: string) =>
`/static-assets/img/article-previews/${slug}.png`;
export const navIconUrl = (navItem: string) =>
`/static-assets/img/layout/${navItem}`;
export const gearImageUrl = (gearType: GearType, gearSplId: number) =>
`/static-assets/img/gear/${gearType.toLowerCase()}/${gearSplId}`;
export const weaponCategoryUrl = (
category: (typeof weaponCategories)[number]["name"],
) => `/static-assets/img/weapon-categories/${category}`;
export const mainWeaponImageUrl = (mainWeaponSplId: MainWeaponId) =>
`/static-assets/img/main-weapons/${mainWeaponSplId}`;
export const mainWeaponVariantImageUrl = (
mainWeaponSplId: MainWeaponId,
variant: "launched",
) => `/static-assets/img/main-weapons/variants/${mainWeaponSplId}-${variant}`;
export const outlinedMainWeaponImageUrl = (mainWeaponSplId: MainWeaponId) =>
`/static-assets/img/main-weapons-outlined/${mainWeaponSplId}`;
export const outlinedFiveStarMainWeaponImageUrl = (
mainWeaponSplId: MainWeaponId,
) => `/static-assets/img/main-weapons-outlined-2/${mainWeaponSplId}`;
export const subWeaponImageUrl = (subWeaponSplId: SubWeaponId) =>
`/static-assets/img/sub-weapons/${subWeaponSplId}`;
export const specialWeaponImageUrl = (specialWeaponSplId: SpecialWeaponId) =>
`/static-assets/img/special-weapons/${specialWeaponSplId}`;
export const specialWeaponVariantImageUrl = (
specialWeaponSplId: SpecialWeaponId,
variant: "weakpoints",
) =>
`/static-assets/img/special-weapons/variants/${specialWeaponSplId}-${variant}`;
export const abilityImageUrl = (ability: AbilityWithUnknown) =>
`/static-assets/img/abilities/${ability}`;
export const brandImageUrl = (brand: BrandId) =>
`/static-assets/img/brands/${brand}`;
export const modeImageUrl = (mode: ModeShortWithSpecial) =>
`/static-assets/img/modes/${mode}`;
export const stageImageUrl = (stageId: StageId) =>
`/static-assets/img/stages/${stageId}`;
export const tierImageUrl = (tier: TierName | "CALCULATING") =>
`/static-assets/img/tiers/${tier.toLowerCase()}`;
export const controllerImageUrl = (controller: string) =>
`/static-assets/img/controllers/${controller}.avif`;
export const preferenceEmojiUrl = (preference?: Preference) => {
const emoji =
preference === "PREFER"
? "grin"
: preference === "AVOID"
? "unamused"
: "no-mouth";
return `/static-assets/img/emoji/${emoji}.svg`;
};
export const TIER_PLUS_URL = "/static-assets/img/tiers/plus";
export const winnersImageUrl = ({
season,
placement,
}: {
season: number;
placement: number;
}) => `/static-assets/img/winners/${season}/${placement}`;
export const sqHeaderGuyImageUrl = (season: number) =>
`/static-assets/img/sq-header/${season}`;
export const stageMinimapImageUrlWithEnding = ({
stageId,
mode,
style,
}: {
stageId: StageId;
mode: ModeShort;
style: StageBackgroundStyle;
}) =>
staticAssetsUrl({
folder: "planner-maps",
fileName: `${stageId}-${mode}-${style}.png`,
});
export function resolveBaseUrl(url: string) {
return new URL(url).host;
}
export const mySlugify = (name: string) => {
return slugify(name, {
lower: true,
strict: true,
});
};
export const isCustomUrl = (value: string) => {
return Number.isNaN(Number(value));
};