raffel 0.1.2

package/dist/cache/drivers/file.js

@@ -0,0 +1,329 @@
+/**
+ * File Cache Driver
+ *
+ * File-system based cache for persistent storage across restarts.
+ *
+ * Features:
+ * - Persists cache to disk
+ * - Automatic cleanup of expired entries
+ * - Optional compression
+ * - Size limits (by file count or total bytes)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import zlib from 'node:zlib';
+import crypto from 'node:crypto';
+/**
+ * File Cache Driver
+ *
+ * @example Basic usage
+ * ```typescript
+ * const cache = new FileDriver({ directory: '.cache' })
+ * await cache.set('key', { data: 'value' }, 60000)
+ * const result = await cache.get('key')
+ * ```
+ */
+export class FileDriver {
+    name = 'file';
+    directory;
+    maxFiles;
+    maxSizeBytes;
+    compressionEnabled;
+    cleanupHandle = null;
+    // Stats
+    _stats = {
+        hits: 0,
+        misses: 0,
+        sets: 0,
+        deletes: 0,
+        evictions: 0,
+    };
+    constructor(options = {}) {
+        this.directory = options.directory ?? '.cache';
+        this.maxFiles = options.maxFiles ?? 10000;
+        this.maxSizeBytes = options.maxSizeBytes ?? 0; // 0 = no limit
+        this.compressionEnabled = options.compression ?? false;
+        // Ensure directory exists
+        this.ensureDirectory();
+        // Start cleanup interval
+        const cleanupInterval = options.cleanupInterval ?? 300000; // 5 minutes
+        if (cleanupInterval > 0) {
+            this.cleanupHandle = setInterval(() => this.cleanupExpired(), cleanupInterval);
+            this.cleanupHandle.unref();
+        }
+    }
+    /**
+     * Get a cached entry
+     */
+    async get(key) {
+        const filePath = this.getFilePath(key);
+        try {
+            if (!fs.existsSync(filePath)) {
+                this._stats.misses++;
+                return undefined;
+            }
+            const content = fs.readFileSync(filePath, 'utf8');
+            const fileEntry = JSON.parse(content);
+            // Check expiration
+            if (Date.now() > fileEntry.expiresAt) {
+                this.deleteFile(filePath);
+                this._stats.misses++;
+                return undefined;
+            }
+            // Decompress if needed
+            let value = fileEntry.value;
+            if (fileEntry.compressed && typeof value === 'string') {
+                const buffer = Buffer.from(value, 'base64');
+                const decompressed = zlib.gunzipSync(buffer);
+                value = JSON.parse(decompressed.toString('utf8'));
+            }
+            this._stats.hits++;
+            const entry = {
+                value,
+                expiresAt: fileEntry.expiresAt,
+                createdAt: fileEntry.createdAt,
+                tags: fileEntry.tags,
+            };
+            return { entry, stale: false };
+        }
+        catch {
+            this._stats.misses++;
+            return undefined;
+        }
+    }
+    /**
+     * Set a cached entry
+     */
+    async set(key, value, ttlMs, tags) {
+        this.ensureDirectory();
+        const now = Date.now();
+        const filePath = this.getFilePath(key);
+        let finalValue = value;
+        let compressed = false;
+        // Compress if enabled
+        if (this.compressionEnabled) {
+            const serialized = JSON.stringify(value);
+            if (serialized.length >= 1024) {
+                const buffer = Buffer.from(serialized, 'utf8');
+                const compressedBuffer = zlib.gzipSync(buffer);
+                finalValue = compressedBuffer.toString('base64');
+                compressed = true;
+            }
+        }
+        const fileEntry = {
+            value: finalValue,
+            expiresAt: now + ttlMs,
+            createdAt: now,
+            tags,
+            compressed,
+        };
+        // Enforce file count limit before adding
+        await this.enforceFileLimits();
+        fs.writeFileSync(filePath, JSON.stringify(fileEntry), 'utf8');
+        this._stats.sets++;
+    }
+    /**
+     * Delete a cached entry
+     */
+    async delete(key) {
+        const filePath = this.getFilePath(key);
+        this.deleteFile(filePath);
+        this._stats.deletes++;
+    }
+    /**
+     * Clear all cached entries, or those matching a prefix
+     */
+    async clear(prefix) {
+        try {
+            const files = fs.readdirSync(this.directory);
+            for (const file of files) {
+                if (!file.endsWith('.cache'))
+                    continue;
+                if (prefix) {
+                    // Read file to check if key matches prefix
+                    // For prefix clearing, we'd need to store the original key
+                    // For now, just clear all .cache files
+                }
+                const filePath = path.join(this.directory, file);
+                this.deleteFile(filePath);
+            }
+        }
+        catch {
+            // Directory might not exist
+        }
+    }
+    /**
+     * Check if a key exists
+     */
+    async has(key) {
+        const filePath = this.getFilePath(key);
+        try {
+            if (!fs.existsSync(filePath))
+                return false;
+            const content = fs.readFileSync(filePath, 'utf8');
+            const fileEntry = JSON.parse(content);
+            if (Date.now() > fileEntry.expiresAt) {
+                this.deleteFile(filePath);
+                return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get all keys
+     */
+    async keys(pattern) {
+        // Note: File driver doesn't store original keys, so we return hashed filenames
+        // For full key support, we'd need to store key→hash mapping
+        try {
+            const files = fs.readdirSync(this.directory);
+            return files.filter((f) => f.endsWith('.cache')).map((f) => f.replace('.cache', ''));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    stats() {
+        const total = this._stats.hits + this._stats.misses;
+        const hitRate = total > 0 ? this._stats.hits / total : 0;
+        const totalItems = this.countFiles();
+        return {
+            ...this._stats,
+            hitRate,
+            totalItems,
+        };
+    }
+    /**
+     * Shutdown the cache
+     */
+    async shutdown() {
+        if (this.cleanupHandle) {
+            clearInterval(this.cleanupHandle);
+            this.cleanupHandle = null;
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Private methods
+    // ─────────────────────────────────────────────────────────────────
+    ensureDirectory() {
+        if (!fs.existsSync(this.directory)) {
+            fs.mkdirSync(this.directory, { recursive: true });
+        }
+    }
+    getFilePath(key) {
+        // Hash the key for safe filesystem names
+        const hash = crypto.createHash('sha256').update(key).digest('hex').slice(0, 32);
+        return path.join(this.directory, `${hash}.cache`);
+    }
+    deleteFile(filePath) {
+        try {
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    countFiles() {
+        try {
+            const files = fs.readdirSync(this.directory);
+            return files.filter((f) => f.endsWith('.cache')).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+    getTotalSize() {
+        try {
+            const files = fs.readdirSync(this.directory);
+            let totalSize = 0;
+            for (const file of files) {
+                if (!file.endsWith('.cache'))
+                    continue;
+                const filePath = path.join(this.directory, file);
+                const stat = fs.statSync(filePath);
+                totalSize += stat.size;
+            }
+            return totalSize;
+        }
+        catch {
+            return 0;
+        }
+    }
+    async enforceFileLimits() {
+        // Check file count
+        if (this.maxFiles > 0 && this.countFiles() >= this.maxFiles) {
+            await this.evictOldest();
+        }
+        // Check total size
+        if (this.maxSizeBytes > 0 && this.getTotalSize() >= this.maxSizeBytes) {
+            await this.evictOldest();
+        }
+    }
+    async evictOldest() {
+        try {
+            const files = fs.readdirSync(this.directory);
+            let oldest = null;
+            for (const file of files) {
+                if (!file.endsWith('.cache'))
+                    continue;
+                const filePath = path.join(this.directory, file);
+                const stat = fs.statSync(filePath);
+                if (!oldest || stat.mtimeMs < oldest.mtime) {
+                    oldest = { file, mtime: stat.mtimeMs };
+                }
+            }
+            if (oldest) {
+                const filePath = path.join(this.directory, oldest.file);
+                this.deleteFile(filePath);
+                this._stats.evictions++;
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    cleanupExpired() {
+        const now = Date.now();
+        let cleaned = 0;
+        try {
+            const files = fs.readdirSync(this.directory);
+            for (const file of files) {
+                if (!file.endsWith('.cache'))
+                    continue;
+                const filePath = path.join(this.directory, file);
+                try {
+                    const content = fs.readFileSync(filePath, 'utf8');
+                    const fileEntry = JSON.parse(content);
+                    if (now > fileEntry.expiresAt) {
+                        this.deleteFile(filePath);
+                        cleaned++;
+                    }
+                }
+                catch {
+                    // Invalid file - delete it
+                    this.deleteFile(filePath);
+                    cleaned++;
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return cleaned;
+    }
+}
+/**
+ * Create a file cache driver
+ */
+export function createFileDriver(options) {
+    return new FileDriver(options);
+}
+//# sourceMappingURL=file.js.map

package/dist/cache/drivers/file.js.map

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

package/dist/cache/drivers/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cache Drivers
+ *
+ * Export all available cache drivers.
+ */
+export { MemoryDriver, createMemoryDriver } from './memory.js';
+export { FileDriver, createFileDriver } from './file.js';
+export { RedisDriver, createRedisDriver } from './redis.js';
+export { S3DBDriver, createS3DBDriver } from './s3db.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/drivers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA"}

package/dist/cache/drivers/index.js

@@ -0,0 +1,10 @@
+/**
+ * Cache Drivers
+ *
+ * Export all available cache drivers.
+ */
+export { MemoryDriver, createMemoryDriver } from './memory.js';
+export { FileDriver, createFileDriver } from './file.js';
+export { RedisDriver, createRedisDriver } from './redis.js';
+export { S3DBDriver, createS3DBDriver } from './s3db.js';
+//# sourceMappingURL=index.js.map

package/dist/cache/drivers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/drivers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA"}

package/dist/cache/drivers/memory.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Memory Cache Driver
+ *
+ * High-performance, memory-aware cache implementation ported from Recker.
+ *
+ * Features:
+ * - LRU (Least Recently Used) and FIFO eviction policies
+ * - Memory limits (bytes, percentage, or auto-calculated)
+ * - Container-aware (cgroup detection for Docker/K8s)
+ * - V8 heap pressure monitoring
+ * - Optional gzip compression
+ * - Comprehensive statistics
+ */
+import type { CacheDriver, CacheGetResult, CacheStats, MemoryStats, CompressionStats, MemoryDriverOptions } from '../types.js';
+/**
+ * Memory Cache Driver
+ *
+ * @example Basic usage
+ * ```typescript
+ * const cache = new MemoryDriver()
+ * await cache.set('key', { data: 'value' }, 60000)
+ * const result = await cache.get('key')
+ * ```
+ *
+ * @example Advanced configuration
+ * ```typescript
+ * const cache = new MemoryDriver({
+ *   maxSize: 5000,
+ *   maxMemoryPercent: 0.1,      // 10% of system RAM
+ *   evictionPolicy: 'lru',
+ *   compression: { enabled: true, threshold: 512 },
+ *   enableStats: true,
+ *   monitorInterval: 30000
+ * })
+ * ```
+ */
+export declare class MemoryDriver implements CacheDriver {
+    readonly name = "memory";
+    private storage;
+    private meta;
+    private readonly maxSize;
+    private readonly maxMemoryBytes;
+    private readonly maxMemoryPercent;
+    private readonly evictionPolicy;
+    private readonly compressionEnabled;
+    private readonly compressionThreshold;
+    private readonly enableStats;
+    private readonly heapUsageThreshold;
+    private readonly onEvict?;
+    private readonly onPressure?;
+    private currentMemoryBytes;
+    private evictedDueToMemory;
+    private memoryPressureEvents;
+    private accessCounter;
+    private monitorHandle;
+    private cleanupHandle;
+    private _stats;
+    private compressionStatsData;
+    constructor(options?: MemoryDriverOptions);
+    /**
+     * Get a cached entry
+     */
+    get(key: string): Promise<CacheGetResult | undefined>;
+    /**
+     * Set a cached entry
+     */
+    set(key: string, value: unknown, ttlMs: number, tags?: string[]): Promise<void>;
+    /**
+     * Delete a cached entry
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all cached entries, or those matching a prefix
+     */
+    clear(prefix?: string): Promise<void>;
+    /**
+     * Check if a key exists (without updating LRU)
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Get all keys matching a pattern
+     */
+    keys(pattern?: string): Promise<string[]>;
+    /**
+     * Get cache statistics
+     */
+    stats(): CacheStats;
+    /**
+     * Get memory usage statistics
+     */
+    getMemoryStats(): MemoryStats;
+    /**
+     * Get compression statistics
+     */
+    getCompressionStats(): CompressionStats;
+    /**
+     * Shutdown the cache, cleaning up timers
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get the current size of the cache
+     */
+    size(): number;
+    private deleteInternal;
+    private recordStat;
+    private isCompressed;
+    private compress;
+    private decompress;
+    /**
+     * Select the best candidate for eviction based on policy
+     */
+    private selectEvictionCandidate;
+    /**
+     * Evict one item based on policy
+     */
+    private evictOne;
+    /**
+     * Enforce memory limit, evicting items until space is available
+     */
+    private enforceMemoryLimit;
+    /**
+     * Reduce memory to target bytes
+     */
+    private reduceMemoryTo;
+    /**
+     * Periodic memory health check
+     */
+    private memoryHealthCheck;
+    /**
+     * Clean up expired items
+     */
+    private cleanupExpired;
+}
+/**
+ * Create a memory cache driver
+ */
+export declare function createMemoryDriver(options?: MemoryDriverOptions): CacheDriver;
+//# sourceMappingURL=memory.d.ts.map

package/dist/cache/drivers/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EACV,WAAW,EAEX,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EAGpB,MAAM,aAAa,CAAA;AAqIpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,QAAQ,CAAC,IAAI,YAAW;IAGxB,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,IAAI,CAAmC;IAG/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAG3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAA8B;IAG1D,OAAO,CAAC,kBAAkB,CAAI;IAC9B,OAAO,CAAC,kBAAkB,CAAI;IAC9B,OAAO,CAAC,oBAAoB,CAAI;IAChC,OAAO,CAAC,aAAa,CAAI;IAGzB,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,aAAa,CAA8C;IAGnE,OAAO,CAAC,MAAM,CAMb;IAGD,OAAO,CAAC,oBAAoB,CAI3B;gBAEW,OAAO,GAAE,mBAAwB;IAuE7C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAmD3D;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DrF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxC;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkB/C;;OAEG;IACH,KAAK,IAAI,UAAU;IAanB;;OAEG;IACH,cAAc,IAAI,WAAW;IAiB7B;;OAEG;IACH,mBAAmB,IAAI,gBAAgB;IAwCvC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B;;OAEG;IACH,IAAI,IAAI,MAAM;IAQd,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,UAAU;IAMlB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAyBhB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+CzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAoBvB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,WAAW,CAE7E"}

package/dist/cache/drivers/memory.int.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Memory Cache Driver Tests
+ */
+export {};
+//# sourceMappingURL=memory.int.test.d.ts.map

package/dist/cache/drivers/memory.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.int.test.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/memory.int.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}