open-nami 1.2.0 → 1.2.2

package/dist/cli.js

@@ -9,7 +9,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "open-nami",
-      version: "1.2.0",
+      version: "1.2.2",
       description: "Open Nami: terminal-first bulk social media profile downloader for Instagram, TikTok, Facebook & X.",
       type: "module",
       bin: {
@@ -729,6 +729,7 @@ async function clearCheckpoint(destDir) {
 import path10 from "path";
 import os5 from "os";
 import fs10 from "fs/promises";
+import fsSync from "fs";
 
 // src/lib/cookies.ts
 import fs2 from "fs";
@@ -1210,6 +1211,9 @@ var IG_QUERIES = {
   PolarisProfilePageContentQuery: "28649589871350527"
 };
 var IG_POLARIS_DOC_ID = IG_QUERIES.PolarisProfilePostsTabContentQuery_connection;
+function isExplicitAuthError(msg) {
+  return msg.includes("401") || msg.includes("403") || msg.includes("login_required") || msg.includes("checkpoint_required") || msg.includes("not-logged-in");
+}
 function logExtractorDebug(endpoint, err) {
   if (process.env.DEBUG || process.env.OPEN_NAMI_DEBUG) {
     const message = err instanceof Error ? err.message : String(err);
@@ -1378,39 +1382,63 @@ var InstagramExtractor = class {
     }
     return user;
   }
-  async fetchHighlightsTray(userId, options) {
+  async fetchHighlightsTray(userId, options, tokens) {
+    let authError = null;
     try {
       const variables = JSON.stringify({ user_id: userId });
-      const body = new URLSearchParams({
-        doc_id: IG_QUERIES.PolarisProfileStoryHighlightsTrayContentQuery,
-        variables
-      }).toString();
+      const bodyParams = new URLSearchParams({
+        av: "17841415137994167",
+        __d: "www",
+        __user: "0",
+        __a: "1",
+        __req: "0",
+        dpr: "1",
+        fb_api_caller_class: "RelayModern",
+        fb_api_req_friendly_name: "PolarisProfileStoryHighlightsTrayContentQuery",
+        server_timestamps: "true",
+        variables,
+        doc_id: IG_QUERIES.PolarisProfileStoryHighlightsTrayContentQuery
+      });
+      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-FB-Friendly-Name": "PolarisProfileStoryHighlightsTrayContentQuery",
+        "Referer": "https://www.instagram.com/",
+        "Origin": "https://www.instagram.com",
+        "X-ASBD-ID": "359341"
+      };
+      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,
+        body: bodyParams.toString(),
         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": "PolarisProfileStoryHighlightsTrayContentQuery",
-          "Referer": "https://www.instagram.com/"
-        }
+        headers
       });
       const edges = res?.data?.highlights?.edges;
-      if (Array.isArray(edges) && edges.length > 0) {
+      if (Array.isArray(edges)) {
         if (res?.errors && Array.isArray(res.errors) && res.errors.length > 0) {
           logExtractorDebug("PolarisProfileStoryHighlightsTrayContentQuery partial field errors", res.errors);
         }
-        return edges.map((e) => e.node);
+        return edges.map((e) => e.node).filter(Boolean);
       }
       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}`);
+        if (isExplicitAuthError(errMsg)) {
+          authError = new Error("Instagram Highlights require an active authenticated session. Your session cookie is missing or expired. Update your cookies in Settings (^s).");
+        }
       }
     } catch (err) {
       logExtractorDebug("PolarisProfileStoryHighlightsTrayContentQuery", err);
+      const msg = err instanceof Error ? err.message : String(err);
+      if (isExplicitAuthError(msg)) {
+        authError = new Error("Instagram Highlights require an active authenticated session. Your session cookie is missing or expired. Update your cookies in Settings (^s).");
+      }
     }
     const url = `https://www.instagram.com/api/v1/highlights/${userId}/highlights_tray/`;
     try {
@@ -1419,17 +1447,84 @@ var InstagramExtractor = class {
         cookieDomain: "instagram.com",
         signal: options.signal,
         headers: {
-          "X-IG-App-ID": IG_APP_ID
+          "X-IG-App-ID": IG_APP_ID,
+          "Referer": "https://www.instagram.com/"
         }
       });
-      return res.tray ?? [];
+      if (res?.message === "login_required" || res?.message === "checkpoint_required") {
+        throw new Error("Instagram Highlights require an active authenticated session. Your session cookie is missing or expired. Update your cookies in Settings (^s).");
+      }
+      return res?.tray ?? [];
     } catch (err) {
       logExtractorDebug("Highlights legacy REST", err);
+      const msg = err instanceof Error ? err.message : String(err);
+      if (isExplicitAuthError(msg)) {
+        throw new Error("Instagram Highlights require an active authenticated session. Your session cookie is missing or expired. Update your cookies in Settings (^s).");
+      }
+      if (authError) throw authError;
       return [];
     }
   }
