signal-sdk 0.0.9 → 0.1.1

package/dist/validators.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Input validation utilities for Signal SDK
+ * Provides strict validation for all inputs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePhoneNumber = validatePhoneNumber;
+exports.validateGroupId = validateGroupId;
+exports.validateRecipient = validateRecipient;
+exports.validateMessage = validateMessage;
+exports.validateAttachments = validateAttachments;
+exports.validateTimestamp = validateTimestamp;
+exports.validateEmoji = validateEmoji;
+exports.validateDeviceId = validateDeviceId;
+exports.sanitizeInput = sanitizeInput;
+const errors_1 = require("./errors");
+/**
+ * Validates a phone number format (E.164)
+ * @param phoneNumber Phone number to validate
+ * @throws ValidationError if invalid
+ */
+function validatePhoneNumber(phoneNumber) {
+    if (!phoneNumber) {
+        throw new errors_1.ValidationError('Phone number is required', 'phoneNumber');
+    }
+    if (typeof phoneNumber !== 'string') {
+        throw new errors_1.ValidationError('Phone number must be a string', 'phoneNumber');
+    }
+    // E.164 format: + followed by 1-15 digits
+    const e164Regex = /^\+[1-9]\d{1,14}$/;
+    if (!e164Regex.test(phoneNumber)) {
+        throw new errors_1.ValidationError('Phone number must be in E.164 format (e.g., +33123456789)', 'phoneNumber');
+    }
+}
+/**
+ * Validates a group ID format
+ * @param groupId Group ID to validate
+ * @throws ValidationError if invalid
+ */
+function validateGroupId(groupId) {
+    if (!groupId) {
+        throw new errors_1.ValidationError('Group ID is required', 'groupId');
+    }
+    if (typeof groupId !== 'string') {
+        throw new errors_1.ValidationError('Group ID must be a string', 'groupId');
+    }
+}
+/**
+ * Validates a recipient (phone number, UUID, or username)
+ * @param recipient Recipient to validate
+ * @throws ValidationError if invalid
+ */
+function validateRecipient(recipient) {
+    if (!recipient) {
+        throw new errors_1.ValidationError('Recipient is required', 'recipient');
+    }
+    if (typeof recipient !== 'string') {
+        throw new errors_1.ValidationError('Recipient must be a string', 'recipient');
+    }
+    // Check if it's a username (starts with u:)
+    if (recipient.startsWith('u:')) {
+        if (recipient.length < 3) {
+            throw new errors_1.ValidationError('Username is too short', 'recipient');
+        }
+        return;
+    }
+    // Check if it's a UUID (PNI: prefix or plain UUID)
+    const uuidRegex = /^(PNI:)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidRegex.test(recipient)) {
+        return;
+    }
+    // Otherwise, validate as phone number
+    validatePhoneNumber(recipient);
+}
+/**
+ * Validates a message text
+ * @param message Message to validate
+ * @param maxLength Maximum message length
+ * @throws ValidationError if invalid
+ */
+function validateMessage(message, maxLength = 10000) {
+    if (message === undefined || message === null) {
+        throw new errors_1.ValidationError('Message is required', 'message');
+    }
+    if (typeof message !== 'string') {
+        throw new errors_1.ValidationError('Message must be a string', 'message');
+    }
+    if (message.length > maxLength) {
+        throw new errors_1.ValidationError(`Message exceeds maximum length of ${maxLength} characters`, 'message');
+    }
+}
+/**
+ * Validates file attachments
+ * @param attachments Array of attachment paths
+ * @throws ValidationError if invalid
+ */
+function validateAttachments(attachments) {
+    if (!Array.isArray(attachments)) {
+        throw new errors_1.ValidationError('Attachments must be an array', 'attachments');
+    }
+    for (const attachment of attachments) {
+        if (typeof attachment !== 'string') {
+            throw new errors_1.ValidationError('Each attachment must be a file path string', 'attachments');
+        }
+        if (attachment.length === 0) {
+            throw new errors_1.ValidationError('Attachment path cannot be empty', 'attachments');
+        }
+    }
+}
+/**
+ * Validates a timestamp
+ * @param timestamp Timestamp to validate
+ * @throws ValidationError if invalid
+ */
+function validateTimestamp(timestamp) {
+    if (typeof timestamp !== 'number') {
+        throw new errors_1.ValidationError('Timestamp must be a number', 'timestamp');
+    }
+    if (timestamp <= 0) {
+        throw new errors_1.ValidationError('Timestamp must be positive', 'timestamp');
+    }
+    if (!Number.isFinite(timestamp)) {
+        throw new errors_1.ValidationError('Timestamp must be finite', 'timestamp');
+    }
+}
+/**
+ * Validates an emoji string
+ * @param emoji Emoji to validate
+ * @throws ValidationError if invalid
+ */
+function validateEmoji(emoji) {
+    if (!emoji) {
+        throw new errors_1.ValidationError('Emoji is required', 'emoji');
+    }
+    if (typeof emoji !== 'string') {
+        throw new errors_1.ValidationError('Emoji must be a string', 'emoji');
+    }
+    // Basic emoji validation - should be a single grapheme cluster
+    if (emoji.length === 0 || emoji.length > 10) {
+        throw new errors_1.ValidationError('Invalid emoji format', 'emoji');
+    }
+}
+/**
+ * Validates device ID
+ * @param deviceId Device ID to validate
+ * @throws ValidationError if invalid
+ */
+function validateDeviceId(deviceId) {
+    if (typeof deviceId !== 'number') {
+        throw new errors_1.ValidationError('Device ID must be a number', 'deviceId');
+    }
+    if (!Number.isInteger(deviceId)) {
+        throw new errors_1.ValidationError('Device ID must be an integer', 'deviceId');
+    }
+    if (deviceId <= 0) {
+        throw new errors_1.ValidationError('Device ID must be positive', 'deviceId');
+    }
+}
+/**
+ * Sanitizes user input to prevent injection attacks
+ * @param input Input string to sanitize
+ * @returns Sanitized string
+ */
+function sanitizeInput(input) {
+    if (typeof input !== 'string') {
+        return '';
+    }
+    // Remove null bytes
+    return input.replace(/\0/g, '');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "signal-sdk",
-  "version": "0.0.9",
+  "version": "0.1.1",
   "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",