hono 4.13.9 → 4.13.11

package/dist/cjs/middleware/timeout/index.js

@@ -1,47 +1,42 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var timeout_exports = {};
-__export(timeout_exports, {
-  timeout: () => timeout
-});
-module.exports = __toCommonJS(timeout_exports);
-var import_http_exception = require("../../http-exception");
-const defaultTimeoutException = new import_http_exception.HTTPException(504, {
-  message: "Gateway Timeout"
-});
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/middleware/timeout/index.ts
+const defaultTimeoutException = new (require("../../http-exception.js")).HTTPException(504, { message: "Gateway Timeout" });
+/**
+* Timeout Middleware for Hono.
+*
+* @param {number} duration - The timeout duration in milliseconds.
+* @param {HTTPExceptionFunction | HTTPException} [exception=defaultTimeoutException] - The exception to throw when the timeout occurs. Can be a function that returns an HTTPException or an HTTPException object.
+* @returns {MiddlewareHandler} The middleware handler function.
+*
+* @example
+* ```ts
+* const app = new Hono()
+*
+* app.use(
+*   '/long-request',
+*   timeout(5000) // Set timeout to 5 seconds
+* )
+*
+* app.get('/long-request', async (c) => {
+*   await someLongRunningFunction()
+*   return c.text('Completed within time limit')
+* })
+* ```
+*/
 const timeout = (duration, exception = defaultTimeoutException) => {
-  return async function timeout2(context, next) {
-    let timer;
-    const timeoutPromise = new Promise((_, reject) => {
-      timer = setTimeout(() => {
-        reject(typeof exception === "function" ? exception(context) : exception);
-      }, duration);
-    });
-    try {
-      await Promise.race([next(), timeoutPromise]);
-    } finally {
-      if (timer !== void 0) {
-        clearTimeout(timer);
-      }
-    }
-  };
+	return async function timeout(context, next) {
+		let timer;
+		const timeoutPromise = new Promise((_, reject) => {
+			timer = setTimeout(() => {
+				reject(typeof exception === "function" ? exception(context) : exception);
+			}, duration);
+		});
+		try {
+			await Promise.race([next(), timeoutPromise]);
+		} finally {
+			if (timer !== void 0) clearTimeout(timer);
+		}
+	};
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  timeout
-});
+//#endregion
+exports.timeout = timeout;

package/dist/cjs/middleware/timing/index.js

@@ -1,35 +1,7 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var timing_exports = {};
-__export(timing_exports, {
-  endTime: () => import_timing.endTime,
-  setMetric: () => import_timing.setMetric,
-  startTime: () => import_timing.startTime,
-  timing: () => import_timing.timing,
-  wrapTime: () => import_timing.wrapTime
-});
-module.exports = __toCommonJS(timing_exports);
-var import_timing = require("./timing");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  endTime,
-  setMetric,
-  startTime,
-  timing,
-  wrapTime
-});
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_middleware_timing_timing = require("./timing.js");
+exports.endTime = require_middleware_timing_timing.endTime;
+exports.setMetric = require_middleware_timing_timing.setMetric;
+exports.startTime = require_middleware_timing_timing.startTime;
+exports.timing = require_middleware_timing_timing.timing;
+exports.wrapTime = require_middleware_timing_timing.wrapTime;

package/dist/cjs/middleware/timing/timing.js

@@ -1,130 +1,189 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var timing_exports = {};
-__export(timing_exports, {
-  endTime: () => endTime,
-  setMetric: () => setMetric,
-  startTime: () => startTime,
-  timing: () => timing,
-  wrapTime: () => wrapTime
-});
-module.exports = __toCommonJS(timing_exports);
-var import_context = require("../../context");
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/middleware/timing/timing.ts
 const getTime = () => {
-  try {
-    return performance.now();
-  } catch {
-  }
-  return Date.now();
+	try {
+		return performance.now();
+	} catch {}
+	return Date.now();
 };
