@smartbear/mcp 0.2.1 → 0.3.0

package/dist/tests/unit/insight-hub/filters.test.js

@@ -0,0 +1,93 @@
+import { describe, it, expect } from 'vitest';
+import { equals, notEquals, empty, relativeTime, isoTime, toUrlSearchParams } from '../../../insight-hub/client/api/filters.js';
+describe('Filter Utilities', () => {
+    describe('equals', () => {
+        it('should create eq filter for string value', () => {
+            const result = equals('test-value');
+            expect(result).toEqual({ type: 'eq', value: 'test-value' });
+        });
+        it('should create eq filter for number value', () => {
+            const result = equals(42);
+            expect(result).toEqual({ type: 'eq', value: 42 });
+        });
+    });
+    describe('notEquals', () => {
+        it('should create ne filter for string value', () => {
+            const result = notEquals('test-value');
+            expect(result).toEqual({ type: 'ne', value: 'test-value' });
+        });
+        it('should create ne filter for number value', () => {
+            const result = notEquals(42);
+            expect(result).toEqual({ type: 'ne', value: 42 });
+        });
+    });
+    describe('empty', () => {
+        it('should create empty filter for true', () => {
+            const result = empty(true);
+            expect(result).toEqual({ type: 'empty', value: 'true' });
+        });
+        it('should create empty filter for false', () => {
+            const result = empty(false);
+            expect(result).toEqual({ type: 'empty', value: 'false' });
+        });
+    });
+    describe('relativeTime', () => {
+        it('should create relative time filter with hours', () => {
+            const result = relativeTime(24, 'h');
+            expect(result).toEqual({ type: 'eq', value: '24h' });
+        });
+        it('should create relative time filter with days', () => {
+            const result = relativeTime(7, 'd');
+            expect(result).toEqual({ type: 'eq', value: '7d' });
+        });
+    });
+    describe('isoTime', () => {
+        it('should create ISO time filter from date', () => {
+            const date = new Date('2023-01-01T12:00:00.000Z');
+            const result = isoTime(date);
+            expect(result).toEqual({ type: 'eq', value: '2023-01-01T12:00:00.000Z' });
+        });
+    });
+    describe('toUrlSearchParams', () => {
+        it('should convert simple filter object to URL params', () => {
+            const filters = {
+                'error.status': [{ type: 'eq', value: 'open' }],
+                'user.email': [{ type: 'ne', value: 'test@example.com' }]
+            };
+            const result = toUrlSearchParams(filters);
+            expect(result.get('filters[error.status][][type]')).toBe('eq');
+            expect(result.get('filters[error.status][][value]')).toBe('open');
+            expect(result.get('filters[user.email][][type]')).toBe('ne');
+            expect(result.get('filters[user.email][][value]')).toBe('test@example.com');
+        });
+        it('should handle multiple filters for same field', () => {
+            const filters = {
+                'error.status': [
+                    { type: 'eq', value: 'open' },
+                    { type: 'eq', value: 'in_progress' }
+                ]
+            };
+            const result = toUrlSearchParams(filters);
+            const allEntries = Array.from(result.entries());
+            // Should have entries for both filter values
+            const statusFilters = allEntries.filter(([key]) => key.includes('error.status'));
+            expect(statusFilters.length).toBeGreaterThan(2); // type and value for each filter
+        });
+        it('should handle empty filter object', () => {
+            const filters = {};
+            const result = toUrlSearchParams(filters);
+            expect(result.toString()).toBe('');
+        });
+        it('should handle complex filter scenarios', () => {
+            const filters = {
+                'event.since': [{ type: 'eq', value: '7d' }],
+                'error.status': [{ type: 'ne', value: 'resolved' }],
+                'user.id': [{ type: 'empty', value: 'false' }]
+            };
+            const result = toUrlSearchParams(filters);
+            expect(result.get('filters[event.since][][value]')).toBe('7d');
+            expect(result.get('filters[error.status][][value]')).toBe('resolved');
+            expect(result.get('filters[user.id][][value]')).toBe('false');
+        });
+    });
+});

package/dist/vitest.config.js

