add integration tests

.env.example

@@ -0,0 +1,13 @@
+# QA Sphere Integration Test Configuration
+# Copy this file to .env and fill in the required values
+
+# Required: API key for public API access
+QASPHERE_API_KEY=
+
+# Required: Authentication credentials
+QASPHERE_AUTH_EMAIL=
+QASPHERE_AUTH_PASSWORD=
+
+# Optional: Override defaults for different environments
+# QASPHERE_TENANT_URL=https://e2eqas.eu1.qasphere.com
+# QASPHERE_TENANT_ID=eu1vweq68d

.github/workflows/ci.yml

@@ -9,6 +9,11 @@ on:
 jobs:
   ci:
     runs-on: ubuntu-latest
+    env:
+      QASPHERE_TENANT_URL: https://e2eqas.eu1.qasphere.com
+      QASPHERE_API_KEY: ${{ secrets.QASPHERE_API_KEY }}
+      QASPHERE_AUTH_EMAIL: ${{ secrets.QASPHERE_AUTH_EMAIL }}
+      QASPHERE_AUTH_PASSWORD: ${{ secrets.QASPHERE_AUTH_PASSWORD }}
 
     steps:
       - name: Checkout repository
@@ -35,5 +40,8 @@ jobs:
       - name: Build
         run: npm run build
 
-      - name: Run tests
-        run: npm test
+      - name: Run unit tests
+        run: npm run test:unit
+
+      - name: Run integration tests
+        run: npm run test:integration

.husky/pre-commit

@@ -1 +1,2 @@
-npx lint-staged
+npx lint-staged
+npm run typecheck

package.json

@@ -23,7 +23,8 @@
     "format": "biome format --write .",
     "inspector": "npx @modelcontextprotocol/inspector tsx src/index.ts",
     "test": "vitest run",
