Liwanag 🌟

Filipino Facebook Chat API Library

Ang Liwanag ay isang comprehensive at user-friendly na Filipino version ng Facebook Chat API library na specially designed para sa mga Filipino developers. Nag-aalok ito ng complete automation at interaction capabilities para sa Facebook accounts.

📦 Installation

npm install liwanag-fca

🚀 Quick Start

Using AppState (Recommended)

const liwanag = require('liwanag-fca');

// Load your appstate (cookies from browser)
const appState = require('./appstate.json');

liwanag.login({ appState }, {}, (err, api) => {
    if (err) return console.error(err);
    
    console.log('Logged in as:', api.getUserID());
    
    // Makinig sa messages
    api.makinigSaMensahe((err, message) => {
        if (err) return console.error(err);
        
        console.log('Message received:', message.body);
        
        // Mag-reply
        api.magpadalaNgMensahe('Salamat sa message mo!', message.threadID);
    });
});

🎨 Advanced Logging System

Beautiful Console Logs with Colors and Formatting

const liwanag = require('liwanag-fca');

const options = {
    logConfig: {
        level: 'INFO',           // Minimum log level
        colorize: true,          // Enable colors
        timestamp: true,         // Show timestamps
        saveToFile: true,        // Save logs to file
        logDirectory: './logs',  // Log file location
        maxFileSize: '10MB',     // Max log file size
        maxFiles: 7,             // Keep 7 days of logs
        format: 'detailed',      // 'simple', 'detailed', or 'json'
        showPerformance: true,   // Show response times
        showMemory: true,        // Show memory usage
        language: 'tl'           // 'tl' for Tagalog, 'en' for English
    }
};

liwanag.login({ appState }, options, (err, api) => {
    // Your code here
});

Log Levels

• SUCCESS 🟢 - Green colored success messages
• INFO 🔵 - Blue colored information logs
• WARNING 🟡 - Yellow colored warnings
• ERROR 🔴 - Red colored errors
• DEBUG 🟣 - Purple colored debug information
• SYSTEM ⚪ - White colored system messages

🔄 Auto-Refresh Cookies System

Intelligent Cookie Management

api.autoRefreshCookies({
    enabled: true,
    interval: 30,              // Check every 30 minutes
    refreshBeforeExpiry: 10,   // Refresh 10 minutes before expiry
    maxRetries: 3,             // Retry 3 times if failed
    onRefresh: (info) => {
        console.log('Cookies refreshed!', info);
    },
    onError: (error) => {
        console.error('Refresh failed:', error);
    }
});

// Manual refresh
await api.refreshCookies();

// Get cookie status
const status = api.getCookieStatus();
console.log(status);
// {
//   valid: true,
//   expiresIn: '1h 45m',
//   lastRefresh: '30m ago',
//   nextRefresh: '15m',
//   health: 'excellent'
// }

🕵️ Anti-Detection Suite

FingerprintManager

api.fingerprintManager({
    autoRotate: true,
    rotationInterval: 6 * 60 * 60 * 1000, // 6 hours
    consistency: 'high',
    browserProfile: 'chrome',
    platform: 'Windows',
    onRotation: (newFingerprint) => {
        console.log('Fingerprint rotated:', newFingerprint);
    }
});

RequestObfuscator

api.requestObfuscator({
    enabled: true,
    entropyLevel: 'high',
    headerRandomization: true,
    payloadEncryption: true,
    parameterShuffle: true,
    timestampFuzz: {
        enabled: true,
        variance: 500
    }
});

PatternDiffuser

api.patternDiffuser({
    enabled: true,
    humanLikeDelays: {
        min: 800,
        max: 3500,
        distribution: 'normal'
    },
    burstPrevention: {
        maxBurst: 5,
        cooldownPeriod: 10000
    },
    typingSimulation: {
        enabled: true,
        wpm: 45,
        variance: 15
    }
});

SmartRateLimiter

