@upstash/redis 1.0.0-alpha.3 → 1.0.0

package/README.md

@@ -0,0 +1,256 @@
+# Upstash Redis
+
+An HTTP/REST based Redis client built on top of
+[Upstash REST API](https://docs.upstash.com/features/restapi).
+
+[![Tests](https://github.com/upstash/upstash-redis/actions/workflows/tests.yaml/badge.svg)](https://github.com/upstash/upstash-redis/actions/workflows/tests.yaml)
+![npm (scoped)](https://img.shields.io/npm/v/@upstash/redis)
+![npm bundle size](https://img.shields.io/bundlephobia/minzip/@upstash/redis)
+
+It is the only connectionless (HTTP based) Redis client and designed for:
+
+- Serverless functions (AWS Lambda ...)
+- Cloudflare Workers (see
+  [the example](https://github.com/upstash/upstash-redis/tree/master/examples/cloudflare-workers))
+- Fastly Compute@Edge (see
+  [the example](https://github.com/upstash/upstash-redis/tree/master/examples/fastly))
+- Next.js, Jamstack ...
+- Client side web/mobile applications
+- WebAssembly
+- and other environments where HTTP is preferred over TCP.
+
+See [the list of APIs](https://docs.upstash.com/features/restapi#rest---redis-api-compatibility) supported.
+
+## Upgrading from v0.2.0?
+
+Please read the [migration guide](https://github.com/upstash/upstash-redis#migrating-to-v1).
+For further explanation we wrote a [blog post](https://blog.upstash.com/upstash-redis-sdk-v1).
+
+## Quick Start
+
+### Install
+
+```bash
+npm install @upstash/redis
+```
+
+### Create database
+
+Create a new redis database on [upstash](https://console.upstash.com/)
+
+### Environments
+
+We support various platforms, such as nodejs, cloudflare and fastly.
+Platforms differ slightly when it comes to environment variables and their `fetch` api. Please use the correct import when deploying to special platforms.
+
+#### Node.js
+
+Examples: Vercel, Netlify, AWS Lambda
+
+If you are running on nodejs you can set `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` as environment variable and create a redis instance like this:
+
+```ts
+import { Redis } from "@upstash/redis"
+
+const redis = new Redis({
+  url: <UPSTASH_REDIS_REST_URL>,
+  token: <UPSTASH_REDIS_REST_TOKEN>,
+})
+
+// or load directly from env
+const redis = Redis.fromEnv()
+```
+
+- [Code example](https://github.com/upstash/upstash-redis/tree/main/examples/node)
+
+#### Cloudflare Workers
+
+Cloudflare handles environment variables differently than nodejs.
+Please add `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` using `wrangler secret put ...` or in the cloudflare dashboard.
+
+Afterwards you can create a redis instance:
+
+```ts
+import { Redis } from "@upstash/redis/cloudflare"
+
+const redis = new Redis({
+  url: <UPSTASH_REDIS_REST_URL>,
+  token: <UPSTASH_REDIS_REST_TOKEN>,
+})
+// or load directly from env
+const redis = Redis.fromEnv()
+```
+
+- [Code example](https://github.com/upstash/upstash-redis/tree/main/examples/cloudflare-workers)
+- [Documentation](https://docs.upstash.com/redis/tutorials/cloudflare_workers_with_redis)
+
+#### Fastly
+
+Fastly introduces a concept called [backend](https://developer.fastly.com/reference/api/services/backend/). You need to configure a backend in your `fastly.toml`. An example can be found [here](https://github.com/upstash/upstash-redis/blob/main/examples/fastly/fastly.toml).
+Until the fastly api stabilizes we recommend creating an instance manually:
+
+```ts
+import { Redis } from "@upstash/redis/fastly"
+
+const redis = new Redis({
+  url: <UPSTASH_REDIS_REST_URL>,
+  token: <UPSTASH_REDIS_REST_TOKEN>,
+  backend: <BACKEND_NAME>,
+})
+```
+
+- [Code example](https://github.com/upstash/upstash-redis/tree/main/examples/fastly)
+- [Documentation](https://blog.upstash.com/fastly-compute-edge-with-redi)
+
+### Working with types
+
+Most commands allow you to provide a type to make working with typescript easier.
+
+```ts
+const data = await redis.get<MyCustomType>("key")
+// data is typed as `MyCustomType`
+```
+
+## Migrating to v1
+
+### Explicit authentication
+
+The library is no longer automatically trying to load connection secrets from environment variables.
+You must either supply them yourself:
+
+```ts
+import { Redis } from "@upstash/redis"
+
+const redis = new Redis({
+  url: <UPSTASH_REDIS_REST_URL>,
+  token: <UPSTASH_REDIS_REST_TOKEN>,
+})
+```
+
+Or use one of the static constructors to load from environment variables:
+
+```ts
+// Nodejs
+import { Redis } from "@upstash/redis"
+const redis = Redis.fromEnv()
+```
+
+```ts
+// or when deploying to cloudflare workers
+import { Redis } from "@upstash/redis/cloudflare"
+const redis = Redis.fromEnv()
+```
+
+### Error handling
+
+Errors are now thrown automatically instead of being returned to you.
+
+```ts
+// old
+const { data, error } = await set("key", "value")
+if (error) {
+  throw new Error(error)
+}
+
+// new
+const data = await redis.set("key", "value") // error is thrown automatically
+```
+
+## Pipeline
+
+`v1.0.0` introduces redis pipelines.
+Pipelining commands allows you to send a single http request with multiple commands.
+
+```ts
+import { Redis } from "@upstash/redis"
+
+const redis = new Redis({
+  /* auth */
+})
+
+const p = redis.pipeline()
+
+// Now you can chain multiple commands to create your pipeline:
+
+p.set("key", 2)
+p.incr("key")
+
+// or inline:
+p.hset("key2", "field", { hello: "world" }).hvals("key2")
+
+// Execute the pipeline once you are done building it:
+// `exec` returns an array where each element represents the response of a command in the pipeline.
+// You can optionally provide a type like this to get a typed response.
+const res = await p.exec<[Type1, Type2, Type3]>()
+```
+
+For more information about pipelines using REST see [here](https://blog.upstash.com/pipeline).
+
+### Advanced
+
+A low level `Command` class can be imported from `@upstash/redis` in case you need more control about types and or (de)serialization.
+
+By default all objects you are storing in redis are serialized using `JSON.stringify` and recursively deserialized as well. Here's an example how you could customize that behaviour. Keep in mind that you need to provide a `fetch` polyfill if you are running on nodejs. We recommend [isomorphic-fetch](https://www.npmjs.com/package/isomorphic-fetch).
+
+```ts
+import { Command } from "@upstash/redis/commands"
+import { HttpClient } from "@upstash/redis/http"
+
+/**
+ * TData represents what the user will enter or receive,
+ * TResult is the raw data returned from upstash, which may need to be
+ * transformed or parsed.
+ */
+const deserialize: (raw: TResult) => TData = ...
+
+class CustomGetCommand<TData, TResult> extends Command<TData | null, TResult | null> {
+  constructor(key: string, ) {
+    super(["get", key], { deserialize })
+  }
+}
+
+const client = new HttpClient({
+  baseUrl: <UPSTASH_REDIS_REST_URL>,
+  headers: {
+    authorization: `Bearer ${<UPSTASH_REDIS_REST_TOKEN>}`,
+  },
+})
+
+const res = new CustomGetCommand("key").exec(client)
+
+```
+
+#### Javascript MAX_SAFE_INTEGER
+
+Javascript can not handle numbers larger than `2^53 -1` safely and would return wrong results when trying to deserialize them.
+In these cases the default deserializer will return them as string instead. This might cause a mismatch with your custom types.
+
+```ts
+await redis.set("key", "101600000000150081467")
+const res = await redis<number>("get")
+```
+
+In this example `res` will still be a string despite the type annotation.
+Please keep that in mind and adjust accordingly.
+
+## Docs
+
+See [the documentation](https://docs.upstash.com/features/javascriptsdk) for details.
+
+## Contributing
+
+### Installing dependencies
+
+```bash
+pnpm install
+```
+
+### Database
+
+Create a new redis database on [upstash](https://console.upstash.com/) and copy the url and token to `.env` (See `.env.example` for reference)
+
+### Running tests
+
+```sh
+pnpm test
+```

package/{chunk-FJSI5EBJ.mjs → chunk-AHCVU33N.mjs}

@@ -1,9 +1,9 @@
 import {
   Redis
-} from "./chunk-Y5TC4HX2.mjs";
+} from "./chunk-T66TTHSV.mjs";
 import {
   HttpClient
-} from "./chunk-U7OXAQMQ.mjs";
+} from "./chunk-HIDCSH5S.mjs";
 
 // pkg/nodejs.ts
 import "isomorphic-fetch";

package/{chunk-ZIB6XPPC.mjs → chunk-HGM7M7CJ.mjs}

@@ -4,13 +4,17 @@ import {
 
 // pkg/util.ts
 function parseRecursive(obj) {
-  return Array.isArray(obj) ? obj.map((o) => {
+  const parsed = Array.isArray(obj) ? obj.map((o) => {
     try {
       return parseRecursive(o);
     } catch {
       return o;
     }
   }) : JSON.parse(obj);
+  if (typeof parsed === "number" && parsed.toString() != obj) {
+    return obj;
+  }
+  return parsed;
 }
 function parseResponse(result) {
   try {
@@ -20,7 +24,7 @@ function parseResponse(result) {
   }
 }
 
-// pkg/command.ts
+// pkg/commands/command.ts
 var Command = class {
   constructor(command, opts) {
     var _a;
@@ -300,8 +304,8 @@ var HScanCommand = class extends Command {
 
 // pkg/commands/hset.ts
 var HSetCommand = class extends Command {
-  constructor(key, field, value) {
-    super(["hset", key, field, value]);
+  constructor(key, kv) {
+    super(["hset", key, ...Object.entries(kv).flatMap(([field, value]) => [field, value])]);
   }
 };
 
@@ -951,6 +955,7 @@ var ZUnionStoreCommand = class extends Command {
 };
 
 export {
+  Command,
   AppendCommand,
   BitCountCommand,
   BitOpCommand,

package/{chunk-U7OXAQMQ.mjs → chunk-HIDCSH5S.mjs}

@@ -4,7 +4,6 @@ import {
 } from "./chunk-7YUZYRJS.mjs";
 
 // pkg/http.ts
-import "isomorphic-fetch";
 var HttpClient = class {
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");

package/{chunk-Y5TC4HX2.mjs → chunk-T66TTHSV.mjs}

@@ -106,7 +106,7 @@ import {
   ZScanCommand,
   ZScoreCommand,
   ZUnionStoreCommand
-} from "./chunk-ZIB6XPPC.mjs";
+} from "./chunk-HGM7M7CJ.mjs";
 import {
   UpstashError
 } from "./chunk-7YUZYRJS.mjs";
@@ -223,8 +223,8 @@ var Pipeline = class {
   hscan(...args) {
     return this.chain(new HScanCommand(...args));
   }
-  hset(key, field, value) {
-    return this.chain(new HSetCommand(key, field, value));
+  hset(key, kv) {
+    return this.chain(new HSetCommand(key, kv));
   }
   hsetnx(key, field, value) {
     return this.chain(new HSetNXCommand(key, field, value));
@@ -554,8 +554,8 @@ var Redis = class {
   hscan(...args) {
     return new HScanCommand(...args).exec(this.client);
   }
-  hset(key, field, value) {
-    return new HSetCommand(key, field, value).exec(this.client);
+  hset(key, kv) {
+    return new HSetCommand(key, kv).exec(this.client);
   }
   hsetnx(key, field, value) {
     return new HSetNXCommand(key, field, value).exec(this.client);

package/cloudflare.d.ts

@@ -1,5 +1,5 @@
-import { R as Redis$1 } from './redis-dd052782';
-import './zunionstore-dffa797d';
+import { R as Redis$1 } from './redis-71fa1ee6';
+import './zunionstore-b38007ba';
 import './http';
 
 /**

package/cloudflare.js

@@ -51,13 +51,17 @@ var UpstashError = class extends Error {
 
 // pkg/util.ts
 function parseRecursive(obj) {
-  return Array.isArray(obj) ? obj.map((o) => {
+  const parsed = Array.isArray(obj) ? obj.map((o) => {
     try {
       return parseRecursive(o);
     } catch {
       return o;
     }
   }) : JSON.parse(obj);
+  if (typeof parsed === "number" && parsed.toString() != obj) {
+    return obj;
+  }
+  return parsed;
 }
 function parseResponse(result) {
   try {
@@ -67,7 +71,7 @@ function parseResponse(result) {
   }
 }
 
-// pkg/command.ts
+// pkg/commands/command.ts
 var Command = class {
   constructor(command, opts) {
     var _a;
@@ -347,8 +351,8 @@ var HScanCommand = class extends Command {
 
 // pkg/commands/hset.ts
 var HSetCommand = class extends Command {
-  constructor(key, field, value) {
-    super(["hset", key, field, value]);
+  constructor(key, kv) {
+    super(["hset", key, ...Object.entries(kv).flatMap(([field, value]) => [field, value])]);
   }
 };
 
@@ -1109,8 +1113,8 @@ var Pipeline = class {
   hscan(...args) {
     return this.chain(new HScanCommand(...args));
   }
-  hset(key, field, value) {
-    return this.chain(new HSetCommand(key, field, value));
+  hset(key, kv) {
+    return this.chain(new HSetCommand(key, kv));
   }
   hsetnx(key, field, value) {
     return this.chain(new HSetNXCommand(key, field, value));
@@ -1440,8 +1444,8 @@ var Redis = class {
   hscan(...args) {
     return new HScanCommand(...args).exec(this.client);
   }
-  hset(key, field, value) {
-    return new HSetCommand(key, field, value).exec(this.client);
+  hset(key, kv) {
+    return new HSetCommand(key, kv).exec(this.client);
   }
   hsetnx(key, field, value) {
     return new HSetNXCommand(key, field, value).exec(this.client);
@@ -1680,7 +1684,6 @@ var Redis = class {
 };
 
 // pkg/http.ts
-var import_isomorphic_fetch = require("isomorphic-fetch");
 var HttpClient = class {
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");

package/cloudflare.mjs

@@ -1,10 +1,10 @@
 import {
   Redis
-} from "./chunk-Y5TC4HX2.mjs";
-import "./chunk-ZIB6XPPC.mjs";
+} from "./chunk-T66TTHSV.mjs";
+import "./chunk-HGM7M7CJ.mjs";
 import {
   HttpClient
-} from "./chunk-U7OXAQMQ.mjs";
+} from "./chunk-HIDCSH5S.mjs";
 import "./chunk-7YUZYRJS.mjs";
 
 // pkg/cloudflare.ts

package/commands.d.ts

@@ -1,5 +1,5 @@
-import { at as Command, N as NonEmptyArray } from './zunionstore-dffa797d';
-export { A as AppendCommand, B as BitCountCommand, a as BitPosCommand, b as DecrByCommand, D as DecrCommand, c as DelCommand, E as EchoCommand, d as ExistsCommand, f as ExpireAtCommand, e as ExpireCommand, F as FlushAllCommand, g as FlushDBCommand, h as GetBitCommand, G as GetCommand, i as GetRangeCommand, H as HDelCommand, j as HExistsCommand, l as HGetAllCommand, k as HGetCommand, m as HIncrByCommand, n as HIncrByFloatCommand, o as HKeysCommand, p as HLenCommand, q as HMGetCommand, r as HScanCommand, s as HStrLenCommand, t as HValsCommand, u as IncrByCommand, v as IncrByFloatCommand, I as IncrCommand, K as KeysCommand, L as LIndexCommand, w as LLenCommand, x as LPopCommand, y as LRangeCommand, z as LTrimCommand, M as MGetCommand, O as PExpireAtCommand, J as PExpireCommand, R as PTtlCommand, P as PersistCommand, Q as PingCommand, U as RPopCommand, S as RenameCommand, T as RenameNXCommand, W as SCardCommand, X as SDiffCommand, Y as SDiffStoreCommand, a0 as SInterCommand, a1 as SInterStoreCommand, a2 as SMembersCommand, a3 as SPopCommand, a4 as SRandMemberCommand, a5 as SScanCommand, a7 as SUnionCommand, a8 as SUnionStoreCommand, V as ScanCommand, au as ScanCommandOptions, ad as ScoreMember, _ as SetBitCommand, av as SetCommand, Z as SetCommandOptions, $ as SetRangeCommand, a6 as StrLenCommand, a9 as TouchCommand, aa as TtlCommand, as as Type, ab as TypeCommand, ac as UnlinkCommand, aw as ZAddCommand, ae as ZAddCommandOptions, af as ZAddCommandOptionsWithIncr, ag as ZCardCommand, ah as ZCountCommand, ai as ZInterStoreCommand, ax as ZInterStoreCommandOptions, aj as ZLexCountCommand, ak as ZPopMaxCommand, al as ZPopMinCommand, am as ZRangeCommand, ay as ZRangeCommandOptions, an as ZRemRangeByLexCommand, ao as ZRemRangeByRankCommand, ap as ZRemRangeByScoreCommand, aq as ZScanCommand, ar as ZUnionStoreCommand, az as ZUnionStoreCommandOptions } from './zunionstore-dffa797d';
+import { at as Command, N as NonEmptyArray } from './zunionstore-b38007ba';
+export { A as AppendCommand, B as BitCountCommand, a as BitPosCommand, at as Command, b as DecrByCommand, D as DecrCommand, c as DelCommand, E as EchoCommand, d as ExistsCommand, f as ExpireAtCommand, e as ExpireCommand, F as FlushAllCommand, g as FlushDBCommand, h as GetBitCommand, G as GetCommand, i as GetRangeCommand, H as HDelCommand, j as HExistsCommand, l as HGetAllCommand, k as HGetCommand, m as HIncrByCommand, n as HIncrByFloatCommand, o as HKeysCommand, p as HLenCommand, q as HMGetCommand, r as HScanCommand, s as HStrLenCommand, t as HValsCommand, u as IncrByCommand, v as IncrByFloatCommand, I as IncrCommand, K as KeysCommand, L as LIndexCommand, w as LLenCommand, x as LPopCommand, y as LRangeCommand, z as LTrimCommand, M as MGetCommand, O as PExpireAtCommand, J as PExpireCommand, R as PTtlCommand, P as PersistCommand, Q as PingCommand, U as RPopCommand, S as RenameCommand, T as RenameNXCommand, W as SCardCommand, X as SDiffCommand, Y as SDiffStoreCommand, a0 as SInterCommand, a1 as SInterStoreCommand, a2 as SMembersCommand, a3 as SPopCommand, a4 as SRandMemberCommand, a5 as SScanCommand, a7 as SUnionCommand, a8 as SUnionStoreCommand, V as ScanCommand, au as ScanCommandOptions, ad as ScoreMember, _ as SetBitCommand, av as SetCommand, Z as SetCommandOptions, $ as SetRangeCommand, a6 as StrLenCommand, a9 as TouchCommand, aa as TtlCommand, as as Type, ab as TypeCommand, ac as UnlinkCommand, aw as ZAddCommand, ae as ZAddCommandOptions, af as ZAddCommandOptionsWithIncr, ag as ZCardCommand, ah as ZCountCommand, ai as ZInterStoreCommand, ax as ZInterStoreCommandOptions, aj as ZLexCountCommand, ak as ZPopMaxCommand, al as ZPopMinCommand, am as ZRangeCommand, ay as ZRangeCommandOptions, an as ZRemRangeByLexCommand, ao as ZRemRangeByRankCommand, ap as ZRemRangeByScoreCommand, aq as ZScanCommand, ar as ZUnionStoreCommand, az as ZUnionStoreCommandOptions } from './zunionstore-b38007ba';
 import './http';
 
 /**
@@ -37,7 +37,9 @@ declare class HMSetCommand<TData> extends Command<number, number> {
  * @see https://redis.io/commands/hset
  */
 declare class HSetCommand<TData> extends Command<number, number> {
-    constructor(key: string, field: string, value: TData);
+    constructor(key: string, kv: {
+        [field: string]: TData;
+    });
 }
 
 /**

package/commands.js

@@ -28,6 +28,7 @@ __export(commands_exports, {
   BitCountCommand: () => BitCountCommand,
   BitOpCommand: () => BitOpCommand,
   BitPosCommand: () => BitPosCommand,
+  Command: () => Command,
   DBSizeCommand: () => DBSizeCommand,
   DecrByCommand: () => DecrByCommand,
   DecrCommand: () => DecrCommand,
@@ -143,13 +144,17 @@ var UpstashError = class extends Error {
 
 // pkg/util.ts
 function parseRecursive(obj) {
-  return Array.isArray(obj) ? obj.map((o) => {
+  const parsed = Array.isArray(obj) ? obj.map((o) => {
     try {
       return parseRecursive(o);
     } catch {
       return o;
     }
   }) : JSON.parse(obj);
+  if (typeof parsed === "number" && parsed.toString() != obj) {
+    return obj;
+  }
+  return parsed;
 }
 function parseResponse(result) {
   try {
@@ -159,7 +164,7 @@ function parseResponse(result) {
   }
 }
 
-// pkg/command.ts
+// pkg/commands/command.ts
 var Command = class {
   constructor(command, opts) {
     var _a;
@@ -439,8 +444,8 @@ var HScanCommand = class extends Command {
 
 // pkg/commands/hset.ts
 var HSetCommand = class extends Command {
-  constructor(key, field, value) {
-    super(["hset", key, field, value]);
+  constructor(key, kv) {
+    super(["hset", key, ...Object.entries(kv).flatMap(([field, value]) => [field, value])]);
   }
 };
 
@@ -1095,6 +1100,7 @@ module.exports = __toCommonJS(commands_exports);
   BitCountCommand,
   BitOpCommand,
   BitPosCommand,
+  Command,
   DBSizeCommand,
   DecrByCommand,
   DecrCommand,

package/commands.mjs

@@ -3,6 +3,7 @@ import {
   BitCountCommand,
   BitOpCommand,
   BitPosCommand,
+  Command,
   DBSizeCommand,
   DecrByCommand,
   DecrCommand,
@@ -106,13 +107,14 @@ import {
   ZScanCommand,
   ZScoreCommand,
   ZUnionStoreCommand
-} from "./chunk-ZIB6XPPC.mjs";
+} from "./chunk-HGM7M7CJ.mjs";
 import "./chunk-7YUZYRJS.mjs";
 export {
   AppendCommand,
   BitCountCommand,
   BitOpCommand,
   BitPosCommand,
+  Command,
   DBSizeCommand,
   DecrByCommand,
   DecrCommand,

package/fastly.d.ts

@@ -1,5 +1,5 @@
-import { R as Redis$1 } from './redis-dd052782';
-import './zunionstore-dffa797d';
+import { R as Redis$1 } from './redis-71fa1ee6';
+import './zunionstore-b38007ba';
 import './http';
 
 /**

package/fastly.js

@@ -51,13 +51,17 @@ var UpstashError = class extends Error {
 
 // pkg/util.ts
 function parseRecursive(obj) {
-  return Array.isArray(obj) ? obj.map((o) => {
+  const parsed = Array.isArray(obj) ? obj.map((o) => {
     try {
       return parseRecursive(o);
     } catch {
       return o;
     }
   }) : JSON.parse(obj);
+  if (typeof parsed === "number" && parsed.toString() != obj) {
+    return obj;
+  }
+  return parsed;
 }
 function parseResponse(result) {
   try {
@@ -67,7 +71,7 @@ function parseResponse(result) {
   }
 }
 
-// pkg/command.ts
+// pkg/commands/command.ts
 var Command = class {
   constructor(command, opts) {
     var _a;
@@ -347,8 +351,8 @@ var HScanCommand = class extends Command {
 
 // pkg/commands/hset.ts
 var HSetCommand = class extends Command {
-  constructor(key, field, value) {
-    super(["hset", key, field, value]);
+  constructor(key, kv) {
+    super(["hset", key, ...Object.entries(kv).flatMap(([field, value]) => [field, value])]);
   }
 };
 
@@ -1109,8 +1113,8 @@ var Pipeline = class {
   hscan(...args) {
     return this.chain(new HScanCommand(...args));
   }
-  hset(key, field, value) {
-    return this.chain(new HSetCommand(key, field, value));
+  hset(key, kv) {
+    return this.chain(new HSetCommand(key, kv));
   }
   hsetnx(key, field, value) {
     return this.chain(new HSetNXCommand(key, field, value));
@@ -1440,8 +1444,8 @@ var Redis = class {
   hscan(...args) {
     return new HScanCommand(...args).exec(this.client);
   }
-  hset(key, field, value) {
-    return new HSetCommand(key, field, value).exec(this.client);
+  hset(key, kv) {
+    return new HSetCommand(key, kv).exec(this.client);
   }
   hsetnx(key, field, value) {
     return new HSetNXCommand(key, field, value).exec(this.client);
@@ -1680,7 +1684,6 @@ var Redis = class {
 };
 
 // pkg/http.ts
-var import_isomorphic_fetch = require("isomorphic-fetch");
 var HttpClient = class {
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");

package/fastly.mjs

@@ -1,10 +1,10 @@
 import {
   Redis
-} from "./chunk-Y5TC4HX2.mjs";
-import "./chunk-ZIB6XPPC.mjs";
+} from "./chunk-T66TTHSV.mjs";
+import "./chunk-HGM7M7CJ.mjs";
 import {
   HttpClient
-} from "./chunk-U7OXAQMQ.mjs";
+} from "./chunk-HIDCSH5S.mjs";
 import "./chunk-7YUZYRJS.mjs";
 
 // pkg/fastly.ts

package/http.js

@@ -40,7 +40,6 @@ var http_exports = {};
 __export(http_exports, {
   HttpClient: () => HttpClient
 });
-var import_isomorphic_fetch = require("isomorphic-fetch");
 
 // pkg/error.ts
 var UpstashError = class extends Error {

package/http.mjs

@@ -1,6 +1,6 @@
 import {
   HttpClient
-} from "./chunk-U7OXAQMQ.mjs";
+} from "./chunk-HIDCSH5S.mjs";
 import "./chunk-7YUZYRJS.mjs";
 export {
   HttpClient

package/index.d.ts

@@ -1,6 +1,6 @@
 export { Redis, RedisConfigNodejs } from './nodejs';
-import './redis-dd052782';
-import './zunionstore-dffa797d';
+import './redis-71fa1ee6';
+import './zunionstore-b38007ba';
 import './http';
 
 /**

package/index.js

@@ -52,13 +52,17 @@ var UpstashError = class extends Error {
 
 // pkg/util.ts
 function parseRecursive(obj) {
-  return Array.isArray(obj) ? obj.map((o) => {
+  const parsed = Array.isArray(obj) ? obj.map((o) => {
     try {
       return parseRecursive(o);
     } catch {
       return o;
     }
   }) : JSON.parse(obj);
+  if (typeof parsed === "number" && parsed.toString() != obj) {
+    return obj;
+  }
+  return parsed;
 }
 function parseResponse(result) {
   try {
@@ -68,7 +72,7 @@ function parseResponse(result) {
   }
 }
 
-// pkg/command.ts
+// pkg/commands/command.ts
 var Command = class {
   constructor(command, opts) {
     var _a;
@@ -348,8 +352,8 @@ var HScanCommand = class extends Command {
 
 // pkg/commands/hset.ts
 var HSetCommand = class extends Command {
-  constructor(key, field, value) {
-    super(["hset", key, field, value]);
+  constructor(key, kv) {
+    super(["hset", key, ...Object.entries(kv).flatMap(([field, value]) => [field, value])]);
   }
 };
 
@@ -1110,8 +1114,8 @@ var Pipeline = class {
   hscan(...args) {
     return this.chain(new HScanCommand(...args));
   }
-  hset(key, field, value) {
-    return this.chain(new HSetCommand(key, field, value));
+  hset(key, kv) {
+    return this.chain(new HSetCommand(key, kv));
   }
   hsetnx(key, field, value) {
     return this.chain(new HSetNXCommand(key, field, value));
@@ -1441,8 +1445,8 @@ var Redis = class {
   hscan(...args) {
     return new HScanCommand(...args).exec(this.client);
   }
-  hset(key, field, value) {
-    return new HSetCommand(key, field, value).exec(this.client);
+  hset(key, kv) {
+    return new HSetCommand(key, kv).exec(this.client);
   }
   hsetnx(key, field, value) {
     return new HSetNXCommand(key, field, value).exec(this.client);
@@ -1681,7 +1685,6 @@ var Redis = class {
 };
 
 // pkg/http.ts
-var import_isomorphic_fetch = require("isomorphic-fetch");
 var HttpClient = class {
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
@@ -1710,7 +1713,7 @@ var HttpClient = class {
 };
 
 // pkg/nodejs.ts
-var import_isomorphic_fetch2 = require("isomorphic-fetch");
+var import_isomorphic_fetch = require("isomorphic-fetch");
 var Redis2 = class extends Redis {
   constructor(config) {
     const client = new HttpClient({

package/index.mjs

@@ -1,9 +1,9 @@
 import {
   Redis
-} from "./chunk-FJSI5EBJ.mjs";
-import "./chunk-Y5TC4HX2.mjs";
-import "./chunk-ZIB6XPPC.mjs";
-import "./chunk-U7OXAQMQ.mjs";
+} from "./chunk-AHCVU33N.mjs";
+import "./chunk-T66TTHSV.mjs";
+import "./chunk-HGM7M7CJ.mjs";
+import "./chunk-HIDCSH5S.mjs";
 import {
   UpstashError
 } from "./chunk-7YUZYRJS.mjs";

package/nodejs.d.ts

@@ -1,5 +1,5 @@
-import { R as Redis$1 } from './redis-dd052782';
-import './zunionstore-dffa797d';
+import { R as Redis$1 } from './redis-71fa1ee6';
+import './zunionstore-b38007ba';
 import './http';
 
 /**

package/nodejs.js

@@ -51,13 +51,17 @@ var UpstashError = class extends Error {
 
 // pkg/util.ts
 function parseRecursive(obj) {
-  return Array.isArray(obj) ? obj.map((o) => {
+  const parsed = Array.isArray(obj) ? obj.map((o) => {
     try {
       return parseRecursive(o);
     } catch {
       return o;
     }
   }) : JSON.parse(obj);
+  if (typeof parsed === "number" && parsed.toString() != obj) {
+    return obj;
+  }
+  return parsed;
 }
 function parseResponse(result) {
   try {
@@ -67,7 +71,7 @@ function parseResponse(result) {
   }
 }
 
-// pkg/command.ts
+// pkg/commands/command.ts
 var Command = class {
   constructor(command, opts) {
     var _a;
@@ -347,8 +351,8 @@ var HScanCommand = class extends Command {
 
 // pkg/commands/hset.ts
 var HSetCommand = class extends Command {
-  constructor(key, field, value) {
-    super(["hset", key, field, value]);
+  constructor(key, kv) {
+    super(["hset", key, ...Object.entries(kv).flatMap(([field, value]) => [field, value])]);
   }
 };
 
@@ -1109,8 +1113,8 @@ var Pipeline = class {
   hscan(...args) {
     return this.chain(new HScanCommand(...args));
   }
-  hset(key, field, value) {
-    return this.chain(new HSetCommand(key, field, value));
+  hset(key, kv) {
+    return this.chain(new HSetCommand(key, kv));
   }
   hsetnx(key, field, value) {
     return this.chain(new HSetNXCommand(key, field, value));
@@ -1440,8 +1444,8 @@ var Redis = class {
   hscan(...args) {
     return new HScanCommand(...args).exec(this.client);
   }
-  hset(key, field, value) {
-    return new HSetCommand(key, field, value).exec(this.client);
+  hset(key, kv) {
+    return new HSetCommand(key, kv).exec(this.client);
   }
   hsetnx(key, field, value) {
     return new HSetNXCommand(key, field, value).exec(this.client);
@@ -1680,7 +1684,6 @@ var Redis = class {
 };
 
 // pkg/http.ts
-var import_isomorphic_fetch = require("isomorphic-fetch");
 var HttpClient = class {
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
@@ -1709,7 +1712,7 @@ var HttpClient = class {
 };
 
 // pkg/nodejs.ts
-var import_isomorphic_fetch2 = require("isomorphic-fetch");
+var import_isomorphic_fetch = require("isomorphic-fetch");
 var Redis2 = class extends Redis {
   constructor(config) {
     const client = new HttpClient({

package/nodejs.mjs

@@ -1,9 +1,9 @@
 import {
   Redis
-} from "./chunk-FJSI5EBJ.mjs";
-import "./chunk-Y5TC4HX2.mjs";
-import "./chunk-ZIB6XPPC.mjs";
-import "./chunk-U7OXAQMQ.mjs";
+} from "./chunk-AHCVU33N.mjs";
+import "./chunk-T66TTHSV.mjs";
+import "./chunk-HGM7M7CJ.mjs";
+import "./chunk-HIDCSH5S.mjs";
 import "./chunk-7YUZYRJS.mjs";
 export {
   Redis

package/package.json

@@ -1 +1 @@
-{ "name": "@upstash/redis", "version": "v1.0.0-alpha.3", "engines": { "node": ">=10" }, "description": "An HTTP/REST based Redis client built on top of Upstash REST API.", "main": "./index.js", "module": "./index.mjs", "types": "./index.d.ts", "scripts": { "test": "jest -i", "fmt": "pnpm lint && pnpm prettier --write .", "lint": "eslint --ext .ts --fix --ignore-path .gitignore .", "build": "tsup && cp package.json ./dist/ && pnpm size-limit" }, "repository": { "type": "git", "url": "git+https://github.com/upstash/upstash-redis.git" }, "keywords": [ "redis", "database", "serverless", "edge", "upstash" ], "author": "Andreas Thomas <andreas.thomas@chronark.com>", "license": "MIT", "bugs": { "url": "https://github.com/upstash/upstash-redis/issues" }, "homepage": "https://github.com/upstash/upstash-redis#readme", "directories": { "examples": "examples" }, "devDependencies": { "@jest/globals": "^27.4.6", "@size-limit/preset-small-lib": "^7.0.8", "@trivago/prettier-plugin-sort-imports": "^3.2.0", "@types/jest": "^27.4.0", "@types/node": "^17.0.8", "@typescript-eslint/eslint-plugin": "^5.9.1", "@typescript-eslint/parser": "^5.9.1", "dotenv": "^12.0.3", "eslint": "^8.6.0", "eslint-config-prettier": "^8.3.0", "eslint-plugin-prettier": "^4.0.0", "jest": "^27.4.7", "prettier": "^2.5.1", "size-limit": "^7.0.8", "ts-jest": "^27.1.3", "tsup": "^5.11.11", "typescript": "^4.5.5" }, "dependencies": { "isomorphic-fetch": "^3.0.0" }, "browser": { "isomorphic-fetch": false }, "size-limit": [ { "path": "dist/index.js", "limit": "5 KB" }, { "path": "dist/index.mjs", "limit": "5 KB" } ] }
+{ "name": "@upstash/redis", "version": "v1.0.0", "engines": { "node": ">=10" }, "description": "An HTTP/REST based Redis client built on top of Upstash REST API.", "main": "./index.js", "module": "./index.mjs", "types": "./index.d.ts", "scripts": { "test": "jest -i", "fmt": "pnpm lint && pnpm prettier --write .", "lint": "eslint --ext .ts --fix --ignore-path .gitignore .", "build": "tsup && cp package.json ./dist/ && pnpm size-limit" }, "repository": { "type": "git", "url": "git+https://github.com/upstash/upstash-redis.git" }, "keywords": [ "redis", "database", "serverless", "edge", "upstash" ], "author": "Andreas Thomas <andreas.thomas@chronark.com>", "license": "MIT", "bugs": { "url": "https://github.com/upstash/upstash-redis/issues" }, "homepage": "https://github.com/upstash/upstash-redis#readme", "directories": { "examples": "examples" }, "devDependencies": { "@jest/globals": "^27.4.6", "@size-limit/preset-small-lib": "^7.0.8", "@trivago/prettier-plugin-sort-imports": "^3.2.0", "@types/jest": "^27.4.0", "@types/node": "^17.0.8", "@typescript-eslint/eslint-plugin": "^5.9.1", "@typescript-eslint/parser": "^5.9.1", "dotenv": "^12.0.3", "eslint": "^8.6.0", "eslint-config-prettier": "^8.3.0", "eslint-plugin-prettier": "^4.0.0", "jest": "^27.4.7", "prettier": "^2.5.1", "size-limit": "^7.0.8", "ts-jest": "^27.1.3", "tsup": "^5.11.11", "typescript": "^4.5.5" }, "dependencies": { "isomorphic-fetch": "^3.0.0" }, "browser": { "isomorphic-fetch": false }, "size-limit": [ { "path": "dist/index.js", "limit": "5 KB" }, { "path": "dist/index.mjs", "limit": "5 KB" }, { "path": "dist/cloudflare.js", "limit": "5 KB" }, { "path": "dist/cloudflare.mjs", "limit": "5 KB" }, { "path": "dist/nodejs.js", "limit": "5 KB" }, { "path": "dist/nodejs.mjs", "limit": "5 KB" }, { "path": "dist/fastly.js", "limit": "5 KB" }, { "path": "dist/fastly.mjs", "limit": "5 KB" } ] }

package/{redis-dd052782.d.ts → redis-71fa1ee6.d.ts}

@@ -1,4 +1,4 @@
-import { C as CommandArgs, A as AppendCommand, B as BitCountCommand, a as BitPosCommand, D as DecrCommand, b as DecrByCommand, c as DelCommand, E as EchoCommand, d as ExistsCommand, e as ExpireCommand, f as ExpireAtCommand, F as FlushAllCommand, g as FlushDBCommand, G as GetCommand, h as GetBitCommand, i as GetRangeCommand, H as HDelCommand, j as HExistsCommand, k as HGetCommand, l as HGetAllCommand, m as HIncrByCommand, n as HIncrByFloatCommand, o as HKeysCommand, p as HLenCommand, q as HMGetCommand, r as HScanCommand, s as HStrLenCommand, t as HValsCommand, I as IncrCommand, u as IncrByCommand, v as IncrByFloatCommand, K as KeysCommand, L as LIndexCommand, w as LLenCommand, x as LPopCommand, N as NonEmptyArray, y as LRangeCommand, z as LTrimCommand, M as MGetCommand, P as PersistCommand, J as PExpireCommand, O as PExpireAtCommand, Q as PingCommand, R as PTtlCommand, S as RenameCommand, T as RenameNXCommand, U as RPopCommand, V as ScanCommand, W as SCardCommand, X as SDiffCommand, Y as SDiffStoreCommand, Z as SetCommandOptions, _ as SetBitCommand, $ as SetRangeCommand, a0 as SInterCommand, a1 as SInterStoreCommand, a2 as SMembersCommand, a3 as SPopCommand, a4 as SRandMemberCommand, a5 as SScanCommand, a6 as StrLenCommand, a7 as SUnionCommand, a8 as SUnionStoreCommand, a9 as TouchCommand, aa as TtlCommand, ab as TypeCommand, ac as UnlinkCommand, ad as ScoreMember, ae as ZAddCommandOptions, af as ZAddCommandOptionsWithIncr, ag as ZCardCommand, ah as ZCountCommand, ai as ZInterStoreCommand, aj as ZLexCountCommand, ak as ZPopMaxCommand, al as ZPopMinCommand, am as ZRangeCommand, an as ZRemRangeByLexCommand, ao as ZRemRangeByRankCommand, ap as ZRemRangeByScoreCommand, aq as ZScanCommand, ar as ZUnionStoreCommand, as as Type } from './zunionstore-dffa797d';
+import { C as CommandArgs, A as AppendCommand, B as BitCountCommand, a as BitPosCommand, D as DecrCommand, b as DecrByCommand, c as DelCommand, E as EchoCommand, d as ExistsCommand, e as ExpireCommand, f as ExpireAtCommand, F as FlushAllCommand, g as FlushDBCommand, G as GetCommand, h as GetBitCommand, i as GetRangeCommand, H as HDelCommand, j as HExistsCommand, k as HGetCommand, l as HGetAllCommand, m as HIncrByCommand, n as HIncrByFloatCommand, o as HKeysCommand, p as HLenCommand, q as HMGetCommand, r as HScanCommand, s as HStrLenCommand, t as HValsCommand, I as IncrCommand, u as IncrByCommand, v as IncrByFloatCommand, K as KeysCommand, L as LIndexCommand, w as LLenCommand, x as LPopCommand, N as NonEmptyArray, y as LRangeCommand, z as LTrimCommand, M as MGetCommand, P as PersistCommand, J as PExpireCommand, O as PExpireAtCommand, Q as PingCommand, R as PTtlCommand, S as RenameCommand, T as RenameNXCommand, U as RPopCommand, V as ScanCommand, W as SCardCommand, X as SDiffCommand, Y as SDiffStoreCommand, Z as SetCommandOptions, _ as SetBitCommand, $ as SetRangeCommand, a0 as SInterCommand, a1 as SInterStoreCommand, a2 as SMembersCommand, a3 as SPopCommand, a4 as SRandMemberCommand, a5 as SScanCommand, a6 as StrLenCommand, a7 as SUnionCommand, a8 as SUnionStoreCommand, a9 as TouchCommand, aa as TtlCommand, ab as TypeCommand, ac as UnlinkCommand, ad as ScoreMember, ae as ZAddCommandOptions, af as ZAddCommandOptionsWithIncr, ag as ZCardCommand, ah as ZCountCommand, ai as ZInterStoreCommand, aj as ZLexCountCommand, ak as ZPopMaxCommand, al as ZPopMinCommand, am as ZRangeCommand, an as ZRemRangeByLexCommand, ao as ZRemRangeByRankCommand, ap as ZRemRangeByScoreCommand, aq as ZScanCommand, ar as ZUnionStoreCommand, as as Type } from './zunionstore-b38007ba';
 import { HttpClient } from './http';
 
 /**
@@ -182,7 +182,9 @@ declare class Pipeline {
     /**
      * @see https://redis.io/commands/hset
      */
-    hset<TData>(key: string, field: string, value: TData): this;
+    hset<TData>(key: string, kv: {
+        [field: string]: TData;
+    }): this;
     /**
      * @see https://redis.io/commands/hsetnx
      */
@@ -643,7 +645,9 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/hset
      */
-    hset<TData>(key: string, field: string, value: TData): Promise<number>;
+    hset<TData>(key: string, kv: {
+        [field: string]: TData;
+    }): Promise<number>;
     /**
      * @see https://redis.io/commands/hsetnx
      */

package/{zunionstore-dffa797d.d.ts → zunionstore-b38007ba.d.ts}

@@ -6,7 +6,7 @@ import { HttpClient } from './http';
  * TData represents what the user will enter or receive,
  * TResult is the raw data returned from upstash, which may need to be transformed or parsed.
  */
-declare abstract class Command<TData, TResult> {
+declare class Command<TData, TResult> {
     readonly command: string[];
     deserialize: (result: TResult) => TData;
     /**