@serve.zone/dcrouter 11.12.4 → 11.14.0

package/dist_ts/cache/classes.cached.document.js

@@ -1,100 +0,0 @@
-import * as plugins from '../plugins.js';
-/**
- * Base class for all cached documents with TTL support
- *
- * Extends smartdata's SmartDataDbDoc to add:
- * - Automatic timestamps (createdAt, lastAccessedAt)
- * - TTL/expiration support (expiresAt)
- * - Helper methods for TTL management
- *
- * NOTE: Subclasses MUST add @svDb() decorators to createdAt, expiresAt, and lastAccessedAt
- * since decorators on abstract classes don't propagate correctly.
- */
-export class CachedDocument extends plugins.smartdata.SmartDataDbDoc {
-    /**
-     * Timestamp when the document was created
-     * NOTE: Subclasses must add @svDb() decorator
-     */
-    createdAt = new Date();
-    /**
-     * Timestamp when the document expires and should be cleaned up
-     * NOTE: Subclasses must add @svDb() decorator
-     */
-    expiresAt;
-    /**
-     * Timestamp of last access (for LRU-style eviction if needed)
-     * NOTE: Subclasses must add @svDb() decorator
-     */
-    lastAccessedAt = new Date();
-    /**
-     * Set the TTL (time to live) for this document
-     * @param ttlMs Time to live in milliseconds
-     */
-    setTTL(ttlMs) {
-        this.expiresAt = new Date(Date.now() + ttlMs);
-    }
-    /**
-     * Set TTL using days
-     * @param days Number of days until expiration
-     */
-    setTTLDays(days) {
-        this.setTTL(days * 24 * 60 * 60 * 1000);
-    }
-    /**
-     * Set TTL using hours
-     * @param hours Number of hours until expiration
-     */
-    setTTLHours(hours) {
-        this.setTTL(hours * 60 * 60 * 1000);
-    }
-    /**
-     * Check if this document has expired
-     */
-    isExpired() {
-        if (!this.expiresAt) {
-            return false; // No expiration set
-        }
-        return new Date() > this.expiresAt;
-    }
-    /**
-     * Update the lastAccessedAt timestamp
-     */
-    touch() {
-        this.lastAccessedAt = new Date();
-    }
-    /**
-     * Get remaining TTL in milliseconds
-     * Returns 0 if expired, -1 if no expiration set
-     */
-    getRemainingTTL() {
-        if (!this.expiresAt) {
-            return -1;
-        }
-        const remaining = this.expiresAt.getTime() - Date.now();
-        return remaining > 0 ? remaining : 0;
-    }
-    /**
-     * Extend the TTL by the specified milliseconds from now
-     * @param ttlMs Additional time to live in milliseconds
-     */
-    extendTTL(ttlMs) {
-        this.expiresAt = new Date(Date.now() + ttlMs);
-    }
-    /**
-     * Set the document to never expire (100 years in the future)
-     */
-    setNeverExpires() {
-        this.expiresAt = new Date(Date.now() + 100 * 365 * 24 * 60 * 60 * 1000);
-    }
-}
-/**
- * TTL constants in milliseconds
- */
-export const TTL = {
-    HOURS_1: 1 * 60 * 60 * 1000,
-    HOURS_24: 24 * 60 * 60 * 1000,
-    DAYS_7: 7 * 24 * 60 * 60 * 1000,
-    DAYS_30: 30 * 24 * 60 * 60 * 1000,
-    DAYS_90: 90 * 24 * 60 * 60 * 1000,
-};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jYWNoZWQuZG9jdW1lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9jYWNoZS9jbGFzc2VzLmNhY2hlZC5kb2N1bWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUV6Qzs7Ozs7Ozs7OztHQVVHO0FBQ0gsTUFBTSxPQUFnQixjQUE0QyxTQUFRLE9BQU8sQ0FBQyxTQUFTLENBQUMsY0FBb0I7SUFDOUc7OztPQUdHO0lBQ0ksU0FBUyxHQUFTLElBQUksSUFBSSxFQUFFLENBQUM7SUFFcEM7OztPQUdHO0lBQ0ksU0FBUyxDQUFRO0lBRXhCOzs7T0FHRztJQUNJLGNBQWMsR0FBUyxJQUFJLElBQUksRUFBRSxDQUFDO0lBRXpDOzs7T0FHRztJQUNJLE1BQU0sQ0FBQyxLQUFhO1FBQ3pCLElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBSSxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxHQUFHLEtBQUssQ0FBQyxDQUFDO0lBQ2hELENBQUM7SUFFRDs7O09BR0c7SUFDSSxVQUFVLENBQUMsSUFBWTtRQUM1QixJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUMxQyxDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksV0FBVyxDQUFDLEtBQWE7UUFDOUIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUN0QyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxTQUFTO1FBQ2QsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNwQixPQUFPLEtBQUssQ0FBQyxDQUFDLG9CQUFvQjtRQUNwQyxDQUFDO1FBQ0QsT0FBTyxJQUFJLElBQUksRUFBRSxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUM7SUFDckMsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSztRQUNWLElBQUksQ0FBQyxjQUFjLEdBQUcsSUFBSSxJQUFJLEVBQUUsQ0FBQztJQUNuQyxDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksZUFBZTtRQUNwQixJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ3BCLE9BQU8sQ0FBQyxDQUFDLENBQUM7UUFDWixDQUFDO1FBQ0QsTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLEVBQUUsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDeEQsT0FBTyxTQUFTLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUN2QyxDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksU0FBUyxDQUFDLEtBQWE7UUFDNUIsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLEdBQUcsS0FBSyxDQUFDLENBQUM7SUFDaEQsQ0FBQztJQUVEOztPQUVHO0lBQ0ksZUFBZTtRQUNwQixJQUFJLENBQUMsU0FBUyxHQUFHLElBQUksSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxHQUFHLEdBQUcsR0FBRyxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQzFFLENBQUM7Q0FDRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sR0FBRyxHQUFHO0lBQ2pCLE9BQU8sRUFBRSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJO0lBQzNCLFFBQVEsRUFBRSxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJO0lBQzdCLE1BQU0sRUFBRSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsSUFBSTtJQUMvQixPQUFPLEVBQUUsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUk7SUFDakMsT0FBTyxFQUFFLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJO0NBQ3pCLENBQUMifQ==