api.smartRateLimiter({
    enabled: true,
    adaptive: true,
    limits: {
        messagesPerMinute: 10,
        messagesPerHour: 200,
        messagesPerDay: 1500,
        newAccountMultiplier: 0.5,
        groupMessagesMultiplier: 0.7
    },
    burstAllowance: {
        enabled: true,
        maxBurst: 20,
        cooldown: 600000
    }
});

🎯 Main Features

Messaging

// Magpadala ng text message
await api.magpadalaNgMensahe('Hello!', threadID);

// Magpadala ng message with options
await api.sendMessage({
    body: 'Hello @User!',
    mentions: [{ id: 'userID', tag: '@User' }]
}, threadID);

// Makinig sa mga mensahe
api.makinigSaMensahe((err, message) => {
    console.log(message.body);
});

User Information

// Kunin ang user info
const userInfo = await api.kuninAngUserInfo(['userID1', 'userID2']);

// Or using English method name
const userInfo = await api.getUserInfo(['userID1', 'userID2']);

Thread Management

// Kunin ang thread info
const threadInfo = await api.kuninAngThreadInfo(threadID);

// Kunin ang thread list
const threads = await api.getThreadList(20, null, []);

Group Management

// Gumawa ng group
const groupID = await api.gumawaNgGroup(['user1', 'user2'], 'Group Name');

// Magdagdag ng member
await api.magdagdagNgMember(threadID, 'newUserID');

// Magtanggal ng member
await api.magtanggalNgMember(threadID, 'userID');

// Palitan ang group name
await api.palitanAngGroupName(threadID, 'New Group Name');

🌟 Special Filipino Functions

Mga Special na Pangalang Tagalog

| Tagalog Method | English Equivalent | Description | |----------------|-------------------|-------------| | magpadalaNgMensahe() | sendMessage() | Send message | | makinigSaMensahe() | listenMqtt() | Listen to messages | | kuninAngUserInfo() | getUserInfo() | Get user info | | kuninAngThreadInfo() | getThreadInfo() | Get thread info | | kuninAngThreadList() | getThreadList() | Get thread list | | gumawaNgGroup() | createGroup() | Create group | | magdagdagNgMember() | addUserToGroup() | Add member | | magtanggalNgMember() | removeUserFromGroup() | Remove member | | palitanAngGroupName() | setTitle() | Change group name | | magpadalaNgLarawan() | sendPhoto() | Send photo | | magpadalaNgVideo() | sendVideo() | Send video | | magpadalaNgSticker() | sendSticker() | Send sticker | | magpostsaTimeline() | postToTimeline() | Post to timeline | | magpadalaNgFriendRequest() | sendFriendRequest() | Send friend request | | tanggapinAngFriendRequest() | acceptFriendRequest() | Accept friend request | | kuninAngFriendRequests() | getFriendRequests() | Get friend requests | | kuninAngNotifications() | getNotifications() | Get notifications |

🛡️ Security Features

• Rate Limiting - Prevent spam detection
• Request Delay - Configurable delays between requests
• Proxy Support - Use proxy servers
• User Agent Rotation - Avoid detection
• Cookie Management - Handle session cookies
• Auto-Refresh Cookies - Automatic session refresh
• Fingerprint Rotation - Browser fingerprint spoofing
• Traffic Analysis Resistance - Timing jitter and variability

📋 API Reference

Login Methods

• login(credentials, options, callback) - Login with credentials or appState
• loginFromAppState(path, options, callback) - Login from appState file
• loginWithTwoFactor(credentials, code, options, callback) - Login with 2FA code
• loginWithCheckpointHandler(credentials, handler, options, callback) - Login with checkpoint handler

Messaging Methods

• sendMessage(message, threadID, callback) / magpadalaNgMensahe()
• listenMqtt(callback) / makinigSaMensahe()
• setMessageReaction(reaction, messageID, callback)
• unsendMessage(messageID, callback)
• markAsRead(threadID, callback)
• markAsReadAll(callback)

