@gjsify/http2-native 0.4.0

package/lib/esm/_virtual/_rolldown/runtime.js

@@ -0,0 +1 @@
+var e=Object.defineProperty,__name=(t,n)=>e(t,`name`,{value:n,configurable:!0});export{__name};

package/lib/esm/index.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";let e=null,t=!1,n=null;function loadNativeHttp2(){if(t)return e;t=!0;try{let t=globalThis.imports?.gi;if(!t)return n=Error(`imports.gi not available — not running under GJS?`),null;let r=t.GjsifyHttp2;return r?(e=r,e):(n=Error(`GjsifyHttp2 typelib not found on GI_TYPELIB_PATH`),null)}catch(t){return n=t instanceof Error?t:Error(String(t)),e=null,null}}function hasNativeHttp2(){return loadNativeHttp2()!==null}function getLoadError(){return n}export{getLoadError,hasNativeHttp2,loadNativeHttp2};

package/lib/types/index.d.ts

@@ -0,0 +1,27 @@
+import type { GjsifyHttp2 as GjsifyHttp2NS } from 'gi://GjsifyHttp2?version=1.0';
+type FrameEncoderInstance = GjsifyHttp2NS.FrameEncoder;
+type FrameEncoderCtor = typeof GjsifyHttp2NS.FrameEncoder;
+type StreamIdAllocatorInstance = GjsifyHttp2NS.StreamIdAllocator;
+type StreamIdAllocatorCtor = typeof GjsifyHttp2NS.StreamIdAllocator;
+type SessionBridgeStatic = typeof GjsifyHttp2NS.SessionBridge;
+export interface NativeHttp2Module {
+    FrameEncoder: FrameEncoderCtor;
+    StreamIdAllocator: StreamIdAllocatorCtor;
+    SessionBridge: SessionBridgeStatic;
+}
+export type { FrameEncoderInstance as FrameEncoder };
+export type { StreamIdAllocatorInstance as StreamIdAllocator };
+/**
+ * Lazily load the GjsifyHttp2 typelib. Idempotent — subsequent calls
+ * return the cached module (or `null` if the first call failed).
+ */
+export declare function loadNativeHttp2(): NativeHttp2Module | null;
+/**
+ * Returns `true` if the GjsifyHttp2 typelib is loadable (prebuild present).
+ */
+export declare function hasNativeHttp2(): boolean;
+/**
+ * Returns the load error from the first `loadNativeHttp2()` call, or `null`
+ * if loading succeeded or hasn't been attempted yet.
+ */
+export declare function getLoadError(): Error | null;

package/meson.build

