PageEditorByHackmd.tsx 16 KB

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