@upstash/redis 0.0.0-ci.bf3f49d1 → 0.0.0-ci.bf6288e9-20231018

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 (174) hide show
  1. package/README.md +44 -280
  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/command.js +12 -3
  8. package/esm/pkg/commands/geo_add.js +27 -0
  9. package/esm/pkg/commands/getdel.js +9 -0
  10. package/esm/pkg/commands/hgetall.js +9 -5
  11. package/esm/pkg/commands/hrandfield.js +39 -0
  12. package/esm/pkg/commands/json_arrappend.js +9 -0
  13. package/esm/pkg/commands/json_arrindex.js +9 -0
  14. package/esm/pkg/commands/json_arrinsert.js +9 -0
  15. package/esm/pkg/commands/json_arrlen.js +9 -0
  16. package/esm/pkg/commands/json_arrpop.js +9 -0
  17. package/esm/pkg/commands/json_arrtrim.js +12 -0
  18. package/esm/pkg/commands/json_clear.js +9 -0
  19. package/esm/pkg/commands/json_del.js +9 -0
  20. package/esm/pkg/commands/json_forget.js +9 -0
  21. package/esm/pkg/commands/json_get.js +30 -0
  22. package/esm/pkg/commands/json_mget.js +9 -0
  23. package/esm/pkg/commands/json_numincrby.js +9 -0
  24. package/esm/pkg/commands/json_nummultby.js +9 -0
  25. package/esm/pkg/commands/json_objkeys.js +9 -0
  26. package/esm/pkg/commands/json_objlen.js +9 -0
  27. package/esm/pkg/commands/json_resp.js +9 -0
  28. package/esm/pkg/commands/json_set.js +18 -0
  29. package/esm/pkg/commands/json_strappend.js +9 -0
  30. package/esm/pkg/commands/json_strlen.js +9 -0
  31. package/esm/pkg/commands/json_toggle.js +9 -0
  32. package/esm/pkg/commands/json_type.js +9 -0
  33. package/esm/pkg/commands/lmove.js +9 -0
  34. package/esm/pkg/commands/lpos.js +19 -0
  35. package/esm/pkg/commands/mod.js +30 -0
  36. package/esm/pkg/commands/scan.js +3 -0
  37. package/esm/pkg/commands/sdiffstore.js +1 -1
  38. package/esm/pkg/commands/set.js +16 -4
  39. package/esm/pkg/commands/smismember.js +9 -0
  40. package/esm/pkg/commands/xadd.js +26 -0
  41. package/esm/pkg/commands/xrange.js +36 -0
  42. package/esm/pkg/commands/zdiffstore.js +9 -0
  43. package/esm/pkg/commands/zmscore.js +10 -0
  44. package/esm/pkg/commands/zrange.js +6 -0
  45. package/esm/pkg/commands/zunion.js +30 -0
  46. package/esm/pkg/http.js +134 -9
  47. package/esm/pkg/pipeline.js +194 -12
  48. package/esm/pkg/redis.js +253 -2
  49. package/esm/pkg/script.js +77 -0
  50. package/esm/platforms/cloudflare.js +14 -26
  51. package/esm/platforms/fastly.js +10 -25
  52. package/esm/platforms/node_with_fetch.js +30 -26
  53. package/esm/platforms/nodejs.js +28 -26
  54. package/esm/version.js +1 -0
  55. package/package.json +53 -58
  56. package/script/deps/deno.land/x/base64@v0.2.1/base.js +104 -0
  57. package/script/deps/deno.land/x/base64@v0.2.1/base64url.js +13 -0
  58. package/script/deps/deno.land/x/sha1@v1.0.3/deps.js +6 -0
  59. package/script/deps/deno.land/x/sha1@v1.0.3/mod.js +196 -0
  60. package/script/deps/denopkg.com/chiefbiiko/std-encoding@v1.0.0/mod.js +55 -0
  61. package/script/pkg/commands/command.js +12 -3
  62. package/script/pkg/commands/geo_add.js +31 -0
  63. package/script/pkg/commands/getdel.js +13 -0
  64. package/script/pkg/commands/hgetall.js +9 -5
  65. package/script/pkg/commands/hrandfield.js +43 -0
  66. package/script/pkg/commands/json_arrappend.js +13 -0
  67. package/script/pkg/commands/json_arrindex.js +13 -0
  68. package/script/pkg/commands/json_arrinsert.js +13 -0
  69. package/script/pkg/commands/json_arrlen.js +13 -0
  70. package/script/pkg/commands/json_arrpop.js +13 -0
  71. package/script/pkg/commands/json_arrtrim.js +16 -0
  72. package/script/pkg/commands/json_clear.js +13 -0
  73. package/script/pkg/commands/json_del.js +13 -0
  74. package/script/pkg/commands/json_forget.js +13 -0
  75. package/script/pkg/commands/json_get.js +34 -0
  76. package/script/pkg/commands/json_mget.js +13 -0
  77. package/script/pkg/commands/json_numincrby.js +13 -0
  78. package/script/pkg/commands/json_nummultby.js +13 -0
  79. package/script/pkg/commands/json_objkeys.js +13 -0
  80. package/script/pkg/commands/json_objlen.js +13 -0
  81. package/script/pkg/commands/json_resp.js +13 -0
  82. package/script/pkg/commands/json_set.js +22 -0
  83. package/script/pkg/commands/json_strappend.js +13 -0
  84. package/script/pkg/commands/json_strlen.js +13 -0
  85. package/script/pkg/commands/json_toggle.js +13 -0
  86. package/script/pkg/commands/json_type.js +13 -0
  87. package/script/pkg/commands/lmove.js +13 -0
  88. package/script/pkg/commands/lpos.js +23 -0
  89. package/script/pkg/commands/mod.js +30 -0
  90. package/script/pkg/commands/scan.js +3 -0
  91. package/script/pkg/commands/sdiffstore.js +1 -1
  92. package/script/pkg/commands/set.js +16 -4
  93. package/script/pkg/commands/smismember.js +13 -0
  94. package/script/pkg/commands/xadd.js +30 -0
  95. package/script/pkg/commands/xrange.js +40 -0
  96. package/script/pkg/commands/zdiffstore.js +13 -0
  97. package/script/pkg/commands/zmscore.js +14 -0
  98. package/script/pkg/commands/zrange.js +6 -0
  99. package/script/pkg/commands/zunion.js +34 -0
  100. package/script/pkg/http.js +134 -9
  101. package/script/pkg/pipeline.js +193 -11
  102. package/script/pkg/redis.js +252 -1
  103. package/script/pkg/script.js +81 -0
  104. package/script/platforms/cloudflare.js +14 -26
  105. package/script/platforms/fastly.js +10 -25
  106. package/script/platforms/node_with_fetch.js +30 -26
  107. package/script/platforms/nodejs.js +28 -26
  108. package/script/version.js +4 -0
  109. package/types/deps/deno.land/x/base64@v0.2.1/base.d.ts +5 -0
  110. package/types/deps/deno.land/x/base64@v0.2.1/base64url.d.ts +1 -0
  111. package/types/deps/deno.land/x/sha1@v1.0.3/deps.d.ts +1 -0
  112. package/types/deps/deno.land/x/sha1@v1.0.3/mod.d.ts +26 -0
  113. package/types/deps/denopkg.com/chiefbiiko/std-encoding@v1.0.0/mod.d.ts +3 -0
  114. package/types/pkg/commands/bitop.d.ts +0 -1
  115. package/types/pkg/commands/bitpos.d.ts +1 -1
  116. package/types/pkg/commands/command.d.ts +5 -5
  117. package/types/pkg/commands/geo_add.d.ts +25 -0
  118. package/types/pkg/commands/getdel.d.ts +7 -0
  119. package/types/pkg/commands/hdel.d.ts +1 -1
  120. package/types/pkg/commands/hrandfield.d.ts +9 -0
  121. package/types/pkg/commands/json_arrappend.d.ts +7 -0
  122. package/types/pkg/commands/json_arrindex.d.ts +13 -0
  123. package/types/pkg/commands/json_arrinsert.d.ts +7 -0
  124. package/types/pkg/commands/json_arrlen.d.ts +7 -0
  125. package/types/pkg/commands/json_arrpop.d.ts +7 -0
  126. package/types/pkg/commands/json_arrtrim.d.ts +7 -0
  127. package/types/pkg/commands/json_clear.d.ts +7 -0
  128. package/types/pkg/commands/json_del.d.ts +7 -0
  129. package/types/pkg/commands/json_forget.d.ts +7 -0
  130. package/types/pkg/commands/json_get.d.ts +15 -0
  131. package/types/pkg/commands/json_mget.d.ts +7 -0
  132. package/types/pkg/commands/json_numincrby.d.ts +7 -0
  133. package/types/pkg/commands/json_nummultby.d.ts +7 -0
  134. package/types/pkg/commands/json_objkeys.d.ts +7 -0
  135. package/types/pkg/commands/json_objlen.d.ts +7 -0
  136. package/types/pkg/commands/json_resp.d.ts +7 -0
  137. package/types/pkg/commands/json_set.d.ts +18 -0
  138. package/types/pkg/commands/json_strappend.d.ts +7 -0
  139. package/types/pkg/commands/json_strlen.d.ts +7 -0
  140. package/types/pkg/commands/json_toggle.d.ts +7 -0
  141. package/types/pkg/commands/json_type.d.ts +7 -0
  142. package/types/pkg/commands/lmove.d.ts +12 -0
  143. package/types/pkg/commands/lpop.d.ts +1 -1
  144. package/types/pkg/commands/lpos.d.ts +15 -0
  145. package/types/pkg/commands/mget.d.ts +1 -1
  146. package/types/pkg/commands/mod.d.ts +30 -0
  147. package/types/pkg/commands/rpop.d.ts +2 -2
  148. package/types/pkg/commands/scan.d.ts +2 -1
  149. package/types/pkg/commands/script_flush.d.ts +1 -1
  150. package/types/pkg/commands/sdiffstore.d.ts +1 -1
  151. package/types/pkg/commands/set.d.ts +31 -2
  152. package/types/pkg/commands/smembers.d.ts +2 -2
  153. package/types/pkg/commands/smismember.d.ts +7 -0
  154. package/types/pkg/commands/spop.d.ts +2 -2
  155. package/types/pkg/commands/type.d.ts +1 -1
  156. package/types/pkg/commands/xadd.d.ts +31 -0
  157. package/types/pkg/commands/xrange.d.ts +9 -0
  158. package/types/pkg/commands/zadd.d.ts +4 -4
  159. package/types/pkg/commands/zdiffstore.d.ts +7 -0
  160. package/types/pkg/commands/zinterstore.d.ts +1 -1
  161. package/types/pkg/commands/zmscore.d.ts +7 -0
  162. package/types/pkg/commands/zrange.d.ts +8 -1
  163. package/types/pkg/commands/zunion.d.ts +29 -0
  164. package/types/pkg/commands/zunionstore.d.ts +1 -1
  165. package/types/pkg/http.d.ts +73 -8
  166. package/types/pkg/pipeline.d.ts +270 -124
  167. package/types/pkg/redis.d.ts +195 -19
  168. package/types/pkg/script.d.ts +42 -0
  169. package/types/pkg/types.d.ts +27 -1
  170. package/types/platforms/cloudflare.d.ts +9 -4
  171. package/types/platforms/fastly.d.ts +3 -3
  172. package/types/platforms/node_with_fetch.d.ts +3 -3
  173. package/types/platforms/nodejs.d.ts +19 -3
  174. package/types/version.d.ts +1 -0
