PageEditorByHackmd.tsx 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510
  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 { 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 { setRemoteLatestPageData } = useSetRemoteLatestPageData();
  74. const hackmdEditorRef = useRef<HackEditorRef>(null);
  75. const updateStateAfterSave = useCallback(async(pageId: string) => {
  76. // update swr 'currentPageId', 'currentPage', remote states
  77. await mutateCurrentPageId(pageId);
  78. const updatedPage = await mutatePageData();
  79. if (updatedPage == null) { return }
  80. const remoterevisionData = {
  81. remoteRevisionId: updatedPage.revision._id,
  82. remoteRevisionBody: updatedPage.revision.body,
  83. remoteRevisionLastUpdateUser: updatedPage.lastUpdateUser,
  84. remoteRevisionLastUpdatedAt: updatedPage.updatedAt,
  85. revisionIdHackmdSynced: updatedPage.revisionHackmdSynced.toString(),
  86. hasDraftOnHackmd: updatedPage.hasDraftOnHackmd,
  87. };
  88. setRemoteLatestPageData(remoterevisionData);
  89. }, [mutateCurrentPageId, mutatePageData, setRemoteLatestPageData]);
  90. const saveAndReturnToViewHandler = useCallback(async(opts?: {overwriteScopesOfDescendants: boolean}) => {
  91. if (editorMode !== EditorMode.HackMD) { return }
  92. try {
  93. if (isSlackEnabled == null || currentPathname == null || slackChannels == null || grant == null
  94. || revision == null || hackmdEditorRef.current == null || revisionIdHackmdSynced == null) {
  95. throw new Error('Some materials to save are invalid');
  96. }
  97. const optionsToSave: OptionsToSave = {
  98. isSlackEnabled,
  99. slackChannels,
  100. grant: grant.grant,
  101. grantUserGroupId: grant.grantedGroup?.id,
  102. grantUserGroupName: grant.grantedGroup?.name,
  103. pageTags: pageTags ?? [],
  104. isSyncRevisionToHackmd: true,
  105. ...opts,
  106. };
  107. const markdown = await hackmdEditorRef.current.getValue();
  108. const { page } = await saveOrUpdate(markdown, { pageId, path: currentPagePath || currentPathname, revisionId: revisionIdHackmdSynced }, optionsToSave);
  109. await mutatePageData();
  110. await mutateTagsInfo();
  111. if (page == null) {
  112. return;
  113. }
  114. if (isNotFound) {
  115. await router.push(`/${page._id}`);
  116. }
  117. else {
  118. updateStateAfterSave(page._id);
  119. }
  120. setIsInitialized(false);
  121. mutateEditorMode(EditorMode.View);
  122. }
  123. catch (error) {
  124. logger.error('failed to save', error);
  125. toastError(error.message);
  126. }
  127. // eslint-disable-next-line max-len
  128. }, [editorMode, isSlackEnabled, currentPathname, slackChannels, grant, revision, revisionIdHackmdSynced, pageTags, saveOrUpdate, pageId, currentPagePath, mutatePageData, mutateTagsInfo, isNotFound, mutateEditorMode, router, updateStateAfterSave]);
  129. // set handler to save and reload Page
  130. useEffect(() => {
  131. globalEmitter.on('saveAndReturnToView', saveAndReturnToViewHandler);
  132. return function cleanup() {
  133. globalEmitter.removeListener('saveAndReturnToView', saveAndReturnToViewHandler);
  134. };
  135. }, [saveAndReturnToViewHandler]);
  136. const resetInitializedStatusHandler = useCallback(() => {
  137. setIsInitialized(false);
  138. }, []);
  139. // set handler to save and reload Page
  140. useEffect(() => {
  141. globalEmitter.on('resetInitializedHackMdStatus', resetInitializedStatusHandler);
  142. return function cleanup() {
  143. globalEmitter.removeListener('resetInitializedHackMdStatus', resetInitializedStatusHandler);
  144. };
  145. }, [resetInitializedStatusHandler]);
  146. const isResume = useCallback(() => {
  147. const isPageExistsOnHackmd = (pageIdOnHackmd != null);
  148. return (isPageExistsOnHackmd && hasDraftOnHackmd) || isHackmdDraftUpdatingInRealtime;
  149. }, [hasDraftOnHackmd, isHackmdDraftUpdatingInRealtime, pageIdOnHackmd]);
  150. const startToEdit = useCallback(async() => {
  151. if (hackmdUri == null) {
  152. // do nothing
  153. return;
  154. }
  155. setIsInitialized(false);
  156. setIsInitializing(true);
  157. try {
  158. const res = await apiPost<IResHackmdIntegrated>('/hackmd.integrate', { pageId });
  159. if (!res.ok) {
  160. throw new Error(res.error);
  161. }
  162. mutatePageIdOnHackmd(res.pageIdOnHackmd);
  163. mutateRevisionIdHackmdSynced(res.revisionIdHackmdSynced);
  164. }
  165. catch (err) {
  166. toastError(err.message);
  167. setHasError(true);
  168. setErrorMessage('GROWI server failed to connect to HackMD.');
  169. setErrorReason(err.toString());
  170. }
  171. setIsInitialized(true);
  172. setIsInitializing(false);
  173. }, [pageId, hackmdUri, mutatePageIdOnHackmd, mutateRevisionIdHackmdSynced]);
  174. /**
  175. * Start to edit w/o any api request
  176. */
  177. const resumeToEdit = useCallback(() => {
  178. setIsInitialized(true);
  179. }, []);
  180. const discardChanges = useCallback(async() => {
  181. if (pageId == null) { return }
  182. try {
  183. const res = await apiPost<IResHackmdDiscard>('/hackmd.discard', { pageId });
  184. if (!res.ok) {
  185. throw new Error(res.error);
  186. }
  187. mutateIsHackmdDraftUpdatingInRealtime(false);
  188. mutateHasDraftOnHackmd(false);
  189. mutatePageIdOnHackmd(res.pageIdOnHackmd);
  190. mutateRemoteRevisionId(res.revisionIdHackmdSynced);
  191. mutateRevisionIdHackmdSynced(res.revisionIdHackmdSynced);
  192. }
  193. catch (err) {
  194. logger.error(err);
  195. toastError(err.message);
  196. }
  197. }, [mutateIsHackmdDraftUpdatingInRealtime, mutateHasDraftOnHackmd, mutatePageIdOnHackmd, mutateRevisionIdHackmdSynced, mutateRemoteRevisionId, pageId]);
  198. /**
  199. * save and update state of containers
  200. * @param {string} markdown
  201. */
  202. const onSaveWithShortcut = useCallback(async(markdown) => {
  203. try {
  204. const currentPagePathOrPathname = currentPagePath || currentPathname;
  205. if (
  206. isSlackEnabled == null || grant == null || slackChannels == null || pageId == null
  207. || revisionIdHackmdSynced == null || currentPagePathOrPathname == null
  208. ) { throw new Error('Some materials to save are invalid') }
  209. const optionsToSave = {
  210. isSlackEnabled,
  211. slackChannels,
  212. grant: grant.grant,
  213. grantUserGroupId: grant.grantedGroup?.id,
  214. grantUserGroupName: grant.grantedGroup?.name,
  215. pageTags: pageTags ?? [],
  216. isSyncRevisionToHackmd: true,
  217. };
  218. const res = await saveOrUpdate(markdown, { pageId, path: currentPagePathOrPathname, revisionId: revisionIdHackmdSynced }, optionsToSave);
  219. // update pageData
  220. mutatePageData(res);
  221. // set updated data
  222. // remote更新する必要がある
  223. updateStateAfterSave(res._id);
  224. mutateTagsInfo();
  225. logger.debug('success to save');
  226. toastSuccess(t('successfully_saved_the_page'));
  227. }
  228. catch (error) {
  229. logger.error('failed to save', error);
  230. toastError(error.message);
  231. }
  232. }, [
  233. currentPagePath, currentPathname, isSlackEnabled, grant, slackChannels, pageId, revisionIdHackmdSynced,
  234. pageTags, saveOrUpdate, mutatePageData, updateStateAfterSave, mutateTagsInfo, t,
  235. ]);
  236. /**
  237. * onChange event of HackmdEditor handler
  238. */
  239. const hackmdEditorChangeHandler = useCallback(async(body) => {
  240. if (hackmdUri == null || pageId == null) {
  241. // do nothing
  242. return;
  243. }
  244. if (revision?.body === body) {
  245. return;
  246. }
  247. try {
  248. await apiPost('/hackmd.saveOnHackmd', { pageId });
  249. }
  250. catch (err) {
  251. logger.error(err);
  252. }
  253. }, [pageId, revision?.body, hackmdUri]);
  254. const penpalErrorOccuredHandler = useCallback((error) => {
  255. toastError(error.message);
  256. setHasError(true);
  257. setErrorMessage(t('hackmd.fail_to_connect'));
  258. setErrorReason(error.toString());
  259. }, [t]);
  260. const renderPreInitContent = useCallback(() => {
  261. const isPageNotFound = pageId == null;
  262. let content;
  263. /*
  264. * HackMD is not setup
  265. */
  266. if (hackmdUri == null) {
  267. content = (
  268. <div>
  269. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> { t('hackmd.not_set_up')}</p>
  270. {/* eslint-disable-next-line react/no-danger */}
  271. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_associate_with_growi_to_use_hackmd_refer_to_this') }} />
  272. </div>
  273. );
  274. }
  275. /*
  276. * used HackMD from NotFound Page
  277. */
  278. else if (isPageNotFound) {
  279. content = (
  280. <div className="text-center">
  281. <p className="hackmd-status-label">
  282. <i className="fa fa-file-text mr-2" />
  283. { t('hackmd.used_for_not_found') }
  284. </p>
  285. {/* eslint-disable-next-line react/no-danger */}
  286. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_make_page') }} />
  287. </div>
  288. );
  289. }
  290. /*
  291. * Resume to edit or discard changes
  292. */
  293. else if (isResume()) {
  294. const isHackmdDocumentOutdated = revisionIdHackmdSynced !== remoteRevisionId;
  295. content = (
  296. <div>
  297. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  298. <p className="text-center"><strong>{t('hackmd.unsaved_draft')}</strong></p>
  299. { isHackmdDocumentOutdated && (
  300. <div className="card border-warning">
  301. <div className="card-header bg-warning"><i className="icon-fw icon-info"></i> {t('hackmd.draft_outdated')}</div>
  302. <div className="card-body text-center">
  303. {t('hackmd.based_on_revision')}&nbsp;
  304. { pageData != null && (
  305. <Link href={urljoin(returnPathForURL(pageData.path, pageData._id), `?revisionId=${revisionIdHackmdSynced}`)} prefetch={false}>
  306. <a><span className="badge badge-secondary">{revisionIdHackmdSynced?.substr(-8)}</span></a>
  307. </Link>
  308. )}
  309. <div className="text-center mt-3">
  310. <button
  311. className="btn btn-link btn-view-outdated-draft p-0"
  312. type="button"
  313. disabled={isInitializing}
  314. onClick={resumeToEdit}
  315. >
  316. {t('hackmd.view_outdated_draft')}
  317. </button>
  318. </div>
  319. </div>
  320. </div>
  321. ) }
  322. { !isHackmdDocumentOutdated && (
  323. <div className="text-center hackmd-resume-button-container mb-3">
  324. <button
  325. className="btn btn-success btn-lg waves-effect waves-light"
  326. type="button"
  327. disabled={isInitializing}
  328. onClick={resumeToEdit}
  329. >
  330. <span className="btn-label"><i className="icon-fw icon-control-end"></i></span>
  331. <span className="btn-text">{t('hackmd.resume_to_edit')}</span>
  332. </button>
  333. </div>
  334. ) }
  335. <div className="text-center hackmd-discard-button-container mb-3">
  336. <button
  337. className="btn btn-outline-secondary btn-lg waves-effect waves-light"
  338. type="button"
  339. onClick={discardChanges}
  340. >
  341. <span className="btn-label"><i className="icon-fw icon-control-start"></i></span>
  342. <span className="btn-text">{t('hackmd.discard_changes')}</span>
  343. </button>
  344. </div>
  345. </div>
  346. );
  347. }
  348. /*
  349. * Start to edit
  350. */
  351. else {
  352. const isRevisionOutdated = revision?._id !== remoteRevisionId;
  353. content = (
  354. <div>
  355. <p className="text-muted text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  356. <div className="text-center hackmd-start-button-container mb-3">
  357. <button
  358. className="btn btn-info btn-lg waves-effect waves-light"
  359. type="button"
  360. disabled={isRevisionOutdated || isInitializing}
  361. onClick={startToEdit}
  362. >
  363. <span className="btn-label"><i className="icon-fw icon-paper-plane"></i></span>
  364. {t('hackmd.start_to_edit')}
  365. </button>
  366. </div>
  367. <p className="text-center">{t('hackmd.clone_page_content')}</p>
  368. </div>
  369. );
  370. }
  371. return (
  372. <div className="hackmd-preinit d-flex justify-content-center align-items-center">
  373. {content}
  374. </div>
  375. );
  376. // eslint-disable-next-line max-len
  377. }, [pageId, hackmdUri, isResume, t, revisionIdHackmdSynced, remoteRevisionId, pageData, returnPathForURL, isInitializing, resumeToEdit, discardChanges, revision?._id, startToEdit]);
  378. if (editorMode == null || revision == null) {
  379. return <></>;
  380. }
  381. let content;
  382. // TODO: typescriptize
  383. // using any because ref cann't used between FC and class conponent with type safe
  384. const AnyEditor = HackmdEditor as any;
  385. if (isInitialized && hackmdUri != null) {
  386. content = (
  387. <AnyEditor
  388. ref={hackmdEditorRef}
  389. hackmdUri={hackmdUri}
  390. pageIdOnHackmd={pageIdOnHackmd}
  391. initializationMarkdown={isResume() ? null : revision.body}
  392. onChange={hackmdEditorChangeHandler}
  393. onSaveWithShortcut={(document) => {
  394. onSaveWithShortcut(document);
  395. }}
  396. onPenpalErrorOccured={penpalErrorOccuredHandler}
  397. >
  398. </AnyEditor>
  399. );
  400. }
  401. else {
  402. content = renderPreInitContent();
  403. }
  404. return (
  405. <div className="position-relative">
  406. {content}
  407. { hasError && (
  408. <div className="hackmd-error position-absolute d-flex flex-column justify-content-center align-items-center">
  409. <div className="bg-box p-5 text-center">
  410. <h2 className="text-warning"><i className="icon-fw icon-exclamation"></i> {t('hackmd.integration_failed')}</h2>
  411. <h4>{errorMessage}</h4>
  412. <p className="card well text-danger">
  413. {errorReason}
  414. </p>
  415. {/* eslint-disable-next-line react/no-danger */}
  416. <p dangerouslySetInnerHTML={{ __html: t('hackmd.check_configuration') }} />
  417. </div>
  418. </div>
  419. ) }
  420. </div>
  421. );
  422. };