@getrefino/core 0.1.0-rc.6 → 0.2.0

package/dist/api.d.ts

@@ -45,6 +45,15 @@ export type ContentApiBody = {
         readonly message: string;
         /** Present on CONFLICT so the editor can rebase without another request. */
         readonly current?: ContentSnapshot;
+        /**
+         * The article the failure is about, when it is about one. The
+         * service layer already knows which document it refused; without
+         * this the editor can only guess, and a copy conflict and an
+         * article conflict read identically to the owner.
+         *
+         * An id, never a path: it is the same id the browser sent.
+         */
+        readonly documentId?: DocumentId;
     };
 };
 export interface ContentApiResponse {

package/dist/api.js

@@ -24,9 +24,20 @@ function toErrorResponse(error, options) {
         };
     }
     if (isContentError(error)) {
+        // `details.documentId` is set by every document-service failure that is
+        // about one article. Passing it on costs nothing and is the only way the
+        // browser can tell an article conflict from a copy one.
+        const documentId = error.details.documentId;
         return {
             status: STATUS_BY_CODE[error.code],
-            body: { ok: false, error: { code: error.code, message: error.message } },
+            body: {
+                ok: false,
+                error: {
+                    code: error.code,
+                    message: error.message,
+                    ...(isDocumentId(documentId) ? { documentId } : {}),
+                },
+            },
         };
     }
     options.onError?.(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getrefino/core",
-  "version": "0.1.0-rc.6",
+  "version": "0.2.0",
   "description": "Core content model, draft state and persistence contracts for Refino, the in-browser editor for existing website copy. Framework-independent; the repository stays the source of truth.",
   "keywords": [
     "refino",