feat(security): Add provenance (#420)

This enables provenance. Please note that this PR was created
automatically (using Octokit), so it may not be perfect.

.github/workflows/release.yml

@@ -6,6 +6,13 @@
       - beta
       - "*.x"
 name: Release
+# These are recommended by the semantic-release docs: https://github.com/semantic-release/npm#npm-provenance
+permissions:
+    contents: write # to be able to publish a GitHub release
+    issues: write # to be able to comment on released issues
+    pull-requests: write # to be able to comment on released pull requests
+    id-token: write # to enable use of OIDC for npm provenance
+
 jobs:
   build:
     name: release

package.json

@@ -2,7 +2,8 @@
   "name": "@octokit/rest",
   "version": "0.0.0-development",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "description": "GitHub REST API client for Node.js",
   "keywords": [