Photo/Video Methods

• sendPhoto(path, threadID, caption, callback) / magpadalaNgLarawan()
• sendVideo(path, threadID, caption, callback) / magpadalaNgVideo()

Sticker Methods

• sendSticker(stickerID, threadID, callback) / magpadalaNgSticker()
• getStickerURL(stickerID, callback) - Get sticker image URL

Timeline Methods

• postToTimeline(message, options, callback) / magpostsaTimeline()
• editPost(postID, newMessage, callback)
• deletePost(postID, callback)

Friend Request Methods

• sendFriendRequest(userID, callback) / magpadalaNgFriendRequest()
• acceptFriendRequest(userID, callback) / tanggapinAngFriendRequest()
• declineFriendRequest(userID, callback)
• cancelFriendRequest(userID, callback)
• unfriend(userID, callback)
• getFriendRequests(callback) / kuninAngFriendRequests()
• getFriendsList(callback)

Notification Methods

• getNotifications(limit, callback) / kuninAngNotifications()
• markNotificationAsRead(notificationID, callback)
• markAllNotificationsAsRead(callback)
• onNotification(callback) - Real-time notification listener

Webhook Methods

• registerWebhook(config) - Register webhook endpoint
• unregisterWebhook(webhookID) - Remove webhook
• getWebhooks() - List registered webhooks

User Methods

• getUserInfo(userIDs, callback) / kuninAngUserInfo()
• getUserID() - Get current user ID

Thread Methods

• getThreadInfo(threadID, callback) / kuninAngThreadInfo()
• getThreadList(limit, timestamp, tags, callback) / kuninAngThreadList()

Group Methods

• createGroup(participantIDs, name, callback) / gumawaNgGroup()
• addUserToGroup(userIDs, threadID, callback) / magdagdagNgMember()
• removeUserFromGroup(userID, threadID, callback) / magtanggalNgMember()
• setTitle(title, threadID, callback) / palitanAngGroupName()

Cookie Methods

• autoRefreshCookies(config) - Configure auto refresh
• refreshCookies() - Manual refresh
• getCookieStatus() - Get cookie status
• checkCookieHealth() - Check cookie health
• exportCookies() - Export cookies
• saveCookies(path) - Save to file
• loadCookies(path) - Load from file
• rotateCookies(options) - Rotate cookies

Anti-Detection Methods

• fingerprintManager(config) - Configure fingerprint manager
• requestObfuscator(config) - Configure request obfuscator
• patternDiffuser(config) - Configure pattern diffuser
• smartRateLimiter(config) - Configure rate limiter

🎤 Voice Message Support

// Send voice message
await api.sendVoice('./audio.mp3', threadID, { duration: 30 });
await api.magpadalaNgBoses('./audio.mp3', threadID);

📎 File Attachment Support

// Send documents and files
await api.sendFile('./document.pdf', threadID, { filename: 'Report.pdf' });
await api.magpadalaNgFile('./spreadsheet.xlsx', threadID);

Supported formats: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT, ZIP, RAR (up to 100MB)

📱 Story/Reels Posting

Stories

// Post a story
const story = await api.postStory('./photo.jpg', {
  privacy: 'friends',
  textOverlay: 'Hello World!',
  expiresIn: 24 * 60 * 60 * 1000 // 24 hours
});

// Get stories
const stories = await api.getStories();
await api.kuninAngStories(userID);

// Delete story
await api.deleteStory(storyID);

Reels

// Post a reel
const reel = await api.postReel('./video.mp4', {
  caption: 'Check this out!',
  privacy: 'public'
});

// Get reels
const reels = await api.getReels();
await api.kuninAngReels(userID);

🛒 Marketplace Integration

// Create a listing
const listing = await api.createListing({
  title: 'iPhone 15 Pro',
  description: 'Brand new, sealed',
  price: 65000,
  currency: 'PHP',
  category: 'electronics',
  condition: 'new',
  photos: ['./photo1.jpg', './photo2.jpg'],
  location: 'Manila'
});