@@ -0,0 +1,57 @@
+import { defineConfig } from 'vitest/config';
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: 'node',
+        coverage: {
+            provider: 'v8',
+            reporter: ['text', 'json', 'json-summary', 'html', 'lcov'],
+            exclude: [
+                'dist/**',
+                'node_modules/**',
+                'tests/**',
+                '*.config.*',
+                '**/*.d.ts',
+                // Auto-generated API client files
+                'insight-hub/client/api/*.ts',
+                'insight-hub/client/index.ts',
+                'insight-hub/client/configuration.ts',
+                // Main entry point (tested via integration)
+                'index.ts',
+                // Other client implementations (not currently tested)
+                'api-hub/client.ts',
+                'reflect/client.ts',
+                // Utility modules
+                'common/bugsnag.ts',
+                'common/types.ts'
+            ],
+            // Coverage thresholds for business logic only
+            thresholds: {
+                lines: 75,
+                functions: 75,
+                branches: 85,
+                statements: 75,
+                // Per-file thresholds for core files
+                perFile: false
+            },
+            // Generate more detailed reports
+            reportOnFailure: true,
+            all: true,
+            // Clean coverage directory before tests
+            clean: true,
+            // Include source map support
+            reportsDirectory: './coverage'
+        },
+        // Include TypeScript files
+        include: ['tests/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+        // Setup files
+        // Placeholder for future setup files. Remove if not needed.
+        setupFiles: []
+    },
+    // Resolve imports correctly for ESM
+    resolve: {
+        alias: {
+            '@': new URL('./src', import.meta.url).pathname
+        }
+    }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartbear/mcp",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "MCP server for interacting SmartBear Products",
   "keywords": [
     "smartbear",
@@ -31,20 +31,29 @@
     "build": "tsc && shx chmod +x dist/*.js",
     "lint": "eslint . --ext .ts",
     "prepare": "npm run build",
-    "watch": "tsc --watch"
+    "watch": "tsc --watch",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest --coverage",
+    "test:coverage:ci": "vitest --coverage --reporter=verbose",
+    "test:run": "vitest run",
+    "coverage:check": "vitest --coverage --reporter=verbose --config vitest.config.coverage.ts"
   },
   "dependencies": {
     "@bugsnag/js": "^8.2.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
-    "node-cache": "^5.1.2"
+    "node-cache": "^5.1.2",
+    "zod": "^3"
   },
   "devDependencies": {
     "@eslint/js": "^9.29.0",
     "@types/node": "^22",
+    "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^9.29.0",
     "globals": "^16.2.0",
     "shx": "^0.3.4",
     "typescript": "^5.6.2",
-    "typescript-eslint": "^8.34.1"
+    "typescript-eslint": "^8.34.1",
+    "vitest": "^3.2.4"
   }
 }

package/api-hub/README.md

@@ -1,29 +0,0 @@
-# API Hub
-
-## Environment Variables
-
-- `API_HUB_API_KEY`: Required. The API key for API Hub MCP tools.
-- `MCP_SERVER_INSIGHT_HUB_API_KEY`: Optional. If set, enables error reporting of the _MCP_server_ code via the BugSnag SDK. This is useful for debugging and monitoring of the MCP server itself and shouldn't be set to the same API key as your app.
-
-## Tools
-
-1. `list_portals`
-   - Search for available portals within API Hub. Only portals where you have at least a designer role, either at the product level or organization level, are returned.
-2. `create_portal`
-   - Create a new portal within API Hub.
-3. `get_portal`
-   - Retrieve information about a specific portal.
-4. `delete_portal`
-   - Delete a portal.
-5. `update_portal`
-   - Update a specific portal's configuration.
-6. `list_portal_products`
-   - Get products for a specific portal matching your criteria.
-7. `create_portal_product`
-   - Create a new product within a specific portal.
-8. `get_portal_product`
-   - Retrieve information about a specific product resource.
-9. `delete_portal_product`
-   - Delete a product from a specific portal.
-10. `update_portal_product`
-    - Update a product's settings within a specific portal.

package/assets/smartbear-logo-dark.svg