+/**
+* Server-Timing Middleware for Hono.
+*
+* @see {@link https://hono.dev/docs/middleware/builtin/timing}
+*
+* @param {TimingOptions} [config] - The options for the timing middleware.
+* @param {boolean} [config.total=true] - Show the total response time.
+* @param {boolean | ((c: Context) => boolean)} [config.enabled=true] - Whether timings should be added to the headers or not.
+* @param {string} [config.totalDescription=Total Response Time] - Description for the total response time.
+* @param {boolean} [config.autoEnd=true] - If `startTime()` should end automatically at the end of the request.
+* @param {boolean | string | ((c: Context) => boolean | string)} [config.crossOrigin=false] - The origin this timings header should be readable.
+* @returns {MiddlewareHandler} The middleware handler function.
+*
+* @example
+* ```ts
+* const app = new Hono()
+*
+* // add the middleware to your router
+* app.use(timing());
+*
+* app.get('/', async (c) => {
+*   // add custom metrics
+*   setMetric(c, 'region', 'europe-west3')
+*
+*   // add custom metrics with timing, must be in milliseconds
+*   setMetric(c, 'custom', 23.8, 'My custom Metric')
+*
+*   // start a new timer
+*   startTime(c, 'db');
+*
+*   const data = await db.findMany(...);
+*
+*   // end the timer
+*   endTime(c, 'db');
+*
+*   return c.json({ response: data });
+* });
+* ```
+*/
 const timing = (config) => {
-  const options = {
-    total: true,
-    enabled: true,
-    totalDescription: "Total Response Time",
-    autoEnd: true,
-    crossOrigin: false,
-    ...config
-  };
-  return async function timing2(c, next) {
-    const headers = [];
-    const timers = /* @__PURE__ */ new Map();
-    if (c.get("metric")) {
-      return await next();
-    }
-    c.set("metric", { headers, timers });
-    if (options.total) {
-      startTime(c, "total", options.totalDescription);
-    }
-    await next();
-    if (options.total) {
-      endTime(c, "total");
-    }
-    if (options.autoEnd) {
-      timers.forEach((_, key) => {
-        endTime(c, key);
-      });
-    }
-    const enabled = typeof options.enabled === "function" ? options.enabled(c) : options.enabled;
-    if (enabled) {
-      c.res.headers.append("Server-Timing", headers.join(","));
-      const crossOrigin = typeof options.crossOrigin === "function" ? options.crossOrigin(c) : options.crossOrigin;
-      if (crossOrigin) {
-        c.res.headers.append(
-          "Timing-Allow-Origin",
-          typeof crossOrigin === "string" ? crossOrigin : "*"
-        );
-      }
-    }
-  };
+	const options = {
+		total: true,
+		enabled: true,
+		totalDescription: "Total Response Time",
+		autoEnd: true,
+		crossOrigin: false,
+		...config
+	};
+	return async function timing(c, next) {
+		const headers = [];
+		const timers = /* @__PURE__ */ new Map();
+		if (c.get("metric")) return await next();
+		c.set("metric", {
+			headers,
+			timers
+		});
+		if (options.total) startTime(c, "total", options.totalDescription);
+		await next();
+		if (options.total) endTime(c, "total");
+		if (options.autoEnd) timers.forEach((_, key) => {
+			endTime(c, key);
+		});
+		if (typeof options.enabled === "function" ? options.enabled(c) : options.enabled) {
+			c.res.headers.append("Server-Timing", headers.join(","));
+			const crossOrigin = typeof options.crossOrigin === "function" ? options.crossOrigin(c) : options.crossOrigin;
+			if (crossOrigin) c.res.headers.append("Timing-Allow-Origin", typeof crossOrigin === "string" ? crossOrigin : "*");
+		}
+	};
 };
