nodejs-insta-private-api-mqtt 1.3.40 → 1.3.42

package/README.md

@@ -870,3 +870,164 @@ MIT
 For issues, bugs, or feature requests: https://github.com/Kunboruto20/nodejs-insta-private-api/issues
 
 Documentation: https://github.com/Kunboruto20/nodejs-insta-private-api
+
+
+---
+## Enhanced Location Usage — Practical Examples (English)
+
+The `EnhancedDirectCommands` class (see `enhanced.direct.commands.js`) implements robust location sending for Instagram Direct by trying **story-with-location-sticker → share story to thread → fallback to link**. Below are ready-to-copy examples showing how to use the location-related methods and payloads exposed by the class.
+
+> These examples assume:
+> - `realtime` is an instance of `RealtimeClient`.
+> - `realtime.directCommands` is an instance of `EnhancedDirectCommands`.
+> - You have a valid `threadId` (target DM thread).
+> - `realtime.ig` exists when examples require publishing a story via the private IG client.
+
+### 1) Send a location when you already have a `venue` object (recommended)
+
+```javascript
+// venue shape expected by sendLocation:
+// { id, name, address, lat, lng, facebook_places_id, external_source }
+const venue = {
+  id: "213385402",
+  name: "McDonald's Unirii",
+  address: "Piața Unirii, Bucharest",
+  lat: 44.4268,
+  lng: 26.1025,
+  facebook_places_id: "213385402",
+  external_source: "facebook_places"
+};
+
+await realtime.directCommands.sendLocation({
+  threadId: "340282366841710300949128114477782749726",
+  venue,
+  text: "Meet me here at 18:00"
+});
+```
+
+**What happens:**  
+1. The method attempts to publish a Story with a location sticker using `realtime.ig.publish.story`.  
+2. If the Story publish succeeds and a `storyId` is returned, `sendUserStory` (reel_share) is used to share the story to the thread.  
+3. If either step fails, the method falls back to sending a link to `https://www.instagram.com/explore/locations/{placeId}/` via `itemType: 'link'`.
+
+---
+
+### 2) Search for a place (instagram private search) and send it
+
+Use `searchAndSendLocation()` when you only have a search query or coordinates:
+
+```javascript
+await realtime.directCommands.searchAndSendLocation({
+  threadId: "340282366841710300949128114477782749726",
+  query: "Starbucks Piata Unirii",
+  lat: 44.4268,
+  lng: 26.1025
+});
+```
+
+This helper calls Instagram's `/fbsearch/places/` private endpoint (via `realtime.ig.request`) and then normalizes the first result into the `venue` shape before calling `sendLocation()`.
+
+---
+
+### 3) Build a location sticker manually & publish story (advanced)
+
+If you want direct control over the sticker object or to publish your own image, you can use `createLocationStickerFromVenue()` and `realtime.ig.publish.story()` directly:
+
+```javascript
+const venue = {
+  id: "213385402",
+  name: "McDonald's Unirii",
+  address: "Piața Unirii, Bucharest",
+  lat: 44.4268,
+  lng: 26.1025,
+  facebook_places_id: "213385402"
+};
+
+// create sticker compatible with publish.story helpers
+const sticker = realtime.directCommands.createLocationStickerFromVenue(venue);
+
+// create a tiny placeholder image (1x1 PNG) or your real photo buffer
+const SINGLE_PIXEL_PNG_BASE64 = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR4nGNgYAAAAAMAAWgmWQ0AAAAASUVORK5CYII=";
+const photoBuffer = Buffer.from(SINGLE_PIXEL_PNG_BASE64, 'base64');
+
+// publish story with the sticker (if realtime.ig.publish.story exists)
+const publishResult = await realtime.ig.publish.story({
+  file: photoBuffer,
+  stickers: [sticker]
+});
+
+// try to resolve returned story id and then share it
+const storyId = publishResult?.media?.pk || publishResult?.item_id || publishResult?.upload_id;
+if (storyId) {
+  await realtime.directCommands.sendUserStory({
+    threadId: "340282366841710300949128114477782749726",
+    storyId,
+    text: "Location for tonight"
+  });
+} else {
+  // fallback: send explore link manually
+  await realtime.directCommands.sendLink({
+    threadId: "340282366841710300949128114477782749726",
+    link: `https://www.instagram.com/explore/locations/${venue.facebook_places_id || venue.id}/`,
+    text: venue.name
+  });
+}
+```
+
+---
+
+### 4) Force sending the explore-location link (explicit fallback)
+
+If you don't want to publish a story and only need the location link in DM:
+
+```javascript
+const placeId = "213385402";
+await realtime.directCommands.sendLink({
+  threadId: "340282366841710300949128114477782749726",
+  link: `https://www.instagram.com/explore/locations/${placeId}/`,
+  text: "Meet here"
+});
+```
+
+---
+
+### 5) Error handling & debug tips
+
+```javascript
+try {
+  await realtime.directCommands.sendLocation({ threadId, venue, text: "See you" });
+  console.log("Location sent!");
+} catch (err) {
+  console.error("Failed to send location:", err);
+  // fallback to explicit link if needed
+  await realtime.directCommands.sendLink({
+    threadId,
+    link: `https://www.instagram.com/explore/locations/${venue.facebook_places_id || venue.id}/`,
+    text: venue.name || "Location"
+  });
+}
+```
+
+If you need verbose logs, enable debug for the realtime/enhanced module:
+
+```bash
+# in your environment (example)
+DEBUG="realtime:enhanced-commands" node your_bot.js
+# or to see broader realtime logs
+DEBUG="realtime:*" node your_bot.js
+```
+
+---
+
+### 6) Quick checklist (what the library needs to make story-with-sticker work)
+
+- `realtime.ig` must exist and expose `publish.story(...)` (a private client publish helper).  
+- The `venue` must include either `facebook_places_id` or `id`.  
+- If `realtime.ig.publish.story` is unavailable or Instagram rejects the sticker, the library **automatically falls back** to sending a DM link to the Explore locations page.
+
+---
+
+## End of Location Examples
+
+These examples are appended to the original README in order to keep the whole original file intact while adding clear, English examples for location flows.
+

package/dist/realtime/commands/enhanced.direct.commands.js

@@ -1,20 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EnhancedDirectCommands = void 0;
+
 const shared_1 = require("../../shared");
 const uuid_1 = require("uuid");
 const constants_1 = require("../../constants");
 const thrift_1 = require("../../thrift");
 
 /**
- * Enhanced Direct Commands - sends MQTT directly with proper payload formatting
- * Fixed to match instagram_mqtt library format for proper functionality
+ * EnhancedDirectCommands
+ *
+ * - Full, self-contained class that publishes correctly-formatted payloads to Instagram's
+ *   Direct MQTT (Thrift + compressed payloads).
+ * - Updated sendLocation implementation:
+ *    1) try publish a story with a Location sticker (preferred, matches APK behavior)
+ *    2) share that story to the thread (reel/media_share)
+ *    3) fallback: send a link to /explore/locations/{placeId}/ if (1) fails
+ *
+ * Note: server-side validation may still reject location stickers in some contexts.
  */
 class EnhancedDirectCommands {
     constructor(client) {
         this.realtimeClient = client;
         this.enhancedDebug = (0, shared_1.debugChannel)('realtime', 'enhanced-commands');
-        
+
         // Foreground state config for Thrift encoding (matching instagram_mqtt)
         this.foregroundStateConfig = [
             thrift_1.ThriftDescriptors.boolean('inForegroundApp', 1),
@@ -29,10 +38,10 @@ class EnhancedDirectCommands {
     }
 
     /**
-     * Get MQTT client from realtime client
+     * Attempt to locate the MQTT client object on the realtime client.
+     * Many wrappers expose mqtt under different property names.
      */
     getMqtt() {
-        // Try several known property names for mqtt client (some libs/wrappers expose differently)
         const candidates = [
             'mqtt',
             '_mqtt',
@@ -43,7 +52,6 @@ class EnhancedDirectCommands {
         ];
         let mqtt = null;
         for (const key of candidates) {
-            // eslint-disable-next-line no-prototype-builtins
             if (this.realtimeClient && Object.prototype.hasOwnProperty.call(this.realtimeClient, key) && this.realtimeClient[key]) {
                 mqtt = this.realtimeClient[key];
                 break;
@@ -67,7 +75,6 @@ class EnhancedDirectCommands {
      * - mqtt.publish(topic, payload, { qos }, cb)
      */
     async publishToMqtt(mqtt, publishObj) {
-        // publishObj: { topic, payload, qosLevel }
         const topic = publishObj.topic;
         const payload = publishObj.payload;
         const qosLevel = typeof publishObj.qosLevel !== 'undefined' ? publishObj.qosLevel : 1;
@@ -132,10 +139,10 @@ class EnhancedDirectCommands {
      */
     async sendForegroundState(state) {
         this.enhancedDebug(`Updated foreground state: ${JSON.stringify(state)}`);
-        
+
         try {
             const mqtt = this.getMqtt();
-            
+
             const thriftBuffer = (0, thrift_1.thriftWriteFromObject)(state, this.foregroundStateConfig);
             const concat = Buffer.concat([
                 Buffer.alloc(1, 0),
@@ -144,18 +151,18 @@ class EnhancedDirectCommands {
 
             // ensure we pass Buffer to compressDeflate
             const payload = await (0, shared_1.compressDeflate)(concat);
-            
+
             const result = await this.publishToMqtt(mqtt, {
                 topic: constants_1.Topics.FOREGROUND_STATE.id,
                 payload: payload,
                 qosLevel: 1,
             });
-            
+
             // Update keepAlive if provided
             if ((0, shared_1.notUndefined)(state.keepAliveTimeout)) {
                 mqtt.keepAlive = state.keepAliveTimeout;
             }
-            
+
             this.enhancedDebug(`✅ Foreground state updated via MQTT!`);
             return result;
         } catch (err) {
@@ -166,15 +173,16 @@ class EnhancedDirectCommands {
 
     /**
      * Base command sender (matching instagram_mqtt format)
+     * It encodes the command as JSON, compresses, and publishes to SEND_MESSAGE topic.
      */
     async sendCommand({ action, data, threadId, clientContext }) {
         try {
             const mqtt = this.getMqtt();
-            
+
             if (clientContext) {
                 data.client_context = clientContext;
             }
-            
+
             const json = JSON.stringify({
                 action,
                 thread_id: threadId,
@@ -183,7 +191,7 @@ class EnhancedDirectCommands {
 
             // ensure Buffer (some compress implementations expect Buffer)
             const payload = await (0, shared_1.compressDeflate)(Buffer.from(json));
-            
+
             return this.publishToMqtt(mqtt, {
                 topic: constants_1.Topics.SEND_MESSAGE.id,
                 qosLevel: 1,
@@ -211,11 +219,11 @@ class EnhancedDirectCommands {
     }
 
     /**
-     * Send text via MQTT (matching instagram_mqtt format)
+     * Send text via MQTT
      */
     async sendText({ text, clientContext, threadId }) {
         this.enhancedDebug(`Sending text to ${threadId}: "${text}"`);
-        
+
         const result = await this.sendItem({
             itemType: 'text',
             threadId,
@@ -224,7 +232,7 @@ class EnhancedDirectCommands {
                 text,
             },
         });
-        
+
         this.enhancedDebug(`✅ Text sent via MQTT!`);
         return result;
     }
@@ -241,11 +249,11 @@ class EnhancedDirectCommands {
     }
 
     /**
-     * Send hashtag via MQTT (matching instagram_mqtt format)
+     * Send hashtag via MQTT
      */
     async sendHashtag({ text, threadId, hashtag, clientContext }) {
         this.enhancedDebug(`Sending hashtag #${hashtag} to ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'hashtag',
             threadId,
