@ebowwa/channel-telegram 1.12.6 → 1.13.0

package/README.md

@@ -1,58 +1,92 @@
-# GLM Daemon Telegram Bot
+# @ebowwa/channel-telegram
 
-Telegram adapter for GLM Daemon with ButlerAgent personality.
+Pure Telegram protocol adapter implementing `ChannelConnector` from `@ebowwa/channel-types`.
 
-## Setup
+## Purpose
 
-1. **Install dependencies:**
-   ```bash
-   bun install
-   ```
+This package handles ONLY Telegram protocol operations:
+- Message polling and delivery
+- Typing indicators
+- Long message chunking
+- Access control
+- Message normalization to `ChannelMessage` format
 
-2. **Configure Doppler secrets:**
-   ```
-   TELEGRAM_BOT_TOKEN=<your-bot-token>
-   TELEGRAM_TEST_CHAT_ID=<your-chat-id>  # Optional, for test message
-   GLM_API_KEY=<your-api-key>
-   DOPPLER_TOKEN=<your-doppler-token>
-   ```
+**Intelligence (GLM, tools, memory) is provided by the consumer/daemon.**
 
-3. **Build:**
-   ```bash
-   bun run build
-   ```
+## Usage
 
-4. **Run:**
-   ```bash
-   bun run start
-   ```
+```typescript
+import { createTelegramChannel, createTelegramConfigFromEnv } from "@ebowwa/channel-telegram";
 
-   Or with Doppler:
-   ```bash
-   doppler run -- bun run start
-   ```
+const config = createTelegramConfigFromEnv();
+const channel = createTelegramChannel(config);
 
-## Getting Telegram Credentials
+// Set message handler - daemon provides intelligence
+channel.onMessage(async (message) => {
+  console.log(`Received: ${message.text} from ${message.sender.displayName}`);
 
-1. **Create a bot:**
-   - Message [@BotFather](https://t.me/botfather) on Telegram
-   - Send `/newbot`
-   - Follow the prompts
-   - Copy the bot token (format: `123456789:ABCdefGHIjklMNOpqrsTUVwxyz`)
+  // Process with your LLM/tools/memory here
+  const response = await yourLLM.process(message);
 
-2. **Get your Chat ID:**
-   - Message [@userinfobot](https://t.me/userinfobot) on Telegram
-   - It will reply with your chat ID
-   - Add this to Doppler as `TELEGRAM_TEST_CHAT_ID`
+  return {
+    content: { text: response },
+    replyTo: { messageId: message.messageId, channelId: message.channelId },
+  };
+});
 
-## Features
+await channel.start();
+```
 
-- ✅ Natural conversation with ButlerAgent personality
-- ✅ Context-aware responses (remembers username, name)
-- ✅ Long message chunking (4096 char limit)
-- ✅ Error handling with graceful fallbacks
-- ✅ Test message on startup
+## Configuration
 
-## Deployment
+Environment variables:
 
-See `TICKET.md` for deployment details.
+```
+TELEGRAM_BOT_TOKEN=<your-bot-token>
+TELEGRAM_TEST_CHAT_ID=<chat-id>      # Optional, for startup notification
+TELEGRAM_ALLOWED_USERS=<user-ids>    # Optional, comma-separated
+TELEGRAM_ALLOWED_CHATS=<chat-ids>    # Optional, comma-separated
+```
+
+## API
+
+### `TelegramChannel`
+
+Implements `ChannelConnector`:
+
+- `start()` - Start polling for messages
+- `stop()` - Stop polling
+- `onMessage(handler)` - Set message handler
+- `send(response)` - Send response to channel
+- `isConnected()` - Check connection status
+
+Additional helpers:
+
+- `sendMessage(chatId, text, options)` - Send simple message
+- `sendTyping(chatId)` - Send typing indicator
+- `startTypingIndicator(chatId)` - Continuous typing indicator
+- `stopTypingIndicator(chatId)` - Stop typing indicator
+- `isAllowed(userId, chatId)` - Check access
+- `getBot()` - Get underlying TelegramBot instance
+
+## Architecture
+
+```
+┌─────────────────┐
+│  Telegram API   │
+└────────┬────────┘
+         │
+┌────────▼────────┐
+│ channel-telegram│  ← Pure protocol adapter
+│  - Polling      │
+│  - Normalization│
+│  - Chunking     │
+└────────┬────────┘
+         │ ChannelMessage
+┌────────▼────────┐
+│  GLM Daemon     │  ← Provides intelligence
+│  - LLM          │
+│  - Tools/MCP    │
+│  - Memory       │
+└─────────────────┘
+```

