logos-delivery/messaging/messaging_client.nim
Ivan FB 18e17d2ddd
refactor: extract messaging client into top-level messaging folder
Move messaging_client.nim and the delivery_service machinery (send/recv
services, processors, not_delivered_storage) out of waku/ and waku/node/
into a dedicated top-level messaging/ folder.

The delivery services are a messaging-layer concern built on top of the
node, not part of node core, so a sibling folder makes that boundary
explicit. Shared message types (waku/api/types) and the node-owned
subscription_manager are left in place to avoid churn on widely-imported
modules.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-05 00:37:34 +02:00

60 lines
2.1 KiB
Nim

import results, chronos
import chronicles
import
waku/api/types,
waku/node/[waku_node, subscription_manager],
messaging/delivery_service/[recv_service, send_service],
messaging/delivery_service/send_service/delivery_task
type MessagingClient* = ref object
node: WakuNode
sendService*: SendService
recvService*: RecvService
started: bool
proc new*(
T: type MessagingClient, useP2PReliability: bool, node: WakuNode
): Result[T, string] =
let sendService = ?SendService.new(useP2PReliability, node)
let recvService = RecvService.new(node)
ok(T(node: node, sendService: sendService, recvService: recvService))
proc start*(self: MessagingClient): Result[void, string] =
if self.started:
return ok()
self.recvService.startRecvService()
self.sendService.startSendService()
self.started = true
ok()
proc stop*(self: MessagingClient) {.async.} =
if not self.started:
return
await self.sendService.stopSendService()
await self.recvService.stopRecvService()
self.started = false
proc send*(
self: MessagingClient, envelope: MessageEnvelope
): Future[Result[RequestId, string]] {.async.} =
## High-level messaging API send. Auto-subscribes to the content topic
## (so the local node sees its own gossipsub broadcast), builds a
## `DeliveryTask`, and hands it to the send service. Returns the request
## id the caller can correlate with `MessageSentEvent` / `MessageErrorEvent`.
let isSubbed =
self.node.subscriptionManager.isSubscribed(envelope.contentTopic).valueOr(false)
if not isSubbed:
info "Auto-subscribing to topic on send", contentTopic = envelope.contentTopic
self.node.subscriptionManager.subscribe(envelope.contentTopic).isOkOr:
warn "Failed to auto-subscribe", error = error
return err("Failed to auto-subscribe before sending: " & error)
let requestId = RequestId.new(self.node.rng)
let deliveryTask = DeliveryTask.new(requestId, envelope, self.node.brokerCtx).valueOr:
return err("MessagingClient.send: Failed to create delivery task: " & error)
asyncSpawn self.sendService.send(deliveryTask)
return ok(requestId)