@@ -256,55 +264,264 @@ class EnhancedDirectCommands {
                 item_id: hashtag,
             },
         });
-        
+
         this.enhancedDebug(`✅ Hashtag sent via MQTT!`);
         return result;
     }
 
     /**
-     * Send like via MQTT (matching instagram_mqtt format)
+     * Send like via MQTT
      */
     async sendLike({ threadId, clientContext }) {
         this.enhancedDebug(`Sending like in thread ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'like',
             threadId,
             clientContext,
             data: {},
         });
-        
+
         this.enhancedDebug(`✅ Like sent via MQTT!`);
         return result;
     }
 
     /**
-     * Send location via MQTT (matching instagram_mqtt format)
+     * Send location via MQTT (reworked)
+     *
+     * Now:
+     *  - Tries to publish a Story with a Location sticker (preferred; matches APK behavior)
+     *  - Shares that Story to the thread (reel_share / media_share)
+     *  - If any step fails, falls back to sending a link to /explore/locations/{placeId}/
+     *
+     * venue shape expected:
+     *  { id, name, address, lat, lng, facebook_places_id, external_source }
      */
-    async sendLocation({ text, locationId, threadId, clientContext }) {
-        this.enhancedDebug(`Sending location ${locationId} to ${threadId}`);
-        
-        const result = await this.sendItem({
-            itemType: 'location',
-            threadId,
-            clientContext,
-            data: {
-                text: text || '',
-                venue_id: locationId,
-                item_id: locationId,
-            },
-        });
-        
-        this.enhancedDebug(`✅ Location sent via MQTT!`);
-        return result;
+    async sendLocation({ threadId, clientContext, venue, text = '' }) {
+        this.enhancedDebug(`Attempting to send location to ${threadId}. Venue: ${venue ? JSON.stringify(venue) : 'none'}`);
+
+        // Basic validation - need at least an id (or facebook_places_id)
+        const hasCoords = venue && typeof venue.lat === 'number' && typeof venue.lng === 'number';
+        const hasId = venue && (venue.facebook_places_id || venue.id);
+
+        // prefer facebook_places_id if present
+        const placeId = venue && (venue.facebook_places_id || venue.id);
+
+        // create sticker structure (format used by many reverse-engineered clients)
+        const sticker = this.createLocationStickerFromVenue(venue);
+
+        // If we have an ig client capable of publishing stories, attempt the sticker flow.
+        const ig = this.realtimeClient && this.realtimeClient.ig;
+        if (ig && typeof ig.publish === 'object' && typeof ig.publish.story === 'function') {
+            try {
+                // Use a tiny placeholder image if caller didn't provide one (1x1 PNG)
+                const SINGLE_PIXEL_PNG_BASE64 = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR4nGNgYAAAAAMAAWgmWQ0AAAAASUVORK5CYII=";
+                const photoBuffer = Buffer.from(SINGLE_PIXEL_PNG_BASE64, 'base64');
+
+                this.enhancedDebug(`Publishing story with location sticker (venue id: ${placeId})...`);
+
+                // Build publish params. Many clients accept `file` and `stickers` array like this.
+                const publishParams = {
+                    file: photoBuffer,
+                    stickers: [sticker],
+                    // optional: caption/text not always supported on story publish in the same way; keep minimal
+                };
+
+                const publishResult = await ig.publish.story(publishParams);
+
+                this.enhancedDebug(`Story publish result: ${publishResult ? JSON.stringify(publishResult).slice(0, 400) : 'no result'}`);
+
+                // Try to resolve story media id
+                let storyId = null;
+                if (publishResult) {
+                    // common fields returned by private clients
+                    storyId = publishResult.media && (publishResult.media.pk || publishResult.media.id || publishResult.media_id) ||
+                              publishResult.item_id || publishResult.upload_id || publishResult.media_id;
+                }
+
+                // If we didn't get a story id, try common fallback fields
+                if (!storyId && publishResult && publishResult.params && publishResult.params.upload_id) {
+                    storyId = publishResult.params.upload_id;
+                }
+
+                if (!storyId) {
+                    // If publish succeeded but no usable id found, still attempt best-effort: some clients return a "media" object later on pubsub
+                    this.enhancedDebug(`Could not determine story id from publish result; continuing to fallback to link/share attempt.`);
+                    throw new Error('Could not determine story id from publish result.');
+                }
+
+                // Now share the story to the thread (reel_share/media_share)
+                // Use the existing helper sendUserStory if available (it uses itemType: 'reel_share')
+                this.enhancedDebug(`Sharing published story ${storyId} to thread ${threadId}...`);
+                try {
+                    const shareResult = await this.sendUserStory({
+                        text: text || '',
+                        storyId: storyId,
+                        threadId,
+                        clientContext: clientContext || (0, uuid_1.v4)(),
+                    });
+                    this.enhancedDebug(`✅ Location story shared to thread via MQTT! (storyId=${storyId})`);
+                    return shareResult;
+                } catch (shareErr) {
+                    // If sharing via MQTT fails, try a fallback: some clients expose direct send helper
+                    this.enhancedDebug(`Sharing story to thread failed: ${shareErr && shareErr.message ? shareErr.message : String(shareErr)}`);
+                    // fall through to fallback link below
+                    throw shareErr;
+                }
+            } catch (err) {
+                this.enhancedDebug(`Story-with-sticker attempt failed: ${err && err.message ? err.message : String(err)} - falling back to link`);
+                // fallthrough to fallback block below
+            }
+        } else {
+            this.enhancedDebug(`ig.publish.story not available on realtimeClient.ig — will use fallback link if possible.`);
+        }
+
+        // Fallback: send as a link to the location explore page (guaranteed to render in DM)
+        if (hasId) {
+            const link = `https://www.instagram.com/explore/locations/${placeId}/`;
+            this.enhancedDebug(`Sending location fallback link: ${link}`);
+
+            try {
+                const fallback = await this.sendItem({
+                    itemType: 'link',
+                    threadId,
+                    clientContext: clientContext || (0, uuid_1.v4)(),
+                    data: {
+                        link_text: text || (venue && venue.name) || 'Location',
+                        link_urls: [link],
+                    },
+                });
+                this.enhancedDebug(`✅ Location fallback link sent via MQTT!`);
+                return fallback;
+            } catch (err) {
+                this.enhancedDebug(`Fallback link send failed: ${err && err.message ? err.message : String(err)}`);
+                throw err;
+            }
+        }
+
+        // If we don't have any usable info, throw an error
+        throw new Error('sendLocation requires a venue object with at least id (or facebook_places_id).');
     }
 
     /**
-     * Send media via MQTT (matching instagram_mqtt format - media_share)
+     * Helper that returns a "location sticker" object compatible with many reverse-engineered
+     * clients / the publish.story helper. This mirrors the "LocationStickerClientModel" semantics.
+     *
+     * Format produced:
+     * {
+     *   type: 'location',
+     *   location_id: '12345',
+     *   location: { lat, lng, name, address, external_source, facebook_places_id },
+     *   x: 0.5,
+     *   y: 0.5,
+     *   width: 0.7,
+     *   height: 0.15,
+     *   rotation: 0,
+     *   is_pinned: false
+     * }
+     */
+    createLocationStickerFromVenue(venue) {
+        // Defensive defaults
+        if (!venue) {
+            throw new Error('venue required to create location sticker');
+        }
+        const placeId = venue.facebook_places_id || String(venue.id || '');
+        const lat = (typeof venue.lat === 'number') ? venue.lat : (venue.location && venue.location.lat) || null;
+        const lng = (typeof venue.lng === 'number') ? venue.lng : (venue.location && venue.location.lng) || null;
+
+        const locationObj = {
+            lat: lat,
+            lng: lng,
+            name: venue.name || '',
+            address: venue.address || '',
+            external_source: venue.external_source || 'facebook_places',
+            facebook_places_id: placeId || '',
+        };
+
+        // Sticker appearance / position defaults - caller may tweak later if needed
+        const sticker = {
+            type: 'location',
+            // some clients expect locationId, some expect venue_id or location_id
+            locationId: placeId,
+            venue_id: placeId,
+            location: locationObj,
+            x: 0.5,
+            y: 0.5,
+            width: 0.7,
+            height: 0.15,
+            rotation: 0,
+            isPinned: false,
+        };
+
+        return sticker;
+    }
+
+    /**
+     * Helper: search places via the Instagram client (optional).
+     * If your realtimeClient has an .ig.request helper, this will call the appropriate
+     * endpoint to fetch place metadata, and then call sendLocation with the full venue.
+     *
+     * This is optional — you can call sendLocation yourself with the venue object you already have.
+     */
+    async searchAndSendLocation({ threadId, query, lat, lng, clientContext }) {
+        const ig = this.realtimeClient && this.realtimeClient.ig;
+        if (!ig || !ig.request) {
+            throw new Error('Instagram client (ig.request) not available on realtimeClient. Provide `venue` directly to sendLocation instead.');
+        }
+
+        this.enhancedDebug(`Searching location: ${query} at ${lat},${lng}`);
+
+        // Example endpoint - private API endpoints vary. If your client has a helper method,
+        // prefer that. This tries a common private endpoint pattern.
+        const url = '/fbsearch/places/';
+        const params = {
+            search_media_creation: false,
+            rank_token: (0, uuid_1.v4)(),
+            query: query,
+            latitude: lat,
+            longitude: lng,
+        };
+
+        try {
+            const res = await ig.request.send({
+                url: url,
+                method: 'GET',
+                qs: params,
+            });
+
+            // Parse response - different private API clients return different shapes.
+            // We try to find the first usable place with id/lat/lng/name.
+            const places = (res && (res.places || res.items || res.results)) || [];
+            const place = places.find(p => p && (p.pk || p.place || p.location || p.facebook_places_id)) || places[0];
+
+            if (!place) {
+                throw new Error('No places found from search.');
+            }
+
+            // Normalize to `venue` shape our sendLocation expects
+            const venue = {
+                id: String(place.pk || (place.place && place.place.id) || place.id || place.facebook_places_id || ''),
+                name: place.name || (place.place && place.place.name) || '',
+                address: place.address || (place.place && place.place.address) || '',
+                lat: (place.location && (place.location.lat || place.location.latitude)) || place.lat || null,
+                lng: (place.location && (place.location.lng || place.location.longitude)) || place.lng || null,
+                facebook_places_id: place.facebook_places_id || (place.place && place.place.id) || String(place.pk || ''),
+                external_source: place.external_source || 'facebook_places',
+            };
+
+            return await this.sendLocation({ threadId, clientContext, venue });
+        } catch (err) {
+            this.enhancedDebug(`place search/send failed: ${err && err.message ? err.message : String(err)}`);
+            throw err;
+        }
+    }
+
+    /**
+     * Send media via MQTT (media_share)
      */
     async sendMedia({ text, mediaId, threadId, clientContext }) {
         this.enhancedDebug(`Sending media ${mediaId} to ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'media_share',
             threadId,
@@ -314,17 +531,17 @@ class EnhancedDirectCommands {
                 media_id: mediaId,
             },
         });
-        
+
         this.enhancedDebug(`✅ Media sent via MQTT!`);
         return result;
     }
 
     /**
-     * Send profile via MQTT (matching instagram_mqtt format)
+     * Send profile via MQTT
      */
     async sendProfile({ text, userId, threadId, clientContext }) {
         this.enhancedDebug(`Sending profile ${userId} to ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'profile',
             threadId,
@@ -335,17 +552,17 @@ class EnhancedDirectCommands {
                 item_id: userId,
             },
         });
