mcp-server-azure-devops 1.1.0

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

@@ -0,0 +1,166 @@
+import { AzureDevOpsError, AzureDevOpsResourceNotFoundError, AzureDevOpsValidationError, AzureDevOpsPermissionError, } from '../../../shared/errors';
+import { createWiki } from './feature';
+import { WikiType } from './schema';
+import { getWikiClient } from '../../../clients/azure-devops';
+// Mock the WikiClient
+jest.mock('../../../clients/azure-devops');
+describe('createWiki unit', () => {
+    // Mock WikiClient
+    const mockWikiClient = {
+        createWiki: jest.fn(),
+    };
+    // Mock WebApi connection (kept for backward compatibility)
+    const mockConnection = {};
+    beforeEach(() => {
+        // Clear mock calls between tests
+        jest.clearAllMocks();
+        // Setup mock response for getWikiClient
+        getWikiClient.mockResolvedValue(mockWikiClient);
+    });
+    test('should create a project wiki', async () => {
+        // Mock data
+        const mockWiki = {
+            id: 'wiki1',
+            name: 'Project Wiki',
+            projectId: 'project1',
+            remoteUrl: 'https://example.com/wiki1',
+            url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki1',
+            type: 'projectWiki',
+            repositoryId: 'repo1',
+            mappedPath: '/',
+        };
+        // Setup mock response
+        mockWikiClient.createWiki.mockResolvedValue(mockWiki);
+        // Call the function
+        const result = await createWiki(mockConnection, {
+            name: 'Project Wiki',
+            projectId: 'project1',
+        });
+        // Assertions
+        expect(getWikiClient).toHaveBeenCalledWith({
+            organizationId: undefined,
+            projectId: 'project1',
+        });
+        expect(mockWikiClient.createWiki).toHaveBeenCalledWith('project1', {
+            name: 'Project Wiki',
+            projectId: 'project1',
+            type: WikiType.ProjectWiki,
+        });
+        expect(result).toEqual(mockWiki);
+    });
+    test('should create a code wiki', async () => {
+        // Mock data
+        const mockWiki = {
+            id: 'wiki2',
+            name: 'Code Wiki',
+            projectId: 'project1',
+            repositoryId: 'repo1',
+            mappedPath: '/docs',
+            remoteUrl: 'https://example.com/wiki2',
+            url: 'https://dev.azure.com/org/project/_wiki/wikis/wiki2',
+            type: 'codeWiki',
+        };
+        // Setup mock response
+        mockWikiClient.createWiki.mockResolvedValue(mockWiki);
+        // Call the function
+        const result = await createWiki(mockConnection, {
+            name: 'Code Wiki',
+            projectId: 'project1',
+            type: WikiType.CodeWiki,
+            repositoryId: 'repo1',
+            mappedPath: '/docs',
+        });
+        // Assertions
+        expect(getWikiClient).toHaveBeenCalledWith({
+            organizationId: undefined,
+            projectId: 'project1',
+        });
+        expect(mockWikiClient.createWiki).toHaveBeenCalledWith('project1', {
+            name: 'Code Wiki',
+            projectId: 'project1',
+            type: WikiType.CodeWiki,
+            repositoryId: 'repo1',
+            mappedPath: '/docs',
+            version: {
+                version: 'main',
+                versionType: 'branch',
+            },
+        });
+        expect(result).toEqual(mockWiki);
+    });
+    test('should throw validation error when repository ID is missing for code wiki', async () => {
+        // Call the function and expect it to throw
+        await expect(createWiki(mockConnection, {
+            name: 'Code Wiki',
+            projectId: 'project1',
+            type: WikiType.CodeWiki,
+            // repositoryId is missing
+        })).rejects.toThrow(AzureDevOpsValidationError);
+        // Assertions
+        expect(getWikiClient).not.toHaveBeenCalled();
+        expect(mockWikiClient.createWiki).not.toHaveBeenCalled();
+    });
+    test('should handle project not found error', async () => {
+        // Setup mock to throw an error
+        mockWikiClient.createWiki.mockRejectedValue(new AzureDevOpsResourceNotFoundError('Project not found'));
+        // Call the function and expect it to throw
+        await expect(createWiki(mockConnection, {
+            name: 'Project Wiki',
+            projectId: 'nonExistentProject',
+        })).rejects.toThrow(AzureDevOpsResourceNotFoundError);
+        // Assertions
+        expect(getWikiClient).toHaveBeenCalledWith({
+            organizationId: undefined,
+            projectId: 'nonExistentProject',
+        });
+        expect(mockWikiClient.createWiki).toHaveBeenCalled();
+    });
+    test('should handle repository not found error', async () => {
+        // Setup mock to throw an error
+        mockWikiClient.createWiki.mockRejectedValue(new AzureDevOpsResourceNotFoundError('Repository not found'));
+        // Call the function and expect it to throw
+        await expect(createWiki(mockConnection, {
+            name: 'Code Wiki',
+            projectId: 'project1',
+            type: WikiType.CodeWiki,
+            repositoryId: 'nonExistentRepo',
+        })).rejects.toThrow(AzureDevOpsResourceNotFoundError);
+        // Assertions
+        expect(getWikiClient).toHaveBeenCalledWith({
+            organizationId: undefined,
+            projectId: 'project1',
+        });
+        expect(mockWikiClient.createWiki).toHaveBeenCalled();
+    });
+    test('should handle permission error', async () => {
+        // Setup mock to throw an error
+        mockWikiClient.createWiki.mockRejectedValue(new AzureDevOpsPermissionError('You do not have permission'));
+        // Call the function and expect it to throw
+        await expect(createWiki(mockConnection, {
+            name: 'Project Wiki',
+            projectId: 'project1',
+        })).rejects.toThrow(AzureDevOpsPermissionError);
+        // Assertions
+        expect(getWikiClient).toHaveBeenCalledWith({
+            organizationId: undefined,
+            projectId: 'project1',
+        });
+        expect(mockWikiClient.createWiki).toHaveBeenCalled();
+    });
+    test('should handle generic errors', async () => {
+        // Setup mock to throw an error
+        mockWikiClient.createWiki.mockRejectedValue(new Error('Unknown error'));
+        // Call the function and expect it to throw
+        await expect(createWiki(mockConnection, {
+            name: 'Project Wiki',
+            projectId: 'project1',
+        })).rejects.toThrow(AzureDevOpsError);
+        // Assertions
+        expect(getWikiClient).toHaveBeenCalledWith({
+            organizationId: undefined,
+            projectId: 'project1',
+        });
+        expect(mockWikiClient.createWiki).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=feature.spec.unit.js.map

package/dist/features/wikis/create-wiki/feature.spec.unit.js.map

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

package/dist/features/wikis/create-wiki/index.d.ts

@@ -0,0 +1,2 @@
+export { createWiki } from './feature';
+export { CreateWikiSchema, WikiType } from './schema';

package/dist/features/wikis/create-wiki/index.js

@@ -0,0 +1,3 @@
+export { createWiki } from './feature';
+export { CreateWikiSchema, WikiType } from './schema';
+//# sourceMappingURL=index.js.map

package/dist/features/wikis/create-wiki/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/features/wikis/create-wiki/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/features/wikis/create-wiki/schema.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+/**
+ * Wiki types for creating wiki
+ */
+export declare enum WikiType {
+    /**
+     * The wiki is published from a git repository
+     */
+    CodeWiki = "codeWiki",
+    /**
+     * The wiki is provisioned for the team project
+     */
+    ProjectWiki = "projectWiki"
+}
+/**
+ * Schema for creating a wiki in an Azure DevOps project
+ */
+export declare const CreateWikiSchema: z.ZodEffects<z.ZodObject<{
+    organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    projectId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    name: z.ZodString;
+    type: z.ZodDefault<z.ZodOptional<z.ZodNativeEnum<typeof WikiType>>>;
+    repositoryId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    mappedPath: z.ZodDefault<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type: WikiType;
+    mappedPath: string | null;
+    projectId?: string | null | undefined;
+    organizationId?: string | null | undefined;
+    repositoryId?: string | null | undefined;
+}, {
+    name: string;
+    type?: WikiType | undefined;
+    projectId?: string | null | undefined;
+    organizationId?: string | null | undefined;
+    repositoryId?: string | null | undefined;
+    mappedPath?: string | null | undefined;
+}>, {
+    name: string;
+    type: WikiType;
+    mappedPath: string | null;
+    projectId?: string | null | undefined;
+    organizationId?: string | null | undefined;
+    repositoryId?: string | null | undefined;
+}, {
+    name: string;
+    type?: WikiType | undefined;
+    projectId?: string | null | undefined;
+    organizationId?: string | null | undefined;
+    repositoryId?: string | null | undefined;
+    mappedPath?: string | null | undefined;
+}>;

package/dist/features/wikis/create-wiki/schema.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { defaultProject, defaultOrg } from '../../../utils/environment';
+/**
+ * Wiki types for creating wiki
+ */
+export var WikiType;
+(function (WikiType) {
+    /**
+     * The wiki is published from a git repository
+     */
+    WikiType["CodeWiki"] = "codeWiki";
+    /**
+     * The wiki is provisioned for the team project
+     */
+    WikiType["ProjectWiki"] = "projectWiki";
+})(WikiType || (WikiType = {}));
+/**
+ * Schema for creating a wiki in an Azure DevOps project
+ */
+export const CreateWikiSchema = z
+    .object({
+    organizationId: z
+        .string()
+        .optional()
+        .nullable()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    projectId: z
+        .string()
+        .optional()
+        .nullable()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    name: z.string().describe('The name of the new wiki'),
+    type: z
+        .nativeEnum(WikiType)
+        .optional()
+        .default(WikiType.ProjectWiki)
+        .describe('Type of wiki to create (projectWiki or codeWiki)'),
+    repositoryId: z
+        .string()
+        .optional()
+        .nullable()
+        .describe('The ID of the repository to associate with the wiki (required for codeWiki)'),
+    mappedPath: z
+        .string()
+        .optional()
+        .nullable()
+        .default('/')
+        .describe('Folder path inside repository which is shown as Wiki (only for codeWiki)'),
+})
+    .refine((data) => {
+    // If type is codeWiki, then repositoryId is required
+    return data.type !== WikiType.CodeWiki || !!data.repositoryId;
+}, {
+    message: 'repositoryId is required when type is codeWiki',
+    path: ['repositoryId'],
+});
+//# sourceMappingURL=schema.js.map

package/dist/features/wikis/create-wiki/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/features/wikis/create-wiki/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExE;;GAEG;AACH,MAAM,CAAN,IAAY,QAUX;AAVD,WAAY,QAAQ;IAClB;;OAEG;IACH,iCAAqB,CAAA;IAErB;;OAEG;IACH,uCAA2B,CAAA;AAC7B,CAAC,EAVW,QAAQ,KAAR,QAAQ,QAUnB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,UAAU,GAAG,CAAC;IAC1E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,cAAc,GAAG,CAAC;IACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACrD,IAAI,EAAE,CAAC;SACJ,UAAU,CAAC,QAAQ,CAAC;SACpB,QAAQ,EAAE;SACV,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;SAC7B,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACP,6EAA6E,CAC9E;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CACP,0EAA0E,CAC3E;CACJ,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,qDAAqD;IACrD,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;AAChE,CAAC,EACD;IACE,OAAO,EAAE,gDAAgD;IACzD,IAAI,EAAE,CAAC,cAAc,CAAC;CACvB,CACF,CAAC"}

package/dist/features/wikis/create-wiki-page/feature.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { CreateWikiPageSchema } from './schema';
+/**
+ * Creates a new wiki page in Azure DevOps.
+ * If a page already exists at the specified path, it will be updated.
+ *
+ * @param {z.infer<typeof CreateWikiPageSchema>} params - The parameters for creating the wiki page.
+ * @returns {Promise<any>} A promise that resolves with the API response.
+ */
+export declare const createWikiPage: (params: z.infer<typeof CreateWikiPageSchema>, client?: {
+    defaults?: {
+        organizationId?: string;
+        projectId?: string;
+    };
+    put: (url: string, data: Record<string, unknown>) => Promise<{
+        data: unknown;
+    }>;
+}) => Promise<any>;

package/dist/features/wikis/create-wiki-page/feature.js

@@ -0,0 +1,58 @@
+import * as azureDevOpsClient from '../../../clients/azure-devops';
+import { handleRequestError } from '../../../shared/errors/handle-request-error';
+import { defaultOrg, defaultProject } from '../../../utils/environment';
+/**
+ * Creates a new wiki page in Azure DevOps.
+ * If a page already exists at the specified path, it will be updated.
+ *
+ * @param {z.infer<typeof CreateWikiPageSchema>} params - The parameters for creating the wiki page.
+ * @returns {Promise<any>} A promise that resolves with the API response.
+ */
+export const createWikiPage = async (params, client) => {
+    try {
+        const { organizationId, projectId, wikiId, pagePath, content, comment } = params;
+        // For testing mode, use the client's defaults
+        if (client && client.defaults) {
+            const org = organizationId ?? client.defaults.organizationId;
+            const project = projectId ?? client.defaults.projectId;
+            if (!org) {
+                throw new Error('Organization ID is not defined. Please provide it or set a default.');
+            }
+            // This branch is for testing only
+            const apiUrl = `${org}/${project ? `${project}/` : ''}_apis/wiki/wikis/${wikiId}/pages?path=${encodeURIComponent(pagePath ?? '/')}&api-version=7.1-preview.1`;
+            // Prepare the request body
+            const requestBody = { content };
+            if (comment) {
+                requestBody.comment = comment;
+            }
+            // Make the API request
+            const response = await client.put(apiUrl, requestBody);
+            return response.data;
+        }
+        else {
+            // Use default organization and project if not provided
+            const org = organizationId ?? defaultOrg;
+            const project = projectId ?? defaultProject;
+            if (!org) {
+                throw new Error('Organization ID is not defined. Please provide it or set a default.');
+            }
+            // Create the client
+            const wikiClient = await azureDevOpsClient.getWikiClient({
+                organizationId: org,
+                projectId: project,
+            });
+            // Prepare the wiki page content
+            const wikiPageContent = {
+                content,
+            };
+            // This is the real implementation
+            return await wikiClient.updatePage(wikiPageContent, project, wikiId, pagePath ?? '/', {
+                comment: comment ?? undefined,
+            });
+        }
+    }
+    catch (error) {
+        throw await handleRequestError(error, 'Failed to create or update wiki page');
+    }
+};
+//# sourceMappingURL=feature.js.map

package/dist/features/wikis/create-wiki-page/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/features/wikis/create-wiki-page/feature.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,MAA4C,EAC5C,MAMC,EACD,EAAE;IACF,IAAI,CAAC;QACH,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,GACrE,MAAM,CAAC;QAET,8CAA8C;QAC9C,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,cAAc,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC7D,MAAM,OAAO,GAAG,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAEvD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;YACJ,CAAC;YAED,kCAAkC;YAClC,MAAM,MAAM,GAAG,GAAG,GAAG,IACnB,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,EAC5B,oBAAoB,MAAM,eAAe,kBAAkB,CACzD,QAAQ,IAAI,GAAG,CAChB,4BAA4B,CAAC;YAE9B,2BAA2B;YAC3B,MAAM,WAAW,GAA4B,EAAE,OAAO,EAAE,CAAC;YACzD,IAAI,OAAO,EAAE,CAAC;gBACZ,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;YAChC,CAAC;YAED,uBAAuB;YACvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACvD,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,uDAAuD;YACvD,MAAM,GAAG,GAAG,cAAc,IAAI,UAAU,CAAC;YACzC,MAAM,OAAO,GAAG,SAAS,IAAI,cAAc,CAAC;YAE5C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;YACJ,CAAC;YAED,oBAAoB;YACpB,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC;gBACvD,cAAc,EAAE,GAAG;gBACnB,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;YAEH,gCAAgC;YAChC,MAAM,eAAe,GAAG;gBACtB,OAAO;aACR,CAAC;YAEF,kCAAkC;YAClC,OAAO,MAAM,UAAU,CAAC,UAAU,CAChC,eAAe,EACf,OAAO,EACP,MAAM,EACN,QAAQ,IAAI,GAAG,EACf;gBACE,OAAO,EAAE,OAAO,IAAI,SAAS;aAC9B,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,MAAM,kBAAkB,CAC5B,KAAK,EACL,sCAAsC,CACvC,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/features/wikis/create-wiki-page/feature.spec.int.d.ts

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

package/dist/features/wikis/create-wiki-page/feature.spec.int.js

@@ -0,0 +1,272 @@
+import { createWikiPage } from './feature';
+import { getWikiPage } from '../get-wiki-page/feature';
+import { getWikis } from '../get-wikis/feature';
+import { getTestConnection, shouldSkipIntegrationTest, } from '@/shared/test/test-helpers';
+import { getOrgNameFromUrl } from '@/utils/environment';
+import { AzureDevOpsError } from '@/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 = shouldSkipIntegrationTest();
+const describeOrSkip = shouldSkip ? describe.skip : describe;
+describeOrSkip('createWikiPage Integration Tests', () => {
+    let connection;
+    let projectName;
+    let orgUrl;
+    let organizationId;
+    const testPagePath = '/IntegrationTestPage';
+    const testPagePathSub = '/IntegrationTestPage/SubPage';
+    const testPagePathDefault = '/DefaultPathPage';
+    const testPagePathComment = '/CommentTestPage';
+    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 = getOrgNameFromUrl(orgUrl);
+        // Get a real connection using environment variables
+        const testConnection = await getTestConnection();
+        if (!testConnection) {
+            throw new Error('Connection should be available when integration tests are enabled');
+        }
+        connection = testConnection;
+    });
+    // Helper function to get a valid wiki ID
+    async function getValidWikiId() {
+        const wikis = await getWikis(connection, { projectId: projectName });
+        if (wikis.length === 0) {
+            throw new Error('No wikis available in the project');
+        }
+        const wiki = wikis[0];
+        if (!wiki.name) {
+            throw new Error('Wiki name is undefined');
+        }
+        return wiki.name;
+    }
+    test('should create a new wiki page at the root', async () => {
+        // Get a valid wiki ID
+        const wikiId = await getValidWikiId();
+        const params = {
+            organizationId,
+            projectId: projectName,
+            wikiId,
+            pagePath: testPagePath,
+            content: 'This is content for the integration test page (root).',
+        };
+        try {
+            // Create the wiki page
+            const createdPage = await createWikiPage(params);
+            // Verify the result
+            expect(createdPage).toBeDefined();
+            expect(createdPage.path).toBe(testPagePath);
+            expect(createdPage.content).toBe(params.content);
+            // Verify by fetching the page
+            const fetchedPage = await getWikiPage({
+                organizationId,
+                projectId: projectName,
+                wikiId,
+                pagePath: testPagePath,
+            });
+            expect(fetchedPage).toBeDefined();
+            expect(typeof fetchedPage).toBe('string');
+            expect(fetchedPage).toContain(params.content);
+        }
+        catch (error) {
+            console.error('Error in test:', error);
+            throw error;
+        }
+    });
+    test('should create a new wiki sub-page', async () => {
+        // Get a valid wiki ID
+        const wikiId = await getValidWikiId();
+        // First, ensure the parent page exists
+        const parentParams = {
+            organizationId,
+            projectId: projectName,
+            wikiId,
+            pagePath: testPagePath,
+            content: 'This is the parent page for the sub-page test.',
+        };
+        try {
+            // Create the parent page
+            await createWikiPage(parentParams);
+            // Now create the sub-page
+            const subPageParams = {
+                organizationId,
+                projectId: projectName,
+                wikiId,
+                pagePath: testPagePathSub,
+                content: 'This is content for the integration test sub-page.',
+            };
+            const createdSubPage = await createWikiPage(subPageParams);
+            // Verify the result
+            expect(createdSubPage).toBeDefined();
+            expect(createdSubPage.path).toBe(testPagePathSub);
+            expect(createdSubPage.content).toBe(subPageParams.content);
+            // Verify by fetching the sub-page
+            const fetchedSubPage = await getWikiPage({
+                organizationId,
+                projectId: projectName,
+                wikiId,
+                pagePath: testPagePathSub,
+            });
+            expect(fetchedSubPage).toBeDefined();
+            expect(typeof fetchedSubPage).toBe('string');
+            expect(fetchedSubPage).toContain(subPageParams.content);
+        }
+        catch (error) {
+            console.error('Error in test:', error);
+            throw error;
+        }
+    });
+    test('should update an existing wiki page if path already exists', async () => {
+        // Get a valid wiki ID
+        const wikiId = await getValidWikiId();
+        try {
+            // First create a page with initial content
+            const initialParams = {
+                organizationId,
+                projectId: projectName,
+                wikiId,
+                pagePath: testPagePath,
+                content: 'Initial content.',
+            };
+            await createWikiPage(initialParams);
+            // Now update the page with new content
+            const updatedParams = {
+                ...initialParams,
+                content: 'Updated content for the page.',
+            };
+            const updatedPage = await createWikiPage(updatedParams);
+            // Verify the result
+            expect(updatedPage).toBeDefined();
+            expect(updatedPage.path).toBe(testPagePath);
+            expect(updatedPage.content).toBe(updatedParams.content);
+            // Verify by fetching the page
+            const fetchedPage = await getWikiPage({
+                organizationId,
+                projectId: projectName,
+                wikiId,
+                pagePath: testPagePath,
+            });
+            expect(fetchedPage).toBeDefined();
+            expect(typeof fetchedPage).toBe('string');
+            expect(fetchedPage).toContain(updatedParams.content);
+        }
+        catch (error) {
+            console.error('Error in test:', error);
+            throw error;
+        }
+    });
+    test('should create a page with a default path if specified', async () => {
+        // Get a valid wiki ID
+        const wikiId = await getValidWikiId();
+        try {
+            const params = {
+                organizationId,
+                projectId: projectName,
+                wikiId,
+                pagePath: testPagePathDefault,
+                content: 'Content for page created with default path.',
+            };
+            const createdPage = await createWikiPage(params);
+            // Verify the result
+            expect(createdPage).toBeDefined();
+            expect(createdPage.path).toBe(testPagePathDefault);
+            expect(createdPage.content).toBe(params.content);
+            // Verify by fetching the page
+            const fetchedPage = await getWikiPage({
+                organizationId,
+                projectId: projectName,
+                wikiId,
+                pagePath: testPagePathDefault,
+            });
+            expect(fetchedPage).toBeDefined();
+            expect(typeof fetchedPage).toBe('string');
+            expect(fetchedPage).toContain(params.content);
+        }
+        catch (error) {
+            console.error('Error in test:', error);
+            throw error;
+        }
+    });
+    test('should include comment in the wiki page creation when provided', async () => {
+        // Get a valid wiki ID
+        const wikiId = await getValidWikiId();
+        try {
+            const params = {
+                organizationId,
+                projectId: projectName,
+                wikiId,
+                pagePath: testPagePathComment,
+                content: 'Content with comment.',
+                comment: 'This is a test comment for the wiki page creation',
+            };
+            const createdPage = await createWikiPage(params);
+            // Verify the result
+            expect(createdPage).toBeDefined();
+            expect(createdPage.path).toBe(testPagePathComment);
+            expect(createdPage.content).toBe(params.content);
+            // Verify by fetching the page
+            const fetchedPage = await getWikiPage({
+                organizationId,
+                projectId: projectName,
+                wikiId,
+                pagePath: testPagePathComment,
+            });
+            expect(fetchedPage).toBeDefined();
+            expect(typeof fetchedPage).toBe('string');
+            expect(fetchedPage).toContain(params.content);
+            // Note: The API might not return the comment in the response
+            // This test primarily verifies that including a comment doesn't break the API call
+        }
+        catch (error) {
+            console.error('Error in test:', error);
+            throw error;
+        }
+    });
+    test('should handle error when wiki does not exist', async () => {
+        const nonExistentWikiId = 'non-existent-wiki-12345';
+        const params = {
+            organizationId,
+            projectId: projectName,
+            wikiId: nonExistentWikiId,
+            pagePath: '/test-page',
+            content: 'This should fail.',
+        };
+        await expect(createWikiPage(params)).rejects.toThrow(AzureDevOpsError);
+    });
+    test('should handle error when project does not exist', async () => {
+        const nonExistentProjectId = 'non-existent-project-12345';
+        const params = {
+            organizationId,
+            projectId: nonExistentProjectId,
+            wikiId: 'any-wiki',
+            pagePath: '/test-page',
+            content: 'This should fail.',
+        };
+        await expect(createWikiPage(params)).rejects.toThrow(AzureDevOpsError);
+    });
+    test('should handle error when organization does not exist', async () => {
+        const nonExistentOrgId = 'non-existent-org-12345';
+        const params = {
+            organizationId: nonExistentOrgId,
+            projectId: projectName,
+            wikiId: 'any-wiki',
+            pagePath: '/test-page',
+            content: 'This should fail.',
+        };
+        await expect(createWikiPage(params)).rejects.toThrow(AzureDevOpsError);
+    });
+});
+//# sourceMappingURL=feature.spec.int.js.map