@afterxleep/doc-bot 1.9.1 → 1.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afterxleep/doc-bot",
-  "version": "1.9.1",
+  "version": "1.13.0",
   "description": "Generic MCP server for intelligent documentation access in any project",
   "type": "module",
   "main": "src/index.js",
@@ -12,7 +12,7 @@
     "start:watch": "node bin/doc-bot.js --verbose --watch",
     "start:examples": "node bin/doc-bot.js --docs ./samples --verbose",
     "dev": "node bin/doc-bot.js --verbose --watch",
-    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
     "lint": "eslint src/ bin/ --ext .js",
@@ -45,17 +45,18 @@
     "chokidar": "^3.5.3",
     "fs-extra": "^11.0.0",
     "glob": "^10.3.0",
-    "yaml": "^2.3.0"
+    "yaml": "^2.3.0",
+    "better-sqlite3": "^11.10.0",
+    "axios": "^1.6.0",
+    "tar": "^7.4.0",
+    "adm-zip": "^0.5.16",
+    "plist": "^3.1.0"
   },
   "devDependencies": {
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
     "supertest": "^6.3.0"
   },
-  "jest": {
-    "testEnvironment": "node",
-    "transform": {}
-  },
   "engines": {
     "node": ">=18.0.0"
   },

package/src/__tests__/docset-integration.test.js

@@ -0,0 +1,146 @@
+import { DocsServer } from '../index.js';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import os from 'os';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+describe('DocsServer Docset Integration', () => {
+  let server;
+  let tempDocsPath;
+  let tempDocsetsPath;
+
+  beforeEach(async () => {
+    // Create temporary directories
+    tempDocsPath = path.join(__dirname, 'temp-docs-' + Date.now());
+    tempDocsetsPath = path.join(__dirname, 'temp-docsets-' + Date.now());
+    
+    await fs.ensureDir(tempDocsPath);
+    await fs.ensureDir(tempDocsetsPath);
+    
+    // Create a simple test doc
+    await fs.writeFile(
+      path.join(tempDocsPath, 'test.md'),
+      '---\nalwaysApply: true\ntitle: Test Doc\n---\n# Test'
+    );
+  });
+
+  afterEach(async () => {
+    if (server) {
+      await server.close();
+    }
+    await fs.remove(tempDocsPath);
+    await fs.remove(tempDocsetsPath);
+  });
+
+  describe('Server initialization with docsets', () => {
+    it('should initialize with custom docsets path', async () => {
+      server = new DocsServer({
+        docsPath: tempDocsPath,
+        docsetsPath: tempDocsetsPath,
+        verbose: false
+      });
+
+      await server.start();
+      
+      expect(server.docsetService).toBeDefined();
+      expect(server.docsetService.storagePath).toBe(tempDocsetsPath);
+    });
+
+    it('should use default docsets path when not provided', async () => {
+      server = new DocsServer({
+        docsPath: tempDocsPath,
+        verbose: false
+      });
+
+      await server.start();
+      
+      const expectedPath = path.join(os.homedir(), 'Developer', 'DocSets');
+      expect(server.docsetService.storagePath).toBe(expectedPath);
+    });
+  });
+
+  describe('Docset service functionality', () => {
+    beforeEach(async () => {
+      server = new DocsServer({
+        docsPath: tempDocsPath,
+        docsetsPath: tempDocsetsPath,
+        verbose: false
+      });
+      await server.start();
+    });
+
+    it('should have docset service initialized', () => {
+      expect(server.docsetService).toBeDefined();
+      expect(server.multiDocsetDatabase).toBeDefined();
+    });
+
+    it('should have empty docsets initially', async () => {
+      const docsets = await server.docsetService.listDocsets();
+      expect(docsets).toEqual([]);
+    });
+
+    it('should handle docset operations', async () => {
+      // Create a mock docset
+      const mockDocsetPath = path.join(tempDocsetsPath, 'Mock.docset');
+      const contentsPath = path.join(mockDocsetPath, 'Contents');
+      const resourcesPath = path.join(contentsPath, 'Resources');
+      
+      await fs.ensureDir(resourcesPath);
+      
+      // Create Info.plist
+      const infoPlist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>`;
+      await fs.writeFile(path.join(contentsPath, 'Info.plist'), infoPlist);
+      
+      // Create SQLite database
+      const Database = (await import('better-sqlite3')).default;
+      const dbPath = path.join(resourcesPath, 'docSet.dsidx');
+      const db = new Database(dbPath);
+      db.exec(`
+        CREATE TABLE searchIndex(
+          id INTEGER PRIMARY KEY,
+          name TEXT,
+          type TEXT,
+          path TEXT
+        );
+      `);
+      db.prepare('INSERT INTO searchIndex (name, type, path) VALUES (?, ?, ?)')
+        .run('TestClass', 'Class', 'test.html');
+      db.close();
+      
+      // Test adding docset
+      const docsetInfo = await server.docsetService.addDocset(mockDocsetPath);
+      expect(docsetInfo.name).toBe('Mock Documentation');
+      
+      // Test listing docsets
+      const docsets = await server.docsetService.listDocsets();
+      expect(docsets).toHaveLength(1);
+      expect(docsets[0].name).toBe('Mock Documentation');
+      
+      // Add to database for searching
+      server.multiDocsetDatabase.addDocset(docsetInfo);
+      
+      // Test searching
+      const searchResults = server.multiDocsetDatabase.search('Test');
+      expect(searchResults).toHaveLength(1);
+      expect(searchResults[0].name).toBe('TestClass');
+      
+      // Test removing docset
+      await server.docsetService.removeDocset(docsetInfo.id);
+      const finalDocsets = await server.docsetService.listDocsets();
+      expect(finalDocsets).toHaveLength(0);
+    });
+  });
+});

package/src/__tests__/temp-docs-1752689978225/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1752689978235/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1752689978241/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1752689978243/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1752689978244/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docsets-1752689978244/7e2cbc65/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1752689978244/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1752689978244/docsets.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id": "7e2cbc65",
+    "name": "Mock Documentation",
+    "source": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1752689978244/Mock.docset",
+    "path": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1752689978244/7e2cbc65/Mock.docset",
+    "downloadedAt": "2025-07-16T18:19:38.250Z",
+    "size": 8513
+  }
+]