@http-client-toolkit/store-memory 0.0.1 → 0.3.0

package/lib/index.cjs

@@ -4,9 +4,11 @@ var safeStringify = require('fast-safe-stringify');
 var crypto = require('crypto');
 var core = require('@http-client-toolkit/core');
 
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+function _interopDefault(e) {
+  return e && e.__esModule ? e : { default: e };
+}
 
-var safeStringify__default = /*#__PURE__*/_interopDefault(safeStringify);
+var safeStringify__default = /*#__PURE__*/ _interopDefault(safeStringify);
 
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
@@ -24,7 +26,10 @@ var __async = (__this, __arguments, generator) => {
         reject(e);
       }
     };
-    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    var step = (x) =>
+      x.done
+        ? resolve(x.value)
+        : Promise.resolve(x.value).then(fulfilled, rejected);
     step((generator = generator.apply(__this, __arguments)).next());
   });
 };
@@ -34,15 +39,17 @@ var InMemoryCacheStore = class {
     this.cache = /* @__PURE__ */ new Map();
     this.totalSize = 0;
     var _a, _b, _c, _d;
-    const cleanupIntervalMs = (_a = options.cleanupIntervalMs) != null ? _a : 6e4;
+    const cleanupIntervalMs =
+      (_a = options.cleanupIntervalMs) != null ? _a : 6e4;
     this.maxItems = (_b = options.maxItems) != null ? _b : 1e3;
-    this.maxMemoryBytes = (_c = options.maxMemoryBytes) != null ? _c : 50 * 1024 * 1024;
+    this.maxMemoryBytes =
+      (_c = options.maxMemoryBytes) != null ? _c : 50 * 1024 * 1024;
     this.evictionRatio = (_d = options.evictionRatio) != null ? _d : 0.1;
     if (cleanupIntervalMs > 0) {
       this.cleanupInterval = setInterval(() => {
         this.cleanup();
       }, cleanupIntervalMs);
-      if (typeof this.cleanupInterval.unref === "function") {
+      if (typeof this.cleanupInterval.unref === 'function') {
         this.cleanupInterval.unref();
       }
     }
@@ -77,7 +84,7 @@ var InMemoryCacheStore = class {
         value,
         expiresAt,
         lastAccessed: now,
-        size: entrySize
+        size: entrySize,
       });
       this.enforceMemoryLimits();
     });