package/dist/commands/index.d.ts

@@ -16,6 +16,7 @@ export { registerResumeCommand } from './resume';
 export { registerQuietCommand, isQuiet, clearQuiet } from './quiet';
 export { registerVerboseCommand } from './verbose';
 export { registerInnerthoughtsCommand } from './innerthoughts';
+export { register as registerRestartCommand } from './restart';
 export type { CommandRegistrar, CommandContext } from './types';
 import type TelegramBot from 'node-telegram-bot-api';
 /**

package/dist/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE/D,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEhE,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAC;AAkBrD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,OAAO,wBAAwB,EAAE,kBAAkB,EAC3D,KAAK,EAAE,OAAO,UAAU,EAAE,IAAI,EAAE,GAC/B,IAAI,CAgBN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAG/D,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEhE,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAC;AAkBrD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,OAAO,wBAAwB,EAAE,kBAAkB,EAC3D,KAAK,EAAE,OAAO,UAAU,EAAE,IAAI,EAAE,GAC/B,IAAI,CAiBN"}

package/dist/commands/index.js

@@ -16,6 +16,8 @@ export { registerResumeCommand } from './resume';
 export { registerQuietCommand, isQuiet, clearQuiet } from './quiet';
 export { registerVerboseCommand } from './verbose';
 export { registerInnerthoughtsCommand } from './innerthoughts';
+export { register as registerRestartCommand } from './restart';
+import { register as importedRegisterRestart } from './restart';
 import { registerStartCommand } from './start';
 import { registerStatusCommand } from './status';
 import { registerHelpCommand } from './help';
@@ -50,5 +52,6 @@ export function registerAllCommands(bot, memory, tools) {
     registerQuietCommand(bot, memory, tools);
     registerVerboseCommand(bot, memory, tools);
     registerInnerthoughtsCommand(bot, memory, tools);
+    importedRegisterRestart(bot, tools);
 }
 //# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/restart.d.ts

@@ -0,0 +1,7 @@
+/**
+ * /restart command - Restart the Telegram bot systemd service
+ */
+import TelegramBot from "node-telegram-bot-api";
+import type { Tool } from "../index.js";
+export declare function register(bot: TelegramBot, tools: Tool[]): void;
+//# sourceMappingURL=restart.d.ts.map

package/dist/commands/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../src/commands/restart.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAEhD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAgC9D"}

package/dist/commands/restart.js

@@ -0,0 +1,29 @@
+/**
+ * /restart command - Restart the Telegram bot systemd service
+ */
+import { execSync } from "child_process";
+export function register(bot, tools) {
+    bot.onText(/\/restart(?:@[\w]+)?(?:\s+(.+))?/, async (msg, match) => {
+        const chatId = msg.chat.id;
+        const serviceName = match?.[1]?.trim() || "telegram-bot";
+        try {
+            // Restart the systemd service
+            execSync(`sudo systemctl restart ${serviceName}`, {
+                timeout: 30000,
+                encoding: "utf-8"
+            });
+            await bot.sendMessage(chatId, `Restarting ${serviceName} service...\n\n` +
+                `The bot will restart momentarily. You should see a startup message soon.`);
+        }
+        catch (error) {
+            if (error.message?.includes("systemctl: command not found")) {
+                await bot.sendMessage(chatId, "This command only works on Linux systems with systemd.\n\n" +
+                    "On macOS, use: brew services restart telegram-bot");
+            }
+            else {
+                await bot.sendMessage(chatId, `Error restarting service:\n${error.message}`);
+            }
+        }
+    });
+}
+//# sourceMappingURL=restart.js.map

