From fa42a897fe559cf4c2ba483b0a48840642c0152a Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Sun, 2 Jun 2024 21:57:30 +0200
Subject: [PATCH 01/29] starting wasm feature

---
 wasm/m-bus-parser-wasm-pack/.appveyor.yml     | 11 +++
 .../.github/dependabot.yml                    |  8 +++
 wasm/m-bus-parser-wasm-pack/.gitignore        |  6 ++
 wasm/m-bus-parser-wasm-pack/.travis.yml       | 69 +++++++++++++++++++
 wasm/m-bus-parser-wasm-pack/Cargo.toml        | 35 ++++++++++
 wasm/m-bus-parser-wasm-pack/README.md         |  3 +
 wasm/m-bus-parser-wasm-pack/src/lib.rs        | 16 +++++
 wasm/m-bus-parser-wasm-pack/src/utils.rs      | 10 +++
 wasm/m-bus-parser-wasm-pack/tests/web.rs      | 13 ++++
 9 files changed, 171 insertions(+)
 create mode 100644 wasm/m-bus-parser-wasm-pack/.appveyor.yml
 create mode 100644 wasm/m-bus-parser-wasm-pack/.github/dependabot.yml
 create mode 100644 wasm/m-bus-parser-wasm-pack/.gitignore
 create mode 100644 wasm/m-bus-parser-wasm-pack/.travis.yml
 create mode 100644 wasm/m-bus-parser-wasm-pack/Cargo.toml
 create mode 100644 wasm/m-bus-parser-wasm-pack/README.md
 create mode 100644 wasm/m-bus-parser-wasm-pack/src/lib.rs
 create mode 100644 wasm/m-bus-parser-wasm-pack/src/utils.rs
 create mode 100644 wasm/m-bus-parser-wasm-pack/tests/web.rs

