Feat logging (#29)

* feat(logger): add logging feature

* feat(logger): Add pino logger and support worker threads for file writing using esbuil dbundler

* feat(logger): add logfile formatting like pino-pretty but within logstream (not stdio)

* feat(logger): resolve tests

* chore(config): update jest confgi for coverage

Author: walmsles

.gitignore

@@ -3,7 +3,7 @@
 # misc
 .DS_Store
 *.log*
-.amazon_q
+.vscode
 
 # dependencies
 **/.yarn/*

esbuild.config.js

@@ -0,0 +1,32 @@
+const { build } = require('esbuild');
+const esbuildPluginPino = require('esbuild-plugin-pino');
+
+async function runBuild() {
+  try {
+    await build({
+      entryPoints: ['src/index.ts'],
+      bundle: true,
+      platform: 'node',
+      target: 'node18',
+      outdir: 'dist',
+      sourcemap: true,
+      minify: true,
+      banner: {
+        js: '#!/usr/bin/env node',
+      },
+      plugins: [
+        esbuildPluginPino({
+          transports: [] // No transports needed, we're using direct file output
+        }),
+      ],
+      // We're bundling everything for a standalone executable
+      external: [],
+    });
+    console.log('Build completed successfully!');
+  } catch (error) {
+    console.error('Build failed:', error);
+    process.exit(1);
+  }
+}
+
+runBuild();

jest.config.js

@@ -11,6 +11,15 @@ module.exports = {
     ],
   },
   collectCoverage: true,
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.spec.ts',
+    '!src/**/*.d.ts',
+    '!src/types.d.ts',
+    '!src/**/index.ts',
+  ],
+  coverageReporters: ['text', 'lcov', 'clover', 'json'],
+  coverageDirectory: 'coverage',
   coverageThreshold: {
     global: {
       branches: 25,

package.json

@@ -2,9 +2,9 @@
   "name": "@serverless-dna/powertools-mcp",
   "version": "0.6.0",
   "description": "Powertools for AWS Lambda Documentation MCP Server",
-  "main": "dist/bundle.js",
+  "main": "dist/index.js",
   "bin": {
-    "powertools-mcp": "dist/bundle.js"
+    "powertools-mcp": "dist/index.js"
   },
   "files": [
     "dist/",
@@ -25,15 +25,16 @@
   "homepage": "https://github.com/serverless-dna/powertools-mcp#readme",
   "scripts": {
     "prebuild": "rimraf dist/* && pnpm lint",
-    "build": "rollup -c",
-    "postbuild": "chmod +x dist/bundle.js",
+    "build": "node esbuild.config.js",
+    "postbuild": "chmod +x dist/index.js",
     "test": "jest",
     "lint": "eslint --config eslint.config.mjs",
-    "test:ci": "jest --ci",
+    "test:ci": "jest --ci --coverage",
     "lint:fix": "eslint --fix --config eslint.config.mjs",
     "postversion": "pnpm build",
     "release": "semantic-release",
-    "mcp:local": "pnpm build && npx -y @modelcontextprotocol/inspector node dist/bundle.js"
+    "release:dry-run": "semantic-release --dry-run",
+    "mcp:local": "pnpm build && npx -y @modelcontextprotocol/inspector node dist/index.js"
   },
   "keywords": [
     "aws",
@@ -58,18 +59,17 @@
     "lunr": "^2.3.9",
     "lunr-languages": "^1.14.0",
     "make-fetch-happen": "^14.0.3",
+    "pino": "^9.6.0",
+    "pino-pretty": "^13.0.0",
     "turndown": "^7.2.0",
     "zod": "^3.24.3",
     "zod-to-json-schema": "^3.24.5"
   },
   "devDependencies": {
     "@eslint/js": "^9.25.0",
-    "@rollup/plugin-commonjs": "^28.0.3",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^12.1.2",
+    "@jest/globals": "^29.7.0",
     "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^11.0.1",
     "@types/jest": "^29.5.14",
     "@types/lunr": "^2.3.7",
@@ -78,6 +78,8 @@
     "@types/turndown": "^5.0.5",
     "@typescript-eslint/eslint-plugin": "^8.30.1",
     "@typescript-eslint/parser": "^8.30.1",
+    "esbuild": "^0.25.4",
+    "esbuild-plugin-pino": "^2.2.2",
     "eslint": "^9.25.0",
     "eslint-config-prettier": "^10.1.2",
     "eslint-import-resolver-typescript": "^4.3.3",
@@ -91,7 +93,6 @@
     "jest": "^29.7.0",
     "prettier": "^3.5.3",
     "rimraf": "^6.0.1",
-    "rollup": "^4.40.0",
     "semantic-release": "^24.2.3",
     "ts-jest": "^29.3.2",
     "typescript": "^5.8.3"