PageEditorByHackmd.jsx 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482
  1. import React from 'react';
  2. import { useTranslation } from 'next-i18next';
  3. import PropTypes from 'prop-types';
  4. import AppContainer from '~/client/services/AppContainer';
  5. import EditorContainer from '~/client/services/EditorContainer';
  6. import PageContainer from '~/client/services/PageContainer';
  7. import { apiPost } from '~/client/util/apiv1-client';
  8. import { getOptionsToSave } from '~/client/util/editor';
  9. import { useCurrentPagePath, useCurrentPageId } from '~/stores/context';
  10. import {
  11. useSWRxSlackChannels, useIsSlackEnabled, usePageTagsForEditors, useIsEnabledUnsavedWarning,
  12. } from '~/stores/editor';
  13. import {
  14. useEditorMode, useSelectedGrant,
  15. } from '~/stores/ui';
  16. import loggerFactory from '~/utils/logger';
  17. import HackmdEditor from './PageEditorByHackmd/HackmdEditor';
  18. import { withUnstatedContainers } from './UnstatedUtils';
  19. const logger = loggerFactory('growi:PageEditorByHackmd');
  20. class PageEditorByHackmd extends React.Component {
  21. constructor(props) {
  22. super(props);
  23. this.state = {
  24. isInitialized: false,
  25. isInitializing: false,
  26. // for error
  27. hasError: false,
  28. errorMessage: '',
  29. errorReason: '',
  30. };
  31. this.getHackmdUri = this.getHackmdUri.bind(this);
  32. this.startToEdit = this.startToEdit.bind(this);
  33. this.resumeToEdit = this.resumeToEdit.bind(this);
  34. this.onSaveWithShortcut = this.onSaveWithShortcut.bind(this);
  35. this.hackmdEditorChangeHandler = this.hackmdEditorChangeHandler.bind(this);
  36. this.penpalErrorOccuredHandler = this.penpalErrorOccuredHandler.bind(this);
  37. }
  38. UNSAFE_componentWillMount() {
  39. this.props.appContainer.registerComponentInstance('PageEditorByHackmd', this);
  40. }
  41. /**
  42. * return markdown document of HackMD
  43. * @return {Promise<string>}
  44. */
  45. getMarkdown() {
  46. const { t } = this.props;
  47. if (!this.state.isInitialized) {
  48. return Promise.reject(new Error(t('hackmd.not_initialized')));
  49. }
  50. return this.hackmdEditor.getValue();
  51. }
  52. /**
  53. * reset initialized status
  54. */
  55. reset() {
  56. this.setState({ isInitialized: false });
  57. }
  58. getHackmdUri() {
  59. const envVars = this.props.appContainer.getConfig().env;
  60. return envVars.HACKMD_URI;
  61. }
  62. get isResume() {
  63. const { pageContainer } = this.props;
  64. const {
  65. pageIdOnHackmd, hasDraftOnHackmd, isHackmdDraftUpdatingInRealtime,
  66. } = pageContainer.state;
  67. const isPageExistsOnHackmd = (pageIdOnHackmd != null);
  68. return (isPageExistsOnHackmd && hasDraftOnHackmd) || isHackmdDraftUpdatingInRealtime;
  69. }
  70. /**
  71. * Start integration with HackMD
  72. */
  73. async startToEdit() {
  74. const { pageContainer } = this.props;
  75. const hackmdUri = this.getHackmdUri();
  76. if (hackmdUri == null) {
  77. // do nothing
  78. return;
  79. }
  80. this.setState({
  81. isInitialized: false,
  82. isInitializing: true,
  83. });
  84. const params = {
  85. pageId: pageContainer.state.pageId,
  86. };
  87. try {
  88. const res = await apiPost('/hackmd.integrate', params);
  89. if (!res.ok) {
  90. throw new Error(res.error);
  91. }
  92. await pageContainer.setState({
  93. pageIdOnHackmd: res.pageIdOnHackmd,
  94. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  95. });
  96. }
  97. catch (err) {
  98. pageContainer.showErrorToastr(err);
  99. this.setState({
  100. hasError: true,
  101. errorMessage: 'GROWI server failed to connect to HackMD.',
  102. errorReason: err.toString(),
  103. });
  104. }
  105. this.setState({
  106. isInitialized: true,
  107. isInitializing: false,
  108. });
  109. }
  110. /**
  111. * Start to edit w/o any api request
  112. */
  113. resumeToEdit() {
  114. this.setState({ isInitialized: true });
  115. }
  116. /**
  117. * Reset draft
  118. */
  119. async discardChanges() {
  120. const { pageContainer } = this.props;
  121. const { pageId } = pageContainer.state;
  122. try {
  123. const res = await apiPost('/hackmd.discard', { pageId });
  124. if (!res.ok) {
  125. throw new Error(res.error);
  126. }
  127. this.props.pageContainer.setState({
  128. isHackmdDraftUpdatingInRealtime: false,
  129. hasDraftOnHackmd: false,
  130. pageIdOnHackmd: res.pageIdOnHackmd,
  131. remoteRevisionId: res.revisionIdHackmdSynced,
  132. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  133. });
  134. }
  135. catch (err) {
  136. logger.error(err);
  137. pageContainer.showErrorToastr(err);
  138. }
  139. }
  140. /**
  141. * save and update state of containers
  142. * @param {string} markdown
  143. */
  144. async onSaveWithShortcut(markdown) {
  145. const {
  146. isSlackEnabled, slackChannels, pageContainer, editorContainer, grant, grantGroupId, grantGroupName, pageTags, mutateIsEnabledUnsavedWarning,
  147. } = this.props;
  148. const optionsToSave = getOptionsToSave(isSlackEnabled, slackChannels, grant, grantGroupId, grantGroupName, pageTags);
  149. try {
  150. // disable unsaved warning
  151. mutateIsEnabledUnsavedWarning(false);
  152. // eslint-disable-next-line no-unused-vars
  153. const { page, tags } = await pageContainer.save(markdown, this.props.editorMode, optionsToSave);
  154. logger.debug('success to save');
  155. pageContainer.showSuccessToastr();
  156. // update state of EditorContainer
  157. editorContainer.setState({ tags });
  158. }
  159. catch (error) {
  160. logger.error('failed to save', error);
  161. pageContainer.showErrorToastr(error);
  162. }
  163. }
  164. /**
  165. * onChange event of HackmdEditor handler
  166. */
  167. async hackmdEditorChangeHandler(body) {
  168. const hackmdUri = this.getHackmdUri();
  169. const { pageContainer, mutateIsEnabledUnsavedWarning } = this.props;
  170. if (hackmdUri == null) {
  171. // do nothing
  172. return;
  173. }
  174. // do nothing if contents are same
  175. if (pageContainer.state.markdown === body) {
  176. return;
  177. }
  178. // enable unsaved warning
  179. mutateIsEnabledUnsavedWarning(true);
  180. const params = {
  181. pageId: pageContainer.state.pageId,
  182. };
  183. try {
  184. await apiPost('/hackmd.saveOnHackmd', params);
  185. }
  186. catch (err) {
  187. logger.error(err);
  188. }
  189. }
  190. penpalErrorOccuredHandler(error) {
  191. const { pageContainer, t } = this.props;
  192. pageContainer.showErrorToastr(error);
  193. this.setState({
  194. hasError: true,
  195. errorMessage: t('hackmd.fail_to_connect'),
  196. errorReason: error.toString(),
  197. });
  198. }
  199. renderPreInitContent() {
  200. const hackmdUri = this.getHackmdUri();
  201. const { pageContainer, t } = this.props;
  202. const {
  203. revisionId, revisionIdHackmdSynced, remoteRevisionId, pageId,
  204. } = pageContainer.state;
  205. const isPageNotFound = pageId == null;
  206. let content;
  207. /*
  208. * HackMD is not setup
  209. */
  210. if (hackmdUri == null) {
  211. content = (
  212. <div>
  213. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> { t('hackmd.not_set_up')}</p>
  214. {/* eslint-disable-next-line react/no-danger */}
  215. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_associate_with_growi_to_use_hackmd_refer_to_this') }} />
  216. </div>
  217. );
  218. }
  219. /*
  220. * used HackMD from NotFound Page
  221. */
  222. else if (isPageNotFound) {
  223. content = (
  224. <div className="text-center">
  225. <p className="hackmd-status-label">
  226. <i className="fa fa-file-text mr-2" />
  227. { t('hackmd.used_for_not_found') }
  228. </p>
  229. {/* eslint-disable-next-line react/no-danger */}
  230. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_make_page') }} />
  231. </div>
  232. );
  233. }
  234. /*
  235. * Resume to edit or discard changes
  236. */
  237. else if (this.isResume) {
  238. const isHackmdDocumentOutdated = revisionIdHackmdSynced !== remoteRevisionId;
  239. content = (
  240. <div>
  241. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  242. <p className="text-center"><strong>{t('hackmd.unsaved_draft')}</strong></p>
  243. { isHackmdDocumentOutdated && (
  244. <div className="card border-warning">
  245. <div className="card-header bg-warning"><i className="icon-fw icon-info"></i> {t('hackmd.draft_outdated')}</div>
  246. <div className="card-body text-center">
  247. {t('hackmd.based_on_revision')}&nbsp;
  248. <a href={`?revision=${revisionIdHackmdSynced}`}><span className="badge badge-secondary">{revisionIdHackmdSynced.substr(-8)}</span></a>
  249. <div className="text-center mt-3">
  250. <button
  251. className="btn btn-link btn-view-outdated-draft p-0"
  252. type="button"
  253. disabled={this.state.isInitializing}
  254. onClick={() => { return this.resumeToEdit() }}
  255. >
  256. {t('hackmd.view_outdated_draft')}
  257. </button>
  258. </div>
  259. </div>
  260. </div>
  261. ) }
  262. { !isHackmdDocumentOutdated && (
  263. <div className="text-center hackmd-resume-button-container mb-3">
  264. <button
  265. className="btn btn-success btn-lg"
  266. type="button"
  267. disabled={this.state.isInitializing}
  268. onClick={() => { return this.resumeToEdit() }}
  269. >
  270. <span className="btn-label"><i className="icon-fw icon-control-end"></i></span>
  271. <span className="btn-text">{t('hackmd.resume_to_edit')}</span>
  272. </button>
  273. </div>
  274. ) }
  275. <div className="text-center hackmd-discard-button-container mb-3">
  276. <button
  277. className="btn btn-outline-secondary btn-lg"
  278. type="button"
  279. onClick={() => { return this.discardChanges() }}
  280. >
  281. <span className="btn-label"><i className="icon-fw icon-control-start"></i></span>
  282. <span className="btn-text">{t('hackmd.discard_changes')}</span>
  283. </button>
  284. </div>
  285. </div>
  286. );
  287. }
  288. /*
  289. * Start to edit
  290. */
  291. else {
  292. const isRevisionOutdated = revisionId !== remoteRevisionId;
  293. content = (
  294. <div>
  295. <p className="text-muted text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  296. <div className="text-center hackmd-start-button-container mb-3">
  297. <button
  298. className="btn btn-info btn-lg"
  299. type="button"
  300. disabled={isRevisionOutdated || this.state.isInitializing}
  301. onClick={() => { return this.startToEdit() }}
  302. >
  303. <span className="btn-label"><i className="icon-fw icon-paper-plane"></i></span>
  304. {t('hackmd.start_to_edit')}
  305. </button>
  306. </div>
  307. <p className="text-center">{t('hackmd.clone_page_content')}</p>
  308. </div>
  309. );
  310. }
  311. return (
  312. <div className="hackmd-preinit d-flex justify-content-center align-items-center">
  313. {content}
  314. </div>
  315. );
  316. }
  317. render() {
  318. const hackmdUri = this.getHackmdUri();
  319. const { pageContainer, t } = this.props;
  320. const {
  321. markdown, pageIdOnHackmd,
  322. } = pageContainer.state;
  323. let content;
  324. if (this.state.isInitialized) {
  325. content = (
  326. <HackmdEditor
  327. ref={(c) => { this.hackmdEditor = c }}
  328. hackmdUri={hackmdUri}
  329. pageIdOnHackmd={pageIdOnHackmd}
  330. initializationMarkdown={this.isResume ? null : markdown}
  331. onChange={this.hackmdEditorChangeHandler}
  332. onSaveWithShortcut={(document) => {
  333. this.onSaveWithShortcut(document);
  334. }}
  335. onPenpalErrorOccured={this.penpalErrorOccuredHandler}
  336. >
  337. </HackmdEditor>
  338. );
  339. }
  340. else {
  341. content = this.renderPreInitContent();
  342. }
  343. return (
  344. <div className="position-relative">
  345. {content}
  346. { this.state.hasError && (
  347. <div className="hackmd-error position-absolute d-flex flex-column justify-content-center align-items-center">
  348. <div className="bg-box p-5 text-center">
  349. <h2 className="text-warning"><i className="icon-fw icon-exclamation"></i> {t('hackmd.integration_failed')}</h2>
  350. <h4>{this.state.errorMessage}</h4>
  351. <p className="card well text-danger">
  352. {this.state.errorReason}
  353. </p>
  354. {/* eslint-disable-next-line react/no-danger */}
  355. <p dangerouslySetInnerHTML={{ __html: t('hackmd.check_configuration') }} />
  356. </div>
  357. </div>
  358. ) }
  359. </div>
  360. );
  361. }
  362. }
  363. PageEditorByHackmd.propTypes = {
  364. t: PropTypes.func.isRequired, // i18next
  365. appContainer: PropTypes.instanceOf(AppContainer).isRequired,
  366. pageContainer: PropTypes.instanceOf(PageContainer).isRequired,
  367. editorContainer: PropTypes.instanceOf(EditorContainer).isRequired,
  368. // TODO: remove this when omitting unstated is completed
  369. editorMode: PropTypes.string.isRequired,
  370. isSlackEnabled: PropTypes.bool.isRequired,
  371. pageTags: PropTypes.arrayOf(PropTypes.string),
  372. slackChannels: PropTypes.string.isRequired,
  373. grant: PropTypes.number.isRequired,
  374. grantGroupId: PropTypes.string,
  375. grantGroupName: PropTypes.string,
  376. mutateIsEnabledUnsavedWarning: PropTypes.func,
  377. };
  378. /**
  379. * Wrapper component for using unstated
  380. */
  381. const PageEditorByHackmdHOCWrapper = withUnstatedContainers(PageEditorByHackmd, [AppContainer, PageContainer, EditorContainer]);
  382. const PageEditorByHackmdWrapper = (props) => {
  383. const { t } = useTranslation();
  384. const { data: editorMode } = useEditorMode();
  385. const { data: currentPagePath } = useCurrentPagePath();
  386. const { data: slackChannelsData } = useSWRxSlackChannels(currentPagePath);
  387. const { data: isSlackEnabled } = useIsSlackEnabled();
  388. const { data: pageId } = useCurrentPageId();
  389. const { data: pageTags } = usePageTagsForEditors(pageId);
  390. const { data: grantData } = useSelectedGrant();
  391. const { mutate: mutateIsEnabledUnsavedWarning } = useIsEnabledUnsavedWarning();
  392. if (editorMode == null) {
  393. return null;
  394. }
  395. return (
  396. <PageEditorByHackmdHOCWrapper
  397. {...props}
  398. t={t}
  399. editorMode={editorMode}
  400. isSlackEnabled={isSlackEnabled}
  401. slackChannels={slackChannelsData.toString()}
  402. pageTags={pageTags}
  403. grant={grantData.grant}
  404. grantGroupId={grantData.grantGroup?.id}
  405. grantGroupName={grantData.grantedGroup?.name}
  406. mutateIsEnabledUnsavedWarning={mutateIsEnabledUnsavedWarning}
  407. />
  408. );
  409. };
  410. export default PageEditorByHackmdWrapper;