@vida-global/core 2.1.0 → 2.1.1

package/lib/http/README.md

@@ -25,10 +25,8 @@ class MyApiClient extends HttpClient {
         return this.#dev ? 'https://staging.foo.com' : 'https://foo.com';
     }
 
-    get defaultHeaders() {
-        const headers = super.defaultHeaders;
-        headers.Authorization = `Bearer ${this.#token}`;
-        return headers;
+    get bearerToken() {
+        return this.#token;
     }
 
     async getTickets({ page, pageSize }) {
@@ -104,4 +102,6 @@ Subclasses customize behavior through getters on the class:
 
 - `urlRoot` — base URL prepended to every endpoint.
 - `defaultHeaders` — merged into every request (per-call `headers` override).
+- `bearerToken` — when it returns a value, a `Authorization: Bearer <token>` header is added to `defaultHeaders`.
+- `basicAuthUsername` / `basicAuthPassword` — when both return values, a `Authorization: Basic <base64>` header is added to `defaultHeaders`. `bearerToken` takes precedence if both are set.
 - `logger` — scoped logger used for the `API CALL: ...` debug line emitted on each request (defaults to `logger.http`).

package/lib/http/client.js

@@ -178,10 +178,41 @@ class HttpClient {
 
 
     get defaultHeaders() {
-        return {
+        const headers = {
             Accept: "application/json",
             "Content-Type": "application/json",
-        }
+        };
+        if (this.authorizationHeader) headers.Authorization = this.authorizationHeader;
+        return headers;
+    }
+
+
+    get authorizationHeader() {
+        if (this.bearerToken)          return `Bearer ${this.bearerToken}`;
+        if (this.basicAuthCredentials) return `Basic ${this.basicAuthCredentials}`;
+        return null;
+    }
+
+
+    get bearerToken() {
+        return null;
+    }
+
+
+    get basicAuthCredentials() {
+        if (!this.basicAuthUsername || !this.basicAuthPassword) return null;
+        const credentials = `${this.basicAuthUsername}:${this.basicAuthPassword}`;
+        return Buffer.from(credentials).toString('base64');
+    }
+
+
+    get basicAuthUsername() {
+        return null;
+    }
+
+
+    get basicAuthPassword() {
+        return null;
     }
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vida-global/core",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "description": "Core libraries for supporting Vida development",
     "author": "",
     "license": "ISC",

package/test/http/client.test.js

@@ -26,6 +26,40 @@ describe('HttpClient', () => {
     });
 
 
+    describe('HttpClient#authorizationHeader', () => {
+        it('omits the Authorization header by default', async () => {
+            const client = new HttpClient();
+
+            await client.post(Helpers.apiUrl);
+
+            const callHeaders = fetch.mock.calls[0][1].headers;
+            expect(callHeaders.Authorization).toBeUndefined();
+        });
+
+        it('sets a bearer Authorization header when bearerToken is overridden', async () => {
+            const client = new Helpers.ClientWithBearerToken();
+
+            await client.post(Helpers.apiUrl);
+
+            Helpers.expectRequest('POST', Helpers.apiUrl, {
+                headers: { Authorization: `Bearer ${Helpers.bearerToken}` },
+                body: {},
+            });
+        });
+
+        it('sets a basic Authorization header when username and password are overridden', async () => {
+            const client = new Helpers.ClientWithBasicAuth();
+
+            await client.post(Helpers.apiUrl);
+
+            Helpers.expectRequest('POST', Helpers.apiUrl, {
+                headers: { Authorization: `Basic ${Helpers.basicAuthCredentials}` },
+                body: {},
+            });
+        });
+    });
+
+
     const httpMethods = [
         ['post',   'POST',   { supportsBody: true }],
         ['put',    'PUT',    { supportsBody: true }],

package/test/http/helpers/client.js

@@ -26,6 +26,33 @@ class ClientWithUrlRoot extends HttpClient {
 }
 
 
+const bearerToken = TestHelpers.Faker.Text.randomString();
+
+
+class ClientWithBearerToken extends HttpClient {
+    get bearerToken() {
+        return bearerToken;
+    }
+}
+
+
+const basicAuthUsername    = TestHelpers.Faker.Text.randomString();
+const basicAuthPassword    = TestHelpers.Faker.Text.randomString();
+const basicAuthCredentials = Buffer.from(`${basicAuthUsername}:${basicAuthPassword}`).toString('base64');
+
+
+class ClientWithBasicAuth extends HttpClient {
+    get basicAuthUsername() {
+        return basicAuthUsername;
+    }
+
+
+    get basicAuthPassword() {
+        return basicAuthPassword;
+    }
+}
+
+
 /***************************************************************************************************
 * MOCKS
 ***************************************************************************************************/
@@ -80,6 +107,10 @@ function buildExpectedRequest({ method, headers, body }) {
 
 module.exports = {
     apiUrl,
+    basicAuthCredentials,
+    bearerToken,
+    ClientWithBasicAuth,
+    ClientWithBearerToken,
     ClientWithUrlRoot,
     endpoint,
     expectRequest,