bb-fca 2.0.4 → 2.0.7

package/src/types/index.d.ts

@@ -123,6 +123,15 @@ export interface UploadPhotoResult {
   data: any;
 }
 
+export interface UploadVideoResult {
+  success: boolean;
+  videoID: string;
+  uploadID: string;
+  uploadSessionID: string;
+  fileHandle: string;
+  data: any;
+}
+
 export interface ChangeNameResult {
   /** Raw preview response data from AccountsCenter name validation query. */
   preview: any;
@@ -365,6 +374,56 @@ export interface ThreadInfo {
   };
 }
 
+export interface SearchGroupOptions {
+  limit?: number;
+  cursor?: string | null;
+  locale?: string;
+}
+
+export interface SearchGroupItem {
+  groupID: string | null;
+  name: string | null;
+  url: string | null;
+  profileUrl: string | null;
+  imageSrc: string | null;
+  summary: string | null;
+  privacy: string | null;
+  memberText: string | null;
+  memberCount: number | null;
+  joinState: string | null;
+  hasMembershipQuestions: boolean | null;
+}
+
+export interface SearchGroupResult {
+  groups: SearchGroupItem[];
+  cursor: string | null;
+  hasNextPage: boolean;
+}
+
+export interface GroupModule {
+  join(groupID: string): Promise<any>;
+  leave(groupID: string): Promise<any>;
+  getJoinedGroups(
+    cursor?: string | null,
+    count?: number,
+  ): Promise<{
+    groups: Array<{
+      id: string;
+      name: string;
+      imageUri: string;
+      url: string;
+      memberCount: string;
+      privacy: string;
+    }>;
+    endCursor: string | null;
+    hasNextPage: boolean;
+  }>;
+  searchGroup(
+    keyword: string,
+    options?: SearchGroupOptions,
+  ): Promise<SearchGroupResult>;
+}
+
 export interface MessageObject {
   body?: string;
   attachment?: ReadStream[];
@@ -606,6 +665,10 @@ export interface API {
       photoPath: string,
       callback?: Callback<UploadPhotoResult>,
     ): Promise<UploadPhotoResult>;
+    uploadVideo(
+      videoPath: string,
+      callback?: Callback<UploadVideoResult>,
+    ): Promise<UploadVideoResult>;
   };
 
   /** Comment on a Facebook post. */
@@ -839,6 +902,9 @@ export interface API {
   /** Add an external module to extend the API. */
   addExternalModule(moduleObj: Record<string, Function>): void;
 
+  /** Group-related API methods. */
+  group: GroupModule;
+
   /** Allow accessing dynamically loaded methods. */
   [key: string]: any;
 }

package/src/utils/axios.ts

@@ -175,4 +175,23 @@ export async function postFormData(
   return requestWithRetry(async () => await client.post(url, formData, config));
 }
 
+export async function postRaw(
+  url: string,
+  reqJar: any,
+  body: Buffer,
+  options?: any,
+  ctx?: any,
+  customHeader?: any,
+): Promise<any> {
+  const config: any = {
+    headers: getHeaders(url, options, ctx, customHeader),
+    timeout: 300000, // 5 min for large uploads
+    ...proxyConfig,
+    maxContentLength: Infinity,
+    maxBodyLength: Infinity,
+    validateStatus: (status: number) => status >= 200 && status < 600,
+  };
+  return requestWithRetry(async () => await client.post(url, body, config));
+}
+
 export const getJar = (): CookieJar => jar;

package/src/utils/index.ts

@@ -46,6 +46,7 @@ function makeDefaults(html: string, userID: string | number, ctx: any): any {
     get: (url: string, jar: any, qs?: any, ctxx?: any, customHeader: any = {}) => network.get(url, jar, mergeWithDefaults(qs), ctx.globalOptions, ctxx || ctx, customHeader),
     post: (url: string, jar: any, form?: any, ctxx?: any, customHeader: any = {}) => network.post(url, jar, mergeWithDefaults(form), ctx.globalOptions, ctxx || ctx, customHeader),
     postFormData: (url: string, jar: any, form: any, qs?: any, ctxx?: any) => network.postFormData(url, jar, mergeWithDefaults(form), mergeWithDefaults(qs), ctx.globalOptions, ctxx || ctx),
+    postRaw: (url: string, jar: any, body: Buffer, ctxx?: any, customHeader: any = {}) => network.postRaw(url, jar, body, ctx.globalOptions, ctxx || ctx, customHeader),
   };
 }
 

package/LICENSE-MIT

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2015 Avery, Benjamin, David, Maude
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

package/examples/post.example.js

