clear-router 2.7.6 → 2.7.7

package/dist/ClearRequest.cjs

@@ -0,0 +1,23 @@
+
+//#region src/ClearRequest.ts
+var ClearRequest = class {
+	/**
+	* @param body - Parsed request body
+	*/
+	body;
+	/**
+	* @param query - Parsed query parameters
+	*/
+	query;
+	/**
+	* @param params - Parsed route parameters
+	*/
+	params;
+	route;
+	constructor(init) {
+		Object.assign(this, init);
+	}
+};
+
+//#endregion
+exports.ClearRequest = ClearRequest;

package/dist/ClearRequest.d.cts

@@ -0,0 +1,28 @@
+import { RequestData } from "./types/basic.cjs";
+import { Middleware } from "./types/express.cjs";
+import { Middleware as Middleware$1 } from "./types/fastify.cjs";
+import { Middleware as Middleware$2 } from "./types/h3.cjs";
+import { Middleware as Middleware$3 } from "./types/hono.cjs";
+import { Middleware as Middleware$4 } from "./types/koa.cjs";
+import { Route } from "./Route.cjs";
+
+//#region src/ClearRequest.d.ts
+declare class ClearRequest<X = any, M = Middleware$2 | Middleware | Middleware$1 | Middleware$3 | Middleware$4> {
+  [key: string]: any;
+  /**
+   * @param body - Parsed request body
+   */
+  body: RequestData;
+  /**
+   * @param query - Parsed query parameters
+   */
+  query: RequestData;
+  /**
+   * @param params - Parsed route parameters
+   */
+  params: RequestData;
+  route: Route<X, M>;
+  constructor(init?: Partial<ClearRequest>);
+}
+//#endregion
+export { ClearRequest };

package/dist/ClearRequest.d.mts

@@ -0,0 +1,28 @@
+import { RequestData } from "./types/basic.mjs";
+import { Middleware } from "./types/express.mjs";
+import { Middleware as Middleware$1 } from "./types/fastify.mjs";
+import { Middleware as Middleware$2 } from "./types/h3.mjs";
+import { Middleware as Middleware$3 } from "./types/hono.mjs";
+import { Middleware as Middleware$4 } from "./types/koa.mjs";
+import { Route } from "./Route.mjs";
+
+//#region src/ClearRequest.d.ts
+declare class ClearRequest<X = any, M = Middleware$2 | Middleware | Middleware$1 | Middleware$3 | Middleware$4> {
+  [key: string]: any;
+  /**
+   * @param body - Parsed request body
+   */
+  body: RequestData;
+  /**
+   * @param query - Parsed query parameters
+   */
+  query: RequestData;
+  /**
+   * @param params - Parsed route parameters
+   */
+  params: RequestData;
+  route: Route<X, M>;
+  constructor(init?: Partial<ClearRequest>);
+}
+//#endregion
+export { ClearRequest };

package/dist/ClearRequest.mjs

@@ -0,0 +1,22 @@
+//#region src/ClearRequest.ts
+var ClearRequest = class {
+	/**
+	* @param body - Parsed request body
+	*/
+	body;
+	/**
+	* @param query - Parsed query parameters
+	*/
+	query;
+	/**
+	* @param params - Parsed route parameters
+	*/
+	params;
+	route;
+	constructor(init) {
+		Object.assign(this, init);
+	}
+};
+
+//#endregion
+export { ClearRequest };

package/dist/Contracts.d.cts

@@ -0,0 +1,12 @@
+//#region src/Contracts.d.ts
+/**
+ * HTTP context passed to route handlers
+ */
+interface ClearHttpContext {}
+interface RouteParameter {
+  name: string;
+  field?: string;
+  optional: boolean;
+}
+//#endregion
+export { ClearHttpContext, RouteParameter };

package/dist/Contracts.d.mts

@@ -0,0 +1,12 @@
+//#region src/Contracts.d.ts
+/**
+ * HTTP context passed to route handlers
+ */
+interface ClearHttpContext {}
+interface RouteParameter {
+  name: string;
+  field?: string;
+  optional: boolean;
+}
+//#endregion
+export { ClearHttpContext, RouteParameter };

