telegram-inline-keyboard-builder 1.1.2 → 2.0.0

package/core/InlineKeyboardBuilder.js

@@ -1,89 +1,178 @@
+
 export class InlineKeyboardBuilder {
-	constructor(adapter, buttonsPerRow = 2, autoWrapMaxChars = 0) {
-		if (!adapter) {
-			throw new Error("InlineKeyboardBuilder requires an adapter");
-		}
-		this.adapter = adapter;
-		this.buttonsPerRow = buttonsPerRow;
-		this.autoWrapMaxChars = autoWrapMaxChars;
-		this._buttons = [];
-	}
-
-	_pushButton(btn) {
-		this._buttons.push(btn);
-		return this;
-	}
-
-	addCallbackButton(text, callback_data, hide = false) {
-		return this._pushButton(
-			this.adapter.createCallback(text, callback_data, hide)
-		);
-	}
-
-	addUrlButton(text, url, hide = false) {
-		return this._pushButton(
-			this.adapter.createUrl(text, url, hide)
-		);
-	}
-
-	addPayButton(text, options = {}) {
-		const hide = options.hide ?? false;
-		return this._pushButton(
-			this.adapter.createPay(text, hide)
-		);
-	}
-
-	addCustomButton(btnObj) {
-		return this._pushButton(btnObj);
-	}
-
-	newRow() {
-		this._buttons.push({ __newRow: true });
-		return this;
-	}
-	_layoutButtons() {
-		const rows = [];
-		let row = [];
-		let rowChars = 0;
-
-		const pushRow = () => {
-			if (row.length > 0) {
-				rows.push(row);
-				row = [];
-				rowChars = 0;
-			}
-		};
-
-		for (const b of this._buttons) {
-			if (b && b.__newRow) {
-				pushRow();
-				continue;
-			}
-
-			const text = b?.text || "";
-			const len = String(text).length || 0;
-
-			if (
-				this.autoWrapMaxChars > 0 &&
-				row.length > 0 &&
-				rowChars + len > this.autoWrapMaxChars
-			) {
-				pushRow();
-			}
-
-			if (row.length >= this.buttonsPerRow) {
-				pushRow();
-			}
-
-			row.push(b);
-			rowChars += len;
-		}
-
-		pushRow();
-		return rows;
-	}
-
-	build() {
-		return this.adapter.buildKeyboard(this._layoutButtons());
-	}
+  constructor(buttonsPerRow = 2, autoWrapMaxChars = 0) {
+    this.buttonsPerRow = buttonsPerRow;
+    this.autoWrapMaxChars = autoWrapMaxChars; // 0 = disabled
+    this._buttons = []; // flat list of buttons + row markers
+  }
+
+  // ---------- internal ----------
+  _pushButton(btn) {
+    this._buttons.push(btn);
+    return this;
+  }
+
+  // ---------- button helpers ----------
+  addCallbackButton(text, callback_data) {
+    if (!text || !callback_data) {
+      throw new Error("Callback button requires text and callback_data");
+    }
+
+    return this._pushButton({
+      text,
+      callback_data,
+    });
+  }
+
+  addUrlButton(text, url) {
+    if (!text || !url) {
+      throw new Error("URL button requires text and url");
+    }
+
+    return this._pushButton({
+      text,
+      url,
+    });
+  }
+
+  addPayButton(text) {
+    if (!text) {
+      throw new Error("Pay button requires text");
+    }
+
+    return this._pushButton({
+      text,
+      pay: true,
+    });
+  }
+
+  addCustomButton(buttonObject) {
+    if (!buttonObject || !buttonObject.text) {
+      throw new Error("Custom button must be a valid InlineKeyboardButton object");
+    }
+
+    return this._pushButton(buttonObject);
+  }
+
+  // ---------- layout controls ----------
+  setButtonsPerRow(n) {
+    this.buttonsPerRow = Math.max(1, Math.floor(n));
+    return this;
+  }
+
+  setAutoWrapMaxChars(n) {
+    this.autoWrapMaxChars = Math.max(0, Math.floor(n));
+    return this;
+  }
+
+  newRow() {
+    this._buttons.push({ __newRow: true });
+    return this;
+  }
+
+  // ---------- config-based API ----------
+  _addButtonFromConfig(btn) {
+    const { type, text } = btn;
+
+    if (!type || !text) {
+      throw new Error("Button must have at least { type, text }");
+    }
+
+    switch (type) {
+      case "callback":
+        if (!btn.data) throw new Error("Callback button requires `data`");
+        this.addCallbackButton(text, btn.data);
+        break;
+
+      case "url":
+        if (!btn.url) throw new Error("URL button requires `url`");
+        this.addUrlButton(text, btn.url);
+        break;
+
+      case "pay":
+        this.addPayButton(text);
+        break;
+
+      case "custom":
+        if (!btn.button) throw new Error("Custom button requires `button`");
+        this.addCustomButton(btn.button);
+        break;
+
+      default:
+        throw new Error(`Unknown button type: ${type}`);
+    }
+  }
+
+  addButtons(config) {
+    // Case 1: array of buttons
+    if (Array.isArray(config)) {
+      for (const btn of config) {
+        this._addButtonFromConfig(btn);
+      }
+      return this;
+    }
+
+    // Case 2: grouped config
+    const { type, buttons } = config;
+    if (!type || !Array.isArray(buttons)) {
+      throw new Error("addButtons: invalid config");
+    }
+
+    for (const btn of buttons) {
+      this._addButtonFromConfig({ type, ...btn });
+    }
+
+    return this;
+  }
+
+  // ---------- layout engine ----------
+  _layoutButtons() {
+    const rows = [];
+    let row = [];
+    let rowChars = 0;
+
+    const pushRow = () => {
+      if (row.length > 0) {
+        rows.push(row);
+        row = [];
+        rowChars = 0;
+      }
+    };
+
+    for (const b of this._buttons) {
+      if (b.__newRow) {
+        pushRow();
+        continue;
+      }
+
+      const textLength = String(b.text || "").length;
+
+      if (
+        this.autoWrapMaxChars > 0 &&
+        row.length > 0 &&
+        rowChars + textLength > this.autoWrapMaxChars
+      ) {
+        pushRow();
+      }
+
+      if (row.length >= this.buttonsPerRow) {
+        pushRow();
+      }
+
+      row.push(b);
+      rowChars += textLength;
+    }
+
+    pushRow();
+    return rows;
+  }
+
+  // ---------- final output ----------
+  build() {
+    return {
+      reply_markup: {
+        inline_keyboard: this._layoutButtons(),
+      },
+    };
+  }
 }

