@veltdev/react 5.0.0-beta.2 → 5.0.0-beta.4

package/esm/types/constants.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-export declare const VELT_SDK_VERSION = "5.0.0-beta.2";
+export declare const VELT_SDK_VERSION = "5.0.0-beta.4";
 export declare const VELT_SDK_INIT_EVENT = "onVeltInit";
 export declare const VELT_TAB_ID = "veltTabId";
 export declare const INTEGRITY_MAP: Record<string, string>;

package/esm/types/loadSnippyly.d.ts

@@ -1,2 +1,28 @@
-declare const loadVelt: (callback: Function, version?: string, staging?: boolean, develop?: boolean, proxyDomain?: string, integrity?: boolean, integrityValue?: string) => void;
+/**
+ * Loads the Velt script dynamically and calls the callback when ready.
+ * Returns a cleanup function to remove the event listener if component unmounts.
+ *
+ * ## Issue (Rapid Mount/Unmount with Slow Network)
+ *
+ * When VeltProvider is rapidly mounted/unmounted (e.g., conditional rendering,
+ * React Strict Mode, or route changes) while the Velt script is still loading
+ * over a slow network, multiple issues can occur:
+ *
+ * 1. First component mount creates the script tag and starts loading
+ * 2. Component unmounts before script loads (script tag remains in DOM)
+ * 3. Second component mount finds existing script tag
+ * 4. OLD BEHAVIOR: Immediately triggered callback assuming script was loaded
+ * 5. PROBLEM: Script wasn't actually loaded yet (still loading due to network delay)
+ * 6. This caused initVelt to run with window.Velt = undefined
+ *
+ * ## Fix
+ *
+ * 1. Check if window.Velt exists before triggering callback for existing scripts
+ * 2. If script tag exists but window.Velt doesn't, attach a new load event listener
+ * 3. Return a cleanup function that removes the event listener when component unmounts
+ * 4. This prevents orphaned callbacks from firing on destroyed component instances
+ *
+ * @returns Cleanup function to remove event listener (call on component unmount)
+ */
+declare const loadVelt: (callback: Function, version?: string, staging?: boolean, develop?: boolean, proxyDomain?: string, integrity?: boolean, integrityValue?: string) => (() => void);
 export default loadVelt;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@veltdev/react",
-    "version": "5.0.0-beta.2",
+    "version": "5.0.0-beta.4",
     "description": "Velt is an SDK to add collaborative features to your product within minutes. Example: Comments like Figma, Frame.io, Google docs or sheets, Recording like Loom, Huddles like Slack and much more.",
     "homepage": "https://velt.dev",
     "keywords": [