feat: add proxios wrapper

.github/workflows/release.yml

@@ -0,0 +1,31 @@
+name: Release
+
+on:
+    push:
+        branches: [main]
+
+jobs:
+    release:
+        name: Release
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v2
+            - name: Setup Node.js
+              uses: actions/setup-node@v1
+              with:
+                  node-version: 14.x
+            - name: Install dependencies
+              run: npx ci
+            - name: Install semantic-release extra plugins
+              run: npm install --save-dev @semantic-release/changelog @semantic-release/git
+            - name: Test
+              run: npm run test
+            - name: Build
+              run: npm run build
+            - name: Release
+              env:
+                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+                  NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+              run: npx semantic-release

.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx --no-install commitlint --edit ""

.npmignore

@@ -0,0 +1,6 @@
+src
+tsconfig.json
+coverage
+*.config.js
+tests
+.prettierrc

.prettierrc

@@ -0,0 +1,6 @@
+{
+    "tabWidth": 4,
+    "arrowParens": "avoid",
+    "semi": true,
+    "printWidth": 120
+}

README.md

@@ -1 +1 @@
-# proxios
+# praxios

commitlint.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+    extends: ["@commitlint/config-conventional"],
+    rules: {
+        "body-max-line-length": [0, "always"],
+    },
+};

jest.config.js

@@ -0,0 +1,6 @@
+/** @type {import('ts-jest/dist/types').InitialOptionsTsJest} */
+module.exports = {
+    preset: "ts-jest",
+    testEnvironment: "node",
+    collectCoverage: true,
+};

package.json

@@ -0,0 +1,29 @@
+{
+    "name": "praxios",
+    "version": "0.0.0-semantic-release",
+    "description": "wrapper to support corporate proxies in axios",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "repository": "git@github.com:Safe-Security/praxios.git",
+    "author": "Aneesh Relan <aneesh.relan@gmail.com>",
+    "license": "MIT",
+    "dependencies": {
+        "axios": "^0.21.4",
+        "tunnel": "^0.0.6"
+    },
+    "devDependencies": {
+        "@commitlint/cli": "^13.2.0",
+        "@commitlint/config-conventional": "^13.2.0",
+        "@types/jest": "^27.0.2",
+        "@types/tunnel": "^0.0.3",
+        "husky": "^7.0.2",
+        "jest": "^27.2.3",
+        "ts-jest": "^27.0.5",
+        "typescript": "^4.4.3"
+    },
+    "scripts": {
+        "build": "tsc",
+        "test": "jest",
+        "prepare": "husky install"
+    }
+}

release.config.js

@@ -0,0 +1,23 @@
+module.exports = {
+    branches: ["main"],
+    plugins: [
+        "@semantic-release/commit-analyzer",
+        "@semantic-release/release-notes-generator",
+        [
+            "@semantic-release/changelog",
+            {
+                changelogFile: "CHANGELOG.md",
+            },
+        ],
+        "@semantic-release/npm",
+        "@semantic-release/github",
+        [
+            "@semantic-release/git",
+            {
+                assets: ["CHANGELOG.md", "dist/**"],
+                message:
+                    "chore(release): set `package.json` to ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}",
+            },
+        ],
+    ],
+};

src/index.ts

@@ -0,0 +1,34 @@
+import axios from "axios";
+import * as tunnel from "tunnel";
+
+const { PROXY_HOST, PROXY_PORT, PROXY_USERNAME, PROXY_PASSWORD, NO_PROXY } = process.env;
+
+const isProxyDefined = (): boolean => {
+    return PROXY_HOST !== undefined && PROXY_PORT !== undefined;
+};
+
+const getProxyAuth = (): string | undefined => {
+    if (PROXY_USERNAME && PROXY_PASSWORD) {
+        return `${PROXY_USERNAME}:${PROXY_PASSWORD}`;
+    }
+
+    return;
+};
+
+let praxios = axios.create();
+
+if (isProxyDefined()) {
+    const httpsAgent = tunnel.httpsOverHttp({
+        proxy: {
+            host: PROXY_HOST!,
+            port: Number(PROXY_PORT!),
+            localAddress: NO_PROXY,
+            proxyAuth: getProxyAuth(),
+        },
+    });
+
+    praxios = axios.create({ httpsAgent, proxy: false });
+}
+
+export { tunnel, axios as baseAxios };
+export default praxios;

tests/proxios.test.ts

@@ -0,0 +1,53 @@
+import axios from "axios";
+
+let praxios;
+
+describe("praxios", () => {
+    const OLD_ENV = process.env;
+
+    beforeEach(() => {
+        jest.resetModules();
+        process.env = { ...OLD_ENV };
+    });
+
+    afterAll(() => {
+        process.env = OLD_ENV; // Restore old environment
+    });
+
+    test("base axios client is exported if proxy isn't defined", async () => {
+        praxios = (await import("../src/index")).default;
+        expect(praxios.defaults.httpsAgent).toBeUndefined();
+        expect(praxios.defaults.proxy).toBeUndefined();
+    });
+
+    test("proxy instance with tunneling agent is available when proxy env vars are set", async () => {
+        process.env.PROXY_HOST = "dummy";
+        process.env.PROXY_PORT = "3128";
+
+        const praxios = (await import("../src/index")).default;
+
+        expect(praxios.defaults.proxy).toEqual(false);
+        expect(praxios.defaults.httpsAgent.proxyOptions.host).toEqual("dummy");
+        expect(praxios.defaults.httpsAgent.proxyOptions.port).toEqual(3128);
+        expect(praxios.defaults.httpsAgent.proxyOptions.localAddress).toBeUndefined();
+        expect(praxios.defaults.httpsAgent.proxyOptions.proxyAuth).toBeUndefined();
+    });
+
+    test("proxy instance with tunneling agent and proxy auth is available when proxy and auth env vars are set", async () => {
+        process.env.PROXY_HOST = "dummy";
+        process.env.PROXY_PORT = "3128";
+        process.env.PROXY_USERNAME = "foo";
+        process.env.PROXY_PASSWORD = "bar";
+
+        const praxios = (await import("../src/index")).default;
+
+        expect(praxios.defaults.httpsAgent.proxyOptions.proxyAuth).toEqual("foo:bar");
+    });
+
+    test("tunnel and base axios module is available", async () => {
+        const praxios = await import("../src/index");
+
+        expect(praxios).toHaveProperty("baseAxios");
+        expect(praxios).toHaveProperty("tunnel");
+    });
+});

tsconfig.json

@@ -0,0 +1,10 @@
+{
+    "compilerOptions": {
+        "target": "es5",
+        "module": "commonjs",
+        "declaration": true,
+        "outDir": "./dist",
+        "strict": true
+    },
+    "include": ["src"]
+}