@@ -1,17 +0,0 @@
-<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" width="253.9" height="179.21" viewBox="0 0 253.9 179.21">
-  <title>SB_Logo_Vertical_BLK_RGB</title>
-  <g>
-    <path d="M146,115.56H108l-6.75,20.79h51.55Zm102,20.79-20-61.43L241,35.24,193,0.4,159.26,24.94H94.7L60.93,0.4,13,35.24,25.87,74.92l-20,61.43h63L64,121.28l63-45.76,63,45.76-4.89,15.07h63ZM108,115.56l-6.75,20.79h51.55L146,115.56H108Zm38.05,0H108l-6.75,20.79h51.55Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-    <g>
-      <path d="M17.86,156.7s-5.4-.62-7.64-0.62c-3.24,0-4.9,1.16-4.9,3.43,0,2.47,1.39,3,5.9,4.28,5.55,1.54,7.56,3,7.56,7.52,0,5.78-3.62,8.29-8.83,8.29a56.2,56.2,0,0,1-8.64-1l0.42-3.43s5.21,0.69,7.94.69c3.28,0,4.78-1.47,4.78-4.24,0-2.24-1.2-3-5.24-4C3.52,166.14,1,164.41,1,159.82c0-5.32,3.51-7.52,8.79-7.52a58.55,58.55,0,0,1,8.37.92Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-      <path d="M29.06,152.76H36.5l5.9,20.63,5.9-20.63h7.48v26.42H51.46V156.35H51.24l-6.6,21.75H40.16l-6.6-21.75H33.34v22.83H29.06V152.76Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-      <path d="M122.08,152.76h19.28v3.82h-7.44v22.6H129.6v-22.6h-7.52v-3.82Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-      <path d="M160,152.76c5.24,0,8.06,2,8.06,6.86,0,3.2-1,4.78-3.12,5.94,2.28,0.89,3.78,2.51,3.78,6.13,0,5.4-3.28,7.48-8.41,7.48H150V152.76h10Zm-5.75,3.7V164h5.67c2.62,0,3.78-1.31,3.78-3.9s-1.31-3.66-3.93-3.66h-5.52Zm0,11.18v7.83h5.82c2.66,0,4.24-.85,4.24-4,0-3-2.24-3.82-4.32-3.82h-5.75Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-      <path d="M179.32,152.76H196v3.74H183.6V164h10.07v3.66H183.6v7.75H196v3.78H179.32V152.76Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-      <path d="M211.33,152.76h8.52l6.56,26.42h-4.32l-2-7.75H211l-2,7.75h-4.28Zm0.57,14.89h7.41l-2.73-11.3h-1.93Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-      <path d="M240.22,171.35v7.83h-4.28V152.76h10c5.82,0,8.95,3.34,8.95,9.2,0,3.74-1.5,7.12-4.32,8.43l4.36,8.79h-4.71l-3.82-7.83h-6.21ZM246,156.46h-5.75v11.18H246c3.24,0,4.47-2.91,4.47-5.65C250.51,159,249,156.46,246,156.46Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-      <path d="M71.64,152.76h8.52l6.56,26.42H82.39l-2-7.75h-9.1l-2,7.75H65.12Zm0.57,14.89h7.41l-2.73-11.3H75Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-      <path d="M100.52,171.35v7.83H96.24V152.76h10c5.82,0,8.95,3.34,8.95,9.2,0,3.74-1.5,7.12-4.32,8.43l4.36,8.79h-4.71l-3.82-7.83h-6.21Zm5.75-14.89h-5.75v11.18h5.82c3.24,0,4.47-2.91,4.47-5.65C110.82,159,109.35,156.46,106.27,156.46Z" transform="translate(-1.05 -0.4)" fill="#2c282c"/>
-    </g>
-  </g>
-</svg>

package/assets/smartbear-logo-light.svg

@@ -1,17 +0,0 @@
-<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" width="253.9" height="179.21" viewBox="0 0 253.9 179.21">
-  <title>SB_Logo_Vertical_WT_RGB</title>
-  <g>
-    <path d="M146,115.56H108l-6.75,20.79h51.55Zm102,20.79-20-61.43L241,35.24,193,0.4,159.26,24.94H94.7L60.93,0.4,13,35.24,25.87,74.92l-20,61.43h63L64,121.28l63-45.76,63,45.76-4.89,15.07h63ZM108,115.56l-6.75,20.79h51.55L146,115.56H108Zm38.05,0H108l-6.75,20.79h51.55Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-    <g>
-      <path d="M17.86,156.7s-5.4-.62-7.64-0.62c-3.24,0-4.9,1.16-4.9,3.43,0,2.47,1.39,3,5.9,4.28,5.55,1.54,7.56,3,7.56,7.52,0,5.78-3.62,8.29-8.83,8.29a56.2,56.2,0,0,1-8.64-1l0.42-3.43s5.21,0.69,7.94.69c3.28,0,4.78-1.47,4.78-4.24,0-2.24-1.2-3-5.24-4C3.52,166.14,1,164.41,1,159.82c0-5.32,3.51-7.52,8.79-7.52a58.55,58.55,0,0,1,8.37.92Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-      <path d="M29.06,152.76H36.5l5.9,20.63,5.9-20.63h7.48v26.42H51.46V156.35H51.24l-6.6,21.75H40.16l-6.6-21.75H33.34v22.83H29.06V152.76Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-      <path d="M122.08,152.76h19.28v3.82h-7.44v22.6H129.6v-22.6h-7.52v-3.82Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-      <path d="M160,152.76c5.24,0,8.06,2,8.06,6.86,0,3.2-1,4.78-3.12,5.94,2.28,0.89,3.78,2.51,3.78,6.13,0,5.4-3.28,7.48-8.41,7.48H150V152.76h10Zm-5.75,3.7V164h5.67c2.62,0,3.78-1.31,3.78-3.9s-1.31-3.66-3.93-3.66h-5.52Zm0,11.18v7.83h5.82c2.66,0,4.24-.85,4.24-4,0-3-2.24-3.82-4.32-3.82h-5.75Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-      <path d="M179.32,152.76H196v3.74H183.6V164h10.07v3.66H183.6v7.75H196v3.78H179.32V152.76Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-      <path d="M211.33,152.76h8.52l6.56,26.42h-4.32l-2-7.75H211l-2,7.75h-4.28Zm0.57,14.89h7.41l-2.73-11.3h-1.93Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-      <path d="M240.22,171.35v7.83h-4.28V152.76h10c5.82,0,8.95,3.34,8.95,9.2,0,3.74-1.5,7.12-4.32,8.43l4.36,8.79h-4.71l-3.82-7.83h-6.21ZM246,156.46h-5.75v11.18H246c3.24,0,4.47-2.91,4.47-5.65C250.51,159,249,156.46,246,156.46Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-      <path d="M71.64,152.76h8.52l6.56,26.42H82.39l-2-7.75h-9.1l-2,7.75H65.12Zm0.57,14.89h7.41l-2.73-11.3H75Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-      <path d="M100.52,171.35v7.83H96.24V152.76h10c5.82,0,8.95,3.34,8.95,9.2,0,3.74-1.5,7.12-4.32,8.43l4.36,8.79h-4.71l-3.82-7.83h-6.21Zm5.75-14.89h-5.75v11.18h5.82c3.24,0,4.47-2.91,4.47-5.65C110.82,159,109.35,156.46,106.27,156.46Z" transform="translate(-1.05 -0.4)" fill="#fff"/>
-    </g>
-  </g>
-</svg>

