@gjsify/fetch 0.36.0 → 0.37.0

package/lib/utils/root-relative.d.ts

@@ -1,23 +1,17 @@
 /**
- * Rewrite a root-relative URL (starts with `/` but not `//`, e.g.
- * `/res/images/foo.png`) to a `file://` URL under the given program path's
- * directory, so a GJS/GTK app loads bundled assets with the same paths a
- * browser would resolve against its origin.
+ * Rewrite a root-relative URL (starts with `/` but not `//`) to a `file://` URL under the
+ * program path's directory, so a GJS/GTK app loads bundled assets with the same paths a
+ * browser resolves against its origin. Returns the input unchanged when it is not
+ * root-relative or no usable program path is given.
  *
- * Returns the input unchanged when it is not root-relative or when no usable
- * program path is given. The security implications (arbitrary file reads) are
- * acceptable for the current use cases — revisit if these packages ever handle
- * untrusted input.
+ * The security implications (arbitrary file reads) are acceptable for the current use
+ * cases — revisit if these packages ever handle untrusted input.
  *
- * Deliberately no `GLib.path_get_dirname`: `@girs/glib-2.0` is emptied to `{}`
- * in a plain-Node bundle (only the gjs target and the reverse bridge resolve
- * it), so a GLib call here only ever "worked" behind a swallowing catch. The
- * program path is `/`-separated on every runtime this rewrite serves, making
- * dirname a string slice.
+ * Deliberately no `GLib.path_get_dirname`: `@girs/glib-2.0` is emptied to `{}` in a
+ * plain-Node bundle, so a GLib call here only ever "worked" behind a swallowing catch. The
+ * program path is `/`-separated on every runtime this serves, making dirname a slice.
  *
- * @param url The URL to rewrite.
- * @param programPath The running program's path (`System.programPath ??
- *   System.programInvocationName` on gjs; `process.argv[1]` — the bundle
- *   itself — on the node-gi reverse bridge).
+ * @param programPath `System.programPath ?? System.programInvocationName` on gjs;
+ *   `process.argv[1]` — the bundle itself — on the node-gi reverse bridge.
  */
 export declare function rewriteRootRelativeUrl(url: string, programPath: string): string;

package/lib/utils/root-relative.js

@@ -1,43 +1,29 @@
-// Root-relative URL → `file://` under the program directory.
+// Root-relative URL → `file://` under the program directory. THE one copy: `@gjsify/fetch`
+// and `@gjsify/xmlhttprequest` used to carry two spellings, and they drifted — the fetch
+// copy read `globalThis.imports.system` (GJS-only) while the XHR copy imported the `system`
+// built-in, so on the node-gi reverse bridge XHR-loaded assets resolved and every
+// root-relative `fetch()` died with `ERR_INVALID_URL` (#869).
 //