@@ -1,149 +0,0 @@
-/**
- * Example usage of post API functions
- * This demonstrates how to create, delete posts, upload photos, and get comments
- */
-
-const login = require('../module');
-
-// Your Facebook credentials
-const credentials = {
-  appState: [] // Add your appState here
-};
-
-login(credentials, (err, api) => {
-  if (err) {
-    console.error('Login failed:', err);
-    return;
-  }
-
-  console.log('Logged in successfully!');
-
-  // Example 1: Create a post
-  api.post.create({
-    message: 'Hello from bb-fca!',
-    privacy: 'SELF' // Options: 'EVERYONE', 'FRIENDS', 'SELF'
-  }, (err, result) => {
-    if (err) {
-      console.error('Error creating post:', err);
-      return;
-    }
-
-    console.log('Post created successfully!');
-    console.log('Post ID:', result.postID);
-    console.log('Success:', result.success);
-  });
-
-  // Example 2: Upload a photo
-  api.post.uploadPhoto('./path/to/your/photo.png', (err, result) => {
-    if (err) {
-      console.error('Error uploading photo:', err);
-      return;
-    }
-
-    console.log('Photo uploaded successfully!');
-    console.log('Photo ID:', result.photoID);
-    console.log('Upload ID:', result.uploadID);
-    console.log('Success:', result.success);
-  });
-
-  // Example 3: Upload photo with Promise
-  api.post.uploadPhoto('./path/to/your/photo.jpg')
-    .then(result => {
-      console.log('Photo uploaded:', result.photoID);
-    })
-    .catch(err => {
-      console.error('Upload failed:', err);
-    });
-
-  // Example 3.1: Create a post with photo attachments
-  // First upload the photo, then create post with photo ID
-  api.post.uploadPhoto('./path/to/your/photo.png')
-    .then(uploadResult => {
-      return api.post.create({
-        message: 'Check out this photo!',
-        privacy: 'SELF',
-        photos: [uploadResult.photoID] // Attach the uploaded photo
-      });
-    })
-    .then(createResult => {
-      console.log('Post with photo created successfully!');
-      console.log('Post ID:', createResult.postID);
-    })
-    .catch(err => {
-      console.error('Error:', err);
-    });
-
-  // Example 3.2: Create a post with multiple photos
-  Promise.all([
-    api.post.uploadPhoto('./photo1.jpg'),
-    api.post.uploadPhoto('./photo2.jpg'),
-    api.post.uploadPhoto('./photo3.jpg')
-  ])
-    .then(results => {
-      const photoIDs = results.map(r => r.photoID);
-      return api.post.create({
-        message: 'Multiple photos!',
-        privacy: 'FRIENDS',
-        photos: photoIDs
-      });
-    })
-    .then(result => {
-      console.log('Post with multiple photos created!');
-      console.log('Post ID:', result.postID);
-    })
-    .catch(err => {
-      console.error('Error:', err);
-    });
-
-  // Example 4: Get comments from a post
-  // URL: https://www.facebook.com/permalink.php?story_fbid=pfbid02WHHgPgDR9VuDfXiUR5KCseuh9f2NVmfwddGEgUuYKxrkJpFtqfUKbwcCBV7qAJxel&id=61588408996667
-  api.post.getComments({
-    story_fbid: 'pfbid02WHHgPgDR9VuDfXiUR5KCseuh9f2NVmfwddGEgUuYKxrkJpFtqfUKbwcCBV7qAJxel',
-    id: '61588408996667'
-  }, (err, comments) => {
-    if (err) {
-      console.error('Error getting comments:', err);
-      return;
-    }
-
-    console.log(`Found ${comments.length} comments:`);
-    comments.forEach((comment, index) => {
-      console.log(`\n--- Comment ${index + 1} ---`);
-      console.log(`ID: ${comment.id}`);
-      console.log(`GraphQL ID: ${comment.graphql_id}`);
-      console.log(`Text: ${comment.text}`);
-      console.log(`Author: ${comment.author.name} (ID: ${comment.author.id})`);
-      console.log(`Created: ${new Date(comment.created_time * 1000).toLocaleString('vi-VN')}`);
-      console.log(`Replies: ${comment.reply_count}/${comment.total_reply_count}`);
-      console.log(`Depth: ${comment.depth}`);
-
-      if (comment.replies && comment.replies.length > 0) {
-        console.log(`  Nested replies:`);
-        comment.replies.forEach((reply, i) => {
-          console.log(`  └─ [${i + 1}] ${reply.author.name}: ${reply.text}`);
-        });
-      }
-    });
-  });
-
-  // Example 5: Get comments using just the story_fbid (will use current user's ID)
-  api.post.getComments('pfbid02WHHgPgDR9VuDfXiUR5KCseuh9f2NVmfwddGEgUuYKxrkJpFtqfUKbwcCBV7qAJxel')
-    .then(comments => {
-      console.log(`\nUsing Promise: Found ${comments.length} comments`);
-    })
-    .catch(err => {
-      console.error('Error:', err);
-    });
-
-  // Example 6: Delete a post
-  api.post.delete('post_id_here', (err, result) => {
-    if (err) {
-      console.error('Error deleting post:', err);
-      return;
-    }
-
-    console.log('Post deleted successfully!');
-    console.log('Deleted Post ID:', result.postID);
-    console.log('Success:', result.success);
-  });
-});