rn-remove-image-bg 0.0.20 → 0.0.23

package/README.md

@@ -325,18 +325,25 @@ try {
 > **First-time Use**: On Android, the ML Kit model downloads automatically on first use. The library waits for the download to complete (up to ~15 seconds with retries) before processing. Subsequent calls are instant.
 
 ### Web
-- **Technology**: [@imgly/background-removal](https://github.com/imgly/background-removal-js) running in a **Web Worker**.
-- **Performance**: Zero UI blocking. All processing happens in a background thread.
-- **Implementation**: 
-  - Uses an **Inline Worker** architecture.
-  - Loads the library from CDN (`jsdelivr`) automatically on first use.
-  - **No bundler configuration required**. Works with Metro, Webpack, Vite, etc. out of the box.
+
+1. **Add the Script**: You must add the `@imgly/background-removal` setup to your web `index.html`. 
+   Since the library is distributed as an ES Module, you need to import it and assign it to the window object:
+   ```html
+   <script type="module">
+     import { removeBackground } from "https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/+esm";
+     window.imglyRemoveBackground = removeBackground;
+   </script>
+   ```
+
+2. **Usage**: The library will automatically detect the global `imglyRemoveBackground` function.
+
+- **Technology**: [@imgly/background-removal](https://github.com/imgly/background-removal-js) running in a Web Worker (managed by the library).
+- **Performance**: Zero UI blocking.
+- **Output**: Data URL (`data:image/png;base64,...`) or WEBP Blob.
 - **Requirements**:
-  - **Internet Connection**: Required for the first run to download the library and assets (~10MB) from CDN.
   - **CORS**: Images loaded from external URLs must be CORS-enabled (`Access-Control-Allow-Origin: *`).
-- **Output**: Data URL (`data:image/png;base64,...`) or WEBP Blob.
 
-> **Note on Local Development**: If you see CSP errors, ensure your development server allows loading scripts from `cdn.jsdelivr.net`.
+> **Note**: The first call will download the WASM model files (~10MB) from the CDN. Ensure your CSP allows `cdn.jsdelivr.net`.
 
 ---
 

package/lib/ImageProcessing.web.d.ts

@@ -1,7 +1,6 @@
 /**
- * Web implementation using @imgly/background-removal via Inline Web Worker.
- * Moves all heavy processing to a background thread to prevent UI freezing.
- * Loads library from CDN to bypass Metro bundler issues.
+ * Web implementation using @imgly/background-removal via Script Tag.
+ * Requires the script to be added manually to index.html.
  */
 export type OutputFormat = 'PNG' | 'WEBP';
 export interface RemoveBgImageOptions {

package/lib/ImageProcessing.web.js

@@ -1,128 +1,51 @@
 /**
- * Web implementation using @imgly/background-removal via Inline Web Worker.
- * Moves all heavy processing to a background thread to prevent UI freezing.
- * Loads library from CDN to bypass Metro bundler issues.
+ * Web implementation using @imgly/background-removal via Script Tag.
+ * Requires the script to be added manually to index.html.
  */
-// ==========================================
-// INLINE WORKER CODE (Run in background)
-// ==========================================
-const WORKER_CODE = `
-  let removeBackground = null;
-
-  self.onmessage = async (e) => {
-    const { id, type, payload } = e.data;
-
-    try {
-      if (type === 'init') {
-        if (typeof self.imglyBackgroundRemoval === 'undefined' || !removeBackground) {
-          // Use importScripts (Classic Worker) - most robust for Blob URLs
-          importScripts('https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/dist/imgly-background-removal.min.js');
-          
-          if (!self.imglyBackgroundRemoval) {
-             throw new Error('imglyBackgroundRemoval not loaded via importScripts'); 
-          }
-          
-          removeBackground = self.imglyBackgroundRemoval.removeBackground;
-        }
-        self.postMessage({ id, type: 'success', payload: true });
-        return;
-      }
-
-      if (type === 'removeBg') {
-        const { uri, config } = payload;
-        
-        if (!removeBackground) {
-           importScripts('https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/dist/imgly-background-removal.min.js');
-           removeBackground = self.imglyBackgroundRemoval.removeBackground;
+export async function removeBgImage(uri, options = {}) {
+    const { onProgress, debug = false } = options;
+    // Safety check
+    // @ts-ignore
+    if (typeof window !== 'undefined' && !window.imglyRemoveBackground) {
+        // Also check if user defined it as imglyRemoveBackground globally
+        // @ts-ignore
+        if (typeof imglyRemoveBackground !== 'undefined') {
+            // @ts-ignore
+            window.imglyRemoveBackground = imglyRemoveBackground;
         }
-
-        // Run Inference
-        // CRITICAL: Must point publicPath to CDN so it finds WASM/Models
-        // otherwise it tries to load from blob: URL
-        const blob = await removeBackground(uri, {
-           publicPath: 'https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/dist/',
-           progress: (key, current, total) => {
-              const p = current / total;
-              self.postMessage({ id, type: 'progress', payload: { progress: p } });
-           },
-           ...config
-        });
-
-        // Convert blob to DataURL for return
-        const reader = new FileReader();
-        reader.onloadend = () => {
-           self.postMessage({ id, type: 'success', payload: reader.result });
-        };
-        reader.readAsDataURL(blob);
-      }
-    } catch (err) {
-      self.postMessage({ id, type: 'error', payload: err.message || JSON.stringify(err) });
     }
-  };
-`;
-// ==========================================
-// MAIN THREAD BRIDGE
-// ==========================================
-let worker = null;
-const pendingMessages = new Map();
-function getWorker() {
-    if (!worker) {
-        const blob = new Blob([WORKER_CODE], { type: 'application/javascript' });
-        const url = URL.createObjectURL(blob);
-        worker = new Worker(url);
-        worker.onmessage = (e) => {
-            const { id, type, payload } = e.data;
-            const deferred = pendingMessages.get(id);
-            if (!deferred)
-                return;
-            if (type === 'progress') {
-                if (deferred.onProgress && payload.progress) {
-                    deferred.onProgress(payload.progress * 100);
-                }
-            }
-            else if (type === 'success') {
-                deferred.resolve(payload);
-                pendingMessages.delete(id);
-            }
-            else if (type === 'error') {
-                deferred.reject(new Error(payload));
-                pendingMessages.delete(id);
-            }
-        };
+    // @ts-ignore
+    if (typeof window.imglyRemoveBackground === 'undefined') {
+        throw new Error('[rn-remove-image-bg] Library not found. Please add the following script to your web index.html:\n' +
+            '<script type="module">\n' +
+            '  import { removeBackground } from "https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/+esm";\n' +
+            '  window.imglyRemoveBackground = removeBackground;\n' +
+            '</script>');
     }
-    return worker;
-}
-function sendToWorker(type, payload, onProgress) {
-    return new Promise((resolve, reject) => {
-        const id = Math.random().toString(36).substring(7);
-        pendingMessages.set(id, { resolve, reject, onProgress });
-        getWorker().postMessage({ id, type, payload });
-    });
-}
-// Initialize
-let initPromise = null;
-async function ensureInit() {
-    if (!initPromise) {
-        initPromise = sendToWorker('init', {});
-    }
-    return initPromise;
-}
-export async function removeBgImage(uri, options = {}) {
-    const { onProgress, debug = false } = options;
     if (debug)
         console.log('[rmbg] Starting...');
     onProgress?.(1);
-    // Ensure worker is ready
-    await ensureInit();
     // Config for imgly
     const config = {
         debug: debug,
-        // We can pass other options supported by imgly if needed
-        // device: 'gpu' is auto-detected usually
+        // Point publicPath to CDN for assets (wasm/models)
+        publicPath: 'https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/dist/',
+        progress: (_key, current, total) => {
+            if (onProgress && total > 0) {
+                onProgress((current / total) * 100);
+            }
+        }
     };
-    const result = await sendToWorker('removeBg', { uri, config }, onProgress);
+    // @ts-ignore
+    const blob = await window.imglyRemoveBackground(uri, config);
     onProgress?.(100);
-    return result;
+    // Convert blob to DataURL
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onloadend = () => resolve(reader.result);
+        reader.onerror = reject;
+        reader.readAsDataURL(blob);
+    });
 }
 export const removeBackground = removeBgImage;
 // ==========================================
@@ -192,11 +115,7 @@ export async function generateThumbhash(imageUri, options = {}) {
     }
 }
 export async function clearCache() {
-    if (worker) {
-        worker.terminate();
-        worker = null;
-    }
-    initPromise = null;
+    // Caching is handled internally by the library
 }
 export function getCacheSize() { return 0; }
 export async function onLowMemory() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rn-remove-image-bg",
-  "version": "0.0.20",
+  "version": "0.0.23",
   "description": "rn-remove-image-bg",
   "homepage": "https://github.com/a-eid/rn-remove-image-bg",
   "main": "lib/index",

package/src/ImageProcessing.web.ts

@@ -1,7 +1,6 @@
 /**
- * Web implementation using @imgly/background-removal via Inline Web Worker.
- * Moves all heavy processing to a background thread to prevent UI freezing.
- * Loads library from CDN to bypass Metro bundler issues.
+ * Web implementation using @imgly/background-removal via Script Tag.
+ * Requires the script to be added manually to index.html.
  */
 
 export type OutputFormat = 'PNG' | 'WEBP';
@@ -13,115 +12,9 @@ export interface RemoveBgImageOptions {
   debug?: boolean;
 }
 
-// ==========================================
-// INLINE WORKER CODE (Run in background)
-// ==========================================
-const WORKER_CODE = `
-  let removeBackground = null;
-
-  self.onmessage = async (e) => {
-    const { id, type, payload } = e.data;
-
-    try {
-      if (type === 'init') {
-        if (typeof self.imglyBackgroundRemoval === 'undefined' || !removeBackground) {
-          // Use importScripts (Classic Worker) - most robust for Blob URLs
-          importScripts('https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/dist/imgly-background-removal.min.js');
-          
-          if (!self.imglyBackgroundRemoval) {
-             throw new Error('imglyBackgroundRemoval not loaded via importScripts'); 
-          }
-          
-          removeBackground = self.imglyBackgroundRemoval.removeBackground;
-        }
-        self.postMessage({ id, type: 'success', payload: true });
-        return;
-      }
-
-      if (type === 'removeBg') {
-        const { uri, config } = payload;
-        
-        if (!removeBackground) {
-           importScripts('https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/dist/imgly-background-removal.min.js');
-           removeBackground = self.imglyBackgroundRemoval.removeBackground;
-        }
-
-        // Run Inference
-        // CRITICAL: Must point publicPath to CDN so it finds WASM/Models
-        // otherwise it tries to load from blob: URL
-        const blob = await removeBackground(uri, {
-           publicPath: 'https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/dist/',
-           progress: (key, current, total) => {
-              const p = current / total;
-              self.postMessage({ id, type: 'progress', payload: { progress: p } });
-           },
-           ...config
-        });
-
-        // Convert blob to DataURL for return
-        const reader = new FileReader();
-        reader.onloadend = () => {
-           self.postMessage({ id, type: 'success', payload: reader.result });
-        };
-        reader.readAsDataURL(blob);
-      }
-    } catch (err) {
-      self.postMessage({ id, type: 'error', payload: err.message || JSON.stringify(err) });
-    }
-  };
-`;
-
-// ==========================================
-// MAIN THREAD BRIDGE
-// ==========================================
-
-let worker: Worker | null = null;
-const pendingMessages = new Map<string, { resolve: (v: any) => void; reject: (e: any) => void; onProgress?: (p: number) => void }>();
-
-function getWorker() {
-  if (!worker) {
-    const blob = new Blob([WORKER_CODE], { type: 'application/javascript' });
-    const url = URL.createObjectURL(blob);
-    worker = new Worker(url);
-    
-    worker.onmessage = (e) => {
-      const { id, type, payload } = e.data;
-      const deferred = pendingMessages.get(id);
-      
-      if (!deferred) return;
-
-      if (type === 'progress') {
-        if (deferred.onProgress && payload.progress) {
-             deferred.onProgress(payload.progress * 100); 
-        }
-      } else if (type === 'success') {
-        deferred.resolve(payload);
-        pendingMessages.delete(id);
-      } else if (type === 'error') {
-        deferred.reject(new Error(payload));
-        pendingMessages.delete(id);
-      }
-    };
-  }
-  return worker;
-}
-
-function sendToWorker(type: string, payload: any, onProgress?: (p: number) => void): Promise<any> {
-  return new Promise((resolve, reject) => {
-    const id = Math.random().toString(36).substring(7);
-    pendingMessages.set(id, { resolve, reject, onProgress });
-    getWorker().postMessage({ id, type, payload });
-  });
-}
-
-// Initialize
-let initPromise: Promise<void> | null = null;
-async function ensureInit() {
-  if (!initPromise) {
-    initPromise = sendToWorker('init', {});
-  }
-  return initPromise;
-}
+// Check for global variable
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+declare const imglyRemoveBackground: any;
 
 export async function removeBgImage(
   uri: string,
@@ -129,23 +22,54 @@ export async function removeBgImage(
 ): Promise<string> {
     const { onProgress, debug = false } = options;
     
+    // Safety check
+    // @ts-ignore
+    if (typeof window !== 'undefined' && !window.imglyRemoveBackground) {
+       // Also check if user defined it as imglyRemoveBackground globally
+       // @ts-ignore
+       if (typeof imglyRemoveBackground !== 'undefined') {
+          // @ts-ignore
+          window.imglyRemoveBackground = imglyRemoveBackground;
+       }
+    }
+
+    // @ts-ignore
+    if (typeof window.imglyRemoveBackground === 'undefined') {
+       throw new Error(
+         '[rn-remove-image-bg] Library not found. Please add the following script to your web index.html:\n' +
+         '<script type="module">\n' +
+         '  import { removeBackground } from "https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/+esm";\n' +
+         '  window.imglyRemoveBackground = removeBackground;\n' +
+         '</script>'
+       );
+    }
+    
     if (debug) console.log('[rmbg] Starting...');
     onProgress?.(1); 
     
-    // Ensure worker is ready
-    await ensureInit();
-    
     // Config for imgly
     const config = {
        debug: debug,
-       // We can pass other options supported by imgly if needed
-       // device: 'gpu' is auto-detected usually
+       // Point publicPath to CDN for assets (wasm/models)
+       publicPath: 'https://cdn.jsdelivr.net/npm/@imgly/background-removal@1.7.0/dist/',
+       progress: (_key: string, current: number, total: number) => {
+          if (onProgress && total > 0) {
+             onProgress((current / total) * 100);
+          }
+       }
     };
     
-    const result = await sendToWorker('removeBg', { uri, config }, onProgress);
-    
+    // @ts-ignore
+    const blob = await window.imglyRemoveBackground(uri, config);
     onProgress?.(100);
-    return result as string;
+    
+    // Convert blob to DataURL
+    return new Promise((resolve, reject) => {
+       const reader = new FileReader();
+       reader.onloadend = () => resolve(reader.result as string);
+       reader.onerror = reject;
+       reader.readAsDataURL(blob);
+    });
 }
 
 export const removeBackground = removeBgImage;
@@ -250,11 +174,7 @@ export async function generateThumbhash(
 }
 
 export async function clearCache(): Promise<void> {
-  if (worker) {
-     worker.terminate();
-     worker = null;
-  }
-  initPromise = null;
+  // Caching is handled internally by the library
 }
 
 export function getCacheSize(): number { return 0; }