faros-airbyte-common 0.14.13 → 0.15.0

package/lib/azure-devops/azure-devops.d.ts

@@ -0,0 +1,40 @@
+import { AxiosInstance } from 'axios';
+import { WebApi } from 'azure-devops-node-api';
+import { IdentityRef } from 'azure-devops-node-api/interfaces/common/VSSInterfaces';
+import { TeamProject, WebApiTeam } from 'azure-devops-node-api/interfaces/CoreInterfaces';
+import { AirbyteLogger } from 'faros-airbyte-cdk';
+import * as types from './types';
+/**
+ * This abstract class is used to create Azure DevOps clients.
+ * Extended by Azure DevOps sources that need to access Azure DevOps APIs,
+ * such as Azure Repos, Azure Pipelines, Azure Work Items, etc.
+ *
+ * @abstract
+ * @class AzureDevOps
+ */
+export declare abstract class AzureDevOps {
+    protected readonly client: types.AzureDevOpsClient;
+    protected readonly cutoffDays: number;
+    protected readonly top: number;
+    protected readonly logger: AirbyteLogger;
+    private static azureDevOps;
+    constructor(client: types.AzureDevOpsClient, cutoffDays: number, top: number, logger: AirbyteLogger);
+    static instance<T extends AzureDevOps>(this: new (...args: any[]) => T, config: types.AzureDevOpsConfig, logger: AirbyteLogger, ...rest: any[]): Promise<T>;
+    static getApiUrl(instance: types.AzureDevOpsInstance): string;
+    static validateAuth(config: types.AzureDevOpsConfig): void;
+    static createWebAPI(apiUrl: string, organization: string, accessToken: string, timeout?: number, maxRetries?: number): Promise<WebApi>;
+    static createGraphAPI(instance: types.AzureDevOpsInstance, organization: string, access_token: string, timeout: number, maxRetries: number, logger: AirbyteLogger): AxiosInstance | undefined;
+    protected getPaginated<T>(getFn: (top: number, skipOrToken: number | string) => Promise<Array<T>>, options?: {
+        useContinuationToken: boolean;
+        continuationTokenParam: string;
+    }): AsyncGenerator<T>;
+    private paginateWithSkip;
+    private paginateWithContinuationToken;
+    getProjects(projects?: ReadonlyArray<string>): Promise<ReadonlyArray<TeamProject>>;
+    private getAllProjects;
+    protected getTeams(projectId: string): AsyncGenerator<WebApiTeam>;
+    protected getTeamMembers(projectId: string, teamId: string): AsyncGenerator<IdentityRef>;
+    getUsers(projects?: ReadonlyArray<string>): AsyncGenerator<types.User>;
+    private getGraphUsers;
+    private getTeamUsers;
+}

package/lib/azure-devops/azure-devops.js

