nexus-fca 1.0.0

package/docs/removeUserFromGroup.md

@@ -0,0 +1,16 @@
+# removeUserFromGroup
+
+Remove a user from a group chat.
+
+## Usage
+```js
+api.removeUserFromGroup('1000123456789', '1234567890', (err) => {
+  if (err) return console.error(err);
+  console.log('User removed from group!');
+});
+```
+
+## Arguments
+- `userID`: User ID (string).
+- `threadID`: Group chat ID (string).
+- `callback(err)`: Callback called when the operation is done (error or null).

package/docs/resolvePhotoUrl.md

@@ -0,0 +1,15 @@
+# resolvePhotoUrl
+
+Get the full-size URL of a photo by its ID.
+
+## Usage
+```js
+api.resolvePhotoUrl('1234567890', (err, url) => {
+  if (err) return console.error(err);
+  console.log('Photo URL:', url);
+});
+```
+
+## Arguments
+- `photoID`: Photo ID (string).
+- `callback(err, url)`: Callback with error or photo URL string.

package/docs/searchForThread.md

@@ -0,0 +1,15 @@
+# searchForThread
+
+Search for a thread by name.
+
+## Usage
+```js
+api.searchForThread('Group Name', (err, thread) => {
+  if (err) return console.error(err);
+  console.log('Thread:', thread);
+});
+```
+
+## Arguments
+- `name`: Thread name (string).
+- `callback(err, thread)`: Callback with error or thread object.

package/docs/searchStickers.md

@@ -0,0 +1,15 @@
+# searchStickers
+
+Search for Facebook stickers by keyword.
+
+## Usage
+```js
+api.searchStickers('cat', (err, stickers) => {
+  if (err) return console.error(err);
+  console.log('Stickers:', stickers);
+});
+```
+
+## Arguments
+- `query`: Search keyword (string).
+- `callback(err, stickers)`: Callback with error or sticker array.

package/docs/sendComment.md

@@ -0,0 +1,16 @@
+# sendComment
+
+Send a comment to a Facebook post.
+
+## Usage
+```js
+api.sendComment('1234567890', 'Great post!', (err, res) => {
+  if (err) return console.error(err);
+  console.log('Comment sent!', res);
+});
+```
+
+## Arguments
+- `postID`: The post ID (string).
+- `comment`: Comment text (string).
+- `callback(err, res)`: Callback with error or result.

package/docs/sendMessage.md

@@ -0,0 +1,16 @@
+# sendMessage
+
+Send a message to a thread.
+
+## Usage
+```js
+api.sendMessage('Hello!', '1234567890', (err, info) => {
+  if (err) return console.error(err);
+  console.log('Message sent!', info);
+});
+```
+
+## Arguments
+- `message`: Message string or message object.
+- `threadID`: Thread ID (string).
+- `callback(err, info)`: Callback with error or message info object.

package/docs/sendMessageMqtt.md

@@ -0,0 +1,16 @@
+# sendMessageMqtt
+
+Send a message using the MQTT protocol (advanced).
+
+## Usage
+```js
+api.sendMessageMqtt('Hello!', '1234567890', (err, info) => {
+  if (err) return console.error(err);
+  console.log('Message sent via MQTT!', info);
+});
+```
+
+## Arguments
+- `message`: Message string or message object.
+- `threadID`: Thread ID (string).
+- `callback(err, info)`: Callback with error or message info object.

package/docs/sendTypingIndicator.md

@@ -0,0 +1,15 @@
+# sendTypingIndicator
+
+Send a typing indicator to a thread.
+
+## Usage
+```js
+api.sendTypingIndicator('1234567890', (err) => {
+  if (err) return console.error(err);
+  console.log('Typing indicator sent!');
+});
+```
+
+## Arguments
+- `threadID`: Thread ID (string).
+- `callback(err)`: Callback called when the operation is done (error or null).

package/docs/setMessageReaction.md

@@ -0,0 +1,17 @@
+# setMessageReaction
+
+Set a reaction on a message.
+
+## Usage
+```js
+api.setMessageReaction('👍', 'mid.$cAA...', (err) => {
+  if (err) return console.error(err);
+  console.log('Reaction set!');
+});
+```
+
+## Arguments
+- `reaction`: Emoji or reaction string.
+- `messageID`: Message ID (string).
+- `callback(err)`: Callback called when the operation is done (error or null).
+- `forceCustomReaction`: (Optional) Force use of custom emoji (boolean).

package/docs/setMessageReactionMqtt.md

@@ -0,0 +1,16 @@
+# setMessageReactionMqtt
+
+Set a message reaction using the MQTT protocol (advanced, faster, more reliable for some accounts).
+
+## Usage
+```js
+api.setMessageReactionMqtt('mid.$cAA...', '👍', (err, res) => {
+  if (err) return console.error(err);
+  console.log('Reaction sent!', res);
+});
+```
+
+## Arguments
+- `messageID`: The message ID (string).
+- `reaction`: Emoji or reaction string.
+- `callback(err, res)`: Callback with error or result.

package/docs/setPostReaction.md