-        
+
         this.enhancedDebug(`✅ Profile sent via MQTT!`);
         return result;
     }
 
     /**
-     * Send reaction via MQTT (matching instagram_mqtt format)
+     * Send reaction via MQTT
      */
     async sendReaction({ itemId, reactionType, clientContext, threadId, reactionStatus, targetItemType, emoji }) {
         this.enhancedDebug(`Sending ${reactionType || 'like'} reaction to message ${itemId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'reaction',
             threadId,
@@ -359,17 +576,17 @@ class EnhancedDirectCommands {
                 emoji: emoji || '',
             },
         });
-        
+
         this.enhancedDebug(`✅ Reaction sent via MQTT!`);
         return result;
     }
 
     /**
-     * Send user story via MQTT (matching instagram_mqtt format - reel_share)
+     * Send user story via MQTT (reel_share)
      */
     async sendUserStory({ text, storyId, threadId, clientContext }) {
         this.enhancedDebug(`Sending story ${storyId} to ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'reel_share',
             threadId,
@@ -380,17 +597,17 @@ class EnhancedDirectCommands {
                 media_id: storyId,
             },
         });
-        
+
         this.enhancedDebug(`✅ Story sent via MQTT!`);
         return result;
     }
 
     /**
-     * Mark as seen via MQTT (matching instagram_mqtt format - mark_seen action)
+     * Mark as seen via MQTT (mark_seen action)
      */
     async markAsSeen({ threadId, itemId }) {
         this.enhancedDebug(`Marking message ${itemId} as seen in thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'mark_seen',
             threadId,
@@ -398,18 +615,18 @@ class EnhancedDirectCommands {
                 item_id: itemId,
             },
         });
-        
+
         this.enhancedDebug(`✅ Message marked as seen via MQTT!`);
         return result;
     }
 
     /**
-     * Indicate activity (typing) via MQTT (matching instagram_mqtt format - activity_status)
+     * Indicate activity (typing) via MQTT (activity_status)
      */
     async indicateActivity({ threadId, isActive, clientContext }) {
         const active = typeof isActive === 'undefined' ? true : isActive;
         this.enhancedDebug(`Indicating ${active ? 'typing' : 'stopped'} in thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'indicate_activity',
             threadId,
@@ -418,7 +635,7 @@ class EnhancedDirectCommands {
                 activity_status: active ? '1' : '0',
             },
         });
