@meshcore-cz/meshpkt 0.1.0

package/README.md

@@ -0,0 +1,25 @@
+# @meshcore-cz/meshpkt
+
+MeshCore radio packet codec for JavaScript and TypeScript, powered by WebAssembly.
+
+## Install
+
+```sh
+npm install @meshcore-cz/meshpkt
+````
+
+## Usage
+
+```ts
+import { load } from "@meshcore-cz/meshpkt";
+
+const meshpkt = await load();
+
+const envelope = meshpkt.decodeEnvelope(
+  "your-hex-encoded-meshcore-packet"
+);
+
+console.log(envelope);
+```
+
+The package includes the TinyGo WebAssembly module and generated TypeScript types.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./wasm.gen.js";
+import type { MeshcoreWasm } from "./wasm.gen.js";
+export interface LoadOptions {
+    wasmURL?: string | URL;
+    wasmExecURL?: string | URL;
+}
+export declare function load(options?: LoadOptions): Promise<MeshcoreWasm>;

package/dist/index.js

@@ -0,0 +1,83 @@
+export * from "./wasm.gen.js";
+import { meshcoreOpNames } from "./wasm.gen.js";
+const globals = globalThis;
+let runtimeReady;
+let apiReady;
+function urlString(url) {
+    return typeof url === "string" ? url : url.href;
+}
+async function loadTinyGoRuntime(url) {
+    if (globals.Go)
+        return;
+    runtimeReady ??= new Promise((resolve, reject) => {
+        if (typeof document === "undefined") {
+            reject(new Error("@meshcore-cz/meshpkt currently requires a browser environment"));
+            return;
+        }
+        const script = document.createElement("script");
+        script.src = urlString(url);
+        script.async = true;
+        script.onload = () => {
+            if (!globals.Go) {
+                reject(new Error("TinyGo runtime loaded but globalThis.Go was not registered"));
+                return;
+            }
+            resolve();
+        };
+        script.onerror = () => {
+            reject(new Error(`Failed to load TinyGo runtime: ${script.src}`));
+        };
+        document.head.appendChild(script);
+    });
+    return runtimeReady;
+}
+async function instantiate(url, imports) {
+    const response = await fetch(urlString(url));
+    if (!response.ok) {
+        throw new Error(`Failed to fetch WASM module: ${response.status} ${response.statusText}`);
+    }
+    try {
+        const result = await WebAssembly.instantiateStreaming(response.clone(), imports);
+        return result.instance;
+    }
+    catch {
+        const bytes = await response.arrayBuffer();
+        const result = await WebAssembly.instantiate(bytes, imports);
+        return result.instance;
+    }
+}
+async function waitForCall() {
+    const deadline = Date.now() + 10_000;
+    while (Date.now() < deadline) {
+        if (globals.meshpktCall)
+            return globals.meshpktCall;
+        await new Promise((resolve) => setTimeout(resolve, 10));
+    }
+    throw new Error("meshpktCall was not registered by the WASM module");
+}
+function buildAPI(call) {
+    const api = {};
+    for (const name of meshcoreOpNames) {
+        api[name] = (...args) => call(name, JSON.stringify(args));
+    }
+    return api;
+}
+export function load(options = {}) {
+    if (apiReady)
+        return apiReady;
+    apiReady = (async () => {
+        const wasmURL = options.wasmURL ?? new URL("./meshpkt.wasm", import.meta.url);
+        const wasmExecURL = options.wasmExecURL ?? new URL("./wasm_exec.js", import.meta.url);
+        await loadTinyGoRuntime(wasmExecURL);
+        const Go = globals.Go;
+        if (!Go) {
+            throw new Error("TinyGo runtime is unavailable");
+        }
+        const go = new Go();
+        const instance = await instantiate(wasmURL, go.importObject);
+        void go.run(instance);
+        const call = await waitForCall();
+        return buildAPI(call);
+    })();
+    return apiReady;
+}

package/dist/wasm.gen.d.ts

@@ -0,0 +1,176 @@
+export interface ErrResult {
+    error: string;
+}
+export interface HexResult {
+    hex: string;
+}
+export interface Envelope {
+    route: string;
+    routeCode: number;
+    type: string;
+    typeCode: number;
+    version: number;
+    pathHashSize: number;
+    hopCount: number;
+    hops: string[];
+    payloadHex: string;
+    isTransport: boolean;
+    transportCodes?: [number, number];
+}
+export interface GroupTextPayload {
+    sender: string;
+    text: string;
+    timestamp: number;
+    txtType: number;
+    attempt: number;
+    channelHash: string;
+}
+export interface DirectTextPayload {
+    destHash: string;
+    srcHash: string;
+    text: string;
+    timestamp: number;
+    txtType: number;
+    attempt: number;
+}
+export interface AdvertPayload {
+    publicKey: string;
+    timestamp: number;
+    name: string;
+    nodeType: number;
+    hasGPS: boolean;
+    lat?: number;
+    lon?: number;
+}
+export interface AckPayload {
+    crc: number;
+    crcHex: string;
+}
+export interface GrpDataPayload {
+    channelHash: string;
+    dataType: number;
+    dataHex: string;
+}
+export interface ReqPayload {
+    destHash: string;
+    srcHash: string;
+    timestamp: number;
+    reqType: number;
+    dataHex: string;
+}
+export interface ResponsePayload {
+    destHash: string;
+    srcHash: string;
+    dataHex: string;
+}
+export interface PathPayload {
+    destHash: string;
+    srcHash: string;
+    path: string[];
+    extraType: number;
+    extraHex: string;
+}
+export interface AnonReqPayload {
+    destHash: string;
+    senderPubKey: string;
+    timestamp: number;
+    dataHex: string;
+}
+export interface ControlPayload {
+    subType: number;
+    flags: number;
+    dataHex: string;
+    discoverTag?: number;
+    discoverTypeFilter?: number;
+    discoverSince?: number;
+    discoverNodeType?: number;
+    discoverSNR?: number;
+    discoverPubKey?: string;
+}
+export interface KeypairResult {
+    publicKey: string;
+    privateKey: string;
+}
+export interface MeshcoreWasm {
+    encodeGroupText(channelName: string, sender: string, text: string): HexResult | ErrResult;
+    encodeGroupTextSecret(secret: string, sender: string, text: string): HexResult | ErrResult;
+    encodeGrpData(channelName: string, dataType: number, data: string): HexResult | ErrResult;
+    encodeGrpDataSecret(secret: string, dataType: number, data: string): HexResult | ErrResult;
+    encodeDirectText(privKey: string, peerPubKey: string, text: string): HexResult | ErrResult;
+    encodeAdvert(pubKey: string, signature: string, name: string, hasGPS: number, lat: unknown, lon: unknown): HexResult | ErrResult;
+    encodeAck(crc: number): HexResult | ErrResult;
+    encodeReq(privKey: string, peerPubKey: string, reqType: number, data: string): HexResult | ErrResult;
+    encodeAnonReq(destPubKey: string, myPrivKey: string, data: string): HexResult | ErrResult;
+    encodeDiscoverReq(typeFilter: number, tag: number, since: number, prefixOnly: number): HexResult | ErrResult;
+    encodeRaw(route: number, payloadType: number, version: number, pathHashSize: number, payload: string): HexResult | ErrResult;
+    decodeEnvelope(packet: string): Envelope | ErrResult;
+    decodeGroupText(payload: string, channelName: string): GroupTextPayload | ErrResult;
+    decodeGroupTextSecret(payload: string, secret: string): GroupTextPayload | ErrResult;
+    decodeDirectText(payload: string, privKey: string, peerPubKey: string): DirectTextPayload | ErrResult;
+    decodeAdvert(payload: string): AdvertPayload | ErrResult;
+    decodeAck(payload: string): AckPayload | ErrResult;
+    decodeGrpData(payload: string, channelName: string): GrpDataPayload | ErrResult;
+    decodeGrpDataSecret(payload: string, secret: string): GrpDataPayload | ErrResult;
+    decodeReq(payload: string, privKey: string, peerPubKey: string): ReqPayload | ErrResult;
+    decodeResponse(payload: string, privKey: string, peerPubKey: string): ResponsePayload | ErrResult;
+    decodePath(payload: string, privKey: string, peerPubKey: string): PathPayload | ErrResult;
+    decodeAnonReq(payload: string, myPrivKey: string): AnonReqPayload | ErrResult;
+    decodeControl(payload: string): ControlPayload | ErrResult;
+    generateKeypair(): KeypairResult | ErrResult;
+    deriveChannelSecret(channelName: string): HexResult | ErrResult;
+    sharedSecret(privKey: string, peerPubKey: string): HexResult | ErrResult;
+}
+export declare const meshcoreOpNames: readonly ["encodeGroupText", "encodeGroupTextSecret", "encodeGrpData", "encodeGrpDataSecret", "encodeDirectText", "encodeAdvert", "encodeAck", "encodeReq", "encodeAnonReq", "encodeDiscoverReq", "encodeRaw", "decodeEnvelope", "decodeGroupText", "decodeGroupTextSecret", "decodeDirectText", "decodeAdvert", "decodeAck", "decodeGrpData", "decodeGrpDataSecret", "decodeReq", "decodeResponse", "decodePath", "decodeAnonReq", "decodeControl", "generateKeypair", "deriveChannelSecret", "sharedSecret"];
+export declare const RouteTypes: readonly [{
+    readonly code: 0;
+    readonly label: "TRANSPORT_FLOOD";
+}, {
+    readonly code: 1;
+    readonly label: "FLOOD";
+}, {
+    readonly code: 2;
+    readonly label: "DIRECT";
+}, {
+    readonly code: 3;
+    readonly label: "TRANSPORT_DIRECT";
+}];
+export declare const PayloadTypes: readonly [{
+    readonly code: 0;
+    readonly label: "REQ";
+}, {
+    readonly code: 1;
+    readonly label: "RESPONSE";
+}, {
+    readonly code: 2;
+    readonly label: "TXT_MSG";
+}, {
+    readonly code: 3;
+    readonly label: "ACK";
+}, {
+    readonly code: 4;
+    readonly label: "ADVERT";
+}, {
+    readonly code: 5;
+    readonly label: "GRP_TXT";
+}, {
+    readonly code: 6;
+    readonly label: "GRP_DATA";
+}, {
+    readonly code: 7;
+    readonly label: "ANON_REQ";
+}, {
+    readonly code: 8;
+    readonly label: "PATH";
+}, {
+    readonly code: 9;
+    readonly label: "TRACE";
+}, {
+    readonly code: 10;
+    readonly label: "MULTIPART";
+}, {
+    readonly code: 11;
+    readonly label: "CONTROL";
+}, {
+    readonly code: 15;
+    readonly label: "RAW_CUSTOM";
+}];

package/dist/wasm.gen.js

@@ -0,0 +1,52 @@
+// Code generated by "go run ./cmd/gen-ts"; DO NOT EDIT.
+// Source: github.com/meshcore-cz/meshpkt
+export const meshcoreOpNames = [
+    "encodeGroupText",
+    "encodeGroupTextSecret",
+    "encodeGrpData",
+    "encodeGrpDataSecret",
+    "encodeDirectText",
+    "encodeAdvert",
+    "encodeAck",
+    "encodeReq",
+    "encodeAnonReq",
+    "encodeDiscoverReq",
+    "encodeRaw",
+    "decodeEnvelope",
+    "decodeGroupText",
+    "decodeGroupTextSecret",
+    "decodeDirectText",
+    "decodeAdvert",
+    "decodeAck",
+    "decodeGrpData",
+    "decodeGrpDataSecret",
+    "decodeReq",
+    "decodeResponse",
+    "decodePath",
+    "decodeAnonReq",
+    "decodeControl",
+    "generateKeypair",
+    "deriveChannelSecret",
+    "sharedSecret",
+];
+export const RouteTypes = [
+    { code: 0, label: "TRANSPORT_FLOOD" },
+    { code: 1, label: "FLOOD" },
+    { code: 2, label: "DIRECT" },
+    { code: 3, label: "TRANSPORT_DIRECT" },
+];
+export const PayloadTypes = [
+    { code: 0x00, label: "REQ" },
+    { code: 0x01, label: "RESPONSE" },
+    { code: 0x02, label: "TXT_MSG" },
+    { code: 0x03, label: "ACK" },
+    { code: 0x04, label: "ADVERT" },
+    { code: 0x05, label: "GRP_TXT" },
+    { code: 0x06, label: "GRP_DATA" },
+    { code: 0x07, label: "ANON_REQ" },
+    { code: 0x08, label: "PATH" },
+    { code: 0x09, label: "TRACE" },
+    { code: 0x0a, label: "MULTIPART" },
+    { code: 0x0b, label: "CONTROL" },
+    { code: 0x0f, label: "RAW_CUSTOM" },
+];

package/dist/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.
+//
+// This file has been modified for use by the TinyGo compiler.
+
+(() => {
+	// Map multiple JavaScript environments to a single common API,
+	// preferring web standards over Node.js API.
+	//
+	// Environments considered:
+	// - Browsers
+	// - Node.js
+	// - Electron
+	// - Parcel
+
+	if (typeof global !== "undefined") {
+		// global already exists
+	} else if (typeof window !== "undefined") {
+		window.global = window;
+	} else if (typeof self !== "undefined") {
+		self.global = self;
+	} else {
+		throw new Error("cannot export Go (neither global, window nor self is defined)");
+	}
+
+	if (!global.require && typeof require !== "undefined") {
+		global.require = require;
+	}
+
+	if (!global.fs && global.require) {
+		global.fs = require("node:fs");
+	}
+
+	const enosys = () => {
+		const err = new Error("not implemented");
+		err.code = "ENOSYS";
+		return err;
+	};
+
+	if (!global.fs) {
+		let outputBuf = "";
+		global.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.substr(0, nl));
+					outputBuf = outputBuf.substr(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 (!global.process) {
+		global.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 (!global.crypto) {
+		const nodeCrypto = require("node:crypto");
+		global.crypto = {
+			getRandomValues(b) {
+				nodeCrypto.randomFillSync(b);
+			},
+		};
+	}
+
+	if (!global.performance) {
+		global.performance = {
+			now() {
+				const [sec, nsec] = process.hrtime();
+				return sec * 1000 + nsec / 1000000;
+			},
+		};
+	}
+
+	if (!global.TextEncoder) {
+		global.TextEncoder = require("node:util").TextEncoder;
+	}
+
+	if (!global.TextDecoder) {
+		global.TextDecoder = require("node:util").TextDecoder;
+	}
+
+	// End of polyfills for common API.
+
+	const encoder = new TextEncoder("utf-8");
+	const decoder = new TextDecoder("utf-8");
+	let reinterpretBuf = new DataView(new ArrayBuffer(8));
+	var logLine = [];
+	const wasmExit = {}; // thrown to exit via proc_exit (not an error)
+
+	global.Go = class {
+		constructor() {
+			this._callbackTimeouts = new Map();
+			this._nextCallbackTimeoutID = 1;
+
+			const mem = () => {
+				// The buffer may change when requesting more memory.
+				return new DataView(this._inst.exports.memory.buffer);
+			}
+
+			const unboxValue = (v_ref) => {
+				reinterpretBuf.setBigInt64(0, v_ref, true);
+				const f = reinterpretBuf.getFloat64(0, true);
+				if (f === 0) {
+					return undefined;
+				}
+				if (!isNaN(f)) {
+					return f;
+				}
+
+				const id = v_ref & 0xffffffffn;
+				return this._values[id];
+			}
+
+
+			const loadValue = (addr) => {
+				let v_ref = mem().getBigUint64(addr, true);
+				return unboxValue(v_ref);
+			}
+
+			const boxValue = (v) => {
+				const nanHead = 0x7FF80000n;
+
+				if (typeof v === "number") {
+					if (isNaN(v)) {
+						return nanHead << 32n;
+					}
+					if (v === 0) {
+						return (nanHead << 32n) | 1n;
+					}
+					reinterpretBuf.setFloat64(0, v, true);
+					return reinterpretBuf.getBigInt64(0, true);
+				}
+
+				switch (v) {
+					case undefined:
+						return 0n;
+					case null:
+						return (nanHead << 32n) | 2n;
+					case true:
+						return (nanHead << 32n) | 3n;
+					case false:
+						return (nanHead << 32n) | 4n;
+				}
+
+				let id = this._ids.get(v);
+				if (id === undefined) {
+					id = this._idPool.pop();
+					if (id === undefined) {
+						id = BigInt(this._values.length);
+					}
+					this._values[id] = v;
+					this._goRefCounts[id] = 0;
+					this._ids.set(v, id);
+				}
+				this._goRefCounts[id]++;
+				let typeFlag = 1n;
+				switch (typeof v) {
+					case "string":
+						typeFlag = 2n;
+						break;
+					case "symbol":
+						typeFlag = 3n;
+						break;
+					case "function":
+						typeFlag = 4n;
+						break;
+				}
+				return id | ((nanHead | typeFlag) << 32n);
+			}
+
+			const storeValue = (addr, v) => {
+				let v_ref = boxValue(v);
+				mem().setBigUint64(addr, v_ref, true);
+			}
+
+			const loadSlice = (array, len, cap) => {
+				return new Uint8Array(this._inst.exports.memory.buffer, array, len);
+			}
+
+			const loadSliceOfValues = (array, len, cap) => {
+				const a = new Array(len);
+				for (let i = 0; i < len; i++) {
+					a[i] = loadValue(array + i * 8);
+				}
+				return a;
+			}
+
+			const loadString = (ptr, len) => {
+				return decoder.decode(new DataView(this._inst.exports.memory.buffer, ptr, len));
+			}
+
+			const timeOrigin = Date.now() - performance.now();
+			const wasi_EBADF = 8;
+			const wasi_ENOSYS = 52;
+			this.importObject = {
+				wasi_snapshot_preview1: {
+					// https://github.com/WebAssembly/WASI/blob/snapshot-01/phases/snapshot/docs.md
+					fd_write: function(fd, iovs_ptr, iovs_len, nwritten_ptr) {
+						let nwritten = 0;
+						if (fd == 1) {
+							for (let iovs_i=0; iovs_i<iovs_len;iovs_i++) {
+								let iov_ptr = iovs_ptr+iovs_i*8; // assuming wasm32
+								let ptr = mem().getUint32(iov_ptr + 0, true);
+								let len = mem().getUint32(iov_ptr + 4, true);
+								nwritten += len;
+								for (let i=0; i<len; i++) {
+									let c = mem().getUint8(ptr+i);
+									if (c == 13) { // CR
+										// ignore
+									} else if (c == 10) { // LF
+										// write line
+										let line = decoder.decode(new Uint8Array(logLine));
+										logLine = [];
+										console.log(line);
+									} else {
+										logLine.push(c);
+									}
+								}
+							}
+						} else {
+							console.error('invalid file descriptor:', fd);
+						}
+						mem().setUint32(nwritten_ptr, nwritten, true);
+						return 0;
+					},
+					fd_read: () => wasi_ENOSYS,
+					fd_close: () => wasi_ENOSYS,
+					fd_fdstat_get: () => wasi_ENOSYS,
+					fd_prestat_get: () => wasi_EBADF, // wasi-libc relies on this errno value
+					fd_prestat_dir_name: () => wasi_ENOSYS,
+					fd_seek: () => wasi_ENOSYS,
+					path_open: () => wasi_ENOSYS,
+					proc_exit: (code) => {
+						this.exited = true;
+						this.exitCode = code;
+						this._resolveExitPromise();
+						throw wasmExit;
+					},
+					random_get: (bufPtr, bufLen) => {
+						crypto.getRandomValues(loadSlice(bufPtr, bufLen));
+						return 0;
+					},
+				},
+				gojs: {
+					// func ticks() int64
+					"runtime.ticks": () => {
+						return BigInt((timeOrigin + performance.now()) * 1e6);
+					},
+
+					// func sleepTicks(timeout int64)
+					"runtime.sleepTicks": (timeout) => {
+						// Do not sleep, only reactivate scheduler after the given timeout.
+						setTimeout(() => {
+							if (this.exited) return;
+							try {
+								this._inst.exports.go_scheduler();
+							} catch (e) {
+								if (e !== wasmExit) throw e;
+							}
+						}, Number(timeout)/1e6);
+					},
+
+					// func finalizeRef(v ref)
+					"syscall/js.finalizeRef": (v_ref) => {
+						// Note: TinyGo does not support finalizers so this is only called
+						// for one specific case, by js.go:jsString. and can/might leak memory.
+						const id = v_ref & 0xffffffffn;
+						if (this._goRefCounts?.[id] !== undefined) {
+							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);
+							}
+						} else {
+							console.error("syscall/js.finalizeRef: unknown id", id);
+						}
+					},
+
+					// func stringVal(value string) ref
+					"syscall/js.stringVal": (value_ptr, value_len) => {
+						value_ptr >>>= 0;
+						const s = loadString(value_ptr, value_len);
+						return boxValue(s);
+					},
+
+					// func valueGet(v ref, p string) ref
+					"syscall/js.valueGet": (v_ref, p_ptr, p_len) => {
+						let prop = loadString(p_ptr, p_len);
+						let v = unboxValue(v_ref);
+						let result = Reflect.get(v, prop);
+						return boxValue(result);
+					},
+
+					// func valueSet(v ref, p string, x ref)
+					"syscall/js.valueSet": (v_ref, p_ptr, p_len, x_ref) => {
+						const v = unboxValue(v_ref);
+						const p = loadString(p_ptr, p_len);
+						const x = unboxValue(x_ref);
+						Reflect.set(v, p, x);
+					},
+
+					// func valueDelete(v ref, p string)
+					"syscall/js.valueDelete": (v_ref, p_ptr, p_len) => {
+						const v = unboxValue(v_ref);
+						const p = loadString(p_ptr, p_len);
+						Reflect.deleteProperty(v, p);
+					},
+
+					// func valueIndex(v ref, i int) ref
+					"syscall/js.valueIndex": (v_ref, i) => {
+						return boxValue(Reflect.get(unboxValue(v_ref), i));
+					},
+
+					// valueSetIndex(v ref, i int, x ref)
+					"syscall/js.valueSetIndex": (v_ref, i, x_ref) => {
+						Reflect.set(unboxValue(v_ref), i, unboxValue(x_ref));
+					},
+
+					// func valueCall(v ref, m string, args []ref) (ref, bool)
+					"syscall/js.valueCall": (ret_addr, v_ref, m_ptr, m_len, args_ptr, args_len, args_cap) => {
+						const v = unboxValue(v_ref);
+						const name = loadString(m_ptr, m_len);
+						const args = loadSliceOfValues(args_ptr, args_len, args_cap);
+						try {
+							const m = Reflect.get(v, name);
+							storeValue(ret_addr, Reflect.apply(m, v, args));
+							mem().setUint8(ret_addr + 8, 1);
+						} catch (err) {
+							storeValue(ret_addr, err);
+							mem().setUint8(ret_addr + 8, 0);
+						}
+					},
+
+					// func valueInvoke(v ref, args []ref) (ref, bool)
+					"syscall/js.valueInvoke": (ret_addr, v_ref, args_ptr, args_len, args_cap) => {
+						try {
+							const v = unboxValue(v_ref);
+							const args = loadSliceOfValues(args_ptr, args_len, args_cap);
+							storeValue(ret_addr, Reflect.apply(v, undefined, args));
+							mem().setUint8(ret_addr + 8, 1);
+						} catch (err) {
+							storeValue(ret_addr, err);
+							mem().setUint8(ret_addr + 8, 0);
+						}
+					},
+
+					// func valueNew(v ref, args []ref) (ref, bool)
+					"syscall/js.valueNew": (ret_addr, v_ref, args_ptr, args_len, args_cap) => {
+						const v = unboxValue(v_ref);
+						const args = loadSliceOfValues(args_ptr, args_len, args_cap);
+						try {
+							storeValue(ret_addr, Reflect.construct(v, args));
+							mem().setUint8(ret_addr + 8, 1);
+						} catch (err) {
+							storeValue(ret_addr, err);
+							mem().setUint8(ret_addr+ 8, 0);
+						}
+					},
+
+					// func valueLength(v ref) int
+					"syscall/js.valueLength": (v_ref) => {
+						return unboxValue(v_ref).length;
+					},
+
+					// valuePrepareString(v ref) (ref, int)
+					"syscall/js.valuePrepareString": (ret_addr, v_ref) => {
+						const s = String(unboxValue(v_ref));
+						const str = encoder.encode(s);
+						storeValue(ret_addr, str);
+						mem().setInt32(ret_addr + 8, str.length, true);
+					},
+
+					// valueLoadString(v ref, b []byte)
+					"syscall/js.valueLoadString": (v_ref, slice_ptr, slice_len, slice_cap) => {
+						const str = unboxValue(v_ref);
+						loadSlice(slice_ptr, slice_len, slice_cap).set(str);
+					},
+
+					// func valueInstanceOf(v ref, t ref) bool
+					"syscall/js.valueInstanceOf": (v_ref, t_ref) => {
+ 						return unboxValue(v_ref) instanceof unboxValue(t_ref);
+					},
+
+					// func copyBytesToGo(dst []byte, src ref) (int, bool)
+					"syscall/js.copyBytesToGo": (ret_addr, dest_addr, dest_len, dest_cap, src_ref) => {
+						let num_bytes_copied_addr = ret_addr;
+						let returned_status_addr = ret_addr + 4; // Address of returned boolean status variable
+
+						const dst = loadSlice(dest_addr, dest_len);
+						const src = unboxValue(src_ref);
+						if (!(src instanceof Uint8Array || src instanceof Uint8ClampedArray)) {
+							mem().setUint8(returned_status_addr, 0); // Return "not ok" status
+							return;
+						}
+						const toCopy = src.subarray(0, dst.length);
+						dst.set(toCopy);
+						mem().setUint32(num_bytes_copied_addr, toCopy.length, true);
+						mem().setUint8(returned_status_addr, 1); // Return "ok" status
+					},
+
+					// copyBytesToJS(dst ref, src []byte) (int, bool)
+					// Originally copied from upstream Go project, then modified:
+					//   https://github.com/golang/go/blob/3f995c3f3b43033013013e6c7ccc93a9b1411ca9/misc/wasm/wasm_exec.js#L404-L416
+					"syscall/js.copyBytesToJS": (ret_addr, dst_ref, src_addr, src_len, src_cap) => {
+						let num_bytes_copied_addr = ret_addr;
+						let returned_status_addr = ret_addr + 4; // Address of returned boolean status variable
+
+						const dst = unboxValue(dst_ref);
+						const src = loadSlice(src_addr, src_len);
+						if (!(dst instanceof Uint8Array || dst instanceof Uint8ClampedArray)) {
+							mem().setUint8(returned_status_addr, 0); // Return "not ok" status
+							return;
+						}
+						const toCopy = src.subarray(0, dst.length);
+						dst.set(toCopy);
+						mem().setUint32(num_bytes_copied_addr, toCopy.length, true);
+						mem().setUint8(returned_status_addr, 1); // Return "ok" status
+					},
+				}
+			};
+
+			// Go 1.20 uses 'env'. Go 1.21 uses 'gojs'.
+			// For compatibility, we use both as long as Go 1.20 is supported.
+			this.importObject.env = this.importObject.gojs;
+		}
+
+		async run(instance) {
+			this._inst = instance;
+			this._values = [ // JS values that Go currently has references to, indexed by reference id
+				NaN,
+				0,
+				null,
+				true,
+				false,
+				global,
+				this,
+			];
+			this._goRefCounts = []; // 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
+			this._idPool = [];      // unused ids that have been garbage collected
+			this.exited = false;    // whether the Go program has exited
+			this.exitCode = 0;
+
+			if (this._inst.exports._start) {
+				let exitPromise = new Promise((resolve, reject) => {
+					this._resolveExitPromise = resolve;
+				});
+
+				// Run program, but catch the wasmExit exception that's thrown
+				// to return back here.
+				try {
+					this._inst.exports._start();
+				} catch (e) {
+					if (e !== wasmExit) throw e;
+				}
+
+				await exitPromise;
+				return this.exitCode;
+			} else {
+				this._inst.exports._initialize();
+			}
+		}
+
+		_resume() {
+			if (this.exited) {
+				throw new Error("Go program has already exited");
+			}
+			try {
+				this._inst.exports.resume();
+			} catch (e) {
+				if (e !== wasmExit) throw e;
+			}
+			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;
+			};
+		}
+	}
+
+	if (
+		global.require &&
+		global.require.main === module &&
+		global.process &&
+		global.process.versions &&
+		!global.process.versions.electron
+	) {
+		if (process.argv.length != 3) {
+			console.error("usage: go_js_wasm_exec [wasm binary] [arguments]");
+			process.exit(1);
+		}
+
+		const go = new Go();
+		WebAssembly.instantiate(fs.readFileSync(process.argv[2]), go.importObject).then(async (result) => {
+			let exitCode = await go.run(result.instance);
+			process.exit(exitCode);
+		}).catch((err) => {
+			console.error(err);
+			process.exit(1);
+		});
+	}
+})();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@meshcore-cz/meshpkt",
+  "version": "0.1.0",
+  "description": "MeshCore radio packet codec for JavaScript and TypeScript, powered by WebAssembly",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/meshcore-cz/meshpkt.git",
+    "directory": "js"
+  },
+  "homepage": "https://github.com/meshcore-cz/meshpkt",
+  "bugs": {
+    "url": "https://github.com/meshcore-cz/meshpkt/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./meshpkt.wasm": "./dist/meshpkt.wasm",
+    "./wasm_exec.js": "./dist/wasm_exec.js"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build:ts": "tsc -p tsconfig.json",
+    "pack:check": "npm pack --dry-run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  }
+}