@kangwifi-pro/waliwa 1.0.0

package/dist/skdm/index.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Waliwa - SKDM (Store Key Data Manager)
+ *
+ * Subsystem cerdas untuk manage Signal protocol keys:
+ * - Auto-regenerate pre-keys saat hampir habis (prevents Baileys pre-key exhaustion)
+ * - LRU cache untuk sessions (RAM efficient)
+ * - Atomic writes untuk prevent corruption saat disconnect (Baileys issue)
+ * - Pre-key rotation policy dengan background jobs
+ * - Session cleanup untuk orphaned sessions
+ * - Key prefetching untuk known conversations (fix decryption failures)
+ *
+ * Fixes yang addressed:
+ * - Baileys issue: pre-key exhaustion → pre-keys habis gak auto-regenerate
+ * - Baileys issue: session corruption on disconnect → atomic write
+ * - Baileys issue: decryption failure for old messages → key prefetch
+ * - Baileys issue: memory leak dari sessions lama → LRU eviction
+ */
+import type { AuthenticationCreds, SignalKeyStore, KeyPair, WALogger } from '../types/index.js';
+export interface SKDMConfig {
+    /** Min pre-keys sebelum regenerate (default: 5) */
+    minPreKeys?: number;
+    /** Max pre-keys yang di-generate sekaligus (default: 50) */
+    maxPreKeysBatch?: number;
+    /** Total pre-keys yang di-keep (default: 100) */
+    targetPreKeyCount?: number;
+    /** Max sessions di RAM cache (default: 500, RAM optimization) */
+    maxSessionCacheSize?: number;
+    /** Auto-save interval ms (default: 5000) */
+    autoSaveIntervalMs?: number;
+    /** Enable background key rotation (default: true) */
+    enableKeyRotation?: boolean;
+    /** Logger */
+    logger?: WALogger;
+    /** Folder untuk atomic writes */
+    storageFolder: string;
+    /** File prefix */
+    prefix?: string;
+    /** Enable session prefetching (default: true, fix decryption failure) */
+    enableSessionPrefetch?: boolean;
+    /** Session expiry (ms, default: 30 days) */
+    sessionExpiryMs?: number;
+}
+/**
+ * LRU cache dengan O(1) operations, manual implementation untuk RAM efficiency.
+ * Used untuk caching sessions dan senderKeys.
+ */
+export declare class LRUCache<K, V> {
+    private cache;
+    private maxSize;
+    private hits;
+    private misses;
+    constructor(maxSize?: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    size(): number;
+    getStats(): {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+}
+/**
+ * Atomic file writer - prevents corruption saat disconnect/power failure.
+ * Baileys issue: session files corrupt jika process kill saat write.
+ *
+ * Strategy: write to .tmp file, then rename (atomic on POSIX systems).
+ */
+export declare class AtomicFileWriter {
+    private static writeLocks;
+    static writeFile(filePath: string, data: string | Buffer, encoding?: 'utf-8' | 'binary'): Promise<void>;
+    private static performWrite;
+}
+/**
+ * Pre-key manager - auto-regenerate saat low, prevents exhaustion.
+ * Fix Baileys issue: pre-keys habis tanpa warning.
+ */
+export declare class PreKeyManager {
+    private creds;
+    private keys;
+    private minPreKeys;
+    private maxBatch;
+    private targetCount;
+    private logger;
+    private isRegenerating;
+    private lastRegenTime;
+    private regenDebounce;
+    constructor(creds: AuthenticationCreds, keys: SignalKeyStore, config: Pick<SKDMConfig, 'minPreKeys' | 'maxPreKeysBatch' | 'targetPreKeyCount' | 'logger'>);
+    needsRegeneration(): boolean;
+    getPreKeyCount(): number;
+    getNextPreKeyId(): number;
+    getPreKey(id: number): KeyPair | undefined;
+    /**
+     * Consume a pre-key (mark as used)
+     * Returns true jika key consumed, false jika tidak ada
+     */
+    consumePreKey(id: number): boolean;
+    scheduleRegeneration(): void;
+    regeneratePreKeys(): Promise<void>;
+    startBackgroundRotation(intervalMs?: number): NodeJS.Timeout;
+    getStats(): {
+        total: number;
+        nextId: number;
+        lastRegenTime: number;
+        needsRegen: boolean;
+    };
+}
+/**
+ * Session manager dengan LRU cache untuk RAM efficiency.
+ * Fix Baileys issue: memory leak dari sessions lama.
+ */
+export declare class SessionManager {
+    private keys;
+    private cache;
+    private maxCacheSize;
+    private logger;
+    private sessionExpiryMs;
+    private lastAccess;
+    constructor(keys: SignalKeyStore, config: Pick<SKDMConfig, 'maxSessionCacheSize' | 'logger' | 'sessionExpiryMs'>);
+    getSession(jid: string): any | undefined;
+    setSession(jid: string, session: any): void;
+    deleteSession(jid: string): void;
+    /**
+     * Cleanup expired sessions (untuk free RAM)
+     * Returns count of cleaned sessions
+     */
+    cleanupExpiredSessions(): number;
+    /**
+     * Prefetch sessions untuk multiple JIDs (fix decryption failure)
+     * Bulk load sessions sebelum decrypt group messages
+     */
+    prefetchSessions(jids: string[]): void;
+    getStats(): {
+        totalSessions: number;
+        expiredSessions: number;
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+}
+/**
+ * AppState key manager - manage app state sync keys dengan deduplication.
+ * Fix Baileys issue: app state sync keys bertumpuk tanpa cleanup.
+ */
+export declare class AppStateKeyManager {
+    private keys;
+    private logger;
+    private cache;
+    constructor(keys: SignalKeyStore, logger?: WALogger);
+    get(keyId: string): Uint8Array | undefined;
+    set(keyId: string, key: Uint8Array): void;
+    cleanup(maxKeep?: number): number;
+}
+/**
+ * Identity key manager dengan verification.
+ * Fix Baileys issue: identity changes gak tracked properly.
+ */
+export declare class IdentityKeyManager {
+    private keys;
+    private logger;
+    private trustedIdentities;
+    private changedIdentities;
+    constructor(keys: SignalKeyStore, logger?: WALogger);
+    get(jid: string): Uint8Array | undefined;
+    /**
+     * Save identity key, detect changes
+     * Returns true jika identity CHANGED (security concern)
+     */
+    save(jid: string, identity: Uint8Array): boolean;
+    getChangedIdentities(): string[];
+    acknowledge(jid: string): void;
+    trust(jid: string): void;
+    private bytesEqual;
+}
+/**
+ * SKDM - Store Key Data Manager
+ * Single entry point untuk semua key management operations.
+ */
+export declare class SKDM {
+    private config;
+    private logger;
+    private creds;
+    private keys;
+    preKeyManager: PreKeyManager;
+    sessionManager: SessionManager;
+    identityManager: IdentityKeyManager;
+    appStateManager: AppStateKeyManager;
+    private dirty;
+    private saveCredsDebounced;
+    private saveKeysDebounced;
+    private backgroundJobs;
+    private isInitialized;
+    constructor(creds: AuthenticationCreds, keys: SignalKeyStore, config: SKDMConfig);
+    /**
+     * Initialize SKDM - load state, start background jobs
+     */
+    initialize(): Promise<void>;
+    markCredsDirty(): void;
+    markKeysDirty(): void;
+    private flushCreds;
+    private flushKeys;
+    flush(): Promise<void>;
+    getStats(): SKDMStats;
+    destroy(): Promise<void>;
+}
+export interface SKDMStats {
+    preKeys: ReturnType<PreKeyManager['getStats']>;
+    sessions: ReturnType<SessionManager['getStats']>;
+    identities: {
+        total: number;
+        changed: number;
+    };
+    appStateKeys: number;
+    pendingSaves: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/skdm/index.d.ts.map

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