@dongdev/fca-unofficial 4.0.1 → 4.0.3

package/README.md

@@ -268,7 +268,9 @@ When `stopOnSignals` is `true`, the bot automatically calls `stop()` on `SIGINT`
 
 ## Configuration
 
-Copy the example config and edit it:
+If `fca-config.json` is missing in the process working directory, it is **created automatically** with defaults on first load (or in-memory defaults only if the file cannot be written).
+
+You can also copy the example and edit it:
 
 ```bash
 cp fca-config.example.json fca-config.json

package/dist/index.d.mts

@@ -313,6 +313,13 @@ interface FcaConfig {
         token: string;
         autoReconnect: boolean;
     };
+    /** SQLite thread row cache used by `getThreadInfo`. */
+    threadCache: {
+        /** Treat DB row as fresh for this many ms (default 15 minutes). */
+        maxAgeMs: number;
+        /** Clear `data` for all threads on this interval so the next `getThreadInfo` refetches; 0 = off. */
+        invalidateIntervalMs: number;
+    };
     [key: string]: Loose;
 }
 interface LoadedFcaConfig {

package/dist/index.d.ts

@@ -313,6 +313,13 @@ interface FcaConfig {
         token: string;
         autoReconnect: boolean;
     };
+    /** SQLite thread row cache used by `getThreadInfo`. */
+    threadCache: {
+        /** Treat DB row as fresh for this many ms (default 15 minutes). */
+        maxAgeMs: number;
+        /** Clear `data` for all threads on this interval so the next `getThreadInfo` refetches; 0 = off. */
+        invalidateIntervalMs: number;
+    };
     [key: string]: Loose;
 }
 interface LoadedFcaConfig {

package/dist/index.js

@@ -65,8 +65,7 @@ function makeStyles(theme) {
       info: (v) => import_picocolors.default.cyan(v),
       warn: (v) => import_picocolors.default.yellow(v),
       error: (v) => import_picocolors.default.red(v),
-      sys: (v) => import_picocolors.default.blue(v),
-      banner: (v) => import_picocolors.default.white(v)
+      sys: (v) => import_picocolors.default.blue(v)
     };
   }
   return {
@@ -75,8 +74,7 @@ function makeStyles(theme) {
     info: (v) => import_picocolors.default.cyan(v),
     warn: (v) => import_picocolors.default.yellow(v),
     error: (v) => import_picocolors.default.red(v),
-    sys: (v) => import_picocolors.default.blue(v),
-    banner: (v) => import_picocolors.default.cyan(v)
+    sys: (v) => import_picocolors.default.blue(v)
   };
 }
 function parseLabel(message, fallback) {
@@ -109,22 +107,7 @@ function formatSuccessBody(body, grad, fallbackPaint) {
   }
   return fallbackPaint(body);
 }
-function donixAsciiBlock() {
-  return [
-    "____ ____ ____ ____ ____",
-    "||D ||||O ||||N ||||I ||||X ||",
-    "||__||||__||||__||||__||||__||",
-    "|/__\\||/__\\||/__\\||/__\\||/__\\|"
-  ].join("\n");
-}
 async function ensureUiLibs() {
-  if (!boxenLib) {
-    try {
-      const boxenMod = await import("boxen");
-      boxenLib = boxenMod.default ?? boxenMod;
-    } catch {
-    }
-  }
   if (!oraFactory) {
     try {
       const oraMod = await import("ora");
@@ -141,51 +124,6 @@ async function ensureUiLibs() {
     }
   }
 }
-function printBootBanner(styles) {
-  if (didPrintBootBanner) return;
-  didPrintBootBanner = true;
-  const version = process.env.npm_package_version || "4.0.1";
-  const theme = getTheme();
-  const grad = theme === "cyberpunk" ? loadGradientFns() : null;
-  if (theme === "cyberpunk" && grad && boxenLib) {
-    const asciiStyled = grad.cyberpunk(donixAsciiBlock());
-    const titleLine = `${import_picocolors.default.bold(grad.coolStatus("FCA-UNOFFICIAL"))} ${import_picocolors.default.dim(`v${version}`)}`;
-    const body2 = `${asciiStyled}
-${titleLine}
-${styles.text("Author:")} ${grad.coolStatus("DongDev (Donix-VN)")}
-${styles.text("Status:")} ${import_picocolors.default.green("Ready to Connect")}`;
-    writeStdout(
-      boxenLib(body2, {
-        padding: 1,
-        margin: 0,
-        borderStyle: "double",
-        borderColor: "cyan"
-      })
-    );
-    return;
-  }
-  const art = [
-    "\u2554\u2566\u2557\u2554\u2550\u2557\u2554\u2557\u2554\u2566\u2550\u2557\u2566 \u2566",
-    " \u2551\u2551\u2551 \u2551\u2551\u2551\u2551\u2560\u2566\u255D\u255A\u2566\u255D",
-    "\u2550\u2569\u255D\u255A\u2550\u255D\u255D\u255A\u255D\u2569\u255A\u2550 \u2569  DONIX"
-  ].join("\n");
-  const body = `${import_picocolors.default.bold(styles.info("FCA-UNOFFICIAL"))} ${import_picocolors.default.dim(`v${version}`)}
-${styles.text("Author:")} ${styles.info("DongDev (Donix-VN)")}
-${styles.text("Status:")} ${import_picocolors.default.green("Ready to Connect")}
-${styles.banner(art)}`;
-  if (boxenLib) {
-    writeStdout(
-      boxenLib(body, {
-        padding: 1,
-        margin: 0,
-        borderStyle: "round",
-        borderColor: "cyan"
-      })
-    );
-    return;
-  }
-  writeStdout(styles.banner(body));
-}
 function logLine(text, type) {
   const level = String(type || "info").toLowerCase();
   const message = String(text ?? "");
@@ -222,14 +160,12 @@ function logLine(text, type) {
   const bodyOut = grad ? grad.coolStatus(parts.body) : styles.info(parts.body);
   writeStdout(`${ts} ${labelOut} : ${bodyOut}`);
 }
-var import_picocolors, import_gradient_string, didPrintBootBanner, boxenLib, oraFactory, progressCtor, progressPreset, gradientFns, baseLogger, logger_default;
+var import_picocolors, import_gradient_string, oraFactory, progressCtor, progressPreset, gradientFns, baseLogger, logger_default;
 var init_logger = __esm({
   "src/func/logger.ts"() {
     "use strict";
     import_picocolors = __toESM(require("picocolors"));
     import_gradient_string = __toESM(require("gradient-string"));
-    didPrintBootBanner = false;
-    boxenLib = null;
     oraFactory = null;
     progressCtor = null;
     progressPreset = null;
@@ -240,8 +176,6 @@ var init_logger = __esm({
     baseLogger.warn = (text) => baseLogger(text, "warn");
     baseLogger.error = (text) => baseLogger(text, "error");
     baseLogger.showBanner = async () => {
-      await ensureUiLibs();
-      printBootBanner(makeStyles(getTheme()));
     };
     baseLogger.startSpinner = async (text) => {
       await ensureUiLibs();
@@ -1530,7 +1464,7 @@ function attachThreadUpdater(ctx, models2, logger) {
             await Thread2.create({
               threadID: id,
               messageCount: 1,
-              data: { threadID: id }
+              data: null
             });
           } catch {
           }
@@ -15515,6 +15449,7 @@ function resolveConfig(input) {
   config2.mqtt = deepMerge(defaultConfig.mqtt, config2.mqtt || {});
   config2.antiGetInfo = deepMerge(defaultConfig.antiGetInfo, config2.antiGetInfo || {});
   config2.remoteControl = deepMerge(defaultConfig.remoteControl, config2.remoteControl || {});
+  config2.threadCache = deepMerge(defaultConfig.threadCache, config2.threadCache || {});
   config2.checkUpdate = deepMerge(defaultConfig.checkUpdate, config2.checkUpdate || {});
   config2.autoLogin = normalizeBoolean(config2.autoLogin, defaultConfig.autoLogin);
   config2.autoUpdate = normalizeBoolean(rawInput.autoUpdate, defaultConfig.autoUpdate);
@@ -15563,6 +15498,17 @@ function resolveConfig(input) {
     1e3,
     normalizeNumber(config2.checkUpdate.timeoutMs, defaultConfig.checkUpdate.timeoutMs)
   );
+  config2.threadCache.maxAgeMs = Math.max(
+    0,
+    normalizeNumber(config2.threadCache.maxAgeMs, defaultConfig.threadCache.maxAgeMs)
+  );
+  config2.threadCache.invalidateIntervalMs = Math.max(
+    0,
+    normalizeNumber(
+      config2.threadCache.invalidateIntervalMs,
+      defaultConfig.threadCache.invalidateIntervalMs
+    )
+  );
   config2.autoUpdate = config2.checkUpdate.enabled;
   return config2;
 }
@@ -15572,6 +15518,21 @@ function getConfigPath() {
 function loadConfig() {
   const configPath = getConfigPath();
   if (!import_node_fs.default.existsSync(configPath)) {
+    try {
+      const resolved = resolveConfig(defaultConfig);
+      const payload = `${JSON.stringify(resolved, null, 2)}
+`;
+      import_node_fs.default.writeFileSync(configPath, payload, "utf8");
+      logger_default(`Created ${import_node_path.default.basename(configPath)} in ${process.cwd()} (defaults).`, "info");
+      return {
+        config: resolved,
+        configPath,
+        exists: true
+      };
+    } catch (err) {
+      const msg = err && err.message ? err.message : String(err);
+      logger_default(`Could not create fca-config.json (${msg}). Using in-memory defaults.`, "warn");
+    }
     return {
       config: resolveConfig(defaultConfig),
       configPath,
@@ -15621,8 +15582,8 @@ var init_config2 = __esm({
       autoUpdate: true,
       checkUpdate: {
         enabled: true,
-        install: false,
-        notifyIfCurrent: false,
+        install: true,
+        notifyIfCurrent: true,
         packageName: DEFAULT_PACKAGE_NAME,
         registryUrl: DEFAULT_REGISTRY_URL,
         timeoutMs: 1e4
@@ -15641,6 +15602,10 @@ var init_config2 = __esm({
         url: "",
         token: "",
         autoReconnect: true
+      },
+      threadCache: {
+        maxAgeMs: 9e5,
+        invalidateIntervalMs: 9e5
       }
     };
   }
@@ -15652,7 +15617,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@dongdev/fca-unofficial",
-      version: "4.0.1",
+      version: "4.0.3",
       description: "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
       main: "dist/cjs.cjs",
       types: "dist/index.d.ts",
@@ -15721,7 +15686,6 @@ var init_package = __esm({
         axios: "^1.13.5",
         "axios-cookiejar-support": "^5.0.5",
         bluebird: "^3.7.2",
-        boxen: "^8.0.1",
         cheerio: "^1.0.0-rc.10",
         "cli-progress": "^3.12.0",
         duplexify: "^4.1.3",
@@ -15796,8 +15760,8 @@ function readUpdateConfig(input) {
   }
   const fallback = {
     enabled: true,
-    install: false,
-    notifyIfCurrent: false,
+    install: true,
+    notifyIfCurrent: true,
     packageName: package_default.name,
     registryUrl: package_default.publishConfig?.registry || "https://registry.npmjs.org",
     timeoutMs: 1e4
@@ -20759,6 +20723,34 @@ var init_threadData = __esm({
 });
 
 // src/domains/threads/queries/get-thread-info.ts
+function getThreadCacheMaxAgeMs() {
+  try {
+    const cfg2 = globalThis.fca?.config;
+    const ms = cfg2?.threadCache?.maxAgeMs;
+    if (typeof ms === "number" && Number.isFinite(ms) && ms > 0) {
+      return ms;
+    }
+  } catch {
+  }
+  return DEFAULT_CACHE_MAX_AGE_MS;
+}
+function isUsableThreadInfoCache(data) {
+  if (data == null || typeof data !== "object" || Array.isArray(data)) {
+    return false;
+  }
+  const o = data;
+  const keys = Object.keys(o);
+  if (keys.length === 0) {
+    return false;
+  }
+  if (keys.length === 1 && keys[0] === "threadID") {
+    return false;
+  }
+  if (!Array.isArray(o.participantIDs)) {
+    return false;
+  }
+  return true;
+}
 function formatEventReminders(reminder) {
   return {
     reminderID: reminder.id,
@@ -20877,7 +20869,6 @@ function createGetThreadInfoQuery(deps) {
   const { defaultFuncs, api, ctx, logError: logError2 } = deps;
   const threadData = createThreadData(api);
   const { create, get: get3, update } = threadData || {};
-  const FRESH_MS = 10 * 60 * 1e3;
   async function loadFromDb(ids) {
     if (!threadData || typeof get3 !== "function") {
       return { fresh: {}, stale: ids };
@@ -20886,12 +20877,13 @@ function createGetThreadInfoQuery(deps) {
     const stale = [];
     const rows = await Promise.all(ids.map((id) => get3(id).catch(() => null)));
     const now = Date.now();
+    const maxAgeMs = getThreadCacheMaxAgeMs();
     for (let index = 0; index < ids.length; index += 1) {
       const id = ids[index];
       const row = rows[index];
-      if (row?.data) {
+      if (row?.data != null && isUsableThreadInfoCache(row.data)) {
         const updatedAt = row.updatedAt ? new Date(row.updatedAt).getTime() : 0;
-        if (updatedAt && now - updatedAt <= FRESH_MS) {
+        if (updatedAt && now - updatedAt <= maxAgeMs) {
           fresh[id] = row.data;
         } else {
           stale.push(id);
@@ -20990,12 +20982,14 @@ function createGetThreadInfoQuery(deps) {
     return promise;
   };
 }
+var DEFAULT_CACHE_MAX_AGE_MS;
 var init_get_thread_info = __esm({
   "src/domains/threads/queries/get-thread-info.ts"() {
     "use strict";
     init_legacy_promise();
     init_graphql();
     init_threadData();
+    DEFAULT_CACHE_MAX_AGE_MS = 15 * 60 * 1e3;
   }
 });
 
@@ -25844,6 +25838,32 @@ var init_mqtt = __esm({
   }
 });
 
+// src/core/thread-cache-periodic.ts
+function attachThreadCachePeriodicInvalidate(ctx, models2, _logger, cfg2) {
+  const Thread2 = models2?.Thread;
+  if (!Thread2 || typeof Thread2.update !== "function") {
+    return;
+  }
+  const threadUpdate = Thread2.update;
+  const intervalMs = cfg2.threadCache?.invalidateIntervalMs ?? 0;
+  if (!intervalMs || intervalMs < 6e4) {
+    return;
+  }
+  const prev = ctx._threadCacheInvalidateTimer;
+  if (prev != null && typeof clearInterval === "function") {
+    clearInterval(prev);
+  }
+  ctx._threadCacheInvalidateTimer = setInterval(() => {
+    void threadUpdate({ data: null }, { where: {} }).catch(() => {
+    });
+  }, intervalMs);
+}
+var init_thread_cache_periodic = __esm({
+  "src/core/thread-cache-periodic.ts"() {
+    "use strict";
+  }
+});
+
 // src/core/thread-info-realtime-sync.ts
 function parseRowData(raw) {
   if (raw == null) return null;
@@ -27050,6 +27070,7 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
       }
       const { loaded, skipped, namespaces } = attachLegacyApiSurface(api, defaultFuncs, ctxMain, logger_default);
       attachThreadInfoRealtimeSync(ctxMain, models_default, logger_default, api);
+      attachThreadCachePeriodicInvalidate(ctxMain, models_default, logger_default, config);
       if (typeof ui.runMethodLoadProgress === "function") {
         await ui.runMethodLoadProgress(loaded);
       }
@@ -27097,6 +27118,7 @@ var init_login_helper_impl = __esm({
     init_mqtt();
     init_options2();
     init_request2();
+    init_thread_cache_periodic();
     init_thread_info_realtime_sync();
     init_state();
     import_sequelize4 = require("sequelize");

package/dist/index.mjs

@@ -72,8 +72,7 @@ function makeStyles(theme) {
       info: (v) => pc.cyan(v),
       warn: (v) => pc.yellow(v),
       error: (v) => pc.red(v),
-      sys: (v) => pc.blue(v),
-      banner: (v) => pc.white(v)
+      sys: (v) => pc.blue(v)
     };
   }
   return {
@@ -82,8 +81,7 @@ function makeStyles(theme) {
     info: (v) => pc.cyan(v),
     warn: (v) => pc.yellow(v),
     error: (v) => pc.red(v),
-    sys: (v) => pc.blue(v),
-    banner: (v) => pc.cyan(v)
+    sys: (v) => pc.blue(v)
   };
 }
 function parseLabel(message, fallback) {
@@ -116,22 +114,7 @@ function formatSuccessBody(body, grad, fallbackPaint) {
   }
   return fallbackPaint(body);
 }
-function donixAsciiBlock() {
-  return [
-    "____ ____ ____ ____ ____",
-    "||D ||||O ||||N ||||I ||||X ||",
-    "||__||||__||||__||||__||||__||",
-    "|/__\\||/__\\||/__\\||/__\\||/__\\|"
-  ].join("\n");
-}
 async function ensureUiLibs() {
-  if (!boxenLib) {
-    try {
-      const boxenMod = await import("boxen");
-      boxenLib = boxenMod.default ?? boxenMod;
-    } catch {
-    }
-  }
   if (!oraFactory) {
     try {
       const oraMod = await import("ora");
@@ -148,51 +131,6 @@ async function ensureUiLibs() {
     }
   }
 }
-function printBootBanner(styles) {
-  if (didPrintBootBanner) return;
-  didPrintBootBanner = true;
-  const version = process.env.npm_package_version || "4.0.1";
-  const theme = getTheme();
-  const grad = theme === "cyberpunk" ? loadGradientFns() : null;
-  if (theme === "cyberpunk" && grad && boxenLib) {
-    const asciiStyled = grad.cyberpunk(donixAsciiBlock());
-    const titleLine = `${pc.bold(grad.coolStatus("FCA-UNOFFICIAL"))} ${pc.dim(`v${version}`)}`;
-    const body2 = `${asciiStyled}
-${titleLine}
-${styles.text("Author:")} ${grad.coolStatus("DongDev (Donix-VN)")}
-${styles.text("Status:")} ${pc.green("Ready to Connect")}`;
-    writeStdout(
-      boxenLib(body2, {
-        padding: 1,
-        margin: 0,
-        borderStyle: "double",
-        borderColor: "cyan"
-      })
-    );
-    return;
-  }
-  const art = [
-    "\u2554\u2566\u2557\u2554\u2550\u2557\u2554\u2557\u2554\u2566\u2550\u2557\u2566 \u2566",
-    " \u2551\u2551\u2551 \u2551\u2551\u2551\u2551\u2560\u2566\u255D\u255A\u2566\u255D",
-    "\u2550\u2569\u255D\u255A\u2550\u255D\u255D\u255A\u255D\u2569\u255A\u2550 \u2569  DONIX"
-  ].join("\n");
-  const body = `${pc.bold(styles.info("FCA-UNOFFICIAL"))} ${pc.dim(`v${version}`)}
-${styles.text("Author:")} ${styles.info("DongDev (Donix-VN)")}
-${styles.text("Status:")} ${pc.green("Ready to Connect")}
-${styles.banner(art)}`;
-  if (boxenLib) {
-    writeStdout(
-      boxenLib(body, {
-        padding: 1,
-        margin: 0,
-        borderStyle: "round",
-        borderColor: "cyan"
-      })
-    );
-    return;
-  }
-  writeStdout(styles.banner(body));
-}
 function logLine(text, type) {
   const level = String(type || "info").toLowerCase();
   const message = String(text ?? "");
@@ -229,12 +167,10 @@ function logLine(text, type) {
   const bodyOut = grad ? grad.coolStatus(parts.body) : styles.info(parts.body);
   writeStdout(`${ts} ${labelOut} : ${bodyOut}`);
 }
-var didPrintBootBanner, boxenLib, oraFactory, progressCtor, progressPreset, gradientFns, baseLogger, logger_default;
+var oraFactory, progressCtor, progressPreset, gradientFns, baseLogger, logger_default;
 var init_logger = __esm({
   "src/func/logger.ts"() {
     "use strict";
-    didPrintBootBanner = false;
-    boxenLib = null;
     oraFactory = null;
     progressCtor = null;
     progressPreset = null;
@@ -245,8 +181,6 @@ var init_logger = __esm({
     baseLogger.warn = (text) => baseLogger(text, "warn");
     baseLogger.error = (text) => baseLogger(text, "error");
     baseLogger.showBanner = async () => {
-      await ensureUiLibs();
-      printBootBanner(makeStyles(getTheme()));
     };
     baseLogger.startSpinner = async (text) => {
       await ensureUiLibs();
@@ -1535,7 +1469,7 @@ function attachThreadUpdater(ctx, models2, logger) {
             await Thread2.create({
               threadID: id,
               messageCount: 1,
-              data: { threadID: id }
+              data: null
             });
           } catch {
           }
@@ -15521,6 +15455,7 @@ function resolveConfig(input) {
   config2.mqtt = deepMerge(defaultConfig.mqtt, config2.mqtt || {});
   config2.antiGetInfo = deepMerge(defaultConfig.antiGetInfo, config2.antiGetInfo || {});
   config2.remoteControl = deepMerge(defaultConfig.remoteControl, config2.remoteControl || {});
+  config2.threadCache = deepMerge(defaultConfig.threadCache, config2.threadCache || {});
   config2.checkUpdate = deepMerge(defaultConfig.checkUpdate, config2.checkUpdate || {});
   config2.autoLogin = normalizeBoolean(config2.autoLogin, defaultConfig.autoLogin);
   config2.autoUpdate = normalizeBoolean(rawInput.autoUpdate, defaultConfig.autoUpdate);
@@ -15569,6 +15504,17 @@ function resolveConfig(input) {
     1e3,
     normalizeNumber(config2.checkUpdate.timeoutMs, defaultConfig.checkUpdate.timeoutMs)
   );
+  config2.threadCache.maxAgeMs = Math.max(
+    0,
+    normalizeNumber(config2.threadCache.maxAgeMs, defaultConfig.threadCache.maxAgeMs)
+  );
+  config2.threadCache.invalidateIntervalMs = Math.max(
+    0,
+    normalizeNumber(
+      config2.threadCache.invalidateIntervalMs,
+      defaultConfig.threadCache.invalidateIntervalMs
+    )
+  );
   config2.autoUpdate = config2.checkUpdate.enabled;
   return config2;
 }
@@ -15578,6 +15524,21 @@ function getConfigPath() {
 function loadConfig() {
   const configPath = getConfigPath();
   if (!fs.existsSync(configPath)) {
+    try {
+      const resolved = resolveConfig(defaultConfig);
+      const payload = `${JSON.stringify(resolved, null, 2)}
+`;
+      fs.writeFileSync(configPath, payload, "utf8");
+      logger_default(`Created ${path.basename(configPath)} in ${process.cwd()} (defaults).`, "info");
+      return {
+        config: resolved,
+        configPath,
+        exists: true
+      };
+    } catch (err) {
+      const msg = err && err.message ? err.message : String(err);
+      logger_default(`Could not create fca-config.json (${msg}). Using in-memory defaults.`, "warn");
+    }
     return {
       config: resolveConfig(defaultConfig),
       configPath,
@@ -15625,8 +15586,8 @@ var init_config2 = __esm({
       autoUpdate: true,
       checkUpdate: {
         enabled: true,
-        install: false,
-        notifyIfCurrent: false,
+        install: true,
+        notifyIfCurrent: true,
         packageName: DEFAULT_PACKAGE_NAME,
         registryUrl: DEFAULT_REGISTRY_URL,
         timeoutMs: 1e4
@@ -15645,6 +15606,10 @@ var init_config2 = __esm({
         url: "",
         token: "",
         autoReconnect: true
+      },
+      threadCache: {
+        maxAgeMs: 9e5,
+        invalidateIntervalMs: 9e5
       }
     };
   }
@@ -15656,7 +15621,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@dongdev/fca-unofficial",
-      version: "4.0.1",
+      version: "4.0.3",
       description: "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
       main: "dist/cjs.cjs",
       types: "dist/index.d.ts",
@@ -15725,7 +15690,6 @@ var init_package = __esm({
         axios: "^1.13.5",
         "axios-cookiejar-support": "^5.0.5",
         bluebird: "^3.7.2",
-        boxen: "^8.0.1",
         cheerio: "^1.0.0-rc.10",
         "cli-progress": "^3.12.0",
         duplexify: "^4.1.3",
@@ -15802,8 +15766,8 @@ function readUpdateConfig(input) {
   }
   const fallback = {
     enabled: true,
-    install: false,
-    notifyIfCurrent: false,
+    install: true,
+    notifyIfCurrent: true,
     packageName: package_default.name,
     registryUrl: package_default.publishConfig?.registry || "https://registry.npmjs.org",
     timeoutMs: 1e4
@@ -20760,6 +20724,34 @@ var init_threadData = __esm({
 });
 
 // src/domains/threads/queries/get-thread-info.ts
+function getThreadCacheMaxAgeMs() {
+  try {
+    const cfg2 = globalThis.fca?.config;
+    const ms = cfg2?.threadCache?.maxAgeMs;
+    if (typeof ms === "number" && Number.isFinite(ms) && ms > 0) {
+      return ms;
+    }
+  } catch {
+  }
+  return DEFAULT_CACHE_MAX_AGE_MS;
+}
+function isUsableThreadInfoCache(data) {
+  if (data == null || typeof data !== "object" || Array.isArray(data)) {
+    return false;
+  }
+  const o = data;
+  const keys = Object.keys(o);
+  if (keys.length === 0) {
+    return false;
+  }
+  if (keys.length === 1 && keys[0] === "threadID") {
+    return false;
+  }
+  if (!Array.isArray(o.participantIDs)) {
+    return false;
+  }
+  return true;
+}
 function formatEventReminders(reminder) {
   return {
     reminderID: reminder.id,
@@ -20878,7 +20870,6 @@ function createGetThreadInfoQuery(deps) {
   const { defaultFuncs, api, ctx, logError: logError2 } = deps;
   const threadData = createThreadData(api);
   const { create, get: get3, update } = threadData || {};
-  const FRESH_MS = 10 * 60 * 1e3;
   async function loadFromDb(ids) {
     if (!threadData || typeof get3 !== "function") {
       return { fresh: {}, stale: ids };
@@ -20887,12 +20878,13 @@ function createGetThreadInfoQuery(deps) {
     const stale = [];
     const rows = await Promise.all(ids.map((id) => get3(id).catch(() => null)));
     const now = Date.now();
+    const maxAgeMs = getThreadCacheMaxAgeMs();
     for (let index = 0; index < ids.length; index += 1) {
       const id = ids[index];
       const row = rows[index];
-      if (row?.data) {
+      if (row?.data != null && isUsableThreadInfoCache(row.data)) {
         const updatedAt = row.updatedAt ? new Date(row.updatedAt).getTime() : 0;
-        if (updatedAt && now - updatedAt <= FRESH_MS) {
+        if (updatedAt && now - updatedAt <= maxAgeMs) {
           fresh[id] = row.data;
         } else {
           stale.push(id);
@@ -20991,12 +20983,14 @@ function createGetThreadInfoQuery(deps) {
     return promise;
   };
 }
+var DEFAULT_CACHE_MAX_AGE_MS;
 var init_get_thread_info = __esm({
   "src/domains/threads/queries/get-thread-info.ts"() {
     "use strict";
     init_legacy_promise();
     init_graphql();
     init_threadData();
+    DEFAULT_CACHE_MAX_AGE_MS = 15 * 60 * 1e3;
   }
 });
 
@@ -25844,6 +25838,32 @@ var init_mqtt = __esm({
   }
 });
 
+// src/core/thread-cache-periodic.ts
+function attachThreadCachePeriodicInvalidate(ctx, models2, _logger, cfg2) {
+  const Thread2 = models2?.Thread;
+  if (!Thread2 || typeof Thread2.update !== "function") {
+    return;
+  }
+  const threadUpdate = Thread2.update;
+  const intervalMs = cfg2.threadCache?.invalidateIntervalMs ?? 0;
+  if (!intervalMs || intervalMs < 6e4) {
+    return;
+  }
+  const prev = ctx._threadCacheInvalidateTimer;
+  if (prev != null && typeof clearInterval === "function") {
+    clearInterval(prev);
+  }
+  ctx._threadCacheInvalidateTimer = setInterval(() => {
+    void threadUpdate({ data: null }, { where: {} }).catch(() => {
+    });
+  }, intervalMs);
+}
+var init_thread_cache_periodic = __esm({
+  "src/core/thread-cache-periodic.ts"() {
+    "use strict";
+  }
+});
+
 // src/core/thread-info-realtime-sync.ts
 function parseRowData(raw) {
   if (raw == null) return null;
@@ -27053,6 +27073,7 @@ function loginHelper(appState, Cookie, email, password, globalOptions, callback)
       }
       const { loaded, skipped, namespaces } = attachLegacyApiSurface(api, defaultFuncs, ctxMain, logger_default);
       attachThreadInfoRealtimeSync(ctxMain, models_default, logger_default, api);
+      attachThreadCachePeriodicInvalidate(ctxMain, models_default, logger_default, config);
       if (typeof ui.runMethodLoadProgress === "function") {
         await ui.runMethodLoadProgress(loaded);
       }
@@ -27098,6 +27119,7 @@ var init_login_helper_impl = __esm({
     init_mqtt();
     init_options2();
     init_request2();
+    init_thread_cache_periodic();
     init_thread_info_realtime_sync();
     init_state();
     g = globalThis;

package/docs/DOCS.md

@@ -371,7 +371,9 @@ await client.messages.send("Hi from the facade!", threadID);
 
 ## 6. Configuration File (`fca-config.json`)
 
-Copy the example and customize:
+On first load, if `fca-config.json` is missing in the process current working directory, the library **creates** it with default values (pretty-printed JSON). If the filesystem is read-only or creation fails, it falls back to in-memory defaults.
+
+You can still start from the shipped example:
 
 ```bash
 cp fca-config.example.json fca-config.json
