mcp-server-azure-devops 1.1.0

package/dist/shared/enums/index.js

@@ -0,0 +1,81 @@
+import { CommentThreadStatus, CommentType, GitVersionType, } from 'azure-devops-node-api/interfaces/GitInterfaces';
+import { PullRequestStatus } from 'azure-devops-node-api/interfaces/GitInterfaces';
+/**
+ * Generic enum mapper that creates bidirectional mappings between strings and numeric enums
+ */
+function createEnumMapper(mappings, defaultStringValue = 'unknown') {
+    // Create reverse mapping from enum values to strings
+    const reverseMap = Object.entries(mappings).reduce((acc, [key, value]) => {
+        acc[value] = key;
+        return acc;
+    }, {});
+    return {
+        toEnum: (value) => {
+            const lowerValue = value.toLowerCase();
+            return mappings[lowerValue];
+        },
+        toString: (value) => {
+            return reverseMap[value] ?? defaultStringValue;
+        },
+    };
+}
+/**
+ * CommentThreadStatus enum mappings
+ */
+export const commentThreadStatusMapper = createEnumMapper({
+    unknown: CommentThreadStatus.Unknown,
+    active: CommentThreadStatus.Active,
+    fixed: CommentThreadStatus.Fixed,
+    wontfix: CommentThreadStatus.WontFix,
+    closed: CommentThreadStatus.Closed,
+    bydesign: CommentThreadStatus.ByDesign,
+    pending: CommentThreadStatus.Pending,
+});
+/**
+ * CommentType enum mappings
+ */
+export const commentTypeMapper = createEnumMapper({
+    unknown: CommentType.Unknown,
+    text: CommentType.Text,
+    codechange: CommentType.CodeChange,
+    system: CommentType.System,
+});
+/**
+ * PullRequestStatus enum mappings
+ */
+export const pullRequestStatusMapper = createEnumMapper({
+    active: PullRequestStatus.Active,
+    abandoned: PullRequestStatus.Abandoned,
+    completed: PullRequestStatus.Completed,
+});
+/**
+ * GitVersionType enum mappings
+ */
+export const gitVersionTypeMapper = createEnumMapper({
+    branch: GitVersionType.Branch,
+    commit: GitVersionType.Commit,
+    tag: GitVersionType.Tag,
+});
+/**
+ * Transform comment thread status from numeric to string
+ */
+export function transformCommentThreadStatus(status) {
+    return status !== undefined
+        ? commentThreadStatusMapper.toString(status)
+        : undefined;
+}
+/**
+ * Transform comment type from numeric to string
+ */
+export function transformCommentType(type) {
+    return type !== undefined ? commentTypeMapper.toString(type) : undefined;
+}
+/**
+ * Transform pull request status from numeric to string
+ */
+export function transformPullRequestStatus(status) {
+    return status !== undefined
+        ? pullRequestStatusMapper.toString(status)
+        : undefined;
+}
+//# sourceMappingURL=index.js.map

package/dist/shared/enums/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/enums/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,cAAc,GACf,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAEnF;;GAEG;AACH,SAAS,gBAAgB,CACvB,QAAgC,EAChC,kBAAkB,GAAG,SAAS;IAE9B,qDAAqD;IACrD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAChD,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpB,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;QACjB,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAA4B,CAC7B,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,CAAC,KAAa,EAAsB,EAAE;YAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;QACD,QAAQ,EAAE,CAAC,KAAa,EAAU,EAAE;YAClC,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;IACxD,OAAO,EAAE,mBAAmB,CAAC,OAAO;IACpC,MAAM,EAAE,mBAAmB,CAAC,MAAM;IAClC,KAAK,EAAE,mBAAmB,CAAC,KAAK;IAChC,OAAO,EAAE,mBAAmB,CAAC,OAAO;IACpC,MAAM,EAAE,mBAAmB,CAAC,MAAM;IAClC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ;IACtC,OAAO,EAAE,mBAAmB,CAAC,OAAO;CACrC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;IAChD,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,UAAU,EAAE,WAAW,CAAC,UAAU;IAClC,MAAM,EAAE,WAAW,CAAC,MAAM;CAC3B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;IACtD,MAAM,EAAE,iBAAiB,CAAC,MAAM;IAChC,SAAS,EAAE,iBAAiB,CAAC,SAAS;IACtC,SAAS,EAAE,iBAAiB,CAAC,SAAS;CACvC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;IACnD,MAAM,EAAE,cAAc,CAAC,MAAM;IAC7B,MAAM,EAAE,cAAc,CAAC,MAAM;IAC7B,GAAG,EAAE,cAAc,CAAC,GAAG;CACxB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAe;IAEf,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,yBAAyB,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAe;IAEf,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/dist/shared/enums/index.spec.unit.d.ts

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

