nduka 1.0.0

package/dist/session/recovery.js

@@ -0,0 +1,196 @@
+/**
+ * Session Recovery Service
+ *
+ * Automatically recovers from known WhatsApp disconnection scenarios:
+ *  - connectionClosed (428)
+ *  - connectionLost (408)
+ *  - timedOut (408)
+ *  - restartRequired (515)
+ *  - loggedOut (401) — triggers re-pair workflow
+ *  - badSession (500)
+ *
+ * Recovery strategies in priority order:
+ *  1. Wait and retry (transient issues)
+ *  2. Reload credentials from disk (minor corruption)
+ *  3. Rollback to last snapshot (major corruption)
+ *  4. Trigger re-pair workflow (loggedOut / irrecoverable)
+ */
+import { DisconnectReason } from '@whiskeysockets/baileys';
+import { SingleFileAuthStore } from '../gateway/auth/store.js';
+import { SessionValidator } from './validator.js';
+import { SessionSnapshotService } from './snapshot.js';
+const DEFAULT_CONFIG = { maxRetries: 10, baseDelayMs: 2_000, maxDelayMs: 120_000, reloadAfterRetries: 3, rollbackAfterRetries: 6 };
+const TRANSIENT_REASONS = new Set([DisconnectReason.connectionClosed, DisconnectReason.connectionLost, DisconnectReason.timedOut]);
+const RESTART_REASONS = new Set([DisconnectReason.restartRequired, DisconnectReason.unavailableService, DisconnectReason.forbidden]);
+const CORRUPTION_REASONS = new Set([DisconnectReason.badSession]);
+const IRRECOVERABLE_REASONS = new Set([DisconnectReason.loggedOut, DisconnectReason.multideviceMismatch]);
+function toBackupId(snapshotId) {
+    return snapshotId.replace(/^snap_/, 'backup_');
+}
+function toSnapshotId(backupOrSnapshotId) {
+    return backupOrSnapshotId.replace(/^backup_/, 'snap_');
+}
+export class SessionRecoveryService {
+    config;
+    validator;
+    snapshotService;
+    authStore;
+    retryCount = 0;
+    onRepairNeeded = null;
+    constructor(authStoreOrPath, snapshotServiceOrDir, config) {
+        if (typeof authStoreOrPath === 'string') {
+            this.authStore = new SingleFileAuthStore(authStoreOrPath);
+            this.snapshotService = new SessionSnapshotService(authStoreOrPath, typeof snapshotServiceOrDir === 'string' ? snapshotServiceOrDir : undefined);
+            this.config = { ...DEFAULT_CONFIG, ...config };
+        }
+        else {
+            this.authStore = authStoreOrPath;
+            this.snapshotService = snapshotServiceOrDir instanceof SessionSnapshotService ? snapshotServiceOrDir : null;
+            this.config = { ...DEFAULT_CONFIG, ...config };
+        }
+        this.validator = new SessionValidator();
+    }
+    onRepairNeededCallback(callback) { this.onRepairNeeded = callback; }
+    backupCurrentSession() {
+        if (!this.snapshotService)
+            return null;
+        const snapshot = this.snapshotService.createSnapshot();
+        if (!snapshot)
+            return null;
+        return { ...snapshot, id: toBackupId(snapshot.id) };
+    }
+    restoreFromSnapshot(snapshotId) {
+        if (!this.snapshotService)
+            return { success: false, error: 'No snapshot service configured' };
+        const actualSnapshotId = toSnapshotId(snapshotId);
+        const restored = this.snapshotService.rollbackToSnapshot(actualSnapshotId);
+        if (!restored)
+            return { success: false, error: `Snapshot restore failed: ${snapshotId}` };
+        const reloaded = this.reloadCredentials();
+        if (!reloaded)
+            return { success: false, restoredFrom: snapshotId, error: 'Snapshot restored but credential reload failed' };
+        return { success: true, restoredFrom: snapshotId };
+    }
+    decideRecovery(disconnectReason, statusCode) {
+        this.retryCount++;
+        const reasonCode = statusCode || this.extractStatusCode(disconnectReason);
+        if (IRRECOVERABLE_REASONS.has(reasonCode))
+            return { action: 'trigger_repair', reason: `Irrecoverable disconnection: ${disconnectReason} (code: ${reasonCode})`, delayMs: 0, retryCount: this.retryCount };
+        if (CORRUPTION_REASONS.has(reasonCode))
+            return { action: 'reload_credentials', reason: `Bad session detected: ${disconnectReason} (code: ${reasonCode})`, delayMs: this.config.baseDelayMs, retryCount: this.retryCount };
+        if (this.retryCount >= this.config.maxRetries)
+            return { action: 'trigger_repair', reason: `Max retries (${this.config.maxRetries}) exceeded for: ${disconnectReason}`, delayMs: 0, retryCount: this.retryCount };
+        if (this.retryCount >= this.config.rollbackAfterRetries)
+            return { action: 'rollback_snapshot', reason: `Attempting snapshot rollback after ${this.retryCount} retries`, delayMs: this.calculateDelay(), retryCount: this.retryCount };
+        if (this.retryCount >= this.config.reloadAfterRetries)
+            return { action: 'reload_credentials', reason: `Attempting credential reload after ${this.retryCount} retries`, delayMs: this.calculateDelay(), retryCount: this.retryCount };
+        return { action: 'retry_reconnect', reason: `Retrying after: ${disconnectReason}`, delayMs: this.calculateDelay(), retryCount: this.retryCount };
+    }
+    async executeRecovery(decision) {
+        console.log(`[RecoveryService] Action: ${decision.action} (retry #${decision.retryCount}) — ${decision.reason}`);
+        switch (decision.action) {
+            case 'retry_reconnect': return true;
+            case 'reload_credentials': return this.reloadCredentials();
+            case 'rollback_snapshot': return this.rollbackToSnapshot();
+            case 'trigger_repair':
+                this.onRepairNeeded?.();
+                return false;
+            case 'give_up': return false;
+            default: return false;
+        }
+    }
+    reloadCredentials() {
+        try {
+            const wasLoaded = this.authStore.loadSync();
+            if (!wasLoaded) {
+                console.error('[RecoveryService] No auth state on disk to reload');
+                return false;
+            }
+            const creds = this.authStore.getCreds();
+            const validation = this.validator.validateCredentials(creds);
+            if (!validation.valid) {
+                console.error('[RecoveryService] Reloaded credentials are invalid:', validation.errors.map((e) => e.message));
+                return false;
+            }
+            console.log('[RecoveryService] Credentials reloaded and validated');
+            return true;
+        }
+        catch (err) {
+            console.error('[RecoveryService] Credential reload failed:', err.message);
+            return false;
+        }
+    }
+    rollbackToSnapshot() {
+        if (!this.snapshotService) {
+            console.error('[RecoveryService] No snapshot service configured');
+            return false;
+        }
+        const success = this.snapshotService.rollbackToLatest();
+        if (!success) {
+            console.error('[RecoveryService] Snapshot rollback failed — no valid snapshots');
+            return false;
+        }
+        return this.reloadCredentials();
+    }
+    async validateBeforeConnect() {
+        const creds = this.authStore.getCreds();
+        const validation = this.validator.validateCredentials(creds);
+        if (!validation.valid) {
+            if (this.isFreshPairingState(creds, validation.errors)) {
+                console.log('[RecoveryService] Fresh unpaired auth state detected — allowing connect for pairing.');
+                return true;
+            }
+            console.error('[RecoveryService] Pre-connect validation failed:', validation.errors.map((e) => `${e.field}: ${e.message}`));
+            if (this.snapshotService) {
+                console.log('[RecoveryService] Attempting snapshot recovery...');
+                const rolled = this.snapshotService.rollbackToLatest();
+                if (rolled) {
+                    const reCreds = this.authStore.getCreds();
+                    const reValidation = this.validator.validateCredentials(reCreds);
+                    return reValidation.valid || this.isFreshPairingState(reCreds, reValidation.errors);
+                }
+            }
+            return false;
+        }
+        return true;
+    }
+    reset() { this.retryCount = 0; }
+    isFreshPairingState(creds, errors) {
+        const hasCoreKeys = !!creds.noiseKey && !!creds.signedIdentityKey && !!creds.signedPreKey;
+        const explicitlyUnregistered = creds.registered === false;
+        const onlyPairingSetupErrors = errors.every((e) => ['accountSettings', 'registered'].includes(e.field));
+        return hasCoreKeys && explicitlyUnregistered && onlyPairingSetupErrors;
+    }
+    calculateDelay() {
+        const delay = this.config.baseDelayMs * Math.pow(2, this.retryCount - 1);
+        return Math.min(delay, this.config.maxDelayMs);
+    }
+    extractStatusCode(reason) {
+        const match = reason.match(/\b(\d{3})\b/);
+        if (match)
+            return parseInt(match[1], 10);
+        const reasonLower = reason.toLowerCase();
+        if (reasonLower.includes('logged out'))
+            return DisconnectReason.loggedOut;
+        if (reasonLower.includes('bad session'))
+            return DisconnectReason.badSession;
+        if (reasonLower.includes('restart'))
+            return DisconnectReason.restartRequired;
+        if (reasonLower.includes('timed'))
+            return DisconnectReason.timedOut;
+        if (reasonLower.includes('forbidden'))
+            return DisconnectReason.forbidden;
+        if (reasonLower.includes('replaced'))
+            return DisconnectReason.connectionReplaced;
+        if (reasonLower.includes('unavailable'))
+            return DisconnectReason.unavailableService;
+        if (reasonLower.includes('mismatch'))
+            return DisconnectReason.multideviceMismatch;
+        if (reasonLower.includes('closed'))
+            return DisconnectReason.connectionClosed;
+        if (reasonLower.includes('lost'))
+            return DisconnectReason.connectionLost;
+        return 0;
+    }
+}
+//# sourceMappingURL=recovery.js.map

