devops: Add ci warning for swizzled docusaurus components

.github/actions/docusaurus-swizzled-warning/action.yml

@@ -0,0 +1,12 @@
+name: 'Docusaurus swizzled component changes warning'
+description: 'Check for changes in Docusaurus components which are swizzled and prints out a warning'
+branding:
+  icon: 'alert-triangle'
+  color: 'yellow'
+inputs:
+  github-token:
+    description: 'The GITHUB_TOKEN secret'
+    required: true
+runs:
+  using: 'node16'
+  main: 'index.js'

.github/actions/docusaurus-swizzled-warning/helpers.js

@@ -0,0 +1,75 @@
+'use strict'
+
+/**
+ * Returns info about all files changed in a PR (max 3000 results)
+ *
+ * @param {object} client hydrated octokit ready to use for GitHub Actions
+ * @param {string} owner repo owner
+ * @param {string} repo repo name
+ * @param {number} pullNumber pull request number
+ * @returns {object[]} array of object that describe pr changed files - see https://docs.github.com/en/rest/pulls/pulls?apiVersion=2022-11-28#list-pull-requests-files
+ */
+async function getAllFilesForPullRequest(client, owner, repo, pullNumber) {
+  const perPage = 100 // Max number of items per page
+  let page = 1 // Start with the first page
+  let allFiles = []
+  while (true) {
+    const response = await client.rest.pulls.listFiles({
+      owner,
+      repo,
+      pull_number: pullNumber,
+      per_page: perPage,
+      page,
+    })
+
+    if (response.data.length === 0) {
+      // Break the loop if no more results
+      break
+    }
+
+    allFiles = allFiles.concat(response.data)
+    page++ // Move to the next page
+  }
+  return allFiles
+}
+
+/**
+ * Get a list of files changed betwen two tags for a github repo
+ *
+ * @param {object} client hydrated octokit ready to use for GitHub Actions
+ * @param {string} owner repo owner
+ * @param {string} repo repo name
+ * @param {string} baseTag base tag
+ * @param {string} headTag head tag
+ * @returns {string[]} Array listing all changed files betwen the base tag and the head tag
+ */
+async function getChangedFilesBetweenTags(
+  client,
+  owner,
+  repo,
+  baseTag,
+  headTag,
+) {
+  const response = await client.rest.repos.compareCommits({
+    owner,
+    repo,
+    base: baseTag,
+    head: headTag,
+  })
+
+  return response.data.files.map(file => file.filename)
+}
+
+function findKeyEndingWith(obj, ending) {
+  for (const key in obj) {
+    if (key.endsWith(ending)) {
+      return key
+    }
+  }
+}
+
+module.exports = {
+  getAllFilesForPullRequest,
+  getChangedFilesBetweenTags,
+  findKeyEndingWith,
+}

.github/actions/docusaurus-swizzled-warning/index.js

@@ -0,0 +1,135 @@
+'use strict'
+
+const core = require('@actions/core')
+const github = require('@actions/github')
+const fetch = require('node-fetch')
+const {
+  getAllFilesForPullRequest,
+  getChangedFilesBetweenTags,
+  findKeyEndingWith,
+} = require('./helpers')
+
+async function run() {
+  try {
+    const token = core.getInput('github-token', { required: true })
+
+    const { pull_request: pr } = github.context.payload
+    if (!pr) {
+      throw new Error('Event payload missing `pull_request`')
+    }
+
+    const client = github.getOctokit(token)
+    const packageName = 'docusaurus-theme-openapi'
+    const packageParentName = 'docusaurus-preset-openapi'
+    const overideComponents = ['Curl', 'Response']
+    const messageTemplate = `<table><thead><tr><th>
+      ⚠️ This PR contains changes to components of ${packageName} we've overridden
+    </th></tr></thead>
+    <tbody><tr><th>
+      We need to watch out for changes to the ${overideComponents.join(
+        ', ',
+      )}components
+    </th></tr>
+    `
+
+    if (
+      ['dependabot[bot]', 'dependabot-preview[bot]'].includes(pr.user.login)
+    ) {
+      const files = await getAllFilesForPullRequest(
+        client,
+        github.context.repo.owner,
+        github.context.repo.repo,
+        pr.number,
+      )
+
+      for (const file of files) {
+        if (file.filename !== 'package-lock.json') {
+          continue
+        }
+
+        const pkgLockNewJson = await (await fetch(file.raw_url)).json()
+        const pkgLockOldJson = await (
+          await fetch(
+            `https://raw.githubusercontent.com/${github.context.repo.owner}/${github.context.repo.repo}/master/${file.filename}`,
+          )
+        ).json()
+        const oldVesionModuleKey = findKeyEndingWith(
+          pkgLockOldJson.packages,
+          `node_modules/${packageName}`,
+        )
+        const newVesionModuleKey = findKeyEndingWith(
+          pkgLockNewJson.packages,
+          `node_modules/${packageName}`,
+        )
+        let oldVersion = pkgLockOldJson.packages[oldVesionModuleKey].version
+        let newVersion = pkgLockNewJson.packages[newVesionModuleKey].version
+
+        const oldVesionModuleKeyParent = findKeyEndingWith(
+          pkgLockOldJson.packages,
+          `node_modules/${packageParentName}`,
+        )
+        const newVesionModuleKeyParent = findKeyEndingWith(
+          pkgLockNewJson.packages,
+          `node_modules/${packageParentName}`,
+        )
+        const oldVersionParent =
+          pkgLockOldJson.packages[oldVesionModuleKeyParent].dependencies[
+            packageName
+          ].substring(1)
+        const newVersionParent =
+          pkgLockNewJson.packages[newVesionModuleKeyParent].dependencies[
+            packageName
+          ].substring(1)
+
+        // if parent dependency is higher version then existing
+        // npm install will retrive the newer version from the parent dependency
+        if (oldVersionParent > oldVersion) {
+          oldVersion = oldVersionParent
+        }
+        if (newVersionParent > newVersion) {
+          newVersion = newVersionParent
+        }
+
+        if (newVersion !== oldVersion) {
+          const pkgChangedFiles = await getChangedFilesBetweenTags(
+            client,
+            'cloud-annotations',
+            'docusaurus-openapi',
+            `v${oldVersion}`,
+            `v${newVersion}`,
+          )
+          const changedComponents = overideComponents.filter(
+            componenet =>
+              pkgChangedFiles.filter(
+                path =>
+                  path.includes('docusaurus-theme-openapi/src/theme') &&
+                  path.includes(componenet),
+              ).length > 0,
+          )
+          const versionReport = `<tr><th> Old version </th><th> ${oldVersion} </th></tr>
+          <tr><th> New version </th><th> ${newVersion} </th></tr>
+          `
+          const changedComponentsReport = `<tr><th> Overide components changed </th><th> ${changedComponents.join(
+            ', ',
+          )} </th></tr></tbody></table>
+          `
+          const body = messageTemplate + versionReport + changedComponentsReport
+          await client.rest.issues.createComment({
+            owner: github.context.repo.owner,
+            repo: github.context.repo.repo,
+            issue_number: pr.number,
+            body,
+          })
+
+          core.debug('Found changes and posted comment, done.')
+          return
+        }
+      }
+      core.debug('No changes found, done.')
+    }
+  } catch (error) {
+    core.setFailed(error.message)
+  }
+}
+
+run()