cipher-logger 0.1.2 → 1.0.0

package/README.md

@@ -39,6 +39,10 @@
 - **Express middleware** — records real `status` and `duration` after the response finishes
 - **Next.js middleware** — drop-in support for `middleware.ts`
 - **Zero heavy dependencies** — only `express` or `next` as optional peer dependencies
+ - **Fastify middleware** — lightweight hook-compatible middleware for Fastify
+ - **NestJS middleware** — Express-compatible middleware for Nest apps
+ - **Hono middleware** — edge-friendly middleware for Hono apps
+ - **Zero heavy dependencies** — only framework peers are optional
 - **Node.js 18+** compatible
 
 ---
@@ -63,6 +67,15 @@ npm install express
 
 # Next.js
 npm install next
+
+# Fastify
+npm install fastify
+
+# NestJS (core packages)
+npm install @nestjs/core @nestjs/common
+
+# Hono
+npm install hono
 ```
 
 ---
@@ -222,6 +235,73 @@ export const config = {
 
 ---
 
+## Fastify
+
+Register the Fastify-compatible middleware returned by `cipher.fastify()` using `addHook`:
+
+```typescript
+import fastify from "fastify";
+import { createCipherLogger } from "cipher-logger";
+
+const app = fastify();
+
+const cipher = createCipherLogger({
+  fields: { ip: true, userAgent: true, query: true },
+  level: "info",
+});
+
+// Register before your routes
+app.addHook("onRequest", cipher.fastify());
+
+app.get("/", async () => ({ hello: "world" }));
+
+app.listen({ port: 3000 });
+```
+
+## NestJS
+
+Use the Express-compatible middleware in Nest's runtime (works when Nest is using the Express platform):
+
+```typescript
+import { NestFactory } from "@nestjs/core";
+import { AppModule } from "./app.module";
+import { createCipherLogger } from "cipher-logger";
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  const cipher = createCipherLogger({ fields: { ip: true, userAgent: true } });
+
+  // Mount as global middleware
+  app.use(cipher.nest());
+
+  await app.listen(3000);
+}
+
+bootstrap();
+```
+
+## Hono
+
+Mount the Hono middleware using `app.use` (works on edge and Node runtimes):
+
+```typescript
+import { Hono } from "hono";
+import { createCipherLogger } from "cipher-logger";
+
+const app = new Hono();
+
+const cipher = createCipherLogger({ fields: { ip: true, userAgent: true } });
+
+// Mount for all routes
+app.use("*", cipher.hono());
+
+app.get("/", (c) => c.text("ok"));
+
+app.listen({ port: 3000 });
+```
+
+
 ## Log Schema
 
 ### Required Fields
@@ -301,6 +381,9 @@ import type {
   LoggerOptions,
   ExpressMiddleware,
   NextMiddleware,
+  FastifyMiddleware,
+  NestMiddleware,
+  HonoMiddleware,
 } from "cipher-logger";
 ```
 

package/dist/index.d.mts

@@ -1,5 +1,7 @@
-import { Request, Response, NextFunction } from 'express';
+import { Request, Response as Response$1, NextFunction } from 'express';
 import { NextRequest, NextResponse } from 'next/server';
+import { FastifyRequest, FastifyReply } from 'fastify';
+import { Context } from 'hono';
 
 type LogLevel = "info" | "warn" | "error" | "debug";
 type LogMeta = Record<string, unknown>;
@@ -59,19 +61,31 @@ type CipherLoggerConfig = {
     prefix?: string;
 };
 
-type ExpressMiddleware = (req: Request, res: Response, next: NextFunction) => void;
+type ExpressMiddleware = (req: Request, res: Response$1, next: NextFunction) => void;
 declare function createExpressMiddleware(cipher: CipherLogger): ExpressMiddleware;
 
 type NextMiddleware = (request: NextRequest) => NextResponse | Promise<NextResponse>;
 declare function createNextMiddleware(cipher: CipherLogger): NextMiddleware;
 
