nduka 1.0.0

package/dist/media/reliability.d.ts

@@ -0,0 +1,58 @@
+import { MediaService } from './service.js';
+import type { WAMessage } from '@whiskeysockets/baileys';
+export interface QueuedMedia {
+    id: string;
+    messageId: string;
+    message: unknown;
+    addedAt: number;
+    retryCount: number;
+    maxRetries: number;
+    lastError: string | null;
+}
+export interface MediaIntegrityReport {
+    mediaId: string;
+    filePath: string;
+    expectedSize: number | null;
+    actualSize: number;
+    expectedMime: string | null;
+    actualMime: string;
+    checksumMatch: boolean;
+    valid: boolean;
+    issues: string[];
+}
+export interface MediaReliabilityStats {
+    queued: number;
+    processing: number;
+    downloaded: number;
+    failed: number;
+    retried: number;
+    duplicates: number;
+}
+export declare class MediaReliabilityEngine {
+    private mediaService;
+    private queue;
+    private processing;
+    private hashStore;
+    private activeDownloads;
+    private stats;
+    constructor(mediaService?: MediaService);
+    /**
+     * Enqueue a media message for reliable download.
+     * Returns immediately — download happens in background.
+     */
+    enqueue(message: WAMessage): string;
+    /**
+     * Wait for all queued downloads to complete.
+     */
+    waitForAll(): Promise<void>;
+    /**
+     * Validate a downloaded media file.
+     */
+    validateMedia(filePath: string, expectedMime?: string, expectedSize?: number): MediaIntegrityReport;
+    /** Get reliability stats. */
+    getStats(): MediaReliabilityStats;
+    private processQueue;
+    private downloadWithRetry;
+    private delay;
+}
+//# sourceMappingURL=reliability.d.ts.map

package/dist/media/reliability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reliability.d.ts","sourceRoot":"","sources":["../../src/media/reliability.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAIzD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AA+DD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,KAAK,CAOX;gBAEU,YAAY,CAAC,EAAE,YAAY;IAKvC;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM;IAmBnC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,oBAAoB;IAoEvB,6BAA6B;IAC7B,QAAQ,IAAI,qBAAqB;YAMnB,YAAY;YAgBZ,iBAAiB;IA+C/B,OAAO,CAAC,KAAK;CAGd"}

package/dist/media/reliability.js

