@ziplayer/net 0.0.0-stage → 0.0.1

package/dist/stream/StreamImporter.d.ts

@@ -0,0 +1,37 @@
+import { Readable } from "node:stream";
+import type { NetNode } from "../NetNode";
+import { type AudioFrame } from "../protocol/frames";
+export interface RemoteStream {
+    stream: Readable;
+    streamType: string;
+    seekable: boolean;
+    /** Re-open the stream at `positionMs` from the same owner (seek / URL refresh). */
+    recreate: (positionMs: number) => Promise<Readable>;
+}
+export interface StreamImporterOptions {
+    /** Receive buffer in bytes; also the maximum credit outstanding. Default 512 KiB. */
+    bufferBytes?: number;
+    /** Max out-of-order chunks held while waiting for a gap. Default 256. */
+    maxReorder?: number;
+    openTimeoutMs?: number;
+    /** Accepted stream types from peers. Default: compressed audio (Opus containers and `arbitrary`), never raw PCM. */
+    allowedStreamTypes?: string[];
+}
+/** Consumer side: asks the owner streamInfo node for audio and exposes it as a normal Readable. */
+export declare class StreamImporter {
+    private readonly node;
+    private readonly options;
+    private readonly streams;
+    private nextStreamId;
+    private readonly bufferBytes;
+    private readonly maxReorder;
+    constructor(node: NetNode, options?: StreamImporterOptions);
+    /** Called by the owner of the audio handler for every frame received. */
+    onFrame(peerId: string, frame: AudioFrame): void;
+    open(peerId: string, track: unknown, options?: {
+        position?: number;
+        fresh?: boolean;
+        signal?: AbortSignal;
+    }): Promise<RemoteStream>;
+    closeAll(): void;
+}

