chore: async init wasm on browser

Author: Brooooooklyn

package.json

@@ -12,7 +12,7 @@
     "website"
   ],
   "devDependencies": {
-    "@napi-rs/cli": "^3.0.0-alpha.91",
+    "@napi-rs/cli": "^3.0.0-alpha.92",
     "@taplo/cli": "^0.7.0",
     "@types/node": "^24.0.4",
     "@types/sharp": "^0.32.0",

packages/binding/image.wasi-browser.js

@@ -1,7 +1,7 @@
 import {
   createOnMessage as __wasmCreateOnMessageForFsProxy,
   getDefaultContext as __emnapiGetDefaultContext,
-  instantiateNapiModuleSync as __emnapiInstantiateNapiModuleSync,
+  instantiateNapiModule as __emnapiInstantiateNapiModule,
   WASI as __WASI,
 } from '@napi-rs/wasm-runtime'
 
@@ -25,7 +25,7 @@ const {
   instance: __napiInstance,
   module: __wasiModule,
   napiModule: __napiModule,
-} = __emnapiInstantiateNapiModuleSync(__wasmFile, {
+} = await __emnapiInstantiateNapiModule(__wasmFile, {
   context: __emnapiContext,
   asyncWorkPoolSize: 4,
   wasi: __wasi,

packages/binding/image.wasi.cjs

@@ -65,6 +65,29 @@ const { instance: __napiInstance, module: __wasiModule, napiModule: __napiModule
     worker.onmessage = ({ data }) => {
       __wasmCreateOnMessageForFsProxy(__nodeFs)(data)
     }
+
+    // The main thread of Node.js waits for all the active handles before exiting.
+    // But Rust threads are never waited without `thread::join`.
+    // So here we hack the code of Node.js to prevent the workers from being referenced (active).
+    // According to https://github.com/nodejs/node/blob/19e0d472728c79d418b74bddff588bea70a403d0/lib/internal/worker.js#L415,
+    // a worker is consist of two handles: kPublicPort and kHandle.
+    {
+      const kPublicPort = Object.getOwnPropertySymbols(worker).find(s =>
+        s.toString().includes("kPublicPort")
+      );
+      if (kPublicPort) {
+        worker[kPublicPort].ref = () => {};
+      }
+
+      const kHandle = Object.getOwnPropertySymbols(worker).find(s =>
+        s.toString().includes("kHandle")
+      );
+      if (kPublicPort) {
+        worker[kHandle].ref = () => {};
+      }
+
+      worker.unref();
+    }
     return worker
   },
   overwriteImports(importObject) {

packages/binding/index.d.ts

@@ -6,6 +6,7 @@ export declare class Transformer {
   static fromSvg(input: string | Uint8Array, background?: string | undefined | null): Transformer
   static fromRgbaPixels(input: Uint8Array | Uint8ClampedArray, width: number, height: number): Transformer
   metadata(withExif?: boolean | undefined | null, signal?: AbortSignal | undefined | null): Promise<Metadata>
+  metadataSync(withExif?: boolean | undefined | null): Metadata
   /**
    * Rotate with exif orientation
    * If the orientation param is not null,

packages/binding/package.json

@@ -44,7 +44,13 @@
       "x86_64-unknown-freebsd",
       "i686-pc-windows-msvc",
       "wasm32-wasi-preview1-threads"
-    ]
+    ],
+    "wasm": {
+      "browser": {
+        "asyncInit": true,
+        "fs": false
+      }
+    }
   },
   "license": "MIT",
   "engines": {
@@ -66,7 +72,7 @@
   },
   "repository": "[email protected]:Brooooooklyn/Image.git",
   "devDependencies": {
-    "@napi-rs/cli": "^3.0.0-alpha.91",
+    "@napi-rs/cli": "^3.0.0-alpha.92",
     "@napi-rs/wasm-runtime": "^0.2.11"
   }
 }

yarn.lock

@@ -953,9 +953,9 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@napi-rs/cli@npm:^3.0.0-alpha.91":
-  version: 3.0.0-alpha.91
-  resolution: "@napi-rs/cli@npm:3.0.0-alpha.91"
+"@napi-rs/cli@npm:^3.0.0-alpha.92":
+  version: 3.0.0-alpha.92
+  resolution: "@napi-rs/cli@npm:3.0.0-alpha.92"
   dependencies:
     "@inquirer/prompts": "npm:^7.4.0"
     "@napi-rs/cross-toolchain": "npm:^0.0.19"
@@ -982,7 +982,7 @@ __metadata:
   bin:
     napi: ./dist/cli.js
     napi-raw: ./cli.mjs
-  checksum: 10c0/a1e8078b47b64551f41d1386a7f462a9d34728bbe7158e9d55348889a6100d6c3c970fc7e1d7e4898fce362074515e283cd4475275eea88a1614cab66f16b12b
+  checksum: 10c0/58118e413e9f3d98b991ce1869475c06b6a837c0373f43bb74e2509d48d7d7281d1b4b9c3d2b5aa45c11957d08b5e758a547ae9757c8299ef72fb02751f03208
   languageName: node
   linkType: hard
 
@@ -1027,7 +1027,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "@napi-rs/image@workspace:packages/binding"
   dependencies:
-    "@napi-rs/cli": "npm:^3.0.0-alpha.91"
+    "@napi-rs/cli": "npm:^3.0.0-alpha.92"
     "@napi-rs/wasm-runtime": "npm:^0.2.11"
   languageName: unknown
   linkType: soft
@@ -6649,7 +6649,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "image@workspace:."
   dependencies:
-    "@napi-rs/cli": "npm:^3.0.0-alpha.91"
+    "@napi-rs/cli": "npm:^3.0.0-alpha.92"
     "@taplo/cli": "npm:^0.7.0"
     "@types/node": "npm:^24.0.4"
     "@types/sharp": "npm:^0.32.0"