@ruby/head-wasm-wasi 2.4.1 → 2.5.0

package/dist/browser.script.umd.js

@@ -55,6 +55,107 @@ Please replace your \`require('ruby-head-wasm-wasi/dist/browser.script.umd');\`
 
     class WASIProcExit extends Error{constructor(code){super("exit with exit code "+code);this.code=code;}}let WASI=class WASI{start(instance){this.inst=instance;try{instance.exports._start();}catch(e){if(e instanceof WASIProcExit){return e.code}else {throw e}}}initialize(instance){this.inst=instance;instance.exports._initialize();}constructor(args,env,fds,options={}){this.args=[];this.env=[];this.fds=[];debug.enable(options.debug);this.args=args;this.env=env;this.fds=fds;const self=this;this.wasiImport={args_sizes_get(argc,argv_buf_size){const buffer=new DataView(self.inst.exports.memory.buffer);buffer.setUint32(argc,self.args.length,true);let buf_size=0;for(const arg of self.args){buf_size+=arg.length+1;}buffer.setUint32(argv_buf_size,buf_size,true);debug.log(buffer.getUint32(argc,true),buffer.getUint32(argv_buf_size,true));return 0},args_get(argv,argv_buf){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);const orig_argv_buf=argv_buf;for(let i=0;i<self.args.length;i++){buffer.setUint32(argv,argv_buf,true);argv+=4;const arg=new TextEncoder().encode(self.args[i]);buffer8.set(arg,argv_buf);buffer.setUint8(argv_buf+arg.length,0);argv_buf+=arg.length+1;}if(debug.enabled){debug.log(new TextDecoder("utf-8").decode(buffer8.slice(orig_argv_buf,argv_buf)));}return 0},environ_sizes_get(environ_count,environ_size){const buffer=new DataView(self.inst.exports.memory.buffer);buffer.setUint32(environ_count,self.env.length,true);let buf_size=0;for(const environ of self.env){buf_size+=environ.length+1;}buffer.setUint32(environ_size,buf_size,true);debug.log(buffer.getUint32(environ_count,true),buffer.getUint32(environ_size,true));return 0},environ_get(environ,environ_buf){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);const orig_environ_buf=environ_buf;for(let i=0;i<self.env.length;i++){buffer.setUint32(environ,environ_buf,true);environ+=4;const e=new TextEncoder().encode(self.env[i]);buffer8.set(e,environ_buf);buffer.setUint8(environ_buf+e.length,0);environ_buf+=e.length+1;}if(debug.enabled){debug.log(new TextDecoder("utf-8").decode(buffer8.slice(orig_environ_buf,environ_buf)));}return 0},clock_res_get(id,res_ptr){let resolutionValue;switch(id){case CLOCKID_MONOTONIC:{resolutionValue=5000n;break}case CLOCKID_REALTIME:{resolutionValue=1000000n;break}default:return ERRNO_NOSYS}const view=new DataView(self.inst.exports.memory.buffer);view.setBigUint64(res_ptr,resolutionValue,true);return ERRNO_SUCCESS},clock_time_get(id,precision,time){const buffer=new DataView(self.inst.exports.memory.buffer);if(id===CLOCKID_REALTIME){buffer.setBigUint64(time,BigInt(new Date().getTime())*1000000n,true);}else if(id==CLOCKID_MONOTONIC){let monotonic_time;try{monotonic_time=BigInt(Math.round(performance.now()*1e6));}catch(e){monotonic_time=0n;}buffer.setBigUint64(time,monotonic_time,true);}else {buffer.setBigUint64(time,0n,true);}return 0},fd_advise(fd,offset,len,advice){if(self.fds[fd]!=undefined){return self.fds[fd].fd_advise(offset,len,advice)}else {return ERRNO_BADF}},fd_allocate(fd,offset,len){if(self.fds[fd]!=undefined){return self.fds[fd].fd_allocate(offset,len)}else {return ERRNO_BADF}},fd_close(fd){if(self.fds[fd]!=undefined){const ret=self.fds[fd].fd_close();self.fds[fd]=undefined;return ret}else {return ERRNO_BADF}},fd_datasync(fd){if(self.fds[fd]!=undefined){return self.fds[fd].fd_datasync()}else {return ERRNO_BADF}},fd_fdstat_get(fd,fdstat_ptr){if(self.fds[fd]!=undefined){const{ret,fdstat}=self.fds[fd].fd_fdstat_get();if(fdstat!=null){fdstat.write_bytes(new DataView(self.inst.exports.memory.buffer),fdstat_ptr);}return ret}else {return ERRNO_BADF}},fd_fdstat_set_flags(fd,flags){if(self.fds[fd]!=undefined){return self.fds[fd].fd_fdstat_set_flags(flags)}else {return ERRNO_BADF}},fd_fdstat_set_rights(fd,fs_rights_base,fs_rights_inheriting){if(self.fds[fd]!=undefined){return self.fds[fd].fd_fdstat_set_rights(fs_rights_base,fs_rights_inheriting)}else {return ERRNO_BADF}},fd_filestat_get(fd,filestat_ptr){if(self.fds[fd]!=undefined){const{ret,filestat}=self.fds[fd].fd_filestat_get();if(filestat!=null){filestat.write_bytes(new DataView(self.inst.exports.memory.buffer),filestat_ptr);}return ret}else {return ERRNO_BADF}},fd_filestat_set_size(fd,size){if(self.fds[fd]!=undefined){return self.fds[fd].fd_filestat_set_size(size)}else {return ERRNO_BADF}},fd_filestat_set_times(fd,atim,mtim,fst_flags){if(self.fds[fd]!=undefined){return self.fds[fd].fd_filestat_set_times(atim,mtim,fst_flags)}else {return ERRNO_BADF}},fd_pread(fd,iovs_ptr,iovs_len,offset,nread_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const iovecs=Iovec.read_bytes_array(buffer,iovs_ptr,iovs_len);const{ret,nread}=self.fds[fd].fd_pread(buffer8,iovecs,offset);buffer.setUint32(nread_ptr,nread,true);return ret}else {return ERRNO_BADF}},fd_prestat_get(fd,buf_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const{ret,prestat}=self.fds[fd].fd_prestat_get();if(prestat!=null){prestat.write_bytes(buffer,buf_ptr);}return ret}else {return ERRNO_BADF}},fd_prestat_dir_name(fd,path_ptr,path_len){if(self.fds[fd]!=undefined){const{ret,prestat_dir_name}=self.fds[fd].fd_prestat_dir_name();if(prestat_dir_name!=null){const buffer8=new Uint8Array(self.inst.exports.memory.buffer);buffer8.set(prestat_dir_name,path_ptr);}return ret}else {return ERRNO_BADF}},fd_pwrite(fd,iovs_ptr,iovs_len,offset,nwritten_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const iovecs=Ciovec.read_bytes_array(buffer,iovs_ptr,iovs_len);const{ret,nwritten}=self.fds[fd].fd_pwrite(buffer8,iovecs,offset);buffer.setUint32(nwritten_ptr,nwritten,true);return ret}else {return ERRNO_BADF}},fd_read(fd,iovs_ptr,iovs_len,nread_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const iovecs=Iovec.read_bytes_array(buffer,iovs_ptr,iovs_len);const{ret,nread}=self.fds[fd].fd_read(buffer8,iovecs);buffer.setUint32(nread_ptr,nread,true);return ret}else {return ERRNO_BADF}},fd_readdir(fd,buf,buf_len,cookie,bufused_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){let bufused=0;while(true){const{ret,dirent}=self.fds[fd].fd_readdir_single(cookie);if(ret!=0){buffer.setUint32(bufused_ptr,bufused,true);return ret}if(dirent==null){break}if(buf_len-bufused<dirent.head_length()){bufused=buf_len;break}const head_bytes=new ArrayBuffer(dirent.head_length());dirent.write_head_bytes(new DataView(head_bytes),0);buffer8.set(new Uint8Array(head_bytes).slice(0,Math.min(head_bytes.byteLength,buf_len-bufused)),buf);buf+=dirent.head_length();bufused+=dirent.head_length();if(buf_len-bufused<dirent.name_length()){bufused=buf_len;break}dirent.write_name_bytes(buffer8,buf,buf_len-bufused);buf+=dirent.name_length();bufused+=dirent.name_length();cookie=dirent.d_next;}buffer.setUint32(bufused_ptr,bufused,true);return 0}else {return ERRNO_BADF}},fd_renumber(fd,to){if(self.fds[fd]!=undefined&&self.fds[to]!=undefined){const ret=self.fds[to].fd_close();if(ret!=0){return ret}self.fds[to]=self.fds[fd];self.fds[fd]=undefined;return 0}else {return ERRNO_BADF}},fd_seek(fd,offset,whence,offset_out_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const{ret,offset:offset_out}=self.fds[fd].fd_seek(offset,whence);buffer.setBigInt64(offset_out_ptr,offset_out,true);return ret}else {return ERRNO_BADF}},fd_sync(fd){if(self.fds[fd]!=undefined){return self.fds[fd].fd_sync()}else {return ERRNO_BADF}},fd_tell(fd,offset_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const{ret,offset}=self.fds[fd].fd_tell();buffer.setBigUint64(offset_ptr,offset,true);return ret}else {return ERRNO_BADF}},fd_write(fd,iovs_ptr,iovs_len,nwritten_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const iovecs=Ciovec.read_bytes_array(buffer,iovs_ptr,iovs_len);const{ret,nwritten}=self.fds[fd].fd_write(buffer8,iovecs);buffer.setUint32(nwritten_ptr,nwritten,true);return ret}else {return ERRNO_BADF}},path_create_directory(fd,path_ptr,path_len){const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const path=new TextDecoder("utf-8").decode(buffer8.slice(path_ptr,path_ptr+path_len));return self.fds[fd].path_create_directory(path)}},path_filestat_get(fd,flags,path_ptr,path_len,filestat_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const path=new TextDecoder("utf-8").decode(buffer8.slice(path_ptr,path_ptr+path_len));const{ret,filestat}=self.fds[fd].path_filestat_get(flags,path);if(filestat!=null){filestat.write_bytes(buffer,filestat_ptr);}return ret}else {return ERRNO_BADF}},path_filestat_set_times(fd,flags,path_ptr,path_len,atim,mtim,fst_flags){const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const path=new TextDecoder("utf-8").decode(buffer8.slice(path_ptr,path_ptr+path_len));return self.fds[fd].path_filestat_set_times(flags,path,atim,mtim,fst_flags)}else {return ERRNO_BADF}},path_link(old_fd,old_flags,old_path_ptr,old_path_len,new_fd,new_path_ptr,new_path_len){const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[old_fd]!=undefined&&self.fds[new_fd]!=undefined){const old_path=new TextDecoder("utf-8").decode(buffer8.slice(old_path_ptr,old_path_ptr+old_path_len));const new_path=new TextDecoder("utf-8").decode(buffer8.slice(new_path_ptr,new_path_ptr+new_path_len));return self.fds[new_fd].path_link(old_fd,old_flags,old_path,new_path)}else {return ERRNO_BADF}},path_open(fd,dirflags,path_ptr,path_len,oflags,fs_rights_base,fs_rights_inheriting,fd_flags,opened_fd_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const path=new TextDecoder("utf-8").decode(buffer8.slice(path_ptr,path_ptr+path_len));debug.log(path);const{ret,fd_obj}=self.fds[fd].path_open(dirflags,path,oflags,fs_rights_base,fs_rights_inheriting,fd_flags);if(ret!=0){return ret}self.fds.push(fd_obj);const opened_fd=self.fds.length-1;buffer.setUint32(opened_fd_ptr,opened_fd,true);return 0}else {return ERRNO_BADF}},path_readlink(fd,path_ptr,path_len,buf_ptr,buf_len,nread_ptr){const buffer=new DataView(self.inst.exports.memory.buffer);const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const path=new TextDecoder("utf-8").decode(buffer8.slice(path_ptr,path_ptr+path_len));debug.log(path);const{ret,data}=self.fds[fd].path_readlink(path);if(data!=null){if(data.length>buf_len){buffer.setUint32(nread_ptr,0,true);return ERRNO_BADF}buffer8.set(data,buf_ptr);buffer.setUint32(nread_ptr,data.length,true);}return ret}else {return ERRNO_BADF}},path_remove_directory(fd,path_ptr,path_len){const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const path=new TextDecoder("utf-8").decode(buffer8.slice(path_ptr,path_ptr+path_len));return self.fds[fd].path_remove_directory(path)}else {return ERRNO_BADF}},path_rename(fd,old_path_ptr,old_path_len,new_fd,new_path_ptr,new_path_len){throw "FIXME what is the best abstraction for this?"},path_symlink(old_path_ptr,old_path_len,fd,new_path_ptr,new_path_len){const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const old_path=new TextDecoder("utf-8").decode(buffer8.slice(old_path_ptr,old_path_ptr+old_path_len));const new_path=new TextDecoder("utf-8").decode(buffer8.slice(new_path_ptr,new_path_ptr+new_path_len));return self.fds[fd].path_symlink(old_path,new_path)}else {return ERRNO_BADF}},path_unlink_file(fd,path_ptr,path_len){const buffer8=new Uint8Array(self.inst.exports.memory.buffer);if(self.fds[fd]!=undefined){const path=new TextDecoder("utf-8").decode(buffer8.slice(path_ptr,path_ptr+path_len));return self.fds[fd].path_unlink_file(path)}else {return ERRNO_BADF}},poll_oneoff(in_,out,nsubscriptions){throw "async io not supported"},proc_exit(exit_code){throw new WASIProcExit(exit_code)},proc_raise(sig){throw "raised signal "+sig},sched_yield(){},random_get(buf,buf_len){const buffer8=new Uint8Array(self.inst.exports.memory.buffer);for(let i=0;i<buf_len;i++){buffer8[buf+i]=Math.random()*256|0;}},sock_recv(fd,ri_data,ri_flags){throw "sockets not supported"},sock_send(fd,si_data,si_flags){throw "sockets not supported"},sock_shutdown(fd,how){throw "sockets not supported"},sock_accept(fd,flags){throw "sockets not supported"}};}};
 
+    /**
+     * Create a console printer that can be used as an overlay of WASI imports.
+     * See the example below for how to use it.
+     *
+     * ```javascript
+     * const imports = {
+     *  "wasi_snapshot_preview1": wasi.wasiImport,
+     * }
+     * const printer = consolePrinter();
+     * printer.addToImports(imports);
+     *
+     * const instance = await WebAssembly.instantiate(module, imports);
+     * printer.setMemory(instance.exports.memory);
+     * ```
+     *
+     * Note that the `stdout` and `stderr` functions are called with text, not
+     * bytes. This means that bytes written to stdout/stderr will be decoded as
+     * UTF-8 and then passed to the `stdout`/`stderr` functions every time a write
+     * occurs without buffering.
+     *
+     * @param stdout A function that will be called when stdout is written to.
+     *               Defaults to `console.log`.
+     * @param stderr A function that will be called when stderr is written to.
+     *               Defaults to `console.warn`.
+     * @returns An object that can be used as an overlay of WASI imports.
+     */
+    function consolePrinter({ stdout, stderr, } = {
+        stdout: console.log,
+        stderr: console.warn,
+    }) {
+        let memory = undefined;
+        let _view = undefined;
+        function getMemoryView() {
+            if (typeof memory === "undefined") {
+                throw new Error("Memory is not set");
+            }
+            if (_view === undefined || _view.buffer.byteLength === 0) {
+                _view = new DataView(memory.buffer);
+            }
+            return _view;
+        }
+        const decoder = new TextDecoder();
+        return {
+            addToImports(imports) {
+                const wasiImport = imports.wasi_snapshot_preview1;
+                const original_fd_write = wasiImport.fd_write;
+                wasiImport.fd_write = (fd, iovs, iovsLen, nwritten) => {
+                    if (fd !== 1 && fd !== 2) {
+                        return original_fd_write(fd, iovs, iovsLen, nwritten);
+                    }
+                    const view = getMemoryView();
+                    const buffers = Array.from({ length: iovsLen }, (_, i) => {
+                        const ptr = iovs + i * 8;
+                        const buf = view.getUint32(ptr, true);
+                        const bufLen = view.getUint32(ptr + 4, true);
+                        return new Uint8Array(memory.buffer, buf, bufLen);
+                    });
+                    let written = 0;
+                    let str = "";
+                    for (const buffer of buffers) {
+                        str += decoder.decode(buffer);
+                        written += buffer.byteLength;
+                    }
+                    view.setUint32(nwritten, written, true);
+                    const log = fd === 1 ? stdout : stderr;
+                    log(str);
+                    return 0;
+                };
+                const original_fd_filestat_get = wasiImport.fd_filestat_get;
+                wasiImport.fd_filestat_get = (fd, filestat) => {
+                    if (fd !== 1 && fd !== 2) {
+                        return original_fd_filestat_get(fd, filestat);
+                    }
+                    const view = getMemoryView();
+                    const result = original_fd_filestat_get(fd, filestat);
+                    if (result !== 0) {
+                        return result;
+                    }
+                    const filetypePtr = filestat + 0;
+                    view.setUint8(filetypePtr, 2); // FILETYPE_CHARACTER_DEVICE
+                    return 0;
+                };
+                const original_fd_fdstat_get = wasiImport.fd_fdstat_get;
+                wasiImport.fd_fdstat_get = (fd, fdstat) => {
+                    if (fd !== 1 && fd !== 2) {
+                        return original_fd_fdstat_get(fd, fdstat);
+                    }
+                    const view = getMemoryView();
+                    const fs_filetypePtr = fdstat + 0;
+                    view.setUint8(fs_filetypePtr, 2); // FILETYPE_CHARACTER_DEVICE
+                    const fs_rights_basePtr = fdstat + 8;
+                    view.setBigUint64(fs_rights_basePtr, BigInt(1)); // RIGHTS_FD_WRITE
+                    return 0;
+                };
+            },
+            setMemory(m) {
+                memory = m;
+            },
+        };
+    }
+
     let DATA_VIEW = new DataView(new ArrayBuffer());
 
     function data_view(mem) {
@@ -652,107 +753,6 @@ Please replace your \`require('ruby-head-wasm-wasi/dist/browser.script.umd');\`
       };
     }
 
-    /**
-     * Create a console printer that can be used as an overlay of WASI imports.
-     * See the example below for how to use it.
-     *
-     * ```javascript
-     * const imports = {
-     *  "wasi_snapshot_preview1": wasi.wasiImport,
-     * }
-     * const printer = consolePrinter();
-     * printer.addToImports(imports);
-     *
-     * const instance = await WebAssembly.instantiate(module, imports);
-     * printer.setMemory(instance.exports.memory);
-     * ```
-     *
-     * Note that the `stdout` and `stderr` functions are called with text, not
-     * bytes. This means that bytes written to stdout/stderr will be decoded as
-     * UTF-8 and then passed to the `stdout`/`stderr` functions every time a write
-     * occurs without buffering.
-     *
-     * @param stdout A function that will be called when stdout is written to.
-     *               Defaults to `console.log`.
-     * @param stderr A function that will be called when stderr is written to.
-     *               Defaults to `console.warn`.
-     * @returns An object that can be used as an overlay of WASI imports.
-     */
-    function consolePrinter({ stdout, stderr, } = {
-        stdout: console.log,
-        stderr: console.warn,
-    }) {
-        let memory = undefined;
-        let _view = undefined;
-        function getMemoryView() {
-            if (typeof memory === "undefined") {
-                throw new Error("Memory is not set");
-            }
-            if (_view === undefined || _view.buffer.byteLength === 0) {
-                _view = new DataView(memory.buffer);
-            }
-            return _view;
-        }
-        const decoder = new TextDecoder();
-        return {
-            addToImports(imports) {
-                const wasiImport = imports.wasi_snapshot_preview1;
-                const original_fd_write = wasiImport.fd_write;
-                wasiImport.fd_write = (fd, iovs, iovsLen, nwritten) => {
-                    if (fd !== 1 && fd !== 2) {
-                        return original_fd_write(fd, iovs, iovsLen, nwritten);
-                    }
-                    const view = getMemoryView();
-                    const buffers = Array.from({ length: iovsLen }, (_, i) => {
-                        const ptr = iovs + i * 8;
-                        const buf = view.getUint32(ptr, true);
-                        const bufLen = view.getUint32(ptr + 4, true);
-                        return new Uint8Array(memory.buffer, buf, bufLen);
-                    });
-                    let written = 0;
-                    let str = "";
-                    for (const buffer of buffers) {
-                        str += decoder.decode(buffer);
-                        written += buffer.byteLength;
-                    }
-                    view.setUint32(nwritten, written, true);
-                    const log = fd === 1 ? stdout : stderr;
-                    log(str);
-                    return 0;
-                };
-                const original_fd_filestat_get = wasiImport.fd_filestat_get;
-                wasiImport.fd_filestat_get = (fd, filestat) => {
-                    if (fd !== 1 && fd !== 2) {
-                        return original_fd_filestat_get(fd, filestat);
-                    }
-                    const view = getMemoryView();
-                    const result = original_fd_filestat_get(fd, filestat);
-                    if (result !== 0) {
-                        return result;
-                    }
-                    const filetypePtr = filestat + 0;
-                    view.setUint8(filetypePtr, 2); // FILETYPE_CHARACTER_DEVICE
-                    return 0;
-                };
-                const original_fd_fdstat_get = wasiImport.fd_fdstat_get;
-                wasiImport.fd_fdstat_get = (fd, fdstat) => {
-                    if (fd !== 1 && fd !== 2) {
-                        return original_fd_fdstat_get(fd, fdstat);
-                    }
-                    const view = getMemoryView();
-                    const fs_filetypePtr = fdstat + 0;
-                    view.setUint8(fs_filetypePtr, 2); // FILETYPE_CHARACTER_DEVICE
-                    const fs_rights_basePtr = fdstat + 8;
-                    view.setBigUint64(fs_rights_basePtr, BigInt(1)); // RIGHTS_FD_WRITE
-                    return 0;
-                };
-            },
-            setMemory(m) {
-                memory = m;
-            },
-        };
-    }
-
     /**
      * A Ruby VM instance
      *
@@ -825,11 +825,12 @@ Please replace your \`require('ruby-head-wasm-wasi/dist/browser.script.umd');\`
          * @param args The command line arguments to pass to Ruby. Must be
          * an array of strings starting with the Ruby program name.
          */
-        initialize(args = ["ruby.wasm", "--disable-gems", "-EUTF-8", "-e_=0"]) {
+        initialize(args = ["ruby.wasm", "-EUTF-8", "-e_=0"]) {
             const c_args = args.map((arg) => arg + "\0");
             this.guest.rubyInit();
             this.guest.rubySysinit(c_args);
             this.guest.rubyOptions(c_args);
+            this.eval(`require "/bundle/setup"`);
         }
         /**
          * Set a given instance to interact JavaScript and Ruby's
@@ -1064,13 +1065,8 @@ Please replace your \`require('ruby-head-wasm-wasi/dist/browser.script.umd');\`
          */
         evalAsync(code) {
             const JS = this.eval("require 'js'; JS");
-            return new Promise((resolve, reject) => {
-                JS.call("__eval_async_rb", this.wrap(code), this.wrap({
-                    resolve,
-                    reject: (error) => {
-                        reject(new RbError(this.exceptionFormatter.format(error, this, this.privateObject())));
-                    },
-                }));
+            return newRbPromise(this, this.privateObject(), (future) => {
+                JS.call("__eval_async_rb", this.wrap(code), future);
             });
         }
         /**
@@ -1155,17 +1151,42 @@ Please replace your \`require('ruby-head-wasm-wasi/dist/browser.script.umd');\`
          *
          * @param callee name of the Ruby method to call
          * @param args arguments to pass to the method. Must be an array of RbValue
+         * @returns The result of the method call as a new RbValue.
          *
          * @example
          * const ary = vm.eval("[1, 2, 3]");
          * ary.call("push", 4);
          * console.log(ary.call("sample").toString());
-         *
          */
         call(callee, ...args) {
             const innerArgs = args.map((arg) => arg.inner);
             return new RbValue(callRbMethod(this.vm, this.privateObject, this.inner, callee, innerArgs), this.vm, this.privateObject);
         }
+        /**
+         * Call a given method that may call `JS::Object#await` with given arguments
+         *
+         * @param callee name of the Ruby method to call
+         * @param args arguments to pass to the method. Must be an array of RbValue
+         * @returns A Promise that resolves to the result of the method call as a new RbValue.
+         *
+         * @example
+         * const client = vm.eval(`
+         *   require 'js'
+         *   class HttpClient
+         *     def get(url)
+         *       JS.global.fetch(url).await
+         *     end
+         *   end
+         *   HttpClient.new
+         * `);
+         * const response = await client.callAsync("get", vm.eval(`"https://example.com"`));
+         */
+        callAsync(callee, ...args) {
+            const JS = this.vm.eval("require 'js'; JS");
+            return newRbPromise(this.vm, this.privateObject, (future) => {
+                JS.call("__call_async_method", this, this.vm.wrap(callee), future, ...args);
+            });
+        }
         /**
          * @see {@link https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toPrimitive}
          * @param hint Preferred type of the result primitive value. `"number"`, `"string"`, or `"default"`.
@@ -1364,6 +1385,18 @@ Please replace your \`require('ruby-head-wasm-wasi/dist/browser.script.umd');\`
             return new RbValue(value, vm, privateObject);
         });
     };
+    function newRbPromise(vm, privateObject, body) {
+        return new Promise((resolve, reject) => {
+            const future = vm.wrap({
+                resolve,
+                reject: (error) => {
+                    const rbError = new RbError(privateObject.exceptionFormatter.format(error, vm, privateObject));
+                    reject(rbError);
+                },
+            });
+            body(future);
+        });
+    }
     /**
      * Error class thrown by Ruby execution
      */