Mailspring/internal_packages/composer/lib/composer-view.jsx
Juan Tejada a4ee61eadc fix(mail-merge): Refactor mass sending procedure
Summary:
This diff introduces several updates to mail merge to improve the procedure for sending a list of drafts.
Specifically, sending mass email will now:

- Clear mail merge metadata on the drafts that will actually be sent
- Upload attached files only /once/, and reuse those files on the drafts that will actually be sent
- Minimize database writes for new drafts being created
- Will queue a SendManyDraftsTask that will subsequently queue the necessary SendDraftTasks and keep track of them, and notify of any failed tasks

TODO:
- Add state to MailMerge plugin for failed sends and ability to attempt to re send them

Test Plan: - TODO

Reviewers: evan, bengotow, jackie

Reviewed By: bengotow, jackie

Subscribers: jackie

Differential Revision: https://phab.nylas.com/D2973
2016-05-24 17:22:09 -07:00

653 lines
19 KiB
JavaScript

import _ from 'underscore';
import React from 'react';
import ReactDOM from 'react-dom';
import {remote} from 'electron'
import {
Utils,
Actions,
DraftStore,
UndoManager,
DraftHelpers,
FileDownloadStore,
QuotedHTMLTransformer,
} from 'nylas-exports';
import {
DropZone,
RetinaImg,
ScrollRegion,
TabGroupRegion,
InjectedComponent,
KeyCommandsRegion,
OverlaidComponents,
InjectedComponentSet,
} from 'nylas-component-kit';
import FileUpload from './file-upload';
import ImageFileUpload from './image-file-upload';
import ComposerEditor from './composer-editor';
import ComposerHeader from './composer-header';
import SendActionButton from './send-action-button';
import ActionBarPlugins from './action-bar-plugins'
import Fields from './fields';
// The ComposerView is a unique React component because it (currently) is a
// singleton. Normally, the React way to do things would be to re-render the
// Composer with new props.
export default class ComposerView extends React.Component {
static displayName = 'ComposerView';
static propTypes = {
session: React.PropTypes.object.isRequired,
draft: React.PropTypes.object.isRequired,
// Sometimes when changes in the composer happens it's desirable to
// have the parent scroll to a certain location. A parent component can
// pass a callback that gets called when this composer wants to be
// scrolled to.
scrollTo: React.PropTypes.func,
className: React.PropTypes.string,
}
constructor(props) {
super(props)
this.state = {
showQuotedText: DraftHelpers.isForwardedMessage(props.draft),
}
}
componentDidMount() {
if (this.props.session) {
this._setupForProps(this.props);
}
}
componentWillReceiveProps(nextProps) {
if (nextProps.session !== this.props.session) {
this._teardownForProps();
this._setupForProps(nextProps);
}
if (DraftHelpers.isForwardedMessage(this.props.draft) !== DraftHelpers.isForwardedMessage(nextProps.draft)) {
this.setState({
showQuotedText: DraftHelpers.isForwardedMessage(nextProps.draft),
});
}
}
componentWillUnmount() {
this._teardownForProps();
}
focus() {
if (this.props.draft.to.length === 0) {
this.refs.header.showAndFocusField(Fields.To);
} else if ((this.props.draft.subject || "").trim().length === 0) {
this.refs.header.showAndFocusField(Fields.Subject);
} else {
this.refs[Fields.Body].focus();
}
}
_keymapHandlers() {
return {
'composer:send-message': () => this._onPrimarySend(),
'composer:delete-empty-draft': () => {
if (this.props.draft.pristine) {
this._onDestroyDraft();
}
},
'composer:show-and-focus-bcc': () => this.refs.header.showAndFocusField(Fields.Bcc),
'composer:show-and-focus-cc': () => this.refs.header.showAndFocusField(Fields.Cc),
'composer:focus-to': () => this.refs.header.showAndFocusField(Fields.To),
"composer:show-and-focus-from": () => {},
"core:undo": (event) => {
event.preventDefault();
event.stopPropagation();
this.props.session.undo();
},
"core:redo": (event) => {
event.preventDefault();
event.stopPropagation();
this.props.session.redo();
},
};
}
_setupForProps({draft, session}) {
this.setState({
showQuotedText: Utils.isForwardedMessage(draft),
});
// TODO: This is a dirty hack to save selection state into the undo/redo
// history. Remove it if / when selection is written into the body with
// marker tags, or when selection is moved from `contenteditable.innerState`
// into a first-order part of the session state.
session._composerViewSelectionRetrieve = () => {
// Selection updates /before/ the contenteditable emits it's change event,
// so the selection that goes with the snapshot state is the previous one.
if (this.refs[Fields.Body].getPreviousSelection) {
return this.refs[Fields.Body].getPreviousSelection();
}
return null;
}
session._composerViewSelectionRestore = (selection) => {
this.refs[Fields.Body].setSelection(selection);
}
draft.files.forEach((file) => {
if (Utils.shouldDisplayAsImage(file)) {
Actions.fetchFile(file);
}
});
}
_teardownForProps() {
if (this.props.session) {
this.props.session._composerViewSelectionRestore = null;
this.props.session._composerViewSelectionRetrieve = null;
}
}
_renderContentScrollRegion() {
if (NylasEnv.isComposerWindow()) {
return (
<ScrollRegion className="compose-body-scroll" ref="scrollregion">
{this._renderContent()}
</ScrollRegion>
);
}
return this._renderContent();
}
_renderContent() {
return (
<div className="composer-centered">
<ComposerHeader
ref="header"
draft={this.props.draft}
session={this.props.session}
initiallyFocused={this.props.draft.to.length === 0}
/>
<div
className="compose-body"
ref="composeBody"
onMouseUp={this._onMouseUpComposerBody}
onMouseDown={this._onMouseDownComposerBody}
>
{this._renderBodyRegions()}
{this._renderFooterRegions()}
</div>
</div>
);
}
_renderBodyRegions() {
const exposedProps = {
draft: this.props.draft,
session: this.props.session,
}
return (
<div ref="composerBodyWrap" className="composer-body-wrap">
<OverlaidComponents exposedProps={exposedProps}>
{this._renderEditor()}
</OverlaidComponents>
{this._renderQuotedTextControl()}
{this._renderAttachments()}
</div>
);
}
_renderEditor() {
const exposedProps = {
body: this._removeQuotedText(this.props.draft.body),
draftClientId: this.props.draft.clientId,
parentActions: {
getComposerBoundingRect: this._getComposerBoundingRect,
scrollTo: this.props.scrollTo,
},
onFilePaste: this._onFilePaste,
onBodyChanged: this._onBodyChanged,
};
return (
<InjectedComponent
ref={Fields.Body}
className="body-field"
matching={{role: "Composer:Editor"}}
fallback={ComposerEditor}
requiredMethods={[
'focus',
'focusAbsoluteEnd',
'getPreviousSelection',
'setSelection',
'_onDOMMutated',
]}
exposedProps={exposedProps}
/>
);
}
// The contenteditable decides when to request a scroll based on the
// position of the cursor and its relative distance to this composer
// component. We provide it our boundingClientRect so it can calculate
// this value.
_getComposerBoundingRect = () => {
return ReactDOM.findDOMNode(this.refs.composerWrap).getBoundingClientRect()
}
_removeQuotedText = (html) => {
const {showQuotedText} = this.state;
return showQuotedText ? html : QuotedHTMLTransformer.removeQuotedHTML(html);
}
_showQuotedText = (html) => {
const {showQuotedText} = this.state;
return showQuotedText ? html : QuotedHTMLTransformer.appendQuotedHTML(html, this.props.draft.body);
}
_renderQuotedTextControl() {
if (QuotedHTMLTransformer.hasQuotedHTML(this.props.draft.body)) {
return (
<a className="quoted-text-control" onClick={this._onToggleQuotedText}>
<span className="dots">&bull;&bull;&bull;</span>
</a>
);
}
return false;
}
_onToggleQuotedText = () => {
this.setState({showQuotedText: !this.state.showQuotedText});
}
_renderFooterRegions() {
return (
<div className="composer-footer-region">
<InjectedComponentSet
matching={{role: "Composer:Footer"}}
exposedProps={{
draft: this.props.draft,
threadId: this.props.draft.threadId,
draftClientId: this.props.draft.clientId,
session: this.props.session,
}}
direction="column"
/>
</div>
);
}
_renderAttachments() {
return (
<div className="attachments-area">
{this._renderFileAttachments()}
{this._renderUploadAttachments()}
</div>
);
}
_renderFileAttachments() {
const {files} = this.props.draft;
const nonImageFiles = this._nonImageFiles(files).map(file =>
this._renderFileAttachment(file, "Attachment")
);
const imageFiles = this._imageFiles(files).map(file =>
this._renderFileAttachment(file, "Attachment:Image")
);
return nonImageFiles.concat(imageFiles);
}
_renderFileAttachment(file, role) {
const props = {
file: file,
removable: true,
targetPath: FileDownloadStore.pathForFile(file),
messageClientId: this.props.draft.clientId,
};
const className = (role === "Attachment") ? "file-wrap" : "file-wrap file-image-wrap";
return (
<InjectedComponent
key={file.id}
matching={{role}}
className={className}
exposedProps={props}
/>
);
}
_renderUploadAttachments() {
const {uploads} = this.props.draft;
const nonImageUploads = this._nonImageFiles(uploads).map(upload =>
<FileUpload key={upload.id} upload={upload} />
);
const imageUploads = this._imageFiles(uploads).map(upload =>
<ImageFileUpload key={upload.id} upload={upload} />
);
return nonImageUploads.concat(imageUploads);
}
_imageFiles(files) {
return _.filter(files, Utils.shouldDisplayAsImage);
}
_nonImageFiles(files) {
return _.reject(files, Utils.shouldDisplayAsImage);
}
_renderActionsWorkspaceRegion() {
return (
<InjectedComponentSet
matching={{role: "Composer:ActionBarWorkspace"}}
exposedProps={{
draft: this.props.draft,
threadId: this.props.draft.threadId,
draftClientId: this.props.draft.clientId,
session: this.props.session,
}}
/>
)
}
_renderActionsRegion() {
return (
<div className="composer-action-bar-content">
<ActionBarPlugins
draft={this.props.draft}
session={this.props.session}
isValidDraft={this._isValidDraft}
/>
<button
tabIndex={-1}
className="btn btn-toolbar btn-trash"
style={{order: 100}}
title="Delete draft"
onClick={this._onDestroyDraft}
>
<RetinaImg name="icon-composer-trash.png" mode={RetinaImg.Mode.ContentIsMask} />
</button>
<button
tabIndex={-1}
className="btn btn-toolbar btn-attach"
style={{order: 50}}
title="Attach file"
onClick={this._onSelectAttachment}
>
<RetinaImg name="icon-composer-attachment.png" mode={RetinaImg.Mode.ContentIsMask} />
</button>
<div style={{order: 0, flex: 1}} />
<InjectedComponent
ref="sendActionButton"
tabIndex={-1}
style={{order: -100}}
matching={{role: "Composer:SendActionButton"}}
fallback={SendActionButton}
requiredMethods={[
'primaryClick',
]}
exposedProps={{
draft: this.props.draft,
draftClientId: this.props.draft.clientId,
session: this.props.session,
isValidDraft: this._isValidDraft,
}}
/>
</div>
);
}
// This lets us click outside of the `contenteditable`'s `contentBody`
// and simulate what happens when you click beneath the text *in* the
// contentEditable.
// Unfortunately, we need to manually keep track of the "click" in
// separate mouseDown, mouseUp events because we need to ensure that the
// start and end target are both not in the contenteditable. This ensures
// that this behavior doesn't interfear with a click and drag selection.
_onMouseDownComposerBody = (event) => {
if (ReactDOM.findDOMNode(this.refs[Fields.Body]).contains(event.target)) {
this._mouseDownTarget = null;
} else {
this._mouseDownTarget = event.target;
}
}
_inFooterRegion(el) {
return el.closest && el.closest(".composer-footer-region, .overlaid-components")
}
_onMouseUpComposerBody = (event) => {
if (event.target === this._mouseDownTarget && !this._inFooterRegion(event.target)) {
// We don't set state directly here because we want the native
// contenteditable focus behavior. When the contenteditable gets focused
// the focused field state will be properly set via editor.onFocus
this.refs[Fields.Body].focusAbsoluteEnd();
}
this._mouseDownTarget = null;
}
_onMouseMoveComposeBody = () => {
if (this._mouseComposeBody === "down") {
this._mouseComposeBody = "move";
}
}
_shouldAcceptDrop = (event) => {
// Ensure that you can't pick up a file and drop it on the same draft
const nonNativeFilePath = this._nonNativeFilePathForDrop(event);
const hasNativeFile = event.dataTransfer.files.length > 0;
const hasNonNativeFilePath = nonNativeFilePath !== null;
return hasNativeFile || hasNonNativeFilePath;
}
_nonNativeFilePathForDrop = (event) => {
if (event.dataTransfer.types.includes("text/nylas-file-url")) {
const downloadURL = event.dataTransfer.getData("text/nylas-file-url");
const downloadFilePath = downloadURL.split('file://')[1];
if (downloadFilePath) {
return downloadFilePath;
}
}
// Accept drops of images from within the app
if (event.dataTransfer.types.includes("text/uri-list")) {
const uri = event.dataTransfer.getData('text/uri-list')
if (uri.indexOf('file://') === 0) {
return decodeURI(uri.split('file://')[1]);
}
}
return null;
}
_onDrop = (event) => {
const {clientId} = this.props.draft;
// Accept drops of real files from other applications
for (const file of Array.from(event.dataTransfer.files)) {
Actions.addAttachment({filePath: file.path, messageClientId: clientId});
}
// Accept drops from attachment components / images within the app
const uri = this._nonNativeFilePathForDrop(event);
if (uri) {
Actions.addAttachment({filePath: uri, messageClientId: clientId});
}
}
_onFilePaste = (path) => {
Actions.addAttachment({filePath: path, messageClientId: this.props.draft.clientId});
}
_onBodyChanged = (event) => {
this.props.session.changes.add({body: this._showQuotedText(event.target.value)});
return;
}
_isValidDraft = (options = {}) => {
// We need to check the `DraftStore` because the `DraftStore` is
// immediately and synchronously updated as soon as this function
// fires. Since `setState` is asynchronous, if we used that as our only
// check, then we might get a false reading.
if (DraftStore.isSendingDraft(this.props.draft.clientId)) {
return false;
}
const dialog = remote.dialog;
const {session} = this.props
const {errors, warnings} = session.validateDraftForSending()
if (errors.length > 0) {
dialog.showMessageBox(remote.getCurrentWindow(), {
type: 'warning',
buttons: ['Edit Message', 'Cancel'],
message: 'Cannot Send',
detail: errors[0],
});
return false;
}
if ((warnings.length > 0) && (!options.force)) {
const response = dialog.showMessageBox(remote.getCurrentWindow(), {
type: 'warning',
buttons: ['Send Anyway', 'Cancel'],
message: 'Are you sure?',
detail: `Send ${warnings.join(' and ')}?`,
});
if (response === 0) { // response is button array index
return this._isValidDraft({force: true});
}
return false;
}
return true;
}
_onPrimarySend = () => {
this.refs.sendActionButton.primaryClick();
}
_onDestroyDraft = () => {
Actions.destroyDraft(this.props.draft.clientId);
}
_onSelectAttachment = () => {
Actions.selectAttachment({messageClientId: this.props.draft.clientId});
}
undo = (event) => {
event.preventDefault();
event.stopPropagation();
const historyItem = this.undoManager.undo() || {};
if (!historyItem.state) {
return;
}
this._recoveredSelection = historyItem.currentSelection;
this._applyChanges(historyItem.state, {fromUndoManager: true});
this._recoveredSelection = null;
}
redo = (event) => {
event.preventDefault();
event.stopPropagation();
const historyItem = this.undoManager.redo() || {}
if (!historyItem.state) {
return;
}
this._recoveredSelection = historyItem.currentSelection;
this._applyChanges(historyItem.state, {fromUndoManager: true});
this._recoveredSelection = null;
}
_getSelections = () => {
const bodyComponent = this.refs[Fields.Body];
return {
currentSelection: bodyComponent.getCurrentSelection ? bodyComponent.getCurrentSelection() : null,
previousSelection: bodyComponent.getPreviousSelection ? bodyComponent.getPreviousSelection() : null,
}
}
_saveToHistory = (selections) => {
const {previousSelection, currentSelection} = selections || this._getSelections();
const historyItem = {
previousSelection,
currentSelection,
state: {
body: _.clone(this.props.draft.body),
subject: _.clone(this.props.draft.subject),
to: _.clone(this.props.draft.to),
cc: _.clone(this.props.draft.cc),
bcc: _.clone(this.props.draft.bcc),
},
}
const lastState = this.undoManager.current()
if (lastState) {
lastState.currentSelection = historyItem.previousSelection;
}
this.undoManager.saveToHistory(historyItem);
}
render() {
const dropCoverDisplay = this.state.isDropping ? 'block' : 'none';
return (
<div className={this.props.className}>
<KeyCommandsRegion
localHandlers={this._keymapHandlers()}
className={"message-item-white-wrap composer-outer-wrap"}
tabIndex="-1"
ref="composerWrap"
>
<TabGroupRegion className="composer-inner-wrap">
<DropZone
className="composer-inner-wrap"
shouldAcceptDrop={this._shouldAcceptDrop}
onDragStateChange={({isDropping}) => this.setState({isDropping})}
onDrop={this._onDrop}
>
<div className="composer-drop-cover" style={{display: dropCoverDisplay}}>
<div className="centered">
<RetinaImg
name="composer-drop-to-attach.png"
mode={RetinaImg.Mode.ContentIsMask}
/>
Drop to attach
</div>
</div>
<div className="composer-content-wrap">
{this._renderContentScrollRegion()}
</div>
<div className="composer-action-bar-workspace-wrap">
{this._renderActionsWorkspaceRegion()}
</div>
<div className="composer-action-bar-wrap">
{this._renderActionsRegion()}
</div>
</DropZone>
</TabGroupRegion>
</KeyCommandsRegion>
</div>
);
}
}