@chilfish/gallery-dl-instagram 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { A as Extractor, B as HttpResponse, C as InstagramUser, D as ParserConfig, E as ParsedPost, F as Config, G as RequestConfig, H as MessageIter, I as ConfigValue, K as Storage, L as DirectoryMsg, M as Logger, N as noopLogger, O as TaggedUser, P as ConfigManager, R as ExtractorClass, S as InstagramPost, T as ParsedMedia, U as Metadata, V as Message, W as QueueMsg, _ as InstagramRestAPI, a as InstagramHighlightsExtractor, b as InstagramCarouselItem, c as InstagramPostsExtractor, d as InstagramStoriesExtractor, f as InstagramTagExtractor, g as InstagramExtractorOptions, h as InstagramExtractor, i as InstagramAvatarExtractor, j as ExtractorOptions, k as VideoVersion, l as InstagramReelsExtractor, m as InstagramUserExtractor, n as InstagramSDK, o as InstagramInfoExtractor, p as InstagramTaggedExtractor, q as UrlMsg, r as SDKOptions, s as InstagramPostExtractor, t as ExtractOptions, u as InstagramSavedExtractor, v as Coauthor, w as MusicSticker, x as InstagramLocation, y as ImageCandidate, z as HttpClient } from "./sdk-B9fRyc1e.mjs";
+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.mjs";
 