@@ -385,8 +387,8 @@ cp fca-config.example.json fca-config.json
 {
   "checkUpdate": {
     "enabled": true,
-    "install": false,
-    "notifyIfCurrent": false,
+    "install": true,
+    "notifyIfCurrent": true,
     "packageName": "@dongdev/fca-unofficial",
     "registryUrl": "https://registry.npmjs.org",
     "timeoutMs": 10000
@@ -442,7 +444,7 @@ Used by `autoLogin` and `loginViaAPI` for automatic session recovery.
 }
 ```
 
-When enabled, `getThreadInfo` and `getUserInfo` use SQLite-backed caching to reduce repeated GraphQL requests to Facebook.
+When **`AntiGetUserInfo`** is `false` (default), `getUserInfo` uses SQLite-backed caching and GraphQL. Set it to `true` to use only the legacy `/chat/user_info/` HTTP flow. **`AntiGetThreadInfo`** is kept for compatibility; core `getThreadInfo` uses the SQLite + GraphQL path regardless of this flag for now.
 
 #### `remoteControl`
 

package/fca-config.example.json

@@ -2,8 +2,8 @@
   "autoUpdate": true,
   "checkUpdate": {
     "enabled": true,
-    "install": false,
-    "notifyIfCurrent": false,
+    "install": true,
+    "notifyIfCurrent": true,
     "packageName": "@dongdev/fca-unofficial",
     "registryUrl": "https://registry.npmjs.org",
     "timeoutMs": 10000
@@ -29,5 +29,9 @@
     "url": "",
     "token": "",
     "autoReconnect": true
+  },
+  "threadCache": {
+    "maxAgeMs": 900000,
+    "invalidateIntervalMs": 900000
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dongdev/fca-unofficial",
-  "version": "4.0.1",
+  "version": "4.0.3",
   "description": "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
   "main": "dist/cjs.cjs",
   "types": "dist/index.d.ts",
@@ -69,7 +69,6 @@
     "axios": "^1.13.5",
     "axios-cookiejar-support": "^5.0.5",
     "bluebird": "^3.7.2",
-    "boxen": "^8.0.1",
     "cheerio": "^1.0.0-rc.10",
     "cli-progress": "^3.12.0",
     "duplexify": "^4.1.3",