m-bus-parser-wasm-pack 0.3.0 → 0.4.1

package/README.md

@@ -1,3 +1,24 @@
-# WASM Package for m-bus-parser (wired)
+# WASM package for m-bus-parser
 
-This package is a WebAssembly (WASM) package for the mbus parser so it  may be used in the browser for example. 
+Browser bindings for the wired and wireless M-Bus parser.
+
+- `m_bus_decode(data, key?, includeEnrichment?)` returns the canonical schema
+  as a native JavaScript object.
+- `m_bus_render(data, format, key?, width?, includeEnrichment?)` renders
+  `table`, `json`, `yaml`, `csv`, `mermaid`, `xml`, `annotated`, or
+  `annotated-text`.
+- `m_bus_highlight(source, language)` highlights JSON, YAML, CSV, or XML with
+  the Rust-only `syntect` grammar bundle and returns escaped, prefixed
+  span-only markup.
+- Rejected promises/errors are `MbusParserError` objects with stable `code`,
+  `layer`, and optional `byteOffset` properties.
+- `m_bus_parse` and `m_bus_parse_with_key` remain compatibility wrappers.
+
+```js
+import init, { m_bus_decode, m_bus_highlight, m_bus_render } from 'm-bus-parser-wasm-pack'
+
+await init()
+const decoded = m_bus_decode('68 3D 3D 68 ...')
+const narrowTable = m_bus_render('68 3D 3D 68 ...', 'table', undefined, 48)
+const highlighted = m_bus_highlight(JSON.stringify(decoded, null, 2), 'json')
+```

package/m_bus_parser_wasm_pack.d.ts

@@ -1,8 +1,29 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * Decode into the canonical schema as a native JavaScript object.
+ */
+export function m_bus_decode(data: string, key_hex?: string | null, include_enrichment?: boolean | null): any;
+
+/**
+ * Highlight JSON, YAML, CSV, XML, or plaintext with the bundled Rust grammar set.
+ */
+export function m_bus_highlight(source: string, language: string): string;
+
+/**
+ * Compatibility wrapper returning errors as text. Prefer `m_bus_render`.
+ */
 export function m_bus_parse(data: string, format: string): string;
 
+/**
+ * Compatibility wrapper returning errors as text. Prefer `m_bus_render`.
+ */
 export function m_bus_parse_with_key(data: string, format: string, key_hex: string): string;
 
+/**
+ * Render with the shared Rust/Python/CLI output contract.
+ */
+export function m_bus_render(data: string, format: string, key_hex?: string | null, width?: number | null, include_enrichment?: boolean | null): string;
+
 export function version(): string;

package/m_bus_parser_wasm_pack.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./m_bus_parser_wasm_pack_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    m_bus_parse, m_bus_parse_with_key, version
+    m_bus_decode, m_bus_highlight, m_bus_parse, m_bus_parse_with_key, m_bus_render, version
 } from "./m_bus_parser_wasm_pack_bg.js";

package/m_bus_parser_wasm_pack_bg.js

