feat: consume md docs directly (#78)

Co-authored-by: Stefano Vozza <[email protected]>

Author: dreamorosi

package-lock.json

@@ -57,24 +57,22 @@
     "@types/cacache": "^17.0.2",
     "@types/node": "^22.14.1",
     "cacache": "^19.0.1",
-    "cheerio": "^1.0.0",
     "lunr": "^2.3.9",
     "lunr-languages": "^1.14.0",
-    "make-fetch-happen": "^14.0.3",
-    "node-html-markdown": "^1.3.0",
     "zod": "^3.25.51"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@modelcontextprotocol/inspector": "^0.13.0",
     "@types/lunr": "^2.3.7",
     "@types/make-fetch-happen": "^10.0.4",
-    "@vitest/coverage-v8": "^3.2.1",
+    "@vitest/coverage-v8": "^3.2.3",
     "changelogen": "^0.6.1",
     "husky": "^9.1.7",
     "lint-staged": "^16.1.0",
+    "msw": "^2.10.2",
     "rimraf": "^6.0.1",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.0"
+    "vitest": "^3.2.3"
   }
 }

package.json

@@ -1,39 +1,28 @@
-// Constants for cache configuration
-const FOURTEEN_DAYS_MS = 14 * 24 * 60 * 60 * 1000; // 14 days in milliseconds
-const DEFAULT_CACHE_MODE: RequestCache = 'default';
-const DEFAULT_RETRIES = 3;
-const DEFAULT_RETRY_FACTOR = 2;
-const DEFAULT_MIN_TIMEOUT = 1000; // 1 second
-const DEFAULT_MAX_TIMEOUT = 10000; // 10 seconds
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { getStringFromEnv } from '@aws-lambda-powertools/commons/utils/env';
 
-/**
- * Represents different content types for the fetch service
- */
-const ContentType = {
-  WEB_PAGE: 'web-page',
-  MARKDOWN: 'markdown',
-} as const;
+const MCP_SERVER_NAME = 'powertools-for-aws-mcp' as const;
 
 // Allowed domain for security
 const ALLOWED_DOMAIN = 'docs.powertools.aws.dev';
 // Base URL for Powertools documentation
 const POWERTOOLS_BASE_URL = 'https://docs.powertools.aws.dev/lambda';
 
-// Constants for performance tuning
 const FETCH_TIMEOUT_MS = 15000; // 15 seconds timeout for fetch operations
 
 const runtimes = ['java', 'dotnet', 'typescript', 'python'] as const;
 
+const CACHE_BASE_PATH = getStringFromEnv({
+  key: 'CACHE_BASE_PATH',
+  defaultValue: join(tmpdir(), 'powertools-mcp'),
+});
+
 export {
-  FOURTEEN_DAYS_MS,
-  DEFAULT_CACHE_MODE,
-  DEFAULT_RETRIES,
-  DEFAULT_RETRY_FACTOR,
-  DEFAULT_MIN_TIMEOUT,
-  DEFAULT_MAX_TIMEOUT,
-  ContentType,
+  MCP_SERVER_NAME,
   ALLOWED_DOMAIN,
   FETCH_TIMEOUT_MS,
   runtimes,
   POWERTOOLS_BASE_URL,
+  CACHE_BASE_PATH,
 };