@ihazz/bitrix24 1.1.2 → 1.1.3

package/README.md

@@ -153,6 +153,7 @@ If `eventMode` is omitted, the plugin uses:
 | `agentWatch` | — | Watch rules for user-visible events captured through `agentMode`. Keys follow the same matching pattern as chats: direct dialog like `"77"`, group dialog like `"chat520"`, numeric chat id like `"520"`, or wildcard `"*"`. Only `mode: "notifyOwnerDm"` is supported. |
 | `pollingIntervalMs` | `3000` | Base poll interval for `fetch` mode. |
 | `pollingFastIntervalMs` | `100` | Fast follow-up poll interval when more events are pending. |
+| `verboseLog` | `false` | Enables detailed `info` and `debug` logs for development. Warnings and errors stay enabled either way, and sensitive URL query strings are masked before logging. |
 
 Group override matching order:
 
@@ -369,6 +370,10 @@ If `mode` is omitted, `reply` is used.
 
 The RAM cache keeps up to `historyLimit` entries per conversation and uses an LRU cap of `1000` conversation keys per process.
 
+Outbound media uploads intentionally accept only files from the plugin-managed media directory:
+`$OPENCLAW_STATE_DIR/media/bitrix24` or `~/.openclaw/media/bitrix24`.
+Arbitrary local server paths are rejected on purpose for safety.
+
 ## Not Supported
 
 - Persistent SQLite or search-based history layer

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { bitrix24Plugin } from './src/channel.js';
+import { type PluginRuntime } from './src/runtime.js';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+interface OpenClawPluginApi {
+    config: Record<string, unknown>;
+    runtime: PluginRuntime;
+    registerChannel: (opts: {
+        plugin: typeof bitrix24Plugin;
+    }) => void;
+    registerHttpRoute: (params: {
+        path: string;
+        auth?: 'plugin';
+        handler: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    }) => void;
+}
+export declare function collectBitrix24CallbackPaths(config: Record<string, unknown>): string[];
+/**
+ * OpenClaw Bitrix24 Channel Plugin
+ *
+ * Connects Bitrix24 Messenger as a communication channel for OpenClaw agents.
+ * Users can chat with the AI assistant through Bitrix24's built-in messenger.
+ */
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: OpenClawPluginApi): void;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAwB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,cAAc,CAAA;KAAE,KAAK,IAAI,CAAC;IACnE,iBAAiB,EAAE,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACvE,KAAK,IAAI,CAAC;CACZ;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAkCtF;AAED;;;;;GAKG;;;;;kBAMa,iBAAiB;;AALjC,wBAoBE"}

package/dist/index.js

