@vm3jack/mcp-server-azure-devops 1.0.0

package/dist/features/wikis/list-wiki-pages/feature.spec.int.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const feature_1 = require("./feature");
+const feature_2 = require("../get-wikis/feature");
+const test_helpers_1 = require("@/shared/test/test-helpers");
+const environment_1 = require("@/utils/environment");
+const azure_devops_errors_1 = require("@/shared/errors/azure-devops-errors");
+// Ensure environment variables are set for testing
+process.env.AZURE_DEVOPS_DEFAULT_PROJECT =
+    process.env.AZURE_DEVOPS_DEFAULT_PROJECT || 'default-project';
+const shouldSkip = (0, test_helpers_1.shouldSkipIntegrationTest)();
+const describeOrSkip = shouldSkip ? describe.skip : describe;
+describeOrSkip('listWikiPages integration', () => {
+    let connection;
+    let wikiName;
+    let projectName;
+    let orgUrl;
+    let organizationId;
+    beforeAll(async () => {
+        // Mock the required environment variable for testing
+        process.env.AZURE_DEVOPS_ORG_URL =
+            process.env.AZURE_DEVOPS_ORG_URL || 'https://example.visualstudio.com';
+        // Get and validate required environment variables
+        const envProjectName = process.env.AZURE_DEVOPS_DEFAULT_PROJECT;
+        if (!envProjectName) {
+            throw new Error('AZURE_DEVOPS_DEFAULT_PROJECT environment variable is required');
+        }
+        projectName = envProjectName;
+        const envOrgUrl = process.env.AZURE_DEVOPS_ORG_URL;
+        if (!envOrgUrl) {
+            throw new Error('AZURE_DEVOPS_ORG_URL environment variable is required');
+        }
+        orgUrl = envOrgUrl;
+        organizationId = (0, environment_1.getOrgNameFromUrl)(orgUrl);
+        const testConnection = await (0, test_helpers_1.getTestConnection)();
+        if (!testConnection) {
+            throw new Error('Connection should be available when integration tests are enabled');
+        }
+        connection = testConnection;
+        const wikis = await (0, feature_2.getWikis)(connection, { projectId: projectName });
+        if (wikis.length === 0) {
+            throw new Error('No wikis available in the project');
+        }
+        if (!wikis[0].name) {
+            throw new Error('Wiki name is undefined');
+        }
+        wikiName = wikis[0].name;
+    });
+    describe('Happy Path Tests', () => {
+        test('should list pages in real test wiki', async () => {
+            // List wiki pages
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            // Verify the result structure
+            expect(result).toBeDefined();
+            expect(Array.isArray(result)).toBe(true);
+            // If pages exist, verify their structure matches WikiPageSummary interface
+            if (result.length > 0) {
+                const page = result[0];
+                expect(page).toHaveProperty('id');
+                expect(page).toHaveProperty('path');
+                expect(page).toHaveProperty('url');
+                expect(typeof page.id).toBe('number');
+                expect(typeof page.path).toBe('string');
+                // url and order are optional
+                if (page.url !== undefined) {
+                    expect(typeof page.url).toBe('string');
+                }
+                if (page.order !== undefined) {
+                    expect(typeof page.order).toBe('number');
+                }
+            }
+        });
+        test('should handle wiki listing for different wiki structures', async () => {
+            // Get all pages for different wiki structures
+            const allPages = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            expect(Array.isArray(allPages)).toBe(true);
+            // If we have pages, verify they have expected structure
+            if (allPages.length > 0) {
+                const firstPage = allPages[0];
+                expect(firstPage).toHaveProperty('id');
+                expect(firstPage).toHaveProperty('path');
+                expect(firstPage).toHaveProperty('url');
+                // Verify nested pages if they exist
+                const nestedPages = allPages.filter((page) => page.path.includes('/') && page.path !== '/');
+                console.log(`Found ${nestedPages.length} nested pages out of ${allPages.length} total pages`);
+            }
+        });
+        test('should handle basic wiki page listing consistently', async () => {
+            // Test basic page listing
+            const firstResult = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            expect(Array.isArray(firstResult)).toBe(true);
+            // Test again to ensure consistency
+            const secondResult = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            expect(Array.isArray(secondResult)).toBe(true);
+            // Results should be consistent
+            expect(secondResult.length).toBe(firstResult.length);
+        });
+    });
+    describe('Error Scenarios', () => {
+        test('should handle invalid wikiId (expect 404 error)', async () => {
+            const invalidWikiId = 'non-existent-wiki-id-12345';
+            await expect((0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: invalidWikiId,
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsError);
+        });
+        test('should handle invalid projectId', async () => {
+            const invalidProjectId = 'non-existent-project-12345';
+            await expect((0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: invalidProjectId,
+                wikiId: 'any-wiki',
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsError);
+        });
+        test('should handle invalid organizationId', async () => {
+            const invalidOrgId = 'non-existent-org-12345';
+            await expect((0, feature_1.listWikiPages)({
+                organizationId: invalidOrgId,
+                projectId: projectName,
+                wikiId: 'any-wiki',
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsError);
+        });
+    });
+    describe('Edge Cases', () => {
+        test('should handle empty wikis gracefully', async () => {
+            // Test with a path that likely doesn't exist
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            // Should return an array (may be empty or contain all pages depending on API behavior)
+            expect(Array.isArray(result)).toBe(true);
+            // Note: Azure DevOps API may return all pages when path doesn't match
+            console.log(`Path filter test returned ${result.length} pages`);
+        });
+        test('should handle deeply nested paths', async () => {
+            // Test with default parameters
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            expect(Array.isArray(result)).toBe(true);
+            // Should not throw error with basic parameters
+        });
+        test('should handle boundary recursionLevel values', async () => {
+            // Test basic page listing
+            const firstResult = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            expect(Array.isArray(firstResult)).toBe(true);
+            // Test again for consistency
+            const secondResult = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            expect(Array.isArray(secondResult)).toBe(true);
+        });
+    });
+    describe('Data Structure Validation', () => {
+        test('should verify returned data structure matches WikiPageSummary interface', async () => {
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            expect(Array.isArray(result)).toBe(true);
+            // Validate each page in the result
+            result.forEach((page) => {
+                // Required fields
+                expect(page).toHaveProperty('id');
+                expect(page).toHaveProperty('path');
+                expect(page).toHaveProperty('url');
+                expect(typeof page.id).toBe('number');
+                expect(typeof page.path).toBe('string');
+                // Optional fields
+                if (page.url !== undefined) {
+                    expect(typeof page.url).toBe('string');
+                }
+                if (page.order !== undefined) {
+                    expect(typeof page.order).toBe('number');
+                }
+                // Validate URL format (if present)
+                if (page.url !== undefined) {
+                    expect(page.url).toMatch(/^https?:\/\//);
+                }
+                // Validate path format (should start with /)
+                expect(page.path).toMatch(/^\//);
+            });
+        });
+    });
+    describe('Performance and Pagination', () => {
+        test('should handle large wiki structures efficiently', async () => {
+            const startTime = Date.now();
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId,
+                projectId: projectName,
+                wikiId: wikiName,
+            });
+            const endTime = Date.now();
+            const duration = endTime - startTime;
+            expect(Array.isArray(result)).toBe(true);
+            // Performance check - should complete within reasonable time (30 seconds)
+            expect(duration).toBeLessThan(30000);
+            console.log(`Retrieved ${result.length} pages in ${duration}ms`);
+        });
+    });
+});
+//# sourceMappingURL=feature.spec.int.js.map

package/dist/features/wikis/list-wiki-pages/feature.spec.int.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.spec.int.js","sourceRoot":"","sources":["../../../../src/features/wikis/list-wiki-pages/feature.spec.int.ts"],"names":[],"mappings":"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"}

package/dist/features/wikis/list-wiki-pages/feature.spec.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/wikis/list-wiki-pages/feature.spec.unit.js

@@ -0,0 +1,427 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const feature_1 = require("./feature");
+const azureDevOpsClient = __importStar(require("../../../clients/azure-devops"));
+const azure_devops_errors_1 = require("../../../shared/errors/azure-devops-errors");
+// Mock the Azure DevOps client
+jest.mock('../../../clients/azure-devops');
+// Mock the environment utilities to avoid dependency on environment variables
+jest.mock('../../../utils/environment', () => ({
+    defaultOrg: 'azure-devops-mcp-testing',
+    defaultProject: 'eShopOnWeb',
+}));
+describe('listWikiPages unit', () => {
+    // Mock WikiClient
+    const mockWikiClient = {
+        listWikiPages: jest.fn(),
+    };
+    // Mock getWikiClient function
+    const mockGetWikiClient = azureDevOpsClient.getWikiClient;
+    beforeEach(() => {
+        // Clear mock calls between tests
+        jest.clearAllMocks();
+        // Setup default mock implementation
+        mockGetWikiClient.mockResolvedValue(mockWikiClient);
+    });
+    describe('Happy Path Scenarios', () => {
+        test('should return wiki pages successfully', async () => {
+            // Mock data
+            const mockPages = [
+                {
+                    id: 1,
+                    path: '/Home',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/1',
+                    order: 1,
+                },
+                {
+                    id: 2,
+                    path: '/Getting-Started',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/2',
+                    order: 2,
+                },
+            ];
+            // Setup mock responses
+            mockWikiClient.listWikiPages.mockResolvedValue(mockPages);
+            // Call the function
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            // Assertions
+            expect(mockGetWikiClient).toHaveBeenCalledWith({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+            });
+            expect(mockWikiClient.listWikiPages).toHaveBeenCalledWith('test-project', 'test-wiki');
+            expect(result).toEqual(mockPages);
+            expect(result.length).toBe(2);
+        });
+        test('should handle basic listing without parameters', async () => {
+            const mockPages = [
+                {
+                    id: 3,
+                    path: '/docs/api',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/3',
+                    order: 1,
+                },
+            ];
+            mockWikiClient.listWikiPages.mockResolvedValue(mockPages);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            expect(mockWikiClient.listWikiPages).toHaveBeenCalledWith('test-project', 'test-wiki');
+            expect(result).toEqual(mockPages);
+        });
+        test('should handle nested pages correctly', async () => {
+            const mockPages = [
+                {
+                    id: 4,
+                    path: '/deep/nested/page',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/4',
+                    order: 1,
+                },
+            ];
+            mockWikiClient.listWikiPages.mockResolvedValue(mockPages);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            expect(mockWikiClient.listWikiPages).toHaveBeenCalledWith('test-project', 'test-wiki');
+            expect(result).toEqual(mockPages);
+        });
+        test('should handle empty wiki correctly', async () => {
+            const mockPages = [];
+            mockWikiClient.listWikiPages.mockResolvedValue(mockPages);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            expect(mockWikiClient.listWikiPages).toHaveBeenCalledWith('test-project', 'test-wiki');
+            expect(result).toEqual(mockPages);
+        });
+        test('should return empty array when no pages found', async () => {
+            mockWikiClient.listWikiPages.mockResolvedValue([]);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'empty-wiki',
+            });
+            expect(result).toEqual([]);
+            expect(Array.isArray(result)).toBe(true);
+        });
+        test('should use default organization and project when not provided', async () => {
+            const mockPages = [
+                {
+                    id: 5,
+                    path: '/default-page',
+                    url: 'https://dev.azure.com/default-org/default-project/_wiki/wikis/wiki1/5',
+                    order: 1,
+                },
+            ];
+            mockWikiClient.listWikiPages.mockResolvedValue(mockPages);
+            const result = await (0, feature_1.listWikiPages)({
+                wikiId: 'test-wiki',
+            });
+            expect(mockGetWikiClient).toHaveBeenCalledWith({
+                organizationId: 'azure-devops-mcp-testing', // Uses default from environment
+                projectId: 'eShopOnWeb',
+            });
+            expect(result).toEqual(mockPages);
+        });
+    });
+    describe('Error Scenarios', () => {
+        test('should handle network timeout errors', async () => {
+            const timeoutError = new Error('Network timeout');
+            timeoutError.name = 'ETIMEDOUT';
+            mockWikiClient.listWikiPages.mockRejectedValue(timeoutError);
+            await expect((0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsError);
+        });
+        test('should handle connection refused errors', async () => {
+            const connectionError = new Error('Connection refused');
+            connectionError.name = 'ECONNREFUSED';
+            mockWikiClient.listWikiPages.mockRejectedValue(connectionError);
+            await expect((0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsError);
+        });
+        test('should propagate AzureDevOpsResourceNotFoundError from client', async () => {
+            const notFoundError = new azure_devops_errors_1.AzureDevOpsResourceNotFoundError('Wiki not found: test-wiki');
+            mockWikiClient.listWikiPages.mockRejectedValue(notFoundError);
+            await expect((0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'non-existent-wiki',
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsResourceNotFoundError);
+        });
+        test('should propagate AzureDevOpsPermissionError from client', async () => {
+            const permissionError = new azure_devops_errors_1.AzureDevOpsPermissionError('Permission denied to access wiki');
+            mockWikiClient.listWikiPages.mockRejectedValue(permissionError);
+            await expect((0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'restricted-wiki',
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsPermissionError);
+        });
+        test('should wrap unknown errors in AzureDevOpsError', async () => {
+            const unknownError = new Error('Unknown error occurred');
+            mockWikiClient.listWikiPages.mockRejectedValue(unknownError);
+            await expect((0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsError);
+            try {
+                await (0, feature_1.listWikiPages)({
+                    organizationId: 'test-org',
+                    projectId: 'test-project',
+                    wikiId: 'test-wiki',
+                });
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(azure_devops_errors_1.AzureDevOpsError);
+                expect(error.message).toBe('Failed to list wiki pages');
+            }
+        });
+        test('should handle client creation failure', async () => {
+            const clientError = new Error('Failed to create client');
+            mockGetWikiClient.mockRejectedValue(clientError);
+            await expect((0, feature_1.listWikiPages)({
+                organizationId: 'invalid-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsError);
+        });
+    });
+    describe('Edge Cases and Input Validation', () => {
+        test('should handle malformed API response gracefully', async () => {
+            // Mock malformed response (missing required fields)
+            const malformedPages = [
+                {
+                    id: 'invalid-id', // Should be number
+                    path: null, // Should be string
+                    url: undefined, // Should be string
+                },
+            ];
+            mockWikiClient.listWikiPages.mockResolvedValue(malformedPages);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            // Should still return the data as-is (transformation happens in client)
+            expect(result).toEqual(malformedPages);
+        });
+        test('should handle null/undefined response from client', async () => {
+            mockWikiClient.listWikiPages.mockResolvedValue(null);
+            await expect((0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            })).rejects.toThrow(azure_devops_errors_1.AzureDevOpsError);
+        });
+        test('should handle very large page collections', async () => {
+            // Create a large mock dataset
+            const largeMockPages = Array.from({ length: 10000 }, (_, i) => ({
+                id: i + 1,
+                path: `/page-${i + 1}`,
+                url: `https://dev.azure.com/org/project/_wiki/wikis/wiki1/${i + 1}`,
+                order: i + 1,
+            }));
+            mockWikiClient.listWikiPages.mockResolvedValue(largeMockPages);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'large-wiki',
+            });
+            expect(result).toEqual(largeMockPages);
+            expect(result.length).toBe(10000);
+        });
+        test('should handle pages with special characters in paths', async () => {
+            const specialCharPages = [
+                {
+                    id: 1,
+                    path: '/页面-中文',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/1',
+                    order: 1,
+                },
+                {
+                    id: 2,
+                    path: '/página-español',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/2',
+                    order: 2,
+                },
+                {
+                    id: 3,
+                    path: '/page with spaces & symbols!@#$%',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/3',
+                    order: 3,
+                },
+            ];
+            mockWikiClient.listWikiPages.mockResolvedValue(specialCharPages);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'special-wiki',
+            });
+            expect(result).toEqual(specialCharPages);
+        });
+        test('should handle pages with missing optional order field', async () => {
+            const pagesWithoutOrder = [
+                {
+                    id: 1,
+                    path: '/page-1',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/1',
+                    // order field is optional and missing
+                },
+                {
+                    id: 2,
+                    path: '/page-2',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/2',
+                    order: 5,
+                },
+            ];
+            mockWikiClient.listWikiPages.mockResolvedValue(pagesWithoutOrder);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            expect(result).toEqual(pagesWithoutOrder);
+            expect(result[0].order).toBeUndefined();
+            expect(result[1].order).toBe(5);
+        });
+    });
+    describe('Parameter Validation Edge Cases', () => {
+        test('should handle basic parameter validation', async () => {
+            const mockPages = [];
+            mockWikiClient.listWikiPages.mockResolvedValue(mockPages);
+            await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            expect(mockWikiClient.listWikiPages).toHaveBeenCalledWith('test-project', 'test-wiki');
+            await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            expect(mockWikiClient.listWikiPages).toHaveBeenCalledWith('test-project', 'test-wiki');
+        });
+        test('should handle empty string parameters', async () => {
+            const mockPages = [];
+            mockWikiClient.listWikiPages.mockResolvedValue(mockPages);
+            await (0, feature_1.listWikiPages)({
+                organizationId: '',
+                projectId: '',
+                wikiId: 'test-wiki',
+            });
+            expect(mockGetWikiClient).toHaveBeenCalledWith({
+                organizationId: 'azure-devops-mcp-testing', // Empty string gets overridden by default
+                projectId: 'eShopOnWeb',
+            });
+            expect(mockWikiClient.listWikiPages).toHaveBeenCalledWith('eShopOnWeb', // Empty string gets overridden by default project
+            'test-wiki');
+        });
+    });
+    describe('Data Transformation and Mapping', () => {
+        test('should preserve all WikiPageSummary fields correctly', async () => {
+            const mockPages = [
+                {
+                    id: 42,
+                    path: '/test-page',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/42',
+                    order: 10,
+                },
+            ];
+            mockWikiClient.listWikiPages.mockResolvedValue(mockPages);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            expect(result[0]).toEqual({
+                id: 42,
+                path: '/test-page',
+                url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/42',
+                order: 10,
+            });
+        });
+        test('should handle mixed data types in response', async () => {
+            const mixedPages = [
+                {
+                    id: 1,
+                    path: '/normal-page',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/1',
+                    order: 1,
+                },
+                {
+                    id: 2,
+                    path: '/page-without-order',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/2',
+                    // order is undefined
+                },
+                {
+                    id: 3,
+                    path: '/page-with-zero-order',
+                    url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1/3',
+                    order: 0,
+                },
+            ];
+            mockWikiClient.listWikiPages.mockResolvedValue(mixedPages);
+            const result = await (0, feature_1.listWikiPages)({
+                organizationId: 'test-org',
+                projectId: 'test-project',
+                wikiId: 'test-wiki',
+            });
+            expect(result).toEqual(mixedPages);
+            expect(result[1].order).toBeUndefined();
+            expect(result[2].order).toBe(0);
+        });
+    });
+});
+//# sourceMappingURL=feature.spec.unit.js.map