@primate/go 0.1.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) Terrablue <terrablue@proton.me> and contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@primate/go",
+  "version": "0.1.0",
+  "description": "Primate Go backend",
+  "homepage": "https://primatejs.com/modules/go",
+  "bugs": "https://github.com/primatejs/primate/issues",
+  "license": "MIT",
+  "files": [
+    "src/**/*.js",
+    "!src/**/*.spec.js",
+    "src/**/*.go",
+    "src/**/*.sum",
+    "src/**/*.mod"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/primatejs/primate",
+    "directory": "packages/go"
+  },
+  "dependencies": {
+    "@rcompat/cli": "^0.5.1",
+    "@rcompat/env": "^0.3.0",
+    "@rcompat/fs": "^0.4.0",
+    "@rcompat/invariant": "^0.5.0",
+    "@rcompat/object": "^0.5.0",
+    "@rcompat/platform": "^0.3.0",
+    "@rcompat/stdio": "^0.4.0",
+    "@primate/core": "^0.1.0"
+  },
+  "peerDependencies": {
+    "primate": "^0.32.0"
+  },
+  "type": "module",
+  "imports": {
+    "#*": {
+      "@primate/lt": "./src/private/*.js",
+      "default": "./src/private/*.js"
+    },
+    "#error/*": {
+      "@primate/lt": "./src/private/error/*.js",
+      "default": "./src/private/error/*.js"
+    }
+  },
+  "exports": {
+    ".": {
+      "runtime": "./src/runtime.js",
+      "default": "./src/default.js"
+    },
+    "./*": "./src/*.js"
+  }
+}

package/src/default.js

@@ -0,0 +1,8 @@
+import build from "#build";
+import default_extension from "#extension";
+import pkgname from "#pkgname";
+
+export default ({ extension = default_extension } = {}) => ({
+  name: pkgname,
+  build: build({ extension }),
+});

package/src/env.js

@@ -0,0 +1 @@
+export { default } from "./vendored/wasm_exec.js";

package/src/private/build.js

