doc,test: add documentation and test on how to use addons in SEA

[joyeecheung]

Fixes: #60611

[nodejs-github-bot]

Review requested:

• @nodejs/gyp
• @nodejs/single-executable

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 88.52%. Comparing base (d137969) to head (84ed79b).
⚠️ Report is 66 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #59582      +/-   ##
==========================================
- Coverage   88.53%   88.52%   -0.01%     
==========================================
  Files         703      703              
  Lines      208077   208220     +143     
  Branches    40083    40136      +53     
==========================================
+ Hits       184214   184326     +112     
- Misses      15881    15903      +22     
- Partials     7982     7991       +9     

see 37 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[joyeecheung]

Formatted the addon code and changed the test to use cwd: tmpdir.path for the SEA since the testing environment does not allow access to os.tmpdir().

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/68861/

[joyeecheung]

Forgot the skipIfSingleExecutableIsNotSupported() call, added.

[joyeecheung]

Forgot to skip on ppc64le like what's done in #59563, added

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/68875/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/68888/

[joyeecheung]

For some reason, this doesn't actually work on Linux arm64 - but only in the GitHub actions, and x64 Linux seems to work alright in GitHub actions, and in the Jenkins CI, both work alright.

[process 202296]: --- stderr ---
/home/runner/work/node/node/node/test/.tmp.4536/sea: symbol lookup error: /home/runner/work/node/node/node/test/.tmp.4536/hello.node: undefined symbol: napi_define_properties

[process 202296]: --- stdout ---

[process 202296]: status = 127, signal = null
/home/runner/work/node/node/node/test/common/child_process.js:98
    throw error;
    ^

Error: - process terminated with status 127, expected 0

[joyeecheung]

I poked at it a bit and it looks like the failure in the github actions on linux arm64 is a legit bug of postject - which only reproduces in a Linux arm64 container, but not on bare metal, or Linux x64. Opened nodejs/postject#105

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/70114/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/70128/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/70160/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/70210/

[nodejs-github-bot]

Landed in 61cf89c