package/dist/shared/enums/index.spec.unit.js

@@ -0,0 +1,73 @@
+import { CommentThreadStatus, CommentType, GitVersionType, PullRequestStatus, } from 'azure-devops-node-api/interfaces/GitInterfaces';
+import { commentThreadStatusMapper, commentTypeMapper, pullRequestStatusMapper, gitVersionTypeMapper, } from './index';
+describe('Enum Mappers', () => {
+    describe('commentThreadStatusMapper', () => {
+        it('should map string values to enum values correctly', () => {
+            expect(commentThreadStatusMapper.toEnum('active')).toBe(CommentThreadStatus.Active);
+            expect(commentThreadStatusMapper.toEnum('fixed')).toBe(CommentThreadStatus.Fixed);
+            expect(commentThreadStatusMapper.toEnum('wontfix')).toBe(CommentThreadStatus.WontFix);
+            expect(commentThreadStatusMapper.toEnum('closed')).toBe(CommentThreadStatus.Closed);
+            expect(commentThreadStatusMapper.toEnum('bydesign')).toBe(CommentThreadStatus.ByDesign);
+            expect(commentThreadStatusMapper.toEnum('pending')).toBe(CommentThreadStatus.Pending);
+            expect(commentThreadStatusMapper.toEnum('unknown')).toBe(CommentThreadStatus.Unknown);
+        });
+        it('should map enum values to string values correctly', () => {
+            expect(commentThreadStatusMapper.toString(CommentThreadStatus.Active)).toBe('active');
+            expect(commentThreadStatusMapper.toString(CommentThreadStatus.Fixed)).toBe('fixed');
+            expect(commentThreadStatusMapper.toString(CommentThreadStatus.WontFix)).toBe('wontfix');
+            expect(commentThreadStatusMapper.toString(CommentThreadStatus.Closed)).toBe('closed');
+            expect(commentThreadStatusMapper.toString(CommentThreadStatus.ByDesign)).toBe('bydesign');
+            expect(commentThreadStatusMapper.toString(CommentThreadStatus.Pending)).toBe('pending');
+            expect(commentThreadStatusMapper.toString(CommentThreadStatus.Unknown)).toBe('unknown');
+        });
+        it('should handle case insensitive string input', () => {
+            expect(commentThreadStatusMapper.toEnum('ACTIVE')).toBe(CommentThreadStatus.Active);
+            expect(commentThreadStatusMapper.toEnum('Active')).toBe(CommentThreadStatus.Active);
+        });
+        it('should return undefined for invalid string values', () => {
+            expect(commentThreadStatusMapper.toEnum('invalid')).toBeUndefined();
+        });
+        it('should return default value for invalid enum values', () => {
+            expect(commentThreadStatusMapper.toString(999)).toBe('unknown');
+        });
+    });
+    describe('commentTypeMapper', () => {
+        it('should map string values to enum values correctly', () => {
+            expect(commentTypeMapper.toEnum('text')).toBe(CommentType.Text);
+            expect(commentTypeMapper.toEnum('codechange')).toBe(CommentType.CodeChange);
+            expect(commentTypeMapper.toEnum('system')).toBe(CommentType.System);
+            expect(commentTypeMapper.toEnum('unknown')).toBe(CommentType.Unknown);
+        });
+        it('should map enum values to string values correctly', () => {
+            expect(commentTypeMapper.toString(CommentType.Text)).toBe('text');
+            expect(commentTypeMapper.toString(CommentType.CodeChange)).toBe('codechange');
+            expect(commentTypeMapper.toString(CommentType.System)).toBe('system');
+            expect(commentTypeMapper.toString(CommentType.Unknown)).toBe('unknown');
+        });
+    });
+    describe('pullRequestStatusMapper', () => {
+        it('should map string values to enum values correctly', () => {
+            expect(pullRequestStatusMapper.toEnum('active')).toBe(PullRequestStatus.Active);
+            expect(pullRequestStatusMapper.toEnum('abandoned')).toBe(PullRequestStatus.Abandoned);
+            expect(pullRequestStatusMapper.toEnum('completed')).toBe(PullRequestStatus.Completed);
+        });
+        it('should map enum values to string values correctly', () => {
+            expect(pullRequestStatusMapper.toString(PullRequestStatus.Active)).toBe('active');
+            expect(pullRequestStatusMapper.toString(PullRequestStatus.Abandoned)).toBe('abandoned');
+            expect(pullRequestStatusMapper.toString(PullRequestStatus.Completed)).toBe('completed');
+        });
+    });
+    describe('gitVersionTypeMapper', () => {
+        it('should map string values to enum values correctly', () => {
+            expect(gitVersionTypeMapper.toEnum('branch')).toBe(GitVersionType.Branch);
+            expect(gitVersionTypeMapper.toEnum('commit')).toBe(GitVersionType.Commit);
+            expect(gitVersionTypeMapper.toEnum('tag')).toBe(GitVersionType.Tag);
+        });
+        it('should map enum values to string values correctly', () => {
+            expect(gitVersionTypeMapper.toString(GitVersionType.Branch)).toBe('branch');
+            expect(gitVersionTypeMapper.toString(GitVersionType.Commit)).toBe('commit');
+            expect(gitVersionTypeMapper.toString(GitVersionType.Tag)).toBe('tag');
+        });
+    });
+});
+//# sourceMappingURL=index.spec.unit.js.map

