60 lines
1.8 KiB
JavaScript
60 lines
1.8 KiB
JavaScript
// 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 preferences.
|
|
* @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 (userId, preferences = []) => {
|
|
try {
|
|
const response = await client.put(
|
|
`/api/v4/users/${userId}/preferences`,
|
|
preferences,
|
|
);
|
|
|
|
return {status: response.status};
|
|
} catch (err) {
|
|
return getResponseFromError(err);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Save the user's teams order preference.
|
|
* @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 = (userId, orderedTeamIds = []) => {
|
|
const preference = {
|
|
user_id: userId,
|
|
category: 'teams_order',
|
|
name: '',
|
|
value: orderedTeamIds.toString(),
|
|
};
|
|
|
|
return apiSaveUserPreferences(userId, [preference]);
|
|
};
|
|
|
|
export const Preference = {
|
|
apiSaveUserPreferences,
|
|
apiSaveTeamsOrderPreference,
|
|
};
|
|
|
|
export default Preference;
|