package/dist/stream/StreamImporter.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamImporter = void 0;
+const node_stream_1 = require("node:stream");
+const StreamProvider_1 = require("./StreamProvider");
+const frames_1 = require("../protocol/frames");
+class IncomingStream extends node_stream_1.Readable {
+    streamId;
+    peerId;
+    bufferBytes;
+    grant;
+    onDestroy;
+    expected = 0;
+    received = 0;
+    granted;
+    pendingChunks = new Map();
+    constructor(streamId, peerId, bufferBytes, grant, onDestroy) {
+        super({ highWaterMark: bufferBytes });
+        this.streamId = streamId;
+        this.peerId = peerId;
+        this.bufferBytes = bufferBytes;
+        this.grant = grant;
+        this.onDestroy = onDestroy;
+        this.granted = bufferBytes;
+    }
+    _read() {
+        // Node may call _read() before the consumer has drained its read, so re-check once it has.
+        queueMicrotask(() => this.topUp());
+    }
+    /** Every consumption path (flowing mode, async iteration, pipe) calls read(); re-grant credit right after. */
+    read(size) {
+        const chunk = super.read(size);
+        this.topUp();
+        return chunk;
+    }
+    topUp() {
+        if (this.destroyed)
+            return;
+        const outstanding = this.granted - this.received;
+        const want = this.bufferBytes - this.readableLength - outstanding;
+        if (want >= this.bufferBytes / 4) {
+            this.granted += want;
+            this.grant(want);
+        }
+    }
+    _destroy(error, callback) {
+        this.onDestroy();
+        callback(error);
+    }
+}
+/** Consumer side: asks the owner streamInfo node for audio and exposes it as a normal Readable. */
+class StreamImporter {
+    node;
+    options;
+    streams = new Map();
+    nextStreamId = 1;
+    bufferBytes;
+    maxReorder;
+    constructor(node, options = {}) {
+        this.node = node;
+        this.options = options;
+        this.bufferBytes = options.bufferBytes ?? 512 * 1024;
+        this.maxReorder = options.maxReorder ?? 256;
+        node.on("sessionClose", (peerId) => {
+            for (const s of [...this.streams.values()])
+                if (s.peerId === peerId)
+                    s.destroy(new Error(`Session with ${peerId} closed`));
+        });
+        node.handle("stream.error", (body, ctx) => {
+            this.streams
+                .get(`${ctx.from}#${Number(body?.streamId)}`)
+                ?.destroy(new Error(String(body?.message ?? "Remote stream error")));
+        });
+    }
+    /** Called by the owner of the audio handler for every frame received. */
+    onFrame(peerId, frame) {
+        const stream = this.streams.get(`${peerId}#${frame.streamId}`);
+        if (!stream || stream.destroyed)
+            return;
+        if (frame.seq < stream.expected)
+            return; // duplicate
+        if (frame.seq > stream.expected) {
+            if (stream.pendingChunks.size >= this.maxReorder)
+                return void stream.destroy(new Error("Too many out-of-order audio frames"));
+            stream.pendingChunks.set(frame.seq, frame);
+            return;
+        }
+        let next = frame;
+        while (next) {
+            stream.expected++;
+            stream.pendingChunks.delete(next.seq);
+            if (next.payload.length) {
+                stream.received += next.payload.length;
+                stream.push(next.payload);
+            }
+            if (next.flags & frames_1.AUDIO_FLAG_EOS) {
+                stream.push(null);
+                return;
+            }
+            next = stream.pendingChunks.get(stream.expected);
+        }
+    }
+    async open(peerId, track, options) {
+        const streamId = this.nextStreamId++ >>> 0;
+        const key = `${peerId}#${streamId}`;
+        const incoming = new IncomingStream(streamId, peerId, this.bufferBytes, (bytes) => void this.node.notify(peerId, "stream.credit", { streamId, bytes }).catch(() => { }), () => {
+            if (this.streams.delete(key))
+                void this.node.notify(peerId, "stream.close", { streamId }).catch(() => { });
+        });
+        this.streams.set(key, incoming);
+        try {
+            const reply = await this.node.request(peerId, "stream.open", { streamId, track, position: options?.position ?? 0, fresh: options?.fresh === true, credit: this.bufferBytes }, { timeoutMs: this.options.openTimeoutMs ?? 20_000, signal: options?.signal });
+            const allowed = (this.options.allowedStreamTypes ?? StreamProvider_1.DEFAULT_ALLOWED_STREAM_TYPES).map((t) => t.toLowerCase());
+            if (!allowed.includes(String(reply.streamType).toLowerCase())) {
+                throw new Error(`Peer offered disallowed stream type "${reply.streamType}"`);
+            }
+            if ((options?.position ?? 0) > 0 && !reply.positionApplied) {
+                throw new Error("Stream owner cannot seek this stream");
+            }
+            return {
+                stream: incoming,
+                streamType: reply.streamType,
+                seekable: reply.seekable,
+                recreate: async (positionMs) => (await this.open(peerId, track, { position: positionMs, fresh: true })).stream,
+            };
+        }
+        catch (error) {
+            incoming.destroy();
+            throw error;
+        }
+    }
+    closeAll() {
+        for (const s of [...this.streams.values()])
+            s.destroy();
+    }
+}
+exports.StreamImporter = StreamImporter;
+//# sourceMappingURL=StreamImporter.js.map

package/dist/stream/StreamImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamImporter.js","sourceRoot":"","sources":["../../src/stream/StreamImporter.ts"],"names":[],"mappings":"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"}

package/dist/stream/StreamProvider.d.ts

