@serve.zone/dcrouter 11.0.31 → 11.0.33

package/dist_serve/bundle.js

@@ -39328,4 +39328,4 @@ ibantools/jsnext/ibantools.js:
    * @preferred
    *)
 */
-//# sourceMappingURL=bundle-1772722185785.js.map
+//# sourceMappingURL=bundle-1772722607518.js.map

package/dist_ts/00_commitinfo_data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export declare const commitinfo: {
+    name: string;
+    version: string;
+    description: string;
+};

package/dist_ts/00_commitinfo_data.js

@@ -0,0 +1,9 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+    name: '@serve.zone/dcrouter',
+    version: '11.0.33',
+    description: 'A multifaceted routing service handling mail and SMS delivery functions.'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxzQkFBc0I7SUFDNUIsT0FBTyxFQUFFLFNBQVM7SUFDbEIsV0FBVyxFQUFFLDBFQUEwRTtDQUN4RixDQUFBIn0=

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

@@ -0,0 +1,47 @@
+import { CacheDb } from './classes.cachedb.js';
+/**
+ * Configuration for the cache cleaner
+ */
+export interface ICacheCleanerOptions {
+    /** Cleanup interval in milliseconds (default: 1 hour) */
+    intervalMs?: number;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * CacheCleaner - Periodically removes expired documents from the cache
+ *
+ * Runs on a configurable interval (default: hourly) and queries each
+ * collection for documents where expiresAt < now(), then deletes them.
+ */
+export declare class CacheCleaner {
+    private cleanupInterval;
+    private isRunning;
+    private options;
+    private cacheDb;
+    constructor(cacheDb: CacheDb, options?: ICacheCleanerOptions);
+    /**
+     * Start the periodic cleanup process
+     */
+    start(): void;
+    /**
+     * Stop the periodic cleanup process
+     */
+    stop(): void;
+    /**
+     * Run a single cleanup cycle
+     */
+    runCleanup(): Promise<void>;
+    /**
+     * Clean expired documents from a specific collection using smartdata API
+     */
+    private cleanExpiredDocuments;
+    /**
+     * Check if the cleaner is running
+     */
+    isActive(): boolean;
+    /**
+     * Get the cleanup interval in milliseconds
+     */
+    getIntervalMs(): number;
+}

package/dist_ts/cache/classes.cache.cleaner.js

@@ -0,0 +1,130 @@
+import * as plugins from '../plugins.js';
+import { logger } from '../logger.js';
+import { CacheDb } from './classes.cachedb.js';
+// Import document classes for cleanup
+import { CachedEmail } from './documents/classes.cached.email.js';
+import { CachedIPReputation } from './documents/classes.cached.ip.reputation.js';
+/**
+ * CacheCleaner - Periodically removes expired documents from the cache
+ *
+ * Runs on a configurable interval (default: hourly) and queries each
+ * collection for documents where expiresAt < now(), then deletes them.
+ */
+export class CacheCleaner {
+    cleanupInterval = null;
+    isRunning = false;
+    options;
+    cacheDb;
+    constructor(cacheDb, options = {}) {
+        this.cacheDb = cacheDb;
+        this.options = {
+            intervalMs: options.intervalMs || 60 * 60 * 1000, // 1 hour default
+            verbose: options.verbose || false,
+        };
+    }
+    /**
+     * Start the periodic cleanup process
+     */
+    start() {
+        if (this.isRunning) {
+            logger.log('warn', 'CacheCleaner already running');
+            return;
+        }
+        this.isRunning = true;
+        // Run cleanup immediately on start
+        this.runCleanup().catch((error) => {
+            logger.log('error', `Initial cache cleanup failed: ${error.message}`);
+        });
+        // Schedule periodic cleanup
+        this.cleanupInterval = setInterval(() => {
+            this.runCleanup().catch((error) => {
+                logger.log('error', `Cache cleanup failed: ${error.message}`);
+            });
+        }, this.options.intervalMs);
+        logger.log('info', `CacheCleaner started with interval: ${this.options.intervalMs / 1000 / 60} minutes`);
+    }
+    /**
+     * Stop the periodic cleanup process
+     */
+    stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.isRunning = false;
+        logger.log('info', 'CacheCleaner stopped');
+    }
+    /**
+     * Run a single cleanup cycle
+     */
+    async runCleanup() {
+        if (!this.cacheDb.isReady()) {
+            logger.log('warn', 'CacheDb not ready, skipping cleanup');
+            return;
+        }
+        const now = new Date();
+        const results = [];
+        try {
+            const emailsDeleted = await this.cleanExpiredDocuments(CachedEmail, now);
+            results.push({ collection: 'CachedEmail', deleted: emailsDeleted });
+            const ipReputationDeleted = await this.cleanExpiredDocuments(CachedIPReputation, now);
+            results.push({ collection: 'CachedIPReputation', deleted: ipReputationDeleted });
+            // Log results
+            const totalDeleted = results.reduce((sum, r) => sum + r.deleted, 0);
+            if (totalDeleted > 0 || this.options.verbose) {
+                const summary = results
+                    .filter((r) => r.deleted > 0)
+                    .map((r) => `${r.collection}: ${r.deleted}`)
+                    .join(', ');
+                logger.log('info', `Cache cleanup completed. Deleted ${totalDeleted} expired documents. ${summary || 'No deletions.'}`);
+            }
+        }
+        catch (error) {
+            logger.log('error', `Cache cleanup error: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Clean expired documents from a specific collection using smartdata API
+     */
+    async cleanExpiredDocuments(documentClass, now) {
+        try {
+            // Find all expired documents
+            const expiredDocs = await documentClass.getInstances({
+                expiresAt: { $lt: now },
+            });
+            // Delete each expired document
+            let deletedCount = 0;
+            for (const doc of expiredDocs) {
+                try {
+                    await doc.delete();
+                    deletedCount++;
+                }
+                catch (deleteError) {
+                    logger.log('warn', `Failed to delete expired document: ${deleteError.message}`);
+                }
+            }
+            return deletedCount;
+        }
+        catch (error) {
+            logger.log('error', `Error cleaning collection: ${error.message}`);
+            return 0;
+        }
+    }
+    /**
+     * Check if the cleaner is running
+     */
+    isActive() {
+        return this.isRunning;
+    }
+    /**
+     * Get the cleanup interval in milliseconds
+     */
+    getIntervalMs() {
+        return this.options.intervalMs;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jYWNoZS5jbGVhbmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvY2FjaGUvY2xhc3Nlcy5jYWNoZS5jbGVhbmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sZUFBZSxDQUFDO0FBQ3pDLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDdEMsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBRS9DLHNDQUFzQztBQUN0QyxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFDbEUsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sNkNBQTZDLENBQUM7QUFZakY7Ozs7O0dBS0c7QUFDSCxNQUFNLE9BQU8sWUFBWTtJQUNmLGVBQWUsR0FBMEMsSUFBSSxDQUFDO0lBQzlELFNBQVMsR0FBWSxLQUFLLENBQUM7SUFDM0IsT0FBTyxDQUFpQztJQUN4QyxPQUFPLENBQVU7SUFFekIsWUFBWSxPQUFnQixFQUFFLFVBQWdDLEVBQUU7UUFDOUQsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUM7UUFDdkIsSUFBSSxDQUFDLE9BQU8sR0FBRztZQUNiLFVBQVUsRUFBRSxPQUFPLENBQUMsVUFBVSxJQUFJLEVBQUUsR0FBRyxFQUFFLEdBQUcsSUFBSSxFQUFFLGlCQUFpQjtZQUNuRSxPQUFPLEVBQUUsT0FBTyxDQUFDLE9BQU8sSUFBSSxLQUFLO1NBQ2xDLENBQUM7SUFDSixDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLO1FBQ1YsSUFBSSxJQUFJLENBQUMsU0FBUyxFQUFFLENBQUM7WUFDbkIsTUFBTSxDQUFDLEdBQUcsQ0FBQyxNQUFNLEVBQUUsOEJBQThCLENBQUMsQ0FBQztZQUNuRCxPQUFPO1FBQ1QsQ0FBQztRQUVELElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBSSxDQUFDO1FBRXRCLG1DQUFtQztRQUNuQyxJQUFJ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

package/dist_ts/cache/classes.cached.document.d.ts

@@ -0,0 +1,76 @@
+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 declare abstract class CachedDocument<T extends CachedDocument<T>> extends plugins.smartdata.SmartDataDbDoc<T, T> {
+    /**
+     * Timestamp when the document was created
+     * NOTE: Subclasses must add @svDb() decorator
+     */
+    createdAt: Date;
+    /**
+     * Timestamp when the document expires and should be cleaned up
+     * NOTE: Subclasses must add @svDb() decorator
+     */
+    expiresAt: Date;
+    /**
+     * Timestamp of last access (for LRU-style eviction if needed)
+     * NOTE: Subclasses must add @svDb() decorator
+     */
+    lastAccessedAt: Date;
+    /**
+     * Set the TTL (time to live) for this document
+     * @param ttlMs Time to live in milliseconds
+     */
+    setTTL(ttlMs: number): void;
+    /**
+     * Set TTL using days
+     * @param days Number of days until expiration
+     */
+    setTTLDays(days: number): void;
+    /**
+     * Set TTL using hours
+     * @param hours Number of hours until expiration
+     */
+    setTTLHours(hours: number): void;
+    /**
+     * Check if this document has expired
+     */
+    isExpired(): boolean;
+    /**
+     * Update the lastAccessedAt timestamp
+     */
+    touch(): void;
+    /**
+     * Get remaining TTL in milliseconds
+     * Returns 0 if expired, -1 if no expiration set
+     */
+    getRemainingTTL(): number;
+    /**
+     * Extend the TTL by the specified milliseconds from now
+     * @param ttlMs Additional time to live in milliseconds
+     */
+    extendTTL(ttlMs: number): void;
+    /**
+     * Set the document to never expire (100 years in the future)
+     */
+    setNeverExpires(): void;
+}
+/**
+ * TTL constants in milliseconds
+ */
+export declare const TTL: {
+    readonly HOURS_1: number;
+    readonly HOURS_24: number;
+    readonly DAYS_7: number;
+    readonly DAYS_30: number;
+    readonly DAYS_90: number;
+};

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

@@ -0,0 +1,100 @@
+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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jYWNoZWQuZG9jdW1lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9jYWNoZS9jbGFzc2VzLmNhY2hlZC5kb2N1bWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUV6Qzs7Ozs7Ozs7OztHQVVHO0FBQ0gsTUFBTSxPQUFnQixjQUE0QyxTQUFRLE9BQU8sQ0FBQyxTQUFTLENBQUMsY0FBb0I7SUFDOUc7OztPQUdHO0lBQ0ksU0FBUyxHQUFTLElBQUksSUFBSSxFQUFFLENBQUM7SUFFcEM7OztPQUdHO0lBQ0ksU0FBUyxDQUFPO0lBRXZCOzs7T0FHRztJQUNJLGNBQWMsR0FBUyxJQUFJLElBQUksRUFBRSxDQUFDO0lBRXpDOzs7T0FHRztJQUNJLE1BQU0sQ0FBQyxLQUFhO1FBQ3pCLElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBSSxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxHQUFHLEtBQUssQ0FBQyxDQUFDO0lBQ2hELENBQUM7SUFFRDs7O09BR0c7SUFDSSxVQUFVLENBQUMsSUFBWTtRQUM1QixJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUMxQyxDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksV0FBVyxDQUFDLEtBQWE7UUFDOUIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUN0QyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxTQUFTO1FBQ2QsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNwQixPQUFPLEtBQUssQ0FBQyxDQUFDLG9CQUFvQjtRQUNwQyxDQUFDO1FBQ0QsT0FBTyxJQUFJLElBQUksRUFBRSxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUM7SUFDckMsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSztRQUNWLElBQUksQ0FBQyxjQUFjLEdBQUcsSUFBSSxJQUFJLEVBQUUsQ0FBQztJQUNuQyxDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksZUFBZTtRQUNwQixJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ3BCLE9BQU8sQ0FBQyxDQUFDLENBQUM7UUFDWixDQUFDO1FBQ0QsTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLEVBQUUsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDeEQsT0FBTyxTQUFTLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUN2QyxDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksU0FBUyxDQUFDLEtBQWE7UUFDNUIsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLEdBQUcsS0FBSyxDQUFDLENBQUM7SUFDaEQsQ0FBQztJQUVEOztPQUVHO0lBQ0ksZUFBZTtRQUNwQixJQUFJLENBQUMsU0FBUyxHQUFHLElBQUksSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxHQUFHLEdBQUcsR0FBRyxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQzFFLENBQUM7Q0FDRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sR0FBRyxHQUFHO0lBQ2pCLE9BQU8sRUFBRSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJO0lBQzNCLFFBQVEsRUFBRSxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJO0lBQzdCLE1BQU0sRUFBRSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsSUFBSTtJQUMvQixPQUFPLEVBQUUsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUk7SUFDakMsT0FBTyxFQUFFLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxJQUFJO0NBQ3pCLENBQUMifQ==

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

@@ -0,0 +1,60 @@
+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 LocalTsmDb and smartdata
+ *
+ * Provides persistent caching using smartdata as the ORM layer
+ * and LocalTsmDb as the embedded database engine.
+ */
+export declare class CacheDb {
+    private static instance;
+    private localTsmDb;
+    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 LocalTsmDb with file persistence
+     * - Connects smartdata to the LocalTsmDb 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

@@ -0,0 +1,126 @@
+import * as plugins from '../plugins.js';
+import { logger } from '../logger.js';
+import { defaultTsmDbPath } from '../paths.js';
+/**
+ * CacheDb - Wrapper around LocalTsmDb and smartdata
+ *
+ * Provides persistent caching using smartdata as the ORM layer
+ * and LocalTsmDb as the embedded database engine.
+ */
+export class CacheDb {
+    static instance = null;
+    localTsmDb;
+    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 LocalTsmDb with file persistence
+     * - Connects smartdata to the LocalTsmDb 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 LocalTsmDb instance
+            this.localTsmDb = new plugins.smartmongo.LocalTsmDb({
+                folderPath: this.options.storagePath,
+            });
+            // Start LocalTsmDb and get connection info
+            const connectionInfo = await this.localTsmDb.start();
+            if (this.options.debug) {
+                logger.log('debug', `LocalTsmDb 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 LocalTsmDb
+            if (this.localTsmDb) {
+                await this.localTsmDb.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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jYWNoZWRiLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvY2FjaGUvY2xhc3Nlcy5jYWNoZWRiLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sZUFBZSxDQUFDO0FBQ3pDLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDdEMsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBYy9DOzs7OztHQUtHO0FBQ0gsTUFBTSxPQUFPLE9BQU87SUFDVixNQUFNLENBQUMsUUFBUSxHQUFtQixJQUFJLENBQUM7SUFFdkMsVUFBVSxDQUFnQztJQUMxQyxXQUFXLENBQWdDO0lBQzNDLE9BQU8sQ0FBNEI7SUFDbkMsU0FBUyxHQUFZLEtBQUssQ0FBQztJQUVuQyxZQUFZLFVBQTJCLEVBQUU7UUFDdkMsSUFBSSxDQUFDLE9BQU8sR0FBRztZQUNiLFdBQVcsRUFBRSxPQUFPLENBQUMsV0FBVyxJQUFJLGdCQUFnQjtZQUNwRCxNQUFNLEVBQUUsT0FBTyxDQUFDLE1BQU0sSUFBSSxVQUFVO1lBQ3BDLEtBQUssRUFBRSxPQUFPLENBQUMsS0FBSyxJQUFJLEtBQUs7U0FDOUIsQ0FBQztJQUNKLENBQUM7SUFFRDs7T0FFRztJQUNJLE1BQU0sQ0FBQyxXQUFXLENBQUMsT0FBeUI7UUFDakQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUN0QixPQUFPLENBQUMsUUFBUSxHQUFHLElBQUksT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQzFDLENBQUM7UUFDRCxPQUFPLE9BQU8sQ0FBQyxRQUFRLENBQUM7SUFDMUIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksTUFBTSxDQUFDLGFBQWE7UUFDekIsT0FBTyxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUM7SUFDMUIsQ0FBQztJQUVEOzs7O09BSUc7SUFDSSxLQUFLLENBQUMsS0FBSztRQUNoQixJQUFJLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNuQixNQUFNLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRSx5QkFBeUIsQ0FBQyxDQUFDO1lBQzlDLE9BQU87UUFDVCxDQUFDO1FBRUQsSUFBSSxDQUFDO1lBQ0gsa0NBQWtDO1lBQ2xDLE1BQU0sT0FBTyxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxXQUFXLENBQUMsQ0FBQztZQUUxRCw2QkFBNkI7WUFDN0IsSUFBSSxDQUFDLFVBQVUsR0FBRyxJQUFJLE9BQU8sQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDO2dCQUNsRCxVQUFVLEVBQUUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxXQUFXO2FBQ3JDLENBQUMsQ0FBQztZQUVILDJDQUEyQztZQUMzQyxNQUFNLGNBQWMsR0FBRyxNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsS0FBSyxFQUFFLENBQUM7WUFFckQsSUFBSSxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssRUFBRSxDQUFDO2dCQUN2QixNQUFNLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxnQ0FBZ0MsY0FBYyxDQUFDLGFBQWEsRUFBRSxDQUFDLENBQUM7WUFDdEYsQ0FBQztZQUVELCtDQUErQztZQUMvQyxJQUFJLENBQUMsV0FBVyxHQUFHLElBQUksT0FBTyxDQUFDLFNBQVMsQ0FBQyxXQUFXLENBQUM7Z0JBQ25ELFVBQVUsRUFBRSxjQUFjLENBQUMsYUFBYTtnQkFDeEMsV0FBVyxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTTthQUNqQyxDQUFDLENBQUM7WUFDSCxNQUFNLElBQUksQ0FBQyxXQUFXLENBQUMsSUFBSSxFQUFFLENBQUM7WUFFOUIsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUM7WUFDdEIsTUFBTSxDQUFDLEdBQUcsQ0FBQyxNQUFNLEVBQUUsc0JBQXNCLElBQUksQ0FBQyxPQUFPLENBQUMsV0FBVyxFQUFFLENBQUMsQ0FBQztRQUN2RSxDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLE1BQU0sQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLDRCQUE0QixLQUFLLENBQUMsT0FBTyxFQUFFLENBQUMsQ0FBQztZQUNqRSxNQUFNLEtBQUssQ0FBQztRQUNkLENBQUM7SUFDSCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsSUFBSTtRQUNmLElBQUksQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLENBQUM7WUFDcEIsT0FBTztRQUNULENBQUM7UUFFRCxJQUFJLENBQUM7WUFDSCw2QkFBNkI7WUFDN0IsSUFBSSxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7Z0JBQ3JCLE1BQU0sSUFBSSxDQUFDLFdBQVcsQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNqQyxDQUFDO1lBRUQsa0JBQWtCO1lBQ2xCLElBQUksSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFDO2dCQUNwQixNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDL0IsQ0FBQztZQUVELElBQUksQ0FBQyxTQUFTLEdBQUcsS0FBSyxDQUFDO1lBQ3ZCLE1BQU0sQ0FBQyxHQUFHLENBQUMsTUFBTSxFQUFFLGlCQUFpQixDQUFDLENBQUM7UUFDeEMsQ0FBQztRQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7WUFDZixNQUFNLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSwyQkFBMkIsS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDLENBQUM7WUFDaEUsTUFBTSxLQUFLLENBQUM7UUFDZCxDQUFDO0lBQ0gsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSztRQUNWLElBQUksQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLENBQUM7WUFDcEIsTUFBTSxJQUFJLEtBQUssQ0FBQywwQ0FBMEMsQ0FBQyxDQUFDO1FBQzlELENBQUM7UUFDRCxPQUFPLElBQUksQ0FBQyxXQUFXLENBQUM7SUFDMUIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksT0FBTztRQUNaLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQztJQUN4QixDQUFDO0lBRUQ7O09BRUc7SUFDSSxjQUFjO1FBQ25CLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQyxXQUFXLENBQUM7SUFDbEMsQ0FBQztJQUVEOztPQUVHO0lBQ0ksU0FBUztRQUNkLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUM7SUFDN0IsQ0FBQyJ9