@arkyn/server 3.0.1-beta.143 → 3.0.1-beta.145

package/dist/http/badResponses/badGateway.d.ts

@@ -1,30 +1,23 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 502 (Bad Gateway).
- * This class is used to standardize the structure of a "Bad Gateway" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 502 Bad Gateway — the upstream server returned an invalid or unexpected response.
+ *
+ * Throw inside a server action/loader and catch with `errorHandler`, or call `.toJson()` directly.
+ *
+ * @example
+ * ```typescript
+ * throw new BadGateway("Payment gateway unavailable");
+ * ```
  */
 declare class BadGateway extends BadResponse {
     /**
-     * Creates an instance of the `BadGateway` class.
-     *
-     * @param {string} message - A descriptive message explaining the cause of the error.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description sent in the response body and logged for debugging.
+     * @param cause - Optional extra context (serialized to JSON in the response).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `BadGateway` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `BadGateway` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { BadGateway };

package/dist/http/badResponses/badGateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"badGateway.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/badGateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,UAAW,SAAQ,WAAW;IAClC;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"badGateway.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/badGateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;GASG;AACH,cAAM,UAAW,SAAQ,WAAW;IAClC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/http/badResponses/badGateway.js

@@ -1,15 +1,18 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 502 (Bad Gateway).
- * This class is used to standardize the structure of a "Bad Gateway" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 502 Bad Gateway — the upstream server returned an invalid or unexpected response.
+ *
+ * Throw inside a server action/loader and catch with `errorHandler`, or call `.toJson()` directly.
+ *
+ * @example
+ * ```typescript
+ * throw new BadGateway("Payment gateway unavailable");
+ * ```
  */
 class BadGateway extends BadResponse {
     /**
-     * Creates an instance of the `BadGateway` class.
-     *
-     * @param {string} message - A descriptive message explaining the cause of the error.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description sent in the response body and logged for debugging.
+     * @param cause - Optional extra context (serialized to JSON in the response).
      */
     constructor(message, cause) {
         super();
@@ -19,12 +22,7 @@ class BadGateway extends BadResponse {
         this.cause = cause ? JSON.stringify(cause) : undefined;
         this.onDebug();
     }
-    /**
-     * Converts the `BadGateway` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse() {
         const responseInit = {
             headers: { "Content-Type": "application/json" },
@@ -33,12 +31,7 @@ class BadGateway extends BadResponse {
         };
         return new Response(JSON.stringify(this.makeBody()), responseInit);
     }
-    /**
-     * Converts the `BadGateway` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson() {
         const responseInit = {
             status: this.status,

package/dist/http/badResponses/badRequest.d.ts

@@ -1,30 +1,21 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 400 (Bad Request).
- * This class is used to standardize the structure of a "Bad Request" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 400 Bad Request — the request is malformed or contains invalid data.
+ *
+ * @example
+ * ```typescript
+ * throw new BadRequest("Invalid request body");
+ * ```
  */
 declare class BadRequest extends BadResponse {
     /**
-     * Creates an instance of the `BadRequest` class.
-     *
-     * @param {string} message - A descriptive message explaining the cause of the error.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `BadRequest` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `BadRequest` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { BadRequest };

package/dist/http/badResponses/badRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"badRequest.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/badRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,UAAW,SAAQ,WAAW;IAClC;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"badRequest.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/badRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;GAOG;AACH,cAAM,UAAW,SAAQ,WAAW;IAClC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/http/badResponses/badRequest.js

@@ -1,15 +1,16 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 400 (Bad Request).
- * This class is used to standardize the structure of a "Bad Request" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 400 Bad Request — the request is malformed or contains invalid data.
+ *
+ * @example
+ * ```typescript
+ * throw new BadRequest("Invalid request body");
+ * ```
  */
 class BadRequest extends BadResponse {
     /**
-     * Creates an instance of the `BadRequest` class.
-     *
-     * @param {string} message - A descriptive message explaining the cause of the error.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message, cause) {
         super();
@@ -19,12 +20,7 @@ class BadRequest extends BadResponse {
         this.cause = cause ? JSON.stringify(cause) : undefined;
         this.onDebug();
     }
-    /**
-     * Converts the `BadRequest` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse() {
         const responseInit = {
             headers: { "Content-Type": "application/json" },
@@ -33,12 +29,7 @@ class BadRequest extends BadResponse {
         };
         return new Response(JSON.stringify(this.makeBody()), responseInit);
     }
-    /**
-     * Converts the `BadRequest` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson() {
         const responseInit = {
             status: this.status,

package/dist/http/badResponses/conflict.d.ts

@@ -1,30 +1,21 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 409 (Conflict).
- * This class is used to standardize the structure of a "Conflict" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 409 Conflict — the request conflicts with the current state of the server (e.g. duplicate record).
+ *
+ * @example
+ * ```typescript
+ * throw new Conflict("Email already in use");
+ * ```
  */
 declare class Conflict extends BadResponse {
     /**
-     * Creates an instance of the `Conflict` class.
-     *
-     * @param {string} message - A descriptive message explaining the cause of the conflict.
-     * @param {any} cause - Optional additional information about the cause of the conflict.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `Conflict` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `Conflict` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { Conflict };

package/dist/http/badResponses/conflict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/conflict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,QAAS,SAAQ,WAAW;IAChC;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAYxC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/conflict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;GAOG;AACH,cAAM,QAAS,SAAQ,WAAW;IAChC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAYxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/http/badResponses/conflict.js

@@ -1,15 +1,16 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 409 (Conflict).
- * This class is used to standardize the structure of a "Conflict" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 409 Conflict — the request conflicts with the current state of the server (e.g. duplicate record).
+ *
+ * @example
+ * ```typescript
+ * throw new Conflict("Email already in use");
+ * ```
  */
 class Conflict extends BadResponse {
     /**
-     * Creates an instance of the `Conflict` class.
-     *
-     * @param {string} message - A descriptive message explaining the cause of the conflict.
-     * @param {any} cause - Optional additional information about the cause of the conflict.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message, cause) {
         super();
@@ -20,12 +21,7 @@ class Conflict extends BadResponse {
         this.cause = cause ? JSON.stringify(cause) : undefined;
         this.onDebug();
     }
-    /**
-     * Converts the `Conflict` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse() {
         const responseInit = {
             headers: { "Content-Type": "application/json" },
@@ -34,12 +30,7 @@ class Conflict extends BadResponse {
         };
         return new Response(JSON.stringify(this.makeBody()), responseInit);
     }
-    /**
-     * Converts the `Conflict` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson() {
         const responseInit = {
             status: this.status,

package/dist/http/badResponses/forbidden.d.ts

@@ -1,30 +1,21 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 403 (Forbidden).
- * This class is used to standardize the structure of a "Forbidden" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 403 Forbidden — authenticated but not authorized to access this resource.
+ *
+ * @example
+ * ```typescript
+ * throw new Forbidden("You don't have permission to delete this resource");
+ * ```
  */
 declare class Forbidden extends BadResponse {
     /**
-     * Creates an instance of the `Forbidden` class.
-     *
-     * @param {string} message - A descriptive message explaining why access is forbidden.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `Forbidden` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `Forbidden` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { Forbidden };

package/dist/http/badResponses/forbidden.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forbidden.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/forbidden.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,SAAU,SAAQ,WAAW;IACjC;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"forbidden.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/forbidden.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;GAOG;AACH,cAAM,SAAU,SAAQ,WAAW;IACjC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/http/badResponses/forbidden.js

@@ -1,15 +1,16 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 403 (Forbidden).
- * This class is used to standardize the structure of a "Forbidden" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 403 Forbidden — authenticated but not authorized to access this resource.
+ *
+ * @example
+ * ```typescript
+ * throw new Forbidden("You don't have permission to delete this resource");
+ * ```
  */
 class Forbidden extends BadResponse {
     /**
-     * Creates an instance of the `Forbidden` class.
-     *
-     * @param {string} message - A descriptive message explaining why access is forbidden.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message, cause) {
         super();
@@ -19,12 +20,7 @@ class Forbidden extends BadResponse {
         this.cause = cause ? JSON.stringify(cause) : undefined;
         this.onDebug();
     }
-    /**
-     * Converts the `Forbidden` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse() {
         const responseInit = {
             headers: { "Content-Type": "application/json" },
@@ -33,12 +29,7 @@ class Forbidden extends BadResponse {
         };
         return new Response(JSON.stringify(this.makeBody()), responseInit);
     }
-    /**
-     * Converts the `Forbidden` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson() {
         const responseInit = {
             status: this.status,

package/dist/http/badResponses/notFound.d.ts

@@ -1,30 +1,21 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 404 (Not Found).
- * This class is used to standardize the structure of a "Not Found" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 404 Not Found — the requested resource does not exist.
+ *
+ * @example
+ * ```typescript
+ * throw new NotFound("Product not found");
+ * ```
  */
 declare class NotFound extends BadResponse {
     /**
-     * Creates an instance of the `NotFound` class.
-     *
-     * @param {string} message - A descriptive message explaining the reason the resource was not found.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `NotFound` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `NotFound` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { NotFound };

package/dist/http/badResponses/notFound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notFound.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/notFound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,QAAS,SAAQ,WAAW;IAChC;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"notFound.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/notFound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;GAOG;AACH,cAAM,QAAS,SAAQ,WAAW;IAChC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/http/badResponses/notFound.js

@@ -1,15 +1,16 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 404 (Not Found).
- * This class is used to standardize the structure of a "Not Found" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 404 Not Found — the requested resource does not exist.
+ *
+ * @example
+ * ```typescript
+ * throw new NotFound("Product not found");
+ * ```
  */
 class NotFound extends BadResponse {
     /**
-     * Creates an instance of the `NotFound` class.
-     *
-     * @param {string} message - A descriptive message explaining the reason the resource was not found.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message, cause) {
         super();
@@ -19,12 +20,7 @@ class NotFound extends BadResponse {
         this.cause = cause ? JSON.stringify(cause) : undefined;
         this.onDebug();
     }
-    /**
-     * Converts the `NotFound` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse() {
         const responseInit = {
             headers: { "Content-Type": "application/json" },
@@ -33,12 +29,7 @@ class NotFound extends BadResponse {
         };
         return new Response(JSON.stringify(this.makeBody()), responseInit);
     }
-    /**
-     * Converts the `NotFound` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson() {
         const responseInit = {
             status: this.status,

package/dist/http/badResponses/notImplemented.d.ts

@@ -1,30 +1,21 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 501 (Not Implemented).
- * This class is used to standardize the structure of a "Not Implemented" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 501 Not Implemented — the server does not support the functionality required to fulfill the request.
+ *
+ * @example
+ * ```typescript
+ * throw new NotImplemented("Webhook delivery is not yet implemented");
+ * ```
  */
 declare class NotImplemented extends BadResponse {
     /**
-     * Creates an instance of the `NotImplemented` class.
-     *
-     * @param {string} message - A descriptive message explaining why the functionality is not implemented.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message: string, cause?: any);
-    /**
-     * Converts the `NotImplemented` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse(): Response;
-    /**
-     * Converts the `NotImplemented` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson(): Response;
 }
 export { NotImplemented };

package/dist/http/badResponses/notImplemented.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notImplemented.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/notImplemented.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AAEH,cAAM,cAAe,SAAQ,WAAW;IACtC;;;;;OAKG;gBAES,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC;;;;;OAKG;IAEH,UAAU,IAAI,QAAQ;IAUtB;;;;;OAKG;IAEH,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"notImplemented.d.ts","sourceRoot":"","sources":["../../../src/http/badResponses/notImplemented.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;GAOG;AACH,cAAM,cAAe,SAAQ,WAAW;IACtC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;IAWxC,6EAA6E;IAC7E,UAAU,IAAI,QAAQ;IAUtB,uFAAuF;IACvF,MAAM,IAAI,QAAQ;CAQnB;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/http/badResponses/notImplemented.js

@@ -1,15 +1,16 @@
 import { BadResponse } from "./_badResponse";
 /**
- * Represents an HTTP error response with a status code of 501 (Not Implemented).
- * This class is used to standardize the structure of a "Not Implemented" error response,
- * including the response body, headers, status, and status text.
+ * HTTP 501 Not Implemented — the server does not support the functionality required to fulfill the request.
+ *
+ * @example
+ * ```typescript
+ * throw new NotImplemented("Webhook delivery is not yet implemented");
+ * ```
  */
 class NotImplemented extends BadResponse {
     /**
-     * Creates an instance of the `NotImplemented` class.
-     *
-     * @param {string} message - A descriptive message explaining why the functionality is not implemented.
-     * @param {any} cause - Optional additional information about the cause of the error.
+     * @param message - Error description.
+     * @param cause - Optional extra context (serialized to JSON).
      */
     constructor(message, cause) {
         super();
@@ -19,12 +20,7 @@ class NotImplemented extends BadResponse {
         this.cause = cause ? JSON.stringify(cause) : undefined;
         this.onDebug();
     }
-    /**
-     * Converts the `NotImplemented` instance into a `Response` object with a JSON body.
-     * This method ensures the response has the appropriate headers, status, and status text.
-     *
-     * @returns {Response} A `Response` object with the serialized JSON body and response metadata.
-     */
+    /** Converts to a `Response` with `Content-Type: application/json` header. */
     toResponse() {
         const responseInit = {
             headers: { "Content-Type": "application/json" },
@@ -33,12 +29,7 @@ class NotImplemented extends BadResponse {
         };
         return new Response(JSON.stringify(this.makeBody()), responseInit);
     }
-    /**
-     * Converts the `NotImplemented` instance into a `Response` object using the `Response.json` method.
-     * This method is an alternative to `toResponse` for generating JSON error responses.
-     *
-     * @returns {Response["json"]} A `Response` object with the JSON body and response metadata.
-     */
+    /** Converts to a `Response` using `Response.json()`. Alternative to `toResponse()`. */
     toJson() {
         const responseInit = {
             status: this.status,