plogme 1.0.0

package/LICENSE

@@ -0,0 +1,61 @@
+CRYSNOVAX SOURCE LICENSE
+Version 1.0
+License identifier: Crysnovax Source License v1.0
+
+Copyright (c) 2026 Crysnovax — @crysnovax/baileys
+
+Preamble
+--------
+This software is the result of substantial original work by Crysnovax.
+It is distributed under a restricted license that protects the author's
+attribution rights. It is NOT the MIT license and intentionally does
+not grant the same freedoms.
+
+1. Permitted Use
+   You may use, run, and modify this software for your own personal or
+   non-commercial purposes, including private bot projects, prototypes,
+   and internal tooling, provided that all copyright and attribution
+   notices are preserved.
+
+2. Attribution Requirement
+   Any copy, fork, modified version, or derivative of this software must
+   retain, visibly and unmodified, in the source code, documentation,
+   and any user-facing material (bot menus, footers, README files,
+   sticker pack metadata, etc.):
+     - the original package name, or an explicit credit line reading
+       "Based on @crysnovax/baileys by Crysnovax",
+     - this license text,
+     - the copyright notice above.
+
+3. Prohibited Conduct
+   You may NOT, without the prior written permission of Crysnovax:
+     - rename, rebrand, or republish this software or substantial
+       portions of it under a different name or author,
+     - remove, obscure, or alter any attribution, watermark, integrity
+       check, or branding enforcement contained in the software,
+     - sell, license, sublicense, or commercially redistribute this
+       software or substantial portions of it,
+     - use AI tools, automated rewriting, or any other means to strip
+       attribution and claim the work as your own.
+
+4. Enforcement
+   This software contains integrity and attribution checks. Tampering
+   with, deleting, or circumventing them does not grant you any rights
+   under this license. Violations may be pursued to the fullest extent
+   permitted by law, including copyright claims, DMCA takedowns, and
+   platform (npm, GitHub) abuse reports.
+
+5. No Warranty
+   THIS 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
+   NON-INFRINGEMENT. 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.
+
+6. Termination
+   Any violation of this license automatically terminates your rights
+   to use, copy, or modify the software. Upon termination you must
+   delete all copies in your possession.

package/README.md

