CharlesKWON 00b4835a53 feat(rtl): nodebridge — handle-based Node module bridge in pure Go
Faithful Go port of the C++ fivenode Require() mechanism: persistent node
sidecar + JSON handle protocol (require→handle, call→method with auto-await
Promise, end), driven by pure-Go glue (os/exec + stdio). No C/CGO, not
`node -e` string eval. NODE_PATH points at the app's node_modules.
PRG: FN_REQUIRE / FN_CALL / FN_END / FN_LASTERROR.

Replaces the earlier nodertl (NODE_EVAL string-eval), removed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 19:04:09 +09:00

fivenode_go

FiveNode for Five — a Harbour-compatible web framework that compiles to a single Go binary. No Node.js, no FFI, no Apache. PRG sources go in, one executable comes out.

Successor to the koffi/N-API based fivenode framework, rebuilt on the Five Pure-Go runtime.

Status

Early bootstrap — Phase 1a in progress.

Architecture

Browser ──── HTTP/HTTPS ──── fivenode_go single binary
                              ├─ Five hbrt VM (PRG interpreter / compiled)
                              ├─ Five hbrtl (483 standard RTL functions)
                              ├─ hbrtl_ext/httpserver  — HTTP server RTL
                              ├─ hbrtl_ext/capi        — bridge_*.prg helpers
                              ├─ hbrtl_ext/pgrtl       — PostgreSQL client RTL
                              ├─ app/                  — bridge_*.prg + app PRG
                              └─ go:embed              — static assets

fnode build api/*.prg --extra-rtl=hbrtl_ext/... -o myapp produces a self-contained binary. No external dependencies beyond what the app code itself opens (e.g. a Postgres connection).

Build

go build -o fnode ./cmd/fnode
./fnode build app/hello.prg -o hello
./hello

License

Copyright (c) 2026 Charles KWON OhJun. All rights reserved.

Description
FiveNode for Five — Harbour PRG web framework as a single Go binary (no Node.js, no FFI)
Readme 208 KiB
Languages
Go 48%
xBase 36.7%
HTML 7.8%
CSS 6.2%
JavaScript 1.3%