@upstash/redis 1.3.4 → 1.4.0-next.2

package/.releaserc

@@ -0,0 +1,14 @@
+{
+  "branches": [
+    {
+      "name": "release"
+    },
+    {
+      "name": "main",
+      "channel": "next",
+      "prerelease": "next"
+    }
+  ],
+  "dryRun": false,
+  "ci": true
+}

package/README.md

@@ -1,7 +1,7 @@
 # Upstash Redis
 
-An HTTP/REST based Redis client built on top of
-[Upstash REST API](https://docs.upstash.com/features/restapi).
+`@upstash/redis` is an HTTP/REST based Redis client for typescript, 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)
@@ -23,6 +23,17 @@ See
 [the list of APIs](https://docs.upstash.com/features/restapi#rest---redis-api-compatibility)
 supported.
 
+## Upgrading to v1.4.0 **(ReferenceError: fetch is not defined)**
+
+If you are running on nodejs v17 and earlier, `fetch` will not be natively
+supported. Platforms like Vercel, Netlify, Deno, Fastly etc. provide a polyfill
+for you. But if you are running on bare node, you need to either specify a
+polyfill yourself or change the import path to:
+
+```typescript
+import { Redis } from "@upstash/redis/with-fetch";
+```
+
 ## Upgrading from v0.2.0?
 
 Please read the
@@ -76,6 +87,15 @@ const redis = new Redis({
 const redis = Redis.fromEnv()
 ```
 
+If you are running on nodejs v17 and earlier, `fetch` will not be natively
+supported. Platforms like Vercel, Netlify, Deno, Fastly etc. provide a polyfill
+for you. But if you are running on bare node, you need to either specify a
+polyfill yourself or change the import path to:
+
+```typescript
+import { Redis } from "@upstash/redis/with-fetch";
+```
+
 - [Code example](https://github.com/upstash/upstash-redis/blob/main/examples/nodejs)
 
 #### Cloudflare Workers
@@ -336,3 +356,6 @@ the url and token
 ```sh
 UPSTASH_REDIS_REST_URL=".." UPSTASH_REDIS_REST_TOKEN=".." deno test -A
 ```
+
+```
+```

package/esm/platforms/cloudflare.js

@@ -16,6 +16,16 @@ export class Redis extends core.Redis {
      * ```
      */
     constructor(config) {
+        if (config.url.startsWith(" ") ||
+            config.url.endsWith(" ") ||
+            /\r|\n/.test(config.url)) {
+            console.warn("The redis url contains whitespace or newline, which can cause errors!");
+        }
+        if (config.token.startsWith(" ") ||
+            config.token.endsWith(" ") ||
+            /\r|\n/.test(config.token)) {
+            console.warn("The redis token contains whitespace or newline, which can cause errors!");
+        }
         const client = defaultRequester({
             baseUrl: config.url,
             headers: { authorization: `Bearer ${config.token}` },

package/esm/platforms/fastly.js

@@ -17,6 +17,16 @@ export class Redis extends core.Redis {
      * ```
      */
     constructor(config) {
+        if (config.url.startsWith(" ") ||
+            config.url.endsWith(" ") ||
+            /\r|\n/.test(config.url)) {
+            console.warn("The redis url contains whitespace or newline, which can cause errors!");
+        }
+        if (config.token.startsWith(" ") ||
+            config.token.endsWith(" ") ||
+            /\r|\n/.test(config.token)) {
+            console.warn("The redis token contains whitespace or newline, which can cause errors!");
+        }
         const client = defaultRequester({
             baseUrl: config.url,
             headers: { authorization: `Bearer ${config.token}` },

package/esm/platforms/node_with_fetch.js

@@ -0,0 +1,81 @@
+// deno-lint-ignore-file
+import * as core from "../pkg/redis.js";
+import { UpstashError } from "../pkg/error.js";
+import "isomorphic-fetch";
+/**
+ * Serverless redis client for upstash.
+ */
+export class Redis extends core.Redis {
+    constructor(configOrRequester) {
+        if ("request" in configOrRequester) {
+            super(configOrRequester);
+            return;
+        }
+        if (configOrRequester.url.startsWith(" ") ||
+            configOrRequester.url.endsWith(" ") ||
+            /\r|\n/.test(configOrRequester.url)) {
+            console.warn("The redis url contains whitespace or newline, which can cause errors!");
+        }
+        if (configOrRequester.token.startsWith(" ") ||
+            configOrRequester.token.endsWith(" ") ||
+            /\r|\n/.test(configOrRequester.token)) {
+            console.warn("The redis token contains whitespace or newline, which can cause errors!");
+        }
+        const client = defaultRequester({
+            baseUrl: configOrRequester.url,
+            headers: { authorization: `Bearer ${configOrRequester.token}` },
+            // agent: configOrRequester.agent,
+        });
+        super(client, {
+            automaticDeserialization: configOrRequester.automaticDeserialization,
+        });
+    }
+    /**
+     * Create a new Upstash Redis instance from environment variables.
+     *
+     * Use this to automatically load connection secrets from your environment
+     * variables. For instance when using the Vercel integration.
+     *
+     * This tries to load `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` from
+     * your environment using `process.env`.
+     */
+    static fromEnv(config) {
+        // @ts-ignore process will be defined in node
+        if (typeof process?.env === "undefined") {
+            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');
+        }
+        // @ts-ignore process will be defined in node
+        const url = process?.env["UPSTASH_REDIS_REST_URL"];
+        if (!url) {
+            throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_URL`");
+        }
+        // @ts-ignore process will be defined in node
+        const token = process?.env["UPSTASH_REDIS_REST_TOKEN"];
+        if (!token) {
+            throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_TOKEN`");
+        }
+        return new Redis({ url, token, ...config });
+    }
+}
+function defaultRequester(config) {
+    return {
+        request: async function (req) {
+            if (!req.path) {
+                req.path = [];
+            }
+            const res = await fetch([config.baseUrl, ...req.path].join("/"), {
+                method: "POST",
+                headers: { "Content-Type": "application/json", ...config.headers },
+                body: JSON.stringify(req.body),
+                keepalive: true,
+                // @ts-ignore
+                agent: config.agent,
+            });
+            const body = (await res.json());
+            if (!res.ok) {
+                throw new UpstashError(body.error);
+            }
+            return body;
+        },
+    };
+}

package/esm/platforms/nodejs.js

@@ -1,11 +1,6 @@
 // deno-lint-ignore-file
 import * as core from "../pkg/redis.js";
 import { UpstashError } from "../pkg/error.js";
-// @ts-ignore Deno can't compile
-// import https from "https";
-// @ts-ignore Deno can't compile
-// import http from "http";
-import "isomorphic-fetch";
 /**
  * Serverless redis client for upstash.
  */
@@ -15,6 +10,16 @@ export class Redis extends core.Redis {
             super(configOrRequester);
             return;
         }
+        if (configOrRequester.url.startsWith(" ") ||
+            configOrRequester.url.endsWith(" ") ||
+            /\r|\n/.test(configOrRequester.url)) {
+            console.warn("The redis url contains whitespace or newline, which can cause errors!");
+        }
+        if (configOrRequester.token.startsWith(" ") ||
+            configOrRequester.token.endsWith(" ") ||
+            /\r|\n/.test(configOrRequester.token)) {
+            console.warn("The redis token contains whitespace or newline, which can cause errors!");
+        }
         const client = defaultRequester({
             baseUrl: configOrRequester.url,
             headers: { authorization: `Bearer ${configOrRequester.token}` },

package/package.json

@@ -3,7 +3,6 @@
   "main": "./script/platforms/nodejs.js",
   "types": "./types/platforms/nodejs.d.ts",
   "name": "@upstash/redis",
-  "version": "v1.3.4",
   "description": "An HTTP/REST based Redis client built on top of Upstash REST API.",
   "repository": {
     "type": "git",
@@ -21,16 +20,15 @@
   "bugs": {
     "url": "https://github.com/upstash/upstash-redis/issues"
   },
+  "dependencies": {
+    "isomorphic-fetch": "^3.0.0"
+  },
   "homepage": "https://github.com/upstash/upstash-redis#readme",
   "browser": {
     "isomorphic-fetch": false,
     "http": false,
     "https": false
   },
-  "dependencies": {
-    "encoding": "latest",
-    "isomorphic-fetch": "^3.0.0"
-  },
   "devDependencies": {
     "@size-limit/preset-small-lib": "latest",
     "size-limit": "latest"
@@ -81,6 +79,12 @@
       "import": "./esm/platforms/fastly.js",
       "require": "./script/platforms/fastly.js",
       "types": "./types/platforms/fastly.d.ts"
+    },
+    "./with-fetch": {
+      "import": "./esm/platforms/node_with_fetch.js",
+      "require": "./script/platforms/node_with_fetch.js",
+      "types": "./types/platforms/node_with_fetch.d.ts"
     }
-  }
+  },
+  "version": "1.4.0-next.2"
 }

package/script/platforms/cloudflare.js

@@ -42,6 +42,16 @@ class Redis extends core.Redis {
      * ```
      */
     constructor(config) {
+        if (config.url.startsWith(" ") ||
+            config.url.endsWith(" ") ||
+            /\r|\n/.test(config.url)) {
+            console.warn("The redis url contains whitespace or newline, which can cause errors!");
+        }
+        if (config.token.startsWith(" ") ||
+            config.token.endsWith(" ") ||
+            /\r|\n/.test(config.token)) {
+            console.warn("The redis token contains whitespace or newline, which can cause errors!");
+        }
         const client = defaultRequester({
             baseUrl: config.url,
             headers: { authorization: `Bearer ${config.token}` },

package/script/platforms/fastly.js

@@ -43,6 +43,16 @@ class Redis extends core.Redis {
      * ```
      */
     constructor(config) {
+        if (config.url.startsWith(" ") ||
+            config.url.endsWith(" ") ||
+            /\r|\n/.test(config.url)) {
+            console.warn("The redis url contains whitespace or newline, which can cause errors!");
+        }
+        if (config.token.startsWith(" ") ||
+            config.token.endsWith(" ") ||
+            /\r|\n/.test(config.token)) {
+            console.warn("The redis token contains whitespace or newline, which can cause errors!");
+        }
         const client = defaultRequester({
             baseUrl: config.url,
             headers: { authorization: `Bearer ${config.token}` },

package/script/platforms/node_with_fetch.js

@@ -0,0 +1,108 @@
+"use strict";
+// deno-lint-ignore-file
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Redis = void 0;
+const core = __importStar(require("../pkg/redis.js"));
+const error_js_1 = require("../pkg/error.js");
+require("isomorphic-fetch");
+/**
+ * Serverless redis client for upstash.
+ */
+class Redis extends core.Redis {
+    constructor(configOrRequester) {
+        if ("request" in configOrRequester) {
+            super(configOrRequester);
+            return;
+        }
+        if (configOrRequester.url.startsWith(" ") ||
+            configOrRequester.url.endsWith(" ") ||
+            /\r|\n/.test(configOrRequester.url)) {
+            console.warn("The redis url contains whitespace or newline, which can cause errors!");
+        }
+        if (configOrRequester.token.startsWith(" ") ||
+            configOrRequester.token.endsWith(" ") ||
+            /\r|\n/.test(configOrRequester.token)) {
+            console.warn("The redis token contains whitespace or newline, which can cause errors!");
+        }
+        const client = defaultRequester({
+            baseUrl: configOrRequester.url,
+            headers: { authorization: `Bearer ${configOrRequester.token}` },
+            // agent: configOrRequester.agent,
+        });
+        super(client, {
+            automaticDeserialization: configOrRequester.automaticDeserialization,
+        });
+    }
+    /**
+     * Create a new Upstash Redis instance from environment variables.
+     *
+     * Use this to automatically load connection secrets from your environment
+     * variables. For instance when using the Vercel integration.
+     *
+     * This tries to load `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` from
+     * your environment using `process.env`.
+     */
+    static fromEnv(config) {
+        // @ts-ignore process will be defined in node
+        if (typeof process?.env === "undefined") {
+            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');
+        }
+        // @ts-ignore process will be defined in node
+        const url = process?.env["UPSTASH_REDIS_REST_URL"];
+        if (!url) {
+            throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_URL`");
+        }
+        // @ts-ignore process will be defined in node
+        const token = process?.env["UPSTASH_REDIS_REST_TOKEN"];
+        if (!token) {
+            throw new Error("Unable to find environment variable: `UPSTASH_REDIS_REST_TOKEN`");
+        }
+        return new Redis({ url, token, ...config });
+    }
+}
+exports.Redis = Redis;
+function defaultRequester(config) {
+    return {
+        request: async function (req) {
+            if (!req.path) {
+                req.path = [];
+            }
+            const res = await fetch([config.baseUrl, ...req.path].join("/"), {
+                method: "POST",
+                headers: { "Content-Type": "application/json", ...config.headers },
+                body: JSON.stringify(req.body),
+                keepalive: true,
+                // @ts-ignore
+                agent: config.agent,
+            });
+            const body = (await res.json());
+            if (!res.ok) {
+                throw new error_js_1.UpstashError(body.error);
+            }
+            return body;
+        },
+    };
+}

package/script/platforms/nodejs.js

@@ -27,11 +27,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Redis = void 0;
 const core = __importStar(require("../pkg/redis.js"));
 const error_js_1 = require("../pkg/error.js");
-// @ts-ignore Deno can't compile
-// import https from "https";
-// @ts-ignore Deno can't compile
-// import http from "http";
-require("isomorphic-fetch");
 /**
  * Serverless redis client for upstash.
  */
@@ -41,6 +36,16 @@ class Redis extends core.Redis {
             super(configOrRequester);
             return;
         }
+        if (configOrRequester.url.startsWith(" ") ||
+            configOrRequester.url.endsWith(" ") ||
+            /\r|\n/.test(configOrRequester.url)) {
+            console.warn("The redis url contains whitespace or newline, which can cause errors!");
+        }
+        if (configOrRequester.token.startsWith(" ") ||
+            configOrRequester.token.endsWith(" ") ||
+            /\r|\n/.test(configOrRequester.token)) {
+            console.warn("The redis token contains whitespace or newline, which can cause errors!");
+        }
         const client = defaultRequester({
             baseUrl: configOrRequester.url,
             headers: { authorization: `Bearer ${configOrRequester.token}` },

package/types/platforms/node_with_fetch.d.ts

@@ -0,0 +1,63 @@
+import * as core from "../pkg/redis.js";
+import { Requester, UpstashRequest, UpstashResponse } from "../pkg/http.js";
+import "isomorphic-fetch";
+export type { Requester, UpstashRequest, UpstashResponse };
+/**
+ * Connection credentials for upstash redis.
+ * Get them from https://console.upstash.com/redis/<uuid>
+ */
+export declare type RedisConfigNodejs = {
+    /**
+     * UPSTASH_REDIS_REST_URL
+     */
+    url: string;
+    /**
+     * UPSTASH_REDIS_REST_TOKEN
+     */
+    token: string;
+} & core.RedisOptions;
+/**
+ * Serverless redis client for upstash.
+ */
+export declare class Redis extends core.Redis {
+    /**
+     * Create a new redis client by providing the url and token
+     *
+     * @example
+     * ```typescript
+     * const redis = new Redis({
+     *  url: "<UPSTASH_REDIS_REST_URL>",
+     *  token: "<UPSTASH_REDIS_REST_TOKEN>",
+     * });
+     * ```
+     */
+    constructor(config: RedisConfigNodejs);
+    /**
+     * Create a new redis client by providing a custom `Requester` implementation
+     *
+     * @example
+     * ```ts
+     *
+     * import { UpstashRequest, Requester, UpstashResponse, Redis } from "@upstash/redis"
+     *
+     *  const requester: Requester = {
+     *    request: <TResult>(req: UpstashRequest): Promise<UpstashResponse<TResult>> => {
+     *      // ...
+     *    }
+     *  }
+     *
+     * const redis = new Redis(requester)
+     * ```
+     */
+    constructor(requesters: Requester);
+    /**
+     * Create a new Upstash Redis instance from environment variables.
+     *
+     * Use this to automatically load connection secrets from your environment
+     * variables. For instance when using the Vercel integration.
+     *
+     * This tries to load `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` from
+     * your environment using `process.env`.
+     */
+    static fromEnv(config?: Omit<RedisConfigNodejs, "url" | "token">): Redis;
+}

package/types/platforms/nodejs.d.ts

@@ -1,6 +1,5 @@
 import * as core from "../pkg/redis.js";
 import { Requester, UpstashRequest, UpstashResponse } from "../pkg/http.js";
-import "isomorphic-fetch";
 export type { Requester, UpstashRequest, UpstashResponse };
 /**
  * Connection credentials for upstash redis.