discovery

type Advertiser interface {
	// Advertise 广播一个服务
	// 参数:
	//   - ctx: 上下文对象,用于控制操作的生命周期
	//   - ns: 命名空间字符串,用于标识服务
	//   - opts: 可选的配置选项
	// 返回:
	//   - time.Duration: 广告的有效时长
	//   - error: 操作过程中的错误信息
	Advertise(ctx context.Context, ns string, opts ...Option) (time.Duration, error)
}

type Discoverer interface {
	// FindPeers 发现提供特定服务的节点
	// 参数:
	//   - ctx: 上下文对象,用于控制操作的生命周期
	//   - ns: 命名空间字符串,用于标识要查找的服务
	//   - opts: 可选的配置选项
	// 返回:
	//   - <-chan peer.AddrInfo: 返回包含发现节点信息的通道
	//   - error: 操作过程中的错误信息
	FindPeers(ctx context.Context, ns string, opts ...Option) (<-chan peer.AddrInfo, error)
}

type Discovery interface {
	// 嵌入 Advertiser 接口
	Advertiser
	// 嵌入 Discoverer 接口
	Discoverer
}

type Option func(opts *Options) error

type Options struct {
	// Ttl 广告的存活时间
	Ttl time.Duration
	// Limit 对等节点数量上限
	Limit int

	// Other 其他特定实现的选项
	// key和value类型为interface{}的map
	Other map[interface{}]interface{}
}