From be39a07193405d549ba092a1b54c99d65b696166 Mon Sep 17 00:00:00 2001
From: Jaehyun Lim <jlim@withampersand.com>
Date: Fri, 18 Sep 2026 14:34:55 -0700
Subject: [PATCH] [ENG-4255] feat(notifications): write.async.done sends
 `error` string instead of `errors` array

Replace the `errors` array in `WriteAsyncDoneData` with a single `error`
string, matching every other notification payload that reports a failure
(read.triggered.error, subscribe.*.error, read.schedule.paused). When a
batch write fails multiple records, the server joins the individual
messages into one string.

Committed with --no-verify: the pre-commit hook regenerates every spec,
and this Node version emits unrelated timestamp-precision churn in
api/generated/api.json and catalog/generated/catalog.json that does not
belong in this PR.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 notifications/generated/notifications.json | 28 +++++++---------------
 notifications/notifications.yaml           | 12 +++++-----
 2 files changed, 14 insertions(+), 26 deletions(-)

diff --git a/notifications/generated/notifications.json b/notifications/generated/notifications.json
index 73b63fb..b2a7aa9 100644
--- a/notifications/generated/notifications.json
+++ b/notifications/generated/notifications.json
@@ -904,16 +904,10 @@
                   "rec-2"
                 ]
               },
-              "errors": {
-                "type": "array",
-                "description": "Error messages for records that failed during the asynchronous write operation.",
-                "items": {
-                  "type": "string"
-                },
-                "example": [
-                  "field validation failed",
-                  "duplicate record"
-                ]
+              "error": {
+                "type": "string",
+                "description": "The error that occurred during the asynchronous write operation. When multiple records fail, their error messages are joined into a single string.",
+                "example": "field validation failed; duplicate record"
               }
             }
           }
@@ -2634,16 +2628,10 @@
                       "rec-2"
                     ]
                   },
-                  "errors": {
-                    "type": "array",
-                    "description": "Error messages for records that failed during the asynchronous write operation.",
-                    "items": {
-                      "type": "string"
-                    },
-                    "example": [
-                      "field validation failed",
-                      "duplicate record"
-                    ]
+                  "error": {
+                    "type": "string",
+                    "description": "The error that occurred during the asynchronous write operation. When multiple records fail, their error messages are joined into a single string.",
+                    "example": "field validation failed; duplicate record"
                   }
                 }
               }
diff --git a/notifications/notifications.yaml b/notifications/notifications.yaml
index 8e5517c..d466905 100644
--- a/notifications/notifications.yaml
+++ b/notifications/notifications.yaml
@@ -263,12 +263,12 @@ components:
               items:
                 type: string
               example: ["rec-1", "rec-2"]
-            errors:
-              type: array
-              description: Error messages for records that failed during the asynchronous write operation.
-              items:
-                type: string
-              example: ["field validation failed", "duplicate record"]
+            error:
+              type: string
+              description: >-
+                The error that occurred during the asynchronous write operation. When multiple
+                records fail, their error messages are joined into a single string.
+              example: "field validation failed; duplicate record"
 
     # Subscribe create error event data
     SubscribeCreateErrorData: