signal-sdk 0.0.8 → 0.0.9

package/dist/SignalBot.d.ts

@@ -0,0 +1,108 @@
+import { EventEmitter } from 'events';
+import { SignalCli } from './SignalCli';
+import { BotConfig, BotCommand, BotStats } from './interfaces';
+export declare class SignalBot extends EventEmitter {
+    private signalCli;
+    private config;
+    private commands;
+    private isRunning;
+    private botGroupId;
+    private stats;
+    private userCooldowns;
+    private actionQueue;
+    private isProcessingQueue;
+    private incomingMessageBuffer;
+    constructor(config: BotConfig, signalCliPath?: string);
+    /**
+     * Downloads an image from URL to a temporary file
+     * @param imageUrl URL of the image to download
+     * @returns Path to the temporary file
+     */
+    private downloadImage;
+    /**
+     * Downloads an image from URL for commands (like NASA images)
+     * @param imageUrl URL of the image to download
+     * @param prefix Optional prefix for the temp file name
+     * @returns Path to the temporary file
+     */
+    downloadImageFromUrl(imageUrl: string, prefix?: string): Promise<string>;
+    /**
+     * Sends a message with downloaded image attachment
+     * @param recipient Recipient to send to
+     * @param message Text message to send
+     * @param imageUrl URL of the image to download and send
+     * @param prefix Optional prefix for the temp file name
+     */
+    sendMessageWithImage(recipient: string, message: string, imageUrl: string, prefix?: string): Promise<void>;
+    /**
+     * Cleans up a temporary file
+     * @param filePath Path to the file to delete
+     */
+    private cleanupTempFile;
+    /**
+     * Processes group avatar configuration
+     * @param avatar Avatar configuration (URL, file path, or base64)
+     * @returns Path to the avatar file or null if no avatar
+     */
+    private processGroupAvatar;
+    /**
+     * Adds a custom command to the bot
+     */
+    addCommand(command: BotCommand): void;
+    /**
+     * Removes a command from the bot
+     */
+    removeCommand(name: string): boolean;
+    /**
+     * Gets all available commands
+     */
+    getCommands(): BotCommand[];
+    /**
+     * Starts the bot
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the bot
+     */
+    stop(): Promise<void>;
+    gracefulShutdown(): Promise<void>;
+    /**
+     * Sends a message
+     */
+    sendMessage(recipient: string, message: string): Promise<void>;
+    /**
+     * Sends a reaction to a message
+     */
+    sendReaction(recipient: string, targetAuthor: string, targetTimestamp: number, emoji: string): Promise<void>;
+    /**
+     * Sends a message with file attachments
+     */
+    sendMessageWithAttachment(recipient: string, message: string, attachments: string[], cleanup?: string[]): Promise<void>;
+    /**
+     * Gets bot statistics
+     */
+    getStats(): BotStats;
+    /**
+     * Checks if a user is an admin
+     */
+    isAdmin(phoneNumber: string): boolean;
+    /**
+     * Gets the bot group ID
+     */
+    getBotGroupId(): string | null;
+    /**
+     * Gets the underlying SignalCli instance for advanced operations
+     */
+    getSignalCli(): SignalCli;
+    private setupDefaultCommands;
+    private setupBotGroup;
+    private setupEventHandlers;
+    private handleMessage;
+    private handleCommand;
+    private sendCommandResponse;
+    private isOnCooldown;
+    private processActionQueue;
+    private sendWelcomeMessage;
+    private formatUptime;
+    private log;
+}