tezx 1.0.68 → 1.0.70

package/cjs/index.js

@@ -7,4 +7,4 @@ var server_js_1 = require("./core/server.js");
 Object.defineProperty(exports, "TezX", { enumerable: true, get: function () { return server_js_1.TezX; } });
 var params_js_1 = require("./utils/params.js");
 Object.defineProperty(exports, "useParams", { enumerable: true, get: function () { return params_js_1.useParams; } });
-exports.version = "1.0.68";
+exports.version = "1.0.70";

package/cjs/middleware/cacheControl.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheControl = void 0;
+const config_js_1 = require("../core/config.js");
+const cacheControl = (options) => {
+    const { defaultSettings, useWeakETag = false, rules = [], logEvent = (event, ctx, error) => {
+        if (event === "error") {
+            config_js_1.GlobalConfig.debugging.error(`[CACHE] ${event.toUpperCase()}: ${error?.message}`);
+        }
+        else {
+            config_js_1.GlobalConfig.debugging.success(`[CACHE] ${event.toUpperCase()} for ${ctx.method} ${ctx.pathname}`);
+        }
+    }, } = options;
+    return async (ctx, next) => {
+        if (!["GET", "HEAD"].includes(ctx.method)) {
+            return await next();
+        }
+        try {
+            await next();
+            const matchedRule = rules.find((rule) => rule.condition(ctx)) || null;
+            const { maxAge, scope, enableETag, vary } = matchedRule || defaultSettings;
+            const cacheControlValue = `${scope}, max-age=${maxAge}`;
+            ctx.header("Cache-Control", cacheControlValue);
+            const expiresDate = new Date(Date.now() + maxAge * 1000).toUTCString();
+            ctx.header("Expires", expiresDate);
+            if (vary?.length) {
+                ctx.header("Vary", vary.join(", "));
+            }
+            if (enableETag) {
+                const responseBody = typeof ctx.resBody === "string"
+                    ? ctx.resBody
+                    : JSON.stringify(ctx.resBody ?? "");
+                const etag = await generateETag(responseBody, useWeakETag);
+                const ifNoneMatch = ctx.req.headers.get("if-none-match");
+                if (ifNoneMatch === etag) {
+                    ctx.setStatus = 304;
+                    ctx.body = null;
+                    logEvent("cached", ctx);
+                    return;
+                }
+                ctx.header("ETag", etag);
+            }
+            logEvent("cached", ctx);
+        }
+        catch (error) {
+            logEvent("error", ctx, error);
+            ctx.setStatus = 500;
+            ctx.body = { error: "Failed to set cache headers." };
+        }
+    };
+};
+exports.cacheControl = cacheControl;
+const generateETag = async (content, weak = false) => {
+    const crypto = await Promise.resolve().then(() => require("node:crypto"));
+    const hash = crypto.createHash("md5").update(content).digest("hex");
+    return weak ? `W/"${hash}"` : `"${hash}"`;
+};

package/cjs/middleware/index.js

@@ -32,3 +32,4 @@ __exportStar(require("./requestTimeout.js"), exports);
 __exportStar(require("./sanitizeHeader.js"), exports);
 __exportStar(require("./secureHeaders.js"), exports);
 __exportStar(require("./xssProtection.js"), exports);
+__exportStar(require("./cacheControl.js"), exports);

package/cjs/utils/formData.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseJsonBody = parseJsonBody;
 exports.parseTextBody = parseTextBody;
 exports.parseUrlEncodedBody = parseUrlEncodedBody;
+exports.sanitized = sanitized;
 exports.parseMultipartBody = parseMultipartBody;
 const config_js_1 = require("../core/config.js");
 async function parseJsonBody(req) {
@@ -91,6 +92,16 @@ async function parseUrlEncodedBody(req) {
         throw new Error("Unsupported environment for multipart parsing");
     }
 }
