miaw-core 1.1.1 → 1.2.0

package/dist/utils/validation.js

@@ -0,0 +1,177 @@
+/**
+ * Validation utilities for common operations
+ * Provides consistent validation and error messages throughout miaw-core
+ */
+/**
+ * Validate phone number format
+ * @param phone - Phone number to validate (should be in international format without + or spaces)
+ * @returns Validation result with success status and error message if invalid
+ *
+ * @example
+ * ```typescript
+ * validatePhoneNumber("6281234567890");  // { valid: true }
+ * validatePhoneNumber("+62812345");      // { valid: false, error: "Phone number should not contain +" }
+ * validatePhoneNumber("");                // { valid: false, error: "Phone number cannot be empty" }
+ * ```
+ */
+export function validatePhoneNumber(phone) {
+    if (!phone || phone.trim().length === 0) {
+        return { valid: false, error: "Phone number cannot be empty" };
+    }
+    // Check for invalid characters
+    if (phone.includes("+")) {
+        return {
+            valid: false,
+            error: "Phone number should not contain '+' (use international format without prefix)",
+        };
+    }
+    if (phone.includes(" ") || phone.includes("-")) {
+        return {
+            valid: false,
+            error: "Phone number should not contain spaces or hyphens",
+        };
+    }
+    // Basic format check: should be digits only
+    if (!/^\d+$/.test(phone)) {
+        return {
+            valid: false,
+            error: "Phone number should contain only digits",
+        };
+    }
+    // Length check: typical international phone numbers are 10-15 digits
+    if (phone.length < 10 || phone.length > 15) {
+        return {
+            valid: false,
+            error: "Phone number should be between 10-15 digits",
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate JID (WhatsApp identifier) format
+ * @param jid - JID to validate (should be in format phone@s.whatsapp.net or groupId@g.us)
+ * @returns Validation result with success status and error message if invalid
+ *
+ * @example
+ * ```typescript
+ * validateJID("6281234567890@s.whatsapp.net");  // { valid: true }
+ * validateJID("123456789@g.us");                 // { valid: true }
+ * validateJID("invalid");                        // { valid: false, error: "Invalid JID format" }
+ * ```
+ */
+export function validateJID(jid) {
+    if (!jid || jid.trim().length === 0) {
+        return { valid: false, error: "JID cannot be empty" };
+    }
+    // Check for valid WhatsApp JID suffixes
+    const validSuffixes = ["@s.whatsapp.net", "@g.us", "@broadcast", "@lid"];
+    const hasValidSuffix = validSuffixes.some((suffix) => jid.endsWith(suffix));
+    if (!hasValidSuffix) {
+        return {
+            valid: false,
+            error: `JID must end with one of: ${validSuffixes.join(", ")}`,
+        };
+    }
+    // Check format: should have exactly one @ symbol
+    const parts = jid.split("@");
+    if (parts.length !== 2) {
+        return {
+            valid: false,
+            error: "Invalid JID format: should be identifier@domain",
+        };
+    }
+    // Check that identifier is not empty
+    if (parts[0].length === 0) {
+        return {
+            valid: false,
+            error: "JID identifier cannot be empty",
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate message text content
+ * @param text - Message text to validate
+ * @param options - Validation options
+ * @returns Validation result with success status and error message if invalid
+ *
+ * @example
+ * ```typescript
+ * validateMessageText("Hello");                           // { valid: true }
+ * validateMessageText("");                                // { valid: false, error: "Message text cannot be empty" }
+ * validateMessageText("a".repeat(65537));                 // { valid: false, error: "Message text exceeds maximum length" }
+ * validateMessageText("Hi", { minLength: 5 });           // { valid: false, error: "Message text must be at least 5 characters" }
+ * ```
+ */
+export function validateMessageText(text, options = {}) {
+    const { minLength = 1, maxLength = 65536 } = options;
+    if (!text || text.trim().length === 0) {
+        return { valid: false, error: "Message text cannot be empty" };
+    }
+    if (text.length < minLength) {
+        return {
+            valid: false,
+            error: `Message text must be at least ${minLength} character${minLength > 1 ? "s" : ""}`,
+        };
+    }
+    if (text.length > maxLength) {
+        return {
+            valid: false,
+            error: `Message text exceeds maximum length of ${maxLength} characters`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate group name
+ * @param name - Group name to validate
+ * @returns Validation result with success status and error message if invalid
+ *
+ * @example
+ * ```typescript
+ * validateGroupName("My Group");     // { valid: true }
+ * validateGroupName("");              // { valid: false, error: "Group name cannot be empty" }
+ * validateGroupName("a".repeat(101)); // { valid: false, error: "Group name exceeds maximum length" }
+ * ```
+ */
+export function validateGroupName(name) {
+    if (!name || name.trim().length === 0) {
+        return { valid: false, error: "Group name cannot be empty" };
+    }
+    // WhatsApp group name max length is typically 100 characters
+    if (name.length > 100) {
+        return {
+            valid: false,
+            error: "Group name exceeds maximum length of 100 characters",
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate array of phone numbers
+ * @param phones - Array of phone numbers to validate
+ * @returns Validation result with success status and error message if invalid
+ *
+ * @example
+ * ```typescript
+ * validatePhoneNumbers(["6281234567890", "6287654321098"]);  // { valid: true }
+ * validatePhoneNumbers([]);                                   // { valid: false, error: "Phone numbers array cannot be empty" }
+ * validatePhoneNumbers(["invalid"]);                          // { valid: false, error: "Invalid phone number at index 0: ..." }
+ * ```
+ */
+export function validatePhoneNumbers(phones) {
+    if (!phones || phones.length === 0) {
+        return { valid: false, error: "Phone numbers array cannot be empty" };
+    }
+    for (let i = 0; i < phones.length; i++) {
+        const validation = validatePhoneNumber(phones[i]);
+        if (!validation.valid) {
+            return {
+                valid: false,
+                error: `Invalid phone number at index ${i}: ${validation.error}`,
+            };
+        }
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/docs/BAILEYS_MIGRATION_v7.md

@@ -1,5 +1,9 @@
 # Baileys Migration Plan: v6.7.21 → v7.0.0-rc.9
 
+> **Status: Migration Complete** ✅ - All core migration tasks have been implemented.
+> **Date Completed:** 2025-01-10
+> **Current Version:** Baileys v7.0.0-rc.9
+
 ## Current Issue
 
 After scanning QR code and app exits, the session cannot reconnect on restart and requires re-pairing. This is a known issue in v6.7.21 related to session/authentication state handling.
@@ -17,7 +21,7 @@ Upgrade to **Baileys v7.0.0-rc.9** (latest release candidate, November 2025). Th
 
 ## Breaking Changes in v7.0.0
 
-### 1. ESM-Only (No More CommonJS)
+### 1. ESM-Only (No More CommonJS) ✅ COMPLETE
 
 **Impact:** High - Miaw Core uses CommonJS currently.
 
@@ -37,7 +41,12 @@ Upgrade to **Baileys v7.0.0-rc.9** (latest release candidate, November 2025). Th
 import { useMultiFileAuthState } from "@whiskeysockets/baileys";
 ```
 
-### 2. LID (Local Identifier) Support
+**Implementation Status:**
+
+- ✅ [`"type": "module"` in package.json:5](package.json#L5)
+- ✅ All imports use ESM syntax with `.js` extensions in [MiawClient.ts:68-70](src/client/MiawClient.ts#L68-L70)
+
+### 2. LID (Local Identifier) Support ✅ COMPLETE
 
 **Impact:** Medium - New auth state keys required.
 
@@ -54,29 +63,57 @@ WhatsApp now uses LIDs for user privacy. The auth state must support new keys:
 // but verify SignalDataTypeMap includes new keys
 ```
 
+**Implementation Status:**
+
+- ✅ Custom `LruCache` implementation in [MiawClient.ts:76-123](src/client/MiawClient.ts#L76-L123)
+- ✅ LID mapping from `senderLid` in [MiawClient.ts:368-377](src/client/MiawClient.ts#L368-L377)
+- ✅ `@lid` support in [formatPhoneToJid:173-192](src/handlers/MessageHandler.ts#L173-L192)
+- ✅ `useMultiFileAuthState` handles new auth keys in [AuthHandler.ts:23](src/handlers/AuthHandler.ts#L23)
+
 ### 3. API Changes
 
-| Old (v6.x)           | New (v7.x)                                            |
-| -------------------- | ----------------------------------------------------- |
-| `isJidUser(jid)`     | `isPnUser(jid)`                                       |
-| `Contact.jid/lid`    | `Contact.id` + `Contact.phoneNumber` or `Contact.lid` |
-| `proto.fromObject()` | `proto.create()`                                      |
+| Old (v6.x)           | New (v7.x)                                            | Status |
+| -------------------- | ----------------------------------------------------- | ------ |
+| `isJidUser(jid)`     | `isPnUser(jid)`                                       | ⚠️ NOT NEEDED - Codebase doesn't use this API |
+| `Contact.jid/lid`    | `Contact.id` + `Contact.phoneNumber` or `Contact.lid` | ✅ Handled via `participantPn`/`senderPn` in [MessageHandler.ts:20-21](src/handlers/MessageHandler.ts#L20-L21) |
+| `proto.fromObject()` | `proto.create()`                                      | ✅ NOT APPLICABLE - No proto usage in codebase |
 
 ### 4. New Events
 
 - `lid-mapping.update` - Emitted when LID/PN mapping is discovered
 
+**Implementation Status:**
+
+- ✅ Event listener added at [MiawClient.ts:288-308](src/client/MiawClient.ts#L288-L308)
+- ✅ Integrates with existing `LruCache` for seamless mapping storage
+- ✅ Debug logging for monitoring LID discovery
+
+**Note:** This event is marked as WIP in Baileys and may not always fire. The implementation uses multiple sources for LID mapping:
+
+- `lid-mapping.update` event (when available) - [MiawClient.ts:291](src/client/MiawClient.ts#L291)
+- `contacts.upsert`/`contacts.update` events - [MiawClient.ts:311-318](src/client/MiawClient.ts#L311-L318)
+- `chats.upsert`/`chats.update` events - [MiawClient.ts:322-329](src/client/MiawClient.ts#L322-L329)
+- `messages.upsert` (from `senderLid`) - [MiawClient.ts:388-397](src/client/MiawClient.ts#L388-L397)
+
+**Custom LID mapping methods:**
+
+- `updateLidToJidMapping()` - Updates LID mappings from contact data
+- `updateLidFromChats()` - Updates LID mappings from chat data
+- `resolveLidToJid()` - Public method to resolve LID to JID
+- `registerLidMapping()` - Manual LID registration
+- `getLidMappings()` - Export all mappings for persistence
+
 ---
 
 ## Migration Steps
 
-### Step 1: Backup Current Sessions
+### Step 1: Backup Current Sessions ✅ COMPLETE
 
 ```bash
 cp -r ./sessions ./sessions-backup-v6
 ```
 
-### Step 2: Update package.json
+### Step 2: Update package.json ✅ COMPLETE
 
 ```json
 {
@@ -87,7 +124,9 @@ cp -r ./sessions ./sessions-backup-v6
 }
 ```
 
-### Step 3: Update TypeScript Configuration
+**Status:** ✅ [`"type": "module"` set at package.json:5](package.json#L5), Baileys v7.0.0-rc.9 at [package.json:41](package.json#L41)
+
+### Step 3: Update TypeScript Configuration ✅ COMPLETE
 
 ```json
 // tsconfig.json
@@ -100,7 +139,9 @@ cp -r ./sessions ./sessions-backup-v6
 }
 ```
 
-### Step 4: Update Imports in MiawClient.ts
+**Status:** ✅ Configured at [tsconfig.json:4](tsconfig.json#L4), [tsconfig.json:15](tsconfig.json#L15), [tsconfig.json:12](tsconfig.json#L12)
+
+### Step 4: Update Imports in MiawClient.ts ✅ COMPLETE
 
 ```typescript
 // Before (CommonJS-style)
@@ -119,7 +160,11 @@ import makeWASocket, {
 } from "@whiskeysockets/baileys";
 ```
 
-### Step 5: Update MessageHandler.ts
+**Status:** ✅ ESM imports with `.js` extensions at [MiawClient.ts:1-9](src/client/MiawClient.ts#L1-L9) and [MiawClient.ts:68-70](src/client/MiawClient.ts#L68-L70)
+
+**Note:** `isPnUser` is **not imported** because the codebase doesn't use this API - it's not needed for miaw-core's functionality.
+
+### Step 5: Update MessageHandler.ts ✅ COMPLETE
 
 ```typescript
 // Add LID support in formatPhoneToJid
@@ -132,7 +177,9 @@ static formatPhoneToJid(phoneNumber: string): string {
 }
 ```
 
-### Step 6: Update MiawClient for LID Mapping Store Access
+**Status:** ✅ `@lid` support implemented at [MessageHandler.ts:173-192](src/handlers/MessageHandler.ts#L173-L192)
+
+### Step 6: Update MiawClient for LID Mapping Store Access ✅ COMPLETE
 
 ```typescript
 // Access the internal LID mapping store (optional, for advanced use)
@@ -141,7 +188,15 @@ getLidMapping() {
 }
 ```
 
-### Step 7: Handle New Auth State Keys
+**Status:** ✅ **Alternative Implementation** - Custom LruCache implemented instead of accessing internal Baileys store:
+
+- `LruCache` class at [MiawClient.ts:76-123](src/client/MiawClient.ts#L76-L123)
+- `getLidMappings()` public method at [MiawClient.ts:608-615](src/client/MiawClient.ts#L608-L615)
+- `resolveLidToJid()` at [MiawClient.ts:570-575](src/client/MiawClient.ts#L570-L575)
+
+**Reason:** Baileys v7 removed `makeInMemoryStore`, requiring custom implementation.
+
+### Step 7: Handle New Auth State Keys ✅ COMPLETE
 
 Verify `useMultiFileAuthState` in AuthHandler handles new keys automatically. If using custom auth storage, add:
 
@@ -154,7 +209,9 @@ type SignalDataTypeMap = {
 };
 ```
 
-### Step 8: Update Protobuf Usage (if any)
+**Status:** ✅ `useMultiFileAuthState` handles new keys automatically - see [AuthHandler.ts:1](src/handlers/AuthHandler.ts#L1), [AuthHandler.ts:23](src/handlers/AuthHandler.ts#L23)
+
+### Step 8: Update Protobuf Usage (if any) ✅ NOT APPLICABLE
 
 ```typescript
 // Before
@@ -164,7 +221,9 @@ const msg = proto.Message.fromObject({ ... });
 const msg = proto.Message.create({ ... });
 ```
 
-### Step 9: Clear Old Sessions (Recommended)
+**Status:** ✅ **Not Applicable** - No `proto.fromObject()` or `proto.create()` usage found in codebase
+
+### Step 9: Clear Old Sessions (Recommended) ✅ DOCUMENTED
 
 Due to auth state changes, recommend users clear old sessions on first run with v7:
 
@@ -172,6 +231,8 @@ Due to auth state changes, recommend users clear old sessions on first run with
 rm -rf ./sessions/*
 ```
 
+**Status:** ✅ Documented in rollback plan below
+
 ---
 
 ## Testing Checklist
@@ -186,6 +247,37 @@ rm -rf ./sessions/*
 
 ---
 
+## Additional Implementation Notes
+
+### Custom Stores Implementation (Baileys v7 Removal)
+
+Baileys v7 removed `makeInMemoryStore`. Miaw Core implements custom stores:
+
+| Store | Type | Location | Purpose |
+| :--- | :--- | :--- | :--- |
+| `contactsStore` | `Map<string, ContactInfo>` | [MiawClient.ts:139](src/client/MiawClient.ts#L139) | Contact information cache |
+| `chatsStore` | `Map<string, ChatInfo>` | [MiawClient.ts:140](src/client/MiawClient.ts#L140) | Chat metadata cache |
+| `messagesStore` | `Map<string, MiawMessage[]>` | [MiawClient.ts:141](src/client/MiawClient.ts#L141) | Message history cache |
+| `lidToJidMap` | `LruCache` | [MiawClient.ts:136](src/client/MiawClient.ts#L136) | LID → JID resolution (1000 max entries) |
+
+### Signal Key Store Enhancement
+
+Uses `makeCacheableSignalKeyStore` for thread-safe key operations:
+
+- [Imported at MiawClient.ts:5](src/client/MiawClient.ts#L5)
+- [Applied at MiawClient.ts:222](src/client/MiawClient.ts#L222)
+
+This provides mutex-based transaction safety for concurrent key access (Baileys v7 PR #1697).
+
+### Media Download Update
+
+`downloadMediaMessage` signature updated to include `reuploadRequest` parameter:
+
+- [Import at MiawClient.ts:8](src/client/MiawClient.ts#L8)
+- [Usage at MiawClient.ts:1103-1114](src/client/MiawClient.ts#L1103-L1114)
+
+---
+
 ## Rollback Plan
 
 If issues occur:
@@ -201,15 +293,31 @@ npm install @whiskeysockets/baileys@6.7.21
 
 ---
 
+## Migration Status Summary
+
+| Step | Task | Status |
+| :--- | :--- | :--- |
+| 1 | Backup sessions | ✅ Complete |
+| 2 | Update package.json | ✅ Complete |
+| 3 | Update TypeScript config | ✅ Complete |
+| 4 | Update imports (ESM) | ✅ Complete |
+| 5 | Update MessageHandler (@lid) | ✅ Complete |
+| 6 | LID mapping store access | ✅ Complete (custom implementation) |
+| 7 | New auth state keys | ✅ Complete (auto-handled) |
+| 8 | Protobuf usage | ✅ N/A (no usage in codebase) |
+| 9 | Clear old sessions | ✅ Documented |
+
+---
+
 ## Timeline Estimate
 
-| Task                 | Effort         |
-| -------------------- | -------------- |
-| ESM conversion       | 2-4 hours      |
-| API updates          | 1-2 hours      |
-| Testing              | 4-8 hours      |
-| Documentation update | 1-2 hours      |
-| **Total**            | **8-16 hours** |
+| Task | Effort | Actual |
+| :--- | :--- | :--- |
+| ESM conversion | 2-4 hours | ✅ Complete |
+| API updates | 1-2 hours | ✅ Complete |
+| Testing | 4-8 hours | ⏳ Pending |
+| Documentation update | 1-2 hours | ✅ Complete |
+| **Total** | **8-16 hours** | **Implementation Complete** |
 
 ---