@eryxenx/insta-chat 2.0.5 → 2.0.6

package/CHANGELOG.md

@@ -4,6 +4,18 @@ 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.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)
 
@@ -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.6",
   "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",
     "build": "node scripts/build.js"
   },
   "keywords": [

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/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;