@b9g/router 0.2.1 → 0.2.2

package/README.md

@@ -279,7 +279,10 @@ type TrailingSlashMode = "strip" | "add"
 Standard middleware is available from `@b9g/router/middleware`:
 
 ```typescript
-import {cors, trailingSlash} from '@b9g/router/middleware';
+import {cors, logger, trailingSlash} from '@b9g/router/middleware';
+
+// Request logging
+router.use(logger());
 
 // CORS middleware
 router.use(cors({
@@ -293,6 +296,21 @@ router.use(trailingSlash("strip")); // /path/ → /path
 
 ### Available Middleware
 
+#### `logger(options?: LoggerOptions)`
+
+Logs incoming requests and outgoing responses with timing information via [LogTape](https://github.com/dahlia/logtape).
+
+```
+→ GET /
+← 200 GET / (3ms)
+```
+
+```typescript
+interface LoggerOptions {
+  category?: string[];  // Default: ["app", "router"]
+}
+```
+
 #### `cors(options?: CORSOptions)`
 
 Handles Cross-Origin Resource Sharing headers and preflight requests.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b9g/router",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Universal request router built on web standards with generator-based middleware.",
   "keywords": [
     "router",
@@ -19,7 +19,8 @@
   },
   "dependencies": {
     "@b9g/http-errors": "^0.2.1",
-    "@b9g/match-pattern": "^0.2.1"
+    "@b9g/match-pattern": "^0.2.1",
+    "@logtape/logtape": "^1.2.0"
   },
   "devDependencies": {
     "@b9g/libuild": "^0.1.18"

package/src/middleware.d.ts

@@ -98,4 +98,39 @@ export interface CORSOptions {
  * }));
  * ```
  */
+/**
+ * Logger configuration options
+ */
+export interface LoggerOptions {
+    /**
+     * LogTape category for the logger
+     * @default ["app", "router"]
+     */
+    category?: string[];
+}
+/**
+ * Request logging middleware
+ *
+ * Logs incoming requests and outgoing responses with timing information.
+ * Uses LogTape via the specified category (default: ["app", "router"]).
+ *
+ * Output format:
+ * ```
+ * → GET /
+ * ← 200 GET / (3ms)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import {Router} from "@b9g/router";
+ * import {logger} from "@b9g/router/middleware";
+ *
+ * const router = new Router();
+ * router.use(logger());
+ *
+ * // Custom category
+ * router.use(logger({ category: ["app", "http"] }));
+ * ```
+ */
+export declare function logger(options?: LoggerOptions): (request: Request) => AsyncGenerator<Request, Response | undefined, Response>;
 export declare function cors(options?: CORSOptions): (request: Request, _context: any) => AsyncGenerator<Request, Response | undefined, Response>;

package/src/middleware.js

@@ -1,5 +1,6 @@
 /// <reference types="./middleware.d.ts" />
 // src/middleware.ts
+import { getLogger } from "@logtape/logtape";
 function trailingSlash(mode) {
   return (req) => {
     const url = new URL(req.url);
@@ -39,6 +40,21 @@ function getAllowedOrigin(config, requestOrigin) {
   }
   return null;
 }
+function logger(options = {}) {
+  const { category = ["app", "router"] } = options;
+  const log = getLogger(category);
+  return async function* (request) {
+    const url = new URL(request.url);
+    const method = request.method;
+    const pathname = url.pathname;
+    log.info`→ ${method} ${pathname}`;
+    const start = Date.now();
+    const response = yield request;
+    const duration = Date.now() - start;
+    log.info`← ${response.status} ${method} ${pathname} (${duration}ms)`;
+    return response;
+  };
+}
 function cors(options = {}) {
   const {
     origin = "*",
@@ -104,5 +120,6 @@ function cors(options = {}) {
 }
 export {
   cors,
+  logger,
   trailingSlash
 };