@upstash/redis 0.0.0-ci.d8fb1ea41777a410b4cc4d3c1600060c679011e5-20240302001408 → 0.0.0-ci.d9493973d6f2f874c87119d354757b779db8d919-20240930220425

package/{zmscore-5d82e632.d.ts → zmscore-BLgYk16R.d.mts}

@@ -23,7 +23,10 @@ type RedisOptions = {
      * @default true
      */
     automaticDeserialization?: boolean;
+    latencyLogging?: boolean;
     enableTelemetry?: boolean;
+    enableAutoPipelining?: boolean;
+    readYourWrites?: boolean;
 };
 
 type CacheSetting = "default" | "force-cache" | "no-cache" | "no-store" | "only-if-cached" | "reload";
@@ -33,12 +36,21 @@ type UpstashRequest = {
      * Request body will be serialized to json
      */
     body?: unknown;
+    upstashSyncToken?: string;
 };
 type UpstashResponse<TResult> = {
     result?: TResult;
     error?: string;
 };
 interface Requester {
+    /**
+     * When this flag is enabled, any subsequent commands issued by this client are guaranteed to observe the effects of all earlier writes submitted by the same client.
+     */
+    readYourWrites?: boolean;
+    /**
+     * This token is used to ensure that the client is in sync with the server. On each request, we send this token in the header, and the server will return a new token.
+     */
+    upstashSyncToken?: string;
     request: <TResult = unknown>(req: UpstashRequest) => Promise<UpstashResponse<TResult>>;
 }
 type RetryConfig = false | {
@@ -106,6 +118,7 @@ type CommandOptions<TResult, TData> = {
      * @default true
      */
     automaticDeserialization?: boolean;
+    latencyLogging?: boolean;
 };
 /**
  * Command offers default (de)serialization and the exec method to all commands.
@@ -220,8 +233,8 @@ type ScanCommandOptions = {
 /**
  * @see https://redis.io/commands/scan
  */
-declare class ScanCommand extends Command<[number, string[]], [number, string[]]> {
-    constructor([cursor, opts]: [cursor: number, opts?: ScanCommandOptions], cmdOpts?: CommandOptions<[number, string[]], [number, string[]]>);
+declare class ScanCommand extends Command<[string, string[]], [string, string[]]> {
+    constructor([cursor, opts]: [cursor: string | number, opts?: ScanCommandOptions], cmdOpts?: CommandOptions<[string, string[]], [string, string[]]>);
 }
 
 type GeoAddCommandOptions = {
@@ -233,11 +246,11 @@ type GeoAddCommandOptions = {
 } & {
     ch?: boolean;
 });
-interface GeoMember<TMemberType> {
+type GeoMember<TMemberType> = {
     latitude: number;
     longitude: number;
     member: TMemberType;
-}
+};
 /**
  * @see https://redis.io/commands/geoadd
  */
@@ -264,6 +277,28 @@ declare class BitCountCommand extends Command<number, number> {
     constructor(cmd: [key: string, start: number, end: number], opts?: CommandOptions<number, number>);
 }
 
+type SubCommandArgs<TRest extends unknown[] = []> = [
+    encoding: string,
+    offset: number | string,
+    ...rest: TRest
+];
+/**
+ * @see https://redis.io/commands/bitfield
+ */
+declare class BitFieldCommand<T = Promise<number[]>> {
+    private client;
+    private opts?;
+    private execOperation;
+    private command;
+    constructor(args: [key: string], client: Requester, opts?: CommandOptions<number[], number[]> | undefined, execOperation?: (command: Command<number[], number[]>) => T);
+    private chain;
+    get(...args: SubCommandArgs): this;
+    set(...args: SubCommandArgs<[value: number]>): this;
+    incrby(...args: SubCommandArgs<[increment: number]>): this;
+    overflow(overflow: "WRAP" | "SAT" | "FAIL"): this;
+    exec(): T;
+}
+
 /**
  * @see https://redis.io/commands/bitop
  */
@@ -390,7 +425,7 @@ declare class GeoDistCommand<TMemberType = string> extends Command<number | null
  * @see https://redis.io/commands/geohash
  */
 declare class GeoHashCommand<TMember = string> extends Command<(string | null)[], (string | null)[]> {
-    constructor(cmd: [string, ...(TMember[] | TMember[])], opts?: CommandOptions<(string | null)[], (string | null)[]>);
+    constructor(cmd: [string, ...TMember[]], opts?: CommandOptions<(string | null)[], (string | null)[]>);
 }
 
 type Coordinates = {
@@ -617,9 +652,7 @@ declare class HMGetCommand<TData extends Record<string, unknown>> extends Comman
  * @see https://redis.io/commands/hmset
  */
 declare class HMSetCommand<TData> extends Command<"OK", "OK"> {
-    constructor([key, kv]: [key: string, kv: {
-        [field: string]: TData;
-    }], opts?: CommandOptions<"OK", "OK">);
+    constructor([key, kv]: [key: string, kv: Record<string, TData>], opts?: CommandOptions<"OK", "OK">);
 }
 
 /**
@@ -635,22 +668,20 @@ declare class HRandFieldCommand<TData extends string | string[] | Record<string,
  * @see https://redis.io/commands/hscan
  */
 declare class HScanCommand extends Command<[
-    number,
+    string,
     (string | number)[]
 ], [
-    number,
+    string,
     (string | number)[]
 ]> {
-    constructor([key, cursor, cmdOpts]: [key: string, cursor: number, cmdOpts?: ScanCommandOptions], opts?: CommandOptions<[number, (string | number)[]], [number, (string | number)[]]>);
+    constructor([key, cursor, cmdOpts]: [key: string, cursor: string | number, cmdOpts?: ScanCommandOptions], opts?: CommandOptions<[string, (string | number)[]], [string, (string | number)[]]>);
 }
 
 /**
  * @see https://redis.io/commands/hset
  */
 declare class HSetCommand<TData> extends Command<number, number> {
-    constructor([key, kv]: [key: string, kv: {
-        [field: string]: TData;
-    }], opts?: CommandOptions<number, number>);
+    constructor([key, kv]: [key: string, kv: Record<string, TData>], opts?: CommandOptions<number, number>);
 }
 
 /**
@@ -780,6 +811,17 @@ declare class JsonMGetCommand<TData = unknown[]> extends Command<TData, TData> {
     constructor(cmd: [keys: string[], path: string], opts?: CommandOptions<TData, TData>);
 }
 
+/**
+ * @see https://redis.io/commands/json.mset
+ */
+declare class JsonMSetCommand<TData extends number | string | boolean | Record<string, unknown> | (number | string | boolean | Record<string, unknown>)[]> extends Command<"OK" | null, "OK" | null> {
+    constructor(cmd: {
+        key: string;
+        path: string;
+        value: TData;
+    }[], opts?: CommandOptions<"OK" | null, "OK" | null>);
+}
+
 /**
  * @see https://redis.io/commands/json.numincrby
  */
@@ -936,25 +978,21 @@ declare class LTrimCommand extends Command<"OK", "OK"> {
  * @see https://redis.io/commands/mget
  */
 declare class MGetCommand<TData extends unknown[]> extends Command<(string | null)[], TData> {
-    constructor(cmd: [string[]] | [...(string[] | string[])], opts?: CommandOptions<(string | null)[], TData>);
+    constructor(cmd: [string[]] | [...string[]], opts?: CommandOptions<(string | null)[], TData>);
 }
 
 /**
  * @see https://redis.io/commands/mset
  */
 declare class MSetCommand<TData> extends Command<"OK", "OK"> {
-    constructor([kv]: [kv: {
-        [key: string]: TData;
-    }], opts?: CommandOptions<"OK", "OK">);
+    constructor([kv]: [kv: Record<string, TData>], opts?: CommandOptions<"OK", "OK">);
 }
 
 /**
  * @see https://redis.io/commands/msetnx
  */
 declare class MSetNXCommand<TData = string> extends Command<number, number> {
-    constructor([kv]: [kv: {
-        [key: string]: TData;
-    }], opts?: CommandOptions<number, number>);
+    constructor([kv]: [kv: Record<string, TData>], opts?: CommandOptions<number, number>);
 }
 
 /**
@@ -1052,7 +1090,7 @@ declare class RPushXCommand<TData = string> extends Command<number, number> {
  * @see https://redis.io/commands/sadd
  */
 declare class SAddCommand<TData = string> extends Command<number, number> {
-    constructor(cmd: [key: string, ...members: TData[]], opts?: CommandOptions<number, number>);
+    constructor(cmd: [key: string, member: TData, ...members: TData[]], opts?: CommandOptions<number, number>);
 }
 
 /**
@@ -1240,13 +1278,13 @@ declare class SRemCommand<TData = string> extends Command<number, number> {
  * @see https://redis.io/commands/sscan
  */
 declare class SScanCommand extends Command<[
-    number,
+    string,
     (string | number)[]
 ], [
-    number,
+    string,
     (string | number)[]
 ]> {
-    constructor([key, cursor, opts]: [key: string, cursor: number, opts?: ScanCommandOptions], cmdOpts?: CommandOptions<[number, (string | number)[]], [number, (string | number)[]]>);
+    constructor([key, cursor, opts]: [key: string, cursor: string | number, opts?: ScanCommandOptions], cmdOpts?: CommandOptions<[string, (string | number)[]], [string, (string | number)[]]>);
 }
 
 /**
@@ -1321,9 +1359,7 @@ declare class XAddCommand extends Command<string, string> {
     constructor([key, id, entries, opts]: [
         key: string,
         id: "*" | string,
-        entries: {
-            [field: string]: unknown;
-        },
+        entries: Record<string, unknown>,
         opts?: XAddCommandOptions
     ], commandOptions?: CommandOptions<string, string>);
 }
@@ -1547,13 +1583,13 @@ declare class ZRevRankCommand<TData> extends Command<number | null, number | nul
  * @see https://redis.io/commands/zscan
  */
 declare class ZScanCommand extends Command<[
-    number,
+    string,
     (string | number)[]
 ], [
-    number,
+    string,
     (string | number)[]
 ]> {
-    constructor([key, cursor, opts]: [key: string, cursor: number, opts?: ScanCommandOptions], cmdOpts?: CommandOptions<[number, (string | number)[]], [number, (string | number)[]]>);
+    constructor([key, cursor, opts]: [key: string, cursor: string | number, opts?: ScanCommandOptions], cmdOpts?: CommandOptions<[string, (string | number)[]], [string, (string | number)[]]>);
 }
 
 /**
@@ -1644,6 +1680,23 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
      * @see https://redis.io/commands/bitcount
      */
     bitcount: (key: string, start: number, end: number) => Pipeline<[...TCommands, Command<any, number>]>;
+    /**
+     * Returns an instance that can be used to execute `BITFIELD` commands on one key.
+     *
+     * @example
+     * ```typescript
+     * redis.set("mykey", 0);
+     * const result = await redis.pipeline()
+     *   .bitfield("mykey")
+     *   .set("u4", 0, 16)
+     *   .incr("u4", "#1", 1)
+     *   .exec();
+     * console.log(result); // [[0, 1]]
+     * ```
+     *
+     * @see https://redis.io/commands/bitfield
+     */
+    bitfield: (key: string) => BitFieldCommand<Pipeline<[...TCommands, Command<any, number[]>]>>;
     /**
      * @see https://redis.io/commands/bitop
      */
@@ -1713,7 +1766,7 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
      * @see https://redis.io/commands/flushdb
      */
     flushdb: (opts?: {
-        async?: boolean | undefined;
+        async?: boolean;
     } | undefined) => Pipeline<[...TCommands, Command<any, "OK">]>;
     /**
      * @see https://redis.io/commands/geoadd
@@ -1760,11 +1813,11 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     }, order: "ASC" | "DESC" | "asc" | "desc", opts?: {
         count?: {
             limit: number;
-            any?: boolean | undefined;
-        } | undefined;
-        withCoord?: boolean | undefined;
-        withDist?: boolean | undefined;
-        withHash?: boolean | undefined;
+            any?: boolean;
+        };
+        withCoord?: boolean;
+        withDist?: boolean;
+        withHash?: boolean;
     } | undefined) => Pipeline<[...TCommands, Command<any, ({
         member: TData;
     } & {
@@ -1801,9 +1854,9 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     }, order: "ASC" | "DESC" | "asc" | "desc", opts?: {
         count?: {
             limit: number;
-            any?: boolean | undefined;
-        } | undefined;
-        storeDist?: boolean | undefined;
+            any?: boolean;
+        };
+        storeDist?: boolean;
     } | undefined) => Pipeline<[...TCommands, Command<any, number>]>;
     /**
      * @see https://redis.io/commands/get
@@ -1864,9 +1917,7 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/hmset
      */
-    hmset: <TData>(key: string, kv: {
-        [field: string]: TData;
-    }) => Pipeline<[...TCommands, Command<any, "OK">]>;
+    hmset: <TData>(key: string, kv: Record<string, TData>) => Pipeline<[...TCommands, Command<any, "OK">]>;
     /**
      * @see https://redis.io/commands/hrandfield
      */
@@ -1874,13 +1925,11 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/hscan
      */
-    hscan: (key: string, cursor: number, cmdOpts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, [number, (string | number)[]]>]>;
+    hscan: (key: string, cursor: string | number, cmdOpts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, [string, (string | number)[]]>]>;
     /**
      * @see https://redis.io/commands/hset
      */
-    hset: <TData>(key: string, kv: {
-        [field: string]: TData;
-    }) => Pipeline<[...TCommands, Command<any, number>]>;
+    hset: <TData>(key: string, kv: Record<string, TData>) => Pipeline<[...TCommands, Command<any, number>]>;
     /**
      * @see https://redis.io/commands/hsetnx
      */
@@ -1929,13 +1978,17 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
      * @see https://redis.io/commands/lpop
      */
     lpop: <TData>(key: string, count?: number | undefined) => Pipeline<[...TCommands, Command<any, TData | null>]>;
+    /**
+     * @see https://redis.io/commands/lmpop
+     */
+    lmpop: <TData>(numkeys: number, keys: string[], args_2: "LEFT" | "RIGHT", count?: number | undefined) => Pipeline<[...TCommands, Command<any, [string, TData[]] | null>]>;
     /**
      * @see https://redis.io/commands/lpos
      */
     lpos: <TData>(key: string, element: unknown, opts?: {
-        rank?: number | undefined;
-        count?: number | undefined;
-        maxLen?: number | undefined;
+        rank?: number;
+        count?: number;
+        maxLen?: number;
     } | undefined) => Pipeline<[...TCommands, Command<any, TData>]>;
     /**
      * @see https://redis.io/commands/lpush
@@ -1968,15 +2021,11 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/mset
      */
-    mset: <TData>(kv: {
-        [key: string]: TData;
-    }) => Pipeline<[...TCommands, Command<any, "OK">]>;
+    mset: <TData>(kv: Record<string, TData>) => Pipeline<[...TCommands, Command<any, "OK">]>;
     /**
      * @see https://redis.io/commands/msetnx
      */
-    msetnx: <TData>(kv: {
-        [key: string]: TData;
-    }) => Pipeline<[...TCommands, Command<any, number>]>;
+    msetnx: <TData>(kv: Record<string, TData>) => Pipeline<[...TCommands, Command<any, number>]>;
     /**
      * @see https://redis.io/commands/persist
      */
@@ -2044,11 +2093,11 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/sadd
      */
-    sadd: <TData>(key: string, ...members: TData[]) => Pipeline<[...TCommands, Command<any, number>]>;
+    sadd: <TData>(key: string, member: TData, ...members: TData[]) => Pipeline<[...TCommands, Command<any, number>]>;
     /**
      * @see https://redis.io/commands/scan
      */
-    scan: (cursor: number, opts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, [number, string[]]>]>;
+    scan: (cursor: string | number, opts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, [string, string[]]>]>;
     /**
      * @see https://redis.io/commands/scard
      */
@@ -2129,7 +2178,7 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/sscan
      */
-    sscan: (key: string, cursor: number, opts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, [number, (string | number)[]]>]>;
+    sscan: (key: string, cursor: string | number, opts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, [string, (string | number)[]]>]>;
     /**
      * @see https://redis.io/commands/strlen
      */
@@ -2165,15 +2214,13 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/zadd
      */
-    zadd: <TData>(...args: [key: string, scoreMember: ScoreMember<TData>, ...scoreMemberPairs: ScoreMember<TData>[]] | [key: string, opts: ZAddCommandOptions, ScoreMember<TData>, ...ScoreMember<TData>[]]) => Pipeline<[...TCommands, Command<any, number | null>]>;
+    zadd: <TData>(...args: [key: string, scoreMember: ScoreMember<TData>, ...scoreMemberPairs: ScoreMember<TData>[]] | [key: string, opts: ZAddCommandOptions, ...scoreMemberPairs: [ScoreMember<TData>, ...ScoreMember<TData>[]]]) => Pipeline<[...TCommands, Command<any, number | null>]>;
     /**
      * @see https://redis.io/commands/xadd
      */
-    xadd: (key: string, id: string, entries: {
-        [field: string]: unknown;
-    }, opts?: {
-        nomkStream?: boolean | undefined;
-        trim?: (({
+    xadd: (key: string, id: string, entries: Record<string, unknown>, opts?: {
+        nomkStream?: boolean;
+        trim?: ({
             type: "MAXLEN" | "maxlen";
             threshold: number;
         } | {
@@ -2181,11 +2228,11 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
             threshold: string;
         }) & ({
             comparison: "~";
-            limit?: number | undefined;
+            limit?: number;
         } | {
             comparison: "=";
-            limit?: undefined;
-        })) | undefined;
+            limit?: never;
+        });
     } | undefined) => Pipeline<[...TCommands, Command<any, string>]>;
     /**
      * @see https://redis.io/commands/xack
@@ -2201,11 +2248,11 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     xgroup: (key: string, opts: {
         type: "CREATE";
         group: string;
-        id: string;
+        id: `$` | string;
         options?: {
-            MKSTREAM?: boolean | undefined;
-            ENTRIESREAD?: number | undefined;
-        } | undefined;
+            MKSTREAM?: boolean;
+            ENTRIESREAD?: number;
+        };
     } | {
         type: "CREATECONSUMER";
         group: string;
@@ -2220,10 +2267,10 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     } | {
         type: "SETID";
         group: string;
-        id: string;
+        id: `$` | string;
         options?: {
-            ENTRIESREAD?: number | undefined;
-        } | undefined;
+            ENTRIESREAD?: number;
+        };
     }) => Pipeline<[...TCommands, Command<any, never>]>;
     /**
      * @see https://redis.io/commands/xread
@@ -2250,35 +2297,35 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
      * @see https://redis.io/commands/xpending
      */
     xpending: (key: string, group: string, start: string, end: string, count: number, options?: {
-        idleTime?: number | undefined;
-        consumer?: string | string[] | undefined;
+        idleTime?: number;
+        consumer?: string | string[];
     } | undefined) => Pipeline<[...TCommands, Command<any, unknown[]>]>;
     /**
      * @see https://redis.io/commands/xclaim
      */
     xclaim: (key: string, group: string, consumer: string, minIdleTime: number, id: string | string[], options?: {
-        idleMS?: number | undefined;
-        timeMS?: number | undefined;
-        retryCount?: number | undefined;
-        force?: boolean | undefined;
-        justId?: boolean | undefined;
-        lastId?: number | undefined;
+        idleMS?: number;
+        timeMS?: number;
+        retryCount?: number;
+        force?: boolean;
+        justId?: boolean;
+        lastId?: number;
     } | undefined) => Pipeline<[...TCommands, Command<any, unknown[]>]>;
     /**
      * @see https://redis.io/commands/xautoclaim
      */
     xautoclaim: (key: string, group: string, consumer: string, minIdleTime: number, start: string, options?: {
-        count?: number | undefined;
-        justId?: boolean | undefined;
+        count?: number;
+        justId?: boolean;
     } | undefined) => Pipeline<[...TCommands, Command<any, unknown[]>]>;
     /**
      * @see https://redis.io/commands/xtrim
      */
     xtrim: (key: string, options: {
         strategy: "MAXLEN" | "MINID";
-        exactness?: "~" | "=" | undefined;
-        threshold: string | number;
-        limit?: number | undefined;
+        exactness?: "~" | "=";
+        threshold: number | string;
+        limit?: number;
     }) => Pipeline<[...TCommands, Command<any, number>]>;
     /**
      * @see https://redis.io/commands/xrange
@@ -2323,21 +2370,11 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/zrange
      */
-    zrange: <TData extends unknown[]>(...args: [key: string, min: number, max: number, opts?: ZRangeCommandOptions] | [
-        key: string,
-        min: `(${string}` | `[${string}` | "-" | "+",
-        max: `(${string}` | `[${string}` | "-" | "+",
-        opts: {
-            byLex: true;
-        } & ZRangeCommandOptions
-    ] | [
-        key: string,
-        min: number | `(${number}` | "-inf" | "+inf",
-        max: number | `(${number}` | "-inf" | "+inf",
-        opts: {
-            byScore: true;
-        } & ZRangeCommandOptions
-    ]) => Pipeline<[...TCommands, Command<any, TData>]>;
+    zrange: <TData extends unknown[]>(...args: [key: string, min: number, max: number, opts?: ZRangeCommandOptions] | [key: string, min: `(${string}` | `[${string}` | "-" | "+", max: `(${string}` | `[${string}` | "-" | "+", opts: {
+        byLex: true;
+    } & ZRangeCommandOptions] | [key: string, min: number | `(${number}` | "-inf" | "+inf", max: number | `(${number}` | "-inf" | "+inf", opts: {
+        byScore: true;
+    } & ZRangeCommandOptions]) => Pipeline<[...TCommands, Command<any, TData>]>;
     /**
      * @see https://redis.io/commands/zrank
      */
@@ -2365,7 +2402,7 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/zscan
      */
-    zscan: (key: string, cursor: number, opts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, [number, (string | number)[]]>]>;
+    zscan: (key: string, cursor: string | number, opts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, [string, (string | number)[]]>]>;
     /**
      * @see https://redis.io/commands/zscore
      */
@@ -2426,6 +2463,10 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
          * @see https://redis.io/commands/json.mget
          */
         mget: (keys: string[], path: string) => Pipeline<[...TCommands, Command<any, any>]>;
+        /**
+         * @see https://redis.io/commands/json.mset
+         */
+        mset: (...args: CommandArgs<typeof JsonMSetCommand>) => Pipeline<[...TCommands, Command<any, "OK" | null>]>;
         /**
          * @see https://redis.io/commands/json.numincrby
          */
@@ -2451,9 +2492,9 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
          */
         set: (key: string, path: string, value: string | number | boolean | Record<string, unknown> | (string | number | boolean | Record<string, unknown>)[], opts?: {
             nx: true;
-            xx?: undefined;
+            xx?: never;
         } | {
-            nx?: undefined;
+            nx?: never;
             xx: true;
         } | undefined) => Pipeline<[...TCommands, Command<any, "OK" | null>]>;
         /**
@@ -2524,6 +2565,7 @@ declare class Redis {
     protected client: Requester;
     protected opts?: CommandOptions<any, any>;
     protected enableTelemetry: boolean;
+    protected enableAutoPipelining: boolean;
     /**
      * Create a new redis client
      *
@@ -2536,6 +2578,8 @@ declare class Redis {
      * ```
      */
     constructor(client: Requester, opts?: RedisOptions);
+    get readYourWritesSyncToken(): string | undefined;
+    set readYourWritesSyncToken(session: string | undefined);
     get json(): {
         /**
          * @see https://redis.io/commands/json.arrappend
@@ -2580,7 +2624,11 @@ declare class Redis {
         /**
          * @see https://redis.io/commands/json.mget
          */
-        mget: <TData_1>(keys: string[], path: string) => Promise<TData_1>;
+        mget: <TData>(keys: string[], path: string) => Promise<TData>;
+        /**
+         * @see https://redis.io/commands/json.mset
+         */
+        mset: (...args: CommandArgs<typeof JsonMSetCommand>) => Promise<"OK" | null>;
         /**
          * @see https://redis.io/commands/json.numincrby
          */
@@ -2606,9 +2654,9 @@ declare class Redis {
          */
         set: (key: string, path: string, value: string | number | boolean | Record<string, unknown> | (string | number | boolean | Record<string, unknown>)[], opts?: {
             nx: true;
-            xx?: undefined;
+            xx?: never;
         } | {
-            nx?: undefined;
+            nx?: never;
             xx: true;
         } | undefined) => Promise<"OK" | null>;
         /**
@@ -2643,6 +2691,7 @@ declare class Redis {
      * @see {@link Pipeline}
      */
     pipeline: () => Pipeline<[]>;
+    protected autoPipeline: () => Redis;
     /**
      * Create a new transaction to allow executing multiple steps atomically.
      *
@@ -2653,6 +2702,22 @@ declare class Redis {
      * @see {@link Pipeline}
      */
     multi: () => Pipeline<[]>;
+    /**
+     * Returns an instance that can be used to execute `BITFIELD` commands on one key.
+     *
+     * @example
+     * ```typescript
+     * redis.set("mykey", 0);
+     * const result = await redis.bitfield("mykey")
+     *   .set("u4", 0, 16)
+     *   .incr("u4", "#1", 1)
+     *   .exec();
+     * console.log(result); // [0, 1]
+     * ```
+     *
+     * @see https://redis.io/commands/bitfield
+     */
+    bitfield: (key: string) => BitFieldCommand<Promise<number[]>>;
     /**
      * @see https://redis.io/commands/append
      */
@@ -2726,7 +2791,7 @@ declare class Redis {
      * @see https://redis.io/commands/flushdb
      */
     flushdb: (opts?: {
-        async?: boolean | undefined;
+        async?: boolean;
     } | undefined) => Promise<"OK">;
     /**
      * @see https://redis.io/commands/geoadd
@@ -2773,11 +2838,11 @@ declare class Redis {
     }, order: "ASC" | "DESC" | "asc" | "desc", opts?: {
         count?: {
             limit: number;
-            any?: boolean | undefined;
-        } | undefined;
-        withCoord?: boolean | undefined;
-        withDist?: boolean | undefined;
-        withHash?: boolean | undefined;
+            any?: boolean;
+        };
+        withCoord?: boolean;
+        withDist?: boolean;
+        withHash?: boolean;
     } | undefined) => Promise<({
         member: TData;
     } & {
@@ -2814,9 +2879,9 @@ declare class Redis {
     }, order: "ASC" | "DESC" | "asc" | "desc", opts?: {
         count?: {
             limit: number;
-            any?: boolean | undefined;
-        } | undefined;
-        storeDist?: boolean | undefined;
+            any?: boolean;
+        };
+        storeDist?: boolean;
     } | undefined) => Promise<number>;
     /**
      * @see https://redis.io/commands/get
@@ -2877,27 +2942,23 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/hmset
      */
-    hmset: <TData>(key: string, kv: {
-        [field: string]: TData;
-    }) => Promise<"OK">;
+    hmset: <TData>(key: string, kv: Record<string, TData>) => Promise<"OK">;
     /**
      * @see https://redis.io/commands/hrandfield
      */
     hrandfield: {
-        (key: string): Promise<string>;
+        (key: string): Promise<string | null>;
         (key: string, count: number): Promise<string[]>;
         <TData extends Record<string, unknown>>(key: string, count: number, withValues: boolean): Promise<Partial<TData>>;
     };
     /**
      * @see https://redis.io/commands/hscan
      */
-    hscan: (key: string, cursor: number, cmdOpts?: ScanCommandOptions | undefined) => Promise<[number, (string | number)[]]>;
+    hscan: (key: string, cursor: string | number, cmdOpts?: ScanCommandOptions | undefined) => Promise<[string, (string | number)[]]>;
     /**
      * @see https://redis.io/commands/hset
      */
-    hset: <TData>(key: string, kv: {
-        [field: string]: TData;
-    }) => Promise<number>;
+    hset: <TData>(key: string, kv: Record<string, TData>) => Promise<number>;
     /**
      * @see https://redis.io/commands/hsetnx
      */
@@ -2946,13 +3007,17 @@ declare class Redis {
      * @see https://redis.io/commands/lpop
      */
     lpop: <TData>(key: string, count?: number | undefined) => Promise<TData | null>;
+    /**
+     * @see https://redis.io/commands/lmpop
+     */
+    lmpop: <TData>(numkeys: number, keys: string[], args_2: "LEFT" | "RIGHT", count?: number | undefined) => Promise<[string, TData[]] | null>;
     /**
      * @see https://redis.io/commands/lpos
      */
     lpos: <TData = number>(key: string, element: unknown, opts?: {
-        rank?: number | undefined;
-        count?: number | undefined;
-        maxLen?: number | undefined;
+        rank?: number;
+        count?: number;
+        maxLen?: number;
     } | undefined) => Promise<TData>;
     /**
      * @see https://redis.io/commands/lpush
@@ -2985,15 +3050,11 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/mset
      */
-    mset: <TData>(kv: {
-        [key: string]: TData;
-    }) => Promise<"OK">;
+    mset: <TData>(kv: Record<string, TData>) => Promise<"OK">;
     /**
      * @see https://redis.io/commands/msetnx
      */
-    msetnx: <TData>(kv: {
-        [key: string]: TData;
-    }) => Promise<number>;
+    msetnx: <TData>(kv: Record<string, TData>) => Promise<number>;
     /**
      * @see https://redis.io/commands/persist
      */
@@ -3061,11 +3122,11 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/sadd
      */
-    sadd: <TData>(key: string, ...members: TData[]) => Promise<number>;
+    sadd: <TData>(key: string, member: TData, ...members: TData[]) => Promise<number>;
     /**
      * @see https://redis.io/commands/scan
      */
-    scan: (cursor: number, opts?: ScanCommandOptions | undefined) => Promise<[number, string[]]>;
+    scan: (cursor: string | number, opts?: ScanCommandOptions | undefined) => Promise<[string, string[]]>;
     /**
      * @see https://redis.io/commands/scard
      */
@@ -3149,7 +3210,7 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/sscan
      */
-    sscan: (key: string, cursor: number, opts?: ScanCommandOptions | undefined) => Promise<[number, (string | number)[]]>;
+    sscan: (key: string, cursor: string | number, opts?: ScanCommandOptions | undefined) => Promise<[string, (string | number)[]]>;
     /**
      * @see https://redis.io/commands/strlen
      */
@@ -3185,11 +3246,9 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/xadd
      */
-    xadd: (key: string, id: string, entries: {
-        [field: string]: unknown;
-    }, opts?: {
-        nomkStream?: boolean | undefined;
-        trim?: (({
+    xadd: (key: string, id: string, entries: Record<string, unknown>, opts?: {
+        nomkStream?: boolean;
+        trim?: ({
             type: "MAXLEN" | "maxlen";
             threshold: number;
         } | {
@@ -3197,11 +3256,11 @@ declare class Redis {
             threshold: string;
         }) & ({
             comparison: "~";
-            limit?: number | undefined;
+            limit?: number;
         } | {
             comparison: "=";
-            limit?: undefined;
-        })) | undefined;
+            limit?: never;
+        });
     } | undefined) => Promise<string>;
     /**
      * @see https://redis.io/commands/xack
@@ -3217,11 +3276,11 @@ declare class Redis {
     xgroup: (key: string, opts: {
         type: "CREATE";
         group: string;
-        id: string;
+        id: `$` | string;
         options?: {
-            MKSTREAM?: boolean | undefined;
-            ENTRIESREAD?: number | undefined;
-        } | undefined;
+            MKSTREAM?: boolean;
+            ENTRIESREAD?: number;
+        };
     } | {
         type: "CREATECONSUMER";
         group: string;
@@ -3236,10 +3295,10 @@ declare class Redis {
     } | {
         type: "SETID";
         group: string;
-        id: string;
+        id: `$` | string;
         options?: {
-            ENTRIESREAD?: number | undefined;
-        } | undefined;
+            ENTRIESREAD?: number;
+        };
     }) => Promise<never>;
     /**
      * @see https://redis.io/commands/xread
@@ -3266,35 +3325,35 @@ declare class Redis {
      * @see https://redis.io/commands/xpending
      */
     xpending: (key: string, group: string, start: string, end: string, count: number, options?: {
-        idleTime?: number | undefined;
-        consumer?: string | string[] | undefined;
+        idleTime?: number;
+        consumer?: string | string[];
     } | undefined) => Promise<unknown[]>;
     /**
      * @see https://redis.io/commands/xclaim
      */
     xclaim: (key: string, group: string, consumer: string, minIdleTime: number, id: string | string[], options?: {
-        idleMS?: number | undefined;
-        timeMS?: number | undefined;
-        retryCount?: number | undefined;
-        force?: boolean | undefined;
-        justId?: boolean | undefined;
-        lastId?: number | undefined;
+        idleMS?: number;
+        timeMS?: number;
+        retryCount?: number;
+        force?: boolean;
+        justId?: boolean;
+        lastId?: number;
     } | undefined) => Promise<unknown[]>;
     /**
      * @see https://redis.io/commands/xautoclaim
      */
     xautoclaim: (key: string, group: string, consumer: string, minIdleTime: number, start: string, options?: {
-        count?: number | undefined;
-        justId?: boolean | undefined;
+        count?: number;
+        justId?: boolean;
     } | undefined) => Promise<unknown[]>;
     /**
      * @see https://redis.io/commands/xtrim
      */
     xtrim: (key: string, options: {
         strategy: "MAXLEN" | "MINID";
-        exactness?: "~" | "=" | undefined;
-        threshold: string | number;
-        limit?: number | undefined;
+        exactness?: "~" | "=";
+        threshold: number | string;
+        limit?: number;
     }) => Promise<number>;
     /**
      * @see https://redis.io/commands/xrange
@@ -3307,7 +3366,7 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/zadd
      */
-    zadd: <TData>(...args: [key: string, scoreMember: ScoreMember<TData>, ...scoreMemberPairs: ScoreMember<TData>[]] | [key: string, opts: ZAddCommandOptions, ScoreMember<TData>, ...ScoreMember<TData>[]]) => Promise<number | null>;
+    zadd: <TData>(...args: [key: string, scoreMember: ScoreMember<TData>, ...scoreMemberPairs: ScoreMember<TData>[]] | [key: string, opts: ZAddCommandOptions, ...scoreMemberPairs: [ScoreMember<TData>, ...ScoreMember<TData>[]]]) => Promise<number | null>;
     /**
      * @see https://redis.io/commands/zcard
      */
@@ -3347,21 +3406,11 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/zrange
      */
-    zrange: <TData extends unknown[]>(...args: [key: string, min: number, max: number, opts?: ZRangeCommandOptions] | [
-        key: string,
-        min: `(${string}` | `[${string}` | "-" | "+",
-        max: `(${string}` | `[${string}` | "-" | "+",
-        opts: {
-            byLex: true;
-        } & ZRangeCommandOptions
-    ] | [
-        key: string,
-        min: number | `(${number}` | "-inf" | "+inf",
-        max: number | `(${number}` | "-inf" | "+inf",
-        opts: {
-            byScore: true;
-        } & ZRangeCommandOptions
-    ]) => Promise<TData>;
+    zrange: <TData extends unknown[]>(...args: [key: string, min: number, max: number, opts?: ZRangeCommandOptions] | [key: string, min: `(${string}` | `[${string}` | "-" | "+", max: `(${string}` | `[${string}` | "-" | "+", opts: {
+        byLex: true;
+    } & ZRangeCommandOptions] | [key: string, min: number | `(${number}` | "-inf" | "+inf", max: number | `(${number}` | "-inf" | "+inf", opts: {
+        byScore: true;
+    } & ZRangeCommandOptions]) => Promise<TData>;
     /**
      * @see https://redis.io/commands/zrank
      */
@@ -3389,7 +3438,7 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/zscan
      */
-    zscan: (key: string, cursor: number, opts?: ScanCommandOptions | undefined) => Promise<[number, (string | number)[]]>;
+    zscan: (key: string, cursor: string | number, opts?: ScanCommandOptions | undefined) => Promise<[string, (string | number)[]]>;
     /**
      * @see https://redis.io/commands/zscore
      */
@@ -3404,6 +3453,24 @@ declare class Redis {
     zunionstore: (destination: string, numKeys: number, keys: string[], opts?: ZUnionStoreCommandOptions | undefined) => Promise<number>;
 }
 
+/**
+ * Result of a bad request to upstash
+ */
+declare class UpstashError extends Error {
+    constructor(message: string);
+}
+declare class UrlError extends Error {
+    constructor(url: string);
+}
+
+type error_UpstashError = UpstashError;
+declare const error_UpstashError: typeof UpstashError;
+type error_UrlError = UrlError;
+declare const error_UrlError: typeof UrlError;
+declare namespace error {
+  export { error_UpstashError as UpstashError, error_UrlError as UrlError };
+}
+
 /**
  * @see https://redis.io/commands/zdiffstore
  */
@@ -3418,4 +3485,4 @@ declare class ZMScoreCommand<TData> extends Command<string[] | null, number[] |
     constructor(cmd: [key: string, members: TData[]], opts?: CommandOptions<string[] | null, number[] | null>);
 }
 
-export { IncrByCommand as $, AppendCommand as A, BitCountCommand as B, CopyCommand as C, DBSizeCommand as D, EchoCommand as E, FlushAllCommand as F, GeoAddCommand as G, GetSetCommand as H, HDelCommand as I, HExistsCommand as J, HGetCommand as K, HGetAllCommand as L, HIncrByCommand as M, HIncrByFloatCommand as N, HKeysCommand as O, HLenCommand as P, HMGetCommand as Q, RedisOptions as R, HMSetCommand as S, HRandFieldCommand as T, UpstashRequest as U, HScanCommand as V, HSetCommand as W, HSetNXCommand as X, HStrLenCommand as Y, HValsCommand as Z, IncrCommand as _, RequesterConfig as a, SetNxCommand as a$, IncrByFloatCommand as a0, JsonArrAppendCommand as a1, JsonArrIndexCommand as a2, JsonArrInsertCommand as a3, JsonArrLenCommand as a4, JsonArrPopCommand as a5, JsonArrTrimCommand as a6, JsonClearCommand as a7, JsonDelCommand as a8, JsonForgetCommand as a9, MSetNXCommand as aA, PersistCommand as aB, PExpireCommand as aC, PExpireAtCommand as aD, PingCommand as aE, PSetEXCommand as aF, PTtlCommand as aG, PublishCommand as aH, RandomKeyCommand as aI, RenameCommand as aJ, RenameNXCommand as aK, RPopCommand as aL, RPushCommand as aM, RPushXCommand as aN, SAddCommand as aO, ScanCommand as aP, ScanCommandOptions as aQ, SCardCommand as aR, ScriptExistsCommand as aS, ScriptFlushCommand as aT, ScriptLoadCommand as aU, SDiffCommand as aV, SDiffStoreCommand as aW, SetCommand as aX, SetCommandOptions as aY, SetBitCommand as aZ, SetExCommand as a_, JsonGetCommand as aa, JsonMGetCommand as ab, JsonNumIncrByCommand as ac, JsonNumMultByCommand as ad, JsonObjKeysCommand as ae, JsonObjLenCommand as af, JsonRespCommand as ag, JsonSetCommand as ah, JsonStrAppendCommand as ai, JsonStrLenCommand as aj, JsonToggleCommand as ak, JsonTypeCommand as al, KeysCommand as am, LIndexCommand as an, LInsertCommand as ao, LLenCommand as ap, LMoveCommand as aq, LPopCommand as ar, LPushCommand as as, LPushXCommand as at, LRangeCommand as au, LRemCommand as av, LSetCommand as aw, LTrimCommand as ax, MGetCommand as ay, MSetCommand as az, Redis as b, SetRangeCommand as b0, SInterCommand as b1, SInterStoreCommand as b2, SIsMemberCommand as b3, SMembersCommand as b4, SMIsMemberCommand as b5, SMoveCommand as b6, SPopCommand as b7, SRandMemberCommand as b8, SRemCommand as b9, ZRangeCommandOptions as bA, ZRankCommand as bB, ZRemCommand as bC, ZRemRangeByLexCommand as bD, ZRemRangeByRankCommand as bE, ZRemRangeByScoreCommand as bF, ZRevRankCommand as bG, ZScanCommand as bH, ZScoreCommand as bI, ZUnionCommand as bJ, ZUnionCommandOptions as bK, ZUnionStoreCommand as bL, ZUnionStoreCommandOptions as bM, SScanCommand as ba, StrLenCommand as bb, SUnionCommand as bc, SUnionStoreCommand as bd, TimeCommand as be, TouchCommand as bf, TtlCommand as bg, Type as bh, TypeCommand as bi, UnlinkCommand as bj, XAddCommand as bk, XRangeCommand as bl, ScoreMember as bm, ZAddCommandOptions as bn, ZAddCommand as bo, ZCardCommand as bp, ZCountCommand as bq, ZDiffStoreCommand as br, ZIncrByCommand as bs, ZInterStoreCommand as bt, ZInterStoreCommandOptions as bu, ZLexCountCommand as bv, ZMScoreCommand as bw, ZPopMaxCommand as bx, ZPopMinCommand as by, ZRangeCommand as bz, Requester as c, UpstashResponse as d, BitOpCommand as e, BitPosCommand as f, DecrCommand as g, DecrByCommand as h, DelCommand as i, EvalCommand as j, EvalshaCommand as k, ExistsCommand as l, ExpireCommand as m, ExpireAtCommand as n, FlushDBCommand as o, GeoAddCommandOptions as p, GeoMember as q, GeoDistCommand as r, GeoHashCommand as s, GeoPosCommand as t, GeoSearchCommand as u, GeoSearchStoreCommand as v, GetCommand as w, GetBitCommand as x, GetDelCommand as y, GetRangeCommand as z };
+export { HValsCommand as $, AppendCommand as A, BitCountCommand as B, CopyCommand as C, DBSizeCommand as D, EchoCommand as E, FlushAllCommand as F, GeoAddCommand as G, GetRangeCommand as H, GetSetCommand as I, HDelCommand as J, HExistsCommand as K, HGetCommand as L, HGetAllCommand as M, HIncrByCommand as N, HIncrByFloatCommand as O, Pipeline as P, HKeysCommand as Q, type RedisOptions as R, HLenCommand as S, HMGetCommand as T, type UpstashRequest as U, HMSetCommand as V, HRandFieldCommand as W, HScanCommand as X, HSetCommand as Y, HSetNXCommand as Z, HStrLenCommand as _, type RequesterConfig as a, SetBitCommand as a$, IncrCommand as a0, IncrByCommand as a1, IncrByFloatCommand as a2, JsonArrAppendCommand as a3, JsonArrIndexCommand as a4, JsonArrInsertCommand as a5, JsonArrLenCommand as a6, JsonArrPopCommand as a7, JsonArrTrimCommand as a8, JsonClearCommand as a9, MGetCommand as aA, MSetCommand as aB, MSetNXCommand as aC, PersistCommand as aD, PExpireCommand as aE, PExpireAtCommand as aF, PingCommand as aG, PSetEXCommand as aH, PTtlCommand as aI, PublishCommand as aJ, RandomKeyCommand as aK, RenameCommand as aL, RenameNXCommand as aM, RPopCommand as aN, RPushCommand as aO, RPushXCommand as aP, SAddCommand as aQ, ScanCommand as aR, type ScanCommandOptions as aS, SCardCommand as aT, ScriptExistsCommand as aU, ScriptFlushCommand as aV, ScriptLoadCommand as aW, SDiffCommand as aX, SDiffStoreCommand as aY, SetCommand as aZ, type SetCommandOptions as a_, JsonDelCommand as aa, JsonForgetCommand as ab, JsonGetCommand as ac, JsonMGetCommand as ad, JsonNumIncrByCommand as ae, JsonNumMultByCommand as af, JsonObjKeysCommand as ag, JsonObjLenCommand as ah, JsonRespCommand as ai, JsonSetCommand as aj, JsonStrAppendCommand as ak, JsonStrLenCommand as al, JsonToggleCommand as am, JsonTypeCommand as an, KeysCommand as ao, LIndexCommand as ap, LInsertCommand as aq, LLenCommand as ar, LMoveCommand as as, LPopCommand as at, LPushCommand as au, LPushXCommand as av, LRangeCommand as aw, LRemCommand as ax, LSetCommand as ay, LTrimCommand as az, Redis as b, SetExCommand as b0, SetNxCommand as b1, SetRangeCommand as b2, SInterCommand as b3, SInterStoreCommand as b4, SIsMemberCommand as b5, SMembersCommand as b6, SMIsMemberCommand as b7, SMoveCommand as b8, SPopCommand as b9, ZPopMinCommand as bA, ZRangeCommand as bB, type ZRangeCommandOptions as bC, ZRankCommand as bD, ZRemCommand as bE, ZRemRangeByLexCommand as bF, ZRemRangeByRankCommand as bG, ZRemRangeByScoreCommand as bH, ZRevRankCommand as bI, ZScanCommand as bJ, ZScoreCommand as bK, ZUnionCommand as bL, type ZUnionCommandOptions as bM, ZUnionStoreCommand as bN, type ZUnionStoreCommandOptions as bO, SRandMemberCommand as ba, SRemCommand as bb, SScanCommand as bc, StrLenCommand as bd, SUnionCommand as be, SUnionStoreCommand as bf, TimeCommand as bg, TouchCommand as bh, TtlCommand as bi, type Type as bj, TypeCommand as bk, UnlinkCommand as bl, XAddCommand as bm, XRangeCommand as bn, type ScoreMember as bo, type ZAddCommandOptions as bp, ZAddCommand as bq, ZCardCommand as br, ZCountCommand as bs, ZDiffStoreCommand as bt, ZIncrByCommand as bu, ZInterStoreCommand as bv, type ZInterStoreCommandOptions as bw, ZLexCountCommand as bx, ZMScoreCommand as by, ZPopMaxCommand as bz, type UpstashResponse as c, type Requester as d, error as e, BitOpCommand as f, BitPosCommand as g, DecrCommand as h, DecrByCommand as i, DelCommand as j, EvalCommand as k, EvalshaCommand as l, ExistsCommand as m, ExpireCommand as n, ExpireAtCommand as o, FlushDBCommand as p, type GeoAddCommandOptions as q, type GeoMember as r, GeoDistCommand as s, GeoHashCommand as t, GeoPosCommand as u, GeoSearchCommand as v, GeoSearchStoreCommand as w, GetCommand as x, GetBitCommand as y, GetDelCommand as z };