@vm3jack/mcp-server-azure-devops 1.0.0

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

@@ -0,0 +1,49 @@
+import { WebApi } from 'azure-devops-node-api';
+import { WikiType } from './schema';
+/**
+ * Options for creating a wiki
+ */
+export interface CreateWikiOptions {
+    /**
+     * The ID or name of the organization
+     * If not provided, the default organization will be used
+     */
+    organizationId?: string;
+    /**
+     * The ID or name of the project
+     * If not provided, the default project will be used
+     */
+    projectId?: string;
+    /**
+     * The name of the new wiki
+     */
+    name: string;
+    /**
+     * Type of wiki to create (projectWiki or codeWiki)
+     * Default is projectWiki
+     */
+    type?: WikiType;
+    /**
+     * The ID of the repository to associate with the wiki
+     * Required when type is codeWiki
+     */
+    repositoryId?: string;
+    /**
+     * Folder path inside repository which is shown as Wiki
+     * Only applicable for codeWiki type
+     * Default is '/'
+     */
+    mappedPath?: string;
+}
+/**
+ * Create a new wiki in Azure DevOps
+ *
+ * @param _connection The Azure DevOps WebApi connection (deprecated, kept for backward compatibility)
+ * @param options Options for creating a wiki
+ * @returns The created wiki
+ * @throws {AzureDevOpsValidationError} When required parameters are missing
+ * @throws {AzureDevOpsResourceNotFoundError} When the project or repository is not found
+ * @throws {AzureDevOpsPermissionError} When the user does not have permission to create a wiki
+ * @throws {AzureDevOpsError} When an error occurs while creating the wiki
+ */
+export declare function createWiki(_connection: WebApi, options: CreateWikiOptions): Promise<any>;

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

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWiki = createWiki;
+const errors_1 = require("../../../shared/errors");
+const schema_1 = require("./schema");
+const azure_devops_1 = require("../../../clients/azure-devops");
+/**
+ * Create a new wiki in Azure DevOps
+ *
+ * @param _connection The Azure DevOps WebApi connection (deprecated, kept for backward compatibility)
+ * @param options Options for creating a wiki
+ * @returns The created wiki
+ * @throws {AzureDevOpsValidationError} When required parameters are missing
+ * @throws {AzureDevOpsResourceNotFoundError} When the project or repository is not found
+ * @throws {AzureDevOpsPermissionError} When the user does not have permission to create a wiki
+ * @throws {AzureDevOpsError} When an error occurs while creating the wiki
+ */
+async function createWiki(_connection, options) {
+    try {
+        const { name, projectId, type = schema_1.WikiType.ProjectWiki, repositoryId, mappedPath = '/', } = options;
+        // Validate repository ID for code wiki
+        if (type === schema_1.WikiType.CodeWiki && !repositoryId) {
+            throw new errors_1.AzureDevOpsValidationError('Repository ID is required for code wikis');
+        }
+        // Get the Wiki client
+        const wikiClient = await (0, azure_devops_1.getWikiClient)({
+            organizationId: options.organizationId,
+            projectId,
+        });
+        // Prepare the wiki creation parameters
+        const wikiCreateParams = {
+            name,
+            projectId: projectId,
+            type,
+            ...(type === schema_1.WikiType.CodeWiki && {
+                repositoryId,
+                mappedPath,
+                version: {
+                    version: 'main',
+                    versionType: 'branch',
+                },
+            }),
+        };
+        // Create the wiki
+        return await wikiClient.createWiki(projectId, wikiCreateParams);
+    }
+    catch (error) {
+        // Just rethrow if it's already one of our error types
+        if (error instanceof errors_1.AzureDevOpsError) {
+            throw error;
+        }
+        // Otherwise wrap in AzureDevOpsError
+        throw new errors_1.AzureDevOpsError(`Failed to create wiki: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=feature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/features/wikis/create-wiki/feature.ts"],"names":[],"mappings":";;AA4DA,gCAsDC;AAjHD,mDAGgC;AAChC,qCAAoC;AACpC,gEAA8D;AA2C9D;;;;;;;;;;GAUG;AACI,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,OAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,EACJ,IAAI,EACJ,SAAS,EACT,IAAI,GAAG,iBAAQ,CAAC,WAAW,EAC3B,YAAY,EACZ,UAAU,GAAG,GAAG,GACjB,GAAG,OAAO,CAAC;QAEZ,uCAAuC;QACvC,IAAI,IAAI,KAAK,iBAAQ,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;YAChD,MAAM,IAAI,mCAA0B,CAClC,0CAA0C,CAC3C,CAAC;QACJ,CAAC;QAED,sBAAsB;QACtB,MAAM,UAAU,GAAG,MAAM,IAAA,4BAAa,EAAC;YACrC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,SAAS;SACV,CAAC,CAAC;QAEH,uCAAuC;QACvC,MAAM,gBAAgB,GAAG;YACvB,IAAI;YACJ,SAAS,EAAE,SAAU;YACrB,IAAI;YACJ,GAAG,CAAC,IAAI,KAAK,iBAAQ,CAAC,QAAQ,IAAI;gBAChC,YAAY;gBACZ,UAAU;gBACV,OAAO,EAAE;oBACP,OAAO,EAAE,MAAM;oBACf,WAAW,EAAE,QAAiB;iBAC/B;aACF,CAAC;SACH,CAAC;QAEF,kBAAkB;QAClB,OAAO,MAAM,UAAU,CAAC,UAAU,CAAC,SAAU,EAAE,gBAAgB,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sDAAsD;QACtD,IAAI,KAAK,YAAY,yBAAgB,EAAE,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,qCAAqC;QACrC,MAAM,IAAI,yBAAgB,CACxB,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;AACH,CAAC"}

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

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

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

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const feature_1 = require("./feature");
+const schema_1 = require("./schema");
+const test_helpers_1 = require("@/shared/test/test-helpers");
+const feature_2 = require("../get-wikis/feature");
+const errors_1 = require("@/shared/errors");
+const shouldSkip = (0, test_helpers_1.shouldSkipIntegrationTest)();
+const describeOrSkip = shouldSkip ? describe.skip : describe;
+describeOrSkip('createWiki (Integration)', () => {
+    let connection;
+    let projectName;
+    beforeAll(async () => {
+        const testConnection = await (0, test_helpers_1.getTestConnection)();
+        if (!testConnection) {
+            throw new Error('Connection should be available when integration tests are enabled');
+        }
+        connection = testConnection;
+        projectName = process.env.AZURE_DEVOPS_DEFAULT_PROJECT || '';
+        if (!projectName) {
+            throw new Error('AZURE_DEVOPS_DEFAULT_PROJECT must be set for this test');
+        }
+    });
+    test('should create a project wiki or report that it already exists', async () => {
+        const existing = await (0, feature_2.getWikis)(connection, { projectId: projectName });
+        const expectedProjectWikiName = `${projectName}.wiki`;
+        const hasProjectWiki = existing.some((w) => w.name === expectedProjectWikiName);
+        const options = {
+            name: `${projectName}.wiki`,
+            projectId: projectName,
+            type: schema_1.WikiType.ProjectWiki,
+        };
+        if (hasProjectWiki) {
+            await expect((0, feature_1.createWiki)(connection, options)).rejects.toThrow(errors_1.AzureDevOpsError);
+        }
+        else {
+            const wiki = await (0, feature_1.createWiki)(connection, options);
+            expect(wiki).toBeDefined();
+            expect(wiki.projectId).toBeDefined();
+            expect(String(wiki.type)).toBe('projectWiki');
+        }
+    }, 60000);
+});
+//# sourceMappingURL=feature.spec.int.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature.spec.int.js","sourceRoot":"","sources":["../../../../src/features/wikis/create-wiki/feature.spec.int.ts"],"names":[],"mappings":";;AACA,uCAAuC;AACvC,qCAAoC;AACpC,6DAGoC;AACpC,kDAAgD;AAChD,4CAAmD;AAEnD,MAAM,UAAU,GAAG,IAAA,wCAAyB,GAAE,CAAC;AAC/C,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAE7D,cAAc,CAAC,0BAA0B,EAAE,GAAG,EAAE;IAC9C,IAAI,UAAkB,CAAC;IACvB,IAAI,WAAmB,CAAC;IAExB,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,cAAc,GAAG,MAAM,IAAA,gCAAiB,GAAE,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QACD,UAAU,GAAG,cAAc,CAAC;QAE5B,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,EAAE,CAAC;QAC7D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,QAAQ,GAAG,MAAM,IAAA,kBAAQ,EAAC,UAAU,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QACxE,MAAM,uBAAuB,GAAG,GAAG,WAAW,OAAO,CAAC;QACtD,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAC1C,CAAC;QAEF,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,GAAG,WAAW,OAAO;YAC3B,SAAS,EAAE,WAAW;YACtB,IAAI,EAAE,iBAAQ,CAAC,WAAW;SAC3B,CAAC;QAEF,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,MAAM,CAAC,IAAA,oBAAU,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC3D,yBAAgB,CACjB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,MAAM,IAAA,oBAAU,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAEnD,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,EAAE,KAAK,CAAC,CAAC;AACZ,CAAC,CAAC,CAAC"}

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

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

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

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const errors_1 = require("../../../shared/errors");
+const feature_1 = require("./feature");
+const schema_1 = require("./schema");
+const azure_devops_1 = require("../../../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
+        azure_devops_1.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 (0, feature_1.createWiki)(mockConnection, {
+            name: 'Project Wiki',
+            projectId: 'project1',
+        });
+        // Assertions
+        expect(azure_devops_1.getWikiClient).toHaveBeenCalledWith({
+            organizationId: undefined,
+            projectId: 'project1',
+        });
+        expect(mockWikiClient.createWiki).toHaveBeenCalledWith('project1', {
+            name: 'Project Wiki',
+            projectId: 'project1',
+            type: schema_1.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 (0, feature_1.createWiki)(mockConnection, {
+            name: 'Code Wiki',
+            projectId: 'project1',
+            type: schema_1.WikiType.CodeWiki,
+            repositoryId: 'repo1',
+            mappedPath: '/docs',
+        });
+        // Assertions
+        expect(azure_devops_1.getWikiClient).toHaveBeenCalledWith({
+            organizationId: undefined,
+            projectId: 'project1',
+        });
+        expect(mockWikiClient.createWiki).toHaveBeenCalledWith('project1', {
+            name: 'Code Wiki',
+            projectId: 'project1',
+            type: schema_1.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((0, feature_1.createWiki)(mockConnection, {
+            name: 'Code Wiki',
+            projectId: 'project1',
+            type: schema_1.WikiType.CodeWiki,
+            // repositoryId is missing
+        })).rejects.toThrow(errors_1.AzureDevOpsValidationError);
+        // Assertions
+        expect(azure_devops_1.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 errors_1.AzureDevOpsResourceNotFoundError('Project not found'));
+        // Call the function and expect it to throw
+        await expect((0, feature_1.createWiki)(mockConnection, {
+            name: 'Project Wiki',
+            projectId: 'nonExistentProject',
+        })).rejects.toThrow(errors_1.AzureDevOpsResourceNotFoundError);
+        // Assertions
+        expect(azure_devops_1.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 errors_1.AzureDevOpsResourceNotFoundError('Repository not found'));
+        // Call the function and expect it to throw
+        await expect((0, feature_1.createWiki)(mockConnection, {
+            name: 'Code Wiki',
+            projectId: 'project1',
+            type: schema_1.WikiType.CodeWiki,
+            repositoryId: 'nonExistentRepo',
+        })).rejects.toThrow(errors_1.AzureDevOpsResourceNotFoundError);
+        // Assertions
+        expect(azure_devops_1.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 errors_1.AzureDevOpsPermissionError('You do not have permission'));
+        // Call the function and expect it to throw
+        await expect((0, feature_1.createWiki)(mockConnection, {
+            name: 'Project Wiki',
+            projectId: 'project1',
+        })).rejects.toThrow(errors_1.AzureDevOpsPermissionError);
+        // Assertions
+        expect(azure_devops_1.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((0, feature_1.createWiki)(mockConnection, {
+            name: 'Project Wiki',
+            projectId: 'project1',
+        })).rejects.toThrow(errors_1.AzureDevOpsError);
+        // Assertions
+        expect(azure_devops_1.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,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WikiType = exports.CreateWikiSchema = exports.createWiki = void 0;
+var feature_1 = require("./feature");
+Object.defineProperty(exports, "createWiki", { enumerable: true, get: function () { return feature_1.createWiki; } });
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "CreateWikiSchema", { enumerable: true, get: function () { return schema_1.CreateWikiSchema; } });
+Object.defineProperty(exports, "WikiType", { enumerable: true, get: function () { return schema_1.WikiType; } });
+//# 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,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AACnB,mCAAsD;AAA7C,0GAAA,gBAAgB,OAAA;AAAE,kGAAA,QAAQ,OAAA"}

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,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateWikiSchema = exports.WikiType = void 0;
+const zod_1 = require("zod");
+const environment_1 = require("../../../utils/environment");
+/**
+ * Wiki types for creating wiki
+ */
+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 || (exports.WikiType = WikiType = {}));
+/**
+ * Schema for creating a wiki in an Azure DevOps project
+ */
+exports.CreateWikiSchema = zod_1.z
+    .object({
+    organizationId: zod_1.z
+        .string()
+        .optional()
+        .nullable()
+        .describe(`The ID or name of the organization (Default: ${environment_1.defaultOrg})`),
+    projectId: zod_1.z
+        .string()
+        .optional()
+        .nullable()
+        .describe(`The ID or name of the project (Default: ${environment_1.defaultProject})`),
+    name: zod_1.z.string().describe('The name of the new wiki'),
+    type: zod_1.z
+        .nativeEnum(WikiType)
+        .optional()
+        .default(WikiType.ProjectWiki)
+        .describe('Type of wiki to create (projectWiki or codeWiki)'),
+    repositoryId: zod_1.z
+        .string()
+        .optional()
+        .nullable()
+        .describe('The ID of the repository to associate with the wiki (required for codeWiki)'),
+    mappedPath: zod_1.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,6BAAwB;AAExB,4DAAwE;AAExE;;GAEG;AACH,IAAY,QAUX;AAVD,WAAY,QAAQ;IAClB;;OAEG;IACH,iCAAqB,CAAA;IAErB;;OAEG;IACH,uCAA2B,CAAA;AAC7B,CAAC,EAVW,QAAQ,wBAAR,QAAQ,QAUnB;AAED;;GAEG;AACU,QAAA,gBAAgB,GAAG,OAAC;KAC9B,MAAM,CAAC;IACN,cAAc,EAAE,OAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,wBAAU,GAAG,CAAC;IAC1E,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,4BAAc,GAAG,CAAC;IACzE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACrD,IAAI,EAAE,OAAC;SACJ,UAAU,CAAC,QAAQ,CAAC;SACpB,QAAQ,EAAE;SACV,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;SAC7B,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,YAAY,EAAE,OAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACP,6EAA6E,CAC9E;IACH,UAAU,EAAE,OAAC;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,95 @@
+"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 });
+exports.createWikiPage = void 0;
+const azureDevOpsClient = __importStar(require("../../../clients/azure-devops"));
+const handle_request_error_1 = require("../../../shared/errors/handle-request-error");
+const environment_1 = require("../../../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.
+ */
+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 ?? environment_1.defaultOrg;
+            const project = projectId ?? environment_1.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 (0, handle_request_error_1.handleRequestError)(error, 'Failed to create or update wiki page');
+    }
+};
+exports.createWikiPage = createWikiPage;
+//# 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,iFAAmE;AACnE,sFAAiF;AAEjF,4DAAwE;AAExE;;;;;;GAMG;AACI,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,wBAAU,CAAC;YACzC,MAAM,OAAO,GAAG,SAAS,IAAI,4BAAc,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,IAAA,yCAAkB,EAC5B,KAAK,EACL,sCAAsC,CACvC,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAhFW,QAAA,cAAc,kBAgFzB"}

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

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