@@ -0,0 +1,57 @@
+project('GjsifyHttp2', ['c', 'vala'], version: '1.0')
+
+root_dir = meson.current_source_dir()
+
+# Required system packages (Fedora 43+):
+#   dnf install vala meson ninja-build libnghttp2-devel
+#
+# Bindings: there is no upstream nghttp2 VAPI, so we wrap the handful of
+# symbols we need in a small C shim (src/vala/nghttp2-helpers.{h,c}) and
+# call into it from Vala via [CCode] extern declarations. This keeps every
+# nghttp2 pointer C-side, mirroring the pattern in @gjsify/webrtc-native.
+#
+# We use cc.find_library / cc.find_header instead of `dependency()` for
+# nghttp2 — `dependency()` makes meson pass `--pkg libnghttp2` to valac,
+# which then looks for an nghttp2.vapi we don't have. find_library only
+# affects the C compile + link stages, not Vala.
+cc = meson.get_compiler('c')
+
+nghttp2_lib = cc.find_library('nghttp2', has_headers: ['nghttp2/nghttp2.h'])
+
+vala_deps = [
+    dependency('glib-2.0'),
+    dependency('gobject-2.0'),
+]
+
+sources = files(
+    'src/vala/nghttp2-helpers.c',
+    'src/vala/frame-encoder.vala',
+    'src/vala/stream-id-allocator.vala',
+    'src/vala/session-bridge.vala',
+)
+
+# Compiler picks up nghttp2-helpers.h via the include dir.
+inc = include_directories('src/vala')
+
+libGjsifyHttp2 = library('gjsifyhttp2', sources,
+    dependencies: vala_deps + [nghttp2_lib],
+    include_directories: inc,
+    vala_gir: meson.project_name() + '-1.0.gir',
+    install: true,
+    install_dir: [true, true, true, true],
+)
+
+g_ir_compiler = find_program('g-ir-compiler')
+
+custom_target(meson.project_name() + '-1.0.typelib',
+    command: [
+        g_ir_compiler,
+        '--shared-library', 'libgjsifyhttp2.so',
+        '--output', '@OUTPUT@',
+        meson.current_build_dir() / meson.project_name() + '-1.0.gir',
+    ],
+    output: meson.project_name() + '-1.0.typelib',
+    depends: libGjsifyHttp2,
+    install: true,
+    install_dir: get_option('libdir') / 'girepository-1.0',
+)

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@gjsify/http2-native",
+  "version": "0.4.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",
+  "module": "lib/esm/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/esm/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "prebuilds",
+    "meson.build",
+    "src/vala"
+  ],
+  "gjsify": {
+    "prebuilds": "prebuilds"
+  },
+  "scripts": {
+    "clear": "rm -rf lib build tsconfig.tsbuildinfo tsconfig.types.tsbuildinfo || exit 0",
+    "check": "tsc --noEmit",
+    "init:meson": "meson setup build .",
+    "init:meson:wipe": "yarn init:meson --wipe",
+    "build": "yarn build:gjsify && yarn build:types",
+    "build:gjsify": "gjsify build --library 'src/ts/**/*.{ts,js}'",
+    "build:meson": "yarn init:meson && meson compile -C build",
+    "build:types": "tsc",
+    "build:prebuilds": "yarn 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: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"
+  },
+  "keywords": [
+    "gjs",
+    "http2",
+    "nghttp2",
+    "hpack",
+    "push-promise",
+    "h2c",
+    "vala",
+    "native"
+  ],
+  "dependencies": {
+    "@girs/gjs": "4.0.0-rc.15",
+    "@girs/glib-2.0": "2.88.0-4.0.0-rc.15",
+    "@girs/gobject-2.0": "2.88.0-4.0.0-rc.15"
+  },
+  "devDependencies": {
+    "@gjsify/cli": "^0.4.0",
+    "@ts-for-gir/cli": "^4.0.0-rc.15",
+    "@types/node": "^25.6.2",
+    "typescript": "^6.0.3"
+  }
+}

package/prebuilds/linux-aarch64/GjsifyHttp2-1.0.gir

