stian-baileys 0.1.0

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2025 Rajeh Taher/WhiskeySockets
+Copyright (c) 2026 stian-baileys contributors
+
+This project is a fork of Baileys (https://github.com/WhiskeySockets/Baileys).
+The original copyright notice above is retained as required by the MIT License.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,200 @@
+# stian-baileys
+
+A fork of [Baileys](https://github.com/WhiskeySockets/Baileys) (v7.0.0-rc14) that adds group
+statuses, scoped log filtering, and a CommonJS entry point.
+
+Everything else — the socket, the protocol, the types — is upstream Baileys, unmodified.
+
+> **Disclaimer:** not affiliated with, authorized by, or connected to WhatsApp or Meta. Don't use
+> it to spam people.
+
+## What this fork adds
+
+Four things. That's the whole list.
+
+### 1. Group statuses / stories
+
+Post a status visible to a group's members, via `sendMessage`:
+
+```ts
+await sock.sendMessage(groupJid, {
+	groupStatusMessage: { text: 'hello group' }
+})
+
+await sock.sendMessage(groupJid, {
+	groupStatusMessage: { image: { url: './photo.jpg' }, caption: 'nice view' }
+})
+```
+
+Or through `sock.stianStatus` directly:
+
+```ts
+// one group
+const msgId = await sock.stianStatus.sendGroupStatus(groupJid, { text: 'hi' })
+
+// post to status@broadcast and notify several groups/contacts about it
+const status = await sock.stianStatus.sendStatusToGroups({ text: 'hi everyone' }, [groupJid1, groupJid2, contactJid])
+```
+
+`sendStatusToGroups` randomises the font and colours for text statuses unless you set them:
+
+```ts
+await sock.stianStatus.sendStatusToGroups(
+	{ text: 'styled', font: 3, textColor: '#ffffff', backgroundColor: '#075e54' },
+	[groupJid]
+)
+```
+
+Media statuses move `text` onto `caption` automatically, and audio statuses default to `ptt: true`.
+
+### 2. Scoped libsignal log filtering
+
+The `Closing session:` / `Bad MAC` / `Session error:` chatter does not come from Baileys — it comes
+from the `libsignal` dependency writing straight to `console`. This filter silences exactly those
+messages:
+
+```ts
+import { suppressSignalNoise } from 'stian-baileys'
+
+const restore = suppressSignalNoise()
+// ... and to undo it
+restore()
+```
+
+Deliberate design choices, because this is the easiest thing in a fork to get wrong:
+
+- `process.stdout` and `process.stderr` are **never** patched. Patching them silences every write
+  in your process, including your own application logs.
+- Patterns are **anchored to the start** of the first argument and derived from libsignal's actual
+  source, so your own `"Session error while saving order #123"` is never swallowed.
+- Only `console.info`, `console.warn` and `console.error` are wrapped — the three methods libsignal
+  uses.
+- You get a real `restore()` function back.
+
+Want to see what's being dropped? Route it into your own logger:
+
+```ts
+suppressSignalNoise({
+	onSuppressed: (method, args) => logger.trace({ method, args }, 'libsignal noise')
+})
+```
+
+For Baileys' own logging, no patching is needed — it uses pino, so just set the level:
+
+```ts
+const sock = makeWASocket({ auth: state, logger: pino({ level: 'warn' }) })
+```
+
+### 3. CommonJS entry point
+
+Upstream Baileys 7.x is ESM-only. This fork adds a `require()` entry:
+
+```js
+const { makeWASocket, useMultiFileAuthState } = require('stian-baileys')
+```
+
+It relies on Node's native `require(esm)`, so it needs **Node 20.19+ or 22.12+**. On older Node you
+get an explicit error telling you to upgrade or use ESM, rather than a silently empty object.
+
+Why not transpile a real CJS build? Because two runtime dependencies — `p-queue` and
+`whatsapp-rust-bridge` — ship no CommonJS build at all, and `whatsapp-rust-bridge` is a native
+binding used synchronously in the crypto path. Transpiling would produce something that throws
+`ERR_REQUIRE_ESM` at runtime. ESM remains the primary, best-supported entry point.
+
+### 4. `isJidUser` back-compat alias
+
+Baileys 6.x had `isJidUser`; 7.x renamed it to `isPnUser`. The old name is re-exported as a
+deprecated alias so 6.x-era code keeps working.
+
+## Install
+
+```bash
+npm install stian-baileys
+```
+
+Requires Node 20+ (Node 20.19+ or 22.12+ if you're loading it from CommonJS).
+
+## Versioning
+
+This package is `0.x` on purpose. It tracks upstream Baileys **7.0.0-rc14**, a release candidate,
+so the API underneath it can still change. Per semver, `0.x` means the public API is not yet
+declared stable, and breaking changes land in the **minor** slot — `0.1.0` → `0.2.0`, not `2.0.0`.
+
+Pin accordingly if you need stability:
+
+```bash
+npm install stian-baileys@~0.1.0   # patch updates only
+```
+
+Once upstream ships 7.0.0 final and this API settles, it moves to `1.0.0` and normal semver
+guarantees apply from there.
+
+## Usage
+
+Identical to upstream Baileys — see the
+[Baileys documentation](https://github.com/WhiskeySockets/Baileys). Only the four additions above
+differ.
+
+```ts
+import makeWASocket, { useMultiFileAuthState, suppressSignalNoise } from 'stian-baileys'
+
+suppressSignalNoise()
+
+const { state, saveCreds } = await useMultiFileAuthState('./auth')
+const sock = makeWASocket({ auth: state })
+
+sock.ev.on('creds.update', saveCreds)
+```
+
+## Relationship to upstream
+
+Kept deliberately thin so upstream releases are easy to absorb. Seven upstream files are touched,
+by 20 lines in total, and nothing upstream is deleted:
+
+| Upstream file                 | Delta | Change                                                        |
+| ----------------------------- | ----- | ------------------------------------------------------------- |
+| `src/Socket/index.ts`         | ~2    | use `makeStatusSocket` as the outermost socket layer          |
+| `src/Socket/messages-send.ts` | +4    | one `getMediaType` branch to resolve group-status inner media |
+| `src/WABinary/jid-utils.ts`   | +5    | the `isJidUser` alias and its doc comment                     |
+| `src/index.ts`                | +3    | re-export the status layer                                    |
+| `src/Types/index.ts`          | +1    | re-export `./Stian`                                           |
+| `src/Utils/index.ts`          | +1    | re-export `./log-filter`                                      |
+| `eslint.config.mts`           | +4    | add a `files` pattern so linting TypeScript actually runs     |
+
+Everything else is purely additive:
+
+| New file                                    | Purpose                       |
+| ------------------------------------------- | ----------------------------- |
+| `src/Socket/status.ts`                      | the group status socket layer |
+| `src/Types/Stian.ts`                        | public types for the above    |
+| `src/Utils/log-filter.ts`                   | the libsignal console filter  |
+| `src/__tests__/Socket/stian-status.test.ts` | 9 tests                       |
+| `src/__tests__/Utils/log-filter.test.ts`    | 12 tests                      |
+| `cjs/index.cjs`                             | CommonJS entry point          |
+
+To pull in a new upstream release:
+
+```bash
+git fetch upstream
+git merge upstream/master
+```
+
+## Development
+
+```bash
+npm install
+npm run typecheck   # tsc --noEmit, must be clean
+npm run build       # emits lib/ with .js + .d.ts
+npm run test:cjs    # verifies the CommonJS entry
+npm run verify      # all of the above
+```
+
+`lib/` is **never** hand-edited — it is always generated from `src/`.
+That's what keeps the types, the sourcemaps, and the ability to rebase.
+
+## Credits
+
+Built on [Baileys](https://github.com/WhiskeySockets/Baileys) by Rajeh Taher and the WhiskeySockets
+contributors, MIT licensed.
+
+Licensed under MIT. See [LICENSE](./LICENSE).

package/WAProto/GenerateStatics.sh

@@ -0,0 +1,3 @@
+yarn pbjs -t static-module --no-beautify -w es6 --no-bundle --no-delimited --no-verify --no-comments -o ./index.js ./WAProto.proto;
+yarn pbjs -t static-module --no-beautify -w es6 --no-bundle --no-delimited --no-verify ./WAProto.proto | yarn pbts --no-comments -o ./index.d.ts -;
+node ./fix-imports.js