@xopcai/xopcbot 0.1.0

package/dist/channels/access-control.js

@@ -0,0 +1,201 @@
+/**
+ * Channel Access Control Utilities
+ *
+ * Implements hierarchical access control for groups and topics
+ * Inspired by openclaw's group-access.ts and bot-access.ts
+ */
+// ============================================
+// AllowFrom Normalization
+// ============================================
+/**
+ * Normalize allowFrom list to structured format
+ */
+export function normalizeAllowFrom(list) {
+    const entries = (list ?? []).map((value) => String(value).trim()).filter(Boolean);
+    const hasWildcard = entries.includes('*');
+    const normalized = entries
+        .filter((value) => value !== '*')
+        .map((value) => value.replace(/^(telegram|tg):/i, ''));
+    const ids = normalized.filter((value) => /^\d+$/.test(value));
+    return {
+        entries: ids,
+        hasWildcard,
+        hasEntries: ids.length > 0,
+    };
+}
+/**
+ * Normalize allowFrom combining config and store
+ */
+export function normalizeAllowFromWithStore(params) {
+    const combined = [
+        ...(params.allowFrom ?? []),
+        ...(params.storeAllowFrom ?? []),
+    ]
+        .map((value) => String(value).trim())
+        .filter(Boolean);
+    return normalizeAllowFrom(combined);
+}
+/**
+ * Check if sender is allowed based on normalized allowFrom
+ */
+export function isSenderAllowed(params) {
+    const { allow, senderId } = params;
+    // No entries = allow all
+    if (!allow.hasEntries) {
+        return true;
+    }
+    // Wildcard = allow all
+    if (allow.hasWildcard) {
+        return true;
+    }
+    // Check if sender ID is in allowlist
+    if (senderId && allow.entries.includes(senderId)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Resolve sender allowlist match
+ */
+export function resolveSenderAllowMatch(params) {
+    const { allow, senderId } = params;
+    if (allow.hasWildcard) {
+        return { allowed: true, matchKey: '*', matchSource: 'wildcard' };
+    }
+    if (!allow.hasEntries) {
+        return { allowed: false };
+    }
+    if (senderId && allow.entries.includes(senderId)) {
+        return { allowed: true, matchKey: senderId, matchSource: 'id' };
+    }
+    return { allowed: false };
+}
+// ============================================
+// Group Access Control
+// ============================================
+/**
+ * Evaluate base group access (group/topic enabled, allowFrom override)
+ */
+export function evaluateGroupBaseAccess(params) {
+    // Not a group = always allowed
+    if (!params.isGroup) {
+        return { allowed: true };
+    }
+    // Check if group is disabled
+    if (params.groupConfig?.enabled === false) {
+        return { allowed: false, reason: 'group-disabled' };
+    }
+    // Check if topic is disabled
+    if (params.topicConfig?.enabled === false) {
+        return { allowed: false, reason: 'topic-disabled' };
+    }
+    // Check allowFrom override if present
+    if (params.hasGroupAllowOverride) {
+        const senderId = params.senderId ?? '';
+        if (!senderId) {
+            return { allowed: false, reason: 'unauthorized' };
+        }
+        const allowed = isSenderAllowed({
+            allow: params.effectiveGroupAllow,
+            senderId,
+            senderUsername: params.senderUsername,
+        });
+        if (!allowed) {
+            return { allowed: false, reason: 'unauthorized' };
+        }
+    }
+    return { allowed: true };
+}
+/**
+ * Evaluate group policy access (open/disabled/allowlist)
+ */
+export function evaluateGroupPolicyAccess(params) {
+    const { isGroup, groupPolicy, effectiveGroupAllow, senderId, senderUsername } = params;
+    // Not a group or policy not enforced = always allowed
+    if (!isGroup) {
+        return { allowed: true, groupPolicy };
+    }
+    // Disabled policy = block all
+    if (groupPolicy === 'disabled') {
+        return { allowed: false, reason: 'policy-blocked', groupPolicy };
+    }
+    // Open policy = allow all (mention gating handled separately)
+    if (groupPolicy === 'open') {
+        return { allowed: true, groupPolicy };
+    }
+    // Allowlist policy = check allowFrom
+    if (groupPolicy === 'allowlist') {
+        if (!effectiveGroupAllow.hasEntries && !effectiveGroupAllow.hasWildcard) {
+            return { allowed: false, reason: 'policy-blocked', groupPolicy };
+        }
+        const allowed = isSenderAllowed({
+            allow: effectiveGroupAllow,
+            senderId,
+            senderUsername,
+        });
+        if (!allowed) {
+            return { allowed: false, reason: 'policy-blocked', groupPolicy };
+        }
+    }
+    return { allowed: true, groupPolicy };
+}
+/**
+ * Resolve group policy from config hierarchy
+ */
+export function resolveGroupPolicy(params) {
+    // Priority: topic > group > account > default
+    return (params.topicConfig?.groupPolicy ??
+        params.groupConfig?.groupPolicy ??
+        params.accountGroupPolicy ??
+        params.defaultGroupPolicy ??
+        'open');
+}
+/**
+ * Resolve requireMention from config hierarchy
+ */
+export function resolveRequireMention(params) {
+    return (params.topicConfig?.requireMention ??
+        params.groupConfig?.requireMention ??
+        params.defaultRequireMention ??
+        true);
+}
+// ============================================
+// Mention Detection
+// ============================================
+/**
+ * Build mention regexes for bot username
+ */
+export function buildMentionRegex(botUsername) {
+    const escaped = botUsername.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`@${escaped}`, 'i');
+}
+/**
+ * Check if message has bot mention (text or entity)
+ */
+export function hasBotMention(params) {
+    const { botUsername, text = '', entities = [] } = params;
+    const botUsernameLower = botUsername.toLowerCase();
+    const textLower = text.toLowerCase();
+    // Check text mention
+    if (textLower.includes(`@${botUsernameLower}`)) {
+        return true;
+    }
+    // Check entity mentions
+    for (const ent of entities) {
+        if (ent.type === 'mention') {
+            const mentionText = text.slice(ent.offset, ent.offset + ent.length);
+            if (mentionText.toLowerCase() === `@${botUsernameLower}`) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Remove bot mention from text
+ */
+export function removeBotMention(text, botUsername) {
+    const botUsernameLower = botUsername.toLowerCase();
+    return text.replace(new RegExp(`@${botUsernameLower}\\s*`, 'gi'), '').trim();
+}
+//# sourceMappingURL=access-control.js.map

package/dist/channels/access-control.js.map

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

package/dist/channels/draft-stream.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Telegram Draft Stream for Streaming Message Previews
+ *
+ * Implements real-time message streaming with edit-based updates
+ * Inspired by openclaw's draft-stream.ts
+ */
+import type { Bot } from 'grammy';
+export interface TelegramDraftStreamOptions {
+    api: Bot['api'];
+    chatId: number | string;
+    maxChars?: number;
+    threadId?: number;
+    replyToMessageId?: number;
+    throttleMs?: number;
+    parseMode?: 'Markdown' | 'HTML' | undefined;
+}
+export interface TelegramDraftStream {
+    update: (text: string) => void;
+    flush: () => Promise<void>;
+    messageId: () => number | undefined;
+    clear: () => Promise<void>;
+    stop: () => void;
+    forceNewMessage: () => void;
+}
+/**
+ * Create a draft stream for streaming message previews
+ */
+export declare function createTelegramDraftStream(options: TelegramDraftStreamOptions): TelegramDraftStream;
+/**
+ * Streaming state manager for tracking active streams per chat
+ */
+export declare class DraftStreamManager {
+    private streams;
+    /**
+     * Get or create a draft stream for a chat
+     */
+    getOrCreate(key: string, options: TelegramDraftStreamOptions): TelegramDraftStream;
+    /**
+     * Get existing stream for a chat
+     */
+    get(key: string): TelegramDraftStream | undefined;
+    /**
+     * Stop and cleanup stream for a chat
+     */
+    stop(key: string): Promise<void>;
+    /**
+     * Stop all active streams
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Clear stream preview without stopping
+     */
+    clear(key: string): Promise<void>;
+}
+export declare const draftStreamManager: DraftStreamManager;

package/dist/channels/draft-stream.js

@@ -0,0 +1,211 @@
+/**
+ * Telegram Draft Stream for Streaming Message Previews
+ *
+ * Implements real-time message streaming with edit-based updates
+ * Inspired by openclaw's draft-stream.ts
+ */
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('DraftStream');
+const TELEGRAM_STREAM_MAX_CHARS = 4096;
+const DEFAULT_THROTTLE_MS = 1000;
+/**
+ * Create a draft stream for streaming message previews
+ */
+export function createTelegramDraftStream(options) {
+    const maxChars = Math.min(options.maxChars ?? TELEGRAM_STREAM_MAX_CHARS, TELEGRAM_STREAM_MAX_CHARS);
+    const throttleMs = Math.max(250, options.throttleMs ?? DEFAULT_THROTTLE_MS);
+    const chatId = options.chatId;
+    const threadParams = {};
+    if (options.threadId) {
+        threadParams.message_thread_id = options.threadId;
+    }
+    if (options.replyToMessageId) {
+        threadParams.reply_to_message_id = options.replyToMessageId;
+    }
+    let streamMessageId;
+    let lastSentText = '';
+    let stopped = false;
+    let pendingText = '';
+    let pendingTimer = null;
+    const sendOrEditStreamMessage = async (text) => {
+        if (stopped) {
+            return;
+        }
+        const trimmed = text.trimEnd();
+        if (!trimmed) {
+            return;
+        }
+        if (trimmed.length > maxChars) {
+            // Stop streaming once we exceed the cap
+            stopped = true;
+            log.warn({ chatId, textLength: trimmed.length, maxChars }, 'Stream preview stopped (text length exceeded limit)');
+            return;
+        }
+        if (trimmed === lastSentText) {
+            return;
+        }
+        lastSentText = trimmed;
+        try {
+            if (typeof streamMessageId === 'number') {
+                // Edit existing message
+                await options.api.editMessageText(chatId, streamMessageId, trimmed, {
+                    parse_mode: options.parseMode,
+                });
+            }
+            else {
+                // Create new message
+                const sent = await options.api.sendMessage(chatId, trimmed, {
+                    parse_mode: options.parseMode,
+                    ...threadParams,
+                });
+                const sentMessageId = sent?.message_id;
+                if (typeof sentMessageId !== 'number' || !Number.isFinite(sentMessageId)) {
+                    stopped = true;
+                    log.warn({ chatId }, 'Stream preview stopped (missing message id)');
+                    return;
+                }
+                streamMessageId = Math.trunc(sentMessageId);
+            }
+        }
+        catch (err) {
+            stopped = true;
+            log.error({ chatId, err: err instanceof Error ? err.message : String(err) }, 'Stream preview failed');
+        }
+    };
+    const scheduleUpdate = () => {
+        if (pendingTimer) {
+            clearTimeout(pendingTimer);
+        }
+        pendingTimer = setTimeout(async () => {
+            pendingTimer = null;
+            if (pendingText) {
+                await sendOrEditStreamMessage(pendingText);
+                pendingText = '';
+            }
+        }, throttleMs);
+    };
+    const update = (text) => {
+        if (stopped) {
+            return;
+        }
+        pendingText = text;
+        scheduleUpdate();
+    };
+    const flush = async () => {
+        if (pendingTimer) {
+            clearTimeout(pendingTimer);
+            pendingTimer = null;
+        }
+        if (pendingText) {
+            await sendOrEditStreamMessage(pendingText);
+            pendingText = '';
+        }
+    };
+    const clear = async () => {
+        stop();
+        await flush();
+        const messageId = streamMessageId;
+        streamMessageId = undefined;
+        if (typeof messageId !== 'number') {
+            return;
+        }
+        try {
+            await options.api.deleteMessage(chatId, messageId);
+        }
+        catch (err) {
+            log.warn({ chatId, messageId, err: err instanceof Error ? err.message : String(err) }, 'Stream preview cleanup failed');
+        }
+    };
+    const stop = () => {
+        stopped = true;
+        if (pendingTimer) {
+            clearTimeout(pendingTimer);
+            pendingTimer = null;
+        }
+    };
+    const forceNewMessage = () => {
+        streamMessageId = undefined;
+        lastSentText = '';
+        pendingText = '';
+        if (pendingTimer) {
+            clearTimeout(pendingTimer);
+            pendingTimer = null;
+        }
+    };
+    log.debug({ chatId, maxChars, throttleMs }, 'Draft stream created');
+    return {
+        update,
+        flush,
+        messageId: () => streamMessageId,
+        clear,
+        stop,
+        forceNewMessage,
+    };
+}
+/**
+ * Streaming state manager for tracking active streams per chat
+ */
+export class DraftStreamManager {
+    streams = new Map();
+    /**
+     * Get or create a draft stream for a chat
+     */
+    getOrCreate(key, options) {
+        const existing = this.streams.get(key);
+        if (existing) {
+            return existing;
+        }
+        const stream = createTelegramDraftStream(options);
+        this.streams.set(key, stream);
+        // Auto-cleanup when stream stops
+        const originalStop = stream.stop;
+        stream.stop = () => {
+            originalStop.call(stream);
+            this.streams.delete(key);
+        };
+        return stream;
+    }
+    /**
+     * Get existing stream for a chat
+     */
+    get(key) {
+        return this.streams.get(key);
+    }
+    /**
+     * Stop and cleanup stream for a chat
+     */
+    async stop(key) {
+        const stream = this.streams.get(key);
+        if (stream) {
+            await stream.flush();
+            stream.stop();
+            this.streams.delete(key);
+        }
+    }
+    /**
+     * Stop all active streams
+     */
+    async stopAll() {
+        const promises = [];
+        for (const [key, stream] of this.streams.entries()) {
+            promises.push((async () => {
+                await stream.flush();
+                stream.stop();
+                this.streams.delete(key);
+            })());
+        }
+        await Promise.all(promises);
+    }
+    /**
+     * Clear stream preview without stopping
+     */
+    async clear(key) {
+        const stream = this.streams.get(key);
+        if (stream) {
+            await stream.clear();
+        }
+    }
+}
+// Export singleton instance
+export const draftStreamManager = new DraftStreamManager();
+//# sourceMappingURL=draft-stream.js.map

package/dist/channels/draft-stream.js.map

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

package/dist/channels/format.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Telegram Message Formatting Utilities
+ *
+ * Converts Markdown to Telegram HTML format with proper escaping
+ * and file reference protection
+ *
+ * Inspired by openclaw's format.ts
+ */
+/**
+ * Escape HTML special characters
+ */
+export declare function escapeHtml(text: string): string;
+/**
+ * Escape HTML attribute values
+ */
+export declare function escapeHtmlAttr(text: string): string;
+/**
+ * Simple Markdown to HTML converter for Telegram
+ */
+export declare function markdownToTelegramHtml(markdown: string): string;
+/**
+ * Wrap standalone file references in <code> tags
+ * Prevents Telegram from generating domain registrar previews
+ */
+export declare function wrapFileReferencesInHtml(html: string): string;
+/**
+ * Format message for Telegram with proper HTML and file reference protection
+ */
+export declare function formatTelegramMessage(markdown: string, options?: {
+    wrapFileRefs?: boolean;
+}): {
+    html: string;
+    text: string;
+};
+/**
+ * Split long message into chunks respecting code blocks and paragraphs
+ */
+export declare function splitTelegramMessage(text: string, maxChars?: number): string[];