@nauticana/sail 1.1.14 → 1.1.16

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2026 Mustafa Karli
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nauticana/sail",
-  "version": "1.1.14",
+  "version": "1.1.16",
   "description": "Metadata-driven Angular component library for CRUD admin frontends backed by the keel Go backend. Tables, forms, navigation, OTP/2FA/social auth, billing, payout onboarding.",
   "main": "src/index.ts",
   "scripts": {

package/src/util/errors.ts

@@ -15,11 +15,36 @@ function asString(value: unknown): string | undefined {
   return typeof value === 'string' && value ? value : undefined;
 }
 
+function statusOf(err: unknown): number | undefined {
+  if (!err || typeof err !== 'object') return undefined;
+  const s = (err as { status?: unknown }).status;
+  return typeof s === 'number' ? s : undefined;
+}
+
+/**
+ * True when the browser never received a readable response — the network was
+ * down, a CORS rule blocked it, or the request was aborted. Angular collapses
+ * all three to status 0 with a ProgressEvent body, so this is the only signal
+ * available. Use it to offer a retry rather than reporting a backend rejection.
+ */
+export function isTransportFailure(err: unknown): boolean {
+  return statusOf(err) === 0;
+}
+
 /**
  * Human-readable message from any sail error shape — SailApiError (BackendService),
  * raw HttpErrorResponse (direct HttpClient calls), or plain Error.
+ *
+ * keel answers every rejection with an RFC 7807 body, so an error carrying no
+ * `detail` did not come from the API: either nothing reached it (status 0) or
+ * something in front of it replied with a body we cannot read. Both used to
+ * collapse into the caller's fallback, which reads as a backend rejection and
+ * hides the real fault; they are now reported distinctly.
  */
 export function errorDetail(err: unknown, fallback: string): string {
+  if (isTransportFailure(err)) {
+    return 'Cannot reach the server — the network or a CORS rule blocked the response.';
+  }
   const problem = problemOf(err);
   if (problem) {
     const message = asString(problem.detail) ?? asString(problem.title) ?? asString(problem.message);
@@ -28,7 +53,8 @@ export function errorDetail(err: unknown, fallback: string): string {
   if (err instanceof Error && err.message) {
     return err.message;
   }
-  return fallback;
+  const status = statusOf(err);
+  return status ? `${fallback} (HTTP ${status})` : fallback;
 }
 
 /** Stable machine-readable discriminator from a keel RFC 7807 response. */