-//#region core/job.d.ts
+//#region src/core/job.d.ts
 declare abstract class Job {
   readonly extractor: Extractor;
   status: number;
@@ -67,7 +67,470 @@ declare class PrintJob extends Job {
   protected _report(): void;
 }
 //#endregion
-//#region instagram/parsers.d.ts
+//#region src/instagram/types.d.ts
+/**
+ * Instagram API & parsed-post type definitions.
+ *
+ * These mirror the actual JSON shapes returned by Instagram's internal API
+ * (``/api/v1/…``).
+ */
+/** API response types */
+interface InstagramUser {
+  pk: string;
+  id?: string;
+  username: string;
+  full_name: string;
+  is_private?: boolean;
+  profile_pic_url?: string;
+  profile_pic_url_hd?: string;
+  hd_profile_pic_url_info?: ImageCandidate;
+  hd_profile_pic_versions?: ImageCandidate[];
+  profile_pic_id?: string;
+  edge_owner_to_timeline_media?: {
+    count: number;
+  };
+  edge_felix_video_timeline?: {
+    count: number;
+  };
+  edge_saved_media?: {
+    count: number;
+  };
+  edge_mutual_followed_by?: {
+    count: number;
+  };
+  edge_follow?: {
+    count: number;
+  };
+  edge_followed_by?: {
+    count: number;
+  };
+  edge_media_collections?: {
+    count: number;
+  };
+  followed_by_viewer?: boolean;
+}
+interface ImageCandidate {
+  url: string;
+  width: number;
+  height: number;
+}
+interface VideoVersion {
+  url: string;
+  width: number;
+  height: number;
+  type: number;
+}
+interface InstagramLocation {
+  pk: string;
+  short_name: string;
+}
+interface Caption {
+  text: string;
+}
+interface UserTag {
+  user: InstagramUser;
+}
+interface ReelMention {
+  user: InstagramUser;
+}
+interface BloksSticker {
+  bloks_sticker: {
+    bloks_sticker_type: string;
+    sticker_data: {
+      ig_mention: {
+        account_id: string;
+        username: string;
+        full_name: string;
+      };
+    };
+  };
+}
+interface MusicSticker {
+  music_asset_info?: MusicAssetInfo;
+  music_consumption_info?: MusicConsumptionInfo;
+}
+interface MusicAssetInfo {
+  id: string;
+  title?: string;
+  display_artist?: string;
+  ig_artist?: string;
+  duration_in_ms?: number;
+  highlight_start_times_in_ms?: number[];
+  progressive_download_url: string;
+  cover_artwork_uri?: string;
+}
+interface MusicConsumptionInfo {
+  display_artist?: string;
+  ig_artist?: string;
+}
+interface MusicMetadata {
+  music_info?: MusicAssetInfo;
+}
+interface InstagramPost {
+  pk: string;
+  id?: string;
+  code: string;
+  caption: Caption | null;
+  taken_at: number;
+  created_at?: number;
+  like_count?: number;
+  has_liked?: boolean;
+  user: InstagramUser;
+  carousel_media?: InstagramCarouselItem[];
+  image_versions2: {
+    candidates: ImageCandidate[];
+  };
+  video_versions?: VideoVersion[];
+  video_dash_manifest?: string;
+  original_width?: number;
+  original_height?: number;
+  media_type?: number;
+  original_media_type?: number;
+  location?: InstagramLocation;
+  coauthor_producers?: InstagramUser[];
+  usertags?: {
+    in: UserTag[];
+  };
+  reel_mentions?: ReelMention[];
+  story_bloks_stickers?: BloksSticker[];
+  story_music_stickers?: MusicSticker[];
+  music_metadata?: MusicMetadata;
+  expiring_at?: number;
+  seen?: number;
+  items?: InstagramCarouselItem[];
+  timeline_pinned_user_ids?: string[];
+  clips_tab_pinned_user_ids?: string[];
+  subscription_media_visibility?: string;
+  audience?: string;
+  title?: string;
+  pins?: unknown[];
+}
+interface InstagramCarouselItem {
+  pk: string;
+  id?: string;
+  code?: string;
+  taken_at?: number;
+  image_versions2: {
+    candidates: ImageCandidate[];
+  };
+  video_versions?: VideoVersion[];
+  video_dash_manifest?: string;
+  original_width?: number;
+  original_height?: number;
+  media_type?: number;
+  original_media_type?: number;
+  owner?: InstagramUser;
+  reshared_story_media_author?: InstagramUser;
+  expiring_at?: number;
+  subscription_media_visibility?: string;
+  audience?: string;
+  story_music_stickers?: MusicSticker[];
+  usertags?: {
+    in: UserTag[];
+  };
+  reel_mentions?: ReelMention[];
+  story_bloks_stickers?: BloksSticker[];
+}
+/** Parsed post (normalized output) */
+interface ParsedPost {
+  post_id: string;
+  post_shortcode: string;
+  post_url: string;
+  owner_id: string;
+  username: string;
+  fullname: string;
+  post_date: string;
+  date: string;
+  description: string;
+  tags?: string[];
+  location_id?: string;
+  location_slug?: string;
+  location_url?: string;
+  likes: number;
+  liked: boolean;
+  pinned: string[];
+  coauthors?: Coauthor[];
+  sidecar_media_id?: string;
+  sidecar_shortcode?: string;
+  type: 'post' | 'reel' | 'story' | 'highlight';
+  count: number;
+  _files: ParsedMedia[];
+  user?: InstagramUser;
+  expires?: string;
+  highlight_title?: string;
+  tagged_owner_id?: string;
+  tagged_username?: string;
+  tagged_full_name?: string;
+  subscription?: string;
+  /** For graphql: */
+  typename?: string;
+}
+interface ParsedMedia {
+  num: number;
+  date: string;
+  media_id: string;
+  shortcode: string;
+  display_url: string;
+  video_url: string | null;
+  width: number;
+  width_original: number;
+  height: number;
+  height_original: number;
+  tagged_users: TaggedUser[];
+  owner?: InstagramUser;
+  author?: InstagramUser;
+  expires?: string;
+  subscription?: string;
+  audience?: string;
+  audio_url?: string;
+  audio_user?: string;
+  audio_title?: string;
+  audio_artist?: string;
+  audio_duration?: number;
+  audio_timestamps?: number[];
+  _ytdl_manifest_data?: string;
+  sidecar_media_id?: string;
+  sidecar_shortcode?: string;
+}
+interface Coauthor {
+  id: string;
+  username: string;
+  full_name?: string;
+}
+interface TaggedUser {
+  id: string;
+  username: string;
+  full_name: string;
+}
+/** Parser config */
+interface ParserConfig {
+  root: string;
+  findTags: (text: string) => string[];
+  parseTimestamp: (ts: number | null | undefined) => string;
+  staticVideo: boolean;
+  warnVideo: boolean;
+  warnImage: number;
+  videosDash: boolean;
+}
+//#endregion
+//#region src/instagram/api.d.ts
+declare class InstagramRestAPI {
+  private readonly http;
+  private readonly root;
+  private readonly getCsrf;
+  private readonly getWwwClaim;
+  private readonly setWwwClaim;
+  private readonly setCsrf;
+  /** A ref to the extractor's cursor. */
+  private getCursor;
+  private setCursor;
+  constructor(opts: {
+    http: HttpClient;
+    root: string;
+    csrfToken: {
+      value: string;
+    };
+    wwwClaim: {
+      value: string;
+    };
+    cursor: {
+      value: string | null;
+    };
+  });
+  /** Public endpoint methods */
+  /** Single post by shortcode. */
+  media(shortcode: string): AsyncGenerator<InstagramPost>;
+  /** Paginated user feed. */
+  userFeed(userId: string): AsyncGenerator<InstagramPost>;
+  /** Paginated user reels (POST endpoint). */
+  userClips(userId: string): AsyncGenerator<InstagramPost>;
+  /** Paginated tagged posts. */
+  userTagged(userId: string): AsyncGenerator<InstagramPost>;
+  /** Paginated saved posts (media wrapper). */
+  userSaved(): AsyncGenerator<InstagramPost>;
+  /** Paginated collection. */
+  userCollection(collectionId: string): AsyncGenerator<InstagramPost>;
+  /** Reels media — batch call, returns full reel objects. */
+  reelsMedia(reelIds: string[]): Promise<InstagramPost[]>;
+  /** Story tray. */
+  reelsTray(): Promise<InstagramPost[]>;
+  /** Highlights list (tray). */
+  highlightsTray(userId: string): Promise<{
+    id: string;
+  }[]>;
+  /** All highlights' media batched by ``chunkSize``. */
+  highlightsMedia(userId: string, chunkSize?: number): AsyncGenerator<InstagramPost>;
+  /** Hashtag posts (via sections). */
+  tagsMedia(tag: string): AsyncGenerator<InstagramPost>;
+  private tagsSections;
+  /** User by numeric ID. */
+  userById(userId: string): Promise<InstagramUser>;
+  /** User by username (web_profile_info). */
+  userByName(username: string): Promise<InstagramUser>;
+  /** Search user by username. */
+  userBySearch(username: string): Promise<InstagramUser>;
+  /** Scrape user ID from HTML profile page. */
+  userByWeb(username: string): Promise<{
+    id: string;
+  }>;
+  /** Resolve screen name via fallback chain: search → info → web. */
+  userByScreenName(screenName: string): Promise<InstagramUser>;
+  /** Resolve username/id to numeric user ID string. */
+  userId(screenName: string, checkPrivate?: boolean): Promise<string>;
+  /** Followers (paginated). */
+  userFollowers(userId: string): AsyncGenerator<InstagramUser>;
+  /** Following (paginated). */
+  userFollowing(userId: string): AsyncGenerator<InstagramUser>;
+  /** Internal — HTTP call */
+  private _call;
+  /** Pagination engines */
+  private _pagination;
+  private _paginationPost;
+  private _paginationSections;
+  private _paginationFollowing;
+  private _parseIntCursor;
+}
+//#endregion
+//#region src/instagram/base.d.ts
+interface InstagramExtractorOptions extends ExtractorOptions {
+  sessionId?: string;
+  cookies?: Record<string, string>;
+  /** Pre-seeded CSRF token (from anonymous session cookie jar). */
+  csrfToken?: string;
+}
+declare class Ref<T> {
+  value: T;
+  constructor(v: T);
+}
+declare abstract class InstagramExtractor extends Extractor {
+  readonly category = "instagram";
+  readonly root = "https://www.instagram.com";
+  api: InstagramRestAPI;
+  csrfToken: Ref<string>;
+  wwwClaim: Ref<string>;
+  cursor: Ref<string | null>;
+  protected _loggedIn: boolean;
+  protected _user: InstagramUser | null;
+  private readonly _findTags;
+  private readonly _csrfSeed;
+  constructor(opts: InstagramExtractorOptions);
+  /** Initialization */
+  protected _init(): Promise<void>;
+  /** Request override */
+  request(url: string, cfg?: RequestConfig): Promise<HttpResponse<unknown>>;
+  /** Login */
+  login(): Promise<void>;
+  /** Core pipeline */
+  items(): MessageIter;
+  /** Subclass hooks */
+  /** @virtual */
+  metadata(): Promise<Record<string, unknown>>;
+  abstract posts(): AsyncGenerator<InstagramPost>;
+  /** Cursor management */
+  protected _initCursor(): string | null;
+  protected _updateCursor(cursor: string | null): string | null;
+  /** User assignment */
+  protected _assignUser(user: InstagramUser): void;
+}
+//#endregion
+//#region src/instagram/extractors.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>;
+}
+declare class InstagramUserExtractor extends InstagramExtractor {
+  static readonly subcategory = "user";
+  static pattern: RegExp;
+  readonly subcategory = "user";
+  constructor(opts: InstagramExtractorOptions);
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramUserExtractor | null;
+  items(): MessageIter;
+  posts(): AsyncGenerator<InstagramPost>;
+}
+declare class InstagramPostsExtractor extends InstagramExtractor {
+  static readonly subcategory = "posts";
+  static pattern: RegExp;
+  readonly subcategory = "posts";
+  constructor(opts: InstagramExtractorOptions);
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramPostsExtractor | null;
+  posts(): AsyncGenerator<InstagramPost>;
+}
+declare class InstagramReelsExtractor extends InstagramExtractor {
+  static readonly subcategory = "reels";
+  static pattern: RegExp;
+  readonly subcategory = "reels";
+  constructor(opts: InstagramExtractorOptions);
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramReelsExtractor | null;
+  posts(): AsyncGenerator<InstagramPost>;
+}
+declare class InstagramTaggedExtractor extends InstagramExtractor {
+  static readonly subcategory = "tagged";
+  static pattern: RegExp;
+  readonly subcategory = "tagged";
+  private _taggedUserId;
+  constructor(opts: InstagramExtractorOptions);
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramTaggedExtractor | null;
+  metadata(): Promise<Record<string, unknown>>;
+  posts(): AsyncGenerator<InstagramPost>;
+}
+declare class InstagramStoriesExtractor extends InstagramExtractor {
+  static readonly subcategory = "stories";
+  static pattern: RegExp;
+  readonly subcategory = "stories";
+  private highlightId;
+  private mediaId;
+  constructor(opts: InstagramExtractorOptions);
+  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>;
+}
+declare class InstagramTagExtractor extends InstagramExtractor {
+  static readonly subcategory = "tag";
+  static pattern: RegExp;
+  readonly subcategory = "tag";
+  constructor(opts: InstagramExtractorOptions);
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramTagExtractor | null;
+  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";
+  static pattern: RegExp;
+  readonly subcategory = "avatar";
+  constructor(opts: InstagramExtractorOptions);
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramAvatarExtractor | null;
+  posts(): AsyncGenerator<InstagramPost>;
+}
+declare class InstagramSavedExtractor extends InstagramExtractor {
+  static readonly subcategory = "saved";
+  static pattern: RegExp;
+  readonly subcategory = "saved";
+  constructor(opts: InstagramExtractorOptions);
+  static fromURL(url: string, opts: InstagramExtractorOptions): InstagramSavedExtractor | null;
+  posts(): AsyncGenerator<InstagramPost>;
+}
+//#endregion
+//#region src/instagram/parsers.d.ts
 /** Main entry — REST */
 declare function parsePostRest(post: InstagramPost, cfg: ParserConfig): ParsedPost;
 /** Tagged users */
