@faable/auth-sdk 2.6.22 → 2.6.23

package/dist/error_handler.d.ts

@@ -1,5 +1,27 @@
 import type { AxiosError } from "axios";
+/**
+ * El error que lanza el SDK cuando la API responde con un fallo.
+ *
+ * ⚠️ **`error_code` es la parte con la que se ramifica, no el mensaje.** El
+ * `message` de la API está escrito para que lo lea una persona y puede cambiar
+ * —de hecho cambia: el de teléfono inválido se reescribió el 17-09 para que se
+ * entendiera en el formulario de un tenant que lo pintaba literal—. Hasta esa
+ * fecha este error aplanaba la respuesta en un string y se llevaba por delante
+ * el `error_code`, así que quien integraba no tenía más remedio que comparar
+ * textos en inglés. Ahora viajan también `status`, `error_code` y el cuerpo
+ * entero.
+ */
 export declare class FaableApiError extends Error {
-    constructor(msg: string);
+    /** Código HTTP de la respuesta, cuando la hubo. */
+    readonly status?: number;
+    /** Código estable del error (`invalid_phone`, `sms_unavailable:plan`, …). */
+    readonly error_code?: string;
+    /** Cuerpo de la respuesta tal cual, por si hace falta algo más. */
+    readonly body?: unknown;
+    constructor(msg: string, details?: {
+        status?: number;
+        error_code?: string;
+        body?: unknown;
+    });
 }
 export declare const handleErrorInterceptor: (e: AxiosError) => Promise<never>;

package/dist/error_handler.js

@@ -1,11 +1,36 @@
+/**
+ * El error que lanza el SDK cuando la API responde con un fallo.
+ *
+ * ⚠️ **`error_code` es la parte con la que se ramifica, no el mensaje.** El
+ * `message` de la API está escrito para que lo lea una persona y puede cambiar
+ * —de hecho cambia: el de teléfono inválido se reescribió el 17-09 para que se
+ * entendiera en el formulario de un tenant que lo pintaba literal—. Hasta esa
+ * fecha este error aplanaba la respuesta en un string y se llevaba por delante
+ * el `error_code`, así que quien integraba no tenía más remedio que comparar
+ * textos en inglés. Ahora viajan también `status`, `error_code` y el cuerpo
+ * entero.
+ */
 export class FaableApiError extends Error {
-    constructor(msg) {
+    /** Código HTTP de la respuesta, cuando la hubo. */
+    status;
+    /** Código estable del error (`invalid_phone`, `sms_unavailable:plan`, …). */
+    error_code;
+    /** Cuerpo de la respuesta tal cual, por si hace falta algo más. */
+    body;
+    constructor(msg, details = {}) {
         super(msg);
         this.name = "FaableApiError";
+        this.status = details.status;
+        this.error_code = details.error_code;
+        this.body = details.body;
         Object.setPrototypeOf(this, FaableApiError.prototype);
     }
 }
 export const handleErrorInterceptor = async (e) => {
     const data = e.response?.data;
-    throw new FaableApiError(`FaableApiError: ${data?.message} (status=${e.response?.status}, url=${e.response?.config.url})`);
+    throw new FaableApiError(`FaableApiError: ${data?.message} (status=${e.response?.status}, url=${e.response?.config.url})`, {
+        status: e.response?.status,
+        error_code: data?.error_code,
+        body: data
+    });
 };

package/dist/version.js

@@ -9,13 +9,13 @@
 // login pages could not import the SDK at all. Same pattern as auth-js.
 //
 // The sentinels MUST stay byte-identical to the `from` values in `.releaserc`.
-export const version = "2.6.22";
+export const version = "2.6.23";
 // Short git SHA of the released commit. The version dates a build; this names
 // the exact tree, so a canonical log line or an audit entry leads straight to
 // `git show <sha>`. Deliberately NOT hex: an unreleased build (dev, a local
 // link) cannot be mistaken for a real commit — auth only records values that
 // look like a SHA, and this one never will.
-export const commit = "12fba1d";
+export const commit = "65b2a2d";
 // What this SDK writes in `x-faable-client`. Exported for a consumer that
 // builds a strategy on its own (outside `FaableAuthApi`) and still wants the
 // token request attributed — a bare `authClientCredentials` stamps only what

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faable/auth-sdk",
-  "version": "2.6.22",
+  "version": "2.6.23",
   "author": "Marc Pomar <marc@faable.com>",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",