@aster-rpc/aster 0.1.2

package/dist/interceptors/circuit-breaker.js

@@ -0,0 +1,91 @@
+/**
+ * Circuit breaker interceptor — stops sending requests to failing services.
+ *
+ * States: CLOSED (normal) -> OPEN (failing) -> HALF_OPEN (probe) -> CLOSED
+ */
+import { RpcError, StatusCode } from '../status.js';
+export class CircuitBreakerInterceptor {
+    state = 'closed';
+    failures = 0;
+    lastFailure = 0;
+    halfOpenCalls = 0;
+    failureThreshold;
+    resetTimeoutMs;
+    halfOpenMaxCalls;
+    constructor(opts = {}) {
+        this.failureThreshold = opts.failureThreshold ?? 5;
+        this.resetTimeoutMs = opts.resetTimeoutMs ?? 30_000;
+        this.halfOpenMaxCalls = opts.halfOpenMaxCalls ?? 1;
+    }
+    async onRequest(_ctx, request) {
+        if (this.state === 'open') {
+            if (Date.now() - this.lastFailure > this.resetTimeoutMs) {
+                this.state = 'half_open';
+                this.halfOpenCalls = 0;
+            }
+            else {
+                throw new RpcError(StatusCode.UNAVAILABLE, 'circuit breaker is open');
+            }
+        }
+        if (this.state === 'half_open' && this.halfOpenCalls >= this.halfOpenMaxCalls) {
+            throw new RpcError(StatusCode.UNAVAILABLE, 'circuit breaker half-open limit reached');
+        }
+        if (this.state === 'half_open')
+            this.halfOpenCalls++;
+        return request;
+    }
+    async onResponse(_ctx, response) {
+        if (this.state === 'half_open') {
+            this.state = 'closed';
+            this.failures = 0;
+        }
+        return response;
+    }
+    async onError(_ctx, error) {
+        this.failures++;
+        this.lastFailure = Date.now();
+        if (this.failures >= this.failureThreshold) {
+            this.state = 'open';
+        }
+        return error;
+    }
+    /** Current circuit state. */
+    get currentState() {
+        return this.state;
+    }
+    /**
+     * Pre-call gate check — throws if circuit is open.
+     * Alias for the logic in onRequest(), callable without a full call context.
+     */
+    beforeCall() {
+        if (this.state === 'open') {
+            if (Date.now() - this.lastFailure > this.resetTimeoutMs) {
+                this.state = 'half_open';
+                this.halfOpenCalls = 0;
+            }
+            else {
+                throw new RpcError(StatusCode.UNAVAILABLE, 'circuit breaker is open');
+            }
+        }
+        if (this.state === 'half_open' && this.halfOpenCalls >= this.halfOpenMaxCalls) {
+            throw new RpcError(StatusCode.UNAVAILABLE, 'circuit breaker half-open limit reached');
+        }
+        if (this.state === 'half_open')
+            this.halfOpenCalls++;
+    }
+    /** Record a successful call — resets the failure count. */
+    recordSuccess() {
+        if (this.state === 'half_open')
+            this.state = 'closed';
+        this.failures = 0;
+    }
+    /** Record a failed call — may open the circuit. */
+    recordFailure() {
+        this.failures++;
+        this.lastFailure = Date.now();
+        if (this.failures >= this.failureThreshold) {
+            this.state = 'open';
+        }
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/interceptors/circuit-breaker.js.map

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

package/dist/interceptors/compression.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Compression interceptor — manages payload compression negotiation.
+ */
+import type { Interceptor } from './base.js';
+import { CallContext } from './base.js';
+export declare class CompressionInterceptor implements Interceptor {
+    readonly threshold: number;
+    constructor(threshold?: number);
+    onRequest(ctx: CallContext, request: unknown): Promise<unknown>;
+}
+//# sourceMappingURL=compression.d.ts.map

package/dist/interceptors/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/interceptors/compression.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,qBAAa,sBAAuB,YAAW,WAAW;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBACf,SAAS,SAAO;IAEtB,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAItE"}

package/dist/interceptors/compression.js

@@ -0,0 +1,12 @@
+/**
+ * Compression interceptor — manages payload compression negotiation.
+ */
+export class CompressionInterceptor {
+    threshold;
+    constructor(threshold = 4096) { this.threshold = threshold; }
+    async onRequest(ctx, request) {
+        ctx.metadata['accept-encoding'] = 'zstd';
+        return request;
+    }
+}
+//# sourceMappingURL=compression.js.map

package/dist/interceptors/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["../../src/interceptors/compression.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,OAAO,sBAAsB;IACxB,SAAS,CAAS;IAC3B,YAAY,SAAS,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC;IAE7D,KAAK,CAAC,SAAS,CAAC,GAAgB,EAAE,OAAgB;QAChD,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAAC;QACzC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/interceptors/deadline.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Deadline enforcement interceptor. Spec S6.8.1.
+ */
+import type { Interceptor } from './base.js';
+import { CallContext } from './base.js';
+export declare class DeadlineInterceptor implements Interceptor {
+    private skewToleranceMs;
+    constructor(skewToleranceMs?: number);
+    onRequest(ctx: CallContext, request: unknown): Promise<unknown>;
+    timeoutSeconds(ctx: CallContext): number | undefined;
+}
+//# sourceMappingURL=deadline.d.ts.map

package/dist/interceptors/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../src/interceptors/deadline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,eAAe,CAAS;gBAEpB,eAAe,SAAO;IAI5B,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBrE,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS;CAIrD"}

package/dist/interceptors/deadline.js

@@ -0,0 +1,28 @@
+/**
+ * Deadline enforcement interceptor. Spec S6.8.1.
+ */
+import { RpcError, StatusCode } from '../status.js';
+export class DeadlineInterceptor {
+    skewToleranceMs;
+    constructor(skewToleranceMs = 5000) {
+        this.skewToleranceMs = skewToleranceMs;
+    }
+    async onRequest(ctx, request) {
+        if (ctx.deadline !== undefined) {
+            const nowMs = Date.now();
+            const deadlineMs = ctx.deadline * 1000;
+            if (nowMs > deadlineMs + this.skewToleranceMs) {
+                throw new RpcError(StatusCode.DEADLINE_EXCEEDED, `deadline already expired on receipt (skew_tolerance=${this.skewToleranceMs}ms)`);
+            }
+            if (ctx.expired) {
+                throw new RpcError(StatusCode.DEADLINE_EXCEEDED, 'deadline exceeded');
+            }
+        }
+        return request;
+    }
+    timeoutSeconds(ctx) {
+        const remaining = ctx.remainingSeconds;
+        return remaining !== undefined ? Math.max(0, remaining) : undefined;
+    }
+}
+//# sourceMappingURL=deadline.js.map

package/dist/interceptors/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../../src/interceptors/deadline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,OAAO,mBAAmB;IACtB,eAAe,CAAS;IAEhC,YAAY,eAAe,GAAG,IAAI;QAChC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAgB,EAAE,OAAgB;QAChD,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvC,IAAI,KAAK,GAAG,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC9C,MAAM,IAAI,QAAQ,CAChB,UAAU,CAAC,iBAAiB,EAC5B,uDAAuD,IAAI,CAAC,eAAe,KAAK,CACjF,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,cAAc,CAAC,GAAgB;QAC7B,MAAM,SAAS,GAAG,GAAG,CAAC,gBAAgB,CAAC;QACvC,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;CACF"}

package/dist/interceptors/metrics.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Metrics interceptor with optional OpenTelemetry integration.
+ *
+ * Collects RED metrics (Rate, Errors, Duration). Falls back to
+ * in-memory counters when OTel is not installed.
+ */
+import type { Interceptor } from './base.js';
+import { CallContext } from './base.js';
+import type { RpcError } from '../status.js';
+export declare class MetricsInterceptor implements Interceptor {
+    started: number;
+    succeeded: number;
+    failed: number;
+    inFlight: number;
+    /** Total duration of all completed RPCs in seconds (for computing averages). */
+    totalDurationS: number;
+    /** Duration of the last completed RPC in seconds. */
+    lastDurationS: number;
+    private startTimes;
+    private _tracer;
+    private _meter;
+    private _startedCounter;
+    private _completedCounter;
+    private _durationHistogram;
+    constructor();
+    /** Whether OpenTelemetry is available and configured. */
+    get hasOtel(): boolean;
+    onRequest(ctx: CallContext, request: unknown): Promise<unknown>;
+    onResponse(ctx: CallContext, response: unknown): Promise<unknown>;
+    onError(ctx: CallContext, error: RpcError): Promise<RpcError>;
+    /** Snapshot of current metrics. */
+    snapshot(): {
+        started: number;
+        succeeded: number;
+        failed: number;
+        inFlight: number;
+        totalDurationS: number;
+        lastDurationS: number;
+    };
+    /** Reset all counters. */
+    reset(): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/interceptors/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/interceptors/metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,SAAK;IACZ,SAAS,SAAK;IACd,MAAM,SAAK;IACX,QAAQ,SAAK;IAEb,gFAAgF;IAChF,cAAc,SAAK;IACnB,qDAAqD;IACrD,aAAa,SAAK;IAElB,OAAO,CAAC,UAAU,CAA6B;IAG/C,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,kBAAkB,CAAiB;;IAyB3C,yDAAyD;IACzD,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAa/D,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BjE,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8BnE,mCAAmC;IACnC,QAAQ,IAAI;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB;IAWD,0BAA0B;IAC1B,KAAK,IAAI,IAAI;CASd"}

package/dist/interceptors/metrics.js

@@ -0,0 +1,132 @@
+/**
+ * Metrics interceptor with optional OpenTelemetry integration.
+ *
+ * Collects RED metrics (Rate, Errors, Duration). Falls back to
+ * in-memory counters when OTel is not installed.
+ */
+export class MetricsInterceptor {
+    started = 0;
+    succeeded = 0;
+    failed = 0;
+    inFlight = 0;
+    /** Total duration of all completed RPCs in seconds (for computing averages). */
+    totalDurationS = 0;
+    /** Duration of the last completed RPC in seconds. */
+    lastDurationS = 0;
+    startTimes = new Map();
+    // Optional OTel integration
+    _tracer = null;
+    _meter = null;
+    _startedCounter = null;
+    _completedCounter = null;
+    _durationHistogram = null;
+    constructor() {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { trace, metrics } = require('@opentelemetry/api');
+            this._tracer = trace.getTracer('aster.rpc', '0.1.0');
+            this._meter = metrics.getMeter('aster.rpc', '0.1.0');
+            this._startedCounter = this._meter.createCounter('aster.rpc.started', {
+                description: 'Total RPC calls started',
+                unit: '1',
+            });
+            this._completedCounter = this._meter.createCounter('aster.rpc.completed', {
+                description: 'Total RPC calls completed',
+                unit: '1',
+            });
+            this._durationHistogram = this._meter.createHistogram('aster.rpc.duration', {
+                description: 'RPC call duration',
+                unit: 's',
+            });
+        }
+        catch {
+            // OTel not installed — use fallback counters
+        }
+    }
+    /** Whether OpenTelemetry is available and configured. */
+    get hasOtel() {
+        return this._tracer !== null;
+    }
+    async onRequest(ctx, request) {
+        this.started++;
+        this.inFlight++;
+        this.startTimes.set(ctx.callId, performance.now());
+        if (this._startedCounter) {
+            const labels = { service: ctx.service, method: ctx.method, pattern: ctx.pattern ?? 'unary' };
+            this._startedCounter.add(1, labels);
+        }
+        return request;
+    }
+    async onResponse(ctx, response) {
+        this.succeeded++;
+        this.inFlight--;
+        const startTime = this.startTimes.get(ctx.callId);
+        if (startTime !== undefined) {
+            const durationS = (performance.now() - startTime) / 1000;
+            this.totalDurationS += durationS;
+            this.lastDurationS = durationS;
+            this.startTimes.delete(ctx.callId);
+            if (this._durationHistogram) {
+                this._durationHistogram.record(durationS, {
+                    service: ctx.service,
+                    method: ctx.method,
+                });
+            }
+        }
+        if (this._completedCounter) {
+            this._completedCounter.add(1, {
+                service: ctx.service,
+                method: ctx.method,
+                status: 'OK',
+            });
+        }
+        return response;
+    }
+    async onError(ctx, error) {
+        this.failed++;
+        this.inFlight--;
+        const startTime = this.startTimes.get(ctx.callId);
+        if (startTime !== undefined) {
+            const durationS = (performance.now() - startTime) / 1000;
+            this.totalDurationS += durationS;
+            this.lastDurationS = durationS;
+            this.startTimes.delete(ctx.callId);
+            if (this._durationHistogram) {
+                this._durationHistogram.record(durationS, {
+                    service: ctx.service,
+                    method: ctx.method,
+                });
+            }
+        }
+        if (this._completedCounter) {
+            this._completedCounter.add(1, {
+                service: ctx.service,
+                method: ctx.method,
+                status: String(error.code ?? 'UNKNOWN'),
+            });
+        }
+        return error;
+    }
+    /** Snapshot of current metrics. */
+    snapshot() {
+        return {
+            started: this.started,
+            succeeded: this.succeeded,
+            failed: this.failed,
+            inFlight: this.inFlight,
+            totalDurationS: this.totalDurationS,
+            lastDurationS: this.lastDurationS,
+        };
+    }
+    /** Reset all counters. */
+    reset() {
+        this.started = 0;
+        this.succeeded = 0;
+        this.failed = 0;
+        this.inFlight = 0;
+        this.totalDurationS = 0;
+        this.lastDurationS = 0;
+        this.startTimes.clear();
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/interceptors/metrics.js.map

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

package/dist/interceptors/rate-limit.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Token-bucket rate limit interceptor.
+ *
+ * Enforces rate limits at global, per-service, per-method, and per-peer granularity.
+ */
+import type { Interceptor } from './base.js';
+import { CallContext } from './base.js';
+export interface RateLimitOptions {
+    globalRps?: number;
+    perServiceRps?: number;
+    perMethodRps?: number;
+    perPeerRps?: number;
+}
+export declare class RateLimitInterceptor implements Interceptor {
+    private global;
+    private perService;
+    private perMethod;
+    private perPeer;
+    private opts;
+    constructor(opts?: RateLimitOptions);
+    onRequest(ctx: CallContext, request: unknown): Promise<unknown>;
+    private getOrCreate;
+}
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/interceptors/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/interceptors/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAgCxC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,oBAAqB,YAAW,WAAW;IACtD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,IAAI,CAA6B;gBAE7B,IAAI,GAAE,gBAAqB;IAYjC,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BrE,OAAO,CAAC,WAAW;CAQpB"}

package/dist/interceptors/rate-limit.js

@@ -0,0 +1,84 @@
+/**
+ * Token-bucket rate limit interceptor.
+ *
+ * Enforces rate limits at global, per-service, per-method, and per-peer granularity.
+ */
+import { RpcError, StatusCode } from '../status.js';
+class TokenBucket {
+    rps;
+    maxBurst;
+    tokens;
+    lastRefill;
+    constructor(rps, maxBurst) {
+        this.rps = rps;
+        this.maxBurst = maxBurst;
+        this.tokens = maxBurst;
+        this.lastRefill = performance.now();
+    }
+    tryConsume() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return true;
+        }
+        return false;
+    }
+    refill() {
+        const now = performance.now();
+        const elapsed = (now - this.lastRefill) / 1000;
+        this.tokens = Math.min(this.maxBurst, this.tokens + elapsed * this.rps);
+        this.lastRefill = now;
+    }
+}
+export class RateLimitInterceptor {
+    global;
+    perService = new Map();
+    perMethod = new Map();
+    perPeer = new Map();
+    opts;
+    constructor(opts = {}) {
+        this.opts = {
+            globalRps: opts.globalRps ?? 0,
+            perServiceRps: opts.perServiceRps ?? 0,
+            perMethodRps: opts.perMethodRps ?? 0,
+            perPeerRps: opts.perPeerRps ?? 0,
+        };
+        if (this.opts.globalRps > 0) {
+            this.global = new TokenBucket(this.opts.globalRps, this.opts.globalRps * 2);
+        }
+    }
+    async onRequest(ctx, request) {
+        if (this.global && !this.global.tryConsume()) {
+            throw new RpcError(StatusCode.RESOURCE_EXHAUSTED, 'global rate limit exceeded');
+        }
+        if (this.opts.perServiceRps > 0) {
+            const bucket = this.getOrCreate(this.perService, ctx.service, this.opts.perServiceRps);
+            if (!bucket.tryConsume()) {
+                throw new RpcError(StatusCode.RESOURCE_EXHAUSTED, `rate limit exceeded for service ${ctx.service}`);
+            }
+        }
+        if (this.opts.perMethodRps > 0) {
+            const key = `${ctx.service}/${ctx.method}`;
+            const bucket = this.getOrCreate(this.perMethod, key, this.opts.perMethodRps);
+            if (!bucket.tryConsume()) {
+                throw new RpcError(StatusCode.RESOURCE_EXHAUSTED, `rate limit exceeded for ${key}`);
+            }
+        }
+        if (this.opts.perPeerRps > 0 && ctx.peer) {
+            const bucket = this.getOrCreate(this.perPeer, ctx.peer, this.opts.perPeerRps);
+            if (!bucket.tryConsume()) {
+                throw new RpcError(StatusCode.RESOURCE_EXHAUSTED, `rate limit exceeded for peer ${ctx.peer}`);
+            }
+        }
+        return request;
+    }
+    getOrCreate(map, key, rps) {
+        let bucket = map.get(key);
+        if (!bucket) {
+            bucket = new TokenBucket(rps, rps * 2);
+            map.set(key, bucket);
+        }
+        return bucket;
+    }
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/interceptors/rate-limit.js.map

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

package/dist/interceptors/retry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Retry interceptor with exponential backoff.
+ *
+ * Only retries idempotent calls on retryable status codes.
+ */
+import type { Interceptor } from './base.js';
+import { CallContext } from './base.js';
+import { RpcError } from '../status.js';
+import { type RetryPolicy } from '../types.js';
+export declare class RetryInterceptor implements Interceptor {
+    private policy;
+    constructor(policy?: Partial<RetryPolicy>);
+    onError(ctx: CallContext, error: RpcError): Promise<RpcError>;
+    private backoffMs;
+    /**
+     * Decide if a call should be retried.
+     * Returns true if the error is retryable, call is idempotent, and attempts remain.
+     */
+    shouldRetry(error: RpcError, attempt: number, idempotent?: boolean): boolean;
+    /**
+     * Compute backoff duration in seconds for the given attempt number.
+     */
+    backoffSeconds(attempt: number): number;
+}
+//# sourceMappingURL=retry.d.ts.map

package/dist/interceptors/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/interceptors/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAc,MAAM,cAAc,CAAC;AACpD,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAS9D,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAInC,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWnE,OAAO,CAAC,SAAS;IAOjB;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO;IAM1E;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGxC"}

package/dist/interceptors/retry.js

@@ -0,0 +1,55 @@
+/**
+ * Retry interceptor with exponential backoff.
+ *
+ * Only retries idempotent calls on retryable status codes.
+ */
+import { StatusCode } from '../status.js';
+import { DEFAULT_RETRY } from '../types.js';
+const RETRYABLE_CODES = new Set([
+    StatusCode.UNAVAILABLE,
+    StatusCode.DEADLINE_EXCEEDED,
+    StatusCode.ABORTED,
+    StatusCode.RESOURCE_EXHAUSTED,
+]);
+export class RetryInterceptor {
+    policy;
+    constructor(policy) {
+        this.policy = { ...DEFAULT_RETRY, ...policy };
+    }
+    async onError(ctx, error) {
+        if (!ctx.idempotent)
+            return error;
+        if (!RETRYABLE_CODES.has(error.code))
+            return error;
+        if (ctx.attempt >= this.policy.maxAttempts)
+            return error;
+        // Signal retry by attaching metadata
+        error.details['retry_after_ms'] = String(this.backoffMs(ctx.attempt));
+        error.details['retry_attempt'] = String(ctx.attempt);
+        return error;
+    }
+    backoffMs(attempt) {
+        const { initialMs, multiplier, maxMs, jitter } = this.policy.backoff;
+        const base = Math.min(initialMs * Math.pow(multiplier, attempt - 1), maxMs);
+        const jitterAmount = base * jitter * (Math.random() * 2 - 1);
+        return Math.max(0, Math.round(base + jitterAmount));
+    }
+    /**
+     * Decide if a call should be retried.
+     * Returns true if the error is retryable, call is idempotent, and attempts remain.
+     */
+    shouldRetry(error, attempt, idempotent = false) {
+        if (!idempotent)
+            return false;
+        if (!RETRYABLE_CODES.has(error.code))
+            return false;
+        return attempt < this.policy.maxAttempts;
+    }
+    /**
+     * Compute backoff duration in seconds for the given attempt number.
+     */
+    backoffSeconds(attempt) {
+        return this.backoffMs(attempt) / 1000;
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/interceptors/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/interceptors/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAY,UAAU,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAE9D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS;IACtC,UAAU,CAAC,WAAW;IACtB,UAAU,CAAC,iBAAiB;IAC5B,UAAU,CAAC,OAAO;IAClB,UAAU,CAAC,kBAAkB;CAC9B,CAAC,CAAC;AAEH,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAc;IAE5B,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAgB,EAAE,KAAe;QAC7C,IAAI,CAAC,GAAG,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACnD,IAAI,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAEzD,qCAAqC;QACrC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QACtE,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,SAAS,CAAC,OAAe;QAC/B,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACrE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5E,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,KAAe,EAAE,OAAe,EAAE,UAAU,GAAG,KAAK;QAC9D,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAC9B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACnD,OAAO,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,CAAC;CACF"}