Add JS guest

- Implement clocks/wall-clock
- Implement cli/environment

Signed-off-by: Doru Blânzeanu <dblnz@pm.me>

Author: dblnz

README.md

@@ -22,14 +22,23 @@ If you want to follow the manual build instructions, you will also need:
 
 ### Building
 
+```sh
+# Install JS dependencies
+npm install
+```
+
 ```sh
 just build
 ```
 
 ### Running
 
 ```sh
-just run
+# Run Rust
+just run-rust
+
+# Run JS
+just run-js
 ```
 
 From another terminal, you can then test the server:
@@ -53,11 +62,16 @@ Compile the WIT and set the environment variables used when building
 wasm-tools component wit hyperlight.wit -w -o hyperlight-world.wasm
 ```
 
-Build:
+Build Rust:
 ```
 cargo build
 ```
 
+Build JS:
+```
+npm run build
+```
+
 ### Running
 
 Build the guest component:
@@ -78,6 +92,12 @@ hyperlight-wasm-aot compile --component \
 
 You can then run the server:
 
+Rust:
 ```sh
 cargo run -- out/sample_wasi_http_rust.aot
 ```
+
+JS:
+```sh
+cargo run -- out/sample_wasi_http_js.aot
+```

eslint.config.js

@@ -0,0 +1,15 @@
+import { defineConfig } from "eslint/config";
+import js from "@eslint/js";
+import globals from "globals";
+
+export default defineConfig([
+  {
+    files: ["**/*.{js,mjs,cjs}"],
+    plugins: { js },
+    extends: ["js/recommended"],
+  },
+  {
+    files: ["**/*.{js,mjs,cjs}"],
+    languageOptions: { globals: globals.browser },
+  },
+]);

guest_js/endpoints/echo.js

@@ -0,0 +1,24 @@
+export { echo, echoHeaders };
+
+// Echo the body of the request in the response
+const echo = async (req) => {
+  const bodyText = req.body ? await req.text() : "No body to echo";
+
+  return new Response(bodyText, {
+    status: 200,
+    headers: {
+      "Content-Type": "text/plain",
+    },
+  });
+};
+
+// Echo all headers from the request in JSON format
+const echoHeaders = (req) => {
+  const headersObj = Object.fromEntries(req.headers.entries());
+  return new Response(JSON.stringify(headersObj, null, 2), {
+    status: 200,
+    headers: {
+      "Content-Type": "application/json",
+    },
+  });
+};

guest_js/endpoints/sleep.js

@@ -0,0 +1,14 @@
+export { sleep };
+
+// Async sleep function that returns a response after waiting
+const sleep = async (ms) => {
+  const msNum = parseInt(ms, 10);
+  await new Promise((resolve) => setTimeout(resolve, msNum));
+
+  return new Response(`Sleeping for ${ms}ms...`, {
+    status: 200,
+    headers: {
+      "Content-Type": "text/plain",
+    },
+  });
+};

guest_js/endpoints/upload.js

@@ -0,0 +1,24 @@
+export { upload };
+
+// Endpoint to handle file uploads using FormData and Blob
+const upload = async (req) => {
+  try {
+    const blob = await req.blob();
+
+    if (!blob || !(blob instanceof Blob)) {
+      return new Response("File not found in form data.", { status: 400 });
+    }
+
+    const text = await blob.text();
+
+    return new Response(text, {
+      headers: {
+        "Content-Type": blob.type || "application/octet-stream",
+      },
+    });
+  } catch (error) {
+    return new Response(`Error processing form data: ${error}`, {
+      status: 500,
+    });
+  }
+};

guest_js/server.js

@@ -0,0 +1,18 @@
+import { AutoRouter } from "itty-router";
+
+import { sleep } from "./endpoints/sleep.js";
+import { upload } from "./endpoints/upload.js";
+import { echo, echoHeaders } from "./endpoints/echo.js";
+
+let router = AutoRouter();
+
+router
+  .get("/", () => new Response("Hello, JS   wasi:http world!\n"))
+  .get("/echo-headers", (req) => echoHeaders(req))
+  .get("/sleep/:ms", async ({ ms }) => await sleep(ms))
+  .post("/echo", (req) => echo(req))
+  .post("/upload", async (req) => await upload(req));
+
+addEventListener("fetch", async (event) => {
+  event.respondWith(router.fetch(event.request));
+});

justfile

@@ -3,7 +3,7 @@ BIN_DIR := TARGET_DIR + "/bin"
 OUT_DIR := justfile_directory() + "/out"
 default-target := "release"
 
-default: run
+default: run-rust
 
 make-out-dir:
     mkdir -p {{ OUT_DIR }}
@@ -15,6 +15,10 @@ install-hyperlight-wasm-aot:
         --version 0.9.0 \
         --root {{ TARGET_DIR }}
 
+build-js-component: make-out-dir install-hyperlight-wasm-aot
+    npm run build
+    cd {{ OUT_DIR }} && {{ BIN_DIR }}/hyperlight-wasm-aot compile --component sample-wasi-http-js.wasm
+
 build-rust-component target=default-target: make-out-dir install-hyperlight-wasm-aot
     cargo component build \
       --profile={{ if target == "debug" { "dev" } else { target } }} \
@@ -34,6 +38,8 @@ make-wit-world: install-wasm-tools
 build: make-wit-world
     cargo build
 
-run: build build-rust-component
+run-rust: build build-rust-component
     cargo run -- {{ OUT_DIR }}/sample_wasi_http_rust.aot
 
+run-js: build build-js-component
+    cargo run -- {{ OUT_DIR }}/sample-wasi-http-js.aot