@libp2p/interface 1.1.3 → 1.1.4

package/README.md

@@ -1,3 +1,5 @@
+# @libp2p/interface
+
 [![libp2p.io](https://img.shields.io/badge/project-libp2p-yellow.svg?style=flat-square)](http://libp2p.io/)
 [![Discuss](https://img.shields.io/discourse/https/discuss.libp2p.io/posts.svg?style=flat-square)](https://discuss.libp2p.io)
 [![codecov](https://img.shields.io/codecov/c/github/libp2p/js-libp2p.svg?style=flat-square)](https://codecov.io/gh/libp2p/js-libp2p)
@@ -7,6 +9,21 @@
 
 # About
 
+<!--
+
+!IMPORTANT!
+
+Everything in this README between "# About" and "# Install" is automatically
+generated and will be overwritten the next time the doc generator is run.
+
+To make changes to this section, please update the @packageDocumentation section
+of src/index.js or src/index.ts
+
+To experiment with formatting, please run "npm run docs" from the root of this
+repo and examine the changes made.
+
+-->
+
 Exports a `Libp2p` type for modules to use as a type argument.
 
 ## Example
@@ -25,14 +42,6 @@ function doSomethingWithLibp2p (node: Libp2p) {
 $ npm i @libp2p/interface
 ```
 
-## Browser `<script>` tag
-
-Loading this module through a script tag will make it's exports available as `Libp2pInterface` in the global namespace.
-
-```html
-<script src="https://unpkg.com/@libp2p/interface/dist/index.min.js"></script>
-```
-
 # API Docs
 
 - <https://libp2p.github.io/js-libp2p/modules/_libp2p_interface.html>

package/dist/index.min.js

@@ -1,3 +1,3 @@
 (function (root, factory) {(typeof module === 'object' && module.exports) ? module.exports = factory() : root.Libp2PInterface = factory()}(typeof self !== 'undefined' ? self : this, function () {
-"use strict";var Libp2PInterface=(()=>{var n=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var L=Object.prototype.hasOwnProperty;var g=(e,t)=>{for(var o in t)n(e,o,{get:t[o],enumerable:!0})},I=(e,t,o,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of _(t))!L.call(e,r)&&r!==o&&n(e,r,{get:()=>t[r],enumerable:!(s=y(t,r))||s.enumerable});return e};var N=e=>I(n({},"__esModule",{value:!0}),e);var q={};g(q,{AbortError:()=>i,AggregateCodeError:()=>l,CodeError:()=>a,CustomEvent:()=>b,ERR_INVALID_MESSAGE:()=>X,ERR_INVALID_PARAMETERS:()=>G,ERR_NOT_FOUND:()=>j,ERR_TIMEOUT:()=>F,Ed25519:()=>w,FaultTolerance:()=>p,InvalidCryptoExchangeError:()=>x,InvalidCryptoTransmissionError:()=>u,KEEP_ALIVE:()=>C,RSA:()=>P,StrictNoSign:()=>k,StrictSign:()=>U,TopicValidatorResult:()=>c,TypedEventEmitter:()=>m,UnexpectedPeerError:()=>f,connectionSymbol:()=>S,contentRoutingSymbol:()=>v,isConnection:()=>T,isPeerId:()=>M,isStartable:()=>E,isTransport:()=>B,peerDiscoverySymbol:()=>D,peerIdSymbol:()=>R,peerRoutingSymbol:()=>V,secp256k1:()=>O,setMaxListeners:()=>Y,start:()=>H,stop:()=>K,transportSymbol:()=>A});var S=Symbol.for("@libp2p/connection");function T(e){return e!=null&&!!e[S]}var v=Symbol.for("@libp2p/content-routing");var w="Ed25519",P="RSA",O="secp256k1";var D=Symbol.for("@libp2p/peer-discovery");var R=Symbol.for("@libp2p/peer-id");function M(e){return e!=null&&!!e[R]}var V=Symbol.for("@libp2p/peer-routing");var C="keep-alive";var U="StrictSign",k="StrictNoSign",c;(function(e){e.Accept="accept",e.Ignore="ignore",e.Reject="reject"})(c||(c={}));var A=Symbol.for("@libp2p/transport");function B(e){return e!=null&&!!e[A]}var p;(function(e){e[e.FATAL_ALL=0]="FATAL_ALL",e[e.NO_FATAL=1]="NO_FATAL"})(p||(p={}));var i=class e extends Error{code;type;constructor(t="The operation was aborted"){super(t),this.code=e.code,this.type=e.type}static code="ABORT_ERR";static type="aborted"},a=class extends Error{code;props;constructor(t,o,s){super(t),this.code=o,this.name=s?.name??"CodeError",this.props=s??{}}},l=class extends AggregateError{code;props;constructor(t,o,s,r){super(t,o),this.code=s,this.name=r?.name??"AggregateCodeError",this.props=r??{}}},f=class e extends Error{code;constructor(t="Unexpected Peer"){super(t),this.code=e.code}static code="ERR_UNEXPECTED_PEER"},x=class e extends Error{code;constructor(t="Invalid crypto exchange"){super(t),this.code=e.code}static code="ERR_INVALID_CRYPTO_EXCHANGE"},u=class e extends Error{code;constructor(t="Invalid crypto transmission"){super(t),this.code=e.code}static code="ERR_INVALID_CRYPTO_TRANSMISSION"},F="ERR_TIMEOUT",G="ERR_INVALID_PARAMETERS",j="ERR_NOT_FOUND",X="ERR_INVALID_MESSAGE";var m=class extends EventTarget{#t=new Map;listenerCount(t){let o=this.#t.get(t);return o==null?0:o.length}addEventListener(t,o,s){super.addEventListener(t,o,s);let r=this.#t.get(t);r==null&&(r=[],this.#t.set(t,r)),r.push({callback:o,once:(s!==!0&&s!==!1&&s?.once)??!1})}removeEventListener(t,o,s){super.removeEventListener(t.toString(),o??null,s);let r=this.#t.get(t);r!=null&&(r=r.filter(({callback:h})=>h!==o),this.#t.set(t,r))}dispatchEvent(t){let o=super.dispatchEvent(t),s=this.#t.get(t.type);return s==null||(s=s.filter(({once:r})=>!r),this.#t.set(t.type,s)),o}safeDispatchEvent(t,o={}){return this.dispatchEvent(new b(t,o))}},d=class extends Event{detail;constructor(t,o){super(t,o),this.detail=o?.detail}},b=globalThis.CustomEvent??d;var Y=(e,...t)=>{try{[...t]}catch{}};function E(e){return e!=null&&typeof e.start=="function"&&typeof e.stop=="function"}async function H(...e){let t=[];for(let o of e)E(o)&&t.push(o);await Promise.all(t.map(async o=>{o.beforeStart!=null&&await o.beforeStart()})),await Promise.all(t.map(async o=>{await o.start()})),await Promise.all(t.map(async o=>{o.afterStart!=null&&await o.afterStart()}))}async function K(...e){let t=[];for(let o of e)E(o)&&t.push(o);await Promise.all(t.map(async o=>{o.beforeStop!=null&&await o.beforeStop()})),await Promise.all(t.map(async o=>{await o.stop()})),await Promise.all(t.map(async o=>{o.afterStop!=null&&await o.afterStop()}))}return N(q);})();
+"use strict";var Libp2PInterface=(()=>{var n=Object.defineProperty;var L=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var I=(e,t)=>{for(var o in t)n(e,o,{get:t[o],enumerable:!0})},N=(e,t,o,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of _(t))!g.call(e,r)&&r!==o&&n(e,r,{get:()=>t[r],enumerable:!(s=L(t,r))||s.enumerable});return e};var T=e=>N(n({},"__esModule",{value:!0}),e);var q={};I(q,{AbortError:()=>i,AggregateCodeError:()=>l,CodeError:()=>a,CustomEvent:()=>b,ERR_INVALID_MESSAGE:()=>Y,ERR_INVALID_PARAMETERS:()=>j,ERR_NOT_FOUND:()=>X,ERR_TIMEOUT:()=>G,Ed25519:()=>P,FaultTolerance:()=>p,InvalidCryptoExchangeError:()=>x,InvalidCryptoTransmissionError:()=>u,KEEP_ALIVE:()=>U,RSA:()=>M,StrictNoSign:()=>B,StrictSign:()=>k,TopicValidatorResult:()=>c,TypedEventEmitter:()=>d,UnexpectedPeerError:()=>f,connectionSymbol:()=>R,contentRoutingSymbol:()=>w,isConnection:()=>v,isPeerId:()=>V,isStartable:()=>S,isTransport:()=>F,peerDiscoverySymbol:()=>D,peerIdSymbol:()=>h,peerRoutingSymbol:()=>C,secp256k1:()=>O,setMaxListeners:()=>m,start:()=>H,stop:()=>K,transportSymbol:()=>A});var R=Symbol.for("@libp2p/connection");function v(e){return e!=null&&!!e[R]}var w=Symbol.for("@libp2p/content-routing");var P="Ed25519",M="RSA",O="secp256k1";var D=Symbol.for("@libp2p/peer-discovery");var h=Symbol.for("@libp2p/peer-id");function V(e){return e!=null&&!!e[h]}var C=Symbol.for("@libp2p/peer-routing");var U="keep-alive";var k="StrictSign",B="StrictNoSign",c;(function(e){e.Accept="accept",e.Ignore="ignore",e.Reject="reject"})(c||(c={}));var A=Symbol.for("@libp2p/transport");function F(e){return e!=null&&!!e[A]}var p;(function(e){e[e.FATAL_ALL=0]="FATAL_ALL",e[e.NO_FATAL=1]="NO_FATAL"})(p||(p={}));var i=class e extends Error{code;type;constructor(t="The operation was aborted"){super(t),this.code=e.code,this.type=e.type}static code="ABORT_ERR";static type="aborted"},a=class extends Error{code;props;constructor(t,o,s){super(t),this.code=o,this.name=s?.name??"CodeError",this.props=s??{}}},l=class extends AggregateError{code;props;constructor(t,o,s,r){super(t,o),this.code=s,this.name=r?.name??"AggregateCodeError",this.props=r??{}}},f=class e extends Error{code;constructor(t="Unexpected Peer"){super(t),this.code=e.code}static code="ERR_UNEXPECTED_PEER"},x=class e extends Error{code;constructor(t="Invalid crypto exchange"){super(t),this.code=e.code}static code="ERR_INVALID_CRYPTO_EXCHANGE"},u=class e extends Error{code;constructor(t="Invalid crypto transmission"){super(t),this.code=e.code}static code="ERR_INVALID_CRYPTO_TRANSMISSION"},G="ERR_TIMEOUT",j="ERR_INVALID_PARAMETERS",X="ERR_NOT_FOUND",Y="ERR_INVALID_MESSAGE";var m=(e,...t)=>{try{[...t]}catch{}};var d=class extends EventTarget{#t=new Map;constructor(){super(),m(1/0,this)}listenerCount(t){let o=this.#t.get(t);return o==null?0:o.length}addEventListener(t,o,s){super.addEventListener(t,o,s);let r=this.#t.get(t);r==null&&(r=[],this.#t.set(t,r)),r.push({callback:o,once:(s!==!0&&s!==!1&&s?.once)??!1})}removeEventListener(t,o,s){super.removeEventListener(t.toString(),o??null,s);let r=this.#t.get(t);r!=null&&(r=r.filter(({callback:y})=>y!==o),this.#t.set(t,r))}dispatchEvent(t){let o=super.dispatchEvent(t),s=this.#t.get(t.type);return s==null||(s=s.filter(({once:r})=>!r),this.#t.set(t.type,s)),o}safeDispatchEvent(t,o={}){return this.dispatchEvent(new b(t,o))}},E=class extends Event{detail;constructor(t,o){super(t,o),this.detail=o?.detail}},b=globalThis.CustomEvent??E;function S(e){return e!=null&&typeof e.start=="function"&&typeof e.stop=="function"}async function H(...e){let t=[];for(let o of e)S(o)&&t.push(o);await Promise.all(t.map(async o=>{o.beforeStart!=null&&await o.beforeStart()})),await Promise.all(t.map(async o=>{await o.start()})),await Promise.all(t.map(async o=>{o.afterStart!=null&&await o.afterStart()}))}async function K(...e){let t=[];for(let o of e)S(o)&&t.push(o);await Promise.all(t.map(async o=>{o.beforeStop!=null&&await o.beforeStop()})),await Promise.all(t.map(async o=>{await o.stop()})),await Promise.all(t.map(async o=>{o.afterStop!=null&&await o.afterStop()}))}return T(q);})();
 return Libp2PInterface}));

package/dist/src/content-routing/index.d.ts

@@ -8,7 +8,7 @@ import type { CID } from 'multiformats/cid';
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * import { contentRoutingSymbol, ContentRouting } from '@libp2p/content-routing'
  *
  * class MyContentRouter implements ContentRouting {
@@ -35,7 +35,7 @@ export interface ContentRouting {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * // ...
      * await contentRouting.provide(cid)
      * ```
@@ -46,7 +46,7 @@ export interface ContentRouting {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * // Iterate over the providers found for the given cid
      * for await (const provider of contentRouting.findProviders(cid)) {
      *  console.log(provider.id, provider.multiaddrs)
@@ -60,7 +60,7 @@ export interface ContentRouting {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * // ...
      * const key = '/key'
      * const value = uint8ArrayFromString('oh hello there')
@@ -74,7 +74,7 @@ export interface ContentRouting {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * // ...
      *
      * const key = '/key'

package/dist/src/content-routing/index.js

@@ -5,7 +5,7 @@
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * import { contentRoutingSymbol, ContentRouting } from '@libp2p/content-routing'
  *
  * class MyContentRouter implements ContentRouting {

package/dist/src/event-target.d.ts

@@ -26,6 +26,7 @@ export interface TypedEventTarget<EventMap extends Record<string, any>> extends
  */
 export declare class TypedEventEmitter<EventMap extends Record<string, any>> extends EventTarget implements TypedEventTarget<EventMap> {
     #private;
+    constructor();
     listenerCount(type: string): number;
     addEventListener<K extends keyof EventMap>(type: K, listener: EventHandler<EventMap[K]> | null, options?: boolean | AddEventListenerOptions): void;
     removeEventListener<K extends keyof EventMap>(type: K, listener?: EventHandler<EventMap[K]> | null, options?: boolean | EventListenerOptions): void;

package/dist/src/event-target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-target.d.ts","sourceRoot":"","sources":["../../src/event-target.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa,CAAC,SAAS;IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE;AACpE,MAAM,WAAW,WAAW,CAAC,SAAS;IAAI,WAAW,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;CAAE;AACjF,MAAM,MAAM,YAAY,CAAC,SAAS,IAAI,aAAa,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,CAAA;AAOvF;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAE,SAAQ,WAAW;IAC1F,gBAAgB,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAAA;IAElJ,aAAa,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAEpC,mBAAmB,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAAA;IAEnJ,mBAAmB,CAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAAA;IAElH,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAA;CAC1F;AAED;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAE,SAAQ,WAAY,YAAW,gBAAgB,CAAC,QAAQ,CAAC;;IAG5H,aAAa,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAUpC,gBAAgB,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI;IAiBlJ,mBAAmB,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI;IAcnJ,aAAa,CAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IAerC,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,EAAE,MAAM,GAAE,eAAe,CAAC,MAAM,CAAM,GAAG,OAAO;CAG/F;AAoBD,eAAO,MAAM,WAAW;;;CAAgD,CAAA"}
+{"version":3,"file":"event-target.d.ts","sourceRoot":"","sources":["../../src/event-target.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa,CAAC,SAAS;IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE;AACpE,MAAM,WAAW,WAAW,CAAC,SAAS;IAAI,WAAW,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;CAAE;AACjF,MAAM,MAAM,YAAY,CAAC,SAAS,IAAI,aAAa,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,CAAA;AAOvF;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAE,SAAQ,WAAW;IAC1F,gBAAgB,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAAA;IAElJ,aAAa,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAEpC,mBAAmB,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAAA;IAEnJ,mBAAmB,CAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAAA;IAElH,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAA;CAC1F;AAED;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAE,SAAQ,WAAY,YAAW,gBAAgB,CAAC,QAAQ,CAAC;;;IAW5H,aAAa,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAUpC,gBAAgB,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI;IAiBlJ,mBAAmB,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI;IAcnJ,aAAa,CAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IAerC,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,EAAE,MAAM,GAAE,eAAe,CAAC,MAAM,CAAM,GAAG,OAAO;CAG/F;AAoBD,eAAO,MAAM,WAAW;;;CAAgD,CAAA"}

package/dist/src/event-target.js

@@ -1,9 +1,16 @@
+import { setMaxListeners } from './events.js';
 /**
  * An implementation of a typed event target
  * etc
  */
 export class TypedEventEmitter extends EventTarget {
     #listeners = new Map();
+    constructor() {
+        super();
+        // silence MaxListenersExceededWarning warning on Node.js, this is a red
+        // herring almost all of the time
+        setMaxListeners(Infinity, this);
+    }
     listenerCount(type) {
         const listeners = this.#listeners.get(type);
         if (listeners == null) {

package/dist/src/event-target.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-target.js","sourceRoot":"","sources":["../../src/event-target.ts"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,MAAM,OAAO,iBAAwD,SAAQ,WAAW;IACtF,UAAU,GAAG,IAAI,GAAG,EAAmB,CAAA;IAEvC,aAAa,CAAE,IAAY;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAE3C,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,CAAA;QACV,CAAC;QAED,OAAO,SAAS,CAAC,MAAM,CAAA;IACzB,CAAC;IAGD,gBAAgB,CAAE,IAAY,EAAE,QAA6B,EAAE,OAA2C;QACxG,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;QAE/C,IAAI,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAEpC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,IAAI,GAAG,EAAE,CAAA;YACT,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACjC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC;YACR,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK;SACxE,CAAC,CAAA;IACJ,CAAC;IAGD,mBAAmB,CAAE,IAAY,EAAE,QAA8B,EAAE,OAAwC;QACzG,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,IAAI,IAAI,EAAE,OAAO,CAAC,CAAA;QAErE,IAAI,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAEpC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,OAAM;QACR,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAA;QAC3D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,aAAa,CAAE,KAAY;QACzB,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAEzC,IAAI,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAE1C,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,OAAO,MAAM,CAAA;QACf,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAErC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,iBAAiB,CAAS,IAAoB,EAAE,SAAkC,EAAE;QAClF,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,WAAW,CAAS,IAAc,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5E,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,mBAA6B,SAAQ,KAAK;IAC9C,2FAA2F;IACpF,MAAM,CAAG;IAEhB,YAAa,OAAe,EAAE,IAAgC;QAC5D,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACpB,sCAAsC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,IAAI,mBAAmB,CAAA"}
+{"version":3,"file":"event-target.js","sourceRoot":"","sources":["../../src/event-target.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -120,7 +120,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * libp2p.addEventListener('peer:discovery', (event) => {
      *    const peerInfo = event.detail
      *    // ...
@@ -133,7 +133,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * libp2p.addEventListener('peer:connect', (event) => {
      *   const peerId = event.detail
      *   // ...
@@ -148,7 +148,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * libp2p.addEventListener('peer:disconnect', (event) => {
      *   const peerId = event.detail
      *   // ...
@@ -163,7 +163,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * libp2p.addEventListener('peer:identify', (event) => {
      *   const identifyResult = event.detail
      *   // ...
@@ -189,7 +189,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * libp2p.addEventListener('self:peer:update', (event) => {
      *   const { peer } = event.detail
      *   // ...
@@ -224,7 +224,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
     /**
      * This event notifies listeners that the node has started
      *
-     * ```js
+     * ```TypeScript
      * libp2p.addEventListener('start', (event) => {
      *   console.info(libp2p.isStarted()) // true
      * })
@@ -234,7 +234,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
     /**
      * This event notifies listeners that the node has stopped
      *
-     * ```js
+     * ```TypeScript
      * libp2p.addEventListener('stop', (event) => {
      *   console.info(libp2p.isStarted()) // false
      * })
@@ -248,7 +248,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * const node = await createLibp2p({
  *   // ...other options
  *   services: {
@@ -300,7 +300,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * console.info(libp2p.peerId)
      * // PeerId(12D3Foo...)
      * ````
@@ -312,7 +312,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const peer = await libp2p.peerStore.get(peerId)
      * console.info(peer)
      * // { id: PeerId(12D3Foo...), addresses: [] ... }
@@ -325,7 +325,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const peerInfo = await libp2p.peerRouting.findPeer(peerId)
      * console.info(peerInfo)
      * // { id: PeerId(12D3Foo...), multiaddrs: [] ... }
@@ -333,7 +333,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * for await (const peerInfo of libp2p.peerRouting.getClosestPeers(key)) {
      *   console.info(peerInfo)
      *   // { id: PeerId(12D3Foo...), multiaddrs: [] ... }
@@ -348,7 +348,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * for await (const peerInfo of libp2p.contentRouting.findProviders(cid)) {
      *   console.info(peerInfo)
      *   // { id: PeerId(12D3Foo...), multiaddrs: [] ... }
@@ -362,7 +362,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const metric = libp2p.metrics.registerMetric({
      *   'my-metric'
      * })
@@ -390,7 +390,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const listenMa = libp2p.getMultiaddrs()
      * // [ <Multiaddr 047f00000106f9ba - /ip4/127.0.0.1/tcp/63930> ]
      * ```
@@ -401,7 +401,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const protocols = libp2p.getProtocols()
      * // [ '/ipfs/ping/1.0.0', '/ipfs/id/1.0.0' ]
      * ```
@@ -413,7 +413,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * for (const connection of libp2p.getConnections()) {
      *   console.log(peerId, connection.remoteAddr.toString())
      *   // Logs the PeerId string and the observed remote multiaddr of each Connection
@@ -426,7 +426,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * for (const pendingDial of libp2p.getDialQueue()) {
      *   console.log(pendingDial)
      * }
@@ -445,7 +445,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const conn = await libp2p.dial(remotePeerId)
      *
      * // create a new stream within the connection
@@ -465,7 +465,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * import { pipe } from 'it-pipe'
      *
      * const { stream, protocol } = await libp2p.dialProtocol(remotePeerId, protocols)
@@ -484,7 +484,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * await libp2p.hangUp(remotePeerId)
      * ```
      */
@@ -498,7 +498,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const handler = ({ connection, stream, protocol }) => {
      *   // use stream or connection according to the needs
      * }
@@ -516,7 +516,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * libp2p.unhandle(['/echo/1.0.0'])
      * ```
      */
@@ -527,7 +527,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const id = await libp2p.register('/echo/1.0.0', {
      *   onConnect: (peer, connection) => {
      *     // handle connect
@@ -545,7 +545,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const id = await libp2p.register(...)
      *
      * libp2p.unregister(id)
@@ -582,7 +582,7 @@ export interface NodeInfo {
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * const controller = new AbortController()
  *
  * aLongRunningOperation({

package/dist/src/peer-discovery/index.d.ts

@@ -7,7 +7,7 @@ import type { PeerInfo } from '../peer-info/index.js';
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * import { peerDiscovery, PeerDiscovery } from '@libp2p/peer-discovery'
  *
  * class MyPeerDiscoverer implements PeerDiscovery {

package/dist/src/peer-discovery/index.js

@@ -5,7 +5,7 @@
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * import { peerDiscovery, PeerDiscovery } from '@libp2p/peer-discovery'
  *
  * class MyPeerDiscoverer implements PeerDiscovery {

package/dist/src/peer-routing/index.d.ts

@@ -8,7 +8,7 @@ import type { PeerInfo } from '../peer-info/index.js';
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * import { peerRouting, PeerRouting } from '@libp2p/peer-routing'
  *
  * class MyPeerRouter implements PeerRouting {
@@ -34,7 +34,7 @@ export interface PeerRouting {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * // ...
      * const peer = await peerRouting.findPeer(peerId, options)
      * ```
@@ -46,7 +46,7 @@ export interface PeerRouting {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * // Iterate over the closest peers found for the given key
      * for await (const peer of peerRouting.getClosestPeers(key)) {
      *   console.log(peer.id, peer.multiaddrs)

package/dist/src/peer-routing/index.js

@@ -5,7 +5,7 @@
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * import { peerRouting, PeerRouting } from '@libp2p/peer-routing'
  *
  * class MyPeerRouter implements PeerRouting {

package/dist/src/peer-store/index.d.ts

@@ -132,7 +132,7 @@ export interface PeerStore {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * await peerStore.forEach(peer => {
      *   // ...
      * })
@@ -144,7 +144,7 @@ export interface PeerStore {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * for (const peer of await peerStore.all()) {
      *   // ...
      * }
@@ -156,7 +156,7 @@ export interface PeerStore {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * await peerStore.addressBook.set(peerId, multiaddrs)
      * await peerStore.addressBook.get(peerId)
      * // multiaddrs[]
@@ -173,7 +173,7 @@ export interface PeerStore {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * await peerStore.has(peerId)
      * // false
      * await peerStore.addressBook.add(peerId, multiaddrs)
@@ -187,7 +187,7 @@ export interface PeerStore {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const peer = await peerStore.get(peerId)
      * // { .. }
      * ```
@@ -198,7 +198,7 @@ export interface PeerStore {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * await peerStore.save(peerId, {
      *   multiaddrs
      * })
@@ -210,7 +210,7 @@ export interface PeerStore {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * await peerStore.patch(peerId, {
      *   multiaddrs
      * })
@@ -222,7 +222,7 @@ export interface PeerStore {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * await peerStore.merge(peerId, {
      *   multiaddrs
      * })
@@ -238,7 +238,7 @@ export interface PeerStore {
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * await peerStore.consumePeerRecord(buf, expectedPeer)
      * ```
      */

package/dist/src/pubsub/index.d.ts

@@ -146,7 +146,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const topic = 'topic'
      * const validateMessage = (msgTopic, msg) => {
      *   const input = uint8ArrayToString(msg.data)
@@ -164,7 +164,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
     /**
      * Gets a list of topics the node is subscribed to.
      *
-     * ```js
+     * ```TypeScript
      * const topics = libp2p.pubsub.getTopics()
      * ```
      */
@@ -174,7 +174,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const topic = 'topic'
      * const handler = (msg) => {
      *   if (msg.topic === topic) {
@@ -192,7 +192,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const topic = 'topic'
      * const handler = (msg) => {
      *   // msg.data - pubsub data received
@@ -208,7 +208,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const peerIds = libp2p.pubsub.getSubscribers(topic)
      * ```
      */
@@ -218,7 +218,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
      *
      * @example
      *
-     * ```js
+     * ```TypeScript
      * const topic = 'topic'
      * const data = uint8ArrayFromString('data')
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libp2p/interface",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "The interface implemented by a libp2p node",
   "license": "Apache-2.0 OR MIT",
   "homepage": "https://github.com/libp2p/js-libp2p/tree/main/packages/interface#readme",
@@ -43,19 +43,20 @@
   "scripts": {
     "clean": "aegir clean",
     "lint": "aegir lint",
-    "dep-check": "aegir dep-check -i @libp2p/utils",
+    "dep-check": "aegir dep-check",
+    "doc-check": "aegir doc-check",
     "build": "aegir build"
   },
   "dependencies": {
     "@multiformats/multiaddr": "^12.1.14",
     "it-pushable": "^3.2.3",
     "it-stream-types": "^2.0.1",
-    "multiformats": "^13.0.1",
+    "multiformats": "^13.1.0",
     "progress-events": "^1.0.0",
     "uint8arraylist": "^2.4.8"
   },
   "devDependencies": {
-    "aegir": "^42.2.3"
+    "aegir": "^42.2.4"
   },
   "browser": {
     "events": "./dist/src/events.browser.js"

package/src/content-routing/index.ts

@@ -9,7 +9,7 @@ import type { CID } from 'multiformats/cid'
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * import { contentRoutingSymbol, ContentRouting } from '@libp2p/content-routing'
  *
  * class MyContentRouter implements ContentRouting {
@@ -38,7 +38,7 @@ export interface ContentRouting {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * // ...
    * await contentRouting.provide(cid)
    * ```
@@ -50,7 +50,7 @@ export interface ContentRouting {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * // Iterate over the providers found for the given cid
    * for await (const provider of contentRouting.findProviders(cid)) {
    *  console.log(provider.id, provider.multiaddrs)
@@ -65,7 +65,7 @@ export interface ContentRouting {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * // ...
    * const key = '/key'
    * const value = uint8ArrayFromString('oh hello there')
@@ -80,7 +80,7 @@ export interface ContentRouting {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * // ...
    *
    * const key = '/key'

package/src/event-target.ts

@@ -1,3 +1,5 @@
+import { setMaxListeners } from './events.js'
+
 export interface EventCallback<EventType> { (evt: EventType): void }
 export interface EventObject<EventType> { handleEvent: EventCallback<EventType> }
 export type EventHandler<EventType> = EventCallback<EventType> | EventObject<EventType>
@@ -34,6 +36,14 @@ export interface TypedEventTarget <EventMap extends Record<string, any>> extends
 export class TypedEventEmitter<EventMap extends Record<string, any>> extends EventTarget implements TypedEventTarget<EventMap> {
   #listeners = new Map<any, Listener[]>()
 
+  constructor () {
+    super()
+
+    // silence MaxListenersExceededWarning warning on Node.js, this is a red
+    // herring almost all of the time
+    setMaxListeners(Infinity, this)
+  }
+
   listenerCount (type: string): number {
     const listeners = this.#listeners.get(type)
 

package/src/index.ts

@@ -136,7 +136,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * libp2p.addEventListener('peer:discovery', (event) => {
    *    const peerInfo = event.detail
    *    // ...
@@ -150,7 +150,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * libp2p.addEventListener('peer:connect', (event) => {
    *   const peerId = event.detail
    *   // ...
@@ -166,7 +166,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * libp2p.addEventListener('peer:disconnect', (event) => {
    *   const peerId = event.detail
    *   // ...
@@ -182,7 +182,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * libp2p.addEventListener('peer:identify', (event) => {
    *   const identifyResult = event.detail
    *   // ...
@@ -210,7 +210,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * libp2p.addEventListener('self:peer:update', (event) => {
    *   const { peer } = event.detail
    *   // ...
@@ -251,7 +251,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
   /**
    * This event notifies listeners that the node has started
    *
-   * ```js
+   * ```TypeScript
    * libp2p.addEventListener('start', (event) => {
    *   console.info(libp2p.isStarted()) // true
    * })
@@ -262,7 +262,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
   /**
    * This event notifies listeners that the node has stopped
    *
-   * ```js
+   * ```TypeScript
    * libp2p.addEventListener('stop', (event) => {
    *   console.info(libp2p.isStarted()) // false
    * })
@@ -277,7 +277,7 @@ export interface Libp2pEvents<T extends ServiceMap = ServiceMap> {
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * const node = await createLibp2p({
  *   // ...other options
  *   services: {
@@ -336,7 +336,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * console.info(libp2p.peerId)
    * // PeerId(12D3Foo...)
    * ````
@@ -349,7 +349,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const peer = await libp2p.peerStore.get(peerId)
    * console.info(peer)
    * // { id: PeerId(12D3Foo...), addresses: [] ... }
@@ -363,7 +363,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const peerInfo = await libp2p.peerRouting.findPeer(peerId)
    * console.info(peerInfo)
    * // { id: PeerId(12D3Foo...), multiaddrs: [] ... }
@@ -371,7 +371,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * for await (const peerInfo of libp2p.peerRouting.getClosestPeers(key)) {
    *   console.info(peerInfo)
    *   // { id: PeerId(12D3Foo...), multiaddrs: [] ... }
@@ -387,7 +387,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * for await (const peerInfo of libp2p.contentRouting.findProviders(cid)) {
    *   console.info(peerInfo)
    *   // { id: PeerId(12D3Foo...), multiaddrs: [] ... }
@@ -402,7 +402,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const metric = libp2p.metrics.registerMetric({
    *   'my-metric'
    * })
@@ -433,7 +433,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const listenMa = libp2p.getMultiaddrs()
    * // [ <Multiaddr 047f00000106f9ba - /ip4/127.0.0.1/tcp/63930> ]
    * ```
@@ -445,7 +445,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const protocols = libp2p.getProtocols()
    * // [ '/ipfs/ping/1.0.0', '/ipfs/id/1.0.0' ]
    * ```
@@ -458,7 +458,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * for (const connection of libp2p.getConnections()) {
    *   console.log(peerId, connection.remoteAddr.toString())
    *   // Logs the PeerId string and the observed remote multiaddr of each Connection
@@ -472,7 +472,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * for (const pendingDial of libp2p.getDialQueue()) {
    *   console.log(pendingDial)
    * }
@@ -493,7 +493,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const conn = await libp2p.dial(remotePeerId)
    *
    * // create a new stream within the connection
@@ -514,7 +514,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * import { pipe } from 'it-pipe'
    *
    * const { stream, protocol } = await libp2p.dialProtocol(remotePeerId, protocols)
@@ -534,7 +534,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * await libp2p.hangUp(remotePeerId)
    * ```
    */
@@ -549,7 +549,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const handler = ({ connection, stream, protocol }) => {
    *   // use stream or connection according to the needs
    * }
@@ -568,7 +568,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * libp2p.unhandle(['/echo/1.0.0'])
    * ```
    */
@@ -580,7 +580,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const id = await libp2p.register('/echo/1.0.0', {
    *   onConnect: (peer, connection) => {
    *     // handle connect
@@ -599,7 +599,7 @@ export interface Libp2p<T extends ServiceMap = ServiceMap> extends Startable, Ty
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const id = await libp2p.register(...)
    *
    * libp2p.unregister(id)
@@ -641,7 +641,7 @@ export interface NodeInfo {
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * const controller = new AbortController()
  *
  * aLongRunningOperation({

package/src/peer-discovery/index.ts

@@ -8,7 +8,7 @@ import type { PeerInfo } from '../peer-info/index.js'
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * import { peerDiscovery, PeerDiscovery } from '@libp2p/peer-discovery'
  *
  * class MyPeerDiscoverer implements PeerDiscovery {

package/src/peer-routing/index.ts

@@ -9,7 +9,7 @@ import type { PeerInfo } from '../peer-info/index.js'
  *
  * @example
  *
- * ```js
+ * ```TypeScript
  * import { peerRouting, PeerRouting } from '@libp2p/peer-routing'
  *
  * class MyPeerRouter implements PeerRouting {
@@ -37,7 +37,7 @@ export interface PeerRouting {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * // ...
    * const peer = await peerRouting.findPeer(peerId, options)
    * ```
@@ -50,7 +50,7 @@ export interface PeerRouting {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * // Iterate over the closest peers found for the given key
    * for await (const peer of peerRouting.getClosestPeers(key)) {
    *   console.log(peer.id, peer.multiaddrs)

package/src/peer-store/index.ts

@@ -150,7 +150,7 @@ export interface PeerStore {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * await peerStore.forEach(peer => {
    *   // ...
    * })
@@ -163,7 +163,7 @@ export interface PeerStore {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * for (const peer of await peerStore.all()) {
    *   // ...
    * }
@@ -176,7 +176,7 @@ export interface PeerStore {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * await peerStore.addressBook.set(peerId, multiaddrs)
    * await peerStore.addressBook.get(peerId)
    * // multiaddrs[]
@@ -194,7 +194,7 @@ export interface PeerStore {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * await peerStore.has(peerId)
    * // false
    * await peerStore.addressBook.add(peerId, multiaddrs)
@@ -209,7 +209,7 @@ export interface PeerStore {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const peer = await peerStore.get(peerId)
    * // { .. }
    * ```
@@ -221,7 +221,7 @@ export interface PeerStore {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * await peerStore.save(peerId, {
    *   multiaddrs
    * })
@@ -234,7 +234,7 @@ export interface PeerStore {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * await peerStore.patch(peerId, {
    *   multiaddrs
    * })
@@ -247,7 +247,7 @@ export interface PeerStore {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * await peerStore.merge(peerId, {
    *   multiaddrs
    * })
@@ -264,7 +264,7 @@ export interface PeerStore {
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * await peerStore.consumePeerRecord(buf, expectedPeer)
    * ```
    */

package/src/pubsub/index.ts

@@ -174,7 +174,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const topic = 'topic'
    * const validateMessage = (msgTopic, msg) => {
    *   const input = uint8ArrayToString(msg.data)
@@ -194,7 +194,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
   /**
    * Gets a list of topics the node is subscribed to.
    *
-   * ```js
+   * ```TypeScript
    * const topics = libp2p.pubsub.getTopics()
    * ```
    */
@@ -205,7 +205,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const topic = 'topic'
    * const handler = (msg) => {
    *   if (msg.topic === topic) {
@@ -224,7 +224,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const topic = 'topic'
    * const handler = (msg) => {
    *   // msg.data - pubsub data received
@@ -241,7 +241,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const peerIds = libp2p.pubsub.getSubscribers(topic)
    * ```
    */
@@ -252,7 +252,7 @@ export interface PubSub<Events extends Record<string, any> = PubSubEvents> exten
    *
    * @example
    *
-   * ```js
+   * ```TypeScript
    * const topic = 'topic'
    * const data = uint8ArrayFromString('data')
    *