// Search marketplace
const results = await api.searchMarketplace({
  query: 'iPhone',
  category: 'electronics',
  minPrice: 20000,
  maxPrice: 80000,
  sortBy: 'price_low'
});

// Get my listings
const myListings = await api.getMyListings();
await api.kuninAngMgaListingsKo();

// Mark as sold
await api.markAsSold(listingID);

🎮 Gaming & Watch Together

Watch Together

// Start watch party
const session = await api.startWatchTogether(threadID, {
  videoUrl: 'https://youtube.com/watch?v=...',
  videoTitle: 'Movie Night',
  autoStart: true
});

// Control playback
await api.controlWatchTogether(sessionID, 'play');
await api.controlWatchTogether(sessionID, 'pause');
await api.controlWatchTogether(sessionID, 'seek', 120); // Seek to 2:00

Gaming

// Get available games
const games = await api.getAvailableGames();

// Start a game
const game = await api.startGame(threadID, 'trivia');

// Send game invite
await api.sendGameInvite(threadID, 'wordguess');

📊 Analytics Dashboard

// Get analytics
const analytics = await api.getAnalytics('week');
console.log(analytics.messageStats);
console.log(analytics.performanceStats);

// Export analytics
await api.exportAnalytics('json', './analytics.json');
await api.exportAnalytics('csv', './analytics.csv');

// Reset analytics
await api.resetAnalytics();

🔌 Plugin System

// Create a plugin
const myPlugin = {
  id: 'auto-reply',
  name: 'Auto Reply Plugin',
  version: '1.0.0',
  description: 'Automatically replies to messages',
  author: 'Your Name',
  enabled: true,
  hooks: [{
    event: 'onMessageReceived',
    priority: 10,
    handler: async (message, api) => {
      if (message.body.toLowerCase() === 'hello') {
        await api.sendMessage('Hi there!', message.threadID);
      }
      return message;
    }
  }]
};

// Register plugin
api.registerPlugin(myPlugin);

// Manage plugins
api.enablePlugin('auto-reply');
api.disablePlugin('auto-reply');
api.unregisterPlugin('auto-reply');

// List plugins
const plugins = api.getPlugins();

📺 Live Video Streaming

// Start a live stream
const stream = await api.startLiveStream({
  title: 'My Live Stream',
  description: 'Streaming with Liwanag!',
  privacy: 'friends'
});
await api.magsimulaNgLiveStream(options);

console.log('RTMP URL:', stream.rtmpUrl);
console.log('Stream Key:', stream.streamKey);

// Listen for stream events
api.onLiveStreamEvent(stream.streamId, (event) => {
  console.log('Viewers:', event.viewerCount);
  console.log('Comments:', event.comments);
});

// End the stream
await api.endLiveStream(stream.streamId);
await api.tapusinAngLiveStream(streamId);

// Get active streams
const streams = await api.getLiveStreams();
await api.kuninAngMgaLiveStream();

🤖 NLP Chatbot Integration

// Configure chatbot
api.configureChatbot({
  enabled: true,
  language: 'tl', // Tagalog
  fallbackResponse: 'Pasensya, hindi ko maintindihan.',
  provider: 'builtin'
});
api.iConfigAngChatbot(options);

// Add intents
api.addChatbotIntent({
  name: 'greeting',
  patterns: ['hello', 'hi', 'kumusta', 'musta'],
  responses: ['Hello!', 'Kumusta ka?', 'Hi din!']
});

// Process messages
const response = await api.processChatbotMessage('Kumusta po?');
console.log(response.reply); // 'Kumusta ka?'
console.log(response.intent); // 'greeting'
console.log(response.confidence); // 0.95

// Manage context
const context = api.getChatbotContext(userId);
api.clearChatbotContext(userId);

👥 Multi-Account Management

