@chilfish/gallery-dl-instagram 0.1.0

package/dist/sdk.d.mts

@@ -0,0 +1,2 @@
+import { a as InstagramHighlightsExtractor, c as InstagramPostsExtractor, d as InstagramStoriesExtractor, f as InstagramTagExtractor, i as InstagramAvatarExtractor, l as InstagramReelsExtractor, m as InstagramUserExtractor, n as InstagramSDK, o as InstagramInfoExtractor, p as InstagramTaggedExtractor, r as SDKOptions, s as InstagramPostExtractor, t as ExtractOptions, u as InstagramSavedExtractor } from "./sdk-B9fRyc1e.mjs";
+export { ExtractOptions, InstagramAvatarExtractor, InstagramHighlightsExtractor, InstagramInfoExtractor, InstagramPostExtractor, InstagramPostsExtractor, InstagramReelsExtractor, InstagramSDK, InstagramSavedExtractor, InstagramStoriesExtractor, InstagramTagExtractor, InstagramTaggedExtractor, InstagramUserExtractor, SDKOptions };

package/dist/sdk.mjs

@@ -0,0 +1,93 @@
+import { F as ConfigManager, L as noopLogger, M as DownloadJob, a as InstagramPostsExtractor, c as InstagramStoriesExtractor, d as InstagramUserExtractor, i as InstagramPostExtractor, l as InstagramTagExtractor, n as InstagramHighlightsExtractor, o as InstagramReelsExtractor, r as InstagramInfoExtractor, s as InstagramSavedExtractor, t as InstagramAvatarExtractor, u as InstagramTaggedExtractor } from "./extractors-Byw-2lPL.mjs";
+//#region sdk.ts
+var InstagramSDK = class {
+	http;
+	storage;
+	log;
+	config;
+	_csrfToken;
+	constructor(opts) {
+		this.http = opts.http;
+		this.storage = opts.storage ?? void 0;
+		this.log = opts.log ?? noopLogger;
+		this.config = new ConfigManager();
+		this._csrfToken = opts.csrfToken ?? "";
+	}
+	/** High-level API */
+	/**
+	* 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.).
+	*
+	* ```ts
+	* for await (const msg of instagram.extract('https://www.instagram.com/p/.../')) {
+	*   if (msg.type === 'url') {
+	*     console.log(msg.url, msg.metadata.media_id)
+	*   }
+	* }
+	* ```
+	*/
+	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 instagram.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
+		};
+	}
+	/** Internal */
+	/**
+	* 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 { InstagramAvatarExtractor, InstagramHighlightsExtractor, InstagramInfoExtractor, InstagramPostExtractor, InstagramPostsExtractor, InstagramReelsExtractor, InstagramSDK, InstagramSavedExtractor, InstagramStoriesExtractor, InstagramTagExtractor, InstagramTaggedExtractor, InstagramUserExtractor };

package/index.ts

@@ -0,0 +1,159 @@
+/**
+ * gallery-dl TypeScript port — public API.
+ *
+ * Usage:
+ *
+ * ```ts
+ * import { DownloadJob, InstagramPostExtractor, ConfigManager } from './ts/index';
+ *
+ * const config = new ConfigManager({
+ *   extractor: {
+ *     instagram: {
+ *       videos: false,
+ *       'max-posts': 10,
+ *     },
+ *   },
+ * });
+ *
+ * const opts = {
+ *   url: 'https://www.instagram.com/p/CxAbCdEfGh/',
+ *   match: InstagramPostExtractor.pattern.exec('https://www.instagram.com/p/CxAbCdEfGh/')!,
+ *   config,
+ *   http,           // your HttpClient implementation
+ *   storage,        // your Storage implementation
+ *   log: console,   // or custom Logger
+ * };
+ *
+ * const extractor = new InstagramPostExtractor(opts);
+ * const job = new DownloadJob(extractor);
+ * const status = await job.run();
+ * ```
+ */
+
+import type { Logger } from './core/extractor'
+import type { HttpClient, Storage } from './types'
+import { createHttpClient, createStorage, extractCsrfFromCookies } from './cli/adapter'
+import { noopLogger } from './core/extractor'
+
+// Config
+export { ConfigManager } from './config'
+// Core
+export { Extractor } from './core/extractor'
+export type {
+  ExtractorOptions,
+  Logger,
+} from './core/extractor'
+export { noopLogger } from './core/extractor'
+
+export { DownloadJob, Job, PrintJob } from './core/job'
+
+// Instagram
+export * from './instagram/index'
+// Message
+export { directory, queue, url } from './message'
+
+export type { MessageIter } from './message'
+
+// SDK (high-level) — platform-agnostic class
+export { InstagramSDK } from './sdk'
+
+export type { ExtractOptions, SDKOptions } from './sdk'
+// Types
+export type {
+  Config,
+  ConfigValue,
+  DirectoryMsg,
+  ExtractorClass,
+  HttpClient,
+  HttpResponse,
+  Message,
+  Metadata,
+  QueueMsg,
+  RequestConfig,
+  Storage,
+  UrlMsg,
+} from './types'
+
+// Utils
+export { idFromShortcode, shortcodeFromId } from './utils/id-codec'
+export {
+  ensureHttpScheme,
+  extr,
+  extract,
+  findTags,
+  nameExtFromURL,
+  parseInt,
+  parseUnicodeEscapes,
+  unescape,
+  unquote,
+} from './utils/text'
+
+/** Options for the Node.js convenience factory. */
+export interface CreateSDKOptions {
+  /**
+   * Full browser Cookie header string.
+   * Copy from DevTools → Network → Request Headers → Cookie.
+   * Auto-extracts csrftoken for X-CSRFToken header.
+   *
+   * Either ``cookies`` or ``http`` must be provided.
+   */
+  cookies?: string
+
+  /**
+   * Custom HttpClient implementation.
+   * If omitted, a Node.js axios-based client is created from ``cookies``.
+   */
+  http?: HttpClient
+
+  /**
+   * Custom Storage implementation for file output.
+   * Defaults to Node.js fs/promises-based storage.
+   */
+  storage?: Storage
+
+  /**
+   * Logger instance.  Defaults to a silent no-op logger.
+   */
+  log?: Logger
+}
+
+/**
+ * Create an SDK instance with Node.js defaults.
+ *
+ * When ``cookies`` is provided, auto-creates an axios-based HttpClient
+ * with CSRF token extraction.  Pass ``http`` directly for custom adapters.
+ *
+ * ```ts
+ * import { createSDK } from '@chilfish/gallery-dl-instagram'
+ *
+ * // Node.js with cookies
+ * const ig = await createSDK({ cookies: 'ds_user_id=...; sessionid=...' })
+ *
+ * // Custom http adapter (browser / Deno / Edge)
+ * const ig = await createSDK({ http: myHttpClient, storage: myStorage })
+ * ```
+ */
+export async function createSDK(opts: CreateSDKOptions = {}): Promise<import('./sdk').InstagramSDK> {
+  const { InstagramSDK } = await import('./sdk')
+  const log = opts.log ?? noopLogger
+  const storage = opts.storage ?? createStorage()
+
+  let http: HttpClient
+  let csrfToken = ''
+
+  if (opts.http) {
+    http = opts.http
+  }
+  else if (opts.cookies) {
+    csrfToken = extractCsrfFromCookies(opts.cookies)
+    http = createHttpClient(undefined, opts.cookies, log)
+  }
+  else {
+    throw new Error(
+      'Either "cookies" or "http" must be provided. '
+      + 'Get cookies from browser DevTools → Application → Cookies → instagram.com',
+    )
+  }
+
+  return new InstagramSDK({ http, storage, log, csrfToken })
+}