@@ -0,0 +1,253 @@
+<?xml version="1.0"?>
+<!-- GjsifyHttp2-1.0.gir generated by valac 0.56.19, do not modify. -->
+<repository version="1.2" xmlns="http://www.gtk.org/introspection/core/1.0" xmlns:c="http://www.gtk.org/introspection/c/1.0" xmlns:doc="http://www.gtk.org/introspection/doc/1.0" xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
+<include name="GObject" version="2.0"/>
+<include name="GLib" version="2.0"/>
+<package name="gjsifyhttp2"/>
+<c:include name="nghttp2-helpers.h"/>
+<c:include name="gjsifyhttp2.h"/>
+<doc:format name="unknown"/>
+<namespace name="GjsifyHttp2" version="1.0" shared-library="libgjsifyhttp2.so" c:prefix="GjsifyHttp2" c:identifier-prefixes="GjsifyHttp2" c:symbol-prefixes="gjsify_http2">
+	<class name="FrameEncoder" c:type="GjsifyHttp2FrameEncoder" c:symbol-prefix="frame_encoder" glib:type-name="GjsifyHttp2FrameEncoder" glib:get-type="gjsify_http2_frame_encoder_get_type" glib:type-struct="FrameEncoderClass" parent="GObject.Object">
+		<field name="parent_instance" readable="0" private="1">
+			<type name="GObject.Object" c:type="GObject"/>
+		</field>
+		<field name="priv" readable="0" private="1">
+			<type name="FrameEncoderPrivate" c:type="GjsifyHttp2FrameEncoderPrivate*"/>
+		</field>
+		<constant name="TYPE_DATA" c:identifier="GJSIFY_HTTP2_FRAME_ENCODER_TYPE_DATA" value="0x00">
+			<type name="gint" c:type="gint"/>
+		</constant>
+		<constant name="TYPE_HEADERS" c:identifier="GJSIFY_HTTP2_FRAME_ENCODER_TYPE_HEADERS" value="0x01">
+			<type name="gint" c:type="gint"/>
+		</constant>
+		<constant name="TYPE_PUSH_PROMISE" c:identifier="GJSIFY_HTTP2_FRAME_ENCODER_TYPE_PUSH_PROMISE" value="0x05">
+			<type name="gint" c:type="gint"/>
+		</constant>
+		<constant name="TYPE_GOAWAY" c:identifier="GJSIFY_HTTP2_FRAME_ENCODER_TYPE_GOAWAY" value="0x07">
+			<type name="gint" c:type="gint"/>
+		</constant>
+		<constant name="TYPE_WINDOW_UPDATE" c:identifier="GJSIFY_HTTP2_FRAME_ENCODER_TYPE_WINDOW_UPDATE" value="0x08">
+			<type name="gint" c:type="gint"/>
+		</constant>
+		<constant name="FLAG_END_STREAM" c:identifier="GJSIFY_HTTP2_FRAME_ENCODER_FLAG_END_STREAM" value="0x01">
+			<type name="gint" c:type="gint"/>
+		</constant>
+		<constant name="FLAG_END_HEADERS" c:identifier="GJSIFY_HTTP2_FRAME_ENCODER_FLAG_END_HEADERS" value="0x04">
+			<type name="gint" c:type="gint"/>
+		</constant>
+		<method name="encode_headers" c:identifier="gjsify_http2_frame_encoder_encode_headers">
+			<return-value transfer-ownership="full" nullable="1">
+				<type name="GLib.Bytes" c:type="GBytes*"/>
+			</return-value>
+			<parameters>
+				<instance-parameter name="self" transfer-ownership="none">
+					<type name="GjsifyHttp2.FrameEncoder" c:type="GjsifyHttp2FrameEncoder*"/>
+				</instance-parameter>
+				<parameter name="names" transfer-ownership="none">
+					<array length="1" c:type="gchar**">
+						<type name="utf8" c:type="gchar*"/>
+					</array>
+				</parameter>
+				<parameter name="names_length1" transfer-ownership="none">
+					<type name="gint" c:type="gint"/>
+				</parameter>
+				<parameter name="values" transfer-ownership="none">
+					<array length="3" c:type="gchar**">
+						<type name="utf8" c:type="gchar*"/>
+					</array>
+				</parameter>
+				<parameter name="values_length1" transfer-ownership="none">
+					<type name="gint" c:type="gint"/>
+				</parameter>
+			</parameters>
+		</method>
+		<method name="build_data_frame" c:identifier="gjsify_http2_frame_encoder_build_data_frame">
+			<return-value transfer-ownership="full">
+				<type name="GLib.Bytes" c:type="GBytes*"/>
+			</return-value>
+			<parameters>
+				<instance-parameter name="self" transfer-ownership="none">
+					<type name="GjsifyHttp2.FrameEncoder" c:type="GjsifyHttp2FrameEncoder*"/>
+				</instance-parameter>
+				<parameter name="stream_id" transfer-ownership="none">
+					<type name="guint32" c:type="guint32"/>
+				</parameter>
+				<parameter name="end_stream" transfer-ownership="none">
+					<type name="gboolean" c:type="gboolean"/>
+				</parameter>
+				<parameter name="payload" transfer-ownership="none">
+					<type name="GLib.Bytes" c:type="GBytes*"/>
+				</parameter>
+			</parameters>
+		</method>
+		<method name="build_headers_frame" c:identifier="gjsify_http2_frame_encoder_build_headers_frame">
+			<return-value transfer-ownership="full">
+				<type name="GLib.Bytes" c:type="GBytes*"/>
+			</return-value>
+			<parameters>
+				<instance-parameter name="self" transfer-ownership="none">
+					<type name="GjsifyHttp2.FrameEncoder" c:type="GjsifyHttp2FrameEncoder*"/>
+				</instance-parameter>
+				<parameter name="stream_id" transfer-ownership="none">
+					<type name="guint32" c:type="guint32"/>
+				</parameter>
+				<parameter name="end_stream" transfer-ownership="none">
+					<type name="gboolean" c:type="gboolean"/>
+				</parameter>
+				<parameter name="end_headers" transfer-ownership="none">
+					<type name="gboolean" c:type="gboolean"/>
+				</parameter>
+				<parameter name="header_block" transfer-ownership="none">
+					<type name="GLib.Bytes" c:type="GBytes*"/>
+				</parameter>
+			</parameters>
+		</method>
+		<method name="build_push_promise" c:identifier="gjsify_http2_frame_encoder_build_push_promise">
+			<return-value transfer-ownership="full">
+				<type name="GLib.Bytes" c:type="GBytes*"/>
+			</return-value>
+			<parameters>
+				<instance-parameter name="self" transfer-ownership="none">
+					<type name="GjsifyHttp2.FrameEncoder" c:type="GjsifyHttp2FrameEncoder*"/>
+				</instance-parameter>
+				<parameter name="associated_stream_id" transfer-ownership="none">
+					<type name="guint32" c:type="guint32"/>
+				</parameter>
+				<parameter name="promised_stream_id" transfer-ownership="none">
+					<type name="guint32" c:type="guint32"/>
+				</parameter>
+				<parameter name="header_block" transfer-ownership="none">
+					<type name="GLib.Bytes" c:type="GBytes*"/>
+				</parameter>
+			</parameters>
+		</method>
+		<method name="nghttp2_version" c:identifier="gjsify_http2_frame_encoder_nghttp2_version">
+			<return-value transfer-ownership="none">
+				<type name="utf8" c:type="const gchar*"/>
+			</return-value>
+			<parameters>
+				<instance-parameter name="self" transfer-ownership="none">
+					<type name="GjsifyHttp2.FrameEncoder" c:type="GjsifyHttp2FrameEncoder*"/>
+				</instance-parameter>
+			</parameters>
+		</method>
+		<constructor name="new" c:identifier="gjsify_http2_frame_encoder_new">
+			<return-value transfer-ownership="full">
+				<type name="GjsifyHttp2.FrameEncoder" c:type="GjsifyHttp2FrameEncoder*"/>
+			</return-value>
+		</constructor>
+	</class>
+	<record name="FrameEncoderClass" c:type="GjsifyHttp2FrameEncoderClass" glib:is-gtype-struct-for="FrameEncoder">
+		<field name="parent_class" readable="0" private="1">
+			<type name="GObject.ObjectClass" c:type="GObjectClass"/>
+		</field>
+	</record>
+	<record name="FrameEncoderPrivate" c:type="GjsifyHttp2FrameEncoderPrivate" disguised="1"/>
+	<class name="StreamIdAllocator" c:type="GjsifyHttp2StreamIdAllocator" c:symbol-prefix="stream_id_allocator" glib:type-name="GjsifyHttp2StreamIdAllocator" glib:get-type="gjsify_http2_stream_id_allocator_get_type" glib:type-struct="StreamIdAllocatorClass" parent="GObject.Object">
+		<field name="parent_instance" readable="0" private="1">
+			<type name="GObject.Object" c:type="GObject"/>
+		</field>
+		<field name="priv" readable="0" private="1">
+			<type name="StreamIdAllocatorPrivate" c:type="GjsifyHttp2StreamIdAllocatorPrivate*"/>
+		</field>
+		<constant name="MAX_STREAM_ID" c:identifier="GJSIFY_HTTP2_STREAM_ID_ALLOCATOR_MAX_STREAM_ID" value="0x7fffffff">
+			<type name="guint" c:type="guint"/>
+		</constant>
+		<method name="next_promised" c:identifier="gjsify_http2_stream_id_allocator_next_promised">
+			<return-value transfer-ownership="full">
+				<type name="guint32" c:type="guint32"/>
+			</return-value>
+			<parameters>
+				<instance-parameter name="self" transfer-ownership="none">
+					<type name="GjsifyHttp2.StreamIdAllocator" c:type="GjsifyHttp2StreamIdAllocator*"/>
+				</instance-parameter>
+			</parameters>
+		</method>
+		<method name="record_client_stream" c:identifier="gjsify_http2_stream_id_allocator_record_client_stream">
+			<return-value transfer-ownership="full">
+				<type name="none" c:type="void"/>
+			</return-value>
+			<parameters>
+				<instance-parameter name="self" transfer-ownership="none">
+					<type name="GjsifyHttp2.StreamIdAllocator" c:type="GjsifyHttp2StreamIdAllocator*"/>
+				</instance-parameter>
+				<parameter name="id" transfer-ownership="none">
+					<type name="guint32" c:type="guint32"/>
+				</parameter>
+			</parameters>
+		</method>
+		<constructor name="new" c:identifier="gjsify_http2_stream_id_allocator_new">
+			<return-value transfer-ownership="full">
+				<type name="GjsifyHttp2.StreamIdAllocator" c:type="GjsifyHttp2StreamIdAllocator*"/>
+			</return-value>
+		</constructor>
+		<property name="last-client-stream-id">
+			<type name="guint32" c:type="guint32"/>
+		</property>
+		<method name="get_last_client_stream_id" c:identifier="gjsify_http2_stream_id_allocator_get_last_client_stream_id">
+			<return-value transfer-ownership="none">
+				<type name="guint32" c:type="guint32"/>
+			</return-value>
+			<parameters>
+				<instance-parameter name="self" transfer-ownership="none">
+					<type name="GjsifyHttp2.StreamIdAllocator" c:type="GjsifyHttp2StreamIdAllocator*"/>
+				</instance-parameter>
+			</parameters>
+		</method>
+		<property name="remaining-pushes">
+			<type name="guint32" c:type="guint32"/>
+		</property>
+		<method name="get_remaining_pushes" c:identifier="gjsify_http2_stream_id_allocator_get_remaining_pushes">
+			<return-value transfer-ownership="none">
+				<type name="guint32" c:type="guint32"/>
+			</return-value>
+			<parameters>
+				<instance-parameter name="self" transfer-ownership="none">
+					<type name="GjsifyHttp2.StreamIdAllocator" c:type="GjsifyHttp2StreamIdAllocator*"/>
+				</instance-parameter>
+			</parameters>
+		</method>
+	</class>
+	<record name="StreamIdAllocatorClass" c:type="GjsifyHttp2StreamIdAllocatorClass" glib:is-gtype-struct-for="StreamIdAllocator">
+		<field name="parent_class" readable="0" private="1">
+			<type name="GObject.ObjectClass" c:type="GObjectClass"/>
+		</field>
+	</record>
+	<record name="StreamIdAllocatorPrivate" c:type="GjsifyHttp2StreamIdAllocatorPrivate" disguised="1"/>
+	<class name="SessionBridge" c:type="GjsifyHttp2SessionBridge" c:symbol-prefix="session_bridge" glib:type-name="GjsifyHttp2SessionBridge" glib:get-type="gjsify_http2_session_bridge_get_type" glib:type-struct="SessionBridgeClass" parent="GObject.Object">
+		<field name="parent_instance" readable="0" private="1">
+			<type name="GObject.Object" c:type="GObject"/>
+		</field>
+		<field name="priv" readable="0" private="1">
+			<type name="SessionBridgePrivate" c:type="GjsifyHttp2SessionBridgePrivate*"/>
+		</field>
+		<function name="is_client_preface" c:identifier="gjsify_http2_session_bridge_is_client_preface">
+			<return-value transfer-ownership="full">
+				<type name="gboolean" c:type="gboolean"/>
+			</return-value>
+			<parameters>
+				<parameter name="bytes" transfer-ownership="none" nullable="1">
+					<type name="GLib.Bytes" c:type="GBytes*"/>
+				</parameter>
+			</parameters>
+		</function>
+		<function name="preface_length" c:identifier="gjsify_http2_session_bridge_preface_length">
+			<return-value transfer-ownership="full">
+				<type name="guint" c:type="guint"/>
+			</return-value>
+		</function>
+		<constructor name="new" c:identifier="gjsify_http2_session_bridge_new">
+			<return-value transfer-ownership="full">
+				<type name="GjsifyHttp2.SessionBridge" c:type="GjsifyHttp2SessionBridge*"/>
+			</return-value>
+		</constructor>
+	</class>
+	<record name="SessionBridgeClass" c:type="GjsifyHttp2SessionBridgeClass" glib:is-gtype-struct-for="SessionBridge">
+		<field name="parent_class" readable="0" private="1">
+			<type name="GObject.ObjectClass" c:type="GObjectClass"/>
+		</field>
+	</record>
+	<record name="SessionBridgePrivate" c:type="GjsifyHttp2SessionBridgePrivate" disguised="1"/>
+</namespace>
+</repository>