@@ -0,0 +1,49 @@
+import { Readable } from "node:stream";
+import type { NetNode } from "../NetNode";
+/** The subset of ziplayer's `StreamInfo` the provider needs (keeps this module free of a runtime ziplayer dependency). */
+/**
+ * Compressed audio only. Official plugins (YouTube, SoundCloud, TTS...) return `arbitrary` (a compressed container the
+ * receiver demuxes exactly as it would locally), so it is allowed; raw PCM is not. Pass `["webm/opus", "ogg/opus", "opus"]`
+ * to accept Opus containers only.
+ */
+export declare const DEFAULT_ALLOWED_STREAM_TYPES: string[];
+export interface ProvidedStreamInfo {
+    stream?: Readable;
+    url?: string;
+    streamType?: string;
+    type?: string;
+    recreate?: (position: number) => Promise<Readable>;
+    remote?: boolean;
+}
+export interface StreamProviderOptions {
+    /** Resolve a stream for a track, typically `(track) => manager.resolveStream(track)`. */
+    resolveStream: (track: any, options: {
+        fresh?: boolean;
+    }) => Promise<ProvidedStreamInfo | null>;
+    /** Return false to refuse a track (allowlist of sources, etc.). */
+    allow?: (track: any, peerId: string) => boolean | Promise<boolean>;
+    /** Stream types that may leave this node. Default: compressed audio (Opus containers and `arbitrary`), never raw PCM. */
+    allowedStreamTypes?: string[];
+    chunkBytes?: number;
+    maxStreamsPerPeer?: number;
+    debug?: (message: string, ...args: unknown[]) => void;
+}
+/**
+ * Owner-streamInfo side. The node whose plugins resolve the stream keeps the source and pushes encoded
+ * audio (webm/ogg/opus, never PCM) to the requesting node, paced by credit the receiver grants.
+ */
+export declare class StreamProvider {
+    private readonly node;
+    private readonly options;
+    private readonly open;
+    private readonly chunkBytes;
+    private readonly allowedTypes;
+    constructor(node: NetNode, options: StreamProviderOptions);
+    private key;
+    private onOpen;
+    private onCredit;
+    private pump;
+    close(peerId: string, streamId: number): void;
+    closePeer(peerId: string): void;
+    closeAll(): void;
+}

