@squiz/dx-common-lib 1.72.3 → 1.72.4

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change Log
 
+## 1.72.4
+
+### Patch Changes
+
+- aa25b15: Force user-agent to be set for all requests, and fix session parsing bug
+
 ## 1.72.3
 
 ### Patch Changes

package/lib/index.d.ts

@@ -21,3 +21,4 @@ export * from './secret-api-key-service/getSecretApiKeyService';
 export * from './events/EventBusService';
 export * from './stream/EventStreamHandler';
 export * from './stream/StreamUtils';
+export * from './outbound-http';

package/lib/index.js

@@ -37,4 +37,5 @@ __exportStar(require("./secret-api-key-service/getSecretApiKeyService"), exports
 __exportStar(require("./events/EventBusService"), exports);
 __exportStar(require("./stream/EventStreamHandler"), exports);
 __exportStar(require("./stream/StreamUtils"), exports);
+__exportStar(require("./outbound-http"), exports);
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,0CAAwB;AACxB,yCAAuB;AACvB,qDAAmC;AACnC,iEAA+C;AAC/C,+DAA6C;AAC7C,+EAA6D;AAC7D,+EAA6D;AAC7D,gFAA8D;AAC9D,wEAAsD;AACtD,0CAAwB;AACxB,+CAA6B;AAC7B,iHAA+F;AAC/F,gHAA8F;AAC9F,sGAAoF;AACpF,sGAAoF;AACpF,iFAA+D;AAC/D,+EAA6D;AAC7D,kFAAgE;AAChE,kFAAgE;AAChE,2DAAyC;AACzC,8DAA4C;AAC5C,uDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,0CAAwB;AACxB,yCAAuB;AACvB,qDAAmC;AACnC,iEAA+C;AAC/C,+DAA6C;AAC7C,+EAA6D;AAC7D,+EAA6D;AAC7D,gFAA8D;AAC9D,wEAAsD;AACtD,0CAAwB;AACxB,+CAA6B;AAC7B,iHAA+F;AAC/F,gHAA8F;AAC9F,sGAAoF;AACpF,sGAAoF;AACpF,iFAA+D;AAC/D,+EAA6D;AAC7D,kFAAgE;AAChE,kFAAgE;AAChE,2DAAyC;AACzC,8DAA4C;AAC5C,uDAAqC;AACrC,kDAAgC"}

package/lib/outbound-http/createServiceUserAgent.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builds a User-Agent string for outbound service-to-service HTTP requests.
+ *
+ * @param serviceName Service identifier, e.g. `content-api` or `@squiz/content-api`
+ */
+export declare function createServiceUserAgent(serviceName: string): string;

package/lib/outbound-http/createServiceUserAgent.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServiceUserAgent = createServiceUserAgent;
+/**
+ * Builds a User-Agent string for outbound service-to-service HTTP requests.
+ *
+ * @param serviceName Service identifier, e.g. `content-api` or `@squiz/content-api`
+ */
+function createServiceUserAgent(serviceName) {
+    const name = serviceName.replace(/^@squiz\//, '');
+    return `Squiz/${name}`;
+}
+//# sourceMappingURL=createServiceUserAgent.js.map

package/lib/outbound-http/createServiceUserAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createServiceUserAgent.js","sourceRoot":"","sources":["../../src/outbound-http/createServiceUserAgent.ts"],"names":[],"mappings":";;AAKA,wDAGC;AARD;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,WAAmB;IACxD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,SAAS,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/lib/outbound-http/createServiceUserAgent.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/outbound-http/createServiceUserAgent.spec.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const createServiceUserAgent_1 = require("./createServiceUserAgent");
+describe('createServiceUserAgent', () => {
+    it('returns Squiz/<name> for a scoped package name', () => {
+        expect((0, createServiceUserAgent_1.createServiceUserAgent)('@squiz/content-api')).toBe('Squiz/content-api');
+    });
+    it('returns Squiz/<name> for an unscoped service name', () => {
+        expect((0, createServiceUserAgent_1.createServiceUserAgent)('content-api')).toBe('Squiz/content-api');
+    });
+});
+//# sourceMappingURL=createServiceUserAgent.spec.js.map

package/lib/outbound-http/createServiceUserAgent.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createServiceUserAgent.spec.js","sourceRoot":"","sources":["../../src/outbound-http/createServiceUserAgent.spec.ts"],"names":[],"mappings":";;AAAA,qEAAkE;AAElE,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,IAAA,+CAAsB,EAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,IAAA,+CAAsB,EAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/outbound-http/index.d.ts

@@ -0,0 +1,2 @@
+export { createServiceUserAgent } from './createServiceUserAgent';
+export { outboundFetch, type OutboundFetchInput } from './outboundHttp';

package/lib/outbound-http/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.outboundFetch = exports.createServiceUserAgent = void 0;
+var createServiceUserAgent_1 = require("./createServiceUserAgent");
+Object.defineProperty(exports, "createServiceUserAgent", { enumerable: true, get: function () { return createServiceUserAgent_1.createServiceUserAgent; } });
+var outboundHttp_1 = require("./outboundHttp");
+Object.defineProperty(exports, "outboundFetch", { enumerable: true, get: function () { return outboundHttp_1.outboundFetch; } });
+//# sourceMappingURL=index.js.map

package/lib/outbound-http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/outbound-http/index.ts"],"names":[],"mappings":";;;AAAA,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,+CAAwE;AAA/D,6GAAA,aAAa,OAAA"}

package/lib/outbound-http/outboundHttp.d.ts

@@ -0,0 +1,2 @@
+export type OutboundFetchInput = string | URL | Request;
+export declare function outboundFetch(userAgent: string, input: OutboundFetchInput, init?: RequestInit): Promise<Response>;

package/lib/outbound-http/outboundHttp.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.outboundFetch = outboundFetch;
+function buildOutboundHeaders(userAgent, input, init) {
+    const headers = new Headers();
+    if (input instanceof Request) {
+        input.headers.forEach((value, key) => {
+            headers.set(key, value);
+        });
+    }
+    if (init === null || init === void 0 ? void 0 : init.headers) {
+        new Headers(init.headers).forEach((value, key) => {
+            headers.set(key, value);
+        });
+    }
+    headers.set('User-Agent', userAgent);
+    return headers;
+}
+function outboundFetch(userAgent, input, init) {
+    const headers = buildOutboundHeaders(userAgent, input, init);
+    return fetch(input, { ...init, headers });
+}
+//# sourceMappingURL=outboundHttp.js.map

package/lib/outbound-http/outboundHttp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outboundHttp.js","sourceRoot":"","sources":["../../src/outbound-http/outboundHttp.ts"],"names":[],"mappings":";;AAsBA,sCAGC;AAvBD,SAAS,oBAAoB,CAAC,SAAiB,EAAE,KAAyB,EAAE,IAAkB;IAC5F,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACnC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,EAAE,CAAC;QAClB,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAErC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,aAAa,CAAC,SAAiB,EAAE,KAAyB,EAAE,IAAkB;IAC5F,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7D,OAAO,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/lib/outbound-http/outboundHttp.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/outbound-http/outboundHttp.spec.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const outboundHttp_1 = require("./outboundHttp");
+describe('outboundFetch', () => {
+    const userAgent = 'Squiz/test-service';
+    const originalFetch = global.fetch;
+    beforeEach(() => {
+        global.fetch = jest.fn().mockResolvedValue(new Response());
+    });
+    afterEach(() => {
+        global.fetch = originalFetch;
+    });
+    it('adds User-Agent to string URL requests with init headers', async () => {
+        await (0, outboundHttp_1.outboundFetch)(userAgent, 'https://example.com/resource', {
+            headers: { 'x-api-key': 'secret' },
+        });
+        const init = global.fetch.mock.calls[0][1];
+        const headers = init.headers;
+        expect(headers.get('x-api-key')).toBe('secret');
+        expect(headers.get('User-Agent')).toBe(userAgent);
+    });
+    it('preserves headers from a Request input and adds User-Agent', async () => {
+        const request = new Request('https://example.com/resource', {
+            method: 'GET',
+            headers: {
+                Authorization: 'Bearer token',
+                'x-dxp-tenant': 'tenant-1',
+            },
+        });
+        await (0, outboundHttp_1.outboundFetch)(userAgent, request);
+        const init = global.fetch.mock.calls[0][1];
+        const headers = init.headers;
+        expect(headers.get('Authorization')).toBe('Bearer token');
+        expect(headers.get('x-dxp-tenant')).toBe('tenant-1');
+        expect(headers.get('User-Agent')).toBe(userAgent);
+    });
+    it('merges init headers on top of Request headers without dropping existing values', async () => {
+        const request = new Request('https://example.com/resource', {
+            headers: { 'x-api-key': 'from-request' },
+        });
+        await (0, outboundHttp_1.outboundFetch)(userAgent, request, {
+            headers: { 'x-dxp-session': 'session-token' },
+        });
+        const init = global.fetch.mock.calls[0][1];
+        const headers = init.headers;
+        expect(headers.get('x-api-key')).toBe('from-request');
+        expect(headers.get('x-dxp-session')).toBe('session-token');
+        expect(headers.get('User-Agent')).toBe(userAgent);
+    });
+    it('Overrides an explicit User-Agent header', async () => {
+        await (0, outboundHttp_1.outboundFetch)(userAgent, 'https://example.com/resource', {
+            headers: { 'User-Agent': 'custom-agent' },
+        });
+        const init = global.fetch.mock.calls[0][1];
+        const headers = init.headers;
+        expect(headers.get('User-Agent')).toBe(userAgent);
+    });
+});
+//# sourceMappingURL=outboundHttp.spec.js.map

package/lib/outbound-http/outboundHttp.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outboundHttp.spec.js","sourceRoot":"","sources":["../../src/outbound-http/outboundHttp.spec.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squiz/dx-common-lib",
-  "version": "1.72.3",
+  "version": "1.72.4",
   "description": "",
   "main": "lib/index.js",
   "private": false,
@@ -16,7 +16,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@aws-sdk/client-secrets-manager": "^3.946.0",
+    "@aws-sdk/client-secrets-manager": "^3.1057.0",
     "@squiz/dx-logger-lib": "^1.65.1",
     "archiver": "7.0.1",
     "escape-string-regexp": "4.0.0",

package/src/index.ts

@@ -21,3 +21,4 @@ export * from './secret-api-key-service/getSecretApiKeyService';
 export * from './events/EventBusService';
 export * from './stream/EventStreamHandler';
 export * from './stream/StreamUtils';
+export * from './outbound-http';

package/src/outbound-http/createServiceUserAgent.spec.ts

@@ -0,0 +1,11 @@
+import { createServiceUserAgent } from './createServiceUserAgent';
+
+describe('createServiceUserAgent', () => {
+  it('returns Squiz/<name> for a scoped package name', () => {
+    expect(createServiceUserAgent('@squiz/content-api')).toBe('Squiz/content-api');
+  });
+
+  it('returns Squiz/<name> for an unscoped service name', () => {
+    expect(createServiceUserAgent('content-api')).toBe('Squiz/content-api');
+  });
+});

package/src/outbound-http/createServiceUserAgent.ts

@@ -0,0 +1,9 @@
+/**
+ * Builds a User-Agent string for outbound service-to-service HTTP requests.
+ *
+ * @param serviceName Service identifier, e.g. `content-api` or `@squiz/content-api`
+ */
+export function createServiceUserAgent(serviceName: string): string {
+  const name = serviceName.replace(/^@squiz\//, '');
+  return `Squiz/${name}`;
+}

package/src/outbound-http/index.ts

@@ -0,0 +1,2 @@
+export { createServiceUserAgent } from './createServiceUserAgent';
+export { outboundFetch, type OutboundFetchInput } from './outboundHttp';

package/src/outbound-http/outboundHttp.spec.ts

@@ -0,0 +1,69 @@
+import { outboundFetch } from './outboundHttp';
+
+describe('outboundFetch', () => {
+  const userAgent = 'Squiz/test-service';
+  const originalFetch = global.fetch;
+
+  beforeEach(() => {
+    global.fetch = jest.fn().mockResolvedValue(new Response());
+  });
+
+  afterEach(() => {
+    global.fetch = originalFetch;
+  });
+
+  it('adds User-Agent to string URL requests with init headers', async () => {
+    await outboundFetch(userAgent, 'https://example.com/resource', {
+      headers: { 'x-api-key': 'secret' },
+    });
+
+    const init = (global.fetch as jest.Mock).mock.calls[0][1] as RequestInit;
+    const headers = init.headers as Headers;
+    expect(headers.get('x-api-key')).toBe('secret');
+    expect(headers.get('User-Agent')).toBe(userAgent);
+  });
+
+  it('preserves headers from a Request input and adds User-Agent', async () => {
+    const request = new Request('https://example.com/resource', {
+      method: 'GET',
+      headers: {
+        Authorization: 'Bearer token',
+        'x-dxp-tenant': 'tenant-1',
+      },
+    });
+
+    await outboundFetch(userAgent, request);
+
+    const init = (global.fetch as jest.Mock).mock.calls[0][1] as RequestInit;
+    const headers = init.headers as Headers;
+    expect(headers.get('Authorization')).toBe('Bearer token');
+    expect(headers.get('x-dxp-tenant')).toBe('tenant-1');
+    expect(headers.get('User-Agent')).toBe(userAgent);
+  });
+
+  it('merges init headers on top of Request headers without dropping existing values', async () => {
+    const request = new Request('https://example.com/resource', {
+      headers: { 'x-api-key': 'from-request' },
+    });
+
+    await outboundFetch(userAgent, request, {
+      headers: { 'x-dxp-session': 'session-token' },
+    });
+
+    const init = (global.fetch as jest.Mock).mock.calls[0][1] as RequestInit;
+    const headers = init.headers as Headers;
+    expect(headers.get('x-api-key')).toBe('from-request');
+    expect(headers.get('x-dxp-session')).toBe('session-token');
+    expect(headers.get('User-Agent')).toBe(userAgent);
+  });
+
+  it('Overrides an explicit User-Agent header', async () => {
+    await outboundFetch(userAgent, 'https://example.com/resource', {
+      headers: { 'User-Agent': 'custom-agent' },
+    });
+
+    const init = (global.fetch as jest.Mock).mock.calls[0][1] as RequestInit;
+    const headers = init.headers as Headers;
+    expect(headers.get('User-Agent')).toBe(userAgent);
+  });
+});

package/src/outbound-http/outboundHttp.ts

@@ -0,0 +1,26 @@
+export type OutboundFetchInput = string | URL | Request;
+
+function buildOutboundHeaders(userAgent: string, input: OutboundFetchInput, init?: RequestInit): Headers {
+  const headers = new Headers();
+
+  if (input instanceof Request) {
+    input.headers.forEach((value, key) => {
+      headers.set(key, value);
+    });
+  }
+
+  if (init?.headers) {
+    new Headers(init.headers).forEach((value, key) => {
+      headers.set(key, value);
+    });
+  }
+
+  headers.set('User-Agent', userAgent);
+
+  return headers;
+}
+
+export function outboundFetch(userAgent: string, input: OutboundFetchInput, init?: RequestInit): Promise<Response> {
+  const headers = buildOutboundHeaders(userAgent, input, init);
+  return fetch(input, { ...init, headers });
+}