feat: add support for http-path (#380)

See definition in: multiformats/multiaddr#164

Author: MarcoPolo

src/convert.ts

@@ -70,6 +70,8 @@ export function convertToString (proto: number | string, buf: Uint8Array): strin
       return bytes2onion(buf)
     case 466: // certhash
       return bytes2mb(buf)
+    case 481: // http-path
+      return globalThis.encodeURIComponent(bytes2str(buf))
     default:
       return uint8ArrayToString(buf, 'base16') // no clue. convert to hex
   }
@@ -108,6 +110,8 @@ export function convertToBytes (proto: string | number, str: string): Uint8Array
       return onion32bytes(str)
     case 466: // certhash
       return mb2bytes(str)
+    case 481: // http-path
+      return str2bytes(globalThis.decodeURIComponent(str))
     default:
       return uint8ArrayFromString(str, 'base16') // no clue. convert from hex
   }

src/protocols-table.ts

@@ -46,6 +46,7 @@ export const table: Array<[number, number, string, boolean?, boolean?]> = [
   [478, 0, 'wss'],
   [479, 0, 'p2p-websocket-star'],
   [480, 0, 'http'],
+  [481, V, 'http-path'],
   [777, V, 'memory']
 ]
 

test/index.spec.ts

@@ -438,6 +438,17 @@ describe('variants', () => {
     expect(addr.toString()).to.equal(str)
   })
 
+  it('http-path', () => {
+    const str = '/ip4/127.0.0.1/tcp/9090/tls/http-path/tmp%2Ffoo%2F..%2Fbar'
+    const addr = multiaddr(str)
+    expect(addr).to.have.property('bytes')
+    const parts = addr.tuples()
+    const lastPart = parts[parts.length - 1]
+    const httpPath = new TextDecoder().decode(lastPart[1]?.subarray(1)) // skip the first byte since it's the length prefix
+    expect(httpPath).to.equal('tmp/foo/../bar')
+    expect(addr.toString()).to.equal(str)
+  })
+
   it('onion', () => {
     const str = '/onion/timaq4ygg2iegci7:1234'
     const addr = multiaddr(str)