package/package.json

@@ -1,16 +1,17 @@
 {
 	"name": "telegram-inline-keyboard-builder",
-	"version": "1.1.2",
+	"version": "2.0.0",
 	"description": "Universal inline keyboard builder for Telegram APIs",
-	"main": "builders/InlineKeyboardTelegraf.js",
+	"main": "core/InlineKeyboardBuilder.js",
 	"type": "module",
 	"keywords": [
 		"telegram",
 		"inline-keyboard",
 		"telegraf",
-		"aiogram",
+		"puregram",
+		"telebot",
 		"builder",
-		"python-telegram-bot",
+		"telegram-bot",
 		"node-telegram-bot-api"
 	],
 	"author": "neoncraftx",

package/adapters/node-telegram.adapter.js

@@ -1,21 +0,0 @@
-export class NodeTelegramInlineAdapter {
-	createCallback(text, data) {
-		return { text, callback_data: data };
-	}
-
-	createUrl(text, url) {
-		return { text, url };
-	}
-
-	createPay(text) {
-		return { text, pay: true };
-	}
-
-	buildKeyboard(rows) {
-		return {
-			reply_markup: {
-				inline_keyboard: rows
-			}
-		};
-	}
-}

package/adapters/puregram.adapter.js

@@ -1,17 +0,0 @@
-import { InlineKeyboard } from "puregram";
-
-export class PuregramInlineAdapter {
-	createCallback(text, data) {
-		return InlineKeyboard.textButton({ text, payload: data });
-	}
-	createUrl(text, url) {
-		return InlineKeyboard.urlButton({ text, url });
-	}
-	createPay(text) {
-		return InlineKeyboard.payButton({ text });
-	}
-	buildKeyboard(rows) {
-		// maps array of rows of buttons en structure puregram 
-		return InlineKeyboard.keyboard(rows.map(r => r.map(btn => btn)));
-	}
-}

package/adapters/telebot.adapter.js

@@ -1,14 +0,0 @@
-export class TelebotInlineAdapter {
-  createCallback(text, data) {
-    return { text, callback: data };
-  }
-  createUrl(text, url) {
-    return { text, url };
-  }
-  createPay(text) {
-    return { text, pay: true };
-  }
-  buildKeyboard(rows) {
-    return Telebot.inlineKeyboard(rows);
-  }
-}

package/adapters/telegraf.adapter.js

@@ -1,19 +0,0 @@
-import { Markup } from "telegraf";
-
-export class TelegrafInlineAdapter {
-	createCallback(text, data, hide = false) {
-		return Markup.button.callback(text, data, hide);
-	}
-
-	createUrl(text, url, hide = false) {
-		return Markup.button.url(text, url, hide);
-	}
-
-	createPay(text, hide = false) {
-		return Markup.button.pay(text, hide);
-	}
-
-	buildKeyboard(rows) {
-		return Markup.inlineKeyboard(rows);
-	}
-}

package/builders/InlineKeyboardNodeTelegram.js

@@ -1,13 +0,0 @@
-
-import { InlineKeyboardBuilder } from "../core/InlineKeyboardBuilder.js";
-import { NodeTelegramInlineAdapter } from "../adapters/node-telegram.adapter.js";
-
-export class InlineKeyboardNodeTelegram extends InlineKeyboardBuilder {
-	constructor(options = {}) {
-		super(
-			new NodeTelegramInlineAdapter(),
-			options.buttonsPerRow,
-			options.autoWrapMaxChars
-		);
-	}
-}

package/builders/InlineKeyboardPuregram.js

@@ -1,12 +0,0 @@
-import { InlineKeyboardBuilder } from "../core/InlineKeyboardBuilder.js";
-import { PuregramInlineAdapter } from "../adapters/puregram.adapter.js";
-
-export class InlineKeyboardPuregram extends InlineKeyboardBuilder {
-	constructor(options = {}) {
-		super(
-			new PuregramInlineAdapter(),
-			options.buttonsPerRow,
-			options.autoWrapMaxChars
-		);
-	}
-}

package/builders/InlineKeyboardTelebot.js

@@ -1,12 +0,0 @@
-import { InlineKeyboardBuilder } from "../core/InlineKeyboardBuilder.js";
-import { TelebotInlineAdapter } from "../adapters/telebot.adapter.js";
-
-export class InlineKeyboardTelegraf extends InlineKeyboardBuilder {
-	constructor(options = {}) {
-		super(
-			new TelebotInlineAdapter(),
-			options.buttonsPerRow,
-			options.autoWrapMaxChars
-		);
-	}
-}

package/builders/InlineKeyboardTelegraf.js

@@ -1,12 +0,0 @@
-import { InlineKeyboardBuilder } from "../core/InlineKeyboardBuilder.js";
-import { TelegrafInlineAdapter } from "../adapters/telegraf.adapter.js";
-
-export class InlineKeyboardTelegraf extends InlineKeyboardBuilder {
-	constructor(options = {}) {
-		super(
-			new TelegrafInlineAdapter(),
-			options.buttonsPerRow,
-			options.autoWrapMaxChars
-		);
-	}
-}