-// THE one copy of this rewrite. `@gjsify/fetch` and `@gjsify/xmlhttprequest`
-// used to carry two hand-written spellings of it, and the copies drifting is
-// exactly what broke: the fetch copy read `globalThis.imports.system` (GJS-only)
-// while the XHR copy imported the `system` built-in, so on the node-gi reverse
-// bridge every XHR-loaded asset resolved and every root-relative `fetch()` died
-// with `ERR_INVALID_URL` (#869 — the excalibur-jelly-jumper showcase rendered an
-// empty level because its Tiled map is the one asset fetched rather than XHR'd).
-//
-// This module is deliberately PURE — the program path is a PARAMETER, and the
-// `system` built-in is read one module over (`root-relative-system.ts`). The
-// split is load-bearing for cross-platform loadability: on `--app node` the
-// bare `system` specifier is aliased to `@gjsify/node-gi/system` and kept
-// EXTERNAL, so any module that imports it makes the emitted bundle hard-require
-// the node-gi bridge at load. `@gjsify/fetch` is a cross-platform package whose
-// node test bundle must load on plain Node — its spec therefore covers THIS
-// pure function on gjs AND node, while the `system` read stays confined to the
-// GJS-reachable wrapper.
+// Deliberately PURE — the program path is a PARAMETER and the `system` built-in is read one
+// module over (`root-relative-system.ts`). The split is load-bearing: on `--app node` the
+// bare `system` specifier is aliased to `@gjsify/node-gi/system` and kept EXTERNAL, so any
+// module importing it makes the bundle hard-require the bridge at load, and this package's
+// node test bundle must load on plain Node.
 /**
- * Rewrite a root-relative URL (starts with `/` but not `//`, e.g.
- * `/res/images/foo.png`) to a `file://` URL under the given program path's
- * directory, so a GJS/GTK app loads bundled assets with the same paths a
- * browser would resolve against its origin.
+ * Rewrite a root-relative URL (starts with `/` but not `//`) to a `file://` URL under the
+ * program path's directory, so a GJS/GTK app loads bundled assets with the same paths a
+ * browser resolves against its origin. Returns the input unchanged when it is not
+ * root-relative or no usable program path is given.
  *
- * Returns the input unchanged when it is not root-relative or when no usable
- * program path is given. The security implications (arbitrary file reads) are
- * acceptable for the current use cases — revisit if these packages ever handle
- * untrusted input.
+ * The security implications (arbitrary file reads) are acceptable for the current use
+ * cases — revisit if these packages ever handle untrusted input.
  *
- * Deliberately no `GLib.path_get_dirname`: `@girs/glib-2.0` is emptied to `{}`
- * in a plain-Node bundle (only the gjs target and the reverse bridge resolve
- * it), so a GLib call here only ever "worked" behind a swallowing catch. The
- * program path is `/`-separated on every runtime this rewrite serves, making
- * dirname a string slice.
+ * Deliberately no `GLib.path_get_dirname`: `@girs/glib-2.0` is emptied to `{}` in a
+ * plain-Node bundle, so a GLib call here only ever "worked" behind a swallowing catch. The
+ * program path is `/`-separated on every runtime this serves, making dirname a slice.
  *
- * @param url The URL to rewrite.
- * @param programPath The running program's path (`System.programPath ??
- *   System.programInvocationName` on gjs; `process.argv[1]` — the bundle
- *   itself — on the node-gi reverse bridge).
+ * @param programPath `System.programPath ?? System.programInvocationName` on gjs;
+ *   `process.argv[1]` — the bundle itself — on the node-gi reverse bridge.
  */
 export function rewriteRootRelativeUrl(url, programPath) {
     if (!url.startsWith('/') || url.startsWith('//'))

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/fetch",
-    "version": "0.36.0",
+    "version": "0.37.0",
     "description": "Web and Node.js fetch module for Gjs",
     "module": "lib/esm/index.js",
     "types": "lib/index.d.ts",
@@ -51,8 +51,8 @@
         "fetch"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.36.0",
-        "@gjsify/unit": "^0.36.0",
+        "@gjsify/cli": "^0.37.0",
+        "@gjsify/unit": "^0.37.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
@@ -61,11 +61,11 @@
         "@girs/gjs": "^4.1.0",
         "@girs/glib-2.0": "^4.1.0",
         "@girs/soup-3.0": "^4.1.0",
-        "@gjsify/dom-events": "^0.36.0",
-        "@gjsify/formdata": "^0.36.0",
-        "@gjsify/http": "^0.36.0",
-        "@gjsify/url": "^0.36.0",
-        "@gjsify/utils": "^0.36.0"
+        "@gjsify/dom-events": "^0.37.0",
+        "@gjsify/formdata": "^0.37.0",
+        "@gjsify/http": "^0.37.0",
+        "@gjsify/url": "^0.37.0",
+        "@gjsify/utils": "^0.37.0"
     },
     "gjsify": {
         "runtimes": {