feat(hermes): web integration via static assets (#530)

* feat: enhance Flutter asset serving and HTTP routing security

- Fix host header parsing by stripping port numbers for proper routing
- Add comprehensive Flutter web asset serving with MIME type detection
- Implement security headers (COOP/COEP) for SharedArrayBuffer support
- Improve asset caching and fallback logic for navigation routes
- Add version configuration and manifest updates
- Disable HDF5 compression in tests for debugging

* chore: bump catalyst-ci version from v3.5.4 to v3.5.13

- Update all Earthfile imports to use catalyst-ci v3.5.13
- Update build number in hermes http-proxy version.json
- Affects WASM modules, integration tests, documentation, and Hermes components

* Add additional web asset copying to WASM build pipeline

- Copy main.dart.js_1.part.js, sqlite3.wasm, and drift_worker.js to www/ directory
- Add fallback logging for missing files to improve build visibility
- Support additional Flutter/Drift dependencies in Hermes WASM modules

* refactor(routing): improve docs and extract constants

- Add comprehensive routing documentation with Flutter web context
- Extract magic strings to constants (DEFAULT_INDEX_PATH, DOCUMENT_ROOT)
- Refactor routing logic with RouteType enum for better separation
- Apply security headers to 404 responses consistently

* fix: simplify HTTP routing documentation and headers handling

- Remove redundant code comment diagrams from serve_static_web_content
- Fix add_security_headers return to use ? operator consistency
- Update build number for http-proxy module

* fix: simplify HTTP routing documentation and headers handling

- Remove redundant code comment diagrams from serve_static_web_content
- Fix add_security_headers return to use ? operator consistency
- Update build number for http-proxy module

* fix: simplify HTTP routing documentation and headers handling

- Remove redundant code comment diagrams from serve_static_web_content
- Fix add_security_headers return to use ? operator consistency
- Update build number for http-proxy module

* refactor: streamline routing code and documentation

* refactor(http-gateway): streamline routing logic and improve error handling

- Better hostname validation and parsing
- Simplified WebAssembly request processing
- Improved error responses and documentation
- Clean up unused imports and optimize header handling

* refactor(http-gateway): streamline routing logic and improve error handling

- Better hostname validation and parsing
- Simplified WebAssembly request processing
- Improved error responses and documentation
- Clean up unused imports and optimize header handling

* - Clean up HTTP gateway routing module formatting
- Add COEP and Embedder terms to project dictionary

* - Clean up HTTP gateway routing module formatting
- Add COEP and Embedder terms to project dictionary

* Remove Flutter-specific cache headers from HTTP gateway

- Remove add_flutter_cache_headers function and its usage
- Remove is_critical_file helper function
- Simplify static file serving by removing custom cache control logic
- Streamline HTTP gateway routing implementation

* Remove unused Dart MIME type mapping

Remove dart -> application/dart mapping from content type detection
as it's no longer needed in the HTTP gateway routing.

* refactor(http-gateway): improve path validation and add documentation

- Replace inline regex compilation with LazyLock for performance
- Refactor is_valid_path to use functional style with better error handling
- Add comprehensive documentation for HTTP routing functions
- Extract content-type and cache-control constants for maintainability
- Clean up code formatting and improve readability

chore: remove trailing empty lines from Earthfiles

* refactor(http-gateway): improve path validation and add documentation

- Replace inline regex compilation with LazyLock for performance
- Refactor is_valid_path to use functional style with better error handling
- Add comprehensive documentation for HTTP routing functions
- Extract content-type and cache-control constants for maintainability
- Clean up code formatting and improve readability

chore: remove trailing empty lines from Earthfiles

Author: cong-or

.config/dictionaries/project.dic

@@ -151,3 +151,6 @@ xprivate
 xprv
 xpub
 zilla
+Embedder
+COEP
+canvaskit

Earthfile

@@ -3,6 +3,7 @@ VERSION 0.8
 IMPORT github.com/input-output-hk/catalyst-ci/earthly/mdlint:v3.5.14 AS mdlint-ci
 IMPORT github.com/input-output-hk/catalyst-ci/earthly/cspell:v3.5.14 AS cspell-ci
 
+
 # cspell: words livedocs sitedocs
 
 # check-markdown : markdown check using catalyst-ci.

hermes/apps/athena/manifest_app.json

@@ -1,11 +1,13 @@
 {
     "$schema": "https://raw.githubusercontent.com/input-output-hk/hermes/main/hermes/schemas/hermes_app_manifest.schema.json",
+    "name": "app",
     "icon": "icon.svg",
     "metadata": "metadata.json",
     "modules": [
         {
             "package": "modules/http-proxy/lib/http_proxy.hmod",
             "name": "http_proxy"
         }
-    ]
+    ],
+    "www": "modules/http-proxy/lib/www"
 }

hermes/apps/athena/modules/Earthfile