-  async fetchReelsMedia(reelIds, options) {
+  async fetchReelsMediaGraphQL(reelIds, options, tokens) {
     if (reelIds.length === 0) return [];
+    try {
+      const variables = JSON.stringify({
+        initial_reel_id: reelIds[0],
+        reel_ids: reelIds,
+        first: 3,
+        last: 2,
+        __relay_internal__pv__PolarisCommunityNoteStoriesLabelEnabledrelayprovider: true
+      });
+      const bodyParams = new URLSearchParams({
+        av: "17841415137994167",
+        __d: "www",
+        __user: "0",
+        __a: "1",
+        __req: "0",
+        dpr: "1",
+        fb_api_caller_class: "RelayModern",
+        fb_api_req_friendly_name: "PolarisStoriesV3ReelPageGalleryQuery",
+        server_timestamps: "true",
+        variables,
+        doc_id: IG_QUERIES.PolarisStoriesV3ReelPageGalleryQuery
+      });
+      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-FB-Friendly-Name": "PolarisStoriesV3ReelPageGalleryQuery",
+        "Referer": "https://www.instagram.com/",
+        "Origin": "https://www.instagram.com",
+        "X-ASBD-ID": "359341"
+      };
+      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
+      });
+      const connection = res?.data?.xdt_api__v1__feed__reels_media__connection;
+      const edges = connection?.edges;
+      if (Array.isArray(edges) && edges.length > 0) {
+        return edges.map((e) => e.node).filter(Boolean);
+      }
+    } catch (err) {
+      logExtractorDebug("PolarisStoriesV3ReelPageGalleryQuery", err);
+    }
+    return [];
+  }
+  async fetchReelsMedia(reelIds, options, tokens) {
+    if (reelIds.length === 0) return [];
+    const gqlReels = await this.fetchReelsMediaGraphQL(reelIds, options, tokens);
+    if (gqlReels.length > 0) {
+      return gqlReels;
+    }
     const idsParam = reelIds.join(",");
     const url = `https://www.instagram.com/api/v1/feed/reels_media/?reel_ids=${encodeURIComponent(idsParam)}`;
     try {
@@ -1438,13 +1533,22 @@ var InstagramExtractor = class {
         cookieDomain: "instagram.com",
         signal: options.signal,
         headers: {
-          "X-IG-App-ID": IG_APP_ID
+          "X-IG-App-ID": IG_APP_ID,
+          "Referer": "https://www.instagram.com/"
         }
       });
-      if (res.reels_media) return res.reels_media;
-      if (res.reels) return Object.values(res.reels);
+      if (res?.message === "login_required" || res?.message === "checkpoint_required") {
+        throw new Error("Instagram Stories require an active authenticated session. Your session cookie is missing or expired. Update your cookies in Settings (^s).");
+      }
+      if (res?.reels_media) return res.reels_media;
+      if (res?.reels) return Object.values(res.reels);
       return [];
-    } catch {
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (isExplicitAuthError(msg)) {
+        throw new Error("Instagram Stories require an active authenticated session. Your session cookie is missing or expired. Update your cookies in Settings (^s).");
+      }
+      logExtractorDebug("Reels media legacy REST", err);
       return [];
     }
   }
