@labelgrid/core 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -8,6 +8,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 `@labelgrid/core` is primarily an internal shared client for the LabelGrid MCP
 server and CLI — there are no API-stability promises before 1.0.
 
+## [Unreleased]
+
+## [0.2.3] - 2026-09-30
+
+### Changed
+
+- Public API `error_code` and `details` fields are preserved on normalized
+  errors, including typed 404 and 5xx responses.
+- Normalized errors also preserve the API's `blocking_issues` field, which
+  lists the review issues that block a confirm-review request.
+
 ## [0.2.2] - 2026-08-20
 
 ### Added

package/dist/api/http.d.ts

@@ -15,6 +15,9 @@ export type ApiError = {
     suggestion?: string;
     retry_after_seconds?: number;
     errors?: unknown;
+    details?: unknown;
+    /** Actionable release-review issues returned when confirm-review is blocked. */
+    blocking_issues?: unknown;
     /** Structured validation detail passed through verbatim from the API (422). */
     errors_structured?: unknown;
 };

package/dist/api/http.js

@@ -56,8 +56,8 @@ function buildQuery(query) {
     return parts.length > 0 ? `?${parts.join('&')}` : '';
 }
 /**
- * Extracts a code/message/errors triple from any of the four backend error body
- * shapes: `{message}`, `{error: string}`, `{errors}`, `{error: {code, message}}`.
+ * Extracts typed fields from the backend's top-level and nested error shapes,
+ * including public `error_code` and `details` fields.
  */
 function extractServerError(body) {
     if (typeof body === 'string') {
@@ -69,11 +69,22 @@ function extractServerError(body) {
     const record = body;
     const errors = record.errors;
     const errorsStructured = record.errors_structured;
+    const details = record.details;
+    const blockingIssues = record.blocking_issues;
+    const topLevelCode = typeof record.error_code === 'string'
+        ? record.error_code
+        : typeof record.code === 'string'
+            ? record.code
+            : undefined;
     // Shape: { error: { code, message } }
     if (record.error !== null && typeof record.error === 'object') {
         const nested = record.error;
         return {
-            code: typeof nested.code === 'string' ? nested.code : undefined,
+            code: typeof nested.error_code === 'string'
+                ? nested.error_code
+                : typeof nested.code === 'string'
+                    ? nested.code
+                    : topLevelCode,
             message: typeof nested.message === 'string'
                 ? nested.message
                 : typeof nested.error === 'string'
@@ -81,24 +92,30 @@ function extractServerError(body) {
                     : undefined,
             errors,
             errors_structured: errorsStructured,
+            details,
+            blocking_issues: blockingIssues,
         };
     }
     // Shape: { error: 'string' }
     if (typeof record.error === 'string') {
         return {
-            code: typeof record.code === 'string' ? record.code : undefined,
+            code: topLevelCode,
             message: record.error,
             errors,
             errors_structured: errorsStructured,
+            details,
+            blocking_issues: blockingIssues,
         };
     }
     // Shapes: { message } and/or { errors } and/or top-level { code }
     const parts = {
-        code: typeof record.code === 'string' ? record.code : undefined,
+        code: topLevelCode,
         message: typeof record.message === 'string' ? record.message : undefined,
         field: typeof record.field === 'string' ? record.field : undefined,
         errors,
         errors_structured: errorsStructured,
+        details,
+        blocking_issues: blockingIssues,
     };
     // Derive a message from the first validation error when none was given.
     if (parts.message === undefined && errors !== null && typeof errors === 'object') {
@@ -129,6 +146,8 @@ function normalizeError(res, body) {
         status,
         ...(server.field !== undefined ? { field: server.field } : {}),
         ...(server.errors !== undefined ? { errors: server.errors } : {}),
+        ...(server.details !== undefined ? { details: server.details } : {}),
+        ...(server.blocking_issues !== undefined ? { blocking_issues: server.blocking_issues } : {}),
         ...extra,
     });
     switch (status) {
@@ -139,7 +158,7 @@ function normalizeError(res, body) {
         case 403:
             return withCommon(server.code ?? 'FORBIDDEN', server.message ?? 'Forbidden.');
         case 404:
-            return withCommon('NOT_FOUND', server.message ?? 'The requested resource was not found.');
+            return withCommon(server.code ?? 'NOT_FOUND', server.message ?? 'The requested resource was not found.');
         case 409:
             return withCommon(server.code ?? 'CONFLICT', server.message ?? 'The request conflicts with the current state.');
         case 422:
@@ -156,7 +175,7 @@ function normalizeError(res, body) {
         }
         default:
             if (status >= 500) {
-                return withCommon('SERVER_ERROR', server.message ?? 'The server encountered an error.');
+                return withCommon(server.code ?? 'SERVER_ERROR', server.message ?? 'The server encountered an error.');
             }
             return withCommon(server.code ?? 'ERROR', server.message ?? `Request failed with status ${status}.`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@labelgrid/core",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Shared LabelGrid public-API client: HTTP transport, uploads, content types, the catalog-entity registry, and redacting logging",
   "type": "module",
   "keywords": ["labelgrid", "music-distribution", "api-client"],