@fontoxml/fontoxml-development-tools/src/modules/editor/dev-cms/connectors-cms-standard/configureReviewAnnotationPostRouteHandler.js

Development tools for Fonto.

import asyncRouteWithLockCleanupHandler from '../asyncRouteWithLockCleanupHandler.js';
import httpStatusCodeHelpers from './review-annotations/httpStatusCodeHelpers.js';
import unmergeableRevisionList from './stores/unmergeableRevisionList.js';

/** @typedef {import('../../src/getAppConfig.js').DevCmsConfig} DevCmsConfig */

/**
 * @param {DevCmsConfig} config
 */
export default function configureReviewAnnotationPostRouteHandler(config) {
	return asyncRouteWithLockCleanupHandler(async (_acquireLock, req, res) => {
		const {
			context: { editSessionToken },
			annotation,
		} = req.body;

		if (!annotation) {
			res.status(400).send('Missing an "annotation" field in the request.');
			return;
		}

		const timeoutSet = await config.debugConfiguration.getTimeoutConfigForRoute(
			req.cms,
			editSessionToken,
			'/review/annotation',
			'POST',
		);
		if (timeoutSet) {
			// Do not handle the request, but let it time out.
			return new Promise(() => {});
		}

		const isDebuggingEnabled =
			await config.debugConfiguration.isDebuggingEnabled(
				req.cms,
				editSessionToken,
			);
		if (isDebuggingEnabled) {
			const stringToVerify = annotation.metadata.comment;
			const foundHttpStatusCode = httpStatusCodeHelpers.getDebugHttpStatusCode(
				stringToVerify,
				[400, 500],
			);
			if (foundHttpStatusCode && !foundHttpStatusCode.onDelete) {
				httpStatusCodeHelpers.sendDebugHttpResponse(res, foundHttpStatusCode);
				return;
			}
		}

		const currentSession = req.getFontoSession(editSessionToken);
		const annotations = await req.repositories.annotation.addAnnotations(
			req.cms,
			currentSession,
			[annotation],
		);

		const addedAnnotation = annotations[0];
		delete addedAnnotation.replies;

		// Revisions that are the created context of an annotation cannot be merged.
		unmergeableRevisionList.add(addedAnnotation.createdDocumentRevisionId);

		res
			.status(201)
			.set('content-type', 'application/json; charset=utf-8')
			.json({
				annotation: addedAnnotation,
			});
	});
}