mcp-server-azure-devops 1.1.0

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

@@ -0,0 +1,10 @@
+import { WebApi } from 'azure-devops-node-api';
+import { Run, TriggerPipelineOptions } from '../types';
+/**
+ * Trigger a pipeline run
+ *
+ * @param connection The Azure DevOps WebApi connection
+ * @param options Options for triggering a pipeline
+ * @returns The run details
+ */
+export declare function triggerPipeline(connection: WebApi, options: TriggerPipelineOptions): Promise<Run>;

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

@@ -0,0 +1,62 @@
+import { AzureDevOpsError, AzureDevOpsAuthenticationError, AzureDevOpsResourceNotFoundError, } from '../../../shared/errors';
+import { defaultProject } from '../../../utils/environment';
+/**
+ * Trigger a pipeline run
+ *
+ * @param connection The Azure DevOps WebApi connection
+ * @param options Options for triggering a pipeline
+ * @returns The run details
+ */
+export async function triggerPipeline(connection, options) {
+    try {
+        const pipelinesApi = await connection.getPipelinesApi();
+        const { projectId = defaultProject, pipelineId, branch, variables, templateParameters, stagesToSkip, } = options;
+        // Prepare run parameters
+        const runParameters = {};
+        // Add variables
+        if (variables) {
+            runParameters.variables = variables;
+        }
+        // Add template parameters
+        if (templateParameters) {
+            runParameters.templateParameters = templateParameters;
+        }
+        // Add stages to skip
+        if (stagesToSkip && stagesToSkip.length > 0) {
+            runParameters.stagesToSkip = stagesToSkip;
+        }
+        // Prepare resources (including branch)
+        const resources = branch
+            ? { repositories: { self: { refName: `refs/heads/${branch}` } } }
+            : {};
+        // Add resources to run parameters if not empty
+        if (Object.keys(resources).length > 0) {
+            runParameters.resources = resources;
+        }
+        // Call pipeline API to run pipeline
+        const result = await pipelinesApi.runPipeline(runParameters, projectId, pipelineId);
+        return result;
+    }
+    catch (error) {
+        // Handle specific error types
+        if (error instanceof AzureDevOpsError) {
+            throw error;
+        }
+        // Check for specific error types and convert to appropriate Azure DevOps errors
+        if (error instanceof Error) {
+            if (error.message.includes('Authentication') ||
+                error.message.includes('Unauthorized') ||
+                error.message.includes('401')) {
+                throw new AzureDevOpsAuthenticationError(`Failed to authenticate: ${error.message}`);
+            }
+            if (error.message.includes('not found') ||
+                error.message.includes('does not exist') ||
+                error.message.includes('404')) {
+                throw new AzureDevOpsResourceNotFoundError(`Pipeline or project not found: ${error.message}`);
+            }
+        }
+        // Otherwise, wrap it in a generic error
+        throw new AzureDevOpsError(`Failed to trigger pipeline: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=feature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/features/pipelines/trigger-pipeline/feature.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAA+B;IAE/B,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,eAAe,EAAE,CAAC;QACxD,MAAM,EACJ,SAAS,GAAG,cAAc,EAC1B,UAAU,EACV,MAAM,EACN,SAAS,EACT,kBAAkB,EAClB,YAAY,GACb,GAAG,OAAO,CAAC;QAEZ,yBAAyB;QACzB,MAAM,aAAa,GAA4B,EAAE,CAAC;QAElD,gBAAgB;QAChB,IAAI,SAAS,EAAE,CAAC;YACd,aAAa,CAAC,SAAS,GAAG,SAAS,CAAC;QACtC,CAAC;QAED,0BAA0B;QAC1B,IAAI,kBAAkB,EAAE,CAAC;YACvB,aAAa,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QACxD,CAAC;QAED,qBAAqB;QACrB,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,aAAa,CAAC,YAAY,GAAG,YAAY,CAAC;QAC5C,CAAC;QAED,uCAAuC;QACvC,MAAM,SAAS,GAA4B,MAAM;YAC/C,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,MAAM,EAAE,EAAE,EAAE,EAAE;YACjE,CAAC,CAAC,EAAE,CAAC;QAEP,+CAA+C;QAC/C,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,aAAa,CAAC,SAAS,GAAG,SAAS,CAAC;QACtC,CAAC;QACD,oCAAoC;QACpC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,WAAW,CAC3C,aAAa,EACb,SAAS,EACT,UAAU,CACX,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,8BAA8B;QAC9B,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,gFAAgF;QAChF,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,IACE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBACxC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBACtC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAC7B,CAAC;gBACD,MAAM,IAAI,8BAA8B,CACtC,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAC3C,CAAC;YACJ,CAAC;YAED,IACE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACnC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBACxC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAC7B,CAAC;gBACD,MAAM,IAAI,gCAAgC,CACxC,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAClD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,wCAAwC;QACxC,MAAM,IAAI,gBAAgB,CACxB,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/features/pipelines/trigger-pipeline/feature.spec.int.d.ts

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

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

@@ -0,0 +1,83 @@
+import { triggerPipeline } from './feature';
+import { listPipelines } from '../list-pipelines/feature';
+import { getTestConnection, shouldSkipIntegrationTest, } from '../../../shared/test/test-helpers';
+const shouldSkip = shouldSkipIntegrationTest();
+const projectId = process.env.AZURE_DEVOPS_DEFAULT_PROJECT || '';
+const hasProjectId = Boolean(projectId);
+const describeOrSkip = !shouldSkip && hasProjectId ? describe : describe.skip;
+describeOrSkip('triggerPipeline integration', () => {
+    let connection;
+    let existingPipelineId;
+    beforeAll(async () => {
+        // 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;
+        // Try to get an existing pipeline ID for testing
+        const pipelines = await listPipelines(connection, { projectId });
+        const pipelineId = pipelines[0]?.id;
+        if (!pipelineId) {
+            throw new Error('No pipelines found for triggerPipeline tests');
+        }
+        existingPipelineId = pipelineId;
+    });
+    test('should trigger a pipeline run', async () => {
+        // Arrange - prepare options for running the pipeline
+        const options = {
+            projectId,
+            pipelineId: existingPipelineId,
+            // Use previewRun mode to avoid actually triggering pipelines during tests
+            previewRun: true,
+        };
+        // Act - trigger the pipeline
+        const run = await triggerPipeline(connection, options);
+        // Assert - verify the response
+        expect(run).toBeDefined();
+        // Run ID should be present
+        expect(run.id).toBeDefined();
+        expect(typeof run.id).toBe('number');
+        // Pipeline reference should match the pipeline we triggered
+        expect(run.pipeline?.id).toBe(existingPipelineId);
+        // URL should exist and point to the run
+        expect(run.url).toBeDefined();
+        expect(run.url).toContain('_apis/pipelines');
+    });
+    test('should trigger with custom branch', async () => {
+        // Arrange - prepare options with a branch
+        const options = {
+            projectId,
+            pipelineId: existingPipelineId,
+            branch: 'main', // Use the main branch
+            // Use previewRun mode to avoid actually triggering pipelines during tests
+            previewRun: true,
+        };
+        // Act - trigger the pipeline with custom options
+        const run = await triggerPipeline(connection, options);
+        // Assert - verify the response
+        expect(run).toBeDefined();
+        expect(run.id).toBeDefined();
+        // Resources should include the specified branch
+        expect(run.resources?.repositories?.self?.refName).toBe('refs/heads/main');
+    });
+    test('should handle non-existent pipeline', async () => {
+        // Use a very high ID that is unlikely to exist
+        const nonExistentPipelineId = 999999;
+        try {
+            // Attempt to trigger a pipeline that shouldn't exist
+            await triggerPipeline(connection, {
+                projectId,
+                pipelineId: nonExistentPipelineId,
+            });
+            // If we reach here without an error, we'll fail the test
+            fail('Expected triggerPipeline to throw an error for non-existent pipeline');
+        }
+        catch (error) {
+            // We expect an error, so this test passes if we get here
+            expect(error).toBeDefined();
+            // Note: the exact error type might vary depending on the API response
+        }
+    });
+});
+//# sourceMappingURL=feature.spec.int.js.map

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

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

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

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

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

@@ -0,0 +1,110 @@
+import { triggerPipeline } from './feature';
+import { AzureDevOpsError, AzureDevOpsAuthenticationError, AzureDevOpsResourceNotFoundError, } from '../../../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 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 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(triggerPipeline(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 4,
+        })).rejects.toThrow(AzureDevOpsAuthenticationError);
+        await expect(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(triggerPipeline(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 999,
+        })).rejects.toThrow(AzureDevOpsResourceNotFoundError);
+        await expect(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(triggerPipeline(mockConnection, {
+            projectId: 'testproject',
+            pipelineId: 4,
+        })).rejects.toThrow(AzureDevOpsError);
+        await expect(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":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAEhC,iDAAiD;AACjD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,IAAI,cAAsB,CAAC;IAC3B,IAAI,gBAAqB,CAAC;IAE1B,UAAU,CAAC,GAAG,EAAE;QACd,cAAc;QACd,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,gCAAgC;QAChC,cAAc,GAAG;YACf,SAAS,EAAE,+BAA+B;SACjC,CAAC;QAEZ,kCAAkC;QAClC,gBAAgB,GAAG;YACjB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;SACvB,CAAC;QACF,cAAc,CAAC,eAAe,GAAG,IAAI;aAClC,EAAE,EAAE;aACJ,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC9D,UAAU;QACV,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,gBAAgB,CAAC,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAExD,MAAM;QACN,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,cAAc,EAAE;YACnD,SAAS,EAAE,aAAa;YACxB,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,SAAS;QACT,MAAM,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC1D,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,oBAAoB,CACvD,MAAM,CAAC,gBAAgB,CAAC;YACtB,SAAS,EAAE;gBACT,YAAY,EAAE;oBACZ,IAAI,EAAE;wBACJ,OAAO,EAAE,iBAAiB;qBAC3B;iBACF;aACF;SACF,CAAC,EACF,aAAa,EACb,CAAC,CACF,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QAC1D,UAAU;QACV,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,gBAAgB,CAAC,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAExD,MAAM;QACN,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,cAAc,EAAE;YACnD,SAAS,EAAE,aAAa;YACxB,UAAU,EAAE,CAAC;YACb,SAAS,EAAE;gBACT,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACzB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC1C;SACF,CAAC,CAAC;QAEH,SAAS;QACT,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,oBAAoB,CACvD,MAAM,CAAC,gBAAgB,CAAC;YACtB,SAAS,EAAE;gBACT,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACzB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC1C;SACF,CAAC,EACF,aAAa,EACb,CAAC,CACF,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACrD,UAAU;QACV,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACrD,gBAAgB,CAAC,WAAW,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAE1D,eAAe;QACf,MAAM,MAAM,CACV,eAAe,CAAC,cAAc,EAAE;YAC9B,SAAS,EAAE,aAAa;YACxB,UAAU,EAAE,CAAC;SACd,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QAClD,MAAM,MAAM,CACV,eAAe,CAAC,cAAc,EAAE;YAC9B,SAAS,EAAE,aAAa;YACxB,UAAU,EAAE,CAAC;SACd,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACzD,UAAU;QACV,MAAM,aAAa,GAAG,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACtD,gBAAgB,CAAC,WAAW,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAE9D,eAAe;QACf,MAAM,MAAM,CACV,eAAe,CAAC,cAAc,EAAE;YAC9B,SAAS,EAAE,aAAa;YACxB,UAAU,EAAE,GAAG;SAChB,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;QACpD,MAAM,MAAM,CACV,eAAe,CAAC,cAAc,EAAE;YAC9B,SAAS,EAAE,aAAa;YACxB,UAAU,EAAE,GAAG;SAChB,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QAC1C,UAAU;QACV,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAChD,gBAAgB,CAAC,WAAW,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAE1D,eAAe;QACf,MAAM,MAAM,CACV,eAAe,CAAC,cAAc,EAAE;YAC9B,SAAS,EAAE,aAAa;YACxB,UAAU,EAAE,CAAC;SACd,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACpC,MAAM,MAAM,CACV,eAAe,CAAC,cAAc,EAAE;YAC9B,SAAS,EAAE,aAAa;YACxB,UAAU,EAAE,CAAC;SACd,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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,3 @@
+export { triggerPipeline } from './feature';
+export { TriggerPipelineSchema } from './schema';
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC"}

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,42 @@
+import { z } from 'zod';
+import { defaultProject } from '../../../utils/environment';
+/**
+ * Schema for the triggerPipeline function
+ */
+export const TriggerPipelineSchema = z.object({
+    // The project containing the pipeline
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    // The ID of the pipeline to trigger
+    pipelineId: z
+        .number()
+        .int()
+        .positive()
+        .describe('The numeric ID of the pipeline to trigger'),
+    // The branch to run the pipeline on
+    branch: 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: z
+        .record(z.object({
+        value: z.string(),
+        isSecret: z.boolean().optional(),
+    }))
+        .optional()
+        .describe('Variables to pass to the pipeline run'),
+    // Parameters for template-based pipelines
+    templateParameters: z
+        .record(z.string())
+        .optional()
+        .describe('Parameters for template-based pipelines'),
+    // Stages to skip in the pipeline run
+    stagesToSkip: z
+        .array(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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,sCAAsC;IACtC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,cAAc,GAAG,CAAC;IACzE,oCAAoC;IACpC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;IACxD,oCAAoC;IACpC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uHAAuH,CACxH;IACH,wCAAwC;IACxC,SAAS,EAAE,CAAC;SACT,MAAM,CACL,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC,CACH;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,0CAA0C;IAC1C,kBAAkB,EAAE,CAAC;SAClB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAClB,QAAQ,EAAE;SACV,QAAQ,CAAC,yCAAyC,CAAC;IACtD,qCAAqC;IACrC,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,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,2 @@
+export {};
+//# 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,31 @@
+import { WebApi } from 'azure-devops-node-api';
+import { getPersonalAccessTokenHandler } from 'azure-devops-node-api';
+/**
+ * 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;
+}
+/**
+ * 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/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":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;;;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,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,26 @@
+import { AzureDevOpsResourceNotFoundError, AzureDevOpsError, } from '../../../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
+ */
+export async function getProject(connection, projectId) {
+    try {
+        const coreApi = await connection.getCoreApi();
+        const project = await coreApi.getProject(projectId);
+        if (!project) {
+            throw new AzureDevOpsResourceNotFoundError(`Project '${projectId}' not found`);
+        }
+        return project;
+    }
+    catch (error) {
+        if (error instanceof 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":"AACA,OAAO,EACL,gCAAgC,EAChC,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;GAOG;AACH,MAAM,CAAC,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,gCAAgC,CACxC,YAAY,SAAS,aAAa,CACnC,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB,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 {};