@seedgrid/fe-core 2026.6.5 → 2026.6.7

package/dist/http/api-errors.d.ts

@@ -19,6 +19,12 @@ export declare function isApiClientErrorLike(error: unknown): error is ApiClient
  * Cai no `.message` do próprio erro só quando não há payload de problema.
  */
 export declare function extractApiErrorMessage(error: unknown): string | null;
+/**
+ * Mensagem amigável (pt-BR) para um HTTP status, usada quando o corpo do erro não
+ * traz mensagem própria. Exposta para fluxos `fetch` crus (que têm o
+ * `response.status` mas não um `ApiClientError`).
+ */
+export declare function messageForHttpStatus(status: number): string;
 /**
  * Mensagem a partir de UM corpo já em mãos (objeto problem+json, ou string JSON que
  * parseie em um). Texto simples não-JSON -> o próprio texto; objeto sem mensagem

package/dist/http/api-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-errors.d.ts","sourceRoot":"","sources":["../../src/http/api-errors.ts"],"names":[],"mappings":"AAiCA,KAAK,kBAAkB,GAAG;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,kBAAkB,CAE7B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAapE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMhE"}
+{"version":3,"file":"api-errors.d.ts","sourceRoot":"","sources":["../../src/http/api-errors.ts"],"names":[],"mappings":"AAiCA,KAAK,kBAAkB,GAAG;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,kBAAkB,CAE7B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAcpE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2B3D;AASD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMhE"}

package/dist/http/api-errors.js

@@ -16,15 +16,55 @@ export function extractApiErrorMessage(error) {
     if (fromProblem) {
         return fromProblem;
     }
-    // Sem payload de problema útil: cai no `.message` do erro APENAS quando não é um
-    // erro do httpclient. O ApiClientError carrega `responseBody` e tem `.message`
-    // genérico ("API request failed with status N") — devolver isso vazaria texto
-    // técnico e impediria o fallback amigável por-ação do chamador; então retorna null.
-    if (isRecord(error) && "responseBody" in error) {
-        return null;
-    }
+    // Sem mensagem no corpo: muitos erros (401/403/404/5xx) vêm SEM corpo. Em vez de
+    // vazar o `.message` genérico do ApiClientError ("API request failed with status N"),
+    // devolve uma mensagem amigável do HTTP status (ex.: 403 -> "Acesso negado").
+    const status = httpStatusOf(error);
+    if (status != null) {
+        return messageForHttpStatus(status);
+    }
+    // Erro sem status (rede / hand-thrown): cai no próprio `.message`.
     return pickString(readErrorMessage(error));
 }
+/**
+ * Mensagem amigável (pt-BR) para um HTTP status, usada quando o corpo do erro não
+ * traz mensagem própria. Exposta para fluxos `fetch` crus (que têm o
+ * `response.status` mas não um `ApiClientError`).
+ */
+export function messageForHttpStatus(status) {
+    switch (status) {
+        case 400:
+            return "Requisição inválida.";
+        case 401:
+            return "Sessão expirada. Faça login novamente.";
+        case 403:
+            return "Acesso negado.";
+        case 404:
+            return "Recurso não encontrado.";
+        case 408:
+        case 504:
+            return "Tempo de resposta esgotado. Tente novamente.";
+        case 409:
+            return "Conflito com o estado atual do recurso.";
+        case 422:
+            return "Não foi possível processar os dados enviados.";
+        case 429:
+            return "Muitas requisições. Aguarde um momento e tente novamente.";
+        case 503:
+            return "Serviço temporariamente indisponível. Tente novamente.";
+        default:
+            if (status >= 500) {
+                return "Erro no servidor. Tente novamente.";
+            }
+            return "Não foi possível concluir a operação.";
+    }
+}
+function httpStatusOf(error) {
+    if (isRecord(error) && typeof error.status === "number") {
+        return error.status;
+    }
+    return null;
+}
 /**
  * Mensagem a partir de UM corpo já em mãos (objeto problem+json, ou string JSON que
  * parseie em um). Texto simples não-JSON -> o próprio texto; objeto sem mensagem

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seedgrid/fe-core",
-  "version": "2026.6.5",
+  "version": "2026.6.7",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",