@treenity/mods 3.0.1

package/dist/brahman/service.js

@@ -0,0 +1,310 @@
+// Brahman bot service — Telegram runtime
+// Session + auth middleware, command routing, callback queries, start/stop lifecycle
+import { run as runBot } from '@grammyjs/runner';
+import { getComponent, register } from '@treenity/core';
+import { Autostart } from '@treenity/core/mods/autostart/service';
+import { Bot } from 'grammy';
+import { executeAction, executePage, findActionComp, formatTString, resolveWait } from './helpers';
+import { BotConfig, BrahmanSession, BrahmanUser, PageConfig } from './types';
+// ── Bot factory (overridable for tests) ──
+let _botFactory;
+export function setBotFactory(f) { _botFactory = f; }
+// ── Bot service registration ──
+register('brahman.bot', 'service', async (node, svcCtx) => {
+    const config = getComponent(node, BotConfig);
+    if (!config?.token)
+        throw new Error('brahman.bot: token not configured');
+    const bot = (_botFactory?.(config.token) ?? new Bot(config.token));
+    const botPath = node.$path;
+    const botLangs = (config.langs || 'ru,en').split(',').map(s => s.trim());
+    const defaultLang = botLangs[0] || 'ru';
+    // Ensure dirs exist
+    const dirs = ['pages', 'users', 'sessions'];
+    for (const d of dirs) {
+        const dirPath = `${botPath}/${d}`;
+        if (!(await svcCtx.store.get(dirPath))) {
+            await svcCtx.store.set({ $path: dirPath, $type: 'dir' });
+        }
+    }
+    // ── Global middleware: pending callbacks → maintenance → session → auth ──
+    bot.use(async (gCtx, next) => {
+        const userId = gCtx.from?.id;
+        if (!userId)
+            return;
+        // Maintenance check
+        if (config.maintenance) {
+            await gCtx.reply(config.maintenance);
+            return;
+        }
+        // Load/create session
+        const sessionPath = `${botPath}/sessions/${userId}`;
+        let sessionNode = await svcCtx.store.get(sessionPath);
+        if (!sessionNode) {
+            sessionNode = {
+                $path: sessionPath, $type: 'brahman.session',
+                tid: userId, data: {}, history: [], callbacks: {},
+            };
+            await svcCtx.store.set(sessionNode);
+        }
+        // Load/create user
+        const userPath = `${botPath}/users/${userId}`;
+        let userNode = await svcCtx.store.get(userPath);
+        if (!userNode) {
+            userNode = {
+                $path: userPath, $type: 'brahman.user',
+                tid: userId,
+                firstName: gCtx.from.first_name ?? '',
+                lastName: gCtx.from.last_name ?? '',
+                username: gCtx.from.username ?? '',
+                lang: gCtx.from.language_code ?? defaultLang,
+                isAdmin: false, blocked: false, banned: false, tags: [],
+            };
+            await svcCtx.store.set(userNode);
+        }
+        const userData = getComponent(userNode, BrahmanUser);
+        if (userData?.banned)
+            return;
+        // Mark as unblocked if previously blocked (user restarted bot)
+        if (userData?.blocked) {
+            userData.blocked = false;
+            await svcCtx.store.set(userNode);
+        }
+        const sessionComp = getComponent(sessionNode, BrahmanSession);
+        const sessionData = sessionComp?.data ?? {};
+        if (!sessionData.history)
+            sessionData.history = sessionComp?.history ?? [];
+        const bCtx = {
+            ctx: gCtx, store: svcCtx.store,
+            session: sessionData,
+            sessionNode,
+            user: userNode,
+            lang: userData?.lang || defaultLang,
+            botPath,
+            userTags: userData?.tags ?? [],
+            botLangs,
+        };
+        gCtx._brahman = bCtx;
+        // Resolve pending wait (session-persisted) — consumes message if matched
+        if (!(sessionData.wait && await resolveWait(bCtx, gCtx))) {
+            await next();
+        }
+        // Save session after handler
+        Object.assign(sessionNode, {
+            data: sessionData,
+            history: sessionData.history ?? [],
+            callbacks: sessionData.callbacks ?? {},
+        });
+        await svcCtx.store.set(sessionNode);
+    });
+    // ── Dynamic page lookup (pages can be added/changed at runtime) ──
+    async function getPages() {
+        const { items } = await svcCtx.store.getChildren(`${botPath}/pages`, { depth: 10 });
+        return items.filter(n => n.$type === 'brahman.page');
+    }
+    async function findPageByCommand(cmd) {
+        const pages = await getPages();
+        return pages.find(p => {
+            const pc = getComponent(p, PageConfig);
+            return pc?.command === `/${cmd}` || pc?.command === cmd;
+        });
+    }
+    async function findStartPage() {
+        return findPageByCommand('start');
+    }
+    // ── Callback queries: page:/path, btn:id, lang:xx ──
+    bot.on('callback_query:data', async (gCtx) => {
+        const bCtx = gCtx._brahman;
+        if (!bCtx)
+            return;
+        const data = gCtx.callbackQuery.data;
+        if (data.startsWith('page:')) {
+            const pagePath = data.slice(5);
+            const colonIdx = pagePath.indexOf(':');
+            if (colonIdx >= 0) {
+                bCtx.session.param = pagePath.slice(colonIdx + 1);
+                await executePage(pagePath.slice(0, colonIdx), bCtx);
+            }
+            else {
+                await executePage(pagePath, bCtx);
+            }
+        }
+        else if (data.startsWith('btn:')) {
+            const btnId = parseInt(data.slice(4), 10);
+            const lastMenuPath = bCtx.session._lastMenu;
+            if (lastMenuPath) {
+                const menuNode = await svcCtx.store.get(lastMenuPath);
+                const menuComp = menuNode ? findActionComp(menuNode) : null;
+                if (menuComp?.rows) {
+                    for (const row of menuComp.rows) {
+                        for (const btn of row.buttons) {
+                            if (btn.id === btnId && btn.action) {
+                                if (btn.action.type === 'brahman.action.page' && btn.action.target) {
+                                    await executePage(btn.action.target, bCtx);
+                                }
+                                else if (btn.action.target) {
+                                    const actionNode = await svcCtx.store.get(btn.action.target);
+                                    if (actionNode)
+                                        await executeAction(actionNode, bCtx);
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        else if (data.startsWith('lang:')) {
+            const newLang = data.slice(5);
+            if (bCtx.botLangs.includes(newLang)) {
+                const userData = getComponent(bCtx.user, BrahmanUser);
+                if (userData) {
+                    userData.lang = newLang;
+                    await svcCtx.store.set(bCtx.user);
+                    bCtx.lang = newLang;
+                }
+                bCtx.session.langSelected = newLang;
+                const startPage = await findStartPage();
+                if (startPage)
+                    await executePage(startPage.$path, bCtx);
+            }
+        }
+        await gCtx.answerCallbackQuery();
+    });
+    // ── Text message handler: button callback → command fallback ──
+    bot.on('message:text', async (gCtx) => {
+        const bCtx = gCtx._brahman;
+        if (!bCtx)
+            return;
+        const text = gCtx.message.text;
+        if (text.startsWith('/')) {
+            const cmd = text.slice(1).split(/\s/)[0];
+            const page = await findPageByCommand(cmd);
+            if (page) {
+                const paramMatch = text.match(/^\/\S+\s+(.*)/);
+                if (paramMatch)
+                    bCtx.session.param = paramMatch[1];
+                await executePage(page.$path, bCtx);
+                return;
+            }
+            const startPage = await findStartPage();
+            if (startPage)
+                await executePage(startPage.$path, bCtx);
+            return;
+        }
+        // Try button callback from last page in history
+        const history = (bCtx.session.history ?? []);
+        if (history.length > 0) {
+            const lastPagePath = history[history.length - 1];
+            const pageNode = await svcCtx.store.get(lastPagePath);
+            if (pageNode) {
+                const { items: children } = await svcCtx.store.getChildren(lastPagePath + '/_actions');
+                for (const child of children) {
+                    const actionComp = findActionComp(child);
+                    if (!actionComp)
+                        continue;
+                    if (actionComp.menuType === 'keyboard' && actionComp.rows) {
+                        for (const row of actionComp.rows) {
+                            for (const btn of row.buttons) {
+                                const btnText = formatTString(btn.title, bCtx.lang);
+                                if (btnText === text && btn.action) {
+                                    if (btn.action.type === 'brahman.action.page' && btn.action.target) {
+                                        await executePage(btn.action.target, bCtx);
+                                        return;
+                                    }
+                                    else if (btn.action.target) {
+                                        const actionNode = await svcCtx.store.get(btn.action.target);
+                                        if (actionNode)
+                                            await executeAction(actionNode, bCtx);
+                                        return;
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Fallback: check _lastMenu for backward compat
+        const lastMenuPath = bCtx.session._lastMenu;
+        if (lastMenuPath) {
+            const menuNode = await svcCtx.store.get(lastMenuPath);
+            const menuComp = menuNode ? findActionComp(menuNode) : null;
+            if (menuComp?.menuType === 'keyboard' && menuComp.rows) {
+                for (const row of menuComp.rows) {
+                    for (const btn of row.buttons) {
+                        const btnText = formatTString(btn.title, bCtx.lang);
+                        if (btnText === text && btn.action) {
+                            if (btn.action.type === 'brahman.action.page' && btn.action.target) {
+                                await executePage(btn.action.target, bCtx);
+                                return;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Default fallback: /start page
+        const startPage = await findStartPage();
+        if (startPage) {
+            await executePage(startPage.$path, bCtx);
+        }
+    });
+    bot.catch(err => console.error(`[brahman:${config.alias || botPath}]`, err.message ?? err));
+    // Init bot (getMe) and fill node with bot info
+    await bot.init();
+    const info = bot.botInfo;
+    if (info) {
+        const updates = {};
+        if (info.username && !config.alias)
+            updates.alias = `@${info.username}`;
+        if (info.first_name && !config.name)
+            updates.name = info.first_name;
+        if (Object.keys(updates).length > 0) {
+            const fresh = await svcCtx.store.get(botPath);
+            if (fresh)
+                await svcCtx.store.set({ ...fresh, ...updates });
+        }
+    }
+    let runner = null;
+    if (config.running !== false) {
+        runner = runBot(bot);
+    }
+    // React to start/stop actions toggling the running flag
+    const unsub = svcCtx.subscribe(botPath, async () => {
+        const fresh = await svcCtx.store.get(botPath);
+        if (!fresh)
+            return;
+        const cfg = getComponent(fresh, BotConfig);
+        const shouldRun = cfg?.running !== false;
+        if (shouldRun && !runner) {
+            runner = runBot(bot);
+        }
+        else if (!shouldRun && runner) {
+            runner.stop();
+            runner = null;
+        }
+    });
+    return {
+        stop: async () => {
+            unsub();
+            if (runner)
+                runner.stop();
+        },
+    };
+});
+// ── Start/stop actions — delegate to autostart service manager ──
+/** @description Start the Telegram bot polling loop via autostart service */
+register('brahman.bot', 'action:start', async (ctx) => {
+    await ctx.nc('/sys/autostart').get(Autostart).start({ path: ctx.node.$path });
+    // Set running flag — service subscription reacts and calls bot.start()
+    const fresh = await ctx.store.get(ctx.node.$path);
+    if (fresh)
+        await ctx.store.set({ ...fresh, running: true });
+});
+/** @description Stop the Telegram bot polling loop via autostart service */
+register('brahman.bot', 'action:stop', async (ctx) => {
+    await ctx.nc('/sys/autostart').get(Autostart).stop({ path: ctx.node.$path });
+    const fresh = await ctx.store.get(ctx.node.$path);
+    if (fresh)
+        await ctx.store.set({ ...fresh, running: false });
+});
+//# sourceMappingURL=service.js.map

package/dist/brahman/service.js.map

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

package/dist/brahman/types.d.ts

@@ -0,0 +1,335 @@
+import type { BrahmanCtx } from './helpers';
+export type TString = Record<string, string>;
+/** Pending wait state — persisted in session.data.wait */
+export type WaitState = {
+    type: 'text' | 'photo';
+    saveTo: string;
+    deleteMessages: boolean;
+    sentMsgId: number;
+    remaining: string[];
+};
+export type MenuType = 'none' | 'inline' | 'inline_new' | 'inline_close' | 'keyboard' | 'remove' | 'force_reply';
+export declare const MENU_TYPES: {
+    value: MenuType;
+    label: string;
+}[];
+export type ButtonAction = {
+    type: string;
+    target?: string;
+    [key: string]: unknown;
+};
+export type MenuButton = {
+    id: number;
+    title: TString;
+    url?: string;
+    tags?: string[];
+    action?: ButtonAction;
+};
+export type MenuRow = {
+    buttons: MenuButton[];
+};
+export declare const ACTION_TYPES: readonly [{
+    readonly type: "brahman.action.message";
+    readonly label: "Message";
+    readonly icon: "MessageSquare";
+}, {
+    readonly type: "brahman.action.question";
+    readonly label: "Question";
+    readonly icon: "HelpCircle";
+}, {
+    readonly type: "brahman.action.ifelse";
+    readonly label: "If / Else";
+    readonly icon: "GitBranch";
+}, {
+    readonly type: "brahman.action.page";
+    readonly label: "Go to page";
+    readonly icon: "FileText";
+}, {
+    readonly type: "brahman.action.back";
+    readonly label: "Back";
+    readonly icon: "ArrowLeft";
+}, {
+    readonly type: "brahman.action.tag";
+    readonly label: "Set tag";
+    readonly icon: "Tag";
+}, {
+    readonly type: "brahman.action.broadcast";
+    readonly label: "Broadcast";
+    readonly icon: "Send";
+}, {
+    readonly type: "brahman.action.getvalue";
+    readonly label: "Get value";
+    readonly icon: "Download";
+}, {
+    readonly type: "brahman.action.setvalue";
+    readonly label: "Set value";
+    readonly icon: "Upload";
+}, {
+    readonly type: "brahman.action.params";
+    readonly label: "Parse params";
+    readonly icon: "Settings2";
+}, {
+    readonly type: "brahman.action.file";
+    readonly label: "Send file";
+    readonly icon: "File";
+}, {
+    readonly type: "brahman.action.eval";
+    readonly label: "Eval JS";
+    readonly icon: "Code";
+}, {
+    readonly type: "brahman.action.remove";
+    readonly label: "Remove msg";
+    readonly icon: "Trash2";
+}, {
+    readonly type: "brahman.action.emittext";
+    readonly label: "Emit text";
+    readonly icon: "Repeat";
+}, {
+    readonly type: "brahman.action.forward";
+    readonly label: "Forward";
+    readonly icon: "Forward";
+}, {
+    readonly type: "brahman.action.resetsession";
+    readonly label: "Reset session";
+    readonly icon: "RotateCcw";
+}, {
+    readonly type: "brahman.action.resethistory";
+    readonly label: "Reset history";
+    readonly icon: "History";
+}, {
+    readonly type: "brahman.action.onerror";
+    readonly label: "On error";
+    readonly icon: "AlertTriangle";
+}, {
+    readonly type: "brahman.action.keywordselect";
+    readonly label: "Keyword select";
+    readonly icon: "Search";
+}, {
+    readonly type: "brahman.action.selectlang";
+    readonly label: "Select language";
+    readonly icon: "Globe";
+}, {
+    readonly type: "brahman.action.call";
+    readonly label: "Call action";
+    readonly icon: "Zap";
+}];
+/** Telegram bot instance — token, proxy, language, maintenance */
+export declare class BotConfig {
+    /** @title Token @description Telegram bot token */
+    token: string;
+    /** @title Proxy @description SOCKS proxy URL */
+    proxy: string;
+    /** @title Alias @description Bot username */
+    alias: string;
+    /** @title Name @description Display name */
+    name: string;
+    /** @title Langs @description Comma-separated: ru,en,de,uz */
+    langs: string;
+    /** @title Maintenance @description Non-empty = paused */
+    maintenance: string;
+    /** @title Running */
+    running: boolean;
+}
+/** Bot conversation page — command trigger and ordered action sequence */
+export declare class PageConfig {
+    /** @title Command @description Telegram command, e.g. /start */
+    command: string;
+    /** @description Ordered child action paths */
+    positions: string[];
+}
+/** Send message — text with optional menu and link previews */
+export declare class MessageAction {
+    /** @title Text @format tstring */
+    text: TString;
+    /** @title Disable link previews */
+    disableLinks: boolean;
+    /** @title Menu type */
+    menuType: MenuType;
+    /** @title Menu rows */
+    rows: MenuRow[];
+    /** @title Send to chat ID @description Leave empty for current chat */
+    chatId: string;
+    /** @title Reply to message ID @description Session field with message ID */
+    replyToMsgId: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Ask question — prompt for text/photo input, save answer */
+export declare class QuestionAction {
+    /** @title Prompt text @format tstring */
+    text: TString;
+    /** @title Input type */
+    inputType: 'text' | 'photo';
+    /** @title Save answer to */
+    saveTo: string;
+    /** @title Delete messages @description Delete question and answer after receiving */
+    deleteMessages: boolean;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Conditional branch — evaluate JS expression, run if/else action */
+export declare class IfElseAction {
+    /** @title Condition @format textarea @description JS expression evaluated at runtime */
+    condition: string;
+    /** @title Action if true @description Path to action node */
+    actionIf: string;
+    /** @title Action if false */
+    actionElse: string;
+    /** @title Stop after action */
+    stopAfterAction: boolean;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Navigate to page — redirect conversation flow */
+export declare class PageNavAction {
+    /** @title Target page @description Path to page node */
+    targetPage: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Go back — return to previous page in history */
+export declare class BackAction {
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Set user tag — assign key-value metadata to user */
+export declare class TagAction {
+    /** @title Tag name */
+    tag: string;
+    /** @title Value expression */
+    value: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Broadcast message — send action to users matching tag filter */
+export declare class BroadcastAction {
+    /** @title User tags filter @format tags */
+    userTags: string[];
+    /** @title Action to broadcast @description Path to action node */
+    action: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Read session value — extract data from user session */
+export declare class GetValueAction {
+    /** @title Source path @description Dot-path in session data */
+    path: string;
+    /** @title Save to */
+    saveTo: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Write session value — store data in user session */
+export declare class SetValueAction {
+    /** @title Value expression */
+    value: string;
+    /** @title Save to */
+    saveTo: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Parse parameters — split and name input parts */
+export declare class ParamsAction {
+    /** @title Base64 decode */
+    base64: boolean;
+    /** @title Split delimiter */
+    split: string;
+    /** @title Parameter names @format tags */
+    names: string[];
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Send file — deliver photo/document/video/audio to chat */
+export declare class FileAction {
+    /** @title File node path */
+    fileId: string;
+    /** @title Override type @description photo, document, video, audio, voice */
+    asType: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Execute JavaScript — run async code with context access */
+export declare class EvalAction {
+    /** @title JavaScript code @format textarea @description Async function body, receives ctx object */
+    value: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Remove message — delete bot message from chat */
+export declare class RemoveAction {
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Emit synthetic text — inject text for re-processing */
+export declare class EmitTextAction {
+    /** @title Text template @format textarea @description Template for text to re-process */
+    from: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Forward message — relay message to another chat */
+export declare class ForwardAction {
+    /** @title Message ID from @description Session field with msg id. Empty = current msg */
+    msgIdFrom: string;
+    /** @title Forward to @description Chat/user ID template */
+    toFrom: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Reset session — clear all user session data */
+export declare class ResetSessionAction {
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Reset history — clear page navigation stack */
+export declare class ResetHistoryAction {
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Error handler — catch specific errors and run fallback action */
+export declare class OnErrorAction {
+    /** @title Error text @description Substring to match in error message */
+    error: string;
+    /** @title Action path @description Path to action node to run */
+    action: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+export type KeywordEntry = {
+    keywords: string[];
+    message: string;
+};
+/** Keyword matcher — select response based on text keywords */
+export declare class KeywordSelectAction {
+    /** @title Source text @description Template for text to analyze */
+    textFrom: string;
+    /** @title Keyword entries @description Array of {keywords, message} pairs */
+    elements: KeywordEntry[];
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Call tree action — execute any Treenity action from bot flow */
+export declare class CallAction {
+    /** @title Node path @description Template with {session.vars} */
+    path: string;
+    /** @title Action name */
+    action: string;
+    /** @title Component type @description Optional $type for resolution */
+    type: string;
+    /** @title Component key @description Optional named component key */
+    key: string;
+    /** @title Input data @format textarea @description JSON template */
+    dataExpr: string;
+    /** @title Save result to @description Session key for result */
+    saveTo: string;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Language selector — let user choose interface language */
+export declare class SelectLanguageAction {
+    /** @title Text @format tstring */
+    text: TString;
+    run(bCtx: BrahmanCtx): Promise<void>;
+}
+/** Bot user profile — Telegram identity, language, tags, ban status */
+export declare class BrahmanUser {
+    tid: number;
+    firstName: string;
+    lastName: string;
+    username: string;
+    lang: string;
+    isAdmin: boolean;
+    blocked: boolean;
+    banned: boolean;
+    /** @title User tags */
+    tags: string[];
+}
+/** User conversation state — session data, history, pending callbacks */
+export declare class BrahmanSession {
+    tid: number;
+    data: Record<string, unknown>;
+    history: string[];
+    /** @title Pending callbacks @description messageType → action path */
+    callbacks: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/brahman/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../brahman/types.ts"],"names":[],"mappings":"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"}