clear-router 2.1.12 → 2.3.0

package/dist/hono/index.mjs

@@ -0,0 +1,226 @@
+import { t as CoreRouter } from "../router-Bug2IE_u.mjs";
+
+//#region src/hono/router.ts
+/**
+* @class clear-router Hono Router
+* @description Laravel-style routing system for Hono using shared clear-router core
+* @author 3m1n3nc3
+* @repository https://github.com/toneflix/clear-router
+*/
+var Router = class Router extends CoreRouter {
+	static bodyCache = /* @__PURE__ */ new WeakMap();
+	static toResponse(ctx, value) {
+		if (value instanceof Response) return value;
+		if (typeof value === "undefined") return void 0;
+		if (value === null) return ctx.body(null);
+		if (typeof value === "string") return ctx.text(value);
+		if (typeof value === "object") return ctx.json(value);
+		return ctx.text(String(value));
+	}
+	static getParams(ctx) {
+		try {
+			const raw = ctx.req.param?.();
+			return raw && typeof raw === "object" ? raw : {};
+		} catch {
+			return {};
+		}
+	}
+	static async readBodyCached(ctx) {
+		if (this.bodyCache.has(ctx)) {
+			const cached = this.bodyCache.get(ctx) || {};
+			ctx.req.getBody = () => cached;
+			return cached;
+		}
+		let body = {};
+		const contentType = (ctx.req.header("content-type") || "").toLowerCase();
+		if (contentType.includes("application/json")) body = await ctx.req.json().catch(() => ({}));
+		else if (contentType.includes("multipart/form-data") || contentType.includes("application/x-www-form-urlencoded")) body = await ctx.req.parseBody().then((v) => v).catch(() => ({}));
+		ctx.req.getBody = () => body;
+		this.bodyCache.set(ctx, body);
+		return body;
+	}
+	/**
+	* Resolve method override from query, headers, or body
+	* 
+	* @param methods 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static add(methods, path, handler, middlewares) {
+		super.add(methods, path, handler, middlewares);
+	}
+	/**
+	* Define a resourceful API controller with standard CRUD routes
+	* 
+	* @param basePath 
+	* @param controller 
+	* @param options 
+	*/
+	static apiResource(basePath, controller, options) {
+		super.apiResource(basePath, controller, options);
+	}
+	/**
+	* Define a GET route
+	* 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static get(path, handler, middlewares) {
+		super.get(path, handler, middlewares);
+	}
+	/**
+	* Define a POST route
+	* 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static post(path, handler, middlewares) {
+		super.post(path, handler, middlewares);
+	}
+	/**
+	* Define a PUT route
+	* 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static put(path, handler, middlewares) {
+		super.put(path, handler, middlewares);
+	}
+	/**
+	* Define a DELETE route
+	* 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static delete(path, handler, middlewares) {
+		super.delete(path, handler, middlewares);
+	}
+	/**
+	* Define a PATCH route 
+	* 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static patch(path, handler, middlewares) {
+		super.patch(path, handler, middlewares);
+	}
+	/**
+	* Define an OPTIONS route
+	* 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static options(path, handler, middlewares) {
+		super.options(path, handler, middlewares);
+	}
+	/**
+	* Define a HEAD route
+	* 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static head(path, handler, middlewares) {
+		super.head(path, handler, middlewares);
+	}
+	/**
+	* Define a group of routes with a common prefix and optional middlewares
+	* 
+	* @param prefix 
+	* @param callback 
+	* @param middlewares 
+	*/
+	static async group(prefix, callback, middlewares) {
+		await super.group(prefix, callback, middlewares);
+	}
+	/**
+	* Apply middlewares to a group of routes defined within the callback
+	* 
+	* @param middlewares  - Middleware or array of middlewares to apply
+	* @param callback     - Function that defines the routes to which the middlewares will be applied
+	*/
+	static middleware(middlewares, callback) {
+		super.middleware(middlewares, callback);
+	}
+	static allRoutes(type) {
+		return super.allRoutes(type);
+	}
+	/**
+	* Apply the defined routes to a Hono application instance
+	* 
+	* @param app  The Hono application instance
+	* @returns    The Hono application instance with the applied routes
+	*/
+	static apply(app) {
+		for (const route of this.routes) {
+			let handlerFunction = null;
+			let instance = null;
+			try {
+				const resolved = this.resolveHandler(route);
+				handlerFunction = resolved.handlerFunction;
+				instance = resolved.instance;
+			} catch (error) {
+				console.error(`[ROUTES] Error setting up route ${route.path}:`, error.message);
+				throw error;
+			}
+			if (!handlerFunction) continue;
+			for (const method of route.methods) {
+				const allowedMethods = [
+					"get",
+					"post",
+					"put",
+					"delete",
+					"patch",
+					"options",
+					"head"
+				];
+				if (method === "options" && route.methods.length > 1) continue;
+				if (!allowedMethods.includes(method)) throw new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
+				app[method](route.path, ...route.middlewares || [], async (context) => {
+					const ctx = context;
+					const reqBody = await Router.readBodyCached(ctx);
+					const override = Router.resolveMethodOverride(ctx.req.method, ctx.req.header(), reqBody);
+					if (method === "post" && override && override !== "post") return;
+					const inst = instance ?? route;
+					Router.bindRequestToInstance(ctx, inst, route, {
+						body: reqBody,
+						query: ctx.req.query(),
+						params: Router.getParams(ctx)
+					});
+					const result = handlerFunction(ctx, inst.clearRequest);
+					const resolved = await Promise.resolve(result);
+					return Router.toResponse(ctx, resolved);
+				});
+				if ([
+					"put",
+					"patch",
+					"delete"
+				].includes(method)) app.post(route.path, ...route.middlewares || [], async (context) => {
+					const ctx = context;
+					const reqBody = await Router.readBodyCached(ctx);
+					if (Router.resolveMethodOverride(ctx.req.method, ctx.req.header(), reqBody) !== method) return;
+					const inst = instance ?? route;
+					Router.bindRequestToInstance(ctx, inst, route, {
+						body: reqBody,
+						query: ctx.req.query(),
+						params: Router.getParams(ctx)
+					});
+					const result = handlerFunction(ctx, inst.clearRequest);
+					const resolved = await Promise.resolve(result);
+					return Router.toResponse(ctx, resolved);
+				});
+			}
+		}
+		return app;
+	}
+};
+
+//#endregion
+export { Router };