@@ -1570,16 +1674,23 @@ var InstagramExtractor = class {
       for (const edge of connection.edges) {
         const node = edge?.node;
         if (node?.owner_id) {
-          resolvedUserId = String(node.owner_id);
-          break;
+          if (typeof node.owner_id === "object" && node.owner_id !== null) {
+            resolvedUserId = String(node.owner_id.pk || node.owner_id.id || "");
+          } else {
+            resolvedUserId = String(node.owner_id);
+          }
+          if (resolvedUserId && resolvedUserId !== "[object Object]") break;
         }
         if (node?.user?.pk || node?.user?.id) {
           resolvedUserId = String(node.user.pk || node.user.id);
-          break;
+          if (resolvedUserId && resolvedUserId !== "[object Object]") break;
         }
         if (typeof node?.id === "string" && node.id.includes("_")) {
-          resolvedUserId = node.id.split("_")[1];
-          break;
+          const candidate = node.id.split("_")[1];
+          if (candidate && candidate !== "[object Object]") {
+            resolvedUserId = candidate;
+            break;
+          }
         }
       }
       return {
@@ -1739,10 +1850,10 @@ var InstagramExtractor = class {
       logExtractorDebug("fetchWebTokens", err);
     }
     let userId = user?.id || webTokens.userId;
-    if (!userId && (subDir === "Stories" || subDir === "Highlights")) {
+    if ((!userId || userId === "[object Object]") && (subDir === "Stories" || subDir === "Highlights")) {
       try {
         const probe = await this.fetchPostsTabGraphQL(username, void 0, webTokens, options);
-        if (probe.userId) {
+        if (probe.userId && probe.userId !== "[object Object]") {
           userId = probe.userId;
         }
       } catch (err) {
@@ -1750,44 +1861,81 @@ var InstagramExtractor = class {
       }
     }
     if (subDir === "Stories") {
-      if (!userId) return;
+      if (!userId || userId === "[object Object]") {
+        throw new Error(`Could not resolve user ID for @${username}. Profile may be private or unavailable.`);
+      }
+      if (user?.latest_reel_media === 0) {
+        options.onProgress?.({
+          stage: "Stories",
+          found: 0,
+          message: `Profile @${username} has no active stories in the last 24 hours.`
+        });
+        return;
+      }
       options.onProgress?.({
         stage: "Stories",
         found: 0,
         message: `Fetching stories for @${username}...`
       });
-      const reels = await this.fetchReelsMedia([userId], options);
+      const reels = await this.fetchReelsMedia([userId], options, webTokens);
+      let count = 0;
       for (const reel of reels) {
         for (const rawItem of reel.items || []) {
           const item = parseReelItemToMediaItem(rawItem, username);
-          if (item) yield item;
+          if (item) {
+            count++;
+            yield item;
+          }
         }
       }
+      if (count === 0) {
+        options.onProgress?.({
+          stage: "Stories",
+          found: 0,
+          message: `Profile @${username} has no active stories in the last 24 hours.`
+        });
+      }
       return;
     }
     if (subDir === "Highlights") {
-      if (!userId) return;
+      if (!userId || userId === "[object Object]") {
+        throw new Error(`Could not resolve user ID for @${username}. Profile may be private or unavailable.`);
+      }
+      if (user?.highlight_reel_count === 0) {
+        options.onProgress?.({
+          stage: "Highlights",
+          found: 0,
+          message: `Profile @${username} has no available highlights.`
+        });
+        return;
+      }
       options.onProgress?.({
         stage: "Highlights",
         found: 0,
         message: `Fetching highlights tray for @${username}...`
       });
-      const tray = await this.fetchHighlightsTray(userId, options);
+      const tray = await this.fetchHighlightsTray(userId, options, webTokens);
       const highlightIds = tray.map((t) => t.id).filter(Boolean);
-      if (highlightIds.length > 0) {
-        const chunkSize = 5;
-        for (let i = 0; i < highlightIds.length; i += chunkSize) {
-          if (options.signal?.aborted) break;
-          const chunk = highlightIds.slice(i, i + chunkSize);
-          const reels = await this.fetchReelsMedia(chunk, options);
-          for (const reel of reels) {
-            for (const rawItem of reel.items || []) {
-              const item = parseReelItemToMediaItem(rawItem, username);
-              if (item) yield item;
-            }
+      if (highlightIds.length === 0) {
+        options.onProgress?.({
+          stage: "Highlights",
+          found: 0,
+          message: `Profile @${username} has no available highlights.`
+        });
+        return;
+      }
+      const chunkSize = 5;
+      for (let i = 0; i < highlightIds.length; i += chunkSize) {
+        if (options.signal?.aborted) break;
+        const chunk = highlightIds.slice(i, i + chunkSize);
+        const reels = await this.fetchReelsMedia(chunk, options, webTokens);
+        for (const reel of reels) {
+          for (const rawItem of reel.items || []) {
+            const item = parseReelItemToMediaItem(rawItem, username);
+            if (item) yield item;
           }
-          await sleep(1e3, 1500, options.signal);
         }
+        await sleep(1e3, 1500, options.signal);
       }
       return;
     }
@@ -2967,11 +3115,12 @@ async function downloadMediaStream(items, options) {
     }
     return arch;
   };
-  await getArchiveForDir(destDir);
-  if (options.destDirMap) {
+  if (options.destDirMap && Object.values(options.destDirMap).some(Boolean)) {
     for (const d of Object.values(options.destDirMap)) {
       if (d) await getArchiveForDir(d);
     }
+  } else {
+    await getArchiveForDir(destDir);
   }
   let downloaded = 0;
   let skipped = 0;
@@ -3605,7 +3754,7 @@ function buildGalleryDlArgs(options) {
 }
 async function runGalleryDl(options) {
   const { profile, targetDir, subDir, cookiePath, onProgress } = options;
-  const destDir = path8.join(targetDir, subDir);
+  const destDir = subDir === "All" ? targetDir : path8.join(targetDir, subDir);
   await fs8.mkdir(destDir, { recursive: true });
   const args = buildGalleryDlArgs({
     destDir,
@@ -3909,6 +4058,30 @@ function resolveDefaultDownloadDir(platform, username, baseDir) {
   const root = resolveDownloadBaseDir(baseDir);
   return path10.join(root, platform, username);
 }
+async function cleanupEmptyCategoryDirs(targetDir) {
+  const candidateDirs = ["All", "Stories", "Highlights", "Photos", "Videos"];
+  for (const dirName of candidateDirs) {
+    const fullPath = path10.join(targetDir, dirName);
+    try {
+      if (!fsSync.existsSync(fullPath)) continue;
+      const entries = await fs10.readdir(fullPath);
+      const nonArchiveEntries = entries.filter(
+        (e) => e !== ".open-nami-archive.json" && e !== "archive.txt" && e !== "archive_yt-dlp.txt" && e !== "archive_gallery-dl.sqlite3"
+      );
+      if (nonArchiveEntries.length === 0) {
+        for (const entry of entries) {
+          try {
+            await fs10.unlink(path10.join(fullPath, entry));
+          } catch {
+          }
+        }
+        await fs10.rmdir(fullPath).catch(() => {
+        });
+      }
+    } catch {
+    }
+  }
+}
 async function dispatchDownload(options) {
   const { profile, choice, onProgress } = options;
   const targetDir = options.outputDir || resolveDefaultDownloadDir(profile.platform, profile.username);
@@ -3941,7 +4114,7 @@ async function dispatchDownload(options) {
     const savedCheckpoint = options.resume ? await loadCheckpoint(targetDir) : null;
     const currentCursors = savedCheckpoint?.cursors ? { ...savedCheckpoint.cursors } : {};
     const defaultRunNative = async (subDir) => {
-      const dest = path10.join(targetDir, subDir);
+      const dest = subDir === "All" ? targetDir : path10.join(targetDir, subDir);
       const remainingLimit = globalLimit !== void 0 ? Math.max(0, globalLimit - totalDownloaded) : void 0;
       if (remainingLimit === 0) {
         return { success: true, downloaded: 0, skipped: 0 };
@@ -4076,7 +4249,8 @@ async function dispatchDownload(options) {
       } else 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) {
+        const isAuthError = Boolean(res.error && (res.error.includes("cookie") || res.error.includes("authenticated session") || res.error.includes("Settings (^s)")));
+        if (!isAuthError && (!res.success || res.downloaded === 0 && res.skipped === 0) && !options.signal?.aborted) {
           onProgress?.({
             job: subDir,
             downloadedCount: totalDownloaded,
@@ -4084,7 +4258,7 @@ async function dispatchDownload(options) {
             statusText: "switching to gallery-dl engine\u2026"
           });
           const gdlRes = await runGdl(subDir);
-          if (gdlRes.downloaded > 0 || gdlRes.skipped > 0 || gdlRes.success) {
+          if (gdlRes.downloaded > 0 || gdlRes.skipped > 0 || gdlRes.success && !res.error) {
             res = gdlRes;
           }
         }
@@ -4123,6 +4297,7 @@ async function dispatchDownload(options) {
         }
       }
     }
+    await cleanupEmptyCategoryDirs(targetDir);
     if (errors.length === 0 && !options.signal?.aborted) {
       await clearCheckpoint(targetDir);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-nami",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Open Nami: terminal-first bulk social media profile downloader for Instagram, TikTok, Facebook & X.",
   "type": "module",
   "bin": {