@mohasinac/errors 0.1.0

package/dist/index.cjs

@@ -0,0 +1,269 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ApiError: () => ApiError,
+  AppError: () => AppError,
+  AuthenticationError: () => AuthenticationError,
+  AuthorizationError: () => AuthorizationError,
+  DatabaseError: () => DatabaseError,
+  ERROR_CODES: () => ERROR_CODES,
+  ERROR_MESSAGES: () => ERROR_MESSAGES,
+  NotFoundError: () => NotFoundError,
+  ValidationError: () => ValidationError,
+  handleApiError: () => handleApiError,
+  isAppError: () => isAppError,
+  logError: () => logError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/base-error.ts
+var AppError = class extends Error {
+  constructor(statusCode, message, code, data) {
+    super(message);
+    this.statusCode = statusCode;
+    this.message = message;
+    this.code = code;
+    this.data = data;
+    this.name = this.constructor.name;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  toJSON() {
+    return __spreadValues({
+      success: false,
+      error: this.message,
+      code: this.code,
+      statusCode: this.statusCode
+    }, this.data !== void 0 && { data: this.data });
+  }
+};
+
+// src/error-codes.ts
+var ERROR_CODES = {
+  // Authentication
+  AUTH_INVALID_CREDENTIALS: "AUTH_001",
+  AUTH_TOKEN_EXPIRED: "AUTH_002",
+  AUTH_TOKEN_INVALID: "AUTH_003",
+  AUTH_SESSION_EXPIRED: "AUTH_004",
+  AUTH_EMAIL_NOT_VERIFIED: "AUTH_005",
+  // Validation
+  VALIDATION_REQUIRED_FIELD: "VAL_001",
+  VALIDATION_INVALID_INPUT: "VAL_002",
+  VALIDATION_INVALID_EMAIL: "VAL_003",
+  VALIDATION_INVALID_PASSWORD: "VAL_004",
+  VALIDATION_INVALID_PHONE: "VAL_005",
+  // User
+  USER_NOT_FOUND: "USER_001",
+  USER_ALREADY_EXISTS: "USER_002",
+  USER_NOT_AUTHENTICATED: "USER_003",
+  USER_ACCOUNT_DISABLED: "USER_004",
+  // Database
+  DB_OPERATION_FAILED: "DB_001",
+  DB_NOT_FOUND: "DB_002",
+  DB_DUPLICATE_ENTRY: "DB_003",
+  // Email
+  EMAIL_SEND_FAILED: "EMAIL_001",
+  EMAIL_INVALID_TEMPLATE: "EMAIL_002",
+  EMAIL_RATE_LIMITED: "EMAIL_003",
+  EMAIL_DELIVERY_FAILED: "EMAIL_004",
+  // Password
+  PWD_RESET_TOKEN_EXPIRED: "PWD_001",
+  PWD_RESET_TOKEN_INVALID: "PWD_002",
+  PWD_TOO_WEAK: "PWD_003",
+  PWD_HISTORY_REUSE: "PWD_004",
+  PWD_SAME_AS_CURRENT: "PWD_005",
+  // Authorization
+  AUTHZ_FORBIDDEN: "AUTHZ_001",
+  AUTHZ_INSUFFICIENT_ROLE: "AUTHZ_002",
+  // General
+  GEN_BAD_REQUEST: "GEN_001",
+  GEN_NOT_FOUND: "GEN_002",
+  GEN_INTERNAL_ERROR: "GEN_003",
+  GEN_SERVICE_UNAVAILABLE: "GEN_004",
+  GEN_RATE_LIMITED: "GEN_005",
+  GEN_UNKNOWN: "GEN_999"
+};
+var ERROR_MESSAGES = {
+  // Authentication
+  AUTH_001: "Invalid email or password",
+  AUTH_002: "Your session has expired. Please log in again",
+  AUTH_003: "Invalid authentication token",
+  AUTH_004: "Your session has expired. Please log in again",
+  AUTH_005: "Please verify your email address before logging in",
+  // Validation
+  VAL_001: "This field is required",
+  VAL_002: "Invalid input provided",
+  VAL_003: "Please enter a valid email address",
+  VAL_004: "Password must be at least 12 characters with uppercase, lowercase, number and special character",
+  VAL_005: "Please enter a valid phone number",
+  // User
+  USER_001: "User not found",
+  USER_002: "An account with this email already exists",
+  USER_003: "Please log in to continue",
+  USER_004: "Your account has been disabled. Please contact support",
+  // Database
+  DB_001: "A database error occurred. Please try again",
+  DB_002: "The requested resource was not found",
+  DB_003: "This record already exists",
+  // Email
+  EMAIL_001: "Failed to send email. Please try again",
+  EMAIL_002: "Invalid email template",
+  EMAIL_003: "Too many emails sent. Please wait before trying again",
+  EMAIL_004: "Email delivery failed. Please check the address and try again",
+  // Password
+  PWD_001: "Password reset link has expired. Please request a new one",
+  PWD_002: "Invalid password reset link",
+  PWD_003: "Password does not meet security requirements",
+  PWD_004: "Cannot reuse a recent password",
+  PWD_005: "New password must be different from your current password",
+  // Authorization
+  AUTHZ_001: "You do not have permission to perform this action",
+  AUTHZ_002: "Insufficient role to perform this action",
+  // General
+  GEN_001: "Bad request",
+  GEN_002: "The requested resource was not found",
+  GEN_003: "An internal server error occurred",
+  GEN_004: "Service temporarily unavailable",
+  GEN_005: "Too many requests. Please slow down",
+  GEN_999: "An unknown error occurred"
+};
+
+// src/api-error.ts
+var ApiError = class extends AppError {
+  constructor(statusCode, message, data) {
+    super(statusCode, message, "API_ERROR", data);
+  }
+};
+
+// src/validation-error.ts
+var ValidationError = class extends AppError {
+  constructor(message, fields) {
+    super(400, message, "VALIDATION_ERROR", fields);
+  }
+};
+
+// src/authentication-error.ts
+var AuthenticationError = class extends AppError {
+  constructor(message, data) {
+    super(401, message, "AUTHENTICATION_ERROR", data);
+  }
+};
+
+// src/authorization-error.ts
+var AuthorizationError = class extends AppError {
+  constructor(message, data) {
+    super(403, message, "AUTHORIZATION_ERROR", data);
+  }
+};
+
+// src/not-found-error.ts
+var NotFoundError = class extends AppError {
+  constructor(message, data) {
+    super(404, message, "NOT_FOUND", data);
+  }
+};
+
+// src/database-error.ts
+var DatabaseError = class extends AppError {
+  constructor(message, data) {
+    super(500, message, "DATABASE_ERROR", data);
+  }
+};
+
+// src/error-handler.ts
+var import_server = require("next/server");
+function handleApiError(error) {
+  if (error instanceof AppError) {
+    if (error.statusCode >= 500) {
+      console.error("[API Error]", {
+        code: error.code,
+        message: error.message,
+        statusCode: error.statusCode,
+        data: error.data
+      });
+    }
+    return import_server.NextResponse.json(error.toJSON(), { status: error.statusCode });
+  }
+  if (error && typeof error === "object" && "issues" in error) {
+    return import_server.NextResponse.json(
+      {
+        success: false,
+        error: "Validation failed",
+        code: ERROR_CODES.VALIDATION_INVALID_INPUT,
+        data: error
+      },
+      { status: 400 }
+    );
+  }
+  console.error("[Unexpected API Error]", {
+    error: error instanceof Error ? { name: error.name, message: error.message, stack: error.stack } : error
+  });
+  return import_server.NextResponse.json(
+    {
+      success: false,
+      error: ERROR_MESSAGES[ERROR_CODES.GEN_INTERNAL_ERROR],
+      code: ERROR_CODES.GEN_INTERNAL_ERROR
+    },
+    { status: 500 }
+  );
+}
+function logError(error, context) {
+  console.error("[Application Error]", __spreadProps(__spreadValues({}, context && { context }), {
+    error: error instanceof Error ? { name: error.name, message: error.message, stack: error.stack } : error
+  }));
+}
+function isAppError(error) {
+  return error instanceof AppError;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApiError,
+  AppError,
+  AuthenticationError,
+  AuthorizationError,
+  DatabaseError,
+  ERROR_CODES,
+  ERROR_MESSAGES,
+  NotFoundError,
+  ValidationError,
+  handleApiError,
+  isAppError,
+  logError
+});

