improve return types

This commit is contained in:
Andre Staltz 2024-01-16 13:16:30 +02:00
parent 9446faa823
commit e759e76299
No known key found for this signature in database
GPG Key ID: 9EDE23EA7E8A4890
1 changed files with 64 additions and 62 deletions

View File

@ -8,6 +8,7 @@ const { ErrorDuplex } = require('./utils')
const HUBS_SUBDOMAIN = 'hubs'
/**
* @typedef {`/${string}/${string}/${string}/${string}/${string}/${string}`} HubMultiaddr
* @typedef {ReturnType<import('ppppp-net').init>} PPPPPNet
* @typedef {ReturnType<import('ppppp-set').init>} PPPPPSet
* @typedef {import('ppppp-net').Info} Info
@ -52,12 +53,11 @@ function initHubClient(peer, config) {
fn.apply(this, args)
})
return {
/**
* @param {`/${string}`} multiaddr
* @param {HubMultiaddr} multiaddr
* @param {CB<void>} cb
*/
addHub(multiaddr, cb) {
function addHub(multiaddr, cb) {
peer.set.add(HUBS_SUBDOMAIN, multiaddr, (err, _) => {
// prettier-ignore
if (err) return cb(new Error('Failed to add Hub to my Set feed', {cause: err}))
@ -67,23 +67,21 @@ function initHubClient(peer, config) {
cb(null, void 0)
})
})
},
}
/**
* @param {number} amount
* @param {CB<Array<`/${string}`>>} cb
* @param {CB<Array<HubMultiaddr>>} cb
*/
getHubs(amount, cb) {
function getHubs(amount, cb) {
const source = peer.net.peers()
source(null, (err, peers) => {
if (err === true || !peers) return cb(null, [])
// prettier-ignore
if (err) return cb(new Error('Failed to get hubs', { cause: err }))
// @ts-ignore
const infoMap = /**@type {Map<`/${string}`, Info>}*/ (new Map(peers))
const multiaddrs = /**@type {Array<`/${string}`>}*/ (
peer.set.values(HUBS_SUBDOMAIN)
)
const infoMap = new Map(peers)
const multiaddrs = peer.set.values(HUBS_SUBDOMAIN)
const hubs = []
for (const multiaddr of multiaddrs) {
const stats = infoMap.get(multiaddr)?.stats ?? { failure: 1 }
@ -94,13 +92,13 @@ function initHubClient(peer, config) {
const returnable = hubs.map((h) => h.multiaddr)
cb(null, returnable)
})
},
}
/**
* @param {string} origin
* @returns {import('pull-stream').Duplex<unknown, unknown>}
*/
connect(origin) {
function connect(origin) {
// @ts-ignore
const hub = this.shse.pubkey
debug('received hubClient.connect(%s) via hub %s', origin, hub)
@ -113,15 +111,19 @@ function initHubClient(peer, config) {
} else {
return ErrorDuplex(`Could not connect to ${origin} via ${hub}`)
}
},
}
// Internal method, needed for api-plugin.ts
getHubsMap() {
// Internal method
function getHubsMap() {
return hubs
},
}
return {
addHub,
getHubs,
connect,
getHubsMap,
discoveredAttendants,
// underscore so other modules IN THIS LIBRARY can use it
_notifyDiscoveredAttendant,
}