recker 1.0.12 → 1.0.13

package/dist/cache/memory-limits.d.ts

@@ -0,0 +1,21 @@
+export declare function getEffectiveTotalMemoryBytes(): number;
+export interface ResolvedMemoryLimit {
+    maxMemoryBytes: number;
+    derivedFromPercent: boolean;
+    effectiveTotal: number;
+    heapLimit: number;
+    inferredPercent: number | null;
+}
+export interface MemoryLimitOptions {
+    maxMemoryBytes?: number;
+    maxMemoryPercent?: number;
+    safetyPercent?: number;
+}
+export declare function resolveCacheMemoryLimit(options?: MemoryLimitOptions): ResolvedMemoryLimit;
+export declare function formatBytes(bytes: number): string;
+export declare function getHeapStats(): {
+    heapUsed: number;
+    heapLimit: number;
+    heapRatio: number;
+};
+//# sourceMappingURL=memory-limits.d.ts.map

package/dist/cache/memory-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-limits.d.ts","sourceRoot":"","sources":["../../src/cache/memory-limits.ts"],"names":[],"mappings":"AA0DA,wBAAgB,4BAA4B,IAAI,MAAM,CAMrD;AAKD,MAAM,WAAW,mBAAmB;IAElC,cAAc,EAAE,MAAM,CAAC;IAEvB,kBAAkB,EAAE,OAAO,CAAC;IAE5B,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,MAAM,CAAC;IAElB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAKD,MAAM,WAAW,kBAAkB;IAEjC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA0BD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,kBAAuB,GAC/B,mBAAmB,CA0DrB;AAQD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAOD,wBAAgB,YAAY,IAAI;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAWA"}

package/dist/cache/memory-limits.js

@@ -0,0 +1,96 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import v8 from 'node:v8';
+const DEFAULT_TOTAL_PERCENT = 0.5;
+const DEFAULT_HEAP_PERCENT = 0.6;
+function readCgroupLimit() {
+    const candidates = [
+        '/sys/fs/cgroup/memory.max',
+        '/sys/fs/cgroup/memory/memory.limit_in_bytes',
+    ];
+    for (const file of candidates) {
+        try {
+            if (fs.existsSync(file)) {
+                const raw = fs.readFileSync(file, 'utf8').trim();
+                if (!raw || raw === 'max')
+                    continue;
+                const value = Number.parseInt(raw, 10);
+                if (Number.isFinite(value) && value > 0) {
+                    return value;
+                }
+            }
+        }
+        catch {
+        }
+    }
+    return null;
+}
+export function getEffectiveTotalMemoryBytes() {
+    const cgroupLimit = readCgroupLimit();
+    if (cgroupLimit && Number.isFinite(cgroupLimit) && cgroupLimit > 0) {
+        return cgroupLimit;
+    }
+    return os.totalmem();
+}
+export function resolveCacheMemoryLimit(options = {}) {
+    const { maxMemoryBytes, maxMemoryPercent, safetyPercent } = options;
+    const heapStats = v8.getHeapStatistics();
+    const heapLimit = heapStats?.heap_size_limit ?? 0;
+    const effectiveTotal = getEffectiveTotalMemoryBytes();
+    let resolvedBytes = 0;
+    let derivedFromPercent = false;
+    if (typeof maxMemoryBytes === 'number' && maxMemoryBytes > 0) {
+        resolvedBytes = maxMemoryBytes;
+    }
+    else if (typeof maxMemoryPercent === 'number' && maxMemoryPercent > 0) {
+        const percent = Math.max(0, Math.min(maxMemoryPercent, 1));
+        resolvedBytes = Math.floor(effectiveTotal * percent);
+        derivedFromPercent = true;
+    }
+    const safeTotalPercent = typeof safetyPercent === 'number' && safetyPercent > 0 && safetyPercent <= 1
+        ? safetyPercent
+        : DEFAULT_TOTAL_PERCENT;
+    const totalCap = Math.floor(effectiveTotal * safeTotalPercent);
+    if (resolvedBytes === 0 || totalCap < resolvedBytes) {
+        resolvedBytes = totalCap;
+        derivedFromPercent = derivedFromPercent || (maxMemoryPercent ?? 0) > 0;
+    }
+    if (heapLimit > 0) {
+        const heapCap = Math.floor(heapLimit * DEFAULT_HEAP_PERCENT);
+        if (resolvedBytes === 0 || heapCap < resolvedBytes) {
+            resolvedBytes = heapCap;
+            derivedFromPercent = derivedFromPercent || (maxMemoryPercent ?? 0) > 0;
+        }
+    }
+    if (!Number.isFinite(resolvedBytes) || resolvedBytes <= 0) {
+        resolvedBytes = Math.floor(effectiveTotal * DEFAULT_TOTAL_PERCENT);
+        derivedFromPercent = true;
+    }
+    const inferredPercent = effectiveTotal > 0 ? resolvedBytes / effectiveTotal : null;
+    return {
+        maxMemoryBytes: resolvedBytes,
+        derivedFromPercent,
+        effectiveTotal,
+        heapLimit,
+        inferredPercent,
+    };
+}
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+}
+export function getHeapStats() {
+    const heapStats = v8.getHeapStatistics();
+    const { heapUsed } = process.memoryUsage();
+    const heapLimit = heapStats?.heap_size_limit ?? 0;
+    const heapRatio = heapLimit > 0 ? heapUsed / heapLimit : 0;
+    return {
+        heapUsed,
+        heapLimit,
+        heapRatio,
+    };
+}