+function sanitized(title) {
+    const base = title
+        .toLowerCase()
+        .trim()
+        .replace(/[_\s]+/g, '-')
+        .replace(/[^a-z0-9-.]+/g, '')
+        .replace(/--+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return base;
+}
 async function parseMultipartBody(req, boundary, options) {
     const runtime = config_js_1.GlobalConfig.adapter;
     if (runtime === "node") {
@@ -133,7 +144,7 @@ async function parseMultipartBody(req, boundary, options) {
                                 const contentType = contentTypeMatch[1];
                                 if (options?.sanitized) {
                                     filename =
-                                        `${Date.now()}-${filename.replace(/\s+/g, "")?.replace(/[^a-zA-Z0-9.-]/g, "-")}`?.toLowerCase();
+                                        `${Date.now()}-${sanitized(filename)}`;
                                 }
                                 if (Array.isArray(options?.allowedTypes) &&
                                     !options.allowedTypes?.includes(contentType)) {
@@ -192,7 +203,7 @@ async function parseMultipartBody(req, boundary, options) {
                 let filename = val.name;
                 if (options?.sanitized) {
                     filename =
-                        `${Date.now()}-${filename.replace(/\s+/g, "")?.replace(/[^a-zA-Z0-9.-]/g, "-")}`?.toLowerCase();
+                        `${Date.now()}-${sanitized(filename)}`;
                 }
                 if (Array.isArray(options?.allowedTypes) &&
                     !options.allowedTypes?.includes(val.type)) {

package/index.js

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

package/middleware/cacheControl.d.ts

@@ -0,0 +1,47 @@
+import { Context, Middleware } from "../index.js";
+export type CacheRule = {
+    /**
+     * 🎯 Condition to determine if this rule applies.
+     */
+    condition: (ctx: Context) => boolean;
+    /**
+     * ⏳ Maximum age (in seconds) for caching.
+     */
+    maxAge: number;
+    /**
+     * 🌐 Cache scope: "public" or "private".
+     */
+    scope: "public" | "private";
+    /**
+     * 🔄 Enable or disable revalidation with ETag.
+     */
+    enableETag: boolean;
+    /**
+     * 🏷️ Vary header for cache variations.
+     */
+    vary?: string[];
+};
+export type CacheSettings = Pick<CacheRule, "maxAge" | "scope" | "enableETag" | "vary">;
+export type CacheOptions = {
+    /**
+    * 🧪 Weak ETag generation (optional).
+    */
+    useWeakETag?: boolean;
+    /**
+     * 📝 Logging function for cache events.
+     */
+    logEvent?: (event: "cached" | "no-cache" | "error", ctx: Context, error?: Error) => void;
+    /**
+     * 🛠️ Default cache settings.
+     */
+    defaultSettings: CacheSettings;
+    /**
+     * 🔧 Custom rules for dynamic caching behavior.
+     */
+    rules?: CacheRule[];
+};
+/**
+ * Middleware to manage HTTP caching headers dynamically.
+ * @param options - Custom options for dynamic caching behavior.
+ */
+export declare const cacheControl: (options: CacheOptions) => Middleware;

package/middleware/cacheControl.js

@@ -0,0 +1,53 @@
+import { GlobalConfig } from "../core/config.js";
+export const cacheControl = (options) => {
+    const { defaultSettings, useWeakETag = false, rules = [], logEvent = (event, ctx, error) => {
+        if (event === "error") {
+            GlobalConfig.debugging.error(`[CACHE] ${event.toUpperCase()}: ${error?.message}`);
+        }
+        else {
+            GlobalConfig.debugging.success(`[CACHE] ${event.toUpperCase()} for ${ctx.method} ${ctx.pathname}`);
+        }
+    }, } = options;
+    return async (ctx, next) => {
+        if (!["GET", "HEAD"].includes(ctx.method)) {
+            return await next();
+        }
+        try {
+            await next();
+            const matchedRule = rules.find((rule) => rule.condition(ctx)) || null;
+            const { maxAge, scope, enableETag, vary } = matchedRule || defaultSettings;
+            const cacheControlValue = `${scope}, max-age=${maxAge}`;
+            ctx.header("Cache-Control", cacheControlValue);
+            const expiresDate = new Date(Date.now() + maxAge * 1000).toUTCString();
+            ctx.header("Expires", expiresDate);
+            if (vary?.length) {
+                ctx.header("Vary", vary.join(", "));
+            }
+            if (enableETag) {
+                const responseBody = typeof ctx.resBody === "string"
+                    ? ctx.resBody
+                    : JSON.stringify(ctx.resBody ?? "");
+                const etag = await generateETag(responseBody, useWeakETag);
+                const ifNoneMatch = ctx.req.headers.get("if-none-match");
+                if (ifNoneMatch === etag) {
+                    ctx.setStatus = 304;
+                    ctx.body = null;
+                    logEvent("cached", ctx);
+                    return;
+                }
+                ctx.header("ETag", etag);
+            }
+            logEvent("cached", ctx);
+        }
+        catch (error) {
+            logEvent("error", ctx, error);
+            ctx.setStatus = 500;
+            ctx.body = { error: "Failed to set cache headers." };
+        }
+    };
+};
+const generateETag = async (content, weak = false) => {
+    const crypto = await import("node:crypto");
+    const hash = crypto.createHash("md5").update(content).digest("hex");
+    return weak ? `W/"${hash}"` : `"${hash}"`;
+};

package/middleware/index.d.ts

@@ -15,3 +15,4 @@ export * from "./requestTimeout.js";
 export * from "./sanitizeHeader.js";
 export * from "./secureHeaders.js";
 export * from "./xssProtection.js";
+export * from "./cacheControl.js";

package/middleware/index.js

@@ -13,3 +13,4 @@ export * from "./requestTimeout.js";
 export * from "./sanitizeHeader.js";
 export * from "./secureHeaders.js";
 export * from "./xssProtection.js";
+export * from "./cacheControl.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tezx",
-  "version": "1.0.68",
+  "version": "1.0.70",
   "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",

package/utils/formData.d.ts

@@ -2,4 +2,5 @@ import { FormDataOptions } from "../core/request.js";
 export declare function parseJsonBody(req: any): Promise<Record<string, any>>;
 export declare function parseTextBody(req: any): Promise<string>;
 export declare function parseUrlEncodedBody(req: any): Promise<Record<string, any>>;
+export declare function sanitized(title: string): string;
 export declare function parseMultipartBody(req: any, boundary: string, options?: FormDataOptions): Promise<Record<string, any>>;

package/utils/formData.js

@@ -85,6 +85,16 @@ export async function parseUrlEncodedBody(req) {
         throw new Error("Unsupported environment for multipart parsing");
     }
 }
+export function sanitized(title) {
+    const base = title
+        .toLowerCase()
+        .trim()
+        .replace(/[_\s]+/g, '-')
+        .replace(/[^a-z0-9-.]+/g, '')
+        .replace(/--+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return base;
+}
 export async function parseMultipartBody(req, boundary, options) {
     const runtime = GlobalConfig.adapter;
     if (runtime === "node") {
@@ -127,7 +137,7 @@ export async function parseMultipartBody(req, boundary, options) {
                                 const contentType = contentTypeMatch[1];
                                 if (options?.sanitized) {
                                     filename =
-                                        `${Date.now()}-${filename.replace(/\s+/g, "")?.replace(/[^a-zA-Z0-9.-]/g, "-")}`?.toLowerCase();
+                                        `${Date.now()}-${sanitized(filename)}`;
                                 }
                                 if (Array.isArray(options?.allowedTypes) &&
                                     !options.allowedTypes?.includes(contentType)) {
@@ -186,7 +196,7 @@ export async function parseMultipartBody(req, boundary, options) {
                 let filename = val.name;
                 if (options?.sanitized) {
                     filename =
-                        `${Date.now()}-${filename.replace(/\s+/g, "")?.replace(/[^a-zA-Z0-9.-]/g, "-")}`?.toLowerCase();
+                        `${Date.now()}-${sanitized(filename)}`;
                 }
                 if (Array.isArray(options?.allowedTypes) &&
                     !options.allowedTypes?.includes(val.type)) {