@xtsea/tgcore-ts 0.1.5 → 0.1.6

package/dist/index.d.mts

@@ -1,3 +1,53 @@
+type InlineKeyboardButton = {
+    text: string;
+    url?: string;
+    style?: string;
+    callback_data?: string;
+    web_app?: {
+        url: string;
+    };
+    login_url?: {
+        url: string;
+        forward_text?: string;
+        bot_username?: string;
+        request_write_access?: boolean;
+    };
+    switch_inline_query?: string;
+    switch_inline_query_current_chat?: string;
+    switch_inline_query_chosen_chat?: {
+        query?: string;
+        allow_user_chats?: boolean;
+        allow_bot_chats?: boolean;
+        allow_group_chats?: boolean;
+        allow_channel_chats?: boolean;
+    };
+    copy_text?: {
+        text: string;
+    };
+};
+type InlineKeyboardMarkup = {
+    inline_keyboard: InlineKeyboardButton[][];
+};
+declare class KeyboardBuilder {
+    private keyboard;
+    private _maxPerRow;
+    static inline(): KeyboardBuilder;
+    maxPerRow(n: number): this;
+    private currentRow;
+    row(): this;
+    private push;
+    url(text: string, url: string): this;
+    style(text: string, style: string, url: string): this;
+    callback(text: string, data: string): this;
+    webApp(text: string, url: string): this;
+    loginUrl(text: string, url: string, opts?: Omit<NonNullable<InlineKeyboardButton["login_url"]>, "url">): this;
+    switchInline(text: string, query: string): this;
+    switchInlineCurrentChat(text: string, query: string): this;
+    switchInlineChosenChat(text: string, opts: InlineKeyboardButton["switch_inline_query_chosen_chat"]): this;
+    copyText(text: string, copy: string): this;
+    build(): InlineKeyboardMarkup;
+}
+
 type HttpOptions = {
     api_key: string;
     base_url: string;
@@ -60,4 +110,4 @@ declare class Client {
     constructor(opts: ClientOptions);
 }
 
-export { Client, type ClientOptions };
+export { Client, type ClientOptions, type InlineKeyboardButton, type InlineKeyboardMarkup, KeyboardBuilder };

package/dist/index.d.ts

@@ -1,3 +1,53 @@
+type InlineKeyboardButton = {
+    text: string;
+    url?: string;
+    style?: string;
+    callback_data?: string;
+    web_app?: {
+        url: string;
+    };
+    login_url?: {
+        url: string;
+        forward_text?: string;
+        bot_username?: string;
+        request_write_access?: boolean;
+    };
+    switch_inline_query?: string;
+    switch_inline_query_current_chat?: string;
+    switch_inline_query_chosen_chat?: {
+        query?: string;
+        allow_user_chats?: boolean;
+        allow_bot_chats?: boolean;
+        allow_group_chats?: boolean;
+        allow_channel_chats?: boolean;
+    };
+    copy_text?: {
+        text: string;
+    };
+};
+type InlineKeyboardMarkup = {
+    inline_keyboard: InlineKeyboardButton[][];
+};
+declare class KeyboardBuilder {
+    private keyboard;
+    private _maxPerRow;
+    static inline(): KeyboardBuilder;
+    maxPerRow(n: number): this;
+    private currentRow;
+    row(): this;
+    private push;
+    url(text: string, url: string): this;
+    style(text: string, style: string, url: string): this;
+    callback(text: string, data: string): this;
+    webApp(text: string, url: string): this;
+    loginUrl(text: string, url: string, opts?: Omit<NonNullable<InlineKeyboardButton["login_url"]>, "url">): this;
+    switchInline(text: string, query: string): this;
+    switchInlineCurrentChat(text: string, query: string): this;
+    switchInlineChosenChat(text: string, opts: InlineKeyboardButton["switch_inline_query_chosen_chat"]): this;
+    copyText(text: string, copy: string): this;
+    build(): InlineKeyboardMarkup;
+}
+
 type HttpOptions = {
     api_key: string;
     base_url: string;
@@ -60,4 +110,4 @@ declare class Client {
     constructor(opts: ClientOptions);
 }
 
-export { Client, type ClientOptions };
+export { Client, type ClientOptions, type InlineKeyboardButton, type InlineKeyboardMarkup, KeyboardBuilder };

package/dist/index.js

@@ -20,10 +20,94 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  Client: () => Client
+  Client: () => Client,
+  KeyboardBuilder: () => KeyboardBuilder
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/builders/keyboard.ts
+var KeyboardBuilder = class _KeyboardBuilder {
+  constructor() {
+    this.keyboard = [[]];
+    this._maxPerRow = null;
+  }
+  static inline() {
+    return new _KeyboardBuilder();
+  }
+  maxPerRow(n) {
+    if (!Number.isInteger(n) || n <= 0) throw new Error("maxPerRow must be a positive integer");
+    this._maxPerRow = n;
+    return this;
+  }
+  currentRow() {
+    return this.keyboard[this.keyboard.length - 1];
+  }
+  row() {
+    if (this.currentRow().length === 0) return this;
+    this.keyboard.push([]);
+    return this;
+  }
+  push(btn) {
+    if (!btn.text?.trim()) throw new Error("Button text is required");
+    if (btn.text.length > 64) throw new Error("Button text too long (max 64 chars)");
+    const actionKeys = [
+      "url",
+      "callback_data",
+      "web_app",
+      "login_url",
+      "switch_inline_query",
+      "switch_inline_query_current_chat",
+      "switch_inline_query_chosen_chat",
+      "copy_text"
+    ];
+    const used = actionKeys.filter((k) => btn[k] != null);
+    if (used.length !== 1) {
+      throw new Error(`InlineKeyboardButton must have exactly 1 action field, got: ${used.join(", ") || "none"}`);
+    }
+    if (btn.callback_data && btn.callback_data.length > 64) {
+      throw new Error("callback_data too long (max 64 chars)");
+    }
+    if (this._maxPerRow && this.currentRow().length >= this._maxPerRow) {
+      this.row();
+    }
+    this.currentRow().push(btn);
+    return this;
+  }
+  url(text, url) {
+    return this.push({ text, url });
+  }
+  style(text, style, url) {
+    return this.push({ text, style, url });
+  }
+  callback(text, data) {
+    return this.push({ text, callback_data: data });
+  }
+  webApp(text, url) {
+    return this.push({ text, web_app: { url } });
+  }
+  loginUrl(text, url, opts) {
+    return this.push({ text, login_url: { url, ...opts ?? {} } });
+  }
+  switchInline(text, query) {
+    return this.push({ text, switch_inline_query: query });
+  }
+  switchInlineCurrentChat(text, query) {
+    return this.push({ text, switch_inline_query_current_chat: query });
+  }
+  switchInlineChosenChat(text, opts) {
+    if (!opts) throw new Error("switch_inline_query_chosen_chat options required");
+    return this.push({ text, switch_inline_query_chosen_chat: opts });
+  }
+  copyText(text, copy) {
+    return this.push({ text, copy_text: { text: copy } });
+  }
+  build() {
+    const cleaned = this.keyboard.filter((r) => r.length > 0);
+    if (cleaned.length === 0) throw new Error("Keyboard is empty");
+    return { inline_keyboard: cleaned };
+  }
+};
+
 // src/http.ts
 var Http = class {
   constructor(opts) {
@@ -149,5 +233,6 @@ var Client = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Client
+  Client,
+  KeyboardBuilder
 });

package/dist/index.mjs

@@ -1,3 +1,86 @@
+// src/builders/keyboard.ts
+var KeyboardBuilder = class _KeyboardBuilder {
+  constructor() {
+    this.keyboard = [[]];
+    this._maxPerRow = null;
+  }
+  static inline() {
+    return new _KeyboardBuilder();
+  }
+  maxPerRow(n) {
+    if (!Number.isInteger(n) || n <= 0) throw new Error("maxPerRow must be a positive integer");
+    this._maxPerRow = n;
+    return this;
+  }
+  currentRow() {
+    return this.keyboard[this.keyboard.length - 1];
+  }
+  row() {
+    if (this.currentRow().length === 0) return this;
+    this.keyboard.push([]);
+    return this;
+  }
+  push(btn) {
+    if (!btn.text?.trim()) throw new Error("Button text is required");
+    if (btn.text.length > 64) throw new Error("Button text too long (max 64 chars)");
+    const actionKeys = [
+      "url",
+      "callback_data",
+      "web_app",
+      "login_url",
+      "switch_inline_query",
+      "switch_inline_query_current_chat",
+      "switch_inline_query_chosen_chat",
+      "copy_text"
+    ];
+    const used = actionKeys.filter((k) => btn[k] != null);
+    if (used.length !== 1) {
+      throw new Error(`InlineKeyboardButton must have exactly 1 action field, got: ${used.join(", ") || "none"}`);
+    }
+    if (btn.callback_data && btn.callback_data.length > 64) {
+      throw new Error("callback_data too long (max 64 chars)");
+    }
+    if (this._maxPerRow && this.currentRow().length >= this._maxPerRow) {
+      this.row();
+    }
+    this.currentRow().push(btn);
+    return this;
+  }
+  url(text, url) {
+    return this.push({ text, url });
+  }
+  style(text, style, url) {
+    return this.push({ text, style, url });
+  }
+  callback(text, data) {
+    return this.push({ text, callback_data: data });
+  }
+  webApp(text, url) {
+    return this.push({ text, web_app: { url } });
+  }
+  loginUrl(text, url, opts) {
+    return this.push({ text, login_url: { url, ...opts ?? {} } });
+  }
+  switchInline(text, query) {
+    return this.push({ text, switch_inline_query: query });
+  }
+  switchInlineCurrentChat(text, query) {
+    return this.push({ text, switch_inline_query_current_chat: query });
+  }
+  switchInlineChosenChat(text, opts) {
+    if (!opts) throw new Error("switch_inline_query_chosen_chat options required");
+    return this.push({ text, switch_inline_query_chosen_chat: opts });
+  }
+  copyText(text, copy) {
+    return this.push({ text, copy_text: { text: copy } });
+  }
+  build() {
+    const cleaned = this.keyboard.filter((r) => r.length > 0);
+    if (cleaned.length === 0) throw new Error("Keyboard is empty");
+    return { inline_keyboard: cleaned };
+  }
+};
+
 // src/http.ts
 var Http = class {
   constructor(opts) {
@@ -122,5 +205,6 @@ var Client = class {
   }
 };
 export {
-  Client
+  Client,
+  KeyboardBuilder
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtsea/tgcore-ts",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "tgcore TypeScript SDK • Telegram Engine Client",
   "main": "dist/index.js",
   "module": "dist/index.js",