fix: resolve native module architecture mismatch in Linux ARM64 builds

[yunho0130]

Summary

• Fix Linux ARM64 packages shipping with x86-64 native .node modules, which causes immediate crash on ARM64 systems
• Add fix-native-modules.js afterPack hook that detects cross-compilation and replaces mismatched binaries
• Affected modules: @homebridge/node-pty-prebuilt-multiarch, @parcel/watcher, bufferutil

Problem

When building Linux ARM64 .deb/.rpm/.AppImage packages from an x86-64 Docker host (electronuserland/builder), native .node modules are compiled for x86-64 and incorrectly bundled into the ARM64 package.

Root cause: electron-builder install-app-deps runs once for the host architecture (process.arch = x64), and @electron/rebuild skips prebuilt modules (via prebuildInstallNativeModuleExists()) without verifying the target architecture matches.

Runtime errors on ARM64:

Error: /opt/Pinokio/resources/app.asar.unpacked/node_modules/@homebridge/
  node-pty-prebuilt-multiarch/build/Release/pty.node: cannot open shared object file

Error: /opt/Pinokio/resources/app.asar.unpacked/node_modules/@parcel/
  watcher/build/Release/watcher.node: cannot open shared object file

Solution

Add a fix-native-modules.js afterPack hook (called from after-pack.js) that:

1. Detects cross-compilation by comparing host and target architectures
2. Scans all .node files in app.asar.unpacked using the file command to check ELF architecture
3. Replaces mismatched binaries using three strategies:
   • Prebuilds: Copy from the package's prebuilds/linux-<arch>/ directory (e.g. node-pty)
   • Platform packages: Download the correct platform-specific npm package (e.g. @parcel/watcher-linux-arm64-glibc)
   • Cross-compile: Build N-API modules with cross-compiler when available (e.g. bufferutil)

The hook is a no-op when host and target architectures match (no performance impact for native builds).

Test plan

• Verified on Ubuntu 24.04 ARM64 (aarch64) that v6.0.10 ARM64 .deb ships x86-64 native modules
• Manually replaced all three modules (pty.node, watcher.node, bufferutil.node) with ARM64 versions
• Confirmed Pinokio starts and runs successfully on ARM64 after replacement
• Build Linux packages from x86-64 Docker with this patch and verify ARM64 output

🤖 Generated with Claude Code