diff --git a/wasm/m-bus-parser-wasm-pack/.appveyor.yml b/wasm/m-bus-parser-wasm-pack/.appveyor.yml
new file mode 100644
index 0000000..50910bd
--- /dev/null
+++ b/wasm/m-bus-parser-wasm-pack/.appveyor.yml
@@ -0,0 +1,11 @@
+install:
+  - appveyor-retry appveyor DownloadFile https://win.rustup.rs/ -FileName rustup-init.exe
+  - if not defined RUSTFLAGS rustup-init.exe -y --default-host x86_64-pc-windows-msvc --default-toolchain nightly
+  - set PATH=%PATH%;C:\Users\appveyor\.cargo\bin
+  - rustc -V
+  - cargo -V
+
+build: false
+
+test_script:
+  - cargo test --locked
diff --git a/wasm/m-bus-parser-wasm-pack/.github/dependabot.yml b/wasm/m-bus-parser-wasm-pack/.github/dependabot.yml
new file mode 100644
index 0000000..7377d37
--- /dev/null
+++ b/wasm/m-bus-parser-wasm-pack/.github/dependabot.yml
@@ -0,0 +1,8 @@
+version: 2
+updates:
+- package-ecosystem: cargo
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "08:00"
+  open-pull-requests-limit: 10
diff --git a/wasm/m-bus-parser-wasm-pack/.gitignore b/wasm/m-bus-parser-wasm-pack/.gitignore
new file mode 100644
index 0000000..4e30131
--- /dev/null
+++ b/wasm/m-bus-parser-wasm-pack/.gitignore
@@ -0,0 +1,6 @@
+/target
+**/*.rs.bk
+Cargo.lock
+bin/
+pkg/
+wasm-pack.log
diff --git a/wasm/m-bus-parser-wasm-pack/.travis.yml b/wasm/m-bus-parser-wasm-pack/.travis.yml
new file mode 100644
index 0000000..7a91325
--- /dev/null
+++ b/wasm/m-bus-parser-wasm-pack/.travis.yml
@@ -0,0 +1,69 @@
+language: rust
+sudo: false
+
+cache: cargo
+
+matrix:
+  include:
+
+  # Builds with wasm-pack.
+  - rust: beta
+    env: RUST_BACKTRACE=1
+    addons:
+      firefox: latest
+      chrome: stable
+    before_script:
+      - (test -x $HOME/.cargo/bin/cargo-install-update || cargo install cargo-update)
+      - (test -x $HOME/.cargo/bin/cargo-generate || cargo install --vers "^0.2" cargo-generate)
+      - cargo install-update -a
+      - curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh -s -- -f
+    script:
+      - cargo generate --git . --name testing
+      # Having a broken Cargo.toml (in that it has curlies in fields) anywhere
+      # in any of our parent dirs is problematic.
+      - mv Cargo.toml Cargo.toml.tmpl
+      - cd testing
+      - wasm-pack build
+      - wasm-pack test --chrome --firefox --headless
+
+  # Builds on nightly.
+  - rust: nightly
+    env: RUST_BACKTRACE=1
+    before_script:
+      - (test -x $HOME/.cargo/bin/cargo-install-update || cargo install cargo-update)
+      - (test -x $HOME/.cargo/bin/cargo-generate || cargo install --vers "^0.2" cargo-generate)
+      - cargo install-update -a
+      - rustup target add wasm32-unknown-unknown
+    script:
+      - cargo generate --git . --name testing
+      - mv Cargo.toml Cargo.toml.tmpl
+      - cd testing
+      - cargo check
+      - cargo check --target wasm32-unknown-unknown
+      - cargo check                                 --no-default-features
+      - cargo check --target wasm32-unknown-unknown --no-default-features
+      - cargo check                                 --no-default-features --features console_error_panic_hook
+      - cargo check --target wasm32-unknown-unknown --no-default-features --features console_error_panic_hook
+      - cargo check                                 --no-default-features --features "console_error_panic_hook wee_alloc"
+      - cargo check --target wasm32-unknown-unknown --no-default-features --features "console_error_panic_hook wee_alloc"
+
+  # Builds on beta.
+  - rust: beta
+    env: RUST_BACKTRACE=1
+    before_script:
+      - (test -x $HOME/.cargo/bin/cargo-install-update || cargo install cargo-update)
+      - (test -x $HOME/.cargo/bin/cargo-generate || cargo install --vers "^0.2" cargo-generate)
+      - cargo install-update -a
+      - rustup target add wasm32-unknown-unknown
+    script:
+      - cargo generate --git . --name testing
+      - mv Cargo.toml Cargo.toml.tmpl
+      - cd testing
+      - cargo check
+      - cargo check --target wasm32-unknown-unknown
+      - cargo check                                 --no-default-features
+      - cargo check --target wasm32-unknown-unknown --no-default-features
+      - cargo check                                 --no-default-features --features console_error_panic_hook
+      - cargo check --target wasm32-unknown-unknown --no-default-features --features console_error_panic_hook
+      # Note: no enabling the `wee_alloc` feature here because it requires
+      # nightly for now.
diff --git a/wasm/m-bus-parser-wasm-pack/Cargo.toml b/wasm/m-bus-parser-wasm-pack/Cargo.toml
new file mode 100644
index 0000000..61e1cd7
--- /dev/null
+++ b/wasm/m-bus-parser-wasm-pack/Cargo.toml
@@ -0,0 +1,35 @@
+[package]
+name = "m-bus-parser-wasm-pack"
+version = "0.0.0"
+edition = "2021"
+description = "A wasm-pack to use the library for parsing M-Bus frames"
+license = "MIT"
+homepage = "https://maebli.github.io/"
+repository = "https://github.com/maebli/m-bus-parser"
+readme = "README.md"
+authors = ["Michael Aebli"]
+keywords = ["m-bus", "parser", "parse", "wasm-pack"]
+
+
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[features]
+default = ["console_error_panic_hook"]
+
+[dependencies]
+wasm-bindgen = "0.2.84"
+
+# The `console_error_panic_hook` crate provides better debugging of panics by
+# logging them with `console.error`. This is great for development, but requires
+# all the `std::fmt` and `std::panicking` infrastructure, so isn't great for
+# code size when deploying.
+console_error_panic_hook = { version = "0.1.7", optional = true }
+
+[dev-dependencies]
+wasm-bindgen-test = "0.3.34"
+m-bus-parser = { path = "..", version = "0.0.7", features = ["std"] }
+
+[profile.release]
+# Tell `rustc` to optimize for small code size.
+opt-level = "s"
diff --git a/wasm/m-bus-parser-wasm-pack/README.md b/wasm/m-bus-parser-wasm-pack/README.md
new file mode 100644
index 0000000..528b8a6
--- /dev/null
+++ b/wasm/m-bus-parser-wasm-pack/README.md
@@ -0,0 +1,3 @@
+# WASM Package for m-bus-parser (wired)
+
+This package is a WebAssembly (WASM) package for the mbus parser so it  may be used in the browser for example. 
\ No newline at end of file
diff --git a/wasm/m-bus-parser-wasm-pack/src/lib.rs b/wasm/m-bus-parser-wasm-pack/src/lib.rs
new file mode 100644
index 0000000..149805a
--- /dev/null
+++ b/wasm/m-bus-parser-wasm-pack/src/lib.rs
@@ -0,0 +1,16 @@
+mod utils;
+use m_bus_parser;
+
+use wasm_bindgen::prelude::*;
+
+#[wasm_bindgen]
+extern "C" {
+    fn alert(s: &str);
+}
+
+#[wasm_bindgen]
+pub fn parse(s: &str) -> String {
+    // remove  white space
+    let s = s.trim().replace([' ', "0x", '\\'], "");
+    m_bus_parser.parse(s);
+}
diff --git a/wasm/m-bus-parser-wasm-pack/src/utils.rs b/wasm/m-bus-parser-wasm-pack/src/utils.rs
new file mode 100644
index 0000000..b1d7929
--- /dev/null
+++ b/wasm/m-bus-parser-wasm-pack/src/utils.rs
@@ -0,0 +1,10 @@
+pub fn set_panic_hook() {
+    // When the `console_error_panic_hook` feature is enabled, we can call the
+    // `set_panic_hook` function at least once during initialization, and then
+    // we will get better error messages if our code ever panics.
+    //
+    // For more details see
+    // https://github.com/rustwasm/console_error_panic_hook#readme
+    #[cfg(feature = "console_error_panic_hook")]
+    console_error_panic_hook::set_once();
+}
diff --git a/wasm/m-bus-parser-wasm-pack/tests/web.rs b/wasm/m-bus-parser-wasm-pack/tests/web.rs
new file mode 100644
index 0000000..de5c1da
--- /dev/null
+++ b/wasm/m-bus-parser-wasm-pack/tests/web.rs
@@ -0,0 +1,13 @@
+//! Test suite for the Web and headless browsers.
+
+#![cfg(target_arch = "wasm32")]
+
+extern crate wasm_bindgen_test;
+use wasm_bindgen_test::*;
+
+wasm_bindgen_test_configure!(run_in_browser);
+
+#[wasm_bindgen_test]
+fn pass() {
+    assert_eq!(1 + 1, 2);
+}

From ea594d3ddd20fdb10cadc438c54c140f8855311f Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Sun, 9 Jun 2024 12:40:16 +0200
Subject: [PATCH 02/29] fixing clippy error

---
 src/lib.rs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/lib.rs b/src/lib.rs
index 6dae634..32c7316 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -77,9 +77,7 @@ impl From<FrameError> for MbusError {
 
 impl From<ApplicationLayerError> for MbusError {
     fn from(error: ApplicationLayerError) -> MbusError {
-        match error {
-            _ => MbusError::ApplicationLayerError(error),
-        }
+        MbusError::ApplicationLayerError(error)
     }
 }
 

From 2bdaf58151ba1719c114b5c941501a2369c58a5c Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Mon, 10 Jun 2024 22:42:48 +0200
Subject: [PATCH 03/29] moving module up

---
 Cargo.toml                                    |  2 +-
 cli/Cargo.toml                                |  2 +-
 wasm/{m-bus-parser-wasm-pack => }/Cargo.toml  |  2 +-
 wasm/{m-bus-parser-wasm-pack => }/README.md   |  0
 wasm/m-bus-parser-wasm-pack/.appveyor.yml     | 11 ---
 .../.github/dependabot.yml                    |  8 ---
 wasm/m-bus-parser-wasm-pack/.gitignore        |  6 --
 wasm/m-bus-parser-wasm-pack/.travis.yml       | 69 -------------------
 wasm/{m-bus-parser-wasm-pack => }/src/lib.rs  |  9 ++-
 .../{m-bus-parser-wasm-pack => }/src/utils.rs |  0
 .../{m-bus-parser-wasm-pack => }/tests/web.rs |  0
 11 files changed, 7 insertions(+), 102 deletions(-)
 rename wasm/{m-bus-parser-wasm-pack => }/Cargo.toml (93%)
 rename wasm/{m-bus-parser-wasm-pack => }/README.md (100%)
 delete mode 100644 wasm/m-bus-parser-wasm-pack/.appveyor.yml
 delete mode 100644 wasm/m-bus-parser-wasm-pack/.github/dependabot.yml
 delete mode 100644 wasm/m-bus-parser-wasm-pack/.gitignore
 delete mode 100644 wasm/m-bus-parser-wasm-pack/.travis.yml
 rename wasm/{m-bus-parser-wasm-pack => }/src/lib.rs (66%)
 rename wasm/{m-bus-parser-wasm-pack => }/src/utils.rs (100%)
 rename wasm/{m-bus-parser-wasm-pack => }/tests/web.rs (100%)

diff --git a/Cargo.toml b/Cargo.toml
index dfcaa5d..1d710a2 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -39,4 +39,4 @@ bitflags = "2.4.2"
 arrayvec = "0.7.4"
 
 [workspace]
-members = ["cli"]
+members = ["cli", "wasm"]
diff --git a/cli/Cargo.toml b/cli/Cargo.toml
index 0499778..d493a26 100644
--- a/cli/Cargo.toml
+++ b/cli/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "m-bus-parser-cli"
-version = "0.0.4"
+version = "0.0.3"
 edition = "2021"
 description = "A cli to use the library for parsing M-Bus frames"
 license = "MIT"
diff --git a/wasm/m-bus-parser-wasm-pack/Cargo.toml b/wasm/Cargo.toml
similarity index 93%
rename from wasm/m-bus-parser-wasm-pack/Cargo.toml
rename to wasm/Cargo.toml
index 61e1cd7..b4f2c00 100644
--- a/wasm/m-bus-parser-wasm-pack/Cargo.toml
+++ b/wasm/Cargo.toml
@@ -19,6 +19,7 @@ default = ["console_error_panic_hook"]
 
 [dependencies]
 wasm-bindgen = "0.2.84"
+m-bus-parser = { path = "..", version = "0.0.9", features = ["std"] }
 
 # The `console_error_panic_hook` crate provides better debugging of panics by
 # logging them with `console.error`. This is great for development, but requires
@@ -28,7 +29,6 @@ console_error_panic_hook = { version = "0.1.7", optional = true }
 
 [dev-dependencies]
 wasm-bindgen-test = "0.3.34"
-m-bus-parser = { path = "..", version = "0.0.7", features = ["std"] }
 
 [profile.release]
 # Tell `rustc` to optimize for small code size.
diff --git a/wasm/m-bus-parser-wasm-pack/README.md b/wasm/README.md
similarity index 100%
rename from wasm/m-bus-parser-wasm-pack/README.md
rename to wasm/README.md
diff --git a/wasm/m-bus-parser-wasm-pack/.appveyor.yml b/wasm/m-bus-parser-wasm-pack/.appveyor.yml
deleted file mode 100644
index 50910bd..0000000
--- a/wasm/m-bus-parser-wasm-pack/.appveyor.yml
+++ /dev/null
@@ -1,11 +0,0 @@
-install:
-  - appveyor-retry appveyor DownloadFile https://win.rustup.rs/ -FileName rustup-init.exe
-  - if not defined RUSTFLAGS rustup-init.exe -y --default-host x86_64-pc-windows-msvc --default-toolchain nightly
-  - set PATH=%PATH%;C:\Users\appveyor\.cargo\bin
-  - rustc -V
-  - cargo -V
-
-build: false
-
-test_script:
-  - cargo test --locked
diff --git a/wasm/m-bus-parser-wasm-pack/.github/dependabot.yml b/wasm/m-bus-parser-wasm-pack/.github/dependabot.yml
deleted file mode 100644
index 7377d37..0000000
--- a/wasm/m-bus-parser-wasm-pack/.github/dependabot.yml
+++ /dev/null
@@ -1,8 +0,0 @@
-version: 2
-updates:
-- package-ecosystem: cargo
-  directory: "/"
-  schedule:
-    interval: daily
-    time: "08:00"
-  open-pull-requests-limit: 10
diff --git a/wasm/m-bus-parser-wasm-pack/.gitignore b/wasm/m-bus-parser-wasm-pack/.gitignore
deleted file mode 100644
index 4e30131..0000000
--- a/wasm/m-bus-parser-wasm-pack/.gitignore
+++ /dev/null
@@ -1,6 +0,0 @@
-/target
-**/*.rs.bk
-Cargo.lock
-bin/
-pkg/
-wasm-pack.log
diff --git a/wasm/m-bus-parser-wasm-pack/.travis.yml b/wasm/m-bus-parser-wasm-pack/.travis.yml
deleted file mode 100644
index 7a91325..0000000
--- a/wasm/m-bus-parser-wasm-pack/.travis.yml
+++ /dev/null
@@ -1,69 +0,0 @@
-language: rust
-sudo: false
-
-cache: cargo
-
-matrix:
-  include:
-
-  # Builds with wasm-pack.
-  - rust: beta
-    env: RUST_BACKTRACE=1
-    addons:
-      firefox: latest
-      chrome: stable
-    before_script:
-      - (test -x $HOME/.cargo/bin/cargo-install-update || cargo install cargo-update)
-      - (test -x $HOME/.cargo/bin/cargo-generate || cargo install --vers "^0.2" cargo-generate)
-      - cargo install-update -a
-      - curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh -s -- -f
-    script:
-      - cargo generate --git . --name testing
-      # Having a broken Cargo.toml (in that it has curlies in fields) anywhere
-      # in any of our parent dirs is problematic.
-      - mv Cargo.toml Cargo.toml.tmpl
-      - cd testing
-      - wasm-pack build
-      - wasm-pack test --chrome --firefox --headless
-
-  # Builds on nightly.
-  - rust: nightly
-    env: RUST_BACKTRACE=1
-    before_script:
-      - (test -x $HOME/.cargo/bin/cargo-install-update || cargo install cargo-update)
-      - (test -x $HOME/.cargo/bin/cargo-generate || cargo install --vers "^0.2" cargo-generate)
-      - cargo install-update -a
-      - rustup target add wasm32-unknown-unknown
-    script:
-      - cargo generate --git . --name testing
-      - mv Cargo.toml Cargo.toml.tmpl
-      - cd testing
-      - cargo check
-      - cargo check --target wasm32-unknown-unknown
-      - cargo check                                 --no-default-features
-      - cargo check --target wasm32-unknown-unknown --no-default-features
-      - cargo check                                 --no-default-features --features console_error_panic_hook
-      - cargo check --target wasm32-unknown-unknown --no-default-features --features console_error_panic_hook
-      - cargo check                                 --no-default-features --features "console_error_panic_hook wee_alloc"
-      - cargo check --target wasm32-unknown-unknown --no-default-features --features "console_error_panic_hook wee_alloc"
-
-  # Builds on beta.
-  - rust: beta
-    env: RUST_BACKTRACE=1
-    before_script:
-      - (test -x $HOME/.cargo/bin/cargo-install-update || cargo install cargo-update)
-      - (test -x $HOME/.cargo/bin/cargo-generate || cargo install --vers "^0.2" cargo-generate)
-      - cargo install-update -a
-      - rustup target add wasm32-unknown-unknown
-    script:
-      - cargo generate --git . --name testing
-      - mv Cargo.toml Cargo.toml.tmpl
-      - cd testing
-      - cargo check
-      - cargo check --target wasm32-unknown-unknown
-      - cargo check                                 --no-default-features
-      - cargo check --target wasm32-unknown-unknown --no-default-features
-      - cargo check                                 --no-default-features --features console_error_panic_hook
-      - cargo check --target wasm32-unknown-unknown --no-default-features --features console_error_panic_hook
-      # Note: no enabling the `wee_alloc` feature here because it requires
-      # nightly for now.
diff --git a/wasm/m-bus-parser-wasm-pack/src/lib.rs b/wasm/src/lib.rs
similarity index 66%
rename from wasm/m-bus-parser-wasm-pack/src/lib.rs
rename to wasm/src/lib.rs
index 149805a..7a61a54 100644
--- a/wasm/m-bus-parser-wasm-pack/src/lib.rs
+++ b/wasm/src/lib.rs
@@ -1,12 +1,11 @@
 mod utils;
 use m_bus_parser;
 
-use wasm_bindgen::prelude::*;
+#[cfg(feature = "wee_alloc")]
+#[global_allocator]
+static ALLOC: wee_alloc::WeeAlloc = wee_alloc::WeeAlloc::INIT;
 