package/esm/pkg/redis.js CHANGED
@@ -1,5 +1,8 @@
1
- import { AppendCommand, BitCountCommand, BitOpCommand, BitPosCommand, DBSizeCommand, DecrByCommand, DecrCommand, DelCommand, EchoCommand, EvalCommand, EvalshaCommand, ExistsCommand, ExpireAtCommand, ExpireCommand, FlushAllCommand, FlushDBCommand, GetBitCommand, GetCommand, GetRangeCommand, GetSetCommand, HDelCommand, HExistsCommand, HGetAllCommand, HGetCommand, HIncrByCommand, HIncrByFloatCommand, HKeysCommand, HLenCommand, HMGetCommand, HMSetCommand, HScanCommand, HSetCommand, HSetNXCommand, HStrLenCommand, HValsCommand, IncrByCommand, IncrByFloatCommand, IncrCommand, KeysCommand, LIndexCommand, LInsertCommand, LLenCommand, LPopCommand, LPushCommand, LPushXCommand, LRangeCommand, LRemCommand, LSetCommand, LTrimCommand, MGetCommand, MSetCommand, MSetNXCommand, PersistCommand, PExpireAtCommand, PExpireCommand, PingCommand, PSetEXCommand, PTtlCommand, PublishCommand, RandomKeyCommand, RenameCommand, RenameNXCommand, RPopCommand, RPushCommand, RPushXCommand, SAddCommand, ScanCommand, SCardCommand, ScriptExistsCommand, ScriptFlushCommand, ScriptLoadCommand, SDiffCommand, SDiffStoreCommand, SetBitCommand, SetCommand, SetExCommand, SetNxCommand, SetRangeCommand, SInterCommand, SInterStoreCommand, SIsMemberCommand, SMembersCommand, SMoveCommand, SPopCommand, SRandMemberCommand, SRemCommand, SScanCommand, StrLenCommand, SUnionCommand, SUnionStoreCommand, TimeCommand, TouchCommand, TtlCommand, TypeCommand, UnlinkCommand, ZAddCommand, ZCardCommand, ZCountCommand, ZIncrByCommand, ZInterStoreCommand, ZLexCountCommand, ZPopMaxCommand, ZPopMinCommand, ZRangeCommand, ZRankCommand, ZRemCommand, ZRemRangeByLexCommand, ZRemRangeByRankCommand, ZRemRangeByScoreCommand, ZRevRankCommand, ZScanCommand, ZScoreCommand, ZUnionStoreCommand, } from "./commands/mod.js";
1
+ import { AppendCommand, BitCountCommand, BitOpCommand, BitPosCommand, DBSizeCommand, DecrByCommand, DecrCommand, DelCommand, EchoCommand, EvalCommand, EvalshaCommand, ExistsCommand, ExpireAtCommand, ExpireCommand, FlushAllCommand, FlushDBCommand, GeoAddCommand, GetBitCommand, GetCommand, GetDelCommand, GetRangeCommand, GetSetCommand, HDelCommand, HExistsCommand, HGetAllCommand, HGetCommand, HIncrByCommand, HIncrByFloatCommand, HKeysCommand, HLenCommand, HMGetCommand, HMSetCommand, HRandFieldCommand, HScanCommand, HSetCommand, HSetNXCommand, HStrLenCommand, HValsCommand, IncrByCommand, IncrByFloatCommand, IncrCommand, JsonArrAppendCommand, JsonArrIndexCommand, JsonArrInsertCommand, JsonArrLenCommand, JsonArrPopCommand, JsonArrTrimCommand, JsonClearCommand, JsonDelCommand, JsonForgetCommand, JsonGetCommand, JsonMGetCommand, JsonNumIncrByCommand, JsonNumMultByCommand, JsonObjKeysCommand, JsonObjLenCommand, JsonRespCommand, JsonSetCommand, JsonStrAppendCommand, JsonStrLenCommand, JsonToggleCommand, JsonTypeCommand, KeysCommand, LIndexCommand, LInsertCommand, LLenCommand, LMoveCommand, LPopCommand, LPosCommand, LPushCommand, LPushXCommand, LRangeCommand, LRemCommand, LSetCommand, LTrimCommand, MGetCommand, MSetCommand, MSetNXCommand, PersistCommand, PExpireAtCommand, PExpireCommand, PingCommand, PSetEXCommand, PTtlCommand, PublishCommand, RandomKeyCommand, RenameCommand, RenameNXCommand, RPopCommand, RPushCommand, RPushXCommand, SAddCommand, ScanCommand, SCardCommand, ScriptExistsCommand, ScriptFlushCommand, ScriptLoadCommand, SDiffCommand, SDiffStoreCommand, SetBitCommand, SetCommand, SetExCommand, SetNxCommand, SetRangeCommand, SInterCommand, SInterStoreCommand, SIsMemberCommand, SMembersCommand, SMIsMemberCommand, SMoveCommand, SPopCommand, SRandMemberCommand, SRemCommand, SScanCommand, StrLenCommand, SUnionCommand, SUnionStoreCommand, TimeCommand, TouchCommand, TtlCommand, TypeCommand, UnlinkCommand, XAddCommand, XRangeCommand, ZAddCommand, ZCardCommand, ZCountCommand, ZIncrByCommand, ZInterStoreCommand, ZLexCountCommand, ZPopMaxCommand, ZPopMinCommand, ZRangeCommand, ZRankCommand, ZRemCommand, ZRemRangeByLexCommand, ZRemRangeByRankCommand, ZRemRangeByScoreCommand, ZRevRankCommand, ZScanCommand, ZScoreCommand, ZUnionCommand, ZUnionStoreCommand, } from "./commands/mod.js";
2
2
  import { Pipeline } from "./pipeline.js";