@@ -0,0 +1,172 @@
+import faulty_route from "#error/faulty-route";
+import pkgname from "#pkgname";
+import log from "@primate/core/log";
+import dim from "@rcompat/cli/color/dim";
+import { user } from "@rcompat/env";
+import file from "@rcompat/fs/file";
+import platform from "@rcompat/platform";
+import execute from "@rcompat/stdio/execute";
+
+const command = "go";
+const run = (wasm, go, includes = "request.go") =>
+  `${command} build -o ${wasm} ${go} ${includes}`;
+const routes_re = /func (?<route>Get|Post|Put|Delete)/gu;
+const add_setter = route => `
+  var cb${route} js.Func;
+  cb${route} = js.FuncOf(func(this js.Value, args[]js.Value) any {
+    cb${route}.Release();
+    return make_request(${route}, args[0]);
+  });
+  js.Global().Set("${route}", cb${route});
+`;
+
+const make_route = route =>
+  `  ${route.toLowerCase()}(request) {
+    const go = new globalThis.Go();
+    return WebAssembly.instantiate(route, {...go.importObject}).then(result => {
+      go.run(result.instance);
+      return to_response(globalThis.${route}(to_request(request)));
+    });
+  }`;
+
+const js_wrapper = (path, routes) => `
+import env from "@primate/go/env";
+import to_request from "@primate/go/to-request";
+import to_response from "@primate/go/to-response";
+${
+  platform === "bun" ? `
+    import route_path from "${path}" with { type: "file" };
+    const route = await Bun.file(route_path).arrayBuffer();
+  ` : `
+    import file from "@rcompat/fs/file";
+    const route = new Uint8Array(await file(import.meta.dirname+"/${path}")
+      .arrayBuffer());
+  `
+}
+env();
+
+export default {
+${routes.map(route => make_route(route)).join(",\n")}
+};`;
+
+const go_wrapper = (code, routes) =>
+  `// {{{ wrapper prefix
+package main
+import "syscall/js"
+// }}} end
+${code}
+// {{{ wrapper postfix
+func main() {
+  ${routes.map(route => add_setter(route)).join("\n  ")}
+  select{};
+}
+// }}} end`;
+
+const get_routes = code => [...code.matchAll(routes_re)]
+  .map(({ groups: { route } }) => route);
+
+const type_map = {
+  boolean: { transfer: "Bool", type: "bool" },
+  i8: { transfer: "Int", type: "int8" },
+  i16: { transfer: "Int", type: "int16" },
+  i32: { transfer: "Int", type: "int32" },
+  i64: { transfer: "Int", type: "int64" },
+  f32: { transfer: "Float", type: "float32" },
+  f64: { transfer: "Float", type: "float64" },
+  u8: { transfer: "Int", type: "uint8" },
+  u16: { transfer: "Int", type: "uint16" },
+  u32: { transfer: "Int", type: "uint32", nullval: "0" },
+  u64: { transfer: "Int", type: "uint64" },
+  string: { transfer: "String", type: "string" },
+  uuid: { transfer: "String", type: "string" },
+};
+const error_default = {
+  Bool: false,
+  Int: 0,
+  Float: 0,
+  String: "\"\"",
+};
+const root = file(import.meta.url).up(1);
+
+const create_meta_files = async (directory, app) => {
+  const meta = {
+    mod: "go.mod",
+    sum: "go.sum",
+    request: "request.go",
+    session: "session.go",
+  };
+  const has_session = app.modules.names.includes("@primate/session");
+
+  if (!await directory.join(meta.mod).exists()) {
+    const request_struct_items = [];
+    const request_make_items = [];
+
+    if (has_session) {
+      request_struct_items.push(
+        "Session Session",
+      );
+      request_make_items.push(
+        "make_session(request),",
+      );
+    }
+
+    const request_struct = request_struct_items.join("\n");
+    const request_make = request_make_items.join("\n");
+
+    // copy go.mod file
+    await directory.join(meta.mod).write(await root.join(meta.mod).text());
+    // copy go.sum file
+    await directory.join(meta.sum).write(await root.join(meta.sum).text());
+
+    // copy transformed request.go file
+    await directory.join(meta.request).write((await root.join(meta.request)
+      .text())
+      .replace("%%REQUEST_STRUCT%%", _ => request_struct)
+      .replace("%%REQUEST_MAKE%%", _ => request_make),
+    );
+
+    if (has_session) {
+      // copy session.go file
+      directory.join(meta.session).write(await root.join(meta.session).text());
+    }
+  }
+
+  return ["request.go"]
+    .concat(has_session ? ["session.go"] : [])
+  ;
+};
+
+const env = { GOOS: "js", GOARCH: "wasm" };
+
+export default ({ extension }) => (app, next) => {
+  app.bind(extension, async (directory, file) => {
+    const path = directory.join(file);
+    const base = path.directory;
+    const go = path.base.concat(".go");
+    const wasm = path.base.concat(".wasm");
+    const js = path.base.concat(".js");
+
+    // create meta files
+    const includes = await create_meta_files(base, app);
+
+    const code = await path.text();
+    const routes = get_routes(code);
+    // write .go file
+    await path.write(go_wrapper(code, routes));
+    // write .js wrapper
+    const wasm_route_path = `./${file.name.slice(0, -extension.length)}.wasm`;
+    await base.join(js).write(js_wrapper(wasm_route_path, routes));
+
+    try {
+      log.info(`compiling ${dim(file)} to WebAssembly`, { module: pkgname });
+      const cwd = `${base}`;
+      // compile .go to .wasm
+      await execute(run(wasm, go, includes.join(" ")),
+        { cwd, env: { HOME: user.HOME, ...env } });
+    } catch (error) {
+      faulty_route(file, error);
+    }
+  });
+
+  return next(app);
+};

package/src/private/error/faulty-route.js

@@ -0,0 +1,10 @@
+import pkgname from "#pkgname";
+import log from "@primate/core/log";
+import file from "@rcompat/fs/file";
+
+export default (...params) => log.error({
+  params,
+  name: file(import.meta.url).base,
+  module: pkgname,
+  message: "the Go route {0} contains the following error\n {1}",
+});

package/src/private/extension.js

@@ -0,0 +1 @@
+export default ".go";

package/src/private/go.mod

@@ -0,0 +1,5 @@
+module primate-binding
+
+go 1.21
+
+require github.com/primatejs/go/primate v0.0.0-20240512124018-39bdcae05e1c // indirect

package/src/private/go.sum

@@ -0,0 +1,2 @@
+github.com/primatejs/go/primate v0.0.0-20240512124018-39bdcae05e1c h1:JK/EVNq60uV83eFATziKvZW42+fuJnQ0RHIPwcWXTwI=
+github.com/primatejs/go/primate v0.0.0-20240512124018-39bdcae05e1c/go.mod h1:56jgK3iIMJtYGYqlQVvHi5lfSfPQ3Yrex0/6Jtpq4X8=

package/src/private/pkgname.js

