@vicociv/instaloader 0.2.0 → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,15 @@
 # @vicociv/instaloader
 
+[![npm downloads](https://img.shields.io/npm/dm/@vicociv/instaloader.svg)](https://www.npmjs.com/package/@vicociv/instaloader)
+[![npm bundle size](https://img.shields.io/bundlephobia/minzip/@vicociv/instaloader)](https://bundlephobia.com/package/@vicociv/instaloader)
+[![dependencies](https://img.shields.io/bundlephobia/dependency-count/@vicociv/instaloader)](https://bundlephobia.com/package/@vicociv/instaloader)
+[![tree-shaking](https://img.shields.io/badge/tree--shaking-supported-brightgreen)](https://bundlephobia.com/package/@vicociv/instaloader)
+[![CI](https://github.com/star8ks/instaloader.js/actions/workflows/ci.yml/badge.svg)](https://github.com/star8ks/instaloader.js/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/star8ks/instaloader.js/branch/main/graph/badge.svg)](https://codecov.io/gh/star8ks/instaloader.js)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green.svg)](https://nodejs.org/)
+
 TypeScript port of [instaloader](https://github.com/instaloader/instaloader) - Download Instagram content (posts, stories, profiles) with metadata.
 
 ## Installation
@@ -381,6 +391,20 @@ import {
 } from '@vicociv/instaloader';
 ```
 
+## TODO
+
+- [ ] Download comments
+- [ ] Download IGTV
+- [ ] Download Reels
+- [ ] Location support
+- [ ] CLI tool
+
 ## License
 
 MIT
+
+## Buy Me a Coffee
+
+If you find this project helpful, consider supporting its development:
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/nickyoung)

package/dist/index.d.mts

@@ -543,7 +543,7 @@ declare class InstaloaderContext {
     readonly quiet: boolean;
     readonly iphoneSupport: boolean;
     readonly fatalStatusCodes: number[];
-    private _cookieJar;
+    private _cookieStore;
     private _csrfToken;
     private _username;
     private _userId;
@@ -610,7 +610,7 @@ declare class InstaloaderContext {
      */
     updateCookies(cookies: CookieData): void;
     /**
-     * Build cookie header string from cookie jar.
+     * Build cookie header string from cookie store.
      */
     private _getCookieHeader;
     /**
@@ -637,9 +637,11 @@ declare class InstaloaderContext {
      */
     graphql_query(queryHash: string, variables: JsonObject, referer?: string): Promise<JsonObject>;
     /**
-     * Do a doc_id-based GraphQL Query using POST.
-     * Each request uses fresh dynamic headers (timestamp, connection speed, session ID)
-     * to appear as different clients, which helps bypass rate limiting on retries.
+     * Do a doc_id-based GraphQL Query.
+     *
+     * Uses GET for anonymous requests (works without login) and POST for authenticated
+     * requests. This is the correct behavior - Instagram's API accepts GET for public
+     * data but requires POST with session for authenticated operations.
      */
     doc_id_graphql_query(docId: string, variables: JsonObject, referer?: string): Promise<JsonObject>;
     /**

package/dist/index.d.ts

@@ -543,7 +543,7 @@ declare class InstaloaderContext {
     readonly quiet: boolean;
     readonly iphoneSupport: boolean;
     readonly fatalStatusCodes: number[];
-    private _cookieJar;
+    private _cookieStore;
     private _csrfToken;
     private _username;
     private _userId;
@@ -610,7 +610,7 @@ declare class InstaloaderContext {
      */
     updateCookies(cookies: CookieData): void;
     /**
-     * Build cookie header string from cookie jar.
+     * Build cookie header string from cookie store.
      */
     private _getCookieHeader;
     /**
@@ -637,9 +637,11 @@ declare class InstaloaderContext {
      */
     graphql_query(queryHash: string, variables: JsonObject, referer?: string): Promise<JsonObject>;
     /**
-     * Do a doc_id-based GraphQL Query using POST.
-     * Each request uses fresh dynamic headers (timestamp, connection speed, session ID)
-     * to appear as different clients, which helps bypass rate limiting on retries.
+     * Do a doc_id-based GraphQL Query.
+     *
+     * Uses GET for anonymous requests (works without login) and POST for authenticated
+     * requests. This is the correct behavior - Instagram's API accepts GET for public
+     * data but requires POST with session for authenticated operations.
      */
     doc_id_graphql_query(docId: string, variables: JsonObject, referer?: string): Promise<JsonObject>;
     /**