@birdie-so/snippet 1.1.0 → 1.1.1

package/README.md

@@ -76,6 +76,9 @@ initBirdie({
     birdie.on("recorderClose", (data) => {
       console.log("Recorder tab was closed", data);
     });
+    birdie.on("error", (error) => {
+      console.log("Something went wrong", error);
+    });
   }
 
 });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@birdie-so/snippet",
-    "version": "1.1.0",
+    "version": "1.1.1",
     "description": "Helper for integrating the Birdie screen recording snippet into modern JavaScript apps. Requires a Birdie account.",
     "type": "module",
     "main": "src/index.js",

package/src/index.d.ts

@@ -17,11 +17,49 @@ export interface BirdieSettings {
      * Callback when Birdie is fully loaded and available as `window.birdie`.
      */
     onReady?: (birdie: BirdieAPI) => void;
+
+    /**
+     * If true (default), guarantees at most one active handler per event.
+     * Re-registering the same event replaces the previous handler (prevents double fires on remount/HMR).
+     */
+    singleHandlerPerEvent?: boolean;
 }
 
+// export interface BirdieAPI {
+//     metadata: BirdieMetadata;
+//     on(event: 'start' | 'stop' | 'captureStarted' | 'captureStopped' | 'pause' | 'restart' | 'resume' | 'recorderClose' | 'recorderOpen' | 'recordingSent' | 'error', callback: (data: any) => void): void;
+// }
+
 export interface BirdieAPI {
     metadata: BirdieMetadata;
-    on(event: 'start' | 'stop' | 'captureStarted' | 'captureStopped' | 'pause' | 'restart' | 'resume' | 'recorderClose' | 'recorderOpen' | 'recordingSent', callback: (data: any) => void): void;
+
+    on(
+      event:
+        | 'start' | 'stop' | 'captureStarted' | 'captureStopped'
+        | 'pause' | 'restart' | 'resume'
+        | 'recorderClose' | 'recorderOpen'
+        | 'recordingSent' | 'error',
+      callback: (data: any) => void
+    ): void;
+
+    off(
+      event:
+        | 'start' | 'stop' | 'captureStarted' | 'captureStopped'
+        | 'pause' | 'restart' | 'resume'
+        | 'recorderClose' | 'recorderOpen'
+        | 'recordingSent' | 'error',
+      callback: (data: any) => void
+    ): void;
+  
+    /** Auto-unsubscribes after the first event emission. */
+    onOnce(
+      event:
+        | 'start' | 'stop' | 'captureStarted' | 'captureStopped'
+        | 'pause' | 'restart' | 'resume'
+        | 'recorderClose' | 'recorderOpen'
+        | 'recordingSent' | 'error',
+      callback: (data: any) => void
+    ): void;
 }
 
 /**

package/src/index.js

@@ -1,9 +1,9 @@
 let _readyCallbacks = [];
 
-export function initBirdie({ clientId, metadata, onReady, ...otherSettings }) {
-    
-    
-    
+export function initBirdie({ clientId, metadata, onReady, singleHandlerPerEvent = true, ...otherSettings }) {
+
+
+
     if (!clientId) {
         console.error('[Birdie] Missing required clientId in initBirdie()');
         return;
@@ -21,7 +21,12 @@ export function initBirdie({ clientId, metadata, onReady, ...otherSettings }) {
     Object.assign(window.birdieSettings, otherSettings);
 
     window.birdieSettings.onBirdieReady = () => {
-        _readyCallbacks.forEach(cb => { try { cb(window.birdie); } catch(e) { console.error('[Birdie] onReady error', e); }});
+        try {
+            installBirdieGuards({ singleHandlerPerEvent });
+        } catch (e) {
+            console.error('[Birdie] guard install error', e);
+        }
+        _readyCallbacks.forEach(cb => { try { cb(window.birdie); } catch (e) { console.error('[Birdie] onReady error', e); } });
         _readyCallbacks = [];
     };
 
@@ -66,3 +71,45 @@ export function getBirdieInstance(onReady) {
         return null;
     }
 }
+
+// ---- guards & helpers ----
+function installBirdieGuards({ singleHandlerPerEvent }) {
+    const b = window.birdie;
+    if (!b || b.__pkgGuardsInstalled) return;
+
+    // Keep originals
+    const originalOn = b.on?.bind(b);
+    const originalOff = b.off?.bind(b);
+
+    // Registry of the single active handler per event (for dedupe)
+    const singletons = new Map();
+
+    // Add onOnce
+    b.onOnce = (event, cb) => {
+        const wrapper = (data) => {
+            try { cb(data); } finally { b.off?.(event, wrapper); }
+        };
+        b.on(event, wrapper);
+    };
+
+    if (singleHandlerPerEvent && originalOn && originalOff) {
+        b.on = (event, cb) => {
+            // If there was a previous handler for this event installed via this layer, remove it
+            const prev = singletons.get(event);
+            if (prev) {
+                try { originalOff(event, prev); } catch { }
+            }
+            singletons.set(event, cb);
+            return originalOn(event, cb);
+        };
+
+        b.off = (event, cb) => {
+            // Clean our registry if the same cb is removed
+            const prev = singletons.get(event);
+            if (prev === cb) singletons.delete(event);
+            return originalOff(event, cb);
+        };
+    }
+
+    b.__pkgGuardsInstalled = true;
+}