hyperclaw 4.0.2 → 5.0.0

package/dist/connector-B3v0qcXg.js

@@ -0,0 +1,425 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const os = require_chunk.__toESM(require("os"));
+const https = require_chunk.__toESM(require("https"));
+const events = require_chunk.__toESM(require("events"));
+
+//#region extensions/zalo/src/connector.ts
+const STATE_BASE = path.default.join(os.default.homedir(), ".hyperclaw");
+const BOT_API_HOST = "bot.zaloplatforms.com";
+const BOT_API_BASE = "/v3";
+const TEXT_CHUNK = 2e3;
+const DEFAULT_MEDIA_MB = 5;
+const PAIRING_TTL_MS = 60 * 60 * 1e3;
+const DEDUP_TTL_MS = 6e4;
+function zaloApi(token, method, apiPath, body) {
+	return new Promise((resolve, reject) => {
+		const payload = body ? JSON.stringify(body) : null;
+		const qs = method === "GET" && !body ? "" : "";
+		const req = https.default.request({
+			hostname: BOT_API_HOST,
+			port: 443,
+			path: `${BOT_API_BASE}${apiPath}${qs}`,
+			method,
+			headers: {
+				Authorization: `Bot ${token}`,
+				Accept: "application/json",
+				...payload ? {
+					"Content-Type": "application/json",
+					"Content-Length": Buffer.byteLength(payload)
+				} : {}
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const r = JSON.parse(data);
+					if (r.error && r.error !== 0) reject(new Error(r.message || `Zalo error ${r.error}`));
+					else resolve(r);
+				} catch {
+					reject(new Error("Zalo: invalid JSON"));
+				}
+			});
+		});
+		req.on("error", reject);
+		req.setTimeout(35e3, () => {
+			req.destroy();
+			reject(new Error("Zalo API timeout"));
+		});
+		if (payload) req.write(payload);
+		req.end();
+	});
+}
+function zaloApiQuery(token, apiPath, params) {
+	return new Promise((resolve, reject) => {
+		const qs = new URLSearchParams(Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)]))).toString();
+		const req = https.default.request({
+			hostname: BOT_API_HOST,
+			port: 443,
+			path: `${BOT_API_BASE}${apiPath}?${qs}`,
+			method: "GET",
+			headers: {
+				Authorization: `Bot ${token}`,
+				Accept: "application/json"
+			}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const r = JSON.parse(data);
+					if (r.error && r.error !== 0) reject(new Error(r.message || `Zalo error ${r.error}`));
+					else resolve(r);
+				} catch {
+					reject(new Error("Zalo: invalid JSON"));
+				}
+			});
+		});
+		req.on("error", reject);
+		req.setTimeout(4e4, () => {
+			req.destroy();
+			reject(new Error("Zalo poll timeout"));
+		});
+		req.end();
+	});
+}
+var ZaloAccount = class extends events.EventEmitter {
+	cfg;
+	accountId;
+	token = "";
+	running = false;
+	offset = 0;
+	mediaMaxMb;
+	/** Dedup set: "eventName:messageId" → expiry timestamp */
+	dedupMap = /* @__PURE__ */ new Map();
+	constructor(accountId, cfg) {
+		super();
+		this.accountId = accountId;
+		this.cfg = {
+			dmPolicy: "pairing",
+			allowFrom: [],
+			groupPolicy: "allowlist",
+			groupAllowFrom: [],
+			mediaMaxMb: DEFAULT_MEDIA_MB,
+			pendingPairingTs: {},
+			...cfg
+		};
+		this.cfg.approvedPairings = this.cfg.approvedPairings ?? [];
+		this.cfg.pendingPairings = this.cfg.pendingPairings ?? {};
+		this.mediaMaxMb = this.cfg.mediaMaxMb ?? DEFAULT_MEDIA_MB;
+	}
+	async resolveToken() {
+		this.token = this.cfg.botToken || (this.cfg.tokenFile ? (await fs_extra.default.readFile(this.cfg.tokenFile, "utf8")).trim() : "");
+		if (!this.token) throw new Error(`Zalo [${this.accountId}]: botToken or tokenFile is required`);
+	}
+	async connect() {
+		await this.resolveToken();
+		await this.loadState();
+		this.running = true;
+		const useWebhook = !!this.cfg.webhookUrl;
+		if (useWebhook) {
+			await this.registerWebhook();
+			console.log(chalk.default.green(`  🔵 Zalo [${this.accountId}]: webhook mode — ${this.cfg.webhookUrl}`));
+		} else {
+			console.log(chalk.default.green(`  🔵 Zalo [${this.accountId}]: long-polling started`));
+			this.pollLoop();
+		}
+		this.emit("connected", {
+			accountId: this.accountId,
+			mode: useWebhook ? "webhook" : "polling"
+		});
+	}
+	disconnect() {
+		this.running = false;
+	}
+	async registerWebhook() {
+		if (!this.cfg.webhookUrl || !this.cfg.webhookSecret) return;
+		try {
+			await zaloApi(this.token, "POST", "/webhook", {
+				url: this.cfg.webhookUrl,
+				secret_token: this.cfg.webhookSecret
+			});
+		} catch (e) {
+			console.log(chalk.default.yellow(`  ⚠  Zalo [${this.accountId}]: webhook registration: ${e.message}`));
+		}
+	}
+	async pollLoop() {
+		while (this.running) try {
+			const resp = await zaloApiQuery(this.token, "/event", {
+				timeout: 30,
+				offset: this.offset
+			});
+			const events$1 = Array.isArray(resp?.updates) ? resp.updates : Array.isArray(resp?.result) ? resp.result : Array.isArray(resp) ? resp : [];
+			for (const event of events$1) {
+				const id = event.update_id ?? event.id;
+				if (id != null && id >= this.offset) this.offset = id + 1;
+				await this.handleEvent(event);
+			}
+		} catch (e) {
+			if (this.running) {
+				console.log(chalk.default.yellow(`  ⚠  Zalo [${this.accountId}] poll: ${e.message}`));
+				await new Promise((r) => setTimeout(r, 5e3));
+			}
+		}
+	}
+	async handleWebhook(rawBody, secretHeader) {
+		if (!this.verifyWebhookSecret(secretHeader)) {
+			console.log(chalk.default.yellow(`  ⚠  Zalo [${this.accountId}]: invalid webhook secret`));
+			return;
+		}
+		let event;
+		try {
+			event = JSON.parse(rawBody);
+		} catch {
+			return;
+		}
+		await this.handleEvent(event);
+	}
+	verifyWebhookSecret(headerValue) {
+		if (!this.cfg.webhookSecret) return true;
+		return headerValue === this.cfg.webhookSecret;
+	}
+	async handleEvent(event) {
+		if (!event) return;
+		const eventName = event.event_name || event.type || "";
+		const messageId = String(event.message?.msg_id || event.message_id || event.id || "");
+		if (messageId) {
+			const key = `${eventName}:${messageId}`;
+			const now = Date.now();
+			if (this.dedupMap.has(key)) return;
+			this.dedupMap.set(key, now + DEDUP_TTL_MS);
+			if (this.dedupMap.size > 1e3) {
+				for (const [k, exp] of this.dedupMap) if (exp < now) this.dedupMap.delete(k);
+			}
+		}
+		const sender = event.sender?.id || event.from?.id || event.user_id || "";
+		const groupId = event.message?.group_id || event.group_id || "";
+		const isGroup = !!groupId;
+		let text = "";
+		switch (eventName) {
+			case "user_send_text":
+			case "message":
+				text = event.message?.text || event.text || "";
+				break;
+			case "user_send_image":
+			case "message_image": {
+				const url = event.message?.attachments?.[0]?.payload?.url || event.image_url || "";
+				const size = event.message?.attachments?.[0]?.payload?.filesize || 0;
+				const maxBytes = this.mediaMaxMb * 1024 * 1024;
+				if (size > maxBytes) return;
+				text = url ? `[image:${url}]` : "[image]";
+				break;
+			}
+			case "user_send_sticker":
+			case "message_sticker": return;
+			default: return;
+		}
+		if (!text || !sender) return;
+		if (isGroup) {
+			if (!this.checkGroupPolicy(groupId, sender)) return;
+			this.emit("message", {
+				channelId: "zalo",
+				accountId: this.accountId,
+				chatId: groupId,
+				from: sender,
+				text,
+				isDM: false
+			});
+		} else {
+			const allowed = await this.checkDMPolicy(sender, text);
+			if (!allowed) return;
+			this.emit("message", {
+				channelId: "zalo",
+				accountId: this.accountId,
+				chatId: sender,
+				from: sender,
+				text,
+				isDM: true
+			});
+		}
+	}
+	async checkDMPolicy(from, text) {
+		const policy = this.cfg.dmPolicy ?? "pairing";
+		const allowFrom = this.cfg.allowFrom ?? [];
+		this.pruneExpiredCodes();
+		switch (policy) {
+			case "disabled": return false;
+			case "open": return true;
+			case "allowlist":
+				if (allowFrom.includes(from) || allowFrom.includes("*")) return true;
+				await this.sendText(from, "HyperClaw: Not on allowlist.");
+				return false;
+			case "pairing": {
+				if (this.cfg.approvedPairings.includes(from)) return true;
+				const upper = text.trim().toUpperCase().match(/[A-Z0-9]{6}/)?.[0];
+				if (upper && this.cfg.pendingPairings[upper]) {
+					this.cfg.approvedPairings.push(from);
+					delete this.cfg.pendingPairings[upper];
+					delete this.cfg.pendingPairingTs[upper];
+					await this.saveState();
+					await this.sendText(from, "Paired!");
+					this.emit("pairing:approved", {
+						userId: from,
+						channelId: "zalo",
+						accountId: this.accountId
+					});
+					return true;
+				}
+				const code = Array.from({ length: 6 }, () => "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"[Math.floor(Math.random() * 32)]).join("");
+				this.cfg.pendingPairings[code] = from;
+				this.cfg.pendingPairingTs[code] = Date.now();
+				await this.saveState();
+				await this.sendText(from, `Pairing code: ${code}\nApprove: hyperclaw pairing approve zalo ${code}\n(expires in 1 hour)`);
+				return false;
+			}
+		}
+		return false;
+	}
+	pruneExpiredCodes() {
+		const now = Date.now();
+		const ts = this.cfg.pendingPairingTs;
+		for (const code of Object.keys(ts)) if (now - ts[code] > PAIRING_TTL_MS) {
+			delete this.cfg.pendingPairings[code];
+			delete ts[code];
+		}
+	}
+	checkGroupPolicy(groupId, userId) {
+		const policy = this.cfg.groupPolicy ?? "allowlist";
+		if (policy === "disabled") return false;
+		if (policy === "open") {
+			const list$1 = this.cfg.groupAllowFrom ?? this.cfg.allowFrom ?? [];
+			return list$1.length === 0 || list$1.includes(userId);
+		}
+		const list = this.cfg.groupAllowFrom?.length ? this.cfg.groupAllowFrom : this.cfg.allowFrom ?? [];
+		return list.includes(groupId) || list.includes(userId);
+	}
+	async sendMessage(chatId, text) {
+		const chunks = [];
+		for (let i = 0; i < text.length; i += TEXT_CHUNK) chunks.push(text.slice(i, i + TEXT_CHUNK));
+		for (const chunk of chunks) await this.sendText(chatId, chunk);
+	}
+	async sendText(to, text) {
+		await zaloApi(this.token, "POST", "/message/sendtext", {
+			to,
+			text
+		}).catch((e) => console.error(`[zalo:${this.accountId}] sendText: ${e.message}`));
+	}
+	async sendPhoto(to, imageUrl, caption) {
+		await zaloApi(this.token, "POST", "/message/sendimage", {
+			to,
+			image_url: imageUrl,
+			...caption ? { caption } : {}
+		}).catch((e) => console.error(`[zalo:${this.accountId}] sendPhoto: ${e.message}`));
+	}
+	approvePairing(code) {
+		const upper = code.toUpperCase();
+		if (!this.cfg.pendingPairings[upper]) return false;
+		this.cfg.approvedPairings.push(this.cfg.pendingPairings[upper]);
+		delete this.cfg.pendingPairings[upper];
+		delete this.cfg.pendingPairingTs[upper];
+		this.saveState();
+		return true;
+	}
+	stateFile() {
+		return path.default.join(STATE_BASE, `zalo-bot-state-${this.accountId}.json`);
+	}
+	async loadState() {
+		try {
+			const s = await fs_extra.default.readJson(this.stateFile());
+			this.offset = s.offset || 0;
+			if (s.p) this.cfg.pendingPairings = s.p;
+			if (s.a) this.cfg.approvedPairings = s.a;
+			if (s.pts) this.cfg.pendingPairingTs = s.pts;
+		} catch {}
+	}
+	async saveState() {
+		await fs_extra.default.ensureDir(STATE_BASE);
+		await fs_extra.default.writeJson(this.stateFile(), {
+			offset: this.offset,
+			p: this.cfg.pendingPairings,
+			a: this.cfg.approvedPairings,
+			pts: this.cfg.pendingPairingTs
+		}, { spaces: 2 });
+	}
+	isRunning() {
+		return this.running;
+	}
+};
+var ZaloConnector = class extends events.EventEmitter {
+	config;
+	accounts = [];
+	constructor(config) {
+		super();
+		this.config = config;
+	}
+	async connect() {
+		const sharedState = {
+			approvedPairings: this.config.approvedPairings ?? [],
+			pendingPairings: this.config.pendingPairings ?? {},
+			pendingPairingTs: this.config.pendingPairingTs ?? {}
+		};
+		const accountEntries = Object.entries(this.config.accounts || {});
+		if (accountEntries.length === 0) {
+			const acct = new ZaloAccount("default", {
+				...this.config,
+				...sharedState
+			});
+			this.wire(acct);
+			await acct.connect();
+			this.accounts.push(acct);
+		} else for (const [id, acctCfg] of accountEntries) {
+			if (acctCfg.enabled === false) continue;
+			const merged = {
+				...this.config,
+				...acctCfg,
+				mediaMaxMb: this.config.mediaMaxMb,
+				...sharedState
+			};
+			if (!merged.botToken && !merged.tokenFile) {
+				console.error(`[zalo] Account "${id}" has no botToken or tokenFile — skipping`);
+				continue;
+			}
+			const acct = new ZaloAccount(id, merged);
+			this.wire(acct);
+			try {
+				await acct.connect();
+				this.accounts.push(acct);
+			} catch (e) {
+				console.error(`[zalo] Account "${id}" failed: ${e.message}`);
+			}
+		}
+	}
+	wire(acct) {
+		acct.on("message", (msg) => this.emit("message", msg));
+		acct.on("connected", (info) => this.emit("connected", info));
+		acct.on("pairing:approved", (info) => this.emit("pairing:approved", info));
+	}
+	async sendMessage(chatId, text) {
+		const acct = this.accounts[0];
+		if (!acct) throw new Error("Zalo: no connected account");
+		await acct.sendMessage(chatId, text);
+	}
+	/** Called by gateway webhook handler for webhook mode accounts. */
+	async handleWebhook(rawBody, secretHeader) {
+		for (const acct of this.accounts) if (acct.verifyWebhookSecret(secretHeader)) {
+			await acct.handleWebhook(rawBody, secretHeader);
+			return;
+		}
+	}
+	approvePairing(code) {
+		return this.accounts.some((a) => a.approvePairing(code));
+	}
+	disconnect() {
+		for (const a of this.accounts) a.disconnect();
+		this.accounts = [];
+	}
+	isRunning() {
+		return this.accounts.some((a) => a.isRunning());
+	}
+};
+
+//#endregion
+exports.ZaloConnector = ZaloConnector;

