docs(skill): autoRejectCall option, rejectCall method, auto-reject recipe

Author: zeative

plugins/zaileys-official/skills/zaileys-assist/references/api.md

@@ -60,6 +60,7 @@ client.on('text', async (msg) => { if (msg.text === 'ping') await msg.reply('pon
 | `commandPrefix` | `string \| string[]` | — | enables `.command()`; empty/undefined ⇒ commands disabled |
 | `citation` | `CitationConfig` | — | `{authors?, banned?}`: each `string[] \| (jid)=>boolean\|Promise<boolean>` |
 | `ignoreMe` | `boolean` | `true` | drop self-authored inbound messages |
+| `autoRejectCall` | `boolean \| AutoRejectCallOptions` | `false` (off) | 🔗 **unofficial-only**. `true` = reject every incoming call. Object: `{ enabled?, allow?: string[] \| (jid)=>boolean\|Promise<boolean>, onReject?: (call)=>void\|Promise<void> }`. `allow` entries match full jid or digits; `allow`/`onReject` throws are logged, never fatal |
 
 ### Properties & lifecycle methods
 
@@ -326,6 +327,13 @@ Programmatic `AIRichPart` union also supports `product`/`reels`/`post` with full
 
 ## Mutations
 
+`client.rejectCall(call | callId, from?)` → `Promise<void>` — 🔗 **unofficial-only** (throws `UNSUPPORTED_ON_CLOUD` on cloud). Accepts the `call-incoming` payload OR raw `(callId, from)`. Throws `ZaileysAutomationError('NOT_CONNECTED')` if the socket is gone. Pair with the `autoRejectCall` option for hands-off rejecting.
+
+```typescript
+client.on('call-incoming', (call) => client.rejectCall(call))
+```
+
+
 | method | signature | note |
 |---|---|---|
 | `client.edit(key)` | `EditBuilder` | chain `.text(s)` / `.image(src,opts?)` / `.video(src,opts?)` then `await` ⇒ `WAMessageKey` |

plugins/zaileys-official/skills/zaileys-assist/references/recipes.md

@@ -697,6 +697,34 @@ await wa.cloud.flows.send(to, { flowId: 'FLOW1', cta: 'Isi form', bodyText: 'Boo
 
 ---
 
+## 20. 🔗 Auto-reject incoming calls (unofficial only)
+
+```typescript
+// hands-off: reject every call, tell the caller why, let the owner through
+const client = new Client({
+  autoRejectCall: {
+    enabled: true,
+    allow: [process.env['OWNER']!],                    // full jid or bare digits both match
+    onReject: async (call) => {
+      await client.send(call.from).text('Maaf, nomor ini tidak menerima telepon 🙏')
+    },
+  },
+})
+
+// shorthand — reject everything, no hook
+const client = new Client({ autoRejectCall: true })
+
+// manual: decide per call (leave the option off)
+client.on('call-incoming', async (call) => {
+  if (call.isVideo || call.isGroup) await client.rejectCall(call)
+})
+```
+
+`allow` / `onReject` failures are caught + logged (never crash the client). `client.rejectCall()`
+throws on failure so you can handle it. Cloud provider has no calls → `UNSUPPORTED_ON_CLOUD`.
+
+---
+
 ## Diagnostics
 
 | Symptom | Cause | Fix |

plugins/zaileys-official/skills/zaileys-review/SKILL.md

@@ -224,7 +224,7 @@ WHY: inbound is push + HMAC-verified; a body-parser corrupts the signature.
   presence, newsletter`. Connection: `connect, disconnect, qr, pairing-code, reconnecting,
   auth-exhausted, error`.
 - Client methods: `connect, disconnect, logout, send, edit, delete, react, forward,
-  broadcast, scheduleAt, pin, unpin, setDisappearing, command, use, on, off`. `autoConnect`
+  broadcast, scheduleAt, pin, unpin, setDisappearing, rejectCall, command, use, on, off`. `autoConnect`
   defaults `true`.
 - Typed modules: `client.profile` (setName/setStatus/setPicture/removePicture/getPicture/
   getStatus), `client.chat` (archive/unarchive/pin/unpin/mute/unmute/markRead/markUnread/star/

skills/zaileys-assist/references/api.md

@@ -60,6 +60,7 @@ client.on('text', async (msg) => { if (msg.text === 'ping') await msg.reply('pon
 | `commandPrefix` | `string \| string[]` | — | enables `.command()`; empty/undefined ⇒ commands disabled |
 | `citation` | `CitationConfig` | — | `{authors?, banned?}`: each `string[] \| (jid)=>boolean\|Promise<boolean>` |
 | `ignoreMe` | `boolean` | `true` | drop self-authored inbound messages |
+| `autoRejectCall` | `boolean \| AutoRejectCallOptions` | `false` (off) | 🔗 **unofficial-only**. `true` = reject every incoming call. Object: `{ enabled?, allow?: string[] \| (jid)=>boolean\|Promise<boolean>, onReject?: (call)=>void\|Promise<void> }`. `allow` entries match full jid or digits; `allow`/`onReject` throws are logged, never fatal |
 
 ### Properties & lifecycle methods
 
@@ -326,6 +327,13 @@ Programmatic `AIRichPart` union also supports `product`/`reels`/`post` with full
 
 ## Mutations
 
+`client.rejectCall(call | callId, from?)` → `Promise<void>` — 🔗 **unofficial-only** (throws `UNSUPPORTED_ON_CLOUD` on cloud). Accepts the `call-incoming` payload OR raw `(callId, from)`. Throws `ZaileysAutomationError('NOT_CONNECTED')` if the socket is gone. Pair with the `autoRejectCall` option for hands-off rejecting.
+
+```typescript
+client.on('call-incoming', (call) => client.rejectCall(call))
+```
+
+
 | method | signature | note |
 |---|---|---|
 | `client.edit(key)` | `EditBuilder` | chain `.text(s)` / `.image(src,opts?)` / `.video(src,opts?)` then `await` ⇒ `WAMessageKey` |

skills/zaileys-assist/references/recipes.md

@@ -697,6 +697,34 @@ await wa.cloud.flows.send(to, { flowId: 'FLOW1', cta: 'Isi form', bodyText: 'Boo
 
 ---
 
+## 20. 🔗 Auto-reject incoming calls (unofficial only)
+
+```typescript
+// hands-off: reject every call, tell the caller why, let the owner through
+const client = new Client({
+  autoRejectCall: {
+    enabled: true,
+    allow: [process.env['OWNER']!],                    // full jid or bare digits both match
+    onReject: async (call) => {
+      await client.send(call.from).text('Maaf, nomor ini tidak menerima telepon 🙏')
+    },
+  },
+})
+
+// shorthand — reject everything, no hook
+const client = new Client({ autoRejectCall: true })
+
+// manual: decide per call (leave the option off)
+client.on('call-incoming', async (call) => {
+  if (call.isVideo || call.isGroup) await client.rejectCall(call)
+})
+```
+
+`allow` / `onReject` failures are caught + logged (never crash the client). `client.rejectCall()`
+throws on failure so you can handle it. Cloud provider has no calls → `UNSUPPORTED_ON_CLOUD`.
+
+---
+
 ## Diagnostics
 
 | Symptom | Cause | Fix |

skills/zaileys-review/SKILL.md

@@ -224,7 +224,7 @@ WHY: inbound is push + HMAC-verified; a body-parser corrupts the signature.
   presence, newsletter`. Connection: `connect, disconnect, qr, pairing-code, reconnecting,
   auth-exhausted, error`.
 - Client methods: `connect, disconnect, logout, send, edit, delete, react, forward,
-  broadcast, scheduleAt, pin, unpin, setDisappearing, command, use, on, off`. `autoConnect`
+  broadcast, scheduleAt, pin, unpin, setDisappearing, rejectCall, command, use, on, off`. `autoConnect`
   defaults `true`.
 - Typed modules: `client.profile` (setName/setStatus/setPicture/removePicture/getPicture/
   getStatus), `client.chat` (archive/unarchive/pin/unpin/mute/unmute/markRead/markUnread/star/