@xbg.solutions/utils-errors 1.0.0

package/lib/app-errors.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Application Error Classes
+ *
+ * Base error class and typed errors for the application.
+ * All errors extend AppError for consistent handling.
+ */
+export declare class AppError extends Error {
+    readonly statusCode: number;
+    readonly isOperational: boolean;
+    readonly details?: unknown;
+    constructor(statusCode: number, message: string, isOperational?: boolean, details?: unknown);
+}
+/**
+ * 400 Bad Request - Client sent invalid data
+ */
+export declare class ValidationError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * 401 Unauthorized - Authentication required or failed
+ */
+export declare class UnauthorizedError extends AppError {
+    constructor(message?: string);
+}
+/**
+ * 403 Forbidden - Authenticated but insufficient permissions
+ */
+export declare class ForbiddenError extends AppError {
+    constructor(message?: string);
+}
+/**
+ * 404 Not Found - Resource does not exist
+ */
+export declare class NotFoundError extends AppError {
+    constructor(resource: string);
+}
+/**
+ * 409 Conflict - Request conflicts with current state
+ */
+export declare class ConflictError extends AppError {
+    constructor(message: string);
+}
+/**
+ * 500 Internal Server Error - Unexpected server error
+ */
+export declare class InternalServerError extends AppError {
+    constructor(message?: string, details?: unknown);
+}
+//# sourceMappingURL=app-errors.d.ts.map

package/lib/app-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-errors.d.ts","sourceRoot":"","sources":["../src/app-errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,aAAa,EAAE,OAAO,CAAC;IACvC,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAGhC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,OAAc,EAC7B,OAAO,CAAC,EAAE,OAAO;CAcpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,GAAE,MAAuB;CAI7C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,GAAE,MAAoB;CAI1C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,QAAQ,EAAE,MAAM;CAI7B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,GAAE,MAAgC,EAAE,OAAO,CAAC,EAAE,OAAO;CAIzE"}

package/lib/app-errors.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Application Error Classes
+ *
+ * Base error class and typed errors for the application.
+ * All errors extend AppError for consistent handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalServerError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.ValidationError = exports.AppError = void 0;
+class AppError extends Error {
+    constructor(statusCode, message, isOperational = true, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.isOperational = isOperational;
+        this.details = details;
+        // Maintains proper stack trace for where error was thrown (V8 only)
+        Error.captureStackTrace(this, this.constructor);
+        // Set the prototype explicitly (TypeScript requirement)
+        Object.setPrototypeOf(this, AppError.prototype);
+    }
+}
+exports.AppError = AppError;
+/**
+ * 400 Bad Request - Client sent invalid data
+ */
+class ValidationError extends AppError {
+    constructor(message, details) {
+        super(400, message, true, details);
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * 401 Unauthorized - Authentication required or failed
+ */
+class UnauthorizedError extends AppError {
+    constructor(message = 'Unauthorized') {
+        super(401, message, true);
+        Object.setPrototypeOf(this, UnauthorizedError.prototype);
+    }
+}
+exports.UnauthorizedError = UnauthorizedError;
+/**
+ * 403 Forbidden - Authenticated but insufficient permissions
+ */
+class ForbiddenError extends AppError {
+    constructor(message = 'Forbidden') {
+        super(403, message, true);
+        Object.setPrototypeOf(this, ForbiddenError.prototype);
+    }
+}
+exports.ForbiddenError = ForbiddenError;
+/**
+ * 404 Not Found - Resource does not exist
+ */
+class NotFoundError extends AppError {
+    constructor(resource) {
+        super(404, `${resource} not found`, true);
+        Object.setPrototypeOf(this, NotFoundError.prototype);
+    }
+}
+exports.NotFoundError = NotFoundError;
+/**
+ * 409 Conflict - Request conflicts with current state
+ */
+class ConflictError extends AppError {
+    constructor(message) {
+        super(409, message, true);
+        Object.setPrototypeOf(this, ConflictError.prototype);
+    }
+}
+exports.ConflictError = ConflictError;
+/**
+ * 500 Internal Server Error - Unexpected server error
+ */
+class InternalServerError extends AppError {
+    constructor(message = 'Internal server error', details) {
+        super(500, message, false, details);
+        Object.setPrototypeOf(this, InternalServerError.prototype);
+    }
+}
+exports.InternalServerError = InternalServerError;
+//# sourceMappingURL=app-errors.js.map

package/lib/app-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-errors.js","sourceRoot":"","sources":["../src/app-errors.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,MAAa,QAAS,SAAQ,KAAK;IAKjC,YACE,UAAkB,EAClB,OAAe,EACf,gBAAyB,IAAI,EAC7B,OAAiB;QAEjB,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,oEAAoE;QACpE,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAEhD,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF;AAvBD,4BAuBC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AALD,0CAKC;AAED;;GAEG;AACH,MAAa,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,UAAkB,cAAc;QAC1C,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AALD,8CAKC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,QAAQ;IAC1C,YAAY,UAAkB,WAAW;QACvC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AALD,wCAKC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,QAAQ;IACzC,YAAY,QAAgB;QAC1B,KAAK,CAAC,GAAG,EAAE,GAAG,QAAQ,YAAY,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AALD,sCAKC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AALD,sCAKC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,UAAkB,uBAAuB,EAAE,OAAiB;QACtE,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF;AALD,kDAKC"}

package/lib/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Error utilities barrel export
+ */
+export { AppError, ValidationError, UnauthorizedError, ForbiddenError, NotFoundError, ConflictError, InternalServerError, } from './app-errors';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/lib/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Error utilities barrel export
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalServerError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.ValidationError = exports.AppError = void 0;
+var app_errors_1 = require("./app-errors");
+Object.defineProperty(exports, "AppError", { enumerable: true, get: function () { return app_errors_1.AppError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return app_errors_1.ValidationError; } });
+Object.defineProperty(exports, "UnauthorizedError", { enumerable: true, get: function () { return app_errors_1.UnauthorizedError; } });
+Object.defineProperty(exports, "ForbiddenError", { enumerable: true, get: function () { return app_errors_1.ForbiddenError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return app_errors_1.NotFoundError; } });
+Object.defineProperty(exports, "ConflictError", { enumerable: true, get: function () { return app_errors_1.ConflictError; } });
+Object.defineProperty(exports, "InternalServerError", { enumerable: true, get: function () { return app_errors_1.InternalServerError; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2CAQsB;AAPpB,sGAAA,QAAQ,OAAA;AACR,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,4GAAA,cAAc,OAAA;AACd,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,iHAAA,mBAAmB,OAAA"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@xbg.solutions/utils-errors",
+  "version": "1.0.0",
+  "description": "Custom error classes for the XBG backend",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": ["lib"],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {},
+  "devDependencies": {"@types/node": "^20.11.0", "typescript": "^5.3.3"},
+  "engines": {
+    "node": "22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}