lox-airplay-sender 0.3.0 → 0.3.1

package/README.md

@@ -63,6 +63,7 @@ Creates and starts a sender for one AirPlay device. Returns the instance so you
 - `device`: `{ event: "device", message: status, detail: { key, desc } }`
 - `buffer`: `{ event: "buffer", message: status }` where status is `buffering|playing|drain|end`
 - `error`: `{ event: "error", message }`
+- `metrics`: `{ event: "metrics", detail }` sync drift snapshots emitted on each sync tick when enabled.
 
 ### `LoxAirplaySender` methods
 - `sendPcm(chunk: Buffer)`: Push raw PCM audio. If `inputCodec` is `"alac"` you can push ALAC frames.

package/dist/core/audioOut.js

@@ -42,6 +42,10 @@ class AudioOut extends node_events_1.EventEmitter {
             packet.timestamp = (0, numUtil_1.low32)(seq * config_1.default.frames_per_packet + 2 * config_1.default.sampling_rate);
             if (this.hasAirTunes && seq % config_1.default.sync_period === 0) {
                 this.emit('need_sync', seq);
+                const expectedTimeMs = this.rtpTimeRef +
+                    ((seq * config_1.default.frames_per_packet) / config_1.default.sampling_rate) * 1000;
+                const deltaMs = Date.now() - expectedTimeMs;
+                this.emit('metrics', { type: 'sync', seq, deltaMs, latencyFrames: this.latencyFrames });
             }
             this.emit('packet', packet);
             packet.release();

package/dist/core/index.js

@@ -69,6 +69,9 @@ class AirTunes extends node_stream_1.Duplex {
             this.emit('buffer', status);
         });
         audioOut.init(this.devices, this.circularBuffer, options.startTimeMs);
+        audioOut.on('metrics', (metrics) => {
+            this.emit('metrics', metrics);
+        });
         this.circularBuffer.on('drain', () => {
             this.emit('drain');
         });

package/dist/esm/core/audioOut.js

@@ -42,6 +42,10 @@ class AudioOut extends node_events_1.EventEmitter {
             packet.timestamp = (0, numUtil_1.low32)(seq * config_1.default.frames_per_packet + 2 * config_1.default.sampling_rate);
             if (this.hasAirTunes && seq % config_1.default.sync_period === 0) {
                 this.emit('need_sync', seq);
+                const expectedTimeMs = this.rtpTimeRef +
+                    ((seq * config_1.default.frames_per_packet) / config_1.default.sampling_rate) * 1000;
+                const deltaMs = Date.now() - expectedTimeMs;
+                this.emit('metrics', { type: 'sync', seq, deltaMs, latencyFrames: this.latencyFrames });
             }
             this.emit('packet', packet);
             packet.release();

package/dist/esm/core/index.js

@@ -69,6 +69,9 @@ class AirTunes extends node_stream_1.Duplex {
             this.emit('buffer', status);
         });
         audioOut.init(this.devices, this.circularBuffer, options.startTimeMs);
+        audioOut.on('metrics', (metrics) => {
+            this.emit('metrics', metrics);
+        });
         this.circularBuffer.on('drain', () => {
             this.emit('drain');
         });

package/dist/esm/index.js

@@ -84,6 +84,9 @@ class LoxAirplaySender extends node_events_1.EventEmitter {
         this.airtunes.on('error', (err) => {
             onEvent?.({ event: 'error', message: err instanceof Error ? err.message : String(err) });
         });
+        this.airtunes.on('metrics', (detail) => {
+            onEvent?.({ event: 'metrics', detail });
+        });
         const dev = this.airtunes.add(options.host, {
             port: options.port,
             name: options.name,

package/dist/index.js

@@ -84,6 +84,9 @@ class LoxAirplaySender extends node_events_1.EventEmitter {
         this.airtunes.on('error', (err) => {
             onEvent?.({ event: 'error', message: err instanceof Error ? err.message : String(err) });
         });
+        this.airtunes.on('metrics', (detail) => {
+            onEvent?.({ event: 'metrics', detail });
+        });
         const dev = this.airtunes.add(options.host, {
             port: options.port,
             name: options.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lox-airplay-sender",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "AirPlay sender (RAOP/AirPlay 1 + AirPlay 2 auth flows) ",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",