nodejs-insta-private-api-mqtt 1.3.29 → 1.3.30

package/dist/realtime/realtime.client.js

@@ -1,24 +1,30 @@
-// realtime.client.js
 'use strict';
 
 /*
   RealtimeClient
   --------------
   This file implements the RealtimeClient which manages:
-    - constructing the FBNS/MQTT connection payload
+    - constructing the FBNS/MQTT connection payload (Thrift)
     - starting the MQTT client (MQTToTClient)
     - attaching lifecycle handlers (connect/close/error)
     - keepalives, message-sync refresh and traffic watchdogs
     - wiring MQTT messages into higher-level events (message, iris, receive)
-  Comments below are English explanations added next to the existing logic.
+
+  The implementation keeps original structure while applying compatibility tweaks:
+    - persistent clientMqttSessionId and client_context handling
+    - robust sessionid / mqttJwt / deviceSecret fallbacks
+    - slightly adjusted appSpecificInfo to match mobile client fields
+    - uses mqttot.MQTToTConnection to build a thrift connection payload
+    - MQTT URL remains 'edge-mqtt.facebook.com' (Instagram/Meta edge host)
+  Comments are in English next to logic so you can follow what's happening.
 */
 
-// (keep module imports headers the same as in your original code)
+// Keep module imports similar to your original code
 const constants_1 = require("../constants");
 const commands_1 = require("./commands");
 const shared_1 = require("../shared");
 const mqttot_1 = require("../mqttot");
-// IMPORT MQTTS instead of the local shim (we're using mqtts package)
+// Use mqtts for errors / IllegalStateError compatibility
 const mqtts_1 = require("mqtts");
 const errors_1 = require("../errors");
 const eventemitter3_1 = require("eventemitter3");
@@ -32,7 +38,7 @@ const gap_handler_1 = require("./features/gap-handler");
 const enhanced_direct_commands_1 = require("./commands/enhanced.direct.commands");
 const presence_typing_mixin_1 = require("./mixins/presence-typing.mixin");
 
-// Use INSTAGRAM_VERSION exported from mqttot so it is applied automatically
+// Use INSTAGRAM_VERSION exported from mqttot so it is applied automatically where available
 const INSTAGRAM_VERSION = mqttot_1.INSTAGRAM_VERSION;
 
 /**
@@ -57,6 +63,9 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
         this.realtimeDebug = (0, shared_1.debugChannel)('realtime');
         this.messageDebug = this.realtimeDebug.extend('message');
 
+        // enhanced direct commands debug (exposed for compatibility with the enhanced commands)
+        this.enhancedDebug = this.realtimeDebug.extend('enhanced-commands');
+
         // safeDisconnect flag used when user intentionally disconnects
         this.safeDisconnect = false;
 
@@ -81,6 +90,10 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
         // apply mixins to this instance (keeps modular features separated)
         (0, mixins_1.applyMixins)(mixins, this, this.ig);
 
+        // Default subscriptions (force-enable if saved ones are empty)
+        this.defaultGraphQlSubs = ['ig_sub_direct', 'ig_sub_direct_v2_message_sync'];
+        this.defaultSkywalkerSubs = ['presence_subscribe', 'typing_subscribe'];
+
         // internal flags & timers
         this._attachedAuthState = null;
         this._messageSyncAttached = false;
@@ -314,6 +327,7 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
      * - Pulls deviceId, sessionid, device secrets and app-specific headers to populate the payload.
      */
     constructConnection() {
+        // Choose the best available user agent value from state fallbacks
         const userAgent =
             typeof this.ig.state.userAgent === 'string'
                 ? this.ig.state.userAgent
@@ -323,8 +337,10 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
                         ? this.ig.state.deviceString
                         : 'Instagram 155.0.0.37.107 Android';
 
+        // deviceId / phoneId fallback handling (string coercion)
         const deviceId = String(this.ig.state.phoneId || this.ig.state.deviceId || 'device_unknown');
 
+        // attempt to extract sessionid from various locations: Authorization JWT, cookie helpers, state fields, or cookie jar
         let sessionid = null;
         try {
             sessionid = this.extractSessionIdFromJWT();
@@ -354,12 +370,14 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
             } catch (e) {}
         }
 
+        // fallback sessionid generation — only used if nothing else found
         if (!sessionid) {
             const userId = this.ig.state.cookieUserId || this.ig.state.userId || '0';
             sessionid = String(userId) + '_' + Date.now();
             this.realtimeDebug(`SessionID generated (fallback): ${sessionid}`);
         }
 
