@meshwhisper/sdk 0.1.0

package/dist/transport/node/index.js

@@ -0,0 +1,209 @@
+// ============================================================
+// MeshWhisper SDK — Node Transport
+// Connects the SDK to a MeshWhisper Node (relay + directory).
+// All traffic flows through the Node WebSocket endpoint; the
+// Node routes packets by destination hash and buffers blobs
+// for offline recipients.
+// ============================================================
+import { WebSocket } from 'ws';
+import { serializePacket, deserializePacket, HEADER_SIZE, } from '../websocket/serialize.js';
+// ---- Constants ----
+/** Foundation-hosted relay nodes. Used when node config is "mesh". */
+export const FOUNDATION_RELAY_NODES = [
+    'wss://relay.meshwhisper.io', // TODO: deploy actual Foundation nodes
+];
+const RECONNECT_BASE_MS = 1_000;
+const RECONNECT_MAX_MS = 30_000;
+// ---- NodeTransport ----
+/**
+ * Transport that connects to a MeshWhisper Node for relay and
+ * store-and-forward delivery.
+ *
+ * Sends a `hello` control message on connect to register the device's
+ * current destination hashes. The Node then routes incoming packets
+ * to the registered hashes and delivers any queued blobs.
+ *
+ * All outbound packets are forwarded to the Node regardless of the
+ * `destination` argument — the packet's destHash header field is what
+ * the Node uses for routing.
+ */
+export class NodeTransport {
+    nodeUrl;
+    getDestHashes;
+    pushConfig;
+    type = 'internet';
+    ws = null;
+    receiveCallbacks = [];
+    running = false;
+    reconnectAttempt = 0;
+    reconnectTimer = null;
+    /**
+     * @param nodeUrl - The WebSocket URL of the Node, or "mesh" for Foundation nodes.
+     * @param getDestHashes - Callback returning the device's current dest hashes
+     *   as hex strings. Called on every (re)connect so the Node always has
+     *   up-to-date hashes.
+     * @param pushConfig - Optional push token to register with the Node so it can
+     *   wake the device via APNs/FCM when a message arrives while offline.
+     */
+    constructor(nodeUrl, getDestHashes, pushConfig) {
+        this.nodeUrl = nodeUrl;
+        this.getDestHashes = getDestHashes;
+        this.pushConfig = pushConfig;
+    }
+    // ---- Transport interface ----
+    async start() {
+        this.running = true;
+        await this.connect();
+    }
+    async stop() {
+        this.running = false;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close(1000, 'shutdown');
+            this.ws = null;
+        }
+    }
+    async isAvailable() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    async send(packet, _destination) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error('NodeTransport: not connected to Node');
+        }
+        const binary = serializePacket(packet);
+        return new Promise((resolve, reject) => {
+            this.ws.send(binary, { binary: true }, (err) => {
+                if (err)
+                    reject(new Error(`NodeTransport send failed: ${err.message}`));
+                else
+                    resolve();
+            });
+        });
+    }
+    onReceive(callback) {
+        this.receiveCallbacks.push(callback);
+    }
+    // ---- Connection management ----
+    resolveUrl() {
+        if (this.nodeUrl === 'mesh') {
+            return FOUNDATION_RELAY_NODES[0];
+        }
+        return this.nodeUrl;
+    }
+    connect() {
+        const url = this.resolveUrl();
+        return new Promise((resolve, reject) => {
+            let resolved = false;
+            const ws = new WebSocket(url);
+            ws.binaryType = 'arraybuffer';
+            ws.on('open', () => {
+                this.ws = ws;
+                this.reconnectAttempt = 0;
+                resolved = true;
+                // Register dest hashes (and optional push token) with the Node
+                ws.send(JSON.stringify(this.buildHello()));
+                resolve();
+            });
+            ws.on('message', (raw) => {
+                this.handleMessage(raw);
+            });
+            ws.on('close', () => {
+                this.ws = null;
+                if (this.running)
+                    this.scheduleReconnect();
+            });
+            ws.on('error', (err) => {
+                if (!resolved) {
+                    resolved = true;
+                    reject(new Error(`NodeTransport: failed to connect to ${url}: ${err.message}`));
+                }
+            });
+        });
+    }
+    scheduleReconnect() {
+        if (!this.running)
+            return;
+        const delay = Math.min(RECONNECT_BASE_MS * Math.pow(2, this.reconnectAttempt), RECONNECT_MAX_MS);
+        this.reconnectAttempt++;
+        this.reconnectTimer = setTimeout(async () => {
+            if (!this.running)
+                return;
+            try {
+                await this.connect();
+            }
+            catch {
+                this.scheduleReconnect();
+            }
+        }, delay);
+    }
+    // ---- Message handling ----
+    handleMessage(raw) {
+        // Binary messages are relay packets
+        if (raw instanceof ArrayBuffer && raw.byteLength >= HEADER_SIZE) {
+            try {
+                const packet = deserializePacket(new Uint8Array(raw));
+                const source = this.resolveUrl();
+                for (const cb of this.receiveCallbacks) {
+                    try {
+                        cb(packet, source);
+                    }
+                    catch { /* swallow */ }
+                }
+            }
+            catch {
+                // Malformed packet — discard
+            }
+            return;
+        }
+        // JSON messages from the Node (informational; no action needed in v1)
+        if (typeof raw === 'string' || raw instanceof Buffer) {
+            try {
+                JSON.parse(raw.toString());
+                // Reserved for future Node→client control messages
+            }
+            catch { /* not JSON */ }
+        }
+    }
+    // ---- Dest hash refresh ----
+    /**
+     * Re-registers the device's destination hashes with the Node.
+     * Call this when the epoch hour rolls over and hashes rotate.
+     */
+    refreshDestHashes() {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN)
+            return;
+        this.ws.send(JSON.stringify(this.buildHello()));
+    }
+    /**
+     * Update the push token (e.g. after APNs/FCM issues a new token).
+     * Re-registers with the Node immediately if connected.
+     */
+    setPushConfig(pushConfig) {
+        this.pushConfig = pushConfig;
+        this.refreshDestHashes();
+    }
+    // ---- Private helpers ----
+    buildHello() {
+        const msg = {
+            type: 'hello',
+            destHashes: this.getDestHashes(),
+        };
+        if (this.pushConfig) {
+            msg['pushPlatform'] = this.pushConfig.platform;
+            if (this.pushConfig.platform === 'webpush') {
+                msg['pushSubscription'] = JSON.stringify(this.pushConfig.subscription);
+            }
+            else {
+                msg['pushToken'] = this.pushConfig.token;
+                if (this.pushConfig.platform === 'apns' && this.pushConfig.topic) {
+                    msg['pushTopic'] = this.pushConfig.topic;
+                }
+            }
+        }
+        return msg;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/transport/node/index.js.map

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

package/dist/transport/noop/index.d.ts

@@ -0,0 +1,11 @@
+import type { Transport, Packet, BearerType } from '../../types.js';
+export declare class NoOpTransport implements Transport {
+    readonly type: BearerType;
+    constructor(type: BearerType);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isAvailable(): Promise<boolean>;
+    send(_packet: Packet, _destination: string): Promise<void>;
+    onReceive(_callback: (packet: Packet, source: string) => void): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/noop/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/noop/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEpE,qBAAa,aAAc,YAAW,SAAS;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU;gBAAhB,IAAI,EAAE,UAAU;IAE/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IACrB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAE/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,SAAS,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CACrE"}

package/dist/transport/noop/index.js

@@ -0,0 +1,20 @@
+// ============================================================
+// MeshWhisper SDK — No-Op Transport
+// Satisfies the Transport interface but does nothing.
+// Used as a placeholder for transports that are unavailable
+// in the current environment (e.g. LocalTransport in a browser).
+// ============================================================
+export class NoOpTransport {
+    type;
+    constructor(type) {
+        this.type = type;
+    }
+    async start() { }
+    async stop() { }
+    async isAvailable() { return false; }
+    async send(_packet, _destination) {
+        throw new Error(`NoOpTransport(${this.type}): not available in this environment`);
+    }
+    onReceive(_callback) { }
+}
+//# sourceMappingURL=index.js.map

package/dist/transport/noop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/noop/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oCAAoC;AACpC,sDAAsD;AACtD,4DAA4D;AAC5D,iEAAiE;AACjE,+DAA+D;AAI/D,MAAM,OAAO,aAAa;IACH;IAArB,YAAqB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEzC,KAAK,CAAC,KAAK,KAAmB,CAAC;IAC/B,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,CAAC,WAAW,KAAuB,OAAO,KAAK,CAAC,CAAC,CAAC;IAEvD,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,YAAoB;QAC9C,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,IAAI,sCAAsC,CAAC,CAAC;IACpF,CAAC;IAED,SAAS,CAAC,SAAmD,IAAS,CAAC;CACxE"}

package/dist/transport/p2p/index.d.ts

@@ -0,0 +1,109 @@
+import type { Packet, Transport } from '../../types.js';
+/**
+ * Metadata about a discovered P2P peer.
+ * Provided by the native layer during discovery.
+ */
+export interface PeerInfo {
+    /** Human-readable name for the peer device. */
+    displayName: string;
+    /** The service identifier under which this peer was discovered. */
+    serviceId: string;
+    /** Advertised capabilities (e.g. "relay", "store-forward"). */
+    capabilities: string[];
+}
+/**
+ * Abstract interface that native platform code (Swift / Kotlin)
+ * must implement to provide P2P connectivity to the TypeScript SDK.
+ *
+ * - iOS: backed by Apple Multipeer Connectivity Framework
+ *        (BLE discovery + Wi-Fi Direct data transfer).
+ * - Android: backed by Google Nearby Connections API
+ *            (Bluetooth + Wi-Fi).
+ *
+ * All methods are designed to be thin wrappers around the native
+ * APIs so the bridge implementation stays minimal.
+ */
+export interface PlatformP2PBridge {
+    /** Begin advertising this device for the given service. */
+    startAdvertising(serviceId: string): Promise<void>;
+    /** Begin scanning for peers advertising the given service. */
+    startDiscovery(serviceId: string): Promise<void>;
+    /** Stop advertising. */
+    stopAdvertising(): Promise<void>;
+    /** Stop discovery scanning. */
+    stopDiscovery(): Promise<void>;
+    /** Send raw bytes to a connected peer. */
+    sendData(peerId: string, data: Uint8Array): Promise<void>;
+    /** Register a callback invoked when a new peer is discovered. */
+    onPeerDiscovered(callback: (peerId: string, info: PeerInfo) => void): void;
+    /** Register a callback invoked when a previously discovered peer is lost. */
+    onPeerLost(callback: (peerId: string) => void): void;
+    /** Register a callback invoked when data is received from a peer. */
+    onDataReceived(callback: (peerId: string, data: Uint8Array) => void): void;
+    /** Returns the IDs of all currently connected peers. */
+    getConnectedPeers(): string[];
+    /**
+     * Returns true if the underlying native P2P framework is
+     * available on this device / OS version.
+     */
+    isSupported(): boolean;
+}
+/**
+ * Registers a platform-specific P2P bridge implementation.
+ *
+ * Called by native code (via JSI on React Native, or similar
+ * interop layers) to inject the real Multipeer / Nearby
+ * Connections wrapper at runtime.
+ *
+ * @param bridge - The native bridge implementation.
+ */
+export declare function registerPlatformBridge(bridge: PlatformP2PBridge): void;
+/**
+ * Generates a platform-appropriate service identifier from an
+ * application namespace string.
+ *
+ * Both Apple Multipeer Connectivity and Android NSD impose
+ * restrictions on service type identifiers (length, allowed
+ * characters).  This function produces a short, deterministic,
+ * lowercase-alphanumeric ID derived from the namespace.
+ *
+ * @param namespace - The application namespace (e.g. "com.example.chat").
+ * @returns A service ID string safe for both iOS and Android.
+ */
+export declare function generateServiceId(namespace: string): string;
+/**
+ * PlatformP2PTransport adapts a PlatformP2PBridge into the
+ * SDK's Transport interface.
+ *
+ * When a native bridge has been registered via
+ * `registerPlatformBridge()`, this transport serializes Packets
+ * to wire bytes, sends them through the bridge, and
+ * deserializes incoming bytes back into Packets for the mesh
+ * router.
+ *
+ * When no bridge is registered, the transport reports itself
+ * as unavailable and all operations are safe no-ops.
+ */
+export declare class PlatformP2PTransport implements Transport {
+    readonly type: "platform_p2p";
+    private readonly serviceId;
+    private receiveCallback;
+    private running;
+    /**
+     * @param namespace - Application namespace used to derive
+     *   the P2P service identifier.
+     */
+    constructor(namespace: string);
+    /**
+     * Returns the bridge currently in use.  Reads from the
+     * module-level registry so that bridges registered after
+     * construction are picked up automatically.
+     */
+    private get bridge();
+    isAvailable(): Promise<boolean>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(packet: Packet, destination: string): Promise<void>;
+    onReceive(callback: (packet: Packet, source: string) => void): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/p2p/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/p2p/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAe,MAAM,gBAAgB,CAAC;AAIrE;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,8DAA8D;IAC9D,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,wBAAwB;IACxB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC,+BAA+B;IAC/B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D,iEAAiE;IACjE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3E,6EAA6E;IAC7E,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAErD,qEAAqE;IACrE,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3E,wDAAwD;IACxD,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAE9B;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC;CACxB;AA4ID;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAEtE;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAY3D;AAID;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAqB,YAAW,SAAS;IACpD,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IAExC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,eAAe,CAA2D;IAClF,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,SAAS,EAAE,MAAM;IAI7B;;;;OAIG;IACH,OAAO,KAAK,MAAM,GAEjB;IAIK,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAGpE"}

package/dist/transport/p2p/index.js

@@ -0,0 +1,237 @@
+// ============================================================
+// MeshWhisper SDK — Platform P2P Transport
+// Abstract bridge for native P2P (Apple Multipeer Connectivity,
+// Google Nearby Connections) with TypeScript-side Transport
+// wrapper.  Native SDKs implement PlatformP2PBridge; this module
+// provides the Transport adapter and a no-op fallback for
+// environments where native P2P is unavailable.
+// ============================================================
+// ---- Packet Serialization ----
+/**
+ * Minimum header size in bytes:
+ *   version (1) + flags (1) + destHash (8) + senderEphemeralId (16)
+ *   + ttl (1) + payloadLength (4) = 31
+ */
+const HEADER_SIZE = 31;
+/**
+ * Serializes a Packet into a compact binary format for transmission
+ * over the native P2P bridge.
+ *
+ * Wire format (big-endian):
+ *   [0]      u8   version
+ *   [1]      u8   flags
+ *   [2..9]   8B   destHash
+ *   [10..25] 16B  senderEphemeralId
+ *   [26]     u8   ttl
+ *   [27..30] u32  payloadLength
+ *   [31..]   var  encryptedPayload
+ */
+function serializePacket(packet) {
+    const totalLength = HEADER_SIZE + packet.encryptedPayload.length;
+    const buffer = new Uint8Array(totalLength);
+    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    let offset = 0;
+    // version (u8)
+    view.setUint8(offset, packet.version);
+    offset += 1;
+    // flags (u8)
+    view.setUint8(offset, packet.flags);
+    offset += 1;
+    // destHash (8 bytes)
+    buffer.set(packet.destHash, offset);
+    offset += 8;
+    // senderEphemeralId (16 bytes)
+    buffer.set(packet.senderEphemeralId, offset);
+    offset += 16;
+    // ttl (u8)
+    view.setUint8(offset, packet.ttl);
+    offset += 1;
+    // payloadLength (u32 big-endian)
+    view.setUint32(offset, packet.payloadLength, false);
+    offset += 4;
+    // encryptedPayload
+    buffer.set(packet.encryptedPayload, offset);
+    return buffer;
+}
+/**
+ * Deserializes a Uint8Array back into a Packet.
+ * Throws if the data is too short or the payload length mismatches.
+ */
+function deserializePacket(data) {
+    if (data.length < HEADER_SIZE) {
+        throw new Error(`P2P: packet too short (${data.length} bytes, need at least ${HEADER_SIZE})`);
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    let offset = 0;
+    const version = view.getUint8(offset);
+    offset += 1;
+    const flags = view.getUint8(offset);
+    offset += 1;
+    const destHash = data.slice(offset, offset + 8);
+    offset += 8;
+    const senderEphemeralId = data.slice(offset, offset + 16);
+    offset += 16;
+    const ttl = view.getUint8(offset);
+    offset += 1;
+    const payloadLength = view.getUint32(offset, false);
+    offset += 4;
+    const encryptedPayload = data.slice(offset, offset + payloadLength);
+    if (encryptedPayload.length !== payloadLength) {
+        throw new Error(`P2P: payload length mismatch (header says ${payloadLength}, got ${encryptedPayload.length})`);
+    }
+    return {
+        version,
+        flags,
+        destHash,
+        senderEphemeralId,
+        ttl,
+        payloadLength,
+        encryptedPayload,
+    };
+}
+// ---- No-Op Bridge ----
+/**
+ * Default bridge used when no native implementation is registered.
+ * All methods are safe no-ops.  isSupported() returns false so the
+ * transport layer knows to skip this bearer.
+ */
+class NoOpBridge {
+    async startAdvertising(_serviceId) { }
+    async startDiscovery(_serviceId) { }
+    async stopAdvertising() { }
+    async stopDiscovery() { }
+    async sendData(_peerId, _data) { }
+    onPeerDiscovered(_callback) { }
+    onPeerLost(_callback) { }
+    onDataReceived(_callback) { }
+    getConnectedPeers() {
+        return [];
+    }
+    isSupported() {
+        return false;
+    }
+}
+// ---- Bridge Registry ----
+/** The currently registered bridge (defaults to NoOpBridge). */
+let activeBridge = new NoOpBridge();
+/**
+ * Registers a platform-specific P2P bridge implementation.
+ *
+ * Called by native code (via JSI on React Native, or similar
+ * interop layers) to inject the real Multipeer / Nearby
+ * Connections wrapper at runtime.
+ *
+ * @param bridge - The native bridge implementation.
+ */
+export function registerPlatformBridge(bridge) {
+    activeBridge = bridge;
+}
+// ---- Service ID Generation ----
+/** Max length for Bonjour / NSD service types. */
+const MAX_SERVICE_ID_LENGTH = 15;
+/**
+ * Generates a platform-appropriate service identifier from an
+ * application namespace string.
+ *
+ * Both Apple Multipeer Connectivity and Android NSD impose
+ * restrictions on service type identifiers (length, allowed
+ * characters).  This function produces a short, deterministic,
+ * lowercase-alphanumeric ID derived from the namespace.
+ *
+ * @param namespace - The application namespace (e.g. "com.example.chat").
+ * @returns A service ID string safe for both iOS and Android.
+ */
+export function generateServiceId(namespace) {
+    // Simple FNV-1a 32-bit hash for determinism without heavy deps.
+    let h = 0x811c9dc5;
+    for (let i = 0; i < namespace.length; i++) {
+        h ^= namespace.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    // Unsigned conversion then base-36 for compact alphanumeric output.
+    const hashStr = (h >>> 0).toString(36);
+    // Prefix with "mw-" (MeshWhisper) for readability, truncate to limit.
+    const serviceId = `mw-${hashStr}`;
+    return serviceId.slice(0, MAX_SERVICE_ID_LENGTH);
+}
+// ---- Transport Implementation ----
+/**
+ * PlatformP2PTransport adapts a PlatformP2PBridge into the
+ * SDK's Transport interface.
+ *
+ * When a native bridge has been registered via
+ * `registerPlatformBridge()`, this transport serializes Packets
+ * to wire bytes, sends them through the bridge, and
+ * deserializes incoming bytes back into Packets for the mesh
+ * router.
+ *
+ * When no bridge is registered, the transport reports itself
+ * as unavailable and all operations are safe no-ops.
+ */
+export class PlatformP2PTransport {
+    type = 'platform_p2p';
+    serviceId;
+    receiveCallback = null;
+    running = false;
+    /**
+     * @param namespace - Application namespace used to derive
+     *   the P2P service identifier.
+     */
+    constructor(namespace) {
+        this.serviceId = generateServiceId(namespace);
+    }
+    /**
+     * Returns the bridge currently in use.  Reads from the
+     * module-level registry so that bridges registered after
+     * construction are picked up automatically.
+     */
+    get bridge() {
+        return activeBridge;
+    }
+    // ---- Transport interface ----
+    async isAvailable() {
+        return this.bridge.isSupported();
+    }
+    async start() {
+        if (this.running)
+            return;
+        if (!this.bridge.isSupported()) {
+            // Silently skip — the transport negotiator will use
+            // the next bearer in priority order.
+            return;
+        }
+        // Wire up data reception.
+        this.bridge.onDataReceived((peerId, data) => {
+            if (!this.receiveCallback)
+                return;
+            try {
+                const packet = deserializePacket(data);
+                this.receiveCallback(packet, peerId);
+            }
+            catch {
+                // Malformed packet — drop silently.  A production build
+                // may want to emit a diagnostic event here.
+            }
+        });
+        await this.bridge.startAdvertising(this.serviceId);
+        await this.bridge.startDiscovery(this.serviceId);
+        this.running = true;
+    }
+    async stop() {
+        if (!this.running)
+            return;
+        await this.bridge.stopAdvertising();
+        await this.bridge.stopDiscovery();
+        this.running = false;
+    }
+    async send(packet, destination) {
+        if (!this.running || !this.bridge.isSupported())
+            return;
+        const data = serializePacket(packet);
+        await this.bridge.sendData(destination, data);
+    }
+    onReceive(callback) {
+        this.receiveCallback = callback;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/transport/p2p/index.js.map

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