Truncate content (description/comment)

- since we apply a quote header to the original, we may hit the limit and an update will fail

Author: marko-bekhta

src/main/java/org/hibernate/infra/sync/jira/service/jira/handler/JiraCommentUpsertEventHandler.java

@@ -58,11 +58,12 @@ private JiraComment prepareComment(JiraIssue issue, JiraComment source) {
 	private String prepareCommentQuote(JiraIssue issue, JiraComment comment) {
 		URI jiraCommentUri = createJiraCommentUri(issue, comment);
 		URI jiraUserUri = createJiraUserUri(comment.self, comment.author);
-		return """
+		String content = """
 				{quote}This [comment|%s] was posted by the [user %s|%s].{quote}
 
 
 				""".formatted(jiraCommentUri, JiraTextContent.userIdPart(comment.author), jiraUserUri);
+		return truncateContent(content);
 	}
 
 	@Override

src/main/java/org/hibernate/infra/sync/jira/service/jira/handler/JiraEventHandler.java

@@ -19,6 +19,7 @@
 import jakarta.ws.rs.core.UriBuilder;
 
 public abstract class JiraEventHandler implements Runnable {
+	protected static final int MAX_CONTENT_SIZE = 65_535;
 
 	protected final Long objectId;
 	protected final FailureCollector failureCollector;
@@ -162,6 +163,21 @@ public final void run() {
 
 	protected abstract void doRun();
 
+	protected String truncateContent(String content) {
+		// NOTE: description/comment content has a limit, and maybe the original one is
+		// close to that limit but since we modify it with the quote info we better make
+		// sure we are still able to fit the content and truncate anything at the end
+		// (we have a link to the original if we want to read that very last part).
+		//
+		// A possible exception returned by the API:
+		// {"errorMessages":[],"errors":{"description":"The entered text is too long. It
+		// exceeds the allowed limit of 65,535 characters."}}
+		if (content.length() > MAX_CONTENT_SIZE) {
+			content = content.substring(0, MAX_CONTENT_SIZE);
+		}
+		return content;
+	}
+
 	protected String toDestinationKey(String key) {
 		if (keyToUpdatePattern.matcher(key).matches()) {
 			return "%s-%d".formatted(context.project().projectKey(), JiraIssue.keyToLong(key));

src/main/java/org/hibernate/infra/sync/jira/service/jira/handler/JiraIssueUpsertEventHandler.java

@@ -93,6 +93,7 @@ private JiraIssue issueToCreate(JiraIssue sourceIssue) {
 		destinationIssue.fields.description = sourceIssue.fields.description;
 		destinationIssue.fields.description = "%s%s".formatted(prepareDescriptionQuote(sourceIssue),
 				Objects.toString(sourceIssue.fields.description, ""));
+		destinationIssue.fields.description = truncateContent(destinationIssue.fields.description);
 
 		destinationIssue.fields.labels = sourceIssue.fields.labels;
 		// let's also add fix versions to the labels