morpho-socket 0.2.0 → 0.3.0

package/docs/building-a-bot.md

@@ -97,7 +97,7 @@ const g = await contexts.build({ sock, msg, clientId })
 | who it's about | `await g.who()` — the mentioned person, else the replied-to author |
 | permissions | `g.isOwner` · `await g.isAdmin()` · `await g.isBotAdmin()` |
 | to answer | `g.reply(…)` · `g.send(jid, …)` · `g.react("👍")` · `g.edit(sent, …)` |
-| group info and actions | `g.group()` · `g.members()` · `g.kick()` · `g.promote()` · … |
+| group info and actions | `g.group()` · `g.members()` · `g.kick()` · `g.promote()` · `g.tagAll(text)` · … (`g.readMore` = the "Read more…" fold) |
 | media | `g.download()` · `g.media()` |
 
 Your bot's rules plug in through `createContext` options and `extend`:

package/package.json

@@ -1,11 +1,19 @@
 {
   "name": "morpho-socket",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Blocos para bots de WhatsApp sobre o Baileys",
   "license": "MIT",
-  "engines": { "node": ">=22.5.0" },
-  "peerDependencies": { "@whiskeysockets/baileys": "*" },
-  "files": ["packages", "README.md", "docs"],
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "peerDependencies": {
+    "@whiskeysockets/baileys": "*"
+  },
+  "files": [
+    "packages",
+    "README.md",
+    "docs"
+  ],
   "exports": {
     "./core": "./packages/core/index.js",
     "./store-sqlite": "./packages/store-sqlite/index.js",
@@ -23,5 +31,7 @@
     "./commands": "./packages/commands/index.js",
     "./kv": "./packages/kv/index.js"
   },
-  "scripts": { "test": "node test/run-all.js" }
+  "scripts": {
+    "test": "node test/run-all.js"
+  }
 }

package/packages/context/README.md

@@ -58,6 +58,7 @@ if (!r.ok) return g.reply(messages[r.reason] ?? messages.failed)
 | | |
 |---|---|
 | people | `kick` `promote` `demote` `add(number)` `approve` `reject` |
+| tag everyone | `tagAll(text, { quote, admins, bot })` — hidden mention: nobody sees a list of numbers, everybody is notified → `{ ok, action, count, sent }` |
 | group | `close()` `open()` `lock()` `unlock()` `rename(text)` `setDescription(text)` `leave()` |
 | invite link | `link()` · `revokeLink()` → `{ code, url }` |
 | message | `delete()` removes the replied-to message (or the command itself) · `delete("command")` · `delete(sentMessage)` |
@@ -82,6 +83,8 @@ await g.react("🎉");  await g.poll("Pizza?", ["yes", "no"])
 
 Media sources: `Buffer` · `"https://…"` · `"/path/to/file"` · `{ url }` (sticker and voice need a Buffer or a file). Options (second argument, or inside the object): `mentions` (anything `g.at` understands), `quote: false | true | msg`, `mimetype` / `fileName`.
 
+**Read more:** `g.readMore` is a string; put it between two parts of a text and WhatsApp folds the second part behind "Read more…": ``await g.reply(`Title${g.readMore}Long text`)``.
+
 Everything returns the sent message (with `.key`). If quoting fails (e.g. the command came from a button tap) it sends without the quote; if the media fails and there is a caption, it sends the caption. **A command is never left mute.**
 
 ## Incoming media

package/packages/context/group.js

@@ -161,6 +161,30 @@ function createGroupActions({ identity, protect } = {}) {
     async members() { return Promise.all(((await this.groupMeta())?.participants || []).map(p => describe(this, p, false))) },
     async admins() { return (await this.members()).filter(m => m.admin) },
 
+    // ----- tag everyone (hidden: the text shows no @numbers, but everybody is notified) -----
+    // await g.tagAll("Attention, everyone!")                  // quotes the command by default
+    // await g.tagAll("Hi", { quote: false, admins: true })    // admins: only tag the admins
+    // -> { ok: true, action, count, sent } | { ok: false, action, reason }
+    async tagAll(text, opts = {}) {
+      const blocked = await guard(this, "tagAll", false)
+      if (blocked) return blocked
+      const t = String(text ?? "")
+      if (!t.trim()) return fail("tagAll", "invalid-text")
+      try {
+        const meta = await this.groupMeta()
+        const me = botIds(this.sock)
+        const jids = (meta?.participants || [])
+          .filter(p => (!opts.admins || isAdminRole(p)) && !(opts.bot === false && participantIds(p).some(x => me.includes(x))))
+          .map(p => p.id)
+        const content = { text: t, mentions: jids }
+        const quoted = opts.quote === false ? null : (opts.quote && opts.quote !== true ? opts.quote : this.msg)
+        let sent
+        try { sent = await this.sock.sendMessage(this.chatId, content, quoted ? { quoted } : undefined) }
+        catch (e) { if (!quoted) throw e; sent = await this.sock.sendMessage(this.chatId, content) }   // quote failed (button tap...)? send loose
+        return success("tagAll", { count: jids.length, sent })
+      } catch (e) { return fail("tagAll", reasonFromError(e), { error: e?.message }) }
+    },
+
     kick(user, opts = {}) {
       return run(this, "kick", "remove", user, opts, {
         resolve: x => inGroup(this, x),

package/packages/context/index.js

@@ -46,7 +46,7 @@ function createContext({ identity, media, interactive, getGroupMeta, isOwner, pr
     get timestamp() { return this.parsed.timestamp },
     get mentions() { return this.parsed.mentions },
     get quoted() { return this.parsed.quoted },              // parsed quoted message (text, media, sender...) or null
-    get readMore() { return "\u200E".repeat(4000) },
+    get readMore() { return "\u200E".repeat(4001) },                  // `${a}${g.readMore}${b}` -> WhatsApp folds b behind "Read more"
 
     // text/caption; a tap on one of OUR buttons/list rows counts as the command it carries (e.g. "/menu games")
     get text() { return this.parsed.text || this.interactiveReply || null },