package/dist/connector-B8R3iBY1.js

@@ -0,0 +1,280 @@
+const require_chunk = require('./chunk-jS-bbMI5.js');
+const chalk = require_chunk.__toESM(require("chalk"));
+const fs_extra = require_chunk.__toESM(require("fs-extra"));
+const path = require_chunk.__toESM(require("path"));
+const os = require_chunk.__toESM(require("os"));
+const https = require_chunk.__toESM(require("https"));
+const events = require_chunk.__toESM(require("events"));
+
+//#region extensions/telegram/src/connector.ts
+function tgDownloadFile(token, filePath) {
+	return new Promise((resolve, reject) => {
+		const req = https.default.request({
+			hostname: "api.telegram.org",
+			port: 443,
+			path: `/file/bot${token}/${filePath}`,
+			method: "GET"
+		}, (res) => {
+			const chunks = [];
+			res.on("data", (c) => chunks.push(c));
+			res.on("end", () => resolve(Buffer.concat(chunks)));
+		});
+		req.on("error", reject);
+		req.setTimeout(3e4, () => {
+			req.destroy();
+			reject(new Error("Download timeout"));
+		});
+		req.end();
+	});
+}
+function tgRequest(token, method, body) {
+	return new Promise((resolve, reject) => {
+		const payload = body ? JSON.stringify(body) : null;
+		const req = https.default.request({
+			hostname: "api.telegram.org",
+			port: 443,
+			path: `/bot${token}/${method}`,
+			method: payload ? "POST" : "GET",
+			headers: payload ? {
+				"Content-Type": "application/json",
+				"Content-Length": Buffer.byteLength(payload)
+			} : {}
+		}, (res) => {
+			let data = "";
+			res.on("data", (c) => data += c);
+			res.on("end", () => {
+				try {
+					const r = JSON.parse(data);
+					if (r.ok) resolve(r.result);
+					else reject(new Error(r.description || "Telegram API error"));
+				} catch {
+					reject(new Error("Invalid JSON"));
+				}
+			});
+		});
+		req.on("error", reject);
+		req.setTimeout(35e3, () => {
+			req.destroy();
+			reject(new Error("Timeout"));
+		});
+		if (payload) req.write(payload);
+		req.end();
+	});
+}
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "telegram-state.json");
+function sleep(ms) {
+	return new Promise((r) => setTimeout(r, ms));
+}
+function generateCode() {
+	const chars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
+	return Array.from({ length: 6 }, () => chars[Math.floor(Math.random() * chars.length)]).join("");
+}
+function chunkText(text, max) {
+	if (text.length <= max) return [text];
+	const chunks = [];
+	let i = 0;
+	while (i < text.length) {
+		let end = Math.min(i + max, text.length);
+		if (end < text.length) {
+			const nl = text.lastIndexOf("\n", end);
+			if (nl > i) end = nl + 1;
+		}
+		chunks.push(text.slice(i, end));
+		i = end;
+	}
+	return chunks;
+}
+var TelegramConnector = class extends events.EventEmitter {
+	token;
+	config;
+	offset = 0;
+	running = false;
+	botInfo = null;
+	constructor(token, config) {
+		super();
+		this.token = token;
+		this.config = {
+			token,
+			dmPolicy: "allowlist",
+			allowFrom: [],
+			pendingPairings: {},
+			approvedPairings: [],
+			...config
+		};
+	}
+	async connect() {
+		this.botInfo = await tgRequest(this.token, "getMe");
+		console.log(chalk.default.green(`  🦅 Telegram: @${this.botInfo?.username} connected`));
+		await this.loadState();
+		this.running = true;
+		this.pollLoop();
+		this.emit("connected", this.botInfo);
+	}
+	async disconnect() {
+		this.running = false;
+		await this.saveState();
+	}
+	async pollLoop() {
+		while (this.running) try {
+			const updates = await tgRequest(this.token, "getUpdates", {
+				offset: this.offset,
+				timeout: 30,
+				allowed_updates: ["message"]
+			});
+			for (const u of updates) {
+				this.offset = u.update_id + 1;
+				await this.handleUpdate(u).catch((e) => console.log(chalk.default.yellow(`  ⚠  ${e.message}`)));
+			}
+		} catch (e) {
+			if (this.running) {
+				console.log(chalk.default.yellow(`  ⚠  Telegram poll: ${e.message}`));
+				await sleep(5e3);
+			}
+		}
+	}
+	async handleUpdate(u) {
+		const msg = u.message || u.edited_message;
+		if (!msg) return;
+		const text = msg.text?.trim() || "";
+		if (!text && !msg.voice) return;
+		const userId = String(msg.from?.id || "");
+		const isDM = msg.chat.type === "private";
+		const isGroup = msg.chat.type === "group" || msg.chat.type === "supergroup";
+		if (isDM && !await this.checkDMPolicy(userId, msg.chat.id, text || "[voice note]")) return;
+		let finalText = text || "[voice note]";
+		if (isGroup) {
+			const groupAllowFrom = this.config.groupAllowFrom ?? [];
+			if (groupAllowFrom.length > 0 && !groupAllowFrom.includes(String(msg.chat.id))) return;
+			const activation = this.config.groupActivation ?? "mention";
+			if (activation === "mention") {
+				const botUsername = this.botInfo?.username ? `@${this.botInfo.username}`.toLowerCase() : "";
+				const mentioned = botUsername && text.toLowerCase().includes(botUsername);
+				const isReplyToBot = msg.reply_to_message?.from?.is_bot && msg.reply_to_message.from.id === this.botInfo?.id;
+				if (!mentioned && !isReplyToBot) return;
+				if (mentioned && botUsername) finalText = text.replace(new RegExp(botUsername, "gi"), "").trim() || finalText;
+			}
+		}
+		let audioPath;
+		if (msg?.voice?.file_id) try {
+			const file = await tgRequest(this.token, "getFile", { file_id: msg.voice.file_id });
+			const buf = await tgDownloadFile(this.token, file.file_path);
+			const ext = (file.file_path || "").split(".").pop() || "oga";
+			const tmp = path.default.join(os.default.tmpdir(), `hyperclaw-tg-voice-${msg.message_id}.${ext}`);
+			await fs_extra.default.writeFile(tmp, buf);
+			audioPath = tmp;
+		} catch (e) {
+			console.log(chalk.default.yellow(`  ⚠  Telegram voice download failed: ${e.message}`));
+		}
+		this.emit("message", {
+			id: String(msg.message_id),
+			channelId: "telegram",
+			from: userId,
+			fromUsername: msg.from?.username,
+			chatId: msg.chat.id,
+			text: finalText,
+			audioPath,
+			timestamp: new Date(msg.date * 1e3).toISOString(),
+			isDM
+		});
+	}
+	async checkDMPolicy(userId, chatId, text) {
+		if (this.config.dmPolicy === "none") return false;
+		if (this.config.dmPolicy === "open") return true;
+		if (this.config.dmPolicy === "allowlist") {
+			if (this.config.allowFrom.includes(userId)) return true;
+			await this.sendMessage(chatId, `🦅 *HyperClaw*\n\nYou are not on the allowlist.`);
+			return false;
+		}
+		if (this.config.dmPolicy === "pairing") {
+			if (this.config.approvedPairings.includes(userId)) return true;
+			const upper = text.trim().toUpperCase();
+			if (this.config.pendingPairings[upper]) {
+				this.config.approvedPairings.push(userId);
+				delete this.config.pendingPairings[upper];
+				await this.saveState();
+				await this.sendMessage(chatId, `🦅 *Paired!* You can now send messages.`);
+				this.emit("pairing:approved", {
+					userId,
+					channelId: "telegram"
+				});
+				return true;
+			}
+			const code = generateCode();
+			this.config.pendingPairings[code] = userId;
+			await this.saveState();
+			await this.sendMessage(chatId, `🦅 *HyperClaw Pairing*\n\nSend the owner this code:\n\`${code}\`\n\nApprove with:\n\`hyperclaw pairing approve telegram ${code}\``);
+			console.log(chalk.default.cyan(`  🦅 Telegram pairing from ${userId} — code: ${code}`));
+			return false;
+		}
+		return false;
+	}
+	async sendMessage(chatId, text, opts = {}) {
+		const chunks = chunkText(text, 4096);
+		let last = null;
+		for (const chunk of chunks) last = await tgRequest(this.token, "sendMessage", {
+			chat_id: chatId,
+			text: chunk,
+			parse_mode: opts.parse_mode || "Markdown",
+			disable_web_page_preview: opts.disable_web_page_preview ?? true,
+			...opts.reply_to_message_id ? { reply_to_message_id: opts.reply_to_message_id } : {}
+		});
+		return last;
+	}
+	async sendTyping(chatId) {
+		await tgRequest(this.token, "sendChatAction", {
+			chat_id: chatId,
+			action: "typing"
+		}).catch(() => {});
+	}
+	approvePairing(code) {
+		const upper = code.toUpperCase();
+		if (!this.config.pendingPairings[upper]) return false;
+		const userId = this.config.pendingPairings[upper];
+		this.config.approvedPairings.push(userId);
+		delete this.config.pendingPairings[upper];
+		this.saveState();
+		return true;
+	}
+	addToAllowlist(userId) {
+		if (!this.config.allowFrom.includes(userId)) {
+			this.config.allowFrom.push(userId);
+			this.saveState();
+		}
+	}
+	listPendingPairings() {
+		return Object.entries(this.config.pendingPairings).map(([code, userId]) => ({
+			code,
+			userId
+		}));
+	}
+	handleWebhookPayload(body) {
+		try {
+			this.handleUpdate(JSON.parse(body));
+		} catch {}
+	}
+	async loadState() {
+		try {
+			const s = await fs_extra.default.readJson(STATE_FILE);
+			this.offset = s.offset || 0;
+			if (s.pendingPairings) this.config.pendingPairings = s.pendingPairings;
+			if (s.approvedPairings) this.config.approvedPairings = s.approvedPairings;
+		} catch {}
+	}
+	async saveState() {
+		await fs_extra.default.ensureDir(path.default.dirname(STATE_FILE));
+		await fs_extra.default.writeJson(STATE_FILE, {
+			offset: this.offset,
+			pendingPairings: this.config.pendingPairings,
+			approvedPairings: this.config.approvedPairings
+		}, { spaces: 2 });
+	}
+	isRunning() {
+		return this.running;
+	}
+	getBotInfo() {
+		return this.botInfo;
+	}
+};
+
+//#endregion
+exports.TelegramConnector = TelegramConnector;