@vm3jack/mcp-server-azure-devops 1.0.0

package/dist/features/pipelines/trigger-pipeline/feature.spec.unit.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const feature_1 = require("./feature");
+const errors_1 = require("../../../shared/errors");
+// Unit tests should only focus on isolated logic
+describe('triggerPipeline unit', () => {
+    let mockConnection;
+    let mockPipelinesApi;
+    beforeEach(() => {
+        // Reset mocks
+        jest.resetAllMocks();
+        // Mock WebApi with a server URL
+        mockConnection = {
+            serverUrl: 'https://dev.azure.com/testorg',
+        };
+        // Mock the getPipelinesApi method
+        mockPipelinesApi = {
+            runPipeline: jest.fn(),
+        };
+        mockConnection.getPipelinesApi = jest
+            .fn()
+            .mockResolvedValue(mockPipelinesApi);
+    });
+    test('should trigger a pipeline with basic options', async () => {
+        // Arrange
+        const mockRun = { id: 123, name: 'Run 123' };
+        mockPipelinesApi.runPipeline.mockResolvedValue(mockRun);
+        // Act
+        const result = await (0, feature_1.triggerPipeline)(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 4,
+            branch: 'main',
+        });
+        // Assert
+        expect(mockConnection.getPipelinesApi).toHaveBeenCalled();
+        expect(mockPipelinesApi.runPipeline).toHaveBeenCalledWith(expect.objectContaining({
+            resources: {
+                repositories: {
+                    self: {
+                        refName: 'refs/heads/main',
+                    },
+                },
+            },
+        }), 'testproject', 4);
+        expect(result).toBe(mockRun);
+    });
+    test('should trigger a pipeline with variables', async () => {
+        // Arrange
+        const mockRun = { id: 123, name: 'Run 123' };
+        mockPipelinesApi.runPipeline.mockResolvedValue(mockRun);
+        // Act
+        const result = await (0, feature_1.triggerPipeline)(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 4,
+            variables: {
+                var1: { value: 'value1' },
+                var2: { value: 'value2', isSecret: true },
+            },
+        });
+        // Assert
+        expect(mockPipelinesApi.runPipeline).toHaveBeenCalledWith(expect.objectContaining({
+            variables: {
+                var1: { value: 'value1' },
+                var2: { value: 'value2', isSecret: true },
+            },
+        }), 'testproject', 4);
+        expect(result).toBe(mockRun);
+    });
+    test('should handle authentication errors', async () => {
+        // Arrange
+        const authError = new Error('Authentication failed');
+        mockPipelinesApi.runPipeline.mockRejectedValue(authError);
+        // Act & Assert
+        await expect((0, feature_1.triggerPipeline)(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 4,
+        })).rejects.toThrow(errors_1.AzureDevOpsAuthenticationError);
+        await expect((0, feature_1.triggerPipeline)(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 4,
+        })).rejects.toThrow('Failed to authenticate');
+    });
+    test('should handle resource not found errors', async () => {
+        // Arrange
+        const notFoundError = new Error('Pipeline not found');
+        mockPipelinesApi.runPipeline.mockRejectedValue(notFoundError);
+        // Act & Assert
+        await expect((0, feature_1.triggerPipeline)(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 999,
+        })).rejects.toThrow(errors_1.AzureDevOpsResourceNotFoundError);
+        await expect((0, feature_1.triggerPipeline)(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 999,
+        })).rejects.toThrow('Pipeline or project not found');
+    });
+    test('should wrap other errors', async () => {
+        // Arrange
+        const testError = new Error('Some other error');
+        mockPipelinesApi.runPipeline.mockRejectedValue(testError);
+        // Act & Assert
+        await expect((0, feature_1.triggerPipeline)(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 4,
+        })).rejects.toThrow(errors_1.AzureDevOpsError);
+        await expect((0, feature_1.triggerPipeline)(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 4,
+        })).rejects.toThrow('Failed to trigger pipeline');
+    });
+});
+//# sourceMappingURL=feature.spec.unit.js.map

package/dist/features/pipelines/trigger-pipeline/feature.spec.unit.js.map

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

package/dist/features/pipelines/trigger-pipeline/index.d.ts

@@ -0,0 +1,2 @@
+export { triggerPipeline } from './feature';
+export { TriggerPipelineSchema } from './schema';