package/dist/stream/StreamProvider.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamProvider = exports.DEFAULT_ALLOWED_STREAM_TYPES = void 0;
+const node_stream_1 = require("node:stream");
+const frames_1 = require("../protocol/frames");
+/** The subset of ziplayer's `StreamInfo` the provider needs (keeps this module free of a runtime ziplayer dependency). */
+/**
+ * Compressed audio only. Official plugins (YouTube, SoundCloud, TTS...) return `arbitrary` (a compressed container the
+ * receiver demuxes exactly as it would locally), so it is allowed; raw PCM is not. Pass `["webm/opus", "ogg/opus", "opus"]`
+ * to accept Opus containers only.
+ */
+exports.DEFAULT_ALLOWED_STREAM_TYPES = ["webm/opus", "ogg/opus", "opus", "arbitrary"];
+/**
+ * Owner-streamInfo side. The node whose plugins resolve the stream keeps the source and pushes encoded
+ * audio (webm/ogg/opus, never PCM) to the requesting node, paced by credit the receiver grants.
+ */
+class StreamProvider {
+    node;
+    options;
+    open = new Map();
+    chunkBytes;
+    allowedTypes;
+    constructor(node, options) {
+        this.node = node;
+        this.options = options;
+        this.allowedTypes = new Set((options.allowedStreamTypes ?? exports.DEFAULT_ALLOWED_STREAM_TYPES).map((t) => t.toLowerCase()));
+        this.chunkBytes = Math.max(1024, Math.min(options.chunkBytes ?? 16 * 1024, 256 * 1024));
+        node.handle("stream.open", (body, ctx) => this.onOpen(body, ctx.from), { role: "provide-stream" });
+        node.handle("stream.credit", (body, ctx) => this.onCredit(body, ctx.from), { role: "provide-stream" });
+        node.handle("stream.close", (body, ctx) => this.close(ctx.from, body?.streamId), { role: "provide-stream" });
+        node.on("sessionClose", (peerId) => this.closePeer(peerId));
+    }
+    key(peerId, streamId) {
+        return `${peerId}#${streamId}`;
+    }
+    async onOpen(body, from) {
+        const streamId = Number(body?.streamId);
+        if (!Number.isInteger(streamId) || streamId < 0 || streamId > 0xffffffff)
+            throw new Error("Invalid streamId");
+        const track = body?.track;
+        if (!track || typeof track !== "object")
+            throw new Error("Missing track");
+        if (this.options.allow && !(await this.options.allow(track, from)))
+            throw new Error("Track refused by provider");
+        const perPeer = [...this.open.values()].filter((s) => s.peerId === from).length;
+        if (perPeer >= (this.options.maxStreamsPerPeer ?? 8))
+            throw new Error("Too many open streams");
+        if (this.open.has(this.key(from, streamId)))
+            this.close(from, streamId);
+        const info = await this.options.resolveStream(track, { fresh: body?.fresh === true });
+        if (!info)
+            throw new Error("No stream available");
+        const streamType = String(info.streamType ?? info.type ?? "arbitrary");
+        if (!this.allowedTypes.has(streamType.toLowerCase())) {
+            info.stream?.destroy();
+            throw new Error(`Stream type "${streamType}" is not transferable (allowed: ${[...this.allowedTypes].join(", ")})`);
+        }
+        const position = Number(body?.position) > 0 ? Number(body.position) : 0;
+        let source = null;
+        if (position > 0 && info.recreate) {
+            info.stream?.destroy();
+            source = await info.recreate(position);
+        }
+        else if (info.stream) {
+            source = info.stream;
+        }
+        else if (info.url) {
+            source = await fetchUrl(info.url);
+        }
+        if (!source)
+            throw new Error("Stream has no readable source");
+        const state = {
+            peerId: from,
+            streamId,
+            source,
+            credit: Math.max(0, Number(body?.credit) || 0),
+            waiter: null,
+            closed: false,
+        };
+        this.open.set(this.key(from, streamId), state);
+        // Start pumping after the reply has been queued.
+        setImmediate(() => void this.pump(state));
+        return { streamId, streamType, seekable: Boolean(info.recreate), positionApplied: position > 0 && Boolean(info.recreate) };
+    }
+    onCredit(body, from) {
+        const state = this.open.get(this.key(from, Number(body?.streamId)));
+        if (!state)
+            return;
+        state.credit += Math.max(0, Number(body?.bytes) || 0);
+        state.waiter?.();
+    }
+    async pump(state) {
+        let seq = 0;
+        try {
+            for await (const chunk of state.source) {
+                const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                for (let offset = 0; offset < buf.length; offset += this.chunkBytes) {
+                    const part = buf.subarray(offset, offset + this.chunkBytes);
+                    while (state.credit < part.length && !state.closed) {
+                        await new Promise((resolve) => (state.waiter = resolve));
+                        state.waiter = null;
+                    }
+                    if (state.closed)
+                        return;
+                    state.credit -= part.length;
+                    await this.node.sendAudio(state.peerId, { streamId: state.streamId, seq: seq++, flags: 0, payload: part });
+                }
+            }
+            if (!state.closed) {
+                await this.node.sendAudio(state.peerId, {
+                    streamId: state.streamId,
+                    seq: seq++,
+                    flags: frames_1.AUDIO_FLAG_EOS,
+                    payload: Buffer.alloc(0),
+                });
+            }
+        }
+        catch (error) {
+            if (!state.closed) {
+                this.options.debug?.(`stream ${state.streamId} failed: ${error.message}`);
+                this.node
+                    .notify(state.peerId, "stream.error", { streamId: state.streamId, message: error.message })
+                    .catch(() => { });
+            }
+        }
+        finally {
+            this.close(state.peerId, state.streamId);
+        }
+    }
+    close(peerId, streamId) {
+        const k = this.key(peerId, Number(streamId));
+        const state = this.open.get(k);
+        if (!state)
+            return;
+        state.closed = true;
+        this.open.delete(k);
+        state.waiter?.();
+        state.source.destroy();
+    }
+    closePeer(peerId) {
+        for (const s of [...this.open.values()])
+            if (s.peerId === peerId)
+                this.close(peerId, s.streamId);
+    }
+    closeAll() {
+        for (const s of [...this.open.values()])
+            this.close(s.peerId, s.streamId);
+    }
+}
+exports.StreamProvider = StreamProvider;
+async function fetchUrl(url) {
+    const res = await fetch(url);
+    if (!res.ok || !res.body)
+        throw new Error(`Upstream returned ${res.status}`);
+    return node_stream_1.Readable.fromWeb(res.body);
+}
+//# sourceMappingURL=StreamProvider.js.map

