feat: Add jssert function, alternative to node:assert

Author: arpan404

src/core/error/jssert.ts

@@ -0,0 +1,22 @@
+import Jrror from "@/core/error"; // Ensure "@/core/error" exports a valid Jrror class or function
+/**
+* Implicitly asserts that a condition is true. If the condition is false, it throws an error with the provided message and documentation path.
+* Alternative to `assert(condition, message)` from the `node:assert` module.
+* 
+* For naming convention, `jssert` is used to avoid confusion with the `assert` function from the `node:assert` module.
+* 
+* @param {boolean} condition - The condition to assert.
+* @param {string} message - The error message to throw if the assertion fails.
+* @param {string} docsPath - The documentation path for the error.
+*/
+function jssert(condition: boolean, message: string, docsPath:string = "/assertion"): asserts condition {
+    if (!condition) {
+        throw new Jrror({
+            code: 'assertion-failed',
+            message,
+            type: 'error',
+            docsPath: docsPath,
+        })
+    }
+}
+export default jssert;

src/core/response.ts

@@ -1,8 +1,9 @@
 import { ServerResponse } from "node:http";
 import Jrror, { JoorError } from "@/core/error";
-import { HeaderSent } from "@/core/error/response";
 import logger from '@/helpers/joorLogger';
-import Response, {RESPONSE_LOCATION_STATUS} from "@/types/response";
+import Response, { RESPONSE_LOCATION_STATUS } from "@/types/response";
+import assert from "node:assert";
+import jssert from "./error/jssert";
 
 const response = ServerResponse.prototype as Response;
 
@@ -20,26 +21,9 @@ const response = ServerResponse.prototype as Response;
 */
 response.status = function (this: ServerResponse, status: number): Response {
     try {
-        if (this.headersSent) {
-            throw HeaderSent; // Headers have already been sent
-        }
-        if (!Number.isInteger(status)) {
-            throw new Jrror({
-                code: "response-status-invalid",
-                message: `Status must be a integer number, but ${status} is provided.`,
-                type: "error",
-                docsPath: "/response",
-            });
-        }
-
-        if (status < 100 || status > 999) {
-            throw new Jrror({
-                code: "response-status-invalid",
-                message: `Status must be between 100 and 999, but ${status} is provided.`,
-                type: "error",
-                docsPath: "/response",
-            });
-        }
+        jssert(!this.headersSent, "Headers have already been sent", "/response");
+        jssert(!Number.isInteger(status), `Status must be a integer number, but ${status} is provided.`, "/response");
+        jssert(status < 100 || status > 999, `Status must be between 100 and 999, but ${status} is provided.`, "/response");
         this.statusCode = status;
     }
     catch (error: unknown) {
@@ -70,9 +54,13 @@ For more information, see the [HTTP/1.1 RFC](https://datatracker.ietf.org/doc/ht
 */
 response.location = function (this: ServerResponse, location: string, status: RESPONSE_LOCATION_STATUS = 301): void {
     try {
-        if (this.headersSent) {
-            throw HeaderSent; // Headers have already been sent
-        }
+        assert(typeof location === "string", "Location must be a string");
+        assert(location.length > 0, "Location must not be empty");
+        assert(
+            status >= 300 && status <= 308,
+            "Status must be between 300 and 308"
+        );
+        assert(!this.headersSent, "Headers have already been sent");
         this.setHeader("Location", location);
         this.status(status);
     }