attlaz-client 1.75.0 → 1.76.0

package/dist/Http/ClientError.d.ts

@@ -3,6 +3,20 @@ export declare class ClientError extends Error {
     message: string;
     response: unknown;
     constructor(message: string, httpErrorCode?: number | null);
+    /**
+     * Type guard: true when `error` is a ClientError (or a subclass such as ApiError). Use it to
+     * narrow before reading typed fields (`httpStatus`, `message`, …). Relies on instanceof, which
+     * is reliable when there's a single copy of this package (e.g. a bundled web app). For a status
+     * check that must survive multiple package copies / realm boundaries, prefer statusOf().
+     */
+    static is(error: unknown): error is ClientError;
+    /**
+     * The HTTP status carried by a ClientError/ApiError, or null for anything else (e.g. a plain
+     * Error or a non-error value). Robust across module/realm boundaries: when instanceof fails
+     * (two copies of this package in one process) it falls back to reading a numeric httpStatus
+     * field. This is the safe way to ask "what status did this error carry?".
+     */
+    static statusOf(error: unknown): number | null;
     static fromError(error: Error): ClientError;
     static byStatus(statusCode: number, statusText: string): ClientError | null;
 }

package/dist/Http/ClientError.js

@@ -8,6 +8,28 @@ export class ClientError extends Error {
         this.message = message;
         this.httpStatus = httpErrorCode;
     }
+    /**
+     * Type guard: true when `error` is a ClientError (or a subclass such as ApiError). Use it to
+     * narrow before reading typed fields (`httpStatus`, `message`, …). Relies on instanceof, which
+     * is reliable when there's a single copy of this package (e.g. a bundled web app). For a status
+     * check that must survive multiple package copies / realm boundaries, prefer statusOf().
+     */
+    static is(error) {
+        return error instanceof ClientError;
+    }
+    /**
+     * The HTTP status carried by a ClientError/ApiError, or null for anything else (e.g. a plain
+     * Error or a non-error value). Robust across module/realm boundaries: when instanceof fails
+     * (two copies of this package in one process) it falls back to reading a numeric httpStatus
+     * field. This is the safe way to ask "what status did this error carry?".
+     */
+    static statusOf(error) {
+        if (error instanceof ClientError) {
+            return error.httpStatus;
+        }
+        const status = error?.httpStatus;
+        return typeof status === 'number' ? status : null;
+    }
     static fromError(error) {
         // Already a ClientError (or a subclass such as ApiError) — preserve it as-is.
         if (error instanceof ClientError) {

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.74.0";
+export declare const VERSION = "1.76.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "1.74.0";
+export const VERSION = "1.76.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "attlaz-client",
-  "version": "1.75.0",
+  "version": "1.76.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",