fix(HttpAddress): Add path to HttpAddress

Author: nokome

src/base/Transports.test.ts

@@ -1,32 +1,56 @@
-import { TcpAddress } from './Transports'
+import { TcpAddress, HttpAddress } from './Transports'
 
-describe('tcpAddress', () => {
+describe('TcpAddress', () => {
   const defaults = {
     host: '127.0.0.1',
     port: 4321
   }
 
-  test('parses a string with host and port', () => {
+  test('constructor: string with host and port', () => {
     expect(new TcpAddress('example.com:2010', defaults)).toEqual({
       type: 'tcp',
       host: 'example.com',
       port: 2010
     })
   })
 
-  test('parses a number as the port', () => {
+  test('constructor: number as the port', () => {
     expect(new TcpAddress(2020, defaults)).toEqual({
       type: 'tcp',
       host: '127.0.0.1',
       port: 2020
     })
   })
 
-  test('parses a string with just port', () => {
+  test('constructor: string with just port', () => {
     expect(new TcpAddress('2030', defaults)).toEqual({
       type: 'tcp',
       host: '127.0.0.1',
       port: 2030
     })
   })
+
+  test('toString', () => {
+    expect(new TcpAddress().toString()).toEqual('tcp://127.0.0.1:2000')
+  })
+})
+
+describe('HttpAddress', () => {
+  test('constructor: string with host and port', () => {
+    expect(new HttpAddress()).toEqual({
+      type: 'http',
+      host: '127.0.0.1',
+      port: 8000,
+      path: '',
+      jwt: undefined
+    })
+  })
+
+  test('toString', () => {
+    expect(new HttpAddress().toString()).toEqual('http://127.0.0.1:8000')
+
+    expect(new HttpAddress(undefined, '/some/path').toString()).toEqual(
+      'http://127.0.0.1:8000/some/path'
+    )
+  })
 })

src/base/Transports.ts

@@ -39,7 +39,7 @@ export class UdsAddress {
 }
 
 /**
- * An address int the Linux VSOCK address family
+ * An address in the Linux VSOCK address family
  *
  * @see http://man7.org/linux/man-pages/man7/vsock.7.html
  */
@@ -123,18 +123,43 @@ export class TcpAddress {
   }
 }
 
+/**
+ * An address in the HTTP address family
+ *
+ * @see https://www.w3.org/Addressing/HTTPAddressing.html
+ */
 export class HttpAddress extends TcpAddress {
   public readonly type: Transport.http | Transport.ws = Transport.http
 
+  /**
+   * The path for the address.
+   *
+   * Should begin with a forward slash e.g. `/some/route`
+   */
+  public readonly path: string
+
+  /**
+   * The JSON Web Token (JWT) to use add to requests
+   * to this address.
+   */
   public readonly jwt?: string
 
-  public constructor(address?: TcpAddressInitializer, jwt?: string) {
+  public constructor(
+    address?: TcpAddressInitializer,
+    path: string = '',
+    jwt?: string
+  ) {
     super(address, {
       host: '127.0.0.1',
       port: 8000
     })
+    this.path = path
     this.jwt = jwt
   }
+
+  public toString(): string {
+    return `${super.toString()}${this.path}`
+  }
 }
 
 export class WebSocketAddress extends HttpAddress {

src/http/HttpServer.ts

@@ -100,6 +100,7 @@ export default class HttpServer extends TcpServer {
         host: this.host,
         port: this.port
       },
+      '',
       this.defaultJwt
     )
   }