@@ -0,0 +1,240 @@
+/**
+ * Media Reliability Engine
+ *
+ * Enhances the base MediaService with production-grade reliability:
+ *  - Media download queue with retry
+ *  - Duplicate media detection (content-hash based)
+ *  - MIME type validation
+ *  - Size validation
+ *  - Expired CDN URL recovery
+ *  - Parallel download coordination
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { MediaService } from './service.js';
+// ─── Config ──────────────────────────────────────────────────────────────────
+const MAX_RETRIES = 3;
+const MAX_PARALLEL_DOWNLOADS = 5;
+const RETRY_DELAY_MS = 5_000;
+const MAX_FILE_SIZE = 100 * 1024 * 1024; // 100MB
+const VALID_MIME_PREFIXES = ['image/', 'video/', 'audio/', 'application/', 'text/'];
+const ALLOWED_MIME_TYPES = new Set([
+    'image/jpeg', 'image/png', 'image/gif', 'image/webp',
+    'video/mp4', 'video/3gpp',
+    'audio/ogg', 'audio/mp4', 'audio/mpeg', 'audio/ogg; codecs=opus',
+    'application/pdf', 'application/octet-stream',
+    'text/plain',
+]);
+// ─── Content Hash Store ──────────────────────────────────────────────────────
+class ContentHashStore {
+    storePath;
+    hashes = new Map(); // sha256 -> mediaId
+    constructor(storePath = './data/media_hashes.json') {
+        this.storePath = storePath;
+        this.load();
+    }
+    /** Check if content with this hash already exists. */
+    hasDuplicate(hash) {
+        return this.hashes.get(hash) || null;
+    }
+    /** Register a new content hash. */
+    register(hash, mediaId) {
+        this.hashes.set(hash, mediaId);
+        this.save();
+    }
+    load() {
+        try {
+            if (existsSync(this.storePath)) {
+                const data = JSON.parse(readFileSync(this.storePath, 'utf-8'));
+                this.hashes = new Map(Object.entries(data));
+            }
+        }
+        catch {
+            this.hashes = new Map();
+        }
+    }
+    save() {
+        try {
+            const dir = join(this.storePath, '..');
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            writeFileSync(this.storePath, JSON.stringify(Object.fromEntries(this.hashes), null, 2));
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+}
+// ─── Media Reliability Engine ────────────────────────────────────────────────
+export class MediaReliabilityEngine {
+    mediaService;
+    queue = [];
+    processing = new Set();
+    hashStore;
+    activeDownloads = 0;
+    stats = {
+        queued: 0,
+        processing: 0,
+        downloaded: 0,
+        failed: 0,
+        retried: 0,
+        duplicates: 0,
+    };
+    constructor(mediaService) {
+        this.mediaService = mediaService || new MediaService();
+        this.hashStore = new ContentHashStore();
+    }
+    /**
+     * Enqueue a media message for reliable download.
+     * Returns immediately — download happens in background.
+     */
+    enqueue(message) {
+        const id = randomUUID();
+        this.queue.push({
+            id,
+            messageId: message.key?.id || '',
+            message,
+            addedAt: Date.now(),
+            retryCount: 0,
+            maxRetries: MAX_RETRIES,
+            lastError: null,
+        });
+        this.stats.queued = this.queue.length;
+        // Process queue
+        this.processQueue();
+        return id;
+    }
+    /**
+     * Wait for all queued downloads to complete.
+     */
+    async waitForAll() {
+        while (this.queue.length > 0 || this.activeDownloads > 0) {
+            await this.processQueue();
+            await new Promise((r) => setTimeout(r, 100));
+        }
+    }
+    /**
+     * Validate a downloaded media file.
+     */
+    validateMedia(filePath, expectedMime, expectedSize) {
+        const issues = [];
+        if (!existsSync(filePath)) {
+            return {
+                mediaId: '',
+                filePath,
+                expectedSize: expectedSize || null,
+                actualSize: 0,
+                expectedMime: expectedMime || null,
+                actualMime: '',
+                checksumMatch: false,
+                valid: false,
+                issues: ['file_not_found'],
+            };
+        }
+        const fileBuffer = readFileSync(filePath);
+        const actualSize = fileBuffer.length;
+        const actualHash = createHash('sha256').update(fileBuffer).digest('hex');
+        // Size validation
+        if (expectedSize && actualSize !== expectedSize) {
+            issues.push(`size_mismatch: expected ${expectedSize}, got ${actualSize}`);
+        }
+        // MIME validation
+        let actualMime = 'application/octet-stream';
+        if (expectedMime) {
+            // Basic MIME validation
+            if (!expectedMime.startsWith('image/') &&
+                !expectedMime.startsWith('video/') &&
+                !expectedMime.startsWith('audio/') &&
+                !expectedMime.startsWith('application/') &&
+                !expectedMime.startsWith('text/')) {
+                issues.push(`invalid_mime_prefix: ${expectedMime}`);
+            }
+            actualMime = expectedMime;
+        }
+        // Size limit check
+        if (actualSize > MAX_FILE_SIZE) {
+            issues.push(`file_too_large: ${actualSize} > ${MAX_FILE_SIZE}`);
+        }
+        if (actualSize === 0) {
+            issues.push('empty_file');
+        }
+        // Duplicate detection
+        const duplicateMediaId = this.hashStore.hasDuplicate(actualHash);
+        if (duplicateMediaId) {
+            issues.push(`duplicate_content: matches media ${duplicateMediaId}`);
+            this.stats.duplicates++;
+        }
+        return {
+            mediaId: '',
+            filePath,
+            expectedSize: expectedSize || null,
+            actualSize,
+            expectedMime: expectedMime || null,
+            actualMime,
+            checksumMatch: !duplicateMediaId,
+            valid: issues.length === 0 || (issues.length === 1 && issues[0].startsWith('duplicate')),
+            issues,
+        };
+    }
+    /** Get reliability stats. */
+    getStats() {
+        return { ...this.stats, queued: this.queue.length };
+    }
+    // ─── Private ────────────────────────────────────────────────────────────
+    async processQueue() {
+        while (this.queue.length > 0 && this.activeDownloads < MAX_PARALLEL_DOWNLOADS) {
+            const item = this.queue.shift();
+            if (!item)
+                break;
+            if (this.processing.has(item.messageId))
+                continue;
+            this.processing.add(item.messageId);
+            this.activeDownloads++;
+            this.downloadWithRetry(item).finally(() => {
+                this.activeDownloads--;
+                this.processing.delete(item.messageId);
+            });
+        }
+    }
+    async downloadWithRetry(item) {
+        while (item.retryCount < item.maxRetries) {
+            try {
+                const result = await this.mediaService.downloadFromMessage(item.message);
+                if (result) {
+                    this.stats.downloaded++;
+                    // Register in hash store for future duplicate detection
+                    this.hashStore.register(result.sha256, result.mediaId);
+                    // Validate integrity
+                    const report = this.validateMedia(result.filePath, result.mimeType, result.fileSize);
+                    if (!report.valid) {
+                        item.lastError = `Integrity check failed: ${report.issues.join(', ')}`;
+                        item.retryCount++;
+                        this.stats.retried++;
+                        await this.delay(RETRY_DELAY_MS);
+                        continue;
+                    }
+                    return result;
+                }
+                // Download failed — retry
+                item.lastError = 'Download returned null';
+                item.retryCount++;
+                this.stats.retried++;
+                await this.delay(RETRY_DELAY_MS);
+            }
+            catch (err) {
+                item.lastError = err.message;
+                item.retryCount++;
+                this.stats.retried++;
+                await this.delay(RETRY_DELAY_MS);
+            }
+        }
+        this.stats.failed++;
+        console.error(`[MediaReliability] Failed after ${item.maxRetries} retries: ${item.messageId}`);
+        return null;
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=reliability.js.map

package/dist/media/reliability.js.map

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

package/dist/media/service.d.ts

@@ -0,0 +1,53 @@
+import type { Readable } from 'node:stream';
+import { type WAMessage } from '@whiskeysockets/baileys';
+export type MediaType = 'image' | 'video' | 'audio' | 'document' | 'sticker';
+export interface DownloadResult {
+    /** Unique media ID */
+    mediaId: string;
+    /** Path to the downloaded file on disk */
+    filePath: string;
+    /** File size in bytes */
+    fileSize: number;
+    /** SHA-256 checksum of the file */
+    sha256: string;
+    /** MIME type */
+    mimeType: string;
+    /** Original filename (if available) */
+    fileName?: string;
+    /** Media type category */
+    mediaType: MediaType;
+}
+export interface StorageAdapter {
+    /** Store a file and return a retrievable URL/path */
+    store(filePath: string, mediaType: MediaType, mimeType: string): Promise<string>;
+    /** Retrieve a file as a readable stream */
+    retrieve(storageKey: string): Promise<Readable>;
+    /** Delete a stored file */
+    delete(storageKey: string): Promise<void>;
+}
+export declare class LocalStorageAdapter implements StorageAdapter {
+    private baseDir;
+    constructor(baseDir?: string);
+    store(filePath: string, _mediaType: MediaType, _mimeType: string): Promise<string>;
+    retrieve(storageKey: string): Promise<Readable>;
+    delete(storageKey: string): Promise<void>;
+}
+export declare class MediaService {
+    private storage;
+    private downloadDir;
+    constructor(storage?: StorageAdapter, downloadDir?: string);
+    /**
+     * Download media from a WhatsApp message.
+     * Imports content type detection inline to avoid protobuf type issues.
+     */
+    downloadFromMessage(msg: WAMessage): Promise<DownloadResult | null>;
+    /**
+     * Verify a file's integrity by comparing checksums.
+     */
+    verifyIntegrity(filePath: string, expectedSha256: string): boolean;
+    /**
+     * Get a previously downloaded media file path from the database.
+     */
+    getMediaForMessage(messageId: string): string | null;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/media/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/media/service.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,yBAAyB,CAAC;AAOjC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjF,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,2BAA2B;IAC3B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAID,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,SAAiB;IAO9B,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlF,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK/C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhD;AA0FD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,CAAC,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE,MAAM;IAK1D;;;OAGG;IACG,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA8GzE;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAOlE;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAOrD"}

package/dist/media/service.js

@@ -0,0 +1,238 @@
+/**
+ * Media Service
+ *
+ * Handles downloading, storing, and managing WhatsApp media files.
+ *
+ * Supports: images, videos, audio, voice notes, PDFs, documents,
+ *           contacts, locations, stickers.
+ *
+ * Every downloaded file is checksummed to detect corruption.
+ * Storage abstraction allows local filesystem, S3, MinIO, or R2.
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { createWriteStream, existsSync, mkdirSync, readFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { downloadContentFromMessage, extensionForMediaMessage, } from '@whiskeysockets/baileys';
+import { DatabaseManager } from '../database/index.js';
+// ─── Local Filesystem Storage ────────────────────────────────────────────────
+export class LocalStorageAdapter {
+    baseDir;
+    constructor(baseDir = './data/media') {
+        this.baseDir = baseDir;
+        if (!existsSync(baseDir)) {
+            mkdirSync(baseDir, { recursive: true });
+        }
+    }
+    async store(filePath, _mediaType, _mimeType) {
+        return filePath;
+    }
+    async retrieve(storageKey) {
+        const { createReadStream } = await import('node:fs');
+        return createReadStream(storageKey);
+    }
+    async delete(storageKey) {
+        if (existsSync(storageKey)) {
+            unlinkSync(storageKey);
+        }
+    }
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/** Extract a property from a Baileys IMessage which lacks an index signature. */
+function getMessageProp(content, key) {
+    return content?.[key];
+}
+function mapContentTypeToMediaType(contentType) {
+    switch (contentType) {
+        case 'imageMessage':
+            return 'image';
+        case 'videoMessage':
+            return 'video';
+        case 'audioMessage':
+            return 'audio';
+        case 'documentMessage':
+            return 'document';
+        case 'stickerMessage':
+            return 'sticker';
+        default:
+            return null;
+    }
+}
+function getMimeType(content, contentType) {
+    const msg = getMessageProp(content, contentType);
+    return msg?.mimetype || 'application/octet-stream';
+}
+function getFileName(content, contentType) {
+    const msg = getMessageProp(content, contentType);
+    return msg?.fileName || msg?.filename || undefined;
+}
+function getCaption(content, contentType) {
+    const msg = getMessageProp(content, contentType);
+    return msg?.caption || undefined;
+}
+function mediaMessageIdFor(msg, fallbackId) {
+    return msg.key?.id || `media_${fallbackId}`;
+}
+function messageTimestampMs(msg) {
+    const raw = msg.messageTimestamp;
+    const value = typeof raw === 'number'
+        ? raw
+        : raw && typeof raw.toNumber === 'function'
+            ? raw.toNumber()
+            : Date.now();
+    if (!Number.isFinite(value) || value <= 0)
+        return Date.now();
+    return value < 10_000_000_000 ? value * 1000 : value;
+}
+function safeRawMessageJson(msg) {
+    try {
+        return JSON.stringify(msg);
+    }
+    catch {
+        return '{}';
+    }
+}
+function ensureParentMessageForMedia(db, msg, messageId, contentType, content) {
+    if (!messageId || db.getMessage(messageId))
+        return;
+    db.insertMessage({
+        id: messageId,
+        remote_jid: msg.key?.remoteJid || '',
+        from_me: msg.key?.fromMe ? 1 : 0,
+        sender_jid: msg.key?.participant || null,
+        participant_jid: msg.key?.participant || null,
+        text_content: getCaption(content, contentType) || null,
+        message_type: contentType || 'unknown',
+        message_status: 'received',
+        raw_message: safeRawMessageJson(msg),
+        timestamp: messageTimestampMs(msg),
+    });
+}
+// ─── Media Service ───────────────────────────────────────────────────────────
+export class MediaService {
+    storage;
+    downloadDir;
+    constructor(storage, downloadDir) {
+        this.storage = storage || new LocalStorageAdapter();
+        this.downloadDir = downloadDir || './data/media';
+    }
+    /**
+     * Download media from a WhatsApp message.
+     * Imports content type detection inline to avoid protobuf type issues.
+     */
+    async downloadFromMessage(msg) {
+        const content = msg.message;
+        if (!content)
+            return null;
+        const contentRecord = content;
+        // Detect content type
+        const contentType = (() => {
+            for (const key of [
+                'imageMessage',
+                'videoMessage',
+                'audioMessage',
+                'documentMessage',
+                'stickerMessage',
+            ]) {
+                if (contentRecord[key])
+                    return key;
+            }
+            return null;
+        })();
+        if (!contentType)
+            return null;
+        const mediaType = mapContentTypeToMediaType(contentType);
+        if (!mediaType)
+            return null;
+        // Extract the downloadable message object
+        const downloadable = contentRecord[contentType];
+        if (!downloadable || (!downloadable.url && !downloadable.directPath)) {
+            return null;
+        }
+        const mediaId = randomUUID();
+        const ext = extensionForMediaMessage(content);
+        // extensionForMediaMessage returns without dot (e.g., 'ogg' not '.ogg')
+        const filePath = join(this.downloadDir, `${mediaId}.${ext}`);
+        try {
+            // Download content
+            const stream = await downloadContentFromMessage(downloadable, mediaType);
+            const hasher = createHash('sha256');
+            let fileSize = 0;
+            const writeStream = createWriteStream(filePath);
+            await pipeline(stream, async function* (source) {
+                for await (const chunk of source) {
+                    const buf = chunk;
+                    hasher.update(buf);
+                    fileSize += buf.length;
+                    yield buf;
+                }
+            }, writeStream);
+            const sha256 = hasher.digest('hex');
+            // Persist to database
+            const db = DatabaseManager.getInstance();
+            const messageId = mediaMessageIdFor(msg, mediaId);
+            ensureParentMessageForMedia(db, msg, messageId, contentType, contentRecord);
+            const mediaRow = {
+                id: mediaId,
+                message_id: messageId,
+                media_type: mediaType,
+                mime_type: getMimeType(contentRecord, contentType),
+                file_name: getFileName(contentRecord, contentType) || null,
+                file_size: fileSize,
+                file_path: filePath,
+                url: downloadable.url || null,
+                direct_path: downloadable.directPath || null,
+                media_key: downloadable.mediaKey
+                    ? Buffer.from(downloadable.mediaKey).toString('base64')
+                    : null,
+                caption: getCaption(contentRecord, contentType) || null,
+                downloaded: 1,
+            };
+            try {
+                db.insertMedia(mediaRow);
+            }
+            catch (dbErr) {
+                console.warn(`[MediaService] Media metadata insert failed for ${msg.key?.id || mediaId}:`, dbErr.message);
+            }
+            return {
+                mediaId,
+                filePath,
+                fileSize,
+                sha256,
+                mimeType: getMimeType(contentRecord, contentType),
+                fileName: getFileName(contentRecord, contentType),
+                mediaType,
+            };
+        }
+        catch (err) {
+            if (existsSync(filePath)) {
+                unlinkSync(filePath);
+            }
+            console.error(`[MediaService] Download failed for ${msg.key?.id}:`, err.message);
+            return null;
+        }
+    }
+    /**
+     * Verify a file's integrity by comparing checksums.
+     */
+    verifyIntegrity(filePath, expectedSha256) {
+        if (!existsSync(filePath))
+            return false;
+        const fileBuffer = readFileSync(filePath);
+        const actualSha256 = createHash('sha256').update(fileBuffer).digest('hex');
+        return actualSha256 === expectedSha256;
+    }
+    /**
+     * Get a previously downloaded media file path from the database.
+     */
+    getMediaForMessage(messageId) {
+        const db = DatabaseManager.getInstance();
+        const media = db.getMedia(messageId);
+        if (!media || !media.downloaded || !media.file_path)
+            return null;
+        if (!existsSync(media.file_path))
+            return null;
+        return media.file_path;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/media/service.js.map

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

package/dist/media/text-extractor.d.ts

@@ -0,0 +1,23 @@
+export type TextExtractionStatus = 'OK' | 'UNSUPPORTED' | 'TOO_LARGE' | 'READ_ERROR' | 'EMPTY' | 'INVALID_JSON';
+export interface TextExtractionInput {
+    filePath: string;
+    mimeType?: string | null;
+    fileName?: string | null;
+    maxBytes?: number;
+}
+export interface TextExtractionResult {
+    status: TextExtractionStatus;
+    text: string;
+    reason: string;
+    chars: number;
+    bytes: number;
+}
+export declare class SafeTextExtractor {
+    extract(input: TextExtractionInput): TextExtractionResult;
+    private extractJson;
+    private neutralizeCsv;
+    private neutralizeCsvCell;
+    private normalize;
+    private result;
+}
+//# sourceMappingURL=text-extractor.d.ts.map

package/dist/media/text-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-extractor.d.ts","sourceRoot":"","sources":["../../src/media/text-extractor.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,cAAc,CAAC;AAEhH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAOD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB;IAwBzD,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;CAGf"}