signal-sdk 0.1.1 → 0.1.2

package/README.md

@@ -14,7 +14,7 @@
 
 [![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-310%20passing-brightgreen.svg)](./src/__tests__)
@@ -364,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
 
@@ -570,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 |
 | --------------- | -------------------------- | ---------------------------------- | ------ |
@@ -595,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/SignalCli.d.ts

@@ -1,4 +1,4 @@
-import { Message, Contact, GroupUpdateOptions, SendMessageOptions, ContactUpdateOptions, AccountConfiguration, Device, ReceiptType, StickerPack, IdentityKey, LinkingOptions, LinkingResult, MessageRequestResponseType, SendResponse, GroupInfo, RemoveContactOptions, UserStatusResult, PaymentNotificationData, StickerPackManifest, StickerPackUploadResult, RateLimitChallengeResult, ReceiveOptions, UploadProgress, PollCreateOptions, PollVoteOptions, PollTerminateOptions, GetAttachmentOptions, GetAvatarOptions, GetStickerOptions, UpdateAccountOptions, AccountUpdateResult, SendContactsOptions, ListGroupsOptions } from './interfaces';
+import { Message, Contact, GroupUpdateOptions, SendMessageOptions, ContactUpdateOptions, AccountConfiguration, Device, ReceiptType, StickerPack, IdentityKey, LinkingOptions, LinkingResult, MessageRequestResponseType, SendResponse, GroupInfo, RemoveContactOptions, UserStatusResult, PaymentNotificationData, StickerPackManifest, StickerPackUploadResult, RateLimitChallengeResult, ReceiveOptions, UploadProgress, PollCreateOptions, PollVoteOptions, PollTerminateOptions, GetAttachmentOptions, GetAvatarOptions, GetStickerOptions, UpdateAccountOptions, AccountUpdateResult, SendContactsOptions, ListGroupsOptions, UpdateDeviceOptions } from './interfaces';
 import { EventEmitter } from 'events';
 import { SignalCliConfig } from './config';
 export declare class SignalCli extends EventEmitter {
@@ -158,6 +158,26 @@ export declare class SignalCli extends EventEmitter {
     resetGroupLink(groupId: string): Promise<void>;
     listContacts(): Promise<Contact[]>;
     listDevices(): Promise<Device[]>;
+    /**
+     * Update a linked device name (signal-cli v0.13.23+).
+     * Allows changing the display name of a linked device.
+     *
+     * @param options - Device update options
+     * @returns Promise that resolves when device is updated
+     *
+     * @example
+     * ```typescript
+     * // List devices to get device IDs
+     * const devices = await signal.listDevices();
+     *
+     * // Update device name
+     * await signal.updateDevice({
+     *   deviceId: 2,
+     *   deviceName: 'My New Device Name'
+     * });
+     * ```
+     */
+    updateDevice(options: UpdateDeviceOptions): Promise<void>;
     listAccounts(): Promise<string[]>;
     /**
      * @deprecated Use `connect` and listen for `message` events instead.

package/dist/SignalCli.js

@@ -876,6 +876,35 @@ class SignalCli extends events_1.EventEmitter {
     async listDevices() {
         return this.sendJsonRpcRequest('listDevices', { account: this.account });
     }
+    /**
+     * Update a linked device name (signal-cli v0.13.23+).
+     * Allows changing the display name of a linked device.
+     *
+     * @param options - Device update options
+     * @returns Promise that resolves when device is updated
+     *
+     * @example
+     * ```typescript
+     * // List devices to get device IDs
+     * const devices = await signal.listDevices();
+     *
+     * // Update device name
+     * await signal.updateDevice({
+     *   deviceId: 2,
+     *   deviceName: 'My New Device Name'
+     * });
+     * ```
+     */
+    async updateDevice(options) {
+        this.logger.debug('Updating device', options);
+        (0, validators_1.validateDeviceId)(options.deviceId);
+        (0, validators_1.validateMessage)(options.deviceName, 200);
+        await this.sendJsonRpcRequest('updateDevice', {
+            deviceId: options.deviceId,
+            deviceName: options.deviceName,
+            account: this.account
+        });
+    }
     async listAccounts() {
         const result = await this.sendJsonRpcRequest('listAccounts');
         return result.accounts.map((acc) => acc.number);

package/dist/__tests__/SignalCli.methods.test.js

@@ -401,6 +401,90 @@ describe('SignalCli Methods Tests', () => {
             }));
         });
     });