3
+ import { Script } from "./script.js";
4
+ import { ZMScoreCommand } from "./commands/zmscore.js";
5
+ import { ZDiffStoreCommand } from "./commands/zdiffstore.js";
3
6
  /**
4
7
  * Serverless redis client for upstash.
5
8
  */
@@ -28,6 +31,45 @@ export class Redis {
28
31
  writable: true,
29
32
  value: void 0
30
33
  });
34
+ Object.defineProperty(this, "enableTelemetry", {
35
+ enumerable: true,
36
+ configurable: true,
37
+ writable: true,
38
+ value: void 0
39
+ });
40
+ /**
41
+ * Wrap a new middleware around the HTTP client.
42
+ */
43
+ Object.defineProperty(this, "use", {
44
+ enumerable: true,
45
+ configurable: true,
46
+ writable: true,
47
+ value: (middleware) => {
48
+ const makeRequest = this.client.request.bind(this.client);
49
+ this.client.request = (req) => middleware(req, makeRequest);
50
+ }
51
+ });
52
+ /**
53
+ * Technically this is not private, we can hide it from intellisense by doing this
54
+ */
55
+ Object.defineProperty(this, "addTelemetry", {
56
+ enumerable: true,
57
+ configurable: true,
58
+ writable: true,
59
+ value: (telemetry) => {
60
+ if (!this.enableTelemetry) {
61
+ return;
62
+ }
63
+ try {
64
+ // @ts-ignore - The `Requester` interface does not know about this method but it will be there
65
+ // as long as the user uses the standard HttpClient
66
+ this.client.mergeTelemetry(telemetry);
67
+ }
68
+ catch {
69
+ // ignore
70
+ }
71
+ }
72
+ });
31
73
  /**
32
74
  * Create a new pipeline that allows you to send requests in bulk.
33
75
  *
@@ -37,7 +79,30 @@ export class Redis {
37
79
  enumerable: true,
38
80
  configurable: true,
39
81
  writable: true,
40
- value: () => new Pipeline(this.client, this.opts)
82
+ value: () => new Pipeline({
83
+ client: this.client,
84
+ commandOptions: this.opts,
85
+ multiExec: false,
86
+ })
87
+ });
88
+ /**
89
+ * Create a new transaction to allow executing multiple steps atomically.
90
+ *
91
+ * All the commands in a transaction are serialized and executed sequentially. A request sent by
92
+ * another client will never be served in the middle of the execution of a Redis Transaction. This
93
+ * guarantees that the commands are executed as a single isolated operation.
94
+ *
95
+ * @see {@link Pipeline}
96
+ */
97
+ Object.defineProperty(this, "multi", {
98
+ enumerable: true,
99
+ configurable: true,
100
+ writable: true,
101
+ value: () => new Pipeline({
102
+ client: this.client,
103
+ commandOptions: this.opts,
104
+ multiExec: true,
105
+ })
41
106
  });