package/dist/shared/enums/index.spec.unit.js.map

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

package/dist/shared/errors/azure-devops-errors.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Base error class for Azure DevOps API errors.
+ * All specific Azure DevOps errors should extend this class.
+ *
+ * @class AzureDevOpsError
+ * @extends {Error}
+ */
+export declare class AzureDevOpsError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when authentication with Azure DevOps fails.
+ * This can occur due to invalid credentials, expired tokens, or network issues.
+ *
+ * @class AzureDevOpsAuthenticationError
+ * @extends {AzureDevOpsError}
+ */
+export declare class AzureDevOpsAuthenticationError extends AzureDevOpsError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Type for API response error details
+ */
+export type ApiErrorResponse = {
+    message?: string;
+    statusCode?: number;
+    details?: unknown;
+    [key: string]: unknown;
+};
+/**
+ * Error thrown when input validation fails.
+ * This includes invalid parameters, malformed requests, or missing required fields.
+ *
+ * @class AzureDevOpsValidationError
+ * @extends {AzureDevOpsError}
+ * @property {ApiErrorResponse} [response] - The raw response from the API containing validation details
+ */
+export declare class AzureDevOpsValidationError extends AzureDevOpsError {
+    response?: ApiErrorResponse;
+    constructor(message: string, response?: ApiErrorResponse, options?: ErrorOptions);
+}
+/**
+ * Error thrown when a requested resource is not found.
+ * This can occur when trying to access non-existent projects, repositories, or work items.
+ *
+ * @class AzureDevOpsResourceNotFoundError
+ * @extends {AzureDevOpsError}
+ */
+export declare class AzureDevOpsResourceNotFoundError extends AzureDevOpsError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when the user lacks permissions for an operation.
+ * This occurs when trying to access or modify resources without proper authorization.
+ *
+ * @class AzureDevOpsPermissionError
+ * @extends {AzureDevOpsError}
+ */
+export declare class AzureDevOpsPermissionError extends AzureDevOpsError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when the API rate limit is exceeded.
+ * Contains information about when the rate limit will reset.
+ *
+ * @class AzureDevOpsRateLimitError
+ * @extends {AzureDevOpsError}
+ * @property {Date} resetAt - The time when the rate limit will reset
+ */
+export declare class AzureDevOpsRateLimitError extends AzureDevOpsError {
+    resetAt: Date;
+    constructor(message: string, resetAt: Date, options?: ErrorOptions);
+}
+/**
+ * Helper function to check if an error is an Azure DevOps error.
+ * Useful for type narrowing in catch blocks.
+ *
+ * @param {unknown} error - The error to check
+ * @returns {boolean} True if the error is an Azure DevOps error
+ *
+ * @example
+ * try {
+ *   // Some Azure DevOps operation
+ * } catch (error) {
+ *   if (isAzureDevOpsError(error)) {
+ *     // Handle Azure DevOps specific error
+ *   } else {
+ *     // Handle other errors
+ *   }
+ * }
+ */
+export declare function isAzureDevOpsError(error: unknown): error is AzureDevOpsError;
+/**
+ * Format an Azure DevOps error for display.
+ * Provides a consistent error message format across different error types.
+ *
+ * @param {unknown} error - The error to format
+ * @returns {string} A formatted error message
+ *
+ * @example
+ * try {
+ *   // Some Azure DevOps operation
+ * } catch (error) {
+ *   console.error(formatAzureDevOpsError(error));
+ * }
+ */
+export declare function formatAzureDevOpsError(error: unknown): string;

