@upstash/redis 0.0.0-ci.b4d4a1cc → 0.0.0-ci.b984c0e9-20220826

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +36 -274
  2. package/esm/deps/deno.land/x/base64@v0.2.1/base.js +100 -0
  3. package/esm/deps/deno.land/x/base64@v0.2.1/base64url.js +9 -0
  4. package/esm/deps/deno.land/x/sha1@v1.0.3/deps.js +1 -0
  5. package/esm/deps/deno.land/x/sha1@v1.0.3/mod.js +191 -0
  6. package/esm/deps/denopkg.com/chiefbiiko/std-encoding@v1.0.0/mod.js +50 -0
  7. package/esm/pkg/commands/lpos.js +19 -0
  8. package/esm/pkg/commands/mod.js +1 -0
  9. package/esm/pkg/commands/scan.js +3 -0
  10. package/esm/pkg/commands/sdiffstore.js +1 -1
  11. package/esm/pkg/commands/set.js +16 -4
  12. package/esm/pkg/commands/zrange.js +6 -0
  13. package/esm/pkg/http.js +35 -7
  14. package/esm/pkg/pipeline.js +10 -1
  15. package/esm/pkg/redis.js +26 -1
  16. package/esm/pkg/script.js +77 -0
  17. package/esm/platforms/cloudflare.js +5 -25
  18. package/esm/platforms/fastly.js +4 -25
  19. package/esm/platforms/node_with_fetch.js +4 -25
  20. package/esm/platforms/nodejs.js +19 -31
  21. package/package.json +1 -39
  22. package/script/deps/deno.land/x/base64@v0.2.1/base.js +104 -0
  23. package/script/deps/deno.land/x/base64@v0.2.1/base64url.js +13 -0
  24. package/script/deps/deno.land/x/sha1@v1.0.3/deps.js +6 -0
  25. package/script/deps/deno.land/x/sha1@v1.0.3/mod.js +196 -0
  26. package/script/deps/denopkg.com/chiefbiiko/std-encoding@v1.0.0/mod.js +55 -0
  27. package/script/pkg/commands/lpos.js +23 -0
  28. package/script/pkg/commands/mod.js +1 -0
  29. package/script/pkg/commands/scan.js +3 -0
  30. package/script/pkg/commands/sdiffstore.js +1 -1
  31. package/script/pkg/commands/set.js +16 -4
  32. package/script/pkg/commands/zrange.js +6 -0
  33. package/script/pkg/http.js +35 -7
  34. package/script/pkg/pipeline.js +9 -0
  35. package/script/pkg/redis.js +25 -0
  36. package/script/pkg/script.js +81 -0
  37. package/script/platforms/cloudflare.js +5 -25
  38. package/script/platforms/fastly.js +4 -25
  39. package/script/platforms/node_with_fetch.js +4 -25
  40. package/script/platforms/nodejs.js +19 -31
  41. package/types/deps/deno.land/x/base64@v0.2.1/base.d.ts +5 -0
  42. package/types/deps/deno.land/x/base64@v0.2.1/base64url.d.ts +1 -0
  43. package/types/deps/deno.land/x/sha1@v1.0.3/deps.d.ts +1 -0
  44. package/types/deps/deno.land/x/sha1@v1.0.3/mod.d.ts +26 -0
  45. package/types/deps/denopkg.com/chiefbiiko/std-encoding@v1.0.0/mod.d.ts +3 -0
  46. package/types/pkg/commands/bitop.d.ts +0 -1
  47. package/types/pkg/commands/bitpos.d.ts +1 -1
  48. package/types/pkg/commands/lpop.d.ts +1 -1
  49. package/types/pkg/commands/lpos.d.ts +15 -0
  50. package/types/pkg/commands/mget.d.ts +1 -1
  51. package/types/pkg/commands/mod.d.ts +1 -0
  52. package/types/pkg/commands/rpop.d.ts +2 -2
  53. package/types/pkg/commands/scan.d.ts +1 -0
  54. package/types/pkg/commands/sdiffstore.d.ts +1 -1
  55. package/types/pkg/commands/set.d.ts +31 -2
  56. package/types/pkg/commands/spop.d.ts +2 -2
  57. package/types/pkg/commands/zadd.d.ts +1 -1
  58. package/types/pkg/commands/zrange.d.ts +7 -0
  59. package/types/pkg/http.d.ts +27 -3
  60. package/types/pkg/pipeline.d.ts +14 -6
  61. package/types/pkg/redis.d.ts +22 -8
  62. package/types/pkg/script.d.ts +42 -0
  63. package/types/platforms/cloudflare.d.ts +6 -2
  64. package/types/platforms/fastly.d.ts +5 -1
  65. package/types/platforms/node_with_fetch.d.ts +20 -1
  66. package/types/platforms/nodejs.d.ts +20 -1
