PageEditorByHackmd.tsx 15 KB

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