@dongdev/fca-unofficial 4.0.0 → 4.0.1

package/README.md

@@ -37,13 +37,14 @@ npm install
 npm run build
 ```
 
-The build produces three artifacts in `dist/`:
+The build produces these artifacts in `dist/`:
 
-| File              | Format              |
-|-------------------|---------------------|
-| `dist/index.js`   | CommonJS (CJS)      |
-| `dist/index.mjs`  | ES Modules (ESM)    |
-| `dist/index.d.ts` | TypeScript typings   |
+| File              | Format / role                                      |
+|-------------------|----------------------------------------------------|
+| `dist/cjs.cjs`    | **CommonJS entry** — `require()` resolves here; the export **is** the `login` function (Mirai / classic FCA). |
+| `dist/index.js`   | Internal CJS bundle (required by `cjs.cjs`)        |
+| `dist/index.mjs`  | ES Modules (ESM)                                   |
+| `dist/index.d.ts` | TypeScript typings                                  |
 
 ---
 
@@ -80,7 +81,26 @@ async function main() {
 main();
 ```
 
-### Legacy callback style
+### Classic `require` (default export = `login`)
+
+Same pattern as older FCA forks: the required module **is** `login`. Callback gets **`api`**, not `ctx`.
+
+```javascript
+const login = require("@dongdev/fca-unofficial");
+
+login({ appState: require("./appstate.json") }, (err, api) => {
+  if (err) return console.error(err);
+  api.setOptions({ listenEvents: true });
+  api.listenMqtt((e, ev) => {
+    if (e) return console.error(e);
+    if (ev.type === "message") api.sendMessage(ev.body, ev.threadID);
+  });
+});
+```
+
+Optional FCA options before the callback: `login(credentials, { listenEvents: true }, (err, api) => { ... })`.
+
+### Async / Promise style
 
 ```javascript
 const { login } = require("@dongdev/fca-unofficial");
@@ -104,6 +124,8 @@ main();
 
 ## Authentication
 
+With **`require("@dongdev/fca-unofficial")`**, you get the **`login`** function directly (see [Quick Start](#quick-start)). With **named** imports / ESM, use `import { login } from "..."` or `import login from "..."`.
+
 The library supports multiple credential strategies. Pass **one** of the following to `login()` or `createMessengerBot()`:
 
 | Credential     | Description                                                                                                 |

package/dist/cjs.cjs

@@ -0,0 +1,9 @@
+"use strict";
+const m = require("./index.js");
+const core = typeof m.login === "function" ? m.login : m.default;
+if (typeof core !== "function") {
+  throw new Error("@dongdev/fca-unofficial: expected login to be a function (check dist/index.js exports).");
+}
+Object.assign(core, m);
+core.default = core;
+module.exports = core;

package/dist/index.d.mts

@@ -71,7 +71,16 @@ interface LoginCredentials$1 {
     password?: string;
     Cookie?: string | string[] | Record<string, string>;
 }
-declare const login: (credentials: LoginCredentials$1, customOptions?: FcaOptions) => Promise<FcaContext>;
+/** Classic FCA-style callback receives the flat `api` object (same as `ctx.api`). */
+type LoginApiCallback = (err: Error | null | undefined, api?: Loose) => void;
+declare function loginAsync(credentials: LoginCredentials$1, customOptions?: FcaOptions): Promise<FcaContext>;
+/**
+ * Login: Promise API, or legacy `login(credentials, (err, api) => …)` like classic FCA.
+ * For `const login = require('@dongdev/fca-unofficial')`, use the published `dist/cjs.cjs` entry.
+ */
+declare function login(credentials: LoginCredentials$1, callback: LoginApiCallback): void;
+declare function login(credentials: LoginCredentials$1, options: FcaOptions, callback: LoginApiCallback): void;
+declare function login(credentials: LoginCredentials$1, customOptions?: FcaOptions): Promise<FcaContext>;
 declare function loginLegacy(credentials: LoginCredentials$1, options?: FcaOptions | ((err: Error | null, ctx?: FcaContext) => void), callback?: (err: Error | null, ctx?: FcaContext) => void): Promise<FcaContext> | undefined;
 interface TokensApiResponse {
     status?: boolean;
@@ -1238,4 +1247,4 @@ interface MqttCore {
     }) => NodeJS.Timeout | null;
 }
 
-export { type AccountInactiveEvent, type AttachmentPayload, type AuthCore, type ChangeGroupImageResult, type ChangeThreadColorResult, type ChangeThreadEmojiResult, type CreateThemeAIResult, type DeleteMessageResult, type EditMessageResult, type EmojiPayload, type EventBase, type FcaClientFacade, type FcaClientNamespace, type FcaClientNamespaces, type FcaGlobalOptions, type FcaID, type FcaState, type ForwardAttachmentResult, type ForwardPayload, type FriendRequestCancelEvent, type FriendRequestReceivedEvent, type LegacyApiLike, type ListenMqttError, type LocationPayload, type LoginCredentials, type MentionPayload, type MessageEvent, type MessageReaction, type MessageUnsendEvent, MessengerBot, type MessengerBotLike, type MessengerBotOptions, MessengerContext, type MessengerMiddleware, type MessengerNext, type MqttCore, type MqttEvent, type PreUploadedAttachment, type PresenceEvent, type ReactionEvent, type ReadEvent, type ReadyEvent, type ReplyPayload, type RequestCore, type ScheduledMessageInfo, type SchedulerDomain, type SchedulerOptions, type SendMessageAttachment, type SendMessageContentPayload, type SendMessageEmojiSize, type SendMessageLocation, type SendMessageMention, type SendMessageObjectPayload, type SendMessagePayload, type SendMessageResult, type SendTypingOptions, type SetMessageReactionResult, type ShareContactResult, type StateCore, type StickerPayload, type StopListenEvent, type StreamAttachment, type TextPayload, type ThemeAssetImage, type ThemeBackgroundAsset, type ThemePicturesResult, type ThreadColorMap, type ThreadEvent, type TypingEvent, type UnsendMessageResult, type UploadAttachmentDescriptor, type UploadAttachmentInput, type UploadAttachmentMetadata, type UploadAttachmentOptions, type UploadAttachmentResult, type UrlPayload, attachClientFacade, attachThreadInfoRealtimeSync, checkForPackageUpdate, createAccountDomain, createApiFacade, createAuthCore, createDefaultContext, createFcaClient, createFcaState, createHttpDomain, createMessagesDomain, createMessengerBot, createRealtimeDomain, createRequestHelper, createSchedulerDomain, createThreadsDomain, createUsersDomain, login as default, defaultConfig, listenMqtt, loadConfig, login, loginLegacy, loginViaAPI, normalizeCookieHeaderString, resolveConfig, runConfiguredUpdateCheck, setJarFromPairs, tokensViaAPI, writeConfigTemplate };
+export { type AccountInactiveEvent, type AttachmentPayload, type AuthCore, type ChangeGroupImageResult, type ChangeThreadColorResult, type ChangeThreadEmojiResult, type CreateThemeAIResult, type DeleteMessageResult, type EditMessageResult, type EmojiPayload, type EventBase, type FcaClientFacade, type FcaClientNamespace, type FcaClientNamespaces, type FcaGlobalOptions, type FcaID, type FcaState, type ForwardAttachmentResult, type ForwardPayload, type FriendRequestCancelEvent, type FriendRequestReceivedEvent, type LegacyApiLike, type ListenMqttError, type LocationPayload, type LoginApiCallback, type LoginCredentials, type MentionPayload, type MessageEvent, type MessageReaction, type MessageUnsendEvent, MessengerBot, type MessengerBotLike, type MessengerBotOptions, MessengerContext, type MessengerMiddleware, type MessengerNext, type MqttCore, type MqttEvent, type PreUploadedAttachment, type PresenceEvent, type ReactionEvent, type ReadEvent, type ReadyEvent, type ReplyPayload, type RequestCore, type ScheduledMessageInfo, type SchedulerDomain, type SchedulerOptions, type SendMessageAttachment, type SendMessageContentPayload, type SendMessageEmojiSize, type SendMessageLocation, type SendMessageMention, type SendMessageObjectPayload, type SendMessagePayload, type SendMessageResult, type SendTypingOptions, type SetMessageReactionResult, type ShareContactResult, type StateCore, type StickerPayload, type StopListenEvent, type StreamAttachment, type TextPayload, type ThemeAssetImage, type ThemeBackgroundAsset, type ThemePicturesResult, type ThreadColorMap, type ThreadEvent, type TypingEvent, type UnsendMessageResult, type UploadAttachmentDescriptor, type UploadAttachmentInput, type UploadAttachmentMetadata, type UploadAttachmentOptions, type UploadAttachmentResult, type UrlPayload, attachClientFacade, attachThreadInfoRealtimeSync, checkForPackageUpdate, createAccountDomain, createApiFacade, createAuthCore, createDefaultContext, createFcaClient, createFcaState, createHttpDomain, createMessagesDomain, createMessengerBot, createRealtimeDomain, createRequestHelper, createSchedulerDomain, createThreadsDomain, createUsersDomain, login as default, defaultConfig, listenMqtt, loadConfig, login, loginAsync, loginLegacy, loginViaAPI, normalizeCookieHeaderString, resolveConfig, runConfiguredUpdateCheck, setJarFromPairs, tokensViaAPI, writeConfigTemplate };

package/dist/index.d.ts

@@ -71,7 +71,16 @@ interface LoginCredentials$1 {
     password?: string;
     Cookie?: string | string[] | Record<string, string>;
 }
-declare const login: (credentials: LoginCredentials$1, customOptions?: FcaOptions) => Promise<FcaContext>;
+/** Classic FCA-style callback receives the flat `api` object (same as `ctx.api`). */
+type LoginApiCallback = (err: Error | null | undefined, api?: Loose) => void;
+declare function loginAsync(credentials: LoginCredentials$1, customOptions?: FcaOptions): Promise<FcaContext>;
+/**
+ * Login: Promise API, or legacy `login(credentials, (err, api) => …)` like classic FCA.
+ * For `const login = require('@dongdev/fca-unofficial')`, use the published `dist/cjs.cjs` entry.
+ */
+declare function login(credentials: LoginCredentials$1, callback: LoginApiCallback): void;
+declare function login(credentials: LoginCredentials$1, options: FcaOptions, callback: LoginApiCallback): void;
+declare function login(credentials: LoginCredentials$1, customOptions?: FcaOptions): Promise<FcaContext>;
 declare function loginLegacy(credentials: LoginCredentials$1, options?: FcaOptions | ((err: Error | null, ctx?: FcaContext) => void), callback?: (err: Error | null, ctx?: FcaContext) => void): Promise<FcaContext> | undefined;
 interface TokensApiResponse {
     status?: boolean;
@@ -1238,4 +1247,4 @@ interface MqttCore {
     }) => NodeJS.Timeout | null;
 }
 
-export { type AccountInactiveEvent, type AttachmentPayload, type AuthCore, type ChangeGroupImageResult, type ChangeThreadColorResult, type ChangeThreadEmojiResult, type CreateThemeAIResult, type DeleteMessageResult, type EditMessageResult, type EmojiPayload, type EventBase, type FcaClientFacade, type FcaClientNamespace, type FcaClientNamespaces, type FcaGlobalOptions, type FcaID, type FcaState, type ForwardAttachmentResult, type ForwardPayload, type FriendRequestCancelEvent, type FriendRequestReceivedEvent, type LegacyApiLike, type ListenMqttError, type LocationPayload, type LoginCredentials, type MentionPayload, type MessageEvent, type MessageReaction, type MessageUnsendEvent, MessengerBot, type MessengerBotLike, type MessengerBotOptions, MessengerContext, type MessengerMiddleware, type MessengerNext, type MqttCore, type MqttEvent, type PreUploadedAttachment, type PresenceEvent, type ReactionEvent, type ReadEvent, type ReadyEvent, type ReplyPayload, type RequestCore, type ScheduledMessageInfo, type SchedulerDomain, type SchedulerOptions, type SendMessageAttachment, type SendMessageContentPayload, type SendMessageEmojiSize, type SendMessageLocation, type SendMessageMention, type SendMessageObjectPayload, type SendMessagePayload, type SendMessageResult, type SendTypingOptions, type SetMessageReactionResult, type ShareContactResult, type StateCore, type StickerPayload, type StopListenEvent, type StreamAttachment, type TextPayload, type ThemeAssetImage, type ThemeBackgroundAsset, type ThemePicturesResult, type ThreadColorMap, type ThreadEvent, type TypingEvent, type UnsendMessageResult, type UploadAttachmentDescriptor, type UploadAttachmentInput, type UploadAttachmentMetadata, type UploadAttachmentOptions, type UploadAttachmentResult, type UrlPayload, attachClientFacade, attachThreadInfoRealtimeSync, checkForPackageUpdate, createAccountDomain, createApiFacade, createAuthCore, createDefaultContext, createFcaClient, createFcaState, createHttpDomain, createMessagesDomain, createMessengerBot, createRealtimeDomain, createRequestHelper, createSchedulerDomain, createThreadsDomain, createUsersDomain, login as default, defaultConfig, listenMqtt, loadConfig, login, loginLegacy, loginViaAPI, normalizeCookieHeaderString, resolveConfig, runConfiguredUpdateCheck, setJarFromPairs, tokensViaAPI, writeConfigTemplate };
+export { type AccountInactiveEvent, type AttachmentPayload, type AuthCore, type ChangeGroupImageResult, type ChangeThreadColorResult, type ChangeThreadEmojiResult, type CreateThemeAIResult, type DeleteMessageResult, type EditMessageResult, type EmojiPayload, type EventBase, type FcaClientFacade, type FcaClientNamespace, type FcaClientNamespaces, type FcaGlobalOptions, type FcaID, type FcaState, type ForwardAttachmentResult, type ForwardPayload, type FriendRequestCancelEvent, type FriendRequestReceivedEvent, type LegacyApiLike, type ListenMqttError, type LocationPayload, type LoginApiCallback, type LoginCredentials, type MentionPayload, type MessageEvent, type MessageReaction, type MessageUnsendEvent, MessengerBot, type MessengerBotLike, type MessengerBotOptions, MessengerContext, type MessengerMiddleware, type MessengerNext, type MqttCore, type MqttEvent, type PreUploadedAttachment, type PresenceEvent, type ReactionEvent, type ReadEvent, type ReadyEvent, type ReplyPayload, type RequestCore, type ScheduledMessageInfo, type SchedulerDomain, type SchedulerOptions, type SendMessageAttachment, type SendMessageContentPayload, type SendMessageEmojiSize, type SendMessageLocation, type SendMessageMention, type SendMessageObjectPayload, type SendMessagePayload, type SendMessageResult, type SendTypingOptions, type SetMessageReactionResult, type ShareContactResult, type StateCore, type StickerPayload, type StopListenEvent, type StreamAttachment, type TextPayload, type ThemeAssetImage, type ThemeBackgroundAsset, type ThemePicturesResult, type ThreadColorMap, type ThreadEvent, type TypingEvent, type UnsendMessageResult, type UploadAttachmentDescriptor, type UploadAttachmentInput, type UploadAttachmentMetadata, type UploadAttachmentOptions, type UploadAttachmentResult, type UrlPayload, attachClientFacade, attachThreadInfoRealtimeSync, checkForPackageUpdate, createAccountDomain, createApiFacade, createAuthCore, createDefaultContext, createFcaClient, createFcaState, createHttpDomain, createMessagesDomain, createMessengerBot, createRealtimeDomain, createRequestHelper, createSchedulerDomain, createThreadsDomain, createUsersDomain, login as default, defaultConfig, listenMqtt, loadConfig, login, loginAsync, loginLegacy, loginViaAPI, normalizeCookieHeaderString, resolveConfig, runConfiguredUpdateCheck, setJarFromPairs, tokensViaAPI, writeConfigTemplate };

package/dist/index.js

@@ -144,7 +144,7 @@ async function ensureUiLibs() {
 function printBootBanner(styles) {
   if (didPrintBootBanner) return;
   didPrintBootBanner = true;
-  const version = process.env.npm_package_version || "4.0.0";
+  const version = process.env.npm_package_version || "4.0.1";
   const theme = getTheme();
   const grad = theme === "cyberpunk" ? loadGradientFns() : null;
   if (theme === "cyberpunk" && grad && boxenLib) {
@@ -15652,16 +15652,16 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@dongdev/fca-unofficial",
-      version: "4.0.0",
+      version: "4.0.1",
       description: "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
-      main: "dist/index.js",
+      main: "dist/cjs.cjs",
       types: "dist/index.d.ts",
       exports: {
         ".": {
           types: "./dist/index.d.ts",
-          require: "./dist/index.js",
+          require: "./dist/cjs.cjs",
           import: "./dist/index.mjs",
-          default: "./dist/index.js"
+          default: "./dist/index.mjs"
         }
       },
       files: [
@@ -15677,7 +15677,7 @@ var init_package = __esm({
         "test:build": "npm run build && node ./test/fca.test.cjs",
         lint: "eslint .",
         typecheck: "tsc -p tsconfig.typecheck.json --noEmit",
-        build: "tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist --external gradient-string",
+        build: "tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist --external gradient-string && node scripts/cjs-bridge.cjs",
         "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly"
       },
       repository: {
@@ -27146,19 +27146,83 @@ function appStateToFbid(appState) {
   const iUser = appState.find((c) => c?.key === "i_user" || c?.name === "i_user");
   return String(cUser && cUser.value || iUser && iUser.value || "");
 }
+async function loginAsync(credentials, customOptions = {}) {
+  const { config: config2 } = loadConfig();
+  g2.fca = g2.fca || {};
+  g2.fca.config = config2;
+  const ctx = createDefaultContext();
+  const globalOptions = { ...DEFAULT_LOGIN_OPTIONS };
+  setOptions(globalOptions, customOptions || {});
+  ctx.options = { ...ctx.options, ...globalOptions };
+  ctx.globalOptions = globalOptions;
+  ctx.cookieString = appStateToCookieString(credentials.appState);
+  ctx.fbid = appStateToFbid(credentials.appState);
+  ctx._request = createRequestHelper(ctx);
+  const runLogin = () => new Promise((resolve, reject) => {
+    (0, import_login_helper.default)(
+      credentials.appState,
+      credentials.Cookie,
+      credentials.email,
+      credentials.password,
+      globalOptions,
+      (error, api2) => {
+        if (error) return reject(error);
+        return resolve(api2);
+      }
+    );
+  });
+  let api;
+  if (config2.checkUpdate.enabled) {
+    await runConfiguredUpdateCheck(config2, logger_default);
+  }
+  api = await runLogin();
+  ctx.api = api;
+  try {
+    if (typeof api.getCurrentUserID === "function") {
+      ctx.fbid = String(api.getCurrentUserID() || ctx.fbid || "");
+      ctx.userID = ctx.fbid;
+    }
+    if (typeof api.getCookies === "function") {
+      ctx.cookieString = String(api.getCookies() || ctx.cookieString || "");
+    }
+  } catch {
+  }
+  return ctx;
+}
+function login(credentials, optionsOrCallback, callback) {
+  if (typeof optionsOrCallback === "function") {
+    const cb = optionsOrCallback;
+    void loginAsync(credentials, {}).then((ctx) => {
+      cb(null, ctx.api);
+    }).catch((err) => {
+      cb(err instanceof Error ? err : new Error(String(err?.message ?? err)));
+    });
+    return;
+  }
+  if (typeof callback === "function") {
+    const opts = optionsOrCallback || {};
+    void loginAsync(credentials, opts).then((ctx) => {
+      callback(null, ctx.api);
+    }).catch((err) => {
+      callback(err instanceof Error ? err : new Error(String(err?.message ?? err)));
+    });
+    return;
+  }
+  return loginAsync(credentials, optionsOrCallback || {});
+}
 function loginLegacy(credentials, options, callback) {
   if (getType14(options) === "Function" || getType14(options) === "AsyncFunction") {
     callback = options;
     options = {};
   }
-  const p = login(credentials, options || {});
+  const p = loginAsync(credentials, options || {});
   if (typeof callback === "function") {
     p.then((res) => callback?.(null, res)).catch((err) => callback?.(err));
     return;
   }
   return p;
 }
-var import_format19, import_login_helper, getType14, g2, initialConfig, DEFAULT_LOGIN_OPTIONS, login, tokensViaAPI, loginViaAPI2, normalizeCookieHeaderString, setJarFromPairs2;
+var import_format19, import_login_helper, getType14, g2, initialConfig, DEFAULT_LOGIN_OPTIONS, tokensViaAPI, loginViaAPI2, normalizeCookieHeaderString, setJarFromPairs2;
 var init_auth = __esm({
   "src/core/auth.ts"() {
     "use strict";
@@ -27230,49 +27294,6 @@ var init_auth = __esm({
       emitReady: false,
       userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36"
     };
-    login = async (credentials, customOptions = {}) => {
-      const { config: config2 } = loadConfig();
-      g2.fca = g2.fca || {};
-      g2.fca.config = config2;
-      const ctx = createDefaultContext();
-      const globalOptions = { ...DEFAULT_LOGIN_OPTIONS };
-      setOptions(globalOptions, customOptions || {});
-      ctx.options = { ...ctx.options, ...globalOptions };
-      ctx.globalOptions = globalOptions;
-      ctx.cookieString = appStateToCookieString(credentials.appState);
-      ctx.fbid = appStateToFbid(credentials.appState);
-      ctx._request = createRequestHelper(ctx);
-      const runLogin = () => new Promise((resolve, reject) => {
-        (0, import_login_helper.default)(
-          credentials.appState,
-          credentials.Cookie,
-          credentials.email,
-          credentials.password,
-          globalOptions,
-          (error, api2) => {
-            if (error) return reject(error);
-            return resolve(api2);
-          }
-        );
-      });
-      let api;
-      if (config2.checkUpdate.enabled) {
-        await runConfiguredUpdateCheck(config2, logger_default);
-      }
-      api = await runLogin();
-      ctx.api = api;
-      try {
-        if (typeof api.getCurrentUserID === "function") {
-          ctx.fbid = String(api.getCurrentUserID() || ctx.fbid || "");
-          ctx.userID = ctx.fbid;
-        }
-        if (typeof api.getCookies === "function") {
-          ctx.cookieString = String(api.getCookies() || ctx.cookieString || "");
-        }
-      } catch {
-      }
-      return ctx;
-    };
     tokensViaAPI = (email, password, twoFactor, apiBaseUrl) => import_login_helper.default.tokensViaAPI(email, password, twoFactor, apiBaseUrl);
     loginViaAPI2 = (email, password, twoFactor, apiBaseUrl, apiKey) => import_login_helper.default.loginViaAPI(email, password, twoFactor, apiBaseUrl, apiKey);
     normalizeCookieHeaderString = (cookieHeader) => import_login_helper.default.normalizeCookieHeaderString(cookieHeader);
@@ -27307,6 +27328,7 @@ __export(index_exports, {
   listenMqtt: () => listenMqtt,
   loadConfig: () => loadConfig,
   login: () => login,
+  loginAsync: () => loginAsync,
   loginLegacy: () => loginLegacy,
   loginViaAPI: () => loginViaAPI2,
   normalizeCookieHeaderString: () => normalizeCookieHeaderString,
@@ -27688,6 +27710,7 @@ init_scheduler();
   listenMqtt,
   loadConfig,
   login,
+  loginAsync,
   loginLegacy,
   loginViaAPI,
   normalizeCookieHeaderString,

package/dist/index.mjs

@@ -151,7 +151,7 @@ async function ensureUiLibs() {
 function printBootBanner(styles) {
   if (didPrintBootBanner) return;
   didPrintBootBanner = true;
-  const version = process.env.npm_package_version || "4.0.0";
+  const version = process.env.npm_package_version || "4.0.1";
   const theme = getTheme();
   const grad = theme === "cyberpunk" ? loadGradientFns() : null;
   if (theme === "cyberpunk" && grad && boxenLib) {
@@ -15656,16 +15656,16 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@dongdev/fca-unofficial",
-      version: "4.0.0",
+      version: "4.0.1",
       description: "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
-      main: "dist/index.js",
+      main: "dist/cjs.cjs",
       types: "dist/index.d.ts",
       exports: {
         ".": {
           types: "./dist/index.d.ts",
-          require: "./dist/index.js",
+          require: "./dist/cjs.cjs",
           import: "./dist/index.mjs",
-          default: "./dist/index.js"
+          default: "./dist/index.mjs"
         }
       },
       files: [
@@ -15681,7 +15681,7 @@ var init_package = __esm({
         "test:build": "npm run build && node ./test/fca.test.cjs",
         lint: "eslint .",
         typecheck: "tsc -p tsconfig.typecheck.json --noEmit",
-        build: "tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist --external gradient-string",
+        build: "tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist --external gradient-string && node scripts/cjs-bridge.cjs",
         "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly"
       },
       repository: {
@@ -27146,19 +27146,83 @@ function appStateToFbid(appState) {
   const iUser = appState.find((c) => c?.key === "i_user" || c?.name === "i_user");
   return String(cUser && cUser.value || iUser && iUser.value || "");
 }
+async function loginAsync(credentials, customOptions = {}) {
+  const { config: config2 } = loadConfig();
+  g2.fca = g2.fca || {};
+  g2.fca.config = config2;
+  const ctx = createDefaultContext();
+  const globalOptions = { ...DEFAULT_LOGIN_OPTIONS };
+  setOptions(globalOptions, customOptions || {});
+  ctx.options = { ...ctx.options, ...globalOptions };
+  ctx.globalOptions = globalOptions;
+  ctx.cookieString = appStateToCookieString(credentials.appState);
+  ctx.fbid = appStateToFbid(credentials.appState);
+  ctx._request = createRequestHelper(ctx);
+  const runLogin = () => new Promise((resolve, reject) => {
+    (0, import_login_helper.default)(
+      credentials.appState,
+      credentials.Cookie,
+      credentials.email,
+      credentials.password,
+      globalOptions,
+      (error, api2) => {
+        if (error) return reject(error);
+        return resolve(api2);
+      }
+    );
+  });
+  let api;
+  if (config2.checkUpdate.enabled) {
+    await runConfiguredUpdateCheck(config2, logger_default);
+  }
+  api = await runLogin();
+  ctx.api = api;
+  try {
+    if (typeof api.getCurrentUserID === "function") {
+      ctx.fbid = String(api.getCurrentUserID() || ctx.fbid || "");
+      ctx.userID = ctx.fbid;
+    }
+    if (typeof api.getCookies === "function") {
+      ctx.cookieString = String(api.getCookies() || ctx.cookieString || "");
+    }
+  } catch {
+  }
+  return ctx;
+}
+function login(credentials, optionsOrCallback, callback) {
+  if (typeof optionsOrCallback === "function") {
+    const cb = optionsOrCallback;
+    void loginAsync(credentials, {}).then((ctx) => {
+      cb(null, ctx.api);
+    }).catch((err) => {
+      cb(err instanceof Error ? err : new Error(String(err?.message ?? err)));
+    });
+    return;
+  }
+  if (typeof callback === "function") {
+    const opts = optionsOrCallback || {};
+    void loginAsync(credentials, opts).then((ctx) => {
+      callback(null, ctx.api);
+    }).catch((err) => {
+      callback(err instanceof Error ? err : new Error(String(err?.message ?? err)));
+    });
+    return;
+  }
+  return loginAsync(credentials, optionsOrCallback || {});
+}
 function loginLegacy(credentials, options, callback) {
   if (getType14(options) === "Function" || getType14(options) === "AsyncFunction") {
     callback = options;
     options = {};
   }
-  const p = login(credentials, options || {});
+  const p = loginAsync(credentials, options || {});
   if (typeof callback === "function") {
     p.then((res) => callback?.(null, res)).catch((err) => callback?.(err));
     return;
   }
   return p;
 }
-var import_format19, import_login_helper, getType14, g2, initialConfig, DEFAULT_LOGIN_OPTIONS, login, tokensViaAPI, loginViaAPI2, normalizeCookieHeaderString, setJarFromPairs2;
+var import_format19, import_login_helper, getType14, g2, initialConfig, DEFAULT_LOGIN_OPTIONS, tokensViaAPI, loginViaAPI2, normalizeCookieHeaderString, setJarFromPairs2;
 var init_auth = __esm({
   "src/core/auth.ts"() {
     "use strict";
@@ -27230,49 +27294,6 @@ var init_auth = __esm({
       emitReady: false,
       userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36"
     };
-    login = async (credentials, customOptions = {}) => {
-      const { config: config2 } = loadConfig();
-      g2.fca = g2.fca || {};
-      g2.fca.config = config2;
-      const ctx = createDefaultContext();
-      const globalOptions = { ...DEFAULT_LOGIN_OPTIONS };
-      setOptions(globalOptions, customOptions || {});
-      ctx.options = { ...ctx.options, ...globalOptions };
-      ctx.globalOptions = globalOptions;
-      ctx.cookieString = appStateToCookieString(credentials.appState);
-      ctx.fbid = appStateToFbid(credentials.appState);
-      ctx._request = createRequestHelper(ctx);
-      const runLogin = () => new Promise((resolve, reject) => {
-        (0, import_login_helper.default)(
-          credentials.appState,
-          credentials.Cookie,
-          credentials.email,
-          credentials.password,
-          globalOptions,
-          (error, api2) => {
-            if (error) return reject(error);
-            return resolve(api2);
-          }
-        );
-      });
-      let api;
-      if (config2.checkUpdate.enabled) {
-        await runConfiguredUpdateCheck(config2, logger_default);
-      }
-      api = await runLogin();
-      ctx.api = api;
-      try {
-        if (typeof api.getCurrentUserID === "function") {
-          ctx.fbid = String(api.getCurrentUserID() || ctx.fbid || "");
-          ctx.userID = ctx.fbid;
-        }
-        if (typeof api.getCookies === "function") {
-          ctx.cookieString = String(api.getCookies() || ctx.cookieString || "");
-        }
-      } catch {
-      }
-      return ctx;
-    };
     tokensViaAPI = (email, password, twoFactor, apiBaseUrl) => import_login_helper.default.tokensViaAPI(email, password, twoFactor, apiBaseUrl);
     loginViaAPI2 = (email, password, twoFactor, apiBaseUrl, apiKey) => import_login_helper.default.loginViaAPI(email, password, twoFactor, apiBaseUrl, apiKey);
     normalizeCookieHeaderString = (cookieHeader) => import_login_helper.default.normalizeCookieHeaderString(cookieHeader);
@@ -27652,6 +27673,7 @@ export {
   listenMqtt,
   loadConfig,
   login,
+  loginAsync,
   loginLegacy,
   loginViaAPI2 as loginViaAPI,
   normalizeCookieHeaderString,

package/docs/DOCS.md

@@ -63,7 +63,27 @@ Additional scripts:
 
 ## 2. Authentication
 
-### 2.1. `login()` — async, returns `FcaContext`
+### 2.1. `require()` default = `login` (classic FCA / Mirai)
+
+`package.json` points CommonJS `require` at `dist/cjs.cjs`, so the module itself **is** the `login` function (with all named exports copied onto it):
+
+```javascript
+const login = require("@dongdev/fca-unofficial");
+
+login({ appState: require("./appstate.json") }, (err, api) => {
+  if (err) return console.error(err);
+  api.setOptions({ listenEvents: true });
+  // api.getAppState(), api.listenMqtt(), …
+});
+```
+
+The callback receives **`api`** (flat legacy API), not `FcaContext`. For options + callback:
+
+```javascript
+login({ appState: [...] }, { listenEvents: true }, (err, api) => { ... });
+```
+
+### 2.2. `login()` — Promise, returns `FcaContext`
 
 ```typescript
 import { login } from "@dongdev/fca-unofficial";