-        
+
         this.enhancedDebug(`✅ Activity indicator sent via MQTT!`);
         return result;
     }
@@ -428,7 +645,7 @@ class EnhancedDirectCommands {
      */
     async deleteMessage(threadId, itemId) {
         this.enhancedDebug(`Deleting message ${itemId} from thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'delete_item',
             threadId,
@@ -437,7 +654,7 @@ class EnhancedDirectCommands {
                 item_id: itemId,
             },
         });
-        
+
         this.enhancedDebug(`✅ Message deleted via MQTT!`);
         return result;
     }
@@ -447,7 +664,7 @@ class EnhancedDirectCommands {
      */
     async editMessage(threadId, itemId, newText) {
         this.enhancedDebug(`Editing message ${itemId}: "${newText}"`);
-        
+
         const result = await this.sendCommand({
             action: 'edit_item',
             threadId,
@@ -457,7 +674,7 @@ class EnhancedDirectCommands {
                 text: newText,
             },
         });
-        
+
         this.enhancedDebug(`✅ Message edited via MQTT!`);
         return result;
     }
@@ -467,7 +684,7 @@ class EnhancedDirectCommands {
      */
     async replyToMessage(threadId, messageId, replyText) {
         this.enhancedDebug(`Replying to ${messageId} in thread ${threadId}: "${replyText}"`);
-        
+
         const result = await this.sendItem({
             itemType: 'text',
             threadId,
@@ -477,7 +694,7 @@ class EnhancedDirectCommands {
                 replied_to_item_id: messageId,
             },
         });
-        
+
         this.enhancedDebug(`✅ Reply sent via MQTT!`);
         return result;
     }
@@ -487,7 +704,7 @@ class EnhancedDirectCommands {
      */
     async addMemberToThread(threadId, userId) {
         this.enhancedDebug(`Adding user ${userId} to thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'add_users',
             threadId,
@@ -496,7 +713,7 @@ class EnhancedDirectCommands {
                 user_ids: Array.isArray(userId) ? userId : [userId],
             },
         });
-        
+
         this.enhancedDebug(`✅ Member added to thread via MQTT!`);
         return result;
     }
