qadeer-xtech 1.0.0 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 LOFT-OSS Inc
3
+ Copyright (c) 2026 Qadeer Ahmad (Qadeer-XTech)
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -1,68 +1,119 @@
1
- # qadeer-xtech
1
+ ꧁༺ QADEER-XTECH ༻꧂
2
2
 
3
- ### Qadeer-Xtech enhanced WhatsApp library
3
+ <div align="center"><img src="https://img.shields.io/badge/⚡_QADEER--XTECH-0A0F1C?style=for-the-badge&labelColor=05080F" />𓆩♡𓆪 Enhanced WhatsApp Library 𓆩♡𓆪
4
4
 
5
- A clean, locally-modifiable Baileys-compatible package for Node.js **20+**, branded for **Qadeer-Xtech**. It keeps the familiar WhatsApp socket API while adding media fixes, interactive messages, albums, extra message types and the built-in AIRich toolkit.
5
+ A Powerful. Customizable. Next-Generation Baileys-Compatible Library.
6
6
 
7
- > **TEAM QADEER** — build it, brand it, ship it.
7
+ ""NPM Version" (https://img.shields.io/npm/v/qadeer-xtech?style=for-the-badge&color=00E5FF&labelColor=080D18)" (https://www.npmjs.com/package/qadeer-xtech)
8
+ ""Node" (https://img.shields.io/badge/Node.js-20%2B-00D68F?style=for-the-badge&logo=node.js&logoColor=white&labelColor=080D18)" (https://nodejs.org/)
9
+ ""License" (https://img.shields.io/badge/License-MIT-BD93F9?style=for-the-badge&labelColor=080D18)" (LICENSE)
10
+ ""Team" (https://img.shields.io/badge/POWERED%20BY-TEAM%20QADEER-00E5FF?style=for-the-badge&labelColor=080D18)" (#-team-qadeer)
8
11
 
9
- ## Highlights
12
+ <br/>「 Beyond Baileys. Beyond Limits. 」
10
13
 
11
- - Baileys-compatible `makeWASocket()` API
12
- - Qadeer-Xtech terminal banner
13
- - Branded default pairing code: **`QADEERAI`**
14
- - AIRich rich responses: text, images, posts, products, buttons and carousels
15
- - Newsletter/channel media handling and extra message types
16
- - No package repository or homepage metadata
17
- - Source files and marker filenames rebranded for local editing
14
+ Engineered with precision. Customized with passion. Powered by Qadeer-Xtech.
18
15
 
19
- ## Install
16
+ </div>---
17
+
18
+ 𖤐 01 — Introduction
19
+
20
+ Qadeer-Xtech is an enhanced, locally customizable WhatsApp library built on a Baileys-compatible foundation.
21
+
22
+ Designed for developers who want more control, additional functionality and a personalized development experience.
23
+
24
+ It retains the familiar "makeWASocket()" API while introducing media improvements, interactive messages, albums, additional message types and the built-in AIRich Toolkit.
25
+
26
+ «⚡ One library. More possibilities. Your own control.»
27
+
28
+ ✦ 02 — Core Features
29
+
30
+ Feature| Description
31
+ ⚡ Baileys Compatibility| Familiar "makeWASocket()" API
32
+ 💠 AIRich Toolkit| Rich text, images, posts, products and more
33
+ 🎠 Interactive Messages| Buttons and carousel support
34
+ 🖼️ Media Enhancements| Media fixes, albums and additional message types
35
+ 📡 Channel Support| Newsletter and channel media handling
36
+ 🖥️ Terminal Branding| Custom Qadeer-Xtech terminal banner
37
+ 🔐 Pairing Customization| Branded default pairing code "QADEERAI"
38
+ 🛠️ Local Modification| Editable source files for developers
39
+
40
+ 𖠌 03 — Installation
41
+
42
+ Install directly through NPM:
20
43
 
21
- ```bash
22
44
  npm install qadeer-xtech
23
- ```
24
45
 
25
- Use the package directly:
46
+ Import the Library
47
+
48
+ import makeWASocket, {
49
+ AIRich,
50
+ Toolkit,
51
+ richSupported
52
+ } from "qadeer-xtech";
26
53
 
27
- ```js
28
- import makeWASocket, { AIRich, Toolkit, richSupported } from "qadeer-xtech";
29
- ```
54
+ ⚙️ 04 — Drop-in Baileys Replacement
30
55
 
31
- ## Drop-in Baileys alias
56
+ Already running a Baileys-based WhatsApp bot?
32
57
 
33
- If your bot already imports `@whiskeysockets/baileys`, point that dependency to this package:
58
+ You can use Qadeer-Xtech as an NPM alias without changing your existing import statements.
59
+
60
+ Add this to your "package.json":
34
61
 
35
- ```json
36
62
  {
37
63
  "dependencies": {
38
- "@whiskeysockets/baileys": "npm:qadeer-xtech@1.0.0"
64
+ "@whiskeysockets/baileys": "npm:qadeer-xtech@1.0.3"
39
65
  }
40
66
  }
41
- ```
42
67
 
43
- Your existing imports can remain unchanged.
68
+ Then install:
69
+
70
+ npm install
71
+
72
+ Your existing Baileys imports can remain unchanged.
73
+
74
+ 🔑 05 — Pairing Code System
44
75
 
45
- ## Pairing code
76
+ Qadeer-Xtech includes a branded default pairing code:
46
77
 
47
- The socket exposes the standard method:
78
+ ╭────────────────────────────╮
79
+ │ QADEER-XTECH AUTH │
80
+ │ │
81
+ │ QADEERAI │
82
+ │ │
83
+ │ SECURE CONNECTION │
84
+ ╰────────────────────────────╯
85
+
86
+ Request a Pairing Code
48
87
 
49
- ```js
50
88
  const phoneNumber = process.env.WA_PHONE_NUMBER;
89
+
51
90
  const code = await sock.requestPairingCode(phoneNumber);
91
+
52
92
  console.log("Pairing code:", code);
53
- ```
54
93
 
55
- By default, this build uses the branded eight-character code **`QADEERAI`**. WhatsApp requires the pairing code to be exactly eight characters. A caller-provided custom code is still accepted when needed:
94
+ The default branded code is "QADEERAI".
95
+
96
+ WhatsApp pairing codes must contain exactly eight characters. You can also provide your own custom code:
97
+
98
+ const code = await sock.requestPairingCode(
99
+ "YOUR_PHONE_NUMBER",
100
+ "MYCODE12"
101
+ );
56
102
 
57
- ```js
58
- const code = await sock.requestPairingCode("YOUR_PHONE_NUMBER", "MYCODE12");
59
- ```
103
+ Important:
60
104
 
61
- Use the phone number in international format without `+`, spaces or dashes. Never hardcode your real phone number in a public project.
105
+ - Use your phone number in international format.
106
+ - Do not include "+", spaces or dashes.
107
+ - Never expose real phone numbers in public repositories.
62
108
 
63
- ## AIRich example
109
+ 💎 06 — AIRich Toolkit
110
+
111
+ Meet AIRich, the built-in rich messaging toolkit designed to expand your WhatsApp messaging experience.
112
+
113
+ Create rich responses with text and other supported interactive content.
114
+
115
+ Quick Example
64
116
 
65
- ```js
66
117
  const sock = makeWASocket({
67
118
  auth: state,
68
119
  qadeerBanner: true
@@ -72,38 +123,111 @@ if (richSupported()) {
72
123
  const rich = new AIRich(sock)
73
124
  .addText("Hello from Qadeer-Xtech");
74
125
 
75
- await rich.send(`${phoneNumber}@s.whatsapp.net`);
126
+ await rich.send(
127
+ `${phoneNumber}@s.whatsapp.net`
128
+ );
76
129
  }
77
- ```
78
130
 
79
- ## Banner controls
131
+ AIRich Capabilities
132
+
133
+ - 📝 Rich Text
134
+ - 🖼️ Images
135
+ - 📢 Posts
136
+ - 🛍️ Products
137
+ - 🔘 Buttons
138
+ - 🎠 Carousels
139
+
140
+ 🖥️ 07 — Terminal Banner
141
+
142
+ Qadeer-Xtech includes a branded terminal banner that displays:
80
143
 
81
- The terminal banner displays **TEAM QADEER** once per process. Disable it in code:
144
+ ╔═════════════════════════╗
145
+ ║ ║
146
+ ║ QADEER-XTECH ║
147
+ ║ ║
148
+ ║ TEAM QADEER ║
149
+ ║ ║
150
+ ║ WHATSAPP ENGINE READY ║
151
+ ║ ║
152
+ ╚═════════════════════════╝
82
153
 
83
- ```js
84
- makeWASocket({ qadeerBanner: false });
85
- ```
154
+ The banner is displayed once per process by default.
86
155
 
87
- Or with an environment variable:
156
+ Disable Banner in Code
88
157
 
89
- ```bash
90
- QADEER_BAILEY_BANNER=false
91
- ```
158
+ makeWASocket({
159
+ qadeerBanner: false
160
+ });
161
+
162
+ Disable Using Environment Variable
163
+
164
+ QADEER_BAILEYS_BANNER=false
165
+
166
+ 🛠️ 08 — Local Development
92
167
 
93
- ## Local development
168
+ Want to customize the engine or build your own features?
169
+
170
+ Clone your package source and install dependencies:
94
171
 
95
- ```bash
96
172
  npm install
173
+
174
+ Run the smoke test:
175
+
97
176
  npm run smoke
177
+
178
+ Create an NPM package archive:
179
+
98
180
  npm pack
99
- ```
100
181
 
101
- Edit the implementation under `lib/`. The package does not require a GitHub repository to install, modify or publish.
182
+ Project Structure
183
+
184
+ qadeer-xtech/
185
+ │
186
+ ├── lib/ # Core library implementation
187
+ ├── package.json # Package configuration
188
+ ├── README.md # Documentation
189
+ └── LICENSE # MIT License
190
+
191
+ Modify the implementation inside "lib/" to customize your build.
192
+
193
+ The package does not require a GitHub repository or homepage metadata to install, modify or publish.
194
+
195
+ 🔒 09 — Security & Privacy
196
+
197
+ Security matters.
198
+
199
+ Qadeer-Xtech does not contain a hardcoded channel JID or phone number.
200
+
201
+ WhatsApp protocol endpoints remain part of the implementation because they are required for a real WhatsApp Web connection.
202
+
203
+ Keep your credentials protected:
204
+
205
+ - Never publish authentication state.
206
+ - Never expose session files.
207
+ - Keep phone numbers and API tokens private.
208
+ - Avoid committing sensitive configuration files.
209
+ - Use environment variables for private credentials.
210
+
211
+ 📜 10 — License
212
+
213
+ This project is licensed under the MIT License.
214
+
215
+ You are free to use, modify, distribute and build upon this software under the terms of the license.
216
+
217
+ See the "LICENSE" file for complete details.
218
+
219
+ ---
220
+
221
+ <div align="center">𓆩♡𓆪 TEAM QADEER 𓆩♡𓆪
222
+
223
+ CRAFTED FOR DEVELOPERS. BUILT FOR POSSIBILITIES.
224
+
225
+ ⚡ QADEER-XTECH
102
226
 
103
- ## Safety and privacy
227
+ Code with creativity. Build without limits.
104
228
 
105
- This library does not contain a hardcoded channel JID or phone number. WhatsApp protocol endpoints remain because they are required for a real WhatsApp Web connection. Keep authentication state, session files, phone numbers and tokens outside the package and never commit them.
229
+ <br/>""NPM" (https://img.shields.io/badge/NPM-qadeer--xtech-CB3837?style=for-the-badge&logo=npm&logoColor=white)" (https://www.npmjs.com/package/qadeer-xtech)
106
230
 
107
- ## License
231
+ © 2026 Qadeer-Xtech · Team Qadeer
108
232
 
109
- MIT — Qadeer-Xtech build.
233
+ </div>
@@ -594,7 +594,7 @@ export const makeSocket = (config) => {
594
594
  void end(new Boom(msg || 'Intentional Logout', { statusCode: DisconnectReason.loggedOut }));
595
595
  };
596
596
  const requestPairingCode = async (phoneNumber, customPairingCode) => {
597
- const pairingCode = customPairingCode ?? 'QADEERAI'; // Qadeer-Xtech branded 8-character default
597
+ const pairingCode = customPairingCode ?? bytesToCrockford(randomBytes(5));
598
598
  if (customPairingCode && customPairingCode?.length !== 8) {
599
599
  throw new Error('Custom pairing code must be exactly 8 chars');
600
600
  }
package/package.json CHANGED
@@ -1,13 +1,12 @@
1
1
  {
2
2
  "name": "qadeer-xtech",
3
- "version": "1.0.0",
3
+ "version": "1.0.3",
4
4
  "description": "Qadeer-Xtech enhanced Baileys v7 for Node.js with interactive messages, media fixes, albums, extra message types, and AIRich rich responses.",
5
5
  "main": "lib/index.js",
6
6
  "types": "lib/index.d.ts",
7
7
  "type": "module",
8
8
  "scripts": {
9
- "preinstall": "node ./engine-requirements.js",
10
- "smoke": "node ./smoke-test.mjs"
9
+ "preinstall": "node ./engine-requirements.js"
11
10
  },
12
11
  "engines": {
13
12
  "node": ">=20.0.0"