// Add accounts
await api.addAccount(appState1, { name: 'Primary' });
await api.addAccount(appState2, { name: 'Secondary' });
await api.magdagdagNgAccount(appState, options);

// Switch between accounts
await api.switchAccount(accountId);
await api.lumipatNgAccount(accountId);

// Get all accounts
const accounts = await api.getAccounts();
await api.kuninAngMgaAccount();

// Get active account
const active = api.getActiveAccount();

// Get account statistics
const stats = await api.getAccountStats(accountId);

// Configure account manager
api.configureAccountManager({
  maxAccounts: 5,
  autoRotation: false,
  failover: true
});

📝 Automated Response Templates

// Add a template
api.addTemplate({
  id: 'welcome',
  name: 'Welcome Message',
  trigger: {
    type: 'keyword',
    value: 'hello',
    matchType: 'contains'
  },
  response: {
    type: 'text',
    content: 'Welcome to our page! How can I help you?'
  },
  enabled: true
});
api.magdagdagNgTemplate(template);

// Get templates
const templates = api.getTemplates();
await api.kuninAngMgaTemplate();

// Enable/disable templates
api.enableTemplate('welcome');
api.disableTemplate('welcome');

// Test template matching
const result = api.testTemplate('Hello po!');
console.log(result.matched); // true
console.log(result.response); // 'Welcome to our page!'

⏰ Message Scheduling

// Schedule a message
const scheduled = await api.scheduleMessage({
  threadId: '123456789',
  message: 'Good morning!',
  scheduledTime: new Date('2025-12-25 08:00:00'),
  recurrence: 'daily'
});
await api.magScheduleNgMensahe(options);

// Get scheduled messages
const messages = await api.getScheduledMessages();
await api.kuninAngMgaScheduledMessage();

// Update scheduled message
await api.updateScheduledMessage(messageId, { message: 'Updated message' });

// Cancel scheduled message
await api.cancelScheduledMessage(messageId);

// Configure scheduler
api.configureScheduler({
  enabled: true,
  timezone: 'Asia/Manila',
  retryOnFail: true
});

🛡️ Advanced Spam Detection

// Configure spam detection
api.configureSpamDetection({
  enabled: true,
  sensitivity: 'medium', // low, medium, high
  actions: ['notify', 'delete'],
  customPatterns: [{ type: 'keyword', value: 'spam', action: 'block' }]
});
api.iConfigAngSpamDetection(options);

// Check if message is spam
const result = await api.checkForSpam('Free money! Click here!');
await api.suriiinKungSpam(message);
console.log(result.isSpam); // true
console.log(result.score); // 0.95
console.log(result.reasons); // ['Contains spam pattern']

// Manage whitelist/blacklist
api.addToWhitelist(userId);
api.addToBlacklist(userId);
api.removeFromWhitelist(userId);
api.removeFromBlacklist(userId);

// Get spam reports
const reports = await api.getSpamReports();
await api.resolveSpamReport(reportId, 'dismiss');

📊 Group Analytics

// Get group analytics
const analytics = await api.getGroupAnalytics(threadId, 'month');
await api.kuninAngGroupAnalytics(threadId, period);

console.log(analytics.memberStats);   // { total, active, new, left }
console.log(analytics.activityStats); // { messages, photos, videos }
console.log(analytics.peakTimes);     // ['20:00', '21:00']
console.log(analytics.sentiment);     // { positive: 0.6, neutral: 0.3, negative: 0.1 }

// Get top contributors
const contributors = await api.getTopContributors(threadId, 10);
await api.kuninAngTopContributors(threadId, limit);

// Get group sentiment
const sentiment = await api.getGroupSentiment(threadId);

// Export analytics
await api.exportGroupAnalytics(threadId, 'json', './group-analytics.json');
await api.exportGroupAnalytics(threadId, 'csv', './group-analytics.csv');

🌉 Cross-Platform Messaging Bridge