package/dist/features/pipelines/trigger-pipeline/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriggerPipelineSchema = exports.triggerPipeline = void 0;
+var feature_1 = require("./feature");
+Object.defineProperty(exports, "triggerPipeline", { enumerable: true, get: function () { return feature_1.triggerPipeline; } });
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "TriggerPipelineSchema", { enumerable: true, get: function () { return schema_1.TriggerPipelineSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/features/pipelines/trigger-pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/features/pipelines/trigger-pipeline/index.ts"],"names":[],"mappings":";;;AAAA,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,mCAAiD;AAAxC,+GAAA,qBAAqB,OAAA"}

package/dist/features/pipelines/trigger-pipeline/schema.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * Schema for the triggerPipeline function
+ */
+export declare const TriggerPipelineSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    pipelineId: z.ZodNumber;
+    branch: z.ZodOptional<z.ZodString>;
+    variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        value: z.ZodString;
+        isSecret: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        isSecret?: boolean | undefined;
+    }, {
+        value: string;
+        isSecret?: boolean | undefined;
+    }>>>;
+    templateParameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    stagesToSkip: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    pipelineId: number;
+    projectId?: string | undefined;
+    branch?: string | undefined;
+    templateParameters?: Record<string, string> | undefined;
+    variables?: Record<string, {
+        value: string;
+        isSecret?: boolean | undefined;
+    }> | undefined;
+    stagesToSkip?: string[] | undefined;
+}, {
+    pipelineId: number;
+    projectId?: string | undefined;
+    branch?: string | undefined;
+    templateParameters?: Record<string, string> | undefined;
+    variables?: Record<string, {
+        value: string;
+        isSecret?: boolean | undefined;
+    }> | undefined;
+    stagesToSkip?: string[] | undefined;
+}>;

