v1.0.0 public release

Author: wavim

README

@@ -1,22 +1,38 @@
-<!-- replace all &pack -->
-
 <h3 align="center">
-	<img src="https://raw.githubusercontent.com/wavim/&pack/master/assets/icon.png" width="130" alt="&pack icon" />
-        <br />
-        &pack name
+        HTTP Error
 </h3>
-<p align="center">&pack description</p>
+<p align="center">Convenient HTTP Error Utilities</p>
 
 ---
 
 ### Usage
 
-Add this package in your project:
+Add this package to your project:
 
 ```bash
-deno add jsr:@wvm/&pack
+deno add jsr:@wvm/http-error
 ```
 
----
+And enjoy hassle-free HTTP error status handling:
+
+```ts
+import { ErrorCode, HttpError, raise } from "@wvm/http-error";
+
+// ErrorCode Mapper
+ErrorCode.NOT_FOUND; // 404
+ErrorCode[404]; // NOT_FOUND
 
-_&emsp;_ &pack quotes
+// HttpError Raiser
+throw raise("NOT_FOUND")`Missing Page`;
+throw raise(404)`Missing Page`;
+
+// ->
+error.status; // 404
+error.phrase; // NOT_FOUND
+error.message; // 404 NOT_FOUND: Missing Page
+
+// HttpError Result
+if (error instanceof HttpError) {
+  res.status(error.status).send(error.message);
+}
+```

assets/icon.png

@@ -1,6 +1,6 @@
 {
-  "name": "@wvm/&pack",
-  "version": "0.0.0-r",
+  "name": "@wvm/http-error",
+  "version": "1.0.0",
   "publish": {
     "exclude": ["assets"]
   },

deno.json

@@ -0,0 +1,44 @@
+/**
+ * HTTP 4xx/5xx Error Codes
+ * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status)
+ */
+export enum ErrorCode {
+  BAD_REQUEST = 400,
+  UNAUTHORIZED = 401,
+  PAYMENT_REQUIRED = 402,
+  FORBIDDEN = 403,
+  NOT_FOUND = 404,
+  METHOD_NOT_ALLOWED = 405,
+  NOT_ACCEPTABLE = 406,
+  PROXY_AUTHENTICATION_REQUIRED = 407,
+  REQUEST_TIMEOUT = 408,
+  CONFLICT = 409,
+  GONE = 410,
+  LENGTH_REQUIRED = 411,
+  PRECONDITION_FAILED = 412,
+  REQUEST_TOO_LONG = 413,
+  REQUEST_URI_TOO_LONG = 414,
+  UNSUPPORTED_MEDIA_TYPE = 415,
+  REQUESTED_RANGE_NOT_SATISFIABLE = 416,
+  EXPECTATION_FAILED = 417,
+  IM_A_TEAPOT = 418,
+  INSUFFICIENT_SPACE_ON_RESOURCE = 419,
+  METHOD_FAILURE = 420,
+  MISDIRECTED_REQUEST = 421,
+  UNPROCESSABLE_ENTITY = 422,
+  LOCKED = 423,
+  FAILED_DEPENDENCY = 424,
+  UPGRADE_REQUIRED = 426,
+  PRECONDITION_REQUIRED = 428,
+  TOO_MANY_REQUESTS = 429,
+  REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
+  UNAVAILABLE_FOR_LEGAL_REASONS = 451,
+  INTERNAL_SERVER_ERROR = 500,
+  NOT_IMPLEMENTED = 501,
+  BAD_GATEWAY = 502,
+  SERVICE_UNAVAILABLE = 503,
+  GATEWAY_TIMEOUT = 504,
+  HTTP_VERSION_NOT_SUPPORTED = 505,
+  INSUFFICIENT_STORAGE = 507,
+  NETWORK_AUTHENTICATION_REQUIRED = 511,
+}

src/codes.ts

@@ -0,0 +1,23 @@
+import { ErrorCode } from "./codes.ts";
+
+/**
+ * HTTP Error Class With Status Pair
+ */
+export class HttpError extends Error {
+  readonly status: number;
+  readonly phrase: string;
+
+  /**
+   * @param error HTTP Error Code/Phrase
+   * @param message HTTP Error Cause/Details
+   */
+  constructor(error: ErrorCode | keyof typeof ErrorCode, message: string) {
+    const status = typeof error === "number" ? error : ErrorCode[error];
+    const phrase = typeof error === "number" ? ErrorCode[error] : error;
+
+    super(`${status} ${phrase}: ${message}`);
+
+    this.status = status;
+    this.phrase = phrase;
+  }
+}

src/error.ts

@@ -1 +1,15 @@
-console.log("Have a nice day!");
+import type { ErrorCode } from "./codes.ts";
+export { ErrorCode } from "./codes.ts";
+import { HttpError } from "./error.ts";
+export { HttpError } from "./error.ts";
+
+/**
+ * Get HTTP Error With Tagged Templates
+ * @param error HTTP Error Code/Phrase
+ * @returns Tag Function For HTTP Error
+ */
+export function raise(
+  error: ErrorCode | keyof typeof ErrorCode,
+): (...template: Parameters<typeof String.raw>) => HttpError {
+  return (...template) => new HttpError(error, String.raw(...template));
+}