package/dist/session/recovery.js.map

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

package/dist/session/snapshot.d.ts

@@ -0,0 +1,70 @@
+export interface Snapshot {
+    /** Snapshot ID (timestamp-based) */
+    id: string;
+    /** Timestamp of snapshot creation */
+    createdAt: string;
+    /** Session version at time of snapshot */
+    version: number;
+    /** SHA-256 hash of the snapshot data */
+    hash: string;
+    /** Path to the snapshot auth file */
+    authFilePath: string;
+    /** Path to the snapshot key store file */
+    keyFilePath: string;
+    /** Size of snapshot in bytes */
+    sizeBytes: number;
+    /** Whether this snapshot has been validated */
+    validated: boolean;
+}
+export interface SnapshotList {
+    snapshots: Snapshot[];
+    totalCount: number;
+    oldestSnapshot: Snapshot | null;
+    newestSnapshot: Snapshot | null;
+}
+export declare class SessionSnapshotService {
+    private snapshotDir;
+    private authFilePath;
+    private maxSnapshots;
+    private intervalId;
+    private onSnapshotCallback;
+    constructor(authFilePath: string, snapshotDir?: string, maxSnapshots?: number);
+    /**
+     * Start periodic snapshotting (every 5 minutes).
+     */
+    startPeriodicSnapshots(): void;
+    /** Stop periodic snapshotting. */
+    stopPeriodicSnapshots(): void;
+    /** Register a callback for when a snapshot is created. */
+    onSnapshot(callback: (snapshot: Snapshot) => void): void;
+    /**
+     * Create a snapshot of the current auth state.
+     * Returns the snapshot metadata, or null if the auth file doesn't exist.
+     */
+    createSnapshot(): Snapshot | null;
+    /**
+     * List all available snapshots, sorted newest first.
+     */
+    listSnapshots(): SnapshotList;
+    /**
+     * Rollback to a specific snapshot.
+     * Copies the snapshot auth/key files back to the original locations.
+     */
+    rollbackToSnapshot(snapshotId: string): boolean;
+    /**
+     * Rollback to the most recent validated snapshot.
+     */
+    rollbackToLatest(): boolean;
+    /**
+     * Validate all snapshots and clean up corrupted ones.
+     */
+    validateAll(): {
+        valid: number;
+        removed: number;
+    };
+    private extractVersion;
+    private pruneOldSnapshots;
+    /** Clean up resources. */
+    destroy(): void;
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/session/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/session/snapshot.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,QAAQ,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,QAAQ,GAAG,IAAI,CAAC;CACjC;AAUD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,kBAAkB,CAA+C;gBAGvE,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM;IAWvB;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAY9B,kCAAkC;IAClC,qBAAqB,IAAI,IAAI;IAO7B,0DAA0D;IAC1D,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAIxD;;;OAGG;IACH,cAAc,IAAI,QAAQ,GAAG,IAAI;IAyDjC;;OAEG;IACH,aAAa,IAAI,YAAY;IA8C7B;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAqC/C;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAc3B;;OAEG;IACH,WAAW,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAuCjD,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,iBAAiB;IAoBzB,0BAA0B;IAC1B,OAAO,IAAI,IAAI;CAGhB"}

package/dist/session/snapshot.js

@@ -0,0 +1,268 @@
+/**
+ * Session Snapshot Service
+ *
+ * Creates periodic snapshots of the auth state for recovery.
+ * Supports rollback to previous valid snapshot on corruption.
+ *
+ * Snapshots are taken every 5 minutes and on credential updates.
+ * Maintains a rolling window of snapshots (default: 12, i.e. 1 hour).
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, existsSync, unlinkSync, mkdirSync, readdirSync, copyFileSync, } from 'node:fs';
+import { join } from 'node:path';
+// ─── Config ──────────────────────────────────────────────────────────────────
+const DEFAULT_SNAPSHOT_DIR = './data/snapshots';
+const MAX_SNAPSHOTS = 12;
+const SNAPSHOT_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+// ─── Session Snapshot Service ────────────────────────────────────────────────
+export class SessionSnapshotService {
+    snapshotDir;
+    authFilePath;
+    maxSnapshots;
+    intervalId = null;
+    onSnapshotCallback = null;
+    constructor(authFilePath, snapshotDir, maxSnapshots) {
+        this.authFilePath = authFilePath;
+        this.snapshotDir = snapshotDir || DEFAULT_SNAPSHOT_DIR;
+        this.maxSnapshots = maxSnapshots || MAX_SNAPSHOTS;
+        if (!existsSync(this.snapshotDir)) {
+            mkdirSync(this.snapshotDir, { recursive: true });
+        }
+    }
+    /**
+     * Start periodic snapshotting (every 5 minutes).
+     */
+    startPeriodicSnapshots() {
+        if (this.intervalId)
+            return;
+        // Take initial snapshot
+        this.createSnapshot();
+        // Schedule periodic snapshots
+        this.intervalId = setInterval(() => {
+            this.createSnapshot();
+        }, SNAPSHOT_INTERVAL_MS);
+    }
+    /** Stop periodic snapshotting. */
+    stopPeriodicSnapshots() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+    }
+    /** Register a callback for when a snapshot is created. */
+    onSnapshot(callback) {
+        this.onSnapshotCallback = callback;
+    }
+    /**
+     * Create a snapshot of the current auth state.
+     * Returns the snapshot metadata, or null if the auth file doesn't exist.
+     */
+    createSnapshot() {
+        if (!existsSync(this.authFilePath)) {
+            return null;
+        }
+        try {
+            const timestamp = Date.now();
+            const snapshotId = `snap_${timestamp}`;
+            const authSnapshotPath = join(this.snapshotDir, `${snapshotId}_auth.json`);
+            // Read and hash the current auth state
+            const authData = readFileSync(this.authFilePath);
+            const keyDataPath = this.authFilePath.replace('.json', '_keys.json');
+            const keyData = existsSync(keyDataPath) ? readFileSync(keyDataPath) : Buffer.alloc(0);
+            // Copy the auth file to snapshot
+            copyFileSync(this.authFilePath, authSnapshotPath);
+            // Copy key store if it exists
+            let keySnapshotPath = '';
+            if (existsSync(keyDataPath)) {
+                keySnapshotPath = join(this.snapshotDir, `${snapshotId}_keys.json`);
+                copyFileSync(keyDataPath, keySnapshotPath);
+            }
+            const hash = createHash('sha256')
+                .update(authData)
+                .update(keyData)
+                .digest('hex');
+            const snapshot = {
+                id: snapshotId,
+                createdAt: new Date(timestamp).toISOString(),
+                version: this.extractVersion(authData),
+                hash,
+                authFilePath: authSnapshotPath,
+                keyFilePath: keySnapshotPath,
+                sizeBytes: authData.length + keyData.length,
+                validated: true,
+            };
+            // Prune old snapshots
+            this.pruneOldSnapshots();
+            // Notify callback
+            this.onSnapshotCallback?.(snapshot);
+            return snapshot;
+        }
+        catch (err) {
+            console.error('[SnapshotService] Failed to create snapshot:', err.message);
+            return null;
+        }
+    }
+    /**
+     * List all available snapshots, sorted newest first.
+     */
+    listSnapshots() {
+        if (!existsSync(this.snapshotDir)) {
+            return { snapshots: [], totalCount: 0, oldestSnapshot: null, newestSnapshot: null };
+        }
+        const files = readdirSync(this.snapshotDir)
+            .filter((f) => f.endsWith('_auth.json'))
+            .sort()
+            .reverse();
+        const snapshots = files.map((f) => {
+            const id = f.replace('_auth.json', '');
+            const authFilePath = join(this.snapshotDir, f);
+            const keyFilePath = join(this.snapshotDir, `${id}_keys.json`);
+            let hash = '';
+            let sizeBytes = 0;
+            try {
+                const authData = readFileSync(authFilePath);
+                const keyData = existsSync(keyFilePath) ? readFileSync(keyFilePath) : Buffer.alloc(0);
+                hash = createHash('sha256').update(authData).update(keyData).digest('hex');
+                sizeBytes = authData.length + keyData.length;
+            }
+            catch {
+                // Skip invalid snapshots
+            }
+            return {
+                id,
+                createdAt: new Date(parseInt(id.replace('snap_', ''))).toISOString(),
+                version: 0,
+                hash,
+                authFilePath,
+                keyFilePath: existsSync(keyFilePath) ? keyFilePath : '',
+                sizeBytes,
+                validated: true,
+            };
+        });
+        return {
+            snapshots,
+            totalCount: snapshots.length,
+            oldestSnapshot: snapshots[snapshots.length - 1] || null,
+            newestSnapshot: snapshots[0] || null,
+        };
+    }
+    /**
+     * Rollback to a specific snapshot.
+     * Copies the snapshot auth/key files back to the original locations.
+     */
+    rollbackToSnapshot(snapshotId) {
+        const snapshotAuthPath = join(this.snapshotDir, `${snapshotId}_auth.json`);
+        const snapshotKeyPath = join(this.snapshotDir, `${snapshotId}_keys.json`);
+        if (!existsSync(snapshotAuthPath)) {
+            console.error(`[SnapshotService] Snapshot ${snapshotId} not found`);
+            return false;
+        }
+        try {
+            // Verify snapshot integrity
+            const authData = readFileSync(snapshotAuthPath);
+            const keyData = existsSync(snapshotKeyPath) ? readFileSync(snapshotKeyPath) : Buffer.alloc(0);
+            const hash = createHash('sha256').update(authData).update(keyData).digest('hex');
+            // Restore auth file
+            copyFileSync(snapshotAuthPath, this.authFilePath);
+            // Restore key file
+            const origKeyPath = this.authFilePath.replace('.json', '_keys.json');
+            if (existsSync(snapshotKeyPath)) {
+                copyFileSync(snapshotKeyPath, origKeyPath);
+            }
+            console.log(`[SnapshotService] Rolled back to snapshot ${snapshotId} (hash: ${hash.slice(0, 16)})`);
+            return true;
+        }
+        catch (err) {
+            console.error('[SnapshotService] Rollback failed:', err.message);
+            return false;
+        }
+    }
+    /**
+     * Rollback to the most recent validated snapshot.
+     */
+    rollbackToLatest() {
+        const { snapshots } = this.listSnapshots();
+        if (snapshots.length === 0)
+            return false;
+        // Try snapshots from newest to oldest
+        for (const snap of snapshots) {
+            if (snap.validated) {
+                return this.rollbackToSnapshot(snap.id);
+            }
+        }
+        return false;
+    }
+    /**
+     * Validate all snapshots and clean up corrupted ones.
+     */
+    validateAll() {
+        let valid = 0;
+        let removed = 0;
+        const { snapshots } = this.listSnapshots();
+        for (const snap of snapshots) {
+            if (!existsSync(snap.authFilePath)) {
+                removed++;
+                continue;
+            }
+            try {
+                const authData = readFileSync(snap.authFilePath);
+                const keyData = existsSync(snap.keyFilePath)
+                    ? readFileSync(snap.keyFilePath)
+                    : Buffer.alloc(0);
+                const actualHash = createHash('sha256')
+                    .update(authData)
+                    .update(keyData)
+                    .digest('hex');
+                if (actualHash === snap.hash) {
+                    valid++;
+                }
+                else {
+                    // Remove corrupted snapshot
+                    unlinkSync(snap.authFilePath);
+                    if (existsSync(snap.keyFilePath))
+                        unlinkSync(snap.keyFilePath);
+                    removed++;
+                }
+            }
+            catch {
+                removed++;
+            }
+        }
+        return { valid, removed };
+    }
+    // ─── Private ────────────────────────────────────────────────────────────
+    extractVersion(authData) {
+        try {
+            const creds = JSON.parse(authData.toString());
+            // Version stored in metadata file alongside auth
+            return 1;
+        }
+        catch {
+            return 1;
+        }
+    }
+    pruneOldSnapshots() {
+        if (!existsSync(this.snapshotDir))
+            return;
+        const files = readdirSync(this.snapshotDir)
+            .filter((f) => f.endsWith('_auth.json'))
+            .sort(); // oldest first
+        while (files.length > this.maxSnapshots) {
+            const oldest = files.shift();
+            if (oldest) {
+                const base = oldest.replace('_auth.json', '');
+                const authPath = join(this.snapshotDir, oldest);
+                const keyPath = join(this.snapshotDir, `${base}_keys.json`);
+                if (existsSync(authPath))
+                    unlinkSync(authPath);
+                if (existsSync(keyPath))
+                    unlinkSync(keyPath);
+            }
+        }
+    }
+    /** Clean up resources. */
+    destroy() {
+        this.stopPeriodicSnapshots();
+    }
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/session/snapshot.js.map

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