package/dist/features/pipelines/trigger-pipeline/schema.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriggerPipelineSchema = void 0;
+const zod_1 = require("zod");
+const environment_1 = require("../../../utils/environment");
+/**
+ * Schema for the triggerPipeline function
+ */
+exports.TriggerPipelineSchema = zod_1.z.object({
+    // The project containing the pipeline
+    projectId: zod_1.z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${environment_1.defaultProject})`),
+    // The ID of the pipeline to trigger
+    pipelineId: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .describe('The numeric ID of the pipeline to trigger'),
+    // The branch to run the pipeline on
+    branch: zod_1.z
+        .string()
+        .optional()
+        .describe('The branch to run the pipeline on (e.g., "main", "feature/my-branch"). If left empty, the default branch will be used'),
+    // Variables to pass to the pipeline run
+    variables: zod_1.z
+        .record(zod_1.z.object({
+        value: zod_1.z.string(),
+        isSecret: zod_1.z.boolean().optional(),
+    }))
+        .optional()
+        .describe('Variables to pass to the pipeline run'),
+    // Parameters for template-based pipelines
+    templateParameters: zod_1.z
+        .record(zod_1.z.string())
+        .optional()
+        .describe('Parameters for template-based pipelines'),
+    // Stages to skip in the pipeline run
+    stagesToSkip: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('Stages to skip in the pipeline run'),
+});
+//# sourceMappingURL=schema.js.map

package/dist/features/pipelines/trigger-pipeline/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/features/pipelines/trigger-pipeline/schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4DAA4D;AAE5D;;GAEG;AACU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,sCAAsC;IACtC,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,4BAAc,GAAG,CAAC;IACzE,oCAAoC;IACpC,UAAU,EAAE,OAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;IACxD,oCAAoC;IACpC,MAAM,EAAE,OAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uHAAuH,CACxH;IACH,wCAAwC;IACxC,SAAS,EAAE,OAAC;SACT,MAAM,CACL,OAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;QACjB,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC,CACH;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,0CAA0C;IAC1C,kBAAkB,EAAE,OAAC;SAClB,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SAClB,QAAQ,EAAE;SACV,QAAQ,CAAC,yCAAyC,CAAC;IACtD,qCAAqC;IACrC,YAAY,EAAE,OAAC;SACZ,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAC,CAAC"}

package/dist/features/pipelines/types.d.ts

@@ -0,0 +1,122 @@
+import { Pipeline, Run } from 'azure-devops-node-api/interfaces/PipelinesInterfaces';
+/**
+ * Options for listing pipelines
+ */
+export interface ListPipelinesOptions {
+    projectId: string;
+    orderBy?: string;
+    top?: number;
+    continuationToken?: string;
+}
+/**
+ * Options for getting a pipeline
+ */
+export interface GetPipelineOptions {
+    projectId: string;
+    organizationId?: string;
+    pipelineId: number;
+    pipelineVersion?: number;
+}
+/**
+ * Options for triggering a pipeline
+ */
+export interface TriggerPipelineOptions {
+    projectId: string;
+    pipelineId: number;
+    branch?: string;
+    variables?: Record<string, {
+        value: string;
+        isSecret?: boolean;
+    }>;
+    templateParameters?: Record<string, string>;
+    stagesToSkip?: string[];
+}
+/**
+ * Options for listing runs of a pipeline
+ */
+export interface ListPipelineRunsOptions {
+    projectId: string;
+    pipelineId: number;
+    top?: number;
+    continuationToken?: string;
+    branch?: string;
+    state?: 'notStarted' | 'inProgress' | 'completed' | 'cancelling' | 'postponed';
+    result?: 'succeeded' | 'partiallySucceeded' | 'failed' | 'canceled' | 'none';
+    createdFrom?: string;
+    createdTo?: string;
+    orderBy?: 'createdDate desc' | 'createdDate asc';
+}
+/**
+ * Result of listing pipeline runs
+ */
+export interface ListPipelineRunsResult {
+    runs: Run[];
+    continuationToken?: string;
+}
+/**
+ * Options for retrieving a single pipeline run
+ */
+export interface GetPipelineRunOptions {
+    projectId: string;
+    runId: number;
+    pipelineId?: number;
+}
+export interface PipelineArtifactItem {
+    path: string;
+    itemType: 'file' | 'folder';
+    size?: number;
+}
+export interface PipelineRunArtifact {
+    name: string;
+    type?: string;
+    source?: string;
+    downloadUrl?: string;
+    resourceUrl?: string;
+    containerId?: number;
+    rootPath?: string;
+    signedContentUrl?: string;
+    /** Sorted list of files/folders discovered inside the artifact */
+    items?: PipelineArtifactItem[];
+    /** Indicates the artifact has more items than were returned */
+    itemsTruncated?: boolean;
+}
+export interface PipelineRunDetails extends Run {
+    artifacts?: PipelineRunArtifact[];
+}
+export interface DownloadPipelineArtifactOptions {
+    projectId: string;
+    runId: number;
+    artifactPath: string;
+    pipelineId?: number;
+}
+export interface PipelineArtifactContent {
+    artifact: string;
+    path: string;
+    content: string;
+}
+/**
+ * Options for retrieving the timeline of a pipeline run
+ */
+export interface GetPipelineTimelineOptions {
+    projectId: string;
+    runId: number;
+    timelineId?: string;
+    pipelineId?: number;
+    state?: string | string[];
+    result?: string | string[];
+}
+export type PipelineTimeline = Record<string, unknown>;
+/**
+ * Options for retrieving a specific pipeline log
+ */
+export interface GetPipelineLogOptions {
+    projectId: string;
+    runId: number;
+    logId: number;
+    pipelineId?: number;
+    format?: 'plain' | 'json';
+    startLine?: number;
+    endLine?: number;
+}
+export type PipelineLogContent = unknown;
+export { Pipeline, Run };

package/dist/features/pipelines/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/features/pipelines/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/pipelines/types.ts"],"names":[],"mappings":""}

package/dist/features/projects/__test__/test-helpers.d.ts

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

package/dist/features/projects/__test__/test-helpers.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTestConnection = getTestConnection;
+exports.shouldSkipIntegrationTest = shouldSkipIntegrationTest;
+const azure_devops_node_api_1 = require("azure-devops-node-api");
+const azure_devops_node_api_2 = require("azure-devops-node-api");
+/**
+ * Creates a WebApi connection for tests with real credentials
+ *
+ * @returns WebApi connection
+ */
+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 = (0, azure_devops_node_api_2.getPersonalAccessTokenHandler)(token);
+        return new azure_devops_node_api_1.WebApi(orgUrl, authHandler);
+    }
+    // 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
+ */
+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/features/projects/__test__/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../../../src/features/projects/__test__/test-helpers.ts"],"names":[],"mappings":";;AAQA,8CAYC;AAOD,8DAQC;AAnCD,iEAA+C;AAC/C,iEAAsE;AAEtE;;;;GAIG;AACI,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,IAAA,qDAA6B,EAAC,KAAK,CAAC,CAAC;QACzD,OAAO,IAAI,8BAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,4CAA4C;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,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"}

package/dist/features/projects/get-project/feature.d.ts

@@ -0,0 +1,11 @@
+import { WebApi } from 'azure-devops-node-api';
+import { TeamProject } from '../types';
+/**
+ * Get a project by ID or name
+ *
+ * @param connection The Azure DevOps WebApi connection
+ * @param projectId The ID or name of the project
+ * @returns The project details
+ * @throws {AzureDevOpsResourceNotFoundError} If the project is not found
+ */
+export declare function getProject(connection: WebApi, projectId: string): Promise<TeamProject>;

package/dist/features/projects/get-project/feature.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProject = getProject;
+const errors_1 = require("../../../shared/errors");
+/**
+ * Get a project by ID or name
+ *
+ * @param connection The Azure DevOps WebApi connection
+ * @param projectId The ID or name of the project
+ * @returns The project details
+ * @throws {AzureDevOpsResourceNotFoundError} If the project is not found
+ */
+async function getProject(connection, projectId) {
+    try {
+        const coreApi = await connection.getCoreApi();
+        const project = await coreApi.getProject(projectId);
+        if (!project) {
+            throw new errors_1.AzureDevOpsResourceNotFoundError(`Project '${projectId}' not found`);
+        }
+        return project;
+    }
+    catch (error) {
+        if (error instanceof errors_1.AzureDevOpsError) {
+            throw error;
+        }
+        throw new Error(`Failed to get project: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=feature.js.map

package/dist/features/projects/get-project/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/features/projects/get-project/feature.ts"],"names":[],"mappings":";;AAeA,gCAuBC;AArCD,mDAGgC;AAGhC;;;;;;;GAOG;AACI,KAAK,UAAU,UAAU,CAC9B,UAAkB,EAClB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAEpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,yCAAgC,CACxC,YAAY,SAAS,aAAa,CACnC,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,yBAAgB,EAAE,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,KAAK,CACb,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/projects/get-project/feature.spec.int.d.ts

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

package/dist/features/projects/get-project/feature.spec.int.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const feature_1 = require("./feature");
+const test_helpers_1 = require("@/shared/test/test-helpers");
+const shouldSkip = (0, test_helpers_1.shouldSkipIntegrationTest)();
+const describeOrSkip = shouldSkip ? describe.skip : describe;
+describeOrSkip('getProject integration', () => {
+    let connection;
+    let projectName;
+    beforeAll(async () => {
+        // Get a real connection using environment variables
+        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 || 'DefaultProject';
+    });
+    test('should retrieve a real project from Azure DevOps', async () => {
+        // Act - make an actual API call to Azure DevOps
+        const result = await (0, feature_1.getProject)(connection, projectName);
+        // Assert on the actual response
+        expect(result).toBeDefined();
+        expect(result.name).toBe(projectName);
+        expect(result.id).toBeDefined();
+        expect(result.url).toBeDefined();
+        expect(result.state).toBeDefined();
+        // Verify basic project structure
+        expect(result.visibility).toBeDefined();
+        expect(result.lastUpdateTime).toBeDefined();
+    });
+    test('should throw error when project is not found', async () => {
+        // Use a non-existent project name
+        const nonExistentProjectName = 'non-existent-project-' + Date.now();
+        // Act & Assert - should throw an error for non-existent project
+        await expect((0, feature_1.getProject)(connection, nonExistentProjectName)).rejects.toThrow(/not found|Failed to get project/);
+    });
+});
+//# sourceMappingURL=feature.spec.int.js.map

package/dist/features/projects/get-project/feature.spec.int.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.spec.int.js","sourceRoot":"","sources":["../../../../src/features/projects/get-project/feature.spec.int.ts"],"names":[],"mappings":";;AACA,uCAAuC;AACvC,6DAGoC;AAEpC,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,wBAAwB,EAAE,GAAG,EAAE;IAC5C,IAAI,UAAkB,CAAC;IACvB,IAAI,WAAmB,CAAC;IAExB,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,oDAAoD;QACpD,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;QAC5B,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,gBAAgB,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAClE,gDAAgD;QAChD,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAU,EAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAEzD,gCAAgC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAEnC,iCAAiC;QACjC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC9D,kCAAkC;QAClC,MAAM,sBAAsB,GAAG,uBAAuB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEpE,gEAAgE;QAChE,MAAM,MAAM,CACV,IAAA,oBAAU,EAAC,UAAU,EAAE,sBAAsB,CAAC,CAC/C,CAAC,OAAO,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/features/projects/get-project/feature.spec.unit.d.ts

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

package/dist/features/projects/get-project/feature.spec.unit.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const feature_1 = require("./feature");
+const errors_1 = require("../../../shared/errors");
+// Unit tests should only focus on isolated logic
+describe('getProject unit', () => {
+    test('should throw resource not found error when project is null', async () => {
+        // Arrange
+        const mockCoreApi = {
+            getProject: jest.fn().mockResolvedValue(null), // Simulate project not found
+        };
+        const mockConnection = {
+            getCoreApi: jest.fn().mockResolvedValue(mockCoreApi),
+        };
+        // Act & Assert
+        await expect((0, feature_1.getProject)(mockConnection, 'non-existent-project')).rejects.toThrow(errors_1.AzureDevOpsResourceNotFoundError);
+        await expect((0, feature_1.getProject)(mockConnection, 'non-existent-project')).rejects.toThrow("Project 'non-existent-project' not found");
+    });
+    test('should propagate custom errors when thrown internally', async () => {
+        // Arrange
+        const mockConnection = {
+            getCoreApi: jest.fn().mockImplementation(() => {
+                throw new errors_1.AzureDevOpsError('Custom error');
+            }),
+        };
+        // Act & Assert
+        await expect((0, feature_1.getProject)(mockConnection, 'test-project')).rejects.toThrow(errors_1.AzureDevOpsError);
+        await expect((0, feature_1.getProject)(mockConnection, 'test-project')).rejects.toThrow('Custom error');
+    });
+    test('should wrap unexpected errors in a friendly error message', async () => {
+        // Arrange
+        const mockConnection = {
+            getCoreApi: jest.fn().mockImplementation(() => {
+                throw new Error('Unexpected error');
+            }),
+        };
+        // Act & Assert
+        await expect((0, feature_1.getProject)(mockConnection, 'test-project')).rejects.toThrow('Failed to get project: Unexpected error');
+    });
+});
+//# sourceMappingURL=feature.spec.unit.js.map

package/dist/features/projects/get-project/feature.spec.unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.spec.unit.js","sourceRoot":"","sources":["../../../../src/features/projects/get-project/feature.spec.unit.ts"],"names":[],"mappings":";;AAAA,uCAAuC;AACvC,mDAGgC;AAkBhC,iDAAiD;AACjD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC5E,UAAU;QACV,MAAM,WAAW,GAAgB;YAC/B,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,6BAA6B;SAC7E,CAAC;QAEF,MAAM,cAAc,GAAmB;YACrC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,WAAW,CAAC;SACrD,CAAC;QAEF,eAAe;QACf,MAAM,MAAM,CACV,IAAA,oBAAU,EAAC,cAAmC,EAAE,sBAAsB,CAAC,CACxE,CAAC,OAAO,CAAC,OAAO,CAAC,yCAAgC,CAAC,CAAC;QAEpD,MAAM,MAAM,CACV,IAAA,oBAAU,EAAC,cAAmC,EAAE,sBAAsB,CAAC,CACxE,CAAC,OAAO,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACvE,UAAU;QACV,MAAM,cAAc,GAAmB;YACrC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBAC5C,MAAM,IAAI,yBAAgB,CAAC,cAAc,CAAC,CAAC;YAC7C,CAAC,CAAC;SACH,CAAC;QAEF,eAAe;QACf,MAAM,MAAM,CACV,IAAA,oBAAU,EAAC,cAAmC,EAAE,cAAc,CAAC,CAChE,CAAC,OAAO,CAAC,OAAO,CAAC,yBAAgB,CAAC,CAAC;QAEpC,MAAM,MAAM,CACV,IAAA,oBAAU,EAAC,cAAmC,EAAE,cAAc,CAAC,CAChE,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC3E,UAAU;QACV,MAAM,cAAc,GAAmB;YACrC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBAC5C,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACtC,CAAC,CAAC;SACH,CAAC;QAEF,eAAe;QACf,MAAM,MAAM,CACV,IAAA,oBAAU,EAAC,cAAmC,EAAE,cAAc,CAAC,CAChE,CAAC,OAAO,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/features/projects/get-project/index.d.ts

@@ -0,0 +1,2 @@
+export * from './schema';
+export * from './feature';

package/dist/features/projects/get-project/index.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./schema"), exports);
+__exportStar(require("./feature"), exports);
+//# sourceMappingURL=index.js.map

package/dist/features/projects/get-project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/features/projects/get-project/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B"}

package/dist/features/projects/get-project/schema.d.ts

@@ -0,0 +1,2 @@
+import { GetProjectSchema } from '../schemas';
+export { GetProjectSchema };

package/dist/features/projects/get-project/schema.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetProjectSchema = void 0;
+const schemas_1 = require("../schemas");
+Object.defineProperty(exports, "GetProjectSchema", { enumerable: true, get: function () { return schemas_1.GetProjectSchema; } });
+//# sourceMappingURL=schema.js.map

package/dist/features/projects/get-project/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/features/projects/get-project/schema.ts"],"names":[],"mappings":";;;AAAA,wCAA8C;AAErC,iGAFA,0BAAgB,OAEA"}