+    describe('Update Account Methods', () => {
+        it('should update account with device name', async () => {
+            sendJsonRpcRequestSpy.mockResolvedValue({ username: 'user.123' });
+            const result = await signalCli.updateAccount({ deviceName: 'New Device' });
+            expect(result.success).toBe(true);
+            expect(sendJsonRpcRequestSpy).toHaveBeenCalledWith('updateAccount', expect.objectContaining({
+                deviceName: 'New Device'
+            }));
+        });
+        it('should update account with username', async () => {
+            sendJsonRpcRequestSpy.mockResolvedValue({ username: 'newuser.456', usernameLink: 'link' });
+            const result = await signalCli.updateAccount({ username: 'newuser.456' });
+            expect(result.success).toBe(true);
+            expect(result.username).toBe('newuser.456');
+        });
+        it('should delete username', async () => {
+            sendJsonRpcRequestSpy.mockResolvedValue({});
+            await signalCli.updateAccount({ deleteUsername: true });
+            expect(sendJsonRpcRequestSpy).toHaveBeenCalledWith('updateAccount', expect.objectContaining({
+                deleteUsername: true
+            }));
+        });
+        it('should update privacy settings', async () => {
+            sendJsonRpcRequestSpy.mockResolvedValue({});
+            await signalCli.updateAccount({
+                unrestrictedUnidentifiedSender: true,
+                discoverableByNumber: false,
+                numberSharing: false
+            });
+            expect(sendJsonRpcRequestSpy).toHaveBeenCalledWith('updateAccount', expect.objectContaining({
+                unrestrictedUnidentifiedSender: true,
+                discoverableByNumber: false,
+                numberSharing: false
+            }));
+        });
+        it('should handle update account error', async () => {
+            sendJsonRpcRequestSpy.mockRejectedValue(new Error('Update failed'));
+            const result = await signalCli.updateAccount({ deviceName: 'Device' });
+            expect(result.success).toBe(false);
+        });
+    });
+    describe('Device Management Methods (v0.13.23+)', () => {
+        it('should list devices', async () => {
+            const mockDevices = [
+                { id: 1, name: 'Primary', lastSeen: Date.now() },
+                { id: 2, name: 'Tablet', lastSeen: Date.now() }
+            ];
+            sendJsonRpcRequestSpy.mockResolvedValue(mockDevices);
+            const result = await signalCli.listDevices();
+            expect(sendJsonRpcRequestSpy).toHaveBeenCalledWith('listDevices', {
+                account: '+1234567890'
+            });
+            expect(result).toEqual(mockDevices);
+        });
+        it('should update device name', async () => {
+            sendJsonRpcRequestSpy.mockResolvedValue(undefined);
+            await signalCli.updateDevice({
+                deviceId: 3,
+                deviceName: 'My Laptop'
+            });
+            expect(sendJsonRpcRequestSpy).toHaveBeenCalledWith('updateDevice', {
+                account: '+1234567890',
+                deviceId: 3,
+                deviceName: 'My Laptop'
+            });
+        });
+        it('should validate device ID', async () => {
+            await expect(signalCli.updateDevice({
+                deviceId: 0,
+                deviceName: 'Invalid'
+            })).rejects.toThrow();
+            await expect(signalCli.updateDevice({
+                deviceId: -5,
+                deviceName: 'Invalid'
+            })).rejects.toThrow();
+        });
+        it('should validate device name is not too long', async () => {
+            const longName = 'x'.repeat(300);
+            await expect(signalCli.updateDevice({
+                deviceId: 2,
+                deviceName: longName
+            })).rejects.toThrow();
+        });
+    });
     describe('Update Account Methods', () => {
         it('should update account with device name', async () => {
             sendJsonRpcRequestSpy.mockResolvedValue({ username: 'user.123' });

package/dist/__tests__/SignalCli.test.js

@@ -407,6 +407,51 @@ describe('SignalCli', () => {
             expect(result).toEqual(mockResponse.accounts);
         });
     });
+    // Test device management (v0.13.23+)
+    describe('Device Management', () => {
+        beforeEach(() => {
+            jest.spyOn(signalCli, 'sendJsonRpcRequest').mockResolvedValue({});
+        });
+        it('should list devices', async () => {
+            const mockDevices = [
+                { id: 1, name: 'Device 1' },
+                { id: 2, name: 'Device 2' }
+            ];
+            const sendJsonRpcRequestSpy = jest.spyOn(signalCli, 'sendJsonRpcRequest')
+                .mockResolvedValue(mockDevices);
+            const result = await signalCli.listDevices();
+            expect(sendJsonRpcRequestSpy).toHaveBeenCalledWith('listDevices', {
+                account: '+1234567890'
+            });
+            expect(result).toEqual(mockDevices);
+        });
+        it('should update device name', async () => {
+            const sendJsonRpcRequestSpy = jest.spyOn(signalCli, 'sendJsonRpcRequest')
+                .mockResolvedValue(undefined);
+            await signalCli.updateDevice({
+                deviceId: 2,
+                deviceName: 'My Updated Device'
+            });
+            expect(sendJsonRpcRequestSpy).toHaveBeenCalledWith('updateDevice', {
+                account: '+1234567890',
+                deviceId: 2,
+                deviceName: 'My Updated Device'
+            });
+        });
+        it('should validate device ID when updating', async () => {
+            await expect(signalCli.updateDevice({
+                deviceId: -1,
+                deviceName: 'Invalid'
+            })).rejects.toThrow();
+        });
+        it('should validate device name length', async () => {
+            const longName = 'a'.repeat(201);
+            await expect(signalCli.updateDevice({
+                deviceId: 2,
+                deviceName: longName
+            })).rejects.toThrow();
+        });
+    });
     // Test v0.1.0 features: Synchronization
     describe('Synchronization', () => {
         beforeEach(() => {

package/dist/interfaces.d.ts

@@ -1095,6 +1095,15 @@ export interface AccountUpdateResult {
     /** Error message if failed */
     error?: string;
 }
+/**
+ * Options for updating a linked device
+ */
+export interface UpdateDeviceOptions {
+    /** Device ID to update */
+    deviceId: number;
+    /** New device name */
+    deviceName: string;
+}
 /**
  * Options for receiving messages
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "signal-sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A comprehensive TypeScript SDK for Signal Messenger with native JSON-RPC support, providing high-performance messaging, bot framework, and full signal-cli integration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/scripts/install.js

@@ -3,7 +3,7 @@ const fs = require('fs');
 const path = require('path');
 const tar = require('tar');
 
-const VERSION = '0.13.22';
+const VERSION = '0.13.23';
 const BASE_URL = `https://github.com/AsamK/signal-cli/releases/download/v${VERSION}`;
 
 const platform = process.platform;