@mikrojs/native 0.20.1 → 0.21.0-next.20260913195055

package/CMakeLists.txt

@@ -62,6 +62,7 @@ set(MIKROJS_CORE_SOURCES
     src/mik_ota_client.cpp
     src/mik_sys_codec.cpp
     src/mik_watchdog.cpp
+    src/gpio_claim.cpp
 )
 
 add_library(mikrojs STATIC
@@ -92,7 +93,7 @@ endif()
 include(cmake/mikrojs_bytecode.cmake)
 mikrojs_generate_bytecode(
     RUNTIME_DIR "${CMAKE_CURRENT_SOURCE_DIR}/runtime"
-    MODULES abort cbor env result schema fs i2c kv/nvs kv/rtc kv/shared module neopixel observable observable/lazy observable/operators ota ota/client ota/config pin pwm reader sleep spi sntp stdio stream sys test uart udp watchdog
+    MODULES abort cbor env result schema fs kv/nvs kv/rtc kv/shared module observable observable/lazy ota ota/client ota/config reader sleep sntp stdio stream sys test udp watchdog
     MODULE_PREFIX "mikro"
     SYMBOL_PREFIX "mikro"
     TARGET gen_bytecode
@@ -224,6 +225,7 @@ if(BUILD_TESTING)
         test/schema_conformance_test.cpp
         test/sys_codec_test.cpp
         test/watchdog_test.cpp
+        test/gpio_claim_test.cpp
     )
 
     # ── Check-in wire fixtures ───────────────────────────────────────

package/cmake/mikrojs_bytecode.cmake

@@ -7,7 +7,7 @@
 #   mikrojs_generate_bytecode(
 #       RUNTIME_DIR <path>         # Directory containing <mod>/<mod>.ts files
 #       MODULES <mod1> <mod2>      # Module names to compile
-#       MODULE_PREFIX <prefix>     # Module name prefix (e.g. "mikro" -> "mikro/pin")
+#       MODULE_PREFIX <prefix>     # Module name prefix (e.g. "mikro" -> "mikro/gpio")
 #       SYMBOL_PREFIX <prefix>     # C symbol prefix (e.g. "mikrojs" -> "mikrojs_pin_bytecode")
 #       TARGET <name>              # Custom target name (default: gen_bytecode)
 #       WORKING_DIRECTORY <dir>    # Working dir for esbuild (default: CMAKE_CURRENT_SOURCE_DIR)

package/dist/index.d.ts

@@ -32,7 +32,7 @@ export declare class MikroRuntime {
      * Useful for stripping TypeScript types from .ts files. */
     setPreprocessor(fn: (filename: string, source: string) => string | undefined): void;
     /** Set a synchronous RPC handler called from QuickJS via native:mikro/host.call().
-     * The handler receives a method name (e.g. 'pin.pinMode') and JSON-encoded args,
+     * The handler receives a method name (e.g. 'http.fetch') and JSON-encoded args,
      * and must return a JSON-encoded result string (or a Promise of one for async). */
     setRpcHandler(handler: (method: string, argsJson: string) => string | Promise<string>): void;
     /** Enable per-module memory profiling. Must be called before any module loads

package/dist/index.js

@@ -79,7 +79,7 @@ export class MikroRuntime {
         this.native.setPreprocessor(fn);
     }
     /** Set a synchronous RPC handler called from QuickJS via native:mikro/host.call().
-     * The handler receives a method name (e.g. 'pin.pinMode') and JSON-encoded args,
+     * The handler receives a method name (e.g. 'http.fetch') and JSON-encoded args,
      * and must return a JSON-encoded result string (or a Promise of one for async). */
     setRpcHandler(handler) {
         this.native.setRpcHandler(handler);

package/dist/runtime/result/native-result.node-shim.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-result.node-shim.js","sourceRoot":"","sources":["../../../runtime/result/native-result.node-shim.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uEAAuE;AAEvE,MAAM,KAAK,GAAG;IACZ,GAAG,CAAwD,EAA2B;QACpF,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5C,CAAC;IACD,MAAM,CAAwD,EAA2B;QACvF,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,CAAwD,EAA2B;QACxF,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACxC,CAAC;IACD,KAAK,CAEH,QAAqE;QAErE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrE,CAAC;IACD,SAAS,CAAwD,YAAqB;QACpF,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAA;IAC5C,CAAC;IACD,OAAO,CAAwD,OAAe;QAC5E,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,KAAK,CAAA;QAC9B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;QAChC,KAAK,CAAC,IAAI,GAAG,YAAY,CACxB;QAAC,KAAmC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxD,MAAM,KAAK,CAAA;IACb,CAAC;CACF,CAAA;AAED,MAAM,UAAU,EAAE,CAAC,KAAe;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC,CAAC,EAAE,GAAG,IAAI,CAAA;IACX,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,CAAC,CAAC,KAAK,GAAG,KAAK,CAAA;IACzC,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAc;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC,CAAC,EAAE,GAAG,KAAK,CAAA;IACZ,CAAC,CAAC,KAAK,GAAG,KAAK,CAAA;IACf,OAAO,CAAC,CAAA;AACV,CAAC"}
+{"version":3,"file":"native-result.node-shim.js","sourceRoot":"","sources":["../../../runtime/result/native-result.node-shim.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uEAAuE;AAEvE,MAAM,KAAK,GAAG;IACZ,GAAG,CAAwD,EAA2B;QACpF,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5C,CAAC;IACD,MAAM,CAAwD,EAA2B;QACvF,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,CAAwD,EAA2B;QACxF,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACxC,CAAC;IACD,KAAK,CAEH,QAAqE;QAErE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrE,CAAC;IACD,SAAS,CAAwD,YAAqB;QACpF,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAA;IAC5C,CAAC;IACD,OAAO,CAAwD,OAAgB;QAC7E,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,KAAK,CAAA;QAC9B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;QAChC,KAAK,CAAC,IAAI,GAAG,YAAY,CACxB;QAAC,KAAmC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxD,MAAM,KAAK,CAAA;IACb,CAAC;CACF,CAAA;AAED,MAAM,UAAU,EAAE,CAAC,KAAe;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC,CAAC,EAAE,GAAG,IAAI,CAAA;IACX,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,CAAC,CAAC,KAAK,GAAG,KAAK,CAAA;IACzC,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAc;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC,CAAC,EAAE,GAAG,KAAK,CAAA;IACZ,CAAC,CAAC,KAAK,GAAG,KAAK,CAAA;IACf,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/runtime/result/types.d.ts

@@ -1,5 +1,5 @@
 export declare class PanicError extends Error {
-    constructor(message: string, options?: {
+    constructor(message?: string, options?: {
         cause?: unknown;
     });
 }
@@ -16,8 +16,8 @@ export interface OkResult<T> {
     }): A;
     /** Get the value, or return the default if this is an Err. */
     orDefault<D>(defaultValue: D): T | D;
-    /** Get the value, or panic with the given message if this is an Err. */
-    orPanic(message: string): T;
+    /** Get the value, or panic if this is an Err. The error is included as cause. */
+    orPanic(message?: string): T;
 }
 export interface ErrResult<E> {
     readonly ok: false;
@@ -32,8 +32,8 @@ export interface ErrResult<E> {
     }): B;
     /** Return the default value since this is an Err. */
     orDefault<D>(defaultValue: D): D;
-    /** Always panics with the given message since this is an Err. The error is included as cause. */
-    orPanic(message: string): never;
+    /** Always panics since this is an Err. The error is included as cause. */
+    orPanic(message?: string): never;
 }
 export type Result<T, E> = OkResult<T> | ErrResult<E>;
 export declare function ok(): OkResult<void>;

package/dist/runtime/result/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../runtime/result/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../runtime/result/types.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -6,7 +6,7 @@ export interface MikroRuntimeOptions {
     fsLimit?: number;
     fsReadMax?: number;
     env?: Record<string, string>;
-    /** Virtual module sources to register, keyed by module name (e.g. 'native:mikro/pin'). */
+    /** Virtual module sources to register, keyed by module name (e.g. 'native:mikro/sleep'). */
     modules?: Record<string, string>;
 }
 export interface HostMessage {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../addon/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACpD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,QAAQ,IAAI,MAAM,CAAA;IAClB,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;IACf,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACxD,aAAa,IAAI,WAAW,EAAE,CAAA;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,eAAe,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IACnF,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;IACvB,UAAU,IAAI,YAAY,EAAE,CAAA;IAC5B,kBAAkB,IAAI,MAAM,CAAA;IAC5B,WAAW,IAAI;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAA;IACpD,EAAE,IAAI,IAAI,CAAA;IACV,iBAAiB,IAAI,IAAI,CAAA;IACzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,KAAK,OAAO,CAAC,EAAE,mBAAmB,KAAK,kBAAkB,CAAA;IACvE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACjC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACjF,UAAU,CACR,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAC,GAClC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAAA;CAC7D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../addon/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACpD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,QAAQ,IAAI,MAAM,CAAA;IAClB,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;IACf,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACxD,aAAa,IAAI,WAAW,EAAE,CAAA;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,eAAe,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IACnF,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;IACvB,UAAU,IAAI,YAAY,EAAE,CAAA;IAC5B,kBAAkB,IAAI,MAAM,CAAA;IAC5B,WAAW,IAAI;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAA;IACpD,EAAE,IAAI,IAAI,CAAA;IACV,iBAAiB,IAAI,IAAI,CAAA;IACzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,KAAK,OAAO,CAAC,EAAE,mBAAmB,KAAK,kBAAkB,CAAA;IACvE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACjC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACjF,UAAU,CACR,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAC,GAClC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAAA;CAC7D"}

package/include/mikrojs/mikrojs.h

@@ -93,7 +93,9 @@ void MIK_FreeRuntime(MIKRuntime* mik_rt);
  *   -EINVAL   runtime or entry is null/empty
  *   -ENOENT   entry (and its .bjs variant) not on disk
  *   -EFAULT   module evaluation threw
- * Emits no diagnostic output — callers decide whether and how to log. */
+ * A synchronous throw (a missing import, a syntax error) is reported like an
+ * uncaught exception found by MIK_Loop: error handler, dump, MIK_Stop. A
+ * rejected eval promise is reported by the next loop's rejection flush. */
 int MIK_RunEntry(MIKRuntime* mik_rt, const char* entry);
 
 /* MIK_RunEntry variant that, on -EFAULT, copies the thrown exception's
@@ -265,7 +267,7 @@ int MIK_ReserveModuleSlot(void);
 typedef JSModuleDef* (*MIKModuleInitFn)(JSContext* ctx);
 
 typedef struct mik_module_desc_t {
-    const char* name;         /* module name, e.g. "native:mikro/pin" */
+    const char* name;         /* module name, e.g. "native:mikro/sleep" */
     MIKModuleInitFn init;     /* called on first import; returns the JSModuleDef */
     MIKLoopConsumeFn consume; /* event loop consumer (nullable) */
     MIKLoopDestroyFn destroy; /* cleanup on shutdown (nullable) */
@@ -290,6 +292,7 @@ extern mik_module_desc_t* mik__module_registry_head;
 #define MIK__REQUIRE_NATIVE_NS(name_) MIK__REQUIRE_PREFIX(name_, "native:" MIK_PACKAGE_NAME "/")
 #define MIK__REQUIRE_BUILTIN_NS(name_) MIK__REQUIRE_PREFIX(name_, MIK_PACKAGE_NAME "/")
 #else
+#define MIK__REQUIRE_PREFIX(name_, prefix_) static_assert(true, "")
 #define MIK__REQUIRE_NATIVE_NS(name_) static_assert(true, "")
 #define MIK__REQUIRE_BUILTIN_NS(name_) static_assert(true, "")
 #endif
@@ -298,6 +301,14 @@ extern mik_module_desc_t* mik__module_registry_head;
  * via -u flags (static symbols in static libraries get stripped). */
 #define MIK_REGISTER_MODULE(id, name_, init_, consume_, destroy_)              \
     MIK__REQUIRE_NATIVE_NS(name_);                                             \
+    MIK__MODULE_DESC(id, name_, init_, consume_, destroy_)
+/* A platform C module under its public mikro/ name (mikro/gpio on ESP-IDF), for
+ * modules with no bytecode layer. Core runtime only. */
+#define MIK__REGISTER_PUBLIC_MODULE(id, name_, init_, consume_, destroy_)      \
+    MIK__REQUIRE_BUILTIN_NS(name_);                                            \
+    MIK__REQUIRE_PREFIX(name_, "mikro/");                                      \
+    MIK__MODULE_DESC(id, name_, init_, consume_, destroy_)
+#define MIK__MODULE_DESC(id, name_, init_, consume_, destroy_)                 \
     mik_module_desc_t mik__mod_desc_##id = {                                   \
         name_, init_, consume_, destroy_, NULL};                               \
     static void __attribute__((constructor)) mik__register_mod_##id(void) {    \
@@ -437,6 +448,19 @@ void MIK_ProtocolServeLoop(void);
  * and call MIK_ProtocolServeLoop() again. */
 void MIK_ProtocolExit(void);
 
+/* Exclusive GPIO claims, shared by every module and driver that configures a
+ * GPIO pin. MIK_ClaimGpio returns false when the GPIO is already held. `owner`
+ * must be a non-null static string, such as a class name ("Pwm"); it is
+ * reported to the app in GpioInUse errors, and a NULL owner claims and
+ * releases nothing. Numbers outside 0..63, such as -1 for an unused bus role,
+ * are not tracked: the claim succeeds and release does nothing. Release only
+ * frees a GPIO held under the same owner string, so a stale release cannot
+ * free another module's claim (two instances of one class share an owner). */
+bool MIK_ClaimGpio(int gpio, const char* owner);
+void MIK_ReleaseGpio(int gpio, const char* owner);
+/* The current owner of `gpio`, or NULL when it is free. */
+const char* MIK_GpioOwner(int gpio);
+
 #ifdef __cplusplus
 }
 #endif

package/include/mikrojs/ota_env.h

@@ -146,13 +146,15 @@ struct MIKOtaEnv {
     MIKOtaKvStatus (*kv_get_blob)(void* opaque, const char* key, uint8_t* out_buf,
                                   size_t* inout_len);
     bool (*kv_set_blob)(void* opaque, const char* key, const uint8_t* data, size_t len);
-    /* NOTE: the string and integer getters are still two-valued. Their callers
-     * (the retry-budget store) read a failure as absence, which hands the budget
-     * back a boot early. Same class of bug as the blob case above; worth the same
-     * treatment when the policy's error handling is revisited. */
-    bool (*kv_get_str)(void* opaque, const char* key, char* out_buf, size_t max_len);
+    /* Same contract as kv_get_blob: absent and failed are different answers.
+     * The retry budget lives behind these two, and every fallback a caller
+     * would pick for "absent" grants the device more than it has earned: an
+     * unspent budget, a url that looks new, no bad build on record. Stored
+     * bytes that do not decode report MIK_OTA_KV_ERROR too: garbage is not
+     * absence either. */
+    MIKOtaKvStatus (*kv_get_str)(void* opaque, const char* key, char* out_buf, size_t max_len);
     bool (*kv_set_str)(void* opaque, const char* key, const char* val);
-    bool (*kv_get_i32)(void* opaque, const char* key, int32_t* out_val);
+    MIKOtaKvStatus (*kv_get_i32)(void* opaque, const char* key, int32_t* out_val);
     bool (*kv_set_i32)(void* opaque, const char* key, int32_t val);
     bool (*kv_remove)(void* opaque, const char* key);
 

package/include/mikrojs/ota_policy.h

@@ -92,8 +92,24 @@ public:
     void SetDecline(const MIKOtaDeclineRecord& record);
     void ClearDecline();
 
+    /* True once any read on this store has failed (as opposed to finding the
+     * key absent). Each getter has to answer with something, and the honest
+     * fallback for an unreadable key is the same everywhere: nothing stored.
+     * That reads as an unspent budget, a url that never matched, no abandoned
+     * build, every one of them more permission than the device has earned.
+     * Callers that are about to widen what the device may do consult this
+     * instead, and do nothing on an unreadable store; the next boot re-reads
+     * the real values. Latches for the life of one policy operation, which is
+     * how long a store lives. */
+    bool ReadFailed() const { return read_failed_; }
+
 private:
+    /* Runs every read through one place so the latch cannot be forgotten. */
+    MIKOtaKvStatus ReadStr(const char* key, char* out, size_t max_len) const;
+    MIKOtaKvStatus ReadI32(const char* key, int32_t* out) const;
+
     const MIKOtaEnv* env_;
+    mutable bool read_failed_ = false;
 };
 
 /* Validate untrusted offer fields into a well-formed MIKOtaOffer */

package/include/mikrojs/private.h

@@ -310,6 +310,19 @@ JSModuleDef* mik__udp_init(JSContext* ctx);
 /* Observable module (mik_observable.cpp) */
 JSModuleDef* mik__observable_init(JSContext* ctx);
 void mik__observable_dispatch_free(struct MIKRuntime* mik_rt);
+/* mikro/observable/operators, loaded lazily through the C-module table. */
+JSModuleDef* mik__observable_operators_load(JSContext* ctx);
+/* Builds the same {observable, next, complete} triple as Observable.withEmitters(),
+ * for C modules that expose event streams. Returns -1 with an exception pending;
+ * on success the caller owns all three values. */
+int mik__observable_multicast_new(JSContext* ctx, JSValue* observable, JSValue* next,
+                                  JSValue* complete);
+
+/* GPIO claims (gpio_claim.cpp). Claims every GPIO for `owner`; on the first one
+ * already held, releases those claimed so far and returns an err Result
+ * carrying GpioInUse {name, owner, message}. Returns JS_UNDEFINED on success. */
+JSValue mik__claim_gpios(JSContext* ctx, const int* gpios, int count, const char* owner);
+void mik__release_gpios(const int* gpios, int count, const char* owner);
 
 /* Watchdog (mik_watchdog.cpp). */
 /* Start a fresh blocking budget: top of each MIK_Loop pass, eval entry

package/include/mikrojs/utils.h

@@ -73,6 +73,30 @@ void mik_call_handler(JSContext* ctx, JSValue func, int argc, JSValue* argv);
  * tag on the device and silent by default, so lines that precede a reboot
  * (watchdog lines, panic actions) go through here instead. */
 void mik__print_error_line(const char* fmt, ...) __attribute__((format(printf, 1, 2)));
+/* The Symbol.asyncIterator atom; quickjs.h does not expose the well-known
+ * symbols. The caller frees it with JS_FreeAtom. */
+JSAtom mik__async_iterator_atom(JSContext* ctx);
+/* Prints "<owner> <id>: <call> after end(); the handle no longer owns the <resource>"
+ * once per handle; `warned` is the handle's flag. */
+void mik__warn_after_end(bool* warned, const char* owner, int id, const char* call,
+                         const char* resource);
+
+/* Argument readers for handle factories and methods. Each returns -1 with a
+ * TypeError pending: an integer rejects NaN and fractions (a number accepts
+ * both), a missing optional value leaves *out unchanged, and options may be
+ * undefined unless required. */
+int mik__to_int_arg(JSContext* ctx, JSValueConst v, const char* name, int32_t* out);
+int mik__to_number_arg(JSContext* ctx, JSValueConst v, const char* name, double* out);
+/* Reads a Uint8Array (or ArrayBuffer) without copying; returns nullptr with a
+ * TypeError pending. */
+uint8_t* mik__bytes_arg(JSContext* ctx, JSValueConst v, const char* name, size_t* len);
+int mik__options_arg(JSContext* ctx, int argc, JSValueConst* argv, int index, bool required,
+                     JSValueConst* out);
+int mik__int_option(JSContext* ctx, JSValueConst options, const char* name, bool required,
+                    int32_t* out);
+int mik__number_option(JSContext* ctx, JSValueConst options, const char* name, bool required,
+                       double* out);
+int mik__bool_option(JSContext* ctx, JSValueConst options, const char* name, bool* out);
 void mik_dump_error(JSContext* ctx);
 void mik_dump_error1(JSContext* ctx, JSValue exception_val);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikrojs/native",
-  "version": "0.20.1",
+  "version": "0.21.0-next.20260913195055",
   "description": "Mikro.js C++ runtime library and Node.js native addon",
   "keywords": [
     "esp32",
@@ -65,7 +65,7 @@
     "./runtime/observable/operators": "./runtime/observable/operators.ts",
     "./runtime/observable/types": "./runtime/observable/types.ts",
     "./runtime/ota/types": "./runtime/ota/types.ts",
-    "./runtime/pin/types": "./runtime/pin/types.ts",
+    "./runtime/gpio/types": "./runtime/gpio/types.ts",
     "./runtime/pwm/types": "./runtime/pwm/types.ts",
     "./runtime/reader/types": "./runtime/reader/types.ts",
     "./runtime/result/native-result.node-shim": "./dist/runtime/result/native-result.node-shim.js",
@@ -84,18 +84,18 @@
     "./runtime/wifi/types": "./runtime/wifi/types.ts"
   },
   "dependencies": {
+    "@mikrojs/quickjs": "0.21.0-next.20260913195055+2dfdbd6",
     "cmake-js": "^8.0.0",
-    "node-addon-api": "^8.7.0",
-    "node-gyp-build": "^4.8.4",
-    "@mikrojs/quickjs": "0.20.1"
+    "node-addon-api": "^8.9.2",
+    "node-gyp-build": "^4.8.4"
   },
   "devDependencies": {
-    "@swc/core": "^1.15.30",
+    "@mikrojs/registry": "0.21.0-next.20260913195055+2dfdbd6",
+    "@mikrojs/schema": "0.21.0-next.20260913195055+2dfdbd6",
+    "@swc/core": "^1.16.2",
     "@types/node": "^24.12.2",
-    "esbuild": "^0.28.0",
-    "terser": "^5.46.2",
-    "@mikrojs/registry": "0.20.1",
-    "@mikrojs/schema": "0.20.1"
+    "esbuild": "^0.28.2",
+    "terser": "^5.51.2"
   },
   "engines": {
     "node": ">=24.0.0"

package/runtime/gpio/types.ts

@@ -0,0 +1,116 @@
+/* mikro/gpio, declared here and implemented in C (mik_gpio.cpp). Each handle
+ * type has a factory of the same name that claims the GPIO pin, configures it
+ * and returns a Result. A GPIO pin has one owner at a time across every module. */
+
+import type {Observable} from '../observable/types.js'
+import type {Result} from '../result/types.js'
+
+/**
+ * ADC attenuation setting, controls the measurable voltage range.
+ * - `'0db'`: 0 to 750 mV
+ * - `'2.5db'`: 0 to 1050 mV
+ * - `'6db'`: 0 to 1300 mV
+ * - `'11db'`: 0 to 2500 mV (default)
+ */
+export type Attenuation = '0db' | '2.5db' | '6db' | '11db'
+
+/** The electrical level of a pin: 0 is low, 1 is high. */
+export type Level = 0 | 1
+
+export interface DigitalOutOptions {
+  /** Level applied before the pin becomes an output. Defaults to `0`. */
+  initial?: Level
+}
+
+export interface DigitalInOptions {
+  /** Internal pull resistor. Defaults to `'none'`. Input-only GPIOs (ESP32 GPIO 34 to 39)
+   *  have none, so `'up'` or `'down'` there returns `InvalidGpio`. */
+  pull?: 'up' | 'down' | 'none'
+}
+
+export interface AnalogInOptions {
+  /** ADC attenuation. Defaults to `'11db'`. */
+  attenuation?: Attenuation
+}
+
+/** The GPIO pin is held by another handle, peripheral or the console. */
+export type GpioInUse = {name: 'GpioInUse'; owner: string; message: string}
+
+export type GpioError =
+  | GpioInUse
+  | {name: 'InvalidGpio'; message: string}
+  | {name: 'ConfigFailed'; message: string}
+  | {name: 'ReadFailed'; message: string}
+  | {name: 'CalibrationUnavailable'}
+
+/**
+ * @public
+ */
+export interface GpioPin {
+  /** The GPIO number. */
+  readonly gpio: number
+  /** Releases the GPIO pin. Calling it again does nothing. Afterwards writes do nothing and reads
+   *  still read the pin; the first such call prints a warning. */
+  end(): void
+}
+
+/**
+ * @public
+ */
+export interface DigitalOut extends GpioPin {
+  /** Drives the pin low (0) or high (1). Does nothing after `end()`. */
+  write(level: Level): void
+}
+
+/**
+ * @public
+ */
+export interface DigitalIn extends GpioPin {
+  /** The pin's current level. Still reads the pin after `end()`. */
+  read(): Level
+  /**
+   * Level changes. Edges within one event loop pass are combined, so
+   * each value differs from the previous one. Filter bounces with
+   * `debounceTime` followed by `distinctUntilChanged()`, since a short bounce
+   * can return to the level it started from. Reading this keeps the handle
+   * alive until `end()`, which completes the stream.
+   */
+  readonly onChange: Observable<Level>
+}
+
+/**
+ * @public
+ */
+export interface AnalogIn extends GpioPin {
+  /** Raw 12-bit reading, 0 to 4095. Still reads the pin after `end()`. */
+  read(): Result<number, GpioError>
+  /** Calibrated reading in millivolts. */
+  readMillivolts(): Result<number, GpioError>
+}
+
+/**
+ * Claims a GPIO pin as a digital output.
+ * @public
+ */
+export declare function DigitalOut(
+  gpio: number,
+  options?: DigitalOutOptions,
+): Result<DigitalOut, GpioError>
+
+/**
+ * Claims a GPIO pin as a digital input.
+ * @public
+ */
+export declare function DigitalIn(
+  gpio: number,
+  options?: DigitalInOptions,
+): Result<DigitalIn, GpioError>
+
+/**
+ * Claims a GPIO pin as an analog input on ADC1.
+ * @public
+ */
+export declare function AnalogIn(
+  gpio: number,
+  options?: AnalogInOptions,
+): Result<AnalogIn, GpioError>

package/runtime/i2c/types.ts

@@ -1,55 +1,49 @@
-import type {Result} from '../result/types.js'
+/* mikro/i2c, declared here and implemented in C (mik_i2c.cpp). */
 
-/**
- * @public
- */
-export interface I2cBaseOptions {
-  freq?: number
-  timeout?: number
-}
+import type {GpioInUse} from '../gpio/types.js'
+import type {Result} from '../result/types.js'
 
 /**
  * @public
  */
-export interface I2cOptionsWithPins extends I2cBaseOptions {
+export interface I2cOptions {
   sda: number
   scl: number
+  /** Clock frequency in Hz. Defaults to 100000. */
+  freq?: number
+  /** Timeout per operation in ms. Defaults to 100. */
+  timeout?: number
 }
 
-/**
- * @public
- */
-export type I2cOptions = I2cBaseOptions | I2cOptionsWithPins
-
 export type I2cError =
+  | GpioInUse
+  | {name: 'InvalidGpio'; message: string}
+  | {name: 'InvalidParam'; message: string}
   | {name: 'BusInitFailed'; message: string}
-  | {name: 'BusDeinitFailed'; message: string}
-  | {name: 'NotStarted'}
-  | {name: 'MissingPins'}
   | {name: 'AddDeviceFailed'; message: string}
   | {name: 'WriteFailed'; message: string}
   | {name: 'WriteTooLarge'}
   | {name: 'ReadFailed'; message: string}
 
-/**
- * @public
- */
-export declare const I2c: {
-  prototype: I2c
-  new (busNo: 0 | 1, options?: I2cOptions): I2c
-}
-
 /**
  * @public
  */
 export interface I2c {
-  begin(): Result<void, I2cError>
-
-  end(): Result<void, I2cError>
-
+  /** Reads `bytes` bytes from the device at `address`. */
   read(address: number, bytes: number): Result<Uint8Array, I2cError>
-
+  /** Writes `data` to the device at `address`. Pass `stop: false` to follow with a read that
+   *  uses a repeated start. */
   write(address: number, data: Uint8Array, stop?: boolean): Result<void, I2cError>
-
+  /** Addresses that answered a probe. */
   scan(): Result<Uint8Array, I2cError>
+  /** Deletes the bus and releases its GPIO pins. Calling it again does nothing. Afterwards
+   *  `write()` does nothing and reads return an empty array; the first such call prints a
+   *  warning. */
+  end(): void
 }
+
+/**
+ * Claims the pins and starts an I2C bus on a controller.
+ * @public
+ */
+export declare function I2c(bus: number, options: I2cOptions): Result<I2c, I2cError>

package/runtime/i2s/types.ts

@@ -1,3 +1,6 @@
+/* mikro/i2s, declared here and implemented in C (mik_i2s.cpp). */
+
+import type {GpioInUse} from '../gpio/types.js'
 import type {Result} from '../result/types.js'
 
 /**
@@ -57,7 +60,7 @@ export interface I2sStdTxRxOptions extends I2sStdBaseOptions {
 
 /**
  * PDM is receive-only and chip-dependent (classic ESP32 and S3 support it; some
- * C/H-series targets do not). On unsupported chips `begin()` returns
+ * C/H-series targets do not). On unsupported chips `I2s()` returns
  * `ChannelInitFailed`.
  *
  * @public
@@ -80,11 +83,12 @@ export interface I2sPdmRxOptions {
  * @public
  */
 export type I2sError =
+  | GpioInUse
+  | {name: 'InvalidGpio'; message: string}
   | {name: 'ChannelInitFailed'; message: string}
   | {name: 'InvalidParam'; message: string}
   | {name: 'WriteFailed'; message: string}
   | {name: 'ReadFailed'; message: string}
-  | {name: 'NotStarted'}
   | {name: 'QueueFull'}
   | {name: 'NoRxPin'}
   | {name: 'NoTxPin'}
@@ -122,18 +126,25 @@ export interface I2sRx {
 /**
  * @public
  */
-export interface I2sBase {
-  begin(): Result<void, I2sError>
-  end(): Result<void, I2sError>
+export interface I2s {
+  /**
+   * Stops the DMA, deletes the channels and releases the GPIO pins. Queued
+   * writes resolve with `ok()`. Calling it again does nothing. Afterwards
+   * `write()` resolves `ok()` and `capture()` returns an empty array; the first
+   * such call prints a warning.
+   */
+  end(): void
 }
 
 /**
+ * Claims the pins and starts I2S channels on a controller. Direction follows
+ * the pins: `dout` enables `write()`, `din` enables `capture()`.
  * @public
  */
-export declare const I2s: {
-  prototype: I2sBase
-  new (port: number, options: I2sStdTxRxOptions): I2sBase & I2sTx & I2sRx
-  new (port: number, options: I2sStdTxOptions): I2sBase & I2sTx
-  new (port: number, options: I2sStdRxOptions): I2sBase & I2sRx
-  new (port: number, options: I2sPdmRxOptions): I2sBase & I2sRx
-}
+export declare function I2s(
+  port: number,
+  options: I2sStdTxRxOptions,
+): Result<I2s & I2sTx & I2sRx, I2sError>
+export declare function I2s(port: number, options: I2sStdTxOptions): Result<I2s & I2sTx, I2sError>
+export declare function I2s(port: number, options: I2sStdRxOptions): Result<I2s & I2sRx, I2sError>
+export declare function I2s(port: number, options: I2sPdmRxOptions): Result<I2s & I2sRx, I2sError>