package/dist/session/validator.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Session Validator
+ *
+ * Validates WhatsApp auth state integrity BEFORE socket initialization.
+ * Prevents Baileys from attempting to connect with corrupted state,
+ * which would produce cryptic crypto errors downstream.
+ *
+ * Checks:
+ *  - Credential structure completeness
+ *  - Required key pairs existence and type
+ *  - Binary field integrity (not JSON-corrupted)
+ *  - Signal key store accessibility
+ *  - Session version consistency
+ */
+import type { AuthenticationCreds, SignalKeyStore } from '@whiskeysockets/baileys';
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+export interface ValidationError {
+    field: string;
+    message: string;
+    severity: 'critical' | 'error';
+}
+export interface ValidationWarning {
+    field: string;
+    message: string;
+    severity: 'warning' | 'info';
+}
+export declare class SessionValidator {
+    /**
+     * Validate credentials before socket initialization.
+     * Returns detailed errors for any issues found.
+     */
+    validateCredentials(creds: AuthenticationCreds): ValidationResult;
+    /**
+     * Validate the Signal key store is accessible and has required key types.
+     */
+    validateKeyStore(keys: SignalKeyStore): Promise<ValidationResult>;
+    /**
+     * Full validation: credentials + key store.
+     */
+    validateFull(creds: AuthenticationCreds, keys: SignalKeyStore): Promise<{
+        credResult: ValidationResult;
+        keyResult: ValidationResult;
+    }>;
+    private validateKeyPair;
+    private validateSignedPreKey;
+    /**
+     * Check if a value is a valid binary type (Uint8Array or Buffer).
+     * Plain objects (JSON-corrupted) are rejected.
+     */
+    private isBinaryField;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/session/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/session/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAInF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;CAC9B;AA2BD,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,gBAAgB;IAqFjE;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4CvE;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,mBAAmB,EAC1B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC;QAAE,UAAU,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAQzE,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,oBAAoB;IAuD5B;;;OAGG;IACH,OAAO,CAAC,aAAa;CAkBtB"}