karboai 1.6.0 → 1.7.0

package/README.RU.md

@@ -32,6 +32,14 @@
     - [on()](#on)
     - [command()](#command)
 - [Схемы](#схемы)
+- [Утилиты](#утилиты)
+  - [bold()](#bold)
+  - [italic()](#italic)
+  - [centralize()](#centralize)
+  - [code()](#code)
+  - [strikethrough()](#strikethrough)
+  - [underline()](#underline)
+  - [hyperlink()](#hyperlink)
 - [Логирование](#логирование)
 
 ## Установка
@@ -393,6 +401,120 @@ router.command('/start', async ({ karbo, message }) => {
 import { KarboConfig, Message, KarboContext, User } from 'karboai';
 ```
 
+## Утилиты
+
+Вспомогательные функции для форматирования текста в сообщениях. Все утилиты экспортируются из основного пакета.
+
+```typescript
+import { bold, italic, centralize, code, strikethrough, underline, hyperlink } from 'karboai';
+```
+
+### `bold(text)`
+
+Оборачивает текст в жирное форматирование.
+
+**Параметры:**
+- `text` — Текст для форматирования
+
+**Возвращает:** `string` — Отформатированный текст с маркерами `**`
+
+**Пример:**
+```typescript
+await karbo.text('chat-123', bold('Это жирный текст'));
+// Отправит: **Это жирный текст**
+```
+
+### `italic(text)`
+
+Оборачивает текст в курсивное форматирование.
+
+**Параметры:**
+- `text` — Текст для форматирования
+
+**Возвращает:** `string` — Отформатированный текст с маркерами `__`
+
+**Пример:**
+```typescript
+await karbo.text('chat-123', italic('Это курсивный текст'));
+// Отправит: __Это курсивный текст__
+```
+
+### `centralize(text)`
+
+Выравнивает текст по центру сообщения.
+
+**Параметры:**
+- `text` — Текст для центрирования
+
+**Возвращает:** `string` — Отформатированный текст с префиксом `[C]`
+
+**Пример:**
+```typescript
+await karbo.text('chat-123', centralize('Центрированный текст'));
+// Отправит: [C]Центрированный текст
+```
+
+### `code(text)`
+
+Оборачивает текст в inline-код форматирование.
+
+**Параметры:**
+- `text` — Текст для форматирования
+
+**Возвращает:** `string` — Отформатированный текст с обратными кавычками
+
+**Пример:**
+```typescript
+await karbo.text('chat-123', code('const x = 42'));
+// Отправит: `const x = 42`
+```
+
+### `strikethrough(text)`
+
+Оборачивает текст в зачёркнутое форматирование.
+
+**Параметры:**
+- `text` — Текст для форматирования
+
+**Возвращает:** `string` — Отформатированный текст с маркерами `~~`
+
+**Пример:**
+```typescript
+await karbo.text('chat-123', strikethrough('Это удалённый текст'));
+// Отправит: ~~Это удалённый текст~~
+```
+
+### `underline(text)`
+
+Оборачивает текст в подчёркнутое форматирование.
+
+**Параметры:**
+- `text` — Текст для форматирования
+
+**Возвращает:** `string` — Отформатированный текст с маркерами `++`
+
+**Пример:**
+```typescript
+await karbo.text('chat-123', underline('Подчёркнутый текст'));
+// Отправит: ++Подчёркнутый текст++
+```
+
+### `hyperlink(text, url)`
+
+Создаёт гиперссылку с отображаемым текстом.
+
+**Параметры:**
+- `text` — Отображаемый текст ссылки
+- `url` — URL для гиперссылки
+
+**Возвращает:** `string` — Отформатированная гиперссылка
+
+**Пример:**
+```typescript
+await karbo.text('chat-123', hyperlink('Посетить KarboAI', 'https://karboai.com'));
+// Отправит: [Посетить KarboAI](https://karboai.com)
+```
+
 ## Логирование
 
 Включите структурированное логирование, установив `enableLogging: true` в конфигурации:

package/README.md

@@ -32,6 +32,14 @@ A powerful library for creating bots in the [KarboAI](https://karboai.com) appli
     - [on()](#on)
     - [command()](#command)
 - [Schemas](#schemas)
+- [Utilities](#utilities)
+  - [bold()](#bold)
+  - [italic()](#italic)
+  - [centralize()](#centralize)
+  - [code()](#code)
+  - [strikethrough()](#strikethrough)
+  - [underline()](#underline)
+  - [hyperlink()](#hyperlink)
 - [Logging](#logging)
 
 ## Installation
@@ -393,6 +401,120 @@ The library exports several TypeScript types and Zod schemas:
 import { KarboConfig, Message, KarboContext, User } from 'karboai';
 ```
 
+## Utilities
+
+Helper functions for formatting text in messages. All utilities are exported from the main package.
+
+```typescript
+import { bold, italic, centralize, code, strikethrough, underline, hyperlink } from 'karboai';
+```
+
+### `bold(text)`
+
+Wraps text in bold formatting.
+
+**Parameters:**
+- `text` — Text to format
+
+**Returns:** `string` — Formatted text with `**` markers
+
+**Example:**
+```typescript
+await karbo.text('chat-123', bold('This is bold text'));
+// Sends: **This is bold text**
+```
+
+### `italic(text)`
+
+Wraps text in italic formatting.
+
+**Parameters:**
+- `text` — Text to format
+
+**Returns:** `string` — Formatted text with `__` markers
+
+**Example:**
+```typescript
+await karbo.text('chat-123', italic('This is italic text'));
+// Sends: __This is italic text__
+```
+
+### `centralize(text)`
+
+Centers text in the message.
+
+**Parameters:**
+- `text` — Text to center
+
+**Returns:** `string` — Formatted text with `[C]` prefix
+
+**Example:**
+```typescript
+await karbo.text('chat-123', centralize('Centered text'));
+// Sends: [C]Centered text
+```
+
+### `code(text)`
+
+Wraps text in inline code formatting.
+
+**Parameters:**
+- `text` — Text to format
+
+**Returns:** `string` — Formatted text with backtick markers
+
+**Example:**
+```typescript
+await karbo.text('chat-123', code('const x = 42'));
+// Sends: `const x = 42`
+```
+
+### `strikethrough(text)`
+
+Wraps text in strikethrough formatting.
+
+**Parameters:**
+- `text` — Text to format
+
+**Returns:** `string` — Formatted text with `~~` markers
+
+**Example:**
+```typescript
+await karbo.text('chat-123', strikethrough('This is deleted'));
+// Sends: ~~This is deleted~~
+```
+
+### `underline(text)`
+
+Wraps text in underline formatting.
+
+**Parameters:**
+- `text` — Text to format
+
+**Returns:** `string` — Formatted text with `++` markers
+
+**Example:**
+```typescript
+await karbo.text('chat-123', underline('Underlined text'));
+// Sends: ++Underlined text++
+```
+
+### `hyperlink(text, url)`
+
+Creates a hyperlink with display text.
+
+**Parameters:**
+- `text` — Display text for the link
+- `url` — URL for the hyperlink
+
+**Returns:** `string` — Formatted hyperlink
+
+**Example:**
+```typescript
+await karbo.text('chat-123', hyperlink('Visit KarboAI', 'https://karboai.com'));
+// Sends: [Visit KarboAI](https://karboai.com)
+```
+
 ## Logging
 
 Enable structured logging by setting `enableLogging: true` in the config:

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { Router } from './core/hub/router';
 export { KarboAI } from './core/karboai';
+export { bold, italic, centralize, code, strikethrough, underline, hyperlink, } from './utils/utils';
 export * from './schemas/index';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EACL,IAAI,EACJ,MAAM,EACN,UAAU,EACV,IAAI,EACJ,aAAa,EACb,SAAS,EACT,SAAS,GACV,MAAM,eAAe,CAAC;AAEvB,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -14,9 +14,17 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KarboAI = exports.Router = void 0;
+exports.hyperlink = exports.underline = exports.strikethrough = exports.code = exports.centralize = exports.italic = exports.bold = exports.KarboAI = exports.Router = void 0;
 var router_1 = require("./core/hub/router");
 Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return router_1.Router; } });
 var karboai_1 = require("./core/karboai");
 Object.defineProperty(exports, "KarboAI", { enumerable: true, get: function () { return karboai_1.KarboAI; } });
+var utils_1 = require("./utils/utils");
+Object.defineProperty(exports, "bold", { enumerable: true, get: function () { return utils_1.bold; } });
+Object.defineProperty(exports, "italic", { enumerable: true, get: function () { return utils_1.italic; } });
+Object.defineProperty(exports, "centralize", { enumerable: true, get: function () { return utils_1.centralize; } });
+Object.defineProperty(exports, "code", { enumerable: true, get: function () { return utils_1.code; } });
+Object.defineProperty(exports, "strikethrough", { enumerable: true, get: function () { return utils_1.strikethrough; } });
+Object.defineProperty(exports, "underline", { enumerable: true, get: function () { return utils_1.underline; } });
+Object.defineProperty(exports, "hyperlink", { enumerable: true, get: function () { return utils_1.hyperlink; } });
 __exportStar(require("./schemas/index"), exports);

package/dist/utils/utils.d.ts

@@ -1,3 +1,10 @@
 export declare const clean: (body: Record<string, any>) => Record<string, any>;
 export declare const generateRouterName: () => string;
+export declare const bold: (text: string) => string;
+export declare const italic: (text: string) => string;
+export declare const centralize: (text: string) => string;
+export declare const code: (text: string) => string;
+export declare const strikethrough: (text: string) => string;
+export declare const underline: (text: string) => string;
+export declare const hyperlink: (text: string, url: string) => string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAGjE,CAAC;AAEJ,eAAO,MAAM,kBAAkB,QAAO,MACkB,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAGjE,CAAC;AAEJ,eAAO,MAAM,kBAAkB,QAAO,MACkB,CAAC;AAEzD,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,WAAkB,CAAC;AACpD,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,WAAkB,CAAC;AACtD,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,WAAiB,CAAC;AACzD,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,WAAkB,CAAC;AACpD,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,WAAkB,CAAC;AAC7D,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,WAAkB,CAAC;AACzD,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAK,MAAM,WAAwB,CAAC"}

package/dist/utils/utils.js

@@ -1,7 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateRouterName = exports.clean = void 0;
+exports.hyperlink = exports.underline = exports.strikethrough = exports.code = exports.centralize = exports.italic = exports.bold = exports.generateRouterName = exports.clean = void 0;
 const clean = (body) => Object.fromEntries(Object.entries(body).filter(([_, value]) => value !== undefined));
 exports.clean = clean;
 const generateRouterName = () => `router-${Math.random().toString(36).substring(2, 9)}`;
 exports.generateRouterName = generateRouterName;
+const bold = (text) => `**${text}**`;
+exports.bold = bold;
+const italic = (text) => `__${text}__`;
+exports.italic = italic;
+const centralize = (text) => `[C]${text}`;
+exports.centralize = centralize;
+const code = (text) => `\`${text}\``;
+exports.code = code;
+const strikethrough = (text) => `~~${text}~~`;
+exports.strikethrough = strikethrough;
+const underline = (text) => `++${text}++`;
+exports.underline = underline;
+const hyperlink = (text, url) => `[${text}](${url})`;
+exports.hyperlink = hyperlink;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karboai",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "A powerful lib for https://karboai.com",
   "keywords": [
     "karbo",