Node.js / Bun SDK

The Node SDK (@tunnet/sdk) embeds Tunnet mesh networking in Node.js or Bun apps. It exposes a TypeScript API with native performance.

Installation

bun add @tunnet/sdk

Quick start

import { TunnetNode } from "@tunnet/sdk";

const node = await TunnetNode.create({
  controlUrl: "http://control:8080",
  stateDir: "/tmp/tunnet-sdk",
});

// List peers on the mesh
const peers = await node.listPeers();
console.log("Peers:", peers);

// Open a stream to a peer
const stream = await node.openStream("api-server", 8080);
await stream.write(new TextEncoder().encode("GET / HTTP/1.1\r\nHost: api-server\r\n\r\n"));
const response = await stream.read();
console.log(new TextDecoder().decode(response));
await stream.end();

// Send a file
await node.sendFile("./data.csv", "db-server", "daily export");

await node.close();

Next steps

• TunnetNode - create a node, list peers, open streams
• Streams & Fetch - duplex I/O and HTTP over the mesh
• File Transfer - send and receive files