+/**
+* Set a metric for the timing middleware.
+*
+* @param {Context} c - The context of the request.
+* @param {string} name - The name of the metric.
+* @param {number | string} [valueDescription] - The value or description of the metric.
+* @param {string} [description] - The description of the metric.
+* @param {number} [precision] - The precision of the metric value.
+*
+* @example
+* ```ts
+* setMetric(c, 'region', 'europe-west3')
+* setMetric(c, 'custom', 23.8, 'My custom Metric')
+* ```
+*/
 const setMetric = (c, name, valueDescription, description, precision) => {
-  const metrics = c.get("metric");
-  if (!metrics) {
-    console.warn("Metrics not initialized! Please add the `timing()` middleware to this route!");
-    return;
-  }
-  if (typeof valueDescription === "number") {
-    const dur = valueDescription.toFixed(precision || 1);
-    const metric = description ? `${name};dur=${dur};desc="${description}"` : `${name};dur=${dur}`;
-    metrics.headers.push(metric);
-  } else {
-    const metric = valueDescription ? `${name};desc="${valueDescription}"` : `${name}`;
-    metrics.headers.push(metric);
-  }
+	const metrics = c.get("metric");
+	if (!metrics) {
+		console.warn("Metrics not initialized! Please add the `timing()` middleware to this route!");
+		return;
+	}
+	if (typeof valueDescription === "number") {
+		const dur = valueDescription.toFixed(precision || 1);
+		const metric = description ? `${name};dur=${dur};desc="${description}"` : `${name};dur=${dur}`;
+		metrics.headers.push(metric);
+	} else {
+		const metric = valueDescription ? `${name};desc="${valueDescription}"` : `${name}`;
+		metrics.headers.push(metric);
+	}
 };
+/**
+* Start a timer for the timing middleware.
+*
+* @param {Context} c - The context of the request.
+* @param {string} name - The name of the timer.
+* @param {string} [description] - The description of the timer.
+*
+* @example
+* ```ts
+* startTime(c, 'db')
+* ```
+*/
 const startTime = (c, name, description) => {
-  const metrics = c.get("metric");
-  if (!metrics) {
-    console.warn("Metrics not initialized! Please add the `timing()` middleware to this route!");
-    return;
-  }
-  metrics.timers.set(name, { description, start: getTime() });
+	const metrics = c.get("metric");
+	if (!metrics) {
+		console.warn("Metrics not initialized! Please add the `timing()` middleware to this route!");
+		return;
+	}
+	metrics.timers.set(name, {
+		description,
+		start: getTime()
+	});
 };
+/**
+* End a timer for the timing middleware.
+*
+* @param {Context} c - The context of the request.
+* @param {string} name - The name of the timer.
+* @param {number} [precision] - The precision of the timer value.
+*
+* @example
+* ```ts
+* endTime(c, 'db')
+* ```
+*/
 const endTime = (c, name, precision) => {
-  const metrics = c.get("metric");
-  if (!metrics) {
-    console.warn("Metrics not initialized! Please add the `timing()` middleware to this route!");
-    return;
-  }
-  const timer = metrics.timers.get(name);
-  if (!timer) {
-    console.warn(`Timer "${name}" does not exist!`);
-    return;
-  }
-  const { description, start } = timer;
-  const duration = getTime() - start;
-  setMetric(c, name, duration, description, precision);
-  metrics.timers.delete(name);
+	const metrics = c.get("metric");
+	if (!metrics) {
+		console.warn("Metrics not initialized! Please add the `timing()` middleware to this route!");
+		return;
+	}
+	const timer = metrics.timers.get(name);
+	if (!timer) {
+		console.warn(`Timer "${name}" does not exist!`);
+		return;
+	}
+	const { description, start } = timer;
+	const duration = getTime() - start;
+	setMetric(c, name, duration, description, precision);
+	metrics.timers.delete(name);
 };
