@xhub-short/adapters 1.0.0-beta.26 → 1.0.0-beta.27

package/dist/index.d.ts

@@ -1672,6 +1672,14 @@ declare class BrowserVideoLoader implements IVideoLoader {
      * Full segment preload requires hls.js which is optional
      */
     private preloadHLS;
+    /**
+     * Parse M3U8 manifest and pre-fetch the first N segments into the Cache API.
+     * Runs concurrently for speed; tolerates individual segment fetch failures.
+     *
+     * Resolves relative segment paths against the manifest URL base.
+     * Only runs when a cache is available - gracefully no-ops otherwise.
+     */
+    private preloadHLSSegments;
     /**
      * Cancel preload
      */

package/dist/index.js

@@ -4196,11 +4196,42 @@ var BrowserVideoLoader = class {
    * Full segment preload requires hls.js which is optional
    */
   async preloadHLS(url, signal) {
+    const _isDev = globalThis.process?.env?.NODE_ENV !== "production";
+    const _t0 = _isDev ? performance.now() : 0;
+    if (_isDev) {
+      performance.mark("sv-preload:hls:start");
+      console.debug(
+        "%c\u{1F504} [HLS Preload] manifest fetch start",
+        "color:#7c3aed;font-size:11px;",
+        url.slice(url.lastIndexOf("/") + 1).slice(0, 60)
+      );
+    }
     const response = await fetch(url, { signal });
     if (!response.ok) {
       throw new Error(`HTTP error: ${response.status}`);
     }
     const text = await response.text();
+    if (_isDev) {
+      performance.mark("sv-preload:hls:done");
+      try {
+        performance.measure(
+          "sv-preload:hls:manifest",
+          "sv-preload:hls:start",
+          "sv-preload:hls:done"
+        );
+      } catch {
+      }
+      const segCount = text.split("\n").filter(
+        (l) => l.endsWith(".ts") || l.endsWith(".m4s") || l.includes(".ts?") || l.includes(".m4s?")
+      ).length;
+      console.debug(
+        "%c\u2705 [HLS Preload] manifest done",
+        "color:#059669;font-size:11px;",
+        `+${(performance.now() - _t0).toFixed(0)}ms`,
+        `${text.length} bytes`,
+        `segments: ${segCount}`
+      );
+    }
     if (this.cache) {
       try {
         const cacheResponse = new Response(text, {
@@ -4212,8 +4243,50 @@ var BrowserVideoLoader = class {
       } catch {
       }
     }
+    await this.preloadHLSSegments(url, text, signal);
     return text.length;
   }
+  /**
+   * Parse M3U8 manifest and pre-fetch the first N segments into the Cache API.
+   * Runs concurrently for speed; tolerates individual segment fetch failures.
+   *
+   * Resolves relative segment paths against the manifest URL base.
+   * Only runs when a cache is available - gracefully no-ops otherwise.
+   */
+  async preloadHLSSegments(manifestUrl, manifestText, signal, maxSegments = 3) {
+    if (!this.cache) return;
+    const baseUrl = manifestUrl.substring(0, manifestUrl.lastIndexOf("/") + 1);
+    const segmentUrls = manifestText.split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith("#")).slice(0, maxSegments).map((l) => l.startsWith("http") ? l : `${baseUrl}${l}`);
+    if (segmentUrls.length === 0) return;
+    const _isDev = globalThis.process?.env?.NODE_ENV !== "production";
+    if (_isDev) {
+      console.debug(
+        "%c\u{1F4E6} [HLS Preload] fetching first segments",
+        "color:#7c3aed;font-size:11px;",
+        segmentUrls.map((u) => u.slice(u.lastIndexOf("/") + 1).slice(0, 40))
+      );
+    }
+    const cache = this.cache;
+    await Promise.allSettled(
+      segmentUrls.map(async (segUrl) => {
+        const existing = await cache.match(segUrl);
+        if (existing) return;
+        const segResponse = await fetch(segUrl, { signal });
+        if (segResponse.ok) {
+          await cache.put(segUrl, segResponse.clone());
+          if (_isDev) {
+            const size = Number(segResponse.headers.get("content-length") ?? 0);
+            console.debug(
+              "%c  \u2713 segment cached",
+              "color:#059669;font-size:11px;",
+              segUrl.slice(segUrl.lastIndexOf("/") + 1).slice(0, 50),
+              size ? `${(size / 1024).toFixed(0)}KB` : ""
+            );
+          }
+        }
+      })
+    );
+  }
   /**
    * Cancel preload
    */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xhub-short/adapters",
   "sideEffects": false,
-  "version": "1.0.0-beta.26",
+  "version": "1.0.0-beta.27",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -20,7 +20,7 @@
     "dist"
   ],
   "dependencies": {
-    "@xhub-short/contracts": "1.0.0-beta.26"
+    "@xhub-short/contracts": "1.0.0-beta.27"
   },
   "optionalDependencies": {
     "hls.js": "^1.5.0"