@@ -0,0 +1,81 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Script = void 0;
4
+ const mod_js_1 = require("../deps/deno.land/x/sha1@v1.0.3/mod.js");
5
+ /**
6
+ * Creates a new script.
7
+ *
8
+ * Scripts offer the ability to optimistically try to execute a script without having to send the
9
+ * entire script to the server. If the script is loaded on the server, it tries again by sending
10
+ * the entire script. Afterwards, the script is cached on the server.
11
+ *
12
+ * @example
13
+ * ```ts
14
+ * const redis = new Redis({...})
15
+ *
16
+ * const script = redis.createScript<string>("return ARGV[1];")
17
+ * const arg1 = await script.eval([], ["Hello World"])
18
+ * assertEquals(arg1, "Hello World")
19
+ * ```
20
+ */
21
+ class Script {
22
+ constructor(redis, script) {
23
+ Object.defineProperty(this, "script", {
24
+ enumerable: true,
25
+ configurable: true,
26
+ writable: true,
27
+ value: void 0
28
+ });
29
+ Object.defineProperty(this, "sha1", {
30
+ enumerable: true,
31
+ configurable: true,
32
+ writable: true,
33
+ value: void 0
34
+ });
35
+ Object.defineProperty(this, "redis", {
36
+ enumerable: true,
37
+ configurable: true,
38
+ writable: true,
39
+ value: void 0
40
+ });
41
+ this.redis = redis;
42
+ this.sha1 = this.digest(script);
43
+ this.script = script;
44
+ }
45
+ /**
46
+ * Send an `EVAL` command to redis.
47
+ */
48
+ async eval(keys, args) {
49
+ return await this.redis.eval(this.script, keys, args);
50
+ }
51
+ /**
52
+ * Calculates the sha1 hash of the script and then calls `EVALSHA`.
53
+ */
54
+ async evalsha(keys, args) {
55
+ return await this.redis.evalsha(this.sha1, keys, args);
56
+ }
57
+ /**
58
+ * Optimistically try to run `EVALSHA` first.
59
+ * If the script is not loaded in redis, it will fall back and try again with `EVAL`.
60
+ *
61
+ * Following calls will be able to use the cached script
62
+ */
63
+ async exec(keys, args) {
64
+ const res = await this.redis.evalsha(this.sha1, keys, args).catch(async (err) => {
65
+ if (err instanceof Error &&
66
+ err.message.toLowerCase().includes("noscript")) {
67
+ return await this.redis.eval(this.script, keys, args);
68
+ }
69
+ throw err;
70
+ });
71
+ return res;
72
+ }
73
+ /**
74
+ * Compute the sha1 hash of the script and return its hex representation.
75
+ */
76
+ digest(s) {
77
+ const hash = (0, mod_js_1.sha1)(s, "utf8", "hex");
78
+ return typeof hash === "string" ? hash : new TextDecoder().decode(hash);
79
+ }
80
+ }
81
+ exports.Script = Script;
@@ -25,7 +25,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
25
25
  Object.defineProperty(exports, "__esModule", { value: true });
26
26
  exports.Redis = void 0;
27
27
  const core = __importStar(require("../pkg/redis.js"));
28
- const error_js_1 = require("../pkg/error.js");
28
+ const http_js_1 = require("../pkg/http.js");
29
29
  /**
30
30
  * Serverless redis client for upstash.
31
31
  */
