@dongdev/fca-unofficial 4.0.2 → 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

@@ -1464,7 +1464,7 @@ function attachThreadUpdater(ctx, models2, logger) {
             await Thread2.create({
               threadID: id,
               messageCount: 1,
-              data: { threadID: id }
+              data: null
             });
           } catch {
           }
@@ -15449,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);
@@ -15497,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;
 }
@@ -15506,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,
@@ -15555,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
@@ -15575,6 +15602,10 @@ var init_config2 = __esm({
         url: "",
         token: "",
         autoReconnect: true
+      },
+      threadCache: {
+        maxAgeMs: 9e5,
+        invalidateIntervalMs: 9e5
       }
     };
   }
@@ -15586,7 +15617,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@dongdev/fca-unofficial",
-      version: "4.0.2",
+      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",
@@ -15729,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
@@ -20692,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,
@@ -20810,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 };
@@ -20819,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);
@@ -20923,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;
   }
 });
 
@@ -25777,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;
@@ -26983,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);
       }
@@ -27030,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

@@ -1469,7 +1469,7 @@ function attachThreadUpdater(ctx, models2, logger) {
             await Thread2.create({
               threadID: id,
               messageCount: 1,
-              data: { threadID: id }
+              data: null
             });
           } catch {
           }
@@ -15455,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);
@@ -15503,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;
 }
@@ -15512,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,
@@ -15559,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
@@ -15579,6 +15606,10 @@ var init_config2 = __esm({
         url: "",
         token: "",
         autoReconnect: true
+      },
+      threadCache: {
+        maxAgeMs: 9e5,
+        invalidateIntervalMs: 9e5
       }
     };
   }
@@ -15590,7 +15621,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@dongdev/fca-unofficial",
-      version: "4.0.2",
+      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",
@@ -15735,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
@@ -20693,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,
@@ -20811,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 };
@@ -20820,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);
@@ -20924,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;
   }
 });
 
@@ -25777,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;
@@ -26986,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);
       }
@@ -27031,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

@@ -3,7 +3,7 @@
   "checkUpdate": {
     "enabled": true,
     "install": true,
-    "notifyIfCurrent": false,
+    "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.2",
+  "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",