@chilfish/gallery-dl-instagram 0.1.0 → 0.2.2

package/dist/{extractors-Byw-2lPL.mjs → sdk-CovBsEps.mjs}

@@ -1,126 +1,4 @@
-//#region core/extractor.ts
-/** A no-op logger */
-const noopLogger = {
-	debug: () => {},
-	info: () => {},
-	warn: () => {},
-	error: () => {}
-};
-var Extractor = class {
-	/** Regex pattern to match against URLs */
-	static pattern = /^$/;
-	/** The input URL */
-	url;
-	/** Regex match groups from ``fromURL`` */
-	groups;
-	config;
-	/** HTTP client — public so Job can access for downloads */
-	http;
-	/** Storage backend — public so Job can access for writes */
-	storage;
-	/** Logger instance — public so Job can access for reporting */
-	log;
-	/** Delay range in seconds — random between [min, max] before each request */
-	requestInterval = [6, 12];
-	_initialized = false;
-	constructor(opts) {
-		this.url = opts.url;
-		this.groups = opts.match ? [...opts.match].slice(1) : [];
-		this.config = opts.config;
-		this.http = opts.http;
-		this.storage = opts.storage;
-		this.log = opts.log;
-	}
-	/** Initialization */
-	/**
-	* One-time async setup (cookies, session, internal state).
-	* Safe to call multiple times — after the first call it becomes a no-op.
-	*/
-	async initialize() {
-		if (this._initialized) return;
-		await this._init();
-		this._initialized = true;
-		this.initialize = async () => {};
-	}
-	/**
-	* Subclass hook for one-time setup.
-	*/
-	async _init() {}
-	/** Async iteration */
-	async *[Symbol.asyncIterator]() {
-		await this.initialize();
-		yield* this.items();
-	}
-	/** Config helpers */
-	/**
-	* Read a config value using the interpolated hierarchy.
-	*/
-	_cfg(key, defaultVal) {
-		const path = [
-			"extractor",
-			this.category,
-			this.subcategory
-		];
-		return this.config.interpolate(path, key, defaultVal);
-	}
-	/** HTTP */
-	_lastRequestTime = 0;
-	/**
-	* Rate-limited HTTP request wrapper.
-	*/
-	async request(url, cfg = {}) {
-		await this._throttle();
-		const response = await this.http.request({
-			url,
-			...cfg
-		});
-		this._lastRequestTime = Date.now();
-		return response;
-	}
-	/**
-	* Convenience: request + parse JSON body.
-	*/
-	async requestJSON(url, cfg = {}) {
-		const resp = await this.request(url, cfg);
-		if (typeof resp.data === "object") return resp.data;
-		try {
-			return JSON.parse(resp.data);
-		} catch {
-			return {};
-		}
-	}
-	/** Rate limiting */
-	/**
-	* Sleep long enough to keep the minimum interval between requests.
-	*/
-	async _throttle() {
-		const elapsed = Date.now() - this._lastRequestTime;
-		const [min, max] = this.requestInterval;
-		const target = min + Math.random() * (max - min);
-		const waitMs = Math.max(0, target * 1e3 - elapsed);
-		if (waitMs > 0) await new Promise((r) => setTimeout(r, waitMs));
-	}
-	/** Utility */
-	/**
-	* Convert a Unix timestamp (seconds or ms) to an ISO-8601 string.
-	*/
-	parseTimestamp(ts) {
-		if (ts == null) return "";
-		const asMs = ts > 25e8 ? ts : ts * 1e3;
-		return new Date(asMs).toISOString();
-	}
-	/**
-	* Generate a random hex token (used for CSRF).
-	*/
-	static generateToken(size = 16) {
-		const bytes = new Uint8Array(size);
-		if (typeof crypto !== "undefined" && crypto.getRandomValues) crypto.getRandomValues(bytes);
-		else for (let i = 0; i < size; i++) bytes[i] = Math.floor(Math.random() * 256);
-		return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
-	}
-};
-//#endregion
-//#region config.ts
+//#region src/config.ts
 var ConfigManager = class {
 	data;
 	constructor(data = {}) {
@@ -174,7 +52,8 @@ var ConfigManager = class {
 	}
 };
 //#endregion
-//#region core/job.ts
+//#region src/core/format.ts
+/** Shared ANSI formatting and display utilities. */
 function formatBytes(bytes) {
 	if (bytes === 0) return "0 B";
 	const units = [
@@ -204,19 +83,20 @@ function c(s) {
 function g(s) {
 	return `${GREEN}${s}${RESET}`;
 }
+const _YELLOW = YELLOW;
+const _RESET = RESET;
 function pad(s, n) {
 	return s.length >= n ? s : s + " ".repeat(n - s.length);
 }
+//#endregion
+//#region src/core/job.ts
 var Job = class {
 	extractor;
 	status = 0;
 	constructor(extractor) {
 		this.extractor = extractor;
 	}
-	/**
-	* Main entry point.  Calls ``extractor[Symbol.asyncIterator]()`` and
-	* dispatches every yielded message.
-	*/
+	/** Main entry point. Dispatches every yielded message. */
 	async run() {
 		this.extractor.log.info(`Starting ${this.extractor.category}/${this.extractor.subcategory} — ${this.extractor.url}`);
 		await this.extractor.initialize();
@@ -237,6 +117,8 @@ var Job = class {
 	/** Override in subclasses to print a summary. */
 	_report() {}
 };
+//#endregion
+//#region src/core/download-job.ts
 var DownloadJob = class DownloadJob extends Job {
 	/** Base output directory (prepended to all paths). */
 	basePath = "";
@@ -244,10 +126,6 @@ var DownloadJob = class DownloadJob extends Job {
 	_currentDir = {};
 	/** In-memory archive keyed by archive format. */
 	archive = /* @__PURE__ */ new Map();
-	/**
-	* Registry of per-category "archive formats" — the key is formed
-	* by interpolating this format string over the metadata.
-	*/
 	_archiveFmts = /* @__PURE__ */ new Map();
 	_postCount = 0;
 	_fileCount = 0;
@@ -256,23 +134,18 @@ var DownloadJob = class DownloadJob extends Job {
 	registerArchive(category, format) {
 		this._archiveFmts.set(category, format);
 	}
-	/** Simple format-string interpolation for archive keys. */
 	_interp(fmt, meta) {
 		return fmt.replace(/\{(\w+)\}/g, (_, key) => {
 			const v = meta[key];
 			return v == null ? "" : String(v);
 		});
 	}
-	/** Check whether this URL has already been downloaded (and skip). */
 	_isArchived(meta) {
 		const cat = meta.category ?? this.extractor.category;
 		const fmt = this._archiveFmts.get(cat) ?? "{media_id}";
 		const key = this._interp(fmt, meta);
-		const set = this.archive.get(cat);
-		if (set && set.has(key)) return true;
-		return false;
+		return !!this.archive.get(cat)?.has(key);
 	}
-	/** Mark a post/media as archived. */
 	_archive(meta) {
 		const cat = meta.category ?? this.extractor.category;
 		const fmt = this._archiveFmts.get(cat) ?? "{media_id}";
@@ -284,7 +157,6 @@ var DownloadJob = class DownloadJob extends Job {
 		}
 		set.add(key);
 	}
-	/** Handlers */
 	async handleDirectory(msg) {
 		this._currentDir = { ...msg.metadata };
 		this._postCount++;
@@ -313,7 +185,6 @@ var DownloadJob = class DownloadJob extends Job {
 			if (resp.data instanceof Uint8Array) data = resp.data;
 			else if (resp.data instanceof ArrayBuffer) data = new Uint8Array(resp.data);
 			else if (typeof resp.data === "string") data = resp.data;
-			else if (typeof resp.data === "object" && resp.data != null && "type" in resp.data && resp.data.type === "Buffer") data = new Uint8Array(resp.data);
 			else data = JSON.stringify(resp.data);
 			await this.extractor.storage.write(fullPath, data);
 			this._fileCount++;
@@ -357,13 +228,11 @@ var DownloadJob = class DownloadJob extends Job {
 			else this.archive.set(cat, set);
 		}
 	}
-	/** Report */
 	_report() {
 		const log = this.extractor.log;
 		log.info(`Done — ${this._postCount} post(s), ${this._fileCount} file(s) downloaded (${formatBytes(this._downloadedBytes)})`);
 		if (this._skippedCount > 0) log.info(`  ${this._skippedCount} file(s) skipped (already archived)`);
 	}
-	/** Path builders */
 	_buildDirPath(meta) {
 		return `${meta.category ?? this.extractor.category}/${meta.username ?? "_"}`;
 	}
@@ -373,166 +242,133 @@ var DownloadJob = class DownloadJob extends Job {
 		return `${mid}${meta.num ? `_${meta.num}` : ""}.${ext}`;
 	}
 };
-var PrintJob = class PrintJob extends Job {
-	_currentDir = {};
-	_files = [];
-	_postCount = 0;
-	_fileCount = 0;
-	_width;
-	constructor(extractor) {
-		super(extractor);
-		this._width = Math.min(process.stdout.columns ?? 80, 100);
+//#endregion
+//#region src/core/extractor.ts
+/** A no-op logger */
+const noopLogger = {
+	debug: () => {},
+	info: () => {},
+	warn: () => {},
+	error: () => {}
+};
+var Extractor = class {
+	/** Regex pattern to match against URLs */
+	static pattern = /^$/;
+	/** The input URL */
+	url;
+	/** Regex match groups from ``fromURL`` */
+	groups;
+	config;
+	/** HTTP client — public so Job can access for downloads */
+	http;
+	/** Storage backend — public so Job can access for writes */
+	storage;
+	/** Logger instance — public so Job can access for reporting */
+	log;
+	/** Delay range in seconds — random between [min, max] before each request */
+	requestInterval = [6, 12];
+	_initialized = false;
+	constructor(opts) {
+		this.url = opts.url;
+		this.groups = opts.match ? [...opts.match].slice(1) : [];
+		this.config = opts.config;
+		this.http = opts.http;
+		this.storage = opts.storage;
+		this.log = opts.log;
 	}
-	async handleDirectory(msg) {
-		if (this._postCount > 0) this._flushPost();
-		this._currentDir = { ...msg.metadata };
-		this._postCount++;
-		this._files = [];
+	/** Initialization */
+	/**
+	* One-time async setup (cookies, session, internal state).
+	* Safe to call multiple times — after the first call it becomes a no-op.
+	*/
+	async initialize() {
+		if (this._initialized) return;
+		await this._init();
+		this._initialized = true;
+		this.initialize = async () => {};
 	}
-	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
+	/**
+	* Subclass hook for one-time setup.
+	*/
+	async _init() {}
+	/** Async iteration */
+	async *[Symbol.asyncIterator]() {
+		await this.initialize();
+		yield* this.items();
+	}
+	/** Config helpers */
+	/**
+	* Read a config value using the interpolated hierarchy.
+	*/
+	_cfg(key, defaultVal) {
+		const path = [
+			"extractor",
+			this.category,
+			this.subcategory
+		];
+		return this.config.interpolate(path, key, defaultVal);
+	}
+	/** HTTP */
+	_lastRequestTime = 0;
+	/**
+	* Rate-limited HTTP request wrapper.
+	*/
+	async request(url, cfg = {}) {
+		await this._throttle();
+		const response = await this.http.request({
+			url,
+			...cfg
 		});
+		this._lastRequestTime = Date.now();
+		return response;
 	}
-	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;
-	}
-	/** Output */
-	_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${dim("┌")}${"─".repeat(padL)}${b(header)}${"─".repeat(padR)}${dim("┐")}\n`);
-		const row = (label, value, color) => {
-			const colored = typeof color === "function" ? color(value) : color ? `${color}${value}${RESET}` : value;
-			process.stdout.write(` ${dim("│")} ${c(pad(label, labelW))} ${colored}\n`);
-		};
-		const username = m.username ?? "?";
-		const fullname = m.fullname ?? "";
-		row("Author:", fullname ? `${username} (${fullname})` : username, 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(` ${dim("│")}\n`);
-			process.stdout.write(` ${dim("│")} ${b("Description:")}\n`);
-			const lines = desc.split("\n");
-			for (const line of lines) {
-				const wrapped = this._wrap(line, w - 8);
-				for (const wl of wrapped) process.stdout.write(` ${dim("│")}   ${dim(wl)}\n`);
-			}
-		}
-		const tags = m.tags;
-		if (tags && tags.length > 0) {
-			process.stdout.write(` ${dim("│")}\n`);
-			process.stdout.write(` ${dim("│")} ${b("Tags:")} ${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, 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(` ${dim("│")}\n`);
-			process.stdout.write(` ${dim("│")} ${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)}...` : 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 = ` ${dim("│")}   ${g(numStr)} ${dimStr}  ${res}`;
-				if (badges.length > 0) line += `  ${YELLOW}(${badges.join("+")})${RESET}`;
-				process.stdout.write(`${line}\n`);
-			}
-		}
-		process.stdout.write(` ${dim("└")}${"─".repeat(w - 2)}${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();
+	/**
+	* Convenience: request + parse JSON body.
+	*/
+	async requestJSON(url, cfg = {}) {
+		const resp = await this.request(url, cfg);
+		if (typeof resp.data === "object") return resp.data;
+		try {
+			return JSON.parse(resp.data);
+		} catch {
+			return {};
 		}
-		if (remaining) lines.push(remaining);
-		return lines;
-	}
-	_report() {
-		this._flushPost();
-		process.stdout.write(`\n${dim("──")} ${b("Summary")} ${dim("───")}\n`);
-		process.stdout.write(`  Posts: ${g(String(this._postCount))}\n`);
-		process.stdout.write(`  Files: ${g(String(this._fileCount))}\n`);
-		process.stdout.write(`\n`);
 	}
-};
-//#endregion
-//#region utils/id-codec.ts
-/**
-* Instagram-style Base64-variant ID ↔ shortcode conversion.
-*/
+	/** Rate limiting */
+	/**
+	* Sleep long enough to keep the minimum interval between requests.
+	*/
+	async _throttle() {
+		const elapsed = Date.now() - this._lastRequestTime;
+		const [min, max] = this.requestInterval;
+		const target = min + Math.random() * (max - min);
+		const waitMs = Math.max(0, target * 1e3 - elapsed);
+		if (waitMs > 0) await new Promise((r) => setTimeout(r, waitMs));
+	}
+	/** Utility */
+	/**
+	* Convert a Unix timestamp (seconds or ms) to an ISO-8601 string.
+	*/
+	parseTimestamp(ts) {
+		if (ts == null) return "";
+		const asMs = ts > 25e8 ? ts : ts * 1e3;
+		return new Date(asMs).toISOString();
+	}
+	/**
+	* Generate a random hex token (used for CSRF).
+	*/
+	static generateToken(size = 16) {
+		const bytes = new Uint8Array(size);
+		if (typeof crypto !== "undefined" && crypto.getRandomValues) crypto.getRandomValues(bytes);
+		else for (let i = 0; i < size; i++) bytes[i] = Math.floor(Math.random() * 256);
+		return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+	}
+};
+//#endregion
+//#region src/utils/id-codec.ts
+/**
+* Instagram-style Base64-variant ID ↔ shortcode conversion.
+*/
 const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
 /** Pre-built index for O(1) character lookup during decode. */
 const CHAR_INDEX = {};
@@ -560,7 +396,160 @@ function shortcodeFromId(postId) {
 	return chars.reverse().join("");
 }
 //#endregion
-//#region instagram/api.ts
+//#region src/message.ts
+function directory(metadata = {}) {
+	return {
+		type: "directory",
+		metadata
+	};
+}
+function url(u, metadata = {}) {
+	return {
+		type: "url",
+		url: u,
+		metadata
+	};
+}
+function queue(u, metadata = {}) {
+	return {
+		type: "queue",
+		url: u,
+		metadata
+	};
+}
+//#endregion
+//#region src/utils/text.ts
+/**
+* Text utilities ported from gallery-dl's ``text`` module.
+*
+* All functions are pure and environment-agnostic.
+*/
+/** String extraction */
+/**
+* Extract the substring between ``begin`` and ``end`` from ``txt``.
+* Returns the substring or ``null`` if either delimiter is missing.
+*/
+function extract(txt, begin, end) {
+	const first = txt.indexOf(begin);
+	if (first < 0) return null;
+	const start = first + begin.length;
+	const last = txt.indexOf(end, start);
+	if (last < 0) return null;
+	return txt.slice(start, last);
+}
+/**
+* Shorthand: same as ``extract`` but returns ``default_`` on failure.
+* Mirrors the Python ``extr()`` function.
+*/
+function extr(txt, begin, end, default_ = "") {
+	return extract(txt, begin, end) ?? default_;
+}
+/** Unicode / HTML */
+/**
+* Decode ``\\uXXXX`` escape sequences in a string.
+*/
+function parseUnicodeEscapes$1(text) {
+	if (!text.includes("\\u")) return text;
+	return text.replace(/\\u([0-9a-fA-F]{4})/g, (_m, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
+}
+/**
+* HTML entity decode.
+*
+* In Node.js we could use a DOM parser, but since this library is
+* environment-agnostic we ship a minimal covering the common cases.
+*/
+const HTML_ENTITIES = {
+	"amp": "&",
+	"lt": "<",
+	"gt": ">",
+	"quot": "\"",
+	"apos": "'",
+	"nbsp": "\xA0",
+	"#x27": "'",
+	"#x2F": "/",
+	"#39": "'",
+	"#47": "/"
+};
+const RE_ENTITY = /&([^;]+);/g;
+function unescape(text) {
+	return text.replace(RE_ENTITY, (m, name) => {
+		const ch = HTML_ENTITIES[name];
+		if (ch !== void 0) return ch;
+		if (name.startsWith("#")) {
+			const cp = name[1] === "x" || name[1] === "X" ? Number.parseInt(name.slice(2), 16) : Number.parseInt(name.slice(1), 10);
+			if (Number.isSafeInteger(cp)) return String.fromCodePoint(cp);
+		}
+		return m;
+	});
+}
+/** URL helpers */
+/**
+* URL-decode a string.
+*/
+function unquote(text) {
+	try {
+		return decodeURIComponent(text);
+	} catch {
+		return text.replace(/%[0-9a-f]{2}/gi, (m) => {
+			try {
+				return decodeURIComponent(m);
+			} catch {
+				return m;
+			}
+		});
+	}
+}
+/**
+* Ensure a URL starts with ``https://`` (or ``http://``).
+*/
+function ensureHttpScheme(url, scheme = "https://") {
+	if (!url) return url;
+	if (url.startsWith("https://") || url.startsWith("http://")) return url;
+	return scheme + url.replace(/^[/:]+/, "");
+}
+/**
+* Extract filename + extension from a URL and write into ``meta``.
+*/
+function nameExtFromURL(url, meta) {
+	const filename = filenameFromURL(url);
+	const dot = filename.lastIndexOf(".");
+	if (dot > 0 && filename.length - dot - 1 <= 16) {
+		meta.filename = unquote(filename.slice(0, dot));
+		meta.extension = unquote(filename.slice(dot + 1)).toLowerCase();
+	} else {
+		meta.filename = unquote(filename);
+		meta.extension = "";
+	}
+}
+/**
+* Extract the file-name portion of a URL (before query string).
+*/
+function filenameFromURL(url) {
+	try {
+		return url.split("?")[0].split("/").pop() ?? "";
+	} catch {
+		return "";
+	}
+}
+/**
+* Parse an integer from a possibly-null value. Returns ``default_`` on failure.
+*/
+function parseInt(value, default_ = 0) {
+	if (value == null) return default_;
+	const n = typeof value === "number" ? value : Number.parseInt(String(value), 10);
+	return Number.isFinite(n) ? n : default_;
+}
+function tagRe(pattern) {
+	const re = new RegExp(pattern, "g");
+	return (text) => {
+		const matches = text.match(re);
+		return matches ? [...new Set(matches)] : [];
+	};
+}
+/** Pre-configured hashtag regex. */
+const findTags = tagRe("#\\w+");
+//#endregion
+//#region src/instagram/api.ts
 const APP_ID = "936619743392459";
 const ASBD_ID = "129477";
 var InstagramRestAPI = class {
@@ -900,192 +889,38 @@ var InstagramRestAPI = class {
 	}
 };
 //#endregion
-//#region message.ts
-function directory(metadata = {}) {
-	return {
-		type: "directory",
-		metadata
-	};
-}
-function url(u, metadata = {}) {
-	return {
-		type: "url",
-		url: u,
-		metadata
-	};
-}
-function queue(u, metadata = {}) {
-	return {
-		type: "queue",
-		url: u,
-		metadata
-	};
-}
-//#endregion
-//#region utils/text.ts
-/**
-* Text utilities ported from gallery-dl's ``text`` module.
-*
-* All functions are pure and environment-agnostic.
-*/
-/** String extraction */
-/**
-* Extract the substring between ``begin`` and ``end`` from ``txt``.
-* Returns the substring or ``null`` if either delimiter is missing.
-*/
-function extract(txt, begin, end) {
-	const first = txt.indexOf(begin);
-	if (first < 0) return null;
-	const start = first + begin.length;
-	const last = txt.indexOf(end, start);
-	if (last < 0) return null;
-	return txt.slice(start, last);
-}
-/**
-* Shorthand: same as ``extract`` but returns ``default_`` on failure.
-* Mirrors the Python ``extr()`` function.
-*/
-function extr(txt, begin, end, default_ = "") {
-	return extract(txt, begin, end) ?? default_;
-}
-/** Unicode / HTML */
-/**
-* Decode ``\\uXXXX`` escape sequences in a string.
-*/
-function parseUnicodeEscapes$1(text) {
-	if (!text.includes("\\u")) return text;
-	return text.replace(/\\u([0-9a-fA-F]{4})/g, (_m, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
-}
-/**
-* HTML entity decode.
-*
-* In Node.js we could use a DOM parser, but since this library is
-* environment-agnostic we ship a minimal covering the common cases.
-*/
-const HTML_ENTITIES = {
-	"amp": "&",
-	"lt": "<",
-	"gt": ">",
-	"quot": "\"",
-	"apos": "'",
-	"nbsp": "\xA0",
-	"#x27": "'",
-	"#x2F": "/",
-	"#39": "'",
-	"#47": "/"
-};
-const RE_ENTITY = /&([^;]+);/g;
-function unescape(text) {
-	return text.replace(RE_ENTITY, (m, name) => {
-		const ch = HTML_ENTITIES[name];
-		if (ch !== void 0) return ch;
-		if (name.startsWith("#")) {
-			const cp = name[1] === "x" || name[1] === "X" ? Number.parseInt(name.slice(2), 16) : Number.parseInt(name.slice(1), 10);
-			if (Number.isSafeInteger(cp)) return String.fromCodePoint(cp);
-		}
-		return m;
-	});
-}
-/** URL helpers */
-/**
-* URL-decode a string.
-*/
-function unquote(text) {
-	try {
-		return decodeURIComponent(text);
-	} catch {
-		return text.replace(/%[0-9a-f]{2}/gi, (m) => {
-			try {
-				return decodeURIComponent(m);
-			} catch {
-				return m;
-			}
-		});
-	}
-}
-/**
-* Ensure a URL starts with ``https://`` (or ``http://``).
-*/
-function ensureHttpScheme(url, scheme = "https://") {
-	if (!url) return url;
-	if (url.startsWith("https://") || url.startsWith("http://")) return url;
-	return scheme + url.replace(/^[/:]+/, "");
-}
-/**
-* Extract filename + extension from a URL and write into ``meta``.
-*/
-function nameExtFromURL(url, meta) {
-	const filename = filenameFromURL(url);
-	const dot = filename.lastIndexOf(".");
-	if (dot > 0 && filename.length - dot - 1 <= 16) {
-		meta.filename = unquote(filename.slice(0, dot));
-		meta.extension = unquote(filename.slice(dot + 1)).toLowerCase();
-	} else {
-		meta.filename = unquote(filename);
-		meta.extension = "";
-	}
-}
-/**
-* Extract the file-name portion of a URL (before query string).
-*/
-function filenameFromURL(url) {
-	try {
-		return url.split("?")[0].split("/").pop() ?? "";
-	} catch {
-		return "";
-	}
-}
-/**
-* Parse an integer from a possibly-null value. Returns ``default_`` on failure.
-*/
-function parseInt(value, default_ = 0) {
-	if (value == null) return default_;
-	const n = typeof value === "number" ? value : Number.parseInt(String(value), 10);
-	return Number.isFinite(n) ? n : default_;
-}
-function tagRe(pattern) {
-	const re = new RegExp(pattern, "g");
-	return (text) => {
-		const matches = text.match(re);
-		return matches ? [...new Set(matches)] : [];
-	};
-}
-/** Pre-configured hashtag regex. */
-const findTags = tagRe("#\\w+");
-//#endregion
-//#region instagram/parsers.ts
-/** Main entry — REST */
-function parsePostRest(post, cfg) {
-	if (post.items) return parseStoryRest(post, cfg);
-	const owner = post.user;
-	const caption = post.caption;
-	const ts = post.taken_at ?? post.created_at;
-	const date = cfg.parseTimestamp(ts ?? null);
-	const data = {
-		post_id: post.pk,
-		post_shortcode: post.code,
-		post_url: `${cfg.root}/p/${post.code}/`,
-		likes: post.like_count ?? 0,
-		liked: post.has_liked ?? false,
-		pinned: extractPinned(post),
-		owner_id: owner.pk,
-		username: owner.username ?? "",
-		fullname: owner.full_name ?? "",
-		post_date: date,
-		date,
-		description: caption ? caption.text : "",
-		type: "post",
-		count: 0,
-		_files: []
+//#region src/instagram/parsers/rest.ts
+/** Main entry — parse a REST post response. */
+function parsePostRest(post, cfg) {
+	if (post.items) return parseStoryRest(post, cfg);
+	const owner = post.user;
+	const caption = post.caption;
+	const ts = post.taken_at ?? post.created_at;
+	const date = cfg.parseTimestamp(ts ?? null);
+	const data = {
+		post_id: post.pk,
+		post_shortcode: post.code,
+		post_url: `${cfg.root}/p/${post.code}/`,
+		likes: post.like_count ?? 0,
+		liked: post.has_liked ?? false,
+		pinned: extractPinned(post),
+		owner_id: owner.pk,
+		username: owner.username ?? "",
+		fullname: owner.full_name ?? "",
+		post_date: date,
+		date,
+		description: caption ? caption.text : "",
+		type: "post",
+		count: 0,
+		_files: []
 	};
 	const tags = cfg.findTags(data.description);
 	if (tags.length > 0) data.tags = [...new Set(tags)].sort();
 	if (post.location) {
 		const loc = post.location;
-		const slug = loc.short_name.replace(/\s+/g, "-").toLowerCase();
 		data.location_id = loc.pk;
-		data.location_slug = slug;
-		data.location_url = `${cfg.root}/explore/locations/${loc.pk}/${slug}/`;
+		data.location_slug = loc.short_name.replace(/\s+/g, "-").toLowerCase();
+		data.location_url = `${cfg.root}/explore/locations/${loc.pk}/${data.location_slug}/`;
 	}
 	if (post.coauthor_producers) data.coauthors = post.coauthor_producers.map((u) => ({
 		id: u.pk,
@@ -1132,7 +967,7 @@ function parsePostRest(post, cfg) {
 	if (post.subscription_media_visibility) data.subscription = post.subscription_media_visibility;
 	return data;
 }
-/** Story / highlight */
+/** Parse a story or highlight REST response. */
 function parseStoryRest(post, cfg) {
 	const items = post.items;
 	const reelId = String(post.id).split(":").pop() ?? "0";
@@ -1158,9 +993,8 @@ function parseStoryRest(post, cfg) {
 		expires: expires ? cfg.parseTimestamp(expires) : void 0,
 		user: post.user
 	};
-	if (!isStory) {
-		if (post.title) data.highlight_title = post.title;
-	} else if (!post.seen) post.seen = expires - 86400;
+	if (!isStory && post.title) data.highlight_title = post.title;
+	else if (!post.seen) post.seen = expires - 86400;
 	for (let num = 0; num < items.length; num++) {
 		const item = items[num];
 		const media = parseMediaItem(item, post, cfg, num + 1);
@@ -1170,7 +1004,7 @@ function parseStoryRest(post, cfg) {
 	}
 	return data;
 }
-/** Single media item */
+/** Parse a single media item (image/video) from a carousel or story. */
 function parseMediaItem(item, parent, cfg, num) {
 	let image;
 	try {
@@ -1229,7 +1063,7 @@ function parseMediaItem(item, parent, cfg, num) {
 	if (itemRec.audience) media.audience = itemRec.audience;
 	return media;
 }
-/** Tagged users */
+/** Extract tagged users from various field formats. */
 function extractTaggedUsers(src, dest) {
 	dest.tagged_users = [];
 	const edges = src.edge_media_to_tagged_user;
@@ -1272,13 +1106,9 @@ function extractTaggedUsers(src, dest) {
 		}
 	}
 	const seen = /* @__PURE__ */ new Set();
-	dest.tagged_users = dest.tagged_users.filter((t) => {
-		if (seen.has(t.id)) return false;
-		seen.add(t.id);
-		return true;
-	});
+	dest.tagged_users = dest.tagged_users.filter((t) => seen.has(t.id) ? false : (seen.add(t.id), true));
 }
-/** Audio / music extraction */
+/** Extract audio/music metadata from a story sticker. */
 function extractAudio(src, dest, sticker, cfg) {
 	const info = sticker.music_asset_info;
 	if (!info) return null;
@@ -1310,7 +1140,14 @@ function extractAudio(src, dest, sticker, cfg) {
 		audio_timestamps: info.highlight_start_times_in_ms
 	};
 }
-/** GraphQL parser */
+function extractPinned(post) {
+	if (post.timeline_pinned_user_ids) return post.timeline_pinned_user_ids;
+	if (post.clips_tab_pinned_user_ids) return post.clips_tab_pinned_user_ids;
+	return [];
+}
+//#endregion
+//#region src/instagram/parsers/graphql.ts
+/** Parse a GraphQL post/edge response. */
 function parsePostGraphql(post, cfg) {
 	const typename = post.__typename ?? "GraphImage";
 	const owner = post.owner;
@@ -1395,17 +1232,12 @@ function parsePostGraphql(post, cfg) {
 	}
 	return data;
 }
-function extractPinned(post) {
-	if (post.timeline_pinned_user_ids) return post.timeline_pinned_user_ids;
-	if (post.clips_tab_pinned_user_ids) return post.clips_tab_pinned_user_ids;
-	return [];
-}
 function parseUnicodeEscapes(text) {
 	if (!text.includes("\\u")) return text;
 	return text.replace(/\\u([0-9a-fA-F]{4})/g, (_, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
 }
 //#endregion
-//#region instagram/base.ts
+//#region src/instagram/base.ts
 var Ref = class {
 	value;
 	constructor(v) {
@@ -1558,12 +1390,123 @@ var InstagramExtractor = class extends Extractor {
 	}
 };
 //#endregion
-//#region instagram/extractors.ts
+//#region src/instagram/extractors/helpers.ts
+/** Shared regex utilities for Instagram extractor URL patterns. */
 const BASE_RE = /^(?:https?:\/\/)?(?:www\.)?instagram\.com/;
 function re(base, path) {
 	const pathSrc = typeof path === "string" ? path : path.source;
 	return new RegExp(base.source + pathSrc, "i");
 }
+//#endregion
+//#region src/instagram/extractors/registry.ts
+const _registry = /* @__PURE__ */ new Map();
+function register(subcategory, cls) {
+	_registry.set(subcategory, cls);
+}
+function get(subcategory) {
+	return _registry.get(subcategory);
+}
+//#endregion
+//#region src/instagram/extractors/avatar.ts
+var InstagramAvatarExtractor = class InstagramAvatarExtractor extends InstagramExtractor {
+	static subcategory = "avatar";
+	static pattern = re(BASE_RE, /(\/[^/?#]+)\/avatar/);
+	subcategory = InstagramAvatarExtractor.subcategory;
+	constructor(opts) {
+		super(opts);
+	}
+	static fromURL(url, opts) {
+		const match = InstagramAvatarExtractor.pattern.exec(url);
+		if (!match) return null;
+		return new InstagramAvatarExtractor({
+			...opts,
+			url,
+			match
+		});
+	}
+	async *posts() {
+		const screenName = (this.groups[0] ?? "").replace(/^\//, "");
+		let user;
+		if (screenName.startsWith("id:")) user = await this.api.userById(screenName.slice(3));
+		else user = await this.api.userByScreenName(screenName);
+		const avatar = user.hd_profile_pic_url_info ?? user.hd_profile_pic_versions?.[user.hd_profile_pic_versions.length - 1] ?? {
+			url: user.profile_pic_url ?? "",
+			width: 0,
+			height: 0
+		};
+		let pk = user.profile_pic_id?.split("_")[0];
+		let code;
+		if (pk) code = shortcodeFromId(pk);
+		else {
+			pk = `avatar:${user.pk}`;
+			code = pk;
+		}
+		yield {
+			pk,
+			code,
+			user,
+			caption: null,
+			like_count: 0,
+			image_versions2: { candidates: [avatar] }
+		};
+	}
+};
+register(InstagramAvatarExtractor.subcategory, InstagramAvatarExtractor);
+//#endregion
+//#region src/instagram/extractors/highlights.ts
+var InstagramHighlightsExtractor = class InstagramHighlightsExtractor extends InstagramExtractor {
+	static subcategory = "highlights";
+	static pattern = re(BASE_RE, /(\/[^/?#]+)\/highlights/);
+	subcategory = InstagramHighlightsExtractor.subcategory;
+	constructor(opts) {
+		super(opts);
+	}
+	static fromURL(url, opts) {
+		const match = InstagramHighlightsExtractor.pattern.exec(url);
+		if (!match) return null;
+		return new InstagramHighlightsExtractor({
+			...opts,
+			url,
+			match
+		});
+	}
+	async *posts() {
+		const screenName = (this.groups[0] ?? "").replace(/^\//, "");
+		const uid = await this.api.userId(screenName);
+		yield* this.api.highlightsMedia(uid);
+	}
+};
+register(InstagramHighlightsExtractor.subcategory, InstagramHighlightsExtractor);
+//#endregion
+//#region src/instagram/extractors/info.ts
+var InstagramInfoExtractor = class InstagramInfoExtractor extends InstagramExtractor {
+	static subcategory = "info";
+	static pattern = re(BASE_RE, /(\/[^/?#]+)\/info/);
+	subcategory = InstagramInfoExtractor.subcategory;
+	constructor(opts) {
+		super(opts);
+	}
+	static fromURL(url, opts) {
+		const match = InstagramInfoExtractor.pattern.exec(url);
+		if (!match) return null;
+		return new InstagramInfoExtractor({
+			...opts,
+			url,
+			match
+		});
+	}
+	async *items() {
+		const screenName = (this.groups[0] ?? "").replace(/^\//, "");
+		let user;
+		if (screenName.startsWith("id:")) user = await this.api.userById(screenName.slice(3));
+		else user = await this.api.userByScreenName(screenName);
+		yield directory(user);
+	}
+	async *posts() {}
+};
+register(InstagramInfoExtractor.subcategory, InstagramInfoExtractor);
+//#endregion
+//#region src/instagram/extractors/post.ts
 var InstagramPostExtractor = class InstagramPostExtractor extends InstagramExtractor {
 	static subcategory = "post";
 	static pattern = re(/^(?:https?:\/\/)?(?:www\.)?instagram\.com\//, /(?:share(?:\/(?:p|tv|reels?))?|(?:[^/?#]+\/)?(?:p|tv|reels?))\/([^/?#]+)/);
@@ -1598,75 +1541,9 @@ var InstagramPostExtractor = class InstagramPostExtractor extends InstagramExtra
 		yield* this.api.media(shortcode);
 	}
 };
-var InstagramUserExtractor = class InstagramUserExtractor extends InstagramExtractor {
-	static subcategory = "user";
-	static pattern = re(BASE_RE, /(\/[^/?#]+)\/?(?:$|[?#])/);
-	subcategory = InstagramUserExtractor.subcategory;
-	constructor(opts) {
-		super(opts);
-	}
-	static fromURL(url, opts) {
-		const match = InstagramUserExtractor.pattern.exec(url);
-		if (!match) return null;
-		return new InstagramUserExtractor({
-			...opts,
-			url,
-			match
-		});
-	}
-	async *items() {
-		await this.login();
-		const userPath = this.groups[0] ?? "/";
-		const base = `${this.root}${userPath}/`;
-		const storiesUrl = `${this.root}/stories/${userPath.slice(1)}/`;
-		const include = this._cfg("include", ["posts"]);
-		const categories = include === "all" ? [
-			"posts",
-			"reels",
-			"tagged",
-			"stories",
-			"highlights",
-			"info",
-			"avatar"
-		] : typeof include === "string" ? include.replace(/\s+/g, "").split(",") : include;
-		const extractors = {
-			info: {
-				cls: InstagramInfoExtractor,
-				url: `${base}info/`
-			},
-			avatar: {
-				cls: InstagramAvatarExtractor,
-				url: `${base}avatar/`
-			},
-			stories: {
-				cls: InstagramStoriesExtractor,
-				url: storiesUrl
-			},
-			highlights: {
-				cls: InstagramHighlightsExtractor,
-				url: `${base}highlights/`
-			},
-			posts: {
-				cls: InstagramPostsExtractor,
-				url: `${base}posts/`
-			},
-			reels: {
-				cls: InstagramReelsExtractor,
-				url: `${base}reels/`
-			},
-			tagged: {
-				cls: InstagramTaggedExtractor,
-				url: `${base}tagged/`
-			}
-		};
-		for (const cat of categories) {
-			const entry = extractors[cat];
-			if (entry) yield queue(entry.url, { _extractor: entry.cls });
-			else this.log.warn(`Invalid include '${cat}'`);
-		}
-	}
-	async *posts() {}
-};
+register(InstagramPostExtractor.subcategory, InstagramPostExtractor);
+//#endregion
+//#region src/instagram/extractors/posts-list.ts
 var InstagramPostsExtractor = class InstagramPostsExtractor extends InstagramExtractor {
 	static subcategory = "posts";
 	static pattern = re(BASE_RE, /(\/[^/?#]+)\/posts/);
@@ -1689,6 +1566,9 @@ var InstagramPostsExtractor = class InstagramPostsExtractor extends InstagramExt
 		yield* this.api.userFeed(uid);
 	}
 };
+register(InstagramPostsExtractor.subcategory, InstagramPostsExtractor);
+//#endregion
+//#region src/instagram/extractors/reels-list.ts
 var InstagramReelsExtractor = class InstagramReelsExtractor extends InstagramExtractor {
 	static subcategory = "reels";
 	static pattern = re(BASE_RE, /(\/[^/?#]+)\/reels/);
@@ -1711,44 +1591,32 @@ var InstagramReelsExtractor = class InstagramReelsExtractor extends InstagramExt
 		yield* this.api.userClips(uid);
 	}
 };
-var InstagramTaggedExtractor = class InstagramTaggedExtractor extends InstagramExtractor {
-	static subcategory = "tagged";
-	static pattern = re(BASE_RE, /(\/[^/?#]+)\/tagged/);
-	subcategory = InstagramTaggedExtractor.subcategory;
-	_taggedUserId = "";
+register(InstagramReelsExtractor.subcategory, InstagramReelsExtractor);
+//#endregion
+//#region src/instagram/extractors/saved.ts
+var InstagramSavedExtractor = class InstagramSavedExtractor extends InstagramExtractor {
+	static subcategory = "saved";
+	static pattern = re(BASE_RE, /(\/[^/?#]+)\/saved(?:\/all-posts)?\/?$/);
+	subcategory = InstagramSavedExtractor.subcategory;
 	constructor(opts) {
 		super(opts);
 	}
 	static fromURL(url, opts) {
-		const match = InstagramTaggedExtractor.pattern.exec(url);
+		const match = InstagramSavedExtractor.pattern.exec(url);
 		if (!match) return null;
-		return new InstagramTaggedExtractor({
+		return new InstagramSavedExtractor({
 			...opts,
 			url,
 			match
 		});
 	}
-	async metadata() {
-		const screenName = (this.groups[0] ?? "").replace(/^\//, "");
-		let user;
-		if (screenName.startsWith("id:")) {
-			this._taggedUserId = screenName.slice(3);
-			user = await this.api.userById(screenName.slice(3));
-		} else {
-			this._taggedUserId = await this.api.userId(screenName);
-			user = await this.api.userByScreenName(screenName);
-		}
-		return {
-			tagged_owner_id: user.id ?? user.pk,
-			tagged_username: user.username,
-			tagged_full_name: user.full_name
-		};
-	}
 	async *posts() {
-		if (!this._taggedUserId) await this.metadata();
-		yield* this.api.userTagged(this._taggedUserId);
+		yield* this.api.userSaved();
 	}
 };
+register(InstagramSavedExtractor.subcategory, InstagramSavedExtractor);
+//#endregion
+//#region src/instagram/extractors/stories.ts
 var InstagramStoriesExtractor = class InstagramStoriesExtractor extends InstagramExtractor {
 	static subcategory = "stories";
 	static pattern = /^(?:https?:\/\/)?(?:www\.)?instagram\.com\/(?:stories\/(?:highlights\/(\d+)|([^/?#]+)(?:\/(\d+))?)|\/(aGlnaGxpZ2h0[^?#]+)(?:\?story_media_id=(\d+))?)/;
@@ -1804,28 +1672,9 @@ var InstagramStoriesExtractor = class InstagramStoriesExtractor extends Instagra
 		} else yield* reels;
 	}
 };
-var InstagramHighlightsExtractor = class InstagramHighlightsExtractor extends InstagramExtractor {
-	static subcategory = "highlights";
-	static pattern = re(BASE_RE, /(\/[^/?#]+)\/highlights/);
-	subcategory = InstagramHighlightsExtractor.subcategory;
-	constructor(opts) {
-		super(opts);
-	}
-	static fromURL(url, opts) {
-		const match = InstagramHighlightsExtractor.pattern.exec(url);
-		if (!match) return null;
-		return new InstagramHighlightsExtractor({
-			...opts,
-			url,
-			match
-		});
-	}
-	async *posts() {
-		const screenName = (this.groups[0] ?? "").replace(/^\//, "");
-		const uid = await this.api.userId(screenName);
-		yield* this.api.highlightsMedia(uid);
-	}
-};
+register(InstagramStoriesExtractor.subcategory, InstagramStoriesExtractor);
+//#endregion
+//#region src/instagram/extractors/tag.ts
 var InstagramTagExtractor = class InstagramTagExtractor extends InstagramExtractor {
 	static subcategory = "tag";
 	static pattern = re(BASE_RE, /\/explore\/tags\/([^/?#]+)/);
@@ -1851,93 +1700,294 @@ var InstagramTagExtractor = class InstagramTagExtractor extends InstagramExtract
 		yield* this.api.tagsMedia(decodeURIComponent(tag));
 	}
 };
-var InstagramInfoExtractor = class InstagramInfoExtractor extends InstagramExtractor {
-	static subcategory = "info";
-	static pattern = re(BASE_RE, /(\/[^/?#]+)\/info/);
-	subcategory = InstagramInfoExtractor.subcategory;
+register(InstagramTagExtractor.subcategory, InstagramTagExtractor);
+//#endregion
+//#region src/instagram/extractors/tagged.ts
+var InstagramTaggedExtractor = class InstagramTaggedExtractor extends InstagramExtractor {
+	static subcategory = "tagged";
+	static pattern = re(BASE_RE, /(\/[^/?#]+)\/tagged/);
+	subcategory = InstagramTaggedExtractor.subcategory;
+	_taggedUserId = "";
 	constructor(opts) {
 		super(opts);
 	}
 	static fromURL(url, opts) {
-		const match = InstagramInfoExtractor.pattern.exec(url);
+		const match = InstagramTaggedExtractor.pattern.exec(url);
 		if (!match) return null;
-		return new InstagramInfoExtractor({
+		return new InstagramTaggedExtractor({
 			...opts,
 			url,
 			match
 		});
 	}
-	async *items() {
+	async metadata() {
 		const screenName = (this.groups[0] ?? "").replace(/^\//, "");
 		let user;
-		if (screenName.startsWith("id:")) user = await this.api.userById(screenName.slice(3));
-		else user = await this.api.userByScreenName(screenName);
-		yield directory(user);
+		if (screenName.startsWith("id:")) {
+			this._taggedUserId = screenName.slice(3);
+			user = await this.api.userById(screenName.slice(3));
+		} else {
+			this._taggedUserId = await this.api.userId(screenName);
+			user = await this.api.userByScreenName(screenName);
+		}
+		return {
+			tagged_owner_id: user.id ?? user.pk,
+			tagged_username: user.username,
+			tagged_full_name: user.full_name
+		};
+	}
+	async *posts() {
+		if (!this._taggedUserId) await this.metadata();
+		yield* this.api.userTagged(this._taggedUserId);
 	}
-	async *posts() {}
 };
-var InstagramAvatarExtractor = class InstagramAvatarExtractor extends InstagramExtractor {
-	static subcategory = "avatar";
-	static pattern = re(BASE_RE, /(\/[^/?#]+)\/avatar/);
-	subcategory = InstagramAvatarExtractor.subcategory;
+register(InstagramTaggedExtractor.subcategory, InstagramTaggedExtractor);
+//#endregion
+//#region src/instagram/extractors/user.ts
+var InstagramUserExtractor = class InstagramUserExtractor extends InstagramExtractor {
+	static subcategory = "user";
+	static pattern = re(BASE_RE, /(\/[^/?#]+)\/?(?:$|[?#])/);
+	subcategory = InstagramUserExtractor.subcategory;
 	constructor(opts) {
 		super(opts);
 	}
 	static fromURL(url, opts) {
-		const match = InstagramAvatarExtractor.pattern.exec(url);
+		const match = InstagramUserExtractor.pattern.exec(url);
 		if (!match) return null;
-		return new InstagramAvatarExtractor({
+		return new InstagramUserExtractor({
 			...opts,
 			url,
 			match
 		});
 	}
-	async *posts() {
-		const screenName = (this.groups[0] ?? "").replace(/^\//, "");
-		let user;
-		if (screenName.startsWith("id:")) user = await this.api.userById(screenName.slice(3));
-		else user = await this.api.userByScreenName(screenName);
-		const avatar = user.hd_profile_pic_url_info ?? user.hd_profile_pic_versions?.[user.hd_profile_pic_versions.length - 1] ?? {
-			url: user.profile_pic_url ?? "",
-			width: 0,
-			height: 0
+	async *items() {
+		await this.login();
+		const userPath = this.groups[0] ?? "/";
+		const base = `${this.root}${userPath}/`;
+		const storiesUrl = `${this.root}/stories/${userPath.slice(1)}/`;
+		const include = this._cfg("include", ["posts"]);
+		const categories = include === "all" ? [
+			"posts",
+			"reels",
+			"tagged",
+			"stories",
+			"highlights",
+			"info",
+			"avatar"
+		] : typeof include === "string" ? include.replace(/\s+/g, "").split(",") : include;
+		const urls = {
+			info: `${base}info/`,
+			avatar: `${base}avatar/`,
+			stories: storiesUrl,
+			highlights: `${base}highlights/`,
+			posts: `${base}posts/`,
+			reels: `${base}reels/`,
+			tagged: `${base}tagged/`
 		};
-		let pk = user.profile_pic_id?.split("_")[0];
-		let code;
-		if (pk) code = shortcodeFromId(pk);
-		else {
-			pk = `avatar:${user.pk}`;
-			code = pk;
+		for (const cat of categories) {
+			const cls = get(cat);
+			const url = urls[cat];
+			if (cls && url) yield queue(url, { _extractor: cls });
+			else this.log.warn(`Invalid include '${cat}'`);
 		}
-		yield {
-			pk,
-			code,
-			user,
-			caption: null,
-			like_count: 0,
-			image_versions2: { candidates: [avatar] }
-		};
 	}
+	async *posts() {}
 };
-var InstagramSavedExtractor = class InstagramSavedExtractor extends InstagramExtractor {
-	static subcategory = "saved";
-	static pattern = re(BASE_RE, /(\/[^/?#]+)\/saved(?:\/all-posts)?\/?$/);
-	subcategory = InstagramSavedExtractor.subcategory;
-	constructor(opts) {
-		super(opts);
+register(InstagramUserExtractor.subcategory, InstagramUserExtractor);
+//#endregion
+//#region src/fetcher.ts
+/** Build URL with query params appended as URLSearchParams. */
+function buildUrl(base, params) {
+	if (!params) return base;
+	const cleaned = {};
+	for (const [k, v] of Object.entries(params)) if (v != null) cleaned[k] = String(v);
+	const entries = Object.entries(cleaned);
+	if (entries.length === 0) return base;
+	const qs = new URLSearchParams(entries).toString();
+	return `${base}${base.includes("?") ? "&" : "?"}${qs}`;
+}
+/** Merge cookie strings with append semantics: a=1 + b=2 → a=1; b=2 */
+function mergeCookie(base, extra) {
+	if (!base) return extra;
+	return `${base}; ${extra}`;
+}
+/** Extract csrftoken value from a Cookie header string. */
+function extractCsrf(cookies) {
+	return cookies.match(/(?:^|;\s*)csrftoken=([^;]+)/)?.[1] ?? "";
+}
+/** Convert fetch Headers to a plain Record. */
+function headersToRecord(headers) {
+	const rec = {};
+	headers.forEach((v, k) => {
+		rec[k] = v;
+	});
+	return rec;
+}
+/** Read response body according to the requested type. */
+async function readBody(resp, responseType) {
+	switch (responseType) {
+		case "arraybuffer": {
+			const buf = await resp.arrayBuffer();
+			return Buffer.from(buf);
+		}
+		case "text": return resp.text();
+		default: return resp.json();
 	}
-	static fromURL(url, opts) {
-		const match = InstagramSavedExtractor.pattern.exec(url);
-		if (!match) return null;
-		return new InstagramSavedExtractor({
-			...opts,
-			url,
-			match
-		});
+}
+/** Serialize a request body value for fetch. */
+function serializeBody(data) {
+	if (data == null) return void 0;
+	if (typeof data === "string") return data;
+	if (data instanceof URLSearchParams) return data;
+	return JSON.stringify(data);
+}
+const UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
+/**
+* Create a platform-agnostic HttpClient backed by native ``fetch``.
+*
+* Zero dependencies — works in Node.js 18+, browsers, Deno, and Edge.
+*
+* @example Plain (no cookies)
+* ```ts
+* const http = createFetchHttpClient()
+* ```
+*
+* @example With static cookies (CLI session mode)
+* ```ts
+* const http = createFetchHttpClient({ cookie: 'sessionid=abc; csrftoken=xyz' })
+* ```
+*
+* @example With cookie jar (anonymous session)
+* ```ts
+* const jar = createCookieJar()
+* const http = createFetchHttpClient({
+*   cookieProvider: () => jar.getCookieHeader(),
+*   onResponse: (headers) => jar.setFromResponse(headers),
+* })
+* ```
+*/
+function createFetchHttpClient(opts = {}) {
+	const { cookie, cookieProvider, userAgent = UA, timeout = 3e4, onResponse } = opts;
+	return { async request(config) {
+		const method = config.method ?? "GET";
+		const url = buildUrl(config.url, config.params);
+		const headers = new Headers(config.headers);
+		const reqCookie = cookieProvider?.() ?? cookie;
+		if (reqCookie) {
+			const existing = headers.get("Cookie");
+			headers.set("Cookie", existing ? mergeCookie(reqCookie, existing) : reqCookie);
+		}
+		if (!headers.has("User-Agent")) headers.set("User-Agent", userAgent);
+		const body = serializeBody(config.data);
+		if (typeof body === "string" && !headers.has("Content-Type")) headers.set("Content-Type", "application/json");
+		let controller = null;
+		let timer = null;
+		let signal = config.signal ?? null;
+		const timeoutMs = config.timeout ?? timeout;
+		if (!signal) {
+			controller = new AbortController();
+			timer = setTimeout(() => controller.abort(), timeoutMs);
+			signal = controller.signal;
+		}
+		try {
+			const resp = await fetch(url, {
+				method,
+				headers,
+				body,
+				signal
+			});
+			onResponse?.(headersToRecord(resp.headers));
+			const data = await readBody(resp, config.responseType);
+			return {
+				status: resp.status,
+				data,
+				headers: headersToRecord(resp.headers),
+				url: resp.url
+			};
+		} catch (err) {
+			if (controller?.signal.aborted && !config.signal?.aborted) throw new Error(`Request timeout after ${timeoutMs}ms: ${url}`);
+			if (String(err).includes("too many redirect")) throw new Error("Too many redirects — session may be expired or invalid. Export a fresh session from your browser.");
+			throw err;
+		} finally {
+			if (timer) clearTimeout(timer);
+		}
+	} };
+}
+//#endregion
+//#region src/sdk.ts
+var InstagramSDK = class {
+	http;
+	storage;
+	log;
+	config;
+	_csrfToken;
+	constructor(opts = {}) {
+		this.http = opts.http ?? createFetchHttpClient();
+		this.storage = opts.storage ?? void 0;
+		this.log = opts.log ?? noopLogger;
+		this.config = new ConfigManager();
+		this._csrfToken = opts.csrfToken ?? "";
 	}
-	async *posts() {
-		yield* this.api.userSaved();
+	/**
+	* Extract messages from an Instagram URL without downloading.
+	*
+	* Returns an async generator yielding Directory / Url / Queue messages.
+	* Each ``url`` message includes full metadata (post_id, username, dimensions, etc.).
+	*/
+	async *extract(url) {
+		const extractor = this._resolve(url);
+		await extractor.initialize();
+		yield* extractor;
+	}
+	/**
+	* Download all media from an Instagram URL.
+	*
+	* Uses the built-in DownloadJob + Storage to save files to disk.
+	* Requires ``storage`` to be set in constructor options.
+	*
+	* ```ts
+	* const stats = await ig.download('https://www.instagram.com/p/.../', './my-downloads')
+	* // → { posts: 1, files: 9, bytes: 4500000 }
+	* ```
+	*/
+	async download(url, outputDir = "./data") {
+		const job = new DownloadJob(this._resolve(url));
+		job.basePath = outputDir;
+		await job.run();
+		return {
+			posts: job._postCount ?? 0,
+			files: job._fileCount ?? 0,
+			bytes: job._downloadedBytes ?? 0
+		};
+	}
+	/** Resolve a URL to an Extractor instance via pattern matching. */
+	_resolve(url) {
+		for (const Cls of [
+			InstagramPostExtractor,
+			InstagramStoriesExtractor,
+			InstagramHighlightsExtractor,
+			InstagramTagExtractor,
+			InstagramSavedExtractor,
+			InstagramPostsExtractor,
+			InstagramReelsExtractor,
+			InstagramTaggedExtractor,
+			InstagramInfoExtractor,
+			InstagramAvatarExtractor,
+			InstagramUserExtractor
+		]) {
+			const match = Cls.pattern.exec(url);
+			if (match) return Reflect.construct(Cls, [{
+				url,
+				match,
+				config: this.config,
+				http: this.http,
+				storage: this.storage,
+				log: this.log,
+				csrfToken: this._csrfToken
+			}]);
+		}
+		throw new Error(`No extractor matched URL: ${url}. Supported: /p/, /reel/, /{user}/, /stories/, /highlights/, /explore/tags/, /saved/`);
 	}
 };
 //#endregion
-export { idFromShortcode as A, parseUnicodeEscapes$1 as C, queue as D, directory as E, ConfigManager as F, Extractor as I, noopLogger as L, DownloadJob as M, Job as N, url as O, PrintJob as P, parseInt as S, unquote as T, ensureHttpScheme as _, InstagramPostsExtractor as a, findTags as b, InstagramStoriesExtractor as c, InstagramUserExtractor as d, InstagramExtractor as f, parsePostRest as g, parsePostGraphql as h, InstagramPostExtractor as i, shortcodeFromId as j, InstagramRestAPI as k, InstagramTagExtractor as l, extractTaggedUsers as m, InstagramHighlightsExtractor as n, InstagramReelsExtractor as o, extractAudio as p, InstagramInfoExtractor as r, InstagramSavedExtractor as s, InstagramAvatarExtractor as t, InstagramTaggedExtractor as u, extr as v, unescape as w, nameExtFromURL as x, extract as y };
+export { directory as A, _YELLOW as B, extract as C, parseUnicodeEscapes$1 as D, parseInt as E, Extractor as F, pad as G, c as H, noopLogger as I, ConfigManager as K, DownloadJob as L, url as M, idFromShortcode as N, unescape as O, shortcodeFromId as P, Job as R, extr as S, nameExtFromURL as T, dim as U, b as V, g as W, extractAudio as _, InstagramTaggedExtractor as a, InstagramRestAPI as b, InstagramSavedExtractor as c, InstagramPostExtractor as d, InstagramInfoExtractor as f, parsePostGraphql as g, InstagramExtractor as h, InstagramUserExtractor as i, queue as j, unquote as k, InstagramReelsExtractor as l, InstagramAvatarExtractor as m, createFetchHttpClient as n, InstagramTagExtractor as o, InstagramHighlightsExtractor as p, extractCsrf as r, InstagramStoriesExtractor as s, InstagramSDK as t, InstagramPostsExtractor as u, extractTaggedUsers as v, findTags as w, ensureHttpScheme as x, parsePostRest as y, _RESET as z };