package/dist/Controller.cjs

@@ -0,0 +1,12 @@
+
+//#region src/Controller.ts
+var Controller = class {
+	ctx;
+	body;
+	query;
+	params;
+	clearRequest;
+};
+
+//#endregion
+exports.Controller = Controller;

package/dist/Controller.d.cts

@@ -0,0 +1,14 @@
+import { RequestData } from "./types/basic.cjs";
+import { ClearRequest } from "./ClearRequest.cjs";
+
+//#region src/Controller.d.ts
+declare abstract class Controller<X = any> {
+  [x: string]: any;
+  ctx: X;
+  body: RequestData;
+  query: RequestData;
+  params: RequestData;
+  clearRequest: ClearRequest;
+}
+//#endregion
+export { Controller };

package/dist/Controller.d.mts

@@ -0,0 +1,14 @@
+import { RequestData } from "./types/basic.mjs";
+import { ClearRequest } from "./ClearRequest.mjs";
+
+//#region src/Controller.d.ts
+declare abstract class Controller<X = any> {
+  [x: string]: any;
+  ctx: X;
+  body: RequestData;
+  query: RequestData;
+  params: RequestData;
+  clearRequest: ClearRequest;
+}
+//#endregion
+export { Controller };

package/dist/Controller.mjs

@@ -0,0 +1,11 @@
+//#region src/Controller.ts
+var Controller = class {
+	ctx;
+	body;
+	query;
+	params;
+	clearRequest;
+};
+
+//#endregion
+export { Controller };

package/dist/{Request-DKXwa_W0.d.mts → Request-BhTJDR_5.d.mts}

@@ -10,6 +10,11 @@ import { Middleware as Middleware$4 } from "./types/express.mjs";
  * HTTP context passed to route handlers
  */
 interface ClearHttpContext {}