package/dist/shared/errors/azure-devops-errors.js

@@ -0,0 +1,150 @@
+/**
+ * Base error class for Azure DevOps API errors.
+ * All specific Azure DevOps errors should extend this class.
+ *
+ * @class AzureDevOpsError
+ * @extends {Error}
+ */
+export class AzureDevOpsError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'AzureDevOpsError';
+    }
+}
+/**
+ * Error thrown when authentication with Azure DevOps fails.
+ * This can occur due to invalid credentials, expired tokens, or network issues.
+ *
+ * @class AzureDevOpsAuthenticationError
+ * @extends {AzureDevOpsError}
+ */
+export class AzureDevOpsAuthenticationError extends AzureDevOpsError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'AzureDevOpsAuthenticationError';
+    }
+}
+/**
+ * Error thrown when input validation fails.
+ * This includes invalid parameters, malformed requests, or missing required fields.
+ *
+ * @class AzureDevOpsValidationError
+ * @extends {AzureDevOpsError}
+ * @property {ApiErrorResponse} [response] - The raw response from the API containing validation details
+ */
+export class AzureDevOpsValidationError extends AzureDevOpsError {
+    response;
+    constructor(message, response, options) {
+        super(message, options);
+        this.name = 'AzureDevOpsValidationError';
+        this.response = response;
+    }
+}
+/**
+ * Error thrown when a requested resource is not found.
+ * This can occur when trying to access non-existent projects, repositories, or work items.
+ *
+ * @class AzureDevOpsResourceNotFoundError
+ * @extends {AzureDevOpsError}
+ */
+export class AzureDevOpsResourceNotFoundError extends AzureDevOpsError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'AzureDevOpsResourceNotFoundError';
+    }
+}
+/**
+ * Error thrown when the user lacks permissions for an operation.
+ * This occurs when trying to access or modify resources without proper authorization.
+ *
+ * @class AzureDevOpsPermissionError
+ * @extends {AzureDevOpsError}
+ */
+export class AzureDevOpsPermissionError extends AzureDevOpsError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'AzureDevOpsPermissionError';
+    }
+}
+/**
+ * Error thrown when the API rate limit is exceeded.
+ * Contains information about when the rate limit will reset.
+ *
+ * @class AzureDevOpsRateLimitError
+ * @extends {AzureDevOpsError}
+ * @property {Date} resetAt - The time when the rate limit will reset
+ */
+export class AzureDevOpsRateLimitError extends AzureDevOpsError {
+    resetAt;
+    constructor(message, resetAt, options) {
+        super(message, options);
+        this.name = 'AzureDevOpsRateLimitError';
+        this.resetAt = resetAt;
+    }
+}
+/**
+ * Helper function to check if an error is an Azure DevOps error.
+ * Useful for type narrowing in catch blocks.
+ *
+ * @param {unknown} error - The error to check
+ * @returns {boolean} True if the error is an Azure DevOps error
+ *
+ * @example
+ * try {
+ *   // Some Azure DevOps operation
+ * } catch (error) {
+ *   if (isAzureDevOpsError(error)) {
+ *     // Handle Azure DevOps specific error
+ *   } else {
+ *     // Handle other errors
+ *   }
+ * }
+ */
+export function isAzureDevOpsError(error) {
+    return error instanceof AzureDevOpsError;
+}
+/**
+ * Format an Azure DevOps error for display.
+ * Provides a consistent error message format across different error types.
+ *
+ * @param {unknown} error - The error to format
+ * @returns {string} A formatted error message
+ *
+ * @example
+ * try {
+ *   // Some Azure DevOps operation
+ * } catch (error) {
+ *   console.error(formatAzureDevOpsError(error));
+ * }
+ */
+export function formatAzureDevOpsError(error) {
+    // Handle non-error objects
+    if (error === null) {
+        return 'null';
+    }
+    if (error === undefined) {
+        return 'undefined';
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (typeof error === 'number' || typeof error === 'boolean') {
+        return String(error);
+    }
+    // Handle error-like objects
+    const errorObj = error;
+    let message = `${errorObj.name || 'Unknown'}: ${errorObj.message || 'Unknown error'}`;
+    if (error instanceof AzureDevOpsValidationError) {
+        if (error.response) {
+            message += `\nResponse: ${JSON.stringify(error.response)}`;
+        }
+        else {
+            message += '\nNo response details available';
+        }
+    }
+    else if (error instanceof AzureDevOpsRateLimitError) {
+        message += `\nReset at: ${error.resetAt.toISOString()}`;
+    }
+    return message;
+}
+//# sourceMappingURL=azure-devops-errors.js.map

package/dist/shared/errors/azure-devops-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-devops-errors.js","sourceRoot":"","sources":["../../../src/shared/errors/azure-devops-errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,8BAA+B,SAAQ,gBAAgB;IAClE,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAYD;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IAC9D,QAAQ,CAAoB;IAE5B,YACE,OAAe,EACf,QAA2B,EAC3B,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,gCAAiC,SAAQ,gBAAgB;IACpE,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAC7D,OAAO,CAAO;IAEd,YAAY,OAAe,EAAE,OAAa,EAAE,OAAsB;QAChE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,gBAAgB,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,2BAA2B;IAC3B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,KAAgC,CAAC;IAClD,IAAI,OAAO,GAAG,GAAG,QAAQ,CAAC,IAAI,IAAI,SAAS,KAAK,QAAQ,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;IAEtF,IAAI,KAAK,YAAY,0BAA0B,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,iCAAiC,CAAC;QAC/C,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;QACtD,OAAO,IAAI,eAAe,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;IAC1D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/shared/errors/handle-request-error.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Centralized error handler for Azure DevOps API requests.
+ * This function takes an error caught in a try-catch block and converts it
+ * into an appropriate AzureDevOpsError subtype with a user-friendly message.
+ *
+ * @param error - The caught error to handle
+ * @param context - Additional context about the operation being performed
+ * @returns Never - This function always throws an error
+ * @throws {AzureDevOpsError} - Always throws a subclass of AzureDevOpsError
+ *
+ * @example
+ * try {
+ *   // Some Azure DevOps API call
+ * } catch (error) {
+ *   handleRequestError(error, 'getting work item details');
+ * }
+ */
+export declare function handleRequestError(error: unknown, context: string): never;
+/**
+ * Handles errors from feature request handlers and returns a formatted response
+ * instead of throwing an error. This is used in the server's request handlers.
+ *
+ * @param error The error to handle
+ * @returns A formatted error response
+ */
+export declare function handleResponseError(error: unknown): {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+};

package/dist/shared/errors/handle-request-error.js

@@ -0,0 +1,91 @@
+import { AzureDevOpsError, AzureDevOpsValidationError, AzureDevOpsResourceNotFoundError, AzureDevOpsAuthenticationError, AzureDevOpsPermissionError, isAzureDevOpsError, } from './azure-devops-errors';
+import axios from 'axios';
+// Create a safe console logging function that won't interfere with MCP protocol
+function safeLog(message) {
+    process.stderr.write(`${message}\n`);
+}
+/**
+ * Format an Azure DevOps error for display
+ *
+ * @param error The error to format
+ * @returns Formatted error message
+ */
+function formatAzureDevOpsError(error) {
+    let message = `Azure DevOps API Error: ${error.message}`;
+    if (error instanceof AzureDevOpsValidationError) {
+        message = `Validation Error: ${error.message}`;
+    }
+    else if (error instanceof AzureDevOpsResourceNotFoundError) {
+        message = `Not Found: ${error.message}`;
+    }
+    else if (error instanceof AzureDevOpsAuthenticationError) {
+        message = `Authentication Failed: ${error.message}`;
+    }
+    else if (error instanceof AzureDevOpsPermissionError) {
+        message = `Permission Denied: ${error.message}`;
+    }
+    return message;
+}
+/**
+ * Centralized error handler for Azure DevOps API requests.
+ * This function takes an error caught in a try-catch block and converts it
+ * into an appropriate AzureDevOpsError subtype with a user-friendly message.
+ *
+ * @param error - The caught error to handle
+ * @param context - Additional context about the operation being performed
+ * @returns Never - This function always throws an error
+ * @throws {AzureDevOpsError} - Always throws a subclass of AzureDevOpsError
+ *
+ * @example
+ * try {
+ *   // Some Azure DevOps API call
+ * } catch (error) {
+ *   handleRequestError(error, 'getting work item details');
+ * }
+ */
+export function handleRequestError(error, context) {
+    // If it's already an AzureDevOpsError, rethrow it
+    if (error instanceof AzureDevOpsError) {
+        throw error;
+    }
+    // Handle Axios errors
+    if (axios.isAxiosError(error)) {
+        const axiosError = error;
+        const status = axiosError.response?.status;
+        const data = axiosError.response?.data;
+        const message = data?.message || axiosError.message;
+        switch (status) {
+            case 400:
+                throw new AzureDevOpsValidationError(`Invalid request while ${context}: ${message}`, data, { cause: error });
+            case 401:
+                throw new AzureDevOpsAuthenticationError(`Authentication failed while ${context}: ${message}`, { cause: error });
+            case 403:
+                throw new AzureDevOpsPermissionError(`Permission denied while ${context}: ${message}`, { cause: error });
+            case 404:
+                throw new AzureDevOpsResourceNotFoundError(`Resource not found while ${context}: ${message}`, { cause: error });
+            default:
+                throw new AzureDevOpsError(`Failed while ${context}: ${message}`, {
+                    cause: error,
+                });
+        }
+    }
+    // Handle all other errors
+    throw new AzureDevOpsError(`Unexpected error while ${context}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+}
+/**
+ * Handles errors from feature request handlers and returns a formatted response
+ * instead of throwing an error. This is used in the server's request handlers.
+ *
+ * @param error The error to handle
+ * @returns A formatted error response
+ */
+export function handleResponseError(error) {
+    safeLog(`Error handling request: ${error}`);
+    const errorMessage = isAzureDevOpsError(error)
+        ? formatAzureDevOpsError(error)
+        : `Error: ${error instanceof Error ? error.message : String(error)}`;
+    return {
+        content: [{ type: 'text', text: errorMessage }],
+    };
+}
+//# sourceMappingURL=handle-request-error.js.map

package/dist/shared/errors/handle-request-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-request-error.js","sourceRoot":"","sources":["../../../src/shared/errors/handle-request-error.ts"],"names":[],"mappings":"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"}

package/dist/shared/errors/index.d.ts

@@ -0,0 +1 @@
+export * from './azure-devops-errors';

package/dist/shared/errors/index.js

@@ -0,0 +1,2 @@
+export * from './azure-devops-errors';
+//# sourceMappingURL=index.js.map

package/dist/shared/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/shared/test/test-helpers.d.ts

@@ -0,0 +1,20 @@
+import { WebApi } from 'azure-devops-node-api';
+import { AzureDevOpsConfig } from '../types';
+/**
+ * Creates a WebApi connection for tests with real credentials
+ *
+ * @returns WebApi connection
+ */
+export declare function getTestConnection(): Promise<WebApi | null>;
+/**
+ * Creates test configuration for Azure DevOps tests
+ *
+ * @returns Azure DevOps config
+ */
+export declare function getTestConfig(): AzureDevOpsConfig | null;
+/**
+ * Determines if integration tests should be skipped
+ *
+ * @returns true if integration tests should be skipped
+ */
+export declare function shouldSkipIntegrationTest(): boolean;

package/dist/shared/test/test-helpers.js

@@ -0,0 +1,52 @@
+import { WebApi } from 'azure-devops-node-api';
+import { getPersonalAccessTokenHandler } from 'azure-devops-node-api';
+import { AuthenticationMethod } from '../auth';
+/**
+ * Creates a WebApi connection for tests with real credentials
+ *
+ * @returns WebApi connection
+ */
+export async function getTestConnection() {
+    // If we have real credentials, use them
+    const orgUrl = process.env.AZURE_DEVOPS_ORG_URL;
+    const token = process.env.AZURE_DEVOPS_PAT;
+    if (orgUrl && token) {
+        const authHandler = getPersonalAccessTokenHandler(token);
+        return new WebApi(orgUrl, authHandler);
+    }
+    // If we don't have credentials, return null
+    return null;
+}
+/**
+ * Creates test configuration for Azure DevOps tests
+ *
+ * @returns Azure DevOps config
+ */
+export function getTestConfig() {
+    // If we have real credentials, use them
+    const orgUrl = process.env.AZURE_DEVOPS_ORG_URL;
+    const pat = process.env.AZURE_DEVOPS_PAT;
+    if (orgUrl && pat) {
+        return {
+            organizationUrl: orgUrl,
+            authMethod: AuthenticationMethod.PersonalAccessToken,
+            personalAccessToken: pat,
+            defaultProject: process.env.AZURE_DEVOPS_DEFAULT_PROJECT,
+        };
+    }
+    // If we don't have credentials, return null
+    return null;
+}
+/**
+ * Determines if integration tests should be skipped
+ *
+ * @returns true if integration tests should be skipped
+ */
+export function shouldSkipIntegrationTest() {
+    if (!process.env.AZURE_DEVOPS_ORG_URL || !process.env.AZURE_DEVOPS_PAT) {
+        console.log('Skipping integration test: No real Azure DevOps connection available');
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/shared/test/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../../src/shared/test/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,wCAAwC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAE3C,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,4CAA4C;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,wCAAwC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAEzC,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,OAAO;YACL,eAAe,EAAE,MAAM;YACvB,UAAU,EAAE,oBAAoB,CAAC,mBAAmB;YACpD,mBAAmB,EAAE,GAAG;YACxB,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B;SACzD,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB;IACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACvE,OAAO,CAAC,GAAG,CACT,sEAAsE,CACvE,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}