42
107
  /**
43
108
  * @see https://redis.io/commands/append
@@ -201,6 +266,15 @@ export class Redis {
201
266
  writable: true,
202
267
  value: (...args) => new GetBitCommand(args, this.opts).exec(this.client)
203
268
  });
269
+ /**
270
+ * @see https://redis.io/commands/getdel
271
+ */
272
+ Object.defineProperty(this, "getdel", {
273
+ enumerable: true,
274
+ configurable: true,
275
+ writable: true,
276
+ value: (...args) => new GetDelCommand(args, this.opts).exec(this.client)
277
+ });
204
278
  /**
205
279
  * @see https://redis.io/commands/getrange
206
280
  */
@@ -309,6 +383,15 @@ export class Redis {
309
383
  writable: true,
310
384
  value: (key, kv) => new HMSetCommand([key, kv], this.opts).exec(this.client)
311
385
  });
386
+ /**
387
+ * @see https://redis.io/commands/hrandfield
388
+ */
389
+ Object.defineProperty(this, "hrandfield", {
390
+ enumerable: true,
391
+ configurable: true,
392
+ writable: true,
393
+ value: (key, count, withValues) => new HRandFieldCommand([key, count, withValues], this.opts).exec(this.client)
394
+ });
312
395
  /**
313
396
  * @see https://redis.io/commands/hscan
314
397
  */