@@ -9,6 +9,7 @@ VERSION 0.8
 # This includes: rustc, cargo, wasm32-wasip2 target, optimization tools, and build utilities
 IMPORT github.com/input-output-hk/catalyst-ci/earthly/rust:v3.5.14 AS rust-ci
 
+
 # Alternative for local catalyst-ci debugging (uncomment when needed):
 # IMPORT ../../../catalyst-ci/earthly/rust AS rust-ci
 
@@ -122,10 +123,7 @@ gen-bindings:
 # Output: http_proxy.wasm - Executable WebAssembly module
 # Duration: ~3-5 minutes (Rust compilation to WASM)
 local-build-http-proxy:
-    # Initialize the Rust CI environment with pre-configured toolchain
     DO rust-ci+SETUP
-
-    # Set working directory for build process
     WORKDIR /app
 
     # Copy source code and project configuration
@@ -140,17 +138,35 @@ local-build-http-proxy:
     COPY http-proxy/lib/manifest_module.json .
     COPY http-proxy/lib/metadata.json .
     COPY http-proxy/lib/settings.schema.json .
+    
+    # Create the missing config.json file (empty JSON object)
+    RUN echo '{}' > config.json
+
+    # Download web assets directly to root level
+    COPY github.com/input-output-hk/catalyst-voices/catalyst_voices+build-web/web .
 
     # Compile Rust code to WebAssembly
     DO rust-ci+CARGO \
         --args "build --target wasm32-wasip2 --release" \
         --output="wasm32-wasip2/release/http_proxy.wasm"
 
-    # Export build artifacts
-    SAVE ARTIFACT target/wasm32-wasip2/release/http_proxy.wasm http_proxy.wasm
+    # Create staging directory structure
+    RUN mkdir -p /staging/www
+
+    # Copy WASM module and JSON config files to root of staging
+    RUN cp target/wasm32-wasip2/release/http_proxy.wasm /staging/
+    RUN cp *.json /staging/ || true
+
+    # Copy web assets to www subdirectory
+    RUN cp -r assets /staging/www/ || true
+    RUN cp -r canvaskit /staging/www/ || true
+    RUN cp -r icons /staging/www/ || true
+
+    # Copy all regular files from current directory to staging/www, skip directories
+    RUN find . -maxdepth 1 -type f -exec cp {} /staging/www/ \; 2>/dev/null || echo "⚠️  Some files may not have been copied"
 
-    # Save to local filesystem in expected location for packaging
-    SAVE ARTIFACT target/wasm32-wasip2/release/http_proxy.wasm AS LOCAL http-proxy/lib/http_proxy.wasm
+    # Export build artifacts from staging directory
+    SAVE ARTIFACT /staging AS LOCAL http-proxy/lib
 
 # Future Module Build Targets
 # ============================

hermes/apps/athena/modules/http-proxy/lib/config.json

@@ -1 +1 @@
-{}
+{}

hermes/apps/athena/modules/http-proxy/lib/manifest.json

@@ -0,0 +1,23 @@
+{
+  "name": "Catalyst Voices",
+  "short_name": "Catalyst Voices",
+  "start_url": ".",
+  "display": "standalone",
+  "background_color": "#0175C2",
+  "theme_color": "#0175C2",
+  "description": "Catalyst Voices",
+  "orientation": "portrait-primary",
+  "prefer_related_applications": false,
+  "icons": [
+    {
+      "src": "icons/Icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "icons/Icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    }
+  ]
+}

hermes/apps/athena/modules/http-proxy/lib/manifest_module.json

@@ -9,5 +9,6 @@
     },
     "settings": {
         "schema": "settings.schema.json"
-    }
+    },
+    "share": "www"
 }

hermes/apps/athena/modules/http-proxy/lib/version.json

@@ -0,0 +1 @@
+{"app_name":"catalyst_voices","version":"0.1.0","build_number":"1757006451","package_name":"catalyst_voices"}

hermes/bin/src/logger.rs

@@ -6,7 +6,7 @@ use derive_more::Display;
 use tracing::level_filters::LevelFilter;
 use tracing_subscriber::{
     fmt::{format::FmtSpan, time},
-    FmtSubscriber,
+    EnvFilter, FmtSubscriber,
 };
 
 use crate::runtime_extensions::bindings::hermes::logging;
@@ -167,6 +167,8 @@ pub(crate) fn init(logger_config: &LoggerConfig) -> anyhow::Result<()> {
         .with_timer(time::UtcTime::rfc_3339())
         .with_span_events(FmtSpan::CLOSE)
         .with_max_level(LevelFilter::from_level(logger_config.log_level.into()))
+        // Hardcode the filter to always suppress IPFS noise
+        .with_env_filter(EnvFilter::new("hermes=info,rust_ipfs=error"))
         .finish();
 
     Ok(tracing::subscriber::set_global_default(subscriber)?)