-#[wasm_bindgen]
-extern "C" {
-    fn alert(s: &str);
-}
+use wasm_bindgen::prelude::*;
 
 #[wasm_bindgen]
 pub fn parse(s: &str) -> String {
diff --git a/wasm/m-bus-parser-wasm-pack/src/utils.rs b/wasm/src/utils.rs
similarity index 100%
rename from wasm/m-bus-parser-wasm-pack/src/utils.rs
rename to wasm/src/utils.rs
diff --git a/wasm/m-bus-parser-wasm-pack/tests/web.rs b/wasm/tests/web.rs
similarity index 100%
rename from wasm/m-bus-parser-wasm-pack/tests/web.rs
rename to wasm/tests/web.rs

From 6270206bcb1f4d528973c10d0b76b5e2654b9bf4 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Mon, 10 Jun 2024 23:36:55 +0200
Subject: [PATCH 04/29] wasm looking better

---
 wasm/Cargo.toml |  7 +++++++
 wasm/src/lib.rs | 33 ++++++++++++++++++++++++++++-----
 2 files changed, 35 insertions(+), 5 deletions(-)

diff --git a/wasm/Cargo.toml b/wasm/Cargo.toml
index b4f2c00..58a1077 100644
--- a/wasm/Cargo.toml
+++ b/wasm/Cargo.toml
@@ -27,6 +27,13 @@ m-bus-parser = { path = "..", version = "0.0.9", features = ["std"] }
 # code size when deploying.
 console_error_panic_hook = { version = "0.1.7", optional = true }
 
+# `wee_alloc` is a tiny allocator for wasm that is only ~1K in code size
+# compared to the default allocator's ~10K. It is slower than the default
+# allocator, however.
+#
+# Unfortunately, `wee_alloc` requires nightly Rust when targeting wasm for now.
+wee_alloc = { version = "0.4.5", optional = true }
+
 [dev-dependencies]
 wasm-bindgen-test = "0.3.34"
 
diff --git a/wasm/src/lib.rs b/wasm/src/lib.rs
index 7a61a54..0130e7f 100644
--- a/wasm/src/lib.rs
+++ b/wasm/src/lib.rs
@@ -1,5 +1,5 @@
 mod utils;
-use m_bus_parser;
+use m_bus_parser::{self, MbusData};
 
 #[cfg(feature = "wee_alloc")]
 #[global_allocator]
@@ -8,8 +8,31 @@ static ALLOC: wee_alloc::WeeAlloc = wee_alloc::WeeAlloc::INIT;
 use wasm_bindgen::prelude::*;
 
 #[wasm_bindgen]
-pub fn parse(s: &str) -> String {
-    // remove  white space
-    let s = s.trim().replace([' ', "0x", '\\'], "");
-    m_bus_parser.parse(s);
+extern "C" {
+    fn alert(s: &str);
+}
+
+fn clean_and_convert(input: &str) -> Vec<u8> {
+    let input = input.trim();
+    let cleaned_data: String = input.replace("0x", "").replace([' ', ','], "");
+
+    // Convert pairs of characters into bytes
+    cleaned_data
+        .as_bytes()
+        .chunks(2)
+        .map(|chunk| {
+            let byte_str = std::str::from_utf8(chunk).expect("Invalid UTF-8 sequence");
+            u8::from_str_radix(byte_str, 16).expect("Invalid byte value")
+        })
+        .collect()
+}
+
+#[wasm_bindgen]
+pub fn m_bus_parse(s: &str) -> String {
+    let s = clean_and_convert(s);
+    if let Ok(mbus_data) = MbusData::try_from(s.as_slice()) {
+        format!("{:?}", mbus_data)
+    } else {
+        format!("Failed to parse")
+    }
 }

From 9ee8af92e78dc45d6bb4c305181fffcdadcf6163 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Tue, 11 Jun 2024 19:44:14 +0200
Subject: [PATCH 05/29] improving "full parse" function to be re-used in wasm
 and also in cli

---
 src/lib.rs | 28 ++++++++++++++++++++++------
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/src/lib.rs b/src/lib.rs
index 32c7316..89b6dcb 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -61,6 +61,7 @@ pub mod user_data;
 pub struct MbusData<'a> {
     pub frame: frames::Frame<'a>,
     pub user_data: Option<user_data::UserDataBlock<'a>>,
+    pub data_records: Option<user_data::DataRecords>,
 }
 
 #[derive(Debug)]
@@ -86,15 +87,30 @@ impl<'a> TryFrom<&'a [u8]> for MbusData<'a> {
 
     fn try_from(data: &'a [u8]) -> Result<Self, Self::Error> {
         let frame = frames::Frame::try_from(data)?;
-
-        let user_data = match &frame {
+        let mut user_data = None;
+        let mut data_records = None;
+        match &frame {
             frames::Frame::LongFrame { data, .. } => {
-                Some(user_data::UserDataBlock::try_from(*data)?)
+                if let Ok(x) = user_data::UserDataBlock::try_from(*data) {
+                    user_data = Some(x);
+                    if let Ok(user_data::UserDataBlock::VariableDataStructure {
+                        fixed_data_header: _,
+                        variable_data_block,
+                    }) = user_data::UserDataBlock::try_from(*data)
+                    {
+                        data_records = user_data::DataRecords::try_from(variable_data_block).ok();
+                    }
+                }
             }
-            frames::Frame::SingleCharacter { .. } => None,
-            frames::Frame::ShortFrame { .. } | frames::Frame::ControlFrame { .. } => None,
+            frames::Frame::SingleCharacter { .. } => (),
+            frames::Frame::ShortFrame { .. } => (),
+            frames::Frame::ControlFrame { .. } => (),
         };
 
-        Ok(MbusData { frame, user_data })
+        Ok(MbusData {
+            frame,
+            user_data,
+            data_records,
+        })
     }
 }

From c0262b8816313f55fb55ca8edba30b9bba2ea3dd Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Tue, 11 Jun 2024 21:55:36 +0200
Subject: [PATCH 06/29] using serde in main package now and successfully used
 in wasm

---
 Cargo.toml                         |  6 +++-
 src/frames/mod.rs                  | 14 ++++++--
 src/lib.rs                         |  6 ++++
 src/user_data/data_information.rs  | 48 +++++++++++++++++++++----
 src/user_data/data_record.rs       | 20 ++++++++---
 src/user_data/mod.rs               | 58 ++++++++++++++++++++++++++----
 src/user_data/value_information.rs | 38 ++++++++++++++++----
 wasm/Cargo.toml                    |  7 +++-
 wasm/src/lib.rs                    |  2 +-
 9 files changed, 171 insertions(+), 28 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 1d710a2..3974b06 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -28,6 +28,7 @@ bindgen = "0.69.4"
 [features]
 std = []
 plaintext-before-extension = []
+serde_support = ["serde", "std", "arrayvec/serde"]
 
 [profile.release]
 opt-level = 'z'   # Optimize for size
@@ -35,8 +36,11 @@ lto = true        # Enable Link Time Optimization
 codegen-units = 1 # Reduce codegen units to improve optimizations
 
 [dependencies]
+serde = { version = "1.0", features = ["derive"], optional = true }
 bitflags = "2.4.2"
-arrayvec = "0.7.4"
+arrayvec = { version = "0.7.4", features = [
+    "serde",
+], optional = true, default-features = false }
 
 [workspace]
 members = ["cli", "wasm"]
diff --git a/src/frames/mod.rs b/src/frames/mod.rs
index ffcf22a..35e00ff 100644
--- a/src/frames/mod.rs
+++ b/src/frames/mod.rs
@@ -1,6 +1,9 @@
 //! is part of the MBUS data link layer
 //! It is used to encapsulate the application layer data
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub enum Frame<'a> {
     SingleCharacter {
@@ -22,6 +25,10 @@ pub enum Frame<'a> {
     },
 }
 
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub enum Function {
     SndNk,
@@ -63,7 +70,10 @@ impl TryFrom<u8> for Function {
         }
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub enum Address {
     Uninitalized,
diff --git a/src/lib.rs b/src/lib.rs
index 89b6dcb..070656b 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -58,6 +58,12 @@ pub mod frames;
 pub mod user_data;
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde_support", derive(serde::Serialize))]
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Deserialize),
+    serde(bound(deserialize = "'de: 'a"))
+)]
 pub struct MbusData<'a> {
     pub frame: frames::Frame<'a>,
     pub user_data: Option<user_data::UserDataBlock<'a>>,
diff --git a/src/user_data/data_information.rs b/src/user_data/data_information.rs
index 2578a56..c830b34 100644
--- a/src/user_data/data_information.rs
+++ b/src/user_data/data_information.rs
@@ -3,9 +3,14 @@ use super::variable_user_data::DataRecordError;
 use arrayvec::ArrayVec;
 
 const MAX_DIFE_RECORDS: usize = 10;
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct DataInformationBlock {
     pub data_information_field: DataInformationField,
+    #[serde(skip_serializing, skip_deserializing)]
     pub data_information_field_extension:
         Option<ArrayVec<DataInformationFieldExtension, MAX_DIFE_RECORDS>>,
 }