@@ -417,6 +500,15 @@ export class Redis {
417
500
  writable: true,
418
501
  value: (...args) => new LLenCommand(args, this.opts).exec(this.client)
419
502
  });
503
+ /**
504
+ * @see https://redis.io/commands/lmove
505
+ */
506
+ Object.defineProperty(this, "lmove", {
507
+ enumerable: true,
508
+ configurable: true,
509
+ writable: true,
510
+ value: (...args) => new LMoveCommand(args, this.opts).exec(this.client)
511
+ });
420
512
  /**
421
513
  * @see https://redis.io/commands/lpop
422
514
  */
@@ -426,6 +518,15 @@ export class Redis {
426
518
  writable: true,
427
519
  value: (...args) => new LPopCommand(args, this.opts).exec(this.client)
428
520
  });
521
+ /**
522
+ * @see https://redis.io/commands/lpos
523
+ */
524
+ Object.defineProperty(this, "lpos", {
525
+ enumerable: true,
526
+ configurable: true,
527
+ writable: true,
528
+ value: (...args) => new LPosCommand(args, this.opts).exec(this.client)
529
+ });
429
530
  /**
430
531
  * @see https://redis.io/commands/lpush
431
532
  */
@@ -768,6 +869,15 @@ export class Redis {
768
869
  writable: true,
769
870
  value: (key, member) => new SIsMemberCommand([key, member], this.opts).exec(this.client)
770
871
  });
872
+ /**
873
+ * @see https://redis.io/commands/smismember
874
+ */
875
+ Object.defineProperty(this, "smismember", {
876
+ enumerable: true,
877
+ configurable: true,
878
+ writable: true,
879
+ value: (key, members) => new SMIsMemberCommand([key, members], this.opts).exec(this.client)
880
+ });
771
881
  /**
772
882
  * @see https://redis.io/commands/smembers
773
883
  */
@@ -894,6 +1004,24 @@ export class Redis {
894
1004
  writable: true,
895
1005
  value: (...args) => new UnlinkCommand(args, this.opts).exec(this.client)
896
1006
  });
1007
+ /**
1008
+ * @see https://redis.io/commands/xadd
1009
+ */
1010
+ Object.defineProperty(this, "xadd", {
1011
+ enumerable: true,
1012
+ configurable: true,
1013
+ writable: true,
1014
+ value: (...args) => new XAddCommand(args, this.opts).exec(this.client)
1015
+ });
1016
+ /**
1017
+ * @see https://redis.io/commands/xrange
1018
+ */
1019
+ Object.defineProperty(this, "xrange", {
1020
+ enumerable: true,
1021
+ configurable: true,
1022
+ writable: true,
1023
+ value: (...args) => new XRangeCommand(args, this.opts).exec(this.client)
1024
+ });
897
1025
  /**
898
1026
  * @see https://redis.io/commands/zadd
899
1027
  */
@@ -926,6 +1054,15 @@ export class Redis {
926
1054
  writable: true,
927
1055
  value: (...args) => new ZCountCommand(args, this.opts).exec(this.client)
928
1056
  });
1057
+ /**
1058
+ * @see https://redis.io/commands/zdiffstore
1059
+ */
1060
+ Object.defineProperty(this, "zdiffstore", {
1061
+ enumerable: true,
1062
+ configurable: true,
1063
+ writable: true,
1064
+ value: (...args) => new ZDiffStoreCommand(args, this.opts).exec(this.client)
1065
+ });
929
1066
  /**
930
1067
  * @see https://redis.io/commands/zincrby
931
1068
  */
@@ -953,6 +1090,15 @@ export class Redis {
953
1090
  writable: true,
954
1091
  value: (...args) => new ZLexCountCommand(args, this.opts).exec(this.client)
955
1092
  });
1093
+ /**
1094
+ * @see https://redis.io/commands/zmscore
1095
+ */
1096
+ Object.defineProperty(this, "zmscore", {
1097
+ enumerable: true,
1098
+ configurable: true,
1099
+ writable: true,
1100
+ value: (...args) => new ZMScoreCommand(args, this.opts).exec(this.client)
1101
+ });
956
1102
  /**
957
1103
  * @see https://redis.io/commands/zpopmax
958
1104
  */
@@ -1052,6 +1198,15 @@ export class Redis {
1052
1198
  writable: true,
1053
1199
  value: (key, member) => new ZScoreCommand([key, member], this.opts).exec(this.client)
1054
1200
  });
1201
+ /**
1202
+ * @see https://redis.io/commands/zunion
1203
+ */
1204
+ Object.defineProperty(this, "zunion", {
1205
+ enumerable: true,
1206
+ configurable: true,
1207
+ writable: true,
1208
+ value: (...args) => new ZUnionCommand(args, this.opts).exec(this.client)
1209
+ });
1055
1210
  /**
1056
1211
  * @see https://redis.io/commands/zunionstore
1057
1212
  */
