feat(discovery): resolve message links into discoverable guilds (#3159)

This commit is contained in:
Hampus
2026-10-03 13:12:30 +02:00
committed by GitHub
parent 4e6b837ccc
commit 81d69c41f5
13 changed files with 504 additions and 10 deletions
@@ -245,6 +245,8 @@ export const Endpoints = {
DISCOVERY_GUILDS: '/discovery/guilds',
DISCOVERY_CATEGORIES: '/discovery/categories',
DISCOVERY_JOIN: (guildId: string) => `/discovery/guilds/${guildId}/join`,
DISCOVERY_CHANNEL_PREVIEW: (guildId: string, channelId: string) =>
`/discovery/guilds/${guildId}/channels/${channelId}`,
GUILD_DISCOVERY: (guildId: string) => `/guilds/${guildId}/discovery`,
CONNECTIONS: '/users/@me/connections',
CONNECTIONS_VERIFY_AND_CREATE: '/users/@me/connections/verify',
@@ -23,6 +23,11 @@ export interface DiscoveryGuild {
type DiscoveryGuildPayload = Omit<DiscoveryGuild, 'banner'> & {banner?: string | null};
export interface DiscoveryChannelPreview {
guild: {id: string; name: string; icon: string | null};
channel: {id: string; name: string | null; type: number};
}
interface DiscoveryCategoryCountPayload {
category_type: number;
count: number;
@@ -115,6 +120,11 @@ export async function getCategories(): Promise<Array<DiscoveryCategory>> {
return requestDiscoveryCategories();
}
export async function getChannelPreview(guildId: string, channelId: string): Promise<DiscoveryChannelPreview> {
const response = await http.get<DiscoveryChannelPreview>(Endpoints.DISCOVERY_CHANNEL_PREVIEW(guildId, channelId));
return response.body;
}
export async function joinGuild(guildId: string): Promise<void> {
await http.post(Endpoints.DISCOVERY_JOIN(guildId));
logger.info('Joined guild via discovery', {guildId});
@@ -112,10 +112,17 @@ function showJoinGuildErrorModal(error: unknown): void {
);
}
export async function joinDiscoveryGuild(guildId: string): Promise<boolean> {
export async function joinDiscoveryGuild(
guildId: string,
target?: {channelId: string; messageId?: string},
): Promise<boolean> {
try {
await DiscoveryCommands.joinGuild(guildId);
NavigationCommands.selectGuild(guildId);
if (target) {
NavigationCommands.selectChannel(guildId, target.channelId, target.messageId);
} else {
NavigationCommands.selectGuild(guildId);
}
return true;
} catch (error) {
showJoinGuildErrorModal(error);
@@ -0,0 +1,55 @@
// SPDX-License-Identifier: AGPL-3.0-or-later
import type {DiscoveryChannelPreview} from '@app/features/discovery/commands/DiscoveryCommands';
import * as DiscoveryCommands from '@app/features/discovery/commands/DiscoveryCommands';
import {failureCode} from '@app/features/platform/utils/ResponseInspection';
import {APIErrorCodes} from '@fluxer/constants/src/ApiErrorCodes';
import {makeAutoObservable, observable, runInAction} from 'mobx';
type DiscoveryChannelPreviewEntry =
| {status: 'loading'}
| {status: 'ready'; preview: DiscoveryChannelPreview}
| {status: 'unavailable'};
function entryKey(guildId: string, channelId: string): string {
return `${guildId}:${channelId}`;
}
class DiscoveryChannelPreviews {
private entries = observable.map<string, DiscoveryChannelPreviewEntry>();
private discoveryDisabled = false;
constructor() {
makeAutoObservable(this, {}, {autoBind: true});
}
get(guildId: string, channelId: string): DiscoveryChannelPreviewEntry | undefined {
return this.entries.get(entryKey(guildId, channelId));
}
request(guildId: string, channelId: string): void {
const key = entryKey(guildId, channelId);
if (this.discoveryDisabled || this.entries.has(key)) return;
this.entries.set(key, {status: 'loading'});
DiscoveryCommands.getChannelPreview(guildId, channelId).then(
(preview) => {
runInAction(() => this.entries.set(key, {status: 'ready', preview}));
},
(error: unknown) => {
const code = failureCode(error);
runInAction(() => {
if (code === APIErrorCodes.DISCOVERY_DISABLED) {
this.discoveryDisabled = true;
this.entries.set(key, {status: 'unavailable'});
} else if (code === APIErrorCodes.DISCOVERY_NOT_DISCOVERABLE) {
this.entries.set(key, {status: 'unavailable'});
} else {
this.entries.delete(key);
}
});
},
);
}
}
export default new DiscoveryChannelPreviews();
@@ -11,6 +11,8 @@ import type {Channel} from '@app/features/channel/models/Channel';
import Channels from '@app/features/channel/state/Channels';
import {getDMDisplayName, getIcon, getName} from '@app/features/channel/utils/ChannelUtils';
import DeveloperMode from '@app/features/devtools/state/DeveloperMode';
import {joinDiscoveryGuild} from '@app/features/discovery/commands/DiscoveryJoinCommands';
import DiscoveryChannelPreviews from '@app/features/discovery/state/DiscoveryChannelPreviews';
import type {Guild} from '@app/features/guild/models/Guild';
import Guilds from '@app/features/guild/state/Guilds';
import {getGuildIconDisplayInitials} from '@app/features/guild/utils/GuildInitialsUtils';
@@ -75,6 +77,7 @@ import type {UserSettingsDeepLinkTarget} from '@app/features/user/components/set
import * as AvatarUtils from '@app/features/user/utils/AvatarUtils';
import * as StringUtils from '@app/lib/strings';
import {ME} from '@fluxer/constants/src/AppConstants';
import {isProbablyAValidSnowflake} from '@fluxer/snowflake/src/SnowflakeUtils';
import type {I18n} from '@lingui/core';
import {msg} from '@lingui/core/macro';
import {useLingui} from '@lingui/react';
@@ -82,7 +85,7 @@ import {CaretRightIcon, ChatTeardropIcon, LockIcon} from '@phosphor-icons/react'
import {clsx} from 'clsx';
import {observer} from 'mobx-react-lite';
import type React from 'react';
import {useCallback} from 'react';
import {useCallback, useEffect, useState} from 'react';
const LINK_CONTENT_OPTION_OVERRIDES: Partial<MarkdownRenderOptions> = {disableEmojiInteractions: true};
@@ -201,7 +204,7 @@ type CompactGuildMentionIconStyle = React.CSSProperties & {
'--jump-link-guild-icon-image'?: string;
};
function CompactGuildMentionIcon({guild}: {guild: Guild}) {
function CompactGuildMentionIcon({guild}: {guild: Pick<Guild, 'id' | 'name' | 'icon'>}) {
const iconUrl = guild.icon ? AvatarUtils.getGuildIconURL({id: guild.id, icon: guild.icon}) : '';
const style: CompactGuildMentionIconStyle | undefined = iconUrl
? {'--jump-link-guild-icon-image': `url(${iconUrl})`}
@@ -514,6 +517,143 @@ function InaccessibleJumpLinkMention({url, i18n, interactive = true}: Inaccessib
);
}
interface DiscoverableJumpLinkMentionProps {
guildId: string;
channelId: string;
messageId?: string;
url: string;
i18n: I18n;
interactive?: boolean;
}
const DiscoverableJumpLinkMention = observer(function DiscoverableJumpLinkMention({
guildId,
channelId,
messageId,
url,
i18n,
interactive = true,
}: DiscoverableJumpLinkMentionProps) {
useLingui();
const [joining, setJoining] = useState(false);
useEffect(() => {
DiscoveryChannelPreviews.request(guildId, channelId);
}, [guildId, channelId]);
const handleClick = useCallback(
(event: React.MouseEvent<HTMLButtonElement | HTMLSpanElement>) => {
if (!interactive) return;
event.preventDefault();
event.stopPropagation();
if (joining) return;
setJoining(true);
void joinDiscoveryGuild(guildId, {channelId, messageId}).finally(() => setJoining(false));
},
[channelId, guildId, interactive, joining, messageId],
);
const handleAuxClick = useCallback(
(event: React.MouseEvent<HTMLButtonElement | HTMLSpanElement>) => {
if (!interactive) return;
if (event.button !== 1) return;
event.preventDefault();
event.stopPropagation();
void openExternalUrl(url);
},
[interactive, url],
);
const handleContextMenu = useCallback(
(event: React.MouseEvent<HTMLButtonElement | HTMLSpanElement>) => {
if (!interactive) return;
ContextMenuCommands.openFromEvent(event, ({onClose}) => (
<JumpLinkContextMenu
url={url}
i18n={i18n}
onClose={onClose}
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.context-menu"
/>
));
},
[interactive, i18n, url],
);
const entry = DiscoveryChannelPreviews.get(guildId, channelId);
if (entry?.status !== 'ready') {
return (
<InaccessibleJumpLinkMention
url={url}
i18n={i18n}
interactive={interactive}
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.inaccessible"
/>
);
}
const {guild, channel} = entry.preview;
const ariaLabel = messageId
? i18n._(JUMP_TO_THE_MESSAGE_IN_DESCRIPTOR, {labelText: guild.name})
: i18n._(JUMP_TO_DESCRIPTOR, {labelText: guild.name});
const Component = interactive ? 'button' : 'span';
return (
<Component
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.component.click"
{...(interactive ? {type: 'button'} : {})}
className={clsx(markupStyles.mention, interactive && markupStyles.interactive, jumpLinkStyles.jumpLinkButton)}
onClick={handleClick}
onAuxClick={handleAuxClick}
onContextMenu={handleContextMenu}
aria-label={ariaLabel}
aria-busy={joining || undefined}
{...(interactive
? {'aria-roledescription': i18n._(messageId ? MESSAGE_LINK_DESCRIPTOR : CHANNEL_LINK_DESCRIPTOR)}
: {})}
tabIndex={interactive ? 0 : -1}
>
<span
className={jumpLinkStyles.part}
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.part--guild"
>
<CompactGuildMentionIcon
guild={guild}
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.guild-icon"
/>
<span
className={jumpLinkStyles.name}
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.guild-name"
>
{guild.name}
</span>
</span>
<span
className={jumpLinkStyles.divider}
aria-hidden="true"
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.divider"
>
<CaretRightIcon
weight="bold"
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.caret-right-icon"
/>
</span>
{messageId ? (
<ChatTeardropIcon
className={jumpLinkStyles.icon}
weight="fill"
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.chat-teardrop-icon"
/>
) : (
<span
className={jumpLinkStyles.part}
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.part--channel"
>
{getIcon({type: channel.type}, {className: jumpLinkStyles.icon})}
<span
className={jumpLinkStyles.name}
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention.channel-name"
>
{channel.name ?? channel.id}
</span>
</span>
)}
</Component>
);
});
interface SettingsJumpLinkMentionProps {
target: UserSettingsDeepLinkTarget;
url: string;
@@ -740,6 +880,14 @@ export const LinkRenderer = observer(function LinkRenderer({
const jumpTarget = messageJumpTarget ?? channelJumpTarget;
const jumpChannel = jumpTarget ? (Channels.getChannel(jumpTarget.channelId) ?? null) : null;
const jumpGuild = jumpChannel?.guildId ? (Guilds.getGuild(jumpChannel.guildId) ?? null) : null;
const discoverableGuildId =
jumpTarget &&
!jumpChannel &&
jumpTarget.scope !== ME &&
isProbablyAValidSnowflake(jumpTarget.scope) &&
!Guilds.getGuild(jumpTarget.scope)
? jumpTarget.scope
: null;
const settingsTarget = isAppProtocolUrl(url) ? parseUserSettingsDeepLink(url) : null;
const appPage = settingsTarget ? null : parseAppPageLink(url);
const isInlineReplyContext = isRestrictedInlineContext(options.context);
@@ -810,11 +958,22 @@ export const LinkRenderer = observer(function LinkRenderer({
);
}
if (jumpTarget && !jumpChannel && !text) {
const mention = (
const interactive = !isInlineReplyContext && !shouldDisableInteractions;
const mention = discoverableGuildId ? (
<DiscoverableJumpLinkMention
guildId={discoverableGuildId}
channelId={jumpTarget.channelId}
messageId={messageJumpTarget?.messageId}
url={url}
i18n={i18n}
interactive={interactive}
data-flx="messaging.markdown.renderers.link-renderer.discoverable-jump-link-mention"
/>
) : (
<InaccessibleJumpLinkMention
url={url}
i18n={i18n}
interactive={!isInlineReplyContext && !shouldDisableInteractions}
interactive={interactive}
data-flx="messaging.markdown.renderers.link-renderer.inaccessible-jump-link-mention"
/>
);