@@ -0,0 +1 @@
+export default "@primate/go";

package/src/private/request.go

@@ -0,0 +1,117 @@
+package main
+
+import "syscall/js"
+import "encoding/json"
+
+type t_request func(Request) any
+type t_response func(js.Value, []js.Value) any
+type Object map[string]any
+type Array []any
+
+type Dispatcher struct {
+  Get func(string) any
+  Json func() map[string]any
+}
+
+type URL struct {
+  Href string
+  Origin string
+  Protocol string
+  Username string
+  Password string
+  Host string
+  Hostname string
+  Port string
+  Pathname string
+  Search string
+  SearchParams map[string]any
+  Hash string
+}
+
+type Request struct {
+  Url URL
+  Body map[string]any
+  Path Dispatcher
+  Query Dispatcher
+  Cookies Dispatcher
+  Headers Dispatcher
+  %%REQUEST_STRUCT%%
+}
+
+func make_url(request js.Value) URL {
+  url := request.Get("url");
+  search_params := make(map[string]any);
+  json.Unmarshal([]byte(request.Get("search_params").String()), &search_params);
+
+  return URL{
+    url.Get("href").String(),
+    url.Get("origin").String(),
+    url.Get("protocol").String(),
+    url.Get("username").String(),
+    url.Get("password").String(),
+    url.Get("host").String(),
+    url.Get("hostname").String(),
+    url.Get("port").String(),
+    url.Get("pathname").String(),
+    url.Get("search").String(),
+    search_params,
+    url.Get("hash").String(),
+  };
+}
+
+func make_dispatcher(key string, request js.Value) Dispatcher {
+  properties := make(map[string]any);
+  value := request.Get(key)
+  json.Unmarshal([]byte(value.Get("stringified").String()), &properties);
+
+  return Dispatcher{
+    // Get
+    func(property string) any {
+      switch properties[property].(type) {
+        case string:
+          return properties[property].(string);
+        default:
+          return nil;
+        }
+    },
+    // Json
+    func() map[string]any {
+      return properties;
+    },
+  };
+}
+
+func make_request(route t_request, request js.Value) any {
+  body := make(map[string]any);
+  json.Unmarshal([]byte(request.Get("body").String()), &body);
+
+  go_request := Request{
+    make_url(request),
+    body,
+    make_dispatcher("path", request),
+    make_dispatcher("query", request),
+    make_dispatcher("cookies", request),
+    make_dispatcher("headers", request),
+    %%REQUEST_MAKE%%
+  };
+
+  response := route(go_request);
+  switch response.(type) {
+    case js.Func:
+      return response;
+    default:
+      marshalled, _ := json.Marshal(response);
+      return string(marshalled);
+    }
+}
+
+func make_empty(route func() any) any {
+  response := route();
+  switch response.(type) {
+    case js.Func:
+      return response;
+    default:
+      marshalled, _ := json.Marshal(response);
+      return string(marshalled);
+    }
+}

package/src/private/session.go

@@ -0,0 +1,70 @@
+package main
+
+import "syscall/js"
+import "encoding/json"
+import "errors"
+
+type Session struct {
+  Exists func() bool
+  Get func(string) any
+  Json func() map[string]any
+  Set func(string, any) error
+  Create func(map[string]any)
+  Destroy func()
+}
+
+func make_session(request js.Value) Session {
+  session := request.Get("session");
+  properties := make(map[string]any);
+  json.Unmarshal([]byte(session.Get("stringified").String()), &properties);
+
+  return Session{
+    // Exists
+    func() bool {
+      return session.Get("exists").Invoke().Bool();
+    },
+    // Get
+    func(key string) any {
+      invoked := session.Get("get").Invoke(key);
+      jstype := invoked.Type()
+      switch jstype {
+        case 0: 
+        case 1:
+          return nil;
+        case 2:
+          return invoked.Bool();
+        case 3: 
+          return invoked.Float();
+        case 4:
+          return invoked.String();
+        // currently unsupported
+        case 5:
+        case 6:
+        case 7:
+          return nil;
+      }
+
+      return nil;
+    },
+    // Json
+    func() map[string]any {
+      return properties;
+    },
+    // Set
+    func(key string, value any) error {
+      r := session.Get("set").Invoke(key, value);
+      if (r.Type() == 7) {
+        return errors.New(r.Invoke().String());
+      }
+      return nil
+    },
+    // Create
+    func(data map[string]any) {
+      session.Get("create").Invoke(data);
+    },
+    // Destroy
+    func() {
+      session.Get("destroy").Invoke();
+    },
+  };
+}