@@ -52,7 +52,8 @@ class Redis extends core.Redis {
52
52
  /\r|\n/.test(config.token)) {
53
53
  console.warn("The redis token contains whitespace or newline, which can cause errors!");
54
54
  }
55
- const client = defaultRequester({
55
+ const client = new http_js_1.HttpClient({
56
+ retry: config.retry,
56
57
  baseUrl: config.url,
57
58
  headers: { authorization: `Bearer ${config.token}` },
58
59
  });
@@ -70,9 +71,8 @@ class Redis extends core.Redis {
70
71
  * ```ts
71
72
  * const redis = Redis.fromEnv(env)
72
73
  * ```
73
- *
74
74
  */
75
- static fromEnv(env) {
75
+ static fromEnv(env, opts) {
76
76
  // @ts-ignore These will be defined by cloudflare
77
77
  const url = env?.UPSTASH_REDIS_REST_URL ?? UPSTASH_REDIS_REST_URL;
78
78
  // @ts-ignore These will be defined by cloudflare
@@ -83,27 +83,7 @@ class Redis extends core.Redis {
83
83
  if (!token) {
84
84
  throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_TOKEN`. Please add it via `wrangler secret put UPSTASH_REDIS_REST_TOKEN`");
85
85
  }
86
- return new Redis({ url, token });
86
+ return new Redis({ ...opts, url, token });
87
87
  }
88
88
  }
89
89
  exports.Redis = Redis;
90
- function defaultRequester(config) {
91
- return {
92
- request: async function (req) {
93
- if (!req.path) {
94
- req.path = [];
95
- }
96
- const res = await fetch([config.baseUrl, ...req.path].join("/"), {
97
- method: "POST",
98
- headers: { "Content-Type": "application/json", ...config.headers },
99
- body: JSON.stringify(req.body),
100
- keepalive: true,
101
- });
102
- const body = (await res.json());
103
- if (!res.ok) {
104
- throw new error_js_1.UpstashError(body.error);
105
- }
106
- return body;
107
- },
108
- };
109
- }
@@ -25,7 +25,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
25
25
  Object.defineProperty(exports, "__esModule", { value: true });
26
26
  exports.Redis = void 0;
27
27
  const core = __importStar(require("../pkg/redis.js"));
28
- const error_js_1 = require("../pkg/error.js");
28
+ const http_js_1 = require("../pkg/http.js");
29
29
  /**
30
30
  * Serverless redis client for upstash.
31
31
  */
@@ -53,10 +53,11 @@ class Redis extends core.Redis {
53
53
  /\r|\n/.test(config.token)) {
54
54
  console.warn("The redis token contains whitespace or newline, which can cause errors!");
55
55
  }
56
- const client = defaultRequester({
56
+ const client = new http_js_1.HttpClient({
57
57
  baseUrl: config.url,
58
+ retry: config.retry,
58
59
  headers: { authorization: `Bearer ${config.token}` },
59
- backend: config.backend,
60
+ options: { backend: config.backend },
60
61
  });
61
62
  super(client, {
62
63
  automaticDeserialization: config.automaticDeserialization,
@@ -64,25 +65,3 @@ class Redis extends core.Redis {
64
65
  }
65
66
  }
66
67
  exports.Redis = Redis;
67
- function defaultRequester(config) {
68
- return {
69
- request: async function (req) {
70
- if (!req.path) {
71
- req.path = [];
72
- }
73
- const res = await fetch([config.baseUrl, ...req.path].join("/"), {
74
- method: "POST",
75
- headers: { "Content-Type": "application/json", ...config.headers },
76
- body: JSON.stringify(req.body),
77
- keepalive: true,
78
- // @ts-expect-error fastly requires `backend`
79
- backend: config.backend,
80
- });
81
- const body = (await res.json());
82
- if (!res.ok) {
83
- throw new error_js_1.UpstashError(body.error);
84
- }
85
- return body;
86
- },
87
- };
88
- }
@@ -26,7 +26,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
26
26
  Object.defineProperty(exports, "__esModule", { value: true });
27
27
  exports.Redis = void 0;
28
28
  const core = __importStar(require("../pkg/redis.js"));
29
- const error_js_1 = require("../pkg/error.js");
29
+ const http_js_1 = require("../pkg/http.js");
30
30
  require("isomorphic-fetch");
31
31
  /**
32
32
  * Serverless redis client for upstash.
@@ -47,8 +47,9 @@ class Redis extends core.Redis {
47
47
  /\r|\n/.test(configOrRequester.token)) {
48
48
  console.warn("The redis token contains whitespace or newline, which can cause errors!");
49
49
  }
50
- const client = defaultRequester({
50
+ const client = new http_js_1.HttpClient({
51
51
  baseUrl: configOrRequester.url,
52
+ retry: configOrRequester.retry,
52
53
  headers: { authorization: `Bearer ${configOrRequester.token}` },
53
54
  // agent: configOrRequester.agent,
54
55
  });
@@ -80,29 +81,7 @@ class Redis extends core.Redis {
80
81
  if (!token) {
81
82
  throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_TOKEN`");
82
83
  }
83
- return new Redis({ url, token, ...config });
84
+ return new Redis({ ...config, url, token });
84
85
  }
85
86
  }
86
87
  exports.Redis = Redis;
87
- function defaultRequester(config) {
88
- return {
89
- request: async function (req) {
90
- if (!req.path) {
91
- req.path = [];
92
- }
93
- const res = await fetch([config.baseUrl, ...req.path].join("/"), {
94
- method: "POST",
95
- headers: { "Content-Type": "application/json", ...config.headers },
96
- body: JSON.stringify(req.body),
97
- keepalive: true,
98
- // @ts-ignore
99
- agent: config.agent,
100
- });
101
- const body = (await res.json());
102
- if (!res.ok) {
103
- throw new error_js_1.UpstashError(body.error);
104
- }
105
- return body;
106
- },
107
- };
108
- }
@@ -26,7 +26,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
26
26
  Object.defineProperty(exports, "__esModule", { value: true });
27
27
  exports.Redis = void 0;
28
28
  const core = __importStar(require("../pkg/redis.js"));
29
- const error_js_1 = require("../pkg/error.js");
29
+ const http_js_1 = require("../pkg/http.js");
30
30
  /**
31
31
  * Serverless redis client for upstash.
32
32
  */
@@ -46,8 +46,9 @@ class Redis extends core.Redis {
46
46
  /\r|\n/.test(configOrRequester.token)) {
47
47
  console.warn("The redis token contains whitespace or newline, which can cause errors!");
48
48
  }
49
- const client = defaultRequester({
49
+ const client = new http_js_1.HttpClient({
50
50
  baseUrl: configOrRequester.url,
51
+ retry: configOrRequester.retry,
51
52
  headers: { authorization: `Bearer ${configOrRequester.token}` },
52
53
  // agent: configOrRequester.agent,
53
54
  });
@@ -65,43 +66,30 @@ class Redis extends core.Redis {
65
66
  * your environment using `process.env`.
66
67
  */
67
68
  static fromEnv(config) {
69
+ let url = undefined;
70
+ let token = undefined;
68
71
  // @ts-ignore process will be defined in node
69
- if (typeof process?.env === "undefined") {
70
- throw new Error('Unable to get environment variables, `process.env` is undefined. If you are deploying to cloudflare, please import from "@upstash/redis/cloudflare" instead');
72
+ if (typeof process !== "undefined") {
73
+ // @ts-ignore process will be defined in node
74
+ url = process?.env["UPSTASH_REDIS_REST_URL"];
75
+ // @ts-ignore process will be defined in node
76
+ token = process?.env["UPSTASH_REDIS_REST_TOKEN"];
77
+ }
78
+ // fallback for Vite https://vitejs.dev/guide/env-and-mode.html
79
+ if (!url) {
80
+ url = import.meta.env["VITE_UPSTASH_REDIS_REST_URL"];
71
81
  }
72
- // @ts-ignore process will be defined in node
73
- const url = process?.env["UPSTASH_REDIS_REST_URL"];
74
82
  if (!url) {
75
83
  throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_URL`");
76
84
  }
77
- // @ts-ignore process will be defined in node
78
- const token = process?.env["UPSTASH_REDIS_REST_TOKEN"];
85
+ // fallback for Vite https://vitejs.dev/guide/env-and-mode.html
86
+ if (!token) {
87
+ token = import.meta.env.VITE_UPSTASH_REDIS_REST_TOKEN;
88
+ }
79
89
  if (!token) {
80
90
  throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_TOKEN`");
81
91
  }
82
- return new Redis({ url, token, ...config });
92
+ return new Redis({ ...config, url, token });
83
93
  }
84
94
  }
85
95
  exports.Redis = Redis;
86
- function defaultRequester(config) {
87
- return {
88
- request: async function (req) {
89
- if (!req.path) {
90
- req.path = [];
91
- }
92
- const res = await fetch([config.baseUrl, ...req.path].join("/"), {
93
- method: "POST",
94
- headers: { "Content-Type": "application/json", ...config.headers },
95
- body: JSON.stringify(req.body),
96
- keepalive: true,
97
- // @ts-ignore
98
- agent: config.agent,
99
- });
100
- const body = (await res.json());
101
- if (!res.ok) {
102
- throw new error_js_1.UpstashError(body.error);
103
- }
104
- return body;
105
- },
106
- };
107
- }
@@ -0,0 +1,5 @@
1
+ export declare function init(lookup: string[], revLookup: number[], urlsafe?: boolean): {
2
+ byteLength(b64: string): number;
3
+ toUint8Array(b64: string): Uint8Array;
4
+ fromUint8Array(buf: Uint8Array): string;
5
+ };
@@ -0,0 +1 @@
1
+ export declare const byteLength: (b64: string) => number, toUint8Array: (b64: string) => Uint8Array, fromUint8Array: (buf: Uint8Array) => string;
@@ -0,0 +1 @@
1
+ export { encode, decode } from "../../../denopkg.com/chiefbiiko/std-encoding@v1.0.0/mod.js";
@@ -0,0 +1,26 @@
1
+ /** Byte length of a SHA1 digest. */
2
+ export declare const BYTES: number;
3
+ /** A class representation of the SHA1 algorithm. */
4
+ export declare class SHA1 {
5
+ readonly hashSize: number;
6
+ private _buf;
7
+ private _bufIdx;
8
+ private _count;
9
+ private _K;
10
+ private _H;
11
+ private _finalized;
12
+ /** Creates a SHA1 instance. */
13
+ constructor();
14
+ /** Reduces the four input numbers to a single one. */
15
+ protected static F(t: number, b: number, c: number, d: number): number;
16
+ /** Initializes a hash instance. */
17
+ init(): SHA1;
18
+ /** Updates a hash with additional message data. */
19
+ update(msg: string | Uint8Array, inputEncoding?: string): SHA1;
20
+ /** Finalizes a hash with additional message data. */
21
+ digest(outputEncoding?: string): string | Uint8Array;
22
+ /** Performs one transformation cycle. */
23
+ private transform;
24
+ }
25
+ /** Generates a SHA1 hash of the input data. */
26
+ export declare function sha1(msg: string | Uint8Array, inputEncoding?: string, outputEncoding?: string): string | Uint8Array;
@@ -0,0 +1,3 @@
1
+ /** Decodes a Uint8Array to utf8-, base64-, or hex-encoded string. */
2
+ export declare function decode(buf: Uint8Array, encoding?: string): string;
3
+ export declare function encode(str: string, encoding?: string): Uint8Array;
@@ -6,7 +6,6 @@ export declare class BitOpCommand extends Command<number, number> {
6
6
  constructor(cmd: [
7
7
  op: "and" | "or" | "xor",
8
8
  destinationKey: string,
9
- sourceKey: string,
10
9
  ...sourceKeys: string[]
11
10
  ], opts?: CommandOptions<number, number>);
12
11
  constructor(cmd: [op: "not", destinationKey: string, sourceKey: string], opts?: CommandOptions<number, number>);
@@ -3,5 +3,5 @@ import { Command, CommandOptions } from "./command.js";
3
3
  * @see https://redis.io/commands/bitpos
4
4
  */
5
5
  export declare class BitPosCommand extends Command<number, number> {
6
- constructor(cmd: [key: string, start: number, end: number], opts?: CommandOptions<number, number>);
6
+ constructor(cmd: [key: string, bit: 0 | 1, start?: number, end?: number], opts?: CommandOptions<number, number>);
7
7
  }
@@ -3,5 +3,5 @@ import { Command, CommandOptions } from "./command.js";
3
3
  * @see https://redis.io/commands/lpop
4
4
  */
5
5
  export declare class LPopCommand<TData = string> extends Command<unknown | null, TData | null> {
6
- constructor(cmd: [key: string], opts?: CommandOptions<unknown | null, TData | null>);
6
+ constructor(cmd: [key: string, count?: number], opts?: CommandOptions<unknown | null, TData | null>);
7
7
  }
@@ -0,0 +1,15 @@
1
+ import { Command, CommandOptions } from "./command.js";
2
+ /**
3
+ * @see https://redis.io/commands/lpos
4
+ */
5
+ export declare class LPosCommand<TData = number> extends Command<TData, TData> {
6
+ constructor(cmd: [
7
+ key: string,
8
+ element: unknown,
9
+ opts?: {
10
+ rank?: number;
11
+ count?: number;
12
+ maxLen?: number;
13
+ }
14
+ ], opts?: CommandOptions<TData, TData>);
15
+ }
@@ -3,5 +3,5 @@ import { Command, CommandOptions } from "./command.js";
3
3
  * @see https://redis.io/commands/mget
4
4
  */
5
5
  export declare class MGetCommand<TData extends unknown[]> extends Command<(string | null)[], TData> {
6
- constructor(cmd: [...keys: [string, ...string[]]], opts?: CommandOptions<(string | null)[], TData>);
6
+ constructor(cmd: [...keys: string[]], opts?: CommandOptions<(string | null)[], TData>);
7
7
  }
@@ -42,6 +42,7 @@ export * from "./lindex.js";
42
42
  export * from "./linsert.js";
43
43
  export * from "./llen.js";
44
44
  export * from "./lpop.js";
45
+ export * from "./lpos.js";
45
46
  export * from "./lpush.js";
46
47
  export * from "./lpushx.js";
47
48
  export * from "./lrange.js";
@@ -2,6 +2,6 @@ import { Command, CommandOptions } from "./command.js";
2
2
  /**
3
3
  * @see https://redis.io/commands/rpop
4
4
  */
5
- export declare class RPopCommand<TData = string> extends Command<unknown | null, TData | null> {
6
- constructor(cmd: [key: string], opts?: CommandOptions<unknown | null, TData | null>);
5
+ export declare class RPopCommand<TData extends unknown | unknown[] = string> extends Command<unknown | null, TData | null> {
6
+ constructor(cmd: [key: string, count?: number], opts?: CommandOptions<unknown | null, TData | null>);
7
7
  }
@@ -2,6 +2,7 @@ import { Command, CommandOptions } from "./command.js";
2
2
  export declare type ScanCommandOptions = {
3
3
  match?: string;
4
4
  count?: number;
5
+ type?: string;
5
6
  };
6
7
  /**
7
8
  * @see https://redis.io/commands/scan
@@ -1,6 +1,6 @@
1
1
  import { Command, CommandOptions } from "./command.js";
2
2
  /**
3
- * @see https://redis.io/commands/sdiffstpre
3
+ * @see https://redis.io/commands/sdiffstore
4
4
  */
5
5
  export declare class SDiffStoreCommand extends Command<number, number> {
6
6
  constructor(cmd: [destination: string, ...keys: string[]], opts?: CommandOptions<number, number>);
@@ -1,13 +1,42 @@
1
1
  import { Command, CommandOptions } from "./command.js";
2
- export declare type SetCommandOptions = ({
2
+ export declare type SetCommandOptions = {
3
+ get: boolean;
4
+ } | ({
3
5
  ex: number;
4
6
  px?: never;
7
+ exat?: never;
8
+ pxat?: never;
9
+ keepTtl?: never;
5
10
  } | {
6
11
  ex?: never;
7
12
  px: number;
13
+ exat?: never;
14
+ pxat?: never;
15
+ keepTtl?: never;
8
16
  } | {
9
17
  ex?: never;
10
18
  px?: never;
19
+ exat: number;
20
+ pxat?: never;
21
+ keepTtl?: never;
22
+ } | {
23
+ ex?: never;
24
+ px?: never;
25
+ exat?: never;
26
+ pxat: number;
27
+ keepTtl?: never;
28
+ } | {
29
+ ex?: never;
30
+ px?: never;
31
+ exat?: never;
32
+ pxat?: never;
33
+ keepTtl: true;
34
+ } | {
35
+ ex?: never;
36
+ px?: never;
37
+ exat?: never;
38
+ pxat?: never;
39
+ keepTtl?: never;
11
40
  }) & ({
12
41
  nx: true;
13
42
  xx?: never;
@@ -21,6 +50,6 @@ export declare type SetCommandOptions = ({
21
50
  /**
22
51
  * @see https://redis.io/commands/set
23
52
  */
24
- export declare class SetCommand<TData, TResult = "OK"> extends Command<TResult, TData> {
53
+ export declare class SetCommand<TData, TResult = TData | "OK" | null> extends Command<TResult, TData | "OK" | null> {
25
54
  constructor([key, value, opts]: [key: string, value: TData, opts?: SetCommandOptions], cmdOpts?: CommandOptions<TResult, TData>);
26
55
  }
@@ -2,6 +2,6 @@ import { Command, CommandOptions } from "./command.js";
2
2
  /**
3
3
  * @see https://redis.io/commands/spop
4
4
  */
5
- export declare class SPopCommand<TData> extends Command<string | null, TData | null> {
6
- constructor([key, count]: [key: string, count?: number], opts?: CommandOptions<string | null, TData | null>);
5
+ export declare class SPopCommand<TData> extends Command<string | string[] | null, TData | null> {
6
+ constructor([key, count]: [key: string, count?: number], opts?: CommandOptions<string | string[] | null, TData | null>);
7
7
  }
@@ -30,6 +30,6 @@ export declare class ZAddCommand<TData = string> extends Command<number | null,
30
30
  constructor(cmd: [
31
31
  key: string,
32
32
  opts: ZAddCommandOptions | ZAddCommandOptionsWithIncr,
33
- ...scoreMemberPairs: [ScoreMember<TData>, ...ScoreMember<TData>[]]
33
+ ...scoreMemberPairs: ScoreMember<TData>[]
34
34
  ], opts?: CommandOptions<number | null, number | null>);
35
35
  }
@@ -1,6 +1,7 @@
1
1
  import { Command, CommandOptions } from "./command.js";
2
2
  export declare type ZRangeCommandOptions = {
3
3
  withScores?: boolean;
4
+ rev?: boolean;
4
5
  } & ({
5
6
  byScore: true;
6
7
  byLex?: never;
@@ -10,6 +11,12 @@ export declare type ZRangeCommandOptions = {
10
11
  } | {
11
12
  byScore?: never;
12
13
  byLex?: never;
14
+ }) & ({
15
+ offset: number;
16
+ count: number;
17
+ } | {
18
+ offset?: never;
19
+ count?: never;
13
20
  });
14
21
  /**
15
22
  * @see https://redis.io/commands/zrange
@@ -12,12 +12,31 @@ export declare type UpstashResponse<TResult> = {
12
12
  export interface Requester {
13
13
  request: <TResult = unknown>(req: UpstashRequest) => Promise<UpstashResponse<TResult>>;
14
14
  }
15
+ export declare type RetryConfig = false | {
16
+ /**
17
+ * The number of retries to attempt before giving up.
18
+ *
19
+ * @default 5
20
+ */
21
+ retries?: number;
22
+ /**
23
+ * A backoff function receives the current retry cound and returns a number in milliseconds to wait before retrying.
24
+ *
25
+ * @default
26
+ * ```ts
27
+ * Math.exp(retryCount) * 50
28
+ * ```
29
+ */
30
+ backoff?: (retryCount: number) => number;
31
+ };
32
+ declare type Options = {
33
+ backend?: string;
34
+ };
15
35
  export declare type HttpClientConfig = {
16
36
  headers?: Record<string, string>;
17
37
  baseUrl: string;
18
- options?: {
19
- backend?: string;
20
- };
38
+ options?: Options;
39
+ retry?: RetryConfig;
21
40
  };
22
41
  export declare class HttpClient implements Requester {
23
42
  baseUrl: string;
@@ -25,6 +44,11 @@ export declare class HttpClient implements Requester {
25
44
  readonly options?: {
26
45
  backend?: string;
27
46
  };
47
+ readonly retry: {
48
+ attempts: number;
49
+ backoff: (retryCount: number) => number;
50
+ };
28
51
  constructor(config: HttpClientConfig);
29
52
  request<TResult>(req: UpstashRequest): Promise<UpstashResponse<TResult>>;
30
53
  }
54
+ export {};
@@ -1,4 +1,4 @@
1
- import { DelCommand, ExistsCommand, FlushAllCommand, PingCommand, ScoreMember, ScriptExistsCommand, SetCommandOptions, TouchCommand, UnlinkCommand, ZAddCommandOptions, ZAddCommandOptionsWithIncr, ZRangeCommandOptions } from "./commands/mod.js";
1
+ import { DelCommand, ExistsCommand, FlushAllCommand, MGetCommand, PingCommand, ScoreMember, ScriptExistsCommand, SetCommandOptions, TouchCommand, UnlinkCommand, ZAddCommandOptions, ZAddCommandOptionsWithIncr, ZRangeCommandOptions } from "./commands/mod.js";
2
2
  import { CommandOptions } from "./commands/command.js";
3
3
  import { Requester } from "./http.js";
4
4
  import { CommandArgs } from "./types.js";
@@ -79,7 +79,7 @@ export declare class Pipeline {
79
79
  /**
80
80
  * @see https://redis.io/commands/bitpos
81
81
  */
82
- bitpos: (key: string, start: number, end: number) => this;
82
+ bitpos: (key: string, bit: 0 | 1, start?: number | undefined, end?: number | undefined) => this;
83
83
  /**
84
84
  * @see https://redis.io/commands/dbsize
85
85
  */
@@ -241,7 +241,15 @@ export declare class Pipeline {
241
241
  /**
242
242
  * @see https://redis.io/commands/lpop
243
243
  */
244
- lpop: <TData>(key: string) => this;
244
+ lpop: <TData>(key: string, count?: number | undefined) => this;
245
+ /**
246
+ * @see https://redis.io/commands/lpos
247
+ */
248
+ lpos: <TData>(key: string, element: unknown, opts?: {
249
+ rank?: number | undefined;
250
+ count?: number | undefined;
251
+ maxLen?: number | undefined;
252
+ } | undefined) => this;
245
253
  /**
246
254
  * @see https://redis.io/commands/lpush
247
255
  */
@@ -269,7 +277,7 @@ export declare class Pipeline {
269
277
  /**
270
278
  * @see https://redis.io/commands/mget
271
279
  */
272
- mget: <TData extends unknown[]>(args_0: string, ...args_1: string[]) => this;
280
+ mget: <TData extends unknown[]>(...args: CommandArgs<typeof MGetCommand>) => this;
273
281
  /**
274
282
  * @see https://redis.io/commands/mset
275
283
  */
@@ -325,7 +333,7 @@ export declare class Pipeline {
325
333
  /**
326
334
  * @see https://redis.io/commands/rpop
327
335
  */
328
- rpop: <TData = string>(key: string) => this;
336
+ rpop: <TData = string>(key: string, count?: number | undefined) => this;
329
337
  /**
330
338
  * @see https://redis.io/commands/rpush
331
339
  */
@@ -366,7 +374,7 @@ export declare class Pipeline {
366
374
  /**
367
375
  * @see https://redis.io/commands/set
368
376
  */
369
- set: <TData>(key: string, value: TData, opts?: SetCommandOptions | undefined) => this;
377
+ set: <TData>(key: string, value: TData, opts?: SetCommandOptions) => this;
370
378
  /**
371
379
  * @see https://redis.io/commands/setbit
372
380
  */