package/dist/index.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let node_async_hooks = require("node:async_hooks");
 
 //#region src/ClearRequest.ts
 var ClearRequest = class {
@@ -58,7 +59,363 @@ var Route = class {
 	}
 };
 
+//#endregion
+//#region src/core/router.ts
+/**
+* @class clear-router CoreRouter
+* @description Core routing logic for clear-router, shared between all supported adapters (Express.js, H3, etc.)
+* @author 3m1n3nc3
+* @repository https://github.com/toneflix/clear-router
+*/
+var CoreRouter = class {
+	static createDefaultOptionsHandler() {
+		return (ctx) => {
+			const allow = "GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD";
+			if (ctx?.header && ctx?.status && ctx?.body) {
+				ctx.header("Allow", allow);
+				ctx.status(204);
+				return ctx.body(null);
+			}
+			if (ctx?.res?.headers?.set) {
+				ctx.res.headers.set("Allow", allow);
+				ctx.res.status = 204;
+				return;
+			}
+			if (ctx?.res?.set) {
+				ctx.res.set("Allow", allow);
+				ctx.res.sendStatus(204);
+				return;
+			}
+			if (ctx?.reply?.header) {
+				ctx.reply.header("Allow", allow);
+				ctx.reply.code(204).send();
+				return;
+			}
+		};
+	}
+	static config = { methodOverride: {
+		enabled: true,
+		bodyKeys: ["_method"],
+		headerKeys: ["x-http-method"]
+	} };
+	static groupContext = new node_async_hooks.AsyncLocalStorage();
+	static routes = [];
+	static routesByPathMethod = {};
+	static routesByMethod = {};
+	static prefix = "";
+	static groupMiddlewares = [];
+	static globalMiddlewares = [];
+	static ensureState() {
+		if (!Object.prototype.hasOwnProperty.call(this, "config")) this.config = { methodOverride: {
+			enabled: true,
+			bodyKeys: ["_method"],
+			headerKeys: ["x-http-method"]
+		} };
+		if (!Object.prototype.hasOwnProperty.call(this, "groupContext")) this.groupContext = new node_async_hooks.AsyncLocalStorage();
+		if (!Object.prototype.hasOwnProperty.call(this, "routes")) this.routes = [];
+		if (!Object.prototype.hasOwnProperty.call(this, "routesByPathMethod")) this.routesByPathMethod = {};
+		if (!Object.prototype.hasOwnProperty.call(this, "routesByMethod")) this.routesByMethod = {};
+		if (!Object.prototype.hasOwnProperty.call(this, "prefix")) this.prefix = "";
+		if (!Object.prototype.hasOwnProperty.call(this, "groupMiddlewares")) this.groupMiddlewares = [];
+		if (!Object.prototype.hasOwnProperty.call(this, "globalMiddlewares")) this.globalMiddlewares = [];
+	}
+	/**
+	* Normalizes a path by ensuring it starts with a single slash and does not have trailing 
+	* slashes, while preserving dynamic segments and parameters.
+	* 
+	* @param path  The path to normalize.
+	* @returns     The normalized path.
+	*/
+	static normalizePath(path) {
+		return "/" + path.split("/").filter(Boolean).join("/");
+	}
+	/**
+	* Configures the router with the given options, such as method override settings.
+	* 
+	* @param this 
+	* @param options 
+	* @returns 
+	*/
+	static configure(options) {
+		this.ensureState();
+		if (!this.config.methodOverride) this.config.methodOverride = {
+			enabled: true,
+			bodyKeys: ["_method"],
+			headerKeys: ["x-http-method"]
+		};
+		const override = options?.methodOverride;
+		if (!override) return;
+		if (typeof override.enabled === "boolean") this.config.methodOverride.enabled = override.enabled;
+		const bodyKeys = override.bodyKeys;
+		if (typeof bodyKeys !== "undefined") this.config.methodOverride.bodyKeys = (Array.isArray(bodyKeys) ? bodyKeys : [bodyKeys]).map((e) => String(e).trim()).filter(Boolean);
+		const headerKeys = override.headerKeys;
+		if (typeof headerKeys !== "undefined") this.config.methodOverride.headerKeys = (Array.isArray(headerKeys) ? headerKeys : [headerKeys]).map((e) => String(e).trim().toLowerCase()).filter(Boolean);
+	}
+	static resolveMethodOverride(method, headers, body) {
+		this.ensureState();
+		if (!this.config.methodOverride?.enabled || method.toLowerCase() !== "post") return null;
+		let override;
+		const headerValueFor = (key) => {
+			if (typeof headers.get === "function") return headers.get(key);
+			const value = headers?.[key];
+			return Array.isArray(value) ? value[0] : value;
+		};
+		for (const key of this.config.methodOverride?.headerKeys || []) {
+			const value = headerValueFor(key);
+			if (value) {
+				override = value;
+				break;
+			}
+		}
+		if (!override && body && typeof body === "object") for (const key of this.config.methodOverride?.bodyKeys || []) {
+			const value = body[key];
+			if (typeof value !== "undefined" && value !== null && value !== "") {
+				override = value;
+				break;
+			}
+		}
+		const normalized = String(override || "").trim().toLowerCase();
+		if (!normalized) return null;
+		if ([
+			"put",
+			"patch",
+			"delete",
+			"post"
+		].includes(normalized)) return normalized;
+		return null;
+	}
+	/**
+	* Adds a new route to the router with the specified methods, path, handler, and middlewares.
+	* 
+	* @param this 
+	* @param methods 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static add(methods, path, handler, middlewares) {
+		this.ensureState();
+		const context = this.groupContext.getStore();
+		const activePrefix = context?.prefix ?? this.prefix;
+		const activeGroupMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
+		methods = Array.isArray(methods) ? methods : [methods];
+		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
+		const fullPath = this.normalizePath(`${activePrefix}/${path}`);
+		const route = new Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
+			...this.globalMiddlewares,
+			...activeGroupMiddlewares,
+			...middlewares || []
+		]);
+		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, this.createDefaultOptionsHandler());
+		this.routes.push(route);
+		for (const method of methods.map((m) => m.toUpperCase())) {
+			this.routesByPathMethod[`${method} ${fullPath}`] = route;
+			if (!this.routesByMethod[method]) this.routesByMethod[method] = [];
+			this.routesByMethod[method].push(route);
+		}
+	}
+	/**
+	* Adds a new API resource route to the router for the specified base path and controller, with 
+	* options to include/exclude specific actions and apply middlewares.
+	* 
+	* @param this 
+	* @param basePath 
+	* @param controller 
+	* @param options 
+	*/
+	static apiResource(basePath, controller, options) {
+		const actions = {
+			index: {
+				method: "get",
+				path: "/"
+			},
+			show: {
+				method: "get",
+				path: "/:id"
+			},
+			create: {
+				method: "post",
+				path: "/"
+			},
+			update: {
+				method: "put",
+				path: "/:id"
+			},
+			destroy: {
+				method: "delete",
+				path: "/:id"
+			}
+		};
+		const only = options?.only || Object.keys(actions);
+		const except = options?.except || [];
+		const preController = typeof controller === "function" ? new controller() : controller;
+		for (const action of only) {
+			if (except.includes(action)) continue;
+			if (typeof preController[action] === "function") {
+				const { method, path } = actions[action];
+				const actionMiddlewares = typeof options?.middlewares === "object" && !Array.isArray(options.middlewares) ? options.middlewares[action] : options?.middlewares;
+				this.add(method, `${basePath}${path}`, [controller, action], Array.isArray(actionMiddlewares) ? actionMiddlewares : actionMiddlewares ? [actionMiddlewares] : void 0);
+			}
+		}
+	}
+	/**
+	* Adds a new GET route to the router with the specified path, handler, and optional middlewares.
+	* 
+	* @param this          The router instance.
+	* @param path          The path for the GET route.
+	* @param handler       The handler function for the GET route.
+	* @param middlewares   Optional middlewares to apply to the GET route.
+	*/
+	static get(path, handler, middlewares) {
+		this.add("get", path, handler, middlewares);
+	}
+	/**
+	* Adds a new POST route to the router with the specified path, handler, and optional middlewares.
+	* 
+	* @param this 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static post(path, handler, middlewares) {
+		this.add("post", path, handler, middlewares);
+	}
+	/**
+	* Adds a new PUT route to the router with the specified path, handler, and optional middlewares.
+	* 
+	* @param this 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static put(path, handler, middlewares) {
+		this.add("put", path, handler, middlewares);
+	}
+	/**
+	* Adds a new DELETE route to the router with the specified path, handler, and optional middlewares.
+	* 
+	* @param this 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static delete(path, handler, middlewares) {
+		this.add("delete", path, handler, middlewares);
+	}
+	/**
+	* Adds a new PATCH route to the router with the specified path, handler, and optional middlewares.
+	* 
+	* @param this 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static patch(path, handler, middlewares) {
+		this.add("patch", path, handler, middlewares);
+	}
+	/**
+	* Adds a new OPTIONS route to the router with the specified path, handler, and optional middlewares.
+	* 
+	* @param this 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static options(path, handler, middlewares) {
+		this.add("options", path, handler, middlewares);
+	}
+	/**
+	* Adds a new HEAD route to the router with the specified path, handler, and optional middlewares.
+	* 
+	* @param this 
+	* @param path 
+	* @param handler 
+	* @param middlewares 
+	*/
+	static head(path, handler, middlewares) {
+		this.add("head", path, handler, middlewares);
+	}
+	/**
+	* Defines a group of routes with a common prefix and optional middlewares, allowing for better 
+	* organization and reuse of route configurations.
+	* 
+	* @param this 
+	* @param prefix 
+	* @param callback 
+	* @param middlewares 
+	*/
+	static async group(prefix, callback, middlewares) {
+		this.ensureState();
+		const context = this.groupContext.getStore();
+		const previousPrefix = context?.prefix ?? this.prefix;
+		const previousMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
+		const fullPrefix = [previousPrefix, prefix].filter(Boolean).join("/");
+		const nextContext = {
+			prefix: this.normalizePath(fullPrefix),
+			groupMiddlewares: [...previousMiddlewares, ...middlewares || []]
+		};
+		await this.groupContext.run(nextContext, async () => {
+			await Promise.resolve(callback());
+		});
+	}
+	/**
+	* Adds global middlewares to the router, which will be applied to all routes.
+	* 
+	* @param this 
+	* @param middlewares 
+	* @param callback 
+	*/
+	static middleware(middlewares, callback) {
+		this.ensureState();
+		const prevMiddlewares = this.globalMiddlewares;
+		this.globalMiddlewares = [...prevMiddlewares, ...middlewares || []];
+		callback();
+		this.globalMiddlewares = prevMiddlewares;
+	}
+	static allRoutes(type) {
+		this.ensureState();
+		if (type === "method") return this.routesByMethod;
+		if (type === "path") return this.routesByPathMethod;
+		return this.routes.filter((e) => e.methods.length > 1 || e.methods[0] !== "options");
+	}
+	static resolveHandler(route) {
+		let handlerFunction;
+		let instance = null;
+		if (typeof route.handler === "function") handlerFunction = route.handler.bind(route);
+		else if (Array.isArray(route.handler) && route.handler.length === 2) {
+			const [ControllerType, method] = route.handler;
+			if (["function", "object"].includes(typeof ControllerType) && typeof ControllerType[method] === "function") {
+				instance = ControllerType;
+				handlerFunction = ControllerType[method].bind(ControllerType);
+			} else if (typeof ControllerType === "function") {
+				instance = new ControllerType();
+				if (typeof instance[method] === "function") handlerFunction = instance[method].bind(instance);
+				else throw new Error(`Method "${method}" not found in controller instance "${ControllerType.name}"`);
+			} else throw new Error(`Invalid controller type for route: ${route.path}`);
+		} else throw new Error(`Invalid handler format for route: ${route.path}`);
+		return {
+			handlerFunction,
+			instance
+		};
+	}
+	static bindRequestToInstance(ctx, instance, route, payload) {
+		if (!instance) return;
+		instance.ctx = ctx;
+		instance.body = payload.body;
+		instance.query = payload.query;
+		instance.params = payload.params;
+		instance.clearRequest = new ClearRequest({
+			ctx,
+			route,
+			body: instance.body,
+			query: instance.query,
+			params: instance.params
+		});
+	}
+};
+
 //#endregion
 exports.ClearRequest = ClearRequest;
 exports.Controller = Controller;
+exports.CoreRouter = CoreRouter;
 exports.Route = Route;