@@ -0,0 +1,212 @@
+# plogme
+
+A Node.js WhatsApp Web API client for building messaging integrations with authentication, media transfer, groups, interactive messages, status updates, and rich message composition.
+
+> **Package naming note:** npm scoped packages require a scope and package name. The valid package form is `plogme`; the bare string `@plogme` is a scope, not an installable package name by itself.
+
+## Installation
+
+```bash
+npm install plogme
+```
+
+For a repository checkout:
+
+```bash
+npm install github:crysnovax/baileys
+```
+
+## Requirements
+
+The package supports current Node.js LTS releases. Use Node.js 20 or newer for the latest runtime and dependency compatibility.
+
+## Quick start
+
+```js
+import {
+  makeWASocket,
+  DisconnectReason,
+  useMultiFileAuthState
+} from 'plogme'
+import { Boom } from '@hapi/boom'
+import pino from 'pino'
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState('./session')
+  const socket = makeWASocket({
+    auth: state,
+    logger: pino({ level: 'silent' })
+  })
+
+  socket.ev.on('creds.update', saveCreds)
+  socket.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+    if (connection === 'open') console.log('Connected')
+    if (connection === 'close') {
+      const status = new Boom(lastDisconnect?.error)?.output?.statusCode
+      if (status !== DisconnectReason.loggedOut) start()
+    }
+  })
+
+  socket.ev.on('messages.upsert', async ({ messages }) => {
+    const message = messages[0]
+    if (!message?.message) return
+    await socket.sendMessage(message.key.remoteJid, { text: 'Hello from plogme' })
+  })
+}
+
+start()
+```
+
+## Authentication
+
+The recommended authentication state is multi-file authentication:
+
+```js
+import { useMultiFileAuthState } from 'plogme'
+
+const { state, saveCreds } = await useMultiFileAuthState('./session')
+```
+
+Pairing codes can be requested after the socket has initialized:
+
+```js
+const code = await socket.requestPairingCode('15551234567')
+console.log(code)
+```
+
+Keep authentication files private. Do not commit session credentials, private keys, or environment files to a public repository.
+
+## Text, mentions, and reactions
+
+```js
+await socket.sendMessage(jid, { text: 'Hello!' })
+
+await socket.sendMessage(jid, {
+  text: 'Hello @15551234567',
+  mentions: ['15551234567@s.whatsapp.net']
+})
+
+await socket.sendMessage(jid, {
+  react: { text: '✅', key: message.key }
+})
+```
+
+## Media
+
+```js
+await socket.sendMessage(jid, {
+  image: { url: './image.jpg' },
+  caption: 'Image caption'
+})
+
+await socket.sendMessage(jid, {
+  video: { url: './video.mp4' },
+  caption: 'Video caption',
+  gifPlayback: false
+})
+
+await socket.sendMessage(jid, {
+  document: { url: './report.pdf' },
+  mimetype: 'application/pdf',
+  fileName: 'report.pdf'
+})
+
+await socket.sendMessage(jid, {
+  audio: { url: './audio.ogg' },
+  mimetype: 'audio/ogg; codecs=opus'
+})
+```
+
+## Interactive messages
+
+The client supports button, list, template, carousel, and native-flow message structures exposed by the installed library version. A basic button example is:
+
+```js
+await socket.sendMessage(jid, {
+  text: 'Choose an option',
+  footer: 'Menu',
+  buttons: [
+    { buttonId: 'confirm', buttonText: { displayText: 'Confirm' }, type: 1 },
+    { buttonId: 'cancel', buttonText: { displayText: 'Cancel' }, type: 1 }
+  ],
+  headerType: 1
+})
+```
+
+Always validate button input on the server. A button identifier is user-controlled input and must not be treated as an authorization grant.
+
+## Groups
+
+```js
+const metadata = await socket.groupMetadata(groupJid)
+await socket.groupParticipantsUpdate(groupJid, [userJid], 'add')
+await socket.groupParticipantsUpdate(groupJid, [userJid], 'remove')
+await socket.groupSettingUpdate(groupJid, 'announcement')
+```
+
+Group administration calls require the connected account to have the corresponding privileges. Applications should handle permission failures and disconnected sessions gracefully.
+
+## Status updates
+
+Status messages can be sent with text, images, videos, captions, and mentions according to the message content supported by the current protocol version:
+
+```js
+await socket.sendMessage('status@broadcast', {
+  text: 'Service status: online',
+  backgroundArgb: 0xff102a43,
+  font: 2
+})
+```
+
+## Message options
+
+```js
+await socket.sendMessage(jid, {
+  text: 'Disappearing message',
+  ephemeralExpiration: 86400
+})
+
+await socket.sendMessage(jid, {
+  text: 'Updated text',
+  edit: message.key
+})
+
+await socket.sendMessage(jid, {
+  delete: message.key
+})
+```
+
+Use raw protocol options only when the target client and installed library version support them. Unsupported message fields can be rejected by WhatsApp or ignored by the recipient.
+
+## Error handling and reconnection
+
+Connections can close because of logout, network interruption, protocol updates, or server-side session invalidation. Applications should distinguish logout from recoverable failures and should avoid starting multiple concurrent connection loops.
+
+```js
+socket.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+  if (connection !== 'close') return
+  const status = new Boom(lastDisconnect?.error)?.output?.statusCode
+  if (status === DisconnectReason.loggedOut) {
+    console.error('Session logged out; remove the old session and pair again.')
+    return
+  }
+  console.log('Connection interrupted; reconnect using a backoff strategy.')
+})
+```
+
+## Development
+
+```bash
+npm install
+npm test
+```
+
+Before opening a pull request, run the test suite, check the generated package contents, and confirm that no credentials or session files are included.
+
+## License
+
+Review the repository license before distributing applications built with this package. Keep required notices with redistributed source and binaries.
+
+## Support
+
+For implementation questions, include the Node.js version, package version, operating system, relevant error text, and a minimal reproducible example. Never include authentication state or private account data in an issue.

package/WAProto/V

@@ -0,0 +1 @@
+