@@ -1,4 +1,53 @@
 /**
+ * Decode into the canonical schema as a native JavaScript object.
+ * @param {string} data
+ * @param {string | null} [key_hex]
+ * @param {boolean | null} [include_enrichment]
+ * @returns {any}
+ */
+export function m_bus_decode(data, key_hex, include_enrichment) {
+    const ptr0 = passStringToWasm0(data, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    var ptr1 = isLikeNone(key_hex) ? 0 : passStringToWasm0(key_hex, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len1 = WASM_VECTOR_LEN;
+    const ret = wasm.m_bus_decode(ptr0, len0, ptr1, len1, isLikeNone(include_enrichment) ? 0xFFFFFF : include_enrichment ? 1 : 0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Highlight JSON, YAML, CSV, XML, or plaintext with the bundled Rust grammar set.
+ * @param {string} source
+ * @param {string} language
+ * @returns {string}
+ */
+export function m_bus_highlight(source, language) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(language, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.m_bus_highlight(ptr0, len0, ptr1, len1);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
+/**
+ * Compatibility wrapper returning errors as text. Prefer `m_bus_render`.
  * @param {string} data
  * @param {string} format
  * @returns {string}
@@ -21,6 +70,7 @@ export function m_bus_parse(data, format) {
 }
 
 /**
+ * Compatibility wrapper returning errors as text. Prefer `m_bus_render`.
  * @param {string} data
  * @param {string} format
  * @param {string} key_hex
@@ -45,6 +95,40 @@ export function m_bus_parse_with_key(data, format, key_hex) {
     }
 }
 
+/**
+ * Render with the shared Rust/Python/CLI output contract.
+ * @param {string} data
+ * @param {string} format
+ * @param {string | null} [key_hex]
+ * @param {number | null} [width]
+ * @param {boolean | null} [include_enrichment]
+ * @returns {string}
+ */
+export function m_bus_render(data, format, key_hex, width, include_enrichment) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const ptr0 = passStringToWasm0(data, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(format, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        var ptr2 = isLikeNone(key_hex) ? 0 : passStringToWasm0(key_hex, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len2 = WASM_VECTOR_LEN;
+        const ret = wasm.m_bus_render(ptr0, len0, ptr1, len1, ptr2, len2, isLikeNone(width) ? Number.MAX_SAFE_INTEGER : (width) >>> 0, isLikeNone(include_enrichment) ? 0xFFFFFF : include_enrichment ? 1 : 0);
+        var ptr4 = ret[0];
+        var len4 = ret[1];
+        if (ret[3]) {
+            ptr4 = 0; len4 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred5_0 = ptr4;
+        deferred5_1 = len4;
+        return getStringFromWasm0(ptr4, len4);
+    } finally {
+        wasm.__wbindgen_free(deferred5_0, deferred5_1, 1);
+    }
+}
+
 /**
  * @returns {string}
  */
@@ -60,6 +144,89 @@ export function version() {
         wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
     }
 }
+export function __wbg_Error_92b29b0548f8b746(arg0, arg1) {
+    const ret = Error(getStringFromWasm0(arg0, arg1));
+    return ret;
+}
+export function __wbg_String_8564e559799eccda(arg0, arg1) {
+    const ret = String(arg1);
+    const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+}
+export function __wbg___wbindgen_is_string_ea5e6cc2e4141dfe(arg0) {
+    const ret = typeof(arg0) === 'string';
+    return ret;
+}
+export function __wbg___wbindgen_string_get_b0ca35b86a603356(arg0, arg1) {
+    const obj = arg1;
+    const ret = typeof(obj) === 'string' ? obj : undefined;
+    var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+}
+export function __wbg___wbindgen_throw_344f42d3211c4765(arg0, arg1) {
+    throw new Error(getStringFromWasm0(arg0, arg1));
+}
+export function __wbg_new_32b398fb48b6d94a() {
+    const ret = new Array();
+    return ret;
+}
+export function __wbg_new_7796ffc7ed656783() {
+    const ret = new Map();
+    return ret;
+}
+export function __wbg_new_b667d279fd5aa943(arg0, arg1) {
+    const ret = new Error(getStringFromWasm0(arg0, arg1));
+    return ret;
+}
+export function __wbg_new_da52cf8fe3429cb2() {
+    const ret = new Object();
+    return ret;
+}
+export function __wbg_set_575dd786d51585f8(arg0, arg1, arg2) {
+    const ret = arg0.set(arg1, arg2);
+    return ret;
+}
+export function __wbg_set_6be42768c690e380(arg0, arg1, arg2) {
+    arg0[arg1] = arg2;
+}
+export function __wbg_set_8535240470bf2500() { return handleError(function (arg0, arg1, arg2) {
+    const ret = Reflect.set(arg0, arg1, arg2);
+    return ret;
+}, arguments); }
+export function __wbg_set_8a16b38e4805b298(arg0, arg1, arg2) {
+    arg0[arg1 >>> 0] = arg2;
+}
+export function __wbg_set_name_3bbc583faefa4193(arg0, arg1, arg2) {
+    arg0.name = getStringFromWasm0(arg1, arg2);
+}
+export function __wbg_stringify_b54333f60f1e4dad() { return handleError(function (arg0) {
+    const ret = JSON.stringify(arg0);
+    return ret;
+}, arguments); }
+export function __wbindgen_cast_0000000000000001(arg0) {
+    // Cast intrinsic for `F64 -> Externref`.
+    const ret = arg0;
+    return ret;
+}
+export function __wbindgen_cast_0000000000000002(arg0) {
+    // Cast intrinsic for `I64 -> Externref`.
+    const ret = arg0;
+    return ret;
+}
+export function __wbindgen_cast_0000000000000003(arg0, arg1) {
+    // Cast intrinsic for `Ref(String) -> Externref`.
+    const ret = getStringFromWasm0(arg0, arg1);
+    return ret;
+}
+export function __wbindgen_cast_0000000000000004(arg0) {
+    // Cast intrinsic for `U64 -> Externref`.
+    const ret = BigInt.asUintN(64, arg0);
+    return ret;
+}
 export function __wbindgen_init_externref_table() {
     const table = wasm.__wbindgen_externrefs;
     const offset = table.grow(4);
@@ -69,6 +236,20 @@ export function __wbindgen_init_externref_table() {
     table.set(offset + 2, true);
     table.set(offset + 3, false);
 }
+function addToExternrefTable0(obj) {
+    const idx = wasm.__externref_table_alloc();
+    wasm.__wbindgen_externrefs.set(idx, obj);
+    return idx;
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
 function getStringFromWasm0(ptr, len) {
     return decodeText(ptr >>> 0, len);
 }
@@ -81,6 +262,19 @@ function getUint8ArrayMemory0() {
     return cachedUint8ArrayMemory0;
 }
 
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        const idx = addToExternrefTable0(e);
+        wasm.__wbindgen_exn_store(idx);
+    }
+}
+
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
 function passStringToWasm0(arg, malloc, realloc) {
     if (realloc === undefined) {
         const buf = cachedTextEncoder.encode(arg);
@@ -118,6 +312,12 @@ function passStringToWasm0(arg, malloc, realloc) {
     return ptr;
 }
 
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
 let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
 cachedTextDecoder.decode();
 const MAX_SAFARI_DECODE_BYTES = 2146435072;

package/package.json

@@ -5,7 +5,7 @@
     "Michael Aebli"
   ],
   "description": "A wasm-pack to use the library for parsing M-Bus frames",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "license": "MIT",
   "repository": {
     "type": "git",