Simple network programming on top of Tailscale.

// Bob listens
const server = mesh.net.createServer((socket) => {
  socket.on('data', (chunk) => {
    socket.write(Buffer.from('echo: ' + chunk.toString()));
  });
});
server.listen(7000);

// Alice dials a Peer handle
const bob = await mesh.peer('bob-laptop', { waitMs: 5000 });
if (!bob) throw new Error('bob not found');
const socket = mesh.net.connect({ peer: bob, port: 7000 });
socket.write('hello over private TCP');

// Namespaced messaging
mesh.onMessage('chat', async (msg) => {
  if (typeof msg.from === 'string') return;
  console.log(msg.from.displayName, msg.payload);
  await msg.from.sendJson('chat', { text: 'ack' });
});

// File transfer (PeerLike)
const ft = mesh.fileTransfer();
ft.onOffer((offer, responder) => {
  responder.accept('/tmp/' + offer.fileName);
});
const peer = (await mesh.getPeers())[0];
if (peer) await ft.sendFile(peer, './report.pdf', '/tmp/report.pdf');

// Device-owned state
const presence = mesh.syncedStore('presence');
await presence.set({ status: 'editing', file: 'notes.md' });

// Expose a local Vite/API process
const h = await mesh.serve({
  port: 443,
  target: 'http://localhost:3000',
});
console.log(h.url); // https://myapp.tail1234.ts.net

// Or a static SPA + API under one origin
await mesh.serve({
  port: 443,
  routes: {
    '/api': 'http://localhost:8000',
    '/': { dir: './public', fallback: '/index.html' },
  },
});

pnpm add @vibecook/truffle
pnpm add ws   # optional — only for mesh.ws

import { createMeshNode } from '@vibecook/truffle';

const mesh = await createMeshNode({
  appId: 'field-tools',
  deviceName: 'alice-laptop',
  onAuthRequired: (url) => console.log('Auth URL:', url),
});

console.log(mesh.getLocalInfo());
for (const p of await mesh.getPeers()) {
  console.log(p.displayName, p.online ? 'online' : 'offline');
}

mesh.onMessage('chat', async (msg) => {
  if (typeof msg.from === 'string') return; // not interned yet
  console.log(msg.from.displayName, msg.payload);
  await msg.from.sendJson('chat', { text: 'ack' });
});

const bob = await mesh.peer('bob-laptop', { waitMs: 5000 });
if (bob) await bob.sendJson('chat', { text: 'hello' });