tezx 1.0.44 → 1.0.45

package/cjs/core/server.js

@@ -7,13 +7,15 @@ const context_1 = require("./context");
 const router_1 = require("./router");
 const params_1 = require("../utils/params");
 class TezX extends router_1.Router {
-    constructor({ basePath = "/", env = {}, debugMode = false, allowDuplicateMw = false, overwriteMethod = true, } = {}) {
+    #onPathResolve;
+    constructor({ basePath = "/", env = {}, debugMode = false, onPathResolve, allowDuplicateMw = false, overwriteMethod = true, } = {}) {
         config_1.GlobalConfig.allowDuplicateMw = allowDuplicateMw;
         config_1.GlobalConfig.overwriteMethod = overwriteMethod;
         if (debugMode) {
             config_1.GlobalConfig.debugMode = debugMode;
         }
         super({ basePath, env });
+        this.#onPathResolve = onPathResolve;
         this.serve = this.serve.bind(this);
     }
     #hashRouter(method, pathname) {
@@ -121,11 +123,19 @@ class TezX extends router_1.Router {
         let ctx = new context_1.Context(req, connInfo);
         const urlRef = ctx.req.urlRef;
         const { pathname } = urlRef;
-        let middlewares = this.#findMiddleware(pathname);
+        let resolvePath = pathname;
+        if (this.#onPathResolve) {
+            resolvePath = this.#onPathResolve(pathname);
+            config_1.GlobalConfig.debugging.warn(`${colors_1.COLORS.white} PATH RESOLVE ${colors_1.COLORS.reset} ${colors_1.COLORS.red}${pathname}${colors_1.COLORS.reset} ➞ ${colors_1.COLORS.cyan}${resolvePath}${colors_1.COLORS.reset}`);
+        }
+        if (typeof resolvePath !== 'string') {
+            throw new Error(`Path resolution failed: expected a string, got ${typeof resolvePath}`);
+        }
+        let middlewares = this.#findMiddleware(resolvePath);
         ctx.env = this.env;
         try {
             let callback = async (ctx) => {
-                const find = this.findRoute(ctx.req.method, pathname);
+                const find = this.findRoute(ctx.req.method, resolvePath);
                 if (find?.callback) {
                     ctx.params = find.params;
                     const callback = find.callback;

package/cjs/index.js

@@ -7,4 +7,4 @@ var server_1 = require("./core/server");
 Object.defineProperty(exports, "TezX", { enumerable: true, get: function () { return server_1.TezX; } });
 var params_1 = require("./utils/params");
 Object.defineProperty(exports, "useParams", { enumerable: true, get: function () { return params_1.useParams; } });
-exports.version = "1.0.44";
+exports.version = "1.0.45";

package/core/server.d.ts

@@ -32,6 +32,25 @@ export type TezXConfig = {
      * @default true
      */
     overwriteMethod?: boolean;
+    /**
+     * 🔄 Hook to transform or normalize the incoming request pathname before routing.
+     *
+     * This function allows you to customize how incoming paths are handled.
+     * You can use it to:
+     * - Remove trailing slashes
+     * - Normalize casing
+     * - Rewrite certain paths dynamically
+     * - Add localization or versioning prefixes
+     *
+     * @example
+     * ```ts
+     * onPathResolve: (pathname) => pathname.replace(/\/+$/, "").toLowerCase()
+     * ```
+     *
+     * @param pathname - The raw incoming request path (e.g., `/Api/Users/`)
+     * @returns The transformed or resolved path used for routing (e.g., `/api/users`)
+     */
+    onPathResolve?: (pathname: string) => string;
     /**
      * Enables or disables debugging for the middleware.
      * When set to `true`, detailed debug logs will be output,
@@ -43,7 +62,7 @@ export type TezXConfig = {
 } & RouterConfig;
 export declare class TezX<T extends Record<string, any> = {}> extends Router<T> {
     #private;
-    constructor({ basePath, env, debugMode, allowDuplicateMw, overwriteMethod, }?: TezXConfig);
+    constructor({ basePath, env, debugMode, onPathResolve, allowDuplicateMw, overwriteMethod, }?: TezXConfig);
     protected findRoute(method: HTTPMethod, pathname: string): {
         callback: any;
         middlewares: Middleware<T>[];

package/core/server.js

@@ -4,13 +4,15 @@ import { Context, httpStatusMap } from "./context";
 import { Router } from "./router";
 import { useParams } from "../utils/params";
 export class TezX extends Router {
-    constructor({ basePath = "/", env = {}, debugMode = false, allowDuplicateMw = false, overwriteMethod = true, } = {}) {
+    #onPathResolve;
+    constructor({ basePath = "/", env = {}, debugMode = false, onPathResolve, allowDuplicateMw = false, overwriteMethod = true, } = {}) {
         GlobalConfig.allowDuplicateMw = allowDuplicateMw;
         GlobalConfig.overwriteMethod = overwriteMethod;
         if (debugMode) {
             GlobalConfig.debugMode = debugMode;
         }
         super({ basePath, env });
+        this.#onPathResolve = onPathResolve;
         this.serve = this.serve.bind(this);
     }
     #hashRouter(method, pathname) {
@@ -118,11 +120,19 @@ export class TezX extends Router {
         let ctx = new Context(req, connInfo);
         const urlRef = ctx.req.urlRef;
         const { pathname } = urlRef;
-        let middlewares = this.#findMiddleware(pathname);
+        let resolvePath = pathname;
+        if (this.#onPathResolve) {
+            resolvePath = this.#onPathResolve(pathname);
+            GlobalConfig.debugging.warn(`${COLORS.white} PATH RESOLVE ${COLORS.reset} ${COLORS.red}${pathname}${COLORS.reset} ➞ ${COLORS.cyan}${resolvePath}${COLORS.reset}`);
+        }
+        if (typeof resolvePath !== 'string') {
+            throw new Error(`Path resolution failed: expected a string, got ${typeof resolvePath}`);
+        }
+        let middlewares = this.#findMiddleware(resolvePath);
         ctx.env = this.env;
         try {
             let callback = async (ctx) => {
-                const find = this.findRoute(ctx.req.method, pathname);
+                const find = this.findRoute(ctx.req.method, resolvePath);
                 if (find?.callback) {
                     ctx.params = find.params;
                     const callback = find.callback;

package/index.js

@@ -1,4 +1,4 @@
 export { Router } from "./core/router";
 export { TezX } from "./core/server";
 export { useParams } from "./utils/params";
-export let version = "1.0.44";
+export let version = "1.0.45";

package/middleware/basicAuth.d.ts

@@ -4,7 +4,13 @@ import { CallbackReturn } from "../core/router";
 /**
  * Supported authentication method types.
  */
-type AuthMethod = "basic" | "api-key" | "bearer-token";
+export type AuthMethod = "basic" | "api-key" | "bearer-token";
+export type AuthCredential = {
+    username?: any;
+    password?: any;
+    token?: any;
+    apiKey?: any;
+};
 /**
  * Configuration options for dynamic basic authentication.
  */
@@ -16,7 +22,7 @@ type DynamicBasicAuthOptions = {
      * @param ctx - The current request context.
      * @returns A boolean or Promise resolving to whether the credentials are valid.
      */
-    validateCredentials: (method: AuthMethod, credentials: Record<string, any>, ctx: Context) => boolean | Promise<boolean>;
+    validateCredentials: (method: AuthMethod, credentials: AuthCredential, ctx: Context) => boolean | Promise<boolean>;
     /**
      * 🔒 Function to dynamically determine the realm for authentication prompt.
      * @param ctx - The current request context.
@@ -65,7 +71,7 @@ type DynamicBasicAuthOptions = {
      * @param credentials - The validated credentials.
      * @returns Whether access is allowed.
      */
-    checkAccess?: (ctx: Context, credentials: Record<string, any>) => boolean | Promise<boolean>;
+    checkAccess?: (ctx: Context, credentials: AuthCredential) => boolean | Promise<boolean>;
 };
 /**
  * 🔐 Middleware for flexible authentication using Basic, API Key, or Bearer Token.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tezx",
-  "version": "1.0.44",
+  "version": "1.0.45",
   "description": "TezX is a high-performance, lightweight JavaScript framework designed for speed, scalability, and flexibility. It enables efficient routing, middleware management, and static file serving with minimal configuration. Fully compatible with Node.js, Deno, and Bun.",
   "main": "cjs/index.js",
   "module": "index.js",