signal-sdk 0.1.0 → 0.1.2

package/README.md

@@ -14,11 +14,10 @@
 
 [![npm version](https://badge.fury.io/js/signal-sdk.svg)](https://badge.fury.io/js/signal-sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![signal-cli](https://img.shields.io/badge/signal--cli-v0.13.22-blue.svg)](https://github.com/AsamK/signal-cli)
+[![signal-cli](https://img.shields.io/badge/signal--cli-v0.13.23-blue.svg)](https://github.com/AsamK/signal-cli)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.8+-blue.svg)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
-[![Tests](https://img.shields.io/badge/tests-225%20passing-brightgreen.svg)](./src/__tests__)
-[![Coverage](https://img.shields.io/badge/coverage-57.52%25-yellow.svg)](./src/__tests__)
+[![Tests](https://img.shields.io/badge/tests-310%20passing-brightgreen.svg)](./src/__tests__)
 [![Donate on Liberapay](https://img.shields.io/badge/Liberapay-Donate-yellow.svg)](https://liberapay.com/devbyben/donate)
 
   </div>
@@ -48,6 +47,14 @@
 
 ### Advanced Features
 
+- **Multi-Account Support** - Manage multiple Signal accounts simultaneously with `MultiAccountManager`
+- **Advanced Messaging** - Text styles (bold, italic), mentions, quotes, URL previews, message editing
+- **Enhanced Receive** - Modern `receive()` method with options (timeout, ignore filters)
+- **Username Management** - Set and delete Signal usernames
+- **Identity Verification** - Get and verify safety numbers, manage untrusted identities
+- **Advanced Groups** - Send invite links, manage banned members, reset group links
+- **Enhanced Parsing** - Extract givenName, familyName, mobileCoinAddress from profiles and contacts
+- **Daemon Modes** - Support for Unix socket, TCP, and HTTP daemon connections
 - **File Attachments** - Send and receive files, images, and media
 - **Group Operations** - Create and manage groups with detailed information
 - **Contact Management** - Manage contacts with export/import capabilities
@@ -55,11 +62,11 @@
 - **Typing Indicators** - Send and receive typing notifications
 - **Read Receipts** - Track message delivery and read status
 - **Profile Management** - Update profile information and avatars
-- **Payment Notifications** - Send payment notifications
+- **Payment Notifications** - Send MobileCoin payment notifications with receipts
 - **Sticker Packs** - Upload and manage custom sticker packs
 - **User Status** - Verify Signal registration status
 - **Rate Limiting** - Handle and recover from rate limits
-- **Phone Number Changes** - Change registered phone numbers
+- **Phone Number Changes** - Change registered phone numbers with verification
 - **Progress Tracking** - Monitor upload progress
 - **Polls** - Create, vote, and terminate polls
 - **Attachment Retrieval** - Retrieve attachments, avatars, and stickers
@@ -357,7 +364,7 @@ await bot.start();
 - **TypeScript**: 5.8+ with strict mode
 - **Test Coverage**: 225 passing tests across 9 suites
 - **Code Coverage**: 57.52% overall, critical modules at 96-100%
-- **signal-cli**: Compatible with v0.13.22
+- **signal-cli**: Compatible with v0.13.23
 
 ## Testing
 
@@ -371,14 +378,14 @@ The SDK has comprehensive test coverage to ensure reliability and quality.
 
 ### Coverage by Module
 
-| Module | Statements | Branches | Functions | Lines | Status |
-|--------|-----------|----------|-----------|-------|--------|
-| **validators.ts** | 100% | 100% | 100% | 100% | ✅ Perfect |
-| **config.ts** | 100% | 97.22% | 100% | 100% | ✅ Excellent |
-| **errors.ts** | 100% | 100% | 100% | 100% | ✅ Perfect |
-| **retry.ts** | 96.15% | 85.71% | 100% | 97.95% | ✅ Excellent |
-| **SignalCli.ts** | 68.68% | 55.46% | 65.9% | 72.7% | ✅ Good |
-| **SignalBot.ts** | 24.33% | 16.94% | 29.68% | 24.59% | ⚠️ In Progress |
+| Module            | Statements | Branches | Functions | Lines  | Status         |
+| ----------------- | ---------- | -------- | --------- | ------ | -------------- |
+| **validators.ts** | 100%       | 100%     | 100%      | 100%   | ✅ Perfect     |
+| **config.ts**     | 100%       | 97.22%   | 100%      | 100%   | ✅ Excellent   |
+| **errors.ts**     | 100%       | 100%     | 100%      | 100%   | ✅ Perfect     |
+| **retry.ts**      | 96.15%     | 85.71%   | 100%      | 97.95% | ✅ Excellent   |
+| **SignalCli.ts**  | 68.68%     | 55.46%   | 65.9%     | 72.7%  | ✅ Good        |
+| **SignalBot.ts**  | 24.33%     | 16.94%   | 29.68%    | 24.59% | ⚠️ In Progress |
 
 ### Running Tests
 
@@ -408,7 +415,7 @@ npm test -- --watch
 8. **SignalBot.test.ts** - Bot framework
 9. **SignalBot.additional.test.ts** - Extended bot features
 
-```
+````
 
 ## Development
 
@@ -428,7 +435,7 @@ npm run build && node examples/sdk/01-basic-usage.js
 
 # Run tests
 npm test
-```
+````
 
 ## Configuration
 
@@ -563,7 +570,7 @@ This project is licensed under the MIT License - see the [LICENSE](./LICENSE) fi
 
 ## API Methods
 
-Compatible with signal-cli v0.13.22 - **100% Feature Coverage**
+Compatible with signal-cli v0.13.23 - **100% Feature Coverage**
 
 | Category        | Method                     | Description                        | Status |
 | --------------- | -------------------------- | ---------------------------------- | ------ |
@@ -588,6 +595,8 @@ Compatible with signal-cli v0.13.22 - **100% Feature Coverage**
 |                 | `getUserStatus`            | Check registration status          | ✅     |
 | **Account**     | `updateAccount`            | Update account settings            | ✅     |
 |                 | `listAccountsDetailed`     | List accounts with detailed info   | ✅     |
+| **Devices**     | `listDevices`              | List linked devices                | ✅     |
+|                 | `updateDevice`             | Update device name (v0.13.23+)     | ✅     |
 | **Attachments** | `getAttachment`            | Retrieve attachment by ID          | ✅     |
 |                 | `getAvatar`                | Retrieve avatar by ID              | ✅     |
 |                 | `getSticker`               | Retrieve sticker by ID             | ✅     |

package/dist/MultiAccountManager.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Multi-Account Manager for Signal SDK
+ *
+ * Manages multiple Signal accounts simultaneously with event routing
+ * and isolated process management.
+ */
+import { SignalCli } from './SignalCli';
+import { EventEmitter } from 'events';
+import { SignalCliConfig } from './config';
+/**
+ * Configuration for a managed account
+ */
+export interface ManagedAccount {
+    /** Account phone number */
+    account: string;
+    /** SignalCli instance */
+    instance: SignalCli;
+    /** Whether the account is connected */
+    connected: boolean;
+    /** Last activity timestamp */
+    lastActivity: number;
+}
+/**
+ * Options for MultiAccountManager
+ */
+export interface MultiAccountOptions {
+    /** Path to signal-cli executable */
+    signalCliPath?: string;
+    /** Data directory for all accounts */
+    dataPath?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Auto-reconnect on failure */
+    autoReconnect?: boolean;
+}
+/**
+ * Multi-Account Manager
+ *
+ * Manages multiple Signal accounts with event routing and lifecycle management.
+ *
+ * @example
+ * ```typescript
+ * const manager = new MultiAccountManager({
+ *   dataPath: '/path/to/data',
+ *   autoReconnect: true
+ * });
+ *
+ * // Add accounts
+ * await manager.addAccount('+33123456789');
+ * await manager.addAccount('+33987654321');
+ *
+ * // Listen to events from all accounts
+ * manager.on('message', (account, message) => {
+ *   console.log(`Message from ${account}: ${message.text}`);
+ * });
+ *
+ * // Connect all accounts
+ * await manager.connectAll();
+ *
+ * // Send from specific account
+ * await manager.sendMessage('+33123456789', '+33111111111', 'Hello!');
+ * ```
+ */
+export declare class MultiAccountManager extends EventEmitter {
+    private accounts;
+    private options;
+    private logger;
+    constructor(options?: MultiAccountOptions);
+    /**
+     * Add an account to the manager
+     *
+     * @param account - Phone number of the account
+     * @param config - Optional SignalCli configuration
+     * @returns The SignalCli instance
+     */
+    addAccount(account: string, config?: Partial<SignalCliConfig>): Promise<SignalCli>;
+    /**
+     * Remove an account from the manager
+     *
+     * @param account - Phone number of the account
+     */
+    removeAccount(account: string): Promise<void>;
+    /**
+     * Get a specific account instance
+     *
+     * @param account - Phone number of the account
+     * @returns The SignalCli instance
+     */
+    getAccount(account: string): SignalCli | undefined;
+    /**
+     * Get all managed accounts
+     *
+     * @returns Array of account phone numbers
+     */
+    getAccounts(): string[];
+    /**
+     * Check if an account exists
+     *
+     * @param account - Phone number of the account
+     * @returns True if the account exists
+     */
+    hasAccount(account: string): boolean;
+    /**
+     * Connect a specific account
+     *
+     * @param account - Phone number of the account
+     */
+    connect(account: string): Promise<void>;
+    /**
+     * Disconnect a specific account
+     *
+     * @param account - Phone number of the account
+     */
+    disconnect(account: string): Promise<void>;
+    /**
+     * Connect all accounts
+     */
+    connectAll(): Promise<void>;
+    /**
+     * Disconnect all accounts
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Send a message from a specific account
+     *
+     * @param fromAccount - Account to send from
+     * @param recipient - Recipient phone number or group ID
+     * @param message - Message text
+     * @param options - Send options
+     */
+    sendMessage(fromAccount: string, recipient: string, message: string, options?: any): Promise<any>;
+    /**
+     * Get account status information
+     *
+     * @param account - Phone number of the account (optional)
+     * @returns Status information for all or specific account
+     */
+    getStatus(account?: string): any;
+    /**
+     * Setup event forwarding from an account instance
+     *
+     * @private
+     */
+    private setupEventForwarding;
+    /**
+     * Shutdown the manager and cleanup all accounts
+     */
+    shutdown(): Promise<void>;
+}

package/dist/MultiAccountManager.js

@@ -0,0 +1,320 @@
+"use strict";
+/**
+ * Multi-Account Manager for Signal SDK
+ *
+ * Manages multiple Signal accounts simultaneously with event routing
+ * and isolated process management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiAccountManager = void 0;
+const SignalCli_1 = require("./SignalCli");
+const events_1 = require("events");
+const config_1 = require("./config");
+/**
+ * Multi-Account Manager
+ *
+ * Manages multiple Signal accounts with event routing and lifecycle management.
+ *
+ * @example
+ * ```typescript
+ * const manager = new MultiAccountManager({
+ *   dataPath: '/path/to/data',
+ *   autoReconnect: true
+ * });
+ *
+ * // Add accounts
+ * await manager.addAccount('+33123456789');
+ * await manager.addAccount('+33987654321');
+ *
+ * // Listen to events from all accounts
+ * manager.on('message', (account, message) => {
+ *   console.log(`Message from ${account}: ${message.text}`);
+ * });
+ *
+ * // Connect all accounts
+ * await manager.connectAll();
+ *
+ * // Send from specific account
+ * await manager.sendMessage('+33123456789', '+33111111111', 'Hello!');
+ * ```
+ */
+class MultiAccountManager extends events_1.EventEmitter {
+    constructor(options = {}) {
+        super();
+        this.accounts = new Map();
+        this.options = options;
+        this.logger = new config_1.Logger({
+            level: options.verbose ? 'debug' : 'info',
+            enableFile: false
+        });
+        this.logger.info('MultiAccountManager initialized');
+    }
+    /**
+     * Add an account to the manager
+     *
+     * @param account - Phone number of the account
+     * @param config - Optional SignalCli configuration
+     * @returns The SignalCli instance
+     */
+    async addAccount(account, config = {}) {
+        if (this.accounts.has(account)) {
+            throw new Error(`Account ${account} already exists`);
+        }
+        this.logger.info(`Adding account: ${account}`);
+        // Create SignalCli instance with merged config
+        const signalConfig = {
+            signalCliPath: this.options.signalCliPath,
+            verbose: this.options.verbose,
+            ...config
+        };
+        const instance = new SignalCli_1.SignalCli(account, undefined, signalConfig);
+        // Forward events from this instance
+        this.setupEventForwarding(account, instance);
+        // Store the managed account
+        const managedAccount = {
+            account,
+            instance,
+            connected: false,
+            lastActivity: Date.now()
+        };
+        this.accounts.set(account, managedAccount);
+        this.emit('accountAdded', account);
+        this.logger.info(`Account ${account} added successfully`);
+        return instance;
+    }
+    /**
+     * Remove an account from the manager
+     *
+     * @param account - Phone number of the account
+     */
+    async removeAccount(account) {
+        const managedAccount = this.accounts.get(account);
+        if (!managedAccount) {
+            throw new Error(`Account ${account} not found`);
+        }
+        this.logger.info(`Removing account: ${account}`);
+        // Disconnect if connected
+        if (managedAccount.connected) {
+            await managedAccount.instance.disconnect();
+        }
+        // Remove all listeners
+        managedAccount.instance.removeAllListeners();
+        // Remove from map
+        this.accounts.delete(account);
+        this.emit('accountRemoved', account);
+        this.logger.info(`Account ${account} removed successfully`);
+    }
+    /**
+     * Get a specific account instance
+     *
+     * @param account - Phone number of the account
+     * @returns The SignalCli instance
+     */
+    getAccount(account) {
+        return this.accounts.get(account)?.instance;
+    }
+    /**
+     * Get all managed accounts
+     *
+     * @returns Array of account phone numbers
+     */
+    getAccounts() {
+        return Array.from(this.accounts.keys());
+    }
+    /**
+     * Check if an account exists
+     *
+     * @param account - Phone number of the account
+     * @returns True if the account exists
+     */
+    hasAccount(account) {
+        return this.accounts.has(account);
+    }
+    /**
+     * Connect a specific account
+     *
+     * @param account - Phone number of the account
+     */
+    async connect(account) {
+        const managedAccount = this.accounts.get(account);
+        if (!managedAccount) {
+            throw new Error(`Account ${account} not found`);
+        }
+        if (managedAccount.connected) {
+            this.logger.warn(`Account ${account} already connected`);
+            return;
+        }
+        this.logger.info(`Connecting account: ${account}`);
+        try {
+            await managedAccount.instance.connect();
+            managedAccount.connected = true;
+            managedAccount.lastActivity = Date.now();
+            this.emit('accountConnected', account);
+            this.logger.info(`Account ${account} connected successfully`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to connect account ${account}:`, error);
+            if (this.options.autoReconnect) {
+                this.logger.info(`Will retry connection for ${account}`);
+                setTimeout(() => this.connect(account), 5000);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Disconnect a specific account
+     *
+     * @param account - Phone number of the account
+     */
+    async disconnect(account) {
+        const managedAccount = this.accounts.get(account);
+        if (!managedAccount) {
+            throw new Error(`Account ${account} not found`);
+        }
+        if (!managedAccount.connected) {
+            this.logger.warn(`Account ${account} not connected`);
+            return;
+        }
+        this.logger.info(`Disconnecting account: ${account}`);
+        await managedAccount.instance.disconnect();
+        managedAccount.connected = false;
+        this.emit('accountDisconnected', account);
+        this.logger.info(`Account ${account} disconnected`);
+    }
+    /**
+     * Connect all accounts
+     */
+    async connectAll() {
+        this.logger.info('Connecting all accounts');
+        const promises = Array.from(this.accounts.keys()).map(account => this.connect(account).catch(error => {
+            this.logger.error(`Failed to connect ${account}:`, error);
+        }));
+        await Promise.all(promises);
+        this.logger.info('All accounts connected');
+    }
+    /**
+     * Disconnect all accounts
+     */
+    async disconnectAll() {
+        this.logger.info('Disconnecting all accounts');
+        const promises = Array.from(this.accounts.keys()).map(account => this.disconnect(account).catch(error => {
+            this.logger.error(`Failed to disconnect ${account}:`, error);
+        }));
+        await Promise.all(promises);
+        this.logger.info('All accounts disconnected');
+    }
+    /**
+     * Send a message from a specific account
+     *
+     * @param fromAccount - Account to send from
+     * @param recipient - Recipient phone number or group ID
+     * @param message - Message text
+     * @param options - Send options
+     */
+    async sendMessage(fromAccount, recipient, message, options = {}) {
+        const managedAccount = this.accounts.get(fromAccount);
+        if (!managedAccount) {
+            throw new Error(`Account ${fromAccount} not found`);
+        }
+        managedAccount.lastActivity = Date.now();
+        return managedAccount.instance.sendMessage(recipient, message, options);
+    }
+    /**
+     * Get account status information
+     *
+     * @param account - Phone number of the account (optional)
+     * @returns Status information for all or specific account
+     */
+    getStatus(account) {
+        if (account) {
+            const managedAccount = this.accounts.get(account);
+            if (!managedAccount) {
+                return null;
+            }
+            return {
+                account: managedAccount.account,
+                connected: managedAccount.connected,
+                lastActivity: managedAccount.lastActivity,
+                uptime: Date.now() - managedAccount.lastActivity
+            };
+        }
+        // Return status for all accounts
+        const status = {
+            totalAccounts: this.accounts.size,
+            connectedAccounts: 0,
+            accounts: []
+        };
+        for (const [account, managed] of this.accounts) {
+            if (managed.connected) {
+                status.connectedAccounts++;
+            }
+            status.accounts.push({
+                account,
+                connected: managed.connected,
+                lastActivity: managed.lastActivity,
+                uptime: Date.now() - managed.lastActivity
+            });
+        }
+        return status;
+    }
+    /**
+     * Setup event forwarding from an account instance
+     *
+     * @private
+     */
+    setupEventForwarding(account, instance) {
+        // Forward all events with account prefix
+        const events = [
+            'message',
+            'receipt',
+            'typing',
+            'reaction',
+            'error',
+            'connected',
+            'disconnected'
+        ];
+        events.forEach(event => {
+            instance.on(event, (...args) => {
+                // Emit with account information
+                this.emit(event, account, ...args);
+                // Also emit a generic event with account
+                this.emit('accountEvent', {
+                    account,
+                    event,
+                    data: args
+                });
+                // Update last activity
+                const managedAccount = this.accounts.get(account);
+                if (managedAccount) {
+                    managedAccount.lastActivity = Date.now();
+                }
+            });
+        });
+        // Handle disconnection
+        instance.on('disconnected', () => {
+            const managedAccount = this.accounts.get(account);
+            if (managedAccount) {
+                managedAccount.connected = false;
+            }
+            // Auto-reconnect if enabled
+            if (this.options.autoReconnect) {
+                this.logger.info(`Auto-reconnecting account ${account}`);
+                setTimeout(() => this.connect(account), 5000);
+            }
+        });
+    }
+    /**
+     * Shutdown the manager and cleanup all accounts
+     */
+    async shutdown() {
+        this.logger.info('Shutting down MultiAccountManager');
+        await this.disconnectAll();
+        // Remove all accounts
+        for (const account of this.accounts.keys()) {
+            await this.removeAccount(account);
+        }
+        this.removeAllListeners();
+        this.logger.info('MultiAccountManager shutdown complete');
+    }
+}
+exports.MultiAccountManager = MultiAccountManager;

package/dist/SignalBot.d.ts

@@ -12,6 +12,7 @@ export declare class SignalBot extends EventEmitter {
     private actionQueue;
     private isProcessingQueue;
     private incomingMessageBuffer;
+    private activeTimers;
     constructor(config: BotConfig, signalCliPath?: string);
     /**
      * Downloads an image from URL to a temporary file

package/dist/SignalBot.js

@@ -50,6 +50,7 @@ class SignalBot extends events_1.EventEmitter {
         this.actionQueue = [];
         this.isProcessingQueue = false;
         this.incomingMessageBuffer = [];
+        this.activeTimers = [];
         this.config = {
             phoneNumber: config.phoneNumber,
             admins: config.admins || [],
@@ -317,6 +318,9 @@ class SignalBot extends events_1.EventEmitter {
     async stop() {
         this.log('- Stopping Signal Bot...');
         this.isRunning = false;
+        // Clear all active timers
+        this.activeTimers.forEach(timer => clearTimeout(timer));
+        this.activeTimers = [];
         this.signalCli.disconnect();
         this.emit('stopped');
         this.log('- Bot stopped');
@@ -324,6 +328,9 @@ class SignalBot extends events_1.EventEmitter {
     async gracefulShutdown() {
         this.log('- Gracefully shutting down Signal Bot...');
         this.isRunning = false;
+        // Clear all active timers
+        this.activeTimers.forEach(timer => clearTimeout(timer));
+        this.activeTimers = [];
         try {
             await this.signalCli.gracefulShutdown();
             this.log('- Signal Bot shutdown completed gracefully');
@@ -725,11 +732,18 @@ class SignalBot extends events_1.EventEmitter {
                             // Wait a bit for signal-cli to finish processing the files before cleanup
                             // signal-cli responds immediately but continues processing files in background
                             if (action.cleanup && action.cleanup.length > 0) {
-                                setTimeout(() => {
+                                const cleanupTimer = setTimeout(() => {
                                     action.cleanup.forEach(filePath => {
                                         this.cleanupTempFile(filePath);
                                     });
+                                    // Remove timer from active list
+                                    const index = this.activeTimers.indexOf(cleanupTimer);
+                                    if (index > -1)
+                                        this.activeTimers.splice(index, 1);
                                 }, 2000); // Wait 2 seconds for signal-cli to upload files
+                                if (cleanupTimer.unref)
+                                    cleanupTimer.unref();
+                                this.activeTimers.push(cleanupTimer);
                             }
                             break;
                         case 'sendReaction':
@@ -738,7 +752,11 @@ class SignalBot extends events_1.EventEmitter {
                             break;
                     }
                     // Wait a bit between actions to be safe
-                    await new Promise(resolve => setTimeout(resolve, 250));
+                    await new Promise(resolve => {
+                        const timer = setTimeout(resolve, 250);
+                        if (timer.unref)
+                            timer.unref();
+                    });
                 }
                 catch (error) {
                     this.log(`ERROR: Failed to execute action ${action.type}: ${error?.message || error}`, 'ERROR');