docs: fix dnsaddrResolver name

README.md

@@ -35,10 +35,8 @@ A standard way to represent addresses that
 
 ```TypeScript
 import { multiaddr } from '@multiformats/multiaddr'
-const addr =  multiaddr("/ip4/127.0.0.1/udp/1234")
-// Multiaddr(/ip4/127.0.0.1/udp/1234)
 
-const addr = multiaddr("/ip4/127.0.0.1/udp/1234")
+const addr = multiaddr('/ip4/127.0.0.1/udp/1234')
 // Multiaddr(/ip4/127.0.0.1/udp/1234)
 
 addr.bytes
@@ -77,9 +75,9 @@ DNSADDR addresses can resolve to multiple multiaddrs, since there is no limit to
 
 ```TypeScript
 import { multiaddr, resolvers } from '@multiformats/multiaddr'
-import { dnsaddr } from '@multiformats/multiaddr/resolvers'
+import { dnsaddrResolver } from '@multiformats/multiaddr/resolvers'
 
-resolvers.set('dnsaddr', dnsaddr)
+resolvers.set('dnsaddr', dnsaddrResolver)
 
 const ma = multiaddr('/dnsaddr/bootstrap.libp2p.io')
 
@@ -88,7 +86,7 @@ const resolved = await ma.resolve({
   signal: AbortSignal.timeout(5000)
 })
 
-console.info(await ma.resolve(resolved)
+console.info(resolved)
 // [Multiaddr('/ip4/147.75...'), Multiaddr('/ip4/147.75...'), Multiaddr('/ip4/147.75...')...]
 ```
 
@@ -102,7 +100,9 @@ import { dns } from '@multiformats/dns'
 import { dnsJsonOverHttps } from '@multiformats/dns/resolvers'
 
 const resolver = dns({
-  '.': dnsJsonOverHttps('https://cloudflare-dns.com/dns-query')
+  resolvers: {
+    '.': dnsJsonOverHttps('https://cloudflare-dns.com/dns-query')
+  }
 })
 
 const ma = multiaddr('/dnsaddr/bootstrap.libp2p.io')

examples/try.js

@@ -1,27 +1,26 @@
-'use strict'
+import { multiaddr, fromNodeAddress } from '@multiformats/multiaddr'
 
-const { Multiaddr } = require('../src')
 // eslint-disable-next-line no-console
 const log = console.log
 
-const addr = new Multiaddr('/ip4/127.0.0.1/udp/1234')
+const addr = multiaddr('/ip4/127.0.0.1/udp/1234')
 log(addr)
 log(addr.bytes)
 log(addr.toString())
-log(new Multiaddr(addr.bytes))
+log(multiaddr(addr.bytes))
 
 log(addr.protoCodes())
 log(addr.protoNames())
 log(addr.protos())
 
 log(addr.nodeAddress())
-log(Multiaddr.fromNodeAddress(addr.nodeAddress(), 'udp'))
+log(fromNodeAddress(addr.nodeAddress(), 'udp'))
 
 log(addr.encapsulate('/sctp/5678'))
 log(addr.decapsulate('/udp'))
 
-const printer = new Multiaddr('/ip4/192.168.0.13/tcp/80')
-const proxy = new Multiaddr('/ip4/10.20.30.40/tcp/443')
+const printer = multiaddr('/ip4/192.168.0.13/tcp/80')
+const proxy = multiaddr('/ip4/10.20.30.40/tcp/443')
 const printerOverProxy = proxy.encapsulate(printer)
 log(printerOverProxy)
 

package.json

@@ -154,6 +154,7 @@
     "clean": "aegir clean",
     "lint": "aegir lint",
     "dep-check": "aegir dep-check",
+    "doc-check": "aegir doc-check",
     "build": "aegir build",
     "test": "aegir test -f",
     "test:chrome": "aegir test -t browser --cov",

src/convert.ts

@@ -1,9 +1,3 @@
-/**
- * @packageDocumentation
- *
- * Provides methods for converting
- */
-
 import { IpNet } from '@chainsafe/netmask'
 import { base32 } from 'multiformats/bases/base32'
 import { base58btc } from 'multiformats/bases/base58'

src/index.ts

@@ -13,10 +13,8 @@
  *
  * ```TypeScript
  * import { multiaddr } from '@multiformats/multiaddr'
- * const addr =  multiaddr("/ip4/127.0.0.1/udp/1234")
- * // Multiaddr(/ip4/127.0.0.1/udp/1234)
  *
- * const addr = multiaddr("/ip4/127.0.0.1/udp/1234")
+ * const addr = multiaddr('/ip4/127.0.0.1/udp/1234')
  * // Multiaddr(/ip4/127.0.0.1/udp/1234)
  *
  * addr.bytes
@@ -55,9 +53,9 @@
  *
  * ```TypeScript
  * import { multiaddr, resolvers } from '@multiformats/multiaddr'
- * import { dnsaddr } from '@multiformats/multiaddr/resolvers'
+ * import { dnsaddrResolver } from '@multiformats/multiaddr/resolvers'
  *
- * resolvers.set('dnsaddr', dnsaddr)
+ * resolvers.set('dnsaddr', dnsaddrResolver)
  *
  * const ma = multiaddr('/dnsaddr/bootstrap.libp2p.io')
  *
@@ -66,7 +64,7 @@
  *   signal: AbortSignal.timeout(5000)
  * })
  *
- * console.info(await ma.resolve(resolved)
+ * console.info(resolved)
  * // [Multiaddr('/ip4/147.75...'), Multiaddr('/ip4/147.75...'), Multiaddr('/ip4/147.75...')...]
  * ```
  *
@@ -80,7 +78,9 @@
  * import { dnsJsonOverHttps } from '@multiformats/dns/resolvers'
  *
  * const resolver = dns({
- *   '.': dnsJsonOverHttps('https://cloudflare-dns.com/dns-query')
+ *   resolvers: {
+ *     '.': dnsJsonOverHttps('https://cloudflare-dns.com/dns-query')
+ *   }
  * })
  *
  * const ma = multiaddr('/dnsaddr/bootstrap.libp2p.io')

src/multiaddr.ts

@@ -1,17 +1,3 @@
-/**
- * @packageDocumentation
- *
- * An implementation of a Multiaddr in JavaScript
- *
- * @example
- *
- * ```js
- * import { multiaddr } from '@multiformats/multiaddr'
- *
- * const ma = multiaddr('/ip4/127.0.0.1/tcp/1234')
- * ```
- */
-
 import { base58btc } from 'multiformats/bases/base58'
 import { CID } from 'multiformats/cid'
 import { equals as uint8ArrayEquals } from 'uint8arrays/equals'

src/resolvers/index.ts

@@ -5,3 +5,4 @@ export interface Resolver<ResolveOptions extends AbortOptions = AbortOptions> {
 }
 
 export { dnsaddrResolver } from './dnsaddr.js'
+export type { DNSADDROptions } from './dnsaddr.js'