package/dist_ts/cache/classes.cachedb.d.ts

@@ -1,60 +0,0 @@
-import * as plugins from '../plugins.js';
-/**
- * Configuration options for CacheDb
- */
-export interface ICacheDbOptions {
-    /** Base storage path for TsmDB data (default: ~/.serve.zone/dcrouter/tsmdb) */
-    storagePath?: string;
-    /** Database name (default: dcrouter) */
-    dbName?: string;
-    /** Enable debug logging */
-    debug?: boolean;
-}
-/**
- * CacheDb - Wrapper around LocalSmartDb and smartdata
- *
- * Provides persistent caching using smartdata as the ORM layer
- * and LocalSmartDb as the embedded database engine.
- */
-export declare class CacheDb {
-    private static instance;
-    private localSmartDb;
-    private smartdataDb;
-    private options;
-    private isStarted;
-    constructor(options?: ICacheDbOptions);
-    /**
-     * Get or create the singleton instance
-     */
-    static getInstance(options?: ICacheDbOptions): CacheDb;
-    /**
-     * Reset the singleton instance (useful for testing)
-     */
-    static resetInstance(): void;
-    /**
-     * Start the cache database
-     * - Initializes LocalSmartDb with file persistence
-     * - Connects smartdata to the LocalSmartDb via Unix socket
-     */
-    start(): Promise<void>;
-    /**
-     * Stop the cache database
-     */
-    stop(): Promise<void>;
-    /**
-     * Get the smartdata database instance
-     */
-    getDb(): plugins.smartdata.SmartdataDb;
-    /**
-     * Check if the database is ready
-     */
-    isReady(): boolean;
-    /**
-     * Get the storage path
-     */
-    getStoragePath(): string;
-    /**
-     * Get the database name
-     */
-    getDbName(): string;
-}

package/dist_ts/cache/classes.cachedb.js