@@ -506,7 +723,7 @@ class EnhancedDirectCommands {
      */
     async removeMemberFromThread(threadId, userId) {
         this.enhancedDebug(`Removing user ${userId} from thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'remove_users',
             threadId,
@@ -515,7 +732,7 @@ class EnhancedDirectCommands {
                 user_ids: Array.isArray(userId) ? userId : [userId],
             },
         });
-        
+
         this.enhancedDebug(`✅ Member removed from thread via MQTT!`);
         return result;
     }
@@ -525,14 +742,14 @@ class EnhancedDirectCommands {
      */
     async leaveThread(threadId) {
         this.enhancedDebug(`Leaving thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'leave',
             threadId,
             clientContext: (0, uuid_1.v4)(),
             data: {},
         });
-        
+
         this.enhancedDebug(`✅ Left thread via MQTT!`);
         return result;
     }
@@ -542,7 +759,7 @@ class EnhancedDirectCommands {
      */
     async muteThread(threadId, muteUntil = null) {
         this.enhancedDebug(`Muting thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'mute',
             threadId,
@@ -551,7 +768,7 @@ class EnhancedDirectCommands {
                 mute_until: muteUntil,
             },
         });
-        
+
         this.enhancedDebug(`✅ Thread muted via MQTT!`);
         return result;
     }
@@ -561,14 +778,14 @@ class EnhancedDirectCommands {
      */
     async unmuteThread(threadId) {
         this.enhancedDebug(`Unmuting thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'unmute',
             threadId,
             clientContext: (0, uuid_1.v4)(),
             data: {},
         });
-        
+
         this.enhancedDebug(`✅ Thread unmuted via MQTT!`);
         return result;
     }