@@ -77,14 +540,14 @@ declare function extractAudio(src: Record<string, unknown>, dest: Record<string,
 /** GraphQL parser */
 declare function parsePostGraphql(post: Record<string, unknown>, cfg: ParserConfig): ParsedPost;
 //#endregion
-//#region message.d.ts
+//#region src/message.d.ts
 declare function directory(metadata?: Metadata): DirectoryMsg;
 declare function url(u: string, metadata?: Metadata): UrlMsg;
 declare function queue(u: string, metadata?: Metadata & {
   _extractor?: ExtractorClass;
 }): QueueMsg;
 //#endregion
-//#region utils/id-codec.d.ts
+//#region src/utils/id-codec.d.ts
 /**
  * Instagram-style Base64-variant ID ↔ shortcode conversion.
  */
@@ -97,7 +560,7 @@ declare function idFromShortcode(shortcode: string): string;
  */
 declare function shortcodeFromId(postId: string | number): string;
 //#endregion
-//#region utils/text.d.ts
+//#region src/utils/text.d.ts
 /**
  * Text utilities ported from gallery-dl's ``text`` module.
  *
@@ -140,48 +603,4 @@ declare function parseInt(value: string | number | null | undefined, default_?:
 /** Pre-configured hashtag regex. */
 declare const findTags: (text: string) => string[];
 //#endregion
-//#region index.d.ts
-/** Options for the Node.js convenience factory. */
-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 })
- * ```
- */
-declare function createSDK(opts?: CreateSDKOptions): Promise<InstagramSDK>;
-//#endregion
-export { type Coauthor, type Config, ConfigManager, type ConfigValue, CreateSDKOptions, type DirectoryMsg, DownloadJob, type ExtractOptions, Extractor, type ExtractorClass, type ExtractorOptions, type HttpClient, type HttpResponse, type ImageCandidate, InstagramAvatarExtractor, type InstagramCarouselItem, InstagramExtractor, type InstagramExtractorOptions, InstagramHighlightsExtractor, InstagramInfoExtractor, type InstagramLocation, type InstagramPost, InstagramPostExtractor, InstagramPostsExtractor, InstagramReelsExtractor, InstagramRestAPI, InstagramSDK, InstagramSavedExtractor, InstagramStoriesExtractor, InstagramTagExtractor, InstagramTaggedExtractor, type InstagramUser, InstagramUserExtractor, Job, type Logger, type Message, type MessageIter, type Metadata, type ParsedMedia, type ParsedPost, type ParserConfig, PrintJob, type QueueMsg, type RequestConfig, type SDKOptions, type Storage, type TaggedUser, type UrlMsg, type VideoVersion, createSDK, directory, ensureHttpScheme, extr, extract, extractAudio, extractTaggedUsers, findTags, idFromShortcode, nameExtFromURL, noopLogger, parseInt, parsePostGraphql, parsePostRest, parseUnicodeEscapes, queue, shortcodeFromId, unescape, unquote, url };
+export { type Coauthor, type Config, ConfigManager, type ConfigValue, type DirectoryMsg, DownloadJob, type ExtractOptions, Extractor, type ExtractorClass, type ExtractorOptions, type HttpClient, type HttpResponse, type ImageCandidate, InstagramAvatarExtractor, type InstagramCarouselItem, InstagramExtractor, type InstagramExtractorOptions, InstagramHighlightsExtractor, InstagramInfoExtractor, type InstagramLocation, type InstagramPost, InstagramPostExtractor, InstagramPostsExtractor, InstagramReelsExtractor, InstagramRestAPI, InstagramSDK, InstagramSavedExtractor, InstagramStoriesExtractor, InstagramTagExtractor, InstagramTaggedExtractor, type InstagramUser, InstagramUserExtractor, Job, type Logger, type Message, type MessageIter, type Metadata, type ParsedMedia, type ParsedPost, type ParserConfig, PrintJob, type QueueMsg, type RequestConfig, type SDKOptions, type Storage, type TaggedUser, type UrlMsg, type VideoVersion, directory, ensureHttpScheme, extr, extract, extractAudio, extractTaggedUsers, findTags, idFromShortcode, nameExtFromURL, noopLogger, parseInt, parsePostGraphql, parsePostRest, parseUnicodeEscapes, queue, shortcodeFromId, unescape, unquote, url };

package/dist/index.mjs

@@ -1,40 +1,2 @@
-import { a as extractCsrfFromCookies, r as createStorage, t as createHttpClient } from "./adapter-Bt86eL1R.mjs";
-import { A as idFromShortcode, C as parseUnicodeEscapes, D as queue, E as directory, F as ConfigManager, I as Extractor, L as noopLogger, M as DownloadJob, N as Job, O as url, P as PrintJob, S as parseInt, T as unquote, _ as ensureHttpScheme, a as InstagramPostsExtractor, b as findTags, c as InstagramStoriesExtractor, d as InstagramUserExtractor, f as InstagramExtractor, g as parsePostRest, h as parsePostGraphql, i as InstagramPostExtractor, j as shortcodeFromId, k as InstagramRestAPI, l as InstagramTagExtractor, m as extractTaggedUsers, n as InstagramHighlightsExtractor, o as InstagramReelsExtractor, p as extractAudio, r as InstagramInfoExtractor, s as InstagramSavedExtractor, t as InstagramAvatarExtractor, u as InstagramTaggedExtractor, v as extr, w as unescape, x as nameExtFromURL, y as extract } from "./extractors-Byw-2lPL.mjs";
-import { InstagramSDK } from "./sdk.mjs";
-//#region index.ts
-/**
-* 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 })
-* ```
-*/
-async function createSDK(opts = {}) {
-	const { InstagramSDK } = await import("./sdk.mjs");
-	const log = opts.log ?? noopLogger;
-	const storage = opts.storage ?? createStorage();
-	let http;
-	let csrfToken = "";
-	if (opts.http) http = opts.http;
-	else if (opts.cookies) {
-		csrfToken = extractCsrfFromCookies(opts.cookies);
-		http = createHttpClient(void 0, 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
-	});
-}
-//#endregion
-export { ConfigManager, DownloadJob, Extractor, InstagramAvatarExtractor, InstagramExtractor, InstagramHighlightsExtractor, InstagramInfoExtractor, InstagramPostExtractor, InstagramPostsExtractor, InstagramReelsExtractor, InstagramRestAPI, InstagramSDK, InstagramSavedExtractor, InstagramStoriesExtractor, InstagramTagExtractor, InstagramTaggedExtractor, InstagramUserExtractor, Job, PrintJob, createSDK, directory, ensureHttpScheme, extr, extract, extractAudio, extractTaggedUsers, findTags, idFromShortcode, nameExtFromURL, noopLogger, parseInt, parsePostGraphql, parsePostRest, parseUnicodeEscapes, queue, shortcodeFromId, unescape, unquote, url };
+import { A as directory, C as nameExtFromURL, D as unquote, E as unescape, F as PrintJob, I as Extractor, L as noopLogger, M as url, N as DownloadJob, O as idFromShortcode, P as Job, R as ConfigManager, S as findTags, T as parseUnicodeEscapes, _ as parsePostRest, a as InstagramPostExtractor, b as extr, c as InstagramSavedExtractor, d as InstagramTaggedExtractor, f as InstagramUserExtractor, g as parsePostGraphql, h as extractTaggedUsers, i as InstagramInfoExtractor, j as queue, k as shortcodeFromId, l as InstagramStoriesExtractor, m as extractAudio, n as InstagramAvatarExtractor, o as InstagramPostsExtractor, p as InstagramExtractor, r as InstagramHighlightsExtractor, s as InstagramReelsExtractor, t as InstagramSDK, u as InstagramTagExtractor, v as InstagramRestAPI, w as parseInt, x as extract, y as ensureHttpScheme } from "./sdk-Bn0VCUIT.mjs";
+export { ConfigManager, DownloadJob, Extractor, InstagramAvatarExtractor, InstagramExtractor, InstagramHighlightsExtractor, InstagramInfoExtractor, InstagramPostExtractor, InstagramPostsExtractor, InstagramReelsExtractor, InstagramRestAPI, InstagramSDK, InstagramSavedExtractor, InstagramStoriesExtractor, InstagramTagExtractor, InstagramTaggedExtractor, InstagramUserExtractor, Job, PrintJob, directory, ensureHttpScheme, extr, extract, extractAudio, extractTaggedUsers, findTags, idFromShortcode, nameExtFromURL, noopLogger, parseInt, parsePostGraphql, parsePostRest, parseUnicodeEscapes, queue, shortcodeFromId, unescape, unquote, url };

