feat: add https proxy env support

package.json

@@ -27,7 +27,8 @@
     "@octokit/core": "^3.0.0",
     "@octokit/plugin-paginate-rest": "^2.2.4",
     "@octokit/plugin-rest-endpoint-methods": "5.5.1",
-    "@octokit/types": "^6.16.1"
+    "@octokit/types": "^6.16.1",
+    "https-proxy-agent": "^5.0.0"
   },
   "devDependencies": {
     "@pika/pack": "^0.5.0",

src/index.ts

@@ -5,10 +5,12 @@ import { legacyRestEndpointMethods } from "@octokit/plugin-rest-endpoint-methods
 export { RestEndpointMethodTypes } from "@octokit/plugin-rest-endpoint-methods";
 
 import { VERSION } from "./version";
+import { autoProxyAgent } from "./plugins";
 
 export const Octokit = Core.plugin(
   paginateRest,
-  legacyRestEndpointMethods
+  legacyRestEndpointMethods,
+  autoProxyAgent
 ).defaults({
   authStrategy: createActionAuth,
   baseUrl: getApiBaseUrl(),

src/plugins.ts

@@ -0,0 +1,15 @@
+import { Octokit } from "@octokit/core";
+import { OctokitOptions } from "@octokit/core/dist-types/types";
+import { HttpsProxyAgent } from "https-proxy-agent";
+
+export function autoProxyAgent(octokit: Octokit, options: OctokitOptions) {
+  const proxy = process.env["HTTPS_PROXY"] || process.env["https_proxy"];
+
+  if (!proxy) return;
+
+  const agent = new HttpsProxyAgent(proxy);
+
+  octokit.hook.before("request", (options) => {
+    options.request.agent = agent;
+  });
+}

test/smoke.test.ts

@@ -1,13 +1,19 @@
 import fetchMock from "fetch-mock";
+import { RequestOptions } from "https";
+import { HttpsProxyAgent } from "https-proxy-agent";
 
 import { Octokit } from "../src";
 
+jest.mock("https-proxy-agent");
+
 describe("Smoke test", () => {
   beforeEach(() => {
     delete process.env.GITHUB_TOKEN;
     delete process.env.INPUT_GITHUB_TOKEN;
     delete process.env.GITHUB_ACTION;
     delete process.env.GITHUB_API_URL;
+    delete process.env.HTTPS_PROXY;
+    delete process.env.https_proxy;
   });
 
   it("happy path with GITHUB_TOKEN", () => {
@@ -171,4 +177,45 @@ describe("Smoke test", () => {
 
     expect(data).toStrictEqual({ ok: true });
   });
+
+  it.each(["HTTPS_PROXY", "https_proxy"])(
+    "Uses https-proxy-agent with %s env var",
+    async (https_proxy_env) => {
+      process.env.GITHUB_TOKEN = "secret123";
+      process.env.GITHUB_ACTION = "test";
+      process.env[https_proxy_env] = "https://127.0.0.1";
+
+      const fetchSandbox = fetchMock.sandbox();
+      const mock = fetchSandbox.post(
+        "path:/repos/octocat/hello-world/issues",
+        { id: 1 },
+        {
+          body: {
+            title: "My test issue",
+          },
+        }
+      );
+
+      expect(Octokit).toBeInstanceOf(Function);
+      const octokit = new Octokit({
+        auth: "secret123",
+        request: {
+          fetch: mock,
+        },
+      });
+      await octokit.request("POST /repos/{owner}/{repo}/issues", {
+        owner: "octocat",
+        repo: "hello-world",
+        title: "My test issue",
+      });
+
+      expect(HttpsProxyAgent).toHaveBeenCalledWith("https://127.0.0.1");
+
+      const [call] = fetchSandbox.calls();
+      expect(call[0]).toEqual(
+        "https://api.github.com/repos/octocat/hello-world/issues"
+      );
+      expect((call[1] as RequestOptions).agent).toBeInstanceOf(HttpsProxyAgent);
+    }
+  );
 });