@spotify/backstage-plugin-soundcheck-backend-module-github 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# @spotify/backstage-plugin-soundcheck-backend-module-github
+
+## 0.1.0
+
+### Minor Changes
+
+- 07770382: Upgrade to Backstage 1.12.0
+- 7dc0e65c: Adds GitHub integration for fact extraction from GitHub repositories. See the modules README.md for additional details, including configuration details.
+
+### Patch Changes
+
+- Updated dependencies [3e368dc9]
+  - @spotify/backstage-plugin-soundcheck-common@0.4.0
+  - @spotify/backstage-plugin-soundcheck-node@0.2.0

package/LICENSE.md

@@ -0,0 +1,9 @@
+# Commercial License
+
+Copyright (c) 2023 Spotify. All rights reserved.
+
+This software is part of the "Spotify Plugins for Backstage" bundle. "Spotify
+Plugins for Backstage" is commercial software. To use it, you must obtain a
+license and agree to the [License
+Terms](https://backstage.spotify.com/spotify-plugins-for-backstage-terms).
+Commercial licenses can be obtained at https://backstage.spotify.com/.

package/README.md

@@ -0,0 +1,429 @@
+# Spotify Plugins for Backstage: Soundcheck - Github Integration
+
+Github integration plugin for [Soundcheck](https://backstage.spotify.com/plugins/soundcheck/).
+Similarly to [SCM Integration plugin](https://www.npmjs.com/package/@spotify/backstage-plugin-soundcheck-backend-module-scm), it provides out-of-box integration with Github by leveraging Backstage's Github integration and implements extraction and collection of facts from Github repositories.
+The purpose of Github Integration plugin is to provide Github-specific fact collection (like branch protections), while the SCM Integration plugin provides the collection of facts based on repository content.
+
+Github integration plugin supports the extraction of the following facts:
+
+- [BranchProtections](#collecting-branchprotections-fact)
+- [RepositoryDetails](#collecting-repositorydetails-fact)
+
+<!-- TOC -->
+
+- [Spotify Plugins for Backstage: Soundcheck - Github Integration](#spotify-plugins-for-backstage-soundcheck---github-integration)
+  - [Prerequisites](#prerequisites)
+    - [Configure Github integration in Backstage](#configure-github-integration-in-backstage)
+  - [Plugin Configuration](#plugin-configuration)
+  - [Defining Github Fact Collectors](#defining-github-fact-collectors)
+    - [Overall Shape Of A Github Fact Collector](#overall-shape-of-a-github-fact-collector)
+      - [`frequency` [optional]](#frequency-optional)
+      - [`filter` [optional]](#filter-optional)
+      - [`cache` [optional]](#cache-optional)
+      - [`collects` [required]](#collects-required)
+    - [Overall Shape Of A Fact Extractor](#overall-shape-of-a-fact-extractor)
+      - [`factName` [required]](#factname-required)
+      - [`type` [required]](#type-required)
+      - [`frequency` [optional]](#frequency-optional)
+      - [`branch` [optional]](#branch-optional)
+      - [`filter` [optional]](#filter-optional)
+      - [`cache` [optional]](#cache-optional)
+  - [Collecting BranchProtections Fact](#collecting-branchprotections-fact)
+    - [Shape of A BranchProtections Fact Collector](#shape-of-a-branchprotections-fact-collector)
+    - [Shape of A BranchProtections Fact](#shape-of-a-branchprotections-fact)
+    - [Shape of A BranchProtections Fact Check](#shape-of-a-branchprotections-fact-check)
+  - [Collecting RepositoryDetails Fact](#collecting-repositorydetails-fact)
+    - [Shape of A RepositoryDetails Fact Collector](#shape-of-a-repositorydetails-fact-collector)
+    - [Shape of A RepositoryDetails Fact](#shape-of-a-repositorydetails-fact)
+    - [Shape of A RepositoryDetails Fact Check](#shape-of-a-repositorydetails-fact-check)
+    <!-- TOC -->
+
+## Prerequisites
+
+### Configure Github integration in Backstage
+
+Integrations are configured at the root level of `app-config.yaml`, here's an example configuration for Github:
+
+```yaml
+integrations:
+  github:
+    - host: github.com
+      token: ${GITHUB_TOKEN}
+```
+
+Follow the [instructions](https://backstage.io/docs/integrations/github/locations) for full details on configuration.
+
+## Plugin Configuration
+
+Collection of facts is driven by config. To learn more about the config, see the [Defining Github Fact Collectors](#defining-github-fact-collectors).
+
+1. Create `github-facts-collectors.yaml` in the root of your Backstage repository and fill in all your Github fact collectors.
+   A simple example Github fact collector is listed below.
+
+   **Note:** this file will be loaded at runtime along with the rest of your Backstage configuration files, so make sure it's available in deployed environments in the same way as your `app-config.yaml` files.
+
+   ```yaml
+   ---
+   frequency:
+     cron: '0 * * * *'
+   collects:
+     - factName: branch_protections
+       type: BranchProtections
+       branch: master
+     - factName: repo_details
+       type: RepositoryDetails
+   ```
+
+2. Add a soundcheck collectors field to `app-config.yaml` and reference the newly created `github-facts-collectors.yaml`
+
+   ```yaml
+   # app-config.yaml
+   soundcheck:
+     collectors:
+       github:
+         $include: ./github-facts-collectors.yaml
+   ```
+
+## Defining Github Fact Collectors
+
+This section describes the data shape and semantics of Github Fact Collectors.
+
+### Overall Shape Of A Github Fact Collector
+
+The following is an example of a descriptor file for a Github Fact Collector:
+
+```yaml
+---
+frequency:
+  cron: '0 * * * *'
+filter:
+  kind: 'Component'
+cache:
+  duration:
+    hours: 2
+collects:
+  - factName: branch_protections
+    type: BranchProtections
+    branch: master
+    filter:
+      - spec.lifecycle: 'production'
+        spec.type: 'website'
+    cache: false
+  - factName: repo_details
+    type: RepositoryDetails
+    cache: true
+```
+
+See below for details about these fields.
+
+#### `frequency` [optional]
+
+The frequency at which the collector should be executed. Possible values are either a cron expression `{ cron: ... }` or [HumanDuration](https://backstage.io/docs/reference/backend-tasks.humanduration).
+This is the default frequency for each extractor.
+
+#### `filter` [optional]
+
+A filter specifying which entities to collect the specified facts for. Matches the [filter format](https://backstage.io/docs/reference/catalog-client.entityfilterquery) used by the Catalog API.
+This is the default filter for each extractor.
+
+#### `cache` [optional]
+
+If the collected facts should be cached, and if so for how long. Possible values are either `true` or `false` or a nested `{ duration:` [HumanDuration](https://backstage.io/docs/reference/types.humanduration) `}` field.
+This is the default cache config for each extractor.
+
+#### `collects` [required]
+
+An array describing which facts to collect and how to extract them. See below for details about the overall shape of a fact extractor.
+
+### Overall Shape Of A Fact Extractor
+
+Each extractor supports the fields described below.
+
+#### `factName` [required]
+
+The name of the fact to be extracted.
+
+- Minimum length of 1
+- Maximum length of 100
+- Alphanumeric with single separator instances of periods, dashes, underscores, or forward slashes
+
+#### `type` [required]
+
+The type of the extractor (e.g. BranchProtections, RepositoryDetails).
+
+#### `frequency` [optional]
+
+The frequency at which the fact extraction should be executed. Possible values are either a cron expression `{ cron: ... }` or [HumanDuration](https://backstage.io/docs/reference/backend-tasks.humanduration).
+If provided it overrides the default frequency provided at the top level. If not provided it defaults to the frequency provided at the top level. If neither extractor's frequency nor default frequency is provided the fact will only be collected on demand.
+Example:
+
+```yaml
+frequency:
+  minutes: 10
+```
+
+#### `branch` [optional]
+
+The branch to extract the fact from. If not provided, defaults to the repository's default branch.
+
+#### `filter` [optional]
+
+A filter specifying which entities to collect the specified facts for. Matches the [filter format](https://backstage.io/docs/reference/catalog-client.entityfilterquery) used by the Catalog API.
+If provided it overrides the default filter provided at the top level. If not provided it defaults to the filter provided at the top level. If neither extractor's filter nor default filter is provided the fact will be collected for all entities.
+
+#### `cache` [optional]
+
+If the collected facts should be cached, and if so for how long. Possible values are either `true` or `false` or a nested `{ duration:` [HumanDuration](https://backstage.io/docs/reference/types.humanduration) `}` field.
+If provided it overrides the default cache config provided at the top level. If not provided it defaults to the cache config provided at the top level. If neither extractor's cache nor default cache config is provided the fact will not be cached.
+Example:
+
+```yaml
+cache:
+  duration:
+    hours: 24
+```
+
+## Collecting BranchProtections Fact
+
+BranchProtections fact contains information about configured branch protections for a given branch in Github repository.
+
+### Shape of A BranchProtections Fact Collector
+
+The shape of a BranchProtections Fact Collector matches the [Overall Shape Of A Github Fact Collector](#overall-shape-of-a-github-fact-collector) (restriction: `type: BranchProtections`).
+
+The following is an example of the BranchProtections Fact Collector config:
+
+```yaml
+collects:
+  - factName: branch_protections
+    type: BranchProtections
+    frequency:
+      cron: '0 * * * *'
+    branch: master
+    filter:
+      - spec.lifecycle: 'production'
+        spec.type: 'website'
+    cache: false
+```
+
+### Shape of A BranchProtections Fact
+
+The shape of a BranchProtections Fact is based on the [Fact Schema](https://www.npmjs.com/package/@spotify/backstage-plugin-soundcheck-backend#fact-schema).
+
+For a description of the data collected regarding branch protection, refer to the [Github API documentation](https://docs.github.com/en/rest/branches/branch-protection).
+
+The following is an example of the collected BranchProtections Fact:
+
+```yaml
+factRef: github:master/branch_protections
+entityRef: component:default/queue-proxy
+scope: master
+timestamp: 2023-02-24T15:50+00Z
+data:
+  url: 'https://api.github.com/repos/backstage/backstage/branches/master/protection'
+  required_pull_request_reviews:
+    url: 'https://api.github.com/repos/backstage/backstage/branches/master/protection/required_pull_request_reviews',
+    dismiss_stale_reviews: false
+    require_code_owner_reviews: true
+    required_approving_review_count: 2
+    require_last_push_approval: false
+  required_signatures:
+    url: 'https://api.github.com/repos/backstage/backstage/branches/master/protection/required_signatures'
+    enabled: false
+  enforce_admins:
+    url: 'https://api.github.com/repos/backstage/backstage/branches/master/protection/enforce_admins'
+    enabled: false
+  required_linear_history:
+    enabled: false
+  allow_force_pushes:
+    enabled: true
+  allow_deletions:
+    enabled: true
+  block_creations:
+    enabled: true
+  required_conversation_resolution:
+    enabled: false
+  lock_branch:
+    enabled: false
+  allow_fork_syncing:
+    enabled: true
+```
+
+### Shape of A BranchProtections Fact Check
+
+The shape of a BranchProtections Fact Check matches the [Shape of a Fact Check](https://www.npmjs.com/package/@spotify/backstage-plugin-soundcheck-backend#shape-of-a-fact-check).
+
+The following is an example of the BranchProtections fact checks:
+
+```yaml
+soundcheck:
+  checks:
+    - id: requires_code_owner_reviews
+      rule:
+        factRef: github:master/branch_protections
+        path: $.required_pull_request_reviews.require_code_owner_reviews
+        operator: equal
+        value: true
+    - id: requires_at_least_two_approving_reviews
+      rule:
+        factRef: github:master/branch_protections
+        path: $.required_pull_request_reviews.required_approving_review_count
+        operator: greaterThanInclusive
+        value: 2
+```
+
+The following is an example of the Soundcheck program that utilizes these checks:
+
+```yaml
+- id: demo
+  name: Demo
+  ownerEntityRef: group:default/owning_group
+  description: Demonstration of Soundcheck BranchProtections Fact Extractor
+  levels:
+    - ordinal: 1
+      name: First level
+      description: Checks leveraging Soundcheck's Github BranchProtections Fact Extractor
+      checks:
+        - id: requires_code_owner_reviews
+          name: Requires code owner reviews
+          description: PR requires code owner reviews
+        - id: requires_at_least_two_approving_reviews
+          name: Requires at least two approving reviews
+          description: PR requires at least two approving reviews
+```
+
+## Collecting RepositoryDetails Fact
+
+RepositoryDetails fact contains information about a Github repository.
+
+### Shape of A RepositoryDetails Fact Collector
+
+The shape of a RepositoryDetails Fact Collector matches the [Overall Shape Of A Github Fact Collector](#overall-shape-of-a-github-fact-collector) (restriction: `type: RepositoryDetails`).
+
+The following is an example of the RepositoryDetails Fact Collector config:
+
+```yaml
+collects:
+  - factName: repo_details
+    type: RepositoryDetails
+    frequency:
+      cron: '0 * * * *'
+    filter:
+      - spec.lifecycle: 'production'
+    cache: true
+```
+
+### Shape of A RepositoryDetails Fact
+
+The shape of a RepositoryDetails Fact is based on the [Fact Schema](https://www.npmjs.com/package/@spotify/backstage-plugin-soundcheck-backend#fact-schema).
+
+For a description of the data collected about repository, refer to the [Github API documentation](https://docs.github.com/en/rest/repos/repos#get-a-repository).
+
+The following is an example of the collected RepositoryDetails Fact:
+
+```yaml
+factRef: github:default/repo_details
+entityRef: component:default/queue-proxy
+scope: default
+timestamp: 2023-02-24T15:50+00Z
+data:
+  name: backstage
+  full_name: backstage/backstage
+  private: true
+  html_url: 'https://github.com/backstage/backstage'
+  description: null
+  fork: false
+  url: 'https://api.github.com/repos/backstage/backstage'
+  homepage: null
+  size: 3
+  stargazers_count: 0
+  watchers_count: 0
+  language: null
+  has_issues: true
+  has_projects: true
+  has_downloads: true
+  has_wiki: true
+  has_pages: false
+  has_discussions: false
+  forks_count: 0
+  mirror_url: null
+  archived: false
+  disabled: false
+  open_issues_count: 0
+  license: null
+  allow_forking: true
+  is_template: false
+  web_commit_signoff_required: false
+  visibility: 'private'
+  forks: 0
+  open_issues: 0
+  watchers: 0
+  default_branch: master
+  permissions:
+    admin: true
+    maintain: true
+    push: true
+    triage: true
+    pull: true
+  allow_squash_merge: true
+  allow_merge_commit: true
+  allow_rebase_merge: true
+  allow_auto_merge: false
+  delete_branch_on_merge: false
+  allow_update_branch: false
+  use_squash_pr_title_as_default: false
+  squash_merge_commit_message: 'COMMIT_MESSAGES'
+  squash_merge_commit_title: 'COMMIT_OR_PR_TITLE'
+  merge_commit_message: 'PR_TITLE'
+  merge_commit_title: 'MERGE_MESSAGE'
+  security_and_analysis:
+    secret_scanning:
+      status: 'disabled'
+    secret_scanning_push_protection:
+      status: 'disabled'
+  network_count: 0
+  subscribers_count: 1
+```
+
+### Shape of A RepositoryDetails Fact Check
+
+The shape of a RepositoryDetails Fact Check matches the [Shape of a Fact Check](https://www.npmjs.com/package/@spotify/backstage-plugin-soundcheck-backend#shape-of-a-fact-check).
+
+The following is an example of the RepositoryDetails fact checks:
+
+```yaml
+soundcheck:
+  checks:
+    - id: allows_rebase_merge
+      rule:
+        factRef: github:default/repo_details
+        path: $.allow_rebase_merge
+        operator: equal
+        value: true
+    - id: has_less_than_ten_open_issues
+      rule:
+        factRef: github:default/repo_details
+        path: $.open_issues
+        operator: lessThan
+        value: 10
+```
+
+The following is an example of the Soundcheck program that utilizes these checks:
+
+```yaml
+- id: demo
+  name: Demo
+  ownerEntityRef: group:default/owning_group
+  description: Demonstration of Soundcheck RepositoryDetails Fact Extractor
+  levels:
+    - ordinal: 1
+      name: First level
+      description: Checks leveraging Soundcheck's Github RepositoryDetails Fact Extractor
+      checks:
+        - id: allows_rebase_merge
+          name: Allows Rebase Merge
+          description: Repository allows rebase merge
+        - id: has_less_than_ten_open_issues
+          name: Has Less Than 10 Open Issues
+          description: Github Repository Has Less Than 10 Open Issues
+```

package/dist/index.cjs.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var s=require("@spotify/backstage-plugin-soundcheck-common"),nt=require("@backstage/catalog-model"),ct=require("@octokit/request-error"),lt=require("@octokit/rest"),N=require("@backstage/integration"),v=require("zod"),ht=require("@backstage/errors"),ft=require("git-url-parse");function dt(t){return t&&typeof t=="object"&&"default"in t?t:{default:t}}var ut=dt(ft),pt=(t,e,r)=>{if(!e.has(t))throw TypeError("Cannot "+r)},W=(t,e,r)=>(pt(t,e,"read from private field"),r?r.call(t):e.get(t)),gt=(t,e,r)=>{if(e.has(t))throw TypeError("Cannot add the same private member more than once");e instanceof WeakSet?e.add(t):e.set(t,r)},d;function vt(t){return`Extractor with type '${t}' is not allowed. You may need to update collectors configuration at 'soundcheck.collectors.github'`}class mt{constructor(){gt(this,d,[])}register(e){W(this,d).push(e)}async extract(e,r,a){for(const{predicate:i,extractor:n}of W(this,d))if(i(e))return n.extract(e,r,a);throw new Error(vt(e.type))}toString(){return`predicateMux{extractors=${W(this,d).map(e=>e.extractor).join(",")}`}}d=new WeakMap;class wt{static create(e){const{logger:r,branchHelper:a,factories:i}=e,n=new mt;for(const k of i!=null?i:[]){const S=k({logger:r,branchHelper:a});n.register(S)}return n}}var F=(t,e,r)=>{if(!e.has(t))throw TypeError("Cannot "+r)},U=(t,e,r)=>(F(t,e,"read from private field"),r?r.call(t):e.get(t)),M=(t,e,r)=>{if(e.has(t))throw TypeError("Cannot add the same private member more than once");e instanceof WeakSet?e.add(t):e.set(t,r)},J=(t,e,r,a)=>(F(t,e,"write to private field"),a?a.call(t,r):e.set(t,r),r),yt=(t,e,r)=>(F(t,e,"access private method"),r),m,w,R,A;const L=class{constructor(t,e){M(this,R),M(this,m,void 0),M(this,w,void 0),J(this,m,t),J(this,w,e)}async extract(t,e,r){const a={owner:e.owner,repo:e.name,branch:await yt(this,R,A).call(this,t,e,r)};try{return(await r.rest.repos.getBranchProtection(a)).data}catch(i){return U(this,m).error(`[BranchProtections] fact extraction failed with: ${i}. Request parameters: ${JSON.stringify(a)}`),i instanceof ct.RequestError&&i.status===404?{}:void 0}}};let Y=L;m=new WeakMap,w=new WeakMap,R=new WeakSet,A=async function(t,e,r){return t.branch?t.branch:U(this,w).getDefaultBranch(e,r)},Y.factory=({logger:t,branchHelper:e})=>{const r=new L(t,e);return{predicate:a=>a.type==="BranchProtections",extractor:r}};var K=(t,e,r)=>{if(!e.has(t))throw TypeError("Cannot "+r)},$t=(t,e,r)=>(K(t,e,"read from private field"),r?r.call(t):e.get(t)),bt=(t,e,r)=>{if(e.has(t))throw TypeError("Cannot add the same private member more than once");e instanceof WeakSet?e.add(t):e.set(t,r)},Et=(t,e,r,a)=>(K(t,e,"write to private field"),a?a.call(t,r):e.set(t,r),r),y;const Q=class{constructor(t){bt(this,y,void 0),Et(this,y,t)}async extract(t,e,r){const a={owner:e.owner,repo:e.name};try{return(await r.rest.repos.get(a)).data}catch(i){$t(this,y).error(`[RepositoryDetails] fact extraction failed with: ${i}. Request parameters: ${JSON.stringify(a)}`);return}}};let V=Q;y=new WeakMap,V.factory=({logger:t})=>{const e=new Q(t);return{predicate:r=>r.type==="RepositoryDetails",extractor:e}};const xt=s.BaseFactExtractorSchema.and(v.z.object({type:v.z.string().regex(new RegExp("BranchProtections"))})),Ct=s.BaseFactExtractorSchema.and(v.z.object({type:v.z.string().regex(new RegExp("RepositoryDetails"))})),kt=xt.or(Ct),St=s.buildFactCollectorSchema(kt);var q=(t,e,r)=>{if(!e.has(t))throw TypeError("Cannot "+r)},P=(t,e,r)=>(q(t,e,"read from private field"),r?r.call(t):e.get(t)),T=(t,e,r)=>{if(e.has(t))throw TypeError("Cannot add the same private member more than once");e instanceof WeakSet?e.add(t):e.set(t,r)},B=(t,e,r,a)=>(q(t,e,"write to private field"),a?a.call(t,r):e.set(t,r),r),X=(t,e,r)=>(q(t,e,"access private method"),r),h,$,b,D;const Z=class{constructor(t,e){T(this,b),T(this,h,void 0),T(this,$,void 0);var r;B(this,$,t),B(this,h,X(this,b,D).call(this,e)),(r=e.subscribe)==null||r.call(e,()=>{B(this,h,X(this,b,D).call(this,e))})}static create(t,e){return new Z(t,e)}getExtractorConfig(t){return P(this,h)[t]}getExtractorConfigs(){return Object.values(P(this,h))}};let Wt=Z;h=new WeakMap,$=new WeakMap,b=new WeakSet,D=function(t){const e=t.getOptional("soundcheck.collectors.github");if(!e)return{};const r=St.safeParse(e);if(!r.success)throw P(this,$).error("Failed to parse GithubFactCollector from schema."),new ht.InputError(r.error.message);return s.buildExtractorConfigMap(r.data)};var tt=(t,e,r)=>{if(!e.has(t))throw TypeError("Cannot "+r)},O=(t,e,r)=>(tt(t,e,"read from private field"),r?r.call(t):e.get(t)),et=(t,e,r)=>{if(e.has(t))throw TypeError("Cannot add the same private member more than once");e instanceof WeakSet?e.add(t):e.set(t,r)},rt=(t,e,r,a)=>(tt(t,e,"write to private field"),a?a.call(t,r):e.set(t,r),r),E,u;const at=class{constructor(t,e){et(this,E,void 0),et(this,u,void 0),rt(this,E,t),rt(this,u,e)}static create(t,e){return new at(t,e)}async getDefaultBranch(t,e){let r=await O(this,u).get(t.full_name);if(r!==void 0)return r;const a={owner:t.owner,repo:t.name};try{r=(await e.rest.repos.get(a)).data.default_branch,await O(this,u).set(t.full_name,r)}catch(i){t.ref?r=t.ref:r="main",O(this,E).error(`Failed to get default branch name with: ${i}. Request parameters: ${JSON.stringify(a)}. Falling back to using [${r}] as default branch`)}return r}};let Ft=at;E=new WeakMap,u=new WeakMap;var _=(t,e,r)=>{if(!e.has(t))throw TypeError("Cannot "+r)},o=(t,e,r)=>(_(t,e,"read from private field"),r?r.call(t):e.get(t)),f=(t,e,r)=>{if(e.has(t))throw TypeError("Cannot add the same private member more than once");e instanceof WeakSet?e.add(t):e.set(t,r)},p=(t,e,r,a)=>(_(t,e,"write to private field"),a?a.call(t,r):e.set(t,r),r),Mt=(t,e,r)=>(_(t,e,"access private method"),r),c,g,x,C,l,j,it;const G=class{constructor(t,e,r){f(this,j),f(this,c,void 0),f(this,g,void 0),f(this,x,void 0),f(this,C,void 0),f(this,l,void 0),this.id=G.ID,p(this,c,e.child({target:this.id})),p(this,g,N.ScmIntegrations.fromConfig(t)),p(this,x,N.DefaultGithubCredentialsProvider.fromIntegrations(o(this,g))),p(this,C,wt.create({logger:o(this,c),branchHelper:Ft.create(o(this,c),r.getClient({defaultTtl:60*60*1e3})),factories:[Y.factory,V.factory]})),p(this,l,Wt.create(o(this,c),t))}static create(t,e,r){return new G(t,e,r)}async collect(t,e){const r=Mt(this,j,it).call(this,e);return Promise.all(t.filter(a=>s.isScmEntity(a)).map(async a=>{const i=nt.stringifyEntityRef(a),n=s.getEntityScmUrl(a),k=ut.default(n),S=await this.getOctokit(n);return Promise.all(r.map(async z=>{const H=s.getFactRef(this.id,z),I=await o(this,C).extract(z,k,S).catch(st=>{o(this,c).error(`Failed to collect ${H} fact data for ${i} entity: ${st}`)});if(I!==void 0)return s.buildFact(i,H,I)}))})).then(a=>a.flat().filter(i=>!!i))}async getOctokit(t){const{token:e}=await o(this,x).getCredentials({url:t}),r=o(this,g).github.byUrl(t);return new lt.Octokit({auth:e,baseUrl:r==null?void 0:r.config.apiBaseUrl})}async getCollectionConfigs(){return s.buildCollectionConfigs(this.id,o(this,l).getExtractorConfigs())}async getFactNames(){return o(this,l).getExtractorConfigs().map(t=>t.factName)}async getDataSchema(t){}};let ot=G;c=new WeakMap,g=new WeakMap,x=new WeakMap,C=new WeakMap,l=new WeakMap,j=new WeakSet,it=function(t){return t!=null&&t.factRefs?o(this,l).getExtractorConfigs().filter(e=>{var r,a;return(a=(r=t==null?void 0:t.factRefs)==null?void 0:r.map(s.stringifyFactRef))==null?void 0:a.includes(s.getFactRef(this.id,e))}):o(this,l).getExtractorConfigs()},ot.ID="github",exports.GithubFactCollector=ot;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+import { FactRef, Fact, CollectionConfig } from '@spotify/backstage-plugin-soundcheck-common';
+import { Entity } from '@backstage/catalog-model';
+import { Logger } from 'winston';
+import { Config } from '@backstage/config';
+import { PluginCacheManager } from '@backstage/backend-common';
+import { FactCollector } from '@spotify/backstage-plugin-soundcheck-node';
+
+/**
+ * Soundcheck 3rd party integration - Github.
+ *
+ * @public
+ */
+declare class GithubFactCollector implements FactCollector {
+    #private;
+    /**
+     * Source identifier used by the {@link GithubFactCollector}.
+     */
+    static ID: string;
+    static create(config: Config, logger: Logger, cache: PluginCacheManager): GithubFactCollector;
+    /** {@inheritDoc @spotify/backstage-plugin-soundcheck-node#FactCollector.id} */
+    id: string;
+    private constructor();
+    /** {@inheritDoc @spotify/backstage-plugin-soundcheck-node#FactCollector.collect} */
+    collect(entities: Entity[], params?: {
+        factRefs?: FactRef[];
+        refresh?: FactRef[];
+    }): Promise<Fact[]>;
+    /** {@inheritDoc @spotify/backstage-plugin-soundcheck-node#FactCollector.getCollectionConfigs} */
+    getCollectionConfigs(): Promise<CollectionConfig[]>;
+    /** {@inheritDoc @spotify/backstage-plugin-soundcheck-node#FactCollector.getFactNames} */
+    getFactNames(): Promise<string[]>;
+    /** {@inheritDoc @spotify/backstage-plugin-soundcheck-node#FactCollector.getDataSchema} */
+    getDataSchema(_factRef: FactRef): Promise<string | undefined>;
+}
+
+export { GithubFactCollector };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@spotify/backstage-plugin-soundcheck-backend-module-github",
+  "description": "Soundcheck 3rd party integration with Github",
+  "version": "0.1.0",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "homepage": "https://backstage.spotify.com/",
+  "main": "dist/index.cjs.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
+  },
+  "backstage": {
+    "role": "node-library"
+  },
+  "scripts": {
+    "build": "backstage-cli package build --minify",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test",
+    "clean": "backstage-cli package clean",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack"
+  },
+  "devDependencies": {
+    "@backstage/cli": "^0.22.4",
+    "@types/git-url-parse": "^9.0.0"
+  },
+  "dependencies": {
+    "@backstage/backend-common": "^0.18.3",
+    "@backstage/catalog-model": "^1.2.1",
+    "@backstage/config": "^1.0.7",
+    "@backstage/errors": "^1.1.5",
+    "@backstage/integration": "^1.4.3",
+    "@backstage/types": "^1.0.2",
+    "@octokit/request-error": "^3.0.3",
+    "@octokit/rest": "^19.0.3",
+    "@spotify/backstage-plugin-soundcheck-common": "^0.4.0",
+    "@spotify/backstage-plugin-soundcheck-node": "^0.2.0",
+    "git-url-parse": "^13.0.0",
+    "lodash": "^4.17.21",
+    "winston": "^3.2.1",
+    "zod": "^3.20.0"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map"
+  ]
+}