+interface RouteParameter {
+  name: string;
+  field?: string;
+  optional: boolean;
+}
 //#endregion
 //#region src/core/Response.d.ts
 declare class Response {
@@ -35,11 +40,6 @@ declare class Response {
 }
 //#endregion
 //#region src/Route.d.ts
-interface RouteParameter {
-  name: string;
-  field?: string;
-  optional: boolean;
-}
 declare class Route<X = any, M = Middleware$1 | Middleware$4, H = any> {
   ctx: X;
   body: RequestData;

package/dist/Route.cjs

@@ -0,0 +1,58 @@
+
+//#region src/Route.ts
+var Route = class {
+	ctx;
+	body = {};
+	query = {};
+	params = {};
+	clearRequest;
+	methods;
+	path;
+	registrationPaths;
+	parameters;
+	routeName;
+	handler;
+	middlewares;
+	controllerName;
+	actionName;
+	handlerType;
+	middlewareCount;
+	constructor(methods, path, handler, middlewares = [], options = {}) {
+		this.methods = methods;
+		this.path = path;
+		this.registrationPaths = options.registrationPaths || [path];
+		this.parameters = options.parameters || [];
+		this.handler = handler;
+		this.middlewares = middlewares;
+		this.handlerType = Array.isArray(handler) ? "controller" : "function";
+		this.middlewareCount = middlewares.length;
+		this.controllerName = Array.isArray(handler) ? handler[0]?.name : void 0;
+		this.actionName = Array.isArray(handler) ? handler[1] : typeof handler === "function" ? handler.constructor.name ?? handler.name : void 0;
+		this.onName = options.onName;
+	}
+	onName;
+	name(name) {
+		const previousName = this.routeName;
+		this.routeName = name;
+		this.onName?.(name, this, previousName);
+		return this;
+	}
+	toPath(params = {}) {
+		return this.path.replace(/\/?\{([^{}]+)\}/g, (segment, raw) => {
+			const optional = raw.endsWith("?");
+			const [rawName, rawField] = (optional ? raw.slice(0, -1) : raw).split(":", 2);
+			const name = rawName.trim();
+			const field = rawField?.trim();
+			const value = params[name];
+			const resolved = field && value && typeof value === "object" ? value[field] : value;
+			if (typeof resolved === "undefined" || resolved === null || resolved === "") {
+				if (optional) return "";
+				throw new Error(`Missing required route parameter: ${name}`);
+			}
+			return `${segment.startsWith("/") ? "/" : ""}${encodeURIComponent(String(resolved))}`;
+		}) || "/";
+	}
+};
+
+//#endregion
+exports.Route = Route;

package/dist/Route.d.cts

@@ -0,0 +1,35 @@
+import { HttpMethod, RequestData } from "./types/basic.cjs";
+import { RouteParameter } from "./Contracts.cjs";
+import { Middleware } from "./types/express.cjs";
+import { Middleware as Middleware$1 } from "./types/h3.cjs";
+import { ClearRequest } from "./ClearRequest.cjs";
+
+//#region src/Route.d.ts
+declare class Route<X = any, M = Middleware$1 | Middleware, H = any> {
+  ctx: X;
+  body: RequestData;
+  query: RequestData;
+  params: RequestData;
+  clearRequest: ClearRequest;
+  methods: HttpMethod[];
+  path: string;
+  registrationPaths: string[];
+  parameters: RouteParameter[];
+  routeName?: string;
+  handler: H;
+  middlewares: M[];
+  controllerName?: string;
+  actionName?: string;
+  handlerType: 'function' | 'controller';
+  middlewareCount: number;
+  constructor(methods: HttpMethod[], path: string, handler: H, middlewares?: M[], options?: {
+    registrationPaths?: string[];
+    parameters?: RouteParameter[];
+    onName?: (name: string, route: Route<X, M, H>, previousName?: string) => void;
+  });
+  private onName?;
+  name(name: string): this;
+  toPath(params?: RequestData): string;
+}
+//#endregion
+export { Route };

package/dist/Route.d.mts

@@ -0,0 +1,35 @@
+import { HttpMethod, RequestData } from "./types/basic.mjs";
+import { RouteParameter } from "./Contracts.mjs";
+import { Middleware } from "./types/express.mjs";
+import { Middleware as Middleware$1 } from "./types/h3.mjs";
+import { ClearRequest } from "./ClearRequest.mjs";
+
+//#region src/Route.d.ts
+declare class Route<X = any, M = Middleware$1 | Middleware, H = any> {
+  ctx: X;
+  body: RequestData;
+  query: RequestData;
+  params: RequestData;
+  clearRequest: ClearRequest;
+  methods: HttpMethod[];
+  path: string;
+  registrationPaths: string[];
+  parameters: RouteParameter[];
+  routeName?: string;
+  handler: H;
+  middlewares: M[];
+  controllerName?: string;
+  actionName?: string;
+  handlerType: 'function' | 'controller';
+  middlewareCount: number;
+  constructor(methods: HttpMethod[], path: string, handler: H, middlewares?: M[], options?: {
+    registrationPaths?: string[];
+    parameters?: RouteParameter[];
+    onName?: (name: string, route: Route<X, M, H>, previousName?: string) => void;
+  });
+  private onName?;
+  name(name: string): this;
+  toPath(params?: RequestData): string;
+}
+//#endregion
+export { Route };

package/dist/Route.mjs

@@ -0,0 +1,57 @@
+//#region src/Route.ts
+var Route = class {
+	ctx;
+	body = {};
+	query = {};
+	params = {};
+	clearRequest;
+	methods;
+	path;
+	registrationPaths;
+	parameters;
+	routeName;
+	handler;
+	middlewares;
+	controllerName;
+	actionName;
+	handlerType;
+	middlewareCount;
+	constructor(methods, path, handler, middlewares = [], options = {}) {
+		this.methods = methods;
+		this.path = path;
+		this.registrationPaths = options.registrationPaths || [path];
+		this.parameters = options.parameters || [];
+		this.handler = handler;
+		this.middlewares = middlewares;
+		this.handlerType = Array.isArray(handler) ? "controller" : "function";
+		this.middlewareCount = middlewares.length;
+		this.controllerName = Array.isArray(handler) ? handler[0]?.name : void 0;
+		this.actionName = Array.isArray(handler) ? handler[1] : typeof handler === "function" ? handler.constructor.name ?? handler.name : void 0;
+		this.onName = options.onName;
+	}
+	onName;
+	name(name) {
+		const previousName = this.routeName;
+		this.routeName = name;
+		this.onName?.(name, this, previousName);
+		return this;
+	}
+	toPath(params = {}) {
+		return this.path.replace(/\/?\{([^{}]+)\}/g, (segment, raw) => {
+			const optional = raw.endsWith("?");
+			const [rawName, rawField] = (optional ? raw.slice(0, -1) : raw).split(":", 2);
+			const name = rawName.trim();
+			const field = rawField?.trim();
+			const value = params[name];
+			const resolved = field && value && typeof value === "object" ? value[field] : value;
+			if (typeof resolved === "undefined" || resolved === null || resolved === "") {
+				if (optional) return "";
+				throw new Error(`Missing required route parameter: ${name}`);
+			}
+			return `${segment.startsWith("/") ? "/" : ""}${encodeURIComponent(String(resolved))}`;
+		}) || "/";
+	}
+};
+
+//#endregion
+export { Route };

package/dist/core/Request.cjs

@@ -0,0 +1,35 @@
+const require_ClearRequest = require('../ClearRequest.cjs');
+
+//#region src/core/Request.ts
+var Request = class extends require_ClearRequest.ClearRequest {
+	original;
+	method = "GET";
+	path = "/";
+	url = "/";
+	headers = {};
+	constructor(init) {
+		super(init);
+		Object.assign(this, init);
+	}
+	getBody() {
+		return this.body ?? {};
+	}
+	header(name) {
+		if (typeof this.headers.get === "function") return this.headers.get(name) || "";
+		const headers = this.headers;
+		const value = headers[name] ?? headers[name.toLowerCase()];
+		return Array.isArray(value) ? String(value[0] ?? "") : String(value ?? "");
+	}
+	param(name) {
+		return this.params?.[name];
+	}
+	input(name) {
+		return this.body?.[name] ?? this.query?.[name] ?? this.params?.[name];
+	}
+	is(method) {
+		return this.method.toLowerCase() === String(method).toLowerCase();
+	}
+};
+
+//#endregion
+exports.Request = Request;

package/dist/core/Request.d.cts

@@ -0,0 +1,25 @@
+import { HttpMethod, RequestData } from "../types/basic.cjs";
+import { Route } from "../Route.cjs";
+import { ClearRequest } from "../ClearRequest.cjs";
+
+//#region src/core/Request.d.ts
+declare class Request<X = any, M = any> extends ClearRequest<X, M> {
+  original?: any;
+  method: string;
+  path: string;
+  url: string;
+  headers: Headers | Record<string, any>;
+  constructor(init?: Partial<Request<X, M>> & {
+    body?: RequestData;
+    query?: RequestData;
+    params?: RequestData;
+    route?: Route<X, M>;
+  });
+  getBody(): RequestData;
+  header(name: string): string;
+  param(name: string): any;
+  input(name: string): any;
+  is(method: HttpMethod | string): boolean;
+}
+//#endregion
+export { Request };

package/dist/core/Request.d.mts

@@ -0,0 +1,25 @@
+import { HttpMethod, RequestData } from "../types/basic.mjs";
+import { Route } from "../Route.mjs";
+import { ClearRequest } from "../ClearRequest.mjs";
+
+//#region src/core/Request.d.ts
+declare class Request<X = any, M = any> extends ClearRequest<X, M> {
+  original?: any;
+  method: string;
+  path: string;
+  url: string;
+  headers: Headers | Record<string, any>;
+  constructor(init?: Partial<Request<X, M>> & {
+    body?: RequestData;
+    query?: RequestData;
+    params?: RequestData;
+    route?: Route<X, M>;
+  });
+  getBody(): RequestData;
+  header(name: string): string;
+  param(name: string): any;
+  input(name: string): any;
+  is(method: HttpMethod | string): boolean;
+}
+//#endregion
+export { Request };

package/dist/core/Request.mjs

@@ -0,0 +1,35 @@
+import { ClearRequest } from "../ClearRequest.mjs";
+
+//#region src/core/Request.ts
+var Request = class extends ClearRequest {
+	original;
+	method = "GET";
+	path = "/";
+	url = "/";
+	headers = {};
+	constructor(init) {
+		super(init);
+		Object.assign(this, init);
+	}
+	getBody() {
+		return this.body ?? {};
+	}
+	header(name) {
+		if (typeof this.headers.get === "function") return this.headers.get(name) || "";
+		const headers = this.headers;
+		const value = headers[name] ?? headers[name.toLowerCase()];
+		return Array.isArray(value) ? String(value[0] ?? "") : String(value ?? "");
+	}
+	param(name) {
+		return this.params?.[name];
+	}
+	input(name) {
+		return this.body?.[name] ?? this.query?.[name] ?? this.params?.[name];
+	}
+	is(method) {
+		return this.method.toLowerCase() === String(method).toLowerCase();
+	}
+};
+
+//#endregion
+export { Request };

package/dist/core/Response.cjs

@@ -0,0 +1,59 @@
+
+//#region src/core/Response.ts
+var Response = class {
+	body;
+	headers = new Headers();
+	sent = false;
+	statusCode = 200;
+	statusText = "OK";
+	constructor(init) {
+		const { status: _, ...rest } = init ?? {};
+		Object.assign(this, rest);
+		if (init?.headers && !(init.headers instanceof Headers)) this.headers = new Headers(init.headers);
+		if (init?.status && typeof init.status === "number") this.statusCode = init?.status;
+	}
+	status(code) {
+		this.statusCode = code;
+		return this;
+	}
+	setStatusText(text) {
+		this.statusText = text;
+		return this;
+	}
+	code(code) {
+		return this.status(code);
+	}
+	setHeader(name, value) {
+		this.headers.set(name, value);
+		return this;
+	}
+	header(name, value) {
+		return this.setHeader(name, value);
+	}
+	set(name, value) {
+		return this.setHeader(name, value);
+	}
+	type(contentType) {
+		return this.setHeader("Content-Type", contentType);
+	}
+	send(body) {
+		this.body = body;
+		this.sent = true;
+		return this;
+	}
+	json(body) {
+		return this.type("application/json; charset=utf-8").send(body);
+	}
+	html(body) {
+		return this.type("text/html; charset=utf-8").send(body);
+	}
+	text(body) {
+		return this.type("text/plain; charset=utf-8").send(body);
+	}
+	noContent() {
+		return this.status(204).send(null);
+	}
+};
+
+//#endregion
+exports.Response = Response;

package/dist/core/Response.d.cts

@@ -0,0 +1,24 @@
+//#region src/core/Response.d.ts
+declare class Response {
+  [key: string]: any;
+  body: any;
+  headers: Headers;
+  sent: boolean;
+  statusCode: number;
+  statusText: string;
+  constructor(init?: Partial<Response | globalThis.Response>);
+  status(code: number): this;
+  setStatusText(text: string): this;
+  code(code: number): this;
+  setHeader(name: string, value: string): this;
+  header(name: string, value: string): this;
+  set(name: string, value: string): this;
+  type(contentType: string): this;
+  send(body?: any): this;
+  json(body: any): this;
+  html(body: string): this;
+  text(body: string): this;
+  noContent(): this;
+}
+//#endregion
+export { Response };

package/dist/core/Response.d.mts

@@ -0,0 +1,24 @@
+//#region src/core/Response.d.ts
+declare class Response {
+  [key: string]: any;
+  body: any;
+  headers: Headers;
+  sent: boolean;
+  statusCode: number;
+  statusText: string;
+  constructor(init?: Partial<Response | globalThis.Response>);
+  status(code: number): this;
+  setStatusText(text: string): this;
+  code(code: number): this;
+  setHeader(name: string, value: string): this;
+  header(name: string, value: string): this;
+  set(name: string, value: string): this;
+  type(contentType: string): this;
+  send(body?: any): this;
+  json(body: any): this;
+  html(body: string): this;
+  text(body: string): this;
+  noContent(): this;
+}
+//#endregion
+export { Response };