nodejs-insta-private-api-mqtt 1.0.0

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;
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"skywalker.parser.js","sourceRoot":"","sources":["../../../src/realtime/parsers/skywalker.parser.ts"],"names":[],"mappings":";;;AAEA,yCAA2F;AAE3F,MAAa,eAAe;IAGlB,YAAY,CAAC,KAAY,EAAE,OAAe;QAC9C,OAAO;YACJ,KAAK;YACL,IAAI,EAAE,IAAA,2BAAkB,EAAC,OAAO,EAAE,eAAe,CAAC,WAAW,CAAC;SAChE,CAAC;IACL,CAAC;;AARJ,0CASC;AARgB,2BAAW,GAAG,CAAC,0BAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,0BAAiB,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC"}

package/dist/realtime/parsers-advanced.js

@@ -0,0 +1,158 @@
+const debug = require('debug')('ig:parsers');
+const ProtoParser = require('./proto-parser');
+
+const protoParser = new ProtoParser();
+
+/**
+ * Advanced Topic-Specific Parsers
+ */
+
+// Parse Iris (Direct Messages)
+function parseIris(topicId, payload) {
+  const result = protoParser.decode(topicId, payload);
+  
+  if (result.success && result.messages) {
+    return {
+      type: 'iris',
+      messages: result.messages.filter(m => m.type === 'message' || !m.type),
+      threads: result.messages.filter(m => m.type === 'thread').map(m => m.thread),
+      typing: result.messages.filter(m => m.type === 'typing').map(m => m.typing)
+    };
+  }
+  
+  return { type: 'iris', error: result.error, raw: result.raw };
+}
+
+// Parse GraphQL (Presence, Typing)
+function parseGraphQL(topicId, payload) {
+  const result = protoParser.decode(topicId, payload);
+  
+  if (result.success) {
+    return {
+      type: 'graphql',
+      data: result.decoded,
+      messages: result.messages
+    };
+  }
+  
+  return { type: 'graphql', error: result.error };
+}
+
+// Parse Delta (Sync updates)
+function parseDelta(topicId, payload) {
+  const result = protoParser.decode(topicId, payload);
+  
+  if (result.success && result.decoded) {
+    return {
+      type: 'delta',
+      seqId: result.decoded.seq_id,
+      action: result.decoded.action,
+      items: result.messages,
+      metadata: result.decoded.metadata
+    };
+  }
+  
+  return { type: 'delta', error: result.error };
+}
+
+// Parse Presence
+function parsePresence(topicId, payload) {
+  const result = protoParser.decode(topicId, payload);
+  
+  if (result.success) {
+    return {
+      type: 'presence',
+      items: result.messages.map(m => ({
+        userId: m.id,
+        status: m.typing?.state || 'unknown',
+        timestamp: m.timestamp
+      }))
+    };
+  }
+  
+  return { type: 'presence', error: result.error };
+}
+
+// Parse Feed
+function parseFeed(topicId, payload) {
+  const result = protoParser.decode(topicId, payload);
+  
+  return {
+    type: 'feed',
+    decoded: result.decoded,
+    items: result.messages,
+    error: result.error
+  };
+}
+
+// Parse Live
+function parseLive(topicId, payload) {
+  const result = protoParser.decode(topicId, payload);
+  
+  return {
+    type: 'live',
+    decoded: result.decoded,
+    items: result.messages,
+    error: result.error
+  };
+}
+
+// Parse Region Hint
+function parseRegionHint(topicId, payload) {
+  try {
+    const text = payload.toString('utf-8');
+    const hint = JSON.parse(text);
+    
+    return {
+      type: 'region-hint',
+      region: hint.region,
+      endpoint: hint.endpoint,
+      data: hint
+    };
+  } catch (e) {
+    return {
+      type: 'region-hint',
+      raw: payload.toString('utf-8', 0, 200),
+      error: e.message
+    };
+  }
+}
+
+// Unified router
+const PARSERS = {
+  iris: parseIris,
+  graphql: parseGraphQL,
+  delta: parseDelta,
+  presence: parsePresence,
+  feed: parseFeed,
+  live: parseLive,
+  'region-hint': parseRegionHint
+};
+
+function parseByType(topicType, topicId, payload) {
+  const parser = PARSERS[topicType];
+  
+  if (!parser) {
+    debug(`⚠️  Unknown topic type: ${topicType}`);
+    return { type: topicType, error: 'Unknown parser', raw: payload.toString('utf-8', 0, 200) };
+  }
+  
+  try {
+    return parser(topicId, payload);
+  } catch (e) {
+    debug(`Parse error for ${topicType}:`, e.message);
+    return { type: topicType, error: e.message };
+  }
+}
+
+module.exports = {
+  parseIris,
+  parseGraphQL,
+  parseDelta,
+  parsePresence,
+  parseFeed,
+  parseLive,
+  parseRegionHint,
+  parseByType,
+  ProtoParser
+};

package/dist/realtime/proto/common.proto

@@ -0,0 +1,38 @@
+syntax = "proto3";
+
+package ig.common;
+
+// Shared message types used across Instagram
+
+message Timestamp {
+  int64 unix_time_ms = 1;
+}
+
+message UserId {
+  int64 id = 1;
+}
+
+message ThreadId {
+  int64 id = 1;
+}
+
+message Reaction {
+  string emoji = 1;
+  int32 count = 2;
+  int64 created_at = 3;
+}
+
+message MediaAttachment {
+  int64 media_id = 1;
+  string type = 2; // image, video, carousel
+  string url = 3;
+  int32 width = 4;
+  int32 height = 5;
+}
+
+message Link {
+  string url = 1;
+  string title = 2;
+  string description = 3;
+  string image_url = 4;
+}

package/dist/realtime/proto/direct.proto

@@ -0,0 +1,65 @@
+syntax = "proto3";
+
+package ig.direct;
+
+import "common.proto";
+
+// Direct message protocol - Specific implementation for DMs
+
+message DirectInboxMessageContent {
+  string text = 1;
+  repeated ig.common.MediaAttachment media = 2;
+  repeated ig.common.Link links = 3;
+}
+
+message DirectInboxMessage {
+  string id = 1;
+  int64 user_id = 2;
+  int64 timestamp = 3;
+  
+  string item_type = 4; // text, media_share, animated_media, etc
+  DirectInboxMessageContent content = 5;
+  
+  map<string, string> reactions = 6;
+  
+  bool is_sent = 7;
+  bool is_delivered = 8;
+  bool is_seen = 9;
+  
+  int32 is_forward = 10;
+  int32 forwarded_from_id = 11;
+}
+
+message DirectInboxThread {
+  int64 thread_id = 1;
+  repeated int64 user_ids = 2;
+  
+  string thread_title = 3;
+  int64 last_activity_at = 4;
+  
+  DirectInboxMessage last_message = 5;
+  
+  int32 unfollowers_count = 6;
+  int32 thread_v2_id = 7;
+  
+  bool is_pin = 8;
+  bool is_muted = 9;
+  bool is_archived = 10;
+  bool has_newer = 11;
+}
+
+message DirectInbox {
+  repeated DirectInboxThread threads = 1;
+  string cursor = 2;
+  bool has_older = 3;
+}
+
+message DirectSync {
+  int64 seq_id = 1;
+  int64 timestamp = 2;
+  
+  repeated DirectInboxMessage messages = 3;
+  repeated DirectInboxThread threads = 4;
+  
+  map<string, int64> seq_ids = 5; // per-thread seq tracking
+}