package/src/runtime.js

@@ -0,0 +1,3 @@
+import pkgname from "#pkgname";
+
+export default () => ({ name: pkgname });

package/src/to-request.js

@@ -0,0 +1,54 @@
+import exclude from "@rcompat/object/exclude";
+import stringify from "@rcompat/object/stringify";
+import valmap from "@rcompat/object/valmap";
+
+const to_search_params = url =>
+  stringify(Object.fromEntries(url.searchParams.entries()));
+const dispatchers = ["path", "query", "cookies", "headers"];
+
+const to_dispatcher = dispatcher =>
+  valmap(exclude(dispatcher, ["get", "raw"]), getter => {
+    try {
+      return getter();
+    } catch ({ message }) {
+      return () => message;
+    }
+  });
+
+const make_session = session => {
+  if (session === undefined) {
+    return {};
+  }
+
+  return {
+    session: {
+      ...session,
+      set: (key, value) => {
+        try {
+          return session.set(key, value);
+        } catch ({ message }) {
+          return () => message;
+        }
+      },
+      get: session.get,
+      stringified: session.toString(),
+    },
+  };
+};
+
+export default request => {
+  dispatchers.map(property => to_dispatcher(request[property]));
+
+  return {
+    url: request.url,
+    search_params: to_search_params(request.url),
+    body: JSON.stringify(request.body),
+    ...Object.fromEntries(dispatchers.map(property => [
+      property, {
+        stringified: request[property].toString(),
+        ...to_dispatcher(request[property]),
+      },
+    ])),
+    ...make_session(request.session),
+  };
+};

package/src/to-response.js

@@ -0,0 +1,23 @@
+import error from "@primate/core/handler/error";
+import redirect from "@primate/core/handler/redirect";
+import view from "@primate/core/handler/view";
+
+const handlers = {
+  view({ component, props = "{}", options = "{}" }) {
+    return view(component, JSON.parse(props), JSON.parse(options));
+  },
+  redirect({ location, options = "{}" }) {
+    return redirect(location, JSON.parse(options));
+  },
+};
+
+const handle_function = response => {
+  const { handler, ...args } = response;
+  return handlers[handler]?.(args) ?? error();
+};
+
+const handle_other = response => JSON.parse(response);
+
+export default response => typeof response === "function"
+  ? handle_function(response())
+  : handle_other(response);

package/src/vendored/wasm_exec.js

