@rocksky/sdk 0.8.1 → 0.10.1

package/README.md

@@ -104,6 +104,33 @@ the existing URI) and a same-second scrobble of the same track isn't duplicated.
 
 Node ≥ 22 (global `WebSocket`/`fetch`) or Bun.
 
+## Remote control
+
+Build a controllable player or a remote UI over the remote-control WebSocket (see
+[`remote-ws/PROTOCOL.md`](../../remote-ws/PROTOCOL.md)). Heartbeat, reconnect, and
+the register handshake are handled for you.
+
+```ts
+import { RemotePlayer, RemoteController } from "@rocksky/sdk";
+
+// A controllable player (advertises now-playing + obeys commands):
+const player = new RemotePlayer({ token, name: "My Player" });
+player.on("play", () => engine.play()).on("pause", () => engine.pause());
+player.connect();
+player.setNowPlaying({ title, artist, albumArt, durationMs, elapsedMs, isPlaying: true });
+player.setStatus("playing");
+
+// A controller (lists devices, picks the primary, sends commands):
+const controller = new RemoteController({ token, name: "My Controller" });
+controller.on("devices", ({ devices }) => render(devices));
+controller.on("nowPlaying", ({ deviceId, track }) => show(deviceId, track));
+controller.connect();
+controller.setPrimary(deviceId);
+controller.pause(deviceId);
+```
+
+See `examples/remote.ts`.
+
 ## Example
 
 ```sh

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export { RockskyLibrary } from "./library.js";
 export { Agent, type ScrobbleInput, type ScrobbleMatchInput, type SongInput, type AlbumInput, type ArtistInput, } from "./agent.js";
 export { RockskyIndex, totalIndexed, type IndexStats } from "./dedup.js";
 export { runJetstream, DEFAULT_JETSTREAM_SERVERS, type JetstreamOptions } from "./jetstream.js";
+export { RemotePlayer, DEFAULT_REMOTE_WS, type RemotePlayerOptions, type RemotePlayerHandlers, type RemoteNowPlaying, type RemoteQueueItem, type EnqueueCommand, } from "./remote-player.js";
+export { RemoteController, type RemoteControllerOptions, type RemoteControllerEvents, type RemoteDevice, type RemoteStatus, } from "./remote-controller.js";
 export { songHash, albumHash, artistHash } from "./hash.js";
 export { RockskyError } from "./errors.js";
 export type * from "./generated/types.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,KAAK,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,mBAAmB,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,KAAK,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,mBAAmB,sBAAsB,CAAC"}

package/dist/index.js

@@ -1018,6 +1018,514 @@ function* walkMst(blocks, cid) {
       yield* walkMst(blocks, e.t.$link);
   }
 }
+// src/remote-player.ts
+var DEFAULT_REMOTE_WS = "wss://api.rocksky.app/ws";
+
+class RemotePlayer {
+  opts;
+  ws = null;
+  deviceId = "";
+  stopped = false;
+  heartbeat;
+  reconnectTimer;
+  url;
+  heartbeatMs;
+  reconnectMs;
+  getToken;
+  debug;
+  handlers = {};
+  lastTrack = null;
+  lastStatus = null;
+  lastQueue = null;
+  constructor(opts) {
+    this.opts = opts;
+    this.url = opts.url ?? DEFAULT_REMOTE_WS;
+    this.heartbeatMs = opts.heartbeatMs ?? 1e4;
+    this.reconnectMs = opts.reconnectMs ?? 3000;
+    this.getToken = typeof opts.token === "function" ? opts.token : () => opts.token;
+    this.debug = opts.debug ?? (() => {});
+  }
+  on(event, handler) {
+    this.handlers[event] = handler;
+    return this;
+  }
+  get id() {
+    return this.deviceId;
+  }
+  connect() {
+    this.stopped = false;
+    this.open();
+  }
+  disconnect() {
+    this.stopped = true;
+    if (this.reconnectTimer)
+      clearTimeout(this.reconnectTimer);
+    if (this.heartbeat)
+      clearInterval(this.heartbeat);
+    try {
+      this.ws?.close();
+    } catch {}
+    this.ws = null;
+  }
+  setNowPlaying(track) {
+    this.lastTrack = track;
+    this.send({
+      type: "message",
+      device_id: this.deviceId,
+      token: this.getToken(),
+      data: {
+        type: "track",
+        title: track.title,
+        artist: track.artist,
+        album: track.album,
+        album_artist: track.albumArtist ?? track.artist,
+        length: track.durationMs ?? 0,
+        elapsed: track.elapsedMs ?? 0,
+        duration_ms: track.durationMs ?? 0,
+        album_art: track.albumArt,
+        is_playing: track.isPlaying ?? true,
+        device_name: this.opts.name
+      }
+    });
+  }
+  setStatus(status) {
+    const code = status === "playing" ? 1 : status === "paused" ? 2 : 0;
+    this.lastStatus = code;
+    this.send({
+      type: "message",
+      device_id: this.deviceId,
+      token: this.getToken(),
+      data: { type: "status", status: code }
+    });
+  }
+  setQueue(items, index) {
+    this.lastQueue = { items, index };
+    this.send({
+      type: "message",
+      device_id: this.deviceId,
+      token: this.getToken(),
+      data: {
+        type: "queue",
+        index,
+        queue: items.map((t) => ({
+          uploadId: t.uploadId,
+          trackId: t.trackId,
+          title: t.title,
+          artist: t.artist,
+          album: t.album,
+          album_artist: t.albumArtist,
+          album_art: t.albumArt,
+          duration: t.durationMs,
+          song_uri: t.songUri,
+          album_uri: t.albumUri,
+          track_number: t.trackNumber
+        }))
+      }
+    });
+  }
+  send(payload) {
+    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+      try {
+        this.ws.send(JSON.stringify(payload));
+      } catch (e) {
+        this.debug("send error", e);
+      }
+    }
+  }
+  open() {
+    if (this.stopped)
+      return;
+    const token = this.getToken();
+    if (!token) {
+      this.reconnectTimer = setTimeout(() => this.open(), this.reconnectMs);
+      return;
+    }
+    let ws;
+    try {
+      ws = new WebSocket(this.url);
+    } catch (e) {
+      this.debug("connect failed", e);
+      this.reconnectTimer = setTimeout(() => this.open(), this.reconnectMs);
+      return;
+    }
+    this.ws = ws;
+    ws.onopen = () => {
+      this.debug("connected");
+      this.send({ type: "register", clientName: this.opts.name, token: this.getToken() });
+      if (this.heartbeat)
+        clearInterval(this.heartbeat);
+      this.heartbeat = setInterval(() => {
+        if (ws.readyState === WebSocket.OPEN)
+          ws.send("ping");
+      }, this.heartbeatMs);
+    };
+    ws.onmessage = (ev) => {
+      if (ev.data === "pong")
+        return;
+      let msg;
+      try {
+        msg = JSON.parse(ev.data);
+      } catch {
+        return;
+      }
+      this.handle(msg);
+    };
+    ws.onerror = () => {
+      try {
+        ws.close();
+      } catch {}
+    };
+    ws.onclose = () => {
+      this.debug("disconnected");
+      if (this.heartbeat)
+        clearInterval(this.heartbeat);
+      if (this.ws === ws)
+        this.ws = null;
+      this.deviceId = "";
+      if (!this.stopped) {
+        if (this.reconnectTimer)
+          clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = setTimeout(() => this.open(), this.reconnectMs);
+      }
+    };
+  }
+  handle(msg) {
+    if (msg.status === "registered" && typeof msg.deviceId === "string") {
+      this.deviceId = msg.deviceId;
+      this.debug("registered", this.deviceId);
+      this.resync();
+      return;
+    }
+    if (msg.type === "command") {
+      this.dispatch(msg);
+      return;
+    }
+  }
+  dispatch(msg) {
+    const h = this.handlers;
+    switch (msg.action) {
+      case "play":
+        h.play?.();
+        break;
+      case "pause":
+        h.pause?.();
+        break;
+      case "next":
+        h.next?.();
+        break;
+      case "previous":
+        h.previous?.();
+        break;
+      case "seek": {
+        const a = msg.args;
+        const pos = typeof a === "number" ? a : a?.position ?? 0;
+        h.seek?.(pos);
+        break;
+      }
+      case "queue_jump":
+        h.queueJump?.(msg.args?.index ?? 0);
+        break;
+      case "queue_remove":
+        h.queueRemove?.(msg.args?.index ?? 0);
+        break;
+      case "enqueue": {
+        const a = msg.args ?? {};
+        h.enqueue?.({
+          tracks: (a.tracks ?? []).map(descriptorToItem),
+          mode: a.mode ?? "now",
+          shuffle: !!a.shuffle,
+          startIndex: a.startIndex ?? 0
+        });
+        break;
+      }
+      default:
+        this.debug("unknown command", msg.action);
+    }
+  }
+  resync() {
+    if (this.lastTrack)
+      this.setNowPlaying(this.lastTrack);
+    if (this.lastStatus !== null) {
+      this.send({
+        type: "message",
+        device_id: this.deviceId,
+        token: this.getToken(),
+        data: { type: "status", status: this.lastStatus }
+      });
+    }
+    if (this.lastQueue)
+      this.setQueue(this.lastQueue.items, this.lastQueue.index);
+  }
+}
+function descriptorToItem(d) {
+  return {
+    uploadId: d.uploadId,
+    trackId: d.trackId,
+    title: d.title ?? "",
+    artist: d.artist ?? "",
+    album: d.album,
+    albumArtist: d.album_artist,
+    albumArt: d.album_art,
+    durationMs: d.duration,
+    songUri: d.song_uri,
+    albumUri: d.album_uri,
+    trackNumber: d.track_number
+  };
+}
+// src/remote-controller.ts
+class RemoteController {
+  opts;
+  ws = null;
+  stopped = false;
+  heartbeat;
+  reconnectTimer;
+  url;
+  heartbeatMs;
+  reconnectMs;
+  getToken;
+  debug;
+  handlers = {};
+  constructor(opts) {
+    this.opts = opts;
+    this.url = opts.url ?? DEFAULT_REMOTE_WS;
+    this.heartbeatMs = opts.heartbeatMs ?? 1e4;
+    this.reconnectMs = opts.reconnectMs ?? 3000;
+    this.getToken = typeof opts.token === "function" ? opts.token : () => opts.token;
+    this.debug = opts.debug ?? (() => {});
+  }
+  on(event, handler) {
+    this.handlers[event] = handler;
+    return this;
+  }
+  connect() {
+    this.stopped = false;
+    this.open();
+  }
+  disconnect() {
+    this.stopped = true;
+    if (this.reconnectTimer)
+      clearTimeout(this.reconnectTimer);
+    if (this.heartbeat)
+      clearInterval(this.heartbeat);
+    try {
+      this.ws?.close();
+    } catch {}
+    this.ws = null;
+  }
+  setPrimary(deviceId) {
+    this.send({ type: "set_primary", device_id: deviceId, token: this.getToken() });
+  }
+  play(target) {
+    this.command("play", target);
+  }
+  pause(target) {
+    this.command("pause", target);
+  }
+  next(target) {
+    this.command("next", target);
+  }
+  previous(target) {
+    this.command("previous", target);
+  }
+  seek(target, positionMs) {
+    this.command("seek", target, { position: positionMs });
+  }
+  queueJump(target, index) {
+    this.command("queue_jump", target, { index });
+  }
+  queueRemove(target, index) {
+    this.command("queue_remove", target, { index });
+  }
+  enqueue(target, tracks, mode = "now", shuffle = false, startIndex = 0) {
+    this.command("enqueue", target, {
+      tracks: tracks.map((t) => ({
+        uploadId: t.uploadId,
+        trackId: t.trackId,
+        title: t.title,
+        artist: t.artist,
+        album: t.album,
+        album_artist: t.albumArtist,
+        album_art: t.albumArt,
+        duration: t.durationMs,
+        song_uri: t.songUri,
+        album_uri: t.albumUri,
+        track_number: t.trackNumber
+      })),
+      mode,
+      shuffle,
+      startIndex
+    });
+  }
+  command(action, target, args) {
+    const payload = { type: "command", action, token: this.getToken() };
+    if (target)
+      payload.target = target;
+    if (args !== undefined)
+      payload.args = args;
+    this.send(payload);
+  }
+  send(payload) {
+    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+      try {
+        this.ws.send(JSON.stringify(payload));
+      } catch (e) {
+        this.debug("send error", e);
+      }
+    }
+  }
+  open() {
+    if (this.stopped)
+      return;
+    const token = this.getToken();
+    if (!token) {
+      this.reconnectTimer = setTimeout(() => this.open(), this.reconnectMs);
+      return;
+    }
+    let ws;
+    try {
+      ws = new WebSocket(this.url);
+    } catch (e) {
+      this.debug("connect failed", e);
+      this.reconnectTimer = setTimeout(() => this.open(), this.reconnectMs);
+      return;
+    }
+    this.ws = ws;
+    ws.onopen = () => {
+      this.debug("connected");
+      this.send({ type: "register", clientName: this.opts.name, token: this.getToken() });
+      if (this.heartbeat)
+        clearInterval(this.heartbeat);
+      this.heartbeat = setInterval(() => {
+        if (ws.readyState === WebSocket.OPEN)
+          ws.send("ping");
+      }, this.heartbeatMs);
+    };
+    ws.onmessage = (ev) => {
+      if (ev.data === "pong")
+        return;
+      let msg;
+      try {
+        msg = JSON.parse(ev.data);
+      } catch {
+        return;
+      }
+      this.handle(msg);
+    };
+    ws.onerror = () => {
+      try {
+        ws.close();
+      } catch {}
+    };
+    ws.onclose = () => {
+      this.debug("disconnected");
+      if (this.heartbeat)
+        clearInterval(this.heartbeat);
+      if (this.ws === ws)
+        this.ws = null;
+      if (!this.stopped) {
+        if (this.reconnectTimer)
+          clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = setTimeout(() => this.open(), this.reconnectMs);
+      }
+    };
+  }
+  handle(msg) {
+    if (msg.status === "registered")
+      return;
+    switch (msg.type) {
+      case "devices":
+        this.handlers.devices?.({
+          primaryDevice: msg.primary_device ?? null,
+          devices: (msg.devices ?? []).map(deviceFromJson)
+        });
+        break;
+      case "device_registered":
+        this.handlers.deviceRegistered?.({
+          deviceId: msg.deviceId ?? "",
+          name: msg.clientName ?? ""
+        });
+        break;
+      case "device_unregistered":
+        this.handlers.deviceUnregistered?.({ deviceId: msg.device_id ?? "" });
+        break;
+      case "primary_changed":
+        this.handlers.primaryChanged?.({ deviceId: msg.device_id ?? "" });
+        break;
+      case "message":
+        this.handleMessage(msg);
+        break;
+      default:
+        this.debug("unknown frame", msg.type);
+    }
+  }
+  handleMessage(msg) {
+    const deviceId = msg.device_id ?? "";
+    const deviceName = msg.device_name ?? "";
+    const data = msg.data;
+    if (!data)
+      return;
+    switch (data.type) {
+      case "track":
+        this.handlers.nowPlaying?.({ deviceId, deviceName, track: trackFromJson(data) });
+        break;
+      case "status":
+        this.handlers.status?.({ deviceId, deviceName, status: statusFromCode(data.status) });
+        break;
+      case "queue":
+        this.handlers.queue?.({
+          deviceId,
+          deviceName,
+          index: data.index ?? 0,
+          queue: (data.queue ?? []).map(queueItemFromJson)
+        });
+        break;
+    }
+  }
+}
+function statusFromCode(code) {
+  return code === 1 ? "playing" : code === 0 ? "stopped" : "paused";
+}
+function trackFromJson(d) {
+  return {
+    title: d.title ?? "",
+    artist: d.artist ?? "",
+    album: d.album,
+    albumArtist: d.album_artist,
+    albumArt: d.album_art,
+    durationMs: d.duration_ms ?? d.length,
+    elapsedMs: d.elapsed,
+    isPlaying: d.is_playing,
+    songUri: d.song_uri,
+    albumUri: d.album_uri,
+    artistUri: d.artist_uri,
+    sha256: d.sha256,
+    liked: d.liked
+  };
+}
+function queueItemFromJson(d) {
+  return {
+    uploadId: d.uploadId,
+    trackId: d.trackId,
+    title: d.title ?? "",
+    artist: d.artist ?? "",
+    album: d.album,
+    albumArtist: d.album_artist,
+    albumArt: d.album_art,
+    durationMs: d.duration,
+    songUri: d.song_uri,
+    albumUri: d.album_uri,
+    trackNumber: d.track_number
+  };
+}
+function deviceFromJson(d) {
+  return {
+    deviceId: d.device_id ?? "",
+    name: d.name ?? "",
+    nowPlaying: d.now_playing ? trackFromJson(d.now_playing) : undefined,
+    queueIndex: d.queue?.index ?? 0,
+    queue: (d.queue?.queue ?? []).map(queueItemFromJson)
+  };
+}
 
 // src/index.ts
 init_errors();
@@ -1031,7 +1539,10 @@ export {
   RockskyIndex,
   RockskyError,
   RockskyClient,
+  RemotePlayer,
+  RemoteController,
   Interval,
+  DEFAULT_REMOTE_WS,
   DEFAULT_JETSTREAM_SERVERS,
   DEFAULT_APPVIEW,
   Agent

package/dist/remote-controller.d.ts

@@ -0,0 +1,123 @@
+/**
+ * RemoteController — build a Rocksky remote UI in a few lines.
+ *
+ * The other half of the remote-control WebSocket protocol (see
+ * remote-ws/PROTOCOL.md): where {@link RemotePlayer} is a controllable player, a
+ * controller lists the user's players, observes what each is playing
+ * (now-playing / status / queue), picks the primary device, and sends commands
+ * (play/pause/next/previous/seek/queue actions/enqueue). Heartbeat, reconnect,
+ * and the register handshake are handled for you.
+ *
+ * ```ts
+ * const controller = new RemoteController({ token, name: "My Controller" });
+ * controller.on("devices", (d) => render(d.devices));
+ * controller.on("nowPlaying", (e) => showTrack(e.deviceId, e.track));
+ * controller.connect();
+ * // …then drive a device:
+ * controller.setPrimary(deviceId);
+ * controller.pause(deviceId);
+ * controller.seek(deviceId, 42000);
+ * ```
+ */
+import { DEFAULT_REMOTE_WS, type RemoteNowPlaying, type RemoteQueueItem } from "./remote-player.js";
+export { DEFAULT_REMOTE_WS, type RemoteNowPlaying, type RemoteQueueItem };
+/** A player device visible to the controller. */
+export interface RemoteDevice {
+    deviceId: string;
+    name: string;
+    nowPlaying?: RemoteNowPlaying;
+    queueIndex: number;
+    queue: RemoteQueueItem[];
+}
+/** Transport state advertised by a device. */
+export type RemoteStatus = "playing" | "paused" | "stopped";
+/** Events the controller emits (from the server). */
+export interface RemoteControllerEvents {
+    /** The full device snapshot (on connect + reconnect). */
+    devices(payload: {
+        primaryDevice: string | null;
+        devices: RemoteDevice[];
+    }): void;
+    deviceRegistered(payload: {
+        deviceId: string;
+        name: string;
+    }): void;
+    deviceUnregistered(payload: {
+        deviceId: string;
+    }): void;
+    primaryChanged(payload: {
+        deviceId: string;
+    }): void;
+    nowPlaying(payload: {
+        deviceId: string;
+        deviceName: string;
+        track: RemoteNowPlaying;
+    }): void;
+    status(payload: {
+        deviceId: string;
+        deviceName: string;
+        status: RemoteStatus;
+    }): void;
+    queue(payload: {
+        deviceId: string;
+        deviceName: string;
+        index: number;
+        queue: RemoteQueueItem[];
+    }): void;
+}
+type EventName = keyof RemoteControllerEvents;
+type EventHandler<K extends EventName> = RemoteControllerEvents[K];
+export interface RemoteControllerOptions {
+    /** Rocksky access token, or a getter (read fresh on each (re)connect/send). */
+    token: string | (() => string | undefined);
+    /** Registration label (controllers are hidden from device lists). */
+    name: string;
+    /** WebSocket endpoint. Defaults to {@link DEFAULT_REMOTE_WS}. */
+    url?: string;
+    /** Heartbeat interval, ms (default 10000). */
+    heartbeatMs?: number;
+    /** Reconnect delay after a drop, ms (default 3000). */
+    reconnectMs?: number;
+    /** Optional debug logger. */
+    debug?: (...args: unknown[]) => void;
+}
+type Json = any;
+export declare class RemoteController {
+    private readonly opts;
+    private ws;
+    private stopped;
+    private heartbeat?;
+    private reconnectTimer?;
+    private readonly url;
+    private readonly heartbeatMs;
+    private readonly reconnectMs;
+    private readonly getToken;
+    private readonly debug;
+    private handlers;
+    constructor(opts: RemoteControllerOptions);
+    /** Subscribe to a server event. Returns `this` for chaining. */
+    on<K extends EventName>(event: K, handler: EventHandler<K>): this;
+    /** Connect, register, and start the heartbeat + auto-reconnect loop. */
+    connect(): void;
+    /** Tear the connection down and stop reconnecting. */
+    disconnect(): void;
+    /** Choose the primary (scrobble/profile) device. */
+    setPrimary(deviceId: string): void;
+    /** `play`. `target` is a device id, or omit to broadcast to all devices. */
+    play(target?: string): void;
+    pause(target?: string): void;
+    next(target?: string): void;
+    previous(target?: string): void;
+    seek(target: string | undefined, positionMs: number): void;
+    queueJump(target: string | undefined, index: number): void;
+    queueRemove(target: string | undefined, index: number): void;
+    /** Enqueue tracks on the target device. */
+    enqueue(target: string | undefined, tracks: RemoteQueueItem[], mode?: "now" | "next" | "last", shuffle?: boolean, startIndex?: number): void;
+    /** Send an arbitrary command (escape hatch). */
+    command(action: string, target?: string, args?: Json): void;
+    private send;
+    private open;
+    private handle;
+    private handleMessage;
+}
+//# sourceMappingURL=remote-controller.d.ts.map

package/dist/remote-controller.d.ts.map

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