@antseed/node 0.1.0

package/dist/p2p/message-protocol.d.ts

@@ -0,0 +1,50 @@
+import { MessageType, type FramedMessage } from "../types/protocol.js";
+/**
+ * Frame layout (9 bytes header + payload):
+ *   [0]       u8   — message type
+ *   [1..4]    u32  — message ID (big-endian)
+ *   [5..8]    u32  — payload length (big-endian)
+ *   [9..]     raw  — payload bytes
+ */
+/** Encode a FramedMessage into a binary buffer. */
+export declare function encodeFrame(msg: FramedMessage): Uint8Array;
+/**
+ * Decode a single FramedMessage from a binary buffer.
+ * Returns the message and the number of bytes consumed.
+ * Returns null if the buffer doesn't contain a complete frame.
+ */
+export declare function decodeFrame(data: Uint8Array): {
+    message: FramedMessage;
+    bytesConsumed: number;
+} | null;
+/**
+ * Streaming frame decoder that handles partial frames across
+ * multiple data chunks (e.g., from a DataChannel).
+ */
+export declare class FrameDecoder {
+    private _buffer;
+    /** Feed new data and return any complete frames. */
+    feed(chunk: Uint8Array): FramedMessage[];
+    /** Reset the internal buffer. */
+    reset(): void;
+    /** Number of buffered bytes not yet decoded. */
+    get bufferedBytes(): number;
+}
+/** Handler function for a specific message type. */
+export type MessageHandler = (msg: FramedMessage) => void | Promise<void>;
+/**
+ * Message multiplexer — routes decoded frames to registered handlers.
+ */
+export declare class MessageMux {
+    private _handlers;
+    private _defaultHandler;
+    /** Register a handler for a specific message type. */
+    on(type: MessageType, handler: MessageHandler): void;
+    /** Remove a handler for a specific message type. */
+    off(type: MessageType, handler: MessageHandler): void;
+    /** Set a default handler for unregistered message types. */
+    setDefaultHandler(handler: MessageHandler): void;
+    /** Dispatch a framed message to registered handlers. */
+    dispatch(msg: FramedMessage): Promise<void>;
+}
+//# sourceMappingURL=message-protocol.d.ts.map

package/dist/p2p/message-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-protocol.d.ts","sourceRoot":"","sources":["../../src/p2p/message-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAGnB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AAEH,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAgB1D;AAUD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,UAAU,GACf;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA+B1D;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAiC;IAEhD,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,EAAE;IA0BxC,iCAAiC;IACjC,KAAK,IAAI,IAAI;IAIb,gDAAgD;IAChD,IAAI,aAAa,IAAI,MAAM,CAE1B;CACF;AAED,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1E;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,eAAe,CAA+B;IAEtD,sDAAsD;IACtD,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAMpD,oDAAoD;IACpD,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IASrD,4DAA4D;IAC5D,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhD,wDAAwD;IAClD,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAUlD"}

package/dist/p2p/message-protocol.js

