@mikrojs/firmware 0.4.0 → 0.5.0-pr-26.g363c07b

package/components/mikrojs/CMakeLists.txt

@@ -64,6 +64,7 @@ idf_component_register(
     "${MIK_SRC_DIR}/mik_text_encoding.cpp"
     "${MIK_SRC_DIR}/mik_cbor.cpp"
     "${MIK_SRC_DIR}/mik_result.cpp"
+    "${MIK_SRC_DIR}/mik_udp.cpp"
     "${MIK_SRC_DIR}/mikrojs.cpp"
     # nanocbor CBOR codec
     "${MIK_NANOCBOR_DIR}/src/encoder.c"
@@ -130,7 +131,7 @@ include("${MIK_BYTECODE_CMAKE}")
 
 # Force linker to include self-registering native modules
 set(_MIK_MODULES cbor pin i2c spi http wifi rtc nvs_kv sntp sleep neopixel pwm uart)
-set(_MIK_BYTECODE_MODULES cbor env result schema fs http/helpers http/request i2c kv/nvs kv/rtc kv/shared neopixel pin pwm reader sleep spi sntp stdio stream sys test uart wifi)
+set(_MIK_BYTECODE_MODULES cbor env result schema fs http/helpers http/request i2c kv/nvs kv/rtc kv/shared neopixel pin pwm reader sleep spi sntp stdio stream sys test uart udp wifi)
 if(CONFIG_BT_ENABLED)
     list(APPEND _MIK_MODULES ble)
     list(APPEND _MIK_BYTECODE_MODULES ble)

package/components/mikrojs/test/CMakeLists.txt

@@ -20,6 +20,7 @@ set(_MIK_TEST_SRCS
     text_encoding_test.cpp
     timers_js_test.cpp
     timers_test.cpp
+    udp_test.cpp
     wifi_test.cpp
 )
 if(CONFIG_BT_ENABLED)

package/components/mikrojs/test/udp_test.cpp

@@ -0,0 +1,91 @@
+#include "mikrojs.h"
+#include "private.h"
+#include "quickjs.h"
+#include "unity.h"
+
+/* native:udp lives in @mikrojs/native and is initialized eagerly via
+ * MIK_NewRuntime — no force-include needed. These tests are smoke-level:
+ * verify the module loads and a basic bind/close cycle works. Full
+ * roundtrip + multicast tests live host-side (ctest). */
+
+static MIKRuntime* rt;
+static JSContext* ctx;
+
+static void setup() {
+    rt = MIK_NewRuntime();
+    ctx = MIK_GetJSContext(rt);
+}
+
+static void teardown() { MIK_FreeRuntime(rt); }
+
+static JSValue eval_module(const char* code) {
+    JSValue ret = MIK_EvalModuleContent(ctx, "mikrojs/test", code, strlen(code));
+    if (!JS_IsException(ret)) {
+        JS_FreeValue(ctx, ret);
+        mik__execute_jobs(ctx);
+    }
+    return ret;
+}
+
+TEST_CASE("mikrojs/udp module is importable", "[modules]") {
+    setup();
+
+    JSValue ret = eval_module(R"(
+        import {bind} from "mikrojs/udp";
+        globalThis.__hasBind = typeof bind === "function";
+    )");
+    TEST_ASSERT_FALSE_MESSAGE(JS_IsException(ret), "Module eval should not throw");
+
+    JSValue g = JS_GetGlobalObject(ctx);
+    JSValue v = JS_GetPropertyStr(ctx, g, "__hasBind");
+    TEST_ASSERT_TRUE_MESSAGE(JS_ToBool(ctx, v), "bind should be a function");
+    JS_FreeValue(ctx, v);
+    JS_FreeValue(ctx, g);
+
+    teardown();
+}
+
+TEST_CASE("mikrojs/udp bind and close work on device", "[modules]") {
+    setup();
+
+    /* Drives a bind+close, holds the socket on globalThis to keep it alive
+     * past the IIFE, then verifies port assignment and idempotent close. */
+    JSValue ret = eval_module(R"(
+        import {bind} from "mikrojs/udp";
+        globalThis.__phase = "init";
+        (async () => {
+          const r = await bind({port: 0, family: 'ipv4'});
+          if (!r.ok) {
+            globalThis.__phase = "bind-fail:" + r.error.name;
+            return;
+          }
+          globalThis.__sock = r.value;
+          globalThis.__port = r.value.port;
+          r.value.close();
+          r.value.close();
+          globalThis.__phase = "done";
+        })();
+    )");
+    TEST_ASSERT_FALSE_MESSAGE(JS_IsException(ret), "Module eval should not throw");
+
+    /* Spin the loop a few times so the IIFE settles. */
+    for (int i = 0; i < 10; i++) {
+        MIK_Loop(rt);
+    }
+
+    JSValue g = JS_GetGlobalObject(ctx);
+    JSValue phase = JS_GetPropertyStr(ctx, g, "__phase");
+    const char* phase_str = JS_ToCString(ctx, phase);
+    TEST_ASSERT_EQUAL_STRING("done", phase_str);
+    JS_FreeCString(ctx, phase_str);
+    JS_FreeValue(ctx, phase);
+
+    JSValue port_v = JS_GetPropertyStr(ctx, g, "__port");
+    int32_t port = -1;
+    JS_ToInt32(ctx, &port, port_v);
+    TEST_ASSERT_GREATER_THAN(0, port);
+    JS_FreeValue(ctx, port_v);
+
+    JS_FreeValue(ctx, g);
+    teardown();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikrojs/firmware",
-  "version": "0.4.0",
+  "version": "0.5.0-pr-26.g363c07b",
   "description": "Mikro.js ESP32 firmware: ESP-IDF component, build tools, and project template",
   "keywords": [
     "esp-idf",
@@ -51,8 +51,8 @@
   },
   "dependencies": {
     "esbuild": "^0.28.0",
-    "@mikrojs/native": "0.4.0",
-    "@mikrojs/quickjs": "0.4.0"
+    "@mikrojs/quickjs": "0.5.0-pr-26.g363c07b",
+    "@mikrojs/native": "0.5.0-pr-26.g363c07b"
   },
   "engines": {
     "node": ">=24.0.0"

package/sdkconfig.defaults

@@ -97,7 +97,11 @@ CONFIG_ESP_ERR_TO_NAME_LOOKUP=n
 CONFIG_HAL_DEFAULT_ASSERTION_LEVEL=0
 
 # --- lwIP ---
-CONFIG_LWIP_IPV6=n
+# IPv6 enabled so mikrojs/udp dual-stack sockets work and to keep the
+# door open for Thread (which is IPv6-only). Required for AF_INET6 /
+# sockaddr_in6 to be defined in lwIP headers — without it, the UDP
+# native module won't even compile. Cost is roughly 5–10 KB flash.
+CONFIG_LWIP_IPV6=y
 
 # --- MbedTLS: TLS 1.2 + 1.3, AES-GCM/CCM, ECDHE ---
 CONFIG_MBEDTLS_SSL_PROTO_TLS1_3=y