+type FastifyMiddleware = (request: FastifyRequest, reply: FastifyReply) => void;
+declare function createFastifyMiddleware(cipher: CipherLogger): FastifyMiddleware;
+
+type NestMiddleware = (req: Request, res: Response$1, next: NextFunction) => void;
+declare function createNestMiddleware(cipher: CipherLogger): NestMiddleware;
+
+type HonoMiddleware = (c: Context, next: () => Promise<void>) => Response | Promise<Response>;
+declare function createHonoMiddleware(cipher: CipherLogger): HonoMiddleware;
+
 interface CipherLogger {
     logRequest(input: RequestLogInput): RequestLog;
     express(): ExpressMiddleware;
     next(): NextMiddleware;
+    fastify(): FastifyMiddleware;
+    nest(): NestMiddleware;
+    hono(): HonoMiddleware;
 }
 declare function createCipherLogger(config?: CipherLoggerConfig): CipherLogger;
 
 declare const logger: Logger;
 
-export { type CipherLogger, type CipherLoggerConfig, type ExpressMiddleware, type LogLevel, type LogMeta, Logger, type LoggerOptions, type NextMiddleware, type OptionalRequestField, type RequestLog, type RequestLogInput, createCipherLogger, createExpressMiddleware, createNextMiddleware, logger, type RequestLog as request };
+export { type CipherLogger, type CipherLoggerConfig, type ExpressMiddleware, type FastifyMiddleware, type HonoMiddleware, type LogLevel, type LogMeta, Logger, type LoggerOptions, type NestMiddleware, type NextMiddleware, type OptionalRequestField, type RequestLog, type RequestLogInput, createCipherLogger, createExpressMiddleware, createFastifyMiddleware, createHonoMiddleware, createNestMiddleware, createNextMiddleware, logger, type RequestLog as request };

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-import { Request, Response, NextFunction } from 'express';
+import { Request, Response as Response$1, NextFunction } from 'express';
 import { NextRequest, NextResponse } from 'next/server';
+import { FastifyRequest, FastifyReply } from 'fastify';
+import { Context } from 'hono';
 
 type LogLevel = "info" | "warn" | "error" | "debug";
 type LogMeta = Record<string, unknown>;
@@ -59,19 +61,31 @@ type CipherLoggerConfig = {
     prefix?: string;
 };
 
-type ExpressMiddleware = (req: Request, res: Response, next: NextFunction) => void;
+type ExpressMiddleware = (req: Request, res: Response$1, next: NextFunction) => void;
 declare function createExpressMiddleware(cipher: CipherLogger): ExpressMiddleware;
 
 type NextMiddleware = (request: NextRequest) => NextResponse | Promise<NextResponse>;
 declare function createNextMiddleware(cipher: CipherLogger): NextMiddleware;
 
+type FastifyMiddleware = (request: FastifyRequest, reply: FastifyReply) => void;
+declare function createFastifyMiddleware(cipher: CipherLogger): FastifyMiddleware;
+
+type NestMiddleware = (req: Request, res: Response$1, next: NextFunction) => void;
+declare function createNestMiddleware(cipher: CipherLogger): NestMiddleware;
+
+type HonoMiddleware = (c: Context, next: () => Promise<void>) => Response | Promise<Response>;
+declare function createHonoMiddleware(cipher: CipherLogger): HonoMiddleware;
+
 interface CipherLogger {
     logRequest(input: RequestLogInput): RequestLog;
     express(): ExpressMiddleware;
     next(): NextMiddleware;
+    fastify(): FastifyMiddleware;
+    nest(): NestMiddleware;
+    hono(): HonoMiddleware;
 }
 declare function createCipherLogger(config?: CipherLoggerConfig): CipherLogger;
 
 declare const logger: Logger;
 
-export { type CipherLogger, type CipherLoggerConfig, type ExpressMiddleware, type LogLevel, type LogMeta, Logger, type LoggerOptions, type NextMiddleware, type OptionalRequestField, type RequestLog, type RequestLogInput, createCipherLogger, createExpressMiddleware, createNextMiddleware, logger, type RequestLog as request };
+export { type CipherLogger, type CipherLoggerConfig, type ExpressMiddleware, type FastifyMiddleware, type HonoMiddleware, type LogLevel, type LogMeta, Logger, type LoggerOptions, type NestMiddleware, type NextMiddleware, type OptionalRequestField, type RequestLog, type RequestLogInput, createCipherLogger, createExpressMiddleware, createFastifyMiddleware, createHonoMiddleware, createNestMiddleware, createNextMiddleware, logger, type RequestLog as request };

package/dist/index.js