@@ -0,0 +1,264 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AzureDevOps = void 0;
+const azure_devops_node_api_1 = require("azure-devops-node-api");
+const faros_airbyte_cdk_1 = require("faros-airbyte-cdk");
+const faros_js_client_1 = require("faros-js-client");
+const typescript_memoize_1 = require("typescript-memoize");
+const verror_1 = __importDefault(require("verror"));
+const CLOUD_API_URL = 'https://dev.azure.com';
+const DEFAULT_GRAPH_API_URL = 'https://vssps.dev.azure.com';
+const DEFAULT_GRAPH_API_VERSION = '7.1-preview.1';
+const DEFAULT_REQUEST_TIMEOUT = 300000;
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_PAGE_SIZE = 100;
+const DEFAULT_CUTOFF_DAYS = 90;
+/**
+ * This abstract class is used to create Azure DevOps clients.
+ * Extended by Azure DevOps sources that need to access Azure DevOps APIs,
+ * such as Azure Repos, Azure Pipelines, Azure Work Items, etc.
+ *
+ * @abstract
+ * @class AzureDevOps
+ */
+class AzureDevOps {
+    constructor(client, cutoffDays = DEFAULT_CUTOFF_DAYS, top = DEFAULT_PAGE_SIZE, logger) {
+        this.client = client;
+        this.cutoffDays = cutoffDays;
+        this.top = top;
+        this.logger = logger;
+    }
+    static async instance(config, logger, ...rest) {
+        var _a, _b, _c, _d;
+        if (AzureDevOps.azureDevOps) {
+            return AzureDevOps.azureDevOps;
+        }
+        AzureDevOps.validateAuth(config);
+        if ((_a = config.instance) === null || _a === void 0 ? void 0 : _a.type) {
+            logger.info(`Azure DevOps instance type: ${config.instance.type}`);
+        }
+        else {
+            logger.info('No Azure DevOps instance type provided, will attempt to use ' +
+                'Azure DevOps Services (cloud)');
+        }
+        const apiUrl = AzureDevOps.getApiUrl(config === null || config === void 0 ? void 0 : config.instance);
+        const timeout = (_b = config.request_timeout) !== null && _b !== void 0 ? _b : DEFAULT_REQUEST_TIMEOUT;
+        const maxRetries = (_c = config.max_retries) !== null && _c !== void 0 ? _c : DEFAULT_MAX_RETRIES;
+        const webApi = await AzureDevOps.createWebAPI(apiUrl, config.organization, config.access_token, timeout, maxRetries);
+        const graphApi = AzureDevOps.createGraphAPI(config.instance, config.organization, config.access_token, timeout, maxRetries, logger);
+        const client = {
+            build: await webApi.getBuildApi(),
+            core: await webApi.getCoreApi(),
+            wit: await webApi.getWorkItemTrackingApi(),
+            git: await webApi.getGitApi(),
+            pipelines: await webApi.getPipelinesApi(),
+            release: await webApi.getReleaseApi(),
+            test: await webApi.getTestApi(),
+            graph: graphApi,
+        };
+        const pageSize = isNaN(config.page_size) ? undefined : config.page_size;
+        if (pageSize && pageSize <= 1) {
+            logger.warn('Page size must be greater than 1, will use default minimum of 2');
+        }
+        const top = Math.max(2, pageSize !== null && pageSize !== void 0 ? pageSize : DEFAULT_PAGE_SIZE);
+        const cutoffDays = (_d = config.cutoff_days) !== null && _d !== void 0 ? _d : DEFAULT_CUTOFF_DAYS;
+        AzureDevOps.azureDevOps = new this(client, cutoffDays, top, logger, ...rest);
+        return AzureDevOps.azureDevOps;
+    }
+    static getApiUrl(instance) {
+        var _a;
+        if ((instance === null || instance === void 0 ? void 0 : instance.type) !== 'server') {
+            return CLOUD_API_URL;
+        }
+        const apiUrl = (_a = instance === null || instance === void 0 ? void 0 : instance.api_url) === null || _a === void 0 ? void 0 : _a.trim();
+        if (!apiUrl) {
+            throw new verror_1.default('api_url must not be an empty string for server instance type');
+        }
+        try {
+            new URL(apiUrl);
+        }
+        catch (error) {
+            throw new verror_1.default(`Invalid URL: ${instance === null || instance === void 0 ? void 0 : instance.api_url}`);
+        }
+        return apiUrl;
+    }
+    static validateAuth(config) {
+        if (!config.access_token) {
+            throw new verror_1.default('access_token must not be an empty string');
+        }
+        if (!config.organization) {
+            throw new verror_1.default('organization must not be an empty string');
+        }
+    }
+    // Create Azure DevOps Node API clients
+    static async createWebAPI(apiUrl, organization, accessToken, timeout = DEFAULT_REQUEST_TIMEOUT, maxRetries = DEFAULT_MAX_RETRIES) {
+        const baseUrl = `${apiUrl}/${organization}`;
+        const authHandler = (0, azure_devops_node_api_1.getPersonalAccessTokenHandler)(accessToken);
+        return new azure_devops_node_api_1.WebApi(baseUrl, authHandler, {
+            socketTimeout: timeout,
+            allowRetries: true,
+            maxRetries,
+            globalAgentOptions: {
+                keepAlive: true,
+                timeout,
+            },
+        });
+    }
+    static createGraphAPI(instance, organization, access_token, timeout, maxRetries, logger) {
+        if ((instance === null || instance === void 0 ? void 0 : instance.type) === 'server') {
+            return undefined;
+        }
+        const base64EncodedToken = (0, faros_airbyte_cdk_1.base64Encode)(`:${access_token}`);
+        return (0, faros_js_client_1.makeAxiosInstanceWithRetry)({
+            baseURL: `${DEFAULT_GRAPH_API_URL}/${organization}/_apis/graph`,
+            timeout,
+            maxContentLength: Infinity,
+            maxBodyLength: Infinity,
+            params: { 'api-version': DEFAULT_GRAPH_API_VERSION },
+            headers: { Authorization: `Basic ${base64EncodedToken}` },
+        }, logger.asPino(), maxRetries, 1000 // Default retry delay
+        );
+    }
+    async *getPaginated(getFn, options) {
+        if (options === null || options === void 0 ? void 0 : options.useContinuationToken) {
+            yield* this.paginateWithContinuationToken(getFn, options.continuationTokenParam);
+        }
+        else {
+            yield* this.paginateWithSkip(getFn);
+        }
+    }
+    async *paginateWithSkip(getFn) {
+        let resCount = 0;
+        let skip = 0;
+        const top = this.top;
+        do {
+            const result = await getFn(top, skip);
+            if (result.length)
+                yield* result;
+            resCount = result.length;
+            skip += resCount;
+        } while (resCount >= top);
+    }
+    // Workaround for Azure DevOps API pagination not returning the continuation token
+    // https://github.com/microsoft/azure-devops-node-api/issues/609
+    async *paginateWithContinuationToken(getFn, continuationTokenParam) {
+        const top = this.top;
+        let hasNext = false;
+        let pages = 0;
+        let continuationToken = undefined;
+        do {
+            const result = await getFn(top, continuationToken);
+            if (!result) {
+                this.logger.warn('Failed to fetch results, received empty result. Skipping...');
+                return;
+            }
+            if (!Array.isArray(result)) {
+                throw new verror_1.default(`Expected array result but got ${typeof result} ${JSON.stringify(result)}`);
+            }
+            // Remove the first record when we have a continuation token to avoid duplication
+            // since we already processed it in the previous page
+            const records = continuationToken ? result.slice(1) : result;
+            yield* records;
+            continuationToken =
+                result.length === top
+                    ? result.at(-1)[continuationTokenParam]
+                    : undefined;
+            hasNext = Boolean(continuationToken);
+            pages++;
+            this.logger.debug(hasNext
+                ? `Fetching next page using continuation token ${continuationToken}`
+                : `Finished fetching ${pages} pages`);
+        } while (hasNext);
+    }
+    async getProjects(projects) {
+        if (!(projects === null || projects === void 0 ? void 0 : projects.length)) {
+            return await this.getAllProjects();
+        }
+        const allProjects = [];
+        for (const project of projects) {
+            const res = await this.client.core.getProject(project);
+            if (res) {
+                allProjects.push(res);
+            }
+            else {
+                this.logger.warn(`Project ${project} in config not found. Skipping`);
+            }
+        }
+        return allProjects;
+    }
+    async getAllProjects() {
+        const projects = [];
+        const getProjectsFn = async (top, skip) => {
+            const res = await this.client.core.getProjects('wellFormed', top, skip);
+            return Array.from(res.values());
+        };
+        for await (const project of this.getPaginated(getProjectsFn)) {
+            projects.push(project);
+        }
+        return projects;
+    }
+    async *getTeams(projectId) {
+        const getTeamsFn = (pageSize, skip) => this.client.core.getTeams(projectId, false, pageSize, skip);
+        yield* this.getPaginated(getTeamsFn);
+    }
+    async *getTeamMembers(projectId, teamId) {
+        const getMembersFn = (top, skip) => this.client.core.getTeamMembersWithExtendedProperties(projectId, teamId, top, skip);
+        for await (const member of this.getPaginated(getMembersFn)) {
+            yield member.identity;
+        }
+    }
+    // If graph API is available, i.e. Azure DevOps Services (cloud) instance,
+    // use it to fetch users. Otherwise, fetch users through teams and
+    // team members (Azure DevOps Server)
+    async *getUsers(projects) {
+        if (this.client.graph) {
+            yield* this.getGraphUsers();
+            return;
+        }
+        yield* this.getTeamUsers(projects);
+    }
+    async *getGraphUsers() {
+        var _a, _b, _c;
+        let continuationToken;
+        do {
+            const res = await this.client.graph.get('users', {
+                params: { subjectTypes: 'msa,aad,imp', continuationToken },
+            });
+            continuationToken = (_a = res === null || res === void 0 ? void 0 : res.headers) === null || _a === void 0 ? void 0 : _a['X-MS-ContinuationToken'];
+            for (const item of (_c = (_b = res === null || res === void 0 ? void 0 : res.data) === null || _b === void 0 ? void 0 : _b.value) !== null && _c !== void 0 ? _c : []) {
+                yield item;
+            }
+        } while (continuationToken);
+    }
+    async *getTeamUsers(projects) {
+        const seenUsers = new Set();
+        let teams = 0;
+        for (const project of await this.getProjects(projects)) {
+            for await (const team of this.getTeams(project.id)) {
+                teams++;
+                for await (const member of this.getTeamMembers(project.id, team.id)) {
+                    if (!seenUsers.has(member.uniqueName)) {
+                        seenUsers.add(member.uniqueName);
+                        yield member;
+                    }
+                }
+            }
+        }
+        this.logger.debug(`Fetched ${seenUsers.size} members from ${teams} teams`);
+    }
+}
+exports.AzureDevOps = AzureDevOps;
+AzureDevOps.azureDevOps = null;
+__decorate([
+    (0, typescript_memoize_1.Memoize)()
+], AzureDevOps.prototype, "getProjects", null);
+//# sourceMappingURL=azure-devops.js.map