@@ -578,7 +795,7 @@ class EnhancedDirectCommands {
      */
     async updateThreadTitle(threadId, title) {
         this.enhancedDebug(`Updating thread ${threadId} title to: "${title}"`);
-        
+
         const result = await this.sendCommand({
             action: 'update_title',
             threadId,
@@ -587,7 +804,7 @@ class EnhancedDirectCommands {
                 title: title,
             },
         });
-        
+
         this.enhancedDebug(`✅ Thread title updated via MQTT!`);
         return result;
     }
@@ -597,7 +814,7 @@ class EnhancedDirectCommands {
      */
     async sendLink({ link, text, threadId, clientContext }) {
         this.enhancedDebug(`Sending link ${link} to ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'link',
             threadId,
@@ -608,7 +825,7 @@ class EnhancedDirectCommands {
                 link_urls: [link],
             },
         });
-        
+
         this.enhancedDebug(`✅ Link sent via MQTT!`);
         return result;
     }
@@ -618,7 +835,7 @@ class EnhancedDirectCommands {
      */
     async sendAnimatedMedia({ id, isSticker, threadId, clientContext }) {
         this.enhancedDebug(`Sending animated media ${id} to ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'animated_media',
             threadId,
@@ -628,7 +845,7 @@ class EnhancedDirectCommands {
                 is_sticker: isSticker || false,
             },
         });
-        
+
         this.enhancedDebug(`✅ Animated media sent via MQTT!`);
         return result;
     }
@@ -638,7 +855,7 @@ class EnhancedDirectCommands {
      */
     async sendVoice({ uploadId, waveform, waveformSamplingFrequencyHz, threadId, clientContext }) {
         this.enhancedDebug(`Sending voice ${uploadId} to ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'voice_media',
             threadId,
@@ -649,17 +866,18 @@ class EnhancedDirectCommands {
                 waveform_sampling_frequency_hz: waveformSamplingFrequencyHz || 10,
             },
         });
-        
+
         this.enhancedDebug(`✅ Voice sent via MQTT!`);
         return result;
     }
 
     /**
      * Send photo via Realtime (Upload + Broadcast)
+     * Note: depends on realtimeClient.ig.request for uploading
      */
     async sendPhotoViaRealtime({ photoBuffer, threadId, caption = '', mimeType = 'image/jpeg', clientContext }) {
         this.enhancedDebug(`Sending photo to thread ${threadId} via Realtime`);
-        
+
         try {
             if (!photoBuffer || !Buffer.isBuffer(photoBuffer) || photoBuffer.length === 0) {
                 throw new Error('photoBuffer must be a non-empty Buffer');
@@ -674,10 +892,10 @@ class EnhancedDirectCommands {
             }
 
             this.enhancedDebug(`Step 1: Uploading photo (${photoBuffer.length} bytes)...`);
-            
+
             const uploadId = Date.now().toString();
             const objectName = `${(0, uuid_1.v4)()}.${mimeType === 'image/png' ? 'png' : 'jpg'}`;
-            
+
             const isJpeg = mimeType === 'image/jpeg' || mimeType === 'image/jpg';
             const compression = isJpeg
                 ? '{"lib_name":"moz","lib_version":"3.1.m","quality":"80"}'
@@ -721,7 +939,7 @@ class EnhancedDirectCommands {
             }
 
             this.enhancedDebug(`Step 2: Broadcasting photo to thread ${threadId}...`);
-            
+
             const broadcastForm = {
                 upload_id: serverUploadId,
                 action: 'send_item',
@@ -761,10 +979,11 @@ class EnhancedDirectCommands {
 
     /**
      * Send video via Realtime (Upload + Broadcast)
+     * Note: depends on realtimeClient.ig.request for uploading
      */
     async sendVideoViaRealtime({ videoBuffer, threadId, caption = '', duration = 0, width = 720, height = 1280, clientContext }) {
         this.enhancedDebug(`Sending video to thread ${threadId} via Realtime`);
-        
+
         try {
             if (!videoBuffer || !Buffer.isBuffer(videoBuffer) || videoBuffer.length === 0) {
                 throw new Error('videoBuffer must be a non-empty Buffer');
@@ -779,10 +998,10 @@ class EnhancedDirectCommands {
             }
 
             this.enhancedDebug(`Step 1: Uploading video (${videoBuffer.length} bytes)...`);
-            
+
             const uploadId = Date.now().toString();
             const objectName = `${(0, uuid_1.v4)()}.mp4`;
-            
+
             const ruploadParams = {
                 upload_id: uploadId,
                 media_type: 2,
@@ -823,7 +1042,7 @@ class EnhancedDirectCommands {
             }
 
             this.enhancedDebug(`Step 2: Broadcasting video to thread ${threadId}...`);
-            
+
             const broadcastForm = {
                 upload_id: serverUploadId,
                 action: 'send_item',
@@ -867,14 +1086,14 @@ class EnhancedDirectCommands {
      */
     async approveThread(threadId) {
         this.enhancedDebug(`Approving thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'approve',
             threadId,
             clientContext: (0, uuid_1.v4)(),
             data: {},
         });
-        
+
         this.enhancedDebug(`✅ Thread approved via MQTT!`);
         return result;
     }
@@ -884,14 +1103,14 @@ class EnhancedDirectCommands {
      */
     async declineThread(threadId) {
         this.enhancedDebug(`Declining thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'decline',
             threadId,
             clientContext: (0, uuid_1.v4)(),
             data: {},
         });
-        
+
         this.enhancedDebug(`✅ Thread declined via MQTT!`);
         return result;
     }
@@ -901,7 +1120,7 @@ class EnhancedDirectCommands {
      */
     async blockUserInThread(threadId, userId) {
         this.enhancedDebug(`Blocking user ${userId} in thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'block',
             threadId,
@@ -910,7 +1129,7 @@ class EnhancedDirectCommands {
                 user_id: userId,
             },
         });
-        
+
         this.enhancedDebug(`✅ User blocked in thread via MQTT!`);
         return result;
     }
@@ -920,7 +1139,7 @@ class EnhancedDirectCommands {
      */
     async reportThread(threadId, reason) {
         this.enhancedDebug(`Reporting thread ${threadId}`);
-        
+
         const result = await this.sendCommand({
             action: 'report',
             threadId,
@@ -929,7 +1148,7 @@ class EnhancedDirectCommands {
                 reason: reason || 'spam',
             },
         });
-        
+
         this.enhancedDebug(`✅ Thread reported via MQTT!`);
         return result;
     }
@@ -939,7 +1158,7 @@ class EnhancedDirectCommands {
      */
     async removeReaction({ itemId, threadId, clientContext }) {
         this.enhancedDebug(`Removing reaction from message ${itemId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'reaction',
             threadId,
@@ -951,7 +1170,7 @@ class EnhancedDirectCommands {
                 reaction_status: 'deleted',
             },
         });
-        
+
         this.enhancedDebug(`✅ Reaction removed via MQTT!`);
         return result;
     }
@@ -961,7 +1180,7 @@ class EnhancedDirectCommands {
      */
     async sendDisappearingPhoto({ uploadId, threadId, viewMode = 'once', clientContext }) {
         this.enhancedDebug(`Sending disappearing photo to ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'expiring_media_message',
             threadId,
@@ -972,7 +1191,7 @@ class EnhancedDirectCommands {
                 allow_replay: viewMode === 'replayable',
             },
         });
-        
+
         this.enhancedDebug(`✅ Disappearing photo sent via MQTT!`);
         return result;
     }
@@ -982,7 +1201,7 @@ class EnhancedDirectCommands {
      */
     async sendDisappearingVideo({ uploadId, threadId, viewMode = 'once', clientContext }) {
         this.enhancedDebug(`Sending disappearing video to ${threadId}`);
-        
+
         const result = await this.sendItem({
             itemType: 'expiring_media_message',
             threadId,
@@ -994,7 +1213,7 @@ class EnhancedDirectCommands {
                 media_type: 2,
             },
         });
-        
+
         this.enhancedDebug(`✅ Disappearing video sent via MQTT!`);
         return result;
     }
@@ -1004,7 +1223,7 @@ class EnhancedDirectCommands {
      */
     async markVisualMessageSeen({ threadId, itemId, clientContext }) {
         this.enhancedDebug(`Marking visual message ${itemId} as seen`);
-        
+
         const result = await this.sendCommand({
             action: 'mark_visual_item_seen',
             threadId,
@@ -1013,7 +1232,7 @@ class EnhancedDirectCommands {
                 item_id: itemId,
             },
         });
-        
+
         this.enhancedDebug(`✅ Visual message marked as seen via MQTT!`);
         return result;
     }
@@ -1023,7 +1242,7 @@ class EnhancedDirectCommands {
      */
     async sendScreenshotNotification({ threadId, itemId, clientContext }) {
         this.enhancedDebug(`Sending screenshot notification for ${itemId}`);
-        
+
         const result = await this.sendCommand({
             action: 'screenshot_notification',
             threadId,
@@ -1032,7 +1251,7 @@ class EnhancedDirectCommands {
                 item_id: itemId,
             },
         });
-        
+
         this.enhancedDebug(`✅ Screenshot notification sent via MQTT!`);
         return result;
     }
@@ -1042,7 +1261,7 @@ class EnhancedDirectCommands {
      */
     async sendReplayNotification({ threadId, itemId, clientContext }) {
         this.enhancedDebug(`Sending replay notification for ${itemId}`);
-        
+
         const result = await this.sendCommand({
             action: 'replay_notification',
             threadId,
@@ -1051,9 +1270,10 @@ class EnhancedDirectCommands {
                 item_id: itemId,
             },
         });
-        
+
         this.enhancedDebug(`✅ Replay notification sent via MQTT!`);
         return result;
     }
 }
-exports.EnhancedDirectCommands = EnhancedDirectCommands;
+
+exports.EnhancedDirectCommands = EnhancedDirectCommands;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodejs-insta-private-api-mqtt",
-  "version": "1.3.40",
+  "version": "1.3.42",
   "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": {