@lox-audioserver/node-airplay-sender 0.4.8 → 0.4.10

package/dist/core/deviceAirtunes.d.ts

@@ -7,6 +7,7 @@ type RTSPClient = {
     once: (event: string, cb: (...args: any[]) => void) => void;
     startHandshake: (udpServers: any, host: string, port: number) => void;
     teardown: () => void;
+    flush: () => void;
     setVolume: (volume: number, callback?: (err?: unknown) => void) => void;
     setTrackInfo: (name: string, artist?: string, album?: string, callback?: (err?: unknown) => void) => void;
     setProgress: (progress: number, duration: number, callback?: (err?: unknown) => void) => void;

package/dist/core/deviceAirtunes.js

@@ -438,6 +438,11 @@ AirTunesDevice.prototype.setVolume = function (volume, callback) {
         return;
     this.rtsp.setVolume(volume, callback);
 };
+AirTunesDevice.prototype.flush = function () {
+    if (!this.rtsp)
+        return;
+    this.rtsp.flush();
+};
 AirTunesDevice.prototype.setTrackInfo = function (name, artist, album, callback) {
     if (!this.rtsp)
         return;

package/dist/core/devices.d.ts

@@ -28,6 +28,8 @@ export default class Devices extends EventEmitter implements DevicesEmitter {
      * @param txt TXT records advertised by the device.
      */
     add(type: string, host: string | null, options: any, mode?: number, txt?: string[] | string): AirTunesDeviceInstance;
+    /** Flush buffered audio on every device, re-anchoring playback at the current RTP position. */
+    flush(): void;
     /** Adjust volume on one device. */
     setVolume(key: string, volume: number, callback?: (err?: unknown) => void): void;
     /** Push playback position to one or all devices. */

package/dist/core/devices.js

@@ -70,6 +70,17 @@ class Devices extends node_events_1.EventEmitter {
         this.checkAirTunesDevices();
         return dev;
     }
+    /** Flush buffered audio on every device, re-anchoring playback at the current RTP position. */
+    flush() {
+        this.forEach((dev) => {
+            try {
+                dev.flush?.();
+            }
+            catch {
+                // ignore
+            }
+        });
+    }
     /** Adjust volume on one device. */
     setVolume(key, volume, callback) {
         const dev = this.devices[key];

package/dist/core/index.d.ts

@@ -35,7 +35,11 @@ declare class AirTunes extends Duplex {
      * Update track title/artist/album on a device.
      */
     setTrackInfo(deviceKey: string, name: string, artist?: string, album?: string, callback?: (err?: unknown) => void): void;
-    /** Reset the circular buffer state. */
+    /**
+     * Flush buffered audio for a track switch: clear our circular buffer and tell
+     * every receiver to drop its buffered audio and re-anchor at the current RTP
+     * position. Keeps the RTP timeline continuous so playback does not desync.
+     */
     reset(): void;
     /** Send artwork to a device. */
     setArtwork(deviceKey: string, art: Buffer, contentType?: string, callback?: (err?: unknown) => void): void;

package/dist/core/index.js

@@ -111,9 +111,14 @@ class AirTunes extends node_stream_1.Duplex {
     setTrackInfo(deviceKey, name, artist, album, callback) {
         this.devices.setTrackInfo(deviceKey, name, artist, album, callback);
     }
-    /** Reset the circular buffer state. */
+    /**
+     * Flush buffered audio for a track switch: clear our circular buffer and tell
+     * every receiver to drop its buffered audio and re-anchor at the current RTP
+     * position. Keeps the RTP timeline continuous so playback does not desync.
+     */
     reset() {
         this.circularBuffer.reset();
+        this.devices.flush();
     }
     /** Send artwork to a device. */
     setArtwork(deviceKey, art, contentType, callback) {

package/dist/core/rtsp.js

@@ -280,6 +280,15 @@ Client.prototype.setVolume = function (volume, callback) {
     this.status = SETVOLUME;
     this.sendNextRequest();
 };
+// Drop the receiver's buffered audio and re-anchor playback at the current RTP
+// position (RTP-Info: seq=lastSeq+1). Used on track switch/scrub so the new
+// track starts cleanly instead of replaying stale buffered frames.
+Client.prototype.flush = function () {
+    if (this.status !== PLAYING)
+        return;
+    this.status = FLUSH;
+    this.sendNextRequest();
+};
 Client.prototype.setProgress = function (progress, duration, callback) {
     if (this.status !== PLAYING)
         return;

package/dist/esm/core/deviceAirtunes.js

@@ -438,6 +438,11 @@ AirTunesDevice.prototype.setVolume = function (volume, callback) {
         return;
     this.rtsp.setVolume(volume, callback);
 };
+AirTunesDevice.prototype.flush = function () {
+    if (!this.rtsp)
+        return;
+    this.rtsp.flush();
+};
 AirTunesDevice.prototype.setTrackInfo = function (name, artist, album, callback) {
     if (!this.rtsp)
         return;

package/dist/esm/core/devices.js

@@ -70,6 +70,17 @@ class Devices extends node_events_1.EventEmitter {
         this.checkAirTunesDevices();
         return dev;
     }
+    /** Flush buffered audio on every device, re-anchoring playback at the current RTP position. */
+    flush() {
+        this.forEach((dev) => {
+            try {
+                dev.flush?.();
+            }
+            catch {
+                // ignore
+            }
+        });
+    }
     /** Adjust volume on one device. */
     setVolume(key, volume, callback) {
         const dev = this.devices[key];

package/dist/esm/core/index.js

@@ -111,9 +111,14 @@ class AirTunes extends node_stream_1.Duplex {
     setTrackInfo(deviceKey, name, artist, album, callback) {
         this.devices.setTrackInfo(deviceKey, name, artist, album, callback);
     }
-    /** Reset the circular buffer state. */
+    /**
+     * Flush buffered audio for a track switch: clear our circular buffer and tell
+     * every receiver to drop its buffered audio and re-anchor at the current RTP
+     * position. Keeps the RTP timeline continuous so playback does not desync.
+     */
     reset() {
         this.circularBuffer.reset();
+        this.devices.flush();
     }
     /** Send artwork to a device. */
     setArtwork(deviceKey, art, contentType, callback) {

package/dist/esm/core/rtsp.js

@@ -280,6 +280,15 @@ Client.prototype.setVolume = function (volume, callback) {
     this.status = SETVOLUME;
     this.sendNextRequest();
 };
+// Drop the receiver's buffered audio and re-anchor playback at the current RTP
+// position (RTP-Info: seq=lastSeq+1). Used on track switch/scrub so the new
+// track starts cleanly instead of replaying stale buffered frames.
+Client.prototype.flush = function () {
+    if (this.status !== PLAYING)
+        return;
+    this.status = FLUSH;
+    this.sendNextRequest();
+};
 Client.prototype.setProgress = function (progress, duration, callback) {
     if (this.status !== PLAYING)
         return;

package/dist/esm/index.js

@@ -116,6 +116,15 @@ class LoxAirplaySender extends node_events_1.EventEmitter {
             return;
         this.airtunes.write(chunk);
     }
+    /**
+     * Clear the internal circular buffer without tearing down the RTSP session.
+     * Use on track switches to drop buffered PCM in place of a full restart.
+     */
+    reset() {
+        if (!this.airtunes)
+            return;
+        this.airtunes.reset();
+    }
     /**
      * Pipe a readable stream into the sender; auto-stops on end/error.
      */

package/dist/index.d.ts

@@ -78,6 +78,11 @@ export declare class LoxAirplaySender extends EventEmitter {
      * Push raw PCM or ALAC frames into the stream.
      */
     sendPcm(chunk: Buffer): void;
+    /**
+     * Clear the internal circular buffer without tearing down the RTSP session.
+     * Use on track switches to drop buffered PCM in place of a full restart.
+     */
+    reset(): void;
     /**
      * Pipe a readable stream into the sender; auto-stops on end/error.
      */

package/dist/index.js

@@ -116,6 +116,15 @@ class LoxAirplaySender extends node_events_1.EventEmitter {
             return;
         this.airtunes.write(chunk);
     }
+    /**
+     * Clear the internal circular buffer without tearing down the RTSP session.
+     * Use on track switches to drop buffered PCM in place of a full restart.
+     */
+    reset() {
+        if (!this.airtunes)
+            return;
+        this.airtunes.reset();
+    }
     /**
      * Pipe a readable stream into the sender; auto-stops on end/error.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lox-audioserver/node-airplay-sender",
-  "version": "0.4.8",
+  "version": "0.4.10",
   "description": "AirPlay sender (RAOP/AirPlay 1; AirPlay 2 control/auth, best-effort audio)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",