package/dist/cache/memory-storage.d.ts

@@ -1,10 +1,133 @@
 import { CacheEntry, CacheStorage } from '../types/index.js';
+export interface CompressionConfig {
+    enabled: boolean;
+    threshold?: number;
+}
+export interface MemoryStorageOptions {
+    maxSize?: number;
+    maxMemoryBytes?: number;
+    maxMemoryPercent?: number;
+    ttl?: number;
+    evictionPolicy?: 'lru' | 'fifo';
+    compression?: boolean | CompressionConfig;
+    enableStats?: boolean;
+    monitorInterval?: number;
+    heapUsageThreshold?: number;
+    cleanupInterval?: number;
+    onEvict?: (info: EvictionInfo) => void;
+    onPressure?: (info: PressureInfo) => void;
+}
+export interface EvictionInfo {
+    reason: 'size' | 'memory' | 'heap' | 'expired';
+    key?: string;
+    freedBytes: number;
+    currentBytes: number;
+    maxMemoryBytes: number;
+}
+export interface PressureInfo {
+    reason: 'limit' | 'heap';
+    heapLimit: number;
+    heapUsed: number;
+    heapRatio?: number;
+    currentBytes: number;
+    maxMemoryBytes: number;
+    freedBytes: number;
+}
+export interface CacheStats {
+    enabled: boolean;
+    hits: number;
+    misses: number;
+    sets: number;
+    deletes: number;
+    evictions: number;
+    hitRate: number;
+    totalItems: number;
+    memoryUsageBytes: number;
+    maxMemoryBytes: number;
+    evictedDueToMemory: number;
+}
+export interface MemoryStats {
+    currentMemoryBytes: number;
+    maxMemoryBytes: number;
+    maxMemoryPercent: number;
+    memoryUsagePercent: number;
+    cachePercentOfSystemMemory: number;
+    totalItems: number;
+    maxSize: number;
+    evictedDueToMemory: number;
+    memoryPressureEvents: number;
+    averageItemSize: number;
+    memoryUsage: {
+        current: string;
+        max: string;
+        available: string;
+    };
+    systemMemory: {
+        total: string;
+        free: string;
+        used: string;
+        cachePercent: string;
+    };
+}
+export interface CompressionStats {
+    enabled: boolean;
+    totalItems: number;
+    compressedItems: number;
+    compressionThreshold: number;
+    totalOriginalSize: number;
+    totalCompressedSize: number;
+    averageCompressionRatio: string;
+    spaceSavingsPercent: string;
+    memoryUsage: {
+        uncompressed: string;
+        compressed: string;
+        saved: string;
+    };
+}
 export declare class MemoryStorage implements CacheStorage {
     private storage;
-    private ttls;
+    private meta;
+    private readonly maxSize;
+    private readonly maxMemoryBytes;
+    private readonly maxMemoryPercent;
+    private readonly defaultTtl;
+    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 compressionStats;
+    constructor(options?: MemoryStorageOptions);
     get(key: string): Promise<CacheEntry | undefined>;
     set(key: string, entry: CacheEntry, ttl?: number): Promise<void>;
     delete(key: string): Promise<void>;
-    clear(): void;
+    clear(prefix?: string): void;
+    size(): number;
+    keys(): string[];
+    has(key: string): boolean;
+    getStats(): CacheStats;
+    getMemoryStats(): MemoryStats;
+    getCompressionStats(): CompressionStats;
+    shutdown(): void;
+    private deleteInternal;
+    private recordStat;
+    private isCompressed;
+    private compress;
+    private decompress;
+    private selectEvictionCandidate;
+    private evictOne;
+    private enforceMemoryLimit;
+    private reduceMemoryTo;
+    private memoryHealthCheck;
+    private cleanupExpired;
 }
 //# sourceMappingURL=memory-storage.d.ts.map

package/dist/cache/memory-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../src/cache/memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7D,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,IAAI,CAA6B;IAEnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAejD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxC,KAAK;CAIN"}
+{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../src/cache/memory-storage.ts"],"names":[],"mappings":"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"}