@gjsify/webaudio 0.19.0 → 0.21.0

package/lib/esm/gst-decoder.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{Gst as e,ensureGstInit as t}from"./gst-init.js";import{AudioBuffer as n}from"./audio-buffer.js";import"gi://GstApp?version=1.0";function decodeAudioDataSync(r){if(t(),!(r instanceof ArrayBuffer)||r.byteLength===0)throw new DOMException(`Unable to decode audio data`,`EncodingError`);let i=e.parse_launch(`appsrc name=src ! decodebin ! audioconvert ! audioresample ! capsfilter caps=audio/x-raw,format=F32LE,layout=interleaved ! appsink name=sink sync=false`),a=i.get_by_name(`src`),o=i.get_by_name(`sink`);i.set_state(e.State.PLAYING);let s=new Uint8Array(r);a.push_buffer(e.Buffer.new_wrapped(s)),a.end_of_stream();let c=[],l=0,u=0;for(;;){let t=o.try_pull_sample(2*Number(e.SECOND));if(!t)break;if(l===0){let e=t.get_caps();if(e){let t=e.get_structure(0);[,l]=t.get_int(`rate`),[,u]=t.get_int(`channels`)}}let n=t.get_buffer();if(!n)continue;let[r,i]=n.map(e.MapFlags.READ);r&&(c.push(new Uint8Array(i.data)),n.unmap(i))}if(i.set_state(e.State.NULL),l===0||u===0)throw new DOMException(`Unable to decode audio data`,`EncodingError`);let d=0;for(let e of c)d+=e.length;let f=d/(4*u),p=new n({numberOfChannels:u,length:f,sampleRate:l}),m=0;for(let e of c){let t=new Float32Array(e.buffer,e.byteOffset,e.length/4),n=t.length/u;for(let e=0;e<n;e++)for(let n=0;n<u;n++)p._channelData[n][m+e]=t[e*u+n];m+=n}return p}export{decodeAudioDataSync};
+import"./_virtual/_rolldown/runtime.js";import{Gst as e,ensureGstInit as t,isGstStreamingUnsafe as n}from"./gst-init.js";import{AudioBuffer as r}from"./audio-buffer.js";import"gi://GstApp?version=1.0";function decodeAudioDataSync(i){if(n()||(t(),!(i instanceof ArrayBuffer)||i.byteLength===0))throw new DOMException(`Unable to decode audio data`,`EncodingError`);let a=e.parse_launch(`appsrc name=src ! decodebin ! audioconvert ! audioresample ! capsfilter caps=audio/x-raw,format=F32LE,layout=interleaved ! appsink name=sink sync=false`),o=a.get_by_name(`src`),s=a.get_by_name(`sink`);a.set_state(e.State.PLAYING);let c=new Uint8Array(i);o.push_buffer(e.Buffer.new_wrapped(c)),o.end_of_stream();let l=[],u=0,d=0;for(;;){let t=s.try_pull_sample(2*Number(e.SECOND));if(!t)break;if(u===0){let e=t.get_caps();if(e){let t=e.get_structure(0);[,u]=t.get_int(`rate`),[,d]=t.get_int(`channels`)}}let n=t.get_buffer();if(!n)continue;let[r,i]=n.map(e.MapFlags.READ);r&&(l.push(new Uint8Array(i.data)),n.unmap(i))}if(a.set_state(e.State.NULL),u===0||d===0)throw new DOMException(`Unable to decode audio data`,`EncodingError`);let f=0;for(let e of l)f+=e.length;let p=f/(4*d),m=new r({numberOfChannels:d,length:p,sampleRate:u}),h=0;for(let e of l){let t=new Float32Array(e.buffer,e.byteOffset,e.length/4),n=t.length/d;for(let e=0;e<n;e++)for(let n=0;n<d;n++)m._channelData[n][h+e]=t[e*d+n];h+=n}return m}export{decodeAudioDataSync};

package/lib/esm/gst-init.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import e from"gi://Gst?version=1.0";let t=!1;function ensureGstInit(){t||=(e.init(null),!0)}export{e as Gst,ensureGstInit};
+import"./_virtual/_rolldown/runtime.js";import e from"gi://Gst?version=1.0";let t=!1;function ensureGstInit(){t||=(e.init(null),!0)}function isGstStreamingUnsafe(){let e=globalThis;return e.Bun!==void 0||e.Deno!==void 0}export{e as Gst,ensureGstInit,isGstStreamingUnsafe};

package/lib/types/gst-init.d.ts

@@ -1,3 +1,25 @@
 import Gst from 'gi://Gst?version=1.0';
 export declare function ensureGstInit(): void;
+/**
+ * Whether a GStreamer pipeline that spins its own streaming threads
+ * (`decodebin`, `playbin`, …) is UNSAFE to run on the current runtime.
+ *
+ * Under the `@gjsify/node-gi` reverse bridge, **bun** and **deno** drive the
+ * GLib main context with a pure `iterateMainContext` pump and no libuv
+ * coupling. GStreamer's own streaming threads then race the JS engine's
+ * garbage collector during pipeline teardown (a GObject finalize firing on a
+ * streaming thread while the engine drains its toggle-ref queue) and
+ * NONDETERMINISTICALLY segfault the process — reproduced on bun with the
+ * synchronous `decodebin` decode path; deno shares the same pump so is guarded
+ * defensively. GJS (native GStreamer) and Node (uv-coupled main loop) drive the
+ * identical pipeline safely, so they are NOT affected.
+ *
+ * Callers use this to fail cleanly (a rejected `EncodingError`, which every
+ * WebAudio consumer already handles) instead of crashing. This closes no
+ * working capability: GStreamer decode does not function on the node target at
+ * all (decodebin returns no samples via the reverse bridge), so the only
+ * behavior change is turning a nondeterministic crash into a clean rejection.
+ * Tracked as a node-gi GStreamer-threading follow-up.
+ */
+export declare function isGstStreamingUnsafe(): boolean;
 export { Gst };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/webaudio",
-    "version": "0.19.0",
+    "version": "0.21.0",
     "description": "Web Audio API for GJS using GStreamer as audio backend",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -42,7 +42,7 @@
         "audio-api"
     ],
     "dependencies": {
-        "@gjsify/dom-events": "^0.19.0"
+        "@gjsify/dom-events": "^0.21.0"
     },
     "devDependencies": {
         "@girs/gjs": "^4.1.0",
@@ -51,8 +51,8 @@
         "@girs/gstapp-1.0": "^4.1.0",
         "@girs/gstaudio-1.0": "^4.1.0",
         "@girs/gstbase-1.0": "^4.1.0",
-        "@gjsify/cli": "^0.19.0",
-        "@gjsify/unit": "^0.19.0",
+        "@gjsify/cli": "^0.21.0",
+        "@gjsify/unit": "^0.21.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },