@aelionsdk/audio 1.2.0-rc.5 → 1.2.0

package/README.md

@@ -5,10 +5,10 @@ Audio scheduling and deterministic PCM processing primitives for AelionSDK.
 ## Install
 
 ```bash
-npm install @aelionsdk/audio@next
+npm install @aelionsdk/audio
 ```
 
-`next` currently resolves to `1.2.0-rc.5`. Product applications should prefer
+`latest` currently resolves to `1.2.0`. Product applications should prefer
 `@aelionsdk/sdk`; use this package directly when building a custom audio host,
 analysis pipeline or renderer integration.
 

package/dist/transferable-worklet-clock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transferable-worklet-clock.d.ts","sourceRoot":"","sources":["../src/transferable-worklet-clock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EACL,oBAAoB,EACpB,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAC;AAoBrC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,qBAAa,6BAA8B,YAAW,UAAU;;IAC9D,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,SAAgB,KAAK,EAAE,oBAAoB,CAAC;gBAazB,OAAO,GAAE,6BAAkC;IAa9D,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,UAAU,IAAI,uBAAuB,GAAG,SAAS,CAE3D;IAEY,UAAU,CACrB,iBAAiB,SAA2C,GAC3D,OAAO,CAAC,IAAI,CAAC;IAwDH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAkB1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAY5B,KAAK,IAAI,MAAM;IAQf,QAAQ,IAAI,4BAA4B;IAIxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAyBhC;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAA;CAAE,CAAC;AAEhG,wBAAgB,2BAA2B,CAAC,WAAW,EAAE;IACvD,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;CAC9C,GAAG,0BAA0B,CAI7B"}
+{"version":3,"file":"transferable-worklet-clock.d.ts","sourceRoot":"","sources":["../src/transferable-worklet-clock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EACL,oBAAoB,EACpB,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAC;AAoBrC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,qBAAa,6BAA8B,YAAW,UAAU;;IAC9D,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,SAAgB,KAAK,EAAE,oBAAoB,CAAC;gBAczB,OAAO,GAAE,6BAAkC;IAa9D,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,IAAW,UAAU,IAAI,uBAAuB,GAAG,SAAS,CAE3D;IAEY,UAAU,CACrB,iBAAiB,SAA2C,GAC3D,OAAO,CAAC,IAAI,CAAC;IAyDH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAkB1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB7B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAY5B,KAAK,IAAI,MAAM;IAQf,QAAQ,IAAI,4BAA4B;IAIxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BhC;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAA;CAAE,CAAC;AAEhG,wBAAgB,2BAA2B,CAAC,WAAW,EAAE;IACvD,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;CAC9C,GAAG,0BAA0B,CAI7B"}

package/dist/transferable-worklet-clock.js

@@ -19,6 +19,7 @@ export class TransferableAudioWorkletClock {
     queue;
     #ownsContext;
     #node;
+    #outputConnected = false;
     #initializeTask;
     #disposeTask;
     #disposed = false;
@@ -97,6 +98,7 @@ export class TransferableAudioWorkletClock {
             node.port.start();
             node.connect(this.context.destination);
             connected = true;
+            this.#outputConnected = true;
             this.#throwIfInitializationStale(generation);
             this.#contextOriginTime = this.context.currentTime;
             this.#node = node;
@@ -110,6 +112,7 @@ export class TransferableAudioWorkletClock {
     }
     async start() {
         await this.initialize();
+        this.#connectOutput();
         this.#node?.port.postMessage({ type: 'start', generation: this.#generation });
         await this.context.resume();
     }
@@ -130,13 +133,28 @@ export class TransferableAudioWorkletClock {
         return true;
     }
     async pause() {
+        this.#disconnectOutput();
         if (this.context.state === 'running')
             await this.context.suspend();
     }
     async resume() {
+        this.#connectOutput();
         if (this.context.state !== 'running')
             await this.context.resume();
     }
+    #connectOutput() {
+        if (this.#node === undefined || this.#outputConnected)
+            return;
+        this.#node.connect(this.context.destination);
+        this.#outputConnected = true;
+    }
+    #disconnectOutput() {
+        if (this.#node === undefined || !this.#outputConnected)
+            return;
+        this.#node.disconnect();
+        this.#outputConnected = false;
+        this.queue.flush();
+    }
     seek(timeUs) {
         if (!Number.isSafeInteger(timeUs) || timeUs < 0) {
             throw new RangeError('Seek target must be a non-negative safe integer microsecond value');
@@ -166,6 +184,7 @@ export class TransferableAudioWorkletClock {
         this.queue.close();
         this.#node?.port.postMessage({ type: 'close' });
         this.#node?.disconnect();
+        this.#outputConnected = false;
         this.#node?.port.close();
         this.#node = undefined;
         if (this.#ownsContext && this.context.state !== 'closed')

package/dist/worklet-clock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worklet-clock.d.ts","sourceRoot":"","sources":["../src/worklet-clock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAEzE,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,wBAAwB,GAChC,aAAa,GAAG,SAAS,GAAG,SAAS,CAIvC;AAoBD,qBAAa,iBAAkB,YAAW,UAAU;;IAClD,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;gBAuBvB,OAAO,GAAE,iBAAsB;IAkBlD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,UAAU,IAAI,gBAAgB,GAAG,SAAS,CAEpD;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAEY,UAAU,CAAC,iBAAiB,SAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAsDtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI;IAKjE,YAAY,CAAC,MAAM,SAAI,GAAG,MAAM;IAYhC,KAAK,IAAI,MAAM;IAQf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA+BhC"}
+{"version":3,"file":"worklet-clock.d.ts","sourceRoot":"","sources":["../src/worklet-clock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAEzE,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,wBAAwB,GAChC,aAAa,GAAG,SAAS,GAAG,SAAS,CAIvC;AAoBD,qBAAa,iBAAkB,YAAW,UAAU;;IAClD,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;gBAwBvB,OAAO,GAAE,iBAAsB;IAkBlD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,UAAU,IAAI,gBAAgB,GAAG,SAAS,CAEpD;IAED,IAAW,UAAU,IAAI,MAAM,CAE9B;IAEY,UAAU,CAAC,iBAAiB,SAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B7B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI;IAKjE,YAAY,CAAC,MAAM,SAAI,GAAG,MAAM;IAYhC,KAAK,IAAI,MAAM;IAQf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAgChC"}

package/dist/worklet-clock.js

@@ -28,6 +28,7 @@ export class AudioWorkletClock {
     #initializeTask;
     #disposeTask;
     #ownsContext;
+    #outputConnected = false;
     #disposed = false;
     #lifecycleGeneration = 0;
     #lastReport;
@@ -114,6 +115,7 @@ export class AudioWorkletClock {
             // module-loading latency appears as permanent A/V drift.
             node.connect(this.context.destination);
             connected = true;
+            this.#outputConnected = true;
             this.#throwIfInitializationStale(generation);
             this.#contextOriginTime = this.context.currentTime;
             this.#node = node;
@@ -127,20 +129,41 @@ export class AudioWorkletClock {
     }
     async start() {
         await this.initialize();
+        this.#connectOutput();
         await withTimeout(this.context.resume(), 5_000, 'AudioContext resume');
         this.#emit('started');
     }
     async pause() {
+        this.#disconnectOutput();
         if (this.context.state === 'running')
             await this.context.suspend();
         this.#emit('paused');
     }
     async resume() {
+        this.#connectOutput();
         if (this.context.state !== 'running') {
             await withTimeout(this.context.resume(), 5_000, 'AudioContext resume');
         }
         this.#emit('resumed');
     }
+    #connectOutput() {
+        if (this.#node === undefined || this.#outputConnected)
+            return;
+        this.#node.connect(this.context.destination);
+        this.#outputConnected = true;
+    }
+    #disconnectOutput() {
+        if (this.#node === undefined || !this.#outputConnected)
+            return;
+        // Disconnect only. A pause does not move the playback position, so the
+        // buffered frames are still the ones that come next and resuming should
+        // continue from them. Dropping them here would also reset the ring's play
+        // and underrun counters, which are reported as session telemetry, and cost
+        // a full refill on every resume. An edit while paused is what makes those
+        // frames stale, and `AelionPlayer.invalidate` handles that case.
+        this.#node.disconnect();
+        this.#outputConnected = false;
+    }
     subscribe(listener) {
         this.#listeners.add(listener);
         return () => this.#listeners.delete(listener);
@@ -171,6 +194,7 @@ export class AudioWorkletClock {
         this.context.removeEventListener('statechange', this.#onStateChange);
         this.ring.close();
         this.#node?.disconnect();
+        this.#outputConnected = false;
         this.#node?.port.close();
         this.#node = undefined;
         if (this.#ownsContext && this.context.state !== 'closed')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/audio",
-  "version": "1.2.0-rc.5",
+  "version": "1.2.0",
   "description": "AudioWorklet clock, PCM buffering and audio mixing for AelionSDK",
   "license": "MIT",
   "repository": {
@@ -34,8 +34,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@aelionsdk/core": "1.2.0-rc.5",
-    "@aelionsdk/render-ir": "1.2.0-rc.5"
+    "@aelionsdk/core": "1.2.0",
+    "@aelionsdk/render-ir": "1.2.0"
   },
   "scripts": {
     "build": "tsc -b",