+        // device secret retrieval (from attached auth helper or state)
         let deviceSecret = null;
         try {
             if (this._attachedAuthState && typeof this._attachedAuthState.getData === 'function') {
@@ -388,6 +406,7 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
             if (!mqttJwt && this.ig.state.mqttJwt) mqttJwt = this.ig.state.mqttJwt;
         } catch (e) {}
 
+        // password is either "jwt=..." or "sessionid=..."
         let password;
         if (mqttJwt) {
             password = `jwt=${mqttJwt}`;
@@ -395,9 +414,10 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
             password = `sessionid=${sessionid}`;
         }
 
+        // client type indicates if device secret is available
         const clientType = deviceSecret ? 'secure_cookie_auth' : 'cookie_auth';
 
-        // IMPORTANT: keep clientMqttSessionId persistent across reconnects
+        // IMPORTANT: keep clientMqttSessionId persistent across reconnects (already set in constructor)
         if (!this._clientMqttSessionId) {
             try {
                 this._clientMqttSessionId = (BigInt(Date.now()) & BigInt(0xffffffff));
@@ -405,19 +425,21 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
                 this._clientMqttSessionId = BigInt(0);
             }
         }
-
         const clientMqttSessionId = this._clientMqttSessionId;
 
+        // numeric topics Instagram uses for subscription mapping (kept consistent)
         const subscribeTopics = [88, 135, 149, 150, 133, 146];
 
         // Build the thrift connection object using mqttot.MQTToTConnection
+        // NOTE: use deviceId.substring(0,20) for clientIdentifier because the mobile app often truncates it.
+        //       endpointCapabilities set to 128 for broader compatibility (some clients use 0, 128 provides better capability advertising).
         this.connection = new mqttot_1.MQTToTConnection({
             clientIdentifier: deviceId.substring(0, 20),
             clientInfo: {
                 userId: BigInt(Number(this.ig.state.cookieUserId || this.ig.state.userId || 0)),
                 userAgent,
                 clientCapabilities: 183,
-                endpointCapabilities: 0,
+                endpointCapabilities: 128,
                 publishFormat: 1,
                 noAutomaticForeground: false,
                 makeUserAvailableInForeground: true,
@@ -444,8 +466,13 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
                     video_call_participant_state_delivery: '17977239895057311',
                     presence_subscribe: '17846944882223835',
                 }),
+                // Extra app-specific fields observed in the mobile APK (helps the server identify the client capabilities)
                 'User-Agent': userAgent,
                 'Accept-Language': (this.ig.state.language || 'en_US').replace('_', '-'),
+                platform: 'android',
+                ig_mqtt_route: 'django',
+                pubsub_msg_type_blacklist: 'direct, typing_type',
+                auth_cache_enabled: '0',
             },
         });
     }
@@ -557,7 +584,7 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
                 this._syncTimer = setInterval(async () => {
                     try {
                         if (!this.commands) return;
-                        const subs = (this.initOptions && this.initOptions.graphQlSubs && this.initOptions.graphQlSubs.length) ? this.initOptions.graphQlSubs : ['ig_sub_direct', 'ig_sub_direct_v2_message_sync'];
+                        const subs = (this.initOptions && this.initOptions.graphQlSubs && this.initOptions.graphQlSubs.length) ? this.initOptions.graphQlSubs : this.defaultGraphQlSubs;
                         await this.graphQlSubscribe(subs);
                         this.realtimeDebug('[WATCHDOG] MESSAGE_SYNC refreshed.');
                     } catch (e) {
@@ -620,6 +647,9 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
         await (0, shared_1.delay)(100);
         if (this.initOptions.graphQlSubs && this.initOptions.graphQlSubs.length > 0) {
             await this.graphQlSubscribe(this.initOptions.graphQlSubs);
+        } else {
+            // ensure defaults if none provided
+            await this.graphQlSubscribe(this.defaultGraphQlSubs);
         }
         if (this.initOptions.irisData) {
             await this.irisSubscribe(this.initOptions.irisData);
@@ -637,6 +667,9 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
         }
         if ((this.initOptions.skywalkerSubs ?? []).length > 0) {
             await this.skywalkerSubscribe(this.initOptions.skywalkerSubs);
+        } else {
+            // ensure default skywalker subs if none provided
+            await this.skywalkerSubscribe(this.defaultSkywalkerSubs);
         }
         await (0, shared_1.delay)(100);
         try {
@@ -790,8 +823,8 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
         }
 
         const connectOptions = {
-            graphQlSubs: options.graphQlSubs || savedOptions.graphQlSubs || ['ig_sub_direct', 'ig_sub_direct_v2_message_sync'],
-            skywalkerSubs: options.skywalkerSubs || savedOptions.skywalkerSubs || ['presence_subscribe', 'typing_subscribe'],
+            graphQlSubs: options.graphQlSubs || savedOptions.graphQlSubs || this.defaultGraphQlSubs,
+            skywalkerSubs: options.skywalkerSubs || savedOptions.skywalkerSubs || this.defaultSkywalkerSubs,
             irisData,
             ...options
         };
@@ -872,6 +905,8 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
         if (!this.commands) {
             throw new mqtts_1.IllegalStateError('connect() must be called before graphQlSubscribe()');
         }
+        // If the caller provided an empty array, ensure defaults are used
+        if (Array.isArray(sub) && sub.length === 0) sub = this.defaultGraphQlSubs;
         this.realtimeDebug(`Subscribing with GraphQL to ${sub.join(', ')}`);
         return this.commands.updateSubscriptions({
             topic: constants_1.Topics.REALTIME_SUB,
@@ -890,6 +925,8 @@ class RealtimeClient extends eventemitter3_1.EventEmitter {
         if (!this.commands) {
             throw new mqtts_1.IllegalStateError('connect() must be called before skywalkerSubscribe()');
         }
+        // If empty, use defaults
+        if (Array.isArray(sub) && sub.length === 0) sub = this.defaultSkywalkerSubs;
         this.realtimeDebug(`Subscribing with Skywalker to ${sub.join(', ')}`);
         return this.commands.updateSubscriptions({
             topic: constants_1.Topics.PUBSUB,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodejs-insta-private-api-mqtt",
-  "version": "1.3.29",
+  "version": "1.3.30",
   "description": "Complete Instagram MQTT protocol with FULL iOS + Android support. 33 device presets (21 iOS + 12 Android). iPhone 16/15/14/13/12, iPad Pro, Samsung, Pixel, Huawei. Real-time DM messaging, view-once media extraction, sub-500ms latency.",
   "main": "dist/index.js",
   "scripts": {