// Configure bridge
api.configureBridge({
  syncMode: 'two_way',
  attachmentHandling: 'forward',
  messageFilter: (msg) => !msg.body.includes('secret')
});
api.iConfigAngBridge(options);

// Add platforms
api.addPlatform({
  type: 'telegram',
  credentials: { botToken: 'your-token' },
  channelMappings: [{ from: 'fb-thread-id', to: '-100123456789' }]
});
api.addPlatform({
  type: 'discord',
  credentials: { botToken: 'your-token' },
  channelMappings: [{ from: 'fb-thread-id', to: 'discord-channel-id' }]
});

// Send cross-platform message
await api.sendCrossPlatformMessage({
  message: 'Hello from Facebook!',
  targetPlatform: 'telegram',
  targetChannel: '-100123456789'
});
await api.magpadalaSaIbangPlatform(options);

// Get bridge statistics
const stats = await api.getBridgeStats();
await api.kuninAngBridgeStats();
console.log(stats.messagesBridged);
console.log(stats.platformsActive);

// Get bridged messages
const messages = await api.getBridgedMessages();

Supported Platforms: Telegram, Discord, Slack, WhatsApp, Viber, LINE, Messenger

📞 Voice & Video Calls

// Start a voice call
const voiceCall = await api.startVoiceCall(threadID, { encrypted: true });
await api.magsimulaNgVoiceCall(threadID, options);

// Start a video call
const videoCall = await api.startVideoCall(threadID);
await api.magsimulaNgVideoCall(threadID, options);

// Join an existing call
await api.joinCall(callID);
await api.sumaliSaTawag(callID);

// Call controls
await api.toggleMute(callID, true);   // Mute
await api.toggleVideo(callID, false); // Turn off video

// Listen for call events
api.onCallEvent(callID, (event) => {
  console.log('Event:', event.type);
  console.log('Participant:', event.participantID);
});

// End the call
await api.endCall(callID);
await api.tapusinAngTawag(callID);

// Get active calls
const calls = api.getActiveCalls();
await api.kuninAngMgaTawag();

🖥️ Screen Sharing

// Start screen sharing during a call
const screenShare = await api.startScreenShare(callID, {
  quality: 'high',
  audio: true,
  optimizeFor: 'detail'
});
await api.magsimulaNgScreenShare(callID, options);

// Pause/Resume screen sharing
await api.pauseScreenShare(callID);
await api.resumeScreenShare(callID);

// Stop screen sharing
await api.stopScreenShare(callID);
await api.itigilAngScreenShare(callID);

🤖 AI Content Moderation

// Configure moderation
api.configureModeration({
  enabled: true,
  provider: 'builtin',
  sensitivity: 'medium',
  categories: ['hate_speech', 'spam', 'harassment'],
  actions: [
    { category: 'hate_speech', action: 'delete', threshold: 0.8 },
    { category: 'spam', action: 'flag', threshold: 0.7 }
  ],
  autoModerate: true,
  notifyAdmins: true
});
api.iConfigAngModeration(config);

// Evaluate a message
const result = await api.evaluateMessage(message, senderID, threadID);
await api.suriiinAngMensahe(message, senderID, threadID);
console.log(result.flagged);      // true/false
console.log(result.overallScore); // 0.0 - 1.0
console.log(result.categories);   // Detected categories

// Get moderation queue
const queue = api.getModerationQueue('pending');
await api.kuninAngModerationQueue('pending');

// Review flagged content
await api.approveFlaggedMessage(resultID);
await api.rejectFlaggedMessage(resultID);

// Get moderation statistics
const stats = api.getModerationStats();
await api.kuninAngModerationStats();

// Add custom moderation rule
api.addModerationRule({
  id: 'no-links',
  name: 'Block External Links',
  type: 'regex',
  pattern: 'https?://[^\\s]+',
  category: 'spam',
  action: 'flag',
  severity: 'medium',
  enabled: true
});