package/dist/stream/StreamProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamProvider.js","sourceRoot":"","sources":["../../src/stream/StreamProvider.ts"],"names":[],"mappings":"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"}

package/dist/transport/MemoryTransport.d.ts

@@ -0,0 +1,36 @@
+import { type MessageHandler, type PublishOptions, type Transport } from "./Transport";
+interface Subscription {
+    client: MemoryTransport;
+    filter: string;
+    handler: MessageHandler;
+}
+/** In-process broker for tests and single-process setups. Mimics retained messages and last-will. */
+export declare class MemoryBroker {
+    readonly subscriptions: Set<Subscription>;
+    readonly retained: Map<string, Uint8Array<ArrayBufferLike>>;
+    /** Messages delivered, so tests can assert what an untrusted broker would see. */
+    readonly log: Array<{
+        topic: string;
+        payload: Uint8Array;
+    }>;
+    /** Optional tamper hook: return null to drop, or a replacement payload. */
+    intercept?: (topic: string, payload: Uint8Array) => Uint8Array | null;
+    deliver(topic: string, payload: Uint8Array, options?: PublishOptions): void;
+    transport(): MemoryTransport;
+}
+export declare class MemoryTransport implements Transport {
+    private readonly broker;
+    private will?;
+    private connected;
+    private readonly owned;
+    constructor(broker: MemoryBroker);
+    setLastWill(topic: string, payload: Uint8Array, options?: PublishOptions): void;
+    connect(): Promise<void>;
+    /** Graceful close: the last will is NOT published. */
+    close(): Promise<void>;
+    /** Simulates a crash: drops subscriptions and publishes the last will. */
+    kill(): Promise<void>;
+    publish(topic: string, payload: Uint8Array, options?: PublishOptions): Promise<void>;
+    subscribe(filter: string, handler: MessageHandler): Promise<() => void>;
+}
+export {};

