nodejs-insta-private-api-mqt 1.3.70

package/dist/realtime/mixins/presence-typing.mixin.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PresenceTypingMixin = void 0;
+const presence_manager_1 = require("../features/presence.manager");
+const skywalker_protocol_1 = require("../protocols/skywalker.protocol");
+/**
+ * Mixin for handling Presence and Typing Indicators
+ */
+class PresenceTypingMixin {
+    apply(client) {
+        // Initialize managers
+        client.presenceManager = new presence_manager_1.PresenceManager(client);
+        client.skywalkerProtocol = new skywalker_protocol_1.SkywalkerProtocol(client);
+        
+        // Add public methods
+        client.sendTyping = async (threadId, isTyping = true) => {
+            return client.skywalkerProtocol.sendTypingIndicator(threadId, isTyping);
+        };
+        
+        client.sendReaction = async (messageId, threadId, emoji) => {
+            return client.skywalkerProtocol.sendReaction(messageId, threadId, emoji);
+        };
+        
+        client.broadcastPresence = async (status = 'online') => {
+            return client.presenceManager.broadcastPresence(status);
+        };
+    }
+    
+    get name() {
+        return 'Presence & Typing';
+    }
+}
+exports.PresenceTypingMixin = PresenceTypingMixin;

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

@@ -0,0 +1,8 @@
+import { Mixin } from './mixin';
+import { RealtimeClient } from '../realtime.client';
+export declare class RealtimeSubMixin extends Mixin {
+    apply(client: RealtimeClient): void;
+    private handleRealtimeSub;
+    private emitDirectEvent;
+    get name(): string;
+}