package/insight-hub/README.md

@@ -1,42 +0,0 @@
-# Insight Hub
-
-Fetch details of your app crashes and errors from your [Insight Hub](https://www.smartbear.com/insight-hub) dashboard for your LLM to help you diagnose and fix.
-
-To connect an MCP server, you will need to create a personal auth token from the user settings page on your Insight Hub dashboard.
-
-If you wish to interact with only one Insight Hub project, we also recommend setting `INSIGHT_HUB_PROJECT_API_KEY` to reduce the scope of the conversation. This allows the MCP server to pre-cache your project's custom filters for better filtering prompts.
-
-## Example prompts
-
-- "Help me fix this crash: https://app.bugsnag.com/my-org/my-project/errors/1a2b3c4d5e6f7g8h9i0j1k2l?&event_id=1a2b3c4d5e6f7g8h9i0j1k2l"
-- "What are my latest events my project?"
-- "Which errors occurred in the last 7 days?"
-
-## Environment Variables
-
-- `INSIGHT_HUB_AUTH_TOKEN`: (Required) The auth token for your account from your Insight Hub dashboard, under **Personal auth tokens** in user settings.
-- `INSIGHT_HUB_PROJECT_API_KEY`: (Recommended) The API key for the Insight Hub project you wish to interact with. Use this to scope all operations to a single project.
-- `INSIGHT_HUB_ENDPOINT`: (Optional) The API server to connect to. Use this for on-premise installations to point to your own endpoint (e.g. `https://your.api.server`).
-
-## Tools
-
-1. `list_insight_hub_projects`
-   - List all projects in an organization.
-   - Multi-project mode only.
-2. `get_insight_hub_error`
-   - Get error details from a project.
-3. `get_insight_hub_error_latest_event`
-   - Get the latest event for an error.
-4. `get_insight_hub_event_details`
-   - Get details of a specific event.
-5. `get_project_event_filters`
-   - List the filters available for a project.
-6. `list_insight_hub_project_errors`
-   - List and filter the errors from a project.
-
-## Resources
-
-- **insight_hub_event**
-  - URI Template: `insighthub://event/{id}`
-  - Description: Fetches details for a specific event by its event ID. Returns the event details in JSON format.
-  - Example usage: Retrieve event details for debugging or analysis by referencing the event ID.

package/reflect/README.md

@@ -1,25 +0,0 @@
-# Reflect
-
-## Environment Variables
-
-- `REFLECT_API_TOKEN`: Required. The Reflect Account API Key.
-- `MCP_SERVER_INSIGHT_HUB_API_KEY`: Optional. If set, enables error reporting of the _MCP_server_ code via the BugSnag SDK. This is useful for debugging and monitoring of the MCP server itself and shouldn't be set to the same API key as your app.
-
-## Tools
-
-1. `list_reflect_suites`
-   - List all Reflect suites for your account.
-2. `list_reflect_suite_executions`
-   - List all executions for a given Reflect suite.
-3. `reflect_suite_execution_status`
-   - Get the status of a Reflect suite execution.
-4. `reflect_suite_execution`
-   - Execute a Reflect suite.
-5. `cancel_reflect_suite_execution`
-   - Cancel a Reflect suite execution.
-6. `list_reflect_tests`
-   - List all Reflect tests.
-7. `run_reflect_test`
-   - Run a Reflect test.
-8. `reflect_test_status`
-   - Get the status of a Reflect test execution.