@libp2p/interface-compliance-tests 3.0.7-d853d124 → 3.0.7-e9cafd3d

package/dist/src/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,gBAAgB,CAAA;AACjC,OAAO,MAAM,MAAM,kBAAkB,CAAA;AACrC,OAAO,MAAM,MAAM,kBAAkB,CAAA;AAgBrC,eAAe,CAAC,MAAwC,EAAQ,EAAE;IAChE,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,IAAI,CAAC,MAAM,CAAC,CAAA;QACZ,MAAM,CAAC,MAAM,CAAC,CAAA;QACd,MAAM,CAAC,MAAM,CAAC,CAAA;IAChB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/src/transport/listen-test.d.ts

@@ -0,0 +1,5 @@
+import type { TransportTestFixtures } from './index.js';
+import type { TestSetup } from '../index.js';
+declare const _default: (common: TestSetup<TransportTestFixtures>) => void;
+export default _default;
+//# sourceMappingURL=listen-test.d.ts.map

package/dist/src/transport/listen-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listen-test.d.ts","sourceRoot":"","sources":["../../../src/transport/listen-test.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;iCAMpB,UAAU,qBAAqB,CAAC,KAAG,IAAI;AAA/D,wBA4KC"}

package/dist/src/transport/listen-test.js

@@ -0,0 +1,152 @@
+/* eslint max-nested-callbacks: ["error", 8] */
+import { CustomEvent, EventEmitter } from '@libp2p/interface/events';
+import { expect } from 'aegir/chai';
+import drain from 'it-drain';
+import { pipe } from 'it-pipe';
+import defer from 'p-defer';
+import pWaitFor from 'p-wait-for';
+import sinon from 'sinon';
+import { fromString as uint8ArrayFromString } from 'uint8arrays/from-string';
+import { isValidTick } from '../is-valid-tick.js';
+import { mockUpgrader, mockRegistrar } from '../mocks/index.js';
+export default (common) => {
+    describe('listen', () => {
+        let upgrader;
+        let addrs;
+        let transport;
+        let registrar;
+        before(async () => {
+            registrar = mockRegistrar();
+            upgrader = mockUpgrader({
+                registrar,
+                events: new EventEmitter()
+            });
+            ({ transport, addrs } = await common.setup());
+        });
+        after(async () => {
+            await common.teardown();
+        });
+        afterEach(() => {
+            sinon.restore();
+        });
+        it('simple', async () => {
+            const listener = transport.createListener({
+                upgrader
+            });
+            await listener.listen(addrs[0]);
+            await listener.close();
+        });
+        it('close listener with connections, through timeout', async () => {
+            const upgradeSpy = sinon.spy(upgrader, 'upgradeInbound');
+            const listenerConns = [];
+            const protocol = '/test/protocol';
+            void registrar.handle(protocol, (data) => {
+                void drain(data.stream.source);
+            });
+            const listener = transport.createListener({
+                upgrader,
+                handler: (conn) => {
+                    listenerConns.push(conn);
+                }
+            });
+            // Listen
+            await listener.listen(addrs[0]);
+            // Create two connections to the listener
+            const [conn1] = await Promise.all([
+                transport.dial(addrs[0], {
+                    upgrader
+                }),
+                transport.dial(addrs[0], {
+                    upgrader
+                })
+            ]);
+            // Give the listener a chance to finish its upgrade
+            await pWaitFor(() => listenerConns.length === 2);
+            const stream1 = await conn1.newStream([protocol]);
+            // Wait for the data send and close to finish
+            await Promise.all([
+                pipe([uint8ArrayFromString('Some data that is never handled')], stream1),
+                // Closer the listener (will take a couple of seconds to time out)
+                listener.close()
+            ]);
+            stream1.close();
+            await conn1.close();
+            expect(isValidTick(conn1.timeline.close)).to.equal(true);
+            listenerConns.forEach(conn => {
+                expect(isValidTick(conn.timeline.close)).to.equal(true);
+            });
+            // 2 dials = 2 connections upgraded
+            expect(upgradeSpy.callCount).to.equal(2);
+        });
+        it('should not handle connection if upgradeInbound throws', async () => {
+            sinon.stub(upgrader, 'upgradeInbound').throws();
+            const listener = transport.createListener({
+                upgrader
+            });
+            // Listen
+            await listener.listen(addrs[0]);
+            // Create a connection to the listener
+            const conn = await transport.dial(addrs[0], {
+                upgrader
+            });
+            await pWaitFor(() => typeof conn.timeline.close === 'number');
+            await listener.close();
+        });
+        describe('events', () => {
+            it('connection', async () => {
+                const upgradeSpy = sinon.spy(upgrader, 'upgradeInbound');
+                const listener = transport.createListener({
+                    upgrader
+                });
+                const deferred = defer();
+                let conn;
+                listener.addEventListener('connection', (evt) => {
+                    conn = evt.detail;
+                    deferred.resolve();
+                });
+                void (async () => {
+                    await listener.listen(addrs[0]);
+                    await transport.dial(addrs[0], {
+                        upgrader
+                    });
+                })();
+                await deferred.promise;
+                await expect(upgradeSpy.getCall(0).returnValue).to.eventually.equal(conn);
+                expect(upgradeSpy.callCount).to.equal(1);
+                await listener.close();
+            });
+            it('listening', (done) => {
+                const listener = transport.createListener({
+                    upgrader
+                });
+                listener.addEventListener('listening', () => {
+                    listener.close().then(done, done);
+                });
+                void listener.listen(addrs[0]);
+            });
+            it('error', (done) => {
+                const listener = transport.createListener({
+                    upgrader
+                });
+                listener.addEventListener('error', (evt) => {
+                    expect(evt.detail).to.be.an.instanceOf(Error);
+                    listener.close().then(done, done);
+                });
+                listener.dispatchEvent(new CustomEvent('error', {
+                    detail: new Error('my err')
+                }));
+            });
+            it('close', (done) => {
+                const listener = transport.createListener({
+                    upgrader
+                });
+                listener.addEventListener('close', () => { done(); });
+                void (async () => {
+                    await listener.listen(addrs[0]);
+                    await listener.close();
+                })();
+            });
+        });
+    });
+};
+//# sourceMappingURL=listen-test.js.map