package/dist/realtime/mixins/realtime-sub.mixin.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * RealtimeSubMixin - ENHANCED VERSION
+ * 
+ * This file has been modified to include all MQTT features from instagram_mqtt library.
+ * 
+ * CHANGES MADE (from instagram_mqtt compatibility):
+ * 1. Added import for subscriptions (QueryIDs) - was MISSING
+ * 2. Added client.mqtt.listen() approach for REALTIME_SUB topic - was MISSING
+ * 3. Added 'realtimeSub' event emission - was MISSING (only had 'subscription')
+ * 4. Added 'direct' topic processing - was MISSING
+ * 5. Added emitDirectEvent() method - was MISSING
+ * 6. Added QueryIDs-based event emission (directTyping, appPresence, etc.) - was MISSING
+ * 
+ * PRESERVED:
+ * - Original 'subscription' event emission (for backwards compatibility)
+ * - Original on('message') approach with topicMap (extended, not replaced)
+ * - All existing retry logic and error handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeSubMixin = void 0;
+const mixin_1 = require("./mixin");
+const constants_1 = require("../../constants");
+const shared_1 = require("../../shared");
+// ADDED: Import subscriptions for QueryIDs (was MISSING in nodejs-insta-private-api-mqt)
+const subscriptions_1 = require("../subscriptions");
+const mqtts_1 = require("mqtts");
+
+class RealtimeSubMixin extends mixin_1.Mixin {
+    apply(client) {
+        (0, mixin_1.hook)(client, 'connect', {
+            post: async () => {
+                // Wait for MQTT client to be ready (PRESERVED from original)
+                let retries = 0;
+                while (!client.mqtt && retries < 50) {
+                    await new Promise(r => setTimeout(r, 100));
+                    retries++;
+                }
+                if (!client.mqtt) {
+                    throw new mqtts_1.IllegalStateError('No mqtt client created after retries');
+                }
+
+                // ADDED: Use client.mqtt.listen() for REALTIME_SUB topic (from instagram_mqtt)
+                // This is the approach used by instagram_mqtt for handling realtime subscriptions
+                if (client.mqtt.listen) {
+                    client.mqtt.listen({
+                        topic: constants_1.Topics.REALTIME_SUB.id,
+                        transformer: async ({ payload }) => {
+                            try {
+                                return constants_1.Topics.REALTIME_SUB.parser.parseMessage(
+                                    constants_1.Topics.REALTIME_SUB, 
+                                    await (0, shared_1.tryUnzipAsync)(payload)
+                                );
+                            } catch (err) {
+                                // If transformer fails, return null so handler can skip
+                                console.warn('[RealtimeSubMixin] transformer parse failed:', err?.message || err);
+                                return null;
+                            }
+                        },
+                    }, data => {
+                        if (data) {
+                            // ADDED: Call the instagram_mqtt compatible handler
+                            this.handleRealtimeSubFromListen(client, data);
+                        }
+                    });
+                }
+
+                // PRESERVED: Original on('message') approach with topicMap (for backwards compatibility)
+                client.mqtt.on('message', async (msg) => {
+                    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);
+                            const parsedMessages = topic.parser.parseMessage(topic, unzipped);
+                            if (Array.isArray(parsedMessages)) {
+                                parsedMessages.forEach(m => {
+                                    this.handleRealtimeSub(client, topic, m.data);
+                                });
+                            } else {
+                                this.handleRealtimeSub(client, topic, parsedMessages.data);
+                            }
+                        } catch (e) {
+                            console.error(`RealtimeSub parse error on ${topic.path}:`, e.message);
+                        }
+                    }
+                });
+            },
+        });
+    }
+
+    /**
+     * 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, { data, topic: messageTopic }) {
+        const { message } = data;
+        
+        // ADDED: Emit 'realtimeSub' event (was MISSING - this is what instagram_mqtt does)
+        client.emit('realtimeSub', { data, topic: messageTopic });
+        
+        // ADDED: Process message based on type (was MISSING)
+        if (typeof message === 'string') {
+            // If message is a string, parse it and emit direct event
+            this.emitDirectEvent(client, JSON.parse(message));
+        }
+        else if (message) {
+            const { topic, payload, json } = message;
+            switch (topic) {
+                case 'direct': {
+                    // ADDED: Handle 'direct' topic specifically (was MISSING)
+                    this.emitDirectEvent(client, json);
+                    break;
+                }
+                default: {
+                    // ADDED: Emit QueryID-based events (was MISSING)
+                    // This emits events like 'directTyping', 'appPresence', 'directStatus', etc.
+                    const entries = Object.entries(subscriptions_1.QueryIDs);
+                    const query = entries.find(e => e[1] === topic);
+                    if (query) {
+                        client.emit(query[0], json || payload);
+                    }
+                }
+            }
+        }
+    }
+
+    /**
+     * 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, parsed) {
+        if (!parsed || !parsed.data || !Array.isArray(parsed.data)) {
+            return;
+        }
+        
+        parsed.data = parsed.data.map((e) => {
+            if (typeof e.value === 'string') {
+                try {
+                    e.value = JSON.parse(e.value);
+                } catch (parseErr) {
+                    // If parsing fails, keep original value
+                    console.warn('[RealtimeSubMixin] emitDirectEvent JSON parse failed:', parseErr?.message);
+                }
+            }
+            return e;
+        });
+        
+        // Emit 'direct' event for each data item
+        parsed.data.forEach((data) => client.emit('direct', data));
+    }
+
+    /**
+     * 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, topic, data) {
+        // PRESERVED: Emit 'subscription' event (original behavior)
+        client.emit('subscription', {
+            query: topic.path,
+            data: data,
+            topic: topic,
+        });
+    }
+
+    get name() {
+        return 'Realtime Sub';
+    }
+}
+exports.RealtimeSubMixin = RealtimeSubMixin;
+//# sourceMappingURL=realtime-sub.mixin.js.map

package/dist/realtime/mixins/realtime-sub.mixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-sub.mixin.js","sourceRoot":"","sources":["../../../src/realtime/mixins/realtime-sub.mixin.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAEtC,+CAAyC;AACzC,yCAA6C;AAE7C,oDAA4C;AAE5C,iCAA0C;AAE1C,MAAa,gBAAiB,SAAQ,aAAK;IACxC,KAAK,CAAC,MAAsB;QACzB,IAAA,YAAI,EAAC,MAAM,EAAE,SAAS,EAAE;YACrB,IAAI,EAAE,GAAG,EAAE;gBACR,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,MAAM,IAAI,yBAAiB,CAAC,wBAAwB,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,MAAM,CACf;oBACG,KAAK,EAAE,kBAAM,CAAC,YAAY,CAAC,EAAE;oBAC7B,WAAW,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAChC,kBAAM,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,kBAAM,CAAC,YAAY,EAAE,MAAM,IAAA,sBAAa,EAAC,OAAO,CAAC,CAAC;iBAC/F,EACD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAC9C,CAAC;YACL,CAAC;SACH,CAAC,CAAC;IACN,CAAC;IAEO,iBAAiB,CAAC,MAAsB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAiC;QAC3G,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACL,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;YACzC,QAAQ,KAAK,EAAE,CAAC;gBACb,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACb,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;oBACnC,MAAM;gBACT,CAAC;gBACD,OAAO,CAAC,CAAC,CAAC;oBACP,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,wBAAQ,CAAC,CAAC;oBACzC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;oBAChD,IAAI,KAAK,EAAE,CAAC;wBACT,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAA0B,EAAE,IAAI,IAAI,OAAO,CAAC,CAAC;oBACnE,CAAC;gBACJ,CAAC;YACJ,CAAC;QACJ,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,MAAsB,EAAE,MAAW;QACxD,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE;YACtC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC/B,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAkC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,IAAI;QACL,OAAO,cAAc,CAAC;IACzB,CAAC;CACH;AAvDD,4CAuDC"}

package/dist/realtime/parsers/graphql-parser.js

@@ -0,0 +1,43 @@
+/**
+ * GraphQL Parser
+ * 
+ * Parses GraphQL messages from Instagram's realtime system.
+ * These messages contain GraphQL queries, mutations, and subscriptions.
+ */
+class GraphqlParser {
+  /**
+   * Parse a GraphQL message
+   * @param {Buffer|string} data - The raw message data
+   * @returns {Object} Parsed GraphQL data
+   */
+  parse(data) {
+    try {
+      const message = Buffer.isBuffer(data) ? data.toString() : data;
+      
+      // Try to parse as JSON first
+      try {
+        const parsed = JSON.parse(message);
+        return {
+          type: 'graphql',
+          data: parsed,
+          raw: message
+        };
+      } catch (jsonError) {
+        // If not JSON, treat as GraphQL query string
+        return {
+          type: 'graphql',
+          data: { query: message },
+          raw: message
+        };
+      }
+    } catch (error) {
+      return {
+        type: 'graphql',
+        data: { error: error.message },
+        raw: data.toString()
+      };
+    }
+  }
+}
+
+module.exports = GraphqlParser;

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

