zaileys 1.1.40-tx.9 → 2.0.0

package/README.MD

@@ -16,7 +16,7 @@
 
 <div align="center">
   <p>
-    <b>Zaileys</b> is a powerful, type-safe wrapper around Baileys, designed to simplify the development of WhatsApp bots. It provides a robust architecture with built-in state management, middleware support, and easy-to-use event handlers, making it perfect for building scalable and maintainable WhatsApp applications.
+    <b>Zaileys</b> is a powerful, type-safe wrapper around <a href="https://github.com/WhiskeySockets/Baileys">Baileys</a>, designed to simplify the development of WhatsApp bots. It provides a robust architecture with built-in state management, middleware support, and easy-to-use event handlers, making it perfect for building scalable and maintainable WhatsApp applications.
   </p>
 </div>
 
@@ -28,9 +28,12 @@
 [🪶 Features](#-features) &nbsp;&nbsp;•&nbsp;&nbsp;
 [📦 Installation](#-installation) &nbsp;&nbsp;•&nbsp;&nbsp;
 [⚡ Quick Start](#-quick-start) &nbsp;&nbsp;•&nbsp;&nbsp;
+[🧩 Plugins](#-plugins) &nbsp;&nbsp;•&nbsp;&nbsp;
 [📨 Sending Messages](#-sending-messages) &nbsp;&nbsp;•&nbsp;&nbsp;
 [👥 Group Management](#-group-management) &nbsp;&nbsp;•&nbsp;&nbsp;
-[🧩 Plugins](#-plugins) &nbsp;&nbsp;•&nbsp;&nbsp;
+[📰 Newsletter Management](#-newsletter-channel) &nbsp;&nbsp;•&nbsp;&nbsp;
+[🌐 Community Management](#-community-management) &nbsp;&nbsp;•&nbsp;&nbsp;
+[🔒 Privacy](#-privacy-settings) &nbsp;&nbsp;•&nbsp;&nbsp;
 [🤝 Contributing](#-contributing)
 
 </div>
@@ -92,6 +95,8 @@ Here is a minimal example to get your bot running with QR code authentication:
 
 ```typescript
 import { Client } from 'zaileys';
+// or
+const { Client } = require('zaileys');
 
 const wa = new Client({
   authType: 'qr',
@@ -548,7 +553,7 @@ Create a new group with initial participants.
 
 ```typescript
 // Create group with name and participants
-const group = await wa.group.create('My Group', [6281234567890, 6289876543210]);
+const group = await wa.group.create('My Group', ['senderId']);
 console.log('Group created:', group);
 ```
 
@@ -560,16 +565,16 @@ Add, remove, promote, or demote participants.
 const groupId = '1234567890@g.us';
 
 // Add participants
-await wa.group.participant(groupId, [6281234567890], 'add');
+await wa.group.participant(groupId, ['senderId'], 'add');
 
 // Remove participants
-await wa.group.participant(groupId, [6281234567890], 'remove');
+await wa.group.participant(groupId, [...], 'remove');
 
 // Promote to admin
-await wa.group.participant(groupId, [6281234567890], 'promote');
+await wa.group.participant(groupId, [...], 'promote');
 
 // Demote to member
-await wa.group.participant(groupId, [6281234567890], 'demote');
+await wa.group.participant(groupId, [...], 'demote');
 ```
 
 ### Group Profile
@@ -648,10 +653,10 @@ Manage pending join requests.
 const requests = await wa.group.requestJoinList(groupId);
 
 // Approve requests
-await wa.group.requestJoin(groupId, [6281234567890], 'approve');
+await wa.group.requestJoin(groupId, ['senderId'], 'approve');
 
 // Reject requests
-await wa.group.requestJoin(groupId, [6281234567890], 'reject');
+await wa.group.requestJoin(groupId, [...], 'reject');
 ```
 
 ### Fetch All Groups
@@ -689,6 +694,278 @@ Leave group.
 await wa.group.leave(groupId);
 ```
 
+## 📰 Newsletter (Channel)
+
+Create and manage WhatsApp Channels (Newsletters).
+
+> **Quick Jump:** [Create](#create-channel) · [Actions](#channel-actions) · [Update](#update-channel) · [Info](#channel-info) · [Messages](#manage-messages) · [Admin](#admin-actions)
+
+### Create Channel
+
+```typescript
+const channel = await wa.newsletter.create('My Channel', 'Description here');
+console.log('Channel created:', channel);
+```
+
+### Channel Actions
+
+Follow, unfollow, mute, or unmute a channel.
+
+```typescript
+const channelId = '1234567890@newsletter';
+
+// Follow
+await wa.newsletter.action(channelId, 'follow');
+
+// Unfollow
+await wa.newsletter.action(channelId, 'unfollow');
+
+// Mute
+await wa.newsletter.action(channelId, 'mute');
+
+// Unmute
+await wa.newsletter.action(channelId, 'unmute');
+```
+
+### Update Channel
+
+Update channel info.
+
+```typescript
+// Update name
+await wa.newsletter.update(channelId, 'New Name', 'name');
+
+// Update description
+await wa.newsletter.update(channelId, 'New Description', 'description');
+
+// Update picture (URL/Buffer)
+await wa.newsletter.update(channelId, 'https://example.com/image.jpg', 'picture');
+
+// Remove picture
+await wa.newsletter.removePicture(channelId);
+```
+
+### Channel Info
+
+Get channel details.
+
+```typescript
+// Get metadata by ChannelId
+const meta = await wa.newsletter.metadata(channelId, 'jid');
+
+// Get metadata by Invite Code
+const metaInvite = await wa.newsletter.metadata('INVITE_CODE', 'invite');
+
+// Get subscribers
+const subs = await wa.newsletter.subscribers(channelId);
+
+// Get admin count
+const adminCount = await wa.newsletter.adminCount(channelId);
+```
+
+### Manage Messages
+
+Fetch messages or react to them.
+
+```typescript
+// Fetch messages
+const since = new Date() - 1000 * 60 * 60 * 24; // 1 day
+const after = new Date();
+
+const count = 10;
+
+const messages = await wa.newsletter.fetchMessages(channelId, count, since, after);
+
+// React to message
+await wa.newsletter.reaction(channelId, 'chatId', '👍');
+```
+
+### Admin Actions
+
+Manage channel ownership and admins.
+
+```typescript
+// Change owner
+await wa.newsletter.changeOwner(channelId, 'senderId');
+
+// Demote admin
+await wa.newsletter.demote(channelId, 'senderId');
+
+// Delete channel
+await wa.newsletter.delete(channelId);
+```
+
+## 🌐 Community Management
+
+Create and manage WhatsApp Communities.
+
+> **Quick Jump:** [Create](#create-community) · [Create Group](#create-group-in-community) · [Groups](#manage-groups) · [Info](#community-info) · [Participants](#manage-participants-1) · [Invite](#invite-code-1) · [Settings](#community-settings) · [Leave](#leave-community)
+
+### Create Community
+
+```typescript
+const community = await wa.community.create('My Community', 'Description here');
+console.log('Community created:', community);
+```
+
+### Create Group in Community
+
+Create a new group linked to a community.
+
+```typescript
+const communityId = '1234567890@g.us';
+const group = await wa.community.createGroup('New Group', ['senderId'], communityId);
+```
+
+### Manage Groups
+
+Link or unlink groups from a community.
+
+```typescript
+const groupId = '0987654321@g.us';
+
+// Link group
+await wa.community.group(communityId, 'link', groupId);
+
+// Unlink group
+await wa.community.group(communityId, 'unlink', groupId);
+
+// Get linked groups
+const linkedGroups = await wa.community.group(communityId, 'linked');
+```
+
+### Community Info
+
+Get metadata or update info.
+
+```typescript
+// Get metadata
+const meta = await wa.community.metadata(communityId);
+
+// Update subject
+await wa.community.update(communityId, 'subject', 'New Name');
+
+// Update description
+await wa.community.update(communityId, 'description', 'New Description');
+```
+
+### Manage Participants
+
+Manage community participants.
+
+```typescript
+// List participants
+const participants = await wa.community.participants(communityId, 'list');
+
+// Add participant
+await wa.community.participants(communityId, 'update', 'add', ['senderId']);
+
+// Remove participant
+await wa.community.participants(communityId, 'update', 'remove', ['senderId']);
+
+// Promote to admin
+await wa.community.participants(communityId, 'update', 'promote', ['senderId']);
+
+// Demote to member
+await wa.community.participants(communityId, 'update', 'demote', ['senderId']);
+```
+
+### Invite Code
+
+Manage community invite links.
+
+```typescript
+// Get invite code
+const code = await wa.community.invite(communityId, 'code');
+
+// Revoke invite code
+await wa.community.invite(communityId, 'revoke');
+
+// Get invite info
+const info = await wa.community.invite('INVITE_CODE', 'info');
+
+// Join via invite code
+await wa.community.invite('INVITE_CODE', 'accept');
+```
+
+### Community Settings
+
+Configure community settings.
+
+```typescript
+// Toggle ephemeral messages
+await wa.community.settings(communityId, 'ephemeral', 86400); // 24 hours
+
+// Who can add members? 'all_member_add' or 'admin_add'
+await wa.community.settings(communityId, 'memberAdd', 'admin_add');
+
+// Join approval mode? 'on' or 'off'
+await wa.community.settings(communityId, 'approval', 'on');
+```
+
+### Leave Community
+
+Leave a community.
+
+```typescript
+await wa.community.leave(communityId);
+```
+
+## 🔒 Privacy Settings
+
+Manage your privacy settings and block list.
+
+> **Quick Jump:** [Block/Unblock](#blockunblock) · [Configuration](#privacy-configuration) · [Get Settings](#get-settings)
+
+### Block/Unblock
+
+```typescript
+// Block user
+await wa.privacy.block('senderId');
+
+// Unblock user
+await wa.privacy.unblock('senderId');
+
+// Get blocklist
+const blocklist = await wa.privacy.blocklist();
+```
+
+### Privacy Configuration
+
+Update privacy settings.
+
+```typescript
+// Last Seen: 'all', 'contacts', 'contact_blacklist', 'none'
+await wa.privacy.lastSeen('contacts');
+
+// Online: 'all', 'match_last_seen'
+await wa.privacy.online('match_last_seen');
+
+// Profile Picture: 'all', 'contacts', 'contact_blacklist', 'none'
+await wa.privacy.picture('all');
+
+// Status: 'all', 'contacts', 'contact_blacklist', 'none'
+await wa.privacy.status('contacts');
+
+// Read Receipts: 'all', 'none'
+await wa.privacy.readReceipt('all');
+
+// Group Add: 'all', 'contacts', 'contact_blacklist', 'none'
+await wa.privacy.groupsAdd('contacts');
+
+// Default Disappearing Mode: 'off', '24h', '7d', '90d'
+await wa.privacy.ephemeral('90d');
+```
+
+### Get Settings
+
+Fetch current privacy settings.
+
+```typescript
+const settings = await wa.privacy.getSettings();
+console.log(settings);
+```
+
 ## 🤝 Contributing
 
 Contributions are welcome! Please follow these steps:

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as baileys from 'baileys';
-import { AuthenticationState, WAMessage, proto, ParticipantAction } from 'baileys';
+import { AuthenticationState, WAMessage, proto, ParticipantAction, WAPrivacyValue, WAPrivacyOnlineValue, WAReadReceiptsValue, WAPrivacyGroupAddValue } from 'baileys';
 import z, { z as z$1 } from 'zod';
 import _ from 'lodash';
 
@@ -94,6 +94,7 @@ declare const ButtonOptionsType: z.ZodIntersection<z.ZodObject<{
             text: z.ZodString;
             section: z.ZodArray<z.ZodObject<{
                 title: z.ZodString;
+                highlight_label: z.ZodOptional<z.ZodString>;
                 rows: z.ZodArray<z.ZodObject<{
                     id: z.ZodString;
                     title: z.ZodString;
@@ -129,18 +130,18 @@ declare class Signal {
 declare class Group {
     protected client: Client;
     constructor(client: Client);
-    create(name: string, participants: number[]): Promise<baileys.GroupMetadata>;
-    participant(roomId: string, participants: number[], action: ParticipantAction): Promise<{
+    create(name: string, participants: string[]): Promise<baileys.GroupMetadata>;
+    participant(roomId: string, participants: string[], action: ParticipantAction): Promise<{
         status: string;
         jid: string | undefined;
         content: baileys.BinaryNode;
     }[]>;
-    profile(roomId: string, update: string | Buffer, type: 'subject' | 'description' | 'avatar'): Promise<void>;
+    profile(roomId: string, update: string | Buffer, type: 'subject' | 'description' | 'picture'): Promise<void>;
     setting(roomId: string, type: 'open' | 'close' | 'locked' | 'unlocked' | 'all_member_add' | 'admin_add'): Promise<void>;
     leave(roomId: string): Promise<void>;
     inviteCode(roomId: string, type: 'code' | 'revoke' | 'accept' | 'info'): Promise<string | baileys.GroupMetadata>;
     metadata(roomId: string): Promise<baileys.GroupMetadata>;
-    requestJoin(roomId: string, participants: number[], type: 'approve' | 'reject'): Promise<{
+    requestJoin(roomId: string, participants: string[], type: 'approve' | 'reject'): Promise<{
         status: string;
         jid: string | undefined;
     }[]>;
@@ -441,7 +442,90 @@ declare class Plugins {
 }
 declare const definePlugins: (handler: PluginsHandlerType, config: PluginsConfigType) => PluginDefinition;
 
-interface Client extends Signal, SignalGroup {
+declare class Privacy {
+    protected client: Client;
+    constructor(client: Client);
+    block(senderId: string): Promise<void>;
+    unblock(senderId: string): Promise<void>;
+    lastSeen(type: WAPrivacyValue): Promise<void>;
+    online(type: WAPrivacyOnlineValue): Promise<void>;
+    picture(type: WAPrivacyValue): Promise<void>;
+    status(type: WAPrivacyValue): Promise<void>;
+    readReceipt(type: WAReadReceiptsValue): Promise<void>;
+    groupsAdd(type: WAPrivacyGroupAddValue): Promise<void>;
+    ephemeral(type: 'off' | '24h' | '7d' | '90d'): Promise<void>;
+    blocklist(): Promise<string[]>;
+    getSettings(): Promise<{
+        [_: string]: string;
+    }>;
+}
+declare class SignalPrivacy {
+    protected plient: Client;
+    privacy: Privacy;
+    constructor(plient: Client);
+}
+
+declare class Newsletter {
+    protected client: Client;
+    constructor(client: Client);
+    create(name: string, description: string): Promise<baileys.NewsletterMetadata>;
+    action(roomId: string, type: 'follow' | 'unfollow' | 'mute' | 'unmute' | ''): Promise<unknown>;
+    update(roomId: string, update: string | Buffer, type: 'name' | 'description' | 'picture'): Promise<unknown>;
+    metadata(roomId: string, type: 'invite' | 'jid'): Promise<baileys.NewsletterMetadata>;
+    subscribers(roomId: string): Promise<{
+        subscribers: number;
+    }>;
+    reaction(roomId: string, chatId: string, reaction: string): Promise<void>;
+    fetchMessages(roomId: string, count: number, since: Date, after: Date): Promise<any>;
+    adminCount(roomId: string): Promise<number>;
+    changeOwner(roomId: string, owner: string): Promise<void>;
+    demote(roomId: string, senderId: string): Promise<void>;
+    delete(roomId: string): Promise<void>;
+    removePicture(roomId: string): Promise<unknown>;
+}
+declare class SignalNewsletter {
+    protected nlient: Client;
+    newsletter: Newsletter;
+    constructor(nlient: Client);
+}
+
+declare class Community {
+    protected client: Client;
+    constructor(client: Client);
+    create(subject: string, description: string): Promise<baileys.GroupMetadata>;
+    createGroup(subject: string, participants: string[], parentId: string): Promise<baileys.GroupMetadata>;
+    leave(id: string): Promise<void>;
+    metadata(id: string): Promise<baileys.GroupMetadata>;
+    update(id: string, type: 'subject' | 'description', value: string): Promise<void>;
+    group(id: string, type: 'link' | 'unlink' | 'linked', groupJid?: string): Promise<void | {
+        communityJid: string;
+        isCommunity: boolean;
+        linkedGroups: {
+            id: string | undefined;
+            subject: string;
+            creation: number | undefined;
+            owner: string | undefined;
+            size: number | undefined;
+        }[];
+    }>;
+    participants(id: string, type: 'list' | 'request-update' | 'update' | 'all', action?: 'add' | 'remove' | 'promote' | 'demote' | 'approve' | 'reject', participants?: string[]): Promise<{
+        [key: string]: string;
+    }[] | {
+        status: string;
+        jid: string | undefined;
+    }[] | {
+        [_: string]: baileys.GroupMetadata;
+    }>;
+    invite(target: string | any, type: 'code' | 'revoke' | 'accept' | 'info' | 'revokeV4' | 'acceptV4', ...args: any[]): Promise<any>;
+    settings(id: string, type: 'ephemeral' | 'update' | 'memberAdd' | 'approval', value?: any): Promise<void>;
+}
+declare class SignalCommunity {
+    protected mlient: Client;
+    community: Community;
+    constructor(mlient: Client);
+}
+
+interface Client extends Signal, SignalGroup, SignalPrivacy, SignalNewsletter, SignalCommunity {
 }
 declare class Client {
     options: z.infer<typeof ClientOptionsType>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as baileys from 'baileys';
-import { AuthenticationState, WAMessage, proto, ParticipantAction } from 'baileys';
+import { AuthenticationState, WAMessage, proto, ParticipantAction, WAPrivacyValue, WAPrivacyOnlineValue, WAReadReceiptsValue, WAPrivacyGroupAddValue } from 'baileys';
 import z, { z as z$1 } from 'zod';
 import _ from 'lodash';
 
@@ -94,6 +94,7 @@ declare const ButtonOptionsType: z.ZodIntersection<z.ZodObject<{
             text: z.ZodString;
             section: z.ZodArray<z.ZodObject<{
                 title: z.ZodString;
+                highlight_label: z.ZodOptional<z.ZodString>;
                 rows: z.ZodArray<z.ZodObject<{
                     id: z.ZodString;
                     title: z.ZodString;
@@ -129,18 +130,18 @@ declare class Signal {
 declare class Group {
     protected client: Client;
     constructor(client: Client);
-    create(name: string, participants: number[]): Promise<baileys.GroupMetadata>;
-    participant(roomId: string, participants: number[], action: ParticipantAction): Promise<{
+    create(name: string, participants: string[]): Promise<baileys.GroupMetadata>;
+    participant(roomId: string, participants: string[], action: ParticipantAction): Promise<{
         status: string;
         jid: string | undefined;
         content: baileys.BinaryNode;
     }[]>;
-    profile(roomId: string, update: string | Buffer, type: 'subject' | 'description' | 'avatar'): Promise<void>;
+    profile(roomId: string, update: string | Buffer, type: 'subject' | 'description' | 'picture'): Promise<void>;
     setting(roomId: string, type: 'open' | 'close' | 'locked' | 'unlocked' | 'all_member_add' | 'admin_add'): Promise<void>;
     leave(roomId: string): Promise<void>;
     inviteCode(roomId: string, type: 'code' | 'revoke' | 'accept' | 'info'): Promise<string | baileys.GroupMetadata>;
     metadata(roomId: string): Promise<baileys.GroupMetadata>;
-    requestJoin(roomId: string, participants: number[], type: 'approve' | 'reject'): Promise<{
+    requestJoin(roomId: string, participants: string[], type: 'approve' | 'reject'): Promise<{
         status: string;
         jid: string | undefined;
     }[]>;
@@ -441,7 +442,90 @@ declare class Plugins {
 }
 declare const definePlugins: (handler: PluginsHandlerType, config: PluginsConfigType) => PluginDefinition;
 
-interface Client extends Signal, SignalGroup {
+declare class Privacy {
+    protected client: Client;
+    constructor(client: Client);
+    block(senderId: string): Promise<void>;
+    unblock(senderId: string): Promise<void>;
+    lastSeen(type: WAPrivacyValue): Promise<void>;
+    online(type: WAPrivacyOnlineValue): Promise<void>;
+    picture(type: WAPrivacyValue): Promise<void>;
+    status(type: WAPrivacyValue): Promise<void>;
+    readReceipt(type: WAReadReceiptsValue): Promise<void>;
+    groupsAdd(type: WAPrivacyGroupAddValue): Promise<void>;
+    ephemeral(type: 'off' | '24h' | '7d' | '90d'): Promise<void>;
+    blocklist(): Promise<string[]>;
+    getSettings(): Promise<{
+        [_: string]: string;
+    }>;
+}
+declare class SignalPrivacy {
+    protected plient: Client;
+    privacy: Privacy;
+    constructor(plient: Client);
+}
+
+declare class Newsletter {
+    protected client: Client;
+    constructor(client: Client);
+    create(name: string, description: string): Promise<baileys.NewsletterMetadata>;
+    action(roomId: string, type: 'follow' | 'unfollow' | 'mute' | 'unmute' | ''): Promise<unknown>;
+    update(roomId: string, update: string | Buffer, type: 'name' | 'description' | 'picture'): Promise<unknown>;
+    metadata(roomId: string, type: 'invite' | 'jid'): Promise<baileys.NewsletterMetadata>;
+    subscribers(roomId: string): Promise<{
+        subscribers: number;
+    }>;
+    reaction(roomId: string, chatId: string, reaction: string): Promise<void>;
+    fetchMessages(roomId: string, count: number, since: Date, after: Date): Promise<any>;
+    adminCount(roomId: string): Promise<number>;
+    changeOwner(roomId: string, owner: string): Promise<void>;
+    demote(roomId: string, senderId: string): Promise<void>;
+    delete(roomId: string): Promise<void>;
+    removePicture(roomId: string): Promise<unknown>;
+}
+declare class SignalNewsletter {
+    protected nlient: Client;
+    newsletter: Newsletter;
+    constructor(nlient: Client);
+}
+
+declare class Community {
+    protected client: Client;
+    constructor(client: Client);
+    create(subject: string, description: string): Promise<baileys.GroupMetadata>;
+    createGroup(subject: string, participants: string[], parentId: string): Promise<baileys.GroupMetadata>;
+    leave(id: string): Promise<void>;
+    metadata(id: string): Promise<baileys.GroupMetadata>;
+    update(id: string, type: 'subject' | 'description', value: string): Promise<void>;
+    group(id: string, type: 'link' | 'unlink' | 'linked', groupJid?: string): Promise<void | {
+        communityJid: string;
+        isCommunity: boolean;
+        linkedGroups: {
+            id: string | undefined;
+            subject: string;
+            creation: number | undefined;
+            owner: string | undefined;
+            size: number | undefined;
+        }[];
+    }>;
+    participants(id: string, type: 'list' | 'request-update' | 'update' | 'all', action?: 'add' | 'remove' | 'promote' | 'demote' | 'approve' | 'reject', participants?: string[]): Promise<{
+        [key: string]: string;
+    }[] | {
+        status: string;
+        jid: string | undefined;
+    }[] | {
+        [_: string]: baileys.GroupMetadata;
+    }>;
+    invite(target: string | any, type: 'code' | 'revoke' | 'accept' | 'info' | 'revokeV4' | 'acceptV4', ...args: any[]): Promise<any>;
+    settings(id: string, type: 'ephemeral' | 'update' | 'memberAdd' | 'approval', value?: any): Promise<void>;
+}
+declare class SignalCommunity {
+    protected mlient: Client;
+    community: Community;
+    constructor(mlient: Client);
+}
+
+interface Client extends Signal, SignalGroup, SignalPrivacy, SignalNewsletter, SignalCommunity {
 }
 declare class Client {
     options: z.infer<typeof ClientOptionsType>;