Skip to content

docs(weak-node-api): update outdated rationale in README - #489

Draft
kraenhansen wants to merge 3 commits into
nextfrom
docs/weak-node-api-readme-rationale
Draft

kraenhansen wants to merge 3 commits into
nextfrom
docs/weak-node-api-readme-rationale

Conversation

@kraenhansen

@kraenhansen kraenhansen commented Oct 31, 2026 •

Copy link
Copy Markdown
Collaborator

The README justified weak-node-api by a Node-API implementation split between Hermes and the host. That split is gone: Hermes implements Node-API, and the host supplies hermes_napi_host integration plus one deliberate napi_fatal_error override. The rationale now rests on what still holds: addons have no specific Hermes to link against, and runtime injection is what lets the override reach them.

Also links nodejs/node#60916 as the better long-term solution, since it would remove the need for this library.

No changeset, matching earlier docs-only package README PRs (#411, #400).

Test plan

  • Checked each statement against next (generate-injector.mts, weak-node-api.ts generator, RuntimeNodeApi.hpp, HermesNapiHost.hpp, Logger.cpp, ferric/cmake-rn sources)
  • prettier --check packages/weak-node-api/README.md

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
kraenhansen and others added 2 commits October 31, 2026 19:53
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant