/* Copyright 2021 The Matrix.org Foundation C.I.C. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ import React, { useRef, useState, Dispatch, SetStateAction } from "react"; import { Room } from "matrix-js-sdk/src/matrix"; import { logger } from "matrix-js-sdk/src/logger"; import { _t } from "../../../languageHandler"; import { IDialogProps } from "./IDialogProps"; import BaseDialog from "./BaseDialog"; import DialogButtons from "../elements/DialogButtons"; import Field from "../elements/Field"; import StyledRadioGroup from "../elements/StyledRadioGroup"; import StyledCheckbox from "../elements/StyledCheckbox"; import { ExportFormat, ExportType, textForFormat, textForType, } from "../../../utils/exportUtils/exportUtils"; import withValidation, { IFieldState, IValidationResult } from "../elements/Validation"; import HTMLExporter from "../../../utils/exportUtils/HtmlExport"; import JSONExporter from "../../../utils/exportUtils/JSONExport"; import PlainTextExporter from "../../../utils/exportUtils/PlainTextExport"; import { useStateCallback } from "../../../hooks/useStateCallback"; import Exporter from "../../../utils/exportUtils/Exporter"; import Spinner from "../elements/Spinner"; import InfoDialog from "./InfoDialog"; import ChatExport from "../../../customisations/ChatExport"; import { validateNumberInRange } from "../../../utils/validate"; interface IProps extends IDialogProps { room: Room; } interface ExportConfig { exportFormat: ExportFormat; exportType: ExportType; numberOfMessages: number; sizeLimit: number; includeAttachments: boolean; setExportFormat?: Dispatch>; setExportType?: Dispatch>; setAttachments?: Dispatch>; setNumberOfMessages?: Dispatch>; setSizeLimit?: Dispatch>; } /** * Set up form state using "forceRoomExportParameters" or defaults * Form fields configured in ForceRoomExportParameters are not allowed to be edited * Only return change handlers for editable values */ const useExportFormState = (): ExportConfig => { const config = ChatExport.getForceChatExportParameters(); const [exportFormat, setExportFormat] = useState(config.format ?? ExportFormat.Html); const [exportType, setExportType] = useState(config.range ?? ExportType.Timeline); const [includeAttachments, setAttachments] = useState(config.includeAttachments ?? false); const [numberOfMessages, setNumberOfMessages] = useState(config.numberOfMessages ?? 100); const [sizeLimit, setSizeLimit] = useState(config.sizeMb ?? 8); return { exportFormat, exportType, includeAttachments, numberOfMessages, sizeLimit, setExportFormat: !config.format ? setExportFormat : undefined, setExportType: !config.range ? setExportType : undefined, setNumberOfMessages: !config.numberOfMessages ? setNumberOfMessages : undefined, setSizeLimit: !config.sizeMb ? setSizeLimit : undefined, setAttachments: config.includeAttachments === undefined ? setAttachments : undefined, }; }; const ExportDialog: React.FC = ({ room, onFinished }) => { const { exportFormat, exportType, includeAttachments, numberOfMessages, sizeLimit, setExportFormat, setExportType, setNumberOfMessages, setSizeLimit, setAttachments, } = useExportFormState(); const [isExporting, setExporting] = useState(false); const sizeLimitRef = useRef(); const messageCountRef = useRef(); const [exportProgressText, setExportProgressText] = useState(_t("Processing...")); const [displayCancel, setCancelWarning] = useState(false); const [exportCancelled, setExportCancelled] = useState(false); const [exportSuccessful, setExportSuccessful] = useState(false); const [exporter, setExporter] = useStateCallback( null, async (exporter: Exporter) => { await exporter?.export().then(() => { if (!exportCancelled) setExportSuccessful(true); }); }, ); const startExport = async () => { const exportOptions = { numberOfMessages, attachmentsIncluded: includeAttachments, maxSize: sizeLimit * 1024 * 1024, }; switch (exportFormat) { case ExportFormat.Html: setExporter( new HTMLExporter( room, ExportType[exportType], exportOptions, setExportProgressText, ), ); break; case ExportFormat.Json: setExporter( new JSONExporter( room, ExportType[exportType], exportOptions, setExportProgressText, ), ); break; case ExportFormat.PlainText: setExporter( new PlainTextExporter( room, ExportType[exportType], exportOptions, setExportProgressText, ), ); break; default: logger.error("Unknown export format"); return; } }; const onExportClick = async () => { const isValidSize = !setSizeLimit || (await sizeLimitRef.current.validate({ focused: false, })); if (!isValidSize) { sizeLimitRef.current.validate({ focused: true }); return; } if (exportType === ExportType.LastNMessages) { const isValidNumberOfMessages = await messageCountRef.current.validate({ focused: false }); if (!isValidNumberOfMessages) { messageCountRef.current.validate({ focused: true }); return; } } setExporting(true); await startExport(); }; const validateSize = withValidation({ rules: [ { key: "required", test({ value, allowEmpty }) { return allowEmpty || !!value; }, invalid: () => { const min = 1; const max = 2000; return _t("Enter a number between %(min)s and %(max)s", { min, max, }); }, }, { key: "number", test: ({ value }) => { const parsedSize = parseInt(value, 10); return validateNumberInRange(1, 2000)(parsedSize); }, invalid: () => { const min = 1; const max = 2000; return _t( "Size can only be a number between %(min)s MB and %(max)s MB", { min, max }, ); }, }, ], }); const onValidateSize = async (fieldState: IFieldState): Promise => { const result = await validateSize(fieldState); return result; }; const validateNumberOfMessages = withValidation({ rules: [ { key: "required", test({ value, allowEmpty }) { return allowEmpty || !!value; }, invalid: () => { const min = 1; const max = 10 ** 8; return _t("Enter a number between %(min)s and %(max)s", { min, max, }); }, }, { key: "number", test: ({ value }) => { const parsedSize = parseInt(value, 10); return validateNumberInRange(1, 10 ** 8)(parsedSize); }, invalid: () => { const min = 1; const max = 10 ** 8; return _t( "Number of messages can only be a number between %(min)s and %(max)s", { min, max }, ); }, }, ], }); const onValidateNumberOfMessages = async (fieldState: IFieldState): Promise => { const result = await validateNumberOfMessages(fieldState); return result; }; const onCancel = async () => { if (isExporting) setCancelWarning(true); else onFinished(false); }; const confirmCancel = async () => { await exporter?.cancelExport(); setExportCancelled(true); setExporting(false); setExporter(null); }; const exportFormatOptions = Object.keys(ExportFormat).map((format) => ({ value: ExportFormat[format], label: textForFormat(ExportFormat[format]), })); const exportTypeOptions = Object.keys(ExportType).map((type) => { return ( ); }); let messageCount = null; if (exportType === ExportType.LastNMessages && setNumberOfMessages) { messageCount = ( { setNumberOfMessages(parseInt(e.target.value)); }} /> ); } const sizePostFix = { _t("MB") }; if (exportCancelled) { // Display successful cancellation message return ( ); } else if (exportSuccessful) { // Display successful export message return ( ); } else if (displayCancel) { // Display cancel warning return (

{ _t( "Are you sure you want to stop exporting your data? If you do, you'll need to start over.", ) }

setCancelWarning(false)} onPrimaryButtonClick={confirmCancel} />
); } else { // Display export settings return ( { !isExporting ?

{ _t( "Select from the options below to export chats from your timeline", ) }

: null }
{ !!setExportFormat && <> { _t("Format") } setExportFormat(ExportFormat[key])} definitions={exportFormatOptions} /> } { !!setExportType && <> { _t("Messages") } { setExportType(ExportType[e.target.value]); }} > { exportTypeOptions } { messageCount } } { setSizeLimit && <> { _t("Size Limit") } setSizeLimit(parseInt(e.target.value))} /> } { setAttachments && <> setAttachments( (e.target as HTMLInputElement).checked, ) } > { _t("Include Attachments") } }
{ isExporting ? (

{ exportProgressText }

) : ( onFinished(false)} /> ) }
); } }; export default ExportDialog;