instasave-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nykadamec
+
+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

@@ -0,0 +1,153 @@
+# InstaSave SDK
+
+📸 Simple Instagram scraper for downloading images from posts
+
+## What does it do?
+
+InstaSave SDK allows you to download images from Instagram posts with just a few lines of code. Works with both public and private posts (after login).
+
+## Installation
+
+```bash
+npm install instasave-sdk
+```
+
+## Basic Usage
+
+### 1. Download public post
+
+```javascript
+import { InstaScraper } from 'instasave-sdk';
+
+const scraper = new InstaScraper();
+
+// Download images from Instagram post
+const data = await scraper.scrapePost('https://www.instagram.com/p/ABC123/');
+
+console.log(data);
+// Result:
+// {
+//   url: 'https://www.instagram.com/p/ABC123/',
+//   post_id: 'ABC123',
+//   profile_name: 'username',
+//   images: [
+//     'https://instagram.com/image1.jpg',
+//     'https://instagram.com/image2.jpg'
+//   ]
+// }
+```
+
+### 2. Save to file
+
+```javascript
+const data = await scraper.scrapePost('https://www.instagram.com/p/ABC123/', {
+  saveToFile: true,           // Save data to JSON file
+  outputPath: './downloads'   // Folder to save to
+});
+```
+
+### 3. Access private posts
+
+```javascript
+// Login first
+await scraper.login({
+  username: 'your_username',
+  password: 'your_password'
+});
+
+// Then you can download private posts
+const data = await scraper.scrapePost('https://www.instagram.com/p/private_post/');
+```
+
+## What SDK supports
+
+✅ **Single posts** - One image  
+✅ **Carousel posts** - Multiple images in one post  
+✅ **Private posts** - After login  
+✅ **Auto save** - To JSON file  
+✅ **Error handling** - When something fails  
+
+❌ **Videos/Reels** - Images only  
+❌ **Stories** - Posts only  
+
+## All options
+
+```javascript
+const data = await scraper.scrapePost('URL', {
+  saveToFile: true,        // Save to file? (default: false)
+  outputPath: './folder',  // Where to save? (default: current folder)
+  timeout: 60,            // Timeout in seconds (default: 60)
+  retries: 2,             // How many retries on error (default: 0)
+  headless: true          // Hidden browser? (default: true)
+});
+```
+
+## Common errors and solutions
+
+### "Login required"
+```javascript
+// Solution: Login before downloading
+await scraper.login({ username: 'user', password: 'pass' });
+```
+
+### "Failed to extract post ID"
+```javascript
+// Solution: Check URL - must contain /p/
+// ✅ Correct: https://www.instagram.com/p/ABC123/
+// ❌ Wrong: https://www.instagram.com/username/
+```
+
+### "Timeout"
+```javascript
+// Solution: Increase timeout
+const data = await scraper.scrapePost(url, { timeout: 120 });
+```
+
+## Complete example
+
+```javascript
+import { InstaScraper } from 'instasave-sdk';
+
+async function downloadInstagramPost() {
+  const scraper = new InstaScraper();
+  
+  try {
+    // Optionally login for private posts
+    // await scraper.login({
+    //   username: 'your_username',
+    //   password: 'your_password'
+    // });
+    
+    const data = await scraper.scrapePost(
+      'https://www.instagram.com/p/ABC123/',
+      {
+        saveToFile: true,
+        outputPath: './instagram_downloads',
+        timeout: 90
+      }
+    );
+    
+    console.log(`✅ Downloaded ${data.images.length} images from @${data.profile_name}`);
+    console.log('Images:', data.images);
+    
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+  }
+}
+
+downloadInstagramPost();
+```
+
+## Requirements
+
+- Node.js 16 or newer
+- Internet connection
+- For private posts: valid Instagram account
+
+## License
+
+MIT - use anywhere
+
+## Support
+
+Having issues? Create an [issue on GitHub](https://github.com/nykadamec/instasave-sdk/issues)

package/dist/auth-fast.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Fast authentication module for Instagram login
+ */
+import { Page } from 'puppeteer';
+export interface LoginCredentials {
+    username: string;
+    password: string;
+}
+export declare class FastAuthManager {
+    private authenticated;
+    private username;
+    private displayName;
+    private sessionPath;
+    constructor();
+    private sleep;
+    private loadSession;
+    private saveSession;
+    private clearSession;
+    saveSessionData(cookies?: any[]): Promise<void>;
+    refreshSession(page: Page): Promise<boolean>;
+    isAuthenticated(): boolean;
+    getUsername(): string | null;
+    getDisplayName(): string | null;
+    logout(): Promise<void>;
+    refreshUserInfo(page: Page): Promise<{
+        username: string | null;
+        displayName: string | null;
+    }>;
+    applyCookies(page: Page): Promise<void>;
+    login(page: Page, credentials: LoginCredentials): Promise<boolean>;
+}
+//# sourceMappingURL=auth-fast.d.ts.map

package/dist/auth-fast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-fast.d.ts","sourceRoot":"","sources":["../src/auth-fast.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAsC;;IAMzD,OAAO,CAAC,KAAK;YAIC,WAAW;YAeX,WAAW;YA0BX,YAAY;IAYpB,eAAe,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAwClD,eAAe,IAAI,OAAO;IAI1B,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B,cAAc,IAAI,MAAM,GAAG,IAAI;IAIzB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAiG7F,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BvC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;CA8TzE"}