fb-messenger-e2ee 0.1.0

package/examples/basic-usage.ts

@@ -0,0 +1,52 @@
+import { FBClient } from "../src/index.ts";
+import { loadEnv } from "../src/config/env.ts";
+import { logger } from "../src/utils/logger.ts";
+
+async function bootstrap(): Promise<void> {
+  const env = loadEnv();
+
+  // You can pass appState directly as an array or string, 
+  // or use appStatePath to let the client read it from a file.
+  const client = new FBClient({
+    appStatePath: env.appStatePath,
+    sessionStorePath: env.sessionStorePath,
+    platform: env.platform,
+  });
+
+  client.onEvent(event => {
+    switch (event.type) {
+      case "message":
+        logger.info("example", `Message from ${event.data.senderId}: ${event.data.text}`);
+        break;
+      case "e2ee_message":
+        logger.info("example", `[E2EE] Message from ${event.data.senderId}: ${event.data.text}`);
+        break;
+      case "error":
+        logger.error("example", `Error: ${event.data.message}`);
+        break;
+      default:
+        logger.debug("example", `Event: ${event.type}`, event.data);
+    }
+  });
+
+  try {
+    const { userId } = await client.connect();
+    logger.info("example", `Successfully connected as ${userId}`);
+
+    // Initiate E2EE connection
+    const deviceStorePath = `device-${userId}.json`;
+    await client.connectE2EE(deviceStorePath, userId);
+    logger.info("example", "E2EE connection established.");
+
+    // Example: Send a message after 5 seconds
+    setTimeout(async () => {
+      // await client.sendMessage({ threadId: "...", text: "Hello from E2EE!" });
+    }, 5000);
+
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error("example", `Connection failed: ${message}`);
+  }
+}
+
+void bootstrap();

package/jest.config.ts

@@ -0,0 +1,18 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+export default {
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        useESM: true,
+      },
+    ],
+  },
+  testMatch: ['**/tests/unit/**/*.test.ts'],
+  setupFiles: ['<rootDir>/tests/setup.ts'],
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "fb-messenger-e2ee",
+  "version": "0.1.0",
+  "description": "E2EE-only TypeScript/Bun toolkit for Facebook Messenger Noise, Signal Protocol, WA-binary, media, and DGW flows",
+  "main": "src/index.ts",
+  "module": "src/index.ts",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "dev": "bun run examples/basic-usage.ts",
+    "start": "bun run examples/basic-usage.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' npx jest"
+  },
+  "dependencies": {
+    "@noble/curves": "^2.2.0",
+    "@noble/hashes": "^2.2.0",
+    "@signalapp/libsignal-client": "0.70.0",
+    "fca-unofficial": "github:VangBanLaNhat/fca-unofficial",
+    "protobufjs": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/jest": "^30.0.0",
+    "@types/ws": "^8.18.1",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.8.3"
+  },
+  "trustedDependencies": [
+    "@signalapp/libsignal-client"
+  ],
+  "directories": {
+    "example": "examples",
+    "test": "tests"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HerokeyVN/FB-Messenger-E2EE.git"
+  },
+  "keywords": [
+    "facebook",
+    "messenger",
+    "e2ee",
+    "encode",
+    "encrypt"
+  ],
+  "author": "HerokeyVN",
+  "license": "AGPL-3.0-or-later",
+  "bugs": {
+    "url": "https://github.com/HerokeyVN/FB-Messenger-E2EE/issues"
+  },
+  "homepage": "https://github.com/HerokeyVN/FB-Messenger-E2EE#readme"
+}

package/src/config/env.ts

@@ -0,0 +1,15 @@
+import { resolve } from "node:path";
+
+import type { AppEnv } from "../models/config.ts";
+
+export function loadEnv(): AppEnv {
+  const appStatePath = process.env.FB_APPSTATE_PATH ?? "./data/appstate.json";
+  const sessionStorePath = process.env.FB_SESSION_STORE_PATH ?? "./data/session.json";
+  const platform = (process.env.FB_PLATFORM ?? "facebook") as "facebook" | "messenger";
+
+  return {
+    appStatePath: resolve(appStatePath),
+    sessionStorePath: resolve(sessionStorePath),
+    platform,
+  };
+}