🔐 End-to-End Encryption

// Configure encryption
api.configureEncryption({
  enabled: true,
  algorithm: 'aes-256-gcm',
  keyExchange: 'x25519',
  autoRotateKeys: true,
  rotationInterval: 24 * 60 * 60 * 1000 // 24 hours
});
api.iConfigAngEncryption(config);

// Enable encryption for a thread
const status = await api.enableEncryption(threadID);
await api.paganahinAngEncryption(threadID);
console.log(status.enabled);   // true
console.log(status.verified);  // true

// Check encryption status
const encStatus = api.getEncryptionStatus(threadID);
await api.kuninAngEncryptionStatus(threadID);

// Rotate encryption keys
const newKeys = await api.rotateEncryptionKeys(threadID);

// Verify participant
const verified = await api.verifyParticipant(threadID, userID);

// Get all encrypted threads
const threads = api.getEncryptedThreads();

// Disable encryption
await api.disableEncryption(threadID);
await api.patayinAngEncryption(threadID);

🏪 Bot Marketplace

// Configure marketplace
api.configureBotMarketplace({
  enabled: true,
  maxInstalledBots: 10,
  autoUpdate: true,
  sandboxMode: false
});
api.iConfigAngBotMarketplace(config);

// Search for bots
const bots = await api.searchBots({
  query: 'moderation',
  category: 'moderation',
  minRating: 4.0,
  verified: true,
  sortBy: 'rating'
});
await api.hanapiNgMgaBot(options);

// Get bot details
const botDetails = await api.getBotDetails(botID);
await api.kuninAngBotDetails(botID);

// Install a bot
const installed = await api.installBot(botID, { autoReply: true });
await api.iInstallAngBot(botID, config);

// Get installed bots
const myBots = api.getInstalledBots();
await api.kuninAngMgaInstalledBot();

// Enable/disable bot
api.enableBot(botID);
api.disableBot(botID);

// Configure bot for specific thread
api.configureBotForThread(botID, threadID, { prefix: '!' });

// Submit a review
await api.submitBotReview(botID, 5, 'Great bot!');

// Uninstall bot
await api.uninstallBot(botID);
await api.iUninstallAngBot(botID);

🔄 Webhook Transformations

// Configure webhook transformations
api.configureWebhookTransforms({
  enabled: true,
  transformations: [],
  errorHandling: 'skip',
  logging: true
});
api.iConfigAngWebhookTransforms(config);

// Add a transformation
api.addWebhookTransformation({
  id: 'uppercase-sender',
  name: 'Uppercase Sender Name',
  priority: 1,
  enabled: true,
  type: 'map',
  config: {
    mappings: [
      { source: 'senderName', target: 'senderName', transform: 'uppercase' },
      { source: 'message', target: 'content' }
    ],
    enrichments: [
      { field: 'processedAt', source: 'timestamp' }
    ]
  }
});
api.magdagdagNgTransformation(transformation);

// Test transformation
const result = api.testWebhookTransformation('uppercase-sender', {
  senderName: 'john doe',
  message: 'Hello!'
});
console.log(result.transformedPayload);
// { senderName: 'JOHN DOE', content: 'Hello!', processedAt: 1702... }

// Get all transformations
const transforms = api.getWebhookTransformations();
await api.kuninAngMgaTransformation();

// Enable/disable transformation
api.enableWebhookTransformation('uppercase-sender');
api.disableWebhookTransformation('uppercase-sender');

🌟 New Filipino Functions (v0.5.0)