+/**
+* Wrap a Promise to capture its duration.
+* @param {Context} c - The context of the request.
+* @param {string} name - The name of the timer.
+* @param {Promise<T>} callable - The Promise to time.
+* @param {string} [description] - The description of the timer.
+* @param {number} [precision] - The precision of the timer value.
+*
+* @example
+* ```ts
+*   // Instead of this:
+*   const data = await db.findMany(...);
+*
+*   // do this:
+*   const data = await wrapTime(c, 'query', db.findMany(...));
+* ```
+* */
 async function wrapTime(c, name, callable, description, precision) {
-  startTime(c, name, description);
-  try {
-    return await callable;
-  } finally {
-    endTime(c, name, precision);
-  }
+	startTime(c, name, description);
+	try {
+		return await callable;
+	} finally {
+		endTime(c, name, precision);
+	}
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  endTime,
-  setMetric,
-  startTime,
-  timing,
-  wrapTime
-});
+//#endregion
+exports.endTime = endTime;
+exports.setMetric = setMetric;
+exports.startTime = startTime;
+exports.timing = timing;
+exports.wrapTime = wrapTime;

package/dist/cjs/middleware/trailing-slash/index.js

@@ -1,62 +1,89 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var trailing_slash_exports = {};
-__export(trailing_slash_exports, {
-  appendTrailingSlash: () => appendTrailingSlash,
-  trimTrailingSlash: () => trimTrailingSlash
-});
-module.exports = __toCommonJS(trailing_slash_exports);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/middleware/trailing-slash/index.ts
+/**
+* Trailing Slash Middleware for Hono.
+*
+* @see {@link https://hono.dev/docs/middleware/builtin/trailing-slash}
+*
+* @param {TrimTrailingSlashOptions} options - The options for the middleware.
+* @returns {MiddlewareHandler} The middleware handler function.
+*
+* @example
+* ```ts
+* const app = new Hono()
+*
+* app.use(trimTrailingSlash())
+* app.get('/about/me/', (c) => c.text('With Trailing Slash'))
+* ```
+*
+* @example
+* ```ts
+* // With alwaysRedirect option for wildcard routes
+* const app = new Hono()
+*
+* app.use(trimTrailingSlash({ alwaysRedirect: true }))
+* app.get('/my-path/*', (c) => c.text('Wildcard route'))
+* ```
+*/
 const trimTrailingSlash = (options) => {
-  return async function trimTrailingSlash2(c, next) {
-    if (options?.alwaysRedirect) {
-      if ((c.req.method === "GET" || c.req.method === "HEAD") && c.req.path !== "/" && c.req.path.at(-1) === "/") {
-        const url = new URL(c.req.url);
-        url.pathname = url.pathname.substring(0, url.pathname.length - 1);
-        return c.redirect(url.toString(), 301);
-      }
-    }
-    await next();
-    if (!options?.alwaysRedirect && c.res.status === 404 && (c.req.method === "GET" || c.req.method === "HEAD") && c.req.path !== "/" && c.req.path.at(-1) === "/") {
-      const url = new URL(c.req.url);
-      url.pathname = url.pathname.substring(0, url.pathname.length - 1);
-      c.res = c.redirect(url.toString(), 301);
-    }
-  };
+	return async function trimTrailingSlash(c, next) {
+		if (options?.alwaysRedirect) {
+			if ((c.req.method === "GET" || c.req.method === "HEAD") && c.req.path !== "/" && c.req.path.at(-1) === "/") {
+				const url = new URL(c.req.url);
+				url.pathname = url.pathname.substring(0, url.pathname.length - 1);
+				return c.redirect(url.toString(), 301);
+			}
+		}
+		await next();
+		if (!options?.alwaysRedirect && c.res.status === 404 && (c.req.method === "GET" || c.req.method === "HEAD") && c.req.path !== "/" && c.req.path.at(-1) === "/") {
+			const url = new URL(c.req.url);
+			url.pathname = url.pathname.substring(0, url.pathname.length - 1);
+			c.res = c.redirect(url.toString(), 301);
+		}
+	};
 };