package/dist/src/transport/listen-test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libp2p/interface-compliance-tests",
-  "version": "3.0.7-d853d124",
+  "version": "3.0.7-e9cafd3d",
   "description": "Compliance tests for JS libp2p interfaces",
   "license": "Apache-2.0 OR MIT",
   "homepage": "https://github.com/libp2p/js-libp2p/tree/master/packages/interface-compliance-tests#readme",
@@ -44,13 +44,41 @@
       "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js"
     },
+    "./connection": {
+      "types": "./dist/src/connection/index.d.ts",
+      "import": "./dist/src/connection/index.js"
+    },
+    "./connection-encryption": {
+      "types": "./dist/src/connection-encryption/index.d.ts",
+      "import": "./dist/src/connection-encryption/index.js"
+    },
     "./is-valid-tick": {
       "types": "./dist/src/is-valid-tick.d.ts",
       "import": "./dist/src/is-valid-tick.js"
     },
+    "./mocks": {
+      "types": "./dist/src/mocks/index.d.ts",
+      "import": "./dist/src/mocks/index.js"
+    },
+    "./peer-discovery": {
+      "types": "./dist/src/peer-discovery/index.d.ts",
+      "import": "./dist/src/peer-discovery/index.js"
+    },
     "./peers": {
       "types": "./dist/src/peers.d.ts",
       "import": "./dist/src/peers.js"
+    },
+    "./pubsub": {
+      "types": "./dist/src/pubsub/index.d.ts",
+      "import": "./dist/src/pubsub/index.js"
+    },
+    "./stream-muxer": {
+      "types": "./dist/src/stream-muxer/index.d.ts",
+      "import": "./dist/src/stream-muxer/index.js"
+    },
+    "./transport": {
+      "types": "./dist/src/transport/index.d.ts",
+      "import": "./dist/src/transport/index.js"
     }
   },
   "eslintConfig": {
@@ -63,10 +91,48 @@
     "clean": "aegir clean",
     "lint": "aegir lint",
     "dep-check": "aegir dep-check",
-    "build": "aegir build"
+    "build": "aegir build",
+    "test": "aegir test",
+    "test:chrome": "aegir test -t browser --cov",
+    "test:chrome-webworker": "aegir test -t webworker",
+    "test:firefox": "aegir test -t browser -- --browser firefox",
+    "test:firefox-webworker": "aegir test -t webworker -- --browser firefox",
+    "test:node": "aegir test -t node --cov",
+    "test:electron-main": "aegir test -t electron-main"
   },
   "dependencies": {
-    "aegir": "^39.0.5"
+    "@libp2p/interface": "0.0.1-e9cafd3d",
+    "@libp2p/interface-internal": "0.0.1-e9cafd3d",
+    "@libp2p/logger": "2.1.1-e9cafd3d",
+    "@libp2p/multistream-select": "3.1.9-e9cafd3d",
+    "@libp2p/peer-collections": "3.0.2-e9cafd3d",
+    "@libp2p/peer-id": "2.0.3-e9cafd3d",
+    "@libp2p/peer-id-factory": "2.0.3-e9cafd3d",
+    "@multiformats/multiaddr": "^12.1.3",
+    "abortable-iterator": "^5.0.1",
+    "any-signal": "^4.1.1",
+    "delay": "^6.0.0",
+    "it-all": "^3.0.2",
+    "it-drain": "^3.0.2",
+    "it-handshake": "^4.1.3",
+    "it-map": "^3.0.3",
+    "it-ndjson": "^1.0.3",
+    "it-pair": "^2.0.6",
+    "it-pipe": "^3.0.1",
+    "it-pushable": "^3.1.3",
+    "it-stream-types": "^2.0.1",
+    "merge-options": "^3.0.4",
+    "p-defer": "^4.0.0",
+    "p-event": "^6.0.0",
+    "p-limit": "^4.0.0",
+    "p-wait-for": "^5.0.2",
+    "sinon": "^15.1.2",
+    "ts-sinon": "^2.0.2",
+    "uint8arraylist": "^2.4.3",
+    "uint8arrays": "^4.0.4"
+  },
+  "devDependencies": {
+    "aegir": "^39.0.13"
   },
   "typedoc": {
     "entryPoint": "./src/index.ts"

package/src/connection/index.ts

@@ -0,0 +1,182 @@
+import { expect } from 'aegir/chai'
+import sinon from 'sinon'
+import { stubInterface } from 'ts-sinon'
+import type { TestSetup } from '../index.js'
+import type { Connection, Stream } from '@libp2p/interface/connection'
+
+export default (test: TestSetup<Connection>): void => {
+  describe('connection', () => {
+    describe('open connection', () => {
+      let connection: Connection
+
+      beforeEach(async () => {
+        connection = await test.setup()
+      })
+
+      afterEach(async () => {
+        await connection.close()
+        await test.teardown()
+      })
+
+      it('should have properties set', () => {
+        expect(connection.id).to.exist()
+        expect(connection.remotePeer).to.exist()
+        expect(connection.remoteAddr).to.exist()
+        expect(connection.status).to.equal('OPEN')
+        expect(connection.timeline.open).to.exist()
+        expect(connection.timeline.close).to.not.exist()
+        expect(connection.direction).to.exist()
+        expect(connection.streams).to.eql([])
+        expect(connection.tags).to.eql([])
+      })
+
+      it('should get the metadata of an open connection', () => {
+        expect(connection.status).to.equal('OPEN')
+        expect(connection.direction).to.exist()
+        expect(connection.timeline.open).to.exist()
+        expect(connection.timeline.close).to.not.exist()
+      })
+
+      it('should return an empty array of streams', () => {
+        const streams = connection.streams
+
+        expect(streams).to.eql([])
+      })
+
+      it('should be able to create a new stream', async () => {
+        expect(connection.streams).to.be.empty()
+
+        const protocolToUse = '/echo/0.0.1'
+        const stream = await connection.newStream([protocolToUse])
+
+        expect(stream).to.have.property('protocol', protocolToUse)
+
+        const connStreams = connection.streams
+
+        expect(stream).to.exist()
+        expect(connStreams).to.exist()
+        expect(connStreams).to.have.lengthOf(1)
+        expect(connStreams[0]).to.equal(stream)
+      })
+    })
+
+    describe('close connection', () => {
+      let connection: Connection
+      let timelineProxy
+      const proxyHandler = {
+        set () {
+          // @ts-expect-error - TS fails to infer here
+          return Reflect.set(...arguments)
+        }
+      }
+
+      beforeEach(async () => {
+        timelineProxy = new Proxy({
+          open: Date.now() - 10,
+          upgraded: Date.now()
+        }, proxyHandler)
+
+        connection = await test.setup()
+        connection.timeline = timelineProxy
+      })
+
+      afterEach(async () => {
+        await test.teardown()
+      })
+
+      it('should be able to close the connection after being created', async () => {
+        expect(connection.timeline.close).to.not.exist()
+        await connection.close()
+
+        expect(connection.timeline.close).to.exist()
+        expect(connection.status).to.equal('CLOSED')
+      })
+
+      it('should be able to close the connection after opening a stream', async () => {
+        // Open stream
+        const protocol = '/echo/0.0.1'
+        await connection.newStream([protocol])
+
+        // Close connection
+        expect(connection.timeline.close).to.not.exist()
+        await connection.close()
+
+        expect(connection.timeline.close).to.exist()
+        expect(connection.status).to.equal('CLOSED')
+      })
+
+      it('should properly track streams', async () => {
+        // Open stream
+        const protocol = '/echo/0.0.1'
+        const stream = await connection.newStream([protocol])
+        expect(stream).to.have.property('protocol', protocol)
+
+        // Close stream
+        stream.close()
+
+        expect(connection.streams.filter(s => s.id === stream.id)).to.be.empty()
+      })
+
+      it('should track outbound streams', async () => {
+        // Open stream
+        const protocol = '/echo/0.0.1'
+        const stream = await connection.newStream(protocol)
+        expect(stream).to.have.property('direction', 'outbound')
+      })
+
+      it.skip('should track inbound streams', async () => {
+        // Add an remotely opened stream
+        const stream = stubInterface<Stream>()
+        connection.addStream(stream)
+        expect(stream).to.have.property('direction', 'inbound')
+      })
+
+      it('should support a proxy on the timeline', async () => {
+        sinon.spy(proxyHandler, 'set')
+        expect(connection.timeline.close).to.not.exist()
+
+        await connection.close()
+        // @ts-expect-error - fails to infer callCount
+        expect(proxyHandler.set.callCount).to.equal(1)
+        // @ts-expect-error - fails to infer getCall
+        const [obj, key, value] = proxyHandler.set.getCall(0).args
+        expect(obj).to.eql(connection.timeline)
+        expect(key).to.equal('close')
+        expect(value).to.be.a('number').that.equals(connection.timeline.close)
+      })
+
+      it('should fail to create a new stream if the connection is closing', async () => {
+        expect(connection.timeline.close).to.not.exist()
+        const p = connection.close()
+
+        try {
+          const protocol = '/echo/0.0.1'
+          await connection.newStream([protocol])
+        } catch (err: any) {
+          expect(err).to.exist()
+          return
+        } finally {
+          await p
+        }
+
+        throw new Error('should fail to create a new stream if the connection is closing')
+      })
+
+      it('should fail to create a new stream if the connection is closed', async () => {
+        expect(connection.timeline.close).to.not.exist()
+        await connection.close()
+
+        try {
+          const protocol = '/echo/0.0.1'
+          await connection.newStream([protocol])
+        } catch (err: any) {
+          expect(err).to.exist()
+          expect(err.code).to.equal('ERR_CONNECTION_CLOSED')
+          return
+        }
+
+        throw new Error('should fail to create a new stream if the connection is closing')
+      })
+    })
+  })
+}

package/src/connection-encryption/index.ts

@@ -0,0 +1,97 @@
+import { UnexpectedPeerError } from '@libp2p/interface/errors'
+import * as PeerIdFactory from '@libp2p/peer-id-factory'
+import { expect } from 'aegir/chai'
+import all from 'it-all'
+import { pipe } from 'it-pipe'
+import { fromString as uint8ArrayFromString } from 'uint8arrays/from-string'
+import peers from '../peers.js'
+import { createMaConnPair } from './utils/index.js'
+import type { TestSetup } from '../index.js'
+import type { ConnectionEncrypter } from '@libp2p/interface/connection-encrypter'
+import type { PeerId } from '@libp2p/interface/peer-id'
+
+export default (common: TestSetup<ConnectionEncrypter>): void => {
+  describe('interface-connection-encrypter compliance tests', () => {
+    let crypto: ConnectionEncrypter
+    let localPeer: PeerId
+    let remotePeer: PeerId
+    let mitmPeer: PeerId
+
+    before(async () => {
+      [
+        crypto,
+        localPeer,
+        remotePeer,
+        mitmPeer
+      ] = await Promise.all([
+        common.setup(),
+        PeerIdFactory.createFromJSON(peers[0]),
+        PeerIdFactory.createFromJSON(peers[1]),
+        PeerIdFactory.createFromJSON(peers[2])
+      ])
+    })
+
+    after(async () => {
+      await common.teardown()
+    })
+
+    it('has a protocol string', () => {
+      expect(crypto.protocol).to.exist()
+      expect(crypto.protocol).to.be.a('string')
+    })
+
+    it('it wraps the provided duplex connection', async () => {
+      const [localConn, remoteConn] = createMaConnPair()
+
+      const [
+        inboundResult,
+        outboundResult
+      ] = await Promise.all([
+        crypto.secureInbound(remotePeer, localConn),
+        crypto.secureOutbound(localPeer, remoteConn, remotePeer)
+      ])
+
+      // Echo server
+      void pipe(inboundResult.conn, inboundResult.conn)
+
+      // Send some data and collect the result
+      const input = uint8ArrayFromString('data to encrypt')
+      const result = await pipe(
+        [input],
+        outboundResult.conn,
+        async (source) => all(source)
+      )
+
+      expect(result).to.eql([input])
+    })
+
+    it('should return the remote peer id', async () => {
+      const [localConn, remoteConn] = createMaConnPair()
+
+      const [
+        inboundResult,
+        outboundResult
+      ] = await Promise.all([
+        crypto.secureInbound(remotePeer, localConn),
+        crypto.secureOutbound(localPeer, remoteConn, remotePeer)
+      ])
+
+      // Inbound should return the initiator (local) peer
+      expect(inboundResult.remotePeer.toBytes()).to.equalBytes(localPeer.toBytes())
+      // Outbound should return the receiver (remote) peer
+      expect(outboundResult.remotePeer.toBytes()).to.equalBytes(remotePeer.toBytes())
+    })
+
+    it('inbound connections should verify peer integrity if known', async () => {
+      const [localConn, remoteConn] = createMaConnPair()
+
+      await Promise.all([
+        crypto.secureInbound(remotePeer, localConn, mitmPeer),
+        crypto.secureOutbound(localPeer, remoteConn, remotePeer)
+      ]).then(() => expect.fail(), (err) => {
+        expect(err).to.exist()
+        expect(err).to.have.property('code', UnexpectedPeerError.code)
+      })
+    })
+  })
+}

package/src/connection-encryption/utils/index.ts

@@ -0,0 +1,23 @@
+import { multiaddr } from '@multiformats/multiaddr'
+import { duplexPair } from 'it-pair/duplex'
+import type { MultiaddrConnection } from '@libp2p/interface/connection'
+import type { Duplex, Source } from 'it-stream-types'
+
+export function createMaConnPair (): [MultiaddrConnection, MultiaddrConnection] {
+  const [local, remote] = duplexPair<Uint8Array>()
+
+  function duplexToMaConn (duplex: Duplex<AsyncGenerator<Uint8Array>, Source<Uint8Array>, Promise<void>>): MultiaddrConnection {
+    const output: MultiaddrConnection = {
+      ...duplex,
+      close: async () => {},
+      remoteAddr: multiaddr('/ip4/127.0.0.1/tcp/4001'),
+      timeline: {
+        open: Date.now()
+      }
+    }
+
+    return output
+  }
+
+  return [duplexToMaConn(local), duplexToMaConn(remote)]
+}