@lazyneoaz/metachat 6.0.2 → 6.0.4

package/dist/index.cjs

@@ -70169,6 +70169,7 @@ __export(utils_exports2, {
   getType: () => getType,
   getWebSocketHeaders: () => getWebSocketHeaders,
   hasAuthenticatedSession: () => hasAuthenticatedSession,
+  hasCometTokens: () => hasCometTokens,
   humanDelay: () => humanDelay,
   info: () => info,
   invalidateCometTokens: () => invalidateCometTokens,
@@ -85863,6 +85864,12 @@ function tokenPairFresh(state) {
     state.lsd && state.fb_dtsg && state.fetchedAt && Date.now() - state.fetchedAt < TOKEN_TTL_MS
   );
 }
+function applyCached(ctx, state) {
+  if (!state.lsd || !state.fb_dtsg) return;
+  ctx.lsd = state.lsd;
+  ctx.fb_dtsg = state.fb_dtsg;
+  ctx.jazoest = recomputeJazoest(state.fb_dtsg);
+}
 function htmlOf(res) {
   if (typeof res === "string") return res;
   if (res && typeof res.body === "string") return res.body;
@@ -85872,20 +85879,28 @@ function htmlOf(res) {
 async function ensureCometTokens(ctx, defaultFuncs, force = false) {
   const state = tokenState(ctx);
   if (!force && tokenPairFresh(state)) {
-    ctx.lsd = state.lsd;
-    ctx.fb_dtsg = state.fb_dtsg;
+    applyCached(ctx, state);
     return;
   }
   if (!force && state.failures > 0) {
     const backoff = Math.min(1e3 * Math.pow(2, state.failures), MAX_BACKOFF_MS);
     if (state.attemptedAt && Date.now() - state.attemptedAt < backoff) {
-      if (state.lsd && state.fb_dtsg) {
-        ctx.lsd = state.lsd;
-        ctx.fb_dtsg = state.fb_dtsg;
-      }
+      applyCached(ctx, state);
       return;
     }
   }
+  if (!state.inflight) {
+    state.inflight = scrapeTokens(ctx, defaultFuncs, state).finally(() => {
+      state.inflight = null;
+    });
+  }
+  try {
+    await state.inflight;
+  } catch {
+  }
+  applyCached(ctx, state);
+}
+async function scrapeTokens(ctx, defaultFuncs, state) {
   state.attemptedAt = Date.now();
   try {
     const res = await defaultFuncs.get("https://www.facebook.com/", ctx.jar);
@@ -85909,13 +85924,14 @@ async function ensureCometTokens(ctx, defaultFuncs, force = false) {
     if (spin.__rev) ctx.revision = spin.__rev;
     const asbd = extractAsbdId(html3);
     if (asbd) ctx.asbdId = asbd;
-    ctx.lsd = lsd;
-    ctx.fb_dtsg = dtsg;
-    ctx.jazoest = recomputeJazoest(dtsg);
   } catch {
     state.failures++;
   }
 }
+function hasCometTokens(ctx) {
+  const state = ctx.__cometTokens || {};
+  return Boolean(state.lsd && state.fb_dtsg);
+}
 function invalidateCometTokens(ctx) {
   const state = tokenState(ctx);
   state.lsd = void 0;
@@ -90173,10 +90189,11 @@ function collectTracks(payload) {
     if (Array.isArray(node.sub_items)) candidates.push(...node.sub_items);
     for (const candidate of candidates) {
       const track = unwrap2(candidate);
-      if (track && track.id && !seen.has(track.id)) {
-        seen.add(track.id);
-        tracks.push(track);
-      }
+      if (!track) continue;
+      const key = track.id || track.audioUrl;
+      if (!key || seen.has(key)) continue;
+      seen.add(key);
+      tracks.push(track);
     }
   }
   const pageInfo = container?.items?.page_info;
@@ -90188,10 +90205,24 @@ function collectTracks(payload) {
 }
 
 // src/deltas/apis/music/searchMusic.ts
+var MUSIC_CACHE_TTL_MS = 5 * 60 * 1e3;
 function nextRequestId(ctx) {
   ctx.__reqCounter = (typeof ctx.__reqCounter === "number" ? ctx.__reqCounter : 0) + 1;
   return ctx.__reqCounter.toString(36);
 }
+var MUSIC_MIN_INTERVAL_MS = 1100;
+async function paceMusic(ctx) {
+  const configured = Number(ctx?.globalOptions?.musicMinIntervalMs);
+  const min = Number.isFinite(configured) && configured >= 0 ? configured : MUSIC_MIN_INTERVAL_MS;
+  const last2 = typeof ctx.__musicLastCallAt === "number" ? ctx.__musicLastCallAt : 0;
+  const wait = last2 + min - Date.now();
+  if (wait > 0) await sleep(wait);
+  ctx.__musicLastCallAt = Date.now();
+}
+function cacheResult(ctx, key, result) {
+  const cache = ctx.__musicCache || (ctx.__musicCache = {});
+  cache[key] = { at: Date.now(), result };
+}
 function normalizeError(error2) {
   if (!error2 || typeof error2 !== "object") {
     const message2 = String(error2);
@@ -90213,6 +90244,13 @@ function normalizeError(error2) {
 }
 function searchMusic_default(defaultFuncs, _api, ctx) {
   async function runSearch(text3, count, selectedOptions, callback) {
+    const cacheKey = `${selectedOptions.product || PRODUCT}|${count}|${text3}|${selectedOptions.cursor || ""}`;
+    if (!selectedOptions.noCache) {
+      const cache = ctx.__musicCache || (ctx.__musicCache = {});
+      const hit = cache[cacheKey];
+      if (hit && Date.now() - hit.at < MUSIC_CACHE_TTL_MS) return hit.result;
+    }
+    await paceMusic(ctx);
     const params = { first: count };
     if (text3) params.search_text = text3;
     if (selectedOptions.cursor) params.after = String(selectedOptions.cursor);
@@ -90248,7 +90286,6 @@ function searchMusic_default(defaultFuncs, _api, ctx) {
     };
     let parsed = await attempt(false);
     if (isStaleTokenError(parsed)) {
-      invalidateCometTokens(ctx);
       parsed = await attempt(true);
     }
     if (!parsed) throw { error: "searchMusic returned empty object.", code: "BAD_RESPONSE" };
@@ -90286,12 +90323,12 @@ function searchMusic_default(defaultFuncs, _api, ctx) {
       result.endCursor = page.endCursor;
       result.hasNextPage = page.hasNextPage;
       result.query = text3;
+      cacheResult(ctx, cacheKey, result);
       return result;
     }
     for (let retry = 0; retry < 3; retry++) {
-      invalidateCometTokens(ctx);
-      await sleep(600 + retry * 900);
-      const retried = await attempt(true);
+      await sleep(1200 + retry * 1300 + Math.floor(Math.random() * 400));
+      const retried = await attempt(retry === 2 || !hasCometTokens(ctx));
       if (isStaleTokenError(retried) || retried?.error || (retried?.errors || []).length) continue;
       const retryPage = collectTracks(retried);
       const retryTracks = retryPage.tracks.slice(0, count);
@@ -90301,9 +90338,17 @@ function searchMusic_default(defaultFuncs, _api, ctx) {
         result.endCursor = retryPage.endCursor;
         result.hasNextPage = retryPage.hasNextPage;
         result.query = text3;
+        cacheResult(ctx, cacheKey, result);
         return result;
       }
     }
+    if (!hasCometTokens(ctx)) {
+      throw {
+        error: "Facebook did not return a music search document token. The session or network is unhealthy; retry shortly.",
+        code: "TOKEN_UNAVAILABLE",
+        query: text3
+      };
+    }
     throw {
       error: `No music results found for "${text3}". The Facebook music catalog may be unavailable for this account or region.`,
       code: "NO_RESULTS",
@@ -92047,7 +92092,7 @@ function getThreadHistory_default(defaultFuncs, api, ctx) {
 function formatEventReminders(reminder) {
   return {
     reminderID: reminder.id,
-    eventCreatorID: reminder.lightweight_event_creator.id,
+    eventCreatorID: reminder.lightweight_event_creator?.id,
     time: reminder.time,
     eventType: String(reminder.lightweight_event_type || "").toLowerCase(),
     locationName: reminder.location_name,
@@ -92083,21 +92128,21 @@ function formatThreadGraphQLResponse(data2) {
   return {
     threadID,
     threadName: messageThread.name,
-    participantIDs: messageThread.all_participants.edges.map(
-      (d) => d.node.messaging_actor.id
+    participantIDs: (messageThread.all_participants?.edges || []).map(
+      (d) => d?.node?.messaging_actor?.id
     ),
-    userInfo: messageThread.all_participants.edges.map((d) => ({
-      id: d.node.messaging_actor.id,
-      name: d.node.messaging_actor.name,
-      firstName: d.node.messaging_actor.short_name,
-      vanity: d.node.messaging_actor.username,
-      url: d.node.messaging_actor.url,
-      thumbSrc: d.node.messaging_actor.big_image_src.uri,
-      profileUrl: d.node.messaging_actor.big_image_src.uri,
-      gender: d.node.messaging_actor.gender,
-      type: d.node.messaging_actor.__typename,
-      isFriend: d.node.messaging_actor.is_viewer_friend,
-      isBirthday: !!d.node.messaging_actor.is_birthday
+    userInfo: (messageThread.all_participants?.edges || []).map((d) => ({
+      id: d?.node?.messaging_actor?.id,
+      name: d?.node?.messaging_actor?.name,
+      firstName: d?.node?.messaging_actor?.short_name,
+      vanity: d?.node?.messaging_actor?.username,
+      url: d?.node?.messaging_actor?.url,
+      thumbSrc: d?.node?.messaging_actor?.big_image_src?.uri,
+      profileUrl: d?.node?.messaging_actor?.big_image_src?.uri,
+      gender: d?.node?.messaging_actor?.gender,
+      type: d?.node?.messaging_actor?.__typename,
+      isFriend: d?.node?.messaging_actor?.is_viewer_friend,
+      isBirthday: !!d?.node?.messaging_actor?.is_birthday
     })),
     unreadCount: messageThread.unread_count,
     messageCount: messageThread.messages_count,
@@ -92108,7 +92153,7 @@ function formatThreadGraphQLResponse(data2) {
     isArchived: messageThread.has_viewer_archived,
     folder: messageThread.folder,
     cannotReplyReason: messageThread.cannot_reply_reason,
-    eventReminders: messageThread.event_reminders ? messageThread.event_reminders.nodes.map(formatEventReminders) : null,
+    eventReminders: messageThread.event_reminders ? (messageThread.event_reminders.nodes || []).map(formatEventReminders) : null,
     emoji: messageThread.customization_info ? messageThread.customization_info.emoji : null,
     color: messageThread.customization_info && messageThread.customization_info.outgoing_bubble_color ? messageThread.customization_info.outgoing_bubble_color.slice(2) : null,
     threadTheme: messageThread.thread_theme,
@@ -92154,7 +92199,8 @@ function formatThreadGraphQLResponse(data2) {
   };
 }
 function getThreadInfo_default(defaultFuncs, api, ctx) {
-  return async function getThreadInfo(threadID) {
+  return async function getThreadInfo(threadID, callback = void 0) {
+    const cb = typeof callback === "function" ? callback : void 0;
     const threadIDs = Array.isArray(threadID) ? threadID : [threadID];
     let form = {};
     threadIDs.forEach((t, i2) => {
@@ -92205,9 +92251,23 @@ function getThreadInfo_default(defaultFuncs, api, ctx) {
       if (matched === 0) {
         throw new Error("getThreadInfo: malformed response from GraphQL.");
       }
-      return Array.isArray(threadID) ? threadInfos : Object.values(threadInfos)[0] || null;
+      const out = Array.isArray(threadID) ? threadInfos : Object.values(threadInfos)[0] || null;
+      if (cb) {
+        try {
+          cb(null, out);
+        } catch (_) {
+        }
+      }
+      return out;
     } catch (err) {
       error("getThreadInfo", err);
+      if (cb) {
+        try {
+          cb(err);
+        } catch (_) {
+        }
+        return void 0;
+      }
       throw err;
     }
   };
@@ -92217,7 +92277,7 @@ function getThreadInfo_default(defaultFuncs, api, ctx) {
 function formatEventReminders2(reminder) {
   return {
     reminderID: reminder.id,
-    eventCreatorID: reminder.lightweight_event_creator.id,
+    eventCreatorID: reminder.lightweight_event_creator?.id,
     time: reminder.time,
     eventType: String(reminder.lightweight_event_type || "").toLowerCase(),
     locationName: reminder.location_name,
@@ -92231,7 +92291,7 @@ function formatEventReminders2(reminder) {
     secondsToNotifyBefore: reminder.seconds_to_notify_before,
     allowsRsvp: reminder.allows_rsvp,
     relatedEvent: reminder.related_event,
-    members: reminder.event_reminder_members.edges.map(function(member) {
+    members: (reminder.event_reminder_members?.edges || []).map(function(member) {
       return {
         memberID: member.node.id,
         state: String(member.guest_list_state || "").toLowerCase()
@@ -92250,21 +92310,21 @@ function formatThreadGraphQLResponse2(messageThread) {
   return {
     threadID,
     threadName: messageThread.name,
-    participantIDs: messageThread.all_participants.edges.map(
-      (d) => d.node.messaging_actor.id
+    participantIDs: (messageThread.all_participants?.edges || []).map(
+      (d) => d?.node?.messaging_actor?.id
     ),
-    userInfo: messageThread.all_participants.edges.map((d) => ({
-      id: d.node.messaging_actor.id,
-      name: d.node.messaging_actor.name,
-      firstName: d.node.messaging_actor.short_name,
-      vanity: d.node.messaging_actor.username,
-      url: d.node.messaging_actor.url,
-      thumbSrc: d.node.messaging_actor.big_image_src.uri,
-      profileUrl: d.node.messaging_actor.big_image_src.uri,
-      gender: d.node.messaging_actor.gender,
-      type: d.node.messaging_actor.__typename,
-      isFriend: d.node.messaging_actor.is_viewer_friend,
-      isBirthday: !!d.node.messaging_actor.is_birthday
+    userInfo: (messageThread.all_participants?.edges || []).map((d) => ({
+      id: d?.node?.messaging_actor?.id,
+      name: d?.node?.messaging_actor?.name,
+      firstName: d?.node?.messaging_actor?.short_name,
+      vanity: d?.node?.messaging_actor?.username,
+      url: d?.node?.messaging_actor?.url,
+      thumbSrc: d?.node?.messaging_actor?.big_image_src?.uri,
+      profileUrl: d?.node?.messaging_actor?.big_image_src?.uri,
+      gender: d?.node?.messaging_actor?.gender,
+      type: d?.node?.messaging_actor?.__typename,
+      isFriend: d?.node?.messaging_actor?.is_viewer_friend,
+      isBirthday: !!d?.node?.messaging_actor?.is_birthday
     })),
     unreadCount: messageThread.unread_count,
     messageCount: messageThread.messages_count,
@@ -92275,7 +92335,7 @@ function formatThreadGraphQLResponse2(messageThread) {
     isArchived: messageThread.has_viewer_archived,
     folder: messageThread.folder,
     cannotReplyReason: messageThread.cannot_reply_reason,
-    eventReminders: messageThread.event_reminders ? messageThread.event_reminders.nodes.map(formatEventReminders2) : null,
+    eventReminders: messageThread.event_reminders ? (messageThread.event_reminders.nodes || []).map(formatEventReminders2) : null,
     emoji: messageThread.customization_info ? messageThread.customization_info.emoji : null,
     color: messageThread.customization_info && messageThread.customization_info.outgoing_bubble_color ? messageThread.customization_info.outgoing_bubble_color.slice(2) : null,
     threadTheme: messageThread.thread_theme,
@@ -92321,18 +92381,29 @@ function formatThreadGraphQLResponse2(messageThread) {
   };
 }
 function getThreadList_default(defaultFuncs, api, ctx) {
-  return async function getThreadList(limit, timestamp = null, tags = ["INBOX"]) {
+  return async function getThreadList(limit, timestamp = null, tags = ["INBOX"], callback = void 0) {
+    const cb = typeof callback === "function" ? callback : void 0;
+    const fail = (err) => {
+      if (cb) {
+        try {
+          cb(err);
+        } catch (_) {
+        }
+        return void 0;
+      }
+      throw err;
+    };
     if (getType(limit) !== "Number" || !Number.isInteger(limit) || limit <= 0) {
-      throw new Error("getThreadList: limit must be a positive integer.");
+      return fail(new Error("getThreadList: limit must be a positive integer."));
     }
     if (getType(timestamp) !== "Null" && (getType(timestamp) !== "Number" || !Number.isInteger(timestamp))) {
-      throw new Error("getThreadList: timestamp must be an integer or null.");
+      return fail(new Error("getThreadList: timestamp must be an integer or null."));
     }
     if (getType(tags) === "String") {
       tags = [tags];
     }
     if (getType(tags) !== "Array") {
-      throw new Error("getThreadList: tags must be an array.");
+      return fail(new Error("getThreadList: tags must be an array."));
     }
     const form = {
       av: ctx.i_userID || ctx.userID,
@@ -92366,10 +92437,17 @@ function getThreadList_default(defaultFuncs, api, ctx) {
       if (timestamp !== null && timestamp !== void 0) {
         nodes.shift();
       }
-      return nodes.map(formatThreadGraphQLResponse2).filter(Boolean);
+      const list = nodes.map(formatThreadGraphQLResponse2).filter(Boolean);
+      if (cb) {
+        try {
+          cb(null, list);
+        } catch (_) {
+        }
+      }
+      return list;
     } catch (err) {
       error("getThreadList", err);
-      throw err;
+      return fail(err);
     }
   };
 }

package/dist/index.mjs

@@ -70137,6 +70137,7 @@ __export(utils_exports2, {
   getType: () => getType,
   getWebSocketHeaders: () => getWebSocketHeaders,
   hasAuthenticatedSession: () => hasAuthenticatedSession,
+  hasCometTokens: () => hasCometTokens,
   humanDelay: () => humanDelay,
   info: () => info,
   invalidateCometTokens: () => invalidateCometTokens,
@@ -85831,6 +85832,12 @@ function tokenPairFresh(state) {
     state.lsd && state.fb_dtsg && state.fetchedAt && Date.now() - state.fetchedAt < TOKEN_TTL_MS
   );
 }
+function applyCached(ctx, state) {
+  if (!state.lsd || !state.fb_dtsg) return;
+  ctx.lsd = state.lsd;
+  ctx.fb_dtsg = state.fb_dtsg;
+  ctx.jazoest = recomputeJazoest(state.fb_dtsg);
+}
 function htmlOf(res) {
   if (typeof res === "string") return res;
   if (res && typeof res.body === "string") return res.body;
@@ -85840,20 +85847,28 @@ function htmlOf(res) {
 async function ensureCometTokens(ctx, defaultFuncs, force = false) {
   const state = tokenState(ctx);
   if (!force && tokenPairFresh(state)) {
-    ctx.lsd = state.lsd;
-    ctx.fb_dtsg = state.fb_dtsg;
+    applyCached(ctx, state);
     return;
   }
   if (!force && state.failures > 0) {
     const backoff = Math.min(1e3 * Math.pow(2, state.failures), MAX_BACKOFF_MS);
     if (state.attemptedAt && Date.now() - state.attemptedAt < backoff) {
-      if (state.lsd && state.fb_dtsg) {
-        ctx.lsd = state.lsd;
-        ctx.fb_dtsg = state.fb_dtsg;
-      }
+      applyCached(ctx, state);
       return;
     }
   }
+  if (!state.inflight) {
+    state.inflight = scrapeTokens(ctx, defaultFuncs, state).finally(() => {
+      state.inflight = null;
+    });
+  }
+  try {
+    await state.inflight;
+  } catch {
+  }
+  applyCached(ctx, state);
+}
+async function scrapeTokens(ctx, defaultFuncs, state) {
   state.attemptedAt = Date.now();
   try {
     const res = await defaultFuncs.get("https://www.facebook.com/", ctx.jar);
@@ -85877,13 +85892,14 @@ async function ensureCometTokens(ctx, defaultFuncs, force = false) {
     if (spin.__rev) ctx.revision = spin.__rev;
     const asbd = extractAsbdId(html3);
     if (asbd) ctx.asbdId = asbd;
-    ctx.lsd = lsd;
-    ctx.fb_dtsg = dtsg;
-    ctx.jazoest = recomputeJazoest(dtsg);
   } catch {
     state.failures++;
   }
 }
+function hasCometTokens(ctx) {
+  const state = ctx.__cometTokens || {};
+  return Boolean(state.lsd && state.fb_dtsg);
+}
 function invalidateCometTokens(ctx) {
   const state = tokenState(ctx);
   state.lsd = void 0;
@@ -90141,10 +90157,11 @@ function collectTracks(payload) {
     if (Array.isArray(node.sub_items)) candidates.push(...node.sub_items);
     for (const candidate of candidates) {
       const track = unwrap2(candidate);
-      if (track && track.id && !seen.has(track.id)) {
-        seen.add(track.id);
-        tracks.push(track);
-      }
+      if (!track) continue;
+      const key = track.id || track.audioUrl;
+      if (!key || seen.has(key)) continue;
+      seen.add(key);
+      tracks.push(track);
     }
   }
   const pageInfo = container?.items?.page_info;
@@ -90156,10 +90173,24 @@ function collectTracks(payload) {
 }
 
 // src/deltas/apis/music/searchMusic.ts
+var MUSIC_CACHE_TTL_MS = 5 * 60 * 1e3;
 function nextRequestId(ctx) {
   ctx.__reqCounter = (typeof ctx.__reqCounter === "number" ? ctx.__reqCounter : 0) + 1;
   return ctx.__reqCounter.toString(36);
 }
+var MUSIC_MIN_INTERVAL_MS = 1100;
+async function paceMusic(ctx) {
+  const configured = Number(ctx?.globalOptions?.musicMinIntervalMs);
+  const min = Number.isFinite(configured) && configured >= 0 ? configured : MUSIC_MIN_INTERVAL_MS;
+  const last2 = typeof ctx.__musicLastCallAt === "number" ? ctx.__musicLastCallAt : 0;
+  const wait = last2 + min - Date.now();
+  if (wait > 0) await sleep(wait);
+  ctx.__musicLastCallAt = Date.now();
+}
+function cacheResult(ctx, key, result) {
+  const cache = ctx.__musicCache || (ctx.__musicCache = {});
+  cache[key] = { at: Date.now(), result };
+}
 function normalizeError(error2) {
   if (!error2 || typeof error2 !== "object") {
     const message2 = String(error2);
@@ -90181,6 +90212,13 @@ function normalizeError(error2) {
 }
 function searchMusic_default(defaultFuncs, _api, ctx) {
   async function runSearch(text3, count, selectedOptions, callback) {
+    const cacheKey = `${selectedOptions.product || PRODUCT}|${count}|${text3}|${selectedOptions.cursor || ""}`;
+    if (!selectedOptions.noCache) {
+      const cache = ctx.__musicCache || (ctx.__musicCache = {});
+      const hit = cache[cacheKey];
+      if (hit && Date.now() - hit.at < MUSIC_CACHE_TTL_MS) return hit.result;
+    }
+    await paceMusic(ctx);
     const params = { first: count };
     if (text3) params.search_text = text3;
     if (selectedOptions.cursor) params.after = String(selectedOptions.cursor);
@@ -90216,7 +90254,6 @@ function searchMusic_default(defaultFuncs, _api, ctx) {
     };
     let parsed = await attempt(false);
     if (isStaleTokenError(parsed)) {
-      invalidateCometTokens(ctx);
       parsed = await attempt(true);
     }
     if (!parsed) throw { error: "searchMusic returned empty object.", code: "BAD_RESPONSE" };
@@ -90254,12 +90291,12 @@ function searchMusic_default(defaultFuncs, _api, ctx) {
       result.endCursor = page.endCursor;
       result.hasNextPage = page.hasNextPage;
       result.query = text3;
+      cacheResult(ctx, cacheKey, result);
       return result;
     }
     for (let retry = 0; retry < 3; retry++) {
-      invalidateCometTokens(ctx);
-      await sleep(600 + retry * 900);
-      const retried = await attempt(true);
+      await sleep(1200 + retry * 1300 + Math.floor(Math.random() * 400));
+      const retried = await attempt(retry === 2 || !hasCometTokens(ctx));
       if (isStaleTokenError(retried) || retried?.error || (retried?.errors || []).length) continue;
       const retryPage = collectTracks(retried);
       const retryTracks = retryPage.tracks.slice(0, count);
@@ -90269,9 +90306,17 @@ function searchMusic_default(defaultFuncs, _api, ctx) {
         result.endCursor = retryPage.endCursor;
         result.hasNextPage = retryPage.hasNextPage;
         result.query = text3;
+        cacheResult(ctx, cacheKey, result);
         return result;
       }
     }
+    if (!hasCometTokens(ctx)) {
+      throw {
+        error: "Facebook did not return a music search document token. The session or network is unhealthy; retry shortly.",
+        code: "TOKEN_UNAVAILABLE",
+        query: text3
+      };
+    }
     throw {
       error: `No music results found for "${text3}". The Facebook music catalog may be unavailable for this account or region.`,
       code: "NO_RESULTS",
@@ -92015,7 +92060,7 @@ function getThreadHistory_default(defaultFuncs, api, ctx) {
 function formatEventReminders(reminder) {
   return {
     reminderID: reminder.id,
-    eventCreatorID: reminder.lightweight_event_creator.id,
+    eventCreatorID: reminder.lightweight_event_creator?.id,
     time: reminder.time,
     eventType: String(reminder.lightweight_event_type || "").toLowerCase(),
     locationName: reminder.location_name,
@@ -92051,21 +92096,21 @@ function formatThreadGraphQLResponse(data2) {
   return {
     threadID,
     threadName: messageThread.name,
-    participantIDs: messageThread.all_participants.edges.map(
-      (d) => d.node.messaging_actor.id
+    participantIDs: (messageThread.all_participants?.edges || []).map(
+      (d) => d?.node?.messaging_actor?.id
     ),
-    userInfo: messageThread.all_participants.edges.map((d) => ({
-      id: d.node.messaging_actor.id,
-      name: d.node.messaging_actor.name,
-      firstName: d.node.messaging_actor.short_name,
-      vanity: d.node.messaging_actor.username,
-      url: d.node.messaging_actor.url,
-      thumbSrc: d.node.messaging_actor.big_image_src.uri,
-      profileUrl: d.node.messaging_actor.big_image_src.uri,
-      gender: d.node.messaging_actor.gender,
-      type: d.node.messaging_actor.__typename,
-      isFriend: d.node.messaging_actor.is_viewer_friend,
-      isBirthday: !!d.node.messaging_actor.is_birthday
+    userInfo: (messageThread.all_participants?.edges || []).map((d) => ({
+      id: d?.node?.messaging_actor?.id,
+      name: d?.node?.messaging_actor?.name,
+      firstName: d?.node?.messaging_actor?.short_name,
+      vanity: d?.node?.messaging_actor?.username,
+      url: d?.node?.messaging_actor?.url,
+      thumbSrc: d?.node?.messaging_actor?.big_image_src?.uri,
+      profileUrl: d?.node?.messaging_actor?.big_image_src?.uri,
+      gender: d?.node?.messaging_actor?.gender,
+      type: d?.node?.messaging_actor?.__typename,
+      isFriend: d?.node?.messaging_actor?.is_viewer_friend,
+      isBirthday: !!d?.node?.messaging_actor?.is_birthday
     })),
     unreadCount: messageThread.unread_count,
     messageCount: messageThread.messages_count,
@@ -92076,7 +92121,7 @@ function formatThreadGraphQLResponse(data2) {
     isArchived: messageThread.has_viewer_archived,
     folder: messageThread.folder,
     cannotReplyReason: messageThread.cannot_reply_reason,
-    eventReminders: messageThread.event_reminders ? messageThread.event_reminders.nodes.map(formatEventReminders) : null,
+    eventReminders: messageThread.event_reminders ? (messageThread.event_reminders.nodes || []).map(formatEventReminders) : null,
     emoji: messageThread.customization_info ? messageThread.customization_info.emoji : null,
     color: messageThread.customization_info && messageThread.customization_info.outgoing_bubble_color ? messageThread.customization_info.outgoing_bubble_color.slice(2) : null,
     threadTheme: messageThread.thread_theme,
@@ -92122,7 +92167,8 @@ function formatThreadGraphQLResponse(data2) {
   };
 }
 function getThreadInfo_default(defaultFuncs, api, ctx) {
-  return async function getThreadInfo(threadID) {
+  return async function getThreadInfo(threadID, callback = void 0) {
+    const cb = typeof callback === "function" ? callback : void 0;
     const threadIDs = Array.isArray(threadID) ? threadID : [threadID];
     let form = {};
     threadIDs.forEach((t, i2) => {
@@ -92173,9 +92219,23 @@ function getThreadInfo_default(defaultFuncs, api, ctx) {
       if (matched === 0) {
         throw new Error("getThreadInfo: malformed response from GraphQL.");
       }
-      return Array.isArray(threadID) ? threadInfos : Object.values(threadInfos)[0] || null;
+      const out = Array.isArray(threadID) ? threadInfos : Object.values(threadInfos)[0] || null;
+      if (cb) {
+        try {
+          cb(null, out);
+        } catch (_) {
+        }
+      }
+      return out;
     } catch (err) {
       error("getThreadInfo", err);
+      if (cb) {
+        try {
+          cb(err);
+        } catch (_) {
+        }
+        return void 0;
+      }
       throw err;
     }
   };
@@ -92185,7 +92245,7 @@ function getThreadInfo_default(defaultFuncs, api, ctx) {
 function formatEventReminders2(reminder) {
   return {
     reminderID: reminder.id,
-    eventCreatorID: reminder.lightweight_event_creator.id,
+    eventCreatorID: reminder.lightweight_event_creator?.id,
     time: reminder.time,
     eventType: String(reminder.lightweight_event_type || "").toLowerCase(),
     locationName: reminder.location_name,
@@ -92199,7 +92259,7 @@ function formatEventReminders2(reminder) {
     secondsToNotifyBefore: reminder.seconds_to_notify_before,
     allowsRsvp: reminder.allows_rsvp,
     relatedEvent: reminder.related_event,
-    members: reminder.event_reminder_members.edges.map(function(member) {
+    members: (reminder.event_reminder_members?.edges || []).map(function(member) {
       return {
         memberID: member.node.id,
         state: String(member.guest_list_state || "").toLowerCase()
@@ -92218,21 +92278,21 @@ function formatThreadGraphQLResponse2(messageThread) {
   return {
     threadID,
     threadName: messageThread.name,
-    participantIDs: messageThread.all_participants.edges.map(
-      (d) => d.node.messaging_actor.id
+    participantIDs: (messageThread.all_participants?.edges || []).map(
+      (d) => d?.node?.messaging_actor?.id
     ),
-    userInfo: messageThread.all_participants.edges.map((d) => ({
-      id: d.node.messaging_actor.id,
-      name: d.node.messaging_actor.name,
-      firstName: d.node.messaging_actor.short_name,
-      vanity: d.node.messaging_actor.username,
-      url: d.node.messaging_actor.url,
-      thumbSrc: d.node.messaging_actor.big_image_src.uri,
-      profileUrl: d.node.messaging_actor.big_image_src.uri,
-      gender: d.node.messaging_actor.gender,
-      type: d.node.messaging_actor.__typename,
-      isFriend: d.node.messaging_actor.is_viewer_friend,
-      isBirthday: !!d.node.messaging_actor.is_birthday
+    userInfo: (messageThread.all_participants?.edges || []).map((d) => ({
+      id: d?.node?.messaging_actor?.id,
+      name: d?.node?.messaging_actor?.name,
+      firstName: d?.node?.messaging_actor?.short_name,
+      vanity: d?.node?.messaging_actor?.username,
+      url: d?.node?.messaging_actor?.url,
+      thumbSrc: d?.node?.messaging_actor?.big_image_src?.uri,
+      profileUrl: d?.node?.messaging_actor?.big_image_src?.uri,
+      gender: d?.node?.messaging_actor?.gender,
+      type: d?.node?.messaging_actor?.__typename,
+      isFriend: d?.node?.messaging_actor?.is_viewer_friend,
+      isBirthday: !!d?.node?.messaging_actor?.is_birthday
     })),
     unreadCount: messageThread.unread_count,
     messageCount: messageThread.messages_count,
@@ -92243,7 +92303,7 @@ function formatThreadGraphQLResponse2(messageThread) {
     isArchived: messageThread.has_viewer_archived,
     folder: messageThread.folder,
     cannotReplyReason: messageThread.cannot_reply_reason,
-    eventReminders: messageThread.event_reminders ? messageThread.event_reminders.nodes.map(formatEventReminders2) : null,
+    eventReminders: messageThread.event_reminders ? (messageThread.event_reminders.nodes || []).map(formatEventReminders2) : null,
     emoji: messageThread.customization_info ? messageThread.customization_info.emoji : null,
     color: messageThread.customization_info && messageThread.customization_info.outgoing_bubble_color ? messageThread.customization_info.outgoing_bubble_color.slice(2) : null,
     threadTheme: messageThread.thread_theme,
@@ -92289,18 +92349,29 @@ function formatThreadGraphQLResponse2(messageThread) {
   };
 }
 function getThreadList_default(defaultFuncs, api, ctx) {
-  return async function getThreadList(limit, timestamp = null, tags = ["INBOX"]) {
+  return async function getThreadList(limit, timestamp = null, tags = ["INBOX"], callback = void 0) {
+    const cb = typeof callback === "function" ? callback : void 0;
+    const fail = (err) => {
+      if (cb) {
+        try {
+          cb(err);
+        } catch (_) {
+        }
+        return void 0;
+      }
+      throw err;
+    };
     if (getType(limit) !== "Number" || !Number.isInteger(limit) || limit <= 0) {
-      throw new Error("getThreadList: limit must be a positive integer.");
+      return fail(new Error("getThreadList: limit must be a positive integer."));
     }
     if (getType(timestamp) !== "Null" && (getType(timestamp) !== "Number" || !Number.isInteger(timestamp))) {
-      throw new Error("getThreadList: timestamp must be an integer or null.");
+      return fail(new Error("getThreadList: timestamp must be an integer or null."));
     }
     if (getType(tags) === "String") {
       tags = [tags];
     }
     if (getType(tags) !== "Array") {
-      throw new Error("getThreadList: tags must be an array.");
+      return fail(new Error("getThreadList: tags must be an array."));
     }
     const form = {
       av: ctx.i_userID || ctx.userID,
@@ -92334,10 +92405,17 @@ function getThreadList_default(defaultFuncs, api, ctx) {
       if (timestamp !== null && timestamp !== void 0) {
         nodes.shift();
       }
-      return nodes.map(formatThreadGraphQLResponse2).filter(Boolean);
+      const list = nodes.map(formatThreadGraphQLResponse2).filter(Boolean);
+      if (cb) {
+        try {
+          cb(null, list);
+        } catch (_) {
+        }
+      }
+      return list;
     } catch (err) {
       error("getThreadList", err);
-      throw err;
+      return fail(err);
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lazyneoaz/metachat",
-  "version": "6.0.2",
+  "version": "6.0.4",
   "description": "A modern TypeScript Facebook Chat API client for building reliable Messenger bots, with built-in anti-detection protection, automatic cookie refresh, music search, and AI theme support.",
   "license": "MIT",
   "author": {
@@ -57,7 +57,7 @@
     "prepublishOnly": "npm run build",
     "lint": "npm run typecheck",
     "format": "prettier --write \"src/**/*.ts\" \"index.ts\"",
-    "test": "npm run build && node test/smoke.test.cjs && node test/smoke.test.mjs && node test/music-search.test.cjs && node test/mqtt-lifecycle.test.cjs && node test/session-reliability.test.cjs && node test/anti-detection.test.cjs && node test/account-safety.test.cjs && node test/liveness.test.cjs && node test/recovery.test.cjs && node test/cookie-acquisition.test.cjs && node test/realtime-health.test.cjs && node test/attachment-resilience.test.cjs && node test/reaction-validation.test.cjs && node test/api-surface-fixes.test.cjs && node test/threadinfo-regression.test.cjs && node test/new-modules.test.cjs && node test/mention-parsing.test.cjs",
+    "test": "npm run build && node test/smoke.test.cjs && node test/smoke.test.mjs && node test/music-search.test.cjs && node test/mqtt-lifecycle.test.cjs && node test/session-reliability.test.cjs && node test/anti-detection.test.cjs && node test/account-safety.test.cjs && node test/liveness.test.cjs && node test/recovery.test.cjs && node test/cookie-acquisition.test.cjs && node test/realtime-health.test.cjs && node test/attachment-resilience.test.cjs && node test/reaction-validation.test.cjs && node test/api-surface-fixes.test.cjs && node test/threadinfo-regression.test.cjs && node test/new-modules.test.cjs && node test/mention-parsing.test.cjs && node test/pending-support.test.cjs && node test/music-token-resilience.test.cjs",
     "audit": "npm audit",
     "audit:fix": "npm audit fix"
   },