@gjsify/tls 0.35.0 → 0.37.0

package/lib/types/session-access.d.ts

@@ -2,37 +2,19 @@ import { TlsChannelBindingType as _TlsChannelBindingType, type NativeSessionAcce
 export { TlsChannelBindingType } from '@gjsify/tls-native';
 export type { NativeSessionAccess, TlsConnectionHandle } from '@gjsify/tls-native';
 /**
- * Returns `true` when the @gjsify/tls-native Phase 2 session-access
- * bridge is loaded AND functional. Today this returns `false` even
- * on GJS with the typelib installed — the underlying gnutls_session_t
- * extraction from `Gio.TlsConnection` is not yet implemented
- * (`docs/poc/tls-phase2-session-access.md`).
- *
- * Use this predicate to detect "session-resumption / channel-binding
- * available on this runtime" without triggering a thrown error. When
- * it returns `false`:
- *
- *   - `TLSSocket.getFinished()` / `getPeerFinished()` return `undefined`.
- *   - `TLSSocket.getSession()` returns `undefined`.
- *   - `TLSSocket.setSession()` / `tls.connect({session})` silently
- *     skip the resumption attempt (full handshake instead).
- *   - The `'session'` event never fires.
- *
- * This matches Node's behavior on a build without OpenSSL session
- * support — present API surface, no-op when unavailable.
+ * Returns `true` when the native bridge is loaded AND the GIO TLS backend is
+ * GnuTLS, whose private `gnutls_session_t` the shim reads. `false` on Node and
+ * on any other backend, where the surface degrades exactly as Node's does
+ * without OpenSSL session support: `getFinished`/`getPeerFinished`/`getSession`
+ * return `undefined`, `setSession`/`connect({session})` skip the resumption
+ * attempt, and `'session'` never fires.
  */
 export declare function hasTlsSessionAccess(): boolean;
 /**
- * Internal: build a {@link NativeSessionAccess} wrapper around a live
- * `Gio.TlsConnection`. Returns `null` when the native typelib isn't
- * loaded OR @connection is `null`. The returned wrapper's methods
- * may throw — callers must wrap in `try/catch` AND check
- * `hasTlsSessionAccess()` first.
+ * `null` when the native typelib isn't loaded or @connection is `null`. The
+ * wrapper's methods may throw — check `hasTlsSessionAccess()` AND catch.
  *
- * @internal — used by `TLSSocket` and `connect.ts`. Public consumers
- * should rely on the Node-shaped getters/setters on `TLSSocket`.
+ * @internal — public consumers use the Node-shaped `TLSSocket` accessors.
  */
 export declare function createSessionAccess(connection: _TlsConnectionHandle | null): _NativeSessionAccess | null;
-/** Re-export for code that wants the channel-binding type constants
- *  without importing through the native package directly. */
 export { _TlsChannelBindingType };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/tls",
-    "version": "0.35.0",
+    "version": "0.37.0",
     "description": "Node.js tls module for Gjs",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -37,17 +37,17 @@
         "tls"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.35.0",
-        "@gjsify/unit": "^0.35.0",
+        "@gjsify/cli": "^0.37.0",
+        "@gjsify/unit": "^0.37.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
     "dependencies": {
         "@girs/gio-2.0": "^4.1.0",
         "@girs/glib-2.0": "^4.1.0",
-        "@gjsify/net": "^0.35.0",
-        "@gjsify/tls-native": "^0.35.0",
-        "@gjsify/utils": "^0.35.0"
+        "@gjsify/net": "^0.37.0",
+        "@gjsify/tls-native": "^0.37.0",
+        "@gjsify/utils": "^0.37.0"
     },
     "gjsify": {
         "runtimes": {