package/dist/transport/MemoryTransport.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryTransport = exports.MemoryBroker = void 0;
+const Transport_1 = require("./Transport");
+/** In-process broker for tests and single-process setups. Mimics retained messages and last-will. */
+class MemoryBroker {
+    subscriptions = new Set();
+    retained = new Map();
+    /** Messages delivered, so tests can assert what an untrusted broker would see. */
+    log = [];
+    /** Optional tamper hook: return null to drop, or a replacement payload. */
+    intercept;
+    deliver(topic, payload, options) {
+        const out = this.intercept ? this.intercept(topic, payload) : payload;
+        if (!out)
+            return;
+        this.log.push({ topic, payload: out });
+        if (options?.retain) {
+            if (out.length === 0)
+                this.retained.delete(topic);
+            else
+                this.retained.set(topic, out);
+        }
+        for (const sub of [...this.subscriptions]) {
+            if ((0, Transport_1.topicMatches)(sub.filter, topic))
+                queueMicrotask(() => sub.handler(topic, out));
+        }
+    }
+    transport() {
+        return new MemoryTransport(this);
+    }
+}
+exports.MemoryBroker = MemoryBroker;
+class MemoryTransport {
+    broker;
+    will;
+    connected = false;
+    owned = new Set();
+    constructor(broker) {
+        this.broker = broker;
+    }
+    setLastWill(topic, payload, options) {
+        this.will = { topic, payload, options };
+    }
+    async connect() {
+        this.connected = true;
+    }
+    /** Graceful close: the last will is NOT published. */
+    async close() {
+        this.connected = false;
+        for (const sub of this.owned)
+            this.broker.subscriptions.delete(sub);
+        this.owned.clear();
+    }
+    /** Simulates a crash: drops subscriptions and publishes the last will. */
+    async kill() {
+        const will = this.will;
+        await this.close();
+        if (will)
+            this.broker.deliver(will.topic, will.payload, will.options);
+    }
+    async publish(topic, payload, options) {
+        if (!this.connected)
+            throw new Error("MemoryTransport is not connected");
+        this.broker.deliver(topic, payload, options);
+    }
+    async subscribe(filter, handler) {
+        if (!this.connected)
+            throw new Error("MemoryTransport is not connected");
+        const sub = { client: this, filter, handler };
+        this.broker.subscriptions.add(sub);
+        this.owned.add(sub);
+        for (const [topic, payload] of this.broker.retained) {
+            if ((0, Transport_1.topicMatches)(filter, topic))
+                queueMicrotask(() => handler(topic, payload));
+        }
+        return () => {
+            this.broker.subscriptions.delete(sub);
+            this.owned.delete(sub);
+        };
+    }
+}
+exports.MemoryTransport = MemoryTransport;
+//# sourceMappingURL=MemoryTransport.js.map

package/dist/transport/MemoryTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryTransport.js","sourceRoot":"","sources":["../../src/transport/MemoryTransport.ts"],"names":[],"mappings":";;;AAAA,2CAAqG;AAQrG,qGAAqG;AACrG,MAAa,YAAY;IACf,aAAa,GAAG,IAAI,GAAG,EAAgB,CAAC;IACxC,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAClD,kFAAkF;IACzE,GAAG,GAAkD,EAAE,CAAC;IACjE,2EAA2E;IAC3E,SAAS,CAA6D;IAEtE,OAAO,CAAC,KAAa,EAAE,OAAmB,EAAE,OAAwB;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACtE,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACvC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;;gBAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3C,IAAI,IAAA,wBAAY,EAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;gBAAE,cAAc,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACpF,CAAC;IACF,CAAC;IAED,SAAS;QACR,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACD;AAxBD,oCAwBC;AAED,MAAa,eAAe;IAKE;IAJrB,IAAI,CAAoE;IACxE,SAAS,GAAG,KAAK,CAAC;IACT,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAEjD,YAA6B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAErD,WAAW,CAAC,KAAa,EAAE,OAAmB,EAAE,OAAwB;QACvE,IAAI,CAAC,IAAI,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,KAAK;QACV,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,IAAI;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAmB,EAAE,OAAwB;QACzE,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,OAAuB;QACtD,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACzE,MAAM,GAAG,GAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrD,IAAI,IAAA,wBAAY,EAAC,MAAM,EAAE,KAAK,CAAC;gBAAE,cAAc,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,GAAG,EAAE;YACX,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC,CAAC;IACH,CAAC;CACD;AA/CD,0CA+CC"}

package/dist/transport/MqttTransport.d.ts