@@ -1063,5 +1218,101 @@ export class Redis {
1063
1218
  });
1064
1219
  this.client = client;
1065
1220
  this.opts = opts;
1221
+ this.enableTelemetry = opts?.enableTelemetry ?? true;
1222
+ }
1223
+ get json() {
1224
+ return {
1225
+ /**
1226
+ * @see https://redis.io/commands/json.arrappend
1227
+ */
1228
+ arrappend: (...args) => new JsonArrAppendCommand(args, this.opts).exec(this.client),
1229
+ /**
1230
+ * @see https://redis.io/commands/json.arrindex
1231
+ */
1232
+ arrindex: (...args) => new JsonArrIndexCommand(args, this.opts).exec(this.client),
1233
+ /**
1234
+ * @see https://redis.io/commands/json.arrinsert
1235
+ */
1236
+ arrinsert: (...args) => new JsonArrInsertCommand(args, this.opts).exec(this.client),
1237
+ /**
1238
+ * @see https://redis.io/commands/json.arrlen
1239
+ */
1240
+ arrlen: (...args) => new JsonArrLenCommand(args, this.opts).exec(this.client),
1241
+ /**
1242
+ * @see https://redis.io/commands/json.arrpop
1243
+ */
1244
+ arrpop: (...args) => new JsonArrPopCommand(args, this.opts).exec(this.client),
1245
+ /**
1246
+ * @see https://redis.io/commands/json.arrtrim
1247
+ */
1248
+ arrtrim: (...args) => new JsonArrTrimCommand(args, this.opts).exec(this.client),
1249
+ /**
1250
+ * @see https://redis.io/commands/json.clear
1251
+ */
1252
+ clear: (...args) => new JsonClearCommand(args, this.opts).exec(this.client),
1253
+ /**
1254
+ * @see https://redis.io/commands/json.del
1255
+ */
1256
+ del: (...args) => new JsonDelCommand(args, this.opts).exec(this.client),
1257
+ /**
1258
+ * @see https://redis.io/commands/json.forget
1259
+ */
1260
+ forget: (...args) => new JsonForgetCommand(args, this.opts).exec(this.client),
1261
+ /**
1262
+ * @see https://redis.io/commands/geoadd
1263
+ */
1264
+ geoadd: (...args) => new GeoAddCommand(args, this.opts).exec(this.client),
1265
+ /**
1266
+ * @see https://redis.io/commands/json.get
1267
+ */
1268
+ get: (...args) => new JsonGetCommand(args, this.opts).exec(this.client),
1269
+ /**
1270
+ * @see https://redis.io/commands/json.mget
1271
+ */
1272
+ mget: (...args) => new JsonMGetCommand(args, this.opts).exec(this.client),
1273
+ /**
1274
+ * @see https://redis.io/commands/json.numincrby
1275
+ */
1276
+ numincrby: (...args) => new JsonNumIncrByCommand(args, this.opts).exec(this.client),
1277
+ /**
1278
+ * @see https://redis.io/commands/json.nummultby
1279
+ */
1280
+ nummultby: (...args) => new JsonNumMultByCommand(args, this.opts).exec(this.client),
1281
+ /**
1282
+ * @see https://redis.io/commands/json.objkeys
1283
+ */
1284
+ objkeys: (...args) => new JsonObjKeysCommand(args, this.opts).exec(this.client),
1285
+ /**
1286
+ * @see https://redis.io/commands/json.objlen
1287
+ */
1288
+ objlen: (...args) => new JsonObjLenCommand(args, this.opts).exec(this.client),
1289
+ /**
1290
+ * @see https://redis.io/commands/json.resp
1291
+ */
1292
+ resp: (...args) => new JsonRespCommand(args, this.opts).exec(this.client),
1293
+ /**
1294
+ * @see https://redis.io/commands/json.set
1295
+ */
1296
+ set: (...args) => new JsonSetCommand(args, this.opts).exec(this.client),
1297
+ /**
1298
+ * @see https://redis.io/commands/json.strappend
1299
+ */
1300
+ strappend: (...args) => new JsonStrAppendCommand(args, this.opts).exec(this.client),
1301
+ /**
1302
+ * @see https://redis.io/commands/json.strlen
1303
+ */
1304
+ strlen: (...args) => new JsonStrLenCommand(args, this.opts).exec(this.client),
1305
+ /**
1306
+ * @see https://redis.io/commands/json.toggle
1307
+ */
1308
+ toggle: (...args) => new JsonToggleCommand(args, this.opts).exec(this.client),
1309
+ /**
1310
+ * @see https://redis.io/commands/json.type
1311
+ */
1312
+ type: (...args) => new JsonTypeCommand(args, this.opts).exec(this.client),
1313
+ };
1314
+ }
1315
+ createScript(script) {
1316
+ return new Script(this, script);
1066
1317
  }
1067
1318
  }