+/**
+* Append trailing slash middleware for Hono.
+* Append a trailing slash to the URL if it doesn't have one. For example, `/path/to/page` will be redirected to `/path/to/page/`.
+*
+* @see {@link https://hono.dev/docs/middleware/builtin/trailing-slash}
+*
+* @param {AppendTrailingSlashOptions} options - The options for the middleware.
+* @returns {MiddlewareHandler} The middleware handler function.
+*
+* @example
+* ```ts
+* const app = new Hono()
+*
+* app.use(appendTrailingSlash())
+* ```
+*
+* @example
+* ```ts
+* // With alwaysRedirect option for wildcard routes
+* const app = new Hono()
+*
+* app.use(appendTrailingSlash({ alwaysRedirect: true }))
+* app.get('/my-path/*', (c) => c.text('Wildcard route'))
+* ```
+*/
 const appendTrailingSlash = (options) => {
-  return async function appendTrailingSlash2(c, next) {
-    if (options?.alwaysRedirect) {
-      if ((c.req.method === "GET" || c.req.method === "HEAD") && c.req.path.at(-1) !== "/" && !options.skip?.(c.req.path)) {
-        const url = new URL(c.req.url);
-        url.pathname += "/";
-        return c.redirect(url.toString(), 301);
-      }
-    }
-    await next();
-    if (!options?.alwaysRedirect && c.res.status === 404 && (c.req.method === "GET" || c.req.method === "HEAD") && c.req.path.at(-1) !== "/" && !options?.skip?.(c.req.path)) {
-      const url = new URL(c.req.url);
-      url.pathname += "/";
-      c.res = c.redirect(url.toString(), 301);
-    }
-  };
+	return async function appendTrailingSlash(c, next) {
+		if (options?.alwaysRedirect) {
+			if ((c.req.method === "GET" || c.req.method === "HEAD") && c.req.path.at(-1) !== "/" && !options.skip?.(c.req.path)) {
+				const url = new URL(c.req.url);
+				url.pathname += "/";
+				return c.redirect(url.toString(), 301);
+			}
+		}
+		await next();
+		if (!options?.alwaysRedirect && c.res.status === 404 && (c.req.method === "GET" || c.req.method === "HEAD") && c.req.path.at(-1) !== "/" && !options?.skip?.(c.req.path)) {
+			const url = new URL(c.req.url);
+			url.pathname += "/";
+			c.res = c.redirect(url.toString(), 301);
+		}
+	};
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  appendTrailingSlash,
-  trimTrailingSlash
-});
+//#endregion
+exports.appendTrailingSlash = appendTrailingSlash;
+exports.trimTrailingSlash = trimTrailingSlash;

package/dist/cjs/preset/quick.js

@@ -1,38 +1,19 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_hono_base = require("../hono-base.js");
+const require_router_smart_router_router = require("../router/smart-router/router.js");
+const require_router_trie_router_router = require("../router/trie-router/router.js");
+require("../router/trie-router/index.js");
+const require_router_linear_router_router = require("../router/linear-router/router.js");
+//#region src/preset/quick.ts
+/**
+* @module
+* The preset that uses `LinearRouter`.
+*/
+var Hono = class extends require_hono_base.HonoBase {
+	constructor(options = {}) {
+		super(options);
+		this.router = new require_router_smart_router_router.SmartRouter({ routers: [new require_router_linear_router_router.LinearRouter(), new require_router_trie_router_router.TrieRouter()] });
+	}
 };
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var quick_exports = {};
-__export(quick_exports, {
-  Hono: () => Hono
-});
-module.exports = __toCommonJS(quick_exports);
-var import_hono_base = require("../hono-base");
-var import_linear_router = require("../router/linear-router");
-var import_smart_router = require("../router/smart-router");
-var import_trie_router = require("../router/trie-router");
-class Hono extends import_hono_base.HonoBase {
-  constructor(options = {}) {
-    super(options);
-    this.router = new import_smart_router.SmartRouter({
-      routers: [new import_linear_router.LinearRouter(), new import_trie_router.TrieRouter()]
-    });
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Hono
-});
+//#endregion
+exports.Hono = Hono;