feat: add frontend console logging support

Author: RAprogramm

CHANGELOG.md

@@ -3,6 +3,16 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.4.0] - 2025-09-15
+### Added
+- Optional `frontend` feature:
+  - Converts [`AppError`] and [`ErrorResponse`] into `wasm_bindgen::JsValue` for browser contexts.
+  - Logs structured errors to the browser console via `console.error`.
+- `BrowserConsoleError` and `BrowserConsoleExt` API for WASM front-ends.
+
+### Documentation
+- Documented browser/WASM support and console logging workflow in the README and crate docs.
+
 ## [0.3.5] - 2025-09-12
 ### Added
 - Conversion from `teloxide_core::RequestError` into `AppError` (feature `teloxide`).
@@ -111,4 +121,5 @@ All notable changes to this project will be documented in this file.
 [0.3.0]: https://github.com/RAprogramm/masterror/releases/tag/v0.3.0
 [0.2.1]: https://github.com/RAprogramm/masterror/releases/tag/v0.2.1
 [0.2.0]: https://github.com/RAprogramm/masterror/releases/tag/v0.2.0
+[0.4.0]: https://github.com/RAprogramm/masterror/releases/tag/v0.4.0
 

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "masterror"
-version = "0.3.5"
+version = "0.4.0"
 rust-version = "1.89"
 edition = "2024"
 description = "Application error types and response mapping"
@@ -26,6 +26,7 @@ tokio = ["dep:tokio"]
 reqwest = ["dep:reqwest"]
 teloxide = ["dep:teloxide-core"]
 telegram-webapp-sdk = ["dep:telegram-webapp-sdk"]
+frontend = ["dep:wasm-bindgen", "dep:js-sys", "dep:serde-wasm-bindgen"]
 turnkey = []
 
 openapi = ["dep:utoipa"]
@@ -58,6 +59,9 @@ tokio = { version = "1", optional = true, features = ["time"] }
 reqwest = { version = "0.12", optional = true, default-features = false }
 teloxide-core = { version = "0.13", optional = true, default-features = false }
 telegram-webapp-sdk = { version = "0.1", optional = true }
+wasm-bindgen = { version = "0.2", optional = true }
+js-sys = { version = "0.3", optional = true }
+serde-wasm-bindgen = { version = "0.6", optional = true }
 
 [dev-dependencies]
 serde_json = "1"

Cargo.toml

@@ -22,14 +22,15 @@ Stable categories, conservative HTTP mapping, no `unsafe`.
 
 ~~~toml
 [dependencies]
-masterror = { version = "0.3", default-features = false }
+masterror = { version = "0.4", default-features = false }
 # or with features:
-# masterror = { version = "0.3", features = [
+# masterror = { version = "0.4", features = [
 #   "axum", "actix", "serde_json", "openapi",
 #   "sqlx", "reqwest", "redis", "validator", "config", "tokio", "teloxide"
 # ] }
 ~~~
 
+*Since v0.4.0: optional `frontend` feature for WASM/browser console logging.*
 *Since v0.3.0: stable `AppCode` enum and extended `ErrorResponse` with retry/authentication metadata.*
 
 ---
@@ -53,10 +54,10 @@ masterror = { version = "0.3", default-features = false }
 ~~~toml
 [dependencies]
 # lean core
-masterror = { version = "0.3", default-features = false }
+masterror = { version = "0.4", default-features = false }
 
 # with Axum/Actix + JSON + integrations
-# masterror = { version = "0.3", features = [
+# masterror = { version = "0.4", features = [
 #   "axum", "actix", "serde_json", "openapi",
 #   "sqlx", "reqwest", "redis", "validator", "config", "tokio", "teloxide"
 # ] }
@@ -160,12 +161,37 @@ async fn payload() -> impl Responder {
 
 ~~~toml
 [dependencies]
-masterror = { version = "0.3", features = ["openapi", "serde_json"] }
+masterror = { version = "0.4", features = ["openapi", "serde_json"] }
 utoipa = "5"
 ~~~
 
 </details>
 
+<details>
+  <summary><b>Browser (WASM)</b></summary>
+
+~~~rust
+// features = ["frontend"]
+use masterror::{AppError, AppErrorKind};
+use masterror::frontend::{BrowserConsoleError, BrowserConsoleExt};
+
+fn report() -> Result<(), BrowserConsoleError> {
+    let err = AppError::bad_request("missing field");
+    let payload = err.to_js_value()?;
+    assert!(payload.is_object());
+
+    #[cfg(target_arch = "wasm32")]
+    err.log_to_browser_console()?;
+
+    Ok(())
+}
+~~~
+
+- On non-WASM targets `log_to_browser_console` returns
+  `BrowserConsoleError::UnsupportedTarget`.
+
+</details>
+
 <details>
   <summary><b>Feature flags</b></summary>
 
@@ -174,6 +200,7 @@ utoipa = "5"
 - `openapi` — utoipa schema
 - `serde_json` — JSON details
 - `sqlx`, `redis`, `reqwest`, `validator`, `config`, `tokio`, `multipart`, `teloxide`, `telegram-webapp-sdk`
+- `frontend` — convert errors into `JsValue` and log via `console.error` (WASM)
 - `turnkey` — domain taxonomy and conversions for Turnkey errors
 
 </details>
@@ -201,13 +228,13 @@ utoipa = "5"
 Minimal core:
 
 ~~~toml
-masterror = { version = "0.3", default-features = false }
+masterror = { version = "0.4", default-features = false }
 ~~~
 
 API (Axum + JSON + deps):
 
 ~~~toml
-masterror = { version = "0.3", features = [
+masterror = { version = "0.4", features = [
   "axum", "serde_json", "openapi",
   "sqlx", "reqwest", "redis", "validator", "config", "tokio"
 ] }
@@ -216,7 +243,7 @@ masterror = { version = "0.3", features = [
 API (Actix + JSON + deps):
 
 ~~~toml
-masterror = { version = "0.3", features = [
+masterror = { version = "0.4", features = [
   "actix", "serde_json", "openapi",
   "sqlx", "reqwest", "redis", "validator", "config", "tokio"
 ] }