Skip to content

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

Merged
kraenhansen merged 3 commits into
nextfrom
docs/weak-node-api-readme-rationale
Nov 1, 2026
Merged

kraenhansen merged 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>
@kraenhansen
kraenhansen marked this pull request as ready for review November 1, 2026 23:13
@kraenhansen
kraenhansen merged commit b9dd5c5 into next Nov 1, 2026
18 checks passed
@kraenhansen
kraenhansen deleted the docs/weak-node-api-readme-rationale branch November 1, 2026 23:14
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