@@ -116,7 +123,7 @@ var InMemoryCacheStore = class {
       maxItems: this.maxItems,
       maxMemoryBytes: this.maxMemoryBytes,
       memoryUtilization: memoryUsageBytes / this.maxMemoryBytes,
-      itemUtilization: this.cache.size / this.maxItems
+      itemUtilization: this.cache.size / this.maxItems,
     };
   }
   /**
@@ -150,7 +157,7 @@ var InMemoryCacheStore = class {
     if (memoryUsage > this.maxMemoryBytes) {
       const itemsToEvict = Math.max(
         1,
-        Math.floor(this.cache.size * this.evictionRatio)
+        Math.floor(this.cache.size * this.evictionRatio),
       );
       this.evictLRUItems(itemsToEvict);
     }
@@ -160,7 +167,7 @@ var InMemoryCacheStore = class {
    */
   evictLRUItems(count) {
     const entries = Array.from(this.cache.entries()).sort(
-      ([, a], [, b]) => a.lastAccessed - b.lastAccessed
+      ([, a], [, b]) => a.lastAccessed - b.lastAccessed,
     );
     for (let i = 0; i < count && i < entries.length; i++) {
       const entry = entries[i];
@@ -181,11 +188,13 @@ var InMemoryCacheStore = class {
    * Get items sorted by last accessed time (for debugging/monitoring)
    */
   getLRUItems(limit = 10) {
-    const entries = Array.from(this.cache.entries()).sort(([, a], [, b]) => a.lastAccessed - b.lastAccessed).slice(0, limit);
+    const entries = Array.from(this.cache.entries())
+      .sort(([, a], [, b]) => a.lastAccessed - b.lastAccessed)
+      .slice(0, limit);
     return entries.map(([hash, item]) => ({
       hash,
       lastAccessed: new Date(item.lastAccessed),
-      size: item.size
+      size: item.size,
     }));
   }
   /**
@@ -208,7 +217,8 @@ var InMemoryCacheStore = class {
     size += hash.length * 2;
     size += 16;
     try {
-      const json = (_a = safeStringify__default.default(value)) != null ? _a : "";
+      const json =
+        (_a = safeStringify__default.default(value)) != null ? _a : '';
       size += json.length * 2;
     } catch (e) {
       size += 1024;
@@ -230,7 +240,7 @@ var InMemoryDedupeStore = class {
     /** Job timeout in milliseconds. Defaults to 5 minutes. */
     jobTimeoutMs = 3e5,
     /** Cleanup interval in milliseconds. Defaults to 1 minute. */
-    cleanupIntervalMs = 6e4
+    cleanupIntervalMs = 6e4,
   } = {}) {
     this.jobs = /* @__PURE__ */ new Map();
     this.totalJobsProcessed = 0;
@@ -240,7 +250,7 @@ var InMemoryDedupeStore = class {
       this.cleanupInterval = setInterval(() => {
         this.cleanup();
       }, cleanupIntervalMs);
-      if (typeof this.cleanupInterval.unref === "function") {
+      if (typeof this.cleanupInterval.unref === 'function') {
         this.cleanupInterval.unref();
       }
     }
@@ -255,7 +265,8 @@ var InMemoryDedupeStore = class {
       if (!job) {
         return void 0;
       }
-      const jobTimedOut = this.jobTimeoutMs > 0 && Date.now() - job.createdAt > this.jobTimeoutMs;
+      const jobTimedOut =
+        this.jobTimeoutMs > 0 && Date.now() - job.createdAt > this.jobTimeoutMs;
       if (jobTimedOut) {
         this.cleanup();
         return void 0;
@@ -285,7 +296,7 @@ var InMemoryDedupeStore = class {
       if (existingJob) {
         return {
           jobId: existingJob.jobId,
-          isOwner: false
+          isOwner: false,
         };
       }
       const jobId = crypto.randomUUID();
@@ -296,13 +307,13 @@ var InMemoryDedupeStore = class {
         resolve,
         reject,
         createdAt: Date.now(),
-        completed: false
+        completed: false,
       };
       this.jobs.set(hash, job);
       this.totalJobsProcessed++;
       return {
         jobId,
-        isOwner: true
+        isOwner: true,
       };
     });
   }
@@ -332,7 +343,8 @@ var InMemoryDedupeStore = class {
       if (!job) {
         return false;
       }
-      const isJobExpired = this.jobTimeoutMs > 0 && Date.now() - job.createdAt > this.jobTimeoutMs;
+      const isJobExpired =
+        this.jobTimeoutMs > 0 && Date.now() - job.createdAt > this.jobTimeoutMs;
       if (isJobExpired) {
         this.cleanup();
         return false;
@@ -364,7 +376,7 @@ var InMemoryDedupeStore = class {
       activeJobs,
       totalJobsProcessed: this.totalJobsProcessed,
       expiredJobs,
-      oldestJobAgeMs
+      oldestJobAgeMs,
     };
   }
   /**
@@ -381,7 +393,7 @@ var InMemoryDedupeStore = class {
         if (!job.completed) {
           job.completed = true;
           job.error = new Error(
-            "Job timeout: Request took too long to complete"
+            'Job timeout: Request took too long to complete',
           );
           job.reject(job.error);
         }
@@ -399,7 +411,7 @@ var InMemoryDedupeStore = class {
     for (const [_hash, job] of this.jobs) {
       if (!job.completed) {
         job.completed = true;
-        job.error = new Error("DedupeStore cleared");
+        job.error = new Error('DedupeStore cleared');
         job.reject(job.error);
       }
     }
@@ -424,7 +436,7 @@ var InMemoryRateLimitStore = class {
     /** Optional per-resource overrides. */
     resourceConfigs = /* @__PURE__ */ new Map(),
     /** Cleanup interval in milliseconds. Defaults to 1 minute. */
-    cleanupIntervalMs = 6e4
+    cleanupIntervalMs = 6e4,
   } = {}) {
     this.limits = /* @__PURE__ */ new Map();
     this.resourceConfigs = /* @__PURE__ */ new Map();
@@ -435,7 +447,7 @@ var InMemoryRateLimitStore = class {
       this.cleanupInterval = setInterval(() => {
         this.cleanup();
       }, cleanupIntervalMs);
-      if (typeof this.cleanupInterval.unref === "function") {
+      if (typeof this.cleanupInterval.unref === 'function') {
         this.cleanupInterval.unref();
       }
     }
@@ -467,7 +479,7 @@ var InMemoryRateLimitStore = class {
       return {
         remaining: Math.max(0, info.limit - info.requests.length),
         resetTime: new Date(info.resetTime),
-        limit: info.limit
+        limit: info.limit,
       };
     });
   }
@@ -477,7 +489,7 @@ var InMemoryRateLimitStore = class {
       if (info) {
         this.totalRequests = Math.max(
           0,
-          this.totalRequests - info.requests.length
+          this.totalRequests - info.requests.length,
         );
       }
       this.limits.delete(resource);
@@ -498,7 +510,8 @@ var InMemoryRateLimitStore = class {
       if (oldestRequest === void 0) {
         return 0;
       }
-      const timeUntilOldestExpires = oldestRequest + config.windowMs - Date.now();
+      const timeUntilOldestExpires =
+        oldestRequest + config.windowMs - Date.now();
       return Math.max(0, timeUntilOldestExpires);
     });
   }
@@ -534,7 +547,7 @@ var InMemoryRateLimitStore = class {
       totalResources: this.limits.size,
       activeResources,
       rateLimitedResources,
-      totalRequests: this.totalRequests
+      totalRequests: this.totalRequests,
     };
   }
   /**
@@ -569,7 +582,7 @@ var InMemoryRateLimitStore = class {
         requests: [],
         limit: config.limit,
         windowMs: config.windowMs,
-        resetTime: Date.now() + config.windowMs
+        resetTime: Date.now() + config.windowMs,
       };
       this.limits.set(resource, info);
     }
@@ -595,48 +608,51 @@ var AdaptiveRateLimitStore = class {
     this.lastCapacityUpdate = /* @__PURE__ */ new Map();
     this.cachedCapacity = /* @__PURE__ */ new Map();
     var _a, _b;
-    this.defaultConfig = (_a = options.defaultConfig) != null ? _a : core.DEFAULT_RATE_LIMIT;
-    this.resourceConfigs = (_b = options.resourceConfigs) != null ? _b : /* @__PURE__ */ new Map();
+    this.defaultConfig =
+      (_a = options.defaultConfig) != null ? _a : core.DEFAULT_RATE_LIMIT;
+    this.resourceConfigs =
+      (_b = options.resourceConfigs) != null ? _b : /* @__PURE__ */ new Map();
     this.capacityCalculator = new core.AdaptiveCapacityCalculator(
-      options.adaptiveConfig
+      options.adaptiveConfig,
     );
   }
-  canProceed(resource, priority = "background") {
+  canProceed(resource, priority = 'background') {
     return __async(this, null, function* () {
       const metrics = this.getOrCreateActivityMetrics(resource);
       const capacity = this.calculateCurrentCapacity(resource, metrics);
-      if (priority === "background" && capacity.backgroundPaused) {
+      if (priority === 'background' && capacity.backgroundPaused) {
         return false;
       }
       const currentUserRequests = this.getCurrentUsage(
         resource,
-        metrics.recentUserRequests
+        metrics.recentUserRequests,
       );
       const currentBackgroundRequests = this.getCurrentUsage(
         resource,
-        metrics.recentBackgroundRequests
+        metrics.recentBackgroundRequests,
       );
-      if (priority === "user") {
+      if (priority === 'user') {
         return currentUserRequests < capacity.userReserved;
       } else {
         return currentBackgroundRequests < capacity.backgroundMax;
       }
     });
   }
-  record(resource, priority = "background") {
+  record(resource, priority = 'background') {
     return __async(this, null, function* () {
       const metrics = this.getOrCreateActivityMetrics(resource);
       const now = Date.now();
-      if (priority === "user") {
+      if (priority === 'user') {
         metrics.recentUserRequests.push(now);
         this.cleanupOldRequests(metrics.recentUserRequests);
       } else {
         metrics.recentBackgroundRequests.push(now);
         this.cleanupOldRequests(metrics.recentBackgroundRequests);
       }
-      metrics.userActivityTrend = this.capacityCalculator.calculateActivityTrend(
-        metrics.recentUserRequests
-      );
+      metrics.userActivityTrend =
+        this.capacityCalculator.calculateActivityTrend(
+          metrics.recentUserRequests,
+        );
     });
   }
   getStatus(resource) {
@@ -646,15 +662,21 @@ var AdaptiveRateLimitStore = class {
       const capacity = this.calculateCurrentCapacity(resource, metrics);
       const currentUserUsage = this.getCurrentUsage(
         resource,
-        metrics.recentUserRequests
+        metrics.recentUserRequests,
       );
       const currentBackgroundUsage = this.getCurrentUsage(
         resource,
-        metrics.recentBackgroundRequests
+        metrics.recentBackgroundRequests,
       );
-      const config = (_a = this.resourceConfigs.get(resource)) != null ? _a : this.defaultConfig;
+      const config =
+        (_a = this.resourceConfigs.get(resource)) != null
+          ? _a
+          : this.defaultConfig;
       return {
-        remaining: capacity.userReserved - currentUserUsage + (capacity.backgroundMax - currentBackgroundUsage),
+        remaining:
+          capacity.userReserved -
+          currentUserUsage +
+          (capacity.backgroundMax - currentBackgroundUsage),
         resetTime: new Date(Date.now() + config.windowMs),
         limit: this.getResourceLimit(resource),
         adaptive: {
@@ -662,10 +684,10 @@ var AdaptiveRateLimitStore = class {
           backgroundMax: capacity.backgroundMax,
           backgroundPaused: capacity.backgroundPaused,
           recentUserActivity: this.capacityCalculator.getRecentActivity(
-            metrics.recentUserRequests
+            metrics.recentUserRequests,
           ),
-          reason: capacity.reason
-        }
+          reason: capacity.reason,
+        },
       };
     });
   }
@@ -676,7 +698,7 @@ var AdaptiveRateLimitStore = class {
       this.lastCapacityUpdate.delete(resource);
     });
   }
-  getWaitTime(resource, priority = "background") {
+  getWaitTime(resource, priority = 'background') {
     return __async(this, null, function* () {
       const canProceed = yield this.canProceed(resource, priority);
       if (canProceed) {
@@ -684,13 +706,18 @@ var AdaptiveRateLimitStore = class {
       }
       const metrics = this.getOrCreateActivityMetrics(resource);
       const capacity = this.calculateCurrentCapacity(resource, metrics);
-      if (priority === "background" && capacity.backgroundPaused) {
+      if (priority === 'background' && capacity.backgroundPaused) {
         const lastUpdate = this.lastCapacityUpdate.get(resource) || 0;
-        const nextUpdate = lastUpdate + this.capacityCalculator.config.recalculationIntervalMs;
+        const nextUpdate =
+          lastUpdate + this.capacityCalculator.config.recalculationIntervalMs;
         return Math.max(0, nextUpdate - Date.now());
       }
-      const monitoringWindow = this.capacityCalculator.config.monitoringWindowMs;
-      const requests = priority === "user" ? metrics.recentUserRequests : metrics.recentBackgroundRequests;
+      const monitoringWindow =
+        this.capacityCalculator.config.monitoringWindowMs;
+      const requests =
+        priority === 'user'
+          ? metrics.recentUserRequests
+          : metrics.recentBackgroundRequests;
       if (requests.length === 0) {
         return 0;
       }
@@ -701,15 +728,18 @@ var AdaptiveRateLimitStore = class {
   }
   calculateCurrentCapacity(resource, metrics) {
     const lastUpdate = this.lastCapacityUpdate.get(resource) || 0;
-    const recalcInterval = this.capacityCalculator.config.recalculationIntervalMs;
+    const recalcInterval =
+      this.capacityCalculator.config.recalculationIntervalMs;
     if (Date.now() - lastUpdate < recalcInterval) {
-      return this.cachedCapacity.get(resource) || this.getDefaultCapacity(resource);
+      return (
+        this.cachedCapacity.get(resource) || this.getDefaultCapacity(resource)
+      );
     }
     const totalLimit = this.getResourceLimit(resource);
     const capacity = this.capacityCalculator.calculateDynamicCapacity(
       resource,
       totalLimit,
-      metrics
+      metrics,
     );
     this.cachedCapacity.set(resource, capacity);
     this.lastCapacityUpdate.set(resource, Date.now());
@@ -720,26 +750,33 @@ var AdaptiveRateLimitStore = class {
       this.activityMetrics.set(resource, {
         recentUserRequests: [],
         recentBackgroundRequests: [],
-        userActivityTrend: "none"
+        userActivityTrend: 'none',
       });
     }
     return this.activityMetrics.get(resource);
   }
   getCurrentUsage(resource, requests) {
     var _a;
-    const config = (_a = this.resourceConfigs.get(resource)) != null ? _a : this.defaultConfig;
+    const config =
+      (_a = this.resourceConfigs.get(resource)) != null
+        ? _a
+        : this.defaultConfig;
     const windowStart = Date.now() - config.windowMs;
     return requests.filter((timestamp) => timestamp > windowStart).length;
   }
   cleanupOldRequests(requests) {
-    const cutoff = Date.now() - this.capacityCalculator.config.monitoringWindowMs;
+    const cutoff =
+      Date.now() - this.capacityCalculator.config.monitoringWindowMs;
     while (requests.length > 0 && requests[0] < cutoff) {
       requests.shift();
     }
   }
   getResourceLimit(resource) {
     var _a;
-    const config = (_a = this.resourceConfigs.get(resource)) != null ? _a : this.defaultConfig;
+    const config =
+      (_a = this.resourceConfigs.get(resource)) != null
+        ? _a
+        : this.defaultConfig;
     return config.limit;
   }
   getDefaultCapacity(resource) {
@@ -748,7 +785,7 @@ var AdaptiveRateLimitStore = class {
       userReserved: Math.floor(totalLimit * 0.3),
       backgroundMax: Math.floor(totalLimit * 0.7),
       backgroundPaused: false,
-      reason: "Default capacity allocation"
+      reason: 'Default capacity allocation',
     };
   }
 };
@@ -758,4 +795,4 @@ exports.InMemoryCacheStore = InMemoryCacheStore;
 exports.InMemoryDedupeStore = InMemoryDedupeStore;
 exports.InMemoryRateLimitStore = InMemoryRateLimitStore;
 //# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map