@upstash/redis 1.3.2-alpha.0 → 1.3.3-alpha.0

package/README.md

@@ -34,10 +34,18 @@ further explanation we wrote a
 
 ### Install
 
+#### npm
+
 ```bash
 npm install @upstash/redis
 ```
 
+#### Deno
+
+```ts
+import { Redis } from "https://deno.land/x/upstash_redis/mod.ts";
+```
+
 ### Create database
 
 Create a new redis database on [upstash](https://console.upstash.com/)
@@ -68,7 +76,7 @@ const redis = new Redis({
 const redis = Redis.fromEnv()
 ```
 
-- [Code example](https://github.com/upstash/upstash-redis/tree/main/examples/node)
+- [Code example](https://github.com/upstash/upstash-redis/blob/main/examples/nodejs)
 
 #### Cloudflare Workers
 
@@ -127,6 +135,23 @@ const redis = new Redis({
 - [Code example](https://github.com/upstash/upstash-redis/tree/main/examples/fastly)
 - [Documentation](https://blog.upstash.com/fastly-compute-edge-with-redi)
 
+#### Deno
+
+Examples: [Deno Deploy](https://deno.com/deploy),
+[Netlify Edge](https://www.netlify.com/products/edge/)
+
+```ts
+import { Redis } from "https://deno.land/x/upstash_redis/mod.ts"
+
+const redis = new Redis({
+  url: <UPSTASH_REDIS_REST_URL>,
+  token: <UPSTASH_REDIS_REST_TOKEN>,
+})
+
+// or
+const redis = Redis.fromEnv();
+```
+
 ### Working with types
 
 Most commands allow you to provide a type to make working with typescript

package/esm/pkg/commands/append.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/append
  */
 export class AppendCommand extends Command {
-    constructor(key, value) {
-        super(["append", key, value]);
+    constructor(cmd, opts) {
+        super(["append", ...cmd], opts);
     }
 }

package/esm/pkg/commands/bitcount.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/bitcount
  */
 export class BitCountCommand extends Command {
-    constructor(key, start, end) {
+    constructor([key, start, end], opts) {
         const command = ["bitcount", key];
         if (typeof start === "number") {
             command.push(start);
@@ -11,6 +11,6 @@ export class BitCountCommand extends Command {
         if (typeof end === "number") {
             command.push(end);
         }
-        super(command);
+        super(command, opts);
     }
 }

package/esm/pkg/commands/bitop.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/bitop
  */
 export class BitOpCommand extends Command {
-    constructor(op, destinationKey, sourceKey, ...sourceKeys) {
-        super(["bitop", op, destinationKey, sourceKey, ...sourceKeys]);
+    constructor(cmd, opts) {
+        super(["bitop", ...cmd], opts);
     }
 }

package/esm/pkg/commands/bitpos.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/bitpos
  */
 export class BitPosCommand extends Command {
-    constructor(key, start, end) {
-        super(["bitpos", key, start, end]);
+    constructor(cmd, opts) {
+        super(["bitpos", ...cmd], opts);
     }
 }

package/esm/pkg/commands/command.js

@@ -1,5 +1,6 @@
 import { UpstashError } from "../error.js";
 import { parseResponse } from "../util.js";
+const defaultSerializer = (c) => typeof c === "string" ? c : JSON.stringify(c);
 /**
  * Command offers default (de)serialization and the exec method to all commands.
  *
@@ -19,14 +20,24 @@ export class Command {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "serialize", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "deserialize", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        this.command = command.map((c) => typeof c === "string" ? c : JSON.stringify(c));
-        this.deserialize = opts?.deserialize ?? parseResponse;
+        this.serialize = defaultSerializer;
+        this.deserialize = typeof opts?.automaticDeserialization === "undefined" ||
+            opts.automaticDeserialization
+            ? opts?.deserialize ?? parseResponse
+            : (x) => x;
+        this.command = command.map(this.serialize);
     }
     /**
      * Execute the command using a client.

package/esm/pkg/commands/dbsize.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/dbsize
  */
 export class DBSizeCommand extends Command {
-    constructor() {
-        super(["dbsize"]);
+    constructor(opts) {
+        super(["dbsize"], opts);
     }
 }

package/esm/pkg/commands/decr.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/decr
  */
 export class DecrCommand extends Command {
-    constructor(key) {
-        super(["decr", key]);
+    constructor(cmd, opts) {
+        super(["decr", ...cmd], opts);
     }
 }

package/esm/pkg/commands/decrby.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/decrby
  */
 export class DecrByCommand extends Command {
-    constructor(key, decrement) {
-        super(["decrby", key, decrement]);
+    constructor(cmd, opts) {
+        super(["decrby", ...cmd], opts);
     }
 }

package/esm/pkg/commands/del.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/del
  */
 export class DelCommand extends Command {
-    constructor(...keys) {
-        super(["del", ...keys]);
+    constructor(cmd, opts) {
+        super(["del", ...cmd], opts);
     }
 }

package/esm/pkg/commands/echo.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/echo
  */
 export class EchoCommand extends Command {
-    constructor(message) {
-        super(["echo", message]);
+    constructor(cmd, opts) {
+        super(["echo", ...cmd], opts);
     }
 }

package/esm/pkg/commands/eval.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/eval
  */
 export class EvalCommand extends Command {
-    constructor(script, keys, args) {
-        super(["eval", script, keys.length, ...keys, ...(args ?? [])]);
+    constructor([script, keys, args], opts) {
+        super(["eval", script, keys.length, ...keys, ...(args ?? [])], opts);
     }
 }

package/esm/pkg/commands/evalsha.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/evalsha
  */
 export class EvalshaCommand extends Command {
-    constructor(sha, keys, args) {
-        super(["evalsha", sha, keys.length, ...keys, ...(args ?? [])]);
+    constructor([sha, keys, args], opts) {
+        super(["evalsha", sha, keys.length, ...keys, ...(args ?? [])], opts);
     }
 }

package/esm/pkg/commands/exists.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/exists
  */
 export class ExistsCommand extends Command {
-    constructor(...keys) {
-        super(["exists", ...keys]);
+    constructor(cmd, opts) {
+        super(["exists", ...cmd], opts);
     }
 }

package/esm/pkg/commands/expire.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/expire
  */
 export class ExpireCommand extends Command {
-    constructor(key, seconds) {
-        super(["expire", key, seconds]);
+    constructor(cmd, opts) {
+        super(["expire", ...cmd], opts);
     }
 }

package/esm/pkg/commands/expireat.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/expireat
  */
 export class ExpireAtCommand extends Command {
-    constructor(key, unix) {
-        super(["expireat", key, unix]);
+    constructor(cmd, opts) {
+        super(["expireat", ...cmd], opts);
     }
 }

package/esm/pkg/commands/flushall.js

@@ -3,11 +3,11 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/flushall
  */
 export class FlushAllCommand extends Command {
-    constructor(opts) {
+    constructor(args, opts) {
         const command = ["flushall"];
-        if (opts?.async) {
+        if (args && args.length > 0 && args[0].async) {
             command.push("async");
         }
-        super(command);
+        super(command, opts);
     }
 }

package/esm/pkg/commands/flushdb.js

@@ -3,11 +3,11 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/flushdb
  */
 export class FlushDBCommand extends Command {
-    constructor(opts) {
+    constructor([opts], cmdOpts) {
         const command = ["flushdb"];
         if (opts?.async) {
             command.push("async");
         }
-        super(command);
+        super(command, cmdOpts);
     }
 }

package/esm/pkg/commands/get.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/get
  */
 export class GetCommand extends Command {
-    constructor(key) {
-        super(["get", key]);
+    constructor(cmd, opts) {
+        super(["get", ...cmd], opts);
     }
 }

package/esm/pkg/commands/getbit.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/getbit
  */
 export class GetBitCommand extends Command {
-    constructor(key, offset) {
-        super(["getbit", key, offset]);
+    constructor(cmd, opts) {
+        super(["getbit", ...cmd], opts);
     }
 }

package/esm/pkg/commands/getrange.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/getrange
  */
 export class GetRangeCommand extends Command {
-    constructor(key, start, end) {
-        super(["getrange", key, start, end]);
+    constructor(cmd, opts) {
+        super(["getrange", ...cmd], opts);
     }
 }

package/esm/pkg/commands/getset.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/getset
  */
 export class GetSetCommand extends Command {
-    constructor(key, value) {
-        super(["getset", key, value]);
+    constructor(cmd, opts) {
+        super(["getset", ...cmd], opts);
     }
 }

package/esm/pkg/commands/hdel.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hdel
  */
 export class HDelCommand extends Command {
-    constructor(key, field) {
-        super(["hdel", key, field]);
+    constructor(cmd, opts) {
+        super(["hdel", ...cmd], opts);
     }
 }

package/esm/pkg/commands/hexists.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hexists
  */
 export class HExistsCommand extends Command {
-    constructor(key, field) {
-        super(["hexists", key, field]);
+    constructor(cmd, opts) {
+        super(["hexists", ...cmd], opts);
     }
 }

package/esm/pkg/commands/hget.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hget
  */
 export class HGetCommand extends Command {
-    constructor(key, field) {
-        super(["hget", key, field]);
+    constructor(cmd, opts) {
+        super(["hget", ...cmd], opts);
     }
 }

package/esm/pkg/commands/hgetall.js

@@ -24,7 +24,10 @@ function deserialize(result) {
  * @see https://redis.io/commands/hgetall
  */
 export class HGetAllCommand extends Command {
-    constructor(key) {
-        super(["hgetall", key], { deserialize: (result) => deserialize(result) });
+    constructor(cmd, opts) {
+        super(["hgetall", ...cmd], {
+            deserialize: (result) => deserialize(result),
+            ...opts,
+        });
     }
 }

package/esm/pkg/commands/hincrby.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hincrby
  */
 export class HIncrByCommand extends Command {
-    constructor(key, field, increment) {
-        super(["hincrby", key, field, increment]);
+    constructor(cmd, opts) {
+        super(["hincrby", ...cmd], opts);
     }
 }

package/esm/pkg/commands/hincrbyfloat.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hincrbyfloat
  */
 export class HIncrByFloatCommand extends Command {
-    constructor(key, field, increment) {
-        super(["hincrbyfloat", key, field, increment]);
+    constructor(cmd, opts) {
+        super(["hincrbyfloat", ...cmd], opts);
     }
 }

package/esm/pkg/commands/hkeys.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hkeys
  */
 export class HKeysCommand extends Command {
-    constructor(key) {
-        super(["hkeys", key]);
+    constructor([key], opts) {
+        super(["hkeys", key], opts);
     }
 }

package/esm/pkg/commands/hlen.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hlen
  */
 export class HLenCommand extends Command {
-    constructor(key) {
-        super(["hlen", key]);
+    constructor(cmd, opts) {
+        super(["hlen", ...cmd], opts);
     }
 }

package/esm/pkg/commands/hmget.js

@@ -26,7 +26,10 @@ function deserialize(fields, result) {
  * @see https://redis.io/commands/hmget
  */
 export class HMGetCommand extends Command {
-    constructor(key, ...fields) {
-        super(["hmget", key, ...fields], { deserialize: (result) => deserialize(fields, result) });
+    constructor([key, ...fields], opts) {
+        super(["hmget", key, ...fields], {
+            deserialize: (result) => deserialize(fields, result),
+            ...opts,
+        });
     }
 }

package/esm/pkg/commands/hmset.js

@@ -3,11 +3,11 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hmset
  */
 export class HMSetCommand extends Command {
-    constructor(key, kv) {
+    constructor([key, kv], opts) {
         super([
             "hmset",
             key,
             ...Object.entries(kv).flatMap(([field, value]) => [field, value]),
-        ]);
+        ], opts);
     }
 }

package/esm/pkg/commands/hscan.js

@@ -3,14 +3,14 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hscan
  */
 export class HScanCommand extends Command {
-    constructor(key, cursor, opts) {
+    constructor([key, cursor, cmdOpts], opts) {
         const command = ["hscan", key, cursor];
-        if (opts?.match) {
-            command.push("match", opts.match);
+        if (cmdOpts?.match) {
+            command.push("match", cmdOpts.match);
         }
-        if (typeof opts?.count === "number") {
-            command.push("count", opts.count);
+        if (typeof cmdOpts?.count === "number") {
+            command.push("count", cmdOpts.count);
         }
-        super(command);
+        super(command, opts);
     }
 }

package/esm/pkg/commands/hset.js

@@ -3,11 +3,11 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hset
  */
 export class HSetCommand extends Command {
-    constructor(key, kv) {
+    constructor([key, kv], opts) {
         super([
             "hset",
             key,
             ...Object.entries(kv).flatMap(([field, value]) => [field, value]),
-        ]);
+        ], opts);
     }
 }

package/esm/pkg/commands/hsetnx.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hsetnx
  */
 export class HSetNXCommand extends Command {
-    constructor(key, field, value) {
-        super(["hsetnx", key, field, value]);
+    constructor(cmd, opts) {
+        super(["hsetnx", ...cmd], opts);
     }
 }

package/esm/pkg/commands/hstrlen.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hstrlen
  */
 export class HStrLenCommand extends Command {
-    constructor(key, field) {
-        super(["hstrlen", key, field]);
+    constructor(cmd, opts) {
+        super(["hstrlen", ...cmd], opts);
     }
 }

package/esm/pkg/commands/hvals.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/hvals
  */
 export class HValsCommand extends Command {
-    constructor(key) {
-        super(["hvals", key]);
+    constructor(cmd, opts) {
+        super(["hvals", ...cmd], opts);
     }
 }

package/esm/pkg/commands/incr.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/incr
  */
 export class IncrCommand extends Command {
-    constructor(key) {
-        super(["incr", key]);
+    constructor(cmd, opts) {
+        super(["incr", ...cmd], opts);
     }
 }

package/esm/pkg/commands/incrby.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/incrby
  */
 export class IncrByCommand extends Command {
-    constructor(key, value) {
-        super(["incrby", key, value]);
+    constructor(cmd, opts) {
+        super(["incrby", ...cmd], opts);
     }
 }

package/esm/pkg/commands/incrbyfloat.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/incrbyfloat
  */
 export class IncrByFloatCommand extends Command {
-    constructor(key, value) {
-        super(["incrbyfloat", key, value]);
+    constructor(cmd, opts) {
+        super(["incrbyfloat", ...cmd], opts);
     }
 }

package/esm/pkg/commands/keys.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/keys
  */
 export class KeysCommand extends Command {
-    constructor(pattern) {
-        super(["keys", pattern]);
+    constructor(cmd, opts) {
+        super(["keys", ...cmd], opts);
     }
 }

package/esm/pkg/commands/lindex.js

@@ -1,6 +1,6 @@
 import { Command } from "./command.js";
 export class LIndexCommand extends Command {
-    constructor(key, index) {
-        super(["lindex", key, index]);
+    constructor(cmd, opts) {
+        super(["lindex", ...cmd], opts);
     }
 }

package/esm/pkg/commands/linsert.js

@@ -1,6 +1,6 @@
 import { Command } from "./command.js";
 export class LInsertCommand extends Command {
-    constructor(key, direction, pivot, value) {
-        super(["linsert", key, direction, pivot, value]);
+    constructor(cmd, opts) {
+        super(["linsert", ...cmd], opts);
     }
 }

package/esm/pkg/commands/llen.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/llen
  */
 export class LLenCommand extends Command {
-    constructor(key) {
-        super(["llen", key]);
+    constructor(cmd, opts) {
+        super(["llen", ...cmd], opts);
     }
 }

package/esm/pkg/commands/lpop.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/lpop
  */
 export class LPopCommand extends Command {
-    constructor(key) {
-        super(["lpop", key]);
+    constructor(cmd, opts) {
+        super(["lpop", ...cmd], opts);
     }
 }

package/esm/pkg/commands/lpush.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/lpush
  */
 export class LPushCommand extends Command {
-    constructor(key, ...elements) {
-        super(["lpush", key, ...elements]);
+    constructor(cmd, opts) {
+        super(["lpush", ...cmd], opts);
     }
 }

package/esm/pkg/commands/lpushx.js

@@ -3,7 +3,7 @@ import { Command } from "./command.js";
  * @see https://redis.io/commands/lpushx
  */
 export class LPushXCommand extends Command {
-    constructor(key, ...elements) {
-        super(["lpushx", key, ...elements]);
+    constructor(cmd, opts) {
+        super(["lpushx", ...cmd], opts);
     }
 }

package/esm/pkg/commands/lrange.js

@@ -1,6 +1,6 @@
 import { Command } from "./command.js";
 export class LRangeCommand extends Command {
-    constructor(key, start, end) {
-        super(["lrange", key, start, end]);
+    constructor(cmd, opts) {
+        super(["lrange", ...cmd], opts);
     }
 }