hyperframes 0.6.74 → 0.6.76

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.6.74" : "0.0.0-dev";
+    VERSION = true ? "0.6.76" : "0.0.0-dev";
   }
 });
 
@@ -62042,21 +62042,33 @@ var init_manager2 = __esm({
   }
 });
 
-// ../engine/src/config.ts
+// ../engine/src/services/systemMemory.ts
 import { totalmem as totalmem2 } from "os";
 function getSystemTotalMb() {
   return Math.floor(totalmem2() / (1024 * 1024));
 }
+function isLowMemorySystem(totalMb = getSystemTotalMb()) {
+  return totalMb <= LOW_MEMORY_TOTAL_MB_THRESHOLD;
+}
+var LOW_MEMORY_TOTAL_MB_THRESHOLD;
+var init_systemMemory = __esm({
+  "../engine/src/services/systemMemory.ts"() {
+    "use strict";
+    LOW_MEMORY_TOTAL_MB_THRESHOLD = 8192;
+  }
+});
+
+// ../engine/src/config.ts
 function memoryAdaptiveCacheLimit() {
   const total = getSystemTotalMb();
   if (total < 4096) return 32;
-  if (total <= 8192) return 64;
+  if (total <= LOW_MEMORY_TOTAL_MB_THRESHOLD) return 64;
   return DEFAULT_CONFIG2.frameDataUriCacheLimit;
 }
 function memoryAdaptiveCacheBytesMb() {
   const total = getSystemTotalMb();
   if (total < 4096) return 128;
-  if (total <= 8192) return 256;
+  if (total <= LOW_MEMORY_TOTAL_MB_THRESHOLD) return 256;
   return DEFAULT_CONFIG2.frameDataUriCacheBytesLimitMb;
 }
 function resolveConfig(overrides) {
@@ -62077,6 +62089,12 @@ function resolveConfig(overrides) {
     if (raw === "hardware" || raw === "software" || raw === "auto") return raw;
     return DEFAULT_CONFIG2.browserGpuMode;
   };
+  const resolveLowMemoryMode = () => {
+    const raw = env("PRODUCER_LOW_MEMORY_MODE")?.toLowerCase();
+    if (raw === "true" || raw === "on" || raw === "1") return true;
+    if (raw === "false" || raw === "off" || raw === "0") return false;
+    return isLowMemorySystem();
+  };
   const fromEnv = {
     concurrency: env("PRODUCER_MAX_WORKERS") ? Number(env("PRODUCER_MAX_WORKERS")) : void 0,
     coresPerWorker: envNum("PRODUCER_CORES_PER_WORKER", DEFAULT_CONFIG2.coresPerWorker),
@@ -62096,6 +62114,7 @@ function resolveConfig(overrides) {
     ),
     expectedChromiumMajor: env("PRODUCER_EXPECTED_CHROMIUM_MAJOR") ? Number(env("PRODUCER_EXPECTED_CHROMIUM_MAJOR")) : void 0,
     forceScreenshot: envBool("PRODUCER_FORCE_SCREENSHOT", DEFAULT_CONFIG2.forceScreenshot),
+    lowMemoryMode: resolveLowMemoryMode(),
     enablePageSideCompositing: envBool(
       "HF_PAGE_SIDE_COMPOSITING",
       DEFAULT_CONFIG2.enablePageSideCompositing
@@ -62167,6 +62186,7 @@ var DEFAULT_CONFIG2;
 var init_config2 = __esm({
   "../engine/src/config.ts"() {
     "use strict";
+    init_systemMemory();
     DEFAULT_CONFIG2 = {
       fps: 30,
       quality: "standard",
@@ -62182,6 +62202,9 @@ var init_config2 = __esm({
       browserTimeout: 12e4,
       protocolTimeout: 3e5,
       forceScreenshot: false,
+      // Auto-detected per host in `resolveConfig`; defaults off for the raw
+      // DEFAULT_CONFIG (used directly by tests and worker-sizing fallbacks).
+      lowMemoryMode: false,
       enablePageSideCompositing: true,
       enableChunkedEncode: false,
       chunkSizeFrames: 360,
@@ -62208,7 +62231,7 @@ var init_config2 = __esm({
 import { execSync as execSync4 } from "child_process";
 import { existsSync as existsSync19, readdirSync as readdirSync9 } from "fs";
 import { join as join23 } from "path";
-import { homedir as homedir6, totalmem as totalmem3 } from "os";
+import { homedir as homedir6 } from "os";
 async function getPuppeteer() {
   if (_puppeteer) return _puppeteer;
   try {
@@ -62402,6 +62425,10 @@ async function launchBrowser(chromeArgs, config) {
     timeout: browserTimeout,
     protocolTimeout
   });
+  const browserVersion = await browser.version().catch(() => "unknown");
+  console.log(
+    `[BrowserManager] Browser launched (${browserVersion}, ${captureMode}, headlessShell=${!!headlessShell}, platform=${process.platform})`
+  );
   if (captureMode === "beginframe") {
     const supported = await probeBeginFrameSupport(browser).catch(() => true);
     if (!supported) {
@@ -62480,9 +62507,6 @@ async function drainBrowserPool() {
     });
   }
 }
-function getTotalMemMb() {
-  return Math.floor(totalmem3() / (1024 * 1024));
-}
 function probeNvidiaVramMb() {
   if (_cachedVramMb !== null) return _cachedVramMb;
   try {
@@ -62503,14 +62527,14 @@ function probeNvidiaVramMb() {
 function getGpuMemBudgetMb() {
   const vram = probeNvidiaVramMb();
   if (vram) return Math.min(vram, 16384);
-  const total = getTotalMemMb();
+  const total = getSystemTotalMb();
   if (total < 4096) return 512;
-  if (total <= 8192) return 1024;
+  if (total <= LOW_MEMORY_TOTAL_MB_THRESHOLD) return 1024;
   return Math.min(Math.floor(total / 2), 16384);
 }
 function getLowMemoryFlags() {
-  const total = getTotalMemMb();
-  if (total > 8192) return [];
+  const total = getSystemTotalMb();
+  if (total > LOW_MEMORY_TOTAL_MB_THRESHOLD) return [];
   const heapMb = total < 4096 ? 256 : 512;
   return [`--js-flags=--max-old-space-size=${heapMb}`];
 }
@@ -62606,6 +62630,7 @@ var init_browserManager = __esm({
   "../engine/src/services/browserManager.ts"() {
     "use strict";
     init_config2();
+    init_systemMemory();
     pooledBrowser = null;
     pooledBrowserRefCount = 0;
     pooledCaptureMode = "screenshot";
@@ -63305,17 +63330,26 @@ async function initializeSession(session) {
   });
   const url = `${serverUrl}/index.html`;
   const pageNavigationTimeout = session.config?.pageNavigationTimeout ?? DEFAULT_CONFIG2.pageNavigationTimeout;
+  const initStart = Date.now();
+  const logInitPhase = (phase) => {
+    console.log(`[initSession:${session.captureMode}] ${phase} (${Date.now() - initStart}ms)`);
+  };
   if (session.captureMode === "screenshot") {
     await page.goto(url, { waitUntil: "domcontentloaded", timeout: pageNavigationTimeout });
+    logInitPhase("page.goto complete");
     const pageReadyTimeout2 = session.config?.playerReadyTimeout ?? DEFAULT_CONFIG2.playerReadyTimeout;
     await pollHfReady(page, pageReadyTimeout2);
+    logInitPhase("pollHfReady complete");
     await pollSubCompositionTimelines(page, pageReadyTimeout2);
+    logInitPhase("pollSubCompositionTimelines complete");
     await applyVideoMetadataHints(page, session.options.videoMetadataHints);
+    logInitPhase("applyVideoMetadataHints complete");
     const videosReady = await pollVideosReady(
       page,
       session.options.skipReadinessVideoIds ?? [],
       pageReadyTimeout2
     );
+    logInitPhase("pollVideosReady complete");
     if (!videosReady) {
       const failedVideos = await page.evaluate((skipIdList) => {
         const skip = new Set(skipIdList);
@@ -63340,8 +63374,11 @@ async function initializeSession(session) {
       );
     }
     await decodeAllImages(page);
+    logInitPhase("images ready + decoded");
     await page.evaluate(`document.fonts?.ready`);
+    logInitPhase("fonts ready");
     await waitForOptionalTailwindReady(page, pageReadyTimeout2);
+    logInitPhase("tailwind ready");
     if (session.options.format === "png") {
       await initTransparentBackground(session.page);
     }
@@ -63384,16 +63421,21 @@ async function initializeSession(session) {
   })();
   warmupLoopPromise.catch(() => {
   });
+  logInitPhase("warmup loop started");
   await page.goto(url, { waitUntil: "domcontentloaded", timeout: pageNavigationTimeout });
+  logInitPhase("page.goto complete");
   const pageReadyTimeout = session.config?.playerReadyTimeout ?? DEFAULT_CONFIG2.playerReadyTimeout;
   try {
     await pollHfReady(page, pageReadyTimeout);
+    logInitPhase("pollHfReady complete");
   } catch (err) {
     warmupState.running = false;
     throw err;
   }
   await pollSubCompositionTimelines(page, pageReadyTimeout);
+  logInitPhase("pollSubCompositionTimelines complete");
   await applyVideoMetadataHints(page, session.options.videoMetadataHints);
+  logInitPhase("applyVideoMetadataHints complete");
   const bfVideosReady = await pollVideosReady(
     page,
     session.options.skipReadinessVideoIds ?? [],
@@ -63408,6 +63450,7 @@ async function initializeSession(session) {
       `[FrameCapture] Some video elements did not decode within ${pageReadyTimeout}ms: ${failedVideos}. Continuing render \u2014 affected videos will appear as blank/black frames.`
     );
   }
+  logInitPhase("pollVideosReady complete");
   const bfImagesReady = await pollImagesReady(page, pageReadyTimeout);
   if (!bfImagesReady) {
     const failedImages = await page.evaluate(() => {
@@ -63423,8 +63466,11 @@ async function initializeSession(session) {
     );
   }
   await decodeAllImages(page);
+  logInitPhase("images ready + decoded");
   await page.evaluate(`document.fonts?.ready`);
+  logInitPhase("fonts ready");
   await waitForOptionalTailwindReady(page, pageReadyTimeout);
+  logInitPhase("tailwind ready");
   warmupState.running = false;
   if (lockWarmupTicks) {
     await warmupLoopPromise.catch(() => {
@@ -68579,7 +68625,7 @@ var init_readWebGlVendorInfoFromCanvas = __esm({
 });
 
 // ../engine/src/services/parallelCoordinator.ts
-import { cpus as cpus2, freemem as freemem3, totalmem as totalmem4 } from "os";
+import { cpus as cpus2, freemem as freemem3, totalmem as totalmem3 } from "os";
 import { existsSync as existsSync28, mkdirSync as mkdirSync17, readdirSync as readdirSync13 } from "fs";
 import { copyFile, rename } from "fs/promises";
 import { join as join31 } from "path";
@@ -68604,7 +68650,7 @@ function calculateOptimalWorkers(totalFrames, requested, config) {
   if (totalFrames < MIN_FRAMES_PER_WORKER * 2) return 1;
   const cpuCount = cpus2().length;
   const cpuBasedWorkers = Math.max(1, cpuCount - 2);
-  const totalMemoryMB = Math.round(totalmem4() / (1024 * 1024));
+  const totalMemoryMB = Math.round(totalmem3() / (1024 * 1024));
   const memoryBasedWorkers = Math.max(1, Math.floor(totalMemoryMB * 0.5 / MEMORY_PER_WORKER_MB));
   const frameBasedWorkers = Math.floor(totalFrames / MIN_FRAMES_PER_WORKER);
   const optimal = Math.min(cpuBasedWorkers, memoryBasedWorkers, frameBasedWorkers);
@@ -68782,7 +68828,7 @@ async function mergeWorkerFrames(workDir, tasks, outputDir) {
 function getSystemResources() {
   return {
     cpuCores: cpus2().length,
-    totalMemoryMB: Math.round(totalmem4() / (1024 * 1024)),
+    totalMemoryMB: Math.round(totalmem3() / (1024 * 1024)),
     freeMemoryMB: Math.round(freemem3() / (1024 * 1024)),
     recommendedWorkers: calculateOptimalWorkers(1e3)
   };
@@ -70357,6 +70403,7 @@ __export(src_exports2, {
   ENABLE_BROWSER_POOL: () => ENABLE_BROWSER_POOL,
   ENCODER_PRESETS: () => ENCODER_PRESETS,
   FrameLookupTable: () => FrameLookupTable,
+  LOW_MEMORY_TOTAL_MB_THRESHOLD: () => LOW_MEMORY_TOTAL_MB_THRESHOLD,
   MEDIA_VISUAL_STYLE_PROPERTIES: () => MEDIA_VISUAL_STYLE_PROPERTIES,
   SwiftShaderAssertionError: () => SwiftShaderAssertionError,
   TRANSITIONS: () => TRANSITIONS,
@@ -70412,6 +70459,7 @@ __export(src_exports2, {
   getFrameAtTime: () => getFrameAtTime,
   getHdrEncoderColorParams: () => getHdrEncoderColorParams,
   getSystemResources: () => getSystemResources,
+  getSystemTotalMb: () => getSystemTotalMb,
   groupIntoLayers: () => groupIntoLayers,
   hdrToLinear: () => hdrToLinear,
   hideVideoElements: () => hideVideoElements,
@@ -70421,6 +70469,7 @@ __export(src_exports2, {
   injectVideoFramesBatch: () => injectVideoFramesBatch,
   isHdrColorSpace: () => isHdrColorSpace,
   isHttpUrl: () => isHttpUrl,
+  isLowMemorySystem: () => isLowMemorySystem,
   killTrackedProcesses: () => killTrackedProcesses,
   launchHdrBrowser: () => launchHdrBrowser,
   linearToHdr: () => linearToHdr,
@@ -70459,6 +70508,7 @@ var init_src2 = __esm({
   "../engine/src/index.ts"() {
     "use strict";
     init_config2();
+    init_systemMemory();
     init_browserManager();
     init_frameCapture();
     init_screenshotService();
@@ -72130,6 +72180,12 @@ function resolveRenderWorkerCount(totalFrames, requestedWorkers, cfg, compiled,
     );
     return 1;
   }
+  if (cfg.lowMemoryMode && requestedWorkers === void 0) {
+    log2.info(
+      "[Render] Low-memory profile \u2014 pinning to 1 capture worker (auto-worker calibration skipped)."
+    );
+    return 1;
+  }
   const captureCost = combineCaptureCostEstimates(
     estimateCaptureCostMultiplier(compiled),
     measuredCaptureCost
@@ -72158,7 +72214,7 @@ function resolveRenderWorkerCount(totalFrames, requestedWorkers, cfg, compiled,
 function createCaptureCalibrationConfig(cfg) {
   return {
     ...cfg,
-    protocolTimeout: Math.max(cfg.protocolTimeout, CAPTURE_CALIBRATION_PROTOCOL_TIMEOUT_MS)
+    protocolTimeout: Math.min(cfg.protocolTimeout, CAPTURE_CALIBRATION_PROTOCOL_TIMEOUT_MS)
   };
 }
 function estimateMeasuredCaptureCostMultiplier(samples) {
@@ -72290,6 +72346,12 @@ async function runCaptureCalibration(input2) {
     return result;
   };
   const calibrationCfg = createCaptureCalibrationConfig({ ...cfg, forceScreenshot });
+  log2.info("[Render] Calibration config", {
+    protocolTimeout: calibrationCfg.protocolTimeout,
+    parentProtocolTimeout: cfg.protocolTimeout,
+    forceScreenshot,
+    totalFrames
+  });
   let calibration;
   try {
     calibration = await runOneCalibration(join38(workDir, "capture-calibration"), calibrationCfg);
@@ -76531,6 +76593,20 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     };
     job.startedAt = /* @__PURE__ */ new Date();
     assertNotAborted();
+    log2.info("[Render] Pipeline started", {
+      platform: process.platform,
+      arch: process.arch,
+      nodeVersion: process.version,
+      fps: job.config.fps,
+      format: outputFormat,
+      quality: job.config.quality,
+      browserGpuMode: cfg.browserGpuMode,
+      forceScreenshot: cfg.forceScreenshot,
+      protocolTimeout: cfg.protocolTimeout,
+      browserTimeout: cfg.browserTimeout,
+      pageNavigationTimeout: cfg.pageNavigationTimeout,
+      playerReadyTimeout: cfg.playerReadyTimeout
+    });
     if (!existsSync40(workDir)) mkdirSync24(workDir, { recursive: true });
     if (job.config.debug) {
       const logPath = join50(workDir, "render.log");
@@ -76585,6 +76661,13 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     const { width, height } = composition;
     perfStages.compileOnlyMs = compileResult.compileOnlyMs;
     let captureForceScreenshot = compileResult.forceScreenshot;
+    if (cfg.lowMemoryMode) {
+      captureForceScreenshot = true;
+      log2.info(
+        "[Render] Low-memory render profile active \u2014 screenshot capture, auto-worker calibration skipped" + (job.config.workers === void 0 ? ", pinned to 1 worker" : "") + ". Override with --no-low-memory-mode or PRODUCER_LOW_MEMORY_MODE=false.",
+        { totalMemMb: getSystemTotalMb(), thresholdMb: LOW_MEMORY_TOTAL_MB_THRESHOLD }
+      );
+    }
     const probeResult = await runProbeStage({
       projectDir,
       workDir,
@@ -76689,7 +76772,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     const htmlInCanvasDetected = compiled.renderModeHints.reasons.some(
       (r2) => r2.code === "htmlInCanvas"
     );
-    if (job.config.workers === void 0 && totalFrames >= 60 && !htmlInCanvasDetected) {
+    if (job.config.workers === void 0 && totalFrames >= 60 && !htmlInCanvasDetected && !cfg.lowMemoryMode) {
       const outcome = await runCaptureCalibration({
         cfg,
         fileServer,
@@ -77006,6 +77089,16 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       perfStages,
       hdrDiagnostics
     });
+    log2.info("[Render] Failure summary", {
+      failedStage: job.currentStage,
+      error: errorMessage,
+      elapsedMs: Date.now() - pipelineStart,
+      stageTimings: perfStages,
+      isTimeout: isTimeoutError,
+      workers: job.config.workers ?? "auto",
+      protocolTimeout: cfg.protocolTimeout,
+      browserConsoleErrors: lastBrowserConsole.filter((l) => l.includes("ERROR") || l.includes("PAGEERROR")).slice(-5)
+    });
     await cleanupRenderResources({
       fileServer,
       probeSession,
@@ -83467,6 +83560,10 @@ var init_render2 = __esm({
         "player-ready-timeout": {
           type: "string",
           description: "Timeout in ms for the composition player to become ready. Increase for complex compositions on slow hardware. Default: 45000 (45 s). Env: PRODUCER_PLAYER_READY_TIMEOUT_MS."
+        },
+        "low-memory-mode": {
+          type: "boolean",
+          description: "Force the low-memory safe render profile on (--low-memory-mode) or off (--no-low-memory-mode). Safe mode pins to 1 worker, uses screenshot capture, and skips auto-worker calibration to avoid memory thrash on constrained machines. Default: auto-detected from total RAM (<= 8 GB). Env: PRODUCER_LOW_MEMORY_MODE."
         }
       },
       // `run` is the citty handler for `hyperframes render` — sequential flag
@@ -83550,6 +83647,9 @@ var init_render2 = __esm({
         if (args["page-side-compositing"] === false) {
           process.env.HF_PAGE_SIDE_COMPOSITING = "false";
         }
+        if (args["low-memory-mode"] != null) {
+          process.env.PRODUCER_LOW_MEMORY_MODE = args["low-memory-mode"] ? "true" : "false";
+        }
         if (args["max-concurrent-renders"] != null) {
           const parsed = parseInt(args["max-concurrent-renders"], 10);
           if (isNaN(parsed) || parsed < 1 || parsed > 10) {
@@ -127970,35 +128070,71 @@ async function downloadAndRewriteFonts(css, outputDir) {
   }
   return rewritten;
 }
+function isPrivateIpv4(host) {
+  const octets = host.split(".").map(Number);
+  if (octets.length !== 4) return false;
+  const [a, b2] = octets;
+  return PRIVATE_V4_BLOCKS.some(([first, lo, hi]) => a === first && b2 >= lo && b2 <= hi);
+}
+function isPrivateIpv6(bracketed) {
+  const addr = bracketed.replace(/^\[|\]$/g, "").toLowerCase();
+  if (addr === "::1" || addr === "::") return true;
+  const mapped = /^::ffff:(.+)$/.exec(addr);
+  if (mapped) {
+    const tail = mapped[1];
+    if (tail.includes(".")) return isPrivateIpv4(tail);
+    const hex = tail.split(":");
+    if (hex.length === 2) {
+      const n = (parseInt(hex[0], 16) << 16 | parseInt(hex[1], 16)) >>> 0;
+      return isPrivateIpv4(
+        [n >>> 24 & 255, n >>> 16 & 255, n >>> 8 & 255, n & 255].join(".")
+      );
+    }
+  }
+  if (/^f[cd]/.test(addr)) return true;
+  if (/^fe[89ab]/.test(addr)) return true;
+  return false;
+}
 function isPrivateUrl(url) {
   try {
-    const { hostname } = new URL(url);
-    if (hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]") return true;
-    if (hostname === "169.254.169.254") return true;
+    const u = new URL(url);
+    if (u.protocol !== "http:" && u.protocol !== "https:") return true;
+    const hostname = u.hostname;
+    if (hostname === "localhost") return true;
     if (hostname.endsWith(".internal") || hostname.endsWith(".local")) return true;
-    const parts = hostname.split(".").map(Number);
-    if (parts.length === 4 && parts.every((p2) => !isNaN(p2))) {
-      if (parts[0] === 10) return true;
-      if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31) return true;
-      if (parts[0] === 192 && parts[1] === 168) return true;
-      if (parts[0] === 169 && parts[1] === 254) return true;
-    }
-    const scheme = new URL(url).protocol;
-    if (scheme !== "http:" && scheme !== "https:") return true;
+    if (hostname.startsWith("[")) return isPrivateIpv6(hostname);
+    if (/^\d+(\.\d+){3}$/.test(hostname)) return isPrivateIpv4(hostname);
     return false;
   } catch {
     return true;
   }
 }
+async function safeFetch(url, init) {
+  let current = url;
+  for (let hop = 0; hop <= MAX_FETCH_REDIRECTS; hop++) {
+    if (isPrivateUrl(current)) return null;
+    const res = await fetch(current, { ...init, redirect: "manual" });
+    if (res.status >= 300 && res.status < 400) {
+      const loc = res.headers.get("location");
+      if (!loc) return res;
+      try {
+        current = new URL(loc, current).toString();
+      } catch {
+        return null;
+      }
+      continue;
+    }
+    return res;
+  }
+  return null;
+}
 async function fetchBuffer(url) {
   try {
-    if (isPrivateUrl(url)) return null;
-    const res = await fetch(url, {
+    const res = await safeFetch(url, {
       signal: AbortSignal.timeout(1e4),
-      headers: { "User-Agent": "HyperFrames/1.0" },
-      redirect: "follow"
+      headers: { "User-Agent": "HyperFrames/1.0" }
     });
-    if (!res.ok) return null;
+    if (!res || !res.ok) return null;
     const ct2 = res.headers.get("content-type") || "";
     if (ct2.includes("text/xml") || ct2.includes("text/html") || ct2.includes("application/xml")) {
       return null;
@@ -128046,9 +128182,25 @@ function deriveAssetName(parsedUrl, catalog, isPoster, idx, usedNames) {
   }
   return final;
 }
+var PRIVATE_V4_BLOCKS, MAX_FETCH_REDIRECTS;
 var init_assetDownloader = __esm({
   "src/capture/assetDownloader.ts"() {
     "use strict";
+    PRIVATE_V4_BLOCKS = [
+      [0, 0, 255],
+      // 0.0.0.0/8 (incl. 0.0.0.0, which routes to localhost)
+      [10, 0, 255],
+      // 10.0.0.0/8
+      [127, 0, 255],
+      // 127.0.0.0/8 loopback
+      [172, 16, 31],
+      // 172.16.0.0/12
+      [192, 168, 168],
+      // 192.168.0.0/16
+      [169, 254, 254]
+      // 169.254.0.0/16 link-local (cloud metadata)
+    ];
+    MAX_FETCH_REDIRECTS = 5;
   }
 });
 
@@ -129245,12 +129397,11 @@ async function saveLottieAnimations(discoveredLotties, lottieDir) {
       if (lottieItem.data) {
         jsonData = JSON.stringify(lottieItem.data);
       } else if (lottieItem.url) {
-        if (isPrivateUrl(lottieItem.url)) continue;
-        const res = await fetch(lottieItem.url, {
+        const res = await safeFetch(lottieItem.url, {
           signal: AbortSignal.timeout(1e4),
           headers: { "User-Agent": "HyperFrames/1.0" }
         });
-        if (!res.ok) continue;
+        if (!res || !res.ok) continue;
         const buf = Buffer.from(await res.arrayBuffer());
         if (lottieItem.url.endsWith(".lottie")) {
           try {