package/dist/node.cjs

@@ -0,0 +1,43 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk = require("./sdk-nzhAxf1O.cjs");
+//#region src/node-factory.ts
+/**
+* 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'
+*
+* // 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 })
+* ```
+*/
+async function createSDK(opts = {}) {
+	const log = opts.log ?? require_sdk.noopLogger;
+	let http;
+	let storage = opts.storage;
+	let csrfToken = "";
+	if (opts.http) http = opts.http;
+	else if (opts.cookies) {
+		const { createHttpClient, extractCsrfFromCookies } = await Promise.resolve().then(() => require("./adapter-CFsiiEpM.cjs"));
+		csrfToken = extractCsrfFromCookies(opts.cookies);
+		http = createHttpClient(void 0, opts.cookies, log);
+		if (!storage) {
+			const { createStorage } = await Promise.resolve().then(() => require("./storage-BwGaT6XO.cjs"));
+			storage = createStorage();
+		}
+	} else throw new Error("Either \"cookies\" or \"http\" must be provided. Get cookies from browser DevTools → Application → Cookies → instagram.com");
+	return new require_sdk.InstagramSDK({
+		http,
+		storage,
+		log,
+		csrfToken
+	});
+}
+//#endregion
+exports.createSDK = createSDK;

package/dist/node.d.cts

@@ -0,0 +1,47 @@
+import { b as Storage, n as InstagramSDK, o as Logger, p as HttpClient } from "./sdk-CK9x5wFL.cjs";
+
+//#region src/node-factory.d.ts
+/** Options for the Node.js convenience factory. */
+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'
+ *
+ * // 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 })
+ * ```
+ */
+declare function createSDK(opts?: CreateSDKOptions): Promise<InstagramSDK>;
+//#endregion
+export { type CreateSDKOptions, createSDK };