api-logger-mongodb 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 rick001
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,353 @@
+# api-logger-mongodb
+
+A comprehensive API logging middleware for Node.js applications (Express, NestJS, etc.) that logs requests and responses to MongoDB for auditing and debugging.
+
+## Features
+-  Logs API URL, method, request/response data, status, user info, timestamps, and duration
+-  Mask sensitive fields (e.g., password, token)
+-  Configurable via options (MongoDB URI, collection, etc.)
+-  Express middleware support
+-  NestJS middleware support
+-  TypeScript support
+-  Filter by routes, methods, status codes
+-  Custom user info extraction
+-  Response body logging (configurable)
+
+## Package exports
+
+| Export | Description |
+|--------|-------------|
+| `apiLoggerExpress(options)` | Express middleware factory |
+| `createApiLoggerMiddleware(options)` | NestJS-compatible middleware factory (use with `app.use()` or `MiddlewareConsumer`) |
+| `createApiLoggerModule(options)` | NestJS module factory (options only) |
+| `StandaloneApiLogger` | Class for logging outbound HTTP requests (e.g. axios) |
+| `createAxiosLogger(logger, getUserInfo?)` | Axios request/response/error interceptor factory for `StandaloneApiLogger` |
+| `ApiLogger` | Core logger class (used by middleware and standalone) |
+| `validateLoggerOptions(options)` | Validates options; throws if invalid (e.g. missing `mongoUri`) |
+| `DEFAULT_MASK_FIELDS` | Built-in list of field names that are masked when `maskFields` is not set |
+| `ApiLoggerNestMiddleware`, `ApiLoggerModule` | Legacy aliases for NestJS middleware/module factories |
+
+Types: `ApiLoggerOptions`, `ApiLogEntry`, `ApiLoggerInstance` (and others from `./types`).
+
+## Installation
+
+Requires **Node.js >= 16**. Install from npm (when published) or from GitHub:
+
+```bash
+npm install api-logger-mongodb
+```
+
+Or from GitHub:
+
+```bash
+npm install git+https://github.com/rick001/api-logger-mongodb.git
+```
+
+## Examples
+
+Runnable examples are in the [**example/**](./example) folder (in the repo only; not included in the npm package). They show the three ways to use the package:
+
+| Example | Description |
+|--------|-------------|
+| [**express**](./example/express) | **Express middleware** – log incoming API requests/responses |
+| [**nestjs**](./example/nestjs) | **NestJS middleware** – same in a Nest app (via `app.use()` or `MiddlewareConsumer`) |
+| [**standalone**](./example/standalone) | **Standalone Axios** – log outbound HTTP requests; no server needed |
+
+**Prerequisites:** Build the package from repo root (`npm run build`) and have MongoDB running (e.g. `mongodb://localhost:27017`) or set `MONGO_URI`.
+
+**How to run (from repo root):**
+
+```bash
+# 1. Build the package once
+npm run build
+
+# 2a. Express – no extra install
+node example/express/server.js
+
+# 2b. NestJS – install deps and run from example folder
+cd example/nestjs && npm install && npm run build && npm start
+
+# 2c. Standalone Axios – install deps and run from example folder
+cd example/standalone && npm install && npm start
+```
+
+- **Express** and **NestJS** log **incoming** requests to your server.
+- **Standalone** logs **outbound** requests made by your app (e.g. axios to external APIs).
+
+Full details and sample requests: [example/README.md](./example/README.md) and each subfolder's README.
+
+## Quick Start
+
+### Express.js
+```ts
+import express from 'express';
+import { apiLoggerExpress } from 'api-logger-mongodb';
+
+const app = express();
+
+app.use(express.json());
+app.use(apiLoggerExpress({
+  mongoUri: 'mongodb://localhost:27017',
+  databaseName: 'my_logs',
+  collectionName: 'api_audit',
+  maskFields: ['password', 'token'],
+  logResponseBody: true,
+  logRequestBody: true,
+  getUserInfo: req => req.user ? { id: req.user.id, email: req.user.email } : undefined
+}));
+
+// ... your routes
+app.get('/api/users', (req, res) => {
+  res.json({ users: [] });
+});
+
+app.listen(3000);
+```
+
+### NestJS
+
+Apply via `MiddlewareConsumer` (below) or with `app.use(createApiLoggerMiddleware(options))` in your `bootstrap()` (see [example/nestjs](./example/nestjs)).
+
+```ts
+import { Module, NestModule, MiddlewareConsumer } from '@nestjs/common';
+import { createApiLoggerMiddleware } from 'api-logger-mongodb';
+
+@Module({
+  // ... your modules
+})
+export class AppModule implements NestModule {
+  configure(consumer: MiddlewareConsumer) {
+    consumer
+      .apply(createApiLoggerMiddleware({
+        mongoUri: 'mongodb://localhost:27017',
+        databaseName: 'my_nestjs_logs',
+        collectionName: 'api_audit',
+        maskFields: ['password', 'token'],
+        logResponseBody: true,
+        logRequestBody: true,
+        getUserInfo: (req) => {
+          const user = (req as any).user;
+          return user
+            ? {
+                id: user.id,
+                email: user.email,
+                role: user.role,
+              }
+            : undefined;
+        }
+      }))
+      .forRoutes('*'); // Apply to all routes
+  }
+}
+```
+
+### Standalone (Axios, Fetch, etc.)
+```ts
+import axios from 'axios';
+import { StandaloneApiLogger, createAxiosLogger } from 'api-logger-mongodb';
+
+// Create logger instance
+const logger = new StandaloneApiLogger({
+  mongoUri: 'mongodb://localhost:27017',
+  databaseName: 'my_logs',
+  collectionName: 'api_audit',
+  maskFields: ['password', 'token'],
+  logResponseBody: true,
+  logRequestBody: true
+});
+
+// Initialize logger
+await logger.init();
+
+// Create axios interceptor for automatic logging
+const axiosLogger = createAxiosLogger(logger, () => ({
+  id: 'user123',
+  email: 'user@example.com'
+}));
+
+// Add interceptors to axios
+axios.interceptors.request.use(axiosLogger.request);
+axios.interceptors.response.use(axiosLogger.response, axiosLogger.error);
+
+// Now all axios calls will be automatically logged
+const response = await axios.get('https://api.example.com/users');
+const postResponse = await axios.post('https://api.example.com/users', {
+  name: 'John',
+  email: 'john@example.com'
+});
+
+// Manual logging (for fetch or other HTTP clients)
+await logger.logRequest(
+  'https://api.example.com/users',
+  'GET',
+  {
+    headers: { 'Authorization': 'Bearer token' },
+    query: { page: 1 }
+  },
+  {
+    statusCode: 200,
+    body: { users: [] }
+  },
+  { id: 'user123', email: 'user@example.com' },
+  150 // duration in ms
+);
+
+// Close connection when done
+await logger.close();
+```
+
+## Advanced Usage Examples
+
+### Express - Filter by Routes and Methods
+```ts
+app.use(apiLoggerExpress({
+  mongoUri: 'mongodb://localhost:27017',
+  databaseName: 'my_logs',
+  collectionName: 'api_audit',
+  maskFields: ['password', 'token'],
+  // Only log specific routes
+  includeRoutes: [/^\/api\/users/, /^\/api\/orders/],
+  // Exclude health check routes
+  excludeRoutes: [/^\/health/, /^\/metrics/],
+  // Only log POST, PUT, DELETE methods
+  includeMethods: ['POST', 'PUT', 'DELETE'],
+  // Only log errors (status >= 400)
+  logErrorsOnly: true
+}));
+```
+
+### NestJS - Apply to Specific Routes
+```ts
+import { RequestMethod } from '@nestjs/common';
+
+configure(consumer: MiddlewareConsumer) {
+  consumer
+    .apply(createApiLoggerMiddleware({
+      mongoUri: 'mongodb://localhost:27017',
+      databaseName: 'my_nestjs_logs',
+      collectionName: 'api_audit',
+      maskFields: ['password', 'token'],
+      logResponseBody: true,
+      logRequestBody: true
+    }))
+    .forRoutes(
+      { path: 'api/users', method: RequestMethod.ALL },
+      { path: 'api/orders', method: RequestMethod.ALL },
+      { path: 'api/products', method: RequestMethod.ALL }
+    );
+}
+```
+
+### Custom User Info Extraction
+```ts
+getUserInfo: (req) => {
+  // Extract from JWT payload
+  const user = (req as any).user || (req as any).payload;
+  return user ? {
+    id: user.id || user.sub,
+    email: user.email,
+    role: user.role,
+    tenant: user.tenant
+  } : {
+    type: 'anonymous',
+    ip: req.ip
+  };
+}
+```
+
+## Production considerations
+
+- **Secure default masking:** If you do not set `maskFields`, the logger uses a built-in list of sensitive field names (e.g. `password`, `token`, `authorization`). You can import `DEFAULT_MASK_FIELDS` from the package to inspect or extend it. Pass your own `maskFields` to override.
+- **Fail-open behavior:** If MongoDB connection or middleware initialization fails, the middleware logs the error and calls `next()` so your app keeps running. Requests are not logged until the connection succeeds.
+- **Standalone logging:** `StandaloneApiLogger` and `createAxiosLogger` use the same masking, filtering (`includeRoutes`, `excludeRoutes`, `logErrorsOnly`, etc.), and `transformLog` as the Express/NestJS middleware. Outbound requests are logged through the same pipeline.
+- **Config validation:** Options are validated at construction. Invalid `mongoUri` (missing or blank) throws. You can call `validateLoggerOptions(options)` before creating the logger to fail fast.
+- **Index creation:** If creating indexes on the log collection fails (e.g. permissions), the logger continues without them and logs a warning. Connection and logging still work.
+
+- **Using with a separate WAF:** This package only logs requests; it does not block them. To audit WAF decisions, run your WAF middleware first, then this logger. You can attach WAF outcome to each log entry via `getUserInfo` or `transformLog` (e.g. read from `req` or `res.locals` and add a `waf` field to the entry).
+
+## Options
+| Option            | Type            | Description |
+|-------------------|----------------|-------------|
+| mongoUri          | string         | MongoDB connection URI (required) |
+| databaseName      | string         | Database name (default: `api_logs`) |
+| collectionName    | string         | Collection name (default: `api_requests`) |
+| maskFields        | string[]       | Fields to mask in logs (default: built-in list; see `DEFAULT_MASK_FIELDS`) |
+| logResponseBody   | boolean        | Log response body (default: true) |
+| logRequestBody    | boolean        | Log request body (default: true) |
+| logHeaders        | boolean        | Log headers (default: true) |
+| logQuery          | boolean        | Log query params (default: true) |
+| logParams         | boolean        | Log URL params (default: true) |
+| getUserInfo       | function       | Extract user info from request |
+| includeRoutes     | RegExp[]       | Only log matching routes |
+| excludeRoutes     | RegExp[]       | Exclude matching routes |
+| includeMethods    | string[]       | Only log these HTTP methods |
+| excludeMethods    | string[]       | Exclude these HTTP methods |
+| minStatusCode     | number         | Minimum status code to log |
+| maxStatusCode     | number         | Maximum status code to log |
+| logErrorsOnly     | boolean        | Only log errors (status >= 400) |
+| shouldLog         | function       | Custom function to decide logging |
+| transformLog      | function       | Transform log entry before saving |
+| shouldLogEntry    | function       | For standalone: custom function to decide if a prebuilt entry is logged |
+
+You can also use the exported `validateLoggerOptions(options)` and `DEFAULT_MASK_FIELDS` from the package.
+
+## Log Schema Example
+```json
+{
+  "url": "/api/users",
+  "method": "POST",
+  "request": {
+    "headers": {},
+    "body": {},
+    "query": {},
+    "params": {}
+  },
+  "response": {
+    "statusCode": 200,
+    "body": {}
+  },
+  "user": {
+    "id": "1234",
+    "email": "user@example.com"
+  },
+  "createdAt": "2025-07-01T10:00:00Z",
+  "durationMs": 145,
+  "ip": "127.0.0.1",
+  "userAgent": "Mozilla/5.0 ..."
+}
+```
+
+## Querying Logs
+
+You can query your MongoDB collection to analyze API usage:
+
+```javascript
+// Find all failed requests
+db.api_audit.find({ "response.statusCode": { $gte: 400 } })
+
+// Find slow requests (>1 second)
+db.api_audit.find({ durationMs: { $gt: 1000 } })
+
+// Find requests by user
+db.api_audit.find({ "user.id": "1234" })
+
+// Find requests in the last hour
+db.api_audit.find({ 
+  createdAt: { $gte: new Date(Date.now() - 60*60*1000) } 
+})
+
+// Find requests by endpoint
+db.api_audit.find({ url: /\/api\/users/ })
+
+// Find requests by method
+db.api_audit.find({ method: "POST" })
+
+// Aggregate by endpoint usage
+db.api_audit.aggregate([
+  { $group: { _id: "$url", count: { $sum: 1 } } },
+  { $sort: { count: -1 } }
+])
+```
+
+## License
+MIT 

package/dist/core/logger.d.ts

@@ -0,0 +1,58 @@
+import { Db, Collection } from 'mongodb';
+import { Request, Response } from 'express';
+import { ApiLogEntry, ApiLoggerOptions, ApiLoggerInstance } from '../types';
+/**
+ * Core API Logger class
+ */
+export declare class ApiLogger implements ApiLoggerInstance {
+    private client;
+    private db;
+    private collection;
+    private options;
+    constructor(options: ApiLoggerOptions);
+    /**
+     * Initialize MongoDB connection
+     */
+    init(): Promise<void>;
+    /**
+     * Log API request and response
+     */
+    log(req: Request, res: Response, startTime: number): Promise<void>;
+    /**
+     * Log a prebuilt entry (used by StandaloneApiLogger). Applies masking, filtering, and transformLog.
+     */
+    logEntry(entry: ApiLogEntry): Promise<void>;
+    /**
+     * Close MongoDB connection
+     */
+    close(): Promise<void>;
+    /**
+     * Mask headers
+     */
+    private maskHeaders;
+    /**
+     * Mask request body
+     */
+    private maskBody;
+    /**
+     * Mask query parameters
+     */
+    private maskQuery;
+    /**
+     * Mask URL parameters
+     */
+    private maskParams;
+    /**
+     * Get response body (if available)
+     */
+    private getResponseBody;
+    /**
+     * Get MongoDB collection for direct access
+     */
+    getCollection(): Collection | null;
+    /**
+     * Get database instance for direct access
+     */
+    getDatabase(): Db | null;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,EAAE,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAK5E;;GAEG;AACH,qBAAa,SAAU,YAAW,iBAAiB;IACjD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,OAAO,CAAmB;gBAEtB,OAAO,EAAE,gBAAgB;IA0BrC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CxE;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BjD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAMhB;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,aAAa,IAAI,UAAU,GAAG,IAAI;IAIlC;;OAEG;IACH,WAAW,IAAI,EAAE,GAAG,IAAI;CAGzB"}

package/dist/core/logger.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiLogger = void 0;
+const mongodb_1 = require("mongodb");
+const mask_1 = require("../utils/mask");
+const filter_1 = require("../utils/filter");
+const validate_1 = require("../utils/validate");
+/**
+ * Core API Logger class
+ */
+class ApiLogger {
+    constructor(options) {
+        this.client = null;
+        this.db = null;
+        this.collection = null;
+        (0, validate_1.validateLoggerOptions)(options);
+        this.options = {
+            mongoUri: options.mongoUri,
+            databaseName: options.databaseName || 'api_logs',
+            collectionName: options.collectionName || 'api_requests',
+            maskFields: options.maskFields ?? [...mask_1.DEFAULT_MASK_FIELDS],
+            logResponseBody: options.logResponseBody !== false,
+            logRequestBody: options.logRequestBody !== false,
+            logHeaders: options.logHeaders !== false,
+            logQuery: options.logQuery !== false,
+            logParams: options.logParams !== false,
+            getUserInfo: options.getUserInfo || (() => undefined),
+            includeRoutes: options.includeRoutes || [],
+            excludeRoutes: options.excludeRoutes || [],
+            includeMethods: options.includeMethods || [],
+            excludeMethods: options.excludeMethods || [],
+            minStatusCode: options.minStatusCode ?? 0,
+            maxStatusCode: options.maxStatusCode ?? 999,
+            logErrorsOnly: options.logErrorsOnly || false,
+            shouldLog: options.shouldLog || (() => true),
+            transformLog: options.transformLog || ((entry) => entry),
+            ...(options.shouldLogEntry !== undefined ? { shouldLogEntry: options.shouldLogEntry } : {})
+        };
+    }
+    /**
+     * Initialize MongoDB connection
+     */
+    async init() {
+        try {
+            this.client = new mongodb_1.MongoClient(this.options.mongoUri);
+            await this.client.connect();
+            this.db = this.client.db(this.options.databaseName);
+            this.collection = this.db.collection(this.options.collectionName);
+            try {
+                await this.collection.createIndex({ createdAt: -1 });
+                await this.collection.createIndex({ url: 1 });
+                await this.collection.createIndex({ method: 1 });
+                await this.collection.createIndex({ 'user.id': 1 });
+                await this.collection.createIndex({ 'response.statusCode': 1 });
+            }
+            catch (indexError) {
+                console.warn('API Logger: index creation failed (continuing without indexes):', indexError);
+            }
+            console.log(`API Logger connected to MongoDB: ${this.options.databaseName}.${this.options.collectionName}`);
+        }
+        catch (error) {
+            console.error('Failed to initialize API Logger:', error);
+            throw error;
+        }
+    }
+    /**
+     * Log API request and response
+     */
+    async log(req, res, startTime) {
+        try {
+            // Check if request should be logged
+            if (this.options.shouldLog && !this.options.shouldLog(req, res)) {
+                return;
+            }
+            if (!(0, filter_1.shouldLogRequest)(req, res, this.options)) {
+                return;
+            }
+            const endTime = Date.now();
+            const durationMs = endTime - startTime;
+            // Create log entry
+            const logEntry = {
+                url: req.originalUrl || req.url,
+                method: req.method,
+                request: {
+                    headers: this.options.logHeaders ? this.maskHeaders(req.headers) : {},
+                    body: this.options.logRequestBody ? this.maskBody(req.body) : {},
+                    query: this.options.logQuery ? this.maskQuery(req.query) : {},
+                    params: this.options.logParams ? this.maskParams(req.params) : {}
+                },
+                response: {
+                    statusCode: res.statusCode,
+                    body: this.options.logResponseBody ? this.getResponseBody(res) : undefined
+                },
+                user: this.options.getUserInfo ? (0, filter_1.extractUserInfo)(req, this.options.getUserInfo) : undefined,
+                createdAt: new Date(),
+                durationMs,
+                ip: (0, filter_1.getClientIP)(req) || undefined,
+                userAgent: (0, filter_1.getUserAgent)(req) || undefined
+            };
+            // Apply custom transformation if provided
+            const finalEntry = this.options.transformLog ? this.options.transformLog(logEntry) : logEntry;
+            // Save to MongoDB
+            if (this.collection) {
+                await this.collection.insertOne(finalEntry);
+            }
+        }
+        catch (error) {
+            console.error('Failed to log API request:', error);
+            // Don't throw error to avoid breaking the application
+        }
+    }
+    /**
+     * Log a prebuilt entry (used by StandaloneApiLogger). Applies masking, filtering, and transformLog.
+     */
+    async logEntry(entry) {
+        try {
+            const maskedEntry = {
+                ...entry,
+                method: entry.method.toUpperCase(),
+                request: {
+                    headers: this.options.logHeaders ? this.maskHeaders(entry.request?.headers ?? {}) : {},
+                    body: this.options.logRequestBody ? this.maskBody(entry.request?.body) : {},
+                    query: this.options.logQuery ? this.maskQuery(entry.request?.query ?? {}) : {},
+                    params: this.options.logParams ? this.maskParams(entry.request?.params ?? {}) : {}
+                },
+                response: {
+                    statusCode: entry.response.statusCode,
+                    body: this.options.logResponseBody && entry.response.body !== undefined
+                        ? (0, mask_1.maskResponseData)(entry.response.body, this.options.maskFields ?? [])
+                        : undefined
+                }
+            };
+            if (!(0, filter_1.shouldLogEntry)(maskedEntry, this.options)) {
+                return;
+            }
+            const finalEntry = this.options.transformLog ? this.options.transformLog(maskedEntry) : maskedEntry;
+            if (this.collection) {
+                await this.collection.insertOne(finalEntry);
+            }
+        }
+        catch (error) {
+            console.error('Failed to log API entry:', error);
+        }
+    }
+    /**
+     * Close MongoDB connection
+     */
+    async close() {
+        if (this.client) {
+            await this.client.close();
+            this.client = null;
+            this.db = null;
+            this.collection = null;
+        }
+    }
+    /**
+     * Mask headers
+     */
+    maskHeaders(headers) {
+        if (!this.options.logHeaders)
+            return {};
+        const maskedHeaders = (0, mask_1.maskRequestData)({ headers }, this.options.maskFields || []);
+        return maskedHeaders.headers || {};
+    }
+    /**
+     * Mask request body
+     */
+    maskBody(body) {
+        if (!this.options.logRequestBody)
+            return {};
+        return (0, mask_1.maskRequestData)({ body }, this.options.maskFields || []).body || {};
+    }
+    /**
+     * Mask query parameters
+     */
+    maskQuery(query) {
+        if (!this.options.logQuery)
+            return {};
+        const maskedQuery = (0, mask_1.maskRequestData)({ query }, this.options.maskFields || []);
+        return maskedQuery.query || {};
+    }
+    /**
+     * Mask URL parameters
+     */
+    maskParams(params) {
+        if (!this.options.logParams)
+            return {};
+        const maskedParams = (0, mask_1.maskRequestData)({ params }, this.options.maskFields || []);
+        return maskedParams.params || {};
+    }
+    /**
+     * Get response body (if available)
+     */
+    getResponseBody(res) {
+        if (!this.options.logResponseBody)
+            return undefined;
+        // Try to get response body from common patterns
+        const responseBody = res.body || res.data || res.payload;
+        if (responseBody) {
+            return (0, mask_1.maskResponseData)(responseBody, this.options.maskFields || []);
+        }
+        return undefined;
+    }
+    /**
+     * Get MongoDB collection for direct access
+     */
+    getCollection() {
+        return this.collection;
+    }
+    /**
+     * Get database instance for direct access
+     */
+    getDatabase() {
+        return this.db;
+    }
+}
+exports.ApiLogger = ApiLogger;
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { apiLoggerExpress } from './middleware/express';
+export { ApiLogger } from './core/logger';
+export * from './types';
+export { createApiLoggerMiddleware, createApiLoggerModule, ApiLoggerNestMiddleware, ApiLoggerModule } from './middleware/nestjs';
+export { StandaloneApiLogger, createAxiosLogger } from './utils/standalone';
+export { validateLoggerOptions } from './utils/validate';
+export { DEFAULT_MASK_FIELDS } from './utils/mask';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}