PageEditorByHackmd.tsx 17 KB

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