@geekmidas/errors 10.0.0-alpha.2 → 10.0.0-alpha.21

package/dist/index.cjs

@@ -1,4 +1,4 @@
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/index.ts
 /**
 * Base HTTP Error class that extends the native Error.
@@ -66,7 +66,7 @@ var HttpError = class extends Error {
 	* @private
 	*/
 	getDefaultStatusMessage(statusCode) {
-		const statusMessages = {
+		return {
 			400: "Bad Request",
 			401: "Unauthorized",
 			403: "Forbidden",
@@ -83,8 +83,7 @@ var HttpError = class extends Error {
 			502: "Bad Gateway",
 			503: "Service Unavailable",
 			504: "Gateway Timeout"
-		};
-		return statusMessages[statusCode] || "Unknown Error";
+		}[statusCode] || "Unknown Error";
 	}
 	/**
 	* Serializes the error to a JSON-compatible object.
@@ -507,31 +506,31 @@ function wrapError(error, statusCode = 500, message) {
 * HTTP status code enum for type-safe status code usage.
 * Includes common 2xx, 3xx, 4xx, and 5xx status codes.
 */
-let HttpStatusCode = /* @__PURE__ */ function(HttpStatusCode$1) {
-	HttpStatusCode$1[HttpStatusCode$1["OK"] = 200] = "OK";
-	HttpStatusCode$1[HttpStatusCode$1["CREATED"] = 201] = "CREATED";
-	HttpStatusCode$1[HttpStatusCode$1["ACCEPTED"] = 202] = "ACCEPTED";
-	HttpStatusCode$1[HttpStatusCode$1["NO_CONTENT"] = 204] = "NO_CONTENT";
-	HttpStatusCode$1[HttpStatusCode$1["MOVED_PERMANENTLY"] = 301] = "MOVED_PERMANENTLY";
-	HttpStatusCode$1[HttpStatusCode$1["FOUND"] = 302] = "FOUND";
-	HttpStatusCode$1[HttpStatusCode$1["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
-	HttpStatusCode$1[HttpStatusCode$1["BAD_REQUEST"] = 400] = "BAD_REQUEST";
-	HttpStatusCode$1[HttpStatusCode$1["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
-	HttpStatusCode$1[HttpStatusCode$1["FORBIDDEN"] = 403] = "FORBIDDEN";
-	HttpStatusCode$1[HttpStatusCode$1["NOT_FOUND"] = 404] = "NOT_FOUND";
-	HttpStatusCode$1[HttpStatusCode$1["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
-	HttpStatusCode$1[HttpStatusCode$1["NOT_ACCEPTABLE"] = 406] = "NOT_ACCEPTABLE";
-	HttpStatusCode$1[HttpStatusCode$1["REQUEST_TIMEOUT"] = 408] = "REQUEST_TIMEOUT";
-	HttpStatusCode$1[HttpStatusCode$1["CONFLICT"] = 409] = "CONFLICT";
-	HttpStatusCode$1[HttpStatusCode$1["GONE"] = 410] = "GONE";
-	HttpStatusCode$1[HttpStatusCode$1["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
-	HttpStatusCode$1[HttpStatusCode$1["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
-	HttpStatusCode$1[HttpStatusCode$1["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
-	HttpStatusCode$1[HttpStatusCode$1["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
-	HttpStatusCode$1[HttpStatusCode$1["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
-	HttpStatusCode$1[HttpStatusCode$1["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
-	HttpStatusCode$1[HttpStatusCode$1["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
-	return HttpStatusCode$1;
+let HttpStatusCode = /* @__PURE__ */ function(HttpStatusCode) {
+	HttpStatusCode[HttpStatusCode["OK"] = 200] = "OK";
+	HttpStatusCode[HttpStatusCode["CREATED"] = 201] = "CREATED";
+	HttpStatusCode[HttpStatusCode["ACCEPTED"] = 202] = "ACCEPTED";
+	HttpStatusCode[HttpStatusCode["NO_CONTENT"] = 204] = "NO_CONTENT";
+	HttpStatusCode[HttpStatusCode["MOVED_PERMANENTLY"] = 301] = "MOVED_PERMANENTLY";
+	HttpStatusCode[HttpStatusCode["FOUND"] = 302] = "FOUND";
+	HttpStatusCode[HttpStatusCode["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
+	HttpStatusCode[HttpStatusCode["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+	HttpStatusCode[HttpStatusCode["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+	HttpStatusCode[HttpStatusCode["FORBIDDEN"] = 403] = "FORBIDDEN";
+	HttpStatusCode[HttpStatusCode["NOT_FOUND"] = 404] = "NOT_FOUND";
+	HttpStatusCode[HttpStatusCode["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
+	HttpStatusCode[HttpStatusCode["NOT_ACCEPTABLE"] = 406] = "NOT_ACCEPTABLE";
+	HttpStatusCode[HttpStatusCode["REQUEST_TIMEOUT"] = 408] = "REQUEST_TIMEOUT";
+	HttpStatusCode[HttpStatusCode["CONFLICT"] = 409] = "CONFLICT";
+	HttpStatusCode[HttpStatusCode["GONE"] = 410] = "GONE";
+	HttpStatusCode[HttpStatusCode["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
+	HttpStatusCode[HttpStatusCode["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
+	HttpStatusCode[HttpStatusCode["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+	HttpStatusCode[HttpStatusCode["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
+	HttpStatusCode[HttpStatusCode["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
+	HttpStatusCode[HttpStatusCode["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+	HttpStatusCode[HttpStatusCode["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
+	return HttpStatusCode;
 }({});
 /**
 * Namespace containing all HTTP error classes.
@@ -559,7 +558,6 @@ const HttpErrors = {
 	ServiceUnavailableError,
 	GatewayTimeoutError
 };
-
 //#endregion
 exports.BadGatewayError = BadGatewayError;
 exports.BadRequestError = BadRequestError;
@@ -583,4 +581,5 @@ exports.isClientError = isClientError;
 exports.isHttpError = isHttpError;
 exports.isServerError = isServerError;
 exports.wrapError = wrapError;
+
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["statusCode: number","message?: string","options?: {\n\t\t\tstatusMessage?: string;\n\t\t\tdetails?: any;\n\t\t\tcode?: string;\n\t\t\tcause?: Error;\n\t\t}","statusMessages: Record<number, string>","details?: any","allowedMethods?: string[]","validationErrors?: any","retryAfter?: number","m: string","d: any","am: string[]","ve: any","ra: number","factoryHandlers: Record<\n\tErrorFactory['type'],\n\t(entry: any, message?: string, options?: any) => HttpError\n>","options?: any","error: unknown"],"sources":["../src/index.ts"],"sourcesContent":["// http-errors.ts - Core HTTP Error Classes and Types\n\n/**\n * Base HTTP Error class that extends the native Error.\n * Provides a foundation for all HTTP-specific errors with status codes and structured error responses.\n *\n * @extends Error\n *\n * @example\n * ```typescript\n * throw new HttpError(400, 'Bad Request', {\n *   details: { field: 'email', message: 'Invalid format' }\n * });\n * ```\n */\nexport class HttpError extends Error {\n\t/** The HTTP status code (e.g., 400, 404, 500) */\n\tpublic readonly statusCode: number;\n\t/** The standard HTTP status message (e.g., 'Bad Request', 'Not Found') */\n\tpublic readonly statusMessage: string;\n\t/** Type discriminator for runtime type checking */\n\tpublic readonly isHttpError = true;\n\t/** Additional error details for debugging or client information */\n\tpublic readonly details?: any;\n\t/** Application-specific error code for client-side handling */\n\tpublic readonly code?: string;\n\n\t/**\n\t * Creates a new HttpError instance.\n\t *\n\t * @param statusCode - The HTTP status code\n\t * @param message - Optional error message for the client\n\t * @param options - Optional configuration object\n\t * @param options.statusMessage - Override the default status message\n\t * @param options.details - Additional error details or context\n\t * @param options.code - Application-specific error code\n\t * @param options.cause - The underlying error that caused this error (ES2022)\n\t */\n\tconstructor(\n\t\tstatusCode: number,\n\t\tmessage?: string,\n\t\toptions?: {\n\t\t\tstatusMessage?: string;\n\t\t\tdetails?: any;\n\t\t\tcode?: string;\n\t\t\tcause?: Error;\n\t\t},\n\t) {\n\t\tsuper(message || options?.statusMessage || 'HTTP Error');\n\t\tthis.name = this.constructor.name;\n\t\tthis.statusCode = statusCode;\n\t\tthis.statusMessage =\n\t\t\toptions?.statusMessage || this.getDefaultStatusMessage(statusCode);\n\t\tthis.details = options?.details;\n\t\tthis.code = options?.code;\n\n\t\t// Set cause if provided (ES2022 feature)\n\t\tif (options?.cause) {\n\t\t\tthis.cause = options.cause;\n\t\t}\n\t\t// Maintains proper stack trace for where our error was thrown\n\t\tError.captureStackTrace(this, this.constructor);\n\t}\n\n\t/**\n\t * Gets the error response body as a JSON string.\n\t * Used for sending the error response to clients.\n\t *\n\t * @returns JSON string containing message, code, and error details\n\t */\n\tget body() {\n\t\treturn JSON.stringify({\n\t\t\tmessage: this.message,\n\t\t\tcode: this.code,\n\t\t\terror: this.details,\n\t\t});\n\t}\n\n\t/**\n\t * Gets the default HTTP status message for a given status code.\n\t *\n\t * @param statusCode - The HTTP status code\n\t * @returns The standard HTTP status message or 'Unknown Error' if not found\n\t * @private\n\t */\n\tprivate getDefaultStatusMessage(statusCode: number): string {\n\t\tconst statusMessages: Record<number, string> = {\n\t\t\t400: 'Bad Request',\n\t\t\t401: 'Unauthorized',\n\t\t\t403: 'Forbidden',\n\t\t\t404: 'Not Found',\n\t\t\t405: 'Method Not Allowed',\n\t\t\t406: 'Not Acceptable',\n\t\t\t408: 'Request Timeout',\n\t\t\t409: 'Conflict',\n\t\t\t410: 'Gone',\n\t\t\t422: 'Unprocessable Entity',\n\t\t\t429: 'Too Many Requests',\n\t\t\t500: 'Internal Server Error',\n\t\t\t501: 'Not Implemented',\n\t\t\t502: 'Bad Gateway',\n\t\t\t503: 'Service Unavailable',\n\t\t\t504: 'Gateway Timeout',\n\t\t};\n\t\treturn statusMessages[statusCode] || 'Unknown Error';\n\t}\n\n\t/**\n\t * Serializes the error to a JSON-compatible object.\n\t * Useful for logging and debugging purposes.\n\t *\n\t * @returns Object representation of the error including stack trace\n\t */\n\ttoJSON() {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tmessage: this.message,\n\t\t\tstatusCode: this.statusCode,\n\t\t\tstatusMessage: this.statusMessage,\n\t\t\tcode: this.code,\n\t\t\tdetails: this.details,\n\t\t\tstack: this.stack,\n\t\t};\n\t}\n}\n\n// Client Error Classes (4xx)\n\n/**\n * Represents a 400 Bad Request error.\n * Used when the client sends a malformed or invalid request.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new BadRequestError('Invalid JSON', { line: 5, column: 12 });\n * ```\n */\nexport class BadRequestError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(400, message, { details });\n\t}\n}\n\n/**\n * Represents a 401 Unauthorized error.\n * Used when authentication is required but not provided or invalid.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new UnauthorizedError('Invalid token');\n * ```\n */\nexport class UnauthorizedError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(401, message, { details });\n\t}\n}\n\n/**\n * Represents a 403 Forbidden error.\n * Used when the client is authenticated but lacks permission for the resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ForbiddenError('Insufficient permissions', { required: 'admin' });\n * ```\n */\nexport class ForbiddenError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(403, message, { details });\n\t}\n}\n\n/**\n * Represents a 404 Not Found error.\n * Used when the requested resource doesn't exist.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new NotFoundError('User not found', { userId: '123' });\n * ```\n */\nexport class NotFoundError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(404, message, { details });\n\t}\n}\n\n/**\n * Represents a 405 Method Not Allowed error.\n * Used when the HTTP method is not supported for the requested resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new MethodNotAllowedError('DELETE not supported', ['GET', 'POST', 'PUT']);\n * ```\n */\nexport class MethodNotAllowedError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param allowedMethods - Array of allowed HTTP methods for this resource\n\t */\n\tconstructor(message?: string, allowedMethods?: string[]) {\n\t\tsuper(405, message, {\n\t\t\tdetails: allowedMethods ? { allowedMethods } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 409 Conflict error.\n * Used when the request conflicts with the current state of the resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ConflictError('Email already exists', { email: 'user@example.com' });\n * ```\n */\nexport class ConflictError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(409, message, { details });\n\t}\n}\n\n/**\n * Represents a 422 Unprocessable Entity error.\n * Used when the request is well-formed but contains semantic errors.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new UnprocessableEntityError('Validation failed', {\n *   email: 'Invalid format',\n *   age: 'Must be 18 or older'\n * });\n * ```\n */\nexport class UnprocessableEntityError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param validationErrors - Object containing field-specific validation errors\n\t */\n\tconstructor(message?: string, validationErrors?: any) {\n\t\tsuper(422, message, {\n\t\t\tdetails: validationErrors ? { validationErrors } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 429 Too Many Requests error.\n * Used when the client has exceeded rate limits.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new TooManyRequestsError('Rate limit exceeded', 60); // retry after 60 seconds\n * ```\n */\nexport class TooManyRequestsError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param retryAfter - Number of seconds the client should wait before retrying\n\t */\n\tconstructor(message?: string, retryAfter?: number) {\n\t\tsuper(429, message, {\n\t\t\tdetails: retryAfter ? { retryAfter } : undefined,\n\t\t});\n\t}\n}\n\n// Server Error Classes (5xx)\n\n/**\n * Represents a 500 Internal Server Error.\n * Used for unexpected server-side errors.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new InternalServerError('Database connection failed');\n * ```\n */\nexport class InternalServerError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(500, message, { details });\n\t}\n}\n\n/**\n * Represents a 501 Not Implemented error.\n * Used when the server doesn't support the requested functionality.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new NotImplementedError('WebSocket support not implemented');\n * ```\n */\nexport class NotImplementedError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(501, message, { details });\n\t}\n}\n\n/**\n * Represents a 502 Bad Gateway error.\n * Used when the server receives an invalid response from an upstream server.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new BadGatewayError('Upstream server error');\n * ```\n */\nexport class BadGatewayError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(502, message, { details });\n\t}\n}\n\n/**\n * Represents a 503 Service Unavailable error.\n * Used when the server is temporarily unable to handle requests.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ServiceUnavailableError('Maintenance in progress', 300); // retry after 5 minutes\n * ```\n */\nexport class ServiceUnavailableError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param retryAfter - Number of seconds the client should wait before retrying\n\t */\n\tconstructor(message?: string, retryAfter?: number) {\n\t\tsuper(503, message, {\n\t\t\tdetails: retryAfter ? { retryAfter } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 504 Gateway Timeout error.\n * Used when the server doesn't receive a timely response from an upstream server.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new GatewayTimeoutError('Upstream server timeout');\n * ```\n */\nexport class GatewayTimeoutError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(504, message, { details });\n\t}\n}\n\n// Type definitions for different error factory signatures\n\n/** Factory function for standard HTTP errors with optional details */\ntype StandardErrorFactory = (message?: string, details?: any) => HttpError;\n/** Factory function for Method Not Allowed errors with allowed methods */\ntype MethodNotAllowedFactory = (\n\tmessage?: string,\n\tallowedMethods?: string[],\n) => MethodNotAllowedError;\n/** Factory function for errors that include retry-after information */\ntype RetryAfterFactory = (message?: string, retryAfter?: number) => HttpError;\n/** Factory function for validation errors with field-specific errors */\ntype ValidationErrorFactory = (\n\tmessage?: string,\n\tvalidationErrors?: any,\n) => UnprocessableEntityError;\n\n/** Discriminated union for all factory types */\ntype ErrorFactory =\n\t| { type: 'standard'; factory: StandardErrorFactory }\n\t| { type: 'methodNotAllowed'; factory: MethodNotAllowedFactory }\n\t| { type: 'retryAfter'; factory: RetryAfterFactory }\n\t| { type: 'validation'; factory: ValidationErrorFactory };\n\n/** Type-safe error registry mapping status codes to their factory functions */\nconst errorRegistry = {\n\t400: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new BadRequestError(m, d),\n\t},\n\t401: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new UnauthorizedError(m, d),\n\t},\n\t403: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new ForbiddenError(m, d),\n\t},\n\t404: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new NotFoundError(m, d),\n\t},\n\t405: {\n\t\ttype: 'methodNotAllowed',\n\t\tfactory: (m: string, am: string[]) => new MethodNotAllowedError(m, am),\n\t},\n\t409: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new ConflictError(m, d),\n\t},\n\t422: {\n\t\ttype: 'validation',\n\t\tfactory: (m: string, ve: any) => new UnprocessableEntityError(m, ve),\n\t},\n\t429: {\n\t\ttype: 'retryAfter',\n\t\tfactory: (m: string, ra: number) => new TooManyRequestsError(m, ra),\n\t},\n\t500: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new InternalServerError(m, d),\n\t},\n\t501: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new NotImplementedError(m, d),\n\t},\n\t502: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new BadGatewayError(m, d),\n\t},\n\t503: {\n\t\ttype: 'retryAfter',\n\t\tfactory: (m: string, ra: number) => new ServiceUnavailableError(m, ra),\n\t},\n\t504: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new GatewayTimeoutError(m, d),\n\t},\n} as const;\n\n/** Valid status codes that have registered error factories */\ntype ValidStatusCode = keyof typeof errorRegistry;\n\n/** Type-safe options based on status code, ensuring correct parameters for each error type */\ntype ErrorOptions<T extends number> = T extends 405\n\t? { allowedMethods?: string[]; code?: string; cause?: Error }\n\t: T extends 422\n\t\t? { validationErrors?: any; code?: string; cause?: Error }\n\t\t: T extends 429 | 503\n\t\t\t? { retryAfter?: number; code?: string; cause?: Error }\n\t\t\t: { details?: any; code?: string; cause?: Error };\n\n/** Handler functions for each factory type */\nconst factoryHandlers: Record<\n\tErrorFactory['type'],\n\t(entry: any, message?: string, options?: any) => HttpError\n> = {\n\tstandard: (entry, message, options) =>\n\t\tentry.factory(message, options?.details),\n\tmethodNotAllowed: (entry, message, options) =>\n\t\tentry.factory(message, options?.allowedMethods),\n\tretryAfter: (entry, message, options) =>\n\t\tentry.factory(message, options?.retryAfter),\n\tvalidation: (entry, message, options) =>\n\t\tentry.factory(message, options?.validationErrors),\n};\n\n/**\n * Creates an HTTP error with type-safe options based on the status code.\n * Provides IntelliSense support for status-code-specific options.\n *\n * @overload For known status codes with specific options\n * @param statusCode - A valid HTTP status code from the registry\n * @param message - Optional error message\n * @param options - Status-code-specific options\n * @returns The appropriate HttpError subclass\n *\n * @example\n * ```typescript\n * // TypeScript knows allowedMethods is valid for 405\n * createHttpError(405, 'Method not allowed', { allowedMethods: ['GET', 'POST'] });\n *\n * // TypeScript knows retryAfter is valid for 429\n * createHttpError(429, 'Rate limited', { retryAfter: 60 });\n * ```\n */\nexport function createHttpError<T extends ValidStatusCode>(\n\tstatusCode: T,\n\tmessage?: string,\n\toptions?: ErrorOptions<T>,\n): HttpError;\nexport function createHttpError(\n\tstatusCode: number,\n\tmessage?: string,\n\toptions?: HttpErrorOptions,\n): HttpError;\nexport function createHttpError(\n\tstatusCode: number,\n\tmessage?: string,\n\toptions?: any,\n): HttpError {\n\tconst entry = errorRegistry[statusCode as ValidStatusCode];\n\n\tif (entry) {\n\t\tconst handler = factoryHandlers[entry.type];\n\t\treturn handler(entry, message, options);\n\t}\n\n\t// Fallback to generic HttpError for unknown status codes\n\treturn new HttpError(statusCode, message, options);\n}\n\n/**\n * Type-safe error creation utilities with descriptive method names.\n * Provides a fluent API for creating specific HTTP errors.\n *\n * @example\n * ```typescript\n * createError.notFound('User not found');\n * createError.badRequest('Invalid input', { field: 'email' });\n * createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);\n * ```\n */\nexport const createError = {\n\tbadRequest: (message?: string, details?: any) =>\n\t\tnew BadRequestError(message, details),\n\n\tunauthorized: (message?: string, details?: any) =>\n\t\tnew UnauthorizedError(message, details),\n\n\tforbidden: (message?: string, details?: any) =>\n\t\tnew ForbiddenError(message, details),\n\n\tnotFound: (message?: string, details?: any) =>\n\t\tnew NotFoundError(message, details),\n\n\tmethodNotAllowed: (message?: string, allowedMethods?: string[]) =>\n\t\tnew MethodNotAllowedError(message, allowedMethods),\n\n\tconflict: (message?: string, details?: any) =>\n\t\tnew ConflictError(message, details),\n\n\tunprocessableEntity: (message?: string, validationErrors?: any) =>\n\t\tnew UnprocessableEntityError(message, validationErrors),\n\n\ttooManyRequests: (message?: string, retryAfter?: number) =>\n\t\tnew TooManyRequestsError(message, retryAfter),\n\n\tinternalServerError: (message?: string, details?: any) =>\n\t\tnew InternalServerError(message, details),\n\n\tnotImplemented: (message?: string, details?: any) =>\n\t\tnew NotImplementedError(message, details),\n\n\tbadGateway: (message?: string, details?: any) =>\n\t\tnew BadGatewayError(message, details),\n\n\tserviceUnavailable: (message?: string, retryAfter?: number) =>\n\t\tnew ServiceUnavailableError(message, retryAfter),\n\n\tgatewayTimeout: (message?: string, details?: any) =>\n\t\tnew GatewayTimeoutError(message, details),\n} as const;\n\n// Type guards\n\n/**\n * Type guard to check if an error is an HttpError.\n * Works with both instanceof checks and duck typing.\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError\n *\n * @example\n * ```typescript\n * try {\n *   // some code\n * } catch (error) {\n *   if (isHttpError(error)) {\n *     console.log(`HTTP ${error.statusCode}: ${error.message}`);\n *   }\n * }\n * ```\n */\nexport function isHttpError(error: unknown): error is HttpError {\n\treturn (\n\t\terror instanceof HttpError ||\n\t\t(error !== null &&\n\t\t\ttypeof error === 'object' &&\n\t\t\t'isHttpError' in error &&\n\t\t\terror.isHttpError === true)\n\t);\n}\n\n/**\n * Type guard to check if an error is a client error (4xx status code).\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError with a 4xx status code\n *\n * @example\n * ```typescript\n * if (isClientError(error)) {\n *   // Log client error metrics\n * }\n * ```\n */\nexport function isClientError(error: unknown): error is HttpError {\n\treturn (\n\t\tisHttpError(error) && error.statusCode >= 400 && error.statusCode < 500\n\t);\n}\n\n/**\n * Type guard to check if an error is a server error (5xx status code).\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError with a 5xx status code\n *\n * @example\n * ```typescript\n * if (isServerError(error)) {\n *   // Trigger alerts for server errors\n * }\n * ```\n */\nexport function isServerError(error: unknown): error is HttpError {\n\treturn (\n\t\tisHttpError(error) && error.statusCode >= 500 && error.statusCode < 600\n\t);\n}\n\n// Utility functions\n\n/**\n * Wraps an unknown error into an HttpError.\n * If the error is already an HttpError, returns it unchanged.\n *\n * @param error - The error to wrap\n * @param statusCode - The HTTP status code to use (defaults to 500)\n * @param message - Optional message to override the original error message\n * @returns An HttpError instance\n *\n * @example\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   throw wrapError(error, 503, 'Service temporarily unavailable');\n * }\n * ```\n */\nexport function wrapError(\n\terror: unknown,\n\tstatusCode = 500,\n\tmessage?: string,\n): HttpError {\n\tif (isHttpError(error)) {\n\t\treturn error;\n\t}\n\n\tif (error instanceof HttpError) {\n\t\treturn error;\n\t}\n\n\treturn new HttpError(statusCode, message || 'An unknown error occurred', {\n\t\tdetails: { originalError: error },\n\t});\n}\n\n// Types for better TypeScript support\n\n/**\n * Options for creating an HttpError.\n */\nexport interface HttpErrorOptions {\n\tstatusMessage?: string;\n\tdetails?: any;\n\tcode?: string;\n\tcause?: Error;\n}\n\n/**\n * Constructor type for HttpError classes.\n * Useful for factory patterns and dependency injection.\n */\nexport type HttpErrorConstructor = new (\n\tmessage?: string,\n\toptions?: HttpErrorOptions,\n) => HttpError;\n\n/**\n * HTTP status code enum for type-safe status code usage.\n * Includes common 2xx, 3xx, 4xx, and 5xx status codes.\n */\nexport enum HttpStatusCode {\n\t// 2xx Success\n\tOK = 200,\n\tCREATED = 201,\n\tACCEPTED = 202,\n\tNO_CONTENT = 204,\n\n\t// 3xx Redirection\n\tMOVED_PERMANENTLY = 301,\n\tFOUND = 302,\n\tNOT_MODIFIED = 304,\n\n\t// 4xx Client Error\n\tBAD_REQUEST = 400,\n\tUNAUTHORIZED = 401,\n\tFORBIDDEN = 403,\n\tNOT_FOUND = 404,\n\tMETHOD_NOT_ALLOWED = 405,\n\tNOT_ACCEPTABLE = 406,\n\tREQUEST_TIMEOUT = 408,\n\tCONFLICT = 409,\n\tGONE = 410,\n\tUNPROCESSABLE_ENTITY = 422,\n\tTOO_MANY_REQUESTS = 429,\n\n\t// 5xx Server Error\n\tINTERNAL_SERVER_ERROR = 500,\n\tNOT_IMPLEMENTED = 501,\n\tBAD_GATEWAY = 502,\n\tSERVICE_UNAVAILABLE = 503,\n\tGATEWAY_TIMEOUT = 504,\n}\n\n/**\n * Namespace containing all HTTP error classes.\n * Useful for importing all error types at once.\n *\n * @example\n * ```typescript\n * import { HttpErrors } from '@geekmidas/errors';\n * throw new HttpErrors.NotFoundError('Resource not found');\n * ```\n */\nexport const HttpErrors = {\n\tHttpError,\n\tBadRequestError,\n\tUnauthorizedError,\n\tForbiddenError,\n\tNotFoundError,\n\tMethodNotAllowedError,\n\tConflictError,\n\tUnprocessableEntityError,\n\tTooManyRequestsError,\n\tInternalServerError,\n\tNotImplementedError,\n\tBadGatewayError,\n\tServiceUnavailableError,\n\tGatewayTimeoutError,\n};\n\n// Usage examples:\n/*\n// Basic usage\nthrow new NotFoundError('User not found');\nthrow new BadRequestError('Invalid email format', { field: 'email' });\n\n// With validation errors\nthrow new UnprocessableEntityError('Validation failed', {\n  email: 'Invalid email format',\n  password: 'Password must be at least 8 characters',\n});\n\n// Type-safe factory function with IntelliSense support\nthrow createHttpError(405, 'Method not allowed', { \n  allowedMethods: ['GET', 'POST'] // TypeScript knows this is the correct option!\n});\n\nthrow createHttpError(429, 'Too many requests', { \n  retryAfter: 60 // TypeScript knows this needs retryAfter, not details!\n});\n\nthrow createHttpError(422, 'Validation failed', {\n  validationErrors: { // TypeScript knows this is for validation errors\n    email: 'Invalid format',\n    age: 'Must be 18+'\n  }\n});\n\n// Using the type-safe createError object\nthrow createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);\nthrow createError.tooManyRequests('Rate limit exceeded', 60);\nthrow createError.unprocessableEntity('Invalid input', {\n  field: 'email',\n  message: 'Invalid format'\n});\n\n// TypeScript will show errors for incorrect usage:\n// throw createHttpError(404, 'Not found', { retryAfter: 60 }); // ❌ Type error!\n// throw createError.notFound('User not found', 60); // ❌ Type error!\n\n// Wrapping unknown errors\ntry {\n  await someAsyncOperation();\n} catch (error) {\n  throw wrapError(error, 500, 'Failed to process request');\n}\n\n// In Express middleware\napp.use(expressErrorHandler);\n\n// Type checking\nif (isClientError(error)) {\n  console.log('Client made a bad request');\n}\n*/\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["// http-errors.ts - Core HTTP Error Classes and Types\n\n/**\n * Base HTTP Error class that extends the native Error.\n * Provides a foundation for all HTTP-specific errors with status codes and structured error responses.\n *\n * @extends Error\n *\n * @example\n * ```typescript\n * throw new HttpError(400, 'Bad Request', {\n *   details: { field: 'email', message: 'Invalid format' }\n * });\n * ```\n */\nexport class HttpError extends Error {\n\t/** The HTTP status code (e.g., 400, 404, 500) */\n\tpublic readonly statusCode: number;\n\t/** The standard HTTP status message (e.g., 'Bad Request', 'Not Found') */\n\tpublic readonly statusMessage: string;\n\t/** Type discriminator for runtime type checking */\n\tpublic readonly isHttpError = true;\n\t/** Additional error details for debugging or client information */\n\tpublic readonly details?: any;\n\t/** Application-specific error code for client-side handling */\n\tpublic readonly code?: string;\n\n\t/**\n\t * Creates a new HttpError instance.\n\t *\n\t * @param statusCode - The HTTP status code\n\t * @param message - Optional error message for the client\n\t * @param options - Optional configuration object\n\t * @param options.statusMessage - Override the default status message\n\t * @param options.details - Additional error details or context\n\t * @param options.code - Application-specific error code\n\t * @param options.cause - The underlying error that caused this error (ES2022)\n\t */\n\tconstructor(\n\t\tstatusCode: number,\n\t\tmessage?: string,\n\t\toptions?: {\n\t\t\tstatusMessage?: string;\n\t\t\tdetails?: any;\n\t\t\tcode?: string;\n\t\t\tcause?: Error;\n\t\t},\n\t) {\n\t\tsuper(message || options?.statusMessage || 'HTTP Error');\n\t\tthis.name = this.constructor.name;\n\t\tthis.statusCode = statusCode;\n\t\tthis.statusMessage =\n\t\t\toptions?.statusMessage || this.getDefaultStatusMessage(statusCode);\n\t\tthis.details = options?.details;\n\t\tthis.code = options?.code;\n\n\t\t// Set cause if provided (ES2022 feature)\n\t\tif (options?.cause) {\n\t\t\tthis.cause = options.cause;\n\t\t}\n\t\t// Maintains proper stack trace for where our error was thrown\n\t\tError.captureStackTrace(this, this.constructor);\n\t}\n\n\t/**\n\t * Gets the error response body as a JSON string.\n\t * Used for sending the error response to clients.\n\t *\n\t * @returns JSON string containing message, code, and error details\n\t */\n\tget body() {\n\t\treturn JSON.stringify({\n\t\t\tmessage: this.message,\n\t\t\tcode: this.code,\n\t\t\terror: this.details,\n\t\t});\n\t}\n\n\t/**\n\t * Gets the default HTTP status message for a given status code.\n\t *\n\t * @param statusCode - The HTTP status code\n\t * @returns The standard HTTP status message or 'Unknown Error' if not found\n\t * @private\n\t */\n\tprivate getDefaultStatusMessage(statusCode: number): string {\n\t\tconst statusMessages: Record<number, string> = {\n\t\t\t400: 'Bad Request',\n\t\t\t401: 'Unauthorized',\n\t\t\t403: 'Forbidden',\n\t\t\t404: 'Not Found',\n\t\t\t405: 'Method Not Allowed',\n\t\t\t406: 'Not Acceptable',\n\t\t\t408: 'Request Timeout',\n\t\t\t409: 'Conflict',\n\t\t\t410: 'Gone',\n\t\t\t422: 'Unprocessable Entity',\n\t\t\t429: 'Too Many Requests',\n\t\t\t500: 'Internal Server Error',\n\t\t\t501: 'Not Implemented',\n\t\t\t502: 'Bad Gateway',\n\t\t\t503: 'Service Unavailable',\n\t\t\t504: 'Gateway Timeout',\n\t\t};\n\t\treturn statusMessages[statusCode] || 'Unknown Error';\n\t}\n\n\t/**\n\t * Serializes the error to a JSON-compatible object.\n\t * Useful for logging and debugging purposes.\n\t *\n\t * @returns Object representation of the error including stack trace\n\t */\n\ttoJSON() {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tmessage: this.message,\n\t\t\tstatusCode: this.statusCode,\n\t\t\tstatusMessage: this.statusMessage,\n\t\t\tcode: this.code,\n\t\t\tdetails: this.details,\n\t\t\tstack: this.stack,\n\t\t};\n\t}\n}\n\n// Client Error Classes (4xx)\n\n/**\n * Represents a 400 Bad Request error.\n * Used when the client sends a malformed or invalid request.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new BadRequestError('Invalid JSON', { line: 5, column: 12 });\n * ```\n */\nexport class BadRequestError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(400, message, { details });\n\t}\n}\n\n/**\n * Represents a 401 Unauthorized error.\n * Used when authentication is required but not provided or invalid.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new UnauthorizedError('Invalid token');\n * ```\n */\nexport class UnauthorizedError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(401, message, { details });\n\t}\n}\n\n/**\n * Represents a 403 Forbidden error.\n * Used when the client is authenticated but lacks permission for the resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ForbiddenError('Insufficient permissions', { required: 'admin' });\n * ```\n */\nexport class ForbiddenError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(403, message, { details });\n\t}\n}\n\n/**\n * Represents a 404 Not Found error.\n * Used when the requested resource doesn't exist.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new NotFoundError('User not found', { userId: '123' });\n * ```\n */\nexport class NotFoundError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(404, message, { details });\n\t}\n}\n\n/**\n * Represents a 405 Method Not Allowed error.\n * Used when the HTTP method is not supported for the requested resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new MethodNotAllowedError('DELETE not supported', ['GET', 'POST', 'PUT']);\n * ```\n */\nexport class MethodNotAllowedError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param allowedMethods - Array of allowed HTTP methods for this resource\n\t */\n\tconstructor(message?: string, allowedMethods?: string[]) {\n\t\tsuper(405, message, {\n\t\t\tdetails: allowedMethods ? { allowedMethods } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 409 Conflict error.\n * Used when the request conflicts with the current state of the resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ConflictError('Email already exists', { email: 'user@example.com' });\n * ```\n */\nexport class ConflictError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(409, message, { details });\n\t}\n}\n\n/**\n * Represents a 422 Unprocessable Entity error.\n * Used when the request is well-formed but contains semantic errors.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new UnprocessableEntityError('Validation failed', {\n *   email: 'Invalid format',\n *   age: 'Must be 18 or older'\n * });\n * ```\n */\nexport class UnprocessableEntityError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param validationErrors - Object containing field-specific validation errors\n\t */\n\tconstructor(message?: string, validationErrors?: any) {\n\t\tsuper(422, message, {\n\t\t\tdetails: validationErrors ? { validationErrors } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 429 Too Many Requests error.\n * Used when the client has exceeded rate limits.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new TooManyRequestsError('Rate limit exceeded', 60); // retry after 60 seconds\n * ```\n */\nexport class TooManyRequestsError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param retryAfter - Number of seconds the client should wait before retrying\n\t */\n\tconstructor(message?: string, retryAfter?: number) {\n\t\tsuper(429, message, {\n\t\t\tdetails: retryAfter ? { retryAfter } : undefined,\n\t\t});\n\t}\n}\n\n// Server Error Classes (5xx)\n\n/**\n * Represents a 500 Internal Server Error.\n * Used for unexpected server-side errors.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new InternalServerError('Database connection failed');\n * ```\n */\nexport class InternalServerError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(500, message, { details });\n\t}\n}\n\n/**\n * Represents a 501 Not Implemented error.\n * Used when the server doesn't support the requested functionality.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new NotImplementedError('WebSocket support not implemented');\n * ```\n */\nexport class NotImplementedError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(501, message, { details });\n\t}\n}\n\n/**\n * Represents a 502 Bad Gateway error.\n * Used when the server receives an invalid response from an upstream server.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new BadGatewayError('Upstream server error');\n * ```\n */\nexport class BadGatewayError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(502, message, { details });\n\t}\n}\n\n/**\n * Represents a 503 Service Unavailable error.\n * Used when the server is temporarily unable to handle requests.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ServiceUnavailableError('Maintenance in progress', 300); // retry after 5 minutes\n * ```\n */\nexport class ServiceUnavailableError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param retryAfter - Number of seconds the client should wait before retrying\n\t */\n\tconstructor(message?: string, retryAfter?: number) {\n\t\tsuper(503, message, {\n\t\t\tdetails: retryAfter ? { retryAfter } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 504 Gateway Timeout error.\n * Used when the server doesn't receive a timely response from an upstream server.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new GatewayTimeoutError('Upstream server timeout');\n * ```\n */\nexport class GatewayTimeoutError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(504, message, { details });\n\t}\n}\n\n// Type definitions for different error factory signatures\n\n/** Factory function for standard HTTP errors with optional details */\ntype StandardErrorFactory = (message?: string, details?: any) => HttpError;\n/** Factory function for Method Not Allowed errors with allowed methods */\ntype MethodNotAllowedFactory = (\n\tmessage?: string,\n\tallowedMethods?: string[],\n) => MethodNotAllowedError;\n/** Factory function for errors that include retry-after information */\ntype RetryAfterFactory = (message?: string, retryAfter?: number) => HttpError;\n/** Factory function for validation errors with field-specific errors */\ntype ValidationErrorFactory = (\n\tmessage?: string,\n\tvalidationErrors?: any,\n) => UnprocessableEntityError;\n\n/** Discriminated union for all factory types */\ntype ErrorFactory =\n\t| { type: 'standard'; factory: StandardErrorFactory }\n\t| { type: 'methodNotAllowed'; factory: MethodNotAllowedFactory }\n\t| { type: 'retryAfter'; factory: RetryAfterFactory }\n\t| { type: 'validation'; factory: ValidationErrorFactory };\n\n/** Type-safe error registry mapping status codes to their factory functions */\nconst errorRegistry = {\n\t400: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new BadRequestError(m, d),\n\t},\n\t401: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new UnauthorizedError(m, d),\n\t},\n\t403: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new ForbiddenError(m, d),\n\t},\n\t404: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new NotFoundError(m, d),\n\t},\n\t405: {\n\t\ttype: 'methodNotAllowed',\n\t\tfactory: (m: string, am: string[]) => new MethodNotAllowedError(m, am),\n\t},\n\t409: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new ConflictError(m, d),\n\t},\n\t422: {\n\t\ttype: 'validation',\n\t\tfactory: (m: string, ve: any) => new UnprocessableEntityError(m, ve),\n\t},\n\t429: {\n\t\ttype: 'retryAfter',\n\t\tfactory: (m: string, ra: number) => new TooManyRequestsError(m, ra),\n\t},\n\t500: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new InternalServerError(m, d),\n\t},\n\t501: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new NotImplementedError(m, d),\n\t},\n\t502: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new BadGatewayError(m, d),\n\t},\n\t503: {\n\t\ttype: 'retryAfter',\n\t\tfactory: (m: string, ra: number) => new ServiceUnavailableError(m, ra),\n\t},\n\t504: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new GatewayTimeoutError(m, d),\n\t},\n} as const;\n\n/** Valid status codes that have registered error factories */\ntype ValidStatusCode = keyof typeof errorRegistry;\n\n/** Type-safe options based on status code, ensuring correct parameters for each error type */\ntype ErrorOptions<T extends number> = T extends 405\n\t? { allowedMethods?: string[]; code?: string; cause?: Error }\n\t: T extends 422\n\t\t? { validationErrors?: any; code?: string; cause?: Error }\n\t\t: T extends 429 | 503\n\t\t\t? { retryAfter?: number; code?: string; cause?: Error }\n\t\t\t: { details?: any; code?: string; cause?: Error };\n\n/** Handler functions for each factory type */\nconst factoryHandlers: Record<\n\tErrorFactory['type'],\n\t(entry: any, message?: string, options?: any) => HttpError\n> = {\n\tstandard: (entry, message, options) =>\n\t\tentry.factory(message, options?.details),\n\tmethodNotAllowed: (entry, message, options) =>\n\t\tentry.factory(message, options?.allowedMethods),\n\tretryAfter: (entry, message, options) =>\n\t\tentry.factory(message, options?.retryAfter),\n\tvalidation: (entry, message, options) =>\n\t\tentry.factory(message, options?.validationErrors),\n};\n\n/**\n * Creates an HTTP error with type-safe options based on the status code.\n * Provides IntelliSense support for status-code-specific options.\n *\n * @overload For known status codes with specific options\n * @param statusCode - A valid HTTP status code from the registry\n * @param message - Optional error message\n * @param options - Status-code-specific options\n * @returns The appropriate HttpError subclass\n *\n * @example\n * ```typescript\n * // TypeScript knows allowedMethods is valid for 405\n * createHttpError(405, 'Method not allowed', { allowedMethods: ['GET', 'POST'] });\n *\n * // TypeScript knows retryAfter is valid for 429\n * createHttpError(429, 'Rate limited', { retryAfter: 60 });\n * ```\n */\nexport function createHttpError<T extends ValidStatusCode>(\n\tstatusCode: T,\n\tmessage?: string,\n\toptions?: ErrorOptions<T>,\n): HttpError;\nexport function createHttpError(\n\tstatusCode: number,\n\tmessage?: string,\n\toptions?: HttpErrorOptions,\n): HttpError;\nexport function createHttpError(\n\tstatusCode: number,\n\tmessage?: string,\n\toptions?: any,\n): HttpError {\n\tconst entry = errorRegistry[statusCode as ValidStatusCode];\n\n\tif (entry) {\n\t\tconst handler = factoryHandlers[entry.type];\n\t\treturn handler(entry, message, options);\n\t}\n\n\t// Fallback to generic HttpError for unknown status codes\n\treturn new HttpError(statusCode, message, options);\n}\n\n/**\n * Type-safe error creation utilities with descriptive method names.\n * Provides a fluent API for creating specific HTTP errors.\n *\n * @example\n * ```typescript\n * createError.notFound('User not found');\n * createError.badRequest('Invalid input', { field: 'email' });\n * createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);\n * ```\n */\nexport const createError = {\n\tbadRequest: (message?: string, details?: any) =>\n\t\tnew BadRequestError(message, details),\n\n\tunauthorized: (message?: string, details?: any) =>\n\t\tnew UnauthorizedError(message, details),\n\n\tforbidden: (message?: string, details?: any) =>\n\t\tnew ForbiddenError(message, details),\n\n\tnotFound: (message?: string, details?: any) =>\n\t\tnew NotFoundError(message, details),\n\n\tmethodNotAllowed: (message?: string, allowedMethods?: string[]) =>\n\t\tnew MethodNotAllowedError(message, allowedMethods),\n\n\tconflict: (message?: string, details?: any) =>\n\t\tnew ConflictError(message, details),\n\n\tunprocessableEntity: (message?: string, validationErrors?: any) =>\n\t\tnew UnprocessableEntityError(message, validationErrors),\n\n\ttooManyRequests: (message?: string, retryAfter?: number) =>\n\t\tnew TooManyRequestsError(message, retryAfter),\n\n\tinternalServerError: (message?: string, details?: any) =>\n\t\tnew InternalServerError(message, details),\n\n\tnotImplemented: (message?: string, details?: any) =>\n\t\tnew NotImplementedError(message, details),\n\n\tbadGateway: (message?: string, details?: any) =>\n\t\tnew BadGatewayError(message, details),\n\n\tserviceUnavailable: (message?: string, retryAfter?: number) =>\n\t\tnew ServiceUnavailableError(message, retryAfter),\n\n\tgatewayTimeout: (message?: string, details?: any) =>\n\t\tnew GatewayTimeoutError(message, details),\n} as const;\n\n// Type guards\n\n/**\n * Type guard to check if an error is an HttpError.\n * Works with both instanceof checks and duck typing.\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError\n *\n * @example\n * ```typescript\n * try {\n *   // some code\n * } catch (error) {\n *   if (isHttpError(error)) {\n *     console.log(`HTTP ${error.statusCode}: ${error.message}`);\n *   }\n * }\n * ```\n */\nexport function isHttpError(error: unknown): error is HttpError {\n\treturn (\n\t\terror instanceof HttpError ||\n\t\t(error !== null &&\n\t\t\ttypeof error === 'object' &&\n\t\t\t'isHttpError' in error &&\n\t\t\terror.isHttpError === true)\n\t);\n}\n\n/**\n * Type guard to check if an error is a client error (4xx status code).\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError with a 4xx status code\n *\n * @example\n * ```typescript\n * if (isClientError(error)) {\n *   // Log client error metrics\n * }\n * ```\n */\nexport function isClientError(error: unknown): error is HttpError {\n\treturn (\n\t\tisHttpError(error) && error.statusCode >= 400 && error.statusCode < 500\n\t);\n}\n\n/**\n * Type guard to check if an error is a server error (5xx status code).\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError with a 5xx status code\n *\n * @example\n * ```typescript\n * if (isServerError(error)) {\n *   // Trigger alerts for server errors\n * }\n * ```\n */\nexport function isServerError(error: unknown): error is HttpError {\n\treturn (\n\t\tisHttpError(error) && error.statusCode >= 500 && error.statusCode < 600\n\t);\n}\n\n// Utility functions\n\n/**\n * Wraps an unknown error into an HttpError.\n * If the error is already an HttpError, returns it unchanged.\n *\n * @param error - The error to wrap\n * @param statusCode - The HTTP status code to use (defaults to 500)\n * @param message - Optional message to override the original error message\n * @returns An HttpError instance\n *\n * @example\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   throw wrapError(error, 503, 'Service temporarily unavailable');\n * }\n * ```\n */\nexport function wrapError(\n\terror: unknown,\n\tstatusCode = 500,\n\tmessage?: string,\n): HttpError {\n\tif (isHttpError(error)) {\n\t\treturn error;\n\t}\n\n\tif (error instanceof HttpError) {\n\t\treturn error;\n\t}\n\n\treturn new HttpError(statusCode, message || 'An unknown error occurred', {\n\t\tdetails: { originalError: error },\n\t});\n}\n\n// Types for better TypeScript support\n\n/**\n * Options for creating an HttpError.\n */\nexport interface HttpErrorOptions {\n\tstatusMessage?: string;\n\tdetails?: any;\n\tcode?: string;\n\tcause?: Error;\n}\n\n/**\n * Constructor type for HttpError classes.\n * Useful for factory patterns and dependency injection.\n */\nexport type HttpErrorConstructor = new (\n\tmessage?: string,\n\toptions?: HttpErrorOptions,\n) => HttpError;\n\n/**\n * HTTP status code enum for type-safe status code usage.\n * Includes common 2xx, 3xx, 4xx, and 5xx status codes.\n */\nexport enum HttpStatusCode {\n\t// 2xx Success\n\tOK = 200,\n\tCREATED = 201,\n\tACCEPTED = 202,\n\tNO_CONTENT = 204,\n\n\t// 3xx Redirection\n\tMOVED_PERMANENTLY = 301,\n\tFOUND = 302,\n\tNOT_MODIFIED = 304,\n\n\t// 4xx Client Error\n\tBAD_REQUEST = 400,\n\tUNAUTHORIZED = 401,\n\tFORBIDDEN = 403,\n\tNOT_FOUND = 404,\n\tMETHOD_NOT_ALLOWED = 405,\n\tNOT_ACCEPTABLE = 406,\n\tREQUEST_TIMEOUT = 408,\n\tCONFLICT = 409,\n\tGONE = 410,\n\tUNPROCESSABLE_ENTITY = 422,\n\tTOO_MANY_REQUESTS = 429,\n\n\t// 5xx Server Error\n\tINTERNAL_SERVER_ERROR = 500,\n\tNOT_IMPLEMENTED = 501,\n\tBAD_GATEWAY = 502,\n\tSERVICE_UNAVAILABLE = 503,\n\tGATEWAY_TIMEOUT = 504,\n}\n\n/**\n * Namespace containing all HTTP error classes.\n * Useful for importing all error types at once.\n *\n * @example\n * ```typescript\n * import { HttpErrors } from '@geekmidas/errors';\n * throw new HttpErrors.NotFoundError('Resource not found');\n * ```\n */\nexport const HttpErrors = {\n\tHttpError,\n\tBadRequestError,\n\tUnauthorizedError,\n\tForbiddenError,\n\tNotFoundError,\n\tMethodNotAllowedError,\n\tConflictError,\n\tUnprocessableEntityError,\n\tTooManyRequestsError,\n\tInternalServerError,\n\tNotImplementedError,\n\tBadGatewayError,\n\tServiceUnavailableError,\n\tGatewayTimeoutError,\n};\n\n// Usage examples:\n/*\n// Basic usage\nthrow new NotFoundError('User not found');\nthrow new BadRequestError('Invalid email format', { field: 'email' });\n\n// With validation errors\nthrow new UnprocessableEntityError('Validation failed', {\n  email: 'Invalid email format',\n  password: 'Password must be at least 8 characters',\n});\n\n// Type-safe factory function with IntelliSense support\nthrow createHttpError(405, 'Method not allowed', { \n  allowedMethods: ['GET', 'POST'] // TypeScript knows this is the correct option!\n});\n\nthrow createHttpError(429, 'Too many requests', { \n  retryAfter: 60 // TypeScript knows this needs retryAfter, not details!\n});\n\nthrow createHttpError(422, 'Validation failed', {\n  validationErrors: { // TypeScript knows this is for validation errors\n    email: 'Invalid format',\n    age: 'Must be 18+'\n  }\n});\n\n// Using the type-safe createError object\nthrow createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);\nthrow createError.tooManyRequests('Rate limit exceeded', 60);\nthrow createError.unprocessableEntity('Invalid input', {\n  field: 'email',\n  message: 'Invalid format'\n});\n\n// TypeScript will show errors for incorrect usage:\n// throw createHttpError(404, 'Not found', { retryAfter: 60 }); // ❌ Type error!\n// throw createError.notFound('User not found', 60); // ❌ Type error!\n\n// Wrapping unknown errors\ntry {\n  await someAsyncOperation();\n} catch (error) {\n  throw wrapError(error, 500, 'Failed to process request');\n}\n\n// In Express middleware\napp.use(expressErrorHandler);\n\n// Type checking\nif (isClientError(error)) {\n  console.log('Client made a bad request');\n}\n*/\n"],"mappings":";;;;;;;;;;;;;;;AAeA,IAAa,YAAb,cAA+B,MAAM;;CAEpC;;CAEA;;CAEA,cAA8B;;CAE9B;;CAEA;;;;;;;;;;;;CAaA,YACC,YACA,SACA,SAMC;EACD,MAAM,WAAW,SAAS,iBAAiB,YAAY;EACvD,KAAK,OAAO,KAAK,YAAY;EAC7B,KAAK,aAAa;EAClB,KAAK,gBACJ,SAAS,iBAAiB,KAAK,wBAAwB,UAAU;EAClE,KAAK,UAAU,SAAS;EACxB,KAAK,OAAO,SAAS;EAGrB,IAAI,SAAS,OACZ,KAAK,QAAQ,QAAQ;EAGtB,MAAM,kBAAkB,MAAM,KAAK,WAAW;CAC/C;;;;;;;CAQA,IAAI,OAAO;EACV,OAAO,KAAK,UAAU;GACrB,SAAS,KAAK;GACd,MAAM,KAAK;GACX,OAAO,KAAK;EACb,CAAC;CACF;;;;;;;;CASA,wBAAgC,YAA4B;EAmB3D,OAAO;GAjBN,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;EAEc,EAAE,eAAe;CACtC;;;;;;;CAQA,SAAS;EACR,OAAO;GACN,MAAM,KAAK;GACX,SAAS,KAAK;GACd,YAAY,KAAK;GACjB,eAAe,KAAK;GACpB,MAAM,KAAK;GACX,SAAS,KAAK;GACd,OAAO,KAAK;EACb;CACD;AACD;;;;;;;;;;;;AAeA,IAAa,kBAAb,cAAqC,UAAU;CAC9C,YAAY,SAAkB,SAAe;EAC5C,MAAM,KAAK,SAAS,EAAE,QAAQ,CAAC;CAChC;AACD;;;;;;;;;;;;AAaA,IAAa,oBAAb,cAAuC,UAAU;CAChD,YAAY,SAAkB,SAAe;EAC5C,MAAM,KAAK,SAAS,EAAE,QAAQ,CAAC;CAChC;AACD;;;;;;;;;;;;AAaA,IAAa,iBAAb,cAAoC,UAAU;CAC7C,YAAY,SAAkB,SAAe;EAC5C,MAAM,KAAK,SAAS,EAAE,QAAQ,CAAC;CAChC;AACD;;;;;;;;;;;;AAaA,IAAa,gBAAb,cAAmC,UAAU;CAC5C,YAAY,SAAkB,SAAe;EAC5C,MAAM,KAAK,SAAS,EAAE,QAAQ,CAAC;CAChC;AACD;;;;;;;;;;;;AAaA,IAAa,wBAAb,cAA2C,UAAU;;;;;CAKpD,YAAY,SAAkB,gBAA2B;EACxD,MAAM,KAAK,SAAS,EACnB,SAAS,iBAAiB,EAAE,eAAe,IAAI,KAAA,EAChD,CAAC;CACF;AACD;;;;;;;;;;;;AAaA,IAAa,gBAAb,cAAmC,UAAU;CAC5C,YAAY,SAAkB,SAAe;EAC5C,MAAM,KAAK,SAAS,EAAE,QAAQ,CAAC;CAChC;AACD;;;;;;;;;;;;;;;AAgBA,IAAa,2BAAb,cAA8C,UAAU;;;;;CAKvD,YAAY,SAAkB,kBAAwB;EACrD,MAAM,KAAK,SAAS,EACnB,SAAS,mBAAmB,EAAE,iBAAiB,IAAI,KAAA,EACpD,CAAC;CACF;AACD;;;;;;;;;;;;AAaA,IAAa,uBAAb,cAA0C,UAAU;;;;;CAKnD,YAAY,SAAkB,YAAqB;EAClD,MAAM,KAAK,SAAS,EACnB,SAAS,aAAa,EAAE,WAAW,IAAI,KAAA,EACxC,CAAC;CACF;AACD;;;;;;;;;;;;AAeA,IAAa,sBAAb,cAAyC,UAAU;CAClD,YAAY,SAAkB,SAAe;EAC5C,MAAM,KAAK,SAAS,EAAE,QAAQ,CAAC;CAChC;AACD;;;;;;;;;;;;AAaA,IAAa,sBAAb,cAAyC,UAAU;CAClD,YAAY,SAAkB,SAAe;EAC5C,MAAM,KAAK,SAAS,EAAE,QAAQ,CAAC;CAChC;AACD;;;;;;;;;;;;AAaA,IAAa,kBAAb,cAAqC,UAAU;CAC9C,YAAY,SAAkB,SAAe;EAC5C,MAAM,KAAK,SAAS,EAAE,QAAQ,CAAC;CAChC;AACD;;;;;;;;;;;;AAaA,IAAa,0BAAb,cAA6C,UAAU;;;;;CAKtD,YAAY,SAAkB,YAAqB;EAClD,MAAM,KAAK,SAAS,EACnB,SAAS,aAAa,EAAE,WAAW,IAAI,KAAA,EACxC,CAAC;CACF;AACD;;;;;;;;;;;;AAaA,IAAa,sBAAb,cAAyC,UAAU;CAClD,YAAY,SAAkB,SAAe;EAC5C,MAAM,KAAK,SAAS,EAAE,QAAQ,CAAC;CAChC;AACD;;AA2BA,MAAM,gBAAgB;CACrB,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,MAAW,IAAI,gBAAgB,GAAG,CAAC;CACzD;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,MAAW,IAAI,kBAAkB,GAAG,CAAC;CAC3D;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,MAAW,IAAI,eAAe,GAAG,CAAC;CACxD;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,MAAW,IAAI,cAAc,GAAG,CAAC;CACvD;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,OAAiB,IAAI,sBAAsB,GAAG,EAAE;CACtE;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,MAAW,IAAI,cAAc,GAAG,CAAC;CACvD;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,OAAY,IAAI,yBAAyB,GAAG,EAAE;CACpE;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,OAAe,IAAI,qBAAqB,GAAG,EAAE;CACnE;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,MAAW,IAAI,oBAAoB,GAAG,CAAC;CAC7D;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,MAAW,IAAI,oBAAoB,GAAG,CAAC;CAC7D;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,MAAW,IAAI,gBAAgB,GAAG,CAAC;CACzD;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,OAAe,IAAI,wBAAwB,GAAG,EAAE;CACtE;CACA,KAAK;EACJ,MAAM;EACN,UAAU,GAAW,MAAW,IAAI,oBAAoB,GAAG,CAAC;CAC7D;AACD;;AAeA,MAAM,kBAGF;CACH,WAAW,OAAO,SAAS,YAC1B,MAAM,QAAQ,SAAS,SAAS,OAAO;CACxC,mBAAmB,OAAO,SAAS,YAClC,MAAM,QAAQ,SAAS,SAAS,cAAc;CAC/C,aAAa,OAAO,SAAS,YAC5B,MAAM,QAAQ,SAAS,SAAS,UAAU;CAC3C,aAAa,OAAO,SAAS,YAC5B,MAAM,QAAQ,SAAS,SAAS,gBAAgB;AAClD;AA+BA,SAAgB,gBACf,YACA,SACA,SACY;CACZ,MAAM,QAAQ,cAAc;CAE5B,IAAI,OAAO;EACV,MAAM,UAAU,gBAAgB,MAAM;EACtC,OAAO,QAAQ,OAAO,SAAS,OAAO;CACvC;CAGA,OAAO,IAAI,UAAU,YAAY,SAAS,OAAO;AAClD;;;;;;;;;;;;AAaA,MAAa,cAAc;CAC1B,aAAa,SAAkB,YAC9B,IAAI,gBAAgB,SAAS,OAAO;CAErC,eAAe,SAAkB,YAChC,IAAI,kBAAkB,SAAS,OAAO;CAEvC,YAAY,SAAkB,YAC7B,IAAI,eAAe,SAAS,OAAO;CAEpC,WAAW,SAAkB,YAC5B,IAAI,cAAc,SAAS,OAAO;CAEnC,mBAAmB,SAAkB,mBACpC,IAAI,sBAAsB,SAAS,cAAc;CAElD,WAAW,SAAkB,YAC5B,IAAI,cAAc,SAAS,OAAO;CAEnC,sBAAsB,SAAkB,qBACvC,IAAI,yBAAyB,SAAS,gBAAgB;CAEvD,kBAAkB,SAAkB,eACnC,IAAI,qBAAqB,SAAS,UAAU;CAE7C,sBAAsB,SAAkB,YACvC,IAAI,oBAAoB,SAAS,OAAO;CAEzC,iBAAiB,SAAkB,YAClC,IAAI,oBAAoB,SAAS,OAAO;CAEzC,aAAa,SAAkB,YAC9B,IAAI,gBAAgB,SAAS,OAAO;CAErC,qBAAqB,SAAkB,eACtC,IAAI,wBAAwB,SAAS,UAAU;CAEhD,iBAAiB,SAAkB,YAClC,IAAI,oBAAoB,SAAS,OAAO;AAC1C;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,YAAY,OAAoC;CAC/D,OACC,iBAAiB,aAChB,UAAU,QACV,OAAO,UAAU,YACjB,iBAAiB,SACjB,MAAM,gBAAgB;AAEzB;;;;;;;;;;;;;;AAeA,SAAgB,cAAc,OAAoC;CACjE,OACC,YAAY,KAAK,KAAK,MAAM,cAAc,OAAO,MAAM,aAAa;AAEtE;;;;;;;;;;;;;;AAeA,SAAgB,cAAc,OAAoC;CACjE,OACC,YAAY,KAAK,KAAK,MAAM,cAAc,OAAO,MAAM,aAAa;AAEtE;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,UACf,OACA,aAAa,KACb,SACY;CACZ,IAAI,YAAY,KAAK,GACpB,OAAO;CAGR,IAAI,iBAAiB,WACpB,OAAO;CAGR,OAAO,IAAI,UAAU,YAAY,WAAW,6BAA6B,EACxE,SAAS,EAAE,eAAe,MAAM,EACjC,CAAC;AACF;;;;;AA2BA,IAAY,iBAAL,yBAAA,gBAAA;CAEN,eAAA,eAAA,QAAA,OAAA;CACA,eAAA,eAAA,aAAA,OAAA;CACA,eAAA,eAAA,cAAA,OAAA;CACA,eAAA,eAAA,gBAAA,OAAA;CAGA,eAAA,eAAA,uBAAA,OAAA;CACA,eAAA,eAAA,WAAA,OAAA;CACA,eAAA,eAAA,kBAAA,OAAA;CAGA,eAAA,eAAA,iBAAA,OAAA;CACA,eAAA,eAAA,kBAAA,OAAA;CACA,eAAA,eAAA,eAAA,OAAA;CACA,eAAA,eAAA,eAAA,OAAA;CACA,eAAA,eAAA,wBAAA,OAAA;CACA,eAAA,eAAA,oBAAA,OAAA;CACA,eAAA,eAAA,qBAAA,OAAA;CACA,eAAA,eAAA,cAAA,OAAA;CACA,eAAA,eAAA,UAAA,OAAA;CACA,eAAA,eAAA,0BAAA,OAAA;CACA,eAAA,eAAA,uBAAA,OAAA;CAGA,eAAA,eAAA,2BAAA,OAAA;CACA,eAAA,eAAA,qBAAA,OAAA;CACA,eAAA,eAAA,iBAAA,OAAA;CACA,eAAA,eAAA,yBAAA,OAAA;CACA,eAAA,eAAA,qBAAA,OAAA;;AACD,EAAA,CAAA,CAAA;;;;;;;;;;;AAYA,MAAa,aAAa;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD"}

package/dist/index.d.cts

@@ -12,7 +12,7 @@
  * });
  * ```
  */
-declare class HttpError extends Error {
+export declare class HttpError extends Error {
   /** The HTTP status code (e.g., 400, 404, 500) */
   readonly statusCode: number;
   /** The standard HTTP status message (e.g., 'Bad Request', 'Not Found') */
@@ -82,7 +82,7 @@ declare class HttpError extends Error {
  * throw new BadRequestError('Invalid JSON', { line: 5, column: 12 });
  * ```
  */
-declare class BadRequestError extends HttpError {
+export declare class BadRequestError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -96,7 +96,7 @@ declare class BadRequestError extends HttpError {
  * throw new UnauthorizedError('Invalid token');
  * ```
  */
-declare class UnauthorizedError extends HttpError {
+export declare class UnauthorizedError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -110,7 +110,7 @@ declare class UnauthorizedError extends HttpError {
  * throw new ForbiddenError('Insufficient permissions', { required: 'admin' });
  * ```
  */
-declare class ForbiddenError extends HttpError {
+export declare class ForbiddenError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -124,7 +124,7 @@ declare class ForbiddenError extends HttpError {
  * throw new NotFoundError('User not found', { userId: '123' });
  * ```
  */
-declare class NotFoundError extends HttpError {
+export declare class NotFoundError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -138,7 +138,7 @@ declare class NotFoundError extends HttpError {
  * throw new MethodNotAllowedError('DELETE not supported', ['GET', 'POST', 'PUT']);
  * ```
  */
-declare class MethodNotAllowedError extends HttpError {
+export declare class MethodNotAllowedError extends HttpError {
   /**
    * @param message - Optional error message
    * @param allowedMethods - Array of allowed HTTP methods for this resource
@@ -156,7 +156,7 @@ declare class MethodNotAllowedError extends HttpError {
  * throw new ConflictError('Email already exists', { email: 'user@example.com' });
  * ```
  */
-declare class ConflictError extends HttpError {
+export declare class ConflictError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -173,7 +173,7 @@ declare class ConflictError extends HttpError {
  * });
  * ```
  */
-declare class UnprocessableEntityError extends HttpError {
+export declare class UnprocessableEntityError extends HttpError {
   /**
    * @param message - Optional error message
    * @param validationErrors - Object containing field-specific validation errors
@@ -191,7 +191,7 @@ declare class UnprocessableEntityError extends HttpError {
  * throw new TooManyRequestsError('Rate limit exceeded', 60); // retry after 60 seconds
  * ```
  */
-declare class TooManyRequestsError extends HttpError {
+export declare class TooManyRequestsError extends HttpError {
   /**
    * @param message - Optional error message
    * @param retryAfter - Number of seconds the client should wait before retrying
@@ -209,7 +209,7 @@ declare class TooManyRequestsError extends HttpError {
  * throw new InternalServerError('Database connection failed');
  * ```
  */
-declare class InternalServerError extends HttpError {
+export declare class InternalServerError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -223,7 +223,7 @@ declare class InternalServerError extends HttpError {
  * throw new NotImplementedError('WebSocket support not implemented');
  * ```
  */
-declare class NotImplementedError extends HttpError {
+export declare class NotImplementedError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -237,7 +237,7 @@ declare class NotImplementedError extends HttpError {
  * throw new BadGatewayError('Upstream server error');
  * ```
  */
-declare class BadGatewayError extends HttpError {
+export declare class BadGatewayError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -251,7 +251,7 @@ declare class BadGatewayError extends HttpError {
  * throw new ServiceUnavailableError('Maintenance in progress', 300); // retry after 5 minutes
  * ```
  */
-declare class ServiceUnavailableError extends HttpError {
+export declare class ServiceUnavailableError extends HttpError {
   /**
    * @param message - Optional error message
    * @param retryAfter - Number of seconds the client should wait before retrying
@@ -269,61 +269,61 @@ declare class ServiceUnavailableError extends HttpError {
  * throw new GatewayTimeoutError('Upstream server timeout');
  * ```
  */
-declare class GatewayTimeoutError extends HttpError {
+export declare class GatewayTimeoutError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /** Type-safe error registry mapping status codes to their factory functions */
 declare const errorRegistry: {
   readonly 400: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => BadRequestError;
   };
   readonly 401: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => UnauthorizedError;
   };
   readonly 403: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => ForbiddenError;
   };
   readonly 404: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => NotFoundError;
   };
   readonly 405: {
-    readonly type: "methodNotAllowed";
+    readonly type: 'methodNotAllowed';
     readonly factory: (m: string, am: string[]) => MethodNotAllowedError;
   };
   readonly 409: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => ConflictError;
   };
   readonly 422: {
-    readonly type: "validation";
+    readonly type: 'validation';
     readonly factory: (m: string, ve: any) => UnprocessableEntityError;
   };
   readonly 429: {
-    readonly type: "retryAfter";
+    readonly type: 'retryAfter';
     readonly factory: (m: string, ra: number) => TooManyRequestsError;
   };
   readonly 500: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => InternalServerError;
   };
   readonly 501: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => NotImplementedError;
   };
   readonly 502: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => BadGatewayError;
   };
   readonly 503: {
-    readonly type: "retryAfter";
+    readonly type: 'retryAfter';
     readonly factory: (m: string, ra: number) => ServiceUnavailableError;
   };
   readonly 504: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => GatewayTimeoutError;
   };
 };
@@ -366,8 +366,8 @@ type ErrorOptions<T extends number> = T extends 405 ? {
  * createHttpError(429, 'Rate limited', { retryAfter: 60 });
  * ```
  */
-declare function createHttpError<T extends ValidStatusCode>(statusCode: T, message?: string, options?: ErrorOptions<T>): HttpError;
-declare function createHttpError(statusCode: number, message?: string, options?: HttpErrorOptions): HttpError;
+export declare function createHttpError<T extends ValidStatusCode>(statusCode: T, message?: string, options?: ErrorOptions<T>): HttpError;
+export declare function createHttpError(statusCode: number, message?: string, options?: HttpErrorOptions): HttpError;
 /**
  * Type-safe error creation utilities with descriptive method names.
  * Provides a fluent API for creating specific HTTP errors.
@@ -379,7 +379,7 @@ declare function createHttpError(statusCode: number, message?: string, options?:
  * createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);
  * ```
  */
-declare const createError: {
+export declare const createError: {
   readonly badRequest: (message?: string, details?: any) => BadRequestError;
   readonly unauthorized: (message?: string, details?: any) => UnauthorizedError;
   readonly forbidden: (message?: string, details?: any) => ForbiddenError;
@@ -412,7 +412,7 @@ declare const createError: {
  * }
  * ```
  */
-declare function isHttpError(error: unknown): error is HttpError;
+export declare function isHttpError(error: unknown): error is HttpError;
 /**
  * Type guard to check if an error is a client error (4xx status code).
  *
@@ -426,7 +426,7 @@ declare function isHttpError(error: unknown): error is HttpError;
  * }
  * ```
  */
-declare function isClientError(error: unknown): error is HttpError;
+export declare function isClientError(error: unknown): error is HttpError;
 /**
  * Type guard to check if an error is a server error (5xx status code).
  *
@@ -440,7 +440,7 @@ declare function isClientError(error: unknown): error is HttpError;
  * }
  * ```
  */
-declare function isServerError(error: unknown): error is HttpError;
+export declare function isServerError(error: unknown): error is HttpError;
 /**
  * Wraps an unknown error into an HttpError.
  * If the error is already an HttpError, returns it unchanged.
@@ -459,11 +459,11 @@ declare function isServerError(error: unknown): error is HttpError;
  * }
  * ```
  */
-declare function wrapError(error: unknown, statusCode?: number, message?: string): HttpError;
+export declare function wrapError(error: unknown, statusCode?: number, message?: string): HttpError;
 /**
  * Options for creating an HttpError.
  */
-interface HttpErrorOptions {
+export interface HttpErrorOptions {
   statusMessage?: string;
   details?: any;
   code?: string;
@@ -473,12 +473,12 @@ interface HttpErrorOptions {
  * Constructor type for HttpError classes.
  * Useful for factory patterns and dependency injection.
  */
-type HttpErrorConstructor = new (message?: string, options?: HttpErrorOptions) => HttpError;
+export type HttpErrorConstructor = new (message?: string, options?: HttpErrorOptions) => HttpError;
 /**
  * HTTP status code enum for type-safe status code usage.
  * Includes common 2xx, 3xx, 4xx, and 5xx status codes.
  */
-declare enum HttpStatusCode {
+export declare enum HttpStatusCode {
   OK = 200,
   CREATED = 201,
   ACCEPTED = 202,
@@ -501,7 +501,7 @@ declare enum HttpStatusCode {
   NOT_IMPLEMENTED = 501,
   BAD_GATEWAY = 502,
   SERVICE_UNAVAILABLE = 503,
-  GATEWAY_TIMEOUT = 504,
+  GATEWAY_TIMEOUT = 504
 }
 /**
  * Namespace containing all HTTP error classes.
@@ -513,7 +513,7 @@ declare enum HttpStatusCode {
  * throw new HttpErrors.NotFoundError('Resource not found');
  * ```
  */
-declare const HttpErrors: {
+export declare const HttpErrors: {
   HttpError: typeof HttpError;
   BadRequestError: typeof BadRequestError;
   UnauthorizedError: typeof UnauthorizedError;
@@ -530,5 +530,4 @@ declare const HttpErrors: {
   GatewayTimeoutError: typeof GatewayTimeoutError;
 };
 //#endregion
-export { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, GatewayTimeoutError, HttpError, HttpErrorConstructor, HttpErrorOptions, HttpErrors, HttpStatusCode, InternalServerError, MethodNotAllowedError, NotFoundError, NotImplementedError, ServiceUnavailableError, TooManyRequestsError, UnauthorizedError, UnprocessableEntityError, createError, createHttpError, isClientError, isHttpError, isServerError, wrapError };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -12,7 +12,7 @@
  * });
  * ```
  */
-declare class HttpError extends Error {
+export declare class HttpError extends Error {
   /** The HTTP status code (e.g., 400, 404, 500) */
   readonly statusCode: number;
   /** The standard HTTP status message (e.g., 'Bad Request', 'Not Found') */
@@ -82,7 +82,7 @@ declare class HttpError extends Error {
  * throw new BadRequestError('Invalid JSON', { line: 5, column: 12 });
  * ```
  */
-declare class BadRequestError extends HttpError {
+export declare class BadRequestError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -96,7 +96,7 @@ declare class BadRequestError extends HttpError {
  * throw new UnauthorizedError('Invalid token');
  * ```
  */
-declare class UnauthorizedError extends HttpError {
+export declare class UnauthorizedError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -110,7 +110,7 @@ declare class UnauthorizedError extends HttpError {
  * throw new ForbiddenError('Insufficient permissions', { required: 'admin' });
  * ```
  */
-declare class ForbiddenError extends HttpError {
+export declare class ForbiddenError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -124,7 +124,7 @@ declare class ForbiddenError extends HttpError {
  * throw new NotFoundError('User not found', { userId: '123' });
  * ```
  */
-declare class NotFoundError extends HttpError {
+export declare class NotFoundError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -138,7 +138,7 @@ declare class NotFoundError extends HttpError {
  * throw new MethodNotAllowedError('DELETE not supported', ['GET', 'POST', 'PUT']);
  * ```
  */
-declare class MethodNotAllowedError extends HttpError {
+export declare class MethodNotAllowedError extends HttpError {
   /**
    * @param message - Optional error message
    * @param allowedMethods - Array of allowed HTTP methods for this resource
@@ -156,7 +156,7 @@ declare class MethodNotAllowedError extends HttpError {
  * throw new ConflictError('Email already exists', { email: 'user@example.com' });
  * ```
  */
-declare class ConflictError extends HttpError {
+export declare class ConflictError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -173,7 +173,7 @@ declare class ConflictError extends HttpError {
  * });
  * ```
  */
-declare class UnprocessableEntityError extends HttpError {
+export declare class UnprocessableEntityError extends HttpError {
   /**
    * @param message - Optional error message
    * @param validationErrors - Object containing field-specific validation errors
@@ -191,7 +191,7 @@ declare class UnprocessableEntityError extends HttpError {
  * throw new TooManyRequestsError('Rate limit exceeded', 60); // retry after 60 seconds
  * ```
  */
-declare class TooManyRequestsError extends HttpError {
+export declare class TooManyRequestsError extends HttpError {
   /**
    * @param message - Optional error message
    * @param retryAfter - Number of seconds the client should wait before retrying
@@ -209,7 +209,7 @@ declare class TooManyRequestsError extends HttpError {
  * throw new InternalServerError('Database connection failed');
  * ```
  */
-declare class InternalServerError extends HttpError {
+export declare class InternalServerError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -223,7 +223,7 @@ declare class InternalServerError extends HttpError {
  * throw new NotImplementedError('WebSocket support not implemented');
  * ```
  */
-declare class NotImplementedError extends HttpError {
+export declare class NotImplementedError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -237,7 +237,7 @@ declare class NotImplementedError extends HttpError {
  * throw new BadGatewayError('Upstream server error');
  * ```
  */
-declare class BadGatewayError extends HttpError {
+export declare class BadGatewayError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /**
@@ -251,7 +251,7 @@ declare class BadGatewayError extends HttpError {
  * throw new ServiceUnavailableError('Maintenance in progress', 300); // retry after 5 minutes
  * ```
  */
-declare class ServiceUnavailableError extends HttpError {
+export declare class ServiceUnavailableError extends HttpError {
   /**
    * @param message - Optional error message
    * @param retryAfter - Number of seconds the client should wait before retrying
@@ -269,61 +269,61 @@ declare class ServiceUnavailableError extends HttpError {
  * throw new GatewayTimeoutError('Upstream server timeout');
  * ```
  */
-declare class GatewayTimeoutError extends HttpError {
+export declare class GatewayTimeoutError extends HttpError {
   constructor(message?: string, details?: any);
 }
 /** Type-safe error registry mapping status codes to their factory functions */
 declare const errorRegistry: {
   readonly 400: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => BadRequestError;
   };
   readonly 401: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => UnauthorizedError;
   };
   readonly 403: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => ForbiddenError;
   };
   readonly 404: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => NotFoundError;
   };
   readonly 405: {
-    readonly type: "methodNotAllowed";
+    readonly type: 'methodNotAllowed';
     readonly factory: (m: string, am: string[]) => MethodNotAllowedError;
   };
   readonly 409: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => ConflictError;
   };
   readonly 422: {
-    readonly type: "validation";
+    readonly type: 'validation';
     readonly factory: (m: string, ve: any) => UnprocessableEntityError;
   };
   readonly 429: {
-    readonly type: "retryAfter";
+    readonly type: 'retryAfter';
     readonly factory: (m: string, ra: number) => TooManyRequestsError;
   };
   readonly 500: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => InternalServerError;
   };
   readonly 501: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => NotImplementedError;
   };
   readonly 502: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => BadGatewayError;
   };
   readonly 503: {
-    readonly type: "retryAfter";
+    readonly type: 'retryAfter';
     readonly factory: (m: string, ra: number) => ServiceUnavailableError;
   };
   readonly 504: {
-    readonly type: "standard";
+    readonly type: 'standard';
     readonly factory: (m: string, d: any) => GatewayTimeoutError;
   };
 };
@@ -366,8 +366,8 @@ type ErrorOptions<T extends number> = T extends 405 ? {
  * createHttpError(429, 'Rate limited', { retryAfter: 60 });
  * ```
  */
-declare function createHttpError<T extends ValidStatusCode>(statusCode: T, message?: string, options?: ErrorOptions<T>): HttpError;
-declare function createHttpError(statusCode: number, message?: string, options?: HttpErrorOptions): HttpError;
+export declare function createHttpError<T extends ValidStatusCode>(statusCode: T, message?: string, options?: ErrorOptions<T>): HttpError;
+export declare function createHttpError(statusCode: number, message?: string, options?: HttpErrorOptions): HttpError;
 /**
  * Type-safe error creation utilities with descriptive method names.
  * Provides a fluent API for creating specific HTTP errors.
@@ -379,7 +379,7 @@ declare function createHttpError(statusCode: number, message?: string, options?:
  * createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);
  * ```
  */
-declare const createError: {
+export declare const createError: {
   readonly badRequest: (message?: string, details?: any) => BadRequestError;
   readonly unauthorized: (message?: string, details?: any) => UnauthorizedError;
   readonly forbidden: (message?: string, details?: any) => ForbiddenError;
@@ -412,7 +412,7 @@ declare const createError: {
  * }
  * ```
  */
-declare function isHttpError(error: unknown): error is HttpError;
+export declare function isHttpError(error: unknown): error is HttpError;
 /**
  * Type guard to check if an error is a client error (4xx status code).
  *
@@ -426,7 +426,7 @@ declare function isHttpError(error: unknown): error is HttpError;
  * }
  * ```
  */
-declare function isClientError(error: unknown): error is HttpError;
+export declare function isClientError(error: unknown): error is HttpError;
 /**
  * Type guard to check if an error is a server error (5xx status code).
  *
@@ -440,7 +440,7 @@ declare function isClientError(error: unknown): error is HttpError;
  * }
  * ```
  */
-declare function isServerError(error: unknown): error is HttpError;
+export declare function isServerError(error: unknown): error is HttpError;
 /**
  * Wraps an unknown error into an HttpError.
  * If the error is already an HttpError, returns it unchanged.
@@ -459,11 +459,11 @@ declare function isServerError(error: unknown): error is HttpError;
  * }
  * ```
  */
-declare function wrapError(error: unknown, statusCode?: number, message?: string): HttpError;
+export declare function wrapError(error: unknown, statusCode?: number, message?: string): HttpError;
 /**
  * Options for creating an HttpError.
  */
-interface HttpErrorOptions {
+export interface HttpErrorOptions {
   statusMessage?: string;
   details?: any;
   code?: string;
@@ -473,12 +473,12 @@ interface HttpErrorOptions {
  * Constructor type for HttpError classes.
  * Useful for factory patterns and dependency injection.
  */
-type HttpErrorConstructor = new (message?: string, options?: HttpErrorOptions) => HttpError;
+export type HttpErrorConstructor = new (message?: string, options?: HttpErrorOptions) => HttpError;
 /**
  * HTTP status code enum for type-safe status code usage.
  * Includes common 2xx, 3xx, 4xx, and 5xx status codes.
  */
-declare enum HttpStatusCode {
+export declare enum HttpStatusCode {
   OK = 200,
   CREATED = 201,
   ACCEPTED = 202,
@@ -501,7 +501,7 @@ declare enum HttpStatusCode {
   NOT_IMPLEMENTED = 501,
   BAD_GATEWAY = 502,
   SERVICE_UNAVAILABLE = 503,
-  GATEWAY_TIMEOUT = 504,
+  GATEWAY_TIMEOUT = 504
 }
 /**
  * Namespace containing all HTTP error classes.
@@ -513,7 +513,7 @@ declare enum HttpStatusCode {
  * throw new HttpErrors.NotFoundError('Resource not found');
  * ```
  */
-declare const HttpErrors: {
+export declare const HttpErrors: {
   HttpError: typeof HttpError;
   BadRequestError: typeof BadRequestError;
   UnauthorizedError: typeof UnauthorizedError;
@@ -530,5 +530,4 @@ declare const HttpErrors: {
   GatewayTimeoutError: typeof GatewayTimeoutError;
 };
 //#endregion
-export { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, GatewayTimeoutError, HttpError, HttpErrorConstructor, HttpErrorOptions, HttpErrors, HttpStatusCode, InternalServerError, MethodNotAllowedError, NotFoundError, NotImplementedError, ServiceUnavailableError, TooManyRequestsError, UnauthorizedError, UnprocessableEntityError, createError, createHttpError, isClientError, isHttpError, isServerError, wrapError };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -65,7 +65,7 @@ var HttpError = class extends Error {
 	* @private
 	*/
 	getDefaultStatusMessage(statusCode) {
-		const statusMessages = {
+		return {
 			400: "Bad Request",
 			401: "Unauthorized",
 			403: "Forbidden",
@@ -82,8 +82,7 @@ var HttpError = class extends Error {
 			502: "Bad Gateway",
 			503: "Service Unavailable",
 			504: "Gateway Timeout"
-		};
-		return statusMessages[statusCode] || "Unknown Error";
+		}[statusCode] || "Unknown Error";
 	}
 	/**
 	* Serializes the error to a JSON-compatible object.
@@ -506,31 +505,31 @@ function wrapError(error, statusCode = 500, message) {
 * HTTP status code enum for type-safe status code usage.
 * Includes common 2xx, 3xx, 4xx, and 5xx status codes.
 */
-let HttpStatusCode = /* @__PURE__ */ function(HttpStatusCode$1) {
-	HttpStatusCode$1[HttpStatusCode$1["OK"] = 200] = "OK";
-	HttpStatusCode$1[HttpStatusCode$1["CREATED"] = 201] = "CREATED";
-	HttpStatusCode$1[HttpStatusCode$1["ACCEPTED"] = 202] = "ACCEPTED";
-	HttpStatusCode$1[HttpStatusCode$1["NO_CONTENT"] = 204] = "NO_CONTENT";
-	HttpStatusCode$1[HttpStatusCode$1["MOVED_PERMANENTLY"] = 301] = "MOVED_PERMANENTLY";
-	HttpStatusCode$1[HttpStatusCode$1["FOUND"] = 302] = "FOUND";
-	HttpStatusCode$1[HttpStatusCode$1["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
-	HttpStatusCode$1[HttpStatusCode$1["BAD_REQUEST"] = 400] = "BAD_REQUEST";
-	HttpStatusCode$1[HttpStatusCode$1["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
-	HttpStatusCode$1[HttpStatusCode$1["FORBIDDEN"] = 403] = "FORBIDDEN";
-	HttpStatusCode$1[HttpStatusCode$1["NOT_FOUND"] = 404] = "NOT_FOUND";
-	HttpStatusCode$1[HttpStatusCode$1["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
-	HttpStatusCode$1[HttpStatusCode$1["NOT_ACCEPTABLE"] = 406] = "NOT_ACCEPTABLE";
-	HttpStatusCode$1[HttpStatusCode$1["REQUEST_TIMEOUT"] = 408] = "REQUEST_TIMEOUT";
-	HttpStatusCode$1[HttpStatusCode$1["CONFLICT"] = 409] = "CONFLICT";
-	HttpStatusCode$1[HttpStatusCode$1["GONE"] = 410] = "GONE";
-	HttpStatusCode$1[HttpStatusCode$1["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
-	HttpStatusCode$1[HttpStatusCode$1["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
-	HttpStatusCode$1[HttpStatusCode$1["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
-	HttpStatusCode$1[HttpStatusCode$1["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
-	HttpStatusCode$1[HttpStatusCode$1["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
-	HttpStatusCode$1[HttpStatusCode$1["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
-	HttpStatusCode$1[HttpStatusCode$1["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
-	return HttpStatusCode$1;
+let HttpStatusCode = /* @__PURE__ */ function(HttpStatusCode) {
+	HttpStatusCode[HttpStatusCode["OK"] = 200] = "OK";
+	HttpStatusCode[HttpStatusCode["CREATED"] = 201] = "CREATED";
+	HttpStatusCode[HttpStatusCode["ACCEPTED"] = 202] = "ACCEPTED";
+	HttpStatusCode[HttpStatusCode["NO_CONTENT"] = 204] = "NO_CONTENT";
+	HttpStatusCode[HttpStatusCode["MOVED_PERMANENTLY"] = 301] = "MOVED_PERMANENTLY";
+	HttpStatusCode[HttpStatusCode["FOUND"] = 302] = "FOUND";
+	HttpStatusCode[HttpStatusCode["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
+	HttpStatusCode[HttpStatusCode["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+	HttpStatusCode[HttpStatusCode["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+	HttpStatusCode[HttpStatusCode["FORBIDDEN"] = 403] = "FORBIDDEN";
+	HttpStatusCode[HttpStatusCode["NOT_FOUND"] = 404] = "NOT_FOUND";
+	HttpStatusCode[HttpStatusCode["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
+	HttpStatusCode[HttpStatusCode["NOT_ACCEPTABLE"] = 406] = "NOT_ACCEPTABLE";
+	HttpStatusCode[HttpStatusCode["REQUEST_TIMEOUT"] = 408] = "REQUEST_TIMEOUT";
+	HttpStatusCode[HttpStatusCode["CONFLICT"] = 409] = "CONFLICT";
+	HttpStatusCode[HttpStatusCode["GONE"] = 410] = "GONE";
+	HttpStatusCode[HttpStatusCode["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
+	HttpStatusCode[HttpStatusCode["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
+	HttpStatusCode[HttpStatusCode["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+	HttpStatusCode[HttpStatusCode["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
+	HttpStatusCode[HttpStatusCode["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
+	HttpStatusCode[HttpStatusCode["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+	HttpStatusCode[HttpStatusCode["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
+	return HttpStatusCode;
 }({});
 /**
 * Namespace containing all HTTP error classes.
@@ -558,7 +557,7 @@ const HttpErrors = {
 	ServiceUnavailableError,
 	GatewayTimeoutError
 };
-
 //#endregion
 export { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, GatewayTimeoutError, HttpError, HttpErrors, HttpStatusCode, InternalServerError, MethodNotAllowedError, NotFoundError, NotImplementedError, ServiceUnavailableError, TooManyRequestsError, UnauthorizedError, UnprocessableEntityError, createError, createHttpError, isClientError, isHttpError, isServerError, wrapError };
+
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["statusCode: number","message?: string","options?: {\n\t\t\tstatusMessage?: string;\n\t\t\tdetails?: any;\n\t\t\tcode?: string;\n\t\t\tcause?: Error;\n\t\t}","statusMessages: Record<number, string>","details?: any","allowedMethods?: string[]","validationErrors?: any","retryAfter?: number","m: string","d: any","am: string[]","ve: any","ra: number","factoryHandlers: Record<\n\tErrorFactory['type'],\n\t(entry: any, message?: string, options?: any) => HttpError\n>","options?: any","error: unknown"],"sources":["../src/index.ts"],"sourcesContent":["// http-errors.ts - Core HTTP Error Classes and Types\n\n/**\n * Base HTTP Error class that extends the native Error.\n * Provides a foundation for all HTTP-specific errors with status codes and structured error responses.\n *\n * @extends Error\n *\n * @example\n * ```typescript\n * throw new HttpError(400, 'Bad Request', {\n *   details: { field: 'email', message: 'Invalid format' }\n * });\n * ```\n */\nexport class HttpError extends Error {\n\t/** The HTTP status code (e.g., 400, 404, 500) */\n\tpublic readonly statusCode: number;\n\t/** The standard HTTP status message (e.g., 'Bad Request', 'Not Found') */\n\tpublic readonly statusMessage: string;\n\t/** Type discriminator for runtime type checking */\n\tpublic readonly isHttpError = true;\n\t/** Additional error details for debugging or client information */\n\tpublic readonly details?: any;\n\t/** Application-specific error code for client-side handling */\n\tpublic readonly code?: string;\n\n\t/**\n\t * Creates a new HttpError instance.\n\t *\n\t * @param statusCode - The HTTP status code\n\t * @param message - Optional error message for the client\n\t * @param options - Optional configuration object\n\t * @param options.statusMessage - Override the default status message\n\t * @param options.details - Additional error details or context\n\t * @param options.code - Application-specific error code\n\t * @param options.cause - The underlying error that caused this error (ES2022)\n\t */\n\tconstructor(\n\t\tstatusCode: number,\n\t\tmessage?: string,\n\t\toptions?: {\n\t\t\tstatusMessage?: string;\n\t\t\tdetails?: any;\n\t\t\tcode?: string;\n\t\t\tcause?: Error;\n\t\t},\n\t) {\n\t\tsuper(message || options?.statusMessage || 'HTTP Error');\n\t\tthis.name = this.constructor.name;\n\t\tthis.statusCode = statusCode;\n\t\tthis.statusMessage =\n\t\t\toptions?.statusMessage || this.getDefaultStatusMessage(statusCode);\n\t\tthis.details = options?.details;\n\t\tthis.code = options?.code;\n\n\t\t// Set cause if provided (ES2022 feature)\n\t\tif (options?.cause) {\n\t\t\tthis.cause = options.cause;\n\t\t}\n\t\t// Maintains proper stack trace for where our error was thrown\n\t\tError.captureStackTrace(this, this.constructor);\n\t}\n\n\t/**\n\t * Gets the error response body as a JSON string.\n\t * Used for sending the error response to clients.\n\t *\n\t * @returns JSON string containing message, code, and error details\n\t */\n\tget body() {\n\t\treturn JSON.stringify({\n\t\t\tmessage: this.message,\n\t\t\tcode: this.code,\n\t\t\terror: this.details,\n\t\t});\n\t}\n\n\t/**\n\t * Gets the default HTTP status message for a given status code.\n\t *\n\t * @param statusCode - The HTTP status code\n\t * @returns The standard HTTP status message or 'Unknown Error' if not found\n\t * @private\n\t */\n\tprivate getDefaultStatusMessage(statusCode: number): string {\n\t\tconst statusMessages: Record<number, string> = {\n\t\t\t400: 'Bad Request',\n\t\t\t401: 'Unauthorized',\n\t\t\t403: 'Forbidden',\n\t\t\t404: 'Not Found',\n\t\t\t405: 'Method Not Allowed',\n\t\t\t406: 'Not Acceptable',\n\t\t\t408: 'Request Timeout',\n\t\t\t409: 'Conflict',\n\t\t\t410: 'Gone',\n\t\t\t422: 'Unprocessable Entity',\n\t\t\t429: 'Too Many Requests',\n\t\t\t500: 'Internal Server Error',\n\t\t\t501: 'Not Implemented',\n\t\t\t502: 'Bad Gateway',\n\t\t\t503: 'Service Unavailable',\n\t\t\t504: 'Gateway Timeout',\n\t\t};\n\t\treturn statusMessages[statusCode] || 'Unknown Error';\n\t}\n\n\t/**\n\t * Serializes the error to a JSON-compatible object.\n\t * Useful for logging and debugging purposes.\n\t *\n\t * @returns Object representation of the error including stack trace\n\t */\n\ttoJSON() {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tmessage: this.message,\n\t\t\tstatusCode: this.statusCode,\n\t\t\tstatusMessage: this.statusMessage,\n\t\t\tcode: this.code,\n\t\t\tdetails: this.details,\n\t\t\tstack: this.stack,\n\t\t};\n\t}\n}\n\n// Client Error Classes (4xx)\n\n/**\n * Represents a 400 Bad Request error.\n * Used when the client sends a malformed or invalid request.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new BadRequestError('Invalid JSON', { line: 5, column: 12 });\n * ```\n */\nexport class BadRequestError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(400, message, { details });\n\t}\n}\n\n/**\n * Represents a 401 Unauthorized error.\n * Used when authentication is required but not provided or invalid.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new UnauthorizedError('Invalid token');\n * ```\n */\nexport class UnauthorizedError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(401, message, { details });\n\t}\n}\n\n/**\n * Represents a 403 Forbidden error.\n * Used when the client is authenticated but lacks permission for the resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ForbiddenError('Insufficient permissions', { required: 'admin' });\n * ```\n */\nexport class ForbiddenError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(403, message, { details });\n\t}\n}\n\n/**\n * Represents a 404 Not Found error.\n * Used when the requested resource doesn't exist.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new NotFoundError('User not found', { userId: '123' });\n * ```\n */\nexport class NotFoundError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(404, message, { details });\n\t}\n}\n\n/**\n * Represents a 405 Method Not Allowed error.\n * Used when the HTTP method is not supported for the requested resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new MethodNotAllowedError('DELETE not supported', ['GET', 'POST', 'PUT']);\n * ```\n */\nexport class MethodNotAllowedError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param allowedMethods - Array of allowed HTTP methods for this resource\n\t */\n\tconstructor(message?: string, allowedMethods?: string[]) {\n\t\tsuper(405, message, {\n\t\t\tdetails: allowedMethods ? { allowedMethods } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 409 Conflict error.\n * Used when the request conflicts with the current state of the resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ConflictError('Email already exists', { email: 'user@example.com' });\n * ```\n */\nexport class ConflictError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(409, message, { details });\n\t}\n}\n\n/**\n * Represents a 422 Unprocessable Entity error.\n * Used when the request is well-formed but contains semantic errors.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new UnprocessableEntityError('Validation failed', {\n *   email: 'Invalid format',\n *   age: 'Must be 18 or older'\n * });\n * ```\n */\nexport class UnprocessableEntityError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param validationErrors - Object containing field-specific validation errors\n\t */\n\tconstructor(message?: string, validationErrors?: any) {\n\t\tsuper(422, message, {\n\t\t\tdetails: validationErrors ? { validationErrors } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 429 Too Many Requests error.\n * Used when the client has exceeded rate limits.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new TooManyRequestsError('Rate limit exceeded', 60); // retry after 60 seconds\n * ```\n */\nexport class TooManyRequestsError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param retryAfter - Number of seconds the client should wait before retrying\n\t */\n\tconstructor(message?: string, retryAfter?: number) {\n\t\tsuper(429, message, {\n\t\t\tdetails: retryAfter ? { retryAfter } : undefined,\n\t\t});\n\t}\n}\n\n// Server Error Classes (5xx)\n\n/**\n * Represents a 500 Internal Server Error.\n * Used for unexpected server-side errors.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new InternalServerError('Database connection failed');\n * ```\n */\nexport class InternalServerError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(500, message, { details });\n\t}\n}\n\n/**\n * Represents a 501 Not Implemented error.\n * Used when the server doesn't support the requested functionality.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new NotImplementedError('WebSocket support not implemented');\n * ```\n */\nexport class NotImplementedError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(501, message, { details });\n\t}\n}\n\n/**\n * Represents a 502 Bad Gateway error.\n * Used when the server receives an invalid response from an upstream server.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new BadGatewayError('Upstream server error');\n * ```\n */\nexport class BadGatewayError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(502, message, { details });\n\t}\n}\n\n/**\n * Represents a 503 Service Unavailable error.\n * Used when the server is temporarily unable to handle requests.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ServiceUnavailableError('Maintenance in progress', 300); // retry after 5 minutes\n * ```\n */\nexport class ServiceUnavailableError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param retryAfter - Number of seconds the client should wait before retrying\n\t */\n\tconstructor(message?: string, retryAfter?: number) {\n\t\tsuper(503, message, {\n\t\t\tdetails: retryAfter ? { retryAfter } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 504 Gateway Timeout error.\n * Used when the server doesn't receive a timely response from an upstream server.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new GatewayTimeoutError('Upstream server timeout');\n * ```\n */\nexport class GatewayTimeoutError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(504, message, { details });\n\t}\n}\n\n// Type definitions for different error factory signatures\n\n/** Factory function for standard HTTP errors with optional details */\ntype StandardErrorFactory = (message?: string, details?: any) => HttpError;\n/** Factory function for Method Not Allowed errors with allowed methods */\ntype MethodNotAllowedFactory = (\n\tmessage?: string,\n\tallowedMethods?: string[],\n) => MethodNotAllowedError;\n/** Factory function for errors that include retry-after information */\ntype RetryAfterFactory = (message?: string, retryAfter?: number) => HttpError;\n/** Factory function for validation errors with field-specific errors */\ntype ValidationErrorFactory = (\n\tmessage?: string,\n\tvalidationErrors?: any,\n) => UnprocessableEntityError;\n\n/** Discriminated union for all factory types */\ntype ErrorFactory =\n\t| { type: 'standard'; factory: StandardErrorFactory }\n\t| { type: 'methodNotAllowed'; factory: MethodNotAllowedFactory }\n\t| { type: 'retryAfter'; factory: RetryAfterFactory }\n\t| { type: 'validation'; factory: ValidationErrorFactory };\n\n/** Type-safe error registry mapping status codes to their factory functions */\nconst errorRegistry = {\n\t400: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new BadRequestError(m, d),\n\t},\n\t401: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new UnauthorizedError(m, d),\n\t},\n\t403: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new ForbiddenError(m, d),\n\t},\n\t404: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new NotFoundError(m, d),\n\t},\n\t405: {\n\t\ttype: 'methodNotAllowed',\n\t\tfactory: (m: string, am: string[]) => new MethodNotAllowedError(m, am),\n\t},\n\t409: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new ConflictError(m, d),\n\t},\n\t422: {\n\t\ttype: 'validation',\n\t\tfactory: (m: string, ve: any) => new UnprocessableEntityError(m, ve),\n\t},\n\t429: {\n\t\ttype: 'retryAfter',\n\t\tfactory: (m: string, ra: number) => new TooManyRequestsError(m, ra),\n\t},\n\t500: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new InternalServerError(m, d),\n\t},\n\t501: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new NotImplementedError(m, d),\n\t},\n\t502: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new BadGatewayError(m, d),\n\t},\n\t503: {\n\t\ttype: 'retryAfter',\n\t\tfactory: (m: string, ra: number) => new ServiceUnavailableError(m, ra),\n\t},\n\t504: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new GatewayTimeoutError(m, d),\n\t},\n} as const;\n\n/** Valid status codes that have registered error factories */\ntype ValidStatusCode = keyof typeof errorRegistry;\n\n/** Type-safe options based on status code, ensuring correct parameters for each error type */\ntype ErrorOptions<T extends number> = T extends 405\n\t? { allowedMethods?: string[]; code?: string; cause?: Error }\n\t: T extends 422\n\t\t? { validationErrors?: any; code?: string; cause?: Error }\n\t\t: T extends 429 | 503\n\t\t\t? { retryAfter?: number; code?: string; cause?: Error }\n\t\t\t: { details?: any; code?: string; cause?: Error };\n\n/** Handler functions for each factory type */\nconst factoryHandlers: Record<\n\tErrorFactory['type'],\n\t(entry: any, message?: string, options?: any) => HttpError\n> = {\n\tstandard: (entry, message, options) =>\n\t\tentry.factory(message, options?.details),\n\tmethodNotAllowed: (entry, message, options) =>\n\t\tentry.factory(message, options?.allowedMethods),\n\tretryAfter: (entry, message, options) =>\n\t\tentry.factory(message, options?.retryAfter),\n\tvalidation: (entry, message, options) =>\n\t\tentry.factory(message, options?.validationErrors),\n};\n\n/**\n * Creates an HTTP error with type-safe options based on the status code.\n * Provides IntelliSense support for status-code-specific options.\n *\n * @overload For known status codes with specific options\n * @param statusCode - A valid HTTP status code from the registry\n * @param message - Optional error message\n * @param options - Status-code-specific options\n * @returns The appropriate HttpError subclass\n *\n * @example\n * ```typescript\n * // TypeScript knows allowedMethods is valid for 405\n * createHttpError(405, 'Method not allowed', { allowedMethods: ['GET', 'POST'] });\n *\n * // TypeScript knows retryAfter is valid for 429\n * createHttpError(429, 'Rate limited', { retryAfter: 60 });\n * ```\n */\nexport function createHttpError<T extends ValidStatusCode>(\n\tstatusCode: T,\n\tmessage?: string,\n\toptions?: ErrorOptions<T>,\n): HttpError;\nexport function createHttpError(\n\tstatusCode: number,\n\tmessage?: string,\n\toptions?: HttpErrorOptions,\n): HttpError;\nexport function createHttpError(\n\tstatusCode: number,\n\tmessage?: string,\n\toptions?: any,\n): HttpError {\n\tconst entry = errorRegistry[statusCode as ValidStatusCode];\n\n\tif (entry) {\n\t\tconst handler = factoryHandlers[entry.type];\n\t\treturn handler(entry, message, options);\n\t}\n\n\t// Fallback to generic HttpError for unknown status codes\n\treturn new HttpError(statusCode, message, options);\n}\n\n/**\n * Type-safe error creation utilities with descriptive method names.\n * Provides a fluent API for creating specific HTTP errors.\n *\n * @example\n * ```typescript\n * createError.notFound('User not found');\n * createError.badRequest('Invalid input', { field: 'email' });\n * createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);\n * ```\n */\nexport const createError = {\n\tbadRequest: (message?: string, details?: any) =>\n\t\tnew BadRequestError(message, details),\n\n\tunauthorized: (message?: string, details?: any) =>\n\t\tnew UnauthorizedError(message, details),\n\n\tforbidden: (message?: string, details?: any) =>\n\t\tnew ForbiddenError(message, details),\n\n\tnotFound: (message?: string, details?: any) =>\n\t\tnew NotFoundError(message, details),\n\n\tmethodNotAllowed: (message?: string, allowedMethods?: string[]) =>\n\t\tnew MethodNotAllowedError(message, allowedMethods),\n\n\tconflict: (message?: string, details?: any) =>\n\t\tnew ConflictError(message, details),\n\n\tunprocessableEntity: (message?: string, validationErrors?: any) =>\n\t\tnew UnprocessableEntityError(message, validationErrors),\n\n\ttooManyRequests: (message?: string, retryAfter?: number) =>\n\t\tnew TooManyRequestsError(message, retryAfter),\n\n\tinternalServerError: (message?: string, details?: any) =>\n\t\tnew InternalServerError(message, details),\n\n\tnotImplemented: (message?: string, details?: any) =>\n\t\tnew NotImplementedError(message, details),\n\n\tbadGateway: (message?: string, details?: any) =>\n\t\tnew BadGatewayError(message, details),\n\n\tserviceUnavailable: (message?: string, retryAfter?: number) =>\n\t\tnew ServiceUnavailableError(message, retryAfter),\n\n\tgatewayTimeout: (message?: string, details?: any) =>\n\t\tnew GatewayTimeoutError(message, details),\n} as const;\n\n// Type guards\n\n/**\n * Type guard to check if an error is an HttpError.\n * Works with both instanceof checks and duck typing.\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError\n *\n * @example\n * ```typescript\n * try {\n *   // some code\n * } catch (error) {\n *   if (isHttpError(error)) {\n *     console.log(`HTTP ${error.statusCode}: ${error.message}`);\n *   }\n * }\n * ```\n */\nexport function isHttpError(error: unknown): error is HttpError {\n\treturn (\n\t\terror instanceof HttpError ||\n\t\t(error !== null &&\n\t\t\ttypeof error === 'object' &&\n\t\t\t'isHttpError' in error &&\n\t\t\terror.isHttpError === true)\n\t);\n}\n\n/**\n * Type guard to check if an error is a client error (4xx status code).\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError with a 4xx status code\n *\n * @example\n * ```typescript\n * if (isClientError(error)) {\n *   // Log client error metrics\n * }\n * ```\n */\nexport function isClientError(error: unknown): error is HttpError {\n\treturn (\n\t\tisHttpError(error) && error.statusCode >= 400 && error.statusCode < 500\n\t);\n}\n\n/**\n * Type guard to check if an error is a server error (5xx status code).\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError with a 5xx status code\n *\n * @example\n * ```typescript\n * if (isServerError(error)) {\n *   // Trigger alerts for server errors\n * }\n * ```\n */\nexport function isServerError(error: unknown): error is HttpError {\n\treturn (\n\t\tisHttpError(error) && error.statusCode >= 500 && error.statusCode < 600\n\t);\n}\n\n// Utility functions\n\n/**\n * Wraps an unknown error into an HttpError.\n * If the error is already an HttpError, returns it unchanged.\n *\n * @param error - The error to wrap\n * @param statusCode - The HTTP status code to use (defaults to 500)\n * @param message - Optional message to override the original error message\n * @returns An HttpError instance\n *\n * @example\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   throw wrapError(error, 503, 'Service temporarily unavailable');\n * }\n * ```\n */\nexport function wrapError(\n\terror: unknown,\n\tstatusCode = 500,\n\tmessage?: string,\n): HttpError {\n\tif (isHttpError(error)) {\n\t\treturn error;\n\t}\n\n\tif (error instanceof HttpError) {\n\t\treturn error;\n\t}\n\n\treturn new HttpError(statusCode, message || 'An unknown error occurred', {\n\t\tdetails: { originalError: error },\n\t});\n}\n\n// Types for better TypeScript support\n\n/**\n * Options for creating an HttpError.\n */\nexport interface HttpErrorOptions {\n\tstatusMessage?: string;\n\tdetails?: any;\n\tcode?: string;\n\tcause?: Error;\n}\n\n/**\n * Constructor type for HttpError classes.\n * Useful for factory patterns and dependency injection.\n */\nexport type HttpErrorConstructor = new (\n\tmessage?: string,\n\toptions?: HttpErrorOptions,\n) => HttpError;\n\n/**\n * HTTP status code enum for type-safe status code usage.\n * Includes common 2xx, 3xx, 4xx, and 5xx status codes.\n */\nexport enum HttpStatusCode {\n\t// 2xx Success\n\tOK = 200,\n\tCREATED = 201,\n\tACCEPTED = 202,\n\tNO_CONTENT = 204,\n\n\t// 3xx Redirection\n\tMOVED_PERMANENTLY = 301,\n\tFOUND = 302,\n\tNOT_MODIFIED = 304,\n\n\t// 4xx Client Error\n\tBAD_REQUEST = 400,\n\tUNAUTHORIZED = 401,\n\tFORBIDDEN = 403,\n\tNOT_FOUND = 404,\n\tMETHOD_NOT_ALLOWED = 405,\n\tNOT_ACCEPTABLE = 406,\n\tREQUEST_TIMEOUT = 408,\n\tCONFLICT = 409,\n\tGONE = 410,\n\tUNPROCESSABLE_ENTITY = 422,\n\tTOO_MANY_REQUESTS = 429,\n\n\t// 5xx Server Error\n\tINTERNAL_SERVER_ERROR = 500,\n\tNOT_IMPLEMENTED = 501,\n\tBAD_GATEWAY = 502,\n\tSERVICE_UNAVAILABLE = 503,\n\tGATEWAY_TIMEOUT = 504,\n}\n\n/**\n * Namespace containing all HTTP error classes.\n * Useful for importing all error types at once.\n *\n * @example\n * ```typescript\n * import { HttpErrors } from '@geekmidas/errors';\n * throw new HttpErrors.NotFoundError('Resource not found');\n * ```\n */\nexport const HttpErrors = {\n\tHttpError,\n\tBadRequestError,\n\tUnauthorizedError,\n\tForbiddenError,\n\tNotFoundError,\n\tMethodNotAllowedError,\n\tConflictError,\n\tUnprocessableEntityError,\n\tTooManyRequestsError,\n\tInternalServerError,\n\tNotImplementedError,\n\tBadGatewayError,\n\tServiceUnavailableError,\n\tGatewayTimeoutError,\n};\n\n// Usage examples:\n/*\n// Basic usage\nthrow new NotFoundError('User not found');\nthrow new BadRequestError('Invalid email format', { field: 'email' });\n\n// With validation errors\nthrow new UnprocessableEntityError('Validation failed', {\n  email: 'Invalid email format',\n  password: 'Password must be at least 8 characters',\n});\n\n// Type-safe factory function with IntelliSense support\nthrow createHttpError(405, 'Method not allowed', { \n  allowedMethods: ['GET', 'POST'] // TypeScript knows this is the correct option!\n});\n\nthrow createHttpError(429, 'Too many requests', { \n  retryAfter: 60 // TypeScript knows this needs retryAfter, not details!\n});\n\nthrow createHttpError(422, 'Validation failed', {\n  validationErrors: { // TypeScript knows this is for validation errors\n    email: 'Invalid format',\n    age: 'Must be 18+'\n  }\n});\n\n// Using the type-safe createError object\nthrow createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);\nthrow createError.tooManyRequests('Rate limit exceeded', 60);\nthrow createError.unprocessableEntity('Invalid input', {\n  field: 'email',\n  message: 'Invalid format'\n});\n\n// TypeScript will show errors for incorrect usage:\n// throw createHttpError(404, 'Not found', { retryAfter: 60 }); // ❌ Type error!\n// throw createError.notFound('User not found', 60); // ❌ Type error!\n\n// Wrapping unknown errors\ntry {\n  await someAsyncOperation();\n} catch (error) {\n  throw wrapError(error, 500, 'Failed to process request');\n}\n\n// In Express middleware\napp.use(expressErrorHandler);\n\n// Type checking\nif (isClientError(error)) {\n  console.log('Client made a bad request');\n}\n*/\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["// http-errors.ts - Core HTTP Error Classes and Types\n\n/**\n * Base HTTP Error class that extends the native Error.\n * Provides a foundation for all HTTP-specific errors with status codes and structured error responses.\n *\n * @extends Error\n *\n * @example\n * ```typescript\n * throw new HttpError(400, 'Bad Request', {\n *   details: { field: 'email', message: 'Invalid format' }\n * });\n * ```\n */\nexport class HttpError extends Error {\n\t/** The HTTP status code (e.g., 400, 404, 500) */\n\tpublic readonly statusCode: number;\n\t/** The standard HTTP status message (e.g., 'Bad Request', 'Not Found') */\n\tpublic readonly statusMessage: string;\n\t/** Type discriminator for runtime type checking */\n\tpublic readonly isHttpError = true;\n\t/** Additional error details for debugging or client information */\n\tpublic readonly details?: any;\n\t/** Application-specific error code for client-side handling */\n\tpublic readonly code?: string;\n\n\t/**\n\t * Creates a new HttpError instance.\n\t *\n\t * @param statusCode - The HTTP status code\n\t * @param message - Optional error message for the client\n\t * @param options - Optional configuration object\n\t * @param options.statusMessage - Override the default status message\n\t * @param options.details - Additional error details or context\n\t * @param options.code - Application-specific error code\n\t * @param options.cause - The underlying error that caused this error (ES2022)\n\t */\n\tconstructor(\n\t\tstatusCode: number,\n\t\tmessage?: string,\n\t\toptions?: {\n\t\t\tstatusMessage?: string;\n\t\t\tdetails?: any;\n\t\t\tcode?: string;\n\t\t\tcause?: Error;\n\t\t},\n\t) {\n\t\tsuper(message || options?.statusMessage || 'HTTP Error');\n\t\tthis.name = this.constructor.name;\n\t\tthis.statusCode = statusCode;\n\t\tthis.statusMessage =\n\t\t\toptions?.statusMessage || this.getDefaultStatusMessage(statusCode);\n\t\tthis.details = options?.details;\n\t\tthis.code = options?.code;\n\n\t\t// Set cause if provided (ES2022 feature)\n\t\tif (options?.cause) {\n\t\t\tthis.cause = options.cause;\n\t\t}\n\t\t// Maintains proper stack trace for where our error was thrown\n\t\tError.captureStackTrace(this, this.constructor);\n\t}\n\n\t/**\n\t * Gets the error response body as a JSON string.\n\t * Used for sending the error response to clients.\n\t *\n\t * @returns JSON string containing message, code, and error details\n\t */\n\tget body() {\n\t\treturn JSON.stringify({\n\t\t\tmessage: this.message,\n\t\t\tcode: this.code,\n\t\t\terror: this.details,\n\t\t});\n\t}\n\n\t/**\n\t * Gets the default HTTP status message for a given status code.\n\t *\n\t * @param statusCode - The HTTP status code\n\t * @returns The standard HTTP status message or 'Unknown Error' if not found\n\t * @private\n\t */\n\tprivate getDefaultStatusMessage(statusCode: number): string {\n\t\tconst statusMessages: Record<number, string> = {\n\t\t\t400: 'Bad Request',\n\t\t\t401: 'Unauthorized',\n\t\t\t403: 'Forbidden',\n\t\t\t404: 'Not Found',\n\t\t\t405: 'Method Not Allowed',\n\t\t\t406: 'Not Acceptable',\n\t\t\t408: 'Request Timeout',\n\t\t\t409: 'Conflict',\n\t\t\t410: 'Gone',\n\t\t\t422: 'Unprocessable Entity',\n\t\t\t429: 'Too Many Requests',\n\t\t\t500: 'Internal Server Error',\n\t\t\t501: 'Not Implemented',\n\t\t\t502: 'Bad Gateway',\n\t\t\t503: 'Service Unavailable',\n\t\t\t504: 'Gateway Timeout',\n\t\t};\n\t\treturn statusMessages[statusCode] || 'Unknown Error';\n\t}\n\n\t/**\n\t * Serializes the error to a JSON-compatible object.\n\t * Useful for logging and debugging purposes.\n\t *\n\t * @returns Object representation of the error including stack trace\n\t */\n\ttoJSON() {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tmessage: this.message,\n\t\t\tstatusCode: this.statusCode,\n\t\t\tstatusMessage: this.statusMessage,\n\t\t\tcode: this.code,\n\t\t\tdetails: this.details,\n\t\t\tstack: this.stack,\n\t\t};\n\t}\n}\n\n// Client Error Classes (4xx)\n\n/**\n * Represents a 400 Bad Request error.\n * Used when the client sends a malformed or invalid request.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new BadRequestError('Invalid JSON', { line: 5, column: 12 });\n * ```\n */\nexport class BadRequestError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(400, message, { details });\n\t}\n}\n\n/**\n * Represents a 401 Unauthorized error.\n * Used when authentication is required but not provided or invalid.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new UnauthorizedError('Invalid token');\n * ```\n */\nexport class UnauthorizedError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(401, message, { details });\n\t}\n}\n\n/**\n * Represents a 403 Forbidden error.\n * Used when the client is authenticated but lacks permission for the resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ForbiddenError('Insufficient permissions', { required: 'admin' });\n * ```\n */\nexport class ForbiddenError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(403, message, { details });\n\t}\n}\n\n/**\n * Represents a 404 Not Found error.\n * Used when the requested resource doesn't exist.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new NotFoundError('User not found', { userId: '123' });\n * ```\n */\nexport class NotFoundError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(404, message, { details });\n\t}\n}\n\n/**\n * Represents a 405 Method Not Allowed error.\n * Used when the HTTP method is not supported for the requested resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new MethodNotAllowedError('DELETE not supported', ['GET', 'POST', 'PUT']);\n * ```\n */\nexport class MethodNotAllowedError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param allowedMethods - Array of allowed HTTP methods for this resource\n\t */\n\tconstructor(message?: string, allowedMethods?: string[]) {\n\t\tsuper(405, message, {\n\t\t\tdetails: allowedMethods ? { allowedMethods } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 409 Conflict error.\n * Used when the request conflicts with the current state of the resource.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ConflictError('Email already exists', { email: 'user@example.com' });\n * ```\n */\nexport class ConflictError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(409, message, { details });\n\t}\n}\n\n/**\n * Represents a 422 Unprocessable Entity error.\n * Used when the request is well-formed but contains semantic errors.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new UnprocessableEntityError('Validation failed', {\n *   email: 'Invalid format',\n *   age: 'Must be 18 or older'\n * });\n * ```\n */\nexport class UnprocessableEntityError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param validationErrors - Object containing field-specific validation errors\n\t */\n\tconstructor(message?: string, validationErrors?: any) {\n\t\tsuper(422, message, {\n\t\t\tdetails: validationErrors ? { validationErrors } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 429 Too Many Requests error.\n * Used when the client has exceeded rate limits.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new TooManyRequestsError('Rate limit exceeded', 60); // retry after 60 seconds\n * ```\n */\nexport class TooManyRequestsError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param retryAfter - Number of seconds the client should wait before retrying\n\t */\n\tconstructor(message?: string, retryAfter?: number) {\n\t\tsuper(429, message, {\n\t\t\tdetails: retryAfter ? { retryAfter } : undefined,\n\t\t});\n\t}\n}\n\n// Server Error Classes (5xx)\n\n/**\n * Represents a 500 Internal Server Error.\n * Used for unexpected server-side errors.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new InternalServerError('Database connection failed');\n * ```\n */\nexport class InternalServerError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(500, message, { details });\n\t}\n}\n\n/**\n * Represents a 501 Not Implemented error.\n * Used when the server doesn't support the requested functionality.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new NotImplementedError('WebSocket support not implemented');\n * ```\n */\nexport class NotImplementedError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(501, message, { details });\n\t}\n}\n\n/**\n * Represents a 502 Bad Gateway error.\n * Used when the server receives an invalid response from an upstream server.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new BadGatewayError('Upstream server error');\n * ```\n */\nexport class BadGatewayError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(502, message, { details });\n\t}\n}\n\n/**\n * Represents a 503 Service Unavailable error.\n * Used when the server is temporarily unable to handle requests.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new ServiceUnavailableError('Maintenance in progress', 300); // retry after 5 minutes\n * ```\n */\nexport class ServiceUnavailableError extends HttpError {\n\t/**\n\t * @param message - Optional error message\n\t * @param retryAfter - Number of seconds the client should wait before retrying\n\t */\n\tconstructor(message?: string, retryAfter?: number) {\n\t\tsuper(503, message, {\n\t\t\tdetails: retryAfter ? { retryAfter } : undefined,\n\t\t});\n\t}\n}\n\n/**\n * Represents a 504 Gateway Timeout error.\n * Used when the server doesn't receive a timely response from an upstream server.\n *\n * @extends HttpError\n *\n * @example\n * ```typescript\n * throw new GatewayTimeoutError('Upstream server timeout');\n * ```\n */\nexport class GatewayTimeoutError extends HttpError {\n\tconstructor(message?: string, details?: any) {\n\t\tsuper(504, message, { details });\n\t}\n}\n\n// Type definitions for different error factory signatures\n\n/** Factory function for standard HTTP errors with optional details */\ntype StandardErrorFactory = (message?: string, details?: any) => HttpError;\n/** Factory function for Method Not Allowed errors with allowed methods */\ntype MethodNotAllowedFactory = (\n\tmessage?: string,\n\tallowedMethods?: string[],\n) => MethodNotAllowedError;\n/** Factory function for errors that include retry-after information */\ntype RetryAfterFactory = (message?: string, retryAfter?: number) => HttpError;\n/** Factory function for validation errors with field-specific errors */\ntype ValidationErrorFactory = (\n\tmessage?: string,\n\tvalidationErrors?: any,\n) => UnprocessableEntityError;\n\n/** Discriminated union for all factory types */\ntype ErrorFactory =\n\t| { type: 'standard'; factory: StandardErrorFactory }\n\t| { type: 'methodNotAllowed'; factory: MethodNotAllowedFactory }\n\t| { type: 'retryAfter'; factory: RetryAfterFactory }\n\t| { type: 'validation'; factory: ValidationErrorFactory };\n\n/** Type-safe error registry mapping status codes to their factory functions */\nconst errorRegistry = {\n\t400: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new BadRequestError(m, d),\n\t},\n\t401: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new UnauthorizedError(m, d),\n\t},\n\t403: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new ForbiddenError(m, d),\n\t},\n\t404: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new NotFoundError(m, d),\n\t},\n\t405: {\n\t\ttype: 'methodNotAllowed',\n\t\tfactory: (m: string, am: string[]) => new MethodNotAllowedError(m, am),\n\t},\n\t409: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new ConflictError(m, d),\n\t},\n\t422: {\n\t\ttype: 'validation',\n\t\tfactory: (m: string, ve: any) => new UnprocessableEntityError(m, ve),\n\t},\n\t429: {\n\t\ttype: 'retryAfter',\n\t\tfactory: (m: string, ra: number) => new TooManyRequestsError(m, ra),\n\t},\n\t500: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new InternalServerError(m, d),\n\t},\n\t501: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new NotImplementedError(m, d),\n\t},\n\t502: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new BadGatewayError(m, d),\n\t},\n\t503: {\n\t\ttype: 'retryAfter',\n\t\tfactory: (m: string, ra: number) => new ServiceUnavailableError(m, ra),\n\t},\n\t504: {\n\t\ttype: 'standard',\n\t\tfactory: (m: string, d: any) => new GatewayTimeoutError(m, d),\n\t},\n} as const;\n\n/** Valid status codes that have registered error factories */\ntype ValidStatusCode = keyof typeof errorRegistry;\n\n/** Type-safe options based on status code, ensuring correct parameters for each error type */\ntype ErrorOptions<T extends number> = T extends 405\n\t? { allowedMethods?: string[]; code?: string; cause?: Error }\n\t: T extends 422\n\t\t? { validationErrors?: any; code?: string; cause?: Error }\n\t\t: T extends 429 | 503\n\t\t\t? { retryAfter?: number; code?: string; cause?: Error }\n\t\t\t: { details?: any; code?: string; cause?: Error };\n\n/** Handler functions for each factory type */\nconst factoryHandlers: Record<\n\tErrorFactory['type'],\n\t(entry: any, message?: string, options?: any) => HttpError\n> = {\n\tstandard: (entry, message, options) =>\n\t\tentry.factory(message, options?.details),\n\tmethodNotAllowed: (entry, message, options) =>\n\t\tentry.factory(message, options?.allowedMethods),\n\tretryAfter: (entry, message, options) =>\n\t\tentry.factory(message, options?.retryAfter),\n\tvalidation: (entry, message, options) =>\n\t\tentry.factory(message, options?.validationErrors),\n};\n\n/**\n * Creates an HTTP error with type-safe options based on the status code.\n * Provides IntelliSense support for status-code-specific options.\n *\n * @overload For known status codes with specific options\n * @param statusCode - A valid HTTP status code from the registry\n * @param message - Optional error message\n * @param options - Status-code-specific options\n * @returns The appropriate HttpError subclass\n *\n * @example\n * ```typescript\n * // TypeScript knows allowedMethods is valid for 405\n * createHttpError(405, 'Method not allowed', { allowedMethods: ['GET', 'POST'] });\n *\n * // TypeScript knows retryAfter is valid for 429\n * createHttpError(429, 'Rate limited', { retryAfter: 60 });\n * ```\n */\nexport function createHttpError<T extends ValidStatusCode>(\n\tstatusCode: T,\n\tmessage?: string,\n\toptions?: ErrorOptions<T>,\n): HttpError;\nexport function createHttpError(\n\tstatusCode: number,\n\tmessage?: string,\n\toptions?: HttpErrorOptions,\n): HttpError;\nexport function createHttpError(\n\tstatusCode: number,\n\tmessage?: string,\n\toptions?: any,\n): HttpError {\n\tconst entry = errorRegistry[statusCode as ValidStatusCode];\n\n\tif (entry) {\n\t\tconst handler = factoryHandlers[entry.type];\n\t\treturn handler(entry, message, options);\n\t}\n\n\t// Fallback to generic HttpError for unknown status codes\n\treturn new HttpError(statusCode, message, options);\n}\n\n/**\n * Type-safe error creation utilities with descriptive method names.\n * Provides a fluent API for creating specific HTTP errors.\n *\n * @example\n * ```typescript\n * createError.notFound('User not found');\n * createError.badRequest('Invalid input', { field: 'email' });\n * createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);\n * ```\n */\nexport const createError = {\n\tbadRequest: (message?: string, details?: any) =>\n\t\tnew BadRequestError(message, details),\n\n\tunauthorized: (message?: string, details?: any) =>\n\t\tnew UnauthorizedError(message, details),\n\n\tforbidden: (message?: string, details?: any) =>\n\t\tnew ForbiddenError(message, details),\n\n\tnotFound: (message?: string, details?: any) =>\n\t\tnew NotFoundError(message, details),\n\n\tmethodNotAllowed: (message?: string, allowedMethods?: string[]) =>\n\t\tnew MethodNotAllowedError(message, allowedMethods),\n\n\tconflict: (message?: string, details?: any) =>\n\t\tnew ConflictError(message, details),\n\n\tunprocessableEntity: (message?: string, validationErrors?: any) =>\n\t\tnew UnprocessableEntityError(message, validationErrors),\n\n\ttooManyRequests: (message?: string, retryAfter?: number) =>\n\t\tnew TooManyRequestsError(message, retryAfter),\n\n\tinternalServerError: (message?: string, details?: any) =>\n\t\tnew InternalServerError(message, details),\n\n\tnotImplemented: (message?: string, details?: any) =>\n\t\tnew NotImplementedError(message, details),\n\n\tbadGateway: (message?: string, details?: any) =>\n\t\tnew BadGatewayError(message, details),\n\n\tserviceUnavailable: (message?: string, retryAfter?: number) =>\n\t\tnew ServiceUnavailableError(message, retryAfter),\n\n\tgatewayTimeout: (message?: string, details?: any) =>\n\t\tnew GatewayTimeoutError(message, details),\n} as const;\n\n// Type guards\n\n/**\n * Type guard to check if an error is an HttpError.\n * Works with both instanceof checks and duck typing.\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError\n *\n * @example\n * ```typescript\n * try {\n *   // some code\n * } catch (error) {\n *   if (isHttpError(error)) {\n *     console.log(`HTTP ${error.statusCode}: ${error.message}`);\n *   }\n * }\n * ```\n */\nexport function isHttpError(error: unknown): error is HttpError {\n\treturn (\n\t\terror instanceof HttpError ||\n\t\t(error !== null &&\n\t\t\ttypeof error === 'object' &&\n\t\t\t'isHttpError' in error &&\n\t\t\terror.isHttpError === true)\n\t);\n}\n\n/**\n * Type guard to check if an error is a client error (4xx status code).\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError with a 4xx status code\n *\n * @example\n * ```typescript\n * if (isClientError(error)) {\n *   // Log client error metrics\n * }\n * ```\n */\nexport function isClientError(error: unknown): error is HttpError {\n\treturn (\n\t\tisHttpError(error) && error.statusCode >= 400 && error.statusCode < 500\n\t);\n}\n\n/**\n * Type guard to check if an error is a server error (5xx status code).\n *\n * @param error - The error to check\n * @returns True if the error is an HttpError with a 5xx status code\n *\n * @example\n * ```typescript\n * if (isServerError(error)) {\n *   // Trigger alerts for server errors\n * }\n * ```\n */\nexport function isServerError(error: unknown): error is HttpError {\n\treturn (\n\t\tisHttpError(error) && error.statusCode >= 500 && error.statusCode < 600\n\t);\n}\n\n// Utility functions\n\n/**\n * Wraps an unknown error into an HttpError.\n * If the error is already an HttpError, returns it unchanged.\n *\n * @param error - The error to wrap\n * @param statusCode - The HTTP status code to use (defaults to 500)\n * @param message - Optional message to override the original error message\n * @returns An HttpError instance\n *\n * @example\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   throw wrapError(error, 503, 'Service temporarily unavailable');\n * }\n * ```\n */\nexport function wrapError(\n\terror: unknown,\n\tstatusCode = 500,\n\tmessage?: string,\n): HttpError {\n\tif (isHttpError(error)) {\n\t\treturn error;\n\t}\n\n\tif (error instanceof HttpError) {\n\t\treturn error;\n\t}\n\n\treturn new HttpError(statusCode, message || 'An unknown error occurred', {\n\t\tdetails: { originalError: error },\n\t});\n}\n\n// Types for better TypeScript support\n\n/**\n * Options for creating an HttpError.\n */\nexport interface HttpErrorOptions {\n\tstatusMessage?: string;\n\tdetails?: any;\n\tcode?: string;\n\tcause?: Error;\n}\n\n/**\n * Constructor type for HttpError classes.\n * Useful for factory patterns and dependency injection.\n */\nexport type HttpErrorConstructor = new (\n\tmessage?: string,\n\toptions?: HttpErrorOptions,\n) => HttpError;\n\n/**\n * HTTP status code enum for type-safe status code usage.\n * Includes common 2xx, 3xx, 4xx, and 5xx status codes.\n */\nexport enum HttpStatusCode {\n\t// 2xx Success\n\tOK = 200,\n\tCREATED = 201,\n\tACCEPTED = 202,\n\tNO_CONTENT = 204,\n\n\t// 3xx Redirection\n\tMOVED_PERMANENTLY = 301,\n\tFOUND = 302,\n\tNOT_MODIFIED = 304,\n\n\t// 4xx Client Error\n\tBAD_REQUEST = 400,\n\tUNAUTHORIZED = 401,\n\tFORBIDDEN = 403,\n\tNOT_FOUND = 404,\n\tMETHOD_NOT_ALLOWED = 405,\n\tNOT_ACCEPTABLE = 406,\n\tREQUEST_TIMEOUT = 408,\n\tCONFLICT = 409,\n\tGONE = 410,\n\tUNPROCESSABLE_ENTITY = 422,\n\tTOO_MANY_REQUESTS = 429,\n\n\t// 5xx Server Error\n\tINTERNAL_SERVER_ERROR = 500,\n\tNOT_IMPLEMENTED = 501,\n\tBAD_GATEWAY = 502,\n\tSERVICE_UNAVAILABLE = 503,\n\tGATEWAY_TIMEOUT = 504,\n}\n\n/**\n * Namespace containing all HTTP error classes.\n * Useful for importing all error types at once.\n *\n * @example\n * ```typescript\n * import { HttpErrors } from '@geekmidas/errors';\n * throw new HttpErrors.NotFoundError('Resource not found');\n * ```\n */\nexport const HttpErrors = {\n\tHttpError,\n\tBadRequestError,\n\tUnauthorizedError,\n\tForbiddenError,\n\tNotFoundError,\n\tMethodNotAllowedError,\n\tConflictError,\n\tUnprocessableEntityError,\n\tTooManyRequestsError,\n\tInternalServerError,\n\tNotImplementedError,\n\tBadGatewayError,\n\tServiceUnavailableError,\n\tGatewayTimeoutError,\n};\n\n// Usage examples:\n/*\n// Basic usage\nthrow new NotFoundError('User not found');\nthrow new BadRequestError('Invalid email format', { field: 'email' });\n\n// With validation errors\nthrow new UnprocessableEntityError('Validation failed', {\n  email: 'Invalid email format',\n  password: 'Password must be at least 8 characters',\n});\n\n// Type-safe factory function with IntelliSense support\nthrow createHttpError(405, 'Method not allowed', { \n  allowedMethods: ['GET', 'POST'] // TypeScript knows this is the correct option!\n});\n\nthrow createHttpError(429, 'Too many requests', { \n  retryAfter: 60 // TypeScript knows this needs retryAfter, not details!\n});\n\nthrow createHttpError(422, 'Validation failed', {\n  validationErrors: { // TypeScript knows this is for validation errors\n    email: 'Invalid format',\n    age: 'Must be 18+'\n  }\n});\n\n// Using the type-safe createError object\nthrow createError.methodNotAllowed('DELETE not supported', ['GET', 'POST']);\nthrow createError.tooManyRequests('Rate limit exceeded', 60);\nthrow createError.unprocessableEntity('Invalid input', {\n  field: 'email',\n  message: 'Invalid format'\n});\n\n// TypeScript will show errors for incorrect usage:\n// throw createHttpError(404, 'Not found', { retryAfter: 60 }); // ❌ Type error!\n// throw createError.notFound('User not found', 60); // ❌ Type error!\n\n// Wrapping unknown errors\ntry {\n  await someAsyncOperation();\n} catch (error) {\n  throw wrapError(error, 500, 'Failed to process request');\n}\n\n// In Express middleware\napp.use(expressErrorHandler);\n\n// Type checking\nif (isClientError(error)) {\n  console.log('Client made a bad request');\n}\n*/\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/errors",
-  "version": "10.0.0-alpha.2",
+  "version": "10.0.0-alpha.21",
   "type": "module",
   "exports": {
     ".": {