← Back to @hyperfrontend/network-protocol
@hyperfrontend/network-protocol/browser/receiver

receiver

Browser-side inbound pipeline: frames in, opened packets out.

createReceiver(label, receivePacket, logger, open, onDrop?) builds a Receiver from a ReceivePacketFn callback that takes each opened UnencryptedPacket and the session's PacketOpener (protocol.open). receiver.receive(frame) takes the raw bytes from a message event on window, a MessagePort, or a Worker; a single open queue opens one frame at a time, which keeps the session's replay counter exact, and delivers each packet in order. A frame that is forged, replayed, malformed, or from another session is reported through onDrop and never delivered.

Hello frames belong to the protocol's acceptHello, not to the receiver. Pair with /browser/sender on the other end and a protocol from /browser/v3 or /browser/v4; a channel from /browser/channel creates both for you.

API Reference§

◈ Interfaces

§interface

InboundQueue

Represents an inbound processing queue with measurable size
Properties
§readonly size:numberNumber of items in the queue
View source →
§interface

Receiver

Receiver interface for processing inbound frames
Properties
§readonly receive:ReceiveFnFeeds an incoming frame into the pipeline
§readonly stop:() => voidPauses frame processing
§readonly resume:() => voidResumes frame processing
§readonly queue:InboundQueueThe frames waiting to be opened
View source →

◆ Types

§type

CreateReceiver

Factory function type for creating a Receiver instance; onDrop receives each frame the opener rejects
type CreateReceiver = (label: string, receiver: ReceivePacketFn<T>, logger: Logger, open: PacketOpener<T>, onDrop?: PacketDropHandler) => Receiver
View source →
§type

ReceiveFn

Function to receive raw wire bytes
type ReceiveFn = (packet: Uint8Array) => void
View source →
§type

ReceivePacketFn

Callback invoked with each opened packet
type ReceivePacketFn = (packet: UnencryptedPacket<T>) => void
View source →
§type

ReceiverFactory

Alias for CreateReceiver factory type
type ReceiverFactory = CreateReceiver
View source →

● Variables

§type

createReceiver

Creates the inbound half of a channel: frames are opened one at a time on the session's receiving key and delivered as plaintext packets.
A frame the opener rejects (forged, replayed, foreign, or malformed) is reported through onDrop and never delivered.
Example

Creating a receiver fed by a message listener

const receiver = createReceiver('host receiver', (packet) => deliver(packet.data.message), logger, protocol.open, (drop) => report(drop))
window.addEventListener('message', (event) => receiver.receive(event.data))
View source →