@@ -0,0 +1,77 @@
1
+ import { sha1 as digest } from "../deps/deno.land/x/sha1@v1.0.3/mod.js";
2
+ /**
3
+ * Creates a new script.
4
+ *
5
+ * Scripts offer the ability to optimistically try to execute a script without having to send the
6
+ * entire script to the server. If the script is loaded on the server, it tries again by sending
7
+ * the entire script. Afterwards, the script is cached on the server.
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * const redis = new Redis({...})
12
+ *
13
+ * const script = redis.createScript<string>("return ARGV[1];")
14
+ * const arg1 = await script.eval([], ["Hello World"])
15
+ * assertEquals(arg1, "Hello World")
16
+ * ```
17
+ */
18
+ export class Script {
19
+ constructor(redis, script) {
20
+ Object.defineProperty(this, "script", {
21
+ enumerable: true,
22
+ configurable: true,
23
+ writable: true,
24
+ value: void 0
25
+ });
26
+ Object.defineProperty(this, "sha1", {
27
+ enumerable: true,
28
+ configurable: true,
29
+ writable: true,
30
+ value: void 0
31
+ });
32
+ Object.defineProperty(this, "redis", {
33
+ enumerable: true,
34
+ configurable: true,
35
+ writable: true,
36
+ value: void 0
37
+ });
38
+ this.redis = redis;
39
+ this.sha1 = this.digest(script);
40
+ this.script = script;
41
+ }
42
+ /**
43
+ * Send an `EVAL` command to redis.
44
+ */
45
+ async eval(keys, args) {
46
+ return await this.redis.eval(this.script, keys, args);
47
+ }
48
+ /**
49
+ * Calculates the sha1 hash of the script and then calls `EVALSHA`.
50
+ */
51
+ async evalsha(keys, args) {
52
+ return await this.redis.evalsha(this.sha1, keys, args);
53
+ }
54
+ /**
55
+ * Optimistically try to run `EVALSHA` first.
56
+ * If the script is not loaded in redis, it will fall back and try again with `EVAL`.
57
+ *
58
+ * Following calls will be able to use the cached script
59
+ */
60
+ async exec(keys, args) {
61
+ const res = await this.redis.evalsha(this.sha1, keys, args).catch(async (err) => {
62
+ if (err instanceof Error &&
63
+ err.message.toLowerCase().includes("noscript")) {
64
+ return await this.redis.eval(this.script, keys, args);
65
+ }
66
+ throw err;
67
+ });
68
+ return res;
69
+ }
70
+ /**
71
+ * Compute the sha1 hash of the script and return its hex representation.
72
+ */
73
+ digest(s) {
74
+ const hash = digest(s, "utf8", "hex");
75
+ return typeof hash === "string" ? hash : new TextDecoder().decode(hash);
76
+ }
77
+ }
@@ -1,5 +1,6 @@
1
1
  import * as core from "../pkg/redis.js";
2
- import { UpstashError } from "../pkg/error.js";
2
+ import { HttpClient } from "../pkg/http.js";
3
+ import { VERSION } from "../version.js";
3
4
  /**
4
5
  * Serverless redis client for upstash.
5
6
  */
@@ -15,7 +16,7 @@ export class Redis extends core.Redis {
15
16
  * });
16
17
  * ```
17
18
  */
18
- constructor(config) {
19
+ constructor(config, env) {
19
20
  if (config.url.startsWith(" ") ||
20
21
  config.url.endsWith(" ") ||
21
22
  /\r|\n/.test(config.url)) {
@@ -26,13 +27,21 @@ export class Redis extends core.Redis {
26
27
  /\r|\n/.test(config.token)) {
27
28
  console.warn("The redis token contains whitespace or newline, which can cause errors!");
28
29
  }
29
- const client = defaultRequester({
30
+ const client = new HttpClient({
31
+ retry: config.retry,
30
32
  baseUrl: config.url,
31
33
  headers: { authorization: `Bearer ${config.token}` },
34
+ responseEncoding: config.responseEncoding,
32
35
  });
33
36
  super(client, {
37
+ enableTelemetry: !env?.UPSTASH_DISABLE_TELEMETRY,
34
38
  automaticDeserialization: config.automaticDeserialization,
35
39
  });
40
+ // This is only added of the user has not disabled telemetry
41
+ this.addTelemetry({
42
+ platform: "cloudflare",
43
+ sdk: `@upstash/redis@${VERSION}`,
44
+ });
36
45
  }
37
46
  /*
38
47
  * Create a new Upstash Redis instance from environment variables on cloudflare.
@@ -44,9 +53,8 @@ export class Redis extends core.Redis {
44
53
  * ```ts
45
54
  * const redis = Redis.fromEnv(env)
46
55
  * ```
47
- *
48
56
  */
49
- static fromEnv(env) {
57
+ static fromEnv(env, opts) {
50
58
  // @ts-ignore These will be defined by cloudflare
51
59
  const url = env?.UPSTASH_REDIS_REST_URL ?? UPSTASH_REDIS_REST_URL;
52
60
  // @ts-ignore These will be defined by cloudflare
@@ -57,26 +65,6 @@ export class Redis extends core.Redis {
57
65
  if (!token) {
58
66
  throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_TOKEN`. Please add it via `wrangler secret put UPSTASH_REDIS_REST_TOKEN`");
59
67
  }
60
- return new Redis({ url, token });
68
+ return new Redis({ ...opts, url, token }, env);
61
69
  }
62
70
  }