-    "test:unit": "vitest run src/tests/unit",
+    "test:unit": "vitest run",
+    "test:integration": "vitest run -c vitest.integration.config.ts",
     "prepare": "husky"
   },
   "dependencies": {

src/tests/integration/customFields.integration.test.ts

@@ -0,0 +1,72 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest'
+import axios from 'axios'
+import {
+  getTenantUrl,
+  getApiHeaders,
+  login,
+  createTestProject,
+  deleteTestProject,
+  generateProjectCode,
+} from './helpers.js'
+
+describe('Custom Fields API Integration Tests', () => {
+  let sessionToken: string
+  let testProjectCode: string
+  let testProjectId: string
+
+  beforeAll(async () => {
+    // Login and create test project
+    sessionToken = await login()
+    testProjectCode = generateProjectCode()
+    const project = await createTestProject(
+      sessionToken,
+      testProjectCode,
+      `[MCP-TEST] ${testProjectCode}`
+    )
+    testProjectId = project.id
+  })
+
+  afterAll(async () => {
+    // Clean up the test project (only if it was created)
+    if (sessionToken && testProjectId) {
+      await deleteTestProject(sessionToken, testProjectId)
+    }
+  })
+
+  describe('list_custom_fields', () => {
+    it('should return field definitions', async () => {
+      const response = await axios.get(
+        `${getTenantUrl()}/api/public/v0/project/${testProjectCode}/custom-field`,
+        {
+          headers: getApiHeaders(),
+        }
+      )
+
+      expect(response.status).toBe(200)
+      expect(response.data).toHaveProperty('customFields')
+      expect(Array.isArray(response.data.customFields)).toBe(true)
+    })
+
+    it('should return fields with correct types', async () => {
+      const response = await axios.get(
+        `${getTenantUrl()}/api/public/v0/project/${testProjectCode}/custom-field`,
+        {
+          headers: getApiHeaders(),
+        }
+      )
+
+      expect(response.status).toBe(200)
+
+      // If there are custom fields, verify they have the expected structure
+      const customFields = response.data.customFields
+      if (customFields.length > 0) {
+        const field = customFields[0]
+        expect(field).toHaveProperty('id')
+        expect(field).toHaveProperty('systemName')
+        expect(field).toHaveProperty('name')
+        expect(field).toHaveProperty('type')
+        expect(['text', 'dropdown']).toContain(field.type)
+      }
+    })
+  })
+})

src/tests/integration/folders.integration.test.ts

@@ -0,0 +1,162 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest'
+import axios from 'axios'
+import {
+  getTenantUrl,
+  getApiHeaders,
+  login,
+  createTestProject,
+  deleteTestProject,
+  generateProjectCode,
+} from './helpers.js'
+
+describe('Folder API Integration Tests', () => {
+  let sessionToken: string
+  let testProjectCode: string
+  let testProjectId: string
+
+  beforeAll(async () => {
+    // Login and create test project
+    sessionToken = await login()
+    testProjectCode = generateProjectCode()
+    const project = await createTestProject(
+      sessionToken,
+      testProjectCode,
+      `[MCP-TEST] ${testProjectCode}`
+    )
+    testProjectId = project.id
+  })
+
+  afterAll(async () => {
+    // Clean up the test project (only if it was created)
+    if (sessionToken && testProjectId) {
+      await deleteTestProject(sessionToken, testProjectId)
+    }
+  })
+
+  describe('list_folders', () => {
+    it('should return folder list with pagination', async () => {
+      const response = await axios.get(
+        `${getTenantUrl()}/api/public/v0/project/${testProjectCode}/tcase/folders`,
+        {
+          headers: getApiHeaders(),
+        }
+      )
+
+      expect(response.status).toBe(200)
+      expect(response.data).toHaveProperty('data')
+      expect(response.data).toHaveProperty('total')
+      expect(response.data).toHaveProperty('page')
+      expect(response.data).toHaveProperty('limit')
+      expect(Array.isArray(response.data.data)).toBe(true)
+    })
+
+    it('should respect pagination parameters', async () => {
+      // First create some folders
+      await axios.post(
+        `${getTenantUrl()}/api/public/v0/project/${testProjectCode}/tcase/folder/bulk`,
+        {
+          folders: [
+            { path: ['[MCP-TEST] Folder 1'] },
+            { path: ['[MCP-TEST] Folder 2'] },
+            { path: ['[MCP-TEST] Folder 3'] },
+            { path: ['[MCP-TEST] Folder 4'] },
+            { path: ['[MCP-TEST] Folder 5'] },
+            { path: ['[MCP-TEST] Folder 6'] },
+          ],
+        },
+        {
+          headers: getApiHeaders(),
+        }
+      )
+
+      const response = await axios.get(
+        `${getTenantUrl()}/api/public/v0/project/${testProjectCode}/tcase/folders`,
+        {
+          params: { page: 1, limit: 5 },
+          headers: getApiHeaders(),
+        }
+      )
+
+      expect(response.status).toBe(200)
+      expect(response.data.page).toBe(1)
+      expect(response.data.limit).toBe(5)
+      expect(response.data.data.length).toBeLessThanOrEqual(5)
+    })
+  })
+
+  describe('upsert_folders', () => {
+    it('should create single folder', async () => {
+      const response = await axios.post(
+        `${getTenantUrl()}/api/public/v0/project/${testProjectCode}/tcase/folder/bulk`,
+        {
+          folders: [{ path: ['[MCP-TEST] Single Folder'] }],
+        },
+        {
+          headers: getApiHeaders(),
+        }
+      )
+
+      expect(response.status).toBe(200)
+      expect(response.data).toHaveProperty('ids')
+      expect(Array.isArray(response.data.ids)).toBe(true)
+      expect(response.data.ids.length).toBe(1)
+      expect(response.data.ids[0].length).toBe(1)
+      expect(typeof response.data.ids[0][0]).toBe('number')
+    })
+
+    it('should create nested folders', async () => {
+      const response = await axios.post(
+        `${getTenantUrl()}/api/public/v0/project/${testProjectCode}/tcase/folder/bulk`,
+        {
+          folders: [{ path: ['[MCP-TEST] A', '[MCP-TEST] B', '[MCP-TEST] C'] }],
+        },
+        {
+          headers: getApiHeaders(),
+        }
+      )
+
+      expect(response.status).toBe(200)
+      expect(response.data).toHaveProperty('ids')
+      expect(response.data.ids.length).toBe(1)
+      expect(response.data.ids[0].length).toBe(3)
+
+      // Verify each level has a valid ID
+      for (const id of response.data.ids[0]) {
+        expect(typeof id).toBe('number')
+        expect(id).toBeGreaterThan(0)
+      }
+    })
+
+    it('should update folder comment without creating duplicate', async () => {
+      const folderPath = ['[MCP-TEST] Update Test']
+
+      // Create folder
+      const createResponse = await axios.post(
+        `${getTenantUrl()}/api/public/v0/project/${testProjectCode}/tcase/folder/bulk`,
+        {
+          folders: [{ path: folderPath, comment: 'Initial comment' }],
+        },
+        {
+          headers: getApiHeaders(),
+        }
+      )
+
+      const folderId = createResponse.data.ids[0][0]
+
+      // Update folder comment
+      const updateResponse = await axios.post(
+        `${getTenantUrl()}/api/public/v0/project/${testProjectCode}/tcase/folder/bulk`,
+        {
+          folders: [{ path: folderPath, comment: 'Updated comment' }],
+        },
+        {
+          headers: getApiHeaders(),
+        }
+      )
+
+      expect(updateResponse.status).toBe(200)
+      // Should return the same folder ID (not create a new one)
+      expect(updateResponse.data.ids[0][0]).toBe(folderId)
+    })
+  })
+})