@@ -1,126 +0,0 @@
-import * as plugins from '../plugins.js';
-import { logger } from '../logger.js';
-import { defaultTsmDbPath } from '../paths.js';
-/**
- * CacheDb - Wrapper around LocalSmartDb and smartdata
- *
- * Provides persistent caching using smartdata as the ORM layer
- * and LocalSmartDb as the embedded database engine.
- */
-export class CacheDb {
-    static instance = null;
-    localSmartDb;
-    smartdataDb;
-    options;
-    isStarted = false;
-    constructor(options = {}) {
-        this.options = {
-            storagePath: options.storagePath || defaultTsmDbPath,
-            dbName: options.dbName || 'dcrouter',
-            debug: options.debug || false,
-        };
-    }
-    /**
-     * Get or create the singleton instance
-     */
-    static getInstance(options) {
-        if (!CacheDb.instance) {
-            CacheDb.instance = new CacheDb(options);
-        }
-        return CacheDb.instance;
-    }
-    /**
-     * Reset the singleton instance (useful for testing)
-     */
-    static resetInstance() {
-        CacheDb.instance = null;
-    }
-    /**
-     * Start the cache database
-     * - Initializes LocalSmartDb with file persistence
-     * - Connects smartdata to the LocalSmartDb via Unix socket
-     */
-    async start() {
-        if (this.isStarted) {
-            logger.log('warn', 'CacheDb already started');
-            return;
-        }
-        try {
-            // Ensure storage directory exists
-            await plugins.fsUtils.ensureDir(this.options.storagePath);
-            // Create LocalSmartDb instance
-            this.localSmartDb = new plugins.smartdb.LocalSmartDb({
-                folderPath: this.options.storagePath,
-            });
-            // Start LocalSmartDb and get connection info
-            const connectionInfo = await this.localSmartDb.start();
-            if (this.options.debug) {
-                logger.log('debug', `LocalSmartDb started with URI: ${connectionInfo.connectionUri}`);
-            }
-            // Initialize smartdata with the connection URI
-            this.smartdataDb = new plugins.smartdata.SmartdataDb({
-                mongoDbUrl: connectionInfo.connectionUri,
-                mongoDbName: this.options.dbName,
-            });
-            await this.smartdataDb.init();
-            this.isStarted = true;
-            logger.log('info', `CacheDb started at ${this.options.storagePath}`);
-        }
-        catch (error) {
-            logger.log('error', `Failed to start CacheDb: ${error.message}`);
-            throw error;
-        }
-    }
-    /**
-     * Stop the cache database
-     */
-    async stop() {
-        if (!this.isStarted) {
-            return;
-        }
-        try {
-            // Close smartdata connection
-            if (this.smartdataDb) {
-                await this.smartdataDb.close();
-            }
-            // Stop LocalSmartDb
-            if (this.localSmartDb) {
-                await this.localSmartDb.stop();
-            }
-            this.isStarted = false;
-            logger.log('info', 'CacheDb stopped');
-        }
-        catch (error) {
-            logger.log('error', `Error stopping CacheDb: ${error.message}`);
-            throw error;
-        }
-    }
-    /**
-     * Get the smartdata database instance
-     */
-    getDb() {
-        if (!this.isStarted) {
-            throw new Error('CacheDb not started. Call start() first.');
-        }
-        return this.smartdataDb;
-    }
-    /**
-     * Check if the database is ready
-     */
-    isReady() {
-        return this.isStarted;
-    }
-    /**
-     * Get the storage path
-     */
-    getStoragePath() {
-        return this.options.storagePath;
-    }
-    /**
-     * Get the database name
-     */
-    getDbName() {
-        return this.options.dbName;
-    }
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jYWNoZWRiLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvY2FjaGUvY2xhc3Nlcy5jYWNoZWRiLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sZUFBZSxDQUFDO0FBQ3pDLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDdEMsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBYy9DOzs7OztHQUtHO0FBQ0gsTUFBTSxPQUFPLE9BQU87SUFDVixNQUFNLENBQUMsUUFBUSxHQUFtQixJQUFJLENBQUM7SUFFdkMsWUFBWSxDQUFnQztJQUM1QyxXQUFXLENBQWlDO0lBQzVDLE9BQU8sQ0FBNEI7SUFDbkMsU0FBUyxHQUFZLEtBQUssQ0FBQztJQUVuQyxZQUFZLFVBQTJCLEVBQUU7UUFDdkMsSUFBSSxDQUFDLE9BQU8sR0FBRztZQUNiLFdBQVcsRUFBRSxPQUFPLENBQUMsV0FBVyxJQUFJLGdCQUFnQjtZQUNwRCxNQUFNLEVBQUUsT0FBTyxDQUFDLE1BQU0sSUFBSSxVQUFVO1lBQ3BDLEtBQUssRUFBRSxPQUFPLENBQUMsS0FBSyxJQUFJLEtBQUs7U0FDOUIsQ0FBQztJQUNKLENBQUM7SUFFRDs7T0FFRztJQUNJLE1BQU0sQ0FBQyxXQUFXLENBQUMsT0FBeUI7UUFDakQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUN0QixPQUFPLENBQUMsUUFBUSxHQUFHLElBQUksT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQzFDLENBQUM7UUFDRCxPQUFPLE9BQU8sQ0FBQyxRQUFRLENBQUM7SUFDMUIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksTUFBTSxDQUFDLGFBQWE7UUFDekIsT0FBTyxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUM7SUFDMUIsQ0FBQztJQUVEOzs7O09BSUc7SUFDSSxLQUFLLENBQUMsS0FBSztRQUNoQixJQUFJLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNuQixNQUFNLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRSx5QkFBeUIsQ0FBQyxDQUFDO1lBQzlDLE9BQU87UUFDVCxDQUFDO1FBRUQsSUFBSSxDQUFDO1lBQ0gsa0NBQWtDO1lBQ2xDLE1BQU0sT0FBTyxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxXQUFXLENBQUMsQ0FBQztZQUUxRCwrQkFBK0I7WUFDL0IsSUFBSSxDQUFDLFlBQVksR0FBRyxJQUFJLE9BQU8sQ0FBQyxPQUFPLENBQUMsWUFBWSxDQUFDO2dCQUNuRCxVQUFVLEVBQUUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxXQUFXO2FBQ3JDLENBQUMsQ0FBQztZQUVILDZDQUE2QztZQUM3QyxNQUFNLGNBQWMsR0FBRyxNQUFNLElBQUksQ0FBQyxZQUFZLENBQUMsS0FBSyxFQUFFLENBQUM7WUFFdkQsSUFBSSxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssRUFBRSxDQUFDO2dCQUN2QixNQUFNLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxrQ0FBa0MsY0FBYyxDQUFDLGFBQWEsRUFBRSxDQUFDLENBQUM7WUFDeEYsQ0FBQztZQUVELCtDQUErQztZQUMvQyxJQUFJLENBQUMsV0FBVyxHQUFHLElBQUksT0FBTyxDQUFDLFNBQVMsQ0FBQyxXQUFXLENBQUM7Z0JBQ25ELFVBQVUsRUFBRSxjQUFjLENBQUMsYUFBYTtnQkFDeEMsV0FBVyxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTTthQUNqQyxDQUFDLENBQUM7WUFDSCxNQUFNLElBQUksQ0FBQyxXQUFXLENBQUMsSUFBSSxFQUFFLENBQUM7WUFFOUIsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUM7WUFDdEIsTUFBTSxDQUFDLEdBQUcsQ0FBQyxNQUFNLEVBQUUsc0JBQXNCLElBQUksQ0FBQyxPQUFPLENBQUMsV0FBVyxFQUFFLENBQUMsQ0FBQztRQUN2RSxDQUFDO1FBQUMsT0FBTyxLQUFjLEVBQUUsQ0FBQztZQUN4QixNQUFNLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSw0QkFBNkIsS0FBZSxDQUFDLE9BQU8sRUFBRSxDQUFDLENBQUM7WUFDNUUsTUFBTSxLQUFLLENBQUM7UUFDZCxDQUFDO0lBQ0gsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSyxDQUFDLElBQUk7UUFDZixJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ3BCLE9BQU87UUFDVCxDQUFDO1FBRUQsSUFBSSxDQUFDO1lBQ0gsNkJBQTZCO1lBQzdCLElBQUksSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDO2dCQUNyQixNQUFNLElBQUksQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDakMsQ0FBQztZQUVELG9CQUFvQjtZQUNwQixJQUFJLElBQUksQ0FBQyxZQUFZLEVBQUUsQ0FBQztnQkFDdEIsTUFBTSxJQUFJLENBQUMsWUFBWSxDQUFDLElBQUksRUFBRSxDQUFDO1lBQ2pDLENBQUM7WUFFRCxJQUFJLENBQUMsU0FBUyxHQUFHLEtBQUssQ0FBQztZQUN2QixNQUFNLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRSxpQkFBaUIsQ0FBQyxDQUFDO1FBQ3hDLENBQUM7UUFBQyxPQUFPLEtBQWMsRUFBRSxDQUFDO1lBQ3hCLE1BQU0sQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLDJCQUE0QixLQUFlLENBQUMsT0FBTyxFQUFFLENBQUMsQ0FBQztZQUMzRSxNQUFNLEtBQUssQ0FBQztRQUNkLENBQUM7SUFDSCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLO1FBQ1YsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNwQixNQUFNLElBQUksS0FBSyxDQUFDLDBDQUEwQyxDQUFDLENBQUM7UUFDOUQsQ0FBQztRQUNELE9BQU8sSUFBSSxDQUFDLFdBQVcsQ0FBQztJQUMxQixDQUFDO0lBRUQ7O09BRUc7SUFDSSxPQUFPO1FBQ1osT0FBTyxJQUFJLENBQUMsU0FBUyxDQUFDO0lBQ3hCLENBQUM7SUFFRDs7T0FFRztJQUNJLGNBQWM7UUFDbkIsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLFdBQVcsQ0FBQztJQUNsQyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxTQUFTO1FBQ2QsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQztJQUM3QixDQUFDIn0=

package/dist_ts/cache/documents/classes.cached.email.d.ts

@@ -1,125 +0,0 @@
-import { CachedDocument } from '../classes.cached.document.js';
-/**
- * Email status in the cache
- */
-export type TCachedEmailStatus = 'pending' | 'processing' | 'delivered' | 'failed' | 'deferred';
-/**
- * CachedEmail - Stores email queue items in the cache
- *
- * Used for persistent email queue storage, tracking delivery status,
- * and maintaining email history for the configured TTL period.
- */
-export declare class CachedEmail extends CachedDocument<CachedEmail> {
-    createdAt: Date;
-    expiresAt: Date;
-    lastAccessedAt: Date;
-    /**
-     * Unique identifier for this email
-     */
-    id: string;
-    /**
-     * Email message ID (RFC 822 Message-ID header)
-     */
-    messageId: string;
-    /**
-     * Sender email address (envelope from)
-     */
-    from: string;
-    /**
-     * Recipient email addresses
-     */
-    to: string[];
-    /**
-     * CC recipients
-     */
-    cc: string[];
-    /**
-     * BCC recipients
-     */
-    bcc: string[];
-    /**
-     * Email subject
-     */
-    subject: string;
-    /**
-     * Raw RFC822 email content
-     */
-    rawContent: string;
-    /**
-     * Current status of the email
-     */
-    status: TCachedEmailStatus;
-    /**
-     * Number of delivery attempts
-     */
-    attempts: number;
-    /**
-     * Maximum number of delivery attempts
-     */
-    maxAttempts: number;
-    /**
-     * Timestamp for next delivery attempt
-     */
-    nextAttempt: Date;
-    /**
-     * Last error message if delivery failed
-     */
-    lastError: string;
-    /**
-     * Timestamp when the email was successfully delivered
-     */
-    deliveredAt: Date;
-    /**
-     * Sender domain (for querying/filtering)
-     */
-    senderDomain: string;
-    /**
-     * Priority level (higher = more important)
-     */
-    priority: number;
-    /**
-     * JSON-serialized route data
-     */
-    routeData: string;
-    /**
-     * DKIM signature status
-     */
-    dkimSigned: boolean;
-    constructor();
-    /**
-     * Create a new CachedEmail with a unique ID
-     */
-    static createNew(): CachedEmail;
-    /**
-     * Find an email by ID
-     */
-    static findById(id: string): Promise<CachedEmail | null>;
-    /**
-     * Find all emails with a specific status
-     */
-    static findByStatus(status: TCachedEmailStatus): Promise<CachedEmail[]>;
-    /**
-     * Find all emails pending delivery (status = pending and nextAttempt <= now)
-     */
-    static findPendingForDelivery(): Promise<CachedEmail[]>;
-    /**
-     * Find emails by sender domain
-     */
-    static findBySenderDomain(domain: string): Promise<CachedEmail[]>;
-    /**
-     * Mark as delivered
-     */
-    markDelivered(): void;
-    /**
-     * Mark as failed with error
-     */
-    markFailed(error: string): void;
-    /**
-     * Increment attempt counter and schedule next attempt
-     */
-    scheduleRetry(delayMs?: number): void;
-    /**
-     * Extract sender domain from email address
-     */
-    updateSenderDomain(): void;
-}