@eryxenx/insta-chat 2.0.5 → 2.0.7

package/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to `@eryxenx/insta-chat` are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/) and uses
 [Semantic Versioning](https://semver.org/).
 
+## [2.0.7] - 2026-10-11
+
+### Fixed
+
+- **`unsendMessage` silently failed for a message the bot did not send in this
+  process.** The thread of the id being unsent was resolved only from the
+  in-memory `messageID -> threadID` map, so unsending a message sent before a
+  restart (or a reply to someone else's message) threw `Unknown thread for
+  message` internally and returned `false` — `/unsend` appeared to do nothing.
+  `unsendMessage(messageID, callback?, threadID?)` now accepts the thread
+  explicitly, and the normalizer remembers the replied-to message id (whose
+  thread is known) so the map lookup succeeds. The thread the message was seen
+  in is always a safe explicit value for `/unsend`.
+
+## [2.0.6] - 2026-10-10
+
+### Added
+
+- **Configurable poll floor.** `new InstaAPI(cookie, { minPollIntervalMs })` (and
+  the same option on `InstaClient`) sets the lowest interval `listen()` will
+  honour, defaulting to 15000 ms as before with a hard 2000 ms minimum.
+  Instagram has no DM push, so reply latency is one poll cycle; operators on a
+  residential/mobile proxy can lower it (e.g. 2000) for snappier replies.
+  `api.listen(cb, interval)` still cannot go below this floor, so the bot can no
+  longer pass an interval the package silently raises.
+
 ## [2.0.5] - 2026-10-10
 
 ### Fixed

package/DOCS.md

@@ -48,6 +48,7 @@ commands call). Pass `{ native: true }` to get the bare `InstaAPI` instead.
 | `sessionParamsFile` | `./session-params.json` | Load params from disk. |
 | `deviceFile` | `./device.json` | Persisted device identity. |
 | `pollInterval` | `15000` | `listen()` poll interval (ms). |
+| `minPollIntervalMs` | `15000` | Lowest interval `listen()` will honour (floor, min 2000). |
 
 ## `InstaClient` (FCA surface)
 
@@ -57,7 +58,7 @@ Facebook-Chat-API shape. Its methods live one-per-file under
 
 | Group | Methods |
 |-------|---------|
-| messaging | `sendMessage(form, threadID, cb?, replyToMessage?)`, `sendMessageSync`, `editMessage(text, messageID)`, `unsendMessage(messageID)`, `setMessageReaction(emoji, messageID, cb?, threadID?)`, `sendTypingIndicator`, `markAsRead`, `shareContact`, `resolvePhotoUrl` |
+| messaging | `sendMessage(form, threadID, cb?, replyToMessage?)`, `sendMessageSync`, `editMessage(text, messageID)`, `unsendMessage(messageID, cb?, threadID?)`, `setMessageReaction(emoji, messageID, cb?, threadID?)`, `sendTypingIndicator`, `markAsRead`, `shareContact`, `resolvePhotoUrl` |
 | threads | `getThreadInfo`, `getThreadList`, `getThreadHistory` |
 | users | `getUserInfo`, `getUID`, `getProfilePictureUrl` |
 | account | `getCurrentUserID`, `getAppState`, `getCookies`, `setOptions` |
@@ -140,7 +141,9 @@ All take `(threadID, source, options)` where `options = { filename, text }`.
 
 `getInbox()` returns `{ threads }`. `listen(callback, intervalMs)` polls and
 emits normalized `message` events; it returns a `stop()` function.
-`stopListening()` also stops polling.
+`stopListening()` also stops polling. The interval is raised to the client's
+`minPollIntervalMs` floor (set via the constructor options; default 15000 ms,
+minimum 2000 ms), so pass that option if you want a shorter cycle than 15 s.
 
 ### Event shape
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eryxenx/insta-chat",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "description": " Unofficial Instagram Chat API for Node.js | Build Instagram DM bots on personal accounts \u2014 send messages, media, voice notes, reactions, edit & unsend, listen for incoming chats. No browser at runtime",
   "main": "index.js",
   "types": "index.d.ts",
@@ -23,7 +23,7 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "test": "node test/smoke.js && node test/antiSuspension.test.js && node test/replyContent.test.js && node test/edit.test.js && node test/sendReply.test.js && node test/client.test.js && node test/relayError.test.js && node test/safetyWiring.test.js && node test/mediaOrder.test.js && node test/sessionSafety.test.js && node test/emptySend.test.js",
+    "test": "node test/smoke.js && node test/antiSuspension.test.js && node test/replyContent.test.js && node test/edit.test.js && node test/sendReply.test.js && node test/client.test.js && node test/relayError.test.js && node test/safetyWiring.test.js && node test/mediaOrder.test.js && node test/sessionSafety.test.js && node test/emptySend.test.js && node test/pollFloor.test.js && node test/unsend.test.js",
     "build": "node scripts/build.js"
   },
   "keywords": [

package/src/api/messaging/unsendMessage.js

@@ -5,12 +5,16 @@
  * Original author credit must be retained in all copies and derivatives.
  */
 
-// fca.unsendMessage(messageID) — the thread is resolved from the id.
+// fca.unsendMessage(messageID, callback, threadID) — the thread may be passed
+// explicitly; otherwise it is resolved from the id. A bot that only knows the
+// replied-to message id (it did not send that message in this process, e.g.
+// after a restart) cannot resolve the thread, so the explicit thread is what
+// makes /unsend work reliably.
 module.exports = function (client) {
-  return async function unsendMessage(messageID, callback) {
+  return async function unsendMessage(messageID, callback, threadID) {
     const cb = typeof callback === "function" ? callback : null;
     try {
-      const tid = client._resolveThread(messageID);
+      const tid = client._resolveThread(messageID, threadID);
       const ok = await client.api.unsendMessage(tid, String(messageID));
       if (cb) cb(null, ok);
       return ok;

package/src/api.js

@@ -48,7 +48,9 @@ class InstaAPI {
     this.typing = new TypingMethods(this.http);
     this.thread = new ThreadMethods(this.http);
     this.user = new UserMethods(this.http);
-    this.inbox = new InboxMethods(this.http, () => this.userID);
+    this.inbox = new InboxMethods(this.http, () => this.userID, {
+      minPollIntervalMs: options.minPollIntervalMs
+    });
     this.media = new MediaMethods(this.http, this.identity);
   }
 

package/src/app/InstaContext.js

@@ -29,7 +29,7 @@ class InstaContext {
   }
 
   unsend(messageID, callback) {
-    return this.client.unsendMessage(messageID, callback);
+    return this.client.unsendMessage(messageID, callback, this.threadID);
   }
 
   edit(text, messageID, callback) {

package/src/events/normalizeEvent.js

@@ -139,6 +139,12 @@ class EventNormalizer {
     // client must know which thread it belongs to.
     if (typeof this.client.rememberThread === "function") {
       this.client.rememberThread(event.messageID, threadID);
+      // Remember the replied-to message too: /unsend resolves its thread from
+      // that id, and the bot may be unssending a message it sent in an earlier
+      // process (so it is not in _msgThread otherwise).
+      if (event.messageReply && event.messageReply.messageID) {
+        this.client.rememberThread(event.messageReply.messageID, threadID);
+      }
     }
 
     return event;

package/src/methods/inbox.js

@@ -24,9 +24,14 @@ const INBOX_VARIABLES = {
 const SKIP_TYPES = new Set(["like", "action_log", "video_call_event", "reaction_log"]);
 
 class InboxMethods {
-  constructor(http, getUserID) {
+  constructor(http, getUserID, options = {}) {
     this.http = http;
     this.getUserID = getUserID;
+    // Lowest poll interval listen() will honour, in ms. Instagram has no DM
+    // push, so reply latency is bounded by one poll cycle. The 15000 default is
+    // the conservative safe floor for a personal account; operators on a
+    // residential/mobile proxy can lower it (e.g. 2000) for snappier replies.
+    this.minPollIntervalMs = Math.max(2000, Number(options.minPollIntervalMs) || 15000);
     this._seen = new Map();
     this._pollTimer = null;
     this._selfFbid = null;
@@ -309,7 +314,7 @@ class InboxMethods {
   }
 
   listen(callback, intervalMs = 20000) {
-    const MIN_INTERVAL_MS = 15000;
+    const MIN_INTERVAL_MS = this.minPollIntervalMs;
     const BASE_INTERVAL_MS = Math.max(Number(intervalMs) || 20000, MIN_INTERVAL_MS);
     const BACKOFF_START_MS = 30000;
     const BACKOFF_MAX_MS = 10 * 60 * 1000;