faros-airbyte-common 0.16.24 → 0.16.26

package/lib/common/index.d.ts

@@ -1,5 +1,6 @@
 import { FarosClient } from 'faros-js-client';
 export { bucket, validateBucketingConfig, nextBucketId, applyRoundRobinBucketing, RoundRobinConfig, } from './bucketing';
+export { VCSFilter, VCSFilterConfig, VCSConfigFields, VCSEntityNames, VCSAdapter, RepoInclusion, } from './vcs-filter';
 export interface FileDiff {
     deletions: number;
     additions: number;

package/lib/common/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.applyRoundRobinBucketing = exports.nextBucketId = exports.validateBucketingConfig = exports.bucket = void 0;
+exports.VCSFilter = exports.applyRoundRobinBucketing = exports.nextBucketId = exports.validateBucketingConfig = exports.bucket = void 0;
 exports.normalizeString = normalizeString;
 exports.calculateDateRange = calculateDateRange;
 exports.collectReposByOrg = collectReposByOrg;
@@ -19,6 +19,8 @@ Object.defineProperty(exports, "bucket", { enumerable: true, get: function () {
 Object.defineProperty(exports, "validateBucketingConfig", { enumerable: true, get: function () { return bucketing_1.validateBucketingConfig; } });
 Object.defineProperty(exports, "nextBucketId", { enumerable: true, get: function () { return bucketing_1.nextBucketId; } });
 Object.defineProperty(exports, "applyRoundRobinBucketing", { enumerable: true, get: function () { return bucketing_1.applyRoundRobinBucketing; } });
+var vcs_filter_1 = require("./vcs-filter");
+Object.defineProperty(exports, "VCSFilter", { enumerable: true, get: function () { return vcs_filter_1.VCSFilter; } });
 function normalizeString(str) {
     return str.replace(/\s/g, '').toLowerCase();
 }

package/lib/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;;;;AAyBA,0CAEC;AAED,gDA0CC;AAED,8CAkBC;AAwBD,0CA2CC;AA9JD,qDAA8D;AAC9D,4CAAoB;AACpB,mCAA+B;AAC/B,iCAA+B;AAC/B,gDAAwB;AACxB,mCAA8B;AAE9B,yCAMqB;AALnB,mGAAA,MAAM,OAAA;AACN,oHAAA,uBAAuB,OAAA;AACvB,yGAAA,YAAY,OAAA;AACZ,qHAAA,wBAAwB,OAAA;AAc1B,SAAgB,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED,SAAgB,kBAAkB,CAAC,OAKlC;IACC,MAAM,EAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IAE5D,IAAI,SAAe,CAAC;IACpB,IAAI,OAAa,CAAC;IAElB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,2CAA2C,CAAC,CAAC;QACpD,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,UAAU,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,kEAAkE,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,4DAA4D,CAAC,CAAC;YACrE,SAAS,GAAG,gBAAQ,CAAC,UAAU,CAAC,OAAO,CAAC;iBACrC,KAAK,CAAC,EAAC,IAAI,EAAE,WAAW,EAAC,CAAC;iBAC1B,QAAQ,EAAE,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,eAAe,SAAS,uBAAuB,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,0BAA0B,SAAS,OAAO,OAAO,EAAE,CAAC,CAAC;IAE5D,OAAO,EAAC,SAAS,EAAE,OAAO,EAAC,CAAC;AAC9B,CAAC;AAED,SAAgB,iBAAiB,CAC/B,UAAoC,EACpC,KAA4B;IAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,eAAM,CACd,4BAA4B,IAAI,gDAAgD,CACjF,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,IAAA,gBAAO,EAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,aAAa,GAAG,IAAA,gBAAO,EAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,qBAAqB,GAAG,CAAC,QAAgB,EAAE,EAAE,CACjD,YAAE,CAAC,YAAY,CACb,cAAI,CAAC,IAAI,CACP,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,QAAQ,CACT,EACD,MAAM,CACP,CAAC;AAEJ,MAAM,4BAA4B,GAAG,qBAAqB,CACxD,kCAAkC,CACnC,CAAC;AAEF,MAAM,4BAA4B,GAAG,qBAAqB,CACxD,kCAAkC,CACnC,CAAC;AAEK,KAAK,UAAU,eAAe,CACnC,WAAmC,EACnC,MAAc,EACd,WAAwB,EACxB,KAAa;IAKb,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,IAAI,KAAa,CAAC;IAClB,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,KAAK,GAAG,4BAA4B,CAAC;YACrC,MAAM;QACR,KAAK,YAAY;YACf,KAAK,GAAG,4BAA4B,CAAC;YACrC,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CACnC,KAAK,EACL,KAAK,EACL,IAAI,EACJ,kCAAgB,EAChB,IAAI,GAAG,CACL,MAAM,CAAC,OAAO,CAAC;QACb,MAAM;KACP,CAAC,CACH,CACF,CAAC;IACF,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,OAAO,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC7C,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,OAAO,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YACpD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,EAAC,QAAQ,EAAE,QAAQ,EAAC,CAAC;AAC9B,CAAC;AAED,MAAM,sBAAsB,GAAG,CAC7B,WAAmC,EACnC,OAAY,EACJ,EAAE;;IACV,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,KAAK,GAAG,MAAA,OAAO,CAAC,KAAK,0CAAE,GAAG,CAAC;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,IAAI,GAAG,MAAA,OAAO,CAAC,UAAU,0CAAE,IAAI,CAAC;YACtC,MAAM,GAAG,GAAG,MAAA,MAAA,OAAO,CAAC,UAAU,0CAAE,YAAY,0CAAE,GAAG,CAAC;YAClD,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,OAAO,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"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"}

package/lib/common/vcs-filter.d.ts

@@ -0,0 +1,167 @@
+import { AirbyteLogger } from 'faros-airbyte-cdk';
+import { FarosClient } from 'faros-js-client';
+/**
+ * Configuration for VCS entity filtering
+ */
+export interface VCSFilterConfig<TConfig, TOrg, TRepo> {
+    /** Configuration object containing entity filter arrays */
+    config: TConfig;
+    /** Logger instance for debug/warning messages */
+    logger: AirbyteLogger;
+    /** Optional Faros client for graph-based filtering */
+    farosClient?: FarosClient;
+    /** Configuration field names mapping */
+    configFields: VCSConfigFields;
+    /** Entity type names for logging and API calls */
+    entityNames: VCSEntityNames;
+    /** VCS-specific adapter for API operations */
+    vcsAdapter: VCSAdapter<TOrg, TRepo>;
+    /** Graph name for Faros integration (optional) */
+    defaultGraph?: string;
+    /** Whether to use Faros graph for repo selection */
+    useFarosGraphReposSelection?: boolean;
+}
+/**
+ * Maps configuration field names to their corresponding arrays
+ */
+export interface VCSConfigFields {
+    /** Field name for organization/group/workspace entities (e.g., 'organizations', 'groups', 'workspaces') */
+    orgs: string;
+    /** Field name for excluded organization/group/workspace entities */
+    excludedOrgs: string;
+    /** Field name for repository entities */
+    repos: string;
+    /** Field name for excluded repository entities */
+    excludedRepos: string;
+    /** Field name for Faros graph repos selection flag */
+    useFarosGraphReposSelection?: string;
+    /** Field name for Faros graph name */
+    graph?: string;
+}
+/**
+ * Entity names for logging and display purposes
+ */
+export interface VCSEntityNames {
+    /** Singular name of organization-level entity (e.g., 'organization', 'group', 'workspace') */
+    org: string;
+    /** Plural name of organization-level entity */
+    orgs: string;
+    /** Singular name of repository entity */
+    repo: string;
+    /** Plural name of repository entities */
+    repos: string;
+    /** VCS platform name (e.g., 'GitHub', 'GitLab', 'Bitbucket') */
+    platform: string;
+}
+/**
+ * VCS-specific adapter interface for API operations
+ */
+export interface VCSAdapter<TOrg, TRepo> {
+    /** Get all visible organization-level entities */
+    getOrgs(): Promise<string[]>;
+    /** Get a specific organization-level entity by name */
+    getOrg(orgName: string): Promise<TOrg>;
+    /** Get all repositories for an organization */
+    getRepos(orgName: string): Promise<TRepo[]>;
+    /** Extract repository name from repository object */
+    getRepoName(repo: TRepo): string;
+}
+/**
+ * Repository inclusion result
+ */
+export type RepoInclusion<TRepo> = {
+    repo: TRepo;
+    syncRepoData: boolean;
+};
+/**
+ * Generic VCS organization/repository filter
+ *
+ * This class provides a reusable filtering mechanism for VCS sources that follow
+ * a two-level hierarchy (organization/group/workspace → repository). It supports:
+ *
+ * - Include/exclude patterns for both levels
+ * - Case-insensitive filtering
+ * - Faros Graph integration for dynamic repository selection
+ * - Configurable entity names and field mappings
+ * - Comprehensive validation and error handling
+ *
+ * @example
+ * ```typescript
+ * // GitHub usage
+ * const filter = new VCSFilter({
+ *   config: githubConfig,
+ *   logger: logger,
+ *   farosClient: farosClient,
+ *   configFields: {
+ *     orgs: 'organizations',
+ *     excludedOrgs: 'excluded_organizations',
+ *     repos: 'repositories',
+ *     excludedRepos: 'excluded_repositories',
+ *     useFarosGraphReposSelection: 'use_faros_graph_repos_selection',
+ *     graph: 'graph'
+ *   },
+ *   entityNames: {
+ *     org: 'organization',
+ *     orgs: 'organizations',
+ *     repo: 'repository',
+ *     repos: 'repositories',
+ *     platform: 'GitHub'
+ *   },
+ *   vcsAdapter: new GitHubAdapter(githubClient),
+ *   defaultGraph: 'default-graph'
+ * });
+ *
+ * // GitLab usage
+ * const filter = new VCSFilter({
+ *   config: gitlabConfig,
+ *   logger: logger,
+ *   configFields: {
+ *     orgs: 'groups',
+ *     excludedOrgs: 'excluded_groups',
+ *     repos: 'repositories',
+ *     excludedRepos: 'excluded_repositories'
+ *   },
+ *   entityNames: {
+ *     org: 'group',
+ *     orgs: 'groups',
+ *     repo: 'repository',
+ *     repos: 'repositories',
+ *     platform: 'GitLab'
+ *   },
+ *   vcsAdapter: new GitLabAdapter(gitlabClient)
+ * });
+ * ```
+ */
+export declare class VCSFilter<TConfig extends Record<string, any>, TOrg, TRepo> {
+    private readonly options;
+    private readonly filterConfig;
+    private readonly useFarosGraphReposSelection;
+    private orgs?;
+    private reposByOrg;
+    private loadedSelectedRepos;
+    constructor(options: VCSFilterConfig<TConfig, TOrg, TRepo>);
+    /**
+     * Get all filtered organization names
+     */
+    getOrgs(): Promise<ReadonlyArray<string>>;
+    /**
+     * Get all filtered repositories for an organization
+     */
+    getRepos(org: string): Promise<ReadonlyArray<RepoInclusion<TRepo>>>;
+    /**
+     * Check if a specific repository should be included and synced
+     */
+    getRepoInclusion(org: string, repo: string): Promise<{
+        included: boolean;
+        syncRepoData: boolean;
+    }>;
+    /**
+     * Get a specific repository object by org and name
+     */
+    getRepository(org: string, name: string): TRepo;
+    private filterOrgs;
+    private isVisibleOrg;
+    private loadSelectedRepos;
+    private getSelectedReposByOrg;
+    private hasFarosClient;
+}

package/lib/common/vcs-filter.js

@@ -0,0 +1,280 @@
+"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.VCSFilter = void 0;
+const lodash_1 = require("lodash");
+const typescript_memoize_1 = require("typescript-memoize");
+const verror_1 = __importDefault(require("verror"));
+const index_1 = require("./index");
+/**
+ * Generic VCS organization/repository filter
+ *
+ * This class provides a reusable filtering mechanism for VCS sources that follow
+ * a two-level hierarchy (organization/group/workspace → repository). It supports:
+ *
+ * - Include/exclude patterns for both levels
+ * - Case-insensitive filtering
+ * - Faros Graph integration for dynamic repository selection
+ * - Configurable entity names and field mappings
+ * - Comprehensive validation and error handling
+ *
+ * @example
+ * ```typescript
+ * // GitHub usage
+ * const filter = new VCSFilter({
+ *   config: githubConfig,
+ *   logger: logger,
+ *   farosClient: farosClient,
+ *   configFields: {
+ *     orgs: 'organizations',
+ *     excludedOrgs: 'excluded_organizations',
+ *     repos: 'repositories',
+ *     excludedRepos: 'excluded_repositories',
+ *     useFarosGraphReposSelection: 'use_faros_graph_repos_selection',
+ *     graph: 'graph'
+ *   },
+ *   entityNames: {
+ *     org: 'organization',
+ *     orgs: 'organizations',
+ *     repo: 'repository',
+ *     repos: 'repositories',
+ *     platform: 'GitHub'
+ *   },
+ *   vcsAdapter: new GitHubAdapter(githubClient),
+ *   defaultGraph: 'default-graph'
+ * });
+ *
+ * // GitLab usage
+ * const filter = new VCSFilter({
+ *   config: gitlabConfig,
+ *   logger: logger,
+ *   configFields: {
+ *     orgs: 'groups',
+ *     excludedOrgs: 'excluded_groups',
+ *     repos: 'repositories',
+ *     excludedRepos: 'excluded_repositories'
+ *   },
+ *   entityNames: {
+ *     org: 'group',
+ *     orgs: 'groups',
+ *     repo: 'repository',
+ *     repos: 'repositories',
+ *     platform: 'GitLab'
+ *   },
+ *   vcsAdapter: new GitLabAdapter(gitlabClient)
+ * });
+ * ```
+ */
+class VCSFilter {
+    constructor(options) {
+        var _a;
+        this.options = options;
+        this.reposByOrg = new Map();
+        this.loadedSelectedRepos = false;
+        const { config, logger, configFields, entityNames } = options;
+        this.useFarosGraphReposSelection =
+            (_a = config[configFields.useFarosGraphReposSelection || 'use_faros_graph_repos_selection']) !== null && _a !== void 0 ? _a : false;
+        const orgs = config[configFields.orgs];
+        const repos = config[configFields.repos];
+        const excludedRepos = config[configFields.excludedRepos];
+        let excludedOrgs = config[configFields.excludedOrgs];
+        if ((orgs === null || orgs === void 0 ? void 0 : orgs.length) && (excludedOrgs === null || excludedOrgs === void 0 ? void 0 : excludedOrgs.length)) {
+            logger.warn(`Both ${configFields.orgs} and ${configFields.excludedOrgs} are specified, ${configFields.excludedOrgs} will be ignored.`);
+            excludedOrgs = undefined;
+        }
+        let reposByOrg;
+        let excludedReposByOrg;
+        if (!this.useFarosGraphReposSelection) {
+            ({ reposByOrg, excludedReposByOrg } = this.getSelectedReposByOrg(repos, excludedRepos));
+            this.loadedSelectedRepos = true;
+        }
+        else {
+            if (!this.hasFarosClient()) {
+                throw new verror_1.default(`Faros credentials are required when using Faros Graph for ${entityNames.repos} selection`);
+            }
+            if ((repos === null || repos === void 0 ? void 0 : repos.length) || (excludedRepos === null || excludedRepos === void 0 ? void 0 : excludedRepos.length)) {
+                logger.warn(`Using Faros Graph for ${entityNames.repos} selection but ${configFields.repos} and/or ${configFields.excludedRepos} are specified, both will be ignored.`);
+            }
+        }
+        this.filterConfig = {
+            orgs: (orgs === null || orgs === void 0 ? void 0 : orgs.length) ? new Set(orgs) : undefined,
+            excludedOrgs: (excludedOrgs === null || excludedOrgs === void 0 ? void 0 : excludedOrgs.length) ? new Set(excludedOrgs) : undefined,
+            reposByOrg,
+            excludedReposByOrg,
+        };
+    }
+    /**
+     * Get all filtered organization names
+     */
+    async getOrgs() {
+        if (!this.orgs) {
+            const { vcsAdapter, logger, entityNames } = this.options;
+            const visibleOrgs = new Set((await vcsAdapter.getOrgs()).map((o) => (0, lodash_1.toLower)(o)));
+            if (!visibleOrgs.size) {
+                logger.warn(`No visible ${entityNames.orgs} found`);
+            }
+            this.orgs = await this.filterOrgs(visibleOrgs);
+        }
+        if (this.orgs.size === 0) {
+            throw new verror_1.default({
+                info: {
+                    code: 'NO_VISIBLE_ORGS'
+                }
+            }, `No visible ${this.options.entityNames.orgs} remain after applying inclusion and exclusion filters`);
+        }
+        return Array.from(this.orgs);
+    }
+    /**
+     * Get all filtered repositories for an organization
+     */
+    async getRepos(org) {
+        const lowerOrg = (0, lodash_1.toLower)(org);
+        await this.loadSelectedRepos();
+        if (!this.reposByOrg.has(lowerOrg)) {
+            const repos = new Map();
+            const { vcsAdapter, logger, entityNames } = this.options;
+            const visibleRepos = await vcsAdapter.getRepos(lowerOrg);
+            if (!visibleRepos.length) {
+                logger.warn(`No visible ${entityNames.repos} found for ${entityNames.org} ${lowerOrg}`);
+            }
+            for (const repo of visibleRepos) {
+                const lowerRepoName = (0, lodash_1.toLower)(vcsAdapter.getRepoName(repo));
+                const { included, syncRepoData } = await this.getRepoInclusion(lowerOrg, lowerRepoName);
+                if (included) {
+                    repos.set(lowerRepoName, { repo, syncRepoData });
+                }
+            }
+            this.reposByOrg.set(lowerOrg, repos);
+        }
+        return Array.from(this.reposByOrg.get(lowerOrg).values());
+    }
+    /**
+     * Check if a specific repository should be included and synced
+     */
+    async getRepoInclusion(org, repo) {
+        await this.loadSelectedRepos();
+        const { reposByOrg, excludedReposByOrg } = this.filterConfig;
+        const repos = reposByOrg === null || reposByOrg === void 0 ? void 0 : reposByOrg.get(org);
+        const excludedRepos = excludedReposByOrg === null || excludedReposByOrg === void 0 ? void 0 : excludedReposByOrg.get(org);
+        if (this.useFarosGraphReposSelection) {
+            const included = true;
+            const syncRepoData = (!(repos === null || repos === void 0 ? void 0 : repos.size) || repos.has(repo)) && !(excludedRepos === null || excludedRepos === void 0 ? void 0 : excludedRepos.has(repo));
+            return { included, syncRepoData };
+        }
+        if (repos === null || repos === void 0 ? void 0 : repos.size) {
+            const included = repos.has(repo);
+            return { included, syncRepoData: included };
+        }
+        if (excludedRepos === null || excludedRepos === void 0 ? void 0 : excludedRepos.size) {
+            const included = !excludedRepos.has(repo);
+            return { included, syncRepoData: included };
+        }
+        return { included: true, syncRepoData: true };
+    }
+    /**
+     * Get a specific repository object by org and name
+     */
+    getRepository(org, name) {
+        var _a, _b;
+        const lowerOrg = (0, lodash_1.toLower)(org);
+        const lowerRepoName = (0, lodash_1.toLower)(name);
+        const { repo } = (_b = (_a = this.reposByOrg.get(lowerOrg)) === null || _a === void 0 ? void 0 : _a.get(lowerRepoName)) !== null && _b !== void 0 ? _b : {};
+        if (!repo) {
+            throw new verror_1.default(`${this.options.entityNames.repo} not found: %s/%s`, lowerOrg, lowerRepoName);
+        }
+        return repo;
+    }
+    async filterOrgs(visibleOrgs) {
+        var _a;
+        const orgs = new Set();
+        const { vcsAdapter, logger, entityNames } = this.options;
+        if (!this.filterConfig.orgs) {
+            for (const org of visibleOrgs) {
+                const lowerOrg = (0, lodash_1.toLower)(org);
+                if (!((_a = this.filterConfig.excludedOrgs) === null || _a === void 0 ? void 0 : _a.has(lowerOrg))) {
+                    orgs.add(lowerOrg);
+                }
+                else {
+                    logger.info(`Skipping excluded ${entityNames.org} ${lowerOrg}`);
+                }
+            }
+        }
+        else {
+            for (const org of this.filterConfig.orgs) {
+                const lowerOrg = (0, lodash_1.toLower)(org);
+                if (await this.isVisibleOrg(visibleOrgs, lowerOrg)) {
+                    orgs.add(lowerOrg);
+                }
+            }
+        }
+        return orgs;
+    }
+    async isVisibleOrg(visibleOrgs, lowerOrg) {
+        if (visibleOrgs.has(lowerOrg)) {
+            return true;
+        }
+        const { vcsAdapter, logger, entityNames } = this.options;
+        try {
+            await vcsAdapter.getOrg(lowerOrg);
+            return true;
+        }
+        catch (error) {
+            logger.warn(`Fetching ${entityNames.org} ${lowerOrg} failed with error: ` +
+                `${error.status} - ${error.message}. Skipping.`);
+            return false;
+        }
+    }
+    async loadSelectedRepos() {
+        var _a;
+        if (this.loadedSelectedRepos) {
+            return;
+        }
+        if (this.useFarosGraphReposSelection) {
+            const { farosClient, config, configFields, entityNames, defaultGraph } = this.options;
+            const graphName = (_a = config[configFields.graph || 'graph']) !== null && _a !== void 0 ? _a : defaultGraph;
+            const farosOptions = await (0, index_1.getFarosOptions)('repository', entityNames.platform, farosClient, graphName);
+            const { included: repositories, excluded: excludedRepositories } = farosOptions;
+            const { reposByOrg, excludedReposByOrg } = this.getSelectedReposByOrg(Array.from(repositories), Array.from(excludedRepositories));
+            this.filterConfig.reposByOrg = reposByOrg;
+            this.filterConfig.excludedReposByOrg = excludedReposByOrg;
+        }
+        this.loadedSelectedRepos = true;
+    }
+    getSelectedReposByOrg(repositories, excludedRepositories) {
+        const reposByOrg = new Map();
+        const excludedReposByOrg = new Map();
+        const { logger, entityNames } = this.options;
+        if (repositories === null || repositories === void 0 ? void 0 : repositories.length) {
+            (0, index_1.collectReposByOrg)(reposByOrg, repositories);
+        }
+        if (excludedRepositories === null || excludedRepositories === void 0 ? void 0 : excludedRepositories.length) {
+            (0, index_1.collectReposByOrg)(excludedReposByOrg, excludedRepositories);
+        }
+        for (const org of reposByOrg.keys()) {
+            if (excludedReposByOrg.has(org)) {
+                logger.warn(`Both ${this.options.configFields.repos} and ${this.options.configFields.excludedRepos} are specified for ${entityNames.org} ${org}, ${this.options.configFields.excludedRepos} for ${entityNames.org} ${org} will be ignored.`);
+                excludedReposByOrg.delete(org);
+            }
+        }
+        return { reposByOrg, excludedReposByOrg };
+    }
+    hasFarosClient() {
+        return Boolean(this.options.farosClient);
+    }
+}
+exports.VCSFilter = VCSFilter;
+__decorate([
+    (0, typescript_memoize_1.Memoize)()
+], VCSFilter.prototype, "getOrgs", null);
+__decorate([
+    (0, typescript_memoize_1.Memoize)()
+], VCSFilter.prototype, "getRepos", null);
+//# sourceMappingURL=vcs-filter.js.map

package/lib/common/vcs-filter.js.map

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

package/lib/github/types.d.ts

@@ -137,7 +137,35 @@ export declare enum GitHubTool {
 export type CopilotUsageSummary = {
     org: string;
     team: string | null;
-} & GetResponseDataTypeFromEndpointMethod<typeof octokit.copilot.usageMetricsForOrg>[0];
+} & {
+    day: string;
+    total_suggestions_count: number;
+    total_acceptances_count: number;
+    total_lines_suggested: number;
+    total_lines_accepted: number;
+    total_active_users: number;
+    total_active_chat_users: number;
+    total_chats: number;
+    total_chat_insertion_events: number;
+    total_chat_copy_events: number;
+    breakdown: {
+        language: string;
+        editor: string;
+        suggestions_count: number;
+        acceptances_count: number;
+        lines_suggested: number;
+        lines_accepted: number;
+        active_users: number;
+        model_breakdown?: {
+            model: string;
+            suggestions_count: number;
+            acceptances_count: number;
+            lines_suggested: number;
+            lines_accepted: number;
+            active_users: number;
+        }[];
+    }[];
+};
 export type LanguageEditorBreakdown = CopilotUsageSummary['breakdown'][0];
 export type CodeScanningAlert = {
     org: string;
@@ -214,5 +242,21 @@ export type EnterpriseCopilotSeatsEmpty = {
 export type EnterpriseCopilotUsageSummary = {
     enterprise: string;
     team: string | null;
-} & GetResponseDataTypeFromEndpointMethod<typeof octokit.copilot.usageMetricsForOrg>[0];
+} & Omit<CopilotUsageSummary, 'org' | 'team'>;
+export type EnterpriseCopilotUserEngagement = {
+    enterprise: string;
+    date: string;
+    day: string;
+    login: string;
+    user_id: string;
+    cli_engagement: 0 | 1;
+    code_completion_engagement: 0 | 1;
+    code_review_engagement: 0 | 1;
+    dotcom_chat_engagement: 0 | 1;
+    inline_chat_engagement: 0 | 1;
+    knowledge_base_chat_engagement: 0 | 1;
+    mobile_chat_engagement: 0 | 1;
+    panel_chat_engagement: 0 | 1;
+    pull_request_summary_engagement: 0 | 1;
+};
 export {};