f docs

Author: tmacro

lib/api/apiUtils/rateLimit/gcra.js

@@ -14,10 +14,9 @@
  * - 600 req/s ÷ 6 nodes = 100 req/s per node → interval = 100ms
  *
  * Dynamic work-stealing is achieved through Redis sync reconciliation:
- * - Each worker evaluates locally at its fixed per-worker quota
- * - Workers report consumed / workers to Redis
- * - Redis sums all workers' shares
- * - Workers overwrite local counters with Redis values
+ * - Each worker evaluates locally using preallocated tokens
+ * - Workers report processed requests to Redis
+ * - Redis sums all workers' requests
  * - Idle workers' unused capacity accumulates in Redis
  * - Busy workers pull back higher emptyAt values and throttle proportionally
  *

lib/api/apiUtils/rateLimit/tokenBucket.js

@@ -35,6 +35,7 @@ class WorkerTokenBucket {
         this.tokens = this.bufferSize; // Start with full buffer for fail-open at startup
         this.interval = calculateInterval(this.limitConfig.limit, config.rateLimiting.nodes);
         this.lastRefillTime = Date.now();
+        this.refillCount = 0;
     }
 
     hasCapacity() {
@@ -244,7 +245,9 @@ function cleanupTokenBuckets(maxIdleMs = 60000) {
 /**
  * Remove a specific token bucket (used when rate limit config is deleted)
  *
- * @param {string} bucketName - Bucket name
+ * @param {string} resourceClass - "bucket" or "account"
+ * @param {string} resourceId - bucket name or account canonicalId
+ * @param {string} measure - measure id e.g. "rps"
  * @returns {boolean} True if bucket was found and removed
  */
 function removeTokenBucket(resourceClass, resourceId, measure) {