forked from Ivasoft/mattermost-mobile
1d9c371bfb
* Detox/E2E: Migrate to typescript * Add jest.config.js * Add moduleMapper to config.json * Add cookie jar to axios client, fix tsconfig.json and default_config.json * Take keyboard into consideration; clean test for now for this migration PR * Revert changes on path_builder * Attempt to fix dep issues * Update detox dep * Added missing @type dev dependencies * Fix dep order * Fix unit tests * Added dynamic year to email.ts
102 lines
3.3 KiB
TypeScript
102 lines
3.3 KiB
TypeScript
// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
|
|
// See LICENSE.txt for license information.
|
|
|
|
import client from './client';
|
|
import {getResponseFromError} from './common';
|
|
|
|
// ****************************************************************
|
|
// Preferences
|
|
// See https://api.mattermost.com/#tag/preferences
|
|
//
|
|
// Exported API function should have the following:
|
|
// - documented using JSDoc
|
|
// - meaningful description
|
|
// - match the referenced API endpoints
|
|
// - parameter/s defined by `@param`
|
|
// - return value defined by `@return`
|
|
// ****************************************************************
|
|
|
|
/**
|
|
* Save the user's favorite channel preference.
|
|
* @param {string} baseUrl - the base server URL
|
|
* @param {string} userId - the user ID
|
|
* @param {string} channelId - the channel id to be favorited
|
|
* @return {string} returns {status} on success or {error, status} on error
|
|
*/
|
|
export const apiSaveFavoriteChannelPreference = (baseUrl: string, userId: string, channelId: string): any => {
|
|
const preference = {
|
|
user_id: userId,
|
|
category: 'favorite_channel',
|
|
name: channelId,
|
|
value: 'true',
|
|
};
|
|
|
|
return apiSaveUserPreferences(baseUrl, userId, [preference]);
|
|
};
|
|
|
|
/**
|
|
* Save the user's teammate name display preference.
|
|
* @param {string} baseUrl - the base server URL
|
|
* @param {string} userId - the user ID
|
|
* @param {string} nameFormat - one of "username" (default), "nickname_full_name" or "full_name"
|
|
* @returns
|
|
*/
|
|
export const apiSaveTeammateNameDisplayPreference = (baseUrl: string, userId: string, nameFormat = 'username'): any => {
|
|
const preference = {
|
|
user_id: userId,
|
|
category: 'display_settings',
|
|
name: 'name_format',
|
|
value: nameFormat,
|
|
};
|
|
|
|
return apiSaveUserPreferences(baseUrl, userId, [preference]);
|
|
};
|
|
|
|
/**
|
|
* Save the user's teams order preference.
|
|
* @param {string} baseUrl - the base server URL
|
|
* @param {string} userId - the user ID
|
|
* @param {Array} orderedTeamIds - ordered array of team IDs
|
|
* @return {string} returns {status} on success or {error, status} on error
|
|
*/
|
|
export const apiSaveTeamsOrderPreference = (baseUrl: string, userId: string, orderedTeamIds: string[] = []): any => {
|
|
const preference = {
|
|
user_id: userId,
|
|
category: 'teams_order',
|
|
name: '',
|
|
value: orderedTeamIds.toString(),
|
|
};
|
|
|
|
return apiSaveUserPreferences(baseUrl, userId, [preference]);
|
|
};
|
|
|
|
/**
|
|
* Save the user's preferences.
|
|
* See https://api.mattermost.com/#operation/UpdatePreferences
|
|
* @param {string} baseUrl - the base server URL
|
|
* @param {string} userId - the user ID
|
|
* @param {Array} preferences - a list of user's preferences
|
|
* @return {string} returns {status} on success or {error, status} on error
|
|
*/
|
|
export const apiSaveUserPreferences = async (baseUrl: string, userId: string, preferences: any[] = []): Promise<any> => {
|
|
try {
|
|
const response = await client.put(
|
|
`${baseUrl}/api/v4/users/${userId}/preferences`,
|
|
preferences,
|
|
);
|
|
|
|
return {status: response.status};
|
|
} catch (err) {
|
|
return getResponseFromError(err);
|
|
}
|
|
};
|
|
|
|
export const Preference = {
|
|
apiSaveFavoriteChannelPreference,
|
|
apiSaveTeammateNameDisplayPreference,
|
|
apiSaveTeamsOrderPreference,
|
|
apiSaveUserPreferences,
|
|
};
|
|
|
|
export default Preference;
|