ci: implement canary releases on PRs

Author: IvanGoncharov

.github/workflows/canary.yaml

@@ -7,13 +7,83 @@ on:
       - completed
 env:
   NODE_VERSION_USED_FOR_DEVELOPMENT: 17
+  CI_WORKFLOW_ID: ${{github.event.workflow_run.id}}
 jobs:
   publish-canary:
     runs-on: ubuntu-latest
     name: Publish Canary
     if: ${{ github.event.workflow_run.event == 'pull_request' }}
     steps:
-      - name: Dump GitHub context
-        run: echo "$GITHUB_CONTEXT"
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          cache: npm
+          node-version: ${{ env.NODE_VERSION_USED_FOR_DEVELOPMENT }}
+          # 'registry-url' is required for 'npm publish'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Download saved_github_event.json
+        run: gh run download "$CI_WORKFLOW_ID" -n saved_github_event.json
+
+      - name: Download NPM package artifact
+        run: gh run download "$CI_WORKFLOW_ID" -n npmDist -D npmDist
+
+      - name: Modify NPM package to be canary release
+        uses: actions/github-script@v5
+        with:
+          script: |
+            const assert = require('assert');
+            const { readFileSync, writeFileSync } = require('fs');
+
+            const prNumber = payload.workflow_run.number;
+            const prSHA = context.sha;
+
+            const packageJSONPath = './npmDist/package.json';
+            const packageJSON = JSON.parse(readFileSync(packageJSONPath, 'utf-8'));
+
+            assert(packageJSON.scripts == null, 'No scripts allowed for security reasons!');
+
+            let { version } = packageJSON;
+            assert(!version.includes('+'), 'Can not append after metadata');
+            version += packageJSON.version.includes('-') ? '.' : '-';
+            version += `canary.pr.${prNumber}.${prSHA}`;
+
+            const tag = `canary-pr-${prNumber}`;
+
+            packageJSON.version = version;
+            packageJSON.publishConfig.tag = `canary-pr-${prNumber}`;
+            writeFileSync(packageJSONPath, JSON.stringify(packageJSON, null, 2), 'utf-8');
+
+            core.exportVariable('NPM_VERSION', version);
+            core.exportVariable('NPM_TAG', tag);
+
+      - name: Publish NPM package
+        run: npm publish ./npmDist
         env:
-          GITHUB_CONTEXT: ${{ toJson(github) }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Add deprecate message on NPM package
+        run: |
+          npm deprecate "graphql@$NPM_VERSION" \
+            "You are using canary version build from $PR_URL, no gurantees provided so please use your own discretion."
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          PR_URL: ${{github.event.pull_request.url}}
+
+      - name: Add comment on PR
+        uses: actions/github-script@v5
+        with:
+          github-token: ${{secrets.GITHUB_TOKEN}}
+          script: |
+            const npmTag = process.env.NPM_TAG;
+            const npmVersion = process.env.NPM_VERSION;
+            const npmURL = 'https://www.npmjs.com/package/graphql/v/' + npmVersion;
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body:
+                `The latest changes of this PR are available as ['graphql@${npmVersion}'](${npmURL}) on NPM.\n` +
+                '**Note: no gurantees provided so please use your own discretion.**\n\n' +
+                `Also you can depend on latest version built from this PR: \`npm install --save graphql@${npmTag}\`.`,
+            })

.github/workflows/ci.yml

@@ -3,6 +3,16 @@ on: [push, pull_request]
 env:
   NODE_VERSION_USED_FOR_DEVELOPMENT: 17
 jobs:
+  save-github-event:
+    name: "Save `github.event` as an artifact to use in subsequent 'workflow_run' actions"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Upload github_event.json
+        uses: actions/upload-artifact@v2
+        with:
+          name: github_event.json
+          path: ${{ github.event_path }}
+
   lint:
     name: Lint source files
     runs-on: ubuntu-latest