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

package/lib/index.js

@@ -1,6 +1,9 @@
 import safeStringify from 'fast-safe-stringify';
 import { randomUUID } from 'crypto';
-import { DEFAULT_RATE_LIMIT, AdaptiveCapacityCalculator } from '@http-client-toolkit/core';
+import {
+  DEFAULT_RATE_LIMIT,
+  AdaptiveCapacityCalculator,
+} from '@http-client-toolkit/core';
 
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
@@ -18,7 +21,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());
   });
 };
@@ -28,15 +34,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();
       }
     }
@@ -71,7 +79,7 @@ var InMemoryCacheStore = class {
         value,
         expiresAt,
         lastAccessed: now,
-        size: entrySize
+        size: entrySize,
       });
       this.enforceMemoryLimits();
     });
@@ -110,7 +118,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,
     };
   }
   /**
@@ -144,7 +152,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);
     }
@@ -154,7 +162,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];
@@ -175,11 +183,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,
     }));
   }
   /**
@@ -202,7 +212,7 @@ var InMemoryCacheStore = class {
     size += hash.length * 2;
     size += 16;
     try {
-      const json = (_a = safeStringify(value)) != null ? _a : "";
+      const json = (_a = safeStringify(value)) != null ? _a : '';
       size += json.length * 2;
     } catch (e) {
       size += 1024;
@@ -224,7 +234,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;
@@ -234,7 +244,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();
       }
     }
@@ -249,7 +259,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;
@@ -279,7 +290,7 @@ var InMemoryDedupeStore = class {
       if (existingJob) {
         return {
           jobId: existingJob.jobId,
-          isOwner: false
+          isOwner: false,
         };
       }
       const jobId = randomUUID();
@@ -290,13 +301,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,
       };
     });
   }
@@ -326,7 +337,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;
@@ -358,7 +370,7 @@ var InMemoryDedupeStore = class {
       activeJobs,
       totalJobsProcessed: this.totalJobsProcessed,
       expiredJobs,
-      oldestJobAgeMs
+      oldestJobAgeMs,
     };
   }
   /**
@@ -375,7 +387,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);
         }
@@ -393,7 +405,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);
       }
     }
@@ -418,7 +430,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();
@@ -429,7 +441,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();
       }
     }
@@ -461,7 +473,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,
       };
     });
   }
@@ -471,7 +483,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);
@@ -492,7 +504,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);
     });
   }
@@ -528,7 +541,7 @@ var InMemoryRateLimitStore = class {
       totalResources: this.limits.size,
       activeResources,
       rateLimitedResources,
-      totalRequests: this.totalRequests
+      totalRequests: this.totalRequests,
     };
   }
   /**
@@ -563,7 +576,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);
     }
@@ -589,48 +602,51 @@ var AdaptiveRateLimitStore = class {
     this.lastCapacityUpdate = /* @__PURE__ */ new Map();
     this.cachedCapacity = /* @__PURE__ */ new Map();
     var _a, _b;
-    this.defaultConfig = (_a = options.defaultConfig) != null ? _a : DEFAULT_RATE_LIMIT;
-    this.resourceConfigs = (_b = options.resourceConfigs) != null ? _b : /* @__PURE__ */ new Map();
+    this.defaultConfig =
+      (_a = options.defaultConfig) != null ? _a : DEFAULT_RATE_LIMIT;
+    this.resourceConfigs =
+      (_b = options.resourceConfigs) != null ? _b : /* @__PURE__ */ new Map();
     this.capacityCalculator = new 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) {
@@ -640,15 +656,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: {
@@ -656,10 +678,10 @@ var AdaptiveRateLimitStore = class {
           backgroundMax: capacity.backgroundMax,
           backgroundPaused: capacity.backgroundPaused,
           recentUserActivity: this.capacityCalculator.getRecentActivity(
-            metrics.recentUserRequests
+            metrics.recentUserRequests,
           ),
-          reason: capacity.reason
-        }
+          reason: capacity.reason,
+        },
       };
     });
   }
@@ -670,7 +692,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) {
@@ -678,13 +700,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;
       }
@@ -695,15 +722,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());
@@ -714,26 +744,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) {
@@ -742,11 +779,16 @@ 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',
     };
   }
 };
 
-export { AdaptiveRateLimitStore, InMemoryCacheStore, InMemoryDedupeStore, InMemoryRateLimitStore };
+export {
+  AdaptiveRateLimitStore,
+  InMemoryCacheStore,
+  InMemoryDedupeStore,
+  InMemoryRateLimitStore,
+};
+//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/package.json

@@ -25,7 +25,7 @@
   "dependencies": {
     "fast-safe-stringify": "^2.1.1",
     "zod": "^3.24.1",
-    "@http-client-toolkit/core": "0.0.1"
+    "@http-client-toolkit/core": "0.3.0"
   },
   "keywords": [
     "http-client",
@@ -44,7 +44,7 @@
     "lib/**"
   ],
   "homepage": "https://github.com/AllyMurray/http-client-toolkit#readme",
-  "version": "0.0.1",
+  "version": "0.3.0",
   "bugs": {
     "url": "https://github.com/AllyMurray/http-client-toolkit/issues"
   },