@reticulum/node

Node.js-only Reticulum interfaces and the interface registry, as a companion to the zero-dependency, browser-safe @reticulum/core core.

Why this package exists

The @reticulum/core core must stay browser-safe (no node: specifiers, no external runtime dependencies). Several interfaces — TCP, the zero-config IPv6-multicast AutoInterface, the local shared-instance client, and the HTTP POST exchange server — are built on Node.js built-in modules (node:net, node:dgram, node:http, node:crypto, node:fs, node:os, node:path). They live here, in this companion, so importing @reticulum/core in a browser never pulls in Node builtins.

Installation

npm install @reticulum/node
Copy

This depends on @reticulum/core automatically.

Usage

Import the interface you need from the package entry:

import { Reticulum } from "@reticulum/core";
import {
  AutoInterface,
  LocalClientInterface,
  TCPClientInterface,
} from "@reticulum/node";

const rns = new Reticulum();

// Attach to a running shared `rnsd` if one is available, else dial TCP directly.
const shared = await LocalClientInterface.connectToSharedInstance();
if (shared) {
  rns.addInterface(shared, true);
} else {
  const tcp = new TCPClientInterface({ host: "127.0.0.1", port: 42424 });
  await tcp.connect();
  rns.addInterface(tcp, true);
}
Copy

What's included

Interface registry

The registry aggregates every built-in interface — including the browser-safe ones from @reticulum/core — so a Node process can enumerate interfaces and look up their configuration schemas by id:

import {
  getInterface,
  getSchema,
  listInterfaces,
  registerInterface,
} from "@reticulum/node";

for (const meta of listInterfaces()) {
  console.log(meta.id, meta.title);
}
Copy

License

Licensed under the EUPL 1.2. See the monorepo README for project-wide information.