gemi 0.148.0 → 0.149.0

package/dist/services/rate-limiter/drivers/RedisRateLimiterDriver.d.ts

@@ -24,9 +24,22 @@ export interface RedisRateLimiterOptions {
      * one (payments, sign-up, anything that costs money per call).
      */
     failOpen?: boolean;
+    /**
+     * How long one `consume` may wait for Redis, in ms, before it gives up and
+     * follows `failOpen`. Default `250`. Without it, a request waits as long as
+     * the client does: up to the connect timeout and the reconnect loop (10 to
+     * 30 s) while Redis is down, and with no limit when Redis stops answering on
+     * an open connection. `0` turns it off.
+     */
+    timeout?: number;
     /** Called with every Redis failure. Defaults to `console.error`. */
     onError?: (error: unknown) => void;
 }
+/** What `onError` gets when a `consume` ran past `timeout`. */
+export declare class RedisRateLimiterTimeoutError extends Error {
+    readonly code = "ERR_RATE_LIMITER_TIMEOUT";
+    constructor(timeout: number);
+}
 /**
  * Rate limiter backed by Redis, so every instance of the app counts against the
  * same budget. Use it as soon as you run more than one process.
@@ -48,11 +61,19 @@ export declare class RedisRateLimiter extends RateLimiterDriver {
     private injectedClient?;
     private prefix;
     private failOpen;
+    private timeout;
     private onError;
     /** Cached `SCRIPT LOAD` result, so the script body is sent at most once. */
     private scriptSha;
     constructor(options?: RedisRateLimiterOptions);
     consume(params: ConsumeParams): Promise<RateLimitResult>;
+    /**
+     * Settles with `work`, or rejects with `RedisRateLimiterTimeoutError` once
+     * `timeout` passes. The command itself is not cancelled (Redis may still run
+     * the script, so a request that timed out can still be counted); its late
+     * outcome is ignored.
+     */
+    private withTimeout;
     private get client();
     /** Runs the script by digest, loading it on first use and after a flush. */
     private run;

package/dist/services/rate-limiter/drivers/RedisRateLimiterDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RedisRateLimiterDriver.d.ts","sourceRoot":"","sources":["../../../../services/rate-limiter/drivers/RedisRateLimiterDriver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAyCD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrD,OAAO,CAAC,cAAc,CAAC,CAAyB;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,OAAO,CAA2B;IAE1C,4EAA4E;IAC5E,OAAO,CAAC,SAAS,CAAgC;gBAErC,OAAO,GAAE,uBAA4B;IAQ3C,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAwD9D,OAAO,KAAK,MAAM,GAuBjB;IAED,4EAA4E;YAC9D,GAAG;IAejB,OAAO,CAAC,IAAI;CAcb"}
+{"version":3,"file":"RedisRateLimiterDriver.d.ts","sourceRoot":"","sources":["../../../../services/rate-limiter/drivers/RedisRateLimiterDriver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,+DAA+D;AAC/D,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,8BAA8B;gBAE/B,OAAO,EAAE,MAAM;CAI5B;AAyCD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrD,OAAO,CAAC,cAAc,CAAC,CAAyB;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAA2B;IAE1C,4EAA4E;IAC5E,OAAO,CAAC,SAAS,CAAgC;gBAErC,OAAO,GAAE,uBAA4B;IAS3C,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IA0D9D;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAkBnB,OAAO,KAAK,MAAM,GAuBjB;IAED,4EAA4E;YAC9D,GAAG;IAejB,OAAO,CAAC,IAAI;CAcb"}

package/dist/services/redis/RedisManager.d.ts

@@ -4,13 +4,30 @@ export declare class RedisManager {
     config: RedisConfig;
     static token: string;
     private instance;
+    /** When the connect the manager started on `instance` began, while it is pending. */
+    private connectingSince;
+    /** When `instance` was first seen down, after its connect settled. */
+    private downSince;
+    /** How long a client must be down before it is replaced. */
+    private replaceDelay;
     constructor(config?: RedisConfig);
     /**
-     * Bun's Redis client. Built on first access and memoized.
+     * Bun's Redis client. Built on first access and memoized; building it starts
+     * the connection, which the first command would do anyway.
      *
-     * It connects lazily on the first command, so building it here is safe even
-     * when Redis isn't running or configured — nothing connects until something
-     * actually issues a command.
+     * Once Bun's client gives up on a connection (a connect timeout, or
+     * `maxRetries` reconnects in a row) it never connects again, and every later
+     * command fails at once with `Connection has failed`, even after Redis is
+     * back (#982); calling its `connect()` again can hang. So an access that
+     * finds the client down replaces it: the old one is closed and a new one
+     * built. A client is down when it is not connected and no connect the
+     * manager started on it is still pending. It gets a grace period first, so a
+     * blip that Bun's own reconnect covers costs nothing: 0.5 s, doubling with
+     * each replacement that does not connect, up to 10 s, and back to 0.5 s once
+     * one connects. So a Redis that stays down is tried at most every 10 s.
+     *
+     * Read `client` each time rather than keeping it: a kept reference can be a
+     * client that was replaced and closed.
      */
     get client(): RedisClient;
     /**
@@ -27,5 +44,7 @@ export declare class RedisManager {
      * Does not build one to close it.
      */
     close(): void;
+    private build;
+    private isDown;
 }
 //# sourceMappingURL=RedisManager.d.ts.map

package/dist/services/redis/RedisManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RedisManager.d.ts","sourceRoot":"","sources":["../../../services/redis/RedisManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,KAAK,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAsB5C,qBAAa,YAAY;IAKJ,MAAM,EAAE,WAAW;IAJtC,MAAM,CAAC,KAAK,SAAW;IAEvB,OAAO,CAAC,QAAQ,CAA4B;gBAEzB,MAAM,GAAE,WAAgB;IAE3C;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,WAAW,CAKxB;IAED;;;;;;;OAOG;IACH,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,EAE7B;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;CAKd"}
+{"version":3,"file":"RedisManager.d.ts","sourceRoot":"","sources":["../../../services/redis/RedisManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,KAAK,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA+B5C,qBAAa,YAAY;IAYJ,MAAM,EAAE,WAAW;IAXtC,MAAM,CAAC,KAAK,SAAW;IAEvB,OAAO,CAAC,QAAQ,CAA4B;IAE5C,qFAAqF;IACrF,OAAO,CAAC,eAAe,CAAuB;IAC9C,sEAAsE;IACtE,OAAO,CAAC,SAAS,CAAuB;IACxC,4DAA4D;IAC5D,OAAO,CAAC,YAAY,CAAwB;gBAEzB,MAAM,GAAE,WAAgB;IAE3C;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,MAAM,IAAI,WAAW,CAYxB;IAED;;;;;;;OAOG;IACH,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,EAK7B;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,KAAK;IAqCb,OAAO,CAAC,MAAM;CAqBf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gemi",
-  "version": "0.148.0",
+  "version": "0.149.0",
   "private": false,
   "license": "MIT",
   "author": "Enes Tufekci <enes@gemijs.dev>",