mattermost-mobile/app/utils/deep_link/index.ts
Daniel Espino García a341ef8981
Easy Login (#9261)
* Login screen for easy login

* Deep link changes

* Fix login flow

* Address feedback

* Rebranding

* Add deactivated flow

* Apply changes to the get type API

* Address feedback
2025-11-20 12:38:06 +01:00

455 lines
19 KiB
TypeScript

// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
// See LICENSE.txt for license information.
import {match} from 'path-to-regexp';
import {defineMessage, type IntlShape} from 'react-intl';
import {Alert} from 'react-native';
import {Navigation} from 'react-native-navigation';
import urlParse from 'url-parse';
import {joinIfNeededAndSwitchToChannel, makeDirectChannel} from '@actions/remote/channel';
import {showPermalink} from '@actions/remote/permalink';
import {magicLinkLogin} from '@actions/remote/session';
import {fetchUsersByUsernames} from '@actions/remote/user';
import {DeepLink, Launch, Screens} from '@constants';
import DeepLinkType from '@constants/deep_linking';
import {getDefaultThemeByAppearance} from '@context/theme';
import DatabaseManager from '@database/manager';
import {DEFAULT_LOCALE} from '@i18n';
import WebsocketManager from '@managers/websocket_manager';
import {fetchPlaybookRun} from '@playbooks/actions/remote/runs';
import {getPlaybookRunById} from '@playbooks/database/queries/run';
import {fetchIsPlaybooksEnabled} from '@playbooks/database/queries/version';
import {goToPlaybookRun} from '@playbooks/screens/navigation';
import {getActiveServerUrl} from '@queries/app/servers';
import {getCurrentUser, queryUsersByUsername} from '@queries/servers/user';
import {dismissAllModalsAndPopToRoot} from '@screens/navigation';
import EphemeralStore from '@store/ephemeral_store';
import NavigationStore from '@store/navigation_store';
import {alertErrorWithFallback, errorBadChannel, errorUnkownUser} from '@utils/draft';
import {getIntlShape} from '@utils/general';
import {logError} from '@utils/log';
import {escapeRegex} from '@utils/markdown';
import {addNewServer} from '@utils/server';
import {removeProtocol, stripTrailingSlashes} from '@utils/url';
import {
TEAM_NAME_PATH_PATTERN,
IDENTIFIER_PATH_PATTERN,
ID_PATH_PATTERN,
TOKEN_PATH_PATTERN,
} from '@utils/url/path';
import type {DeepLinkChannel, DeepLinkDM, DeepLinkGM, DeepLinkPermalink, DeepLinkPlaybookRuns, DeepLinkWithData, LaunchProps} from '@typings/launch';
import type {AvailableScreens} from '@typings/screens/navigation';
const deepLinkScreens: AvailableScreens[] = [Screens.HOME, Screens.CHANNEL, Screens.GLOBAL_THREADS, Screens.THREAD];
export async function handleDeepLink(deepLink: DeepLinkWithData, intlShape?: IntlShape, location?: string) {
try {
if (deepLink.type === DeepLink.Invalid || !deepLink.data || !deepLink.data.serverUrl) {
return {error: true};
}
const currentServerUrl = await getActiveServerUrl();
const existingServerUrl = DatabaseManager.searchUrl(deepLink.data.serverUrl);
// After checking the server for http & https then we add it
if (!existingServerUrl) {
const theme = EphemeralStore.theme || getDefaultThemeByAppearance();
if (deepLink.type === DeepLink.MagicLink && 'token' in deepLink.data) {
const result = await magicLinkLogin(deepLink.data.serverUrl, deepLink.data.token);
if (result.error) {
logError('Failed to do magic link login', result.error);
return {error: true};
}
return {error: false};
}
if (NavigationStore.getVisibleScreen() === Screens.SERVER) {
Navigation.updateProps(Screens.SERVER, {serverUrl: deepLink.data.serverUrl});
} else if (!NavigationStore.getScreensInStack().includes(Screens.SERVER)) {
addNewServer(theme, deepLink.data.serverUrl, undefined, deepLink);
}
return {error: false};
}
if (existingServerUrl !== currentServerUrl && NavigationStore.getVisibleScreen()) {
await dismissAllModalsAndPopToRoot();
DatabaseManager.setActiveServerDatabase(existingServerUrl);
WebsocketManager.initializeClient(existingServerUrl, 'DeepLink');
await NavigationStore.waitUntilScreenHasLoaded(Screens.HOME);
}
const {database} = DatabaseManager.getServerDatabaseAndOperator(existingServerUrl);
const currentUser = await getCurrentUser(database);
const locale = currentUser?.locale || DEFAULT_LOCALE;
const intl = intlShape || getIntlShape(locale);
switch (deepLink.type) {
case DeepLink.Channel: {
const deepLinkData = deepLink.data as DeepLinkChannel;
joinIfNeededAndSwitchToChannel(existingServerUrl, {name: deepLinkData.channelName}, {name: deepLinkData.teamName}, errorBadChannel, intl);
break;
}
case DeepLink.DirectMessage: {
const deepLinkData = deepLink.data as DeepLinkDM;
const userIds = await queryUsersByUsername(database, [deepLinkData.userName]).fetchIds();
let userId = userIds.length ? userIds[0] : undefined;
if (!userId) {
const {users} = await fetchUsersByUsernames(existingServerUrl, [deepLinkData.userName], false);
if (users?.length) {
userId = users[0].id;
}
}
if (userId) {
makeDirectChannel(existingServerUrl, userId, '', true);
} else {
errorUnkownUser(intl);
}
break;
}
case DeepLink.GroupMessage: {
const deepLinkData = deepLink.data as DeepLinkGM;
joinIfNeededAndSwitchToChannel(existingServerUrl, {name: deepLinkData.channelName}, {name: deepLinkData.teamName}, errorBadChannel, intl);
break;
}
case DeepLink.Permalink: {
const deepLinkData = deepLink.data as DeepLinkPermalink;
if (
NavigationStore.hasModalsOpened() ||
!deepLinkScreens.includes(NavigationStore.getVisibleScreen())
) {
await dismissAllModalsAndPopToRoot();
}
showPermalink(existingServerUrl, deepLinkData.teamName, deepLinkData.postId);
break;
}
case DeepLink.Playbooks: {
// Alert that playbooks should be access from the webapp or desktop app
Alert.alert(
intl.formatMessage({id: 'playbooks.only_runs_available.title', defaultMessage: 'Playbooks not available'}),
intl.formatMessage({id: 'playbooks.only_runs_available.description', defaultMessage: 'Only Playbook Checklists are available on mobile. To access the Playbook, please use the desktop or web app.'}),
[{
text: intl.formatMessage({id: 'playbooks.only_runs_available.ok', defaultMessage: 'OK'}),
}],
);
break;
}
case DeepLink.PlaybookRunsRetrospective: {
Alert.alert(
intl.formatMessage({id: 'playbooks.retrospective_not_available.title', defaultMessage: 'Playbooks Retrospective not available'}),
intl.formatMessage({id: 'playbooks.retrospective_not_available.description', defaultMessage: 'Only Playbook Checklists are available on mobile. To fill the Run Retrospective, please use the desktop or web app.'}),
[{
text: intl.formatMessage({id: 'playbooks.retrospective_not_available.ok', defaultMessage: 'OK'}),
}],
);
break;
}
case DeepLink.PlaybookRuns: {
const deepLinkData = deepLink.data as DeepLinkPlaybookRuns;
const playbookEnabled = await fetchIsPlaybooksEnabled(database);
if (playbookEnabled) {
// Go to playbook Run
const playbook = await getPlaybookRunById(database, deepLinkData.playbookRunId);
if (!playbook) {
const {error} = await fetchPlaybookRun(existingServerUrl, deepLinkData.playbookRunId);
if (error) {
Alert.alert(
intl.formatMessage({id: 'playbooks.fetch_error.title', defaultMessage: 'Unable to open Checklist'}),
intl.formatMessage({id: 'playbooks.fetch_error.description', defaultMessage: "You don't have permission to view this, or it may no longer exist."}),
[{
text: intl.formatMessage({id: 'playbooks.fetch_error.OK', defaultMessage: 'Okay'}),
}],
);
break;
}
}
goToPlaybookRun(intl, deepLinkData.playbookRunId);
} else {
// Alert playbooks not enabled or version not supported
Alert.alert(
intl.formatMessage({id: 'playbooks.not_enabled_or_unsupported.title', defaultMessage: 'Playbooks not available'}),
intl.formatMessage({id: 'playbooks.not_enabled_or_unsupported.description', defaultMessage: 'Playbooks are either not enabled on this server or the Playbooks version is not supported. Please contact your system administrator.'}),
[{
text: intl.formatMessage({id: 'playbooks.not_enabled_or_unsupported.OK', defaultMessage: 'OK'}),
}],
);
}
break;
}
case DeepLink.MagicLink: {
Alert.alert(
intl.formatMessage({id: 'magic_link.already_logged_in_error.title', defaultMessage: 'Already logged in'}),
intl.formatMessage({id: 'magic_link.already_logged_in_error.description', defaultMessage: 'You are already logged in to this server. Log out and follow the link again.'}),
[{
text: intl.formatMessage({id: 'magic_link.already_logged_in_error.ok', defaultMessage: 'OK'}),
}],
);
break;
}
}
return {error: false};
} catch (error) {
logError('Failed to open channel from deeplink', error, location);
return {error: true};
}
}
export async function parseAndHandleDeepLink(deepLinkUrl: string, intlShape?: IntlShape, location?: string, asServer = false) {
const parsed = parseDeepLink(deepLinkUrl, asServer);
return handleDeepLink(parsed, intlShape, location);
}
type ChannelPathParams = {
hostname: string;
serverUrl: string[];
teamName: string;
path: 'channels' | 'messages';
identifier: string;
};
const CHANNEL_PATH = '*serverUrl/:teamName/:path/:identifier';
export const matchChannelDeeplink = match<ChannelPathParams>(CHANNEL_PATH);
type PlaybooksPathParams = {
serverUrl: string[];
playbookId: string;
};
const PLAYBOOKS_PATH = '*serverUrl/playbooks/playbooks/:playbookId';
export const matchPlaybooksDeeplink = match<PlaybooksPathParams>(PLAYBOOKS_PATH);
type PlaybookRunsPathParams = {
serverUrl: string[];
playbookRunId: string;
};
const PLAYBOOK_RUNS_PATH = '*serverUrl/playbooks/runs/:playbookRunId';
export const matchPlaybookRunsDeeplink = match<PlaybookRunsPathParams>(PLAYBOOK_RUNS_PATH);
const PLAYBOOK_RUNS_RETROSPECTIVE = '*serverUrl/playbooks/runs/:playbookRunId/retrospective';
export const matchPlaybookRunsRetrospectiveDeeplink = match<PlaybookRunsPathParams>(PLAYBOOK_RUNS_RETROSPECTIVE);
type MagicLinkPathParams = {
serverUrl: string[];
token: string;
};
const MAGIC_LINK_PATH = '*serverUrl/login/one_time_link';
export const matchMagicLinkDeeplink = match<MagicLinkPathParams>(MAGIC_LINK_PATH);
type PermalinkPathParams = {
serverUrl: string[];
teamName: string;
postId: string;
};
const PERMALINK_PATH = '*serverUrl/:teamName/pl/:postId';
export const matchPermalinkDeeplink = match<PermalinkPathParams>(PERMALINK_PATH);
type ServerPathParams = {
serverUrl: string;
path: string;
subpath?: string[];
}
export const matchServerDeepLink = match<ServerPathParams>(':serverUrl/{:path}{/*subpath}', {decode: decodeURIComponent});
const reservedWords = ['login', 'signup', 'admin_console'];
export function extractServerUrl(url: string) {
const deepLinkUrl = decodeURIComponent(url).replace(/\.{2,}/g, '').replace(/\/+/g, '/');
const pattern = new RegExp(
// Match the domain, IP address, or localhost
'^([a-zA-Z0-9.-]+|localhost|\\d{1,3}(?:\\.\\d{1,3}){3})' +
// Match optional port
'(?::(\\d+))?' +
// Match path segments
'(?:/([a-zA-Z0-9-/_]+))?/?$',
);
if (!pattern.test(deepLinkUrl)) {
return null;
}
const matched = matchServerDeepLink(deepLinkUrl);
if (matched) {
const {path, subpath} = matched.params;
let extra = '';
if (!path || reservedWords.includes(path)) {
return stripTrailingSlashes(matched.params.serverUrl);
}
if (subpath && subpath.length > 0) {
if (reservedWords.includes(subpath[subpath.length - 1])) {
subpath.pop();
}
extra = subpath.join('/');
}
if (extra) {
return stripTrailingSlashes(`${matched.params.serverUrl}/${path}/${extra}`);
}
return stripTrailingSlashes(`${matched.params.serverUrl}/${path}`);
}
return deepLinkUrl;
}
function isValidTeamName(teamName: string): boolean {
const regex = new RegExp(`^${TEAM_NAME_PATH_PATTERN}$`);
return regex.test(teamName);
}
function isValidIdentifierPathPattern(id: string): boolean {
const regex = new RegExp(`^${IDENTIFIER_PATH_PATTERN}$`);
return regex.test(id);
}
function isValidId(id: string): boolean {
const regex = new RegExp(`^${ID_PATH_PATTERN}$`);
return regex.test(id);
}
function isValidToken(token?: string): boolean {
if (!token) {
return false;
}
const regex = new RegExp(`^${TOKEN_PATH_PATTERN}$`);
return regex.test(token);
}
export function parseDeepLink(deepLinkUrl: string, asServer = false): DeepLinkWithData {
try {
const parsedUrl = urlParse(deepLinkUrl, true);
const urlWithoutQuery = stripTrailingSlashes(parsedUrl.protocol + '//' + parsedUrl.host + parsedUrl.pathname);
const url = removeProtocol(urlWithoutQuery);
const channelMatch = matchChannelDeeplink(url);
if (channelMatch && isValidTeamName(channelMatch.params.teamName) && isValidIdentifierPathPattern(channelMatch.params.identifier)) {
const {params: {serverUrl, teamName, path, identifier}} = channelMatch;
if (path === 'channels') {
return {type: DeepLink.Channel, url: deepLinkUrl, data: {serverUrl: serverUrl.join('/'), teamName, channelName: identifier}};
}
if (path === 'messages') {
if (identifier.startsWith('@')) {
return {type: DeepLink.DirectMessage, url: deepLinkUrl, data: {serverUrl: serverUrl.join('/'), teamName, userName: identifier.substring(1)}};
}
return {type: DeepLink.GroupMessage, url: deepLinkUrl, data: {serverUrl: serverUrl.join('/'), teamName, channelName: identifier}};
}
}
const permalinkMatch = matchPermalinkDeeplink(url);
if (permalinkMatch && isValidTeamName(permalinkMatch.params.teamName) && isValidId(permalinkMatch.params.postId)) {
const {params: {serverUrl, teamName, postId}} = permalinkMatch;
return {type: DeepLink.Permalink, url: deepLinkUrl, data: {serverUrl: serverUrl.join('/'), teamName, postId}};
}
const playbooksMatch = matchPlaybooksDeeplink(url);
if (playbooksMatch && isValidId(playbooksMatch.params.playbookId)) {
const {params: {serverUrl, playbookId}} = playbooksMatch;
return {type: DeepLink.Playbooks, url: deepLinkUrl, data: {serverUrl: serverUrl.join('/'), playbookId}};
}
const playbooksRunsRetrospectiveMatch = matchPlaybookRunsRetrospectiveDeeplink(url);
if (playbooksRunsRetrospectiveMatch && isValidId(playbooksRunsRetrospectiveMatch.params.playbookRunId)) {
const {params: {serverUrl, playbookRunId}} = playbooksRunsRetrospectiveMatch;
return {type: DeepLink.PlaybookRunsRetrospective, url: deepLinkUrl, data: {serverUrl: serverUrl.join('/'), playbookRunId}};
}
const playbooksRunsMatch = matchPlaybookRunsDeeplink(url);
if (playbooksRunsMatch && isValidId(playbooksRunsMatch.params.playbookRunId)) {
const {params: {serverUrl, playbookRunId}} = playbooksRunsMatch;
return {type: DeepLink.PlaybookRuns, url: deepLinkUrl, data: {serverUrl: serverUrl.join('/'), playbookRunId}};
}
const magicLinkMatch = matchMagicLinkDeeplink(url);
if (magicLinkMatch) {
const token = parsedUrl.query.t;
const {params: {serverUrl}} = magicLinkMatch;
if (!isValidToken(token)) {
return {type: DeepLink.Invalid, url: deepLinkUrl};
}
return {type: DeepLink.MagicLink, url: deepLinkUrl, data: {serverUrl: serverUrl.join('/'), token}};
}
if (asServer) {
const serverMatch = extractServerUrl(url);
if (serverMatch) {
return {type: DeepLink.Server, url: deepLinkUrl, data: {serverUrl: serverMatch}};
}
}
} catch (err) {
// do nothing just return invalid deeplink
}
return {type: DeepLink.Invalid, url: deepLinkUrl};
}
export function matchDeepLink(url: string, serverURL?: string, siteURL?: string) {
if (!url || (!serverURL && !siteURL)) {
return null;
}
let urlToMatch = url;
const urlBase = serverURL || siteURL || '';
const parsedUrl = urlParse(url);
if (!parsedUrl.protocol) {
// If url doesn't contain site or server URL, tack it on.
// e.g. <jump to convo> URLs from autolink plugin.
const deepLinkMatch = new RegExp(escapeRegex(urlBase)).exec(url);
if (!deepLinkMatch) {
urlToMatch = urlBase + url;
}
}
const parsed = parseDeepLink(urlToMatch);
if (parsed.type === DeepLinkType.Invalid) {
return null;
}
return parsed;
}
export const getLaunchPropsFromDeepLink = (deepLinkUrl: string, coldStart = false): LaunchProps => {
const parsed = parseDeepLink(deepLinkUrl, coldStart);
const launchProps: LaunchProps = {
launchType: Launch.DeepLink,
coldStart,
};
switch (parsed.type) {
case DeepLink.Invalid:
launchProps.launchError = true;
launchProps.extra = parsed;
break;
default: {
launchProps.extra = parsed;
break;
}
}
return launchProps;
};
export function alertInvalidDeepLink(intl: IntlShape) {
const message = defineMessage({
id: 'mobile.deep_link.invalid',
defaultMessage: 'This link you are trying to open is invalid.',
});
return alertErrorWithFallback(intl, {}, message);
}