api-logger-mongodb 1.0.0

package/dist/utils/standalone.d.ts

@@ -0,0 +1,45 @@
+import { ApiLogger } from '../core/logger';
+import { ApiLoggerOptions } from '../types';
+/**
+ * Standalone API Logger for use with axios or any HTTP client
+ */
+export declare class StandaloneApiLogger {
+    private logger;
+    private initialized;
+    private initPromise;
+    constructor(options: ApiLoggerOptions);
+    /**
+     * Initialize MongoDB connection (single-flight, concurrent-safe).
+     */
+    init(): Promise<void>;
+    /**
+     * Log an HTTP request and response
+     */
+    logRequest(url: string, method: string, requestData: {
+        headers?: Record<string, string>;
+        body?: any;
+        query?: Record<string, any>;
+        params?: Record<string, any>;
+    }, responseData: {
+        statusCode: number;
+        body?: any;
+        headers?: Record<string, string>;
+    }, userInfo?: any, durationMs?: number): Promise<void>;
+    /**
+     * Close MongoDB connection
+     */
+    close(): Promise<void>;
+    /**
+     * Get the underlying logger instance
+     */
+    getLogger(): ApiLogger;
+}
+/**
+ * Axios interceptor factory for automatic logging
+ */
+export declare function createAxiosLogger(logger: StandaloneApiLogger, getUserInfo?: () => any): {
+    request: (config: any) => any;
+    response: (response: any) => Promise<any>;
+    error: (error: any) => Promise<never>;
+};
+//# sourceMappingURL=standalone.d.ts.map

package/dist/utils/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../src/utils/standalone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAe,MAAM,UAAU,CAAC;AAEzD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,EAAE,gBAAgB;IAIrC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B;;OAEG;IACG,UAAU,CACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,WAAW,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC9B,EACD,YAAY,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,EACD,QAAQ,CAAC,EAAE,GAAG,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IA0BhB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,SAAS,IAAI,SAAS;CAGvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,WAAW,CAAC,EAAE,MAAM,GAAG;sBAGH,GAAG;yBAIM,GAAG;mBAuBT,GAAG;EA0B3B"}

package/dist/utils/standalone.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandaloneApiLogger = void 0;
+exports.createAxiosLogger = createAxiosLogger;
+const logger_1 = require("../core/logger");
+/**
+ * Standalone API Logger for use with axios or any HTTP client
+ */
+class StandaloneApiLogger {
+    constructor(options) {
+        this.initialized = false;
+        this.initPromise = null;
+        this.logger = new logger_1.ApiLogger(options);
+    }
+    /**
+     * Initialize MongoDB connection (single-flight, concurrent-safe).
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        if (this.initPromise) {
+            await this.initPromise;
+            return;
+        }
+        this.initPromise = this.logger.init();
+        try {
+            await this.initPromise;
+            this.initialized = true;
+        }
+        finally {
+            this.initPromise = null;
+        }
+    }
+    /**
+     * Log an HTTP request and response
+     */
+    async logRequest(url, method, requestData, responseData, userInfo, durationMs) {
+        await this.init();
+        const logEntry = {
+            url,
+            method: method.toUpperCase(),
+            request: {
+                headers: requestData.headers || {},
+                body: requestData.body || {},
+                query: requestData.query || {},
+                params: requestData.params || {}
+            },
+            response: {
+                statusCode: responseData.statusCode,
+                body: responseData.body
+            },
+            user: userInfo,
+            createdAt: new Date(),
+            durationMs: durationMs || 0,
+            ip: undefined,
+            userAgent: undefined
+        };
+        await this.logger.logEntry(logEntry);
+    }
+    /**
+     * Close MongoDB connection
+     */
+    async close() {
+        await this.logger.close();
+    }
+    /**
+     * Get the underlying logger instance
+     */
+    getLogger() {
+        return this.logger;
+    }
+}
+exports.StandaloneApiLogger = StandaloneApiLogger;
+/**
+ * Axios interceptor factory for automatic logging
+ */
+function createAxiosLogger(logger, getUserInfo) {
+    return {
+        request: (config) => {
+            config.metadata = { startTime: Date.now() };
+            return config;
+        },
+        response: async (response) => {
+            const startTime = response?.config?.metadata?.startTime ?? Date.now();
+            const durationMs = Date.now() - startTime;
+            await logger.logRequest(response.config.url, response.config.method, {
+                headers: response.config.headers,
+                body: response.config.data,
+                query: response.config.params
+            }, {
+                statusCode: response.status,
+                body: response.data,
+                headers: response.headers
+            }, getUserInfo ? getUserInfo() : undefined, durationMs);
+            return response;
+        },
+        error: async (error) => {
+            if (error.response) {
+                const startTime = error?.config?.metadata?.startTime ?? Date.now();
+                const durationMs = Date.now() - startTime;
+                await logger.logRequest(error.config.url, error.config.method, {
+                    headers: error.config.headers,
+                    body: error.config.data,
+                    query: error.config.params
+                }, {
+                    statusCode: error.response.status,
+                    body: error.response.data,
+                    headers: error.response.headers
+                }, getUserInfo ? getUserInfo() : undefined, durationMs);
+            }
+            return Promise.reject(error);
+        }
+    };
+}
+//# sourceMappingURL=standalone.js.map

package/dist/utils/standalone.js.map

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

package/dist/utils/validate.d.ts

@@ -0,0 +1,6 @@
+import { ApiLoggerOptions } from '../types';
+/**
+ * Validates API logger options at construction. Throws if invalid.
+ */
+export declare function validateLoggerOptions(options: ApiLoggerOptions): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/utils/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAarE"}

package/dist/utils/validate.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateLoggerOptions = validateLoggerOptions;
+/**
+ * Validates API logger options at construction. Throws if invalid.
+ */
+function validateLoggerOptions(options) {
+    if (!options.mongoUri || typeof options.mongoUri !== 'string') {
+        throw new Error('ApiLoggerOptions.mongoUri is required and must be a non-empty string.');
+    }
+    if (options.mongoUri.trim().length === 0) {
+        throw new Error('ApiLoggerOptions.mongoUri cannot be blank.');
+    }
+    if (options.databaseName !== undefined && (typeof options.databaseName !== 'string' || options.databaseName.trim().length === 0)) {
+        throw new Error('ApiLoggerOptions.databaseName must be a non-empty string when provided.');
+    }
+    if (options.collectionName !== undefined && (typeof options.collectionName !== 'string' || options.collectionName.trim().length === 0)) {
+        throw new Error('ApiLoggerOptions.collectionName must be a non-empty string when provided.');
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/utils/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":";;AAKA,sDAaC;AAhBD;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAAyB;IAC7D,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACjI,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,CAAC,cAAc,KAAK,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACvI,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "api-logger-mongodb",
+  "version": "1.0.0",
+  "description": "A comprehensive API logging middleware for Node.js applications that logs requests and responses to MongoDB",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "api-logger",
+    "mongodb",
+    "express",
+    "nestjs",
+    "middleware",
+    "logging",
+    "audit",
+    "request-response",
+    "typescript"
+  ],
+  "author": "Sayantan Roy",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rick001/api-logger-mongodb.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rick001/api-logger-mongodb/issues"
+  },
+  "homepage": "https://github.com/rick001/api-logger-mongodb#readme",
+  "dependencies": {
+    "mongodb": "^6.3.0"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.8",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "eslint": "^8.54.0",
+    "express": "^4.22.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.2"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}