Add fula-js WASM SDK and update workflows for npm package

Introduces the new fula-js crate providing high-level JavaScript/TypeScript APIs for Fula decentralized storage via WASM bindings. Updates GitHub Actions workflows to build, test, and verify the npm package, and bumps all workspace and package versions to 0.2.10. Changelog, podspec, and pubspec are updated to reflect the new release and features.

Author: ehsan6sha

.github/workflows/flutter-ci.yml

@@ -5,6 +5,7 @@ on:
     branches: [main]
     paths:
       - 'crates/fula-flutter/**'
+      - 'crates/fula-js/**'
       - 'crates/fula-client/**'
       - 'crates/fula-crypto/**'
       - 'packages/fula_client/**'
@@ -13,6 +14,7 @@ on:
   pull_request:
     paths:
       - 'crates/fula-flutter/**'
+      - 'crates/fula-js/**'
       - 'crates/fula-client/**'
       - 'crates/fula-crypto/**'
       - 'packages/fula_client/**'
@@ -41,10 +43,11 @@ jobs:
       - name: Run Rust tests
         run: |
           cargo test -p fula-flutter --lib
+          cargo test -p fula-js --lib
           cargo test -p fula-client --lib
           cargo test -p fula-crypto --lib
 
-  # Test WASM compilation
+  # Test WASM compilation (fula-js npm package)
   test-wasm:
     runs-on: ubuntu-latest
     steps:
@@ -60,8 +63,21 @@ jobs:
         with:
           shared-key: rust-wasm
 
-      - name: Build WASM
-        run: cargo build -p fula-flutter --target wasm32-unknown-unknown --release
+      - name: Install wasm-pack
+        run: cargo install wasm-pack
+
+      - name: Build WASM (fula-js)
+        run: |
+          cd crates/fula-js
+          wasm-pack build --release --target web
+
+      - name: Verify WASM package exports
+        run: |
+          echo "Checking TypeScript definitions..."
+          grep -q "createEncryptedClient" crates/fula-js/pkg/fula_js.d.ts
+          grep -q "getDecrypted" crates/fula-js/pkg/fula_js.d.ts
+          grep -q "deriveKey" crates/fula-js/pkg/fula_js.d.ts
+          echo "All expected exports found!"
 
   # Generate and validate Dart bindings
   generate-bindings:

.github/workflows/flutter-release.yml

@@ -209,7 +209,7 @@ jobs:
           path: ios-libs/
           retention-days: 1
 
-  # Build WASM package
+  # Build WASM package (fula-js with high-level wasm-bindgen APIs)
   build-wasm:
     needs: get-version
     runs-on: ubuntu-latest
@@ -229,29 +229,32 @@ jobs:
       - name: Install wasm-pack
         run: cargo install wasm-pack
 
-      - name: Build WASM
+      - name: Build WASM (fula-js)
         run: |
-          cd crates/fula-flutter
+          cd crates/fula-js
           wasm-pack build --release --target web --out-dir ../../wasm-package
 
-      - name: Create npm package.json
+      - name: Update package.json with version
         run: |
           cd wasm-package
+          # Update version from tag and ensure correct package name
           cat > package.json << INNEREOF
           {
             "name": "@functionland/fula-client",
             "version": "${{ needs.get-version.outputs.version }}",
-            "description": "Fula encrypted storage SDK for JavaScript/WASM",
-            "main": "fula_flutter.js",
-            "types": "fula_flutter.d.ts",
-            "files": ["*.js", "*.wasm", "*.d.ts", "snippets/**"],
+            "type": "module",
+            "description": "JavaScript/TypeScript SDK for Fula decentralized storage - client-side encryption with cross-platform key compatibility",
+            "main": "fula_js.js",
+            "types": "fula_js.d.ts",
+            "files": ["fula_js_bg.wasm", "fula_js.js", "fula_js.d.ts"],
             "repository": {
               "type": "git",
               "url": "https://github.com/functionland/fula-api"
             },
-            "keywords": ["fula", "storage", "encryption", "wasm", "decentralized"],
-            "author": "Functionland",
-            "license": "Apache-2.0"
+            "homepage": "https://github.com/functionland/fula-api#readme",
+            "keywords": ["fula", "ipfs", "decentralized", "storage", "encryption", "wasm", "web3"],
+            "author": "Functionland <[email protected]>",
+            "license": "MIT OR Apache-2.0"
           }
           INNEREOF
 

Cargo.lock

@@ -7,6 +7,7 @@ members = [
     "crates/fula-cli",
     "crates/fula-client",
     "crates/fula-flutter",
+    "crates/fula-js",
 ]
 
 # Root package for examples
@@ -73,7 +74,7 @@ name = "encrypted_upload_test"
 path = "examples/encrypted_upload_test.rs"
 
 [workspace.package]
-version = "0.1.0"
+version = "0.2.10"
 edition = "2021"
 license = "MIT OR Apache-2.0"
 repository = "https://github.com/functionland/fula-api"

Cargo.toml

@@ -0,0 +1,50 @@
+[package]
+name = "fula-js"
+description = "JavaScript/TypeScript SDK for Fula decentralized storage - WASM bindings"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+authors.workspace = true
+rust-version.workspace = true
+
+[package.metadata.wasm-pack.profile.release]
+wasm-opt = false
+
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[dependencies]
+# Internal crates (WASM-compatible configuration)
+fula-client = { path = "../fula-client" }
+fula-crypto = { path = "../fula-crypto", default-features = false, features = ["wasm"] }
+
+# WASM bindings
+wasm-bindgen = "0.2"
+wasm-bindgen-futures = "0.4"
+js-sys = "0.3"
+
+# Serialization for JS interop
+serde = { workspace = true }
+serde_json = { workspace = true }
+serde-wasm-bindgen = "0.6"
+
+# Error handling
+console_error_panic_hook = "0.1"
+
+# Random number generation for WASM
+getrandom = { version = "0.2", features = ["js"] }
+
+# Utilities
+bytes = { workspace = true }
+base64 = { workspace = true }
+
+# Async (WASM-compatible)
+futures = { workspace = true }
+
+[dependencies.web-sys]
+version = "0.3"
+features = ["console"]
+
+[dev-dependencies]
+wasm-bindgen-test = "0.3"