package/dist/commands/restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../src/commands/restart.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,MAAM,UAAU,QAAQ,CAAC,GAAgB,EAAE,KAAa;IACtD,GAAG,CAAC,MAAM,CAAC,kCAAkC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAClE,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,cAAc,CAAC;QAEzD,IAAI,CAAC;YACH,8BAA8B;YAC9B,QAAQ,CAAC,0BAA0B,WAAW,EAAE,EAAE;gBAChD,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YAEH,MAAM,GAAG,CAAC,WAAW,CACnB,MAAM,EACN,cAAc,WAAW,iBAAiB;gBAC1C,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;gBAC5D,MAAM,GAAG,CAAC,WAAW,CACnB,MAAM,EACN,4DAA4D;oBAC5D,mDAAmD,CACpD,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC,WAAW,CACnB,MAAM,EACN,8BAA8B,KAAK,CAAC,OAAO,EAAE,CAC9C,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/settings.d.ts

@@ -0,0 +1,8 @@
+/**
+ * /settings command - Configure bot settings
+ * TODO: Implement full settings UI
+ */
+import TelegramBot from "node-telegram-bot-api";
+import type { Tool } from "../index.js";
+export declare function register(bot: TelegramBot, tools: Tool[]): void;
+//# sourceMappingURL=settings.d.ts.map

package/dist/commands/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/commands/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAe9D"}

package/dist/commands/settings.js

@@ -0,0 +1,16 @@
+/**
+ * /settings command - Configure bot settings
+ * TODO: Implement full settings UI
+ */
+export function register(bot, tools) {
+    bot.onText(/\/settings/, async (msg) => {
+        const chatId = msg.chat.id;
+        await bot.sendMessage(chatId, "*Settings*\n\n" +
+            "Current configuration:\n" +
+            "- Model: GLM-4.7\n" +
+            "- Tools: " + tools.length + " available\n" +
+            "- MCP: " + (process.env.MCP_ENABLED === "true" ? "Enabled" : "Disabled") + "\n\n" +
+            "Settings will be configurable in a future update.", { parse_mode: "Markdown" });
+    });
+}
+//# sourceMappingURL=settings.js.map

package/dist/commands/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/commands/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,UAAU,QAAQ,CAAC,GAAgB,EAAE,KAAa;IACtD,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAE3B,MAAM,GAAG,CAAC,WAAW,CACnB,MAAM,EACN,gBAAgB;YAChB,0BAA0B;YAC1B,oBAAoB;YACpB,WAAW,GAAG,KAAK,CAAC,MAAM,GAAG,cAAc;YAC3C,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,MAAM;YAClF,mDAAmD,EACnD,EAAE,UAAU,EAAE,UAAU,EAAE,CAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -1,47 +1,101 @@
 /**
- * GLM Daemon Telegram Bot
+ * @ebowwa/channel-telegram
  *
- * Full-featured Telegram bot with GLM-4.7 AI, git status, Doppler integration
+ * Telegram channel adapter implementing ChannelConnector.
  *
- * Features:
- * - GLM-4.7 AI responses via Z.AI API
- * - 429 rate limit handling with exponential backoff
- * - /git command for git status + GitHub auth
- * - /doppler command for Doppler secrets status
- * - Rolling API key support
+ * This package handles:
+ * - Telegram protocol operations (polling, message delivery)
+ * - Built-in commands (/start, /help, /status, etc.)
+ * - Typing indicators, message chunking, access control
+ * - Message normalization to ChannelMessage format
+ *
+ * Intelligence (GLM, tools, memory) can be provided by:
+ * 1. This package (standalone mode with built-in tools)
+ * 2. External daemon/consumer (adapter mode via onMessage handler)
  */
