nodejs-insta-private-api-mqtt 1.1.9 → 1.2.10

package/README.md

@@ -173,51 +173,64 @@ console.log('Build:', info.build);
 console.log('User Agent:', info.userAgent);
 ```
 
-### Complete Bot Example with Custom Device
+### 178. Complete Bot Example with Instant MQTT Boot
+
+This example demonstrates how to build a production-ready bot that restores its session and connects to MQTT instantly upon startup.
 
 ```javascript
-const { IgApiClient, RealtimeClient } = require('nodejs-insta-private-api-mqtt');
-const fs = require('fs');
+const { IgApiClient, RealtimeClient, useMultiFileAuthState } = require('nodejs-insta-private-api-mqtt');
 
 async function startBot() {
   const ig = new IgApiClient();
   
-  // Step 1: Set your preferred device BEFORE login
-  ig.state.usePresetDevice('Samsung Galaxy S25 Ultra');
-  
-  console.log('Device configured:', ig.state.deviceString);
-  console.log('User Agent:', ig.state.appUserAgent);
-  
-  // Step 2: Login
-  await ig.login({
-    username: process.env.IG_USERNAME,
-    password: process.env.IG_PASSWORD
-  });
-  
-  console.log('Login successful!');
+  // 1. Initialize the multi-file auth state (Baileys style)
+  // This folder stores your credentials, cookies, and MQTT session
+  const auth = await useMultiFileAuthState('./auth_info_ig');
   
-  // Step 3: Save session (device info is included)
-  const session = await ig.state.serialize();
-  fs.writeFileSync('session.json', JSON.stringify(session, null, 2));
+  // 2. Setup your device emulation
+  ig.state.usePresetDevice('Samsung Galaxy S25 Ultra');
   
-  // Step 4: Connect to real-time messaging
+  // 3. Initialize the RealtimeClient
+  // IMPORTANT: Because we modified the constructor, this will AUTOMATICALLY 
+  // detect the session in ./auth_info_ig and start MQTT in the background.
   const realtime = new RealtimeClient(ig);
-  const inbox = await ig.direct.getInbox();
-  
-  await realtime.connect({
-    graphQlSubs: ['ig_sub_direct', 'ig_sub_direct_v2_message_sync'],
-    skywalkerSubs: ['presence_subscribe', 'typing_subscribe'],
-    irisData: inbox
+
+  // 4. Set up your event listeners
+  realtime.on('connected', () => {
+    console.log('🚀 Bot is online and MQTT is connected!');
   });
-  
-  console.log('Bot is online with Samsung Galaxy S25 Ultra emulation!');
-  
-  realtime.on('message', (data) => {
-    console.log('New message:', data.message?.text);
+
+  realtime.on('message_live', async (msg) => {
+    console.log(`📩 [${msg.username}]: ${msg.text}`);
+    
+    // Simple auto-reply logic
+    if (msg.text.toLowerCase() === 'ping') {
+      await realtime.directCommands.sendTextViaRealtime(msg.thread_id, 'pong! 🏓');
+    }
   });
-  
-  // Keep running
-  await new Promise(() => {});
+
+  // 5. Handle the initial "Pairing" (only happens once)
+  if (!auth.hasSession()) {
+    console.log('No session found. Please login to pair your account...');
+    
+    await ig.login({
+      username: 'your_username',
+      password: 'your_password'
+    });
+    
+    // Save credentials for the next boot
+    await auth.saveCreds(ig);
+    
+    // Start the realtime sync for the first time
+    await realtime.startRealTimeListener();
+    
+    // Save the MQTT state so we can boot instantly next time
+    await auth.saveMqttSession(realtime);
+    
+    console.log('✅ Pairing successful! Next time you run this, it will boot INSTANTLY.');
+  } else {
+    console.log('✨ Existing session detected. Instant MQTT boot sequence initiated...');
+  }
 }
 
 startBot().catch(console.error);
@@ -250,100 +263,109 @@ startBot().catch(console.error);
 
 ---
 
-## NEW: useMultiFileAuthState (v5.60.2)
+## 🚀 NEW: Instant MQTT Connection (v5.70.0)
 
-This feature provides **Baileys-style multi-file session persistence** for Instagram. Instead of storing everything in a single `session.json`, the session is split across multiple files for better organization, security, and reliability.
+We've completely overhauled how the MQTT connection works. You no longer need to manually manage connection states every time your bot restarts. Just like **Baileys**, if a session is present in the default folder, the library takes care of everything for you.
 
-### Session Files Structure
+### Why this is a game changer:
+- **Zero Configuration**: No need to pass IRIS data or subscription topics manually on every boot.
+- **Background Startup**: The MQTT connection starts the moment you create the `RealtimeClient`.
+- **Session Persistence**: Cookies, device info, and MQTT state are managed automatically.
 
+### 🔌 How to use Instant Boot
+
+Once you've linked your account (see the setup section below), your main script can be as simple as this:
+
+```javascript
+const { IgApiClient, RealtimeClient } = require('nodejs-insta-private-api-mqtt');
+
+// 1. Initialize the client
+const ig = new IgApiClient();
+
+// 2. That's it! 
+// If ./auth_info_ig exists, MQTT starts background connection immediately.
+const realtime = new RealtimeClient(ig);
+
+// 3. Listen for events
+realtime.on('connected', () => {
+    console.log('✅ MQTT is live and kicking!');
+});
+
+realtime.on('message_live', (msg) => {
+    console.log(`📩 New message from ${msg.username}: ${msg.text}`);
+});
+
+realtime.on('error', (err) => {
+    console.error('❌ MQTT Connection issue:', err.message);
+});
 ```
-auth_info_instagram/
-├── creds.json          # Authorization tokens (Bearer token, claims)
-├── device.json         # Device information (device ID, UUID, phone ID)
-├── cookies.json        # HTTP cookies for API requests
-├── mqtt-session.json   # MQTT real-time session data
-├── subscriptions.json  # GraphQL and Skywalker subscriptions
-├── seq-ids.json        # Sequence IDs for message sync
-└── app-state.json      # Application state and preferences
-```
 
-### Basic Usage
+### 🔐 Initial Setup (Pairing)
+
+The first time you run your bot, you need to perform a "pairing" login to generate the session files.
 
 ```javascript
 const { IgApiClient, RealtimeClient, useMultiFileAuthState } = require('nodejs-insta-private-api-mqtt');
 
-async function main() {
-  // Initialize multi-file auth state
-  const authState = await useMultiFileAuthState('./auth_info_instagram');
-  
-  const ig = new IgApiClient();
+async function pair() {
+    const ig = new IgApiClient();
+    const folder = './auth_info_ig'; // Default folder for instant boot
+    const auth = await useMultiFileAuthState(folder);
+    const realtime = new RealtimeClient(ig);
 
-  // Check if we have a saved session
-  if (authState.hasSession()) {
-    console.log('Loading saved session...');
-    
-    // Load credentials from files
-    await authState.loadCreds(ig);
-    
-    // Validate session with Instagram
-    const isValid = await authState.isSessionValid(ig);
-    
-    if (isValid) {
-      console.log('Session valid! Connecting to MQTT...');
-      
-      // Connect using saved MQTT session
-      const realtime = new RealtimeClient(ig);
-      await realtime.connectFromSavedSession(authState);
-      
-      realtime.on('message', (data) => {
-        console.log('New DM:', data.message.text);
-      });
-      
-      console.log('Bot is running!');
-    } else {
-      console.log('Session expired, need fresh login');
-      await freshLogin(ig, authState);
+    if (!auth.hasSession()) {
+        console.log('Linking account...');
+        await ig.state.generateDevice('your_username');
+        await ig.login({ username: 'your_username', password: 'your_password' });
+        
+        // Save credentials
+        await auth.saveCreds(ig);
+        
+        // Fetch initial sync data and connect MQTT
+        await realtime.startRealTimeListener();
+        
+        // Save the MQTT session for instant boot next time
+        await auth.saveMqttSession(realtime);
+        
+        console.log('✅ Pairing complete! Restart your script to see Instant Boot in action.');
     }
-  } else {
-    console.log('No session found, logging in...');
-    await freshLogin(ig, authState);
-  }
 }
 
-async function freshLogin(ig, authState) {
-  // Login with credentials
-  await ig.login({
-    username: 'your_username',
-    password: 'your_password'
-  });
-  
-  // Save credentials to files
-  await authState.saveCreds(ig);
-  console.log('Credentials saved!');
-  
-  // Connect to MQTT
-  const realtime = new RealtimeClient(ig);
-  const inbox = await ig.direct.getInbox();
-  
-  await realtime.connect({
-    graphQlSubs: ['ig_sub_direct', 'ig_sub_direct_v2_message_sync'],
-    skywalkerSubs: ['presence_subscribe', 'typing_subscribe'],
-    irisData: inbox
-  });
-  
-  // Save MQTT session
-  await authState.saveMqttSession(realtime);
-  console.log('MQTT session saved!');
-  
-  realtime.on('message', (data) => {
-    console.log('New DM:', data.message.text);
-  });
-}
+pair().catch(console.error);
+```
+
+
+### 🔄 Comparison: Old vs New MQTT Logic
+
+| Feature | **BEFORE (Manual)** | **NOW (Instant)** |
+|:--- |:--- |:--- |
+| **Setup** | Manual login + inbox fetch | Just initialize the client |
+| **MQTT Startup** | Manual `realtime.connect()` | Starts automatically in background |
+| **IRIS Sub** | Must pass `irisData` manually | Auto-fetches and connects |
+| **Session** | You manage cookie serialization | Handled by `useMultiFileAuthState` |
+
+#### The Old Way (Painful 😫)
+```javascript
+const ig = new IgApiClient();
+await ig.login({ username: '...', password: '...' });
+const inbox = await ig.direct.getInbox(); // Manual step
+
+const realtime = new RealtimeClient(ig);
+await realtime.connect({
+    graphQlSubs: ['ig_sub_direct'],
+    irisData: inbox // Manual injection
+});
+```
+
+#### The New Way (Instant 🚀)
+```javascript
+const ig = new IgApiClient();
+// If ./auth_info_ig exists, this line starts the background connection!
+const realtime = new RealtimeClient(ig); 
 
-main();
+realtime.on('connected', () => console.log('✅ Online!'));
 ```
 
-### API Reference: useMultiFileAuthState
 
 ```javascript
 const authState = await useMultiFileAuthState(folderPath);

package/dist/realtime/realtime.client.js

@@ -46,6 +46,26 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
         
         this.realtimeDebug(`Applying mixins: ${mixins.map(m => m.name).join(', ')}`);
         (0, mixins_1.applyMixins)(mixins, this, this.ig);
+
+        // Auto-connect if session is available
+        const folder = './auth_info_ig';
+        const { useMultiFileAuthState } = require('../useMultiFileAuthState');
+        const fs = require('fs');
+        const path = require('path');
+        if (fs.existsSync(path.join(folder, 'creds.json'))) {
+            setTimeout(async () => {
+                try {
+                    const auth = await useMultiFileAuthState(folder);
+                    if (auth.hasSession()) {
+                        console.log('[REALTIME] Auto-starting MQTT from constructor...');
+                        await auth.loadCreds(this.ig);
+                        await this.connectFromSavedSession(auth);
+                    }
+                } catch (e) {
+                    console.error('[REALTIME] Constructor auto-connect failed:', e.message);
+                }
+            }, 100);
+        }
     }
 
     /**