backend-error 1.1.0 → 1.2.0

package/README.md

@@ -1,37 +1,58 @@
-# Backend-error
+# backend-error
 
-BackendError is a lightweight utility for structured and user-aware error handling in Node.js backends. It helps distinguish operational errors from unexpected crashes, and supports standardized error responses across services.
+![npm](https://img.shields.io/npm/v/backend-error)
+![downloads](https://img.shields.io/npm/dm/backend-error)
+![license](https://img.shields.io/npm/l/backend-error)
 
-> ⚠️ Note: backend-error is not a middleware — it's a flexible utility for throwing and formatting structured errors. It works seamlessly with Express, Cloud Functions, and any other Node.js-based backend environment where you want standardized, user-aware error responses.
+`backend-error` is a lightweight Node.js / TypeScript utility that formats all errors—custom or native—into standardized HTTP responses with correct status codes and user-friendly messages. The `httpErrorFormatter` ensures secure, consistent error output by controlling what is exposed to the frontend.
 
-> 💬 Tip: This package doesn't handle headers or CORS. If you're building an API for browsers, remember to configure CORS separately.
-
-[![GitHub package.json version (master)](https://img.shields.io/github/package-json/v/eriksturesson/backendError/master)](https://github.com/eriksturesson/backendError)
-[![npm](https://img.shields.io/npm/dy/backend-error?label=npm%20downloads)](https://www.npmjs.com/package/backend-error)
+---
 
-## Installation
+## 📦 Installation
 
 ```bash
 npm install backend-error
 ```
 
-## 🔥 Custom BackendError class
-
-Use `BackendError` class for standardized backend error handling:
+---
 
-## Usage
+## 🚀 Throw `BackendError`, catch with `httpErrorFormatter`
 
 ```ts
-import { BackendError } from "backend-error";
+import { BackendError, httpErrorFormatter } from "backend-error";
 
-throw BackendError.BadRequest("Missing required field");
+app.post("/signup", async (req, res) => {
+  try {
+    const auth = req.headers.authorization;
+    const { email, id } = req.body;
+    if (!auth) throw BackendError.Unauthorized("Missing auth token"); // 401, showUser:true
+    if (!email) throw BackendError.BadRequest("Email is required"); // 400, showUser:true
+    const user = await getUser(req.params.id);
+    if (!user) throw BackendError.NotFound("User not found"); // 404, showUser:true
+
+    // Normal logic...
+  } catch (err) {
+    const { status, body } = httpErrorFormatter(err); // Handles BackendError and native Error safely
+    res.status(status).json(body);
+  }
+});
 ```
 
-Or construct it manually for full control:
+✅ No manual showUser checks — handled automatically by the formatter  
+✅ Returns generic 500 for critical or unknown errors (or if `showUser` is false)  
+✅ Formatter supports both BackendError instances and native Error objects
+
+> The httpErrorFormatter inspects any error, formats it consistently, and decides what message is safe to show to users.
+
+---
+
+## ✨ Custom BackendError creation
+
+If you prefer, create your own error with full control including custom metadata:
 
 ```ts
 const error = new BackendError({
-  message: "Something went terribly wrong",
+  message: "Something went wrong",
   severity: "critical",
   showUser: true,
   code: 500,
@@ -39,35 +60,37 @@ const error = new BackendError({
 });
 ```
 
-Properties available:
+### Selected BackendError options
 
-- `message`: The error message
+- `message`: Error message
 - `code`: HTTP status code
-- `isOperational`: Marks it as a handled error (vs. crash)
-- `showUser`: Whether frontend should show the message
+- `showUser`: Whether to expose the message to frontend clients
 - `severity`: "info" | "warning" | "error" | "critical"
-- `data`: Additional metadata (optional and anything accepted)
+- `data`: Optional metadata
 
-## 🧠 Example where you also import `httpErrorFormatter`:
+---
+
+## ⚙️ Static error helpers
 
 ```ts
-import { BackendError, httpErrorFormatter } from "backend-error";
-try {
-  const user = null;
-  if (!user) throw BackendError.NotFound("User not found");
-  res.json(user);
-} catch (err) {
-  const { status, body, message, showUser } = await httpErrorFormatter(err);
-  res.status(status).json(body);
-}
+BackendError.BadRequest("..."); // 400, showUser: true
+BackendError.Unauthorized("..."); // 401, showUser: true
+BackendError.Forbidden("..."); // 403, showUser: true
+BackendError.NotFound("..."); // 404, showUser: true
+BackendError.Conflict("..."); // 409, showUser: true
+BackendError.UnprocessableEntity("..."); // 422, showUser: true
+BackendError.Internal("..."); // 500, showUser: false
+BackendError.ServiceUnavailable("..."); // 503, showUser: false
 ```
 
-## 🧠 Example of manual showUser handling (done automatically in httpErrorFormatter above)
+---
+
+## 🧠 Manual error handling (if not using `httpErrorFormatter`)
 
 ```ts
 import { BackendError } from "backend-error";
 
-app.get("/user/:id", async (req, res, next) => {
+app.get("/user/:id", async (req, res) => {
   try {
     const user = null;
     if (!user) throw BackendError.NotFound("User not found");
@@ -82,24 +105,13 @@ app.get("/user/:id", async (req, res, next) => {
 });
 ```
 
-## Available static error constructors
-
-- `BackendError.BadRequest(message: string)` // 400, showUser: true
-- `BackendError.Unauthorized(message: string)` // 401, showUser: true
-- `BackendError.Forbidden(message: string)` // 403, showUser: true
-- `BackendError.NotFound(message: string)` // 404, showUser: true
-- `BackendError.Conflict(message: string)` // 409, showUser: true
-- `BackendError.UnprocessableEntity(message: string)`// 422, showUser: true
-- `BackendError.Internal(message: string)` // 500, showUser: false
-- `BackendError.ServiceUnavailable(message: string)` // 503, showUser: false
+---
 
 ## 🧩 Types
 
 ```ts
 export type Severity = "info" | "warning" | "error" | "critical";
-```
 
-```ts
 export interface BackendErrorOptions {
   message: string;
   isOperational?: boolean;
@@ -110,29 +122,30 @@ export interface BackendErrorOptions {
 }
 ```
 
+---
+
 ## 🎨 Works well with [error-drawings](https://www.npmjs.com/package/error-drawings)
 
 ![GitHub package.json version (master)](https://img.shields.io/github/package-json/v/eriksturesson/errorDrawings/master)
 ![npm downloads](https://img.shields.io/npm/dy/error-drawings?label=npm%20downloads)
 
-`npm install error-drawings`
+```bash
+npm install error-drawings
+```
 
-If you want fun and visual error output during development, you can combine backend-error with error-drawings. Both libraries support the same severity field ("info" | "warning" | "error" | "critical"), making them plug-and-play together.
+Use for dev-friendly terminal logs — with a bit of dramatic flair for critical errors:
 
 ```ts
-import { BackendError } from "backend-error";
+import { BackendError, httpErrorFormatter } from "backend-error";
 import drawLog from "error-drawings";
 
 try {
   throw BackendError.Forbidden("No access to resource");
 } catch (err) {
   const isCritical = !(err instanceof BackendError && err.isOperational) || err.code >= 500;
-  if (isCritical) {
-    // 🔥 Draw dramatic error output to highlight critical issues during development
-    // 🧠 Important: log BEFORE formatting, since the formatter may hide details if showUser is false
-    drawLog(err);
-  }
-  const { status, body } = await httpErrorFormatter(err); //Use the formatter as always
+  if (isCritical) drawLog(err); // Dramatic terminal art for critical errors!
+
+  const { status, body } = httpErrorFormatter(err);
   res.status(status).json(body);
 }
 ```
@@ -141,8 +154,6 @@ try {
 
 ## 🌐 Repo
 
-[https://github.com/eriksturesson/backendError](https://github.com/eriksturesson/backendError)
-
----
+[GitHub](https://github.com/eriksturesson/backendError)
 
 Created by [@eriksturesson](https://eriksturesson.se)

package/dist/core/BackendError.js

@@ -1,60 +1,45 @@
-"use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BackendError = void 0;
-var BackendError = /** @class */ (function (_super) {
-    __extends(BackendError, _super);
-    function BackendError(options) {
-        var _this = this;
-        var _a, _b, _c;
-        _this = _super.call(this, options.message) || this;
-        _this.name = "BackendError";
-        _this.isOperational = (_a = options.isOperational) !== null && _a !== void 0 ? _a : true;
-        _this.showUser = (_b = options.showUser) !== null && _b !== void 0 ? _b : true;
-        _this.severity = (_c = options.severity) !== null && _c !== void 0 ? _c : "error";
-        _this.code = options.code;
-        _this.data = options.data;
-        Object.setPrototypeOf(_this, BackendError.prototype);
-        return _this;
-    }
-    BackendError.BadRequest = function (msg) {
-        return new BackendError({ message: msg, code: 400, severity: "warning", showUser: true });
-    };
-    BackendError.Unauthorized = function (msg) {
-        return new BackendError({ message: msg, code: 401, severity: "warning", showUser: true });
-    };
-    BackendError.Forbidden = function (msg) {
-        return new BackendError({ message: msg, code: 403, severity: "warning", showUser: true });
-    };
-    BackendError.NotFound = function (msg) {
-        return new BackendError({ message: msg, code: 404, severity: "warning", showUser: true });
-    };
-    BackendError.Conflict = function (msg) {
-        return new BackendError({ message: msg, code: 409, severity: "warning", showUser: true });
-    };
-    BackendError.UnprocessableEntity = function (msg) {
-        return new BackendError({ message: msg, code: 422, severity: "warning", showUser: true });
-    };
-    BackendError.Internal = function (msg) {
-        return new BackendError({ message: msg, code: 500, severity: "critical", showUser: false });
-    };
-    BackendError.ServiceUnavailable = function (msg) {
-        return new BackendError({ message: msg, code: 503, severity: "critical", showUser: false });
-    };
-    return BackendError;
-}(Error));
-exports.BackendError = BackendError;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendError = void 0;
+class BackendError extends Error {
+    constructor(options) {
+        var _a, _b, _c;
+        super(options.message);
+        this.name = "BackendError";
+        this.isOperational = (_a = options.isOperational) !== null && _a !== void 0 ? _a : true;
+        this.showUser = (_b = options.showUser) !== null && _b !== void 0 ? _b : true;
+        this.severity = (_c = options.severity) !== null && _c !== void 0 ? _c : "error";
+        this.code = options.code;
+        this.data = options.data;
+        Object.setPrototypeOf(this, BackendError.prototype);
+    }
+    static BadRequest(msg) {
+        return new BackendError({ message: msg, code: 400, severity: "warning", showUser: true });
+    }
+    static Unauthorized(msg) {
+        return new BackendError({ message: msg, code: 401, severity: "warning", showUser: true });
+    }
+    static Forbidden(msg) {
+        return new BackendError({ message: msg, code: 403, severity: "warning", showUser: true });
+    }
+    static NotFound(msg) {
+        return new BackendError({ message: msg, code: 404, severity: "warning", showUser: true });
+    }
+    static Conflict(msg) {
+        return new BackendError({ message: msg, code: 409, severity: "warning", showUser: true });
+    }
+    static UnprocessableEntity(msg) {
+        return new BackendError({ message: msg, code: 422, severity: "warning", showUser: true });
+    }
+    static Internal(msg) {
+        return new BackendError({ message: msg, code: 500, severity: "critical", showUser: false });
+    }
+    static ExternalAPI(msg, code = 502) {
+        return new BackendError({ message: msg, code, severity: "warning", showUser: true });
+    }
+    static ServiceUnavailable(msg) {
+        return new BackendError({ message: msg, code: 503, severity: "critical", showUser: false });
+    }
+}
+exports.BackendError = BackendError;
+//# sourceMappingURL=BackendError.js.map

package/dist/core/BackendError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackendError.js","sourceRoot":"","sources":["../../src/core/BackendError.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAa,SAAQ,KAAK;IAOrC,YAAY,OAA4B;;QACtC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAE3B,IAAI,CAAC,aAAa,GAAG,MAAA,OAAO,CAAC,aAAa,mCAAI,IAAI,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,MAAA,OAAO,CAAC,QAAQ,mCAAI,IAAI,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,MAAA,OAAO,CAAC,QAAQ,mCAAI,OAAO,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAEzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,GAAW;QAC3B,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,GAAW;QAC7B,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,GAAW;QAC1B,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,GAAW;QACzB,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,GAAW;QACzB,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,GAAW;QACpC,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,GAAW;QACzB,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,GAAW,EAAE,OAAe,GAAG;QAChD,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,GAAW;QACnC,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9F,CAAC;CACF;AAvDD,oCAuDC"}

package/dist/core/httpErrorFormatter.js

@@ -1,52 +1,47 @@
-"use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.httpErrorFormatter = void 0;
-var BackendError_1 = require("./BackendError");
-function isValidStatusCode(code) {
-    return typeof code === "number" && Number.isInteger(code) && code >= 100 && code <= 599;
-}
-function httpErrorFormatter(err) {
-    // Handle your custom BackendError type
-    if (err instanceof BackendError_1.BackendError) {
-        var status_1 = isValidStatusCode(err.code) ? err.code : 400;
-        // If developer explicitly set showUser, trust that; otherwise default: true for 4xx, false for 5xx
-        var showUser_1 = typeof err.showUser === "boolean" ? err.showUser : status_1 < 500;
-        var message_1 = err.message || "Error";
-        // If showUser is true, return detailed info including data, code, severity; else generic message
-        var body_1 = showUser_1
-            ? __assign(__assign({ message: message_1 }, (err.data !== undefined && { data: err.data })), { code: status_1, severity: err.severity }) : { message: "Internal Server Error" };
-        return { status: status_1, body: body_1, showUser: showUser_1, message: message_1 };
-    }
-    // Handle generic Error or string or unknown
-    var status = 500;
-    var message = "Internal Server Error";
-    var showUser = false;
-    if (err instanceof Error) {
-        message = err.message;
-        // Try to extract HTTP status code from common fields 'status' or 'code'
-        var maybeStatus = err.status || err.code;
-        if (isValidStatusCode(maybeStatus)) {
-            status = maybeStatus;
-            showUser = status < 500; // show message for 4xx errors by default
-        }
-    }
-    else if (typeof err === "string") {
-        message = err;
-        status = 400;
-        showUser = true;
-    }
-    var body = showUser ? { message: message } : { message: "Internal Server Error" };
-    return { status: status, body: body, showUser: showUser, message: message };
-}
-exports.httpErrorFormatter = httpErrorFormatter;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpErrorFormatter = httpErrorFormatter;
+const BackendError_1 = require("./BackendError");
+function isValidStatusCode(code) {
+    return typeof code === "number" && Number.isInteger(code) && code >= 100 && code <= 599;
+}
+function httpErrorFormatter(err) {
+    // Handle your custom BackendError type
+    if (err instanceof BackendError_1.BackendError) {
+        const status = isValidStatusCode(err.code) ? err.code : 400;
+        // If developer explicitly set showUser, trust that; otherwise default: true for 4xx, false for 5xx
+        const showUser = typeof err.showUser === "boolean" ? err.showUser : status < 500;
+        const message = err.message || "Error";
+        // If showUser is true, return detailed info including data, code, severity; else generic message
+        const body = showUser
+            ? {
+                message,
+                ...(err.data !== undefined && { data: err.data }),
+                code: status,
+                severity: err.severity,
+            }
+            : { message: "Internal Server Error" };
+        return { status, body, showUser, message };
+    }
+    // Handle generic Error or string or unknown
+    let status = 500;
+    let message = "Internal Server Error";
+    let showUser = false;
+    if (err instanceof Error) {
+        message = err.message;
+        // Try to extract HTTP status code from common fields 'status' or 'code'
+        const maybeStatus = err.status || err.code;
+        if (isValidStatusCode(maybeStatus)) {
+            status = maybeStatus;
+            showUser = status < 500; // show message for 4xx errors by default
+        }
+    }
+    else if (typeof err === "string") {
+        message = err;
+        status = 400;
+        showUser = true;
+    }
+    const body = showUser ? { message } : { message: "Internal Server Error" };
+    return { status, body, showUser, message };
+}
+//# sourceMappingURL=httpErrorFormatter.js.map

package/dist/core/httpErrorFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpErrorFormatter.js","sourceRoot":"","sources":["../../src/core/httpErrorFormatter.ts"],"names":[],"mappings":";;AAMA,gDAmDC;AAzDD,iDAA8C;AAE9C,SAAS,iBAAiB,CAAC,IAAa;IACtC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC;AAC1F,CAAC;AAED,SAAgB,kBAAkB,CAAC,GAAY;IAM7C,uCAAuC;IACvC,IAAI,GAAG,YAAY,2BAAY,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAE5D,mGAAmG;QACnG,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;QAEjF,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;QAEvC,iGAAiG;QACjG,MAAM,IAAI,GAAG,QAAQ;YACnB,CAAC,CAAC;gBACE,OAAO;gBACP,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;gBACjD,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB;YACH,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;QAEzC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7C,CAAC;IAED,4CAA4C;IAC5C,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,IAAI,OAAO,GAAG,uBAAuB,CAAC;IACtC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAEtB,wEAAwE;QACxE,MAAM,WAAW,GAAI,GAAW,CAAC,MAAM,IAAK,GAAW,CAAC,IAAI,CAAC;QAC7D,IAAI,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,MAAM,GAAG,WAAW,CAAC;YACrB,QAAQ,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,yCAAyC;QACpE,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,GAAG,GAAG,CAAC;QACd,MAAM,GAAG,GAAG,CAAC;QACb,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAE3E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.httpErrorFormatter = exports.BackendError = void 0;
-var BackendError_1 = require("./core/BackendError");
-Object.defineProperty(exports, "BackendError", { enumerable: true, get: function () { return BackendError_1.BackendError; } });
-var httpErrorFormatter_1 = require("./core/httpErrorFormatter");
-Object.defineProperty(exports, "httpErrorFormatter", { enumerable: true, get: function () { return httpErrorFormatter_1.httpErrorFormatter; } });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpErrorFormatter = exports.BackendError = void 0;
+var BackendError_1 = require("./core/BackendError");
+Object.defineProperty(exports, "BackendError", { enumerable: true, get: function () { return BackendError_1.BackendError; } });
+var httpErrorFormatter_1 = require("./core/httpErrorFormatter");
+Object.defineProperty(exports, "httpErrorFormatter", { enumerable: true, get: function () { return httpErrorFormatter_1.httpErrorFormatter; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oDAAmD;AAA1C,4GAAA,YAAY,OAAA;AACrB,gEAA+D;AAAtD,wHAAA,kBAAkB,OAAA"}

package/dist/interfaces/Types.js

@@ -1,2 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Types.js.map

package/dist/interfaces/Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../src/interfaces/Types.ts"],"names":[],"mappings":""}

package/dist/types/core/BackendError.d.ts

@@ -0,0 +1,19 @@
+import { BackendErrorOptions, Severity } from "../interfaces/Types";
+export declare class BackendError extends Error {
+    isOperational: boolean;
+    showUser: boolean;
+    severity: Severity;
+    code?: number;
+    data?: any;
+    constructor(options: BackendErrorOptions);
+    static BadRequest(msg: string): BackendError;
+    static Unauthorized(msg: string): BackendError;
+    static Forbidden(msg: string): BackendError;
+    static NotFound(msg: string): BackendError;
+    static Conflict(msg: string): BackendError;
+    static UnprocessableEntity(msg: string): BackendError;
+    static Internal(msg: string): BackendError;
+    static ExternalAPI(msg: string, code?: number): BackendError;
+    static ServiceUnavailable(msg: string): BackendError;
+}
+//# sourceMappingURL=BackendError.d.ts.map

package/dist/types/core/BackendError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackendError.d.ts","sourceRoot":"","sources":["../../../src/core/BackendError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,qBAAa,YAAa,SAAQ,KAAK;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,GAAG,CAAC;gBAEN,OAAO,EAAE,mBAAmB;IAaxC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM;IAI7B,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM;IAI/B,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM;IAI5B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM;IAI3B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM;IAI3B,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM;IAItC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM;IAI3B,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY;IAIlD,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM;CAGtC"}

package/dist/types/core/httpErrorFormatter.d.ts

@@ -0,0 +1,7 @@
+export declare function httpErrorFormatter(err: unknown): {
+    status: number;
+    body: Record<string, any>;
+    showUser: boolean;
+    message: string;
+};
+//# sourceMappingURL=httpErrorFormatter.d.ts.map

package/dist/types/core/httpErrorFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpErrorFormatter.d.ts","sourceRoot":"","sources":["../../../src/core/httpErrorFormatter.ts"],"names":[],"mappings":"AAMA,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CA8CA"}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export { BackendError } from "./core/BackendError";
+export { httpErrorFormatter } from "./core/httpErrorFormatter";
+export type { BackendErrorOptions, Severity } from "./interfaces/Types";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types/interfaces/Types.d.ts

@@ -0,0 +1,10 @@
+export type Severity = "info" | "warning" | "error" | "critical";
+export interface BackendErrorOptions {
+    message: string;
+    isOperational?: boolean;
+    showUser?: boolean;
+    severity?: Severity;
+    code?: number;
+    data?: any;
+}
+//# sourceMappingURL=Types.d.ts.map

package/dist/types/interfaces/Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../src/interfaces/Types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ"}

package/package.json

@@ -1,6 +1,21 @@
 {
+  "version": "1.2.0",
   "name": "backend-error",
   "license": "MIT",
+  "keywords": [
+    "error",
+    "error-handler",
+    "http-errors",
+    "express",
+    "firebase-functions",
+    "nodejs",
+    "api",
+    "backend",
+    "error-handling",
+    "http-status",
+    "custom-error",
+    "structured-error"
+  ],
   "maintainers": [
     "Erik Sturesson"
   ],
@@ -9,28 +24,17 @@
     "email": "hej@eriksturesson.se",
     "url": "https://eriksturesson.se"
   },
-  "version": "1.1.0",
   "description": "Simple Error handling library.",
-  "keywords": [
-    "error",
-    "fail",
-    "drawing",
-    "drawings",
-    "summarized",
-    "help",
-    "fun"
-  ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/eriksturesson/backendError"
+    "url": "git+https://github.com/eriksturesson/backendError.git"
   },
   "bugs": {
     "email": "hej@eriksturesson.se",
     "url": "https://github.com/eriksturesson/backendError/issues"
   },
   "engines": {
-    "npm": "^10.0.0",
-    "node": "^22.0.0"
+    "node": ">=16"
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",