package/dist/index.d.cts

@@ -0,0 +1,96 @@
+import { NextResponse } from 'next/server';
+
+declare class AppError extends Error {
+    statusCode: number;
+    message: string;
+    code: string;
+    data?: unknown | undefined;
+    constructor(statusCode: number, message: string, code: string, data?: unknown | undefined);
+    toJSON(): {
+        success: false;
+        error: string;
+        code: string;
+        statusCode: number;
+        data?: unknown;
+    };
+}
+
+declare const ERROR_CODES: {
+    readonly AUTH_INVALID_CREDENTIALS: "AUTH_001";
+    readonly AUTH_TOKEN_EXPIRED: "AUTH_002";
+    readonly AUTH_TOKEN_INVALID: "AUTH_003";
+    readonly AUTH_SESSION_EXPIRED: "AUTH_004";
+    readonly AUTH_EMAIL_NOT_VERIFIED: "AUTH_005";
+    readonly VALIDATION_REQUIRED_FIELD: "VAL_001";
+    readonly VALIDATION_INVALID_INPUT: "VAL_002";
+    readonly VALIDATION_INVALID_EMAIL: "VAL_003";
+    readonly VALIDATION_INVALID_PASSWORD: "VAL_004";
+    readonly VALIDATION_INVALID_PHONE: "VAL_005";
+    readonly USER_NOT_FOUND: "USER_001";
+    readonly USER_ALREADY_EXISTS: "USER_002";
+    readonly USER_NOT_AUTHENTICATED: "USER_003";
+    readonly USER_ACCOUNT_DISABLED: "USER_004";
+    readonly DB_OPERATION_FAILED: "DB_001";
+    readonly DB_NOT_FOUND: "DB_002";
+    readonly DB_DUPLICATE_ENTRY: "DB_003";
+    readonly EMAIL_SEND_FAILED: "EMAIL_001";
+    readonly EMAIL_INVALID_TEMPLATE: "EMAIL_002";
+    readonly EMAIL_RATE_LIMITED: "EMAIL_003";
+    readonly EMAIL_DELIVERY_FAILED: "EMAIL_004";
+    readonly PWD_RESET_TOKEN_EXPIRED: "PWD_001";
+    readonly PWD_RESET_TOKEN_INVALID: "PWD_002";
+    readonly PWD_TOO_WEAK: "PWD_003";
+    readonly PWD_HISTORY_REUSE: "PWD_004";
+    readonly PWD_SAME_AS_CURRENT: "PWD_005";
+    readonly AUTHZ_FORBIDDEN: "AUTHZ_001";
+    readonly AUTHZ_INSUFFICIENT_ROLE: "AUTHZ_002";
+    readonly GEN_BAD_REQUEST: "GEN_001";
+    readonly GEN_NOT_FOUND: "GEN_002";
+    readonly GEN_INTERNAL_ERROR: "GEN_003";
+    readonly GEN_SERVICE_UNAVAILABLE: "GEN_004";
+    readonly GEN_RATE_LIMITED: "GEN_005";
+    readonly GEN_UNKNOWN: "GEN_999";
+};
+type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+declare const ERROR_MESSAGES: Record<ErrorCode, string>;
+
+declare class ApiError extends AppError {
+    constructor(statusCode: number, message: string, data?: unknown);
+}
+
+declare class ValidationError extends AppError {
+    constructor(message: string, fields?: unknown);
+}
+
+declare class AuthenticationError extends AppError {
+    constructor(message: string, data?: unknown);
+}
+
+declare class AuthorizationError extends AppError {
+    constructor(message: string, data?: unknown);
+}
+
+declare class NotFoundError extends AppError {
+    constructor(message: string, data?: unknown);
+}
+
+declare class DatabaseError extends AppError {
+    constructor(message: string, data?: unknown);
+}
+
+/**
+ * Handle API errors with consistent response format.
+ * Use in Next.js API route catch blocks.
+ */
+declare function handleApiError(error: unknown): NextResponse;
+/**
+ * Log an error with optional context. Wraps console.error for package portability;
+ * replace with your structured logger if needed.
+ */
+declare function logError(error: unknown, context?: Record<string, unknown>): void;
+/**
+ * Type guard — check if a value is an AppError instance.
+ */
+declare function isAppError(error: unknown): error is AppError;
+
+export { ApiError, AppError, AuthenticationError, AuthorizationError, DatabaseError, ERROR_CODES, ERROR_MESSAGES, type ErrorCode, NotFoundError, ValidationError, handleApiError, isAppError, logError };

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+import { NextResponse } from 'next/server';
+
+declare class AppError extends Error {
+    statusCode: number;
+    message: string;
+    code: string;
+    data?: unknown | undefined;
+    constructor(statusCode: number, message: string, code: string, data?: unknown | undefined);
+    toJSON(): {
+        success: false;
+        error: string;
+        code: string;
+        statusCode: number;
+        data?: unknown;
+    };
+}
+
+declare const ERROR_CODES: {
+    readonly AUTH_INVALID_CREDENTIALS: "AUTH_001";
+    readonly AUTH_TOKEN_EXPIRED: "AUTH_002";
+    readonly AUTH_TOKEN_INVALID: "AUTH_003";
+    readonly AUTH_SESSION_EXPIRED: "AUTH_004";
+    readonly AUTH_EMAIL_NOT_VERIFIED: "AUTH_005";
+    readonly VALIDATION_REQUIRED_FIELD: "VAL_001";
+    readonly VALIDATION_INVALID_INPUT: "VAL_002";
+    readonly VALIDATION_INVALID_EMAIL: "VAL_003";
+    readonly VALIDATION_INVALID_PASSWORD: "VAL_004";
+    readonly VALIDATION_INVALID_PHONE: "VAL_005";
+    readonly USER_NOT_FOUND: "USER_001";
+    readonly USER_ALREADY_EXISTS: "USER_002";
+    readonly USER_NOT_AUTHENTICATED: "USER_003";
+    readonly USER_ACCOUNT_DISABLED: "USER_004";
+    readonly DB_OPERATION_FAILED: "DB_001";
+    readonly DB_NOT_FOUND: "DB_002";
+    readonly DB_DUPLICATE_ENTRY: "DB_003";
+    readonly EMAIL_SEND_FAILED: "EMAIL_001";
+    readonly EMAIL_INVALID_TEMPLATE: "EMAIL_002";
+    readonly EMAIL_RATE_LIMITED: "EMAIL_003";
+    readonly EMAIL_DELIVERY_FAILED: "EMAIL_004";
+    readonly PWD_RESET_TOKEN_EXPIRED: "PWD_001";
+    readonly PWD_RESET_TOKEN_INVALID: "PWD_002";
+    readonly PWD_TOO_WEAK: "PWD_003";
+    readonly PWD_HISTORY_REUSE: "PWD_004";
+    readonly PWD_SAME_AS_CURRENT: "PWD_005";
+    readonly AUTHZ_FORBIDDEN: "AUTHZ_001";
+    readonly AUTHZ_INSUFFICIENT_ROLE: "AUTHZ_002";
+    readonly GEN_BAD_REQUEST: "GEN_001";
+    readonly GEN_NOT_FOUND: "GEN_002";
+    readonly GEN_INTERNAL_ERROR: "GEN_003";
+    readonly GEN_SERVICE_UNAVAILABLE: "GEN_004";
+    readonly GEN_RATE_LIMITED: "GEN_005";
+    readonly GEN_UNKNOWN: "GEN_999";
+};
+type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+declare const ERROR_MESSAGES: Record<ErrorCode, string>;
+
+declare class ApiError extends AppError {
+    constructor(statusCode: number, message: string, data?: unknown);
+}
+
+declare class ValidationError extends AppError {
+    constructor(message: string, fields?: unknown);
+}
+
+declare class AuthenticationError extends AppError {
+    constructor(message: string, data?: unknown);
+}
+
+declare class AuthorizationError extends AppError {
+    constructor(message: string, data?: unknown);
+}
+
+declare class NotFoundError extends AppError {
+    constructor(message: string, data?: unknown);
+}
+
+declare class DatabaseError extends AppError {
+    constructor(message: string, data?: unknown);
+}
+
+/**
+ * Handle API errors with consistent response format.
+ * Use in Next.js API route catch blocks.
+ */
+declare function handleApiError(error: unknown): NextResponse;
+/**
+ * Log an error with optional context. Wraps console.error for package portability;
+ * replace with your structured logger if needed.
+ */
+declare function logError(error: unknown, context?: Record<string, unknown>): void;
+/**
+ * Type guard — check if a value is an AppError instance.
+ */
+declare function isAppError(error: unknown): error is AppError;
+
+export { ApiError, AppError, AuthenticationError, AuthorizationError, DatabaseError, ERROR_CODES, ERROR_MESSAGES, type ErrorCode, NotFoundError, ValidationError, handleApiError, isAppError, logError };

