@gjsify/http2-native 0.22.0 → 0.23.0

package/README.md

@@ -31,7 +31,32 @@ if (hasNativeHttp2()) {
 }
 ```
 
-Ships as a prebuilt `.so` + `.typelib` for `linux-x86_64`. Build from source with `meson` + `valac` + `libnghttp2-devel` if your architecture is not covered.
+See [Platform coverage](#platform-coverage) for the prebuilt platforms.
+
+## Platform coverage
+
+| Platform | Prebuild | Built by |
+|---|---|---|
+| `linux-x86_64` | ✅ `.so` + `.gir` + `.typelib` | native runner |
+| `linux-aarch64` | ✅ | native runner |
+| `linux-ppc64`, `linux-s390x`, `linux-riscv64` | ✅ | QEMU emulation |
+| `darwin-arm64` (macOS, Apple silicon) | ✅ `.dylib` + `.gir` + `.typelib` | `macos-latest` runner |
+| `darwin-x64` (macOS, Intel) | ❌ | — no runner leg yet |
+| Windows | ❌ | — no Vala/GI bridge in this repo targets Windows |
+
+All prebuilds are produced by [`.github/workflows/prebuilds.yml`](../../../.github/workflows/prebuilds.yml)
+and committed back to the repository. Build from source with `meson` + `valac` + nghttp2
+development headers if your architecture is not covered.
+
+On macOS, nghttp2 comes from Homebrew's keg-only `libnghttp2` formula. Because this bridge
+resolves it through `cc.find_library('nghttp2', …)` rather than pkg-config, the build needs
+`CPPFLAGS`/`LDFLAGS` pointed at `$(brew --prefix libnghttp2)` — the prebuilds workflow does
+this for you.
+
+**Known gap — a `darwin-arm64` prebuild is built and shipped, but the CLI does not
+load it yet.** `detectNativePackages()` (`packages/infra/cli/src/utils/detect-native-packages.ts`)
+hardcodes a `linux-` directory prefix, and `buildNativeEnv()` exports `LD_LIBRARY_PATH`,
+which macOS `dyld` ignores in favour of `DYLD_LIBRARY_PATH`.
 
 ## License
 

package/meson.build

@@ -41,12 +41,32 @@ libGjsifyHttp2 = library('gjsifyhttp2', sources,
     install_dir: [true, true, true, true],
 )
 
+# ----------------------------------------------------------------------------
+# Host-dependent shared-library leaf name.
+#
+# The typelib records the exact filename gjs' g_module_open() resolves at load
+# time, and meson names the shared library per host convention: lib<name>.so on
+# ELF hosts, lib<name>.dylib on macOS. Recording the wrong leaf yields a typelib
+# that IS found via GI_TYPELIB_PATH but whose library never loads — a silent,
+# confusing failure. Mirrors the branch in packages/napi/napi/meson.build.
+#
+# Windows is deliberately absent: this bridge has had no Windows portability
+# work, so `else` (ELF naming) is the honest fallback rather than a .dll branch
+# that would imply support which does not exist.
+# ----------------------------------------------------------------------------
+host_system = host_machine.system()
+if host_system == 'darwin'
+    shared_lib_name = 'libgjsifyhttp2.dylib'
+else
+    shared_lib_name = 'libgjsifyhttp2.so'
+endif
+
 g_ir_compiler = find_program('g-ir-compiler')
 
 custom_target(meson.project_name() + '-1.0.typelib',
     command: [
         g_ir_compiler,
-        '--shared-library', 'libgjsifyhttp2.so',
+        '--shared-library', shared_lib_name,
         '--output', '@OUTPUT@',
         meson.current_build_dir() / meson.project_name() + '-1.0.gir',
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/http2-native",
-    "version": "0.22.0",
+    "version": "0.23.0",
     "description": "Optional Vala/GObject bridge providing nghttp2 primitives unreachable through libsoup's high-level GIR API: HPACK header-block encoding (for PUSH_PROMISE / DATA frames), server-side push stream-ID allocation, and a thin nghttp2_session wrapper for future cleartext HTTP/2 (h2c) support. Used by @gjsify/http2 to back ServerHttp2Stream.pushStream() / respondWithFD() / respondWithFile() and enable createServer() over plain TCP once the full Soup ↔ nghttp2 boundary is in place.",
     "type": "module",
     "main": "lib/esm/index.js",
@@ -19,6 +19,14 @@
         "src/vala"
     ],
     "gjsify": {
+        "platforms": [
+            "linux-x86_64",
+            "linux-aarch64",
+            "linux-ppc64",
+            "linux-s390x",
+            "linux-riscv64",
+            "darwin-arm64"
+        ],
         "prebuilds": "prebuilds",
         "runtimes": {
             "gjs": "polyfill",
@@ -37,7 +45,7 @@
         "build:gjsify": "gjsify build --library 'src/ts/**/*.{ts,js}' --exclude 'src/ts/**/*.spec.{mts,ts}' 'src/ts/test.{mts,ts}'",
         "build:meson": "gjsify run init:meson && meson compile -C build",
         "build:types": "gjsify tsc",
-        "build:prebuilds": "gjsify run build:meson && mkdir -p prebuilds/linux-x86_64 && cp build/libgjsifyhttp2.so build/GjsifyHttp2-1.0.gir build/GjsifyHttp2-1.0.typelib prebuilds/linux-x86_64/",
+        "build:prebuilds": "gjsify run build:meson && node ../../../scripts/stage-prebuild.mjs .",
         "build:gir-types": "ts-for-gir generate --externalDeps --allowMissingDeps --girDirectories=./prebuilds/linux-x86_64 --girDirectories=/usr/share/gir-1.0 --modules=GjsifyHttp2-1.0 --outdir=src/ts --npmScope=@girs --package=false --ignoreVersionConflicts=true",
         "build:test": "gjsify run build:test:gjs",
         "build:test:gjs": "gjsify build src/ts/test.mts --app gjs --outfile test.gjs.mjs",
@@ -60,8 +68,8 @@
         "@girs/gobject-2.0": "^4.1.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.22.0",
-        "@gjsify/unit": "^0.22.0",
+        "@gjsify/cli": "^0.23.0",
+        "@gjsify/unit": "^0.23.0",
         "@ts-for-gir/cli": "^4.1.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"