gowm 1.0.3 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gowm",
-    "version": "1.0.3",
+    "version": "1.0.5",
     "description": "Go Wasm Manager - Simplify integration of Go WebAssembly modules in your JavaScript projects",
     "main": "src/index.js",
     "browser": "src/browser.js",
@@ -64,5 +64,8 @@
     },
     "devDependencies": {
         "@types/node": "^20.0.0"
+    },
+    "dependencies": {
+        "node-fetch": "^3.3.2"
     }
-}
+}

package/src/README.md

@@ -0,0 +1,54 @@
+# GoWM Source Architecture
+
+## Loader Files
+
+### `loader.js` (Principal)
+- **Role**: Main WASM loader used by `index.js`
+- **Features**: 
+  - Support for local files and HTTP URLs
+  - Node.js and browser compatibility
+  - Automatic node-fetch import for HTTP requests in Node.js
+  - Module caching and cleanup
+- **Usage**: Used by default in `index.js`
+
+### `loader-browser.js` (Spécialisé)
+- **Role**: Browser-specific optimized loader
+- **Features**:
+  - Lightweight version for browser environments
+  - No Node.js dependencies
+  - Optimized for web bundlers
+- **Usage**: Can be used for browser-only builds
+
+### `loader-safe.js` (Alternative)
+- **Role**: Enhanced version with additional error handling
+- **Features**:
+  - Dynamic require loading to avoid bundling issues
+  - Enhanced error checking and fallbacks
+  - Better compatibility with various build systems
+- **Usage**: Alternative for environments with strict security or bundling requirements
+
+## Core Files
+
+### `index.js`
+- Main GoWM class with GitHub loading capabilities
+- Uses `loader.js` by default
+
+### `bridge.js` & `bridge-browser.js`
+- WASM instance wrapper and Go communication bridge
+- Browser-specific optimizations in `bridge-browser.js`
+
+### `browser.js`
+- Browser-specific utilities and optimizations
+
+---
+
+## File Usage
+
+**Active files (used by package):**
+- `index.js` ← imports `loader.js`
+- `loader.js` (main)
+- `loader-browser.js` (browser builds)
+- `bridge.js` / `bridge-browser.js`
+
+**Optional files:**
+- `loader-safe.js` (alternative implementation) 

package/src/index.js

@@ -101,8 +101,24 @@ class GoWM {
             return `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${basePath}${options.filename}`;
         }
 
+        // If module name is provided, try module-specific paths first
+        let possibleFilenames = [];
+        
+        if (options.name) {
+            possibleFilenames.push(
+                `${options.name}/main.wasm`,
+                `${options.name}/index.wasm`,
+                `${options.name}/${options.name}.wasm`,
+                `${options.name}/module.wasm`,
+                `${options.name}/dist/main.wasm`,
+                `${options.name}/dist/index.wasm`,
+                `${options.name}/build/main.wasm`,
+                `${options.name}/build/index.wasm`
+            );
+        }
+
         // Try different common WASM filenames with fallback
-        const possibleFilenames = [
+        possibleFilenames.push(
             'main.wasm',
             'index.wasm',
             `${repo}.wasm`,
@@ -116,7 +132,7 @@ class GoWM {
             'build/main.wasm',
             'build/index.wasm',
             `build/${repo}.wasm`
-        ];
+        );
 
         // Try each possible filename
         for (const filename of possibleFilenames) {
@@ -192,14 +208,21 @@ class GoWM {
     }
 
     /**
-     * Check if a URL exists (for browsers)
+     * Check if a URL exists (for browsers and Node.js)
      * @param {string} url - URL to check
      * @returns {Promise<boolean>} Whether URL exists
      */
     async checkUrlExists(url) {
         if (typeof fetch === 'undefined') {
-            // In Node.js, assume URL exists (will be validated during actual load)
-            return true;
+            // In Node.js, import node-fetch if available
+            try {
+                const nodeFetch = require('node-fetch');
+                const response = await nodeFetch(url, { method: 'HEAD' });
+                return response.ok;
+            } catch (error) {
+                // If node-fetch is not available, assume URL exists (will be validated during actual load)
+                return true;
+            }
         }
 
         try {

package/src/loader.js

@@ -34,12 +34,30 @@ class WasmLoader {
             const go = new globalThis.Go();
             let wasmBytes;
 
-            if (this.isNode) {
+            // Check if wasmPath is a URL
+            const isUrl = wasmPath.startsWith('http://') || wasmPath.startsWith('https://');
+
+            if (this.isNode && !isUrl) {
+                // Local file path in Node.js
                 if (!this.fs.existsSync(wasmPath)) {
                     throw new Error(`WASM file not found: ${wasmPath}`);
                 }
                 wasmBytes = this.fs.readFileSync(wasmPath);
             } else {
+                // Use fetch for URLs in both Node.js and browser
+                if (this.isNode && typeof fetch === 'undefined') {
+                    // Import node-fetch for Node.js environments that don't have fetch
+                    try {
+                        const nodeFetch = require('node-fetch');
+                        global.fetch = nodeFetch;
+                    } catch (e) {
+                        // Fall back to built-in fetch (Node.js 18+) or throw error
+                        if (typeof fetch === 'undefined') {
+                            throw new Error('fetch is not available. Please install node-fetch: npm install node-fetch');
+                        }
+                    }
+                }
+
                 const response = await fetch(wasmPath);
                 if (!response.ok) {
                     throw new Error(`Failed to fetch WASM file: ${response.status} ${response.statusText}`);