open-nami 1.0.4 → 1.0.6

package/dist/cli.js

@@ -9,8 +9,8 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "open-nami",
-      version: "1.0.4",
-      description: "Open Nami \u2014 terminal-first bulk social media profile downloader for Instagram, TikTok, Facebook & X.",
+      version: "1.0.6",
+      description: "Open Nami: terminal-first bulk social media profile downloader for Instagram, TikTok, Facebook & X.",
       type: "module",
       bin: {
         "open-nami": "dist/cli.js",
@@ -1407,10 +1407,11 @@ function parseProfileInput(input) {
       const reserved = ["home", "explore", "notifications", "messages", "i", "settings"];
       if (firstPart && !reserved.includes(firstPart.toLowerCase())) {
         const username = firstPart.replace(/^@/, "");
+        const isLikesUrl = pathParts[1]?.toLowerCase() === "likes";
         return {
           platform: "x",
           username: sanitizeUsername(username),
-          cleanUrl: `https://x.com/${username}`,
+          cleanUrl: isLikesUrl ? `https://x.com/${username}/likes` : `https://x.com/${username}`,
           rawInput: input
         };
       }
@@ -1575,6 +1576,9 @@ function resolvePlatformDownloadsDir(options = {}) {
   return defaultFallback;
 }
 
+// src/lib/engines/extractors/instagram.ts
+import crypto from "crypto";
+
 // src/lib/engines/extractors/http.ts
 import fs5 from "fs/promises";
 import { setTimeout as setTimeoutPromise } from "timers/promises";
@@ -1762,7 +1766,9 @@ var HttpClient = class {
       }
       throw new Error(`HTTP ${res.status} (${res.statusText}) for ${url}`);
     }
-    return await res.json();
+    const text = await res.text();
+    const cleanText = text.replace(/^\s*(?:for\s*\(\s*;\s*;\s*\);|\)\]\}',)/, "").trim();
+    return JSON.parse(cleanText);
   }
   async fetchText(url, options = {}) {
     const res = await this.request(url, options);
@@ -1781,13 +1787,13 @@ var HttpClient = class {
 var IG_APP_ID = "936619743392459";
 var IG_TIMELINE_QUERY_HASH = "69cba40317214236af40e7efa697781d";
 var IG_QUERIES = {
-  PolarisProfilePostsTabContentQuery_connection: "28142289515441884",
+  PolarisProfilePostsTabContentQuery_connection: "39229011733413759",
   PolarisProfileReelsTabContentQuery_connection: "28989741540630190",
   PolarisProfileTaggedTabContentQuery_connection: "28794602806842110",
   PolarisProfileStoryHighlightsTrayContentQuery: "26970053832668570",
   PolarisStoriesV3ReelPageGalleryQuery: "28262315486766731",
   PolarisStoriesV3TrayContainerQuery: "27703822975903310",
-  PolarisProfilePageContentQuery: "28036671149327607"
+  PolarisProfilePageContentQuery: "28649589871350527"
 };
 var IG_POLARIS_DOC_ID = IG_QUERIES.PolarisProfilePostsTabContentQuery_connection;
 function logExtractorDebug(endpoint, err) {
@@ -1831,6 +1837,21 @@ function parseIgNodeToMediaItems(node, username) {
         height: video?.height ?? node.dimensions?.height,
         thumbnailUrl: node.display_url
       });
+    } else {
+      const candidate = node.image_versions2?.candidates?.[0];
+      const photoUrl = candidate?.url || node.display_url;
+      if (photoUrl) {
+        items.push({
+          id: baseId,
+          url: photoUrl,
+          filename: `${username}_${date || baseId}`,
+          extension: "jpg",
+          type: "photo",
+          date,
+          width: candidate?.width ?? node.dimensions?.width,
+          height: candidate?.height ?? node.dimensions?.height
+        });
+      }
     }
   } else {
     const candidate = node.image_versions2?.candidates?.[0];
@@ -1910,7 +1931,15 @@ var InstagramExtractor = class {
     if (!res.data?.user) {
       throw new Error(`Instagram user not found or private profile: ${username}`);
     }
-    return res.data.user;
+    const user = res.data.user;
+    if (user.is_private) {
+      const fs13 = user.friendship_status;
+      const isFollowing = fs13 ? Boolean(fs13.following) : Boolean(user.followed_by_viewer);
+      if (!isFollowing) {
+        throw new Error(`Instagram profile @${username} is private. You must provide a session cookie jar of an account following this profile.`);
+      }
+    }
+    return user;
   }
   async fetchHighlightsTray(userId, options) {
     try {
@@ -1932,6 +1961,10 @@ var InstagramExtractor = class {
           "Referer": "https://www.instagram.com/"
         }
       });
+      if (res?.errors && Array.isArray(res.errors) && res.errors.length > 0) {
+        const errMsg = res.errors.map((e) => e.message || JSON.stringify(e)).join("; ");
+        throw new Error(`Instagram GraphQL query error: ${errMsg}`);
+      }
       const edges = res?.data?.highlights?.edges;
       if (Array.isArray(edges) && edges.length > 0) {
         return edges.map((e) => e.node);
@@ -1975,87 +2008,211 @@ var InstagramExtractor = class {
       return [];
     }
   }
-  async fetchNextPostsPage(userId, username, cursor, options) {
-    const variables = JSON.stringify({ id: userId, first: 12, after: cursor });
-    const url = `https://www.instagram.com/graphql/query/?query_hash=${IG_TIMELINE_QUERY_HASH}&variables=${encodeURIComponent(variables)}`;
+  async fetchWebTokens(username, options) {
+    let csrfToken;
+    if (options.cookiePath) {
+      try {
+        const cookies = await loadCookiesFromPath(options.cookiePath, "instagram.com");
+        csrfToken = cookies["csrftoken"];
+      } catch {
+      }
+    }
+    if (!csrfToken) {
+      csrfToken = crypto.randomBytes(16).toString("hex");
+    }
     try {
-      const res = await this.httpClient.fetchJson(url, {
+      const html = await this.httpClient.fetchText(`https://www.instagram.com/${encodeURIComponent(username)}/`, {
         cookiePath: options.cookiePath,
         cookieDomain: "instagram.com",
         signal: options.signal,
         headers: {
-          "X-IG-App-ID": IG_APP_ID,
-          "Referer": `https://www.instagram.com/${username}/`
+          "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
         }
       });
-      const data = res?.data?.user?.edge_owner_to_timeline_media;
-      if (data?.edges && data.edges.length > 0) {
-        return {
-          edges: data.edges,
-          hasNextPage: Boolean(data.page_info?.has_next_page),
-          nextCursor: data.page_info?.end_cursor
-        };
+      let lsd;
+      let fbDtsg;
+      let userId;
+      const eqmcMatch = html.match(/id="__eqmc"[^>]*>([^<]+)<\/script>/);
+      if (eqmcMatch) {
+        try {
+          const eqmc = JSON.parse(eqmcMatch[1]);
+          if (eqmc.l) lsd = eqmc.l;
+          if (eqmc.f) fbDtsg = eqmc.f;
+        } catch {
+        }
+      }
+      if (!lsd) {
+        const m = html.match(/"lsd":"([^"]+)"/) || html.match(/"LSD",\[\],\{"token":"([^"]+)"/);
+        if (m) lsd = m[1];
+      }
+      if (!fbDtsg) {
+        const m = html.match(/"dtsg":\{"token":"([^"]+)"/);
+        if (m) fbDtsg = m[1];
       }
+      const uMatch = html.match(/"profile_id":"([^"]+)"/) || html.match(/"user_id":"([^"]+)"/);
+      if (uMatch) userId = uMatch[1];
+      return { lsd, fbDtsg, csrfToken, userId };
     } catch (err) {
-      logExtractorDebug("edge_owner_to_timeline_media", err);
+      logExtractorDebug("fetchWebTokens", err);
+      return { csrfToken };
+    }
+  }
+  async fetchPostsTabGraphQL(username, cursor, tokens, options) {
+    const postVariables = JSON.stringify({
+      after: cursor || null,
+      before: null,
+      data: {
+        count: 12,
+        include_reel_media_seen_timestamp: true,
+        include_relationship_info: true,
+        latest_besties_reel_media: true,
+        latest_reel_media: true
+      },
+      first: 12,
+      include_multi_captions: true,
+      last: null,
+      username,
+      __relay_internal__pv__PolarisMultiCaptionCarouselEnabledrelayprovider: true,
+      __relay_internal__pv__PolarisShortDramaEnabledrelayprovider: true,
+      __relay_internal__pv__PolarisThreadsStyleCommentsEnabledrelayprovider: false,
+      __relay_internal__pv__PolarisReelsRecoDebugOverlayEnabledrelayprovider: false
+    });
+    const bodyParams = new URLSearchParams({
+      av: "17841415137994167",
+      __d: "www",
+      __user: "0",
+      __a: "1",
+      __req: "0",
+      __hs: "20731.HYP:instagram_web_pkg.2.1...0",
+      dpr: "1",
+      __ccg: "EXCELLENT",
+      __rev: "1049285836",
+      __hsi: "7693193318680449885",
+      __comet_req: "7",
+      jazoest: "26461",
+      fb_api_caller_class: "RelayModern",
+      fb_api_req_friendly_name: "PolarisProfilePostsTabContentQuery_connection",
+      server_timestamps: "true",
+      variables: postVariables,
+      doc_id: IG_POLARIS_DOC_ID
+    });
+    if (tokens.fbDtsg) bodyParams.set("fb_dtsg", tokens.fbDtsg);
+    if (tokens.lsd) bodyParams.set("lsd", tokens.lsd);
+    const headers = {
+      "Accept": "*/*",
+      "Content-Type": "application/x-www-form-urlencoded",
+      "X-IG-App-ID": IG_APP_ID,
+      "X-IG-Max-Touch-Points": "0",
+      "X-FB-Friendly-Name": "PolarisProfilePostsTabContentQuery_connection",
+      "Referer": `https://www.instagram.com/${username}/`,
+      "Origin": "https://www.instagram.com",
+      "X-ASBD-ID": "359341",
+      "Sec-Fetch-Dest": "empty",
+      "Sec-Fetch-Mode": "cors",
+      "Sec-Fetch-Site": "same-origin"
+    };
+    if (tokens.csrfToken) headers["X-CSRFToken"] = tokens.csrfToken;
+    if (tokens.lsd) headers["X-FB-LSD"] = tokens.lsd;
+    const res = await this.httpClient.fetchJson("https://www.instagram.com/graphql/query", {
+      method: "POST",
+      body: bodyParams.toString(),
+      cookiePath: options.cookiePath,
+      cookieDomain: "instagram.com",
+      signal: options.signal,
+      headers
+    });
+    if (res?.errors && Array.isArray(res.errors) && res.errors.length > 0) {
+      const errMsg = res.errors.map((e) => e.message || JSON.stringify(e)).join("; ");
+      throw new Error(`Instagram GraphQL query error: ${errMsg}`);
+    }
+    const connection = res?.data?.xdt_api__v1__feed__user_timeline_graphql_connection || res?.data?.user?.edge_owner_to_timeline_media;
+    if (connection?.edges && Array.isArray(connection.edges)) {
+      let resolvedUserId;
+      for (const edge of connection.edges) {
+        const node = edge?.node;
+        if (node?.owner_id) {
+          resolvedUserId = String(node.owner_id);
+          break;
+        }
+        if (node?.user?.pk || node?.user?.id) {
+          resolvedUserId = String(node.user.pk || node.user.id);
+          break;
+        }
+        if (typeof node?.id === "string" && node.id.includes("_")) {
+          resolvedUserId = node.id.split("_")[1];
+          break;
+        }
+      }
+      return {
+        edges: connection.edges,
+        hasNextPage: Boolean(connection.page_info?.has_next_page),
+        nextCursor: connection.page_info?.end_cursor,
+        userId: resolvedUserId
+      };
     }
+    return { edges: [], hasNextPage: false };
+  }
+  async fetchNextPostsPage(userId, username, cursor, options, tokens) {
     try {
-      const postVariables = JSON.stringify({
-        after: cursor,
-        first: 12,
-        username,
-        data: { count: 12 }
-      });
-      const postUrl = "https://www.instagram.com/graphql/query";
-      const body = new URLSearchParams({
-        doc_id: IG_POLARIS_DOC_ID,
-        variables: postVariables
-      }).toString();
-      const res = await this.httpClient.fetchJson(postUrl, {
-        method: "POST",
-        body,
-        cookiePath: options.cookiePath,
-        cookieDomain: "instagram.com",
-        signal: options.signal,
-        headers: {
-          "Content-Type": "application/x-www-form-urlencoded",
-          "X-IG-App-ID": IG_APP_ID,
-          "X-FB-Friendly-Name": "PolarisProfilePostsTabContentQuery_connection",
-          "Referer": `https://www.instagram.com/${username}/`
-        }
-      });
-      const connection = res?.data?.xdt_api__v1__feed__user_timeline_graphql_connection || res?.data?.user?.edge_owner_to_timeline_media;
-      if (connection?.edges && connection.edges.length > 0) {
-        return {
-          edges: connection.edges,
-          hasNextPage: Boolean(connection.page_info?.has_next_page),
-          nextCursor: connection.page_info?.end_cursor
-        };
+      const page = await this.fetchPostsTabGraphQL(username, cursor, tokens || {}, options);
+      if (page.edges && page.edges.length > 0) {
+        return page;
       }
     } catch (err) {
       logExtractorDebug("PolarisProfilePostsTabContentQuery_connection", err);
     }
-    try {
-      const restUrl = `https://www.instagram.com/api/v1/feed/user/${userId}/?count=12&max_id=${encodeURIComponent(cursor)}`;
-      const res = await this.httpClient.fetchJson(restUrl, {
-        cookiePath: options.cookiePath,
-        cookieDomain: "instagram.com",
-        signal: options.signal,
-        headers: {
+    if (userId) {
+      const variables = JSON.stringify({ id: userId, first: 12, after: cursor });
+      const url = `https://www.instagram.com/graphql/query/?query_hash=${IG_TIMELINE_QUERY_HASH}&variables=${encodeURIComponent(variables)}`;
+      try {
+        const headers = {
           "X-IG-App-ID": IG_APP_ID,
           "Referer": `https://www.instagram.com/${username}/`
+        };
+        if (tokens?.csrfToken) headers["X-CSRFToken"] = tokens.csrfToken;
+        const res = await this.httpClient.fetchJson(url, {
+          cookiePath: options.cookiePath,
+          cookieDomain: "instagram.com",
+          signal: options.signal,
+          headers
+        });
+        const data = res?.data?.user?.edge_owner_to_timeline_media;
+        if (data?.edges && data.edges.length > 0) {
+          return {
+            edges: data.edges,
+            hasNextPage: Boolean(data.page_info?.has_next_page),
+            nextCursor: data.page_info?.end_cursor
+          };
         }
-      });
-      if (Array.isArray(res?.items) && res.items.length > 0) {
-        const edges = res.items.map((item) => ({ node: item }));
-        return {
-          edges,
-          hasNextPage: Boolean(res.more_available),
-          nextCursor: res.next_max_id ? String(res.next_max_id) : void 0
+      } catch (err) {
+        logExtractorDebug("edge_owner_to_timeline_media", err);
+      }
+    }
+    if (userId) {
+      try {
+        const restUrl = `https://www.instagram.com/api/v1/feed/user/${userId}/?count=12&max_id=${encodeURIComponent(cursor)}`;
+        const headers = {
+          "X-IG-App-ID": IG_APP_ID,
+          "Referer": `https://www.instagram.com/${username}/`
         };
+        if (tokens?.csrfToken) headers["X-CSRFToken"] = tokens.csrfToken;
+        const res = await this.httpClient.fetchJson(restUrl, {
+          cookiePath: options.cookiePath,
+          cookieDomain: "instagram.com",
+          signal: options.signal,
+          headers
+        });
+        if (Array.isArray(res?.items) && res.items.length > 0) {
+          const edges = res.items.map((item) => ({ node: item }));
+          return {
+            edges,
+            hasNextPage: Boolean(res.more_available),
+            nextCursor: res.next_max_id ? String(res.next_max_id) : void 0
+          };
+        }
+      } catch (err) {
+        logExtractorDebug("v1 user feed REST", err);
       }
-    } catch (err) {
-      logExtractorDebug("v1 user feed REST", err);
     }
     return { edges: [], hasNextPage: false };
   }
@@ -2089,6 +2246,10 @@ var InstagramExtractor = class {
           "Referer": "https://www.instagram.com/"
         }
       });
+      if (res?.errors && Array.isArray(res.errors) && res.errors.length > 0) {
+        const errMsg = res.errors.map((e) => e.message || JSON.stringify(e)).join("; ");
+        throw new Error(`Instagram GraphQL query error: ${errMsg}`);
+      }
       const reelsData = res?.data?.fetch__XDTUserDict;
       let connection = reelsData?.reels;
       if (!connection && reelsData) {
@@ -2119,9 +2280,31 @@ var InstagramExtractor = class {
       found: 0,
       message: `Fetching Instagram profile @${username}...`
     });
-    const user = await this.fetchUserProfile(username, options);
-    const userId = user.id;
+    let user = null;
+    try {
+      user = await this.fetchUserProfile(username, options);
+    } catch (err) {
+      logExtractorDebug("fetchUserProfile", err);
+    }
+    let webTokens = {};
+    try {
+      webTokens = await this.fetchWebTokens(username, options);
+    } catch (err) {
+      logExtractorDebug("fetchWebTokens", err);
+    }
+    let userId = user?.id || webTokens.userId;
+    if (!userId && (subDir === "Stories" || subDir === "Highlights")) {
+      try {
+        const probe = await this.fetchPostsTabGraphQL(username, void 0, webTokens, options);
+        if (probe.userId) {
+          userId = probe.userId;
+        }
+      } catch (err) {
+        logExtractorDebug("userId probe", err);
+      }
+    }
     if (subDir === "Stories") {
+      if (!userId) return;
       options.onProgress?.({
         stage: "Stories",
         found: 0,
@@ -2137,6 +2320,7 @@ var InstagramExtractor = class {
       return;
     }
     if (subDir === "Highlights") {
+      if (!userId) return;
       options.onProgress?.({
         stage: "Highlights",
         found: 0,
@@ -2163,9 +2347,22 @@ var InstagramExtractor = class {
     }
     let found = 0;
     const emittedItemIds = /* @__PURE__ */ new Set();
-    let currentEdges = user.edge_owner_to_timeline_media?.edges ?? [];
-    let hasNextPage = Boolean(user.edge_owner_to_timeline_media?.page_info?.has_next_page);
-    let endCursor = user.edge_owner_to_timeline_media?.page_info?.end_cursor;
+    let currentEdges = user?.edge_owner_to_timeline_media?.edges ?? [];
+    let hasNextPage = Boolean(user?.edge_owner_to_timeline_media?.page_info?.has_next_page);
+    let endCursor = user?.edge_owner_to_timeline_media?.page_info?.end_cursor;
+    if (!user) {
+      try {
+        const firstPage = await this.fetchPostsTabGraphQL(username, void 0, webTokens, options);
+        currentEdges = firstPage.edges;
+        hasNextPage = firstPage.hasNextPage;
+        endCursor = firstPage.nextCursor;
+        if (!userId && firstPage.userId) {
+          userId = firstPage.userId;
+        }
+      } catch (err) {
+        logExtractorDebug("fetchPostsTabGraphQL initial", err);
+      }
+    }
     while (true) {
       for (const edge of currentEdges) {
         const items = parseIgNodeToMediaItems(edge.node, username);
@@ -2188,7 +2385,7 @@ var InstagramExtractor = class {
       }
       await sleep(1500, 2500, options.signal);
       try {
-        const nextPage = await this.fetchNextPostsPage(userId, username, endCursor, options);
+        const nextPage = await this.fetchNextPostsPage(userId || "", username, endCursor, options, webTokens);
         currentEdges = nextPage.edges;
         hasNextPage = nextPage.hasNextPage;
         endCursor = nextPage.nextCursor;
@@ -2199,8 +2396,8 @@ var InstagramExtractor = class {
         break;
       }
     }
-    if (subDir === "Videos") {
-      const videoEdges = user.edge_felix_video_timeline?.edges ?? [];
+    if (subDir === "Videos" && userId) {
+      const videoEdges = user?.edge_felix_video_timeline?.edges ?? [];
       for (const edge of videoEdges) {
         const items = parseIgNodeToMediaItems(edge.node, username);
         for (const item of items) {
@@ -2272,8 +2469,43 @@ var TWITTER_FEATURES = {
   responsive_web_text_conversations_enabled: false,
   longform_notetweets_rich_text_read_enabled: true,
   longform_notetweets_inline_media_enabled: true,
-  responsive_web_enhance_cards_enabled: false
+  responsive_web_enhance_cards_enabled: false,
+  creator_subscriptions_tweet_preview_api_enabled: true,
+  communities_web_enable_tweet_community_results_fetch: true,
+  c9s_tweet_anatomy_moderator_badge_enabled: true,
+  articles_preview_enabled: true,
+  responsive_web_twitter_article_tweet_consumption_enabled: true,
+  responsive_web_grok_analyze_post_followups_enabled: true,
+  responsive_web_jetfuel_frame: true,
+  responsive_web_grok_share_attachment_enabled: true,
+  responsive_web_grok_analysis_button_from_backend: true,
+  responsive_web_grok_image_annotation_enabled: true,
+  responsive_web_grok_imagine_annotation_enabled: true,
+  profile_label_improvements_pcf_label_in_post_enabled: true,
+  rweb_tipjar_consumption_enabled: true
 };
+function shouldSkipTweetReply(tweet, targetUserId, mode = "timeline") {
+  const tweetResult = tweet.tweet || tweet;
+  const legacy = tweetResult.legacy || tweetResult;
+  const replyToUserId = legacy.in_reply_to_user_id_str;
+  if (!replyToUserId) {
+    return false;
+  }
+  const authorId = legacy.user_id_str || tweetResult.core?.user_results?.result?.rest_id;
+  if (mode === "timeline") {
+    if (targetUserId) {
+      if (replyToUserId !== targetUserId || authorId && authorId !== targetUserId) {
+        return true;
+      }
+      return false;
+    }
+    return Boolean(authorId && replyToUserId !== authorId);
+  }
+  if (authorId && replyToUserId === authorId) {
+    return false;
+  }
+  return true;
+}
 function parseTweetMediaEntities(tweet, username) {
   const items = [];
   const tweetResult = tweet.tweet || tweet;
@@ -2368,11 +2600,17 @@ var XExtractor = class {
     }
     if (username === "i_history_likes") {
       if (options.cookiePath) {
-        const cookies = await loadCookiesFromPath(options.cookiePath, "x.com");
+        let cookies = await loadCookiesFromPath(options.cookiePath, "x.com");
+        if (!cookies["twid"]) {
+          cookies = await loadCookiesFromPath(options.cookiePath, "twitter.com");
+        }
+        if (!cookies["twid"]) {
+          cookies = await loadCookiesFromPath(options.cookiePath);
+        }
         const twid = cookies["twid"];
         if (twid) {
           const decoded = decodeURIComponent(twid).replace(/^"|"$/g, "").trim();
-          const rawId = decoded.startsWith("u=") ? decoded.slice(2) : decoded;
+          const rawId = decoded.startsWith("u=") ? decoded.slice(2) : decoded.includes("=") ? decoded.split("=").pop()?.trim() : decoded;
           if (rawId && /^[a-zA-Z0-9_-]+$/.test(rawId)) {
             return rawId;
           }
@@ -2414,7 +2652,21 @@ var XExtractor = class {
   async *extract(profile, options) {
     const username = profile.username;
     const subDir = options.subDir;
-    const isLikes = username === "i_history_likes";
+    const isLikes = username === "i_history_likes" || profile.cleanUrl?.endsWith("/likes");
+    const authHeaders = {};
+    if (options.cookiePath) {
+      let cookies = await loadCookiesFromPath(options.cookiePath, "x.com");
+      if (!cookies["ct0"] && !cookies["auth_token"]) {
+        const twCookies = await loadCookiesFromPath(options.cookiePath, "twitter.com");
+        cookies = { ...twCookies, ...cookies };
+      }
+      if (cookies["ct0"]) {
+        authHeaders["x-csrf-token"] = cookies["ct0"];
+      }
+      if (cookies["auth_token"]) {
+        authHeaders["x-twitter-auth-type"] = "OAuth2Session";
+      }
+    }
     options.onProgress?.({
       stage: isLikes ? "Likes" : "Profile",
       found: 0,
@@ -2445,11 +2697,15 @@ var XExtractor = class {
         res = await this.httpClient.fetchJson(url, {
           cookiePath: options.cookiePath,
           cookieDomain: "x.com",
-          signal: options.signal
+          signal: options.signal,
+          headers: authHeaders
         });
       } catch (err) {
         break;
       }
+      if (res?.errors?.length && !res?.data?.user?.result) {
+        throw new Error(`X/Twitter API error: ${res.errors[0]?.message || "GraphQL query failed"}`);
+      }
       const instructions = res?.data?.user?.result?.timeline_v2?.timeline?.instructions || [];
       let newCursor;
       let pageItemCount = 0;
@@ -2462,6 +2718,9 @@ var XExtractor = class {
           }
           const tweetContent = entry.content?.itemContent?.tweet_results?.result;
           if (tweetContent) {
+            if (shouldSkipTweetReply(tweetContent, userId, isLikes ? "likes" : "timeline")) {
+              continue;
+            }
             const mediaItems = parseTweetMediaEntities(tweetContent, username);
             for (const item of mediaItems) {
               if (subDir === "Photos" && item.type !== "photo") continue;
@@ -2490,16 +2749,86 @@ var XExtractor = class {
 
 // src/lib/engines/extractors/tiktok.ts
 function parseTikTokRehydrationJson(html) {
-  const match = html.match(
+  const universalMatch = html.match(
     /<script id="__UNIVERSAL_DATA_FOR_REHYDRATION__"[^>]*>([\s\S]*?)<\/script>/
   );
-  if (!match) return null;
-  try {
-    const raw = JSON.parse(match[1]);
-    return raw?.["__DEFAULT_SCOPE__"];
-  } catch {
-    return null;
+  if (universalMatch) {
+    try {
+      const raw = JSON.parse(universalMatch[1]);
+      const scope = raw?.["__DEFAULT_SCOPE__"] || raw;
+      if (scope) return scope;
+    } catch {
+    }
   }
+  const sigiTagMatch = html.match(
+    /<script id="SIGI_STATE"[^>]*>([\s\S]*?)<\/script>/
+  );
+  if (sigiTagMatch) {
+    try {
+      const raw = JSON.parse(sigiTagMatch[1]);
+      const user = Object.values(raw?.UserModule?.users || {})[0];
+      const items = Object.values(raw?.ItemModule || {});
+      return {
+        "webapp.user-detail": {
+          userInfo: { user },
+          itemList: items
+        },
+        SIGI_STATE: raw
+      };
+    } catch {
+    }
+  }
+  const sigiWindowMatch = html.match(
+    /(?:window\[['"]SIGI_STATE['"]\]|SIGI_STATE)\s*=\s*(\{[\s\S]*?\})\s*;/i
+  );
+  if (sigiWindowMatch) {
+    try {
+      const raw = JSON.parse(sigiWindowMatch[1]);
+      const user = Object.values(raw?.UserModule?.users || {})[0];
+      const items = Object.values(raw?.ItemModule || {});
+      return {
+        "webapp.user-detail": {
+          userInfo: { user },
+          itemList: items
+        },
+        SIGI_STATE: raw
+      };
+    } catch {
+    }
+  }
+  const nextDataMatch = html.match(
+    /<script id="__NEXT_DATA__"[^>]*>([\s\S]*?)<\/script>/
+  );
+  if (nextDataMatch) {
+    try {
+      const raw = JSON.parse(nextDataMatch[1]);
+      const pageProps = raw?.props?.pageProps;
+      if (pageProps) {
+        return {
+          "webapp.user-detail": {
+            userInfo: pageProps.userInfo,
+            itemList: pageProps.items || pageProps.itemList || []
+          },
+          __NEXT_DATA__: raw
+        };
+      }
+    } catch {
+    }
+  }
+  const secUidMatch = html.match(/(?:secUid|sec_uid)["':=\s]+(MS4wLjABAAAA[\w-]{32,64})/i);
+  if (secUidMatch) {
+    return {
+      "webapp.user-detail": {
+        userInfo: {
+          user: {
+            secUid: secUidMatch[1]
+          }
+        },
+        itemList: []
+      }
+    };
+  }
+  return null;
 }
 function parseTikTokItem(item, username) {
   const items = [];
@@ -2596,13 +2925,28 @@ var TikTokExtractor = class {
       if (options.signal?.aborted) break;
       if (visitedCursors.has(cursor)) break;
       visitedCursors.add(cursor);
-      const apiUrl = `https://www.tiktok.com/api/post/item_list/?secUid=${encodeURIComponent(secUid)}&count=30&cursor=${cursor}&post_item_list_request_type=0`;
+      const deviceId = `${Math.floor(725e16 + Math.random() * 75e15)}`;
+      const queryParams = new URLSearchParams({
+        aid: "1988",
+        app_name: "tiktok_web",
+        device_platform: "web_pc",
+        channel: "tiktok_web",
+        device_id: deviceId,
+        secUid,
+        count: "30",
+        cursor,
+        post_item_list_request_type: "0"
+      });
+      const apiUrl = `https://www.tiktok.com/api/post/item_list/?${queryParams.toString()}`;
       let res;
       try {
         res = await this.httpClient.fetchJson(apiUrl, {
           cookiePath: options.cookiePath,
           cookieDomain: "tiktok.com",
-          signal: options.signal
+          signal: options.signal,
+          headers: {
+            "Referer": profileUrl
+          }
         });
       } catch {
         break;
@@ -2654,28 +2998,55 @@ function decodeEscapedUrl(raw) {
 function extractFacebookMediaFromHtml(html, username) {
   const items = [];
   const seenUrls = /* @__PURE__ */ new Set();
-  const hdMatch = html.match(/"browser_native_hd_url":"([^"]+)"/);
-  const sdMatch = html.match(/"browser_native_sd_url":"([^"]+)"/);
-  const rawVideoUrl = hdMatch?.[1] || sdMatch?.[1];
-  if (rawVideoUrl) {
-    const videoUrl = decodeEscapedUrl(rawVideoUrl);
-    if (!seenUrls.has(videoUrl)) {
-      seenUrls.add(videoUrl);
-      items.push({
-        id: `fb_video_${Date.now()}`,
-        url: videoUrl,
-        filename: `${username}_video_${Date.now()}`,
-        extension: "mp4",
-        type: "video"
-      });
+  const videoPatterns = [
+    /"browser_native_hd_url":"([^"]+)"/g,
+    /"browser_native_sd_url":"([^"]+)"/g,
+    /"playable_url_quality_hd":"([^"]+)"/g,
+    /"playable_url":"([^"]+)"/g,
+    /<video[^>]+src=["'](https?:[^"']+)["']/gi
+  ];
+  let videoIndex = 1;
+  for (const regex of videoPatterns) {
+    let vMatch;
+    while ((vMatch = regex.exec(html)) !== null) {
+      const rawUrl = vMatch[1];
+      const videoUrl = decodeEscapedUrl(rawUrl).replace(/&amp;/g, "&");
+      if (videoUrl.startsWith("http") && !seenUrls.has(videoUrl)) {
+        seenUrls.add(videoUrl);
+        items.push({
+          id: `fb_video_${videoIndex}`,
+          url: videoUrl,
+          filename: `${username}_video_${videoIndex}`,
+          extension: "mp4",
+          type: "video"
+        });
+        videoIndex++;
+      }
     }
   }
-  const photoRegex = /,"image":\{"uri":"([^"]+)"/g;
+  const photoRegex = /,"(?:image|viewer_image|full_size_image|display_image)":\{"uri":"([^"]+)"/g;
   let match;
   let photoIndex = 1;
   while ((match = photoRegex.exec(html)) !== null) {
     const rawUrl = match[1];
-    const photoUrl = decodeEscapedUrl(rawUrl);
+    const photoUrl = decodeEscapedUrl(rawUrl).replace(/&amp;/g, "&");
+    if (!seenUrls.has(photoUrl)) {
+      seenUrls.add(photoUrl);
+      items.push({
+        id: `fb_photo_${photoIndex}`,
+        url: photoUrl,
+        filename: `${username}_photo_${photoIndex}`,
+        extension: "jpg",
+        type: "photo"
+      });
+      photoIndex++;
+    }
+  }
+  const mbasicImgRegex = /<img[^>]+src=["'](https:\/\/[^"'\s]*scontent[^"'\s]*\.(?:jpg|png|webp)[^"'\s]*)["']/gi;
+  let mMatch;
+  while ((mMatch = mbasicImgRegex.exec(html)) !== null) {
+    const rawUrl = mMatch[1];
+    const photoUrl = decodeEscapedUrl(rawUrl).replace(/&amp;/g, "&");
     if (!seenUrls.has(photoUrl)) {
       seenUrls.add(photoUrl);
       items.push({
@@ -2689,10 +3060,10 @@ function extractFacebookMediaFromHtml(html, username) {
     }
   }
   if (items.length === 0) {
-    const scontentRegex = /https:\/\/[^"'\s]*scontent[^"'\s]*\.(?:jpg|png|webp)[^"'\s]*/gi;
+    const scontentRegex = /https:\/\/[^"'\s<>]*scontent[^"'\s<>]*\.(?:jpg|png|webp)[^"'\s<>]*/gi;
     let sMatch;
     while ((sMatch = scontentRegex.exec(html)) !== null) {
-      const cleanUrl = sMatch[0].replace(/\\/g, "");
+      const cleanUrl = sMatch[0].replace(/\\/g, "").replace(/&amp;/g, "&");
       if (!seenUrls.has(cleanUrl)) {
         seenUrls.add(cleanUrl);
         items.push({
@@ -2708,6 +3079,59 @@ function extractFacebookMediaFromHtml(html, username) {
   }
   return items;
 }
+function extractFacebookPaginationCursor(html) {
+  const jsonCursorMatch = html.match(/"end_cursor":"([^"]+)"/) || html.match(/"cursor":"([^"]+)"/);
+  if (jsonCursorMatch && jsonCursorMatch[1]) {
+    return jsonCursorMatch[1];
+  }
+  const linkCursorMatch = html.match(/[?&](?:cursor|after)=([^"'\s&<>]+)/i);
+  if (linkCursorMatch && linkCursorMatch[1]) {
+    try {
+      return decodeURIComponent(linkCursorMatch[1]);
+    } catch {
+      return linkCursorMatch[1];
+    }
+  }
+  return null;
+}
+function resolveFacebookUrl(href, currentUrl) {
+  const cleanHref = href.replace(/\\/g, "").replace(/&amp;/g, "&");
+  try {
+    return new URL(cleanHref, currentUrl).toString();
+  } catch {
+    return cleanHref;
+  }
+}
+function extractFacebookNextPageUrl(html, currentUrl) {
+  const moreItemMatch = html.match(/<div[^>]*id=["'](?:m_more_item|m_more_posts)["'][^>]*>\s*<a[^>]+href=["']([^"']+)["']/i);
+  if (moreItemMatch && moreItemMatch[1]) {
+    return resolveFacebookUrl(moreItemMatch[1], currentUrl);
+  }
+  const cursorLabelMatch = html.match(/<a[^>]+href=["']([^"']*(?:cursor=|after=)[^"']+)["'][^>]*>[\s\S]*?(?:See [Mm]ore|More [Pp]hotos|More|Next|Older [Pp]osts)[\s\S]*?<\/a>/i);
+  if (cursorLabelMatch && cursorLabelMatch[1]) {
+    return resolveFacebookUrl(cursorLabelMatch[1], currentUrl);
+  }
+  const genericCursorMatch = html.match(/<a[^>]+href=["']([^"']*(?:[?&]|&amp;)(?:cursor|after)=[^"']+)["']/i);
+  if (genericCursorMatch && genericCursorMatch[1]) {
+    return resolveFacebookUrl(genericCursorMatch[1], currentUrl);
+  }
+  const cursor = extractFacebookPaginationCursor(html);
+  if (cursor) {
+    try {
+      const u = new URL(currentUrl);
+      if (u.searchParams.get("cursor") !== cursor) {
+        u.searchParams.set("cursor", cursor);
+        return u.toString();
+      }
+    } catch {
+      if (!currentUrl.includes(cursor)) {
+        const sep = currentUrl.includes("?") ? "&" : "?";
+        return `${currentUrl}${sep}cursor=${encodeURIComponent(cursor)}`;
+      }
+    }
+  }
+  return null;
+}
 var FacebookExtractor = class {
   platform = "facebook";
   httpClient;
@@ -2724,26 +3148,120 @@ var FacebookExtractor = class {
       found: 0,
       message: `Fetching Facebook profile @${username}...`
     });
-    const targetUrl = subDir === "Photos" ? `https://www.facebook.com/${encodeURIComponent(username)}/photos` : `https://www.facebook.com/${encodeURIComponent(username)}/videos`;
-    const html = await this.httpClient.fetchText(targetUrl, {
-      cookiePath: options.cookiePath,
-      cookieDomain: "facebook.com",
-      signal: options.signal,
-      retries: 0,
-      timeoutMs: 4e3
-    });
-    const items = extractFacebookMediaFromHtml(html, username);
-    let found = 0;
-    for (const item of items) {
-      if (subDir === "Photos" && item.type !== "photo") continue;
-      if (subDir === "Videos" && item.type !== "video") continue;
-      found++;
+    const targetPath = subDir === "Photos" ? "photos" : "videos";
+    const desktopUrl = `https://www.facebook.com/${encodeURIComponent(username)}/${targetPath}`;
+    const mbasicUrl = `https://mbasic.facebook.com/${encodeURIComponent(username)}/${targetPath}`;
+    const mobileUrl = `https://m.facebook.com/${encodeURIComponent(username)}/${targetPath}`;
+    let currentUrl = desktopUrl;
+    let html = "";
+    try {
+      html = await this.httpClient.fetchText(desktopUrl, {
+        cookiePath: options.cookiePath,
+        cookieDomain: "facebook.com",
+        signal: options.signal,
+        retries: 0,
+        timeoutMs: 4e3
+      });
+    } catch {
+      html = "";
+    }
+    let initialItems = extractFacebookMediaFromHtml(html, username);
+    if (initialItems.length === 0) {
       options.onProgress?.({
-        stage: subDir,
-        found,
-        message: `Found item: ${item.filename}`
+        stage: "Profile",
+        found: 0,
+        message: `Desktop yielded 0 items. Falling back to mbasic.facebook.com for @${username}...`
       });
-      yield item;
+      try {
+        const mbasicHtml = await this.httpClient.fetchText(mbasicUrl, {
+          cookiePath: options.cookiePath,
+          cookieDomain: "facebook.com",
+          signal: options.signal,
+          retries: 1,
+          timeoutMs: 5e3,
+          headers: {
+            "Referer": "https://mbasic.facebook.com/"
+          }
+        });
+        const mbasicItems = extractFacebookMediaFromHtml(mbasicHtml, username);
+        if (mbasicItems.length > 0 || mbasicHtml.length > 200) {
+          html = mbasicHtml;
+          currentUrl = mbasicUrl;
+          initialItems = mbasicItems;
+        }
+      } catch {
+      }
+      if (initialItems.length === 0) {
+        try {
+          const mobileHtml = await this.httpClient.fetchText(mobileUrl, {
+            cookiePath: options.cookiePath,
+            cookieDomain: "facebook.com",
+            signal: options.signal,
+            retries: 0,
+            timeoutMs: 5e3,
+            headers: {
+              "User-Agent": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36",
+              "Referer": "https://m.facebook.com/"
+            }
+          });
+          const mobileItems = extractFacebookMediaFromHtml(mobileHtml, username);
+          if (mobileItems.length > 0) {
+            html = mobileHtml;
+            currentUrl = mobileUrl;
+            initialItems = mobileItems;
+          }
+        } catch {
+        }
+      }
+    }
+    const seenUrls = /* @__PURE__ */ new Set();
+    let found = 0;
+    let page = 1;
+    const maxPages = 5;
+    while (true) {
+      const items = extractFacebookMediaFromHtml(html, username);
+      let pageNewCount = 0;
+      for (const item of items) {
+        if (subDir === "Photos" && item.type !== "photo") continue;
+        if (subDir === "Videos" && item.type !== "video") continue;
+        if (seenUrls.has(item.url)) continue;
+        seenUrls.add(item.url);
+        found++;
+        pageNewCount++;
+        options.onProgress?.({
+          stage: subDir,
+          found,
+          message: `Found item: ${item.filename}`
+        });
+        yield item;
+      }
+      if (page >= maxPages || options.signal?.aborted) {
+        break;
+      }
+      const nextUrl = extractFacebookNextPageUrl(html, currentUrl);
+      if (!nextUrl || nextUrl === currentUrl) {
+        break;
+      }
+      if (pageNewCount === 0 && page > 1) {
+        break;
+      }
+      await sleep(1e3, 2e3, options.signal);
+      try {
+        currentUrl = nextUrl;
+        html = await this.httpClient.fetchText(currentUrl, {
+          cookiePath: options.cookiePath,
+          cookieDomain: "facebook.com",
+          signal: options.signal,
+          retries: 1,
+          timeoutMs: 5e3,
+          headers: {
+            "Referer": currentUrl.includes("mbasic") ? "https://mbasic.facebook.com/" : "https://www.facebook.com/"
+          }
+        });
+        page++;
+      } catch {
+        break;
+      }
     }
   }
 };
@@ -2771,17 +3289,48 @@ import path5 from "path";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
 var ARCHIVE_FILENAME = ".open-nami-archive.json";
+var YTDLP_ARCHIVE_FILENAME = "archive_yt-dlp.txt";
+var TEXT_ARCHIVE_FILENAME = "archive.txt";
 async function loadArchive(destDir) {
-  const archivePath = path5.join(destDir, ARCHIVE_FILENAME);
+  const archive = /* @__PURE__ */ new Set();
+  const jsonPath = path5.join(destDir, ARCHIVE_FILENAME);
   try {
-    const raw = await fsPromises2.readFile(archivePath, "utf-8");
+    const raw = await fsPromises2.readFile(jsonPath, "utf-8");
     const parsed = JSON.parse(raw);
     if (Array.isArray(parsed)) {
-      return new Set(parsed);
+      for (const id of parsed) {
+        if (id) archive.add(String(id));
+      }
+    }
+  } catch {
+  }
+  const ytdlpPath = path5.join(destDir, YTDLP_ARCHIVE_FILENAME);
+  try {
+    const raw = await fsPromises2.readFile(ytdlpPath, "utf-8");
+    const lines = raw.split(/\r?\n/);
+    for (const rawLine of lines) {
+      const line = rawLine.trim();
+      if (!line || line.startsWith("#")) continue;
+      const parts = line.split(/\s+/);
+      const id = parts[parts.length - 1];
+      if (id) archive.add(id);
+    }
+  } catch {
+  }
+  const textPath = path5.join(destDir, TEXT_ARCHIVE_FILENAME);
+  try {
+    const raw = await fsPromises2.readFile(textPath, "utf-8");
+    const lines = raw.split(/\r?\n/);
+    for (const rawLine of lines) {
+      const line = rawLine.trim();
+      if (!line || line.startsWith("#")) continue;
+      const parts = line.split(/\s+/);
+      const id = parts[parts.length - 1];
+      if (id) archive.add(id);
     }
   } catch {
   }
-  return /* @__PURE__ */ new Set();
+  return archive;
 }
 async function saveArchive(destDir, archive) {
   const archivePath = path5.join(destDir, ARCHIVE_FILENAME);
@@ -2791,6 +3340,18 @@ async function saveArchive(destDir, archive) {
     await fsPromises2.rename(tmpPath, archivePath);
   } catch {
   }
+  const textPaths = [
+    path5.join(destDir, YTDLP_ARCHIVE_FILENAME),
+    path5.join(destDir, TEXT_ARCHIVE_FILENAME)
+  ];
+  const content = [...archive].map((id) => `${id}
+`).join("");
+  for (const tPath of textPaths) {
+    try {
+      await fsPromises2.writeFile(tPath, content, "utf-8");
+    } catch {
+    }
+  }
 }
 function sanitizeFilename(rawFilename, fallbackId, ext) {
   const cleanExt = ext.replace(/^\./, "");
@@ -2804,6 +3365,14 @@ function sanitizeFilename(rawFilename, fallbackId, ext) {
   }
   return sanitizedBase.includes(".") ? sanitizedBase : `${sanitizedBase}.${cleanExt}`;
 }
+function isCdnUrl(rawUrl) {
+  try {
+    const hostname = new URL(rawUrl).hostname.toLowerCase();
+    return hostname.endsWith(".cdninstagram.com") || hostname.endsWith(".fbcdn.net") || hostname.endsWith(".tiktokcdn.com") || hostname.endsWith(".akamaized.net") || hostname === "pbs.twimg.com" || hostname === "video.twimg.com";
+  } catch {
+    return false;
+  }
+}
 async function downloadMediaStream(items, options) {
   const { jobName, destDir, signal, onProgress } = options;
   const httpClient = options.httpClient ?? new HttpClient();
@@ -2843,12 +3412,13 @@ async function downloadMediaStream(items, options) {
         consecutiveErrors++;
         const errMsg = err instanceof Error ? err.message : String(err);
         errors.push(`Extraction stream error: ${errMsg}`);
+        const cleanErr = errMsg.includes("429") ? "rate limited by platform (HTTP 429)" : errMsg.length > 50 ? `${errMsg.slice(0, 47)}\u2026` : errMsg;
         onProgress?.({
           job: jobName,
           downloadedCount: downloaded,
           skippedCount: skipped,
           currentFile: "",
-          statusText: `Extractor glitch: ${errMsg}`
+          statusText: `Extractor error: ${cleanErr}`
         });
         if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS || signal?.aborted) {
           isDone = true;
@@ -2883,10 +3453,13 @@ async function downloadMediaStream(items, options) {
         if (options.referer) {
           reqHeaders["Referer"] = options.referer;
         }
+        const isCdn = isCdnUrl(item.url);
         const response = await httpClient.request(item.url, {
           signal,
-          cookiePath: options.cookiePath,
-          headers: reqHeaders
+          cookiePath: isCdn ? void 0 : options.cookiePath,
+          headers: reqHeaders,
+          retries: 2,
+          retryDelayMs: 1500
         });
         if (!response.ok || !response.body) {
           try {
@@ -2907,6 +3480,7 @@ async function downloadMediaStream(items, options) {
         await fsPromises2.rename(tmpPath, finalPath);
         archive.add(item.id);
         downloaded++;
+        consecutiveErrors = 0;
         onProgress?.({
           job: jobName,
           downloadedCount: downloaded,
@@ -3318,8 +3892,9 @@ async function runGalleryDl(options) {
   let downloadedCount = 0;
   let skippedCount = 0;
   let errorOutput = "";
+  let engineCmdStr = "gallery-dl";
   try {
-    await ensureGalleryDl((status) => {
+    engineCmdStr = await ensureGalleryDl((status) => {
       onProgress?.({
         job: subDir,
         downloadedCount: 0,
@@ -3335,9 +3910,15 @@ async function runGalleryDl(options) {
       error: err.message || String(err)
     };
   }
-  const engineCmd = resolveEngineCommand("gallery-dl");
+  const engineCmd = engineCmdStr.includes(path8.sep) ? { command: engineCmdStr, baseArgs: [] } : resolveEngineCommand("gallery-dl");
   const fullArgs = [...engineCmd.baseArgs, ...args];
   return new Promise((resolve) => {
+    onProgress?.({
+      job: subDir,
+      downloadedCount,
+      skippedCount,
+      statusText: "downloading with gallery-dl\u2026"
+    });
     const child = spawn2(engineCmd.command, fullArgs, {
       windowsHide: true,
       stdio: ["ignore", "pipe", "pipe"],
@@ -3461,8 +4042,9 @@ async function runYtDlp(options) {
   let downloadedCount = 0;
   let skippedCount = 0;
   let errorOutput = "";
+  let engineCmdStr = "yt-dlp";
   try {
-    await ensureYtDlp((status) => {
+    engineCmdStr = await ensureYtDlp((status) => {
       onProgress?.({
         job: "Videos",
         downloadedCount: 0,
@@ -3478,9 +4060,15 @@ async function runYtDlp(options) {
       error: err.message || String(err)
     };
   }
-  const engineCmd = resolveEngineCommand("yt-dlp");
+  const engineCmd = engineCmdStr.includes(path9.sep) ? { command: engineCmdStr, baseArgs: [] } : resolveEngineCommand("yt-dlp");
   const fullArgs = [...engineCmd.baseArgs, ...args];
   return new Promise((resolve) => {
+    onProgress?.({
+      job: "Videos",
+      downloadedCount,
+      skippedCount,
+      statusText: "downloading with yt-dlp\u2026"
+    });
     const child = spawn3(engineCmd.command, fullArgs, {
       windowsHide: true,
       stdio: ["ignore", "pipe", "pipe"],
@@ -3617,7 +4205,7 @@ async function dispatchDownload(options) {
         jobs.push({ type: "highlights" });
       }
     }
-    const runNative = async (subDir) => {
+    const defaultRunNative = async (subDir) => {
       const dest = path10.join(targetDir, subDir);
       try {
         const extractor = getExtractor(profile.platform);
@@ -3650,27 +4238,34 @@ async function dispatchDownload(options) {
         };
       }
     };
-    const runGdl = (subDir) => runGalleryDl({
+    const runNative = options.runnerOverrides?.nativeRunner ?? defaultRunNative;
+    const runGdl = options.runnerOverrides?.gdlRunner ?? ((subDir) => runGalleryDl({
       profile,
       targetDir,
       subDir,
       cookiePath: cookieCopy?.filePath,
       signal: options.signal,
       onProgress
-    });
-    const runYt = () => runYtDlp({
+    }));
+    const runYt = options.runnerOverrides?.ytRunner ?? (() => runYtDlp({
       profile,
       targetDir,
       cookiePath: cookieCopy?.filePath,
       signal: options.signal,
       onProgress
-    });
+    }));
     for (const job of jobs) {
       if (options.signal?.aborted) break;
       if (job.type === "photos" || job.type === "stories" || job.type === "highlights") {
         const subDir = job.type === "photos" ? "Photos" : job.type === "stories" ? "Stories" : "Highlights";
         let res = await runNative(subDir);
         if ((!res.success || res.downloaded === 0 && res.skipped === 0) && !options.signal?.aborted) {
+          onProgress?.({
+            job: subDir,
+            downloadedCount: totalDownloaded,
+            skippedCount: totalSkipped,
+            statusText: "switching to gallery-dl engine\u2026"
+          });
           const gdlRes = await runGdl(subDir);
           if (gdlRes.downloaded > 0 || gdlRes.skipped > 0 || gdlRes.success) {
             res = gdlRes;
@@ -3685,12 +4280,24 @@ async function dispatchDownload(options) {
           totalDownloaded += res.downloaded;
           totalSkipped += res.skipped;
         } else if (!options.signal?.aborted) {
+          onProgress?.({
+            job: "Videos",
+            downloadedCount: totalDownloaded,
+            skippedCount: totalSkipped,
+            statusText: "switching to yt-dlp engine\u2026"
+          });
           const fbRes = await runYt();
           if (fbRes.downloaded > 0 || fbRes.skipped > 0 || fbRes.success) {
             totalDownloaded += fbRes.downloaded;
             totalSkipped += fbRes.skipped;
             if (!fbRes.success && fbRes.error) errors.push(`[Videos] ${fbRes.error}`);
           } else if (!options.signal?.aborted) {
+            onProgress?.({
+              job: "Videos",
+              downloadedCount: totalDownloaded,
+              skippedCount: totalSkipped,
+              statusText: "switching to gallery-dl engine\u2026"
+            });
             const gdlRes = await runGdl("Videos");
             totalDownloaded += gdlRes.downloaded;
             totalSkipped += gdlRes.skipped;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "open-nami",
-  "version": "1.0.4",
-  "description": "Open Nami — terminal-first bulk social media profile downloader for Instagram, TikTok, Facebook & X.",
+  "version": "1.0.6",
+  "description": "Open Nami: terminal-first bulk social media profile downloader for Instagram, TikTok, Facebook & X.",
   "type": "module",
   "bin": {
     "open-nami": "dist/cli.js",