@@ -75,7 +95,9 @@ const ctx = await login(
 const api = ctx.api;
 ```
 
-### 2.2. Credential strategies
+Use **`loginAsync`** if you need an explicit async function reference without overload resolution.
+
+### 2.3. Credential strategies
 
 | Field              | Description                                                                 |
 |--------------------|-----------------------------------------------------------------------------|
@@ -83,7 +105,7 @@ const api = ctx.api;
 | `Cookie`           | Raw cookie header string: `"c_user=...; xs=...; ..."`.                     |
 | `email` + `password` | Web login credentials. Easily triggers checkpoints; **not recommended** for production bots. |
 
-### 2.3. `loginLegacy()` — callback style
+### 2.4. `loginLegacy()` — callback with `FcaContext`
 
 ```javascript
 const { loginLegacy } = require("@dongdev/fca-unofficial");
@@ -95,11 +117,11 @@ loginLegacy({ appState: require("./appstate.json") }, (err, ctx) => {
 });
 ```
 
-### 2.4. Token-based login
+### 2.5. Token-based login
 
 `tokensViaAPI` and `loginViaAPI` authenticate through an external API server. Configure the `apiServer` and `credentials` fields in `fca-config.json`. See `src/core/auth.ts` for implementation details.
 
-### 2.5. Login options (`FcaOptions`)
+### 2.6. Login options (`FcaOptions`)
 
 | Option            | Type      | Default     | Description                                    |
 |-------------------|-----------|-------------|------------------------------------------------|
@@ -619,8 +641,9 @@ All public exports from `@dongdev/fca-unofficial`:
 
 | Export                          | Category       | Description                                       |
 |---------------------------------|----------------|---------------------------------------------------|
-| `login`                         | Auth           | Async login, returns `FcaContext`                  |
-| `loginLegacy`                   | Auth           | Callback-style login                              |
+| `login`                         | Auth           | Promise login **or** `login(cred, (err, api) => …)` / `login(cred, opts, cb)` (classic FCA) |
+| `loginAsync`                    | Auth           | Always `Promise<FcaContext>` (no callback overload) |
+| `loginLegacy`                   | Auth           | Callback receives `FcaContext`                    |
 | `loginViaAPI`                   | Auth           | Token-based login via external API                 |
 | `tokensViaAPI`                  | Auth           | Fetch tokens from external API                     |
 | `normalizeCookieHeaderString`   | Auth           | Normalize a raw cookie string                      |

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dongdev/fca-unofficial",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Unofficial Facebook Chat API for Node.js - Interact with Facebook Messenger programmatically",
-  "main": "dist/index.js",
+  "main": "dist/cjs.cjs",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
+      "require": "./dist/cjs.cjs",
       "import": "./dist/index.mjs",
-      "default": "./dist/index.js"
+      "default": "./dist/index.mjs"
     }
   },
   "files": [
@@ -25,7 +25,7 @@
     "test:build": "npm run build && node ./test/fca.test.cjs",
     "lint": "eslint .",
     "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist --external gradient-string",
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean --out-dir dist --external gradient-string && node scripts/cjs-bridge.cjs",
     "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly"
   },
   "repository": {

package/test/fca.test.cjs

@@ -366,6 +366,13 @@ test("public exports are available", () => {
   assert.strictEqual(typeof fca.loadConfig, "function");
 });
 
+test("dist/cjs.cjs default export is callable login (Mirai / classic require)", () => {
+  const login = require("../dist/cjs.cjs");
+  assert.strictEqual(typeof login, "function");
+  assert.strictEqual(typeof login.login, "function");
+  assert.strictEqual(typeof login.createMessengerBot, "function");
+});
+
 test("resolveConfig honors legacy autoUpdate alias", () => {
   const resolved = fca.resolveConfig({
     autoUpdate: false,