63
- function defaultRequester(config) {
64
- return {
65
- request: async function (req) {
66
- if (!req.path) {
67
- req.path = [];
68
- }
69
- const res = await fetch([config.baseUrl, ...req.path].join("/"), {
70
- method: "POST",
71
- headers: { "Content-Type": "application/json", ...config.headers },
72
- body: JSON.stringify(req.body),
73
- keepalive: true,
74
- });
75
- const body = (await res.json());
76
- if (!res.ok) {
77
- throw new UpstashError(body.error);
78
- }
79
- return body;
80
- },
81
- };
82
- }
@@ -1,5 +1,6 @@
1
1
  import * as core from "../pkg/redis.js";
2
- import { UpstashError } from "../pkg/error.js";
2
+ import { HttpClient } from "../pkg/http.js";
3
+ import { VERSION } from "../version.js";
3
4
  /**
4
5
  * Serverless redis client for upstash.
5
6
  */
@@ -27,35 +28,19 @@ export class Redis extends core.Redis {
27
28
  /\r|\n/.test(config.token)) {
28
29
  console.warn("The redis token contains whitespace or newline, which can cause errors!");
29
30
  }
30
- const client = defaultRequester({
31
+ const client = new HttpClient({
31
32
  baseUrl: config.url,
33
+ retry: config.retry,
32
34
  headers: { authorization: `Bearer ${config.token}` },
33
- backend: config.backend,
35
+ options: { backend: config.backend },
36
+ responseEncoding: config.responseEncoding,
34
37
  });
35
38
  super(client, {
36
39
  automaticDeserialization: config.automaticDeserialization,
37
40
  });
41
+ this.addTelemetry({
42
+ sdk: `@upstash/redis@${VERSION}`,
43
+ platform: "fastly",
44
+ });
38
45
  }
39
46
  }
40
- function defaultRequester(config) {
41
- return {
42
- request: async function (req) {
43
- if (!req.path) {
44
- req.path = [];
45
- }
46
- const res = await fetch([config.baseUrl, ...req.path].join("/"), {
47
- method: "POST",
48
- headers: { "Content-Type": "application/json", ...config.headers },
49
- body: JSON.stringify(req.body),
50
- keepalive: true,
51
- // @ts-expect-error fastly requires `backend`
52
- backend: config.backend,
53
- });
54
- const body = (await res.json());
55
- if (!res.ok) {
56
- throw new UpstashError(body.error);
57
- }
58
- return body;
59
- },
60
- };
61
- }
@@ -1,7 +1,21 @@
1
1
  // deno-lint-ignore-file
2
2
  import * as core from "../pkg/redis.js";
3
- import { UpstashError } from "../pkg/error.js";
3
+ import { HttpClient, } from "../pkg/http.js";
4
+ import { VERSION } from "../version.js";
4
5
  import "isomorphic-fetch";
6
+ // @ts-ignore Deno can't compile
7
+ // import https from "https";
8
+ // @ts-ignore Deno can't compile
9
+ // import http from "http";
10
+ // import "isomorphic-fetch";
11
+ /**
12
+ * Workaround for nodejs 14, where atob is not included in the standardlib
13
+ */
14
+ if (typeof atob === "undefined") {
15
+ global.atob = function (b64) {
16
+ return Buffer.from(b64, "base64").toString("utf-8");
17
+ };
18
+ }
5
19
  /**
6
20
  * Serverless redis client for upstash.
7
21
  */
@@ -21,13 +35,25 @@ export class Redis extends core.Redis {
21
35
  /\r|\n/.test(configOrRequester.token)) {
22
36
  console.warn("The redis token contains whitespace or newline, which can cause errors!");
23
37
  }
24
- const client = defaultRequester({
38
+ const client = new HttpClient({
25
39
  baseUrl: configOrRequester.url,
40
+ retry: configOrRequester.retry,
26
41
  headers: { authorization: `Bearer ${configOrRequester.token}` },
27
- // agent: configOrRequester.agent,
42
+ // agent: configOrRequester.agent,
43
+ responseEncoding: configOrRequester.responseEncoding,
28
44
  });
29
45
  super(client, {
30
46
  automaticDeserialization: configOrRequester.automaticDeserialization,
47
+ enableTelemetry: !process.env.UPSTASH_DISABLE_TELEMETRY,
48
+ });
49
+ this.addTelemetry({
50
+ runtime: `node@${process.version}`,
51
+ platform: process.env.VERCEL
52
+ ? "vercel"
53
+ : process.env.AWS_REGION
54
+ ? "aws"
55
+ : "unknown",
56
+ sdk: `@upstash/redis@${VERSION}`,
31
57
  });
32
58
  }
33
59
  /**
@@ -54,28 +80,6 @@ export class Redis extends core.Redis {
54
80
  if (!token) {
55
81
  throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_TOKEN`");
56
82
  }
57
- return new Redis({ url, token, ...config });
83
+ return new Redis({ ...config, url, token });
58
84
  }
59
85
  }
60
- function defaultRequester(config) {
61
- return {
62
- request: async function (req) {
63
- if (!req.path) {
64
- req.path = [];
65
- }
66
- const res = await fetch([config.baseUrl, ...req.path].join("/"), {
67
- method: "POST",
68
- headers: { "Content-Type": "application/json", ...config.headers },
69
- body: JSON.stringify(req.body),
70
- keepalive: true,
71
- // @ts-ignore
72
- agent: config.agent,
73
- });
74
- const body = (await res.json());
75
- if (!res.ok) {
76
- throw new UpstashError(body.error);
77
- }
78
- return body;
79
- },
80
- };
81
- }