adaptive-concurrency 0.7.0 → 0.9.0

package/dist/Limiter.d.ts

@@ -113,11 +113,14 @@ export declare class Limiter<Context = void> {
     private readonly acquireStrategy;
     private readonly rejectionStrategy;
     private readonly bypassResolver;
+    private readonly acquireBypassedAllotment;
     private readonly successCounter;
     private readonly droppedCounter;
     private readonly ignoredCounter;
-    private readonly rejectedCounter;
-    private readonly bypassCounter;
+    private readonly acquireSucceededCounter;
+    private readonly acquireFailedCounter;
+    private readonly acquireBypassedCounter;
+    private readonly limitGauge;
     static makeDefaultLimit(): AdaptiveLimit;
     constructor(options?: LimiterOptions<Context>);
     acquire(options?: AcquireOptions<Context>): AcquireResult;

package/dist/Limiter.d.ts.map

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

package/dist/Limiter.js

@@ -5,11 +5,6 @@ import { isAdaptiveTimeoutError, isRunResult, QuotaNotAvailable, } from "./RunRe
 // ---------------------------------------------------------------------------
 // Limiter options
 // ---------------------------------------------------------------------------
-const NOOP_ALLOTMENT = {
-    async releaseAndRecordSuccess() { },
-    async releaseAndIgnore() { },
-    async releaseAndRecordDropped() { },
-};
 let idCounter = 0;
 /**
  * Concurrency limiter with pluggable strategies for gating decisions and
@@ -25,11 +20,14 @@ export class Limiter {
     acquireStrategy;
     rejectionStrategy;
     bypassResolver;
+    acquireBypassedAllotment;
     successCounter;
     droppedCounter;
     ignoredCounter;
-    rejectedCounter;
-    bypassCounter;
+    acquireSucceededCounter;
+    acquireFailedCounter;
+    acquireBypassedCounter;
+    limitGauge;
     static makeDefaultLimit() {
         return new GradientLimit();
     }
@@ -44,12 +42,15 @@ export class Limiter {
         this.limitAlgorithm.subscribe((newLimit) => {
             const oldLimit = this._limit;
             this._limit = newLimit;
+            this.limitGauge.record(newLimit);
             this.acquireStrategy.onLimitChanged?.(oldLimit, newLimit);
             void this.rejectionStrategy?.onLimitChanged?.(oldLimit, newLimit);
         });
         const registry = options.metricRegistry ?? NoopMetricRegistry;
         const limiterName = options.name ?? `unnamed-${++idCounter}`;
-        registry.gauge(MetricIds.LIMIT_NAME, () => this._limit);
+        this.limitGauge = registry.gauge(MetricIds.LIMIT_NAME, {
+            id: limiterName,
+        });
         this.successCounter = registry.counter(MetricIds.CALL_NAME, {
             id: limiterName,
             status: "success",
@@ -62,29 +63,35 @@ export class Limiter {
             id: limiterName,
             status: "ignored",
         });
-        this.rejectedCounter = registry.counter(MetricIds.CALL_NAME, {
-            id: limiterName,
-            status: "rejected",
-        });
-        this.bypassCounter = registry.counter(MetricIds.CALL_NAME, {
-            id: limiterName,
-            status: "bypassed",
-        });
+        this.acquireSucceededCounter = registry.counter(MetricIds.ACQUIRE_ATTEMPT_NAME, { id: limiterName, status: "succeeded" });
+        this.acquireFailedCounter = registry.counter(MetricIds.ACQUIRE_ATTEMPT_NAME, { id: limiterName, status: "failed" });
+        this.acquireBypassedCounter = registry.counter(MetricIds.ACQUIRE_ATTEMPT_NAME, { id: limiterName, status: "bypassed" });
+        this.acquireBypassedAllotment = {
+            releaseAndRecordSuccess: async () => {
+                this.successCounter.increment();
+            },
+            releaseAndIgnore: async () => {
+                this.ignoredCounter.increment();
+            },
+            releaseAndRecordDropped: async () => {
+                this.droppedCounter.increment();
+            },
+        };
     }
     async acquire(options) {
         if (options?.signal?.aborted)
             return undefined;
         const ctx = (options?.context ?? undefined);
         if (this.bypassResolver?.(ctx)) {
-            this.bypassCounter.increment();
-            return NOOP_ALLOTMENT;
+            this.acquireBypassedCounter.increment();
+            return this.acquireBypassedAllotment;
         }
         const state = {
             limit: this._limit,
             inflight: this._inflight,
         };
         if (!(await this.acquireStrategy.tryAcquireAllotment(ctx, state))) {
-            this.rejectedCounter.increment();
+            this.acquireFailedCounter.increment();
             if (!this.rejectionStrategy) {
                 return undefined;
             }
@@ -99,6 +106,7 @@ export class Limiter {
                 return this.tryAcquireCore(retryCtx);
             }, options?.signal);
         }
+        this.acquireSucceededCounter.increment();
         const allotment = this.createAllotment(ctx);
         if (options?.signal?.aborted) {
             // here, we did acquire, so we need to try to cleanup.
@@ -113,8 +121,10 @@ export class Limiter {
             inflight: this._inflight,
         };
         if (!(await this.acquireStrategy.tryAcquireAllotment(ctx, state))) {
+            this.acquireFailedCounter.increment();
             return undefined;
         }
+        this.acquireSucceededCounter.increment();
         return this.createAllotment(ctx);
     }
     createAllotment(ctx) {

package/dist/MetricRegistry.d.ts

@@ -1,9 +1,15 @@
 /**
  * Common metric ids used by the limiters and limit algorithms.
+ *
+ * `CALL_NAME` records outcomes for work that actually executed under a limiter
+ * (status: `success`, `ignored`, `dropped`). `ACQUIRE_ATTEMPT_NAME` records
+ * acquire outcomes (status: `succeeded`, `failed`, `bypassed`), including
+ * failures from retry attempts.
  */
 export declare const MetricIds: {
     readonly LIMIT_NAME: "limit";
     readonly CALL_NAME: "call";
+    readonly ACQUIRE_ATTEMPT_NAME: "acquire_attempt";
     readonly INFLIGHT_NAME: "inflight";
     readonly PARTITION_LIMIT_NAME: "limit.partition";
     readonly MIN_RTT_NAME: "min_rtt";
@@ -24,7 +30,8 @@ export interface Counter {
     increment(): void;
 }
 /** Opaque handle for a registered gauge (supplier is polled by the registry on flush). */
-export interface GaugeMetric {
+export interface Gauge {
+    record(value: number): void;
 }
 /**
  * Simple abstraction for tracking metrics in the limiters.
@@ -39,7 +46,7 @@ export interface MetricRegistry {
      * @param tagNameValuePairs Pairs of tag name and tag value
      * @returns SampleListener for the caller to add samples
      */
-    distribution(id: string, ...tagNameValuePairs: string[]): DistributionMetric;
+    distribution(id: string, attributes?: Record<string, string>): DistributionMetric;
     /**
      * Register a gauge using the provided supplier. The supplier will be polled
      * whenever the gauge value is flushed by the registry.
@@ -49,14 +56,14 @@ export interface MetricRegistry {
      * @param tagNameValuePairs Pairs of tag name and tag value
      * @returns Registration handle for the gauge
      */
-    gauge(id: string, supplier: () => number, ...tagNameValuePairs: string[]): GaugeMetric;
+    gauge(id: string, attributes?: Record<string, string>): Gauge;
     /**
      * Create a counter that will be incremented when an event occurs.
      *
      * @param id Metric identifier
      * @param attributes Counter attributes/tags
      */
-    counter(id: string, attributes: Record<string, string>): Counter;
+    counter(id: string, attributes?: Record<string, string>): Counter;
 }
 /**
  * No-op MetricRegistry that discards all metrics. Used as the default when

package/dist/MetricRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MetricRegistry.d.ts","sourceRoot":"","sources":["../src/MetricRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,0FAA0F;AAC1F,MAAM,WAAW,WAAW;CAAG;AAE/B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAAC;IAE7E;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,MAAM,EAAE,GAAG,iBAAiB,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;IAEvF;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;CAClE;AAMD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAUhC,CAAC"}
+{"version":3,"file":"MetricRegistry.d.ts","sourceRoot":"","sources":["../src/MetricRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;;;;;;;;CASZ,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,0FAA0F;AAC1F,MAAM,WAAW,KAAK;IACpB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;OAQG;IACH,YAAY,CACV,EAAE,EAAE,MAAM,EACV,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,kBAAkB,CAAC;IAEtB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAE9D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;CACnE;AAMD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAUhC,CAAC"}

package/dist/MetricRegistry.js

@@ -1,9 +1,15 @@
 /**
  * Common metric ids used by the limiters and limit algorithms.
+ *
+ * `CALL_NAME` records outcomes for work that actually executed under a limiter
+ * (status: `success`, `ignored`, `dropped`). `ACQUIRE_ATTEMPT_NAME` records
+ * acquire outcomes (status: `succeeded`, `failed`, `bypassed`), including
+ * failures from retry attempts.
  */
 export const MetricIds = {
     LIMIT_NAME: "limit",
     CALL_NAME: "call",
+    ACQUIRE_ATTEMPT_NAME: "acquire_attempt",
     INFLIGHT_NAME: "inflight",
     PARTITION_LIMIT_NAME: "limit.partition",
     MIN_RTT_NAME: "min_rtt",
@@ -12,7 +18,7 @@ export const MetricIds = {
 };
 const NOOP_SAMPLE_LISTENER = { addSample() { } };
 const NOOP_COUNTER = { increment() { } };
-const NOOP_GAUGE = {};
+const NOOP_GAUGE = { record() { } };
 /**
  * No-op MetricRegistry that discards all metrics. Used as the default when
  * no registry is configured.

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export type { AdaptiveLimit } from "./limit/StreamingLimit.js";
 export type { LimitAllotment } from "./LimitAllotment.js";
 export { Limiter, withLimiter, type AcquireOptions, type AcquireResult, type AcquireStrategy, type AllotmentUnavailableStrategy, type LimitedFunction, type LimiterOptions, type LimiterState, type MaybePromise, type RunCallbackArgs, } from "./Limiter.js";
 export { ListenerSet } from "./ListenerSet.js";
-export { MetricIds, NoopMetricRegistry, type Counter, type DistributionMetric, type GaugeMetric, type MetricRegistry, } from "./MetricRegistry.js";
+export { MetricIds, NoopMetricRegistry, type Counter, type DistributionMetric, type Gauge, type MetricRegistry, } from "./MetricRegistry.js";
 export { AdaptiveTimeoutError, dropped, ignore, isAdaptiveTimeoutError, isRunResult, QuotaNotAvailable, success, type RunDropped, type RunIgnore, type RunResult, type RunSuccess, } from "./RunResult.js";
 export { AIMDLimit, type AIMDLimitOptions } from "./limit/AIMDLimit.js";
 export { FixedLimit } from "./limit/FixedLimit.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,OAAO,EACP,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,4BAA4B,EACjC,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,OAAO,EACP,MAAM,EACN,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,aAAa,EACb,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAGtF,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,KAAK,+BAA+B,EACpC,KAAK,WAAW,GACjB,MAAM,yEAAyE,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,sEAAsE,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,6EAA6E,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,OAAO,EACP,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,4BAA4B,EACjC,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,KAAK,EACV,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,OAAO,EACP,MAAM,EACN,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,aAAa,EACb,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAGtF,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,KAAK,+BAA+B,EACpC,KAAK,WAAW,GACjB,MAAM,yEAAyE,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,sEAAsE,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,6EAA6E,CAAC"}

package/dist/limiter/acquire-strategies/PartitionedStrategy.js

@@ -150,8 +150,10 @@ class Partition {
             throw new Error("maxBurstMultiplier must be >= 1.0");
         }
         const registry = init.registry;
-        this.inflightDistribution = registry.distribution(MetricIds.INFLIGHT_NAME, PARTITION_TAG_NAME, this.name);
-        this.limitAtGlobalSaturationGauge = registry.gauge(MetricIds.PARTITION_LIMIT_NAME, () => this._limitAtGlobalSaturation, PARTITION_TAG_NAME, this.name);
+        this.inflightDistribution = registry.distribution(MetricIds.INFLIGHT_NAME, {
+            [PARTITION_TAG_NAME]: this.name,
+        });
+        this.limitAtGlobalSaturationGauge = registry.gauge(MetricIds.PARTITION_LIMIT_NAME, { [PARTITION_TAG_NAME]: this.name });
     }
     /**
      * Recompute this partition's limitAtGlobalSaturation from global limit.
@@ -161,6 +163,7 @@ class Partition {
      */
     updateLimitAtGlobalSaturation(totalGlobalLimit) {
         this._limitAtGlobalSaturation = partitionLimitAtGlobalSaturationForGlobal(totalGlobalLimit, this.percent);
+        this.limitAtGlobalSaturationGauge.record(this._limitAtGlobalSaturation);
     }
     get limitAtGlobalSaturation() {
         return this._limitAtGlobalSaturation;

package/package.json

@@ -9,7 +9,7 @@
     "dynamic rate limiting"
   ],
   "author": "Ethan Resnick <ethan.resnick@gmail.com>",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "type": "module",
   "exports": {
     ".": {
@@ -26,6 +26,7 @@
     "prepublishOnly": "pnpm build"
   },
   "devDependencies": {
+    "@types/node": "^25.5.0",
     "tsx": "^4.19.0",
     "type-fest": "^5.5.0",
     "type-party": "^0.7.3",

package/dist/limiter/allocation-unavailable-strategies/FifoBlockingRejection.d.ts

@@ -1,30 +0,0 @@
-import type { AcquireResult, AllotmentUnavailableStrategy } from "../../Limiter.js";
-export type FifoBlockingRejectionOptions<ContextT> = {
-    /**
-     * Maximum number of blocked callers in the backlog.
-     * Default: unbounded
-     */
-    backlogSize?: number | undefined;
-    /**
-     * Maximum timeout for callers blocked on the limiter, in milliseconds.
-     * Can be a fixed number or a function that derives the timeout from the
-     * request context (e.g. from a deadline). Default: 3_600_000 (1 hour).
-     */
-    backlogTimeout?: number | ((context: ContextT) => number) | undefined;
-};
-/**
- * Rejection strategy that blocks the caller in a FIFO queue when the limit
- * has been reached, waiting for a slot to open up. This strategy favors
- * fairness: callers are served in the order they arrived.
- *
- * Because JavaScript is single-threaded, "blocking" means awaiting a promise
- * that resolves when a token becomes available.
- */
-export declare class FifoBlockingRejection<ContextT> implements AllotmentUnavailableStrategy<ContextT> {
-    private readonly delegate;
-    constructor(options?: FifoBlockingRejectionOptions<ContextT>);
-    onAllotmentUnavailable(context: ContextT, retry: (context: ContextT) => AcquireResult, signal?: AbortSignal): Promise<import("../../LimitAllotment.js").LimitAllotment | undefined>;
-    onAllotmentReleased(): Promise<void>;
-    onLimitChanged(oldLimit: number, newLimit: number): void;
-}
-//# sourceMappingURL=FifoBlockingRejection.d.ts.map

package/dist/limiter/allocation-unavailable-strategies/FifoBlockingRejection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FifoBlockingRejection.d.ts","sourceRoot":"","sources":["../../../src/limiter/allocation-unavailable-strategies/FifoBlockingRejection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,4BAA4B,EAC7B,MAAM,kBAAkB,CAAC;AAO1B,MAAM,MAAM,4BAA4B,CAAC,QAAQ,IAAI;IACnD;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;CACvE,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,qBAAqB,CAChC,QAAQ,CACR,YAAW,4BAA4B,CAAC,QAAQ,CAAC;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;gBAElD,OAAO,GAAE,4BAA4B,CAAC,QAAQ,CAAM;IAQhE,sBAAsB,CACpB,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,aAAa,EAC3C,MAAM,CAAC,EAAE,WAAW;IAKtB,mBAAmB;IAInB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAGzD"}

package/dist/limiter/allocation-unavailable-strategies/FifoBlockingRejection.js

@@ -1,29 +0,0 @@
-import { LinkedWaiterQueue } from "../../utils/LinkedWaiterQueue.js";
-import { BlockingBacklogRejection, MAX_TIMEOUT, } from "./BlockingBacklogRejection.js";
-/**
- * Rejection strategy that blocks the caller in a FIFO queue when the limit
- * has been reached, waiting for a slot to open up. This strategy favors
- * fairness: callers are served in the order they arrived.
- *
- * Because JavaScript is single-threaded, "blocking" means awaiting a promise
- * that resolves when a token becomes available.
- */
-export class FifoBlockingRejection {
-    delegate;
-    constructor(options = {}) {
-        this.delegate = new BlockingBacklogRejection({
-            backlogSize: options.backlogSize ?? Number.POSITIVE_INFINITY,
-            backlogTimeout: options.backlogTimeout ?? MAX_TIMEOUT,
-            queue: new LinkedWaiterQueue("back"),
-        });
-    }
-    onAllotmentUnavailable(context, retry, signal) {
-        return this.delegate.onAllotmentUnavailable(context, retry, signal);
-    }
-    onAllotmentReleased() {
-        return this.delegate.onAllotmentReleased();
-    }
-    onLimitChanged(oldLimit, newLimit) {
-        this.delegate.onLimitChanged(oldLimit, newLimit);
-    }
-}

package/dist/limiter/allocation-unavailable-strategies/LifoBlockingRejection.d.ts

@@ -1,27 +0,0 @@
-import type { AcquireResult, AllotmentUnavailableStrategy } from "../../Limiter.js";
-export interface LifoBlockingRejectionOptions<ContextT> {
-    /**
-     * Maximum number of blocked callers in the backlog. Default: 100
-     */
-    backlogSize?: number | undefined;
-    /**
-     * Maximum timeout for callers blocked on the limiter, in milliseconds.
-     * Can be a fixed number or a function that derives the timeout from the
-     * request context (e.g. from a deadline). Default: 1000
-     */
-    backlogTimeout?: number | ((context: ContextT) => number) | undefined;
-}
-/**
- * Rejection strategy that blocks the caller in a LIFO queue when the limit
- * has been reached. This strategy favors availability over latency by
- * processing the most recently blocked request first, keeping success
- * latencies low and minimizing timeouts.
- */
-export declare class LifoBlockingRejection<ContextT> implements AllotmentUnavailableStrategy<ContextT> {
-    private readonly delegate;
-    constructor(options?: LifoBlockingRejectionOptions<ContextT>);
-    onAllotmentUnavailable(context: ContextT, retry: (context: ContextT) => AcquireResult, signal?: AbortSignal): Promise<import("../../LimitAllotment.js").LimitAllotment | undefined>;
-    onAllotmentReleased(): Promise<void>;
-    onLimitChanged(oldLimit: number, newLimit: number): void;
-}
-//# sourceMappingURL=LifoBlockingRejection.d.ts.map

package/dist/limiter/allocation-unavailable-strategies/LifoBlockingRejection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LifoBlockingRejection.d.ts","sourceRoot":"","sources":["../../../src/limiter/allocation-unavailable-strategies/LifoBlockingRejection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,4BAA4B,EAC7B,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,4BAA4B,CAAC,QAAQ;IACpD;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;CACvE;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB,CAChC,QAAQ,CACR,YAAW,4BAA4B,CAAC,QAAQ,CAAC;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;gBAElD,OAAO,GAAE,4BAA4B,CAAC,QAAQ,CAAM;IAQhE,sBAAsB,CACpB,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,aAAa,EAC3C,MAAM,CAAC,EAAE,WAAW;IAKtB,mBAAmB;IAInB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAGzD"}

package/dist/limiter/allocation-unavailable-strategies/LifoBlockingRejection.js

@@ -1,27 +0,0 @@
-import { LinkedWaiterQueue } from "../../utils/LinkedWaiterQueue.js";
-import { BlockingBacklogRejection, } from "./BlockingBacklogRejection.js";
-/**
- * Rejection strategy that blocks the caller in a LIFO queue when the limit
- * has been reached. This strategy favors availability over latency by
- * processing the most recently blocked request first, keeping success
- * latencies low and minimizing timeouts.
- */
-export class LifoBlockingRejection {
-    delegate;
-    constructor(options = {}) {
-        this.delegate = new BlockingBacklogRejection({
-            backlogSize: options.backlogSize ?? 100,
-            backlogTimeout: options.backlogTimeout ?? 1_000,
-            queue: new LinkedWaiterQueue("front"),
-        });
-    }
-    onAllotmentUnavailable(context, retry, signal) {
-        return this.delegate.onAllotmentUnavailable(context, retry, signal);
-    }
-    onAllotmentReleased() {
-        return this.delegate.onAllotmentReleased();
-    }
-    onLimitChanged(oldLimit, newLimit) {
-        this.delegate.onLimitChanged(oldLimit, newLimit);
-    }
-}