-export interface Tool {
-    name: string;
-    description: string;
-    parameters: Record<string, unknown>;
-    handler: (args: Record<string, unknown>) => Promise<string>;
+import TelegramBot from "node-telegram-bot-api";
+import { type ChannelId, type ChannelResponse, type ChannelCapabilities, type MessageHandler } from "@ebowwa/channel-types";
+import { ConversationMemory } from "./conversation-memory.js";
+import type { Tool } from "./types.js";
+export { ConversationMemory } from "./conversation-memory.js";
+export { registerAllCommands, isQuiet } from "./commands/index.js";
+export type { Tool } from "./types.js";
+export interface TelegramConfig {
+    botToken: string;
+    testChatId?: string;
+    allowedUsers?: number[];
+    allowedChats?: number[];
+    /** Optional tools for command handlers (e.g., /tools command) */
+    tools?: Tool[];
+    /** Optional conversations file path */
+    conversationsFile?: string;
 }
-export declare class TelegramGLMBot {
+export declare function createTelegramConfigFromEnv(): TelegramConfig;
+export declare class TelegramChannel {
+    readonly id: ChannelId;
+    readonly label = "Telegram";
+    readonly capabilities: ChannelCapabilities;
     private bot;
+    private config;
     private memory;
+    private tools;
+    private messageHandler?;
     private typingIntervals;
-    constructor(token: string);
+    private connected;
+    constructor(config: TelegramConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
     /**
-     * Start periodic typing indicator for a chat
-     * Telegram typing indicator lasts ~5 seconds, so refresh every 3 seconds
+     * Set the message handler. The daemon/consumer provides intelligence.
      */
-    private startTypingIndicator;
+    onMessage(handler: MessageHandler): void;
     /**
-     * Stop periodic typing indicator for a chat
+     * Send a response back to Telegram.
      */
-    private stopTypingIndicator;
+    send(response: ChannelResponse): Promise<void>;
+    isConnected(): boolean;
     /**
-     * Send message, splitting if too long for Telegram (4096 char limit)
+     * Get the underlying TelegramBot instance for advanced operations.
      */
-    private sendLongMessage;
-    start(): Promise<void>;
-    getGLMResponse(chatId: number, userMessage: string, userName: string): Promise<string>;
-    sendTestMessage(chatId: number): Promise<void>;
-    stop(): Promise<void>;
+    getBot(): TelegramBot;
+    /**
+     * Get the conversation memory.
+     */
+    getMemory(): ConversationMemory;
+    /**
+     * Send a simple text message.
+     */
+    sendMessage(chatId: number, text: string, options?: TelegramBot.SendMessageOptions): Promise<void>;
+    /**
+     * Send typing indicator.
+     */
+    sendTyping(chatId: number): Promise<void>;
     /**
-     * Check for crash recovery - analyze previous session and report
-     * Always sends a startup message (crash or normal)
+     * Start continuous typing indicator (until response is ready).
      */
-    checkCrashAndReport(chatId: number): Promise<void>;
+    startTypingIndicator(chatId: number): void;
+    /**
+     * Stop typing indicator.
+     */
+    stopTypingIndicator(chatId: number): void;
+    /**
+     * Check if user/chat is allowed.
+     */
+    isAllowed(userId?: number, chatId?: number): boolean;
+    private setupMessageHandlers;
+    /**
+     * Register Telegram command menu
+     */
+    private registerCommands;
+    /**
+     * Normalize Telegram message to ChannelMessage format.
+     */
+    private createChannelMessage;
+    private extractChatId;
+    /**
+     * Send long message by splitting into chunks.
+     */
+    private sendLongMessage;
 }
+export declare function createTelegramChannel(config: TelegramConfig): TelegramChannel;
 //# 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;;;;;;;;;;;GAWG;AAuBH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D;AAiRD,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,eAAe,CAA0C;gBAErD,KAAK,EAAE,MAAM;IAczB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;YACW,eAAe;IAsCvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiQtB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwJtF,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;;OAGG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAyDzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAGxB,KAAK,cAAc,EAEpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iEAAiE;IACjE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,IAAI,cAAc,CAkB5D;AAMD,qBAAa,eAAe;IAC1B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,KAAK,cAAc;IAC5B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAkBxC;IAEF,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,cAAc;IAY5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpD,WAAW,IAAI,OAAO;IAQtB;;OAEG;IACH,MAAM,IAAI,WAAW;IAIrB;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxG;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAS1C;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQzC;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAoBpD,OAAO,CAAC,oBAAoB;IAyG5B;;OAEG;YACW,gBAAgB;IAiB9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoC5B,OAAO,CAAC,aAAa;IAOrB;;OAEG;YACW,eAAe;CAkC9B;AAMD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAE7E"}