@@ -0,0 +1,55 @@
+import { bitrix24Plugin, handleWebhookRequest } from './src/channel.js';
+import { setBitrix24Runtime } from './src/runtime.js';
+export function collectBitrix24CallbackPaths(config) {
+    const channels = config?.channels;
+    const bitrix24 = channels?.bitrix24;
+    const callbackUrls = [];
+    if (typeof bitrix24?.callbackUrl === 'string') {
+        callbackUrls.push(bitrix24.callbackUrl);
+    }
+    for (const account of Object.values(bitrix24?.accounts ?? {})) {
+        if (typeof account?.callbackUrl === 'string') {
+            callbackUrls.push(account.callbackUrl);
+        }
+    }
+    const paths = [];
+    const seenPaths = new Set();
+    for (const callbackUrl of callbackUrls) {
+        try {
+            const path = new URL(callbackUrl).pathname;
+            if (!seenPaths.has(path)) {
+                seenPaths.add(path);
+                paths.push(path);
+            }
+        }
+        catch {
+            console.warn('[bitrix24] Invalid callbackUrl, skipping HTTP route');
+        }
+    }
+    return paths;
+}
+/**
+ * OpenClaw Bitrix24 Channel Plugin
+ *
+ * Connects Bitrix24 Messenger as a communication channel for OpenClaw agents.
+ * Users can chat with the AI assistant through Bitrix24's built-in messenger.
+ */
+export default {
+    id: 'bitrix24',
+    name: 'Bitrix24 Channel',
+    description: 'Bitrix24 Messenger channel for OpenClaw',
+    register(api) {
+        setBitrix24Runtime(api.runtime);
+        api.registerChannel({ plugin: bitrix24Plugin });
+        for (const callbackPath of collectBitrix24CallbackPaths(api.config)) {
+            api.registerHttpRoute({
+                path: callbackPath,
+                auth: 'plugin',
+                handler: async (req, res) => {
+                    await handleWebhookRequest(req, res);
+                },
+            });
+        }
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAsB,MAAM,kBAAkB,CAAC;AAc1E,MAAM,UAAU,4BAA4B,CAAC,MAA+B;IAC1E,MAAM,QAAQ,GAAG,MAAM,EAAE,QAA+D,CAAC;IACzF,MAAM,QAAQ,GAAG,QAAQ,EAAE,QAGd,CAAC;IAEd,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,OAAO,QAAQ,EAAE,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC9C,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,IAAI,OAAO,OAAO,EAAE,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC7C,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC;YAC3C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,eAAe;IACb,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,yCAAyC;IAEtD,QAAQ,CAAC,GAAsB;QAC7B,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEhC,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAEhD,KAAK,MAAM,YAAY,IAAI,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,iBAAiB,CAAC;gBACpB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAE,EAAE;oBAC3D,MAAM,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACvC,CAAC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/src/access-control.d.ts

@@ -0,0 +1,43 @@
+import type { Bitrix24AccountConfig } from './types.js';
+import type { PluginRuntime, ChannelPairingAdapter } from './runtime.js';
+/**
+ * Normalize an allowFrom entry — strip platform prefixes.
+ * "bitrix24:42" → "42", "b24:42" → "42", "bx24:42" → "42", "42" → "42"
+ */
+export declare function normalizeAllowEntry(entry: string): string;
+export declare function normalizeAllowList(entries: string[] | undefined): string[];
+export declare function isIdentityAllowed(identity: string, allowFrom: string[] | undefined): boolean;
+/**
+ * Extract the owner user ID from a Bitrix24 inbound webhook URL.
+ * Format: https://{portal}/rest/{user_id}/{webhook_token}/
+ */
+export declare function getWebhookUserId(webhookUrl: string | undefined): string | null;
+/**
+ * Check whether a sender is allowed to communicate with the bot.
+ *
+ * Pairing requires runtime state, so the synchronous helper cannot approve access.
+ */
+export declare function checkAccess(senderId: string, config: Bitrix24AccountConfig, _options?: {
+    dialogId?: string;
+    isDirect?: boolean;
+}): boolean;
+export type AccessResult = 'allow' | 'deny' | 'pairing';
+/**
+ * Pairing-aware access check.
+ * Merges config allowFrom with file-based allowFrom store.
+ * For pairing mode, upserts a pairing request and sends the reply.
+ */
+export declare function checkAccessWithPairing(params: {
+    senderId: string;
+    dialogId?: string;
+    isDirect?: boolean;
+    config: Bitrix24AccountConfig;
+    runtime: PluginRuntime;
+    accountId: string;
+    pairingAdapter: ChannelPairingAdapter;
+    sendReply: (text: string) => Promise<void>;
+    logger?: {
+        debug: (...args: unknown[]) => void;
+    };
+}): Promise<AccessResult>;
+//# sourceMappingURL=access-control.d.ts.map

package/dist/src/access-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-control.d.ts","sourceRoot":"","sources":["../../src/access-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAoB,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGzE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAU1E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAE5F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAiB9E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD,OAAO,CAiBT;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAExD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,qBAAqB,CAAC;IACtC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CAClD,GAAG,OAAO,CAAC,YAAY,CAAC,CAuExB"}

package/dist/src/access-control.js

@@ -0,0 +1,128 @@
+import { stripChannelPrefix } from './utils.js';
+/**
+ * Normalize an allowFrom entry — strip platform prefixes.
+ * "bitrix24:42" → "42", "b24:42" → "42", "bx24:42" → "42", "42" → "42"
+ */
+export function normalizeAllowEntry(entry) {
+    return stripChannelPrefix(entry.trim());
+}
+export function normalizeAllowList(entries) {
+    if (!Array.isArray(entries)) {
+        return [];
+    }
+    return [...new Set(entries
+            .map((entry) => normalizeAllowEntry(String(entry)))
+            .filter(Boolean))];
+}
+export function isIdentityAllowed(identity, allowFrom) {
+    return normalizeAllowList(allowFrom).includes(identity);
+}
+/**
+ * Extract the owner user ID from a Bitrix24 inbound webhook URL.
+ * Format: https://{portal}/rest/{user_id}/{webhook_token}/
+ */
+export function getWebhookUserId(webhookUrl) {
+    if (!webhookUrl)
+        return null;
+    try {
+        const url = new URL(webhookUrl);
+        const pathParts = url.pathname.split('/').filter(Boolean);
+        const restIndex = pathParts.indexOf('rest');
+        if (restIndex < 0 || pathParts.length <= restIndex + 2) {
+            return null;
+        }
+        const userId = pathParts[restIndex + 1];
+        return userId ? normalizeAllowEntry(userId) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check whether a sender is allowed to communicate with the bot.
+ *
+ * Pairing requires runtime state, so the synchronous helper cannot approve access.
+ */
+export function checkAccess(senderId, config, _options) {
+    const dmPolicy = resolveDmPolicy(config.dmPolicy);
+    const identity = resolveAccessIdentity(senderId);
+    switch (dmPolicy) {
+        case 'webhookUser': {
+            const webhookUserId = getWebhookUserId(config.webhookUrl);
+            return webhookUserId === identity;
+        }
+        case 'open':
+            return true;
+        case 'allowlist':
+            return isIdentityAllowed(identity, config.allowFrom);
+        case 'pairing':
+        default:
+            return false;
+    }
+}
+/**
+ * Pairing-aware access check.
+ * Merges config allowFrom with file-based allowFrom store.
+ * For pairing mode, upserts a pairing request and sends the reply.
+ */
+export async function checkAccessWithPairing(params) {
+    const { senderId, dialogId, isDirect, config, runtime, accountId, pairingAdapter, sendReply, logger, } = params;
+    const identity = resolveAccessIdentity(senderId);
+    const dmPolicy = resolveDmPolicy(config.dmPolicy);
+    if (dmPolicy === 'open') {
+        return 'allow';
+    }
+    if (dmPolicy === 'allowlist') {
+        return isIdentityAllowed(identity, config.allowFrom) ? 'allow' : 'deny';
+    }
+    if (dmPolicy === 'webhookUser') {
+        const webhookUserId = getWebhookUserId(config.webhookUrl);
+        if (webhookUserId && webhookUserId === identity) {
+            return 'allow';
+        }
+        logger?.debug('Access denied (webhookUser)', { senderId, dialogId, webhookUserId, identity });
+        return 'deny';
+    }
+    const storeAllowFrom = await runtime.channel.pairing.readAllowFromStore('bitrix24', '', accountId);
+    const approved = [...new Set([
+            ...normalizeAllowList(config.allowFrom),
+            ...normalizeAllowList(storeAllowFrom),
+        ])];
+    if (approved.includes(identity))
+        return 'allow';
+    try {
+        const { code, created } = await runtime.channel.pairing.upsertPairingRequest({
+            channel: 'bitrix24',
+            id: identity,
+            accountId,
+            meta: {},
+            pairingAdapter,
+        });
+        if (created) {
+            const reply = runtime.channel.pairing.buildPairingReply({
+                code,
+                channel: 'bitrix24',
+                accountId,
+            });
+            const replyText = typeof reply === 'string'
+                ? reply
+                : (reply && typeof reply === 'object' && 'text' in reply && typeof reply.text === 'string')
+                    ? reply.text
+                    : String(reply);
+            await sendReply(replyText);
+        }
+        logger?.debug('Pairing request handled', { senderId, dialogId, identity, code, created });
+        return 'pairing';
+    }
+    catch (err) {
+        logger?.debug('Pairing request failed, falling back to deny', { senderId, dialogId, identity, error: err });
+        return 'deny';
+    }
+}
+function resolveAccessIdentity(senderId) {
+    return normalizeAllowEntry(String(senderId));
+}
+function resolveDmPolicy(policy) {
+    return policy ?? 'webhookUser';
+}
+//# sourceMappingURL=access-control.js.map

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

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

package/dist/src/api.d.ts

@@ -0,0 +1,161 @@
+import type { B24ApiResult, B24V2BotResult, B24V2BotListResult, B24V2GetMessageContextResult, B24V2GetMessageResult, B24V2ReadMessageResult, B24InputActionStatusCode, B24V2CommandResult, B24V2EventGetResult, B24V2FileUploadResult, B24Keyboard, Logger } from './types.js';
+/**
+ * V2 bot context passed to every API call.
+ * In webhook auth mode, botToken is required for all calls.
+ */
+export interface BotContext {
+    botId: number;
+    botToken: string;
+}
+export declare class Bitrix24Api {
+    private rateLimiter;
+    private logger;
+    constructor(opts?: {
+        maxPerSecond?: number;
+        logger?: Logger;
+    });
+    /**
+     * Call B24 REST API via webhook URL.
+     * Webhook URL format: https://domain.bitrix24.com/rest/{user_id}/{token}/
+     */
+    callWebhook<T = unknown>(webhookUrl: string, method: string, params?: Record<string, unknown>): Promise<B24ApiResult<T>>;
+    /**
+     * Register a new bot (imbot.v2.Bot.register).
+     * Idempotent: same code returns existing bot.
+     */
+    registerBot(webhookUrl: string, botToken: string, fields: {
+        code: string;
+        properties: {
+            name: string;
+            lastName?: string;
+            workPosition?: string;
+            color?: string;
+            gender?: string;
+            avatar?: string;
+        };
+        type?: string;
+        eventMode?: 'fetch' | 'webhook';
+        webhookUrl?: string;
+        isHidden?: boolean;
+        isReactionsEnabled?: boolean;
+        isSupportOpenline?: boolean;
+        backgroundId?: string | null;
+    }): Promise<B24V2BotResult>;
+    /**
+     * Update bot properties (imbot.v2.Bot.update).
+     */
+    updateBot(webhookUrl: string, bot: BotContext, fields: Record<string, unknown>): Promise<B24V2BotResult>;
+    /**
+     * List bots of the current application (imbot.v2.Bot.list).
+     */
+    listBots(webhookUrl: string, botToken: string): Promise<B24V2BotListResult>;
+    /**
+     * Unregister a bot (imbot.v2.Bot.unregister).
+     */
+    unregisterBot(webhookUrl: string, bot: BotContext): Promise<boolean>;
+    /**
+     * Send a message (imbot.v2.Chat.Message.send).
+     */
+    sendMessage(webhookUrl: string, bot: BotContext, dialogId: string, message: string | null, options?: {
+        keyboard?: B24Keyboard;
+        attach?: unknown;
+        system?: boolean;
+        urlPreview?: boolean;
+        forwardMessages?: number[];
+    }): Promise<number>;
+    /**
+     * Get a single message by id (imbot.v2.Chat.Message.get).
+     */
+    getMessage(webhookUrl: string, bot: BotContext, messageId: number): Promise<B24V2GetMessageResult>;
+    /**
+     * Get message window around a message id (imbot.v2.Chat.Message.getContext).
+     */
+    getMessageContext(webhookUrl: string, bot: BotContext, messageId: number, range?: number): Promise<B24V2GetMessageContextResult>;
+    /**
+     * Update a message (imbot.v2.Chat.Message.update).
+     */
+    updateMessage(webhookUrl: string, bot: BotContext, messageId: number, message: string, options?: {
+        keyboard?: B24Keyboard | 'N';
+        attach?: unknown;
+    }): Promise<boolean>;
+    /**
+     * Answer a native bot command (imbot.v2.Command.answer).
+     */
+    answerCommand(webhookUrl: string, bot: BotContext, commandId: number, messageId: number, dialogId: string, message: string, options?: {
+        keyboard?: B24Keyboard;
+        attach?: unknown;
+        system?: boolean;
+        urlPreview?: boolean;
+    }): Promise<boolean>;
+    /**
+     * Send typing indicator (imbot.v2.Chat.InputAction.notify).
+     */
+    notifyInputAction(webhookUrl: string, bot: BotContext, dialogId: string, options?: {
+        statusMessageCode?: B24InputActionStatusCode;
+        duration?: number;
+    }): Promise<boolean>;
+    /**
+     * Mark messages as read (imbot.v2.Chat.Message.read).
+     */
+    readMessage(webhookUrl: string, bot: BotContext, dialogId: string, messageId?: number): Promise<B24V2ReadMessageResult>;
+    /**
+     * Bot leaves a chat (imbot.v2.Chat.leave).
+     */
+    leaveChat(webhookUrl: string, bot: BotContext, dialogId: string): Promise<boolean>;
+    /**
+     * Add a reaction to a message (imbot.v2.Chat.Message.Reaction.add).
+     */
+    addReaction(webhookUrl: string, bot: BotContext, messageId: number, reaction: string): Promise<boolean>;
+    /**
+     * Remove a reaction from a message (imbot.v2.Chat.Message.Reaction.delete).
+     */
+    deleteReaction(webhookUrl: string, bot: BotContext, messageId: number, reaction: string): Promise<boolean>;
+    /**
+     * Register a slash command (imbot.v2.Command.register).
+     * Idempotent: same command for same bot returns existing.
+     */
+    registerCommand(webhookUrl: string, bot: BotContext, params: {
+        command: string;
+        title?: Record<string, string>;
+        params?: Record<string, string>;
+        common?: boolean;
+        hidden?: boolean;
+        extranetSupport?: boolean;
+    }): Promise<B24V2CommandResult>;
+    /**
+     * Unregister a slash command (imbot.v2.Command.unregister).
+     */
+    unregisterCommand(webhookUrl: string, bot: BotContext, commandId: number): Promise<boolean>;
+    /**
+     * Fetch events via polling (imbot.v2.Event.get).
+     */
+    fetchEvents(webhookUrl: string, bot: BotContext, params: {
+        offset?: number;
+        limit?: number;
+        withUserEvents?: boolean;
+    }): Promise<B24V2EventGetResult>;
+    /**
+     * Subscribe current user to event recording (im.v2.Event.subscribe).
+     */
+    subscribeUserEvents(webhookUrl: string): Promise<boolean>;
+    /**
+     * Unsubscribe current user from event recording (im.v2.Event.unsubscribe).
+     * Idempotent — safe to call even if not subscribed.
+     */
+    unsubscribeUserEvents(webhookUrl: string): Promise<boolean>;
+    /**
+     * Upload a file to a chat (imbot.v2.File.upload).
+     * Single call replaces the old 3-step process (folder.get → upload → commit).
+     */
+    uploadFile(webhookUrl: string, bot: BotContext, dialogId: string, fields: {
+        name: string;
+        content: string;
+        message?: string;
+    }): Promise<B24V2FileUploadResult>;
+    /**
+     * Get download URL for a file (imbot.v2.File.download).
+     */
+    getFileDownloadUrl(webhookUrl: string, bot: BotContext, dialogId: string, fileId: number): Promise<string>;
+    destroy(): void;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/src/api.d.ts.map

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