@@ -0,0 +1,134 @@
+import { MessageType, FRAME_HEADER_SIZE, MAX_PAYLOAD_SIZE, } from "../types/protocol.js";
+/**
+ * Frame layout (9 bytes header + payload):
+ *   [0]       u8   — message type
+ *   [1..4]    u32  — message ID (big-endian)
+ *   [5..8]    u32  — payload length (big-endian)
+ *   [9..]     raw  — payload bytes
+ */
+/** Encode a FramedMessage into a binary buffer. */
+export function encodeFrame(msg) {
+    if (msg.payload.length > MAX_PAYLOAD_SIZE) {
+        throw new Error(`Payload too large: ${msg.payload.length} > ${MAX_PAYLOAD_SIZE}`);
+    }
+    const frame = new Uint8Array(FRAME_HEADER_SIZE + msg.payload.length);
+    const view = new DataView(frame.buffer);
+    view.setUint8(0, msg.type);
+    view.setUint32(1, msg.messageId);
+    view.setUint32(5, msg.payload.length);
+    frame.set(msg.payload, FRAME_HEADER_SIZE);
+    return frame;
+}
+const VALID_MESSAGE_TYPES = new Set(Object.values(MessageType).filter((v) => typeof v === "number"));
+function isValidMessageType(value) {
+    return VALID_MESSAGE_TYPES.has(value);
+}
+/**
+ * Decode a single FramedMessage from a binary buffer.
+ * Returns the message and the number of bytes consumed.
+ * Returns null if the buffer doesn't contain a complete frame.
+ */
+export function decodeFrame(data) {
+    if (data.length < FRAME_HEADER_SIZE) {
+        return null;
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const rawType = view.getUint8(0);
+    if (!isValidMessageType(rawType)) {
+        return null;
+    }
+    const type = rawType;
+    const messageId = view.getUint32(1);
+    const payloadLength = view.getUint32(5);
+    if (payloadLength > MAX_PAYLOAD_SIZE) {
+        throw new Error(`Payload length ${payloadLength} exceeds maximum ${MAX_PAYLOAD_SIZE}`);
+    }
+    const totalLength = FRAME_HEADER_SIZE + payloadLength;
+    if (data.length < totalLength) {
+        return null; // incomplete frame
+    }
+    const payload = data.slice(FRAME_HEADER_SIZE, totalLength);
+    return {
+        message: { type, messageId, payload },
+        bytesConsumed: totalLength,
+    };
+}
+/**
+ * Streaming frame decoder that handles partial frames across
+ * multiple data chunks (e.g., from a DataChannel).
+ */
+export class FrameDecoder {
+    _buffer = new Uint8Array(0);
+    /** Feed new data and return any complete frames. */
+    feed(chunk) {
+        // Append chunk to buffer
+        const newBuffer = new Uint8Array(this._buffer.length + chunk.length);
+        newBuffer.set(this._buffer, 0);
+        newBuffer.set(chunk, this._buffer.length);
+        this._buffer = newBuffer;
+        const messages = [];
+        while (true) {
+            let result;
+            try {
+                result = decodeFrame(this._buffer);
+            }
+            catch {
+                this._buffer = new Uint8Array(0);
+                break;
+            }
+            if (!result)
+                break;
+            messages.push(result.message);
+            this._buffer = this._buffer.slice(result.bytesConsumed);
+        }
+        return messages;
+    }
+    /** Reset the internal buffer. */
+    reset() {
+        this._buffer = new Uint8Array(0);
+    }
+    /** Number of buffered bytes not yet decoded. */
+    get bufferedBytes() {
+        return this._buffer.length;
+    }
+}
+/**
+ * Message multiplexer — routes decoded frames to registered handlers.
+ */
+export class MessageMux {
+    _handlers = new Map();
+    _defaultHandler = null;
+    /** Register a handler for a specific message type. */
+    on(type, handler) {
+        const existing = this._handlers.get(type) ?? [];
+        existing.push(handler);
+        this._handlers.set(type, existing);
+    }
+    /** Remove a handler for a specific message type. */
+    off(type, handler) {
+        const existing = this._handlers.get(type);
+        if (!existing)
+            return;
+        const idx = existing.indexOf(handler);
+        if (idx !== -1) {
+            existing.splice(idx, 1);
+        }
+    }
+    /** Set a default handler for unregistered message types. */
+    setDefaultHandler(handler) {
+        this._defaultHandler = handler;
+    }
+    /** Dispatch a framed message to registered handlers. */
+    async dispatch(msg) {
+        const handlers = this._handlers.get(msg.type);
+        if (handlers && handlers.length > 0) {
+            for (const handler of handlers) {
+                await handler(msg);
+            }
+        }
+        else if (this._defaultHandler) {
+            await this._defaultHandler(msg);
+        }
+    }
+}
+//# sourceMappingURL=message-protocol.js.map

package/dist/p2p/message-protocol.js.map

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

package/dist/p2p/nat-traversal.d.ts

@@ -0,0 +1,51 @@
+export interface NatMapping {
+    /** The internal port that was mapped. */
+    internalPort: number;
+    /** The external port on the router (usually same as internal). */
+    externalPort: number;
+    /** The external/public IP address. */
+    externalIp: string;
+    /** Protocol that was mapped. */
+    protocol: "TCP" | "UDP";
+}
+export interface NatTraversalResult {
+    /** Whether UPnP/NAT-PMP mapping succeeded. */
+    success: boolean;
+    /** External IP if discovered. */
+    externalIp: string | null;
+    /** Successfully created mappings. */
+    mappings: NatMapping[];
+}
+/**
+ * Automatic NAT traversal via UPnP and NAT-PMP.
+ *
+ * Requests port forwarding from the router so that inbound connections
+ * from the internet can reach the seller's signaling port. This is
+ * transparent to the caller — just call `mapPorts()` after binding
+ * and `cleanup()` on shutdown.
+ */
+export declare class NatTraversal {
+    private _nat;
+    private _mappings;
+    private _externalIp;
+    private _destroyed;
+    /**
+     * Attempt to map the given ports via UPnP/NAT-PMP.
+     *
+     * @param ports - Array of { port, protocol } to map.
+     * @param timeoutMs - How long to wait before giving up (default 10s).
+     * @returns Result indicating success and discovered external IP.
+     */
+    mapPorts(ports: Array<{
+        port: number;
+        protocol: "TCP" | "UDP";
+    }>, timeoutMs?: number): Promise<NatTraversalResult>;
+    private _doMapping;
+    /** The external IP discovered during mapping, if any. */
+    get externalIp(): string | null;
+    /** All active port mappings. */
+    get mappings(): readonly NatMapping[];
+    /** Remove all port mappings and clean up. */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=nat-traversal.d.ts.map

package/dist/p2p/nat-traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nat-traversal.d.ts","sourceRoot":"","sources":["../../src/p2p/nat-traversal.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;OAMG;IACG,QAAQ,CACZ,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAA;KAAE,CAAC,EACvD,SAAS,SAAS,GACjB,OAAO,CAAC,kBAAkB,CAAC;YAiChB,UAAU;IA8CxB,yDAAyD;IACzD,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,gCAAgC;IAChC,IAAI,QAAQ,IAAI,SAAS,UAAU,EAAE,CAEpC;IAED,6CAA6C;IACvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAyB/B"}

package/dist/p2p/nat-traversal.js

@@ -0,0 +1,135 @@
+import NatAPI from "@silentbot1/nat-api";
+import { debugLog, debugWarn } from "../utils/debug.js";
+/**
+ * Automatic NAT traversal via UPnP and NAT-PMP.
+ *
+ * Requests port forwarding from the router so that inbound connections
+ * from the internet can reach the seller's signaling port. This is
+ * transparent to the caller — just call `mapPorts()` after binding
+ * and `cleanup()` on shutdown.
+ */
+export class NatTraversal {
+    _nat = null;
+    _mappings = [];
+    _externalIp = null;
+    _destroyed = false;
+    /**
+     * Attempt to map the given ports via UPnP/NAT-PMP.
+     *
+     * @param ports - Array of { port, protocol } to map.
+     * @param timeoutMs - How long to wait before giving up (default 10s).
+     * @returns Result indicating success and discovered external IP.
+     */
+    async mapPorts(ports, timeoutMs = 10_000) {
+        this._nat = new NatAPI({
+            enablePMP: true,
+            enableUPNP: true,
+            description: "Antseed P2P",
+            ttl: 7200,
+        });
+        const result = {
+            success: false,
+            externalIp: null,
+            mappings: [],
+        };
+        // Race against timeout
+        try {
+            await Promise.race([
+                this._doMapping(ports, result),
+                rejectAfter(timeoutMs, "NAT traversal timed out"),
+            ]);
+        }
+        catch (err) {
+            // Timeout or error — return partial result
+            const msg = err instanceof Error ? err.message : String(err);
+            debugWarn(`[NAT] ${msg}`);
+        }
+        this._mappings = result.mappings;
+        this._externalIp = result.externalIp;
+        result.success = result.mappings.length > 0;
+        return result;
+    }
+    async _doMapping(ports, result) {
+        if (!this._nat)
+            return;
+        // Try to get external IP first
+        try {
+            const ip = await this._nat.externalIp();
+            if (ip) {
+                result.externalIp = ip;
+                debugLog(`[NAT] External IP: ${ip}`);
+            }
+        }
+        catch {
+            debugWarn("[NAT] Could not determine external IP");
+        }
+        // Map each port
+        for (const { port, protocol } of ports) {
+            try {
+                const mapped = await this._nat.map({
+                    publicPort: port,
+                    privatePort: port,
+                    protocol,
+                    description: `Antseed ${protocol}`,
+                });
+                if (mapped) {
+                    const mapping = {
+                        internalPort: port,
+                        externalPort: port,
+                        externalIp: result.externalIp ?? "",
+                        protocol,
+                    };
+                    result.mappings.push(mapping);
+                    debugLog(`[NAT] Mapped ${protocol} port ${port}`);
+                }
+                else {
+                    debugWarn(`[NAT] Failed to map ${protocol} port ${port}`);
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                debugWarn(`[NAT] Error mapping ${protocol} port ${port}: ${msg}`);
+            }
+        }
+    }
+    /** The external IP discovered during mapping, if any. */
+    get externalIp() {
+        return this._externalIp;
+    }
+    /** All active port mappings. */
+    get mappings() {
+        return this._mappings;
+    }
+    /** Remove all port mappings and clean up. */
+    async cleanup() {
+        if (this._destroyed || !this._nat)
+            return;
+        this._destroyed = true;
+        for (const m of this._mappings) {
+            try {
+                await this._nat.unmap({
+                    publicPort: m.externalPort,
+                    privatePort: m.internalPort,
+                    protocol: m.protocol,
+                });
+            }
+            catch {
+                // Best-effort cleanup
+            }
+        }
+        try {
+            await this._nat.destroy();
+        }
+        catch {
+            // Best-effort cleanup
+        }
+        this._mappings = [];
+        this._nat = null;
+    }
+}
+function rejectAfter(ms, message) {
+    return new Promise((_, reject) => {
+        setTimeout(() => reject(new Error(message)), ms);
+    });
+}
+//# sourceMappingURL=nat-traversal.js.map

package/dist/p2p/nat-traversal.js.map

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

package/dist/p2p/payment-codec.d.ts

@@ -0,0 +1,20 @@
+import type { SessionLockAuthPayload, SessionLockConfirmPayload, SessionLockRejectPayload, SellerReceiptPayload, BuyerAckPayload, SessionEndPayload, TopUpRequestPayload, TopUpAuthPayload, DisputeNotifyPayload } from '../types/protocol.js';
+export declare function encodeSessionLockAuth(payload: SessionLockAuthPayload): Uint8Array;
+export declare function encodeSessionLockConfirm(payload: SessionLockConfirmPayload): Uint8Array;
+export declare function encodeSessionLockReject(payload: SessionLockRejectPayload): Uint8Array;
+export declare function encodeSellerReceipt(payload: SellerReceiptPayload): Uint8Array;
+export declare function encodeBuyerAck(payload: BuyerAckPayload): Uint8Array;
+export declare function encodeSessionEnd(payload: SessionEndPayload): Uint8Array;
+export declare function encodeTopUpRequest(payload: TopUpRequestPayload): Uint8Array;
+export declare function encodeTopUpAuth(payload: TopUpAuthPayload): Uint8Array;
+export declare function encodeDisputeNotify(payload: DisputeNotifyPayload): Uint8Array;
+export declare function decodeSessionLockAuth(data: Uint8Array): SessionLockAuthPayload;
+export declare function decodeSessionLockConfirm(data: Uint8Array): SessionLockConfirmPayload;
+export declare function decodeSessionLockReject(data: Uint8Array): SessionLockRejectPayload;
+export declare function decodeSellerReceipt(data: Uint8Array): SellerReceiptPayload;
+export declare function decodeBuyerAck(data: Uint8Array): BuyerAckPayload;
+export declare function decodeSessionEnd(data: Uint8Array): SessionEndPayload;
+export declare function decodeTopUpRequest(data: Uint8Array): TopUpRequestPayload;
+export declare function decodeTopUpAuth(data: Uint8Array): TopUpAuthPayload;
+export declare function decodeDisputeNotify(data: Uint8Array): DisputeNotifyPayload;
+//# sourceMappingURL=payment-codec.d.ts.map

package/dist/p2p/payment-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-codec.d.ts","sourceRoot":"","sources":["../../src/p2p/payment-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAiC9B,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,UAAU,CAEjF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,UAAU,CAEvF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,UAAU,CAErF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAE7E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,UAAU,CAEnE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,UAAU,CAE3E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAErE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAE7E;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,sBAAsB,CAO9E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,yBAAyB,CAMpF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,wBAAwB,CAMlF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CAS1E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAQhE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CASpE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAQxE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAOlE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CAO1E"}

package/dist/p2p/payment-codec.js

@@ -0,0 +1,130 @@
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+// --- Validation helpers ---
+function parseJson(data) {
+    const raw = JSON.parse(decoder.decode(data));
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new Error('Expected JSON object');
+    }
+    return raw;
+}
+function requireString(obj, field) {
+    const val = obj[field];
+    if (typeof val !== 'string' || val.length === 0) {
+        throw new Error(`Missing or invalid string field: ${field}`);
+    }
+    return val;
+}
+function requireNumber(obj, field) {
+    const val = obj[field];
+    if (typeof val !== 'number' || !Number.isFinite(val)) {
+        throw new Error(`Missing or invalid number field: ${field}`);
+    }
+    return val;
+}
+// --- Encoders ---
+export function encodeSessionLockAuth(payload) {
+    return encoder.encode(JSON.stringify(payload));
+}
+export function encodeSessionLockConfirm(payload) {
+    return encoder.encode(JSON.stringify(payload));
+}
+export function encodeSessionLockReject(payload) {
+    return encoder.encode(JSON.stringify(payload));
+}
+export function encodeSellerReceipt(payload) {
+    return encoder.encode(JSON.stringify(payload));
+}
+export function encodeBuyerAck(payload) {
+    return encoder.encode(JSON.stringify(payload));
+}
+export function encodeSessionEnd(payload) {
+    return encoder.encode(JSON.stringify(payload));
+}
+export function encodeTopUpRequest(payload) {
+    return encoder.encode(JSON.stringify(payload));
+}
+export function encodeTopUpAuth(payload) {
+    return encoder.encode(JSON.stringify(payload));
+}
+export function encodeDisputeNotify(payload) {
+    return encoder.encode(JSON.stringify(payload));
+}
+// --- Decoders (with runtime validation) ---
+export function decodeSessionLockAuth(data) {
+    const obj = parseJson(data);
+    return {
+        sessionId: requireString(obj, 'sessionId'),
+        lockedAmount: requireString(obj, 'lockedAmount'),
+        buyerSig: requireString(obj, 'buyerSig'),
+    };
+}
+export function decodeSessionLockConfirm(data) {
+    const obj = parseJson(data);
+    return {
+        sessionId: requireString(obj, 'sessionId'),
+        txSignature: requireString(obj, 'txSignature'),
+    };
+}
+export function decodeSessionLockReject(data) {
+    const obj = parseJson(data);
+    return {
+        sessionId: requireString(obj, 'sessionId'),
+        reason: requireString(obj, 'reason'),
+    };
+}
+export function decodeSellerReceipt(data) {
+    const obj = parseJson(data);
+    return {
+        sessionId: requireString(obj, 'sessionId'),
+        runningTotal: requireString(obj, 'runningTotal'),
+        requestCount: requireNumber(obj, 'requestCount'),
+        responseHash: requireString(obj, 'responseHash'),
+        sellerSig: requireString(obj, 'sellerSig'),
+    };
+}
+export function decodeBuyerAck(data) {
+    const obj = parseJson(data);
+    return {
+        sessionId: requireString(obj, 'sessionId'),
+        runningTotal: requireString(obj, 'runningTotal'),
+        requestCount: requireNumber(obj, 'requestCount'),
+        buyerSig: requireString(obj, 'buyerSig'),
+    };
+}
+export function decodeSessionEnd(data) {
+    const obj = parseJson(data);
+    return {
+        sessionId: requireString(obj, 'sessionId'),
+        runningTotal: requireString(obj, 'runningTotal'),
+        requestCount: requireNumber(obj, 'requestCount'),
+        score: requireNumber(obj, 'score'),
+        buyerSig: requireString(obj, 'buyerSig'),
+    };
+}
+export function decodeTopUpRequest(data) {
+    const obj = parseJson(data);
+    return {
+        sessionId: requireString(obj, 'sessionId'),
+        additionalAmount: requireString(obj, 'additionalAmount'),
+        currentRunningTotal: requireString(obj, 'currentRunningTotal'),
+        currentLockedAmount: requireString(obj, 'currentLockedAmount'),
+    };
+}
+export function decodeTopUpAuth(data) {
+    const obj = parseJson(data);
+    return {
+        sessionId: requireString(obj, 'sessionId'),
+        additionalAmount: requireString(obj, 'additionalAmount'),
+        buyerSig: requireString(obj, 'buyerSig'),
+    };
+}
+export function decodeDisputeNotify(data) {
+    const obj = parseJson(data);
+    return {
+        sessionId: requireString(obj, 'sessionId'),
+        reason: requireString(obj, 'reason'),
+        txSignature: requireString(obj, 'txSignature'),
+    };
+}
+//# sourceMappingURL=payment-codec.js.map

package/dist/p2p/payment-codec.js.map

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

package/dist/p2p/payment-mux.d.ts

@@ -0,0 +1,49 @@
+import type { PeerConnection } from './connection-manager.js';
+import type { SessionLockAuthPayload, SessionLockConfirmPayload, SessionLockRejectPayload, SellerReceiptPayload, BuyerAckPayload, SessionEndPayload, TopUpRequestPayload, TopUpAuthPayload, DisputeNotifyPayload } from '../types/protocol.js';
+import type { FramedMessage } from '../types/protocol.js';
+export type PaymentMessageHandler<T> = (payload: T) => void | Promise<void>;
+/**
+ * Multiplexes bilateral payment messages over a PeerConnection.
+ * Register handlers for each message type, then call handleFrame()
+ * when a payment-range frame arrives.
+ */
+export declare class PaymentMux {
+    private _connection;
+    private _messageIdCounter;
+    private _onSessionLockAuth?;
+    private _onSessionLockConfirm?;
+    private _onSessionLockReject?;
+    private _onSellerReceipt?;
+    private _onBuyerAck?;
+    private _onSessionEnd?;
+    private _onTopUpRequest?;
+    private _onTopUpAuth?;
+    private _onDisputeNotify?;
+    constructor(connection: PeerConnection);
+    onSessionLockAuth(handler: PaymentMessageHandler<SessionLockAuthPayload>): void;
+    onSessionLockConfirm(handler: PaymentMessageHandler<SessionLockConfirmPayload>): void;
+    onSessionLockReject(handler: PaymentMessageHandler<SessionLockRejectPayload>): void;
+    onSellerReceipt(handler: PaymentMessageHandler<SellerReceiptPayload>): void;
+    onBuyerAck(handler: PaymentMessageHandler<BuyerAckPayload>): void;
+    onSessionEnd(handler: PaymentMessageHandler<SessionEndPayload>): void;
+    onTopUpRequest(handler: PaymentMessageHandler<TopUpRequestPayload>): void;
+    onTopUpAuth(handler: PaymentMessageHandler<TopUpAuthPayload>): void;
+    onDisputeNotify(handler: PaymentMessageHandler<DisputeNotifyPayload>): void;
+    sendSessionLockAuth(payload: SessionLockAuthPayload): void;
+    sendSessionLockConfirm(payload: SessionLockConfirmPayload): void;
+    sendSessionLockReject(payload: SessionLockRejectPayload): void;
+    sendSellerReceipt(payload: SellerReceiptPayload): void;
+    sendBuyerAck(payload: BuyerAckPayload): void;
+    sendSessionEnd(payload: SessionEndPayload): void;
+    sendTopUpRequest(payload: TopUpRequestPayload): void;
+    sendTopUpAuth(payload: TopUpAuthPayload): void;
+    sendDisputeNotify(payload: DisputeNotifyPayload): void;
+    /**
+     * Returns true if this frame is a payment message and was handled.
+     */
+    handleFrame(frame: FramedMessage): Promise<boolean>;
+    /** Check if a message type is in the payment range (0x50-0x5F). */
+    static isPaymentMessage(type: number): boolean;
+    private _send;
+}
+//# sourceMappingURL=payment-mux.d.ts.map

package/dist/p2p/payment-mux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-mux.d.ts","sourceRoot":"","sources":["../../src/p2p/payment-mux.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5E;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,iBAAiB,CAAK;IAG9B,OAAO,CAAC,kBAAkB,CAAC,CAAgD;IAC3E,OAAO,CAAC,qBAAqB,CAAC,CAAmD;IACjF,OAAO,CAAC,oBAAoB,CAAC,CAAkD;IAC/E,OAAO,CAAC,gBAAgB,CAAC,CAA8C;IACvE,OAAO,CAAC,WAAW,CAAC,CAAyC;IAC7D,OAAO,CAAC,aAAa,CAAC,CAA2C;IACjE,OAAO,CAAC,eAAe,CAAC,CAA6C;IACrE,OAAO,CAAC,YAAY,CAAC,CAA0C;IAC/D,OAAO,CAAC,gBAAgB,CAAC,CAA8C;gBAE3D,UAAU,EAAE,cAAc;IAKtC,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAG/E,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,CAAC,yBAAyB,CAAC,GAAG,IAAI;IAGrF,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,CAAC,wBAAwB,CAAC,GAAG,IAAI;IAGnF,eAAe,CAAC,OAAO,EAAE,qBAAqB,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAG3E,UAAU,CAAC,OAAO,EAAE,qBAAqB,CAAC,eAAe,CAAC,GAAG,IAAI;IAGjE,YAAY,CAAC,OAAO,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAGrE,cAAc,CAAC,OAAO,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAGzE,WAAW,CAAC,OAAO,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAGnE,eAAe,CAAC,OAAO,EAAE,qBAAqB,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAK3E,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAG1D,sBAAsB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI;IAGhE,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAG9D,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAGtD,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAG5C,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAGhD,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAGpD,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAG9C,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAKtD;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCzD,mEAAmE;IACnE,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9C,OAAO,CAAC,KAAK;CAQd"}