polish

Signed-off-by: Adrian Cole <[email protected]>

Author: codefromthecrypt

examples/log_once.wat

@@ -35,10 +35,10 @@
     ;; ctxNext := handleRequest()
     (local.set $ctx_next (call $handle_request))
 
-    ;; isError := awaitResponse(ctxNext())
+    ;; isError := awaitResponse(ctxNext)
     (local.set $is_error (call $await_response (local.get $ctx_next)))
 
-    ;; expected_count = uint32(result >> 32)
+    ;; ctx = uint32(ctxNext >> 32)
     (local.set $ctx
       (i32.wrap_i64 (i64.shr_u (local.get $ctx_next) (i64.const 32))))
 

internal/test/testdata/e2e/await_response.wat

@@ -1,10 +1,18 @@
 (module $await_response
 
+(; begin adapter logic
+
+   Below is generic and can convert any normal handler to a single synchronous
+   call, provided $handle_request and $handle_response are not exported. ;)
+
+  ;; import $await_response, which blocks until the response is ready.
   (import "http_handler" "await_response" (func $await_response
     (param $ctx_next i64)
     (result (; is_error ;) i32)))
 
   ;; define a start function that performs a request-response without exports.
+  ;; note: this logic is generic and can convert any exported $handle_request/
+  ;; $handle_response pair to a synchronous call without exports.
   (func $start
     (local $ctx_next i64)
     (local $is_error i32)
@@ -13,16 +21,18 @@
     ;; ctxNext := handleRequest()
     (local.set $ctx_next (call $handle_request))
 
-    ;; isError := awaitResponse(ctxNext())
+    ;; isError := awaitResponse(ctxNext)
     (local.set $is_error (call $await_response (local.get $ctx_next)))
 
-    ;; expected_count = uint32(result >> 32)
+    ;; ctx = uint32(ctxNext >> 32)
     (local.set $ctx
       (i32.wrap_i64 (i64.shr_u (local.get $ctx_next) (i64.const 32))))
 
     (call $handle_response (local.get $ctx) (local.get $is_error))
   )
 
+(; end adapter logic ;)
+
   (memory (export "memory") 1 1 (; 1 page==64KB ;))
 
   ;; reqCtx is the upper 32-bits of the $ctx_next result the host should