@@ -0,0 +1,15 @@
+/// <reference types="node" />
+import { ParsedMessage, Parser } from './parser';
+import { Topic } from '../../topic';
+import { ThriftPacketDescriptor } from '../../thrift';
+export declare class GraphqlParser implements Parser<GraphQlMessage> {
+    static descriptors: ThriftPacketDescriptor[];
+    parseMessage(topic: Topic, payload: Buffer): ParsedMessage<GraphQlMessage>;
+}
+export interface GraphQlMessage {
+    message: string | {
+        topic: string;
+        payload: string;
+        json: any;
+    };
+}

package/dist/realtime/parsers/graphql.parser.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphqlParser = void 0;
+const thrift_1 = require("../../thrift");
+const shared_1 = require("../../shared");
+class GraphqlParser {
+    parseMessage(topic, payload) {
+        const message = (0, shared_1.isJson)(payload)
+            ? payload.toString()
+            : (0, thrift_1.thriftReadToObject)(payload, GraphqlParser.descriptors) ?? '';
+        if (message.payload) {
+            message.json = JSON.parse(message.payload);
+        }
+        return { topic, data: { message } };
+    }
+}
+exports.GraphqlParser = GraphqlParser;
+GraphqlParser.descriptors = [
+    thrift_1.ThriftDescriptors.binary('topic', 1),
+    thrift_1.ThriftDescriptors.binary('payload', 2),
+];
+//# sourceMappingURL=graphql.parser.js.map

