dario-tcr-problem-details 1.0.1

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+export declare const ERROR_CATALOG: {
+    readonly USER_NOT_FOUND: {
+        readonly title: "Not Found";
+        readonly status: 404;
+        readonly type: "/errors/not-found";
+    };
+    readonly FORBIDDEN: {
+        readonly title: "Forbidden";
+        readonly status: 403;
+        readonly type: "/errors/forbidden";
+    };
+    readonly INTERNAL_ERROR: {
+        readonly title: "Internal Server Error";
+        readonly status: 500;
+        readonly type: "/errors/internal";
+    };
+};
+export declare class AppError extends Error {
+    readonly status: number;
+    readonly title: string;
+    readonly type: string;
+    readonly detail: string;
+    readonly traceId: string;
+    constructor(status: number, title: string, type: string, detail: string, traceId?: string);
+    static fromCatalog(key: keyof typeof ERROR_CATALOG, detail: string): AppError;
+}

package/dist/errors.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppError = exports.ERROR_CATALOG = void 0;
+exports.ERROR_CATALOG = {
+    USER_NOT_FOUND: { title: "Not Found", status: 404, type: "/errors/not-found" },
+    FORBIDDEN: { title: "Forbidden", status: 403, type: "/errors/forbidden" },
+    INTERNAL_ERROR: { title: "Internal Server Error", status: 500, type: "/errors/internal" }
+};
+class AppError extends Error {
+    constructor(status, title, type, detail, traceId = crypto.randomUUID()) {
+        super(detail);
+        this.status = status;
+        this.title = title;
+        this.type = type;
+        this.detail = detail;
+        this.traceId = traceId;
+        Object.setPrototypeOf(this, AppError.prototype);
+    }
+    static fromCatalog(key, detail) {
+        const err = exports.ERROR_CATALOG[key];
+        return new AppError(err.status, err.title, err.type, detail);
+    }
+}
+exports.AppError = AppError;

package/dist/formatter.d.ts

@@ -0,0 +1,8 @@
+export declare function formatProblemDetails(error: any, instance: string): {
+    type: any;
+    title: any;
+    status: any;
+    detail: any;
+    instance: string;
+    traceId: any;
+};

package/dist/formatter.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatProblemDetails = formatProblemDetails;
+function formatProblemDetails(error, instance) {
+    return {
+        type: error.type || "/errors/internal",
+        title: error.title || "Internal Server Error",
+        status: error.status || 500,
+        detail: error.message || "An unexpected error occurred",
+        instance,
+        traceId: error.traceId || "N/A"
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./errors";
+export * from "./formatter";

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./errors"), exports);
+__exportStar(require("./formatter"), exports);

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "dario-tcr-problem-details",
+  "version": "1.0.1",
+  "description": "RFC 7807 Error Handling Library",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,23 @@
+export const ERROR_CATALOG = {
+    USER_NOT_FOUND: { title: "Not Found", status: 404, type: "/errors/not-found" },
+    FORBIDDEN: { title: "Forbidden", status: 403, type: "/errors/forbidden" },
+    INTERNAL_ERROR: { title: "Internal Server Error", status: 500, type: "/errors/internal" }
+} as const;
+
+export class AppError extends Error {
+    constructor(
+        public readonly status: number,
+        public readonly title: string,
+        public readonly type: string,
+        public readonly detail: string,
+        public readonly traceId: string = crypto.randomUUID()
+    ) {
+        super(detail);
+        Object.setPrototypeOf(this, AppError.prototype);
+    }
+
+    static fromCatalog(key: keyof typeof ERROR_CATALOG, detail: string) {
+        const err = ERROR_CATALOG[key];
+        return new AppError(err.status, err.title, err.type, detail);
+    }
+}

package/src/formatter.ts

@@ -0,0 +1,10 @@
+export function formatProblemDetails(error: any, instance: string) {
+    return {
+        type: error.type || "/errors/internal",
+        title: error.title || "Internal Server Error",
+        status: error.status || 500,
+        detail: error.message || "An unexpected error occurred",
+        instance,
+        traceId: error.traceId || "N/A"
+    };
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./errors";
+export * from "./formatter";

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "CommonJS",
+        "declaration": true,
+        "outDir": "./dist",
+        "strict": true,
+        "esModuleInterop": true
+    },
+    "include": [
+        "src"
+    ]
+}