| Tagalog Method | English Equivalent | Description | |----------------|-------------------|-------------| | magsimulaNgVoiceCall() | startVoiceCall() | Start voice call | | magsimulaNgVideoCall() | startVideoCall() | Start video call | | sumaliSaTawag() | joinCall() | Join call | | tapusinAngTawag() | endCall() | End call | | kuninAngMgaTawag() | getActiveCalls() | Get active calls | | magsimulaNgScreenShare() | startScreenShare() | Start screen share | | itigilAngScreenShare() | stopScreenShare() | Stop screen share | | iConfigAngModeration() | configureModeration() | Configure moderation | | suriiinAngMensahe() | evaluateMessage() | Evaluate message | | kuninAngModerationQueue() | getModerationQueue() | Get moderation queue | | kuninAngModerationStats() | getModerationStats() | Get moderation stats | | iConfigAngEncryption() | configureEncryption() | Configure encryption | | paganahinAngEncryption() | enableEncryption() | Enable encryption | | patayinAngEncryption() | disableEncryption() | Disable encryption | | kuninAngEncryptionStatus() | getEncryptionStatus() | Get encryption status | | iConfigAngBotMarketplace() | configureBotMarketplace() | Configure marketplace | | hanapiNgMgaBot() | searchBots() | Search bots | | kuninAngBotDetails() | getBotDetails() | Get bot details | | iInstallAngBot() | installBot() | Install bot | | iUninstallAngBot() | uninstallBot() | Uninstall bot | | kuninAngMgaInstalledBot() | getInstalledBots() | Get installed bots | | iConfigAngWebhookTransforms() | configureWebhookTransforms() | Configure transforms | | magdagdagNgTransformation() | addWebhookTransformation() | Add transformation | | kuninAngMgaTransformation() | getWebhookTransformations() | Get transformations |

🌟 Filipino Functions (v0.4.0)

| Tagalog Method | English Equivalent | Description | |----------------|-------------------|-------------| | magsimulaNgLiveStream() | startLiveStream() | Start live video | | tapusinAngLiveStream() | endLiveStream() | End live stream | | kuninAngMgaLiveStream() | getLiveStreams() | Get active streams | | iConfigAngChatbot() | configureChatbot() | Configure chatbot | | magdagdagNgAccount() | addAccount() | Add account | | lumipatNgAccount() | switchAccount() | Switch account | | kuninAngMgaAccount() | getAccounts() | Get all accounts | | magdagdagNgTemplate() | addTemplate() | Add response template | | kuninAngMgaTemplate() | getTemplates() | Get templates | | magScheduleNgMensahe() | scheduleMessage() | Schedule message | | kuninAngMgaScheduledMessage() | getScheduledMessages() | Get scheduled messages | | iConfigAngSpamDetection() | configureSpamDetection() | Configure spam detection | | suriiinKungSpam() | checkForSpam() | Check if spam | | kuninAngGroupAnalytics() | getGroupAnalytics() | Get group analytics | | kuninAngTopContributors() | getTopContributors() | Get top contributors | | iConfigAngBridge() | configureBridge() | Configure bridge | | magpadalaSaIbangPlatform() | sendCrossPlatformMessage() | Send cross-platform | | kuninAngBridgeStats() | getBridgeStats() | Get bridge stats |

🌟 Filipino Functions (v0.3.0)

| Tagalog Method | English Equivalent | Description | |----------------|-------------------|-------------| | magpadalaNgBoses() | sendVoice() | Send voice message | | magpadalaNgFile() | sendFile() | Send file attachment | | magpostNgStory() | postStory() | Post story | | kuninAngStories() | getStories() | Get stories | | magpostNgReel() | postReel() | Post reel | | kuninAngReels() | getReels() | Get reels | | gumawaNgListing() | createListing() | Create marketplace listing | | hanapiNgListings() | searchMarketplace() | Search marketplace | | kuninAngMgaListingsKo() | getMyListings() | Get my listings | | magsimulaNgWatchTogether() | startWatchTogether() | Start watch party | | magsimulaNgLaro() | startGame() | Start game | | kuninAngMgaLaro() | getAvailableGames() | Get available games | | kuninAngAnalytics() | getAnalytics() | Get analytics |

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🙏 Salamat!

Maraming salamat sa paggamit ng Liwanag! Made with ❤️ for Filipino developers.