Synchronous WASM init

README.md

@@ -198,9 +198,14 @@ The code fragment below shows how to instantiate a resizable 32 bits WebAssembly
 ```
 import * as hdr from "hdr-histogram-js"
 
-// load HdrHistogramJS WASM module
+// If you are on the browser side, you need to
+// load asynchronously HdrHistogramJS WASM module
 await hdr.initWebAssembly();
 
+// If you are on the server side, you can
+// load synchronously HdrHistogramJS WASM module
+hdr.initWebAssemblySync();
+
 const histogram = hdr.build({ useWebAssembly: true });
 
 // you can now use your histogram the same way you would do

src/Histogram.spec.ts

@@ -2,7 +2,7 @@ import { build } from ".";
 import JsHistogram from "./JsHistogram";
 import { NO_TAG } from "./Histogram";
 import Int32Histogram from "./Int32Histogram";
-import { initWebAssembly, WasmHistogram } from "./wasm";
+import { initWebAssembly, WasmHistogram, initWebAssemblySync } from "./wasm";
 import Int8Histogram from "./Int8Histogram";
 import Histogram from "./Histogram";
 
@@ -309,7 +309,7 @@ describe("WASM Histogram not initialized", () => {
 });
 
 describe("WASM Histogram not happy path", () => {
-  beforeEach(initWebAssembly);
+  beforeEach(initWebAssemblySync);
   it("should throw a clear error message when used after destroy", () => {
     const destroyedHistogram = build({ useWebAssembly: true });
     destroyedHistogram.destroy();

src/index.ts

@@ -19,11 +19,12 @@ import Int8Histogram from "./Int8Histogram";
 import JsHistogram from "./JsHistogram";
 import PackedHistogram from "./PackedHistogram";
 import Recorder from "./Recorder";
-import { initWebAssembly, WasmHistogram } from "./wasm";
+import { initWebAssembly, initWebAssemblySync, WasmHistogram } from "./wasm";
 import { build } from "./HistogramBuilder";
 
 export {
   initWebAssembly,
+  initWebAssemblySync,
   Int8Histogram,
   Int16Histogram,
   Int32Histogram,

src/wasm/index.ts

@@ -43,6 +43,11 @@ export const initWebAssembly = async (): Promise<void> => {
     .then((w: any) => (wasm = w.exports || w));
 };
 
+export const initWebAssemblySync = () => {
+  const w = loader.instantiateSync(pako.inflate(base64.toByteArray(BINARY)));
+  wasm = w.exports || w;
+};
+
 export const webAssemblyReady = () => !!wasm;
 
 const defaultRequest: BuildRequest = {