@@ -0,0 +1,16 @@
+# setPostReaction
+
+React to a Facebook post.
+
+## Usage
+```js
+api.setPostReaction('1234567890', 'LIKE', (err) => {
+  if (err) return console.error(err);
+  console.log('Post reaction set!');
+});
+```
+
+## Arguments
+- `postID`: Post ID (string).
+- `reaction`: Reaction type (e.g. 'LIKE', 'LOVE', 'HAHA', etc.).
+- `callback(err)`: Callback called when the operation is done (error or null).

package/docs/setProfileGuard.md

@@ -0,0 +1,15 @@
+# setProfileGuard
+
+Enable or disable Facebook profile picture guard.
+
+## Usage
+```js
+api.setProfileGuard(true, (err, res) => {
+  if (err) return console.error(err);
+  console.log('Profile guard enabled!', res);
+});
+```
+
+## Arguments
+- `enable`: Boolean to enable (true) or disable (false) guard.
+- `callback(err, res)`: Callback with error or result.

package/docs/setStoryReaction.md

@@ -0,0 +1,16 @@
+# setStoryReaction
+
+React to a Facebook story.
+
+## Usage
+```js
+api.setStoryReaction('story_id', '😍', (err, res) => {
+  if (err) return console.error(err);
+  console.log('Reacted to story!', res);
+});
+```
+
+## Arguments
+- `storyID`: The ID of the story (string).
+- `reaction`: Emoji or reaction string.
+- `callback(err, res)`: Callback with error or result.

package/docs/setTitle.md

@@ -0,0 +1,16 @@
+# setTitle
+
+Set the title of a group chat.
+
+## Usage
+```js
+api.setTitle('New Group Name', '1234567890', (err, obj) => {
+  if (err) return console.error(err);
+  console.log('Title set!', obj);
+});
+```
+
+## Arguments
+- `newTitle`: New title (string).
+- `threadID`: Thread ID (string).
+- `callback(err, obj)`: Callback with error or confirmation object.

package/docs/shareContact.md

@@ -0,0 +1,16 @@
+# shareContact
+
+Share a contact in a thread.
+
+## Usage
+```js
+api.shareContact('1000123456789', '1234567890', (err) => {
+  if (err) return console.error(err);
+  console.log('Contact shared!');
+});
+```
+
+## Arguments
+- `userID`: User ID to share (string).
+- `threadID`: Thread ID (string).
+- `callback(err)`: Callback called when the operation is done (error or null).

package/docs/shareLink.md

@@ -0,0 +1,16 @@
+# shareLink
+
+Share a link to a thread (group or user).
+
+## Usage
+```js
+api.shareLink('https://example.com', '1234567890', (err, res) => {
+  if (err) return console.error(err);
+  console.log('Link shared!', res);
+});
+```
+
+## Arguments
+- `url`: The URL to share (string).
+- `threadID`: Target thread ID (string).
+- `callback(err, res)`: Callback with error or result.

package/docs/stopListenMqtt.md

@@ -0,0 +1,8 @@
+# stopListenMqtt
+
+Stop the MQTT listener (advanced, for bots/services that need to cleanly disconnect).
+
+## Usage
+```js
+api.stopListenMqtt();
+```

package/docs/threadColors.md

@@ -0,0 +1,11 @@
+# threadColors
+
+Get a dictionary of valid thread theme colors.
+
+## Usage
+```js
+console.log(api.threadColors);
+```
+
+## Returns
+- Object mapping color names to theme IDs.

package/docs/unfriend.md

@@ -0,0 +1,15 @@
+# unfriend
+
+Unfriend a user on Facebook.
+
+## Usage
+```js
+api.unfriend('1000123456789', (err) => {
+  if (err) return console.error(err);
+  console.log('User unfriended!');
+});
+```
+
+## Arguments
+- `userID`: User ID (string).
+- `callback(err)`: Callback called when the operation is done (error or null).

package/docs/unsendMessage.md

@@ -0,0 +1,15 @@
+# unsendMessage
+
+Unsend (revoke) a message you sent.
+
+## Usage
+```js
+api.unsendMessage('mid.$cAA...', (err) => {
+  if (err) return console.error(err);
+  console.log('Message unsent!');
+});
+```
+
+## Arguments
+- `messageID`: Message ID (string).
+- `callback(err)`: Callback called when the operation is done (error or null).

package/docs/uploadAttachment.md

@@ -0,0 +1,15 @@
+# uploadAttachment
+
+Upload an attachment to Facebook (utility/advanced).
+
+## Usage
+```js
+api.uploadAttachment(fs.createReadStream('./file.jpg'), (err, res) => {
+  if (err) return console.error(err);
+  console.log('Attachment uploaded!', res);
+});
+```
+
+## Arguments
+- `fileStream`: Readable stream of the file.
+- `callback(err, res)`: Callback with error or result object.

package/fca-config.json

@@ -0,0 +1,7 @@
+{
+  "autoUpdate": true,
+  "mqtt": {
+    "enabled": true,
+    "reconnectInterval": 3600
+  }
+}