package/dist/index.js

@@ -0,0 +1,234 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+
+// src/base-error.ts
+var AppError = class extends Error {
+  constructor(statusCode, message, code, data) {
+    super(message);
+    this.statusCode = statusCode;
+    this.message = message;
+    this.code = code;
+    this.data = data;
+    this.name = this.constructor.name;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  toJSON() {
+    return __spreadValues({
+      success: false,
+      error: this.message,
+      code: this.code,
+      statusCode: this.statusCode
+    }, this.data !== void 0 && { data: this.data });
+  }
+};
+
+// src/error-codes.ts
+var ERROR_CODES = {
+  // Authentication
+  AUTH_INVALID_CREDENTIALS: "AUTH_001",
+  AUTH_TOKEN_EXPIRED: "AUTH_002",
+  AUTH_TOKEN_INVALID: "AUTH_003",
+  AUTH_SESSION_EXPIRED: "AUTH_004",
+  AUTH_EMAIL_NOT_VERIFIED: "AUTH_005",
+  // Validation
+  VALIDATION_REQUIRED_FIELD: "VAL_001",
+  VALIDATION_INVALID_INPUT: "VAL_002",
+  VALIDATION_INVALID_EMAIL: "VAL_003",
+  VALIDATION_INVALID_PASSWORD: "VAL_004",
+  VALIDATION_INVALID_PHONE: "VAL_005",
+  // User
+  USER_NOT_FOUND: "USER_001",
+  USER_ALREADY_EXISTS: "USER_002",
+  USER_NOT_AUTHENTICATED: "USER_003",
+  USER_ACCOUNT_DISABLED: "USER_004",
+  // Database
+  DB_OPERATION_FAILED: "DB_001",
+  DB_NOT_FOUND: "DB_002",
+  DB_DUPLICATE_ENTRY: "DB_003",
+  // Email
+  EMAIL_SEND_FAILED: "EMAIL_001",
+  EMAIL_INVALID_TEMPLATE: "EMAIL_002",
+  EMAIL_RATE_LIMITED: "EMAIL_003",
+  EMAIL_DELIVERY_FAILED: "EMAIL_004",
+  // Password
+  PWD_RESET_TOKEN_EXPIRED: "PWD_001",
+  PWD_RESET_TOKEN_INVALID: "PWD_002",
+  PWD_TOO_WEAK: "PWD_003",
+  PWD_HISTORY_REUSE: "PWD_004",
+  PWD_SAME_AS_CURRENT: "PWD_005",
+  // Authorization
+  AUTHZ_FORBIDDEN: "AUTHZ_001",
+  AUTHZ_INSUFFICIENT_ROLE: "AUTHZ_002",
+  // General
+  GEN_BAD_REQUEST: "GEN_001",
+  GEN_NOT_FOUND: "GEN_002",
+  GEN_INTERNAL_ERROR: "GEN_003",
+  GEN_SERVICE_UNAVAILABLE: "GEN_004",
+  GEN_RATE_LIMITED: "GEN_005",
+  GEN_UNKNOWN: "GEN_999"
+};
+var ERROR_MESSAGES = {
+  // Authentication
+  AUTH_001: "Invalid email or password",
+  AUTH_002: "Your session has expired. Please log in again",
+  AUTH_003: "Invalid authentication token",
+  AUTH_004: "Your session has expired. Please log in again",
+  AUTH_005: "Please verify your email address before logging in",
+  // Validation
+  VAL_001: "This field is required",
+  VAL_002: "Invalid input provided",
+  VAL_003: "Please enter a valid email address",
+  VAL_004: "Password must be at least 12 characters with uppercase, lowercase, number and special character",
+  VAL_005: "Please enter a valid phone number",
+  // User
+  USER_001: "User not found",
+  USER_002: "An account with this email already exists",
+  USER_003: "Please log in to continue",
+  USER_004: "Your account has been disabled. Please contact support",
+  // Database
+  DB_001: "A database error occurred. Please try again",
+  DB_002: "The requested resource was not found",
+  DB_003: "This record already exists",
+  // Email
+  EMAIL_001: "Failed to send email. Please try again",
+  EMAIL_002: "Invalid email template",
+  EMAIL_003: "Too many emails sent. Please wait before trying again",
+  EMAIL_004: "Email delivery failed. Please check the address and try again",
+  // Password
+  PWD_001: "Password reset link has expired. Please request a new one",
+  PWD_002: "Invalid password reset link",
+  PWD_003: "Password does not meet security requirements",
+  PWD_004: "Cannot reuse a recent password",
+  PWD_005: "New password must be different from your current password",
+  // Authorization
+  AUTHZ_001: "You do not have permission to perform this action",
+  AUTHZ_002: "Insufficient role to perform this action",
+  // General
+  GEN_001: "Bad request",
+  GEN_002: "The requested resource was not found",
+  GEN_003: "An internal server error occurred",
+  GEN_004: "Service temporarily unavailable",
+  GEN_005: "Too many requests. Please slow down",
+  GEN_999: "An unknown error occurred"
+};
+
+// src/api-error.ts
+var ApiError = class extends AppError {
+  constructor(statusCode, message, data) {
+    super(statusCode, message, "API_ERROR", data);
+  }
+};
+
+// src/validation-error.ts
+var ValidationError = class extends AppError {
+  constructor(message, fields) {
+    super(400, message, "VALIDATION_ERROR", fields);
+  }
+};
+
+// src/authentication-error.ts
+var AuthenticationError = class extends AppError {
+  constructor(message, data) {
+    super(401, message, "AUTHENTICATION_ERROR", data);
+  }
+};
+
+// src/authorization-error.ts
+var AuthorizationError = class extends AppError {
+  constructor(message, data) {
+    super(403, message, "AUTHORIZATION_ERROR", data);
+  }
+};
+
+// src/not-found-error.ts
+var NotFoundError = class extends AppError {
+  constructor(message, data) {
+    super(404, message, "NOT_FOUND", data);
+  }
+};
+
+// src/database-error.ts
+var DatabaseError = class extends AppError {
+  constructor(message, data) {
+    super(500, message, "DATABASE_ERROR", data);
+  }
+};
+
+// src/error-handler.ts
+import { NextResponse } from "next/server";
+function handleApiError(error) {
+  if (error instanceof AppError) {
+    if (error.statusCode >= 500) {
+      console.error("[API Error]", {
+        code: error.code,
+        message: error.message,
+        statusCode: error.statusCode,
+        data: error.data
+      });
+    }
+    return NextResponse.json(error.toJSON(), { status: error.statusCode });
+  }
+  if (error && typeof error === "object" && "issues" in error) {
+    return NextResponse.json(
+      {
+        success: false,
+        error: "Validation failed",
+        code: ERROR_CODES.VALIDATION_INVALID_INPUT,
+        data: error
+      },
+      { status: 400 }
+    );
+  }
+  console.error("[Unexpected API Error]", {
+    error: error instanceof Error ? { name: error.name, message: error.message, stack: error.stack } : error
+  });
+  return NextResponse.json(
+    {
+      success: false,
+      error: ERROR_MESSAGES[ERROR_CODES.GEN_INTERNAL_ERROR],
+      code: ERROR_CODES.GEN_INTERNAL_ERROR
+    },
+    { status: 500 }
+  );
+}
+function logError(error, context) {
+  console.error("[Application Error]", __spreadProps(__spreadValues({}, context && { context }), {
+    error: error instanceof Error ? { name: error.name, message: error.message, stack: error.stack } : error
+  }));
+}
+function isAppError(error) {
+  return error instanceof AppError;
+}
+export {
+  ApiError,
+  AppError,
+  AuthenticationError,
+  AuthorizationError,
+  DatabaseError,
+  ERROR_CODES,
+  ERROR_MESSAGES,
+  NotFoundError,
+  ValidationError,
+  handleApiError,
+  isAppError,
+  logError
+};

package/dist/index.mjs

@@ -0,0 +1,234 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+
+// src/base-error.ts
+var AppError = class extends Error {
+  constructor(statusCode, message, code, data) {
+    super(message);
+    this.statusCode = statusCode;
+    this.message = message;
+    this.code = code;
+    this.data = data;
+    this.name = this.constructor.name;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  toJSON() {
+    return __spreadValues({
+      success: false,
+      error: this.message,
+      code: this.code,
+      statusCode: this.statusCode
+    }, this.data !== void 0 && { data: this.data });
+  }
+};
+
+// src/error-codes.ts
+var ERROR_CODES = {
+  // Authentication
+  AUTH_INVALID_CREDENTIALS: "AUTH_001",
+  AUTH_TOKEN_EXPIRED: "AUTH_002",
+  AUTH_TOKEN_INVALID: "AUTH_003",
+  AUTH_SESSION_EXPIRED: "AUTH_004",
+  AUTH_EMAIL_NOT_VERIFIED: "AUTH_005",
+  // Validation
+  VALIDATION_REQUIRED_FIELD: "VAL_001",
+  VALIDATION_INVALID_INPUT: "VAL_002",
+  VALIDATION_INVALID_EMAIL: "VAL_003",
+  VALIDATION_INVALID_PASSWORD: "VAL_004",
+  VALIDATION_INVALID_PHONE: "VAL_005",
+  // User
+  USER_NOT_FOUND: "USER_001",
+  USER_ALREADY_EXISTS: "USER_002",
+  USER_NOT_AUTHENTICATED: "USER_003",
+  USER_ACCOUNT_DISABLED: "USER_004",
+  // Database
+  DB_OPERATION_FAILED: "DB_001",
+  DB_NOT_FOUND: "DB_002",
+  DB_DUPLICATE_ENTRY: "DB_003",
+  // Email
+  EMAIL_SEND_FAILED: "EMAIL_001",
+  EMAIL_INVALID_TEMPLATE: "EMAIL_002",
+  EMAIL_RATE_LIMITED: "EMAIL_003",
+  EMAIL_DELIVERY_FAILED: "EMAIL_004",
+  // Password
+  PWD_RESET_TOKEN_EXPIRED: "PWD_001",
+  PWD_RESET_TOKEN_INVALID: "PWD_002",
+  PWD_TOO_WEAK: "PWD_003",
+  PWD_HISTORY_REUSE: "PWD_004",
+  PWD_SAME_AS_CURRENT: "PWD_005",
+  // Authorization
+  AUTHZ_FORBIDDEN: "AUTHZ_001",
+  AUTHZ_INSUFFICIENT_ROLE: "AUTHZ_002",
+  // General
+  GEN_BAD_REQUEST: "GEN_001",
+  GEN_NOT_FOUND: "GEN_002",
+  GEN_INTERNAL_ERROR: "GEN_003",
+  GEN_SERVICE_UNAVAILABLE: "GEN_004",
+  GEN_RATE_LIMITED: "GEN_005",
+  GEN_UNKNOWN: "GEN_999"
+};
+var ERROR_MESSAGES = {
+  // Authentication
+  AUTH_001: "Invalid email or password",
+  AUTH_002: "Your session has expired. Please log in again",
+  AUTH_003: "Invalid authentication token",
+  AUTH_004: "Your session has expired. Please log in again",
+  AUTH_005: "Please verify your email address before logging in",
+  // Validation
+  VAL_001: "This field is required",
+  VAL_002: "Invalid input provided",
+  VAL_003: "Please enter a valid email address",
+  VAL_004: "Password must be at least 12 characters with uppercase, lowercase, number and special character",
+  VAL_005: "Please enter a valid phone number",
+  // User
+  USER_001: "User not found",
+  USER_002: "An account with this email already exists",
+  USER_003: "Please log in to continue",
+  USER_004: "Your account has been disabled. Please contact support",
+  // Database
+  DB_001: "A database error occurred. Please try again",
+  DB_002: "The requested resource was not found",
+  DB_003: "This record already exists",
+  // Email
+  EMAIL_001: "Failed to send email. Please try again",
+  EMAIL_002: "Invalid email template",
+  EMAIL_003: "Too many emails sent. Please wait before trying again",
+  EMAIL_004: "Email delivery failed. Please check the address and try again",
+  // Password
+  PWD_001: "Password reset link has expired. Please request a new one",
+  PWD_002: "Invalid password reset link",
+  PWD_003: "Password does not meet security requirements",
+  PWD_004: "Cannot reuse a recent password",
+  PWD_005: "New password must be different from your current password",
+  // Authorization
+  AUTHZ_001: "You do not have permission to perform this action",
+  AUTHZ_002: "Insufficient role to perform this action",
+  // General
+  GEN_001: "Bad request",
+  GEN_002: "The requested resource was not found",
+  GEN_003: "An internal server error occurred",
+  GEN_004: "Service temporarily unavailable",
+  GEN_005: "Too many requests. Please slow down",
+  GEN_999: "An unknown error occurred"
+};
+
+// src/api-error.ts
+var ApiError = class extends AppError {
+  constructor(statusCode, message, data) {
+    super(statusCode, message, "API_ERROR", data);
+  }
+};
+
+// src/validation-error.ts
+var ValidationError = class extends AppError {
+  constructor(message, fields) {
+    super(400, message, "VALIDATION_ERROR", fields);
+  }
+};
+
+// src/authentication-error.ts
+var AuthenticationError = class extends AppError {
+  constructor(message, data) {
+    super(401, message, "AUTHENTICATION_ERROR", data);
+  }
+};
+
+// src/authorization-error.ts
+var AuthorizationError = class extends AppError {
+  constructor(message, data) {
+    super(403, message, "AUTHORIZATION_ERROR", data);
+  }
+};
+
+// src/not-found-error.ts
+var NotFoundError = class extends AppError {
+  constructor(message, data) {
+    super(404, message, "NOT_FOUND", data);
+  }
+};
+
+// src/database-error.ts
+var DatabaseError = class extends AppError {
+  constructor(message, data) {
+    super(500, message, "DATABASE_ERROR", data);
+  }
+};
+
+// src/error-handler.ts
+import { NextResponse } from "next/server";
+function handleApiError(error) {
+  if (error instanceof AppError) {
+    if (error.statusCode >= 500) {
+      console.error("[API Error]", {
+        code: error.code,
+        message: error.message,
+        statusCode: error.statusCode,
+        data: error.data
+      });
+    }
+    return NextResponse.json(error.toJSON(), { status: error.statusCode });
+  }
+  if (error && typeof error === "object" && "issues" in error) {
+    return NextResponse.json(
+      {
+        success: false,
+        error: "Validation failed",
+        code: ERROR_CODES.VALIDATION_INVALID_INPUT,
+        data: error
+      },
+      { status: 400 }
+    );
+  }
+  console.error("[Unexpected API Error]", {
+    error: error instanceof Error ? { name: error.name, message: error.message, stack: error.stack } : error
+  });
+  return NextResponse.json(
+    {
+      success: false,
+      error: ERROR_MESSAGES[ERROR_CODES.GEN_INTERNAL_ERROR],
+      code: ERROR_CODES.GEN_INTERNAL_ERROR
+    },
+    { status: 500 }
+  );
+}
+function logError(error, context) {
+  console.error("[Application Error]", __spreadProps(__spreadValues({}, context && { context }), {
+    error: error instanceof Error ? { name: error.name, message: error.message, stack: error.stack } : error
+  }));
+}
+function isAppError(error) {
+  return error instanceof AppError;
+}
+export {
+  ApiError,
+  AppError,
+  AuthenticationError,
+  AuthorizationError,
+  DatabaseError,
+  ERROR_CODES,
+  ERROR_MESSAGES,
+  NotFoundError,
+  ValidationError,
+  handleApiError,
+  isAppError,
+  logError
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@mohasinac/errors",
+  "version": "0.1.0",
+  "type": "module",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Application error classes, error codes, and API error handler",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3"
+  }
+}