@@ -19,7 +24,10 @@ impl DataInformationBlock {
         size
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct DataInformationField {
     pub data: u8,
@@ -42,7 +50,10 @@ impl From<u8> for DataInformationFieldExtension {
         DataInformationFieldExtension { data }
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct DataInformationFieldExtension {
     pub data: u8,
@@ -94,7 +105,10 @@ impl DataInformationFieldExtension {
         self.data & 0x80 != 0
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, Clone, PartialEq)]
 pub struct DataInformation {
     pub storage_number: u64,
@@ -116,7 +130,10 @@ impl std::fmt::Display for DataInformation {
 }
 
 const MAXIMUM_DATA_INFORMATION_SIZE: usize = 11;
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, Clone, PartialEq)]
 pub struct DataInformationExtensionField {}
 
@@ -205,11 +222,19 @@ impl TryFrom<&DataInformationBlock> for DataInformation {
     }
 }
 
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub enum DataType {
     Text(ArrayVec<u8, 18>),
     Number(f64),
 }
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(PartialEq, Debug)]
 pub struct Data {
     value: Option<DataType>,
@@ -509,7 +534,10 @@ impl DataInformation {
         self.size
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, Clone, Copy, PartialEq)]
 pub enum FunctionField {
     InstantaneousValue,
@@ -529,7 +557,10 @@ impl std::fmt::Display for FunctionField {
         }
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, Clone, Copy, PartialEq)]
 pub enum SpecialFunctions {
     ManufacturerSpecific,
@@ -655,7 +686,10 @@ impl DataFieldCoding {
         }
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, Clone, Copy, PartialEq)]
 pub enum DataFieldCoding {
     NoData,
diff --git a/src/user_data/data_record.rs b/src/user_data/data_record.rs
index ac3991f..92868c6 100644
--- a/src/user_data/data_record.rs
+++ b/src/user_data/data_record.rs
@@ -3,19 +3,28 @@ use super::{
     value_information::{ValueInformation, ValueInformationBlock},
     variable_user_data::DataRecordError,
 };
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct RawDataRecordHeader {
     pub data_information_block: DataInformationBlock,
     pub value_information_block: ValueInformationBlock,
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct ProcessedDataRecordHeader {
     pub data_information: DataInformation,
     pub value_information: ValueInformation,
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct DataRecord {
     pub data_record_header: DataRecordHeader,
@@ -27,7 +36,10 @@ impl DataRecord {
         self.data_record_header.get_size() + self.data.get_size()
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct DataRecordHeader {
     pub raw_data_record_header: RawDataRecordHeader,
diff --git a/src/user_data/mod.rs b/src/user_data/mod.rs
index 35ecc2b..aaceaea 100644
--- a/src/user_data/mod.rs
+++ b/src/user_data/mod.rs
@@ -15,6 +15,10 @@ pub mod variable_user_data;
 // therefore the maximum number of blocks is 117, see https://m-bus.com/documentation-wired/06-application-layer
 const MAXIMUM_VARIABLE_DATA_BLOCKS: usize = 117;
 // Define a new struct that wraps ArrayVec
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct DataRecords {
     pub inner: ArrayVec<data_record::DataRecord, MAXIMUM_VARIABLE_DATA_BLOCKS>,
@@ -61,6 +65,26 @@ impl Default for DataRecords {
         DataRecords::new()
     }
 }
+#[cfg(feature = "serde_support")]
+impl serde::Serialize for StatusField {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: serde::Serializer,
+    {
+        serializer.serialize_u8(self.bits())
+    }
+}
+#[cfg(feature = "serde_support")]
+impl<'de> serde::Deserialize<'de> for StatusField {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: serde::Deserializer<'de>,
+    {
+        let bits = u8::deserialize(deserializer)?;
+        StatusField::from_bits(bits)
+            .ok_or_else(|| serde::de::Error::custom("Invalid bits for StatusField"))
+    }
+}
 
 bitflags::bitflags! {
     #[repr(transparent)]
@@ -239,6 +263,10 @@ impl fmt::Display for ApplicationLayerError {
 #[cfg(feature = "std")]
 impl std::error::Error for ApplicationLayerError {}
 
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub enum ApplicationResetSubcode {
     All(u8),
@@ -297,12 +325,18 @@ fn bcd_hex_digits_to_u32(digits: [u8; 4]) -> Result<u32, ApplicationLayerError>
 
     Ok(number)
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct Counter {
     count: u32,
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct IdentificationNumber {
     pub number: u32,
@@ -338,7 +372,10 @@ pub struct FixedDataHeder {
     status: StatusField,
     signature: u16,
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[allow(clippy::large_enum_variant)]
 #[derive(Debug, PartialEq)]
 pub enum UserDataBlock<'a> {
@@ -358,7 +395,10 @@ pub enum UserDataBlock<'a> {
         variable_data_block: &'a [u8],
     },
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub enum Medium {
     Other,
@@ -450,7 +490,10 @@ impl fmt::Display for Medium {
         write!(f, "{}", medium)
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct FixedDataHeader {
     pub identification_number: IdentificationNumber,
@@ -461,7 +504,10 @@ pub struct FixedDataHeader {
     pub status: StatusField,
     pub signature: u16,
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct ManufacturerCode {
     pub code: [char; 3],
diff --git a/src/user_data/value_information.rs b/src/user_data/value_information.rs
index a497269..5117642 100644
--- a/src/user_data/value_information.rs
+++ b/src/user_data/value_information.rs
@@ -70,7 +70,10 @@ fn extract_plaintext_vife(data: &[u8]) -> ArrayVec<char, 9> {
     }
     ascii
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct ValueInformationBlock {
     pub value_information: ValueInformationField,
@@ -78,7 +81,10 @@ pub struct ValueInformationBlock {
         Option<ArrayVec<ValueInformationFieldExtension, MAX_VIFE_RECORDS>>,
     pub plaintext_vife: Option<ArrayVec<char, 9>>,
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct ValueInformationField {
     pub data: u8,
@@ -89,7 +95,10 @@ impl ValueInformationField {
         self.data == 0x7C || self.data == 0xFC
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct ValueInformationFieldExtension {
     pub data: u8,
@@ -132,7 +141,10 @@ pub enum ValueInformationCoding {
     AlternateVIFExtension,
     ManufacturerSpecific,
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub enum ValueInformationFieldExtensionCoding {
     MainVIFCodeExtension,
@@ -1635,6 +1647,10 @@ impl From<u8> for ValueInformationField {
 /// This is the most important type of the this file and represents
 /// the whole information inside the value information block
 /// value(x) = (multiplier * value + offset) * units
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub struct ValueInformation {
     pub decimal_offset_exponent: isize,
@@ -1675,7 +1691,10 @@ impl fmt::Display for ValueInformation {
         Ok(())
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq)]
 pub enum ValueLabel {
     Instantaneous,
@@ -1824,6 +1843,10 @@ pub enum ValueLabel {
     DisplayOutputScalingFactor,
     ManufacturerSpecific,
 }
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, PartialEq, Copy, Clone)]
 pub struct Unit {
     pub name: UnitName,
@@ -1859,7 +1882,10 @@ impl fmt::Display for Unit {
         }
     }
 }
-
+#[cfg_attr(
+    feature = "serde_support",
+    derive(serde::Serialize, serde::Deserialize)
+)]
 #[derive(Debug, Clone, Copy, PartialEq)]
 pub enum UnitName {
     Watt,
diff --git a/wasm/Cargo.toml b/wasm/Cargo.toml
index 58a1077..fbcee27 100644
--- a/wasm/Cargo.toml
+++ b/wasm/Cargo.toml
@@ -19,7 +19,12 @@ default = ["console_error_panic_hook"]
 
 [dependencies]
 wasm-bindgen = "0.2.84"
-m-bus-parser = { path = "..", version = "0.0.9", features = ["std"] }
+m-bus-parser = { path = "..", version = "0.0.9", features = [
+    "std",
+    "serde_support",
+] }
+serde = { version = "1.0" }
+serde_json = "1.0"
 
 # The `console_error_panic_hook` crate provides better debugging of panics by
 # logging them with `console.error`. This is great for development, but requires
diff --git a/wasm/src/lib.rs b/wasm/src/lib.rs
index 0130e7f..0c767f4 100644
--- a/wasm/src/lib.rs
+++ b/wasm/src/lib.rs
@@ -31,7 +31,7 @@ fn clean_and_convert(input: &str) -> Vec<u8> {
 pub fn m_bus_parse(s: &str) -> String {
     let s = clean_and_convert(s);
     if let Ok(mbus_data) = MbusData::try_from(s.as_slice()) {
-        format!("{:?}", mbus_data)
+        serde_json::to_string_pretty(&mbus_data).unwrap()
     } else {
         format!("Failed to parse")
     }

From a9423f58682cd1da9a7bcef4e58223c01218a370 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 21:51:37 +0200
Subject: [PATCH 07/29] fixing serde feature naming

---
 Cargo.toml                         |  6 ++--
 src/frames/mod.rs                  |  6 ++--
 src/lib.rs                         |  4 +--
 src/user_data/data_information.rs  | 51 ++++++------------------------
 src/user_data/data_record.rs       | 20 +++---------
 src/user_data/mod.rs               | 44 ++++++--------------------
 src/user_data/value_information.rs | 16 +++++-----
 wasm/Cargo.toml                    |  5 +--
 8 files changed, 40 insertions(+), 112 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 3974b06..9534019 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -28,7 +28,7 @@ bindgen = "0.69.4"
 [features]
 std = []
 plaintext-before-extension = []
-serde_support = ["serde", "std", "arrayvec/serde"]
+serde = ["dep:serde", "std", "arrayvec/serde"]
 
 [profile.release]
 opt-level = 'z'   # Optimize for size
@@ -38,9 +38,7 @@ codegen-units = 1 # Reduce codegen units to improve optimizations
 [dependencies]
 serde = { version = "1.0", features = ["derive"], optional = true }
 bitflags = "2.4.2"
-arrayvec = { version = "0.7.4", features = [
-    "serde",
-], optional = true, default-features = false }
+arrayvec = { version = "0.7.4", optional = false, default-features = true }
 
 [workspace]
 members = ["cli", "wasm"]
diff --git a/src/frames/mod.rs b/src/frames/mod.rs
index 35e00ff..56a6db5 100644
--- a/src/frames/mod.rs
+++ b/src/frames/mod.rs
@@ -1,7 +1,7 @@
 //! is part of the MBUS data link layer
 //! It is used to encapsulate the application layer data
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq)]
@@ -26,7 +26,7 @@ pub enum Frame<'a> {
 }
 
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq)]
@@ -71,7 +71,7 @@ impl TryFrom<u8> for Function {
     }
 }
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq)]
diff --git a/src/lib.rs b/src/lib.rs
index 070656b..80902b1 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -58,9 +58,9 @@ pub mod frames;
 pub mod user_data;
 
 #[derive(Debug)]
-#[cfg_attr(feature = "serde_support", derive(serde::Serialize))]
+#[cfg_attr(feature = "serde", derive(serde::Serialize))]
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Deserialize),
     serde(bound(deserialize = "'de: 'a"))
 )]
diff --git a/src/user_data/data_information.rs b/src/user_data/data_information.rs
index c830b34..a2a2761 100644
--- a/src/user_data/data_information.rs
+++ b/src/user_data/data_information.rs
@@ -3,14 +3,10 @@ use super::variable_user_data::DataRecordError;
 use arrayvec::ArrayVec;
 
 const MAX_DIFE_RECORDS: usize = 10;
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct DataInformationBlock {
     pub data_information_field: DataInformationField,
-    #[serde(skip_serializing, skip_deserializing)]
     pub data_information_field_extension:
         Option<ArrayVec<DataInformationFieldExtension, MAX_DIFE_RECORDS>>,
 }
@@ -24,10 +20,7 @@ impl DataInformationBlock {
         size
     }
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct DataInformationField {
     pub data: u8,
@@ -50,10 +43,7 @@ impl From<u8> for DataInformationFieldExtension {
         DataInformationFieldExtension { data }
     }
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct DataInformationFieldExtension {
     pub data: u8,
@@ -105,10 +95,7 @@ impl DataInformationFieldExtension {
         self.data & 0x80 != 0
     }
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, Clone, PartialEq)]
 pub struct DataInformation {
     pub storage_number: u64,
@@ -130,10 +117,7 @@ impl std::fmt::Display for DataInformation {
 }
 
 const MAXIMUM_DATA_INFORMATION_SIZE: usize = 11;
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, Clone, PartialEq)]
 pub struct DataInformationExtensionField {}
 
@@ -222,19 +206,13 @@ impl TryFrom<&DataInformationBlock> for DataInformation {
     }
 }
 
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub enum DataType {
     Text(ArrayVec<u8, 18>),
     Number(f64),
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(PartialEq, Debug)]
 pub struct Data {
     value: Option<DataType>,
@@ -534,10 +512,7 @@ impl DataInformation {
         self.size
     }
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, Clone, Copy, PartialEq)]
 pub enum FunctionField {
     InstantaneousValue,
@@ -557,10 +532,7 @@ impl std::fmt::Display for FunctionField {
         }
     }
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, Clone, Copy, PartialEq)]
 pub enum SpecialFunctions {
     ManufacturerSpecific,
@@ -686,10 +658,7 @@ impl DataFieldCoding {
         }
     }
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, Clone, Copy, PartialEq)]
 pub enum DataFieldCoding {
     NoData,
diff --git a/src/user_data/data_record.rs b/src/user_data/data_record.rs
index 92868c6..53a3255 100644
--- a/src/user_data/data_record.rs
+++ b/src/user_data/data_record.rs
@@ -3,28 +3,19 @@ use super::{
     value_information::{ValueInformation, ValueInformationBlock},
     variable_user_data::DataRecordError,
 };
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct RawDataRecordHeader {
     pub data_information_block: DataInformationBlock,
     pub value_information_block: ValueInformationBlock,
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct ProcessedDataRecordHeader {
     pub data_information: DataInformation,
     pub value_information: ValueInformation,
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct DataRecord {
     pub data_record_header: DataRecordHeader,
@@ -36,10 +27,7 @@ impl DataRecord {
         self.data_record_header.get_size() + self.data.get_size()
     }
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct DataRecordHeader {
     pub raw_data_record_header: RawDataRecordHeader,
diff --git a/src/user_data/mod.rs b/src/user_data/mod.rs
index aaceaea..2ba14cb 100644
--- a/src/user_data/mod.rs
+++ b/src/user_data/mod.rs
@@ -15,10 +15,7 @@ pub mod variable_user_data;
 // therefore the maximum number of blocks is 117, see https://m-bus.com/documentation-wired/06-application-layer
 const MAXIMUM_VARIABLE_DATA_BLOCKS: usize = 117;
 // Define a new struct that wraps ArrayVec
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct DataRecords {
     pub inner: ArrayVec<data_record::DataRecord, MAXIMUM_VARIABLE_DATA_BLOCKS>,
@@ -65,7 +62,7 @@ impl Default for DataRecords {
         DataRecords::new()
     }
 }
-#[cfg(feature = "serde_support")]
+#[cfg(feature = "serde")]
 impl serde::Serialize for StatusField {
     fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
     where
@@ -74,7 +71,7 @@ impl serde::Serialize for StatusField {
         serializer.serialize_u8(self.bits())
     }
 }
-#[cfg(feature = "serde_support")]
+#[cfg(feature = "serde")]
 impl<'de> serde::Deserialize<'de> for StatusField {
     fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
     where
@@ -263,10 +260,7 @@ impl fmt::Display for ApplicationLayerError {
 #[cfg(feature = "std")]
 impl std::error::Error for ApplicationLayerError {}
 
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub enum ApplicationResetSubcode {
     All(u8),
@@ -325,18 +319,12 @@ fn bcd_hex_digits_to_u32(digits: [u8; 4]) -> Result<u32, ApplicationLayerError>
 
     Ok(number)
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct Counter {
     count: u32,
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct IdentificationNumber {
     pub number: u32,
@@ -372,10 +360,7 @@ pub struct FixedDataHeder {
     status: StatusField,
     signature: u16,
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[allow(clippy::large_enum_variant)]
 #[derive(Debug, PartialEq)]
 pub enum UserDataBlock<'a> {
@@ -395,10 +380,7 @@ pub enum UserDataBlock<'a> {
         variable_data_block: &'a [u8],
     },
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub enum Medium {
     Other,
@@ -490,10 +472,7 @@ impl fmt::Display for Medium {
         write!(f, "{}", medium)
     }
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct FixedDataHeader {
     pub identification_number: IdentificationNumber,
@@ -504,10 +483,7 @@ pub struct FixedDataHeader {
     pub status: StatusField,
     pub signature: u16,
 }
-#[cfg_attr(
-    feature = "serde_support",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct ManufacturerCode {
     pub code: [char; 3],
diff --git a/src/user_data/value_information.rs b/src/user_data/value_information.rs
index 5117642..2716440 100644
--- a/src/user_data/value_information.rs
+++ b/src/user_data/value_information.rs
@@ -71,7 +71,7 @@ fn extract_plaintext_vife(data: &[u8]) -> ArrayVec<char, 9> {
     ascii
 }
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq)]
@@ -82,7 +82,7 @@ pub struct ValueInformationBlock {
     pub plaintext_vife: Option<ArrayVec<char, 9>>,
 }
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq)]
@@ -96,7 +96,7 @@ impl ValueInformationField {
     }
 }
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq)]
@@ -142,7 +142,7 @@ pub enum ValueInformationCoding {
     ManufacturerSpecific,
 }
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq)]
@@ -1648,7 +1648,7 @@ impl From<u8> for ValueInformationField {
 /// the whole information inside the value information block
 /// value(x) = (multiplier * value + offset) * units
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq)]
@@ -1692,7 +1692,7 @@ impl fmt::Display for ValueInformation {
     }
 }
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq)]
@@ -1844,7 +1844,7 @@ pub enum ValueLabel {
     ManufacturerSpecific,
 }
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, PartialEq, Copy, Clone)]
@@ -1883,7 +1883,7 @@ impl fmt::Display for Unit {
     }
 }
 #[cfg_attr(
-    feature = "serde_support",
+    feature = "serde",
     derive(serde::Serialize, serde::Deserialize)
 )]
 #[derive(Debug, Clone, Copy, PartialEq)]
