puppywebhook 1.0.0

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/README.md

@@ -0,0 +1,36 @@
+# puppywebhook
+
+[On npm @ https://www.npmjs.com/package/puppywebhook](https://www.npmjs.com/package/puppywebhook)
+
+[And GitHub @ https://github.com/onlypuppy7/puppywebhook](https://github.com/onlypuppy7/puppywebhook)
+
+Discord webhook wrapper/helper, ported to npm. Another useless file taken out of my projects!
+
+## Install
+`npm install puppywebhook`
+
+## Usage
+```js
+import PuppyWebhook from 'puppywebhook';
+
+const webhook = new PuppyWebhook({
+    webhookUrl: "https://discord.com/api/webhooks/1460782220192256031/Fkibsumk3hWg4M6F2eCmDe_ylXaJlY_z3W9XeCMWbiw4r8zcYfQJg64YeIhaHT-7tpbT",
+    username: 'StateFarmBot',
+    maxMessageLength: 1800,
+
+    //logs just for testing
+    logSends: true,
+    logErrors: true
+});
+
+console.log('Queuing some test webhook messages...');
+
+webhook.send('Bot started');
+webhook.send('Loaded config');
+webhook.send('Something happened');
+
+process.on('exit', async () => {
+    console.log('Flushing webhook messages before exit...');
+    await webhook.flush();
+});
+```

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "puppywebhook",
+  "version": "1.0.0",
+  "description": "Queued, rate safe Discord webhook logger with automatic chunking",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "keywords": [
+    "discord",
+    "webhook",
+    "logger",
+    "queue",
+    "rate-limit",
+    "logging"
+  ],
+  "scripts": {
+    "test": "node src/tests/test.js"
+  },
+  "author": "onlypuppy7",
+  "license": "MIT",
+  "dependencies": {
+    "node-fetch": "^3.3.2"
+  }
+}

package/src/index.js

@@ -0,0 +1,126 @@
+import fetch from 'node-fetch';
+
+export class PuppyWebhook {
+    constructor(options = {}) {
+        this.webhookUrl = options.webhookUrl;
+        this.username = options.username ?? 'puppywebhook';
+        this.avatar = options.avatar ?? null;
+
+        this.maxMessageLength = options.maxMessageLength ?? 1900;
+        this.minDelay = options.minDelay ?? 5000;
+        this.maxDelay = options.maxDelay ?? 15000;
+        this.logSends = options.logSends ?? false;
+        this.logErrors = options.logErrors ?? true;
+
+        this.logQueue = [];
+        this.queuedChunks = [];
+        this.messagesSent = 0;
+
+        this.interval = null;
+
+        if (!this.webhookUrl) {
+            throw new Error('webhookUrl is required');
+        }
+
+        this.start();
+    }
+
+    send(message) {
+        if (typeof message !== 'string') {
+            message = String(message);
+        }
+
+        this.logQueue.push(message);
+    }
+
+    start() {
+        if (this.interval) return;
+        this.interval = setInterval(() => this._process(), this._nextDelay());
+    }
+
+    stop() {
+        if (!this.interval) return;
+        clearInterval(this.interval);
+        this.interval = null;
+    }
+
+    flush() {
+        return this._process(true);
+    }
+
+    async _process(force = false) {
+        while (this.logQueue.length > 0) {
+            const msg = this.logQueue.shift();
+
+            if (msg.length > this.maxMessageLength) {
+                const parts = this._split(msg);
+                this.logQueue.unshift(...parts);
+                continue;
+            }
+
+            const last = this.queuedChunks[0] ?? '';
+            const next = last + '\n' + msg;
+
+            if (next.length > this.maxMessageLength) {
+                this.queuedChunks.unshift(msg);
+            } else {
+                this.queuedChunks[0] = next;
+            }
+        }
+
+        if (this.queuedChunks.length === 0 && !force) return;
+
+        const chunkContent = this.queuedChunks[this.queuedChunks.length - 1];
+        if (!chunkContent) return;
+
+        try {
+            const content = chunkContent.slice(0, 2000) + ` (${this.messagesSent % 1000})`
+
+            const res = await fetch(this.webhookUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    username: this.username,
+                    avatar_url: this.avatar,
+                    content: content
+                })
+            });
+
+            if (!res.ok) {
+                throw new Error(res.statusText);
+            }
+
+            this.logSends && console.log('Sent webhook message:', content);
+
+            this.queuedChunks.pop();
+            this.messagesSent++;
+        } catch (err) {
+            this.logErrors && console.error('Error sending webhook:', err);
+            this.logQueue.unshift(chunkContent);
+        }
+
+        this._reschedule();
+    }
+
+    _split(str) {
+        const chunks = [];
+        for (let i = 0; i < str.length; i += this.maxMessageLength) {
+            chunks.push(str.slice(i, i + this.maxMessageLength));
+        }
+        return chunks;
+    }
+
+    _nextDelay() {
+        const base = this.maxDelay - Math.min(this.queuedChunks.length, 7) * 1000;
+        const jitter = (Math.floor(Math.random() * 8) - 4) * 1000;
+        return Math.max(this.minDelay, base + jitter);
+    }
+
+    _reschedule() {
+        if (!this.interval) return;
+        clearInterval(this.interval);
+        this.interval = setInterval(() => this._process(), this._nextDelay());
+    }
+}
+
+export default PuppyWebhook;