jiti-meet/react/features/feedback/actions.js

131 lines
4.2 KiB
JavaScript
Raw Normal View History

// @flow
2019-03-19 15:42:25 +00:00
import type { Dispatch } from 'redux';
2017-10-13 19:31:05 +00:00
import { openDialog } from '../base/dialog';
import { FEEDBACK_REQUEST_IN_PROGRESS } from '../../../modules/UI/UIErrors';
import { CANCEL_FEEDBACK, SUBMIT_FEEDBACK } from './actionTypes';
import { FeedbackDialog } from './components';
declare var config: Object;
declare var interfaceConfig: Object;
/**
* Caches the passed in feedback in the redux store.
*
* @param {number} score - The quality score given to the conference.
* @param {string} message - A description entered by the participant that
* explains the rating.
* @returns {{
* type: CANCEL_FEEDBACK,
* message: string,
* score: number
* }}
*/
export function cancelFeedback(score: number, message: string) {
return {
type: CANCEL_FEEDBACK,
message,
score
};
}
/**
* Potentially open the {@code FeedbackDialog}. It will not be opened if it is
* already open or feedback has already been submitted.
*
* @param {JistiConference} conference - The conference for which the feedback
* would be about. The conference is passed in because feedback can occur after
* a conference has been left, so references to it may no longer exist in redux.
* @returns {Promise} Resolved with value - false if the dialog is enabled and
* resolved with true if the dialog is disabled or the feedback was already
* submitted. Rejected if another dialog is already displayed.
*/
export function maybeOpenFeedbackDialog(conference: Object) {
type R = {
feedbackSubmitted: boolean,
showThankYou: boolean
};
2019-03-19 15:42:25 +00:00
return (dispatch: Dispatch<any>, getState: Function): Promise<R> => {
const state = getState();
if (interfaceConfig.filmStripOnly || config.iAmRecorder) {
// Intentionally fall through the if chain to prevent further action
// from being taken with regards to showing feedback.
} else if (state['features/base/dialog'].component === FeedbackDialog) {
// Feedback is currently being displayed.
return Promise.reject(FEEDBACK_REQUEST_IN_PROGRESS);
} else if (state['features/feedback'].submitted) {
// Feedback has been submitted already.
return Promise.resolve({
2017-10-13 19:31:05 +00:00
feedbackSubmitted: true,
showThankYou: true
});
} else if (conference.isCallstatsEnabled()) {
return new Promise(resolve => {
dispatch(openFeedbackDialog(conference, () => {
const { submitted } = getState()['features/feedback'];
resolve({
feedbackSubmitted: submitted,
showThankYou: false
});
}));
});
}
2017-10-13 19:31:05 +00:00
// If the feedback functionality isn't enabled we show a "thank you"
// message. Signaling it (true), so the caller of requestFeedback can
// act on it.
return Promise.resolve({
2017-10-13 19:31:05 +00:00
feedbackSubmitted: false,
showThankYou: true
});
};
}
/**
* Opens {@code FeedbackDialog}.
*
* @param {JitsiConference} conference - The JitsiConference that is being
* rated. The conference is passed in because feedback can occur after a
* conference has been left, so references to it may no longer exist in redux.
* @param {Function} [onClose] - An optional callback to invoke when the dialog
* is closed.
* @returns {Object}
*/
export function openFeedbackDialog(conference: Object, onClose: ?Function) {
return openDialog(FeedbackDialog, {
conference,
onClose
});
}
/**
* Send the passed in feedback.
*
* @param {number} score - An integer between 1 and 5 indicating the user
* feedback. The negative integer -1 is used to denote no score was selected.
* @param {string} message - Detailed feedback from the user to explain the
* rating.
* @param {JitsiConference} conference - The JitsiConference for which the
* feedback is being left.
* @returns {{
* type: SUBMIT_FEEDBACK
* }}
*/
export function submitFeedback(
score: number,
message: string,
conference: Object) {
conference.sendFeedback(score, message);
return {
type: SUBMIT_FEEDBACK
};
}