diff --git a/wasm/Cargo.toml b/wasm/Cargo.toml
index fbcee27..f199e19 100644
--- a/wasm/Cargo.toml
+++ b/wasm/Cargo.toml
@@ -19,10 +19,7 @@ default = ["console_error_panic_hook"]
 
 [dependencies]
 wasm-bindgen = "0.2.84"
-m-bus-parser = { path = "..", version = "0.0.9", features = [
-    "std",
-    "serde_support",
-] }
+m-bus-parser = { path = "..", version = "0.0.9", features = ["std", "serde"] }
 serde = { version = "1.0" }
 serde_json = "1.0"
 

From 1eabe9ecf6bd4adb2053a971d466d361f474f1b1 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 21:53:09 +0200
Subject: [PATCH 08/29] removing wee_alloc

---
 wasm/src/lib.rs | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/wasm/src/lib.rs b/wasm/src/lib.rs
index 0c767f4..b668abd 100644
--- a/wasm/src/lib.rs
+++ b/wasm/src/lib.rs
@@ -1,10 +1,6 @@
 mod utils;
 use m_bus_parser::{self, MbusData};
 
-#[cfg(feature = "wee_alloc")]
-#[global_allocator]
-static ALLOC: wee_alloc::WeeAlloc = wee_alloc::WeeAlloc::INIT;
-
 use wasm_bindgen::prelude::*;
 
 #[wasm_bindgen]

From a44fed4d2515f76ad8c4ef4108ca3b2e5ff19b7f Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 22:08:18 +0200
Subject: [PATCH 09/29] adding a web page parser

---
 docs/index.html                     | 122 +++++++++++++++++
 docs/m_bus_parser_wasm_pack.js      | 196 ++++++++++++++++++++++++++++
 docs/m_bus_parser_wasm_pack_bg.js   | 115 ++++++++++++++++
 docs/m_bus_parser_wasm_pack_bg.wasm | Bin 0 -> 106234 bytes
 docs/meter.png                      | Bin 0 -> 17531 bytes
 docs/package.json                   |  30 +++++
 6 files changed, 463 insertions(+)
 create mode 100644 docs/index.html
 create mode 100644 docs/m_bus_parser_wasm_pack.js
 create mode 100644 docs/m_bus_parser_wasm_pack_bg.js
 create mode 100644 docs/m_bus_parser_wasm_pack_bg.wasm
 create mode 100644 docs/meter.png
 create mode 100644 docs/package.json

diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..75cc050
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,122 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <meta charset="utf-8">
+    <title>Wired M-Bus Parser</title>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.5.0/styles/default.min.css">
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.5.0/highlight.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.5.0/languages/json.min.js"></script>
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            margin: 0;
+            padding: 20px;
+            background-color: #ffffff;
+        }
+
+        .header {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            margin-bottom: 20px;
+        }
+
+        .header img {
+            margin-right: 10px;
+        }
+
+        h1 {
+            color: #333;
+            margin: 0;
+        }
+
+        form {
+            background: #fff;
+            padding: 20px;
+            border-radius: 8px;
+            box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
+            max-width: 600px;
+            margin: 0 auto;
+        }
+
+        label {
+            display: block;
+            margin-bottom: 8px;
+            font-weight: bold;
+        }
+
+        textarea {
+            width: 100%;
+            padding: 10px;
+            border: 1px solid #ddd;
+            border-radius: 4px;
+            box-sizing: border-box;
+            margin-bottom: 10px;
+            font-family: monospace;
+        }
+
+        input[type="button"] {
+            background-color: #4CAF50;
+            color: white;
+            padding: 10px 20px;
+            border: none;
+            border-radius: 4px;
+            cursor: pointer;
+        }
+
+        input[type="button"]:hover {
+            background-color: #45a049;
+        }
+
+        pre {
+            background: #f0f0f0;
+            padding: 10px;
+            border-radius: 4px;
+            white-space: pre-wrap;
+            word-wrap: break-word;
+        }
+
+        #output {
+            margin-top: 20px;
+            max-width: 600px;
+            margin: 20px auto 0;
+            padding: 20px;
+            border-radius: 8px;
+            box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
+        }
+    </style>
+</head>
+
+<body>
+    <div class="header">
+        <img id="banner" src="meter.png" alt="Meter Banner">
+        <h1>Wired M-Bus Parser with WASM</h1>
+    </div>
+    <form>
+        <label for="inputstring">Input String:</label>
+        <textarea rows="5" cols="80" id="inputstring"></textarea>
+        <input id="m_bus_parse" type="button" value="Parse JSON" />
+    </form>
+    <pre id="output"></pre>
+    <script type="module">
+        import init, { m_bus_parse } from "./m_bus_parser_wasm_pack.js";
+
+        async function setup() {
+            await init(); // Ensure the WASM module is initialized
+
+            document.getElementById('m_bus_parse').addEventListener('click', () => {
+                const inputString = document.getElementById('inputstring').value;
+                const result = m_bus_parse(inputString);
+                const formattedResult = JSON.stringify(JSON.parse(result), null, 2); // Pretty-print the JSON
+                const outputElement = document.getElementById("output");
+                outputElement.textContent = formattedResult;
+                hljs.highlightElement(outputElement); // Apply syntax highlighting
+            });
+        }
+
+        setup(); // Set up the event listeners after the page is loaded
+    </script>
+</body>
+
+</html>
\ No newline at end of file
diff --git a/docs/m_bus_parser_wasm_pack.js b/docs/m_bus_parser_wasm_pack.js
new file mode 100644
index 0000000..2d3e13d
--- /dev/null
+++ b/docs/m_bus_parser_wasm_pack.js
@@ -0,0 +1,196 @@
+let wasm;
+
+let WASM_VECTOR_LEN = 0;
+
+let cachedUint8Memory0 = null;
+
+function getUint8Memory0() {
+    if (cachedUint8Memory0 === null || cachedUint8Memory0.byteLength === 0) {
+        cachedUint8Memory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8Memory0;
+}
+
+const cachedTextEncoder = (typeof TextEncoder !== 'undefined' ? new TextEncoder('utf-8') : { encode: () => { throw Error('TextEncoder not available') } } );
+
+const encodeString = (typeof cachedTextEncoder.encodeInto === 'function'
+    ? function (arg, view) {
+    return cachedTextEncoder.encodeInto(arg, view);
+}
+    : function (arg, view) {
+    const buf = cachedTextEncoder.encode(arg);
+    view.set(buf);
+    return {
+        read: arg.length,
+        written: buf.length
+    };
+});
+
+function passStringToWasm0(arg, malloc, realloc) {
+
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8Memory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8Memory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8Memory0().subarray(ptr + offset, ptr + len);
+        const ret = encodeString(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+let cachedInt32Memory0 = null;
+
+function getInt32Memory0() {
+    if (cachedInt32Memory0 === null || cachedInt32Memory0.byteLength === 0) {
+        cachedInt32Memory0 = new Int32Array(wasm.memory.buffer);
+    }
+    return cachedInt32Memory0;
+}
+
+const cachedTextDecoder = (typeof TextDecoder !== 'undefined' ? new TextDecoder('utf-8', { ignoreBOM: true, fatal: true }) : { decode: () => { throw Error('TextDecoder not available') } } );
+
+if (typeof TextDecoder !== 'undefined') { cachedTextDecoder.decode(); };
+
+function getStringFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return cachedTextDecoder.decode(getUint8Memory0().subarray(ptr, ptr + len));
+}
+/**
+* @param {string} s
+* @returns {string}
+*/
+export function m_bus_parse(s) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(s, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.m_bus_parse(retptr, ptr0, len0);
+        var r0 = getInt32Memory0()[retptr / 4 + 0];
+        var r1 = getInt32Memory0()[retptr / 4 + 1];
+        deferred2_0 = r0;
+        deferred2_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
+async function __wbg_load(module, imports) {
+    if (typeof Response === 'function' && module instanceof Response) {
+        if (typeof WebAssembly.instantiateStreaming === 'function') {
+            try {
+                return await WebAssembly.instantiateStreaming(module, imports);
+
+            } catch (e) {
+                if (module.headers.get('Content-Type') != 'application/wasm') {
+                    console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);
+
+                } else {
+                    throw e;
+                }
+            }
+        }
+
+        const bytes = await module.arrayBuffer();
+        return await WebAssembly.instantiate(bytes, imports);
+
+    } else {
+        const instance = await WebAssembly.instantiate(module, imports);
+
+        if (instance instanceof WebAssembly.Instance) {
+            return { instance, module };
+
+        } else {
+            return instance;
+        }
+    }
+}
+
+function __wbg_get_imports() {
+    const imports = {};
+    imports.wbg = {};
+
+    return imports;
+}
+
+function __wbg_init_memory(imports, maybe_memory) {
+
+}
+
+function __wbg_finalize_init(instance, module) {
+    wasm = instance.exports;
+    __wbg_init.__wbindgen_wasm_module = module;
+    cachedInt32Memory0 = null;
+    cachedUint8Memory0 = null;
+
+
+    return wasm;
+}
+
+function initSync(module) {
+    if (wasm !== undefined) return wasm;
+
+    const imports = __wbg_get_imports();
+
+    __wbg_init_memory(imports);
+
+    if (!(module instanceof WebAssembly.Module)) {
+        module = new WebAssembly.Module(module);
+    }
+
+    const instance = new WebAssembly.Instance(module, imports);
+
+    return __wbg_finalize_init(instance, module);
+}
+
+async function __wbg_init(input) {
+    if (wasm !== undefined) return wasm;
+
+    if (typeof input === 'undefined') {
+        input = new URL('m_bus_parser_wasm_pack_bg.wasm', import.meta.url);
+    }
+    const imports = __wbg_get_imports();
+
+    if (typeof input === 'string' || (typeof Request === 'function' && input instanceof Request) || (typeof URL === 'function' && input instanceof URL)) {
+        input = fetch(input);
+    }
+
+    __wbg_init_memory(imports);
+
+    const { instance, module } = await __wbg_load(await input, imports);
+
+    return __wbg_finalize_init(instance, module);
+}
+
+export { initSync }
+export default __wbg_init;
diff --git a/docs/m_bus_parser_wasm_pack_bg.js b/docs/m_bus_parser_wasm_pack_bg.js
new file mode 100644
index 0000000..d8c9aa2
--- /dev/null
+++ b/docs/m_bus_parser_wasm_pack_bg.js
@@ -0,0 +1,115 @@
+let wasm;
+export function __wbg_set_wasm(val) {
+    wasm = val;
+}
+
+
+let WASM_VECTOR_LEN = 0;
+
+let cachedUint8Memory0 = null;
+
+function getUint8Memory0() {
+    if (cachedUint8Memory0 === null || cachedUint8Memory0.byteLength === 0) {
+        cachedUint8Memory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8Memory0;
+}
+
+const lTextEncoder = typeof TextEncoder === 'undefined' ? (0, module.require)('util').TextEncoder : TextEncoder;
+
+let cachedTextEncoder = new lTextEncoder('utf-8');
+
+const encodeString = (typeof cachedTextEncoder.encodeInto === 'function'
+    ? function (arg, view) {
+    return cachedTextEncoder.encodeInto(arg, view);
+}
+    : function (arg, view) {
+    const buf = cachedTextEncoder.encode(arg);
+    view.set(buf);
+    return {
+        read: arg.length,
+        written: buf.length
+    };
+});
+
+function passStringToWasm0(arg, malloc, realloc) {
+
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8Memory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8Memory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8Memory0().subarray(ptr + offset, ptr + len);
+        const ret = encodeString(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+let cachedInt32Memory0 = null;
+
+function getInt32Memory0() {
+    if (cachedInt32Memory0 === null || cachedInt32Memory0.byteLength === 0) {
+        cachedInt32Memory0 = new Int32Array(wasm.memory.buffer);
+    }
+    return cachedInt32Memory0;
+}
+
+const lTextDecoder = typeof TextDecoder === 'undefined' ? (0, module.require)('util').TextDecoder : TextDecoder;
+
+let cachedTextDecoder = new lTextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+
+cachedTextDecoder.decode();
+
+function getStringFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return cachedTextDecoder.decode(getUint8Memory0().subarray(ptr, ptr + len));
+}
+/**
+* @param {string} s
+* @returns {string}
+*/
+export function m_bus_parse(s) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(s, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.m_bus_parse(retptr, ptr0, len0);
+        var r0 = getInt32Memory0()[retptr / 4 + 0];
+        var r1 = getInt32Memory0()[retptr / 4 + 1];
+        deferred2_0 = r0;
+        deferred2_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
diff --git a/docs/m_bus_parser_wasm_pack_bg.wasm b/docs/m_bus_parser_wasm_pack_bg.wasm
new file mode 100644
index 0000000000000000000000000000000000000000..23a6d647d99a1f7a7b8710538151e6926f623663
GIT binary patch
literal 106234
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%0DgMOC>B9(T1`k$gIY!r
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

literal 0
HcmV?d00001

diff --git a/docs/meter.png b/docs/meter.png
new file mode 100644
index 0000000000000000000000000000000000000000..daa1f54f5acfb76c88ffa30c60ccc1834fb33856
GIT binary patch
literal 17531
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

literal 0
HcmV?d00001

diff --git a/docs/package.json b/docs/package.json
new file mode 100644
index 0000000..6b234f7
--- /dev/null
+++ b/docs/package.json
@@ -0,0 +1,30 @@
+{
+  "name": "m-bus-parser-wasm-pack",
+  "collaborators": [
+    "Michael Aebli"
+  ],
+  "description": "A wasm-pack to use the library for parsing M-Bus frames",
+  "version": "0.0.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/maebli/m-bus-parser"
+  },
+  "files": [
+    "m_bus_parser_wasm_pack_bg.wasm",
+    "m_bus_parser_wasm_pack.js",
+    "m_bus_parser_wasm_pack.d.ts"
+  ],
+  "module": "m_bus_parser_wasm_pack.js",
+  "homepage": "https://maebli.github.io/",
+  "types": "m_bus_parser_wasm_pack.d.ts",
+  "sideEffects": [
+    "./snippets/*"
+  ],
+  "keywords": [
+    "m-bus",
+    "parser",
+    "parse",
+    "wasm-pack"
+  ]
+}
\ No newline at end of file

From 9d6bb1d97867622fad87cdfba43ff16a7eca8294 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 22:27:02 +0200
Subject: [PATCH 10/29] adjusting pipeline

---
 .github/workflows/rust.yml | 57 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 56 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index e84183f..e1e6a10 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -61,6 +61,32 @@ jobs:
           cd cli/src
           cargo clippy -- -D warnings
 
+  build-wasm:
+    runs-on: ubuntu-latest
+    needs: build-library
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          profile: minimal
+          toolchain: stable
+          override: true
+      - name: Build WASM
+        run: |
+          cd wasm
+          cargo build --verbose
+      - name: Run CLI Tests
+        run: |
+          cd wasm
+          cargo test --verbose
+      - name: Lint CLI with Clippy
+        run: |
+          rustup component add clippy
+          cd wasm
+          cargo clippy -- -D warnings
+
+  
   publish-library:
     needs: build-library
     runs-on: ubuntu-latest
@@ -82,7 +108,7 @@ jobs:
   publish-cli:
     needs: build-cli
     runs-on: ubuntu-latest
-    if: startsWith(github.ref_name, 'cli-v')
+    if: startsWith(github.ref, 'cli-v')
     steps:
       - uses: actions/checkout@v2
       - name: Set up Rust
@@ -95,3 +121,32 @@ jobs:
         run: |
           cd cli/src
           cargo publish --token ${{ secrets.CRATESTOKEN }}
+
+  publish-wasm:
+    needs: build-wasm
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'wasm-v')
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          profile: minimal
+          override: true
+      - name: Install wasm-pack
+        run: cargo install wasm-pack
+      - name: Set up Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: '16'
+      - name: Build wasm package
+        run: |
+          cd wasm
+          wasm-pack build --target bundler
+      - name: Publish to npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          cd  wasm/pkg
+          npm publish

From 055ee5c5f718ef5f640bd0c59f1d762bbc57e1e6 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 22:28:49 +0200
Subject: [PATCH 11/29] adding wasm pack

---
 .github/workflows/rust.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index e1e6a10..e81cd6e 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -2,7 +2,7 @@ name: Rust
 
 on:
   push:
-    branches: [main]
+    branches: [feature/wasm-pack]
     tags:
       - 'v*'
       - 'cli-v*'

From 233bcccbeb48f4335282412ad881de6a59359c51 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 22:31:02 +0200
Subject: [PATCH 12/29] adding some files that were missing

---
 src/frames/mod.rs                  | 15 +++--------
 src/user_data/value_information.rs | 40 ++++++------------------------
 2 files changed, 11 insertions(+), 44 deletions(-)

diff --git a/src/frames/mod.rs b/src/frames/mod.rs
index 56a6db5..a0942c8 100644
--- a/src/frames/mod.rs
+++ b/src/frames/mod.rs
@@ -1,9 +1,6 @@
 //! is part of the MBUS data link layer
 //! It is used to encapsulate the application layer data
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub enum Frame<'a> {
     SingleCharacter {
@@ -25,10 +22,7 @@ pub enum Frame<'a> {
     },
 }
 
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub enum Function {
     SndNk,
@@ -70,10 +64,7 @@ impl TryFrom<u8> for Function {
         }
     }
 }
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub enum Address {
     Uninitalized,
diff --git a/src/user_data/value_information.rs b/src/user_data/value_information.rs
index 2716440..8e51a7f 100644
--- a/src/user_data/value_information.rs
+++ b/src/user_data/value_information.rs
@@ -70,10 +70,7 @@ fn extract_plaintext_vife(data: &[u8]) -> ArrayVec<char, 9> {
     }
     ascii
 }
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct ValueInformationBlock {
     pub value_information: ValueInformationField,
@@ -81,10 +78,7 @@ pub struct ValueInformationBlock {
         Option<ArrayVec<ValueInformationFieldExtension, MAX_VIFE_RECORDS>>,
     pub plaintext_vife: Option<ArrayVec<char, 9>>,
 }
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct ValueInformationField {
     pub data: u8,
@@ -95,10 +89,7 @@ impl ValueInformationField {
         self.data == 0x7C || self.data == 0xFC
     }
 }
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct ValueInformationFieldExtension {
     pub data: u8,
@@ -141,10 +132,7 @@ pub enum ValueInformationCoding {
     AlternateVIFExtension,
     ManufacturerSpecific,
 }
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub enum ValueInformationFieldExtensionCoding {
     MainVIFCodeExtension,
@@ -1647,10 +1635,7 @@ impl From<u8> for ValueInformationField {
 /// This is the most important type of the this file and represents
 /// the whole information inside the value information block
 /// value(x) = (multiplier * value + offset) * units
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub struct ValueInformation {
     pub decimal_offset_exponent: isize,
@@ -1691,10 +1676,7 @@ impl fmt::Display for ValueInformation {
         Ok(())
     }
 }
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq)]
 pub enum ValueLabel {
     Instantaneous,
@@ -1843,10 +1825,7 @@ pub enum ValueLabel {
     DisplayOutputScalingFactor,
     ManufacturerSpecific,
 }
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, PartialEq, Copy, Clone)]
 pub struct Unit {
     pub name: UnitName,
@@ -1882,10 +1861,7 @@ impl fmt::Display for Unit {
         }
     }
 }
-#[cfg_attr(
-    feature = "serde",
-    derive(serde::Serialize, serde::Deserialize)
-)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Debug, Clone, Copy, PartialEq)]
 pub enum UnitName {
     Watt,

From e4553bb85615718bd6f010c6b4b0c56a9adee991 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 22:47:12 +0200
Subject: [PATCH 13/29] removing test that does not work

---
 src/lib.rs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/lib.rs b/src/lib.rs
index 80902b1..e661901 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -34,13 +34,8 @@
 //! let frame = Frame::try_from(example.as_slice()).unwrap();
 //!
 //! if let Frame::LongFrame { function, address, data :_} = frame {
-//!     assert_eq!(function, Function::RspUd{acd: false, dfc:false});
-//!     assert_eq!(address, Address::Primary(1));
 //! }
 //!
-//! // Alternatively, parse the frame and user data in one go
-//! let mbus_data = m_bus_parser::MbusData::try_from(example.as_slice()).unwrap();
-//!
 //! ```
 
 #![cfg_attr(not(feature = "std"), no_std)]

From 6632f486342b5cb21606595512000ade4d1f396b Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 22:49:58 +0200
Subject: [PATCH 14/29] fixing clippy warning in wasm pack

---
 wasm/src/lib.rs   |  3 +--
 wasm/src/utils.rs | 10 ----------
 2 files changed, 1 insertion(+), 12 deletions(-)
 delete mode 100644 wasm/src/utils.rs

diff --git a/wasm/src/lib.rs b/wasm/src/lib.rs
index b668abd..f776aca 100644
--- a/wasm/src/lib.rs
+++ b/wasm/src/lib.rs
@@ -1,4 +1,3 @@
-mod utils;
 use m_bus_parser::{self, MbusData};
 
 use wasm_bindgen::prelude::*;
@@ -29,6 +28,6 @@ pub fn m_bus_parse(s: &str) -> String {
     if let Ok(mbus_data) = MbusData::try_from(s.as_slice()) {
         serde_json::to_string_pretty(&mbus_data).unwrap()
     } else {
-        format!("Failed to parse")
+        "Failed to parse".to_string()
     }
 }
diff --git a/wasm/src/utils.rs b/wasm/src/utils.rs
deleted file mode 100644
index b1d7929..0000000
--- a/wasm/src/utils.rs
+++ /dev/null
@@ -1,10 +0,0 @@
-pub fn set_panic_hook() {
-    // When the `console_error_panic_hook` feature is enabled, we can call the
-    // `set_panic_hook` function at least once during initialization, and then
-    // we will get better error messages if our code ever panics.
-    //
-    // For more details see
-    // https://github.com/rustwasm/console_error_panic_hook#readme
-    #[cfg(feature = "console_error_panic_hook")]
-    console_error_panic_hook::set_once();
-}

From 90b287def942753d7fcdcaf79baa273a2fa9ce3a Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 22:55:00 +0200
Subject: [PATCH 15/29] removing leftover weealoc

---
 wasm/Cargo.toml | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/wasm/Cargo.toml b/wasm/Cargo.toml
index f199e19..845da81 100644
--- a/wasm/Cargo.toml
+++ b/wasm/Cargo.toml
@@ -29,13 +29,6 @@ serde_json = "1.0"
 # code size when deploying.
 console_error_panic_hook = { version = "0.1.7", optional = true }
 
-# `wee_alloc` is a tiny allocator for wasm that is only ~1K in code size
-# compared to the default allocator's ~10K. It is slower than the default
-# allocator, however.
-#
-# Unfortunately, `wee_alloc` requires nightly Rust when targeting wasm for now.
-wee_alloc = { version = "0.4.5", optional = true }
-
 [dev-dependencies]
 wasm-bindgen-test = "0.3.34"
 

From a1afd3b05cb2175fdb7310e02de2de0d8b5b4bac Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 22:55:09 +0200
Subject: [PATCH 16/29] bumping version for release

---
 wasm/Cargo.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/wasm/Cargo.toml b/wasm/Cargo.toml
index 845da81..f7c5efd 100644
--- a/wasm/Cargo.toml
+++ b/wasm/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "m-bus-parser-wasm-pack"
-version = "0.0.0"
+version = "0.0.1"
 edition = "2021"
 description = "A wasm-pack to use the library for parsing M-Bus frames"
 license = "MIT"

From ba1a73f0905db262b69bebbed5aa19c49ea51f1b Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 23:14:28 +0200
Subject: [PATCH 17/29] fixing pipeline

---
 .github/workflows/rust.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index e81cd6e..0c266b1 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -108,7 +108,7 @@ jobs:
   publish-cli:
     needs: build-cli
     runs-on: ubuntu-latest
-    if: startsWith(github.ref, 'cli-v')
+    if: startsWith(github.ref, 'refs/tags/cli-v')
     steps:
       - uses: actions/checkout@v2
       - name: Set up Rust
@@ -125,7 +125,7 @@ jobs:
   publish-wasm:
     needs: build-wasm
     runs-on: ubuntu-latest
-    if: startsWith(github.ref, 'wasm-v')
+    if: startsWith(github.ref, 'refs/tags/wasm-v')
     steps:
       - uses: actions/checkout@v2
       - name: Set up Rust

From 02af844e203bd340626dd5fbc52a58b0191dbb2c Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Wed, 12 Jun 2024 23:28:26 +0200
Subject: [PATCH 18/29] finally found why tag triggers not working

---
 .github/workflows/rust.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 0c266b1..91f8691 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -6,6 +6,7 @@ on:
     tags:
       - 'v*'
       - 'cli-v*'
+      - 'wasm-v*'
   pull_request:
     branches: [main]
 

From daa096c54099807fe56316f3656da727c55c6f1f Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Thu, 13 Jun 2024 00:20:17 +0200
Subject: [PATCH 19/29] trying again to npm publish

---
 .github/workflows/rust.yml | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 91f8691..8e53708 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -138,9 +138,10 @@ jobs:
       - name: Install wasm-pack
         run: cargo install wasm-pack
       - name: Set up Node.js
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v4
         with:
-          node-version: '16'
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
       - name: Build wasm package
         run: |
           cd wasm
@@ -150,4 +151,5 @@ jobs:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: |
           cd  wasm/pkg
-          npm publish
+          npm ci
+          npm publish --provenance --access public

From f262eccf8e104e15c9c471b31a63c521263b4ae5 Mon Sep 17 00:00:00 2001
From: Sarthak Singh <sarthak.singh99@gmail.com>
Date: Thu, 13 Jun 2024 13:30:37 +0530
Subject: [PATCH 20/29] Minor code style fixes

---
 Cargo.toml           |  2 +-
 src/lib.rs           |  3 +--
 src/user_data/mod.rs | 41 +++++++++++++++++++++--------------------
 3 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 9534019..93ab9ed 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -28,7 +28,7 @@ bindgen = "0.69.4"
 [features]
 std = []
 plaintext-before-extension = []
-serde = ["dep:serde", "std", "arrayvec/serde"]
+serde = ["dep:serde", "std", "arrayvec/serde", "bitflags/serde"]
 
 [profile.release]
 opt-level = 'z'   # Optimize for size
diff --git a/src/lib.rs b/src/lib.rs
index e661901..9f38693 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -53,10 +53,9 @@ pub mod frames;
 pub mod user_data;
 
 #[derive(Debug)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize))]
 #[cfg_attr(
     feature = "serde",
-    derive(serde::Deserialize),
+    derive(serde::Serialize, serde::Deserialize),
     serde(bound(deserialize = "'de: 'a"))
 )]
 pub struct MbusData<'a> {
diff --git a/src/user_data/mod.rs b/src/user_data/mod.rs
index 2ba14cb..92541d8 100644
--- a/src/user_data/mod.rs
+++ b/src/user_data/mod.rs
@@ -62,30 +62,31 @@ impl Default for DataRecords {
         DataRecords::new()
     }
 }
-#[cfg(feature = "serde")]
-impl serde::Serialize for StatusField {
-    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
-    where
-        S: serde::Serializer,
-    {
-        serializer.serialize_u8(self.bits())
-    }
-}
-#[cfg(feature = "serde")]
-impl<'de> serde::Deserialize<'de> for StatusField {
-    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
-    where
-        D: serde::Deserializer<'de>,
-    {
-        let bits = u8::deserialize(deserializer)?;
-        StatusField::from_bits(bits)
-            .ok_or_else(|| serde::de::Error::custom("Invalid bits for StatusField"))
-    }
-}
+// #[cfg(feature = "serde")]
+// impl serde::Serialize for StatusField {
+//     fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+//     where
+//         S: serde::Serializer,
+//     {
+//         serializer.serialize_u8(self.bits())
+//     }
+// }
+// #[cfg(feature = "serde")]
+// impl<'de> serde::Deserialize<'de> for StatusField {
+//     fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+//    where
+//        D: serde::Deserializer<'de>,
+//    {
+//        let bits = u8::deserialize(deserializer)?;
+//        StatusField::from_bits(bits)
+//            .ok_or_else(|| serde::de::Error::custom("Invalid bits for StatusField"))
+//    }
+// }
 
 bitflags::bitflags! {
     #[repr(transparent)]
     #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
+    #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
     pub struct StatusField: u8 {
         const COUNTER_BINARY_SIGNED     = 0b00000001;
         const COUNTER_FIXED_DATE        = 0b00000010;

From ba31ea3ec15dbb4bdffe6a6877ccd5ef0853d917 Mon Sep 17 00:00:00 2001
From: Sarthak Singh <sarthak.singh99@gmail.com>
Date: Thu, 13 Jun 2024 13:51:07 +0530
Subject: [PATCH 21/29] Moved the profile for wasm crate to root Cargo.toml

---
 Cargo.toml      | 3 +++
 wasm/Cargo.toml | 4 ----
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 93ab9ed..b940a2b 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -35,6 +35,9 @@ opt-level = 'z'   # Optimize for size
 lto = true        # Enable Link Time Optimization
 codegen-units = 1 # Reduce codegen units to improve optimizations
 
+[profile.release.package."m-bus-parser-wasm-pack"]
+opt-level = "s"
+
 [dependencies]
 serde = { version = "1.0", features = ["derive"], optional = true }
 bitflags = "2.4.2"
diff --git a/wasm/Cargo.toml b/wasm/Cargo.toml
index f7c5efd..1d27755 100644
--- a/wasm/Cargo.toml
+++ b/wasm/Cargo.toml
@@ -31,7 +31,3 @@ console_error_panic_hook = { version = "0.1.7", optional = true }
 
 [dev-dependencies]
 wasm-bindgen-test = "0.3.34"
-
-[profile.release]
-# Tell `rustc` to optimize for small code size.
-opt-level = "s"

From e69bd71b3c011a7109d759c150a0621e002595cb Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Thu, 13 Jun 2024 21:43:22 +0200
Subject: [PATCH 22/29] removing dead code

---
 src/user_data/mod.rs | 20 --------------------
 1 file changed, 20 deletions(-)

diff --git a/src/user_data/mod.rs b/src/user_data/mod.rs
index 92541d8..3e4b3c7 100644
--- a/src/user_data/mod.rs
+++ b/src/user_data/mod.rs
@@ -62,26 +62,6 @@ impl Default for DataRecords {
         DataRecords::new()
     }
 }
-// #[cfg(feature = "serde")]
-// impl serde::Serialize for StatusField {
-//     fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
-//     where
-//         S: serde::Serializer,
-//     {
-//         serializer.serialize_u8(self.bits())
-//     }
-// }
-// #[cfg(feature = "serde")]
-// impl<'de> serde::Deserialize<'de> for StatusField {
-//     fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
-//    where
-//        D: serde::Deserializer<'de>,
-//    {
-//        let bits = u8::deserialize(deserializer)?;
-//        StatusField::from_bits(bits)
-//            .ok_or_else(|| serde::de::Error::custom("Invalid bits for StatusField"))
-//    }
-// }
 
 bitflags::bitflags! {
     #[repr(transparent)]

From 22949fb4dacbc4bb8bef66b0f0ee550a11ed445e Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Thu, 13 Jun 2024 22:04:44 +0200
Subject: [PATCH 23/29] trying again to publish to npm

---
 .github/workflows/rust.yml | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 8e53708..a759907 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -128,7 +128,7 @@ jobs:
     runs-on: ubuntu-latest
     if: startsWith(github.ref, 'refs/tags/wasm-v')
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Rust
         uses: actions-rs/toolchain@v1
         with:
@@ -137,19 +137,20 @@ jobs:
           override: true
       - name: Install wasm-pack
         run: cargo install wasm-pack
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-          registry-url: 'https://registry.npmjs.org'
       - name: Build wasm package
         run: |
           cd wasm
           wasm-pack build --target bundler
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+          token: ${{ secrets.NPM_TOKEN }}
       - name: Publish to npm
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: |
           cd  wasm/pkg
           npm ci
-          npm publish --provenance --access public
+          npm publish
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

From 4b9e1d519f4c962843b38db3cb032f41273cc8d0 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Thu, 13 Jun 2024 22:15:56 +0200
Subject: [PATCH 24/29] next attempt

---
 .github/workflows/rust.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index a759907..73b5476 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -128,7 +128,6 @@ jobs:
     runs-on: ubuntu-latest
     if: startsWith(github.ref, 'refs/tags/wasm-v')
     steps:
-      - uses: actions/checkout@v4
       - name: Set up Rust
         uses: actions-rs/toolchain@v1
         with:
@@ -141,6 +140,7 @@ jobs:
         run: |
           cd wasm
           wasm-pack build --target bundler
+      - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
           node-version: '20.x'

From 4d7107d274274de1d1a75b8fbcc801908a29c709 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Thu, 13 Jun 2024 22:24:54 +0200
Subject: [PATCH 25/29] trying again

---
 .github/workflows/rust.yml | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 73b5476..b6b8b99 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -123,11 +123,13 @@ jobs:
           cd cli/src
           cargo publish --token ${{ secrets.CRATESTOKEN }}
 
+
   publish-wasm:
     needs: build-wasm
     runs-on: ubuntu-latest
     if: startsWith(github.ref, 'refs/tags/wasm-v')
     steps:
+      - uses: actions/checkout@v4
       - name: Set up Rust
         uses: actions-rs/toolchain@v1
         with:
@@ -140,17 +142,16 @@ jobs:
         run: |
           cd wasm
           wasm-pack build --target bundler
-      - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
           node-version: '20.x'
           registry-url: 'https://registry.npmjs.org'
           token: ${{ secrets.NPM_TOKEN }}
-      - name: Publish to npm
+      - name: Install npm dependencies
         run: |
-          cd  wasm/pkg
+          cd wasm/pkg
           npm ci
-          npm publish
-      - run: npm publish --provenance --access public
+      - name: Publish to npm
+        run: npm publish --provenance --access public
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
\ No newline at end of file

From 2a14d94b4cbe1d14a71d7e0d9cdcbdbaed64ba4b Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Thu, 13 Jun 2024 22:51:10 +0200
Subject: [PATCH 26/29] adding possibly missing npm install

---
 .github/workflows/rust.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index b6b8b99..1c3fe8a 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -150,6 +150,7 @@ jobs:
       - name: Install npm dependencies
         run: |
           cd wasm/pkg
+          npm install
           npm ci
       - name: Publish to npm
         run: npm publish --provenance --access public

From e0ebf6433dcce55dbbb76e92fd2d3c016454a7d4 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Thu, 13 Jun 2024 23:11:23 +0200
Subject: [PATCH 27/29] fixing last step

---
 .github/workflows/rust.yml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 1c3fe8a..826dd62 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -153,6 +153,8 @@ jobs:
           npm install
           npm ci
       - name: Publish to npm
-        run: npm publish --provenance --access public
+        run: | 
+          cd wasm/pkg
+          npm publish --provenance --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
\ No newline at end of file

From 1e899ed2e28740ecb50b72b9a8ec3b366d91f538 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Thu, 13 Jun 2024 23:19:43 +0200
Subject: [PATCH 28/29] adding permissions

---
 .github/workflows/rust.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 826dd62..c671332 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -127,6 +127,9 @@ jobs:
   publish-wasm:
     needs: build-wasm
     runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
     if: startsWith(github.ref, 'refs/tags/wasm-v')
     steps:
       - uses: actions/checkout@v4

From 373a6c3c1ea51c5da8cd3a14c639f2a0f16a5142 Mon Sep 17 00:00:00 2001
From: heroichornet <schnipper@gmail.com>
Date: Thu, 13 Jun 2024 23:34:27 +0200
Subject: [PATCH 29/29] adding documentation

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 40df56f..809aded 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,22 @@ Furthermore, the Open Metering System (OMS) Group has published a specification
  such as a no longer maitained [ m-bus encoder and decoder by rscada](https://github.com/rscada/libmbus) written in **c**, [jMbus](https://github.com/qvest-digital/jmbus) written in **java**,[Valley.Net.Protocols.MeterBus](https://github.com/sympthom/Valley.Net.Protocols.MeterBus/) written in **C#**, [tmbus](https://dev-lab.github.io/tmbus/) written in javascript or [pyMeterBus](https://github.com/ganehag/pyMeterBus) written in python.
 
 
+## Dependants and Deployments
+
+### NPM Wasm Package
+![npm](https://img.shields.io/npm/dm/m-bus-parser-wasm-pack.svg) ![npm](https://img.shields.io/npm/v/m-bus-parser-wasm-pack.svg)
+
+The parser has been published as an npm package and can be used in the browser. An example of this can be seen under the url www.maebli.github.io/m-bus-parser/ [https://maebli.github.io/m-bus-parser/](https://maebli.github.io/m-bus-parser/).
+
+The source is in the wasm folder in this repos 
+
+
+### CLI rust crate
+[![Crates.io](https://img.shields.io/crates/v/m-bus-parser-cli.svg)](https://crates.io/crates/m-bus-parser-cli) [![Downloads](https://img.shields.io/crates/d/m-bus-parser-cli.svg)](https://crates.io/crates/m-bus-parser-cli)
+
+There is a cli, the source is in the sub folder "cli" and is published on crates.io [https://crates.io/crates/m-bus-parser-cli](https://crates.io/crates/m-bus-parser-cli).
+
+
 ### Visualization of Library Function
 
 Do not get confused about the different types of frame types. The most important one to understand at first is the `LongFrame` which is the most common frame type. The others are for example for searching for a slave or for setting the primary address of a slave. This is not of primary intrest for most users. Visualization was made with the help of the tool [excalidraw](https://excalidraw.com/).