hyperclaw 4.0.2 → 5.0.1

package/dist/connector-5N0-X_xs.js

@@ -0,0 +1,194 @@
+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/whatsapp/src/connector.ts
+const STATE_FILE = path.default.join(os.default.homedir(), ".hyperclaw", "whatsapp-state.json");
+const GRAPH_API = "graph.facebook.com";
+const API_VERSION = "v18.0";
+function graphReq(token, method, endpoint, body) {
+	return new Promise((resolve, reject) => {
+		const payload = body ? JSON.stringify(body) : null;
+		const req = https.default.request({
+			hostname: GRAPH_API,
+			port: 443,
+			path: `/${API_VERSION}${endpoint}`,
+			method,
+			headers: {
+				"Authorization": `Bearer ${token}`,
+				...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) reject(new Error(`${r.error.code}: ${r.error.message}`));
+					else resolve(r);
+				} catch {
+					reject(new Error("Invalid JSON"));
+				}
+			});
+		});
+		req.on("error", reject);
+		if (payload) req.write(payload);
+		req.end();
+	});
+}
+var WhatsAppConnector = class extends events.EventEmitter {
+	config;
+	running = false;
+	constructor(config) {
+		super();
+		this.config = {
+			dmPolicy: "allowlist",
+			allowFrom: [],
+			approvedPairings: [],
+			pendingPairings: {},
+			...config
+		};
+	}
+	async connect() {
+		const info = await graphReq(this.config.accessToken, "GET", `/${this.config.phoneNumberId}`);
+		await this.loadState();
+		this.running = true;
+		console.log(chalk.default.green(`  🦅 WhatsApp: ${info.display_phone_number || this.config.phoneNumberId} connected`));
+		this.emit("connected", {
+			phoneNumberId: this.config.phoneNumberId,
+			number: info.display_phone_number
+		});
+	}
+	disconnect() {
+		this.running = false;
+	}
+	verifyWebhook(mode, token, challenge) {
+		if (mode === "subscribe" && token === this.config.verifyToken) return challenge;
+		return null;
+	}
+	async handleWebhook(body) {
+		let payload;
+		try {
+			payload = JSON.parse(body);
+		} catch {
+			return;
+		}
+		const entry = payload.entry?.[0];
+		const changes = entry?.changes?.[0];
+		const value = changes?.value;
+		if (!value?.messages) return;
+		for (const msg of value.messages) {
+			if (msg.type !== "text") continue;
+			const from = msg.from;
+			const text = msg.text?.body;
+			if (!text) continue;
+			await this.markRead(msg.id).catch(() => {});
+			const allowed = await this.checkDMPolicy(from, text);
+			if (!allowed) continue;
+			this.emit("message", {
+				id: msg.id,
+				channelId: "whatsapp",
+				from,
+				chatId: from,
+				text,
+				timestamp: new Date(parseInt(msg.timestamp) * 1e3).toISOString(),
+				isDM: true,
+				name: value.contacts?.[0]?.profile?.name
+			});
+		}
+	}
+	async checkDMPolicy(from, 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(from)) return true;
+			await this.sendMessage(from, "🦅 HyperClaw: You are not on the allowlist.");
+			return false;
+		}
+		if (this.config.dmPolicy === "pairing") {
+			if (this.config.approvedPairings.includes(from)) return true;
+			const upper = text.trim().toUpperCase();
+			if (this.config.pendingPairings[upper]) {
+				this.config.approvedPairings.push(from);
+				delete this.config.pendingPairings[upper];
+				await this.saveState();
+				await this.sendMessage(from, "🦅 *Paired!* You can now send messages.");
+				this.emit("pairing:approved", {
+					userId: from,
+					channelId: "whatsapp"
+				});
+				return true;
+			}
+			const code = Array.from({ length: 6 }, () => "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"[Math.floor(Math.random() * 32)]).join("");
+			this.config.pendingPairings[code] = from;
+			await this.saveState();
+			await this.sendMessage(from, `🦅 HyperClaw Pairing\n\nCode: *${code}*\nAsk owner: hyperclaw pairing approve whatsapp ${code}`);
+			return false;
+		}
+		return false;
+	}
+	async sendMessage(to, text) {
+		await graphReq(this.config.accessToken, "POST", `/${this.config.phoneNumberId}/messages`, {
+			messaging_product: "whatsapp",
+			to,
+			type: "text",
+			text: {
+				body: text.slice(0, 4096),
+				preview_url: false
+			}
+		});
+	}
+	async markRead(messageId) {
+		await graphReq(this.config.accessToken, "POST", `/${this.config.phoneNumberId}/messages`, {
+			messaging_product: "whatsapp",
+			status: "read",
+			message_id: messageId
+		}).catch(() => {});
+	}
+	async sendTemplate(to, templateName, languageCode = "en_US") {
+		await graphReq(this.config.accessToken, "POST", `/${this.config.phoneNumberId}/messages`, {
+			messaging_product: "whatsapp",
+			to,
+			type: "template",
+			template: {
+				name: templateName,
+				language: { code: languageCode }
+			}
+		});
+	}
+	approvePairing(code) {
+		const upper = code.toUpperCase();
+		if (!this.config.pendingPairings[upper]) return false;
+		this.config.approvedPairings.push(this.config.pendingPairings[upper]);
+		delete this.config.pendingPairings[upper];
+		this.saveState();
+		return true;
+	}
+	async loadState() {
+		try {
+			const s = await fs_extra.default.readJson(STATE_FILE);
+			if (s.p) this.config.pendingPairings = s.p;
+			if (s.a) this.config.approvedPairings = s.a;
+		} catch {}
+	}
+	async saveState() {
+		await fs_extra.default.ensureDir(path.default.dirname(STATE_FILE));
+		await fs_extra.default.writeJson(STATE_FILE, {
+			p: this.config.pendingPairings,
+			a: this.config.approvedPairings
+		}, { spaces: 2 });
+	}
+	isRunning() {
+		return this.running;
+	}
+};
+
+//#endregion
+exports.WhatsAppConnector = WhatsAppConnector;

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;