@@ -0,0 +1,559 @@
+// Copyright 2018 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+export default () => {
+	const enosys = () => {
+		const err = new Error("not implemented");
+		err.code = "ENOSYS";
+		return err;
+	};
+
+	if (!globalThis.fs) {
+		let outputBuf = "";
+		globalThis.fs = {
+			constants: { O_WRONLY: -1, O_RDWR: -1, O_CREAT: -1, O_TRUNC: -1, O_APPEND: -1, O_EXCL: -1 }, // unused
+			writeSync(fd, buf) {
+				outputBuf += decoder.decode(buf);
+				const nl = outputBuf.lastIndexOf("\n");
+				if (nl != -1) {
+					console.log(outputBuf.substring(0, nl));
+					outputBuf = outputBuf.substring(nl + 1);
+				}
+				return buf.length;
+			},
+			write(fd, buf, offset, length, position, callback) {
+				if (offset !== 0 || length !== buf.length || position !== null) {
+					callback(enosys());
+					return;
+				}
+				const n = this.writeSync(fd, buf);
+				callback(null, n);
+			},
+			chmod(path, mode, callback) { callback(enosys()); },
+			chown(path, uid, gid, callback) { callback(enosys()); },
+			close(fd, callback) { callback(enosys()); },
+			fchmod(fd, mode, callback) { callback(enosys()); },
+			fchown(fd, uid, gid, callback) { callback(enosys()); },
+			fstat(fd, callback) { callback(enosys()); },
+			fsync(fd, callback) { callback(null); },
+			ftruncate(fd, length, callback) { callback(enosys()); },
+			lchown(path, uid, gid, callback) { callback(enosys()); },
+			link(path, link, callback) { callback(enosys()); },
+			lstat(path, callback) { callback(enosys()); },
+			mkdir(path, perm, callback) { callback(enosys()); },
+			open(path, flags, mode, callback) { callback(enosys()); },
+			read(fd, buffer, offset, length, position, callback) { callback(enosys()); },
+			readdir(path, callback) { callback(enosys()); },
+			readlink(path, callback) { callback(enosys()); },
+			rename(from, to, callback) { callback(enosys()); },
+			rmdir(path, callback) { callback(enosys()); },
+			stat(path, callback) { callback(enosys()); },
+			symlink(path, link, callback) { callback(enosys()); },
+			truncate(path, length, callback) { callback(enosys()); },
+			unlink(path, callback) { callback(enosys()); },
+			utimes(path, atime, mtime, callback) { callback(enosys()); },
+		};
+	}
+
+	if (!globalThis.process) {
+		globalThis.process = {
+			getuid() { return -1; },
+			getgid() { return -1; },
+			geteuid() { return -1; },
+			getegid() { return -1; },
+			getgroups() { throw enosys(); },
+			pid: -1,
+			ppid: -1,
+			umask() { throw enosys(); },
+			cwd() { throw enosys(); },
+			chdir() { throw enosys(); },
+		}
+	}
+
+	if (!globalThis.crypto) {
+		throw new Error("globalThis.crypto is not available, polyfill required (crypto.getRandomValues only)");
+	}
+
+	if (!globalThis.performance) {
+		throw new Error("globalThis.performance is not available, polyfill required (performance.now only)");
+	}
+
+	if (!globalThis.TextEncoder) {
+		throw new Error("globalThis.TextEncoder is not available, polyfill required");
+	}
+
+	if (!globalThis.TextDecoder) {
+		throw new Error("globalThis.TextDecoder is not available, polyfill required");
+	}
+
+	const encoder = new TextEncoder("utf-8");
+	const decoder = new TextDecoder("utf-8");
+
+	globalThis.Go = class {
+		constructor() {
+			this.argv = ["js"];
+			this.env = {};
+			this.exit = (code) => {
+				if (code !== 0) {
+					console.warn("exit code:", code);
+				}
+			};
+			this._exitPromise = new Promise((resolve) => {
+				this._resolveExitPromise = resolve;
+			});
+			this._pendingEvent = null;
+			this._scheduledTimeouts = new Map();
+			this._nextCallbackTimeoutID = 1;
+
+			const setInt64 = (addr, v) => {
+				this.mem.setUint32(addr + 0, v, true);
+				this.mem.setUint32(addr + 4, Math.floor(v / 4294967296), true);
+			}
+
+			const setInt32 = (addr, v) => {
+				this.mem.setUint32(addr + 0, v, true);
+			}
+
+			const getInt64 = (addr) => {
+				const low = this.mem.getUint32(addr + 0, true);
+				const high = this.mem.getInt32(addr + 4, true);
+				return low + high * 4294967296;
+			}
+
+			const loadValue = (addr) => {
+				const f = this.mem.getFloat64(addr, true);
+				if (f === 0) {
+					return undefined;
+				}
+				if (!isNaN(f)) {
+					return f;
+				}
+
+				const id = this.mem.getUint32(addr, true);
+				return this._values[id];
+			}
+
+			const storeValue = (addr, v) => {
+				const nanHead = 0x7FF80000;
+
+				if (typeof v === "number" && v !== 0) {
+					if (isNaN(v)) {
+						this.mem.setUint32(addr + 4, nanHead, true);
+						this.mem.setUint32(addr, 0, true);
+						return;
+					}
+					this.mem.setFloat64(addr, v, true);
+					return;
+				}
+
+				if (v === undefined) {
+					this.mem.setFloat64(addr, 0, true);
+					return;
+				}
+
+				let id = this._ids.get(v);
+				if (id === undefined) {
+					id = this._idPool.pop();
+					if (id === undefined) {
+						id = this._values.length;
+					}
+					this._values[id] = v;
+					this._goRefCounts[id] = 0;
+					this._ids.set(v, id);
+				}
+				this._goRefCounts[id]++;
+				let typeFlag = 0;
+				switch (typeof v) {
+					case "object":
+						if (v !== null) {
+							typeFlag = 1;
+						}
+						break;
+					case "string":
+						typeFlag = 2;
+						break;
+					case "symbol":
+						typeFlag = 3;
+						break;
+					case "function":
+						typeFlag = 4;
+						break;
+				}
+				this.mem.setUint32(addr + 4, nanHead | typeFlag, true);
+				this.mem.setUint32(addr, id, true);
+			}
+
+			const loadSlice = (addr) => {
+				const array = getInt64(addr + 0);
+				const len = getInt64(addr + 8);
+				return new Uint8Array(this._inst.exports.mem.buffer, array, len);
+			}
+
+			const loadSliceOfValues = (addr) => {
+				const array = getInt64(addr + 0);
+				const len = getInt64(addr + 8);
+				const a = new Array(len);
+				for (let i = 0; i < len; i++) {
+					a[i] = loadValue(array + i * 8);
+				}
+				return a;
+			}
+
+			const loadString = (addr) => {
+				const saddr = getInt64(addr + 0);
+				const len = getInt64(addr + 8);
+				return decoder.decode(new DataView(this._inst.exports.mem.buffer, saddr, len));
+			}
+
+			const timeOrigin = Date.now() - performance.now();
+			this.importObject = {
+				_gotest: {
+					add: (a, b) => a + b,
+				},
+				gojs: {
+					// Go's SP does not change as long as no Go code is running. Some operations (e.g. calls, getters and setters)
+					// may synchronously trigger a Go event handler. This makes Go code get executed in the middle of the imported
+					// function. A goroutine can switch to a new stack if the current stack is too small (see morestack function).
+					// This changes the SP, thus we have to update the SP used by the imported function.
+
+					// func wasmExit(code int32)
+					"runtime.wasmExit": (sp) => {
+						sp >>>= 0;
+						const code = this.mem.getInt32(sp + 8, true);
+						this.exited = true;
+						delete this._inst;
+						delete this._values;
+						delete this._goRefCounts;
+						delete this._ids;
+						delete this._idPool;
+						this.exit(code);
+					},
+
+					// func wasmWrite(fd uintptr, p unsafe.Pointer, n int32)
+					"runtime.wasmWrite": (sp) => {
+						sp >>>= 0;
+						const fd = getInt64(sp + 8);
+						const p = getInt64(sp + 16);
+						const n = this.mem.getInt32(sp + 24, true);
+						fs.writeSync(fd, new Uint8Array(this._inst.exports.mem.buffer, p, n));
+					},
+
+					// func resetMemoryDataView()
+					"runtime.resetMemoryDataView": (sp) => {
+						sp >>>= 0;
+						this.mem = new DataView(this._inst.exports.mem.buffer);
+					},
+
+					// func nanotime1() int64
+					"runtime.nanotime1": (sp) => {
+						sp >>>= 0;
+						setInt64(sp + 8, (timeOrigin + performance.now()) * 1000000);
+					},
+
+					// func walltime() (sec int64, nsec int32)
+					"runtime.walltime": (sp) => {
+						sp >>>= 0;
+						const msec = (new Date).getTime();
+						setInt64(sp + 8, msec / 1000);
+						this.mem.setInt32(sp + 16, (msec % 1000) * 1000000, true);
+					},
+
+					// func scheduleTimeoutEvent(delay int64) int32
+					"runtime.scheduleTimeoutEvent": (sp) => {
+						sp >>>= 0;
+						const id = this._nextCallbackTimeoutID;
+						this._nextCallbackTimeoutID++;
+						this._scheduledTimeouts.set(id, setTimeout(
+							() => {
+								this._resume();
+								while (this._scheduledTimeouts.has(id)) {
+									// for some reason Go failed to register the timeout event, log and try again
+									// (temporary workaround for https://github.com/golang/go/issues/28975)
+									console.warn("scheduleTimeoutEvent: missed timeout event");
+									this._resume();
+								}
+							},
+							getInt64(sp + 8),
+						));
+						this.mem.setInt32(sp + 16, id, true);
+					},
+
+					// func clearTimeoutEvent(id int32)
+					"runtime.clearTimeoutEvent": (sp) => {
+						sp >>>= 0;
+						const id = this.mem.getInt32(sp + 8, true);
+						clearTimeout(this._scheduledTimeouts.get(id));
+						this._scheduledTimeouts.delete(id);
+					},
+
+					// func getRandomData(r []byte)
+					"runtime.getRandomData": (sp) => {
+						sp >>>= 0;
+						crypto.getRandomValues(loadSlice(sp + 8));
+					},
+
+					// func finalizeRef(v ref)
+					"syscall/js.finalizeRef": (sp) => {
+						sp >>>= 0;
+						const id = this.mem.getUint32(sp + 8, true);
+						this._goRefCounts[id]--;
+						if (this._goRefCounts[id] === 0) {
+							const v = this._values[id];
+							this._values[id] = null;
+							this._ids.delete(v);
+							this._idPool.push(id);
+						}
+					},
+
+					// func stringVal(value string) ref
+					"syscall/js.stringVal": (sp) => {
+						sp >>>= 0;
+						storeValue(sp + 24, loadString(sp + 8));
+					},
+
+					// func valueGet(v ref, p string) ref
+					"syscall/js.valueGet": (sp) => {
+						sp >>>= 0;
+						const result = Reflect.get(loadValue(sp + 8), loadString(sp + 16));
+						sp = this._inst.exports.getsp() >>> 0; // see comment above
+						storeValue(sp + 32, result);
+					},
+
+					// func valueSet(v ref, p string, x ref)
+					"syscall/js.valueSet": (sp) => {
+						sp >>>= 0;
+						Reflect.set(loadValue(sp + 8), loadString(sp + 16), loadValue(sp + 32));
+					},
+
+					// func valueDelete(v ref, p string)
+					"syscall/js.valueDelete": (sp) => {
+						sp >>>= 0;
+						Reflect.deleteProperty(loadValue(sp + 8), loadString(sp + 16));
+					},
+
+					// func valueIndex(v ref, i int) ref
+					"syscall/js.valueIndex": (sp) => {
+						sp >>>= 0;
+						storeValue(sp + 24, Reflect.get(loadValue(sp + 8), getInt64(sp + 16)));
+					},
+
+					// valueSetIndex(v ref, i int, x ref)
+					"syscall/js.valueSetIndex": (sp) => {
+						sp >>>= 0;
+						Reflect.set(loadValue(sp + 8), getInt64(sp + 16), loadValue(sp + 24));
+					},
+
+					// func valueCall(v ref, m string, args []ref) (ref, bool)
+					"syscall/js.valueCall": (sp) => {
+						sp >>>= 0;
+						try {
+							const v = loadValue(sp + 8);
+							const m = Reflect.get(v, loadString(sp + 16));
+							const args = loadSliceOfValues(sp + 32);
+							const result = Reflect.apply(m, v, args);
+							sp = this._inst.exports.getsp() >>> 0; // see comment above
+							storeValue(sp + 56, result);
+							this.mem.setUint8(sp + 64, 1);
+						} catch (err) {
+							sp = this._inst.exports.getsp() >>> 0; // see comment above
+							storeValue(sp + 56, err);
+							this.mem.setUint8(sp + 64, 0);
+						}
+					},
+
+					// func valueInvoke(v ref, args []ref) (ref, bool)
+					"syscall/js.valueInvoke": (sp) => {
+						sp >>>= 0;
+						try {
+							const v = loadValue(sp + 8);
+							const args = loadSliceOfValues(sp + 16);
+							const result = Reflect.apply(v, undefined, args);
+							sp = this._inst.exports.getsp() >>> 0; // see comment above
+							storeValue(sp + 40, result);
+							this.mem.setUint8(sp + 48, 1);
+						} catch (err) {
+							sp = this._inst.exports.getsp() >>> 0; // see comment above
+							storeValue(sp + 40, err);
+							this.mem.setUint8(sp + 48, 0);
+						}
+					},
+
+					// func valueNew(v ref, args []ref) (ref, bool)
+					"syscall/js.valueNew": (sp) => {
+						sp >>>= 0;
+						try {
+							const v = loadValue(sp + 8);
+							const args = loadSliceOfValues(sp + 16);
+							const result = Reflect.construct(v, args);
+							sp = this._inst.exports.getsp() >>> 0; // see comment above
+							storeValue(sp + 40, result);
+							this.mem.setUint8(sp + 48, 1);
+						} catch (err) {
+							sp = this._inst.exports.getsp() >>> 0; // see comment above
+							storeValue(sp + 40, err);
+							this.mem.setUint8(sp + 48, 0);
+						}
+					},
+
+					// func valueLength(v ref) int
+					"syscall/js.valueLength": (sp) => {
+						sp >>>= 0;
+						setInt64(sp + 16, parseInt(loadValue(sp + 8).length));
+					},
+
+					// valuePrepareString(v ref) (ref, int)
+					"syscall/js.valuePrepareString": (sp) => {
+						sp >>>= 0;
+						const str = encoder.encode(String(loadValue(sp + 8)));
+						storeValue(sp + 16, str);
+						setInt64(sp + 24, str.length);
+					},
+
+					// valueLoadString(v ref, b []byte)
+					"syscall/js.valueLoadString": (sp) => {
+						sp >>>= 0;
+						const str = loadValue(sp + 8);
+						loadSlice(sp + 16).set(str);
+					},
+
+					// func valueInstanceOf(v ref, t ref) bool
+					"syscall/js.valueInstanceOf": (sp) => {
+						sp >>>= 0;
+						this.mem.setUint8(sp + 24, (loadValue(sp + 8) instanceof loadValue(sp + 16)) ? 1 : 0);
+					},
+
+					// func copyBytesToGo(dst []byte, src ref) (int, bool)
+					"syscall/js.copyBytesToGo": (sp) => {
+						sp >>>= 0;
+						const dst = loadSlice(sp + 8);
+						const src = loadValue(sp + 32);
+						if (!(src instanceof Uint8Array || src instanceof Uint8ClampedArray)) {
+							this.mem.setUint8(sp + 48, 0);
+							return;
+						}
+						const toCopy = src.subarray(0, dst.length);
+						dst.set(toCopy);
+						setInt64(sp + 40, toCopy.length);
+						this.mem.setUint8(sp + 48, 1);
+					},
+
+					// func copyBytesToJS(dst ref, src []byte) (int, bool)
+					"syscall/js.copyBytesToJS": (sp) => {
+						sp >>>= 0;
+						const dst = loadValue(sp + 8);
+						const src = loadSlice(sp + 16);
+						if (!(dst instanceof Uint8Array || dst instanceof Uint8ClampedArray)) {
+							this.mem.setUint8(sp + 48, 0);
+							return;
+						}
+						const toCopy = src.subarray(0, dst.length);
+						dst.set(toCopy);
+						setInt64(sp + 40, toCopy.length);
+						this.mem.setUint8(sp + 48, 1);
+					},
+
+					"debug": (value) => {
+						console.log(value);
+					},
+				}
+			};
+		}
+
+		async run(instance) {
+			if (!(instance instanceof WebAssembly.Instance)) {
+				throw new Error("Go.run: WebAssembly.Instance expected");
+			}
+			this._inst = instance;
+			this.mem = new DataView(this._inst.exports.mem.buffer);
+			this._values = [ // JS values that Go currently has references to, indexed by reference id
+				NaN,
+				0,
+				null,
+				true,
+				false,
+				globalThis,
+				this,
+			];
+			this._goRefCounts = new Array(this._values.length).fill(Infinity); // number of references that Go has to a JS value, indexed by reference id
+			this._ids = new Map([ // mapping from JS values to reference ids
+				[0, 1],
+				[null, 2],
+				[true, 3],
+				[false, 4],
+				[globalThis, 5],
+				[this, 6],
+			]);
+			this._idPool = [];   // unused ids that have been garbage collected
+			this.exited = false; // whether the Go program has exited
+
+			// Pass command line arguments and environment variables to WebAssembly by writing them to the linear memory.
+			let offset = 4096;
+
+			const strPtr = (str) => {
+				const ptr = offset;
+				const bytes = encoder.encode(str + "\0");
+				new Uint8Array(this.mem.buffer, offset, bytes.length).set(bytes);
+				offset += bytes.length;
+				if (offset % 8 !== 0) {
+					offset += 8 - (offset % 8);
+				}
+				return ptr;
+			};
+
+			const argc = this.argv.length;
+
+			const argvPtrs = [];
+			this.argv.forEach((arg) => {
+				argvPtrs.push(strPtr(arg));
+			});
+			argvPtrs.push(0);
+
+			const keys = Object.keys(this.env).sort();
+			keys.forEach((key) => {
+				argvPtrs.push(strPtr(`${key}=${this.env[key]}`));
+			});
+			argvPtrs.push(0);
+
+			const argv = offset;
+			argvPtrs.forEach((ptr) => {
+				this.mem.setUint32(offset, ptr, true);
+				this.mem.setUint32(offset + 4, 0, true);
+				offset += 8;
+			});
+
+			// The linker guarantees global data starts from at least wasmMinDataAddr.
+			// Keep in sync with cmd/link/internal/ld/data.go:wasmMinDataAddr.
+			const wasmMinDataAddr = 4096 + 8192;
+			if (offset >= wasmMinDataAddr) {
+				throw new Error("total length of command line and environment variables exceeds limit");
+			}
+
+			this._inst.exports.run(argc, argv);
+			if (this.exited) {
+				this._resolveExitPromise();
+			}
+			await this._exitPromise;
+		}
+
+		_resume() {
+			if (this.exited) {
+				throw new Error("Go program has already exited");
+			}
+			this._inst.exports.resume();
+			if (this.exited) {
+				this._resolveExitPromise();
+			}
+		}
+
+		_makeFuncWrapper(id) {
+			const go = this;
+			return function () {
+				const event = { id: id, this: this, args: arguments };
+				go._pendingEvent = event;
+				go._resume();
+				return event.result;
+			};
+		}
+	}
+};