Node.js Integration

npm install @crosslink/sdk-node

import { createCrosslinkServer } from "@crosslink/sdk-node";

const server = createCrosslinkServer({
  application: { id: "com.example.myapp", name: "My App", version: "1.0.0" },
  capabilities: [
    { id: "app.control", title: "Control the app", risk: "medium" }
  ],
  signalingUrl: "http://127.0.0.1:8081",
  relayUrl: "http://127.0.0.1:8082",
  lan: { bind: "loopback" }
});

server.expose("app.status", () => ({ ok: true }));
await server.start();

server.expose("math.add", (args) => {
  return { result: args.a + args.b };
});

server.expose("admin.shutdown", () => {
  process.exit(0);
}, { capability: "admin" });

server.expose("db.query", async (args) => {
  const result = await db.query(args.sql);
  return { rows: result.rows };
});

server.expose("file.read", async (args, { emitProgress }) => {
  const chunks = [];
  for await (const chunk of fs.createReadStream(args.path)) {
    emitProgress({ bytes: chunk.length });
    chunks.push(chunk);
  }
  return { content: Buffer.concat(chunks).toString("base64") };
}, { capability: "file.read" });

// Declare events
server.declareEvent("app.tick");
server.declareEvent("app.update");

// Emit events
setInterval(() => {
  server.emit("app.tick", { t: Date.now() });
}, 1000);

// List paired devices
const devices = server.listDevices();
console.log(`${devices.length} devices paired`);

// Revoke a specific device (kills its active session, blocks reconnection)
server.revokeDevice(deviceId);

// Revoke every paired device
server.revokeAllDevices();

process.on("SIGTERM", async () => {
  await server.stop();
  process.exit(0);
});

server.typedOn("devicePaired", (record) => {
  console.log("Paired:", record.deviceId);
});

server.typedOn("deviceConnected", ({ deviceId, transport }) => {
  console.log(`${deviceId} connected via ${transport}`);
});

server.typedOn("deviceDisconnected", ({ deviceId, transport }) => {
  console.log(`${deviceId} disconnected`);
});

server.typedOn("deviceRevoked", (deviceId) => {
  console.log(`${deviceId} revoked`);
});

import type { CreateCrosslinkServerOptions } from "@crosslink/sdk-node";

const options: CreateCrosslinkServerOptions = {
  application: { id: "com.example.myapp", name: "My App", version: "1.0.0" },
  capabilities: [
    { id: "app.control", title: "Control the app", risk: "medium" }
  ]
};