nodejs-insta-private-api-mqt 1.3.85 → 1.3.86

package/{src-ts/dist/realtime/features/session-health-monitor.ts → dist/dist/realtime/features/session-health-monitor.js}

@@ -1,11 +1,8 @@
 'use strict';
-
 const EventEmitter = require('eventemitter3');
-
 const SESSION_CHECK_INTERVAL = 30 * 60 * 1000;
 const SESSION_CHECK_JITTER = 5 * 60 * 1000;
 const MIN_CHECK_INTERVAL = 5 * 60 * 1000;
-
 class SessionHealthMonitor extends EventEmitter {
     constructor(realtimeClient, options = {}) {
         super();
@@ -20,7 +17,6 @@ class SessionHealthMonitor extends EventEmitter {
             maxConsecutiveFailures: options.maxConsecutiveFailures || 5,
             ...options,
         };
-
         this._checkTimer = null;
         this._running = false;
         this._consecutiveFailures = 0;
@@ -29,7 +25,6 @@ class SessionHealthMonitor extends EventEmitter {
         this._sessionValid = true;
         this._reloginInProgress = false;
         this._reloginCount = 0;
-
         this._stats = {
             startedAt: null,
             totalChecks: 0,
@@ -46,18 +41,16 @@ class SessionHealthMonitor extends EventEmitter {
             uptimeSegments: [],
         };
     }
-
     start() {
-        if (this._running) return;
+        if (this._running)
+            return;
         this._running = true;
         this._stats.startedAt = Date.now();
         this._stats.lastUptimeStart = Date.now();
         this._log('[HEALTH] Session health monitor started');
         this._log(`[HEALTH] Check interval: ${Math.round(this.options.checkIntervalMs / 60000)}min + up to ${Math.round(this.options.jitterMs / 60000)}min jitter`);
         this._log(`[HEALTH] Auto-relogin: ${this.options.autoRelogin ? 'enabled' : 'disabled'}`);
-
         this._scheduleNextCheck();
-
         if (this.rt) {
             this.rt.on('reconnected', () => {
                 this._stats.reconnects++;
@@ -65,18 +58,15 @@ class SessionHealthMonitor extends EventEmitter {
                 this._stats.lastUptimeStart = Date.now();
                 this._log('[HEALTH] Reconnected - uptime segment recorded');
             });
-
             this.rt.on('disconnect', () => {
                 this._recordUptimeSegment();
             });
-
             this.rt.on('reconnect_failed', () => {
                 this._log('[HEALTH] All reconnect attempts exhausted - checking session validity');
-                this._performCheck().catch(() => {});
+                this._performCheck().catch(() => { });
             });
         }
     }
-
     stop() {
         this._running = false;
         if (this._checkTimer) {
@@ -86,32 +76,29 @@ class SessionHealthMonitor extends EventEmitter {
         this._recordUptimeSegment();
         this._log('[HEALTH] Session health monitor stopped');
     }
-
     _scheduleNextCheck() {
-        if (!this._running) return;
-        if (this._checkTimer) clearTimeout(this._checkTimer);
-
+        if (!this._running)
+            return;
+        if (this._checkTimer)
+            clearTimeout(this._checkTimer);
         const jitter = Math.floor(Math.random() * this.options.jitterMs);
         const delay = Math.max(MIN_CHECK_INTERVAL, this.options.checkIntervalMs + jitter);
-
         this._checkTimer = setTimeout(async () => {
             try {
                 await this._performCheck();
-            } catch (e) {
+            }
+            catch (e) {
                 this._log('[HEALTH] Check error:', e?.message || e);
             }
             this._scheduleNextCheck();
         }, delay);
     }
-
     async _performCheck() {
         this._stats.totalChecks++;
         this._lastCheckAt = Date.now();
-
         try {
             const result = await this._checkSessionValidity();
             this._lastCheckResult = result;
-
             if (result.valid) {
                 this._consecutiveFailures = 0;
                 this._sessionValid = true;
@@ -119,32 +106,35 @@ class SessionHealthMonitor extends EventEmitter {
                 this._log(`[HEALTH] Session valid (userId: ${result.userId || 'unknown'}, check #${this._stats.totalChecks})`);
                 this.emit('health_check', { status: 'ok', result, stats: this.getStats() });
                 return true;
-            } else {
+            }
+            else {
                 this._consecutiveFailures++;
                 this._stats.failedChecks++;
                 this._log(`[HEALTH] Session check failed (${this._consecutiveFailures}/${this.options.maxConsecutiveFailures}): ${result.reason}`);
                 this.emit('health_check', { status: 'failed', result, consecutiveFailures: this._consecutiveFailures });
-
                 if (this._consecutiveFailures >= 2) {
                     this._sessionValid = false;
                     this._stats.sessionExpiries++;
                     this._log('[HEALTH] Session appears expired');
                     this.emit('session_expired', { result, consecutiveFailures: this._consecutiveFailures });
-
                     if (this.options.autoRelogin) {
                         return await this._attemptRelogin();
-                    } else if (typeof this.options.onSessionExpired === 'function') {
-                        try { await this.options.onSessionExpired(result); } catch (e) {}
+                    }
+                    else if (typeof this.options.onSessionExpired === 'function') {
+                        try {
+                            await this.options.onSessionExpired(result);
+                        }
+                        catch (e) { }
                     }
                 }
                 return false;
             }
-        } catch (e) {
+        }
+        catch (e) {
             this._consecutiveFailures++;
             this._stats.failedChecks++;
             this._log('[HEALTH] Session check threw:', e?.message || e);
             this.emit('health_check', { status: 'error', error: e?.message, consecutiveFailures: this._consecutiveFailures });
-
             if (this._consecutiveFailures >= this.options.maxConsecutiveFailures) {
                 this._log(`[HEALTH] Max consecutive failures (${this.options.maxConsecutiveFailures}) reached`);
                 if (this.options.autoRelogin) {
@@ -154,7 +144,6 @@ class SessionHealthMonitor extends EventEmitter {
             return false;
         }
     }
-
     async _checkSessionValidity() {
         try {
             const response = await this.ig.request.send({
@@ -162,7 +151,6 @@ class SessionHealthMonitor extends EventEmitter {
                 method: 'GET',
                 qs: { edit: true },
             });
-
             if (response?.body?.user) {
                 return {
                     valid: true,
@@ -171,12 +159,11 @@ class SessionHealthMonitor extends EventEmitter {
                     fullName: response.body.user.full_name,
                 };
             }
-
             return { valid: false, reason: 'No user data in response', statusCode: response?.statusCode };
-        } catch (e) {
+        }
+        catch (e) {
             const status = e?.response?.statusCode || e?.statusCode;
             const body = e?.response?.body;
-
             if (status === 401 || status === 403) {
                 return { valid: false, reason: `Auth error (${status})`, statusCode: status, requiresRelogin: true };
             }
@@ -189,11 +176,9 @@ class SessionHealthMonitor extends EventEmitter {
             if (e.code === 'ENOTFOUND' || e.code === 'ECONNREFUSED' || e.code === 'ETIMEDOUT') {
                 return { valid: false, reason: `Network error: ${e.code}`, networkError: true };
             }
-
             return { valid: false, reason: e?.message || 'Unknown error', statusCode: status };
         }
     }
-
     async _attemptRelogin() {
         if (this._reloginInProgress) {
             this._log('[HEALTH] Relogin already in progress, skipping');
@@ -201,7 +186,6 @@ class SessionHealthMonitor extends EventEmitter {
         }
         this._reloginInProgress = true;
         this._stats.relogins++;
-
         try {
             const creds = this.options.credentials;
             if (!creds || !creds.username || !creds.password) {
@@ -209,10 +193,8 @@ class SessionHealthMonitor extends EventEmitter {
                 this.emit('relogin_needed', { reason: 'No credentials configured' });
                 return false;
             }
-
             this._log(`[HEALTH] Attempting auto-relogin as ${creds.username}...`);
             this.emit('relogin_start', { username: creds.username });
-
             try {
                 await this.ig.login({ username: creds.username, password: creds.password });
                 this._log('[HEALTH] Relogin successful!');
@@ -220,58 +202,52 @@ class SessionHealthMonitor extends EventEmitter {
                 this._reloginCount++;
                 this._consecutiveFailures = 0;
                 this._sessionValid = true;
-
                 if (this.rt._attachedAuthState && typeof this.rt._attachedAuthState.saveCreds === 'function') {
                     try {
                         await this.rt._attachedAuthState.saveCreds(this.ig);
                         this._log('[HEALTH] Credentials saved after relogin');
-                    } catch (e) {
+                    }
+                    catch (e) {
                         this._log('[HEALTH] Failed to save credentials:', e?.message || e);
                     }
                 }
-
                 this.emit('relogin_success', { username: creds.username, reloginCount: this._reloginCount });
-
                 try {
                     this._log('[HEALTH] Triggering MQTT reconnect with fresh session...');
                     await this.rt._attemptReconnectSafely();
-                } catch (e) {
+                }
+                catch (e) {
                     this._log('[HEALTH] MQTT reconnect after relogin failed:', e?.message || e);
                 }
-
                 return true;
-            } catch (e) {
+            }
+            catch (e) {
                 this._stats.failedRelogins++;
                 const isChallenge = e?.message?.includes('challenge') || e?.message?.includes('checkpoint');
                 this._log(`[HEALTH] Relogin failed: ${e?.message || e}`);
-
                 if (isChallenge) {
                     this._log('[HEALTH] Account requires verification - cannot auto-relogin');
                     this.emit('relogin_challenge', { error: e?.message });
                 }
-
                 this.emit('relogin_failed', { error: e?.message, isChallenge });
                 return false;
             }
-        } finally {
+        }
+        finally {
             this._reloginInProgress = false;
         }
     }
-
     async forceCheck() {
         return this._performCheck();
     }
-
     isSessionValid() {
         return this._sessionValid;
     }
-
     getStats() {
         const now = Date.now();
         const currentSegmentMs = this._stats.lastUptimeStart ? (now - this._stats.lastUptimeStart) : 0;
         const totalUptime = this._stats.totalUptimeMs + currentSegmentMs;
         const totalRuntime = this._stats.startedAt ? (now - this._stats.startedAt) : 0;
-
         return {
             running: this._running,
             sessionValid: this._sessionValid,
@@ -298,12 +274,12 @@ class SessionHealthMonitor extends EventEmitter {
             lastCheckResult: this._lastCheckResult,
         };
     }
-
     _recordUptimeSegment() {
         if (this._stats.lastUptimeStart) {
             const segmentMs = Date.now() - this._stats.lastUptimeStart;
             this._stats.totalUptimeMs += segmentMs;
-            if (segmentMs > this._stats.longestUptimeMs) this._stats.longestUptimeMs = segmentMs;
+            if (segmentMs > this._stats.longestUptimeMs)
+                this._stats.longestUptimeMs = segmentMs;
             this._stats.uptimeSegments.push({
                 start: new Date(this._stats.lastUptimeStart).toISOString(),
                 end: new Date().toISOString(),
@@ -315,31 +291,35 @@ class SessionHealthMonitor extends EventEmitter {
             this._stats.lastUptimeStart = null;
         }
     }
-
     _humanDuration(ms) {
-        if (!ms || ms <= 0) return '0s';
+        if (!ms || ms <= 0)
+            return '0s';
         const d = Math.floor(ms / 86400000);
         const h = Math.floor((ms % 86400000) / 3600000);
         const m = Math.floor((ms % 3600000) / 60000);
         const s = Math.floor((ms % 60000) / 1000);
         const parts = [];
-        if (d > 0) parts.push(`${d}d`);
-        if (h > 0) parts.push(`${h}h`);
-        if (m > 0) parts.push(`${m}m`);
-        if (s > 0 || parts.length === 0) parts.push(`${s}s`);
+        if (d > 0)
+            parts.push(`${d}d`);
+        if (h > 0)
+            parts.push(`${h}h`);
+        if (m > 0)
+            parts.push(`${m}m`);
+        if (s > 0 || parts.length === 0)
+            parts.push(`${s}s`);
         return parts.join(' ');
     }
-
     _log(...args) {
         if (this.rt && typeof this.rt.realtimeDebug === 'function') {
             this.rt.realtimeDebug(...args);
-        } else {
+        }
+        else {
             console.log(...args);
         }
         try {
             this.emit('log', args.join(' '));
-        } catch (e) {}
+        }
+        catch (e) { }
     }
 }
-
 module.exports = { SessionHealthMonitor };

package/dist/dist/realtime/index.d.ts

@@ -0,0 +1,9 @@
+declare const realtime_client_1: any;
+declare const iris_handshake_1: any;
+declare const skywalker_protocol_1: any;
+declare const presence_manager_1: any;
+declare const dm_sender_1: any;
+declare const error_handler_1: any;
+declare const gap_handler_1: any;
+declare const presence_typing_mixin_1: any;
+declare const enhanced_direct_commands_1: any;

package/dist/dist/realtime/messages/index.d.ts

@@ -0,0 +1,2 @@
+declare var __createBinding: any;
+declare var __exportStar: any;

package/dist/dist/realtime/messages/message-sync.message.d.ts

@@ -0,0 +1 @@
+declare var MessageSyncMessageTypes: any;

package/dist/dist/realtime/mixins/index.d.ts

@@ -0,0 +1,2 @@
+declare var __createBinding: any;
+declare var __exportStar: any;

package/dist/dist/realtime/mixins/message-sync.mixin.d.ts

@@ -0,0 +1,38 @@
+declare const mixin_1: any;
+declare const constants_1: any;
+declare const shared_1: any;
+declare const mqtts_1: any;
+/**
+ * MessageSyncMixin - patched for 2026 (robust parsing + safe username fetch + tolerant timestamp handling)
+ *
+ * Changes applied:
+ * - tolerant parsing for e.value (string / object / already-parsed)
+ * - support for several path shapes when extracting thread id
+ * - safer timestamp parsing (accepts seconds, milliseconds, microseconds, nanoseconds)
+ * - username fetch uses a pending map + small backoff to reduce rush/rate-limit risk
+ * - defensive try/catch around JSON.parse and all external calls
+ * - keeps original API: apply(client) registers post-connect hook and emits same events
+ *
+ * Additional change requested:
+ * - set message status to 'received' for incoming messages and 'sent' for messages authored by the logged-in account,
+ *   instead of the previous 'good'.
+ *
+ * Note: No rate-limiting code is included.
+ */
+declare class MessageSyncMixin extends mixin_1.Mixin {
+    constructor();
+    apply(client: any): void;
+    getUsernameFromId(client: any, userId: any): Promise<any>;
+    extractMessageContent(msgValue: any, itemType: any): string;
+    formatMessageForConsole(msgData: any): string;
+    /**
+     * parseTimestamp
+     * - accepts numeric strings or numbers in seconds, milliseconds, microseconds, nanoseconds
+     * - normalizes to milliseconds
+     * - sanity-checks to avoid absurd future dates; returns Date.now() fallback if out of range
+     */
+    parseTimestamp(ts: any): number;
+    handleMessageSync(client: any, syncData: any): Promise<void>;
+    static getThreadIdFromPath(path: any): any;
+    get name(): string;
+}

package/{dist-ts → dist}/dist/realtime/mixins/message-sync.mixin.js

@@ -56,7 +56,7 @@ class MessageSyncMixin extends mixin_1.Mixin {
                             }
                             catch (err) {
                                 // If transformer fails, return empty array so handler is tolerant
-                                console.warn('[MESSAGE_SYNC] transformer parse failed:', (err === null || err === void 0 ? void 0 : err.message) || err);
+                                console.warn('[MESSAGE_SYNC] transformer parse failed:', err?.message || err);
                                 return [];
                             }
                         },
@@ -74,7 +74,7 @@ class MessageSyncMixin extends mixin_1.Mixin {
                             }
                         }
                         catch (err) {
-                            console.warn('[MESSAGE_SYNC] receive fallback handler error:', (err === null || err === void 0 ? void 0 : err.message) || err);
+                            console.warn('[MESSAGE_SYNC] receive fallback handler error:', err?.message || err);
                         }
                     });
                 }
@@ -124,7 +124,6 @@ class MessageSyncMixin extends mixin_1.Mixin {
         return result;
     }
     extractMessageContent(msgValue, itemType) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
         let content = '';
         let mediaInfo = '';
         try {
@@ -139,7 +138,7 @@ class MessageSyncMixin extends mixin_1.Mixin {
                         const media = msgValue.media;
                         if (media.image_versions2) {
                             content = '[PHOTO]';
-                            mediaInfo = ` URL: ${((_c = (_b = (_a = media.image_versions2) === null || _a === void 0 ? void 0 : _a.candidates) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.url) || 'N/A'}`;
+                            mediaInfo = ` URL: ${media.image_versions2?.candidates?.[0]?.url || 'N/A'}`;
                         }
                         else if (media.video_versions) {
                             content = '[VIDEO]';
@@ -152,14 +151,14 @@ class MessageSyncMixin extends mixin_1.Mixin {
                     break;
                 case 'voice_media':
                     content = '[VOICE MESSAGE]';
-                    if ((_e = (_d = msgValue.voice_media) === null || _d === void 0 ? void 0 : _d.media) === null || _e === void 0 ? void 0 : _e.audio) {
+                    if (msgValue.voice_media?.media?.audio) {
                         const duration = msgValue.voice_media.media.audio.duration || 0;
                         content = `[VOICE MESSAGE] Duration: ${duration}ms`;
                     }
                     break;
                 case 'animated_media':
                     content = '[GIF]';
-                    if ((_h = (_g = (_f = msgValue.animated_media) === null || _f === void 0 ? void 0 : _f.images) === null || _g === void 0 ? void 0 : _g.fixed_height) === null || _h === void 0 ? void 0 : _h.url) {
+                    if (msgValue.animated_media?.images?.fixed_height?.url) {
                         mediaInfo = ` URL: ${msgValue.animated_media.images.fixed_height.url}`;
                     }
                     break;
@@ -167,8 +166,8 @@ class MessageSyncMixin extends mixin_1.Mixin {
                     content = '[SHARED POST]';
                     if (msgValue.media_share) {
                         const share = msgValue.media_share;
-                        content = `[SHARED POST] From: @${((_j = share.user) === null || _j === void 0 ? void 0 : _j.username) || 'unknown'}`;
-                        if ((_k = share.caption) === null || _k === void 0 ? void 0 : _k.text) {
+                        content = `[SHARED POST] From: @${share.user?.username || 'unknown'}`;
+                        if (share.caption?.text) {
                             content += ` Caption: "${String(share.caption.text).substring(0, 50)}..."`;
                         }
                     }
@@ -177,7 +176,7 @@ class MessageSyncMixin extends mixin_1.Mixin {
                     content = '[SHARED REEL]';
                     if (msgValue.reel_share) {
                         const reel = msgValue.reel_share;
-                        content = `[SHARED REEL] From: @${((_m = (_l = reel.media) === null || _l === void 0 ? void 0 : _l.user) === null || _m === void 0 ? void 0 : _m.username) || 'unknown'}`;
+                        content = `[SHARED REEL] From: @${reel.media?.user?.username || 'unknown'}`;
                         if (reel.text) {
                             content += ` Text: "${reel.text}"`;
                         }
@@ -187,7 +186,7 @@ class MessageSyncMixin extends mixin_1.Mixin {
                     content = '[SHARED STORY]';
                     if (msgValue.story_share) {
                         const story = msgValue.story_share;
-                        content = `[SHARED STORY] From: @${((_p = (_o = story.media) === null || _o === void 0 ? void 0 : _o.user) === null || _p === void 0 ? void 0 : _p.username) || 'unknown'}`;
+                        content = `[SHARED STORY] From: @${story.media?.user?.username || 'unknown'}`;
                         if (story.message) {
                             content += ` Message: "${story.message}"`;
                         }
@@ -195,14 +194,14 @@ class MessageSyncMixin extends mixin_1.Mixin {
                     break;
                 case 'felix_share':
                     content = '[SHARED IGTV/VIDEO]';
-                    if ((_q = msgValue.felix_share) === null || _q === void 0 ? void 0 : _q.video) {
+                    if (msgValue.felix_share?.video) {
                         content = `[SHARED IGTV] Title: "${msgValue.felix_share.video.title || 'N/A'}"`;
                     }
                     break;
                 case 'clip':
                     content = '[SHARED CLIP]';
-                    if ((_r = msgValue.clip) === null || _r === void 0 ? void 0 : _r.clip) {
-                        content = `[SHARED CLIP] From: @${((_s = msgValue.clip.clip.user) === null || _s === void 0 ? void 0 : _s.username) || 'unknown'}`;
+                    if (msgValue.clip?.clip) {
+                        content = `[SHARED CLIP] From: @${msgValue.clip.clip.user?.username || 'unknown'}`;
                     }
                     break;
                 case 'profile':
@@ -240,7 +239,7 @@ class MessageSyncMixin extends mixin_1.Mixin {
                     break;
                 case 'placeholder':
                     content = '[PLACEHOLDER]';
-                    if ((_t = msgValue.placeholder) === null || _t === void 0 ? void 0 : _t.message) {
+                    if (msgValue.placeholder?.message) {
                         content = `[PLACEHOLDER] ${msgValue.placeholder.message}`;
                     }
                     break;
@@ -387,7 +386,6 @@ class MessageSyncMixin extends mixin_1.Mixin {
         }
     }
     async handleMessageSync(client, syncData) {
-        var _a, _b, _c, _d;
         if (!syncData || !Array.isArray(syncData)) {
             console.log(`[MESSAGE_SYNC] No sync data received`);
             return;
@@ -473,7 +471,7 @@ class MessageSyncMixin extends mixin_1.Mixin {
                                 // determine status based on whether message author is the logged-in account
                                 let status = 'received';
                                 try {
-                                    const ownId = ((_b = (_a = client === null || client === void 0 ? void 0 : client.ig) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.cookieUserId) || ((_d = (_c = client === null || client === void 0 ? void 0 : client.ig) === null || _c === void 0 ? void 0 : _c.state) === null || _d === void 0 ? void 0 : _d.userId) || null;
+                                    const ownId = client?.ig?.state?.cookieUserId || client?.ig?.state?.userId || null;
                                     if (ownId && userId && String(userId) === String(ownId)) {
                                         status = 'sent';
                                     }
@@ -541,12 +539,12 @@ class MessageSyncMixin extends mixin_1.Mixin {
                         }
                     }
                     catch (inner) {
-                        console.log(`[MESSAGE_SYNC] element handling error: ${(inner === null || inner === void 0 ? void 0 : inner.message) || inner}`);
+                        console.log(`[MESSAGE_SYNC] element handling error: ${inner?.message || inner}`);
                     }
                 }
             }
             catch (outer) {
-                console.log(`[MESSAGE_SYNC] item error: ${(outer === null || outer === void 0 ? void 0 : outer.message) || outer}`);
+                console.log(`[MESSAGE_SYNC] item error: ${outer?.message || outer}`);
             }
         }
     }

package/dist/dist/realtime/mixins/mixin.d.ts

@@ -0,0 +1,4 @@
+declare class Mixin {
+}
+declare function applyMixins(mixins: any, client: any, ig: any): void;
+declare function hook(target: any, key: any, hooks: any): void;

package/dist/dist/realtime/mixins/presence-typing.mixin.d.ts

@@ -0,0 +1,9 @@
+declare const presence_manager_1: any;
+declare const skywalker_protocol_1: any;
+/**
+ * Mixin for handling Presence and Typing Indicators
+ */
+declare class PresenceTypingMixin {
+    apply(client: any): void;
+    get name(): string;
+}

package/dist/dist/realtime/mixins/realtime-sub.mixin.d.ts

@@ -0,0 +1,37 @@
+declare const mixin_1: any;
+declare const constants_1: any;
+declare const shared_1: any;
+declare const subscriptions_1: any;
+declare const mqtts_1: any;
+declare class RealtimeSubMixin extends mixin_1.Mixin {
+    apply(client: any): void;
+    /**
+     * ADDED: Handler compatible with instagram_mqtt's listen() approach
+     * This method handles data from client.mqtt.listen() and emits instagram_mqtt compatible events
+     *
+     * @param {Object} client - The realtime client instance
+     * @param {Object} param1 - The parsed data object containing { data, topic }
+     */
+    handleRealtimeSubFromListen(client: any, { data, topic: messageTopic }: {
+        data: any;
+        topic: any;
+    }): void;
+    /**
+     * ADDED: Method to emit direct events (was MISSING from nodejs-insta-private-api-mqt)
+     * This method parses string values in parsed.data and emits 'direct' event for each
+     *
+     * @param {Object} client - The realtime client instance
+     * @param {Object} parsed - The parsed message object containing data array
+     */
+    emitDirectEvent(client: any, parsed: any): void;
+    /**
+     * PRESERVED: Original handler for on('message') approach (for backwards compatibility)
+     * This emits the 'subscription' event that existing code may depend on
+     *
+     * @param {Object} client - The realtime client instance
+     * @param {Object} topic - The topic object from topicMap
+     * @param {Object} data - The parsed message data
+     */
+    handleRealtimeSub(client: any, topic: any, data: any): void;
+    get name(): string;
+}

package/{dist-ts → dist}/dist/realtime/mixins/realtime-sub.mixin.js

@@ -49,7 +49,7 @@ class RealtimeSubMixin extends mixin_1.Mixin {
                             }
                             catch (err) {
                                 // If transformer fails, return null so handler can skip
-                                console.warn('[RealtimeSubMixin] transformer parse failed:', (err === null || err === void 0 ? void 0 : err.message) || err);
+                                console.warn('[RealtimeSubMixin] transformer parse failed:', err?.message || err);
                                 return null;
                             }
                         },
@@ -62,9 +62,8 @@ class RealtimeSubMixin extends mixin_1.Mixin {
                 }
                 // PRESERVED: Original on('message') approach with topicMap (for backwards compatibility)
                 client.mqtt.on('message', async (msg) => {
-                    var _a;
-                    const topicMap = (_a = client.mqtt) === null || _a === void 0 ? void 0 : _a.topicMap;
-                    const topic = topicMap === null || topicMap === void 0 ? void 0 : topicMap.get(msg.topic);
+                    const topicMap = client.mqtt?.topicMap;
+                    const topic = topicMap?.get(msg.topic);
                     if (topic && topic.parser && !topic.noParse) {
                         try {
                             const unzipped = await (0, shared_1.tryUnzipAsync)(msg.payload);
@@ -140,7 +139,7 @@ class RealtimeSubMixin extends mixin_1.Mixin {
                 }
                 catch (parseErr) {
                     // If parsing fails, keep original value
-                    console.warn('[RealtimeSubMixin] emitDirectEvent JSON parse failed:', parseErr === null || parseErr === void 0 ? void 0 : parseErr.message);
+                    console.warn('[RealtimeSubMixin] emitDirectEvent JSON parse failed:', parseErr?.message);
                 }
             }
             return e;

package/dist/dist/realtime/parsers/graphql-parser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * GraphQL Parser
+ *
+ * Parses GraphQL messages from Instagram's realtime system.
+ * These messages contain GraphQL queries, mutations, and subscriptions.
+ */
+declare class GraphqlParser {
+    /**
+     * Parse a GraphQL message
+     * @param {Buffer|string} data - The raw message data
+     * @returns {Object} Parsed GraphQL data
+     */
+    parse(data: any): {
+        type: string;
+        data: any;
+        raw: any;
+    };
+}

package/dist/dist/realtime/parsers/graphql.parser.d.ts

@@ -0,0 +1,10 @@
+declare const thrift_1: any;
+declare const shared_1: any;
+declare class GraphqlParser {
+    parseMessage(topic: any, payload: any): {
+        topic: any;
+        data: {
+            message: any;
+        };
+    };
+}

package/{src-ts/dist/realtime/parsers/graphql.parser.ts → dist/dist/realtime/parsers/graphql.parser.js}

@@ -19,4 +19,3 @@ GraphqlParser.descriptors = [
     thrift_1.ThriftDescriptors.binary('topic', 1),
     thrift_1.ThriftDescriptors.binary('payload', 2),
 ];
-//# sourceMappingURL=graphql.parser.js.map