@get-technology-inc/jamf-docs-mcp-server 0.0.1 → 1.0.0

package/dist/services/cache.js

@@ -0,0 +1,189 @@
+/**
+ * Caching service for Jamf documentation
+ *
+ * Provides file-based caching with TTL support
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { CACHE_TTL, CACHE_DIR } from '../constants.js';
+/**
+ * File-based cache implementation
+ */
+class FileCache {
+    cacheDir;
+    memoryCache = new Map();
+    constructor(cacheDir = CACHE_DIR) {
+        this.cacheDir = cacheDir;
+    }
+    /**
+     * Generate a cache key hash
+     */
+    getCacheKey(key) {
+        return crypto.createHash('md5').update(key).digest('hex');
+    }
+    /**
+     * Get the file path for a cache key
+     */
+    getCachePath(key) {
+        return path.join(this.cacheDir, `${this.getCacheKey(key)}.json`);
+    }
+    /**
+     * Ensure cache directory exists
+     */
+    async ensureCacheDir() {
+        try {
+            await fs.mkdir(this.cacheDir, { recursive: true });
+        }
+        catch {
+            // Directory may already exist
+        }
+    }
+    /**
+     * Get a value from cache
+     */
+    async get(key) {
+        // Check memory cache first
+        const memCached = this.memoryCache.get(key);
+        if (memCached) {
+            if (Date.now() - memCached.timestamp < memCached.ttl) {
+                return memCached.data;
+            }
+            // Expired, remove from memory
+            this.memoryCache.delete(key);
+        }
+        // Check file cache
+        try {
+            const cachePath = this.getCachePath(key);
+            const content = await fs.readFile(cachePath, 'utf-8');
+            const entry = JSON.parse(content);
+            // Check if expired
+            if (Date.now() - entry.timestamp > entry.ttl) {
+                await this.delete(key);
+                return null;
+            }
+            // Store in memory cache for faster access
+            this.memoryCache.set(key, entry);
+            return entry.data;
+        }
+        catch {
+            // File doesn't exist or is invalid
+            return null;
+        }
+    }
+    /**
+     * Set a value in cache
+     */
+    async set(key, data, ttl = CACHE_TTL.ARTICLE_CONTENT) {
+        await this.ensureCacheDir();
+        const entry = {
+            data,
+            timestamp: Date.now(),
+            ttl
+        };
+        // Store in memory
+        this.memoryCache.set(key, entry);
+        // Store in file
+        try {
+            const cachePath = this.getCachePath(key);
+            await fs.writeFile(cachePath, JSON.stringify(entry), 'utf-8');
+        }
+        catch (error) {
+            // Log but don't fail
+            console.error(`[CACHE] Failed to write cache: ${error}`);
+        }
+    }
+    /**
+     * Delete a cache entry
+     */
+    async delete(key) {
+        // Remove from memory
+        this.memoryCache.delete(key);
+        // Remove file
+        try {
+            await fs.unlink(this.getCachePath(key));
+        }
+        catch {
+            // File may not exist
+        }
+    }
+    /**
+     * Clear all cache entries
+     */
+    async clear() {
+        // Clear memory
+        this.memoryCache.clear();
+        // Clear files
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            await Promise.all(files
+                .filter(f => f.endsWith('.json'))
+                .map(f => fs.unlink(path.join(this.cacheDir, f))));
+        }
+        catch {
+            // Directory may not exist
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    async stats() {
+        let fileEntries = 0;
+        let totalSize = 0;
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            const jsonFiles = files.filter(f => f.endsWith('.json'));
+            fileEntries = jsonFiles.length;
+            for (const file of jsonFiles) {
+                const stat = await fs.stat(path.join(this.cacheDir, file));
+                totalSize += stat.size;
+            }
+        }
+        catch {
+            // Directory may not exist
+        }
+        return {
+            memoryEntries: this.memoryCache.size,
+            fileEntries,
+            totalSize
+        };
+    }
+    /**
+     * Prune expired entries
+     */
+    async prune() {
+        let pruned = 0;
+        // Prune memory cache
+        for (const [key, entry] of this.memoryCache.entries()) {
+            if (Date.now() - entry.timestamp > entry.ttl) {
+                this.memoryCache.delete(key);
+                pruned++;
+            }
+        }
+        // Prune file cache
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            for (const file of files.filter(f => f.endsWith('.json'))) {
+                try {
+                    const filePath = path.join(this.cacheDir, file);
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    const entry = JSON.parse(content);
+                    if (Date.now() - entry.timestamp > entry.ttl) {
+                        await fs.unlink(filePath);
+                        pruned++;
+                    }
+                }
+                catch {
+                    // Skip invalid files
+                }
+            }
+        }
+        catch {
+            // Directory may not exist
+        }
+        return pruned;
+    }
+}
+// Export singleton instance
+export const cache = new FileCache();
+//# sourceMappingURL=cache.js.map

package/dist/services/cache.js.map

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

package/dist/services/scraper.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Web scraping service for Jamf documentation
+ *
+ * This module handles fetching and parsing HTML from learn.jamf.com
+ * (Jamf documentation has moved from docs.jamf.com to learn.jamf.com)
+ */
+import { type ProductId } from '../constants.js';
+import { type SearchResult, type ParsedArticle, type TocEntry, type SearchParams, type TokenInfo, type PaginationInfo, type ArticleSection } from '../types.js';
+/**
+ * Search response with token and pagination info
+ */
+export interface SearchDocumentationResult {
+    results: SearchResult[];
+    pagination: PaginationInfo;
+    tokenInfo: TokenInfo;
+}
+/**
+ * Search Jamf documentation using Zoomin Search API
+ */
+export declare function searchDocumentation(params: SearchParams): Promise<SearchDocumentationResult>;
+/**
+ * Options for fetching articles
+ */
+export interface FetchArticleOptions {
+    includeRelated?: boolean;
+    section?: string;
+    maxTokens?: number;
+}
+/**
+ * Article result with token and section info
+ */
+export interface FetchArticleResult extends ParsedArticle {
+    tokenInfo: TokenInfo;
+    sections: ArticleSection[];
+}
+/**
+ * Fetch and parse a documentation article
+ * Uses backend URL (learn-be.jamf.com) for pre-rendered content
+ */
+export declare function fetchArticle(url: string, options?: FetchArticleOptions): Promise<FetchArticleResult>;
+/**
+ * Options for fetching table of contents
+ */
+export interface FetchTocOptions {
+    page?: number;
+    maxTokens?: number;
+}
+/**
+ * TOC result with pagination and token info
+ */
+export interface FetchTocResult {
+    toc: TocEntry[];
+    pagination: PaginationInfo;
+    tokenInfo: TokenInfo;
+}
+/**
+ * Fetch table of contents for a product
+ * Uses backend TOC endpoint (learn-be.jamf.com/bundle/{bundleId}/toc)
+ */
+export declare function fetchTableOfContents(product: ProductId, _version: string, // Version is not used for learn.jamf.com (always current)
+options?: FetchTocOptions): Promise<FetchTocResult>;
+//# sourceMappingURL=scraper.d.ts.map

package/dist/services/scraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scraper.d.ts","sourceRoot":"","sources":["../../src/services/scraper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAUL,KAAK,SAAS,EAEf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAwRrB;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA+IlG;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAwF7B;AAiFD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,EAAE,SAAS,CAAC;CACtB;AA6BD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,MAAM,EAAG,0DAA0D;AAC7E,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA2FzB"}