@upstash/redis 0.0.0-ci.608697de-20221215 → 0.0.0-ci.62b04fa8-20231019

package/types/pkg/redis.d.ts

@@ -1,22 +1,17 @@
-import { CommandOptions, DelCommand, ExistsCommand, FlushAllCommand, MGetCommand, PingCommand, ScoreMember, ScriptExistsCommand, SetCommandOptions, TouchCommand, UnlinkCommand, ZAddCommandOptions, ZAddCommandOptionsWithIncr, ZRangeCommandOptions } from "./commands/mod.js";
+import { CommandOptions, DelCommand, ExistsCommand, FlushAllCommand, JsonGetCommand, MGetCommand, PingCommand, ScoreMember, ScriptExistsCommand, SetCommandOptions, TouchCommand, UnlinkCommand, ZAddCommandOptions, ZAddCommandOptionsWithIncr, ZRangeCommandOptions } from "./commands/mod.js";
 import { Requester, UpstashRequest, UpstashResponse } from "./http.js";
 import { Pipeline } from "./pipeline.js";
 import type { CommandArgs } from "./types.js";
 import { Script } from "./script.js";
-export declare type RedisOptions = {
-    /**
-     * Automatically try to deserialize the returned data from upstash using `JSON.deserialize`
-     *
-     * @default true
-     */
-    automaticDeserialization?: boolean;
-};
+import type { RedisOptions, Telemetry } from "./types.js";
+export type { RedisOptions } from "./types.js";
 /**
  * Serverless redis client for upstash.
  */
 export declare class Redis {
     protected client: Requester;
     protected opts?: CommandOptions<any, any>;
+    protected enableTelemetry: boolean;
     /**
      * Create a new redis client
      *
@@ -29,17 +24,121 @@ export declare class Redis {
      * ```
      */
     constructor(client: Requester, opts?: RedisOptions);
+    get json(): {
+        /**
+         * @see https://redis.io/commands/json.arrappend
+         */
+        arrappend: (key: string, path: string, ...values: unknown[]) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.arrindex
+         */
+        arrindex: (key: string, path: string, value: unknown, start?: number | undefined, stop?: number | undefined) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.arrinsert
+         */
+        arrinsert: (key: string, path: string, index: number, ...values: unknown[]) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.arrlen
+         */
+        arrlen: (key: string, path?: string | undefined) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.arrpop
+         */
+        arrpop: (key: string, path?: string | undefined, index?: number | undefined) => Promise<unknown[]>;
+        /**
+         * @see https://redis.io/commands/json.arrtrim
+         */
+        arrtrim: (key: string, path?: string | undefined, start?: number | undefined, stop?: number | undefined) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.clear
+         */
+        clear: (key: string, path?: string | undefined) => Promise<number>;
+        /**
+         * @see https://redis.io/commands/json.del
+         */
+        del: (key: string, path?: string | undefined) => Promise<number>;
+        /**
+         * @see https://redis.io/commands/json.forget
+         */
+        forget: (key: string, path?: string | undefined) => Promise<number>;
+        /**
+         * @see https://redis.io/commands/geoadd
+         */
+        geoadd: (args_0: string, args_1: import("./commands/geo_add.js").GeoAddCommandOptions | import("./commands/geo_add.js").GeoMember<unknown>, ...args_2: import("./commands/geo_add.js").GeoMember<unknown>[]) => Promise<number | null>;
+        /**
+         * @see https://redis.io/commands/geodist
+         */
+        geodist: (key: string, member1: unknown, member2: unknown, unit?: "M" | "KM" | "FT" | "MI" | undefined) => Promise<number | null>;
+        /**
+         * @see https://redis.io/commands/json.get
+         */
+        get: (...args: CommandArgs<typeof JsonGetCommand>) => Promise<any>;
+        /**
+         * @see https://redis.io/commands/json.mget
+         */
+        mget: (keys: string[], path: string) => Promise<any>;
+        /**
+         * @see https://redis.io/commands/json.numincrby
+         */
+        numincrby: (key: string, path: string, value: number) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.nummultby
+         */
+        nummultby: (key: string, path: string, value: number) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.objkeys
+         */
+        objkeys: (key: string, path?: string | undefined) => Promise<(string[] | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.objlen
+         */
+        objlen: (key: string, path?: string | undefined) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.resp
+         */
+        resp: (key: string, path?: string | undefined) => Promise<any>;
+        /**
+         * @see https://redis.io/commands/json.set
+         */
+        set: (key: string, path: string, value: string | number | boolean | Record<string, unknown> | (string | number | boolean | Record<string, unknown>)[], opts?: {
+            nx: true;
+            xx?: undefined;
+        } | {
+            nx?: undefined;
+            xx: true;
+        } | undefined) => Promise<"OK" | null>;
+        /**
+         * @see https://redis.io/commands/json.strappend
+         */
+        strappend: (key: string, path: string, value: string) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.strlen
+         */
+        strlen: (key: string, path?: string | undefined) => Promise<(number | null)[]>;
+        /**
+         * @see https://redis.io/commands/json.toggle
+         */
+        toggle: (key: string, path: string) => Promise<number[]>;
+        /**
+         * @see https://redis.io/commands/json.type
+         */
+        type: (key: string, path?: string | undefined) => Promise<string[]>;
+    };
     /**
      * Wrap a new middleware around the HTTP client.
      */
     use: <TResult = unknown>(middleware: (r: UpstashRequest, next: <TResult_1 = unknown>(req: UpstashRequest) => Promise<UpstashResponse<TResult_1>>) => Promise<UpstashResponse<TResult>>) => void;
+    /**
+     * Technically this is not private, we can hide it from intellisense by doing this
+     */
+    protected addTelemetry: (telemetry: Telemetry) => void;
     createScript(script: string): Script;
     /**
      * Create a new pipeline that allows you to send requests in bulk.
      *
      * @see {@link Pipeline}
      */
-    pipeline: () => Pipeline;
+    pipeline: () => Pipeline<[]>;
     /**
      * Create a new transaction to allow executing multiple steps atomically.
      *
@@ -49,7 +148,7 @@ export declare class Redis {
      *
      * @see {@link Pipeline}
      */
-    multi: () => Pipeline;
+    multi: () => Pipeline<[]>;
     /**
      * @see https://redis.io/commands/append
      */
@@ -142,7 +241,7 @@ export declare class Redis {
     /**
      * @see https://redis.io/commands/hdel
      */
-    hdel: (key: string, field: string) => Promise<0 | 1>;
+    hdel: (key: string, ...fields: string[]) => Promise<0 | 1>;
     /**
      * @see https://redis.io/commands/hexists
      */
@@ -239,6 +338,10 @@ export declare class Redis {
      * @see https://redis.io/commands/llen
      */
     llen: (key: string) => Promise<number>;
+    /**
+     * @see https://redis.io/commands/lmove
+     */
+    lmove: <TData = string>(source: string, destination: string, whereFrom: "left" | "right", whereTo: "left" | "right") => Promise<TData>;
     /**
      * @see https://redis.io/commands/lpop
      */
@@ -407,10 +510,14 @@ export declare class Redis {
      * @see https://redis.io/commands/sismember
      */
     sismember: <TData>(key: string, member: TData) => Promise<0 | 1>;
+    /**
+     * @see https://redis.io/commands/smismember
+     */
+    smismember: <TMembers extends unknown[]>(key: string, members: TMembers) => Promise<(0 | 1)[]>;
     /**
      * @see https://redis.io/commands/smembers
      */
-    smembers: (key: string) => Promise<string[]>;
+    smembers: <TData extends unknown[] = string[]>(key: string) => Promise<TData>;
     /**
      * @see https://redis.io/commands/smove
      */
@@ -463,6 +570,31 @@ export declare class Redis {
      * @see https://redis.io/commands/unlink
      */
     unlink: (...args: CommandArgs<typeof UnlinkCommand>) => Promise<number>;
+    /**
+     * @see https://redis.io/commands/xadd
+     */
+    xadd: (key: string, id: string, entries: {
+        [field: string]: unknown;
+    }, opts?: {
+        nomkStream?: boolean | undefined;
+        trim?: (({
+            type: "MAXLEN" | "maxlen";
+            threshold: number;
+        } | {
+            type: "MINID" | "minid";
+            threshold: string;
+        }) & ({
+            comparison: "~";
+            limit?: number | undefined;
+        } | {
+            comparison: "=";
+            limit?: undefined;
+        })) | undefined;
+    } | undefined) => Promise<string>;
+    /**
+     * @see https://redis.io/commands/xrange
+     */
+    xrange: (key: string, start: string, end: string, count?: number | undefined) => Promise<Record<string, Record<string, unknown>>>;
     /**
      * @see https://redis.io/commands/zadd
      */
@@ -475,6 +607,10 @@ export declare class Redis {
      * @see https://redis.io/commands/zcount
      */
     zcount: (key: string, min: string | number, max: string | number) => Promise<number>;
+    /**
+     * @see https://redis.io/commands/zdiffstore
+     */
+    zdiffstore: (destination: string, numkeys: number, ...keys: string[]) => Promise<number>;
     /**
      * @see https://redis.io/commands/zincrby
      */
@@ -549,6 +685,10 @@ export declare class Redis {
      * @see https://redis.io/commands/zscore
      */
     zscore: <TData>(key: string, member: TData) => Promise<number | null>;
+    /**
+     * @see https://redis.io/commands/zunion
+     */
+    zunion: (numKeys: number, keys: string[], opts?: import("./commands/zunion.js").ZUnionCommandOptions | undefined) => Promise<any>;
     /**
      * @see https://redis.io/commands/zunionstore
      */

package/types/pkg/types.d.ts

@@ -1 +1,27 @@
-export declare type CommandArgs<TCommand extends new (...args: any) => any> = ConstructorParameters<TCommand>[0];
+export type CommandArgs<TCommand extends new (...args: any) => any> = ConstructorParameters<TCommand>[0];
+export type Telemetry = {
+    /**
+     * Upstash-Telemetry-Sdk
+     * @example @upstash/redis@v1.1.1
+     */
+    sdk?: string;
+    /**
+     * Upstash-Telemetry-Platform
+     * @example cloudflare
+     */
+    platform?: string;
+    /**
+     * Upstash-Telemetry-Runtime
+     * @example node@v18
+     */
+    runtime?: string;
+};
+export type RedisOptions = {
+    /**
+     * Automatically try to deserialize the returned data from upstash using `JSON.deserialize`
+     *
+     * @default true
+     */
+    automaticDeserialization?: boolean;
+    enableTelemetry?: boolean;
+};

package/types/platforms/cloudflare.d.ts

@@ -1,7 +1,7 @@
 import * as core from "../pkg/redis.js";
 import type { Requester, UpstashRequest, UpstashResponse } from "../pkg/http.js";
 import { RequesterConfig } from "../pkg/http.js";
-declare type Env = {
+type Env = {
     UPSTASH_DISABLE_TELEMETRY?: string;
 };
 export type { Requester, UpstashRequest, UpstashResponse };
@@ -9,7 +9,7 @@ export type { Requester, UpstashRequest, UpstashResponse };
  * Connection credentials for upstash redis.
  * Get them from https://console.upstash.com/redis/<uuid>
  */
-export declare type RedisConfigCloudflare = {
+export type RedisConfigCloudflare = {
     /**
      * UPSTASH_REDIS_REST_URL
      */

package/types/platforms/fastly.d.ts

@@ -5,7 +5,7 @@ export type { Requester, UpstashRequest, UpstashResponse };
  * Connection credentials for upstash redis.
  * Get them from https://console.upstash.com/redis/<uuid>
  */
-export declare type RedisConfigFastly = {
+export type RedisConfigFastly = {
     /**
      * UPSTASH_REDIS_REST_URL
      */

package/types/platforms/node_with_fetch.d.ts

@@ -6,7 +6,7 @@ export type { Requester, UpstashRequest, UpstashResponse };
  * Connection credentials for upstash redis.
  * Get them from https://console.upstash.com/redis/<uuid>
  */
-export declare type RedisConfigNodejs = {
+export type RedisConfigNodejs = {
     /**
      * UPSTASH_REDIS_REST_URL
      */

package/types/platforms/nodejs.d.ts

@@ -5,7 +5,7 @@ export type { Requester, UpstashRequest, UpstashResponse };
  * Connection credentials for upstash redis.
  * Get them from https://console.upstash.com/redis/<uuid>
  */
-export declare type RedisConfigNodejs = {
+export type RedisConfigNodejs = {
     /**
      * UPSTASH_REDIS_REST_URL
      */

package/types/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "v0.0.0-ci.608697de-20221215";
+export declare const VERSION = "v0.0.0-ci.62b04fa8-20231019";