@@ -23,6 +23,9 @@ __export(src_exports, {
   Logger: () => Logger,
   createCipherLogger: () => createCipherLogger,
   createExpressMiddleware: () => createExpressMiddleware,
+  createFastifyMiddleware: () => createFastifyMiddleware,
+  createHonoMiddleware: () => createHonoMiddleware,
+  createNestMiddleware: () => createNestMiddleware,
   createNextMiddleware: () => createNextMiddleware,
   logger: () => logger
 });
@@ -224,6 +227,145 @@ function createNextMiddleware(cipher) {
   };
 }
 
+// src/adapters/fastify/middleware.ts
+function getHeader3(req, name) {
+  const value = req.headers[name];
+  if (value === void 0) {
+    return void 0;
+  }
+  return Array.isArray(value) ? String(value[0]) : String(value);
+}
+function parseQuery3(req) {
+  try {
+    const raw = req.raw.url ?? req.url ?? "";
+    const url = new URL(raw, "http://localhost");
+    const result = {};
+    for (const [key, value] of url.searchParams.entries()) {
+      result[key] = value;
+    }
+    return Object.keys(result).length > 0 ? result : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function createFastifyMiddleware(cipher) {
+  return (request, reply) => {
+    const start = Date.now();
+    reply.raw.once("finish", () => {
+      const protocol = request.headers["x-forwarded-proto"] || (request.raw.socket && request.raw.socket.encrypted ? "https" : "http");
+      cipher.logRequest({
+        method: request.method,
+        path: request.raw.url ?? request.url,
+        status: reply.statusCode,
+        duration: Date.now() - start,
+        ip: request.headers["x-forwarded-for"] ? request.headers["x-forwarded-for"].split(",")[0].trim() : request.ip || request.socket?.remoteAddress || request.raw.socket?.remoteAddress,
+        userAgent: getHeader3(request, "user-agent"),
+        referer: getHeader3(request, "referer"),
+        protocol,
+        host: getHeader3(request, "host"),
+        query: parseQuery3(request),
+        requestId: getHeader3(request, "x-request-id")
+      });
+    });
+  };
+}
+
+// src/adapters/nest/middleware.ts
+function parseQuery4(query) {
+  const result = {};
+  for (const [key, value] of Object.entries(query)) {
+    if (value === void 0) {
+      continue;
+    }
+    result[key] = typeof value === "string" ? value : Array.isArray(value) ? String(value[0] ?? "") : String(value);
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
+function getHeader4(req, name) {
+  const value = req.headers[name];
+  if (value === void 0) {
+    return void 0;
+  }
+  return Array.isArray(value) ? value[0] : value;
+}
+function createNestMiddleware(cipher) {
+  return (req, res, next) => {
+    const start = Date.now();
+    res.on("finish", () => {
+      cipher.logRequest({
+        method: req.method,
+        path: req.originalUrl || req.url,
+        status: res.statusCode,
+        duration: Date.now() - start,
+        ip: req.headers["x-forwarded-for"]?.split(",")[0]?.trim() || req.ip || req.socket.remoteAddress,
+        userAgent: getHeader4(req, "user-agent"),
+        referer: getHeader4(req, "referer"),
+        protocol: req.protocol,
+        host: getHeader4(req, "host"),
+        query: parseQuery4(req.query),
+        requestId: getHeader4(req, "x-request-id")
+      });
+    });
+    next();
+  };
+}
+
+// src/adapters/hono/middleware.ts
+function getHeader5(request, name) {
+  if (!request) return void 0;
+  if (typeof request.header === "function") {
+    return request.header(name) ?? void 0;
+  }
+  if (request.headers && typeof request.headers.get === "function") {
+    return request.headers.get(name) ?? void 0;
+  }
+  return void 0;
+}
+function parseQuery5(urlString) {
+  try {
+    const url = new URL(urlString);
+    const result = {};
+    for (const [key, value] of url.searchParams.entries()) {
+      result[key] = value;
+    }
+    return Object.keys(result).length > 0 ? result : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function createHonoMiddleware(cipher) {
+  return async (c, next) => {
+    const start = Date.now();
+    await next();
+    const req = c.req ?? c.request;
+    const url = typeof req?.url === "string" ? req.url : String(req?.url ?? "");
+    const parsed = new URL(url, "http://localhost");
+    let status = 200;
+    const cres = c.res ?? c.response ?? void 0;
+    if (cres && typeof cres.status === "number") {
+      status = cres.status;
+    } else if (cres && typeof cres.statusCode === "number") {
+      status = cres.statusCode;
+    }
+    const xfwd = getHeader5(req, "x-forwarded-for");
+    const ip = xfwd ? String(xfwd).split(",")[0].trim() : getHeader5(req, "x-real-ip") ?? void 0;
+    cipher.logRequest({
+      method: req?.method,
+      path: parsed.pathname + parsed.search,
+      status,
+      duration: Date.now() - start,
+      ip,
+      userAgent: getHeader5(req, "user-agent"),
+      referer: getHeader5(req, "referer"),
+      protocol: parsed.protocol.replace(":", ""),
+      host: getHeader5(req, "host"),
+      query: parseQuery5(url),
+      requestId: getHeader5(req, "x-request-id")
+    });
+    return cres ?? new Response(null, { status });
+  };
+}
+
 // src/core/create-cipher-logger.ts
 function createCipherLogger(config = {}) {
   const fields = resolveFieldConfig(config.fields);
@@ -242,6 +384,15 @@ function createCipherLogger(config = {}) {
     },
     next() {
       return createNextMiddleware(cipherLogger);
+    },
+    fastify() {
+      return createFastifyMiddleware(cipherLogger);
+    },
+    nest() {
+      return createNestMiddleware(cipherLogger);
+    },
+    hono() {
+      return createHonoMiddleware(cipherLogger);
     }
   };
   return cipherLogger;
@@ -254,6 +405,9 @@ var logger = new Logger();
   Logger,
   createCipherLogger,
   createExpressMiddleware,
+  createFastifyMiddleware,
+  createHonoMiddleware,
+  createNestMiddleware,
   createNextMiddleware,
   logger
 });

package/dist/index.mjs

@@ -194,6 +194,145 @@ function createNextMiddleware(cipher) {
   };
 }
 
+// src/adapters/fastify/middleware.ts
+function getHeader3(req, name) {
+  const value = req.headers[name];
+  if (value === void 0) {
+    return void 0;
+  }
+  return Array.isArray(value) ? String(value[0]) : String(value);
+}
+function parseQuery3(req) {
+  try {
+    const raw = req.raw.url ?? req.url ?? "";
+    const url = new URL(raw, "http://localhost");
+    const result = {};
+    for (const [key, value] of url.searchParams.entries()) {
+      result[key] = value;
+    }
+    return Object.keys(result).length > 0 ? result : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function createFastifyMiddleware(cipher) {
+  return (request, reply) => {
+    const start = Date.now();
+    reply.raw.once("finish", () => {
+      const protocol = request.headers["x-forwarded-proto"] || (request.raw.socket && request.raw.socket.encrypted ? "https" : "http");
+      cipher.logRequest({
+        method: request.method,
+        path: request.raw.url ?? request.url,
+        status: reply.statusCode,
+        duration: Date.now() - start,
+        ip: request.headers["x-forwarded-for"] ? request.headers["x-forwarded-for"].split(",")[0].trim() : request.ip || request.socket?.remoteAddress || request.raw.socket?.remoteAddress,
+        userAgent: getHeader3(request, "user-agent"),
+        referer: getHeader3(request, "referer"),
+        protocol,
+        host: getHeader3(request, "host"),
+        query: parseQuery3(request),
+        requestId: getHeader3(request, "x-request-id")
+      });
+    });
+  };
+}
+
+// src/adapters/nest/middleware.ts
+function parseQuery4(query) {
+  const result = {};
+  for (const [key, value] of Object.entries(query)) {
+    if (value === void 0) {
+      continue;
+    }
+    result[key] = typeof value === "string" ? value : Array.isArray(value) ? String(value[0] ?? "") : String(value);
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
+function getHeader4(req, name) {
+  const value = req.headers[name];
+  if (value === void 0) {
+    return void 0;
+  }
+  return Array.isArray(value) ? value[0] : value;
+}
+function createNestMiddleware(cipher) {
+  return (req, res, next) => {
+    const start = Date.now();
+    res.on("finish", () => {
+      cipher.logRequest({
+        method: req.method,
+        path: req.originalUrl || req.url,
+        status: res.statusCode,
+        duration: Date.now() - start,
+        ip: req.headers["x-forwarded-for"]?.split(",")[0]?.trim() || req.ip || req.socket.remoteAddress,
+        userAgent: getHeader4(req, "user-agent"),
+        referer: getHeader4(req, "referer"),
+        protocol: req.protocol,
+        host: getHeader4(req, "host"),
+        query: parseQuery4(req.query),
+        requestId: getHeader4(req, "x-request-id")
+      });
+    });
+    next();
+  };
+}
+
+// src/adapters/hono/middleware.ts
+function getHeader5(request, name) {
+  if (!request) return void 0;
+  if (typeof request.header === "function") {
+    return request.header(name) ?? void 0;
+  }
+  if (request.headers && typeof request.headers.get === "function") {
+    return request.headers.get(name) ?? void 0;
+  }
+  return void 0;
+}
+function parseQuery5(urlString) {
+  try {
+    const url = new URL(urlString);
+    const result = {};
+    for (const [key, value] of url.searchParams.entries()) {
+      result[key] = value;
+    }
+    return Object.keys(result).length > 0 ? result : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function createHonoMiddleware(cipher) {
+  return async (c, next) => {
+    const start = Date.now();
+    await next();
+    const req = c.req ?? c.request;
+    const url = typeof req?.url === "string" ? req.url : String(req?.url ?? "");
+    const parsed = new URL(url, "http://localhost");
+    let status = 200;
+    const cres = c.res ?? c.response ?? void 0;
+    if (cres && typeof cres.status === "number") {
+      status = cres.status;
+    } else if (cres && typeof cres.statusCode === "number") {
+      status = cres.statusCode;
+    }
+    const xfwd = getHeader5(req, "x-forwarded-for");
+    const ip = xfwd ? String(xfwd).split(",")[0].trim() : getHeader5(req, "x-real-ip") ?? void 0;
+    cipher.logRequest({
+      method: req?.method,
+      path: parsed.pathname + parsed.search,
+      status,
+      duration: Date.now() - start,
+      ip,
+      userAgent: getHeader5(req, "user-agent"),
+      referer: getHeader5(req, "referer"),
+      protocol: parsed.protocol.replace(":", ""),
+      host: getHeader5(req, "host"),
+      query: parseQuery5(url),
+      requestId: getHeader5(req, "x-request-id")
+    });
+    return cres ?? new Response(null, { status });
+  };
+}
+
 // src/core/create-cipher-logger.ts
 function createCipherLogger(config = {}) {
   const fields = resolveFieldConfig(config.fields);
@@ -212,6 +351,15 @@ function createCipherLogger(config = {}) {
     },
     next() {
       return createNextMiddleware(cipherLogger);
+    },
+    fastify() {
+      return createFastifyMiddleware(cipherLogger);
+    },
+    nest() {
+      return createNestMiddleware(cipherLogger);
+    },
+    hono() {
+      return createHonoMiddleware(cipherLogger);
     }
   };
   return cipherLogger;
@@ -223,6 +371,9 @@ export {
   Logger,
   createCipherLogger,
   createExpressMiddleware,
+  createFastifyMiddleware,
+  createHonoMiddleware,
+  createNestMiddleware,
   createNextMiddleware,
   logger
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cipher-logger",
-  "version": "0.1.2",
+  "version": "1.0.0",
   "description": "See every request. Capture every error. Understand your application.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -43,6 +43,13 @@
     "nextjs-middleware",
     "express",
     "express-logger",
+    "fastify",
+    "fastify-logger",
+    "nest",
+    "nestjs",
+    "nestjs-logger",
+    "hono",
+    "hono-logger",
     "cli",
     "dashboard",
     "cipherlogger",
@@ -54,7 +61,11 @@
   "type": "commonjs",
   "peerDependencies": {
     "express": ">=4",
-    "next": ">=13"
+    "next": ">=13",
+    "fastify": ">=4",
+    "hono": ">=1",
+    "@nestjs/common": ">=10",
+    "@nestjs/core": ">=10"
   },
   "peerDependenciesMeta": {
     "express": {
@@ -63,6 +74,19 @@
     "next": {
       "optional": true
     }
+    ,
+    "fastify": {
+      "optional": true
+    },
+    "hono": {
+      "optional": true
+    },
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/express": "^5.0.3",