package/dist/realtime/parsers/graphql.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.parser.js","sourceRoot":"","sources":["../../../src/realtime/parsers/graphql.parser.ts"],"names":[],"mappings":";;;AAEA,yCAA6F;AAC7F,yCAAsC;AAEtC,MAAa,aAAa;IAMhB,YAAY,CAAC,KAAY,EAAE,OAAe;QAC9C,MAAM,OAAO,GAAQ,IAAA,eAAM,EAAC,OAAO,CAAC;YACjC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;YACpB,CAAC,CAAC,IAAA,2BAAkB,EAAqC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACtG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;IACvC,CAAC;;AAdJ,sCAeC;AAdgB,yBAAW,GAA6B;IACnD,0BAAiB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACpC,0BAAiB,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;CACxC,CAAC"}

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

@@ -0,0 +1,6 @@
+export * from './graphql.parser';
+export * from './iris.parser';
+export * from './json.parser';
+export * from './parser';
+export * from './region-hint.parser';
+export * from './skywalker.parser';

package/dist/realtime/parsers/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./graphql.parser"), exports);
+__exportStar(require("./iris.parser"), exports);
+__exportStar(require("./json.parser"), exports);
+__exportStar(require("./parser"), exports);
+__exportStar(require("./region-hint.parser"), exports);
+__exportStar(require("./skywalker.parser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/realtime/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/realtime/parsers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,gDAA8B;AAC9B,gDAA8B;AAC9B,2CAAyB;AACzB,uDAAqC;AACrC,qDAAmC"}

package/dist/realtime/parsers/iris-parser.js

@@ -0,0 +1,43 @@
+/**
+ * Iris Parser
+ * 
+ * Parses Iris messages from Instagram's realtime system.
+ * Iris is Instagram's internal messaging system for real-time updates.
+ */
+class IrisParser {
+  /**
+   * Parse an Iris message
+   * @param {Buffer|string} data - The raw message data
+   * @returns {Object} Parsed Iris data
+   */
+  parse(data) {
+    try {
+      const message = Buffer.isBuffer(data) ? data.toString() : data;
+      
+      // Try to parse as JSON first
+      try {
+        const parsed = JSON.parse(message);
+        return {
+          type: 'iris',
+          data: parsed,
+          raw: message
+        };
+      } catch (jsonError) {
+        // If not JSON, treat as plain text
+        return {
+          type: 'iris',
+          data: { message: message },
+          raw: message
+        };
+      }
+    } catch (error) {
+      return {
+        type: 'iris',
+        data: { error: error.message },
+        raw: data.toString()
+      };
+    }
+  }
+}
+
+module.exports = IrisParser;

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

@@ -0,0 +1,17 @@
+/// <reference types="node" />
+import { ParsedMessage, Parser } from './parser';
+import { Topic } from '../../topic';
+export declare class IrisParser implements Parser<IrisParserData> {
+    parseMessage(topic: Topic, payload: Buffer): ParsedMessage<IrisParserData>[];
+}
+export interface IrisParserData {
+    event: 'patch' | string;
+    data?: any[];
+    message_type: number;
+    seq_id: number;
+    mutation_token: null | string;
+    realtime: boolean;
+    op?: 'add' | 'replace' | string;
+    path?: string;
+    sampled?: boolean;
+}

package/dist/realtime/parsers/iris.parser.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IrisParser = void 0;
+class IrisParser {
+    parseMessage(topic, payload) {
+        return JSON.parse(payload.toString('utf8')).map((x) => ({ topic, data: x }));
+    }
+}
+exports.IrisParser = IrisParser;
+//# sourceMappingURL=iris.parser.js.map

package/dist/realtime/parsers/iris.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iris.parser.js","sourceRoot":"","sources":["../../../src/realtime/parsers/iris.parser.ts"],"names":[],"mappings":";;;AAGA,MAAa,UAAU;IACb,YAAY,CAAC,KAAY,EAAE,OAAe;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChG,CAAC;CACH;AAJD,gCAIC"}

package/dist/realtime/parsers/json-parser.js

@@ -0,0 +1,43 @@
+/**
+ * JSON Parser
+ * 
+ * Parses JSON messages from Instagram's realtime system.
+ * This is a general-purpose parser for JSON-formatted messages.
+ */
+class JsonParser {
+  /**
+   * Parse a JSON message
+   * @param {Buffer|string} data - The raw message data
+   * @returns {Object} Parsed JSON data
+   */
+  parse(data) {
+    try {
+      const message = Buffer.isBuffer(data) ? data.toString() : data;
+      
+      // Try to parse as JSON
+      try {
+        const parsed = JSON.parse(message);
+        return {
+          type: 'json',
+          data: parsed,
+          raw: message
+        };
+      } catch (jsonError) {
+        // If not valid JSON, return as plain text
+        return {
+          type: 'json',
+          data: { text: message },
+          raw: message
+        };
+      }
+    } catch (error) {
+      return {
+        type: 'json',
+        data: { error: error.message },
+        raw: data.toString()
+      };
+    }
+  }
+}
+
+module.exports = JsonParser;

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

@@ -0,0 +1,6 @@
+/// <reference types="node" />
+import { ParsedMessage, Parser } from './parser';
+import { Topic } from '../../topic';
+export declare class JsonParser implements Parser<any> {
+    parseMessage(topic: Topic, payload: Buffer): ParsedMessage<any>;
+}

package/dist/realtime/parsers/json.parser.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonParser = void 0;
+class JsonParser {
+    parseMessage(topic, payload) {
+        return { topic, data: payload.length > 0 ? JSON.parse(payload.toString()) : {} };
+    }
+}
+exports.JsonParser = JsonParser;
+//# sourceMappingURL=json.parser.js.map

package/dist/realtime/parsers/json.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.parser.js","sourceRoot":"","sources":["../../../src/realtime/parsers/json.parser.ts"],"names":[],"mappings":";;;AAGA,MAAa,UAAU;IACb,YAAY,CAAC,KAAY,EAAE,OAAe;QAC9C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpF,CAAC;CACH;AAJD,gCAIC"}

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

@@ -0,0 +1,9 @@
+/// <reference types="node" />
+import { Topic } from '../../topic';
+export interface Parser<T> {
+    parseMessage(topic: Topic, payload: Buffer): ParsedMessage<T>[] | ParsedMessage<T>;
+}
+export interface ParsedMessage<T> {
+    topic: Topic;
+    data: T;
+}

package/dist/realtime/parsers/parser.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=parser.js.map

package/dist/realtime/parsers/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/realtime/parsers/parser.ts"],"names":[],"mappings":""}

package/dist/realtime/parsers/region-hint-parser.js

@@ -0,0 +1,43 @@
+/**
+ * Region Hint Parser
+ * 
+ * Parses region hint messages from Instagram's realtime system.
+ * These messages contain information about the user's region/location.
+ */
+class RegionHintParser {
+  /**
+   * Parse a region hint message
+   * @param {Buffer|string} data - The raw message data
+   * @returns {Object} Parsed region hint data
+   */
+  parse(data) {
+    try {
+      const message = Buffer.isBuffer(data) ? data.toString() : data;
+      
+      // Try to parse as JSON first
+      try {
+        const parsed = JSON.parse(message);
+        return {
+          type: 'region_hint',
+          data: parsed,
+          raw: message
+        };
+      } catch (jsonError) {
+        // If not JSON, treat as plain text
+        return {
+          type: 'region_hint',
+          data: { hint: message },
+          raw: message
+        };
+      }
+    } catch (error) {
+      return {
+        type: 'region_hint',
+        data: { error: error.message },
+        raw: data.toString()
+      };
+    }
+  }
+}
+
+module.exports = RegionHintParser;

package/dist/realtime/parsers/region-hint.parser.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" />
+import { ParsedMessage, Parser } from './parser';
+import { Topic } from '../../topic';
+import { ThriftToObjectResult } from '../../thrift';
+export declare class RegionHintParser implements Parser<ThriftToObjectResult<{
+    hint: string;
+}>> {
+    static descriptors: import("../../thrift").ThriftPacketDescriptor[];
+    parseMessage: (topic: Topic, payload: Buffer) => ParsedMessage<ThriftToObjectResult<{
+        hint: string;
+    }>>;
+}

package/dist/realtime/parsers/region-hint.parser.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegionHintParser = void 0;
+const thrift_1 = require("../../thrift");
+class RegionHintParser {
+    constructor() {
+        this.parseMessage = (topic, payload) => ({
+            topic,
+            data: (0, thrift_1.thriftReadToObject)(payload, RegionHintParser.descriptors),
+        });
+    }
+}
+exports.RegionHintParser = RegionHintParser;
+RegionHintParser.descriptors = [thrift_1.ThriftDescriptors.binary('hint', 1)];
+//# sourceMappingURL=region-hint.parser.js.map

package/dist/realtime/parsers/region-hint.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-hint.parser.js","sourceRoot":"","sources":["../../../src/realtime/parsers/region-hint.parser.ts"],"names":[],"mappings":";;;AAEA,yCAA2F;AAE3F,MAAa,gBAAgB;IAA7B;QAGU,iBAAY,GAAG,CAAC,KAAY,EAAE,OAAe,EAAyD,EAAE,CAAC,CAAC;YAC9G,KAAK;YACL,IAAI,EAAE,IAAA,2BAAkB,EAAC,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC;SACjE,CAAC,CAAC;IACN,CAAC;;AAPD,4CAOC;AANgB,4BAAW,GAAG,CAAC,0BAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,AAAxC,CAAyC"}

package/dist/realtime/parsers/skywalker-parser.js

@@ -0,0 +1,43 @@
+/**
+ * Skywalker Parser
+ * 
+ * Parses Skywalker messages from Instagram's realtime system.
+ * Skywalker is Instagram's pub/sub system for real-time updates.
+ */
+class SkywalkerParser {
+  /**
+   * Parse a Skywalker message
+   * @param {Buffer|string} data - The raw message data
+   * @returns {Object} Parsed Skywalker data
+   */
+  parse(data) {
+    try {
+      const message = Buffer.isBuffer(data) ? data.toString() : data;
+      
+      // Try to parse as JSON first
+      try {
+        const parsed = JSON.parse(message);
+        return {
+          type: 'skywalker',
+          data: parsed,
+          raw: message
+        };
+      } catch (jsonError) {
+        // If not JSON, treat as plain text
+        return {
+          type: 'skywalker',
+          data: { message: message },
+          raw: message
+        };
+      }
+    } catch (error) {
+      return {
+        type: 'skywalker',
+        data: { error: error.message },
+        raw: data.toString()
+      };
+    }
+  }
+}
+
+module.exports = SkywalkerParser;

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

@@ -0,0 +1,12 @@
+/// <reference types="node" />
+import { ParsedMessage, Parser } from './parser';
+import { Topic } from '../../topic';
+import { ThriftToObjectResult } from '../../thrift';
+export declare class SkywalkerParser implements Parser<ThriftToObjectResult<SkywalkerResult>> {
+    static descriptors: import("../../thrift").ThriftPacketDescriptor[];
+    parseMessage(topic: Topic, payload: Buffer): ParsedMessage<ThriftToObjectResult<SkywalkerResult>>;
+}
+export interface SkywalkerResult {
+    topic: number;
+    payload: string;
+}