PageEditorByHackmd.tsx 13 KB

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