Add diff utils, change how adapter is created, scope down subscribe/publish to a single relay for fastest possible completion

This commit is contained in:
Jon Staab
2025-03-24 15:30:49 -07:00
parent d7b74d2c7e
commit 88b44776d8
4 changed files with 276 additions and 112 deletions
+48 -37
View File
@@ -1,9 +1,10 @@
import EventEmitter from "events" import EventEmitter from "events"
import {call, on} from "@welshman/lib" import {call, on} from "@welshman/lib"
import {Relay, LOCAL_RELAY_URL} from "@welshman/util" import {Relay, LOCAL_RELAY_URL, isRelayUrl} from "@welshman/util"
import {RelayMessage, ClientMessage} from "./message.js" import {RelayMessage, ClientMessage} from "./message.js"
import {Socket, SocketEventType} from "./socket.js" import {Socket, SocketEventType} from "./socket.js"
import {TypedEmitter, Unsubscriber} from "./util.js" import {TypedEmitter, Unsubscriber} from "./util.js"
import {Pool} from "./pool.js"
export enum AdapterEventType { export enum AdapterEventType {
Receive = "adapter:event:receive", Receive = "adapter:event:receive",
@@ -26,25 +27,27 @@ export abstract class AbstractAdapter extends (EventEmitter as new () => TypedEm
} }
} }
export class SocketsAdapter extends AbstractAdapter { export class SocketAdapter extends AbstractAdapter {
constructor(readonly sockets: Socket[]) { constructor(readonly socket: Socket) {
super() super()
this._unsubscribers = sockets.map(socket => { this._unsubscribers.push(
return on(socket, SocketEventType.Receive, (message: RelayMessage, url: string) => { on(socket, SocketEventType.Receive, (message: RelayMessage, url: string) => {
this.emit(AdapterEventType.Receive, message, url) this.emit(AdapterEventType.Receive, message, url)
}) }),
}) )
}
get sockets() {
return [this.socket]
} }
get urls() { get urls() {
return this.sockets.map(socket => socket.url) return [this.socket.url]
} }
send(message: ClientMessage) { send(message: ClientMessage) {
for (const socket of this.sockets) { this.socket.send(message)
socket.send(message)
}
} }
} }
@@ -52,21 +55,21 @@ export class LocalAdapter extends AbstractAdapter {
constructor(readonly relay: Relay) { constructor(readonly relay: Relay) {
super() super()
this._unsubscribers = [ this._unsubscribers.push(
on(relay, "*", (...message: RelayMessage) => { on(relay, "*", (...message: RelayMessage) => {
this.emit(AdapterEventType.Receive, message, LOCAL_RELAY_URL) this.emit(AdapterEventType.Receive, message, LOCAL_RELAY_URL)
}), }),
] )
}
get urls() {
return [LOCAL_RELAY_URL]
} }
get sockets() { get sockets() {
return [] return []
} }
get urls() {
return [LOCAL_RELAY_URL]
}
send(message: ClientMessage) { send(message: ClientMessage) {
const [type, ...rest] = message const [type, ...rest] = message
@@ -74,28 +77,36 @@ export class LocalAdapter extends AbstractAdapter {
} }
} }
export class MultiAdapter extends AbstractAdapter { export type AdapterContext = {
constructor(readonly adapters: AbstractAdapter[]) { pool?: Pool
super() relay?: Relay
getAdapter?: (url: string, context: AdapterContext) => AbstractAdapter
}
this._unsubscribers = adapters.map(adapter => { export const getAdapter = (url: string, context: AdapterContext) => {
return on(adapter, AdapterEventType.Receive, (message: RelayMessage, url: string) => { if (context.getAdapter) {
this.emit(AdapterEventType.Receive, message, url) const adapter = context.getAdapter(url, context)
})
})
}
get urls() { if (adapter) {
return this.adapters.flatMap(t => t.urls) return adapter
}
get sockets() {
return this.adapters.flatMap(t => t.sockets)
}
send(message: ClientMessage) {
for (const adapter of this.adapters) {
adapter.send(message)
} }
} }
if (url === LOCAL_RELAY_URL) {
if (!context.relay) {
throw new Error(`Unable to get local relay for ${url}`)
}
return new LocalAdapter(context.relay)
}
if (isRelayUrl(url)) {
if (!context.pool) {
throw new Error(`Unable to get socket for ${url}`)
}
return new SocketAdapter(context.pool.get(url))
}
throw new Error(`Invalid relay url ${url}`)
} }
+181 -26
View File
@@ -1,6 +1,7 @@
import {EventEmitter} from "events" import {EventEmitter} from "events"
import {on, randomId} from "@welshman/lib" import {on, sleep, randomId, groupBy, pushToMapKey, inc, flatten, chunk} from "@welshman/lib"
import {SignedEvent, Filter} from "@welshman/util" import {SignedEvent, Filter} from "@welshman/util"
import {TypedEmitter} from "./util.js"
import { import {
RelayMessage, RelayMessage,
isRelayNegErr, isRelayNegErr,
@@ -8,37 +9,47 @@ import {
RelayMessageType, RelayMessageType,
ClientMessageType, ClientMessageType,
} from "./message.js" } from "./message.js"
import {AbstractAdapter, AdapterEventType} from "./adapter.js" import {getAdapter, AdapterContext, AbstractAdapter, AdapterEventType} from "./adapter.js"
import {Negentropy, NegentropyStorageVector} from "./negentropy.js" import {Negentropy, NegentropyStorageVector} from "./negentropy.js"
import {TypedEmitter} from "./util.js" import {subscribe, SubscriptionEventType} from "./subscribe.js"
import {publish, PublishEventType} from "./publish.js"
export enum DiffEventType { export enum DifferenceEventType {
Message = "diff:event:message", Message = "difference:event:message",
Error = "diff:event:error", Error = "difference:event:error",
Close = "diff:event:close", Close = "difference:event:close",
} }
export type DiffEvents = { export type DifferenceEvents = {
[DiffEventType.Message]: (payload: {have: string[]; need: string[]}, url: string) => void [DifferenceEventType.Message]: (payload: {have: string[]; need: string[]}, url: string) => void
[DiffEventType.Error]: (error: string, url: string) => void [DifferenceEventType.Error]: (error: string, url: string) => void
[DiffEventType.Close]: () => void [DifferenceEventType.Close]: () => void
} }
export type DiffOptions = { export type DifferenceOptions = {
relay: string
filter: Filter filter: Filter
events: SignedEvent[] events: SignedEvent[]
adapter: AbstractAdapter context: AdapterContext
on?: Partial<DiffEvents> on?: Partial<DifferenceEvents>
} }
export class Diff extends (EventEmitter as new () => TypedEmitter<DiffEvents>) { export class Difference extends (EventEmitter as new () => TypedEmitter<DifferenceEvents>) {
have = new Set<string>()
need = new Set<string>()
_id = `NEG-${randomId().slice(0, 8)}` _id = `NEG-${randomId().slice(0, 8)}`
_unsubscriber: () => void _unsubscriber: () => void
_adapter: AbstractAdapter
_closed = false _closed = false
constructor(readonly options: DiffOptions) { constructor(readonly options: DifferenceOptions) {
super() super()
// Set up our adapter
this._adapter = getAdapter(this.options.relay, this.options.context)
// Set up negentropy
const storage = new NegentropyStorageVector() const storage = new NegentropyStorageVector()
const neg = new Negentropy(storage, 50_000) const neg = new Negentropy(storage, 50_000)
@@ -48,8 +59,9 @@ export class Diff extends (EventEmitter as new () => TypedEmitter<DiffEvents>) {
storage.seal() storage.seal()
// Add listeners
this._unsubscriber = on( this._unsubscriber = on(
this.options.adapter, this._adapter,
AdapterEventType.Receive, AdapterEventType.Receive,
async (message: RelayMessage, url: string) => { async (message: RelayMessage, url: string) => {
if (isRelayNegMsg(message)) { if (isRelayNegMsg(message)) {
@@ -58,12 +70,18 @@ export class Diff extends (EventEmitter as new () => TypedEmitter<DiffEvents>) {
if (negid === this._id) { if (negid === this._id) {
const [newMsg, have, need] = await neg.reconcile(msg) const [newMsg, have, need] = await neg.reconcile(msg)
this.emit(DiffEventType.Message, {have, need}, url) for (const id of have) {
this.have.add(id)
}
for (const id of need) {
this.need.add(id)
}
this.emit(DifferenceEventType.Message, {have, need}, url)
if (newMsg) { if (newMsg) {
this.options.adapter.send([RelayMessageType.NegMsg, this._id, newMsg]) this._adapter.send([RelayMessageType.NegMsg, this._id, newMsg])
} else {
this.close()
} }
} }
} }
@@ -72,7 +90,7 @@ export class Diff extends (EventEmitter as new () => TypedEmitter<DiffEvents>) {
const [_, negid, msg] = message const [_, negid, msg] = message
if (negid === this._id) { if (negid === this._id) {
this.emit(DiffEventType.Error, msg, url) this.emit(DifferenceEventType.Error, msg, url)
} }
} }
}, },
@@ -81,22 +99,159 @@ export class Diff extends (EventEmitter as new () => TypedEmitter<DiffEvents>) {
// Register listeners // Register listeners
if (this.options.on) { if (this.options.on) {
for (const [k, listener] of Object.entries(this.options.on)) { for (const [k, listener] of Object.entries(this.options.on)) {
this.on(k as keyof DiffEvents, listener) this.on(k as keyof DifferenceEvents, listener)
} }
} }
neg.initiate().then((msg: string) => { neg.initiate().then((msg: string) => {
this.options.adapter.send([ClientMessageType.NegOpen, this._id, this.options.filter, msg]) this._adapter.send([ClientMessageType.NegOpen, this._id, this.options.filter, msg])
}) })
} }
close() { close() {
if (this._closed) return if (this._closed) return
this.options.adapter.send([ClientMessageType.NegClose, this._id]) this._adapter.send([ClientMessageType.NegClose, this._id])
this.emit(DiffEventType.Close) this.emit(DifferenceEventType.Close)
this.removeAllListeners() this.removeAllListeners()
this._adapter.cleanup()
this._unsubscriber() this._unsubscriber()
this._closed = true this._closed = true
} }
} }
// diff is a shortcut for diffing multiple filters across multiple relays
export type DiffOptions = {
relays: string[]
filters: Filter[]
events: SignedEvent[]
context: AdapterContext
}
export type DiffItem = {
relay: string
have: Set<string>
need: Set<string>
}
export const diff = async ({relays, filters, ...options}: DiffOptions) => {
const diffs = flatten(
await Promise.all(
relays.flatMap(async relay => {
return await Promise.all(
filters.map(
async filter =>
new Promise<DiffItem>((resolve, reject) => {
const diff = new Difference({relay, filter, ...options})
diff.on(DifferenceEventType.Close, () => {
resolve({relay, have: diff.have, need: diff.need})
diff.close()
})
diff.on(DifferenceEventType.Error, (url, message) => {
reject(message)
diff.close()
})
sleep(30_000).then(() => {
reject("timeout")
diff.close()
})
}),
),
)
}),
),
)
return Array.from(groupBy(diff => diff.relay, diffs).entries()).map(([relay, diffs]) => {
const have = new Set<string>()
const need = new Set<string>()
for (const diff of diffs) {
for (const id of diff.have) {
have.add(id)
}
for (const id of diff.need) {
need.add(id)
}
}
return {relay, have: Array.from(have), need: Array.from(need)}
})
}
// Pull diffs multiple arrays and fetches missing events
export type PullOptions = DiffOptions
export const pull = async ({context, ...options}: PullOptions) => {
const countById = new Map<string, number>()
const idsByRelay = new Map<string, string[]>()
for (const {relay, need} of await diff({context, ...options})) {
for (const id of need) {
const count = countById.get(id) || 0
// Reduce, but don't completely eliminate duplicates, just in case a relay
// won't give us what we ask for.
if (count < 2) {
pushToMapKey(idsByRelay, relay, id)
countById.set(id, inc(count))
}
}
}
const result: SignedEvent[] = []
await Promise.all(
Array.from(idsByRelay.entries()).map(([relay, allIds]) => {
return Promise.all(
chunk(500, allIds).map(ids => {
return new Promise<void>(resolve => {
const sub = subscribe({relay, filter: {ids}, context, autoClose: true})
sub.on(SubscriptionEventType.Close, resolve)
sub.on(SubscriptionEventType.Event, event => result.push(event))
})
}),
)
}),
)
return result
}
// Push diffs multiple relays and publishes missing events
export type PushOptions = DiffOptions
export const push = async ({context, events, ...options}: PushOptions) => {
const relaysById = new Map<string, string[]>()
for (const {relay, have} of await diff({context, events, ...options})) {
for (const id of have) {
pushToMapKey(relaysById, id, relay)
}
}
await Promise.all(
events.map(async event => {
const relays = relaysById.get(event.id)
if (relays) {
await Promise.all(
relays.map(
relay =>
new Promise<void>(resolve => {
publish({event, relay, context}).on(PublishEventType.Complete, resolve)
}),
),
)
}
}),
)
}
+31 -32
View File
@@ -2,7 +2,7 @@ import {EventEmitter} from "events"
import {on, sleep, yieldThread} from "@welshman/lib" import {on, sleep, yieldThread} from "@welshman/lib"
import {SignedEvent} from "@welshman/util" import {SignedEvent} from "@welshman/util"
import {RelayMessage, ClientMessageType, isRelayOk} from "./message.js" import {RelayMessage, ClientMessageType, isRelayOk} from "./message.js"
import {AbstractAdapter, AdapterEventType} from "./adapter.js" import {AbstractAdapter, AdapterEventType, AdapterContext, getAdapter} from "./adapter.js"
import {TypedEmitter} from "./util.js" import {TypedEmitter} from "./util.js"
export enum PublishStatus { export enum PublishStatus {
@@ -13,33 +13,42 @@ export enum PublishStatus {
Aborted = "publish:status:aborted", Aborted = "publish:status:aborted",
} }
export enum PublishEventType {
Complete = "publish:status:complete",
}
export type PublishEvents = { export type PublishEvents = {
[PublishStatus.Pending]: (url: string) => void
[PublishStatus.Success]: (id: string, detail: string, url: string) => void [PublishStatus.Success]: (id: string, detail: string, url: string) => void
[PublishStatus.Failure]: (id: string, detail: string, url: string) => void [PublishStatus.Failure]: (id: string, detail: string, url: string) => void
[PublishStatus.Timeout]: (url: string) => void [PublishStatus.Timeout]: () => void
[PublishStatus.Aborted]: (url: string) => void [PublishStatus.Aborted]: () => void
[PublishEventType.Complete]: () => void
} }
export type PublishOptions = { export type PublishOptions = {
adapter: AbstractAdapter relay: string
event: SignedEvent event: SignedEvent
context: AdapterContext
timeout?: number timeout?: number
on?: Partial<PublishEvents> on?: Partial<PublishEvents>
} }
export class Publish extends (EventEmitter as new () => TypedEmitter<PublishEvents>) { export class Publish extends (EventEmitter as new () => TypedEmitter<PublishEvents>) {
status = new Map<string, PublishStatus>() status = PublishStatus.Pending
_done = new Set<string>() _done = new Set<string>()
_unsubscriber: () => void _unsubscriber: () => void
_adapter: AbstractAdapter
constructor(readonly options: PublishOptions) { constructor(readonly options: PublishOptions) {
super() super()
// Set up our adapter
this._adapter = getAdapter(this.options.relay, this.options.context)
// Listen for publish result // Listen for publish result
this._unsubscriber = on( this._unsubscriber = on(
this.options.adapter, this._adapter,
AdapterEventType.Receive, AdapterEventType.Receive,
(message: RelayMessage, url: string) => { (message: RelayMessage, url: string) => {
if (isRelayOk(message)) { if (isRelayOk(message)) {
@@ -48,16 +57,14 @@ export class Publish extends (EventEmitter as new () => TypedEmitter<PublishEven
if (id !== this.options.event.id) return if (id !== this.options.event.id) return
if (ok) { if (ok) {
this.status.set(url, PublishStatus.Success) this.status = PublishStatus.Success
this.emit(PublishStatus.Success, id, detail, url) this.emit(PublishStatus.Success, id, detail, url)
} else { } else {
this.status.set(url, PublishStatus.Failure) this.status = PublishStatus.Failure
this.emit(PublishStatus.Failure, id, detail, url) this.emit(PublishStatus.Failure, id, detail, url)
} }
if (!Array.from(this.status.values()).includes(PublishStatus.Pending)) { this.cleanup()
this.cleanup()
}
} }
}, },
) )
@@ -74,42 +81,34 @@ export class Publish extends (EventEmitter as new () => TypedEmitter<PublishEven
} }
start = () => { start = () => {
// Initialize status
for (const url of this.options.adapter.urls) {
this.status.set(url, PublishStatus.Pending)
this.emit(PublishStatus.Pending, url)
}
// Set timeout // Set timeout
sleep(this.options.timeout || 10_000).then(() => { sleep(this.options.timeout || 10_000).then(() => {
for (const [url, status] of this.status.entries()) { if (this.status === PublishStatus.Pending) {
if (status === PublishStatus.Pending) { this.status = PublishStatus.Timeout
this.status.set(url, PublishStatus.Timeout) this.emit(PublishStatus.Timeout)
this.emit(PublishStatus.Timeout, url)
}
} }
this.cleanup() this.cleanup()
}) })
// Send the publish message // Send the publish message
this.options.adapter.send([ClientMessageType.Event, event]) this._adapter.send([ClientMessageType.Event, event])
} }
abort = () => { abort = () => {
for (const [url, status] of this.status.entries()) { if (this.status === PublishStatus.Pending) {
if (status === PublishStatus.Pending) { this.status = PublishStatus.Aborted
this.status.set(url, PublishStatus.Aborted) this.emit(PublishStatus.Aborted)
this.emit(PublishStatus.Aborted, url) this.cleanup()
}
} }
this.cleanup()
} }
cleanup = () => { cleanup = () => {
this.options.adapter.cleanup() this.emit(PublishEventType.Complete)
this.removeAllListeners() this.removeAllListeners()
this._adapter.cleanup()
this._unsubscriber() this._unsubscriber()
} }
} }
export const publish = (options: PublishOptions) => new Publish(options)
+16 -17
View File
@@ -2,7 +2,7 @@ import {EventEmitter} from "events"
import {on, call, randomId, yieldThread} from "@welshman/lib" import {on, call, randomId, yieldThread} from "@welshman/lib"
import {Filter, matchFilter, SignedEvent} from "@welshman/util" import {Filter, matchFilter, SignedEvent} from "@welshman/util"
import {RelayMessage, ClientMessageType, isRelayEvent, isRelayEose} from "./message.js" import {RelayMessage, ClientMessageType, isRelayEvent, isRelayEose} from "./message.js"
import {AbstractAdapter, AdapterEventType} from "./adapter.js" import {getAdapter, AdapterContext, AbstractAdapter, AdapterEventType} from "./adapter.js"
import {SocketEventType, SocketStatus} from "./socket.js" import {SocketEventType, SocketStatus} from "./socket.js"
import {TypedEmitter, Unsubscriber} from "./util.js" import {TypedEmitter, Unsubscriber} from "./util.js"
import {Tracker} from "./tracker.js" import {Tracker} from "./tracker.js"
@@ -28,11 +28,12 @@ export type SubscriptionEvents = {
} }
export type SubscriptionOptions = { export type SubscriptionOptions = {
adapter: AbstractAdapter relay: string
autoClose?: boolean
filter: Filter filter: Filter
context: AdapterContext
timeout?: number timeout?: number
tracker?: Tracker tracker?: Tracker
autoClose?: boolean
verifyEvent?: (event: SignedEvent) => boolean verifyEvent?: (event: SignedEvent) => boolean
on?: Partial<SubscriptionEvents> on?: Partial<SubscriptionEvents>
} }
@@ -40,18 +41,18 @@ export type SubscriptionOptions = {
export class Subscription extends (EventEmitter as new () => TypedEmitter<SubscriptionEvents>) { export class Subscription extends (EventEmitter as new () => TypedEmitter<SubscriptionEvents>) {
_id = `REQ-${randomId().slice(0, 8)}` _id = `REQ-${randomId().slice(0, 8)}`
_unsubscribers: Unsubscriber[] = [] _unsubscribers: Unsubscriber[] = []
_done = new Set<string>() _adapter: AbstractAdapter
_closed = false _closed = false
constructor(readonly options: SubscriptionOptions) { constructor(readonly options: SubscriptionOptions) {
super() super()
// Get our unique urls so we know when we're done // Set up our adapter
const urls = new Set(this.options.adapter.urls) this._adapter = getAdapter(this.options.relay, this.options.context)
// Listen for event/eose messages from the adapter // Listen for event/eose messages from the adapter
this._unsubscribers.push( this._unsubscribers.push(
on(this.options.adapter, AdapterEventType.Receive, (message: RelayMessage, url: string) => { on(this._adapter, AdapterEventType.Receive, (message: RelayMessage, url: string) => {
if (isRelayEvent(message)) { if (isRelayEvent(message)) {
const [_, id, event] = message const [_, id, event] = message
@@ -74,9 +75,7 @@ export class Subscription extends (EventEmitter as new () => TypedEmitter<Subscr
if (id === this._id) { if (id === this._id) {
this.emit(SubscriptionEventType.Eose, url) this.emit(SubscriptionEventType.Eose, url)
this._done.add(url) if (this.options.autoClose) {
if (this.options.autoClose && this._done.size === urls.size) {
this.close() this.close()
} }
} }
@@ -85,15 +84,13 @@ export class Subscription extends (EventEmitter as new () => TypedEmitter<Subscr
) )
// Listen to disconnects from any sockets // Listen to disconnects from any sockets
for (const socket of this.options.adapter.sockets) { for (const socket of this._adapter.sockets) {
this._unsubscribers.push( this._unsubscribers.push(
on(socket, SocketEventType.Status, (status: SocketStatus) => { on(socket, SocketEventType.Status, (status: SocketStatus) => {
if (![SocketStatus.Open, SocketStatus.Opening].includes(status)) { if (![SocketStatus.Open, SocketStatus.Opening].includes(status)) {
this.emit(SubscriptionEventType.Disconnect, socket.url) this.emit(SubscriptionEventType.Disconnect, socket.url)
this._done.add(socket.url) if (this.options.autoClose) {
if (this.options.autoClose && this._done.size === urls.size) {
this.close() this.close()
} }
} }
@@ -119,17 +116,19 @@ export class Subscription extends (EventEmitter as new () => TypedEmitter<Subscr
} }
// Send our request // Send our request
this.options.adapter.send([ClientMessageType.Req, this._id, this.options.filter]) this._adapter.send([ClientMessageType.Req, this._id, this.options.filter])
} }
close() { close() {
if (this._closed) return if (this._closed) return
this.options.adapter.send(["CLOSE", this._id]) this._adapter.send(["CLOSE", this._id])
this.emit(SubscriptionEventType.Close) this.emit(SubscriptionEventType.Close)
this.options.adapter.cleanup()
this.removeAllListeners() this.removeAllListeners()
this._unsubscribers.map(call) this._unsubscribers.map(call)
this._adapter.cleanup()
this._closed = true this._closed = true
} }
} }
export const subscribe = (options: SubscriptionOptions) => new Subscription(options)