@chilfish/gallery-dl-instagram 0.2.0 → 0.2.3

package/dist/index.cjs

@@ -1,5 +1,183 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk = require("./sdk-nzhAxf1O.cjs");
+const require_sdk = require("./sdk-D8q2Rjw2.cjs");
+//#region src/core/print-job.ts
+var PrintJob = class PrintJob extends require_sdk.Job {
+	_currentDir = {};
+	_files = [];
+	_postCount = 0;
+	_fileCount = 0;
+	_width;
+	constructor(extractor) {
+		super(extractor);
+		this._width = Math.min(process.stdout.columns ?? 80, 100);
+	}
+	async handleDirectory(msg) {
+		if (this._postCount > 0) this._flushPost();
+		this._currentDir = { ...msg.metadata };
+		this._postCount++;
+		this._files = [];
+	}
+	async handleUrl(msg) {
+		const meta = {
+			...this._currentDir,
+			...msg.metadata
+		};
+		this._fileCount++;
+		const ext = meta.extension ?? "jpg";
+		const mid = meta.media_id ?? "?";
+		this._files.push({
+			num: meta.num ?? this._files.length + 1,
+			filename: `${mid}.${ext}`,
+			width: meta.width ?? 0,
+			height: meta.height ?? 0,
+			videoUrl: meta.video_url ?? null,
+			audioUrl: meta.audio_url ?? null,
+			audioTitle: meta.audio_title ?? void 0,
+			audioArtist: meta.audio_artist ?? void 0,
+			audioDuration: meta.audio_duration ?? void 0,
+			audioHasLyrics: meta.audio_has_lyrics ?? void 0,
+			audioIsExplicit: meta.audio_is_explicit ?? void 0,
+			coverArtworkUri: meta.audio_cover_artwork_uri ?? meta.audio_cover_artwork_thumbnail_uri ?? void 0
+		});
+	}
+	async handleQueue(msg) {
+		if (this._files.length > 0 || this._postCount > 0) this._flushPost();
+		this._postCount = 0;
+		this._files = [];
+		const extrClass = {
+			...this._currentDir,
+			...msg.metadata
+		}._extractor;
+		if (!extrClass || typeof extrClass !== "object") return;
+		const cls = extrClass;
+		const match = cls.pattern.exec(msg.url);
+		if (!match) return;
+		const parentExtr = this.extractor;
+		const childJob = new PrintJob(Reflect.construct(cls, [{
+			url: msg.url,
+			match,
+			config: parentExtr.config,
+			http: parentExtr.http,
+			storage: parentExtr.storage,
+			log: parentExtr.log
+		}]));
+		const childStatus = await childJob.run();
+		this.status |= childStatus;
+		this._postCount += childJob._postCount;
+		this._fileCount += childJob._fileCount;
+	}
+	_flushPost() {
+		const m = this._currentDir;
+		if (Object.keys(m).length === 0) return;
+		const w = this._width;
+		const labelW = 14;
+		const shortcode = m.post_shortcode ?? "?";
+		const header = ` Post #${this._postCount}: ${shortcode} `;
+		const padTotal = w - 2 - header.length;
+		const padL = Math.floor(padTotal / 2);
+		const padR = padTotal - padL;
+		process.stdout.write(`\n${require_sdk.dim("┌")}${"─".repeat(padL)}${require_sdk.b(header)}${"─".repeat(padR)}${require_sdk.dim("┐")}\n`);
+		const row = (label, value, color) => {
+			const colored = typeof color === "function" ? color(value) : color ? `${color}${value}${require_sdk._RESET}` : value;
+			process.stdout.write(` ${require_sdk.dim("│")} ${require_sdk.c(require_sdk.pad(label, labelW))} ${colored}\n`);
+		};
+		const username = m.username ?? "?";
+		const fullname = m.fullname ?? "";
+		row("Author:", fullname ? `${username} (${fullname})` : username, require_sdk.g);
+		row("Date:", m.date ?? m.post_date ?? "?");
+		row("Likes:", `${typeof m.likes === "number" ? m.likes.toLocaleString() : "?"}  |  Liked: ${m.liked ? "yes" : "no"}`);
+		row("Type:", `${m.type ?? "?"}  (${this._files.length} files)`);
+		row("URL:", m.post_url ?? "?");
+		const desc = m.description ?? "";
+		if (desc) {
+			process.stdout.write(` ${require_sdk.dim("│")}\n`);
+			process.stdout.write(` ${require_sdk.dim("│")} ${require_sdk.b("Description:")}\n`);
+			for (const line of desc.split("\n")) for (const wl of this._wrap(line, w - 8)) process.stdout.write(` ${require_sdk.dim("│")}   ${require_sdk.dim(wl)}\n`);
+		}
+		const tags = m.tags;
+		if (tags && tags.length > 0) {
+			process.stdout.write(` ${require_sdk.dim("│")}\n`);
+			process.stdout.write(` ${require_sdk.dim("│")} ${require_sdk.b("Tags:")} ${require_sdk.dim(tags.map((t) => `#${t}`).join("  "))}\n`);
+		}
+		const locName = m.location_slug ?? "";
+		const locId = m.location_id ?? "";
+		if (locName || locId) row("Location:", locId ? `${locName} (ID: ${locId})` : locName);
+		const coauthors = m.coauthors;
+		if (coauthors && coauthors.length > 0) row("Co-authors:", coauthors.map((c) => c.full_name ? `${c.username} (${c.full_name})` : c.username).join(", "));
+		const pinned = m.pinned;
+		if (pinned && pinned.length > 0) row("Pinned:", pinned.join(", "));
+		const expires = m.expires;
+		if (expires) row("Expires:", expires, require_sdk._YELLOW);
+		const hlTitle = m.highlight_title;
+		if (hlTitle) row("Highlight:", hlTitle);
+		const taggedUser = m.tagged_username ?? "";
+		if (taggedUser) {
+			const taggedFull = m.tagged_full_name ?? "";
+			row("Tagged by:", taggedFull ? `${taggedUser} (${taggedFull})` : taggedUser);
+		}
+		if (this._files.length > 0) {
+			process.stdout.write(` ${require_sdk.dim("│")}\n`);
+			process.stdout.write(` ${require_sdk.dim("│")} ${require_sdk.b(`Media (${this._files.length} files):`)}\n`);
+			const maxNumW = String(this._files.length).length;
+			const maxFileW = Math.max(...this._files.map((f) => f.filename.length));
+			const dimW = Math.min(maxFileW, 40);
+			for (const f of this._files) {
+				const numStr = `[${String(f.num).padStart(maxNumW)}]`;
+				const dimStr = f.filename.length > 40 ? `${f.filename.slice(0, 37)}...` : require_sdk.pad(f.filename, dimW);
+				const res = f.width ? `${f.width}x${f.height}` : "?x?";
+				const badges = [];
+				if (f.videoUrl) badges.push("video");
+				if (f.audioUrl) badges.push("audio");
+				let line = ` ${require_sdk.dim("│")}   ${require_sdk.g(numStr)} ${dimStr}  ${res}`;
+				if (badges.length > 0) line += `  ${require_sdk._YELLOW}(${badges.join("+")})${require_sdk._RESET}`;
+				process.stdout.write(`${line}\n`);
+			}
+		}
+		const audioFiles = this._files.filter((f) => f.audioUrl);
+		if (audioFiles.length > 0) {
+			process.stdout.write(` ${require_sdk.dim("│")}\n`);
+			process.stdout.write(` ${require_sdk.dim("│")} ${require_sdk.b("Music:")}\n`);
+			for (const af of audioFiles) {
+				if (af.audioTitle) {
+					const title = af.audioArtist ? `${af.audioTitle} — ${af.audioArtist}` : af.audioTitle;
+					process.stdout.write(` ${require_sdk.dim("│")}   ${require_sdk.g("♪")} ${title}\n`);
+				}
+				if (af.audioDuration) {
+					const mins = Math.floor(af.audioDuration / 60);
+					const secs = Math.round(af.audioDuration % 60);
+					const badges = [`${mins}:${String(secs).padStart(2, "0")}`];
+					if (af.audioHasLyrics) badges.push("lyrics");
+					if (af.audioIsExplicit) badges.push(`${require_sdk._YELLOW}explicit${require_sdk._RESET}`);
+					process.stdout.write(` ${require_sdk.dim("│")}   ${require_sdk.dim(badges.join(" · "))}\n`);
+				}
+				if (af.coverArtworkUri) process.stdout.write(` ${require_sdk.dim("│")}   ${require_sdk.dim("Art:")} ${require_sdk.dim(`${af.coverArtworkUri.slice(0, 60)}…`)}\n`);
+			}
+		}
+		process.stdout.write(` ${require_sdk.dim("└")}${"─".repeat(w - 2)}${require_sdk.dim("┘")}\n`);
+	}
+	_wrap(text, maxLen) {
+		if (text.length <= maxLen) return [text];
+		const lines = [];
+		let remaining = text;
+		while (remaining.length > maxLen) {
+			let cut = maxLen;
+			while (cut > 0 && remaining[cut] !== " ") cut--;
+			if (cut === 0) cut = maxLen;
+			lines.push(remaining.slice(0, cut).trimEnd());
+			remaining = remaining.slice(cut).trimStart();
+		}
+		if (remaining) lines.push(remaining);
+		return lines;
+	}
+	_report() {
+		this._flushPost();
+		process.stdout.write(`\n${require_sdk.dim("──")} ${require_sdk.b("Summary")} ${require_sdk.dim("───")}\n`);
+		process.stdout.write(`  Posts: ${require_sdk.g(String(this._postCount))}\n`);
+		process.stdout.write(`  Files: ${require_sdk.g(String(this._fileCount))}\n`);
+		process.stdout.write(`\n`);
+	}
+};
+//#endregion
 exports.ConfigManager = require_sdk.ConfigManager;
 exports.DownloadJob = require_sdk.DownloadJob;
 exports.Extractor = require_sdk.Extractor;
@@ -18,7 +196,7 @@ exports.InstagramTagExtractor = require_sdk.InstagramTagExtractor;
 exports.InstagramTaggedExtractor = require_sdk.InstagramTaggedExtractor;
 exports.InstagramUserExtractor = require_sdk.InstagramUserExtractor;
 exports.Job = require_sdk.Job;
-exports.PrintJob = require_sdk.PrintJob;
+exports.PrintJob = PrintJob;
 exports.directory = require_sdk.directory;
 exports.ensureHttpScheme = require_sdk.ensureHttpScheme;
 exports.extr = require_sdk.extr;

package/dist/index.d.cts

@@ -1,14 +1,11 @@
-import { _ as Metadata, a as ExtractorOptions, b as Storage, c as ConfigManager, d as DirectoryMsg, f as ExtractorClass, g as MessageIter, h as Message, i as Extractor, l as Config, m as HttpResponse, n as InstagramSDK, o as Logger, p as HttpClient, r as SDKOptions, s as noopLogger, t as ExtractOptions, u as ConfigValue, v as QueueMsg, x as UrlMsg, y as RequestConfig } from "./sdk-CK9x5wFL.cjs";
+import { _ as Metadata, a as ExtractorOptions, b as Storage, c as ConfigManager, d as DirectoryMsg, f as ExtractorClass, g as MessageIter, h as Message, i as Extractor, l as Config, m as HttpResponse, n as InstagramSDK, o as Logger, p as HttpClient, r as SDKOptions, s as noopLogger, t as ExtractOptions, u as ConfigValue, v as QueueMsg, x as UrlMsg, y as RequestConfig } from "./sdk-DyZz22bT.cjs";
 
 //#region src/core/job.d.ts
 declare abstract class Job {
   readonly extractor: Extractor;
   status: number;
   constructor(extractor: Extractor);
-  /**
-   * Main entry point.  Calls ``extractor[Symbol.asyncIterator]()`` and
-   * dispatches every yielded message.
-   */
+  /** Main entry point. Dispatches every yielded message. */
   run(): Promise<number>;
   /** Override in subclasses to print a summary. */
   protected _report(): void;
@@ -16,7 +13,8 @@ declare abstract class Job {
   abstract handleUrl(msg: UrlMsg): Promise<void>;
   abstract handleQueue(msg: QueueMsg): Promise<void>;
 }
-/** An in-memory archive: category → Set<archive-key>. */
+//#endregion
+//#region src/core/download-job.d.ts
 type ArchiveMap = Map<string, Set<string>>;
 declare class DownloadJob extends Job {
   /** Base output directory (prepended to all paths). */
@@ -25,32 +23,24 @@ declare class DownloadJob extends Job {
   private _currentDir;
   /** In-memory archive keyed by archive format. */
   readonly archive: ArchiveMap;
-  /**
-   * Registry of per-category "archive formats" — the key is formed
-   * by interpolating this format string over the metadata.
-   */
   private readonly _archiveFmts;
   private _postCount;
   private _fileCount;
   private _downloadedBytes;
   private _skippedCount;
   registerArchive(category: string, format: string): void;
-  /** Simple format-string interpolation for archive keys. */
   private _interp;
-  /** Check whether this URL has already been downloaded (and skip). */
   private _isArchived;
-  /** Mark a post/media as archived. */
   private _archive;
-  /** Handlers */
   handleDirectory(msg: DirectoryMsg): Promise<void>;
   handleUrl(msg: UrlMsg): Promise<void>;
   handleQueue(msg: QueueMsg): Promise<void>;
-  /** Report */
   protected _report(): void;
-  /** Path builders */
   private _buildDirPath;
   private _buildFilename;
 }
+//#endregion
+//#region src/core/print-job.d.ts
 declare class PrintJob extends Job {
   private _currentDir;
   private _files;
@@ -61,7 +51,6 @@ declare class PrintJob extends Job {
   handleDirectory(msg: DirectoryMsg): Promise<void>;
   handleUrl(msg: UrlMsg): Promise<void>;
   handleQueue(msg: QueueMsg): Promise<void>;
-  /** Output */
   private _flushPost;
   private _wrap;
   protected _report(): void;
@@ -108,6 +97,7 @@ interface InstagramUser {
     count: number;
   };
   followed_by_viewer?: boolean;
+  is_verified?: boolean;
 }
 interface ImageCandidate {
   url: string;
@@ -152,19 +142,25 @@ interface MusicSticker {
 interface MusicAssetInfo {
   id: string;
   title?: string;
+  sanitized_title?: string;
+  subtitle?: string;
   display_artist?: string;
   ig_artist?: string;
+  ig_username?: string;
   duration_in_ms?: number;
   highlight_start_times_in_ms?: number[];
   progressive_download_url: string;
   cover_artwork_uri?: string;
+  cover_artwork_thumbnail_uri?: string;
+  has_lyrics?: boolean;
+  is_explicit?: boolean;
 }
 interface MusicConsumptionInfo {
   display_artist?: string;
   ig_artist?: string;
 }
 interface MusicMetadata {
-  music_info?: MusicAssetInfo;
+  music_info?: MusicSticker;
 }
 interface InstagramPost {
   pk: string;
@@ -285,9 +281,14 @@ interface ParsedMedia {
   audio_url?: string;
   audio_user?: string;
   audio_title?: string;
+  audio_subtitle?: string;
   audio_artist?: string;
   audio_duration?: number;
   audio_timestamps?: number[];
+  audio_cover_artwork_uri?: string;
+  audio_cover_artwork_thumbnail_uri?: string;
+  audio_has_lyrics?: boolean;
+  audio_is_explicit?: boolean;
   _ytdl_manifest_data?: string;
   sidecar_media_id?: string;
   sidecar_shortcode?: string;
@@ -433,24 +434,48 @@ declare abstract class InstagramExtractor extends Extractor {
   protected _assignUser(user: InstagramUser): void;
 }
 //#endregion
-//#region src/instagram/extractors.d.ts
-declare class InstagramPostExtractor extends InstagramExtractor {
-  static readonly subcategory = "post";
+//#region src/instagram/extractors/avatar.d.ts
+declare class InstagramAvatarExtractor extends InstagramExtractor {
+  static readonly subcategory = "avatar";
   static pattern: RegExp;
-  readonly subcategory = "post";
+  readonly subcategory = "avatar";
   constructor(opts: InstagramExtractorOptions);
-  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramPostExtractor | null;
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramAvatarExtractor | null;
   posts(): AsyncGenerator<InstagramPost>;
 }
-declare class InstagramUserExtractor extends InstagramExtractor {
-  static readonly subcategory = "user";
+//#endregion
+//#region src/instagram/extractors/highlights.d.ts
+declare class InstagramHighlightsExtractor extends InstagramExtractor {
+  static readonly subcategory = "highlights";
   static pattern: RegExp;
-  readonly subcategory = "user";
+  readonly subcategory = "highlights";
   constructor(opts: InstagramExtractorOptions);
-  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramUserExtractor | null;
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramHighlightsExtractor | null;
+  posts(): AsyncGenerator<InstagramPost>;
+}
+//#endregion
+//#region src/instagram/extractors/info.d.ts
+declare class InstagramInfoExtractor extends InstagramExtractor {
+  static readonly subcategory = "info";
+  static pattern: RegExp;
+  readonly subcategory = "info";
+  constructor(opts: InstagramExtractorOptions);
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramInfoExtractor | null;
   items(): MessageIter;
   posts(): AsyncGenerator<InstagramPost>;
 }
+//#endregion
+//#region src/instagram/extractors/post.d.ts
+declare class InstagramPostExtractor extends InstagramExtractor {
+  static readonly subcategory = "post";
+  static pattern: RegExp;
+  readonly subcategory = "post";
+  constructor(opts: InstagramExtractorOptions);
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramPostExtractor | null;
+  posts(): AsyncGenerator<InstagramPost>;
+}
+//#endregion
+//#region src/instagram/extractors/posts-list.d.ts
 declare class InstagramPostsExtractor extends InstagramExtractor {
   static readonly subcategory = "posts";
   static pattern: RegExp;
@@ -459,6 +484,8 @@ declare class InstagramPostsExtractor extends InstagramExtractor {
   static fromURL(url: string, opts: InstagramExtractorOptions): InstagramPostsExtractor | null;
   posts(): AsyncGenerator<InstagramPost>;
 }
+//#endregion
+//#region src/instagram/extractors/reels-list.d.ts
 declare class InstagramReelsExtractor extends InstagramExtractor {
   static readonly subcategory = "reels";
   static pattern: RegExp;
@@ -467,16 +494,18 @@ declare class InstagramReelsExtractor extends InstagramExtractor {
   static fromURL(url: string, opts: InstagramExtractorOptions): InstagramReelsExtractor | null;
   posts(): AsyncGenerator<InstagramPost>;
 }
-declare class InstagramTaggedExtractor extends InstagramExtractor {
-  static readonly subcategory = "tagged";
+//#endregion
+//#region src/instagram/extractors/saved.d.ts
+declare class InstagramSavedExtractor extends InstagramExtractor {
+  static readonly subcategory = "saved";
   static pattern: RegExp;
-  readonly subcategory = "tagged";
-  private _taggedUserId;
+  readonly subcategory = "saved";
   constructor(opts: InstagramExtractorOptions);
-  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramTaggedExtractor | null;
-  metadata(): Promise<Record<string, unknown>>;
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramSavedExtractor | null;
   posts(): AsyncGenerator<InstagramPost>;
 }
+//#endregion
+//#region src/instagram/extractors/stories.d.ts
 declare class InstagramStoriesExtractor extends InstagramExtractor {
   static readonly subcategory = "stories";
   static pattern: RegExp;
@@ -487,14 +516,8 @@ declare class InstagramStoriesExtractor extends InstagramExtractor {
   static fromURL(url: string, opts: InstagramExtractorOptions): InstagramStoriesExtractor | null;
   posts(): AsyncGenerator<InstagramPost>;
 }
-declare class InstagramHighlightsExtractor extends InstagramExtractor {
-  static readonly subcategory = "highlights";
-  static pattern: RegExp;
-  readonly subcategory = "highlights";
-  constructor(opts: InstagramExtractorOptions);
-  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramHighlightsExtractor | null;
-  posts(): AsyncGenerator<InstagramPost>;
-}
+//#endregion
+//#region src/instagram/extractors/tag.d.ts
 declare class InstagramTagExtractor extends InstagramExtractor {
   static readonly subcategory = "tag";
   static pattern: RegExp;
@@ -504,41 +527,41 @@ declare class InstagramTagExtractor extends InstagramExtractor {
   metadata(): Promise<Record<string, unknown>>;
   posts(): AsyncGenerator<InstagramPost>;
 }
-declare class InstagramInfoExtractor extends InstagramExtractor {
-  static readonly subcategory = "info";
-  static pattern: RegExp;
-  readonly subcategory = "info";
-  constructor(opts: InstagramExtractorOptions);
-  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramInfoExtractor | null;
-  items(): MessageIter;
-  posts(): AsyncGenerator<InstagramPost>;
-}
-declare class InstagramAvatarExtractor extends InstagramExtractor {
-  static readonly subcategory = "avatar";
+//#endregion
+//#region src/instagram/extractors/tagged.d.ts
+declare class InstagramTaggedExtractor extends InstagramExtractor {
+  static readonly subcategory = "tagged";
   static pattern: RegExp;
-  readonly subcategory = "avatar";
+  readonly subcategory = "tagged";
+  private _taggedUserId;
   constructor(opts: InstagramExtractorOptions);
-  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramAvatarExtractor | null;
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramTaggedExtractor | null;
+  metadata(): Promise<Record<string, unknown>>;
   posts(): AsyncGenerator<InstagramPost>;
 }
-declare class InstagramSavedExtractor extends InstagramExtractor {
-  static readonly subcategory = "saved";
+//#endregion
+//#region src/instagram/extractors/user.d.ts
+declare class InstagramUserExtractor extends InstagramExtractor {
+  static readonly subcategory = "user";
   static pattern: RegExp;
-  readonly subcategory = "saved";
+  readonly subcategory = "user";
   constructor(opts: InstagramExtractorOptions);
-  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramSavedExtractor | null;
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramUserExtractor | null;
+  items(): MessageIter;
   posts(): AsyncGenerator<InstagramPost>;
 }
 //#endregion
-//#region src/instagram/parsers.d.ts
-/** Main entry — REST */
+//#region src/instagram/parsers/graphql.d.ts
+/** Parse a GraphQL post/edge response. */
+declare function parsePostGraphql(post: Record<string, unknown>, cfg: ParserConfig): ParsedPost;
+//#endregion
+//#region src/instagram/parsers/rest.d.ts
+/** Main entry — parse a REST post response. */
 declare function parsePostRest(post: InstagramPost, cfg: ParserConfig): ParsedPost;
-/** Tagged users */
+/** Extract tagged users from various field formats. */
 declare function extractTaggedUsers(src: Record<string, unknown>, dest: ParsedMedia): void;
-/** Audio / music extraction */
+/** Extract audio/music metadata from a story sticker. */
 declare function extractAudio(src: Record<string, unknown>, dest: Record<string, unknown>, sticker: MusicSticker, cfg: ParserConfig): ParsedMedia | null;
-/** GraphQL parser */
-declare function parsePostGraphql(post: Record<string, unknown>, cfg: ParserConfig): ParsedPost;
 //#endregion
 //#region src/message.d.ts
 declare function directory(metadata?: Metadata): DirectoryMsg;