valtech-components 2.0.839 → 2.0.840

package/lib/components/organisms/change-password-modal/change-password-modal.component.d.ts

@@ -49,7 +49,6 @@ export declare class ChangePasswordModalComponent {
     /** Modo actual — `loading` mientras se consulta `checkHasPassword()`. */
     readonly mode: import("@angular/core").Signal<PasswordModalMode>;
     private readonly _formState;
-    constructor();
     /** Traduce una clave del namespace `_auth`. */
     t(key: string): string;
     readonly formProps: import("@angular/core").Signal<FormMetadata>;

package/lib/services/errors/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Error interpretation helpers.
+ *
+ * `interpretError` normaliza cualquier error (HttpErrorResponse crudo,
+ * AuthError aplanado, Error de JS, o un valor arbitrario) a un
+ * `InterpretedError` con forma estable. Función pura, sin Angular DI.
+ */
+export { interpretError } from './interpret-error';
+export type { InterpretedError } from './interpret-error';

package/lib/services/errors/interpret-error.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Error interpretation helper for the Valtech factory.
+ *
+ * Todos los frontends del factory consumen la misma API (backend Go) y la misma
+ * librería. La lógica de interpretar errores debe vivir una sola vez, acá.
+ *
+ * El backend Go (`apperrors`) SIEMPRE devuelve errores como JSON:
+ *   { "code": string, "message": string, "operationId": string }
+ * donde `message` ya viene en español y es user-friendly.
+ *
+ * En Angular un error HTTP llega como `HttpErrorResponse` (body en `.error`).
+ * Un fallo de red es un `HttpErrorResponse` con `status === 0`.
+ *
+ * Además `AuthService.handleAuthError` aplana el `HttpErrorResponse` a un
+ * `AuthError { code, message }` (code/message al nivel superior). Por eso este
+ * helper acepta AMBAS formas — el crudo y el aplanado.
+ */
+/**
+ * Resultado normalizado de cualquier error. Garantiza una forma estable y
+ * predecible para que las webapps no tengan que hacer narrowing manual.
+ */
+export interface InterpretedError {
+    /** Código del backend, o el sentinel `'NETWORK'` / `'UNKNOWN'`. */
+    code: string;
+    /** Mensaje del backend (español, user-friendly) o un genérico en español. */
+    message: string;
+    /** `operationId` del backend, si vino. Útil para soporte / tracing. */
+    operationId?: string;
+    /** HTTP status, si aplica (`0` para fallos de red). */
+    status?: number;
+    /** `true` si fue un fallo de red (status 0 / sin respuesta). */
+    isNetwork: boolean;
+}
+/**
+ * Normaliza CUALQUIER error a un `InterpretedError`.
+ *
+ * Función pura — sin dependencias de Angular DI, testeable y usable desde
+ * cualquier lado (componentes, servicios, interceptores, scripts).
+ *
+ * Nunca lanza: siempre devuelve un `InterpretedError` válido.
+ *
+ * Casos cubiertos:
+ * - `HttpErrorResponse` con `status === 0` (o sin respuesta) → fallo de red.
+ * - `HttpErrorResponse` con body `{ code, message, operationId }` del backend.
+ * - `AuthError` aplanado `{ code, message }` (code/message top-level).
+ * - `Error` plano de JS → `code: 'UNKNOWN'`, `message: err.message`.
+ * - Cualquier otra cosa (string, null, undefined, objeto raro) → genérico.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await firstValueFrom(this.http.get(url));
+ * } catch (err) {
+ *   const e = interpretError(err);
+ *   if (e.isNetwork) {
+ *     this.toast.show({ message: e.message, color: 'dark' });
+ *   } else {
+ *     this.errorCode.set(e.code);
+ *   }
+ * }
+ * ```
+ */
+export declare function interpretError(err: unknown): InterpretedError;

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "2.0.839";
+export declare const VERSION = "2.0.840";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.839",
+  "version": "2.0.840",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -255,6 +255,7 @@ export * from './lib/services/navigation';
 export * from './lib/services/theme.service';
 export * from './lib/services/toast.service';
 export * from './lib/services/types';
+export * from './lib/services/errors';
 export * from './lib/services/confirmation-dialog/confirmation-dialog.service';
 export * from './lib/services/confirmation-dialog/types';
 export * from './lib/services/qr-generator/qr-generator.service';