@@ -0,0 +1,26 @@
+import { type MessageHandler, type PublishOptions, type Transport } from "./Transport";
+export interface MqttTransportOptions {
+    /** e.g. `mqtts://broker.example.com:8883`. Use TLS: node ids and message sizes are visible otherwise. */
+    url: string;
+    username?: string;
+    password?: string;
+    clientId?: string;
+    /** Extra options passed straight to `mqtt.connect` (TLS certs, keepalive...). */
+    connectOptions?: Record<string, unknown>;
+    connectTimeoutMs?: number;
+    /** MQTT protocol level. Default 5; use 4 (3.1.1) for brokers without v5 support. Nothing here depends on v5-only features. */
+    protocolVersion?: 3 | 4 | 5;
+}
+/** MQTT v5 transport. Requires the optional peer dependency `mqtt`. */
+export declare class MqttTransport implements Transport {
+    private readonly options;
+    private client;
+    private will?;
+    private readonly handlers;
+    constructor(options: MqttTransportOptions);
+    setLastWill(topic: string, payload: Uint8Array, options?: PublishOptions): void;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    publish(topic: string, payload: Uint8Array, options?: PublishOptions): Promise<void>;
+    subscribe(filter: string, handler: MessageHandler): Promise<() => void>;
+}

package/dist/transport/MqttTransport.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MqttTransport = void 0;
+const Transport_1 = require("./Transport");
+/** MQTT v5 transport. Requires the optional peer dependency `mqtt`. */
+class MqttTransport {
+    options;
+    client = null;
+    will;
+    handlers = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    setLastWill(topic, payload, options) {
+        this.will = { topic, payload, options };
+    }
+    async connect() {
+        let mqtt;
+        try {
+            mqtt = require("mqtt");
+        }
+        catch {
+            throw new Error('MqttTransport requires the "mqtt" package: npm install mqtt');
+        }
+        const opts = {
+            protocolVersion: this.options.protocolVersion ?? 5,
+            clean: true,
+            reconnectPeriod: 2000,
+            username: this.options.username,
+            password: this.options.password,
+            clientId: this.options.clientId,
+            ...this.options.connectOptions,
+        };
+        if (this.will) {
+            opts.will = {
+                topic: this.will.topic,
+                payload: Buffer.from(this.will.payload),
+                qos: this.will.options?.qos ?? 1,
+                retain: this.will.options?.retain ?? false,
+            };
+        }
+        const client = mqtt.connect(this.options.url, opts);
+        this.client = client;
+        client.on("message", (topic, payload) => {
+            for (const [filter, set] of this.handlers) {
+                if (!(0, Transport_1.topicMatches)(filter, topic))
+                    continue;
+                for (const handler of set)
+                    handler(topic, payload);
+            }
+        });
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error("MQTT connect timed out")), this.options.connectTimeoutMs ?? 10_000);
+            client.once("connect", () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            client.once("error", (error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+        // Clean sessions drop subscriptions on reconnect, so subscribe again.
+        client.on("connect", () => {
+            for (const filter of this.handlers.keys())
+                client.subscribe(filter, { qos: 1 });
+        });
+    }
+    async close() {
+        const client = this.client;
+        this.client = null;
+        this.handlers.clear();
+        if (client)
+            await new Promise((resolve) => client.end(false, {}, () => resolve()));
+    }
+    publish(topic, payload, options) {
+        const client = this.client;
+        if (!client)
+            return Promise.reject(new Error("MqttTransport is not connected"));
+        return new Promise((resolve, reject) => client.publish(topic, Buffer.from(payload), { qos: options?.qos ?? 1, retain: options?.retain ?? false }, (error) => (error ? reject(error) : resolve())));
+    }
+    async subscribe(filter, handler) {
+        const client = this.client;
+        if (!client)
+            throw new Error("MqttTransport is not connected");
+        let set = this.handlers.get(filter);
+        const first = !set;
+        if (!set)
+            this.handlers.set(filter, (set = new Set()));
+        set.add(handler);
+        if (first) {
+            await new Promise((resolve, reject) => client.subscribe(filter, { qos: 1 }, (error) => (error ? reject(error) : resolve())));
+        }
+        return () => {
+            set.delete(handler);
+            if (set.size === 0) {
+                this.handlers.delete(filter);
+                this.client?.unsubscribe(filter);
+            }
+        };
+    }
+}
+exports.MqttTransport = MqttTransport;
+//# sourceMappingURL=MqttTransport.js.map