package/lib/azure-devops/azure-devops.js.map

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

package/lib/azure-devops/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export { AzureDevOps } from './azure-devops';

package/lib/azure-devops/index.js

@@ -0,0 +1,21 @@
+"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 });
+exports.AzureDevOps = void 0;
+__exportStar(require("./types"), exports);
+var azure_devops_1 = require("./azure-devops");
+Object.defineProperty(exports, "AzureDevOps", { enumerable: true, get: function () { return azure_devops_1.AzureDevOps; } });
+//# sourceMappingURL=index.js.map

package/lib/azure-devops/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/azure-devops/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,+CAA2C;AAAnC,2GAAA,WAAW,OAAA"}

package/lib/azure-devops/types.d.ts

@@ -0,0 +1,111 @@
+import { AxiosInstance } from 'axios';
+import { IBuildApi } from 'azure-devops-node-api/BuildApi';
+import { ICoreApi } from 'azure-devops-node-api/CoreApi';
+import { IGitApi } from 'azure-devops-node-api/GitApi';
+import { Build as BaseBuild, BuildArtifact, TimelineRecord as BaseTimelineRecord } from 'azure-devops-node-api/interfaces/BuildInterfaces';
+import { IdentityRef } from 'azure-devops-node-api/interfaces/common/VSSInterfaces';
+import * as GitInterfaces from 'azure-devops-node-api/interfaces/GitInterfaces';
+import { GraphUser } from 'azure-devops-node-api/interfaces/GraphInterfaces';
+import { Pipeline as BasePipeline } from 'azure-devops-node-api/interfaces/PipelinesInterfaces';
+import { ProjectReference } from 'azure-devops-node-api/interfaces/ReleaseInterfaces';
+import { CodeCoverageStatistics } from 'azure-devops-node-api/interfaces/TestInterfaces';
+import { WorkItem } from 'azure-devops-node-api/interfaces/WorkItemTrackingInterfaces';
+import { IPipelinesApi } from 'azure-devops-node-api/PipelinesApi';
+import { IReleaseApi } from 'azure-devops-node-api/ReleaseApi';
+import { ITestApi } from 'azure-devops-node-api/TestApi';
+import { IWorkItemTrackingApi } from 'azure-devops-node-api/WorkItemTrackingApi';
+export type DevOpsCloud = {
+    type: 'cloud';
+};
+export type DevOpsServer = {
+    type: 'server';
+    api_url: string;
+};
+export type AzureDevOpsInstance = DevOpsCloud | DevOpsServer;
+export interface AzureDevOpsConfig {
+    readonly instance?: AzureDevOpsInstance;
+    readonly access_token: string;
+    readonly organization: string;
+    readonly projects?: ReadonlyArray<string>;
+    readonly cutoff_days?: number;
+    readonly page_size?: number;
+    readonly max_retries?: number;
+    readonly request_timeout?: number;
+}
+export interface AzureDevOpsClient {
+    readonly build: IBuildApi;
+    readonly core: ICoreApi;
+    readonly git: IGitApi;
+    readonly wit: IWorkItemTrackingApi;
+    readonly pipelines: IPipelinesApi;
+    readonly release: IReleaseApi;
+    readonly test: ITestApi;
+    readonly graph?: AxiosInstance;
+}
+export type User = GraphUser | IdentityRef;
+export interface GraphUserResponse {
+    count: number;
+    value: GraphUser[];
+}
+export interface Pipeline extends BasePipeline {
+    project: ProjectReference;
+}
+export interface Build extends Omit<BaseBuild, 'reason' | 'status' | 'result'> {
+    artifacts: BuildArtifact[];
+    coverageStats: CodeCoverageStatistics[];
+    jobs: TimelineRecord[];
+    reason: string;
+    status: string;
+    result: string;
+}
+export interface TimelineRecord extends Omit<BaseTimelineRecord, 'result' | 'state'> {
+    result: string;
+    state: string;
+}
+export interface Tag extends GitInterfaces.GitRef {
+    commit?: GitInterfaces.GitAnnotatedTag;
+}
+export interface Repository extends GitInterfaces.GitRepository {
+    branches?: GitInterfaces.GitBranchStats[];
+    tags?: Tag[];
+}
+export interface PullRequest extends Omit<GitInterfaces.GitPullRequest, 'status' | 'mergeStatus'> {
+    status: string;
+    mergeStatus: string;
+    threads: GitInterfaces.GitPullRequestCommentThread[];
+}
+export interface Commit extends GitInterfaces.GitCommitRef {
+    repository?: Repository;
+    branch?: string;
+}
+export interface WorkItemState {
+    name: string;
+    category: string;
+}
+export interface WorkItemStateRevision {
+    readonly state: WorkItemState;
+    readonly changedDate: string;
+}
+export interface WorkItemAssigneeRevision {
+    readonly assignee: IdentityRef;
+    readonly changedDate: string;
+}
+export interface WorkItemIterationRevision {
+    readonly iteration: number;
+    readonly addedAt: string;
+    readonly removedAt?: string;
+}
+export interface WorkItemRevisions {
+    readonly states: ReadonlyArray<WorkItemStateRevision>;
+    readonly assignees: ReadonlyArray<WorkItemAssigneeRevision>;
+    readonly iterations: ReadonlyArray<WorkItemIterationRevision>;
+}
+export interface WorkItemWithRevisions extends WorkItem {
+    revisions: WorkItemRevisions;
+    additionalFields: ReadonlyArray<AdditionalField>;
+    projectId: string;
+}
+export interface AdditionalField {
+    name: string;
+    value: string;
+}

package/lib/azure-devops/types.js

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

package/lib/azure-devops/types.js.map

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

package/lib/bitbucket/index.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/lib/bitbucket/index.js

@@ -0,0 +1,18 @@
+"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("./types"), exports);
+//# sourceMappingURL=index.js.map

package/lib/bitbucket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bitbucket/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}