@upstash/redis 0.0.0-ci.d3170677a5859e31d40407781286bdf17d64ca72-20250220114636 → 0.0.0-ci.d3985e1d3f7f296ee10dff2746b51fa88dddc9a9-20251222113217

package/{zmscore-BnJuTB6j.d.ts → zmscore-CSYwsf1L.d.ts}

@@ -77,7 +77,7 @@ type RetryConfig = false | {
      */
     retries?: number;
     /**
-     * A backoff function receives the current retry cound and returns a number in milliseconds to wait before retrying.
+     * A backoff function receives the current retry count and returns a number in milliseconds to wait before retrying.
      *
      * @default
      * ```ts
@@ -86,6 +86,9 @@ type RetryConfig = false | {
      */
     backoff?: (retryCount: number) => number;
 };
+type Options$1 = {
+    backend?: string;
+};
 type RequesterConfig = {
     /**
      * Configure the retry behaviour in case of network errors
@@ -120,6 +123,19 @@ type RequesterConfig = {
      */
     cache?: CacheSetting;
 };
+type HttpClientConfig = {
+    headers?: Record<string, string>;
+    baseUrl: string;
+    options?: Options$1;
+    retry?: RetryConfig;
+    agent?: any;
+    signal?: AbortSignal | (() => AbortSignal);
+    keepAlive?: boolean;
+    /**
+     * 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;
+} & RequesterConfig;
 
 type Serialize = (data: unknown) => string | number | boolean;
 type Deserialize<TResult, TData> = (result: TResult) => TData;
@@ -271,18 +287,6 @@ declare class ScriptFlushCommand extends Command<"OK", "OK"> {
     constructor([opts]: [opts?: ScriptFlushCommandOptions], cmdOpts?: CommandOptions<"OK", "OK">);
 }
 
-type ScanCommandOptions = {
-    match?: string;
-    count?: number;
-    type?: string;
-};
-/**
- * @see https://redis.io/commands/scan
- */
-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 = {
     nx?: boolean;
     xx?: never;
@@ -308,6 +312,11 @@ declare class GeoAddCommand<TMemberType = string> extends Command<number | null,
     ], opts?: CommandOptions<number | null, number | null>);
 }
 
+type ExpireOption = "NX" | "nx" | "XX" | "xx" | "GT" | "gt" | "LT" | "lt";
+declare class ExpireCommand extends Command<"0" | "1", 0 | 1> {
+    constructor(cmd: [key: string, seconds: number, option?: ExpireOption], opts?: CommandOptions<"0" | "1", 0 | 1>);
+}
+
 /**
  * @see https://redis.io/commands/append
  */
@@ -404,6 +413,13 @@ declare class EchoCommand extends Command<string, string> {
     constructor(cmd: [message: string], opts?: CommandOptions<string, string>);
 }
 
+/**
+ * @see https://redis.io/commands/eval_ro
+ */
+declare class EvalROCommand<TArgs extends unknown[], TData> extends Command<unknown, TData> {
+    constructor([script, keys, args]: [script: string, keys: string[], args: TArgs], opts?: CommandOptions<unknown, TData>);
+}
+
 /**
  * @see https://redis.io/commands/eval
  */
@@ -411,6 +427,13 @@ declare class EvalCommand<TArgs extends unknown[], TData> extends Command<unknow
     constructor([script, keys, args]: [script: string, keys: string[], args: TArgs], opts?: CommandOptions<unknown, TData>);
 }
 
+/**
+ * @see https://redis.io/commands/evalsha_ro
+ */
+declare class EvalshaROCommand<TArgs extends unknown[], TData> extends Command<unknown, TData> {
+    constructor([sha, keys, args]: [sha: string, keys: string[], args?: TArgs], opts?: CommandOptions<unknown, TData>);
+}
+
 /**
  * @see https://redis.io/commands/evalsha
  */
@@ -425,16 +448,11 @@ declare class ExistsCommand extends Command<number, number> {
     constructor(cmd: [...keys: string[]], opts?: CommandOptions<number, number>);
 }
 
-type ExpireOptions = "NX" | "nx" | "XX" | "xx" | "GT" | "gt" | "LT" | "lt";
-declare class ExpireCommand extends Command<"0" | "1", 0 | 1> {
-    constructor(cmd: [key: string, seconds: number, option?: ExpireOptions], opts?: CommandOptions<"0" | "1", 0 | 1>);
-}
-
 /**
  * @see https://redis.io/commands/expireat
  */
 declare class ExpireAtCommand extends Command<"0" | "1", 0 | 1> {
-    constructor(cmd: [key: string, unix: number], opts?: CommandOptions<"0" | "1", 0 | 1>);
+    constructor(cmd: [key: string, unix: number, option?: ExpireOption], opts?: CommandOptions<"0" | "1", 0 | 1>);
 }
 
 /**
@@ -681,6 +699,58 @@ declare class HExistsCommand extends Command<number, number> {
     constructor(cmd: [key: string, field: string], opts?: CommandOptions<number, number>);
 }
 
+declare class HExpireCommand extends Command<(-2 | 0 | 1 | 2)[], (-2 | 0 | 1 | 2)[]> {
+    constructor(cmd: [
+        key: string,
+        fields: (string | number) | (string | number)[],
+        seconds: number,
+        option?: ExpireOption
+    ], opts?: CommandOptions<(-2 | 0 | 1 | 2)[], (-2 | 0 | 1 | 2)[]>);
+}
+
+declare class HExpireAtCommand extends Command<(-2 | 0 | 1 | 2)[], (-2 | 0 | 1 | 2)[]> {
+    constructor(cmd: [
+        key: string,
+        fields: (string | number) | (string | number)[],
+        timestamp: number,
+        option?: ExpireOption
+    ], opts?: CommandOptions<(-2 | 0 | 1 | 2)[], (-2 | 0 | 1 | 2)[]>);
+}
+
+declare class HExpireTimeCommand extends Command<number[], number[]> {
+    constructor(cmd: [key: string, fields: (string | number) | (string | number)[]], opts?: CommandOptions<number[], number[]>);
+}
+
+declare class HPersistCommand extends Command<(-2 | -1 | 1)[], (-2 | -1 | 1)[]> {
+    constructor(cmd: [key: string, fields: (string | number) | (string | number)[]], opts?: CommandOptions<(-2 | -1 | 1)[], (-2 | -1 | 1)[]>);
+}
+
+declare class HPExpireCommand extends Command<(-2 | 0 | 1 | 2)[], (-2 | 0 | 1 | 2)[]> {
+    constructor(cmd: [
+        key: string,
+        fields: (string | number) | (string | number)[],
+        milliseconds: number,
+        option?: ExpireOption
+    ], opts?: CommandOptions<(-2 | 0 | 1 | 2)[], (-2 | 0 | 1 | 2)[]>);
+}
+
+declare class HPExpireAtCommand extends Command<(-2 | 0 | 1 | 2)[], (-2 | 0 | 1 | 2)[]> {
+    constructor(cmd: [
+        key: string,
+        fields: (string | number) | (string | number)[],
+        timestamp: number,
+        option?: ExpireOption
+    ], opts?: CommandOptions<(-2 | 0 | 1 | 2)[], (-2 | 0 | 1 | 2)[]>);
+}
+
+declare class HPExpireTimeCommand extends Command<number[], number[]> {
+    constructor(cmd: [key: string, fields: (string | number) | (string | number)[]], opts?: CommandOptions<number[], number[]>);
+}
+
+declare class HPTtlCommand extends Command<number[], number[]> {
+    constructor(cmd: [key: string, fields: (string | number) | (string | number)[]], opts?: CommandOptions<number[], number[]>);
+}
+
 /**
  * @see https://redis.io/commands/hget
  */
@@ -754,6 +824,39 @@ declare class HRandFieldCommand<TData extends string | string[] | Record<string,
     constructor(cmd: [key: string, count: number, withValues: boolean], opts?: CommandOptions<string[], Partial<TData>>);
 }
 
+type ScanCommandOptionsStandard = {
+    match?: string;
+    count?: number;
+    type?: string;
+    withType?: false;
+};
+type ScanCommandOptionsWithType = {
+    match?: string;
+    count?: number;
+    /**
+     * Includes types of each key in the result
+     *
+     * @example
+     * ```typescript
+     * await redis.scan("0", { withType: true })
+     * // ["0", [{ key: "key1", type: "string" }, { key: "key2", type: "list" }]]
+     * ```
+     */
+    withType: true;
+};
+type ScanCommandOptions = ScanCommandOptionsStandard | ScanCommandOptionsWithType;
+type ScanResultStandard = [string, string[]];
+type ScanResultWithType = [string, {
+    key: string;
+    type: string;
+}[]];
+/**
+ * @see https://redis.io/commands/scan
+ */
+declare class ScanCommand<TData = ScanResultStandard> extends Command<[string, string[]], TData> {
+    constructor([cursor, opts]: [cursor: string | number, opts?: ScanCommandOptions], cmdOpts?: CommandOptions<[string, string[]], TData>);
+}
+
 /**
  * @see https://redis.io/commands/hscan
  */
@@ -788,6 +891,10 @@ declare class HStrLenCommand extends Command<number, number> {
     constructor(cmd: [key: string, field: string], opts?: CommandOptions<number, number>);
 }
 
+declare class HTtlCommand extends Command<number[], number[]> {
+    constructor(cmd: [key: string, fields: (string | number) | (string | number)[]], opts?: CommandOptions<number[], number[]>);
+}
+
 /**
  * @see https://redis.io/commands/hvals
  */
@@ -894,6 +1001,13 @@ declare class JsonGetCommand<TData extends (unknown | Record<string, unknown>) |
     ] | [key: string, ...path: string[]], opts?: CommandOptions<TData | null, TData | null>);
 }
 
+/**
+ * @see https://redis.io/commands/json.merge
+ */
+declare class JsonMergeCommand<TData extends string | number | Record<string, unknown> | Array<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.mget
  */
@@ -1096,14 +1210,14 @@ declare class PersistCommand extends Command<"0" | "1", 0 | 1> {
  * @see https://redis.io/commands/pexpire
  */
 declare class PExpireCommand extends Command<"0" | "1", 0 | 1> {
-    constructor(cmd: [key: string, milliseconds: number], opts?: CommandOptions<"0" | "1", 0 | 1>);
+    constructor(cmd: [key: string, milliseconds: number, option?: ExpireOption], opts?: CommandOptions<"0" | "1", 0 | 1>);
 }
 
 /**
  * @see https://redis.io/commands/pexpireat
  */
 declare class PExpireAtCommand extends Command<"0" | "1", 0 | 1> {
-    constructor(cmd: [key: string, unix: number], opts?: CommandOptions<"0" | "1", 0 | 1>);
+    constructor(cmd: [key: string, unix: number, option?: ExpireOption], opts?: CommandOptions<"0" | "1", 0 | 1>);
 }
 
 /**
@@ -1463,16 +1577,33 @@ type XReadCommandOptions = [
     id: string | string[],
     options?: {
         count?: number;
+        /**
+         * @deprecated block is not yet supported in Upstash Redis
+         */
         blockMS?: number;
     }
 ];
-type XReadOptions = XReadCommandOptions extends [infer K, infer I, ...any[]] ? K extends string ? I extends string ? [key: string, id: string, options?: {
-    count?: number;
-    blockMS?: number;
-}] : never : K extends string[] ? I extends string[] ? [key: string[], id: string[], options?: {
-    count?: number;
-    blockMS?: number;
-}] : never : never : never;
+type XReadOptions = XReadCommandOptions extends [infer K, infer I, ...any[]] ? K extends string ? I extends string ? [
+    key: string,
+    id: string,
+    options?: {
+        count?: number;
+        /**
+         * @deprecated block is not yet supported in Upstash Redis
+         */
+        blockMS?: number;
+    }
+] : never : K extends string[] ? I extends string[] ? [
+    key: string[],
+    id: string[],
+    options?: {
+        count?: number;
+        /**
+         * @deprecated block is not yet supported in Upstash Redis
+         */
+        blockMS?: number;
+    }
+] : never : never : never;
 /**
  * @see https://redis.io/commands/xread
  */
@@ -1482,6 +1613,9 @@ declare class XReadCommand extends Command<number, unknown[]> {
 
 type Options = {
     count?: number;
+    /**
+     * @deprecated block is not yet supported in Upstash Redis
+     */
     blockMS?: number;
     NOACK?: boolean;
 };
@@ -1659,7 +1793,11 @@ declare class ZRemRangeByRankCommand extends Command<number, number> {
  * @see https://redis.io/commands/zremrangebyscore
  */
 declare class ZRemRangeByScoreCommand extends Command<number, number> {
-    constructor(cmd: [key: string, min: number, max: number], opts?: CommandOptions<number, number>);
+    constructor(cmd: [
+        key: string,
+        min: number | `(${number}` | "-inf" | "+inf",
+        max: number | `(${number}` | "-inf" | "+inf"
+    ], opts?: CommandOptions<number, number>);
 }
 
 /**
@@ -1689,23 +1827,38 @@ declare class ZScoreCommand<TData> extends Command<string | null, number | null>
     constructor(cmd: [key: string, member: TData], opts?: CommandOptions<string | null, number | null>);
 }
 
-type MessageEvent = {
-    type: string;
-    data: any;
-    channel?: string;
-    pattern?: string;
+type BaseMessageData<TMessage> = {
+    channel: string;
+    message: TMessage;
+};
+type PatternMessageData<TMessage> = BaseMessageData<TMessage> & {
+    pattern: string;
 };
-type Listener = (event: MessageEvent["data"]) => void;
-declare class Subscriber extends EventTarget {
+type SubscriptionCountEvent = number;
+type MessageEventMap<TMessage> = {
+    message: BaseMessageData<TMessage>;
+    subscribe: SubscriptionCountEvent;
+    unsubscribe: SubscriptionCountEvent;
+    pmessage: PatternMessageData<TMessage>;
+    psubscribe: SubscriptionCountEvent;
+    punsubscribe: SubscriptionCountEvent;
+    error: Error;
+    [key: `message:${string}`]: BaseMessageData<TMessage>;
+    [key: `pmessage:${string}`]: PatternMessageData<TMessage>;
+};
+type EventType = keyof MessageEventMap<any>;
+type Listener<TMessage, T extends EventType> = (event: MessageEventMap<TMessage>[T]) => void;
+declare class Subscriber<TMessage = any> extends EventTarget {
     private subscriptions;
     private client;
     private listeners;
-    constructor(client: Requester, channels: string[], isPattern?: boolean);
+    private opts?;
+    constructor(client: Requester, channels: string[], isPattern?: boolean, opts?: Pick<RedisOptions, "automaticDeserialization">);
     private subscribeToChannel;
     private subscribeToPattern;
     private handleMessage;
     private dispatchToListeners;
-    on(type: string, listener: Listener): void;
+    on<T extends keyof MessageEventMap<TMessage>>(type: T, listener: Listener<TMessage, T>): void;
     removeAllListeners(): void;
     unsubscribe(channels?: string[]): Promise<void>;
     getSubscribedChannels(): string[];
@@ -1871,10 +2024,18 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
      * @see https://redis.io/commands/echo
      */
     echo: (message: string) => Pipeline<[...TCommands, Command<any, string>]>;
+    /**
+     * @see https://redis.io/commands/eval_ro
+     */
+    evalRo: <TArgs extends unknown[], TData = unknown>(script: string, keys: string[], args: TArgs) => Pipeline<[...TCommands, Command<any, TData>]>;
     /**
      * @see https://redis.io/commands/eval
      */
     eval: <TArgs extends unknown[], TData = unknown>(script: string, keys: string[], args: TArgs) => Pipeline<[...TCommands, Command<any, TData>]>;
+    /**
+     * @see https://redis.io/commands/evalsha_ro
+     */
+    evalshaRo: <TArgs extends unknown[], TData = unknown>(sha1: string, keys: string[], args: TArgs) => Pipeline<[...TCommands, Command<any, TData>]>;
     /**
      * @see https://redis.io/commands/evalsha
      */
@@ -1886,11 +2047,11 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/expire
      */
-    expire: (key: string, seconds: number, option?: ("NX" | "nx" | "XX" | "xx" | "GT" | "gt" | "LT" | "lt") | undefined) => Pipeline<[...TCommands, Command<any, 0 | 1>]>;
+    expire: (key: string, seconds: number, option?: ExpireOption | undefined) => Pipeline<[...TCommands, Command<any, 0 | 1>]>;
     /**
      * @see https://redis.io/commands/expireat
      */
-    expireat: (key: string, unix: number) => Pipeline<[...TCommands, Command<any, 0 | 1>]>;
+    expireat: (key: string, unix: number, option?: ExpireOption | undefined) => Pipeline<[...TCommands, Command<any, 0 | 1>]>;
     /**
      * @see https://redis.io/commands/flushall
      */
@@ -2059,6 +2220,42 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
      * @see https://redis.io/commands/hexists
      */
     hexists: (key: string, field: string) => Pipeline<[...TCommands, Command<any, number>]>;
+    /**
+     * @see https://redis.io/commands/hexpire
+     */
+    hexpire: (key: string, fields: string | number | (string | number)[], seconds: number, option?: ExpireOption | undefined) => Pipeline<[...TCommands, Command<any, (0 | 1 | 2 | -2)[]>]>;
+    /**
+     * @see https://redis.io/commands/hexpireat
+     */
+    hexpireat: (key: string, fields: string | number | (string | number)[], timestamp: number, option?: ExpireOption | undefined) => Pipeline<[...TCommands, Command<any, (0 | 1 | 2 | -2)[]>]>;
+    /**
+     * @see https://redis.io/commands/hexpiretime
+     */
+    hexpiretime: (key: string, fields: string | number | (string | number)[]) => Pipeline<[...TCommands, Command<any, number[]>]>;
+    /**
+     * @see https://redis.io/commands/httl
+     */
+    httl: (key: string, fields: string | number | (string | number)[]) => Pipeline<[...TCommands, Command<any, number[]>]>;
+    /**
+     * @see https://redis.io/commands/hpexpire
+     */
+    hpexpire: (key: string, fields: string | number | (string | number)[], milliseconds: number, option?: ExpireOption | undefined) => Pipeline<[...TCommands, Command<any, (0 | 1 | 2 | -2)[]>]>;
+    /**
+     * @see https://redis.io/commands/hpexpireat
+     */
+    hpexpireat: (key: string, fields: string | number | (string | number)[], timestamp: number, option?: ExpireOption | undefined) => Pipeline<[...TCommands, Command<any, (0 | 1 | 2 | -2)[]>]>;
+    /**
+     * @see https://redis.io/commands/hpexpiretime
+     */
+    hpexpiretime: (key: string, fields: string | number | (string | number)[]) => Pipeline<[...TCommands, Command<any, number[]>]>;
+    /**
+     * @see https://redis.io/commands/hpttl
+     */
+    hpttl: (key: string, fields: string | number | (string | number)[]) => Pipeline<[...TCommands, Command<any, number[]>]>;
+    /**
+     * @see https://redis.io/commands/hpersist
+     */
+    hpersist: (key: string, fields: string | number | (string | number)[]) => Pipeline<[...TCommands, Command<any, (1 | -2 | -1)[]>]>;
     /**
      * @see https://redis.io/commands/hget
      */
@@ -2206,11 +2403,11 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/pexpire
      */
-    pexpire: (key: string, milliseconds: number) => Pipeline<[...TCommands, Command<any, 0 | 1>]>;
+    pexpire: (key: string, milliseconds: number, option?: ExpireOption | undefined) => Pipeline<[...TCommands, Command<any, 0 | 1>]>;
     /**
      * @see https://redis.io/commands/pexpireat
      */
-    pexpireat: (key: string, unix: number) => Pipeline<[...TCommands, Command<any, 0 | 1>]>;
+    pexpireat: (key: string, unix: number, option?: ExpireOption | undefined) => Pipeline<[...TCommands, Command<any, 0 | 1>]>;
     /**
      * @see https://redis.io/commands/pfadd
      */
@@ -2270,7 +2467,7 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/scan
      */
-    scan: (cursor: string | number, opts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, [string, string[]]>]>;
+    scan: (cursor: string | number, opts?: ScanCommandOptions | undefined) => Pipeline<[...TCommands, Command<any, any>]>;
     /**
      * @see https://redis.io/commands/scard
      */
@@ -2567,7 +2764,7 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
     /**
      * @see https://redis.io/commands/zremrangebyscore
      */
-    zremrangebyscore: (key: string, min: number, max: number) => Pipeline<[...TCommands, Command<any, number>]>;
+    zremrangebyscore: (key: string, min: number | `(${number}` | "-inf" | "+inf", max: number | `(${number}` | "-inf" | "+inf") => Pipeline<[...TCommands, Command<any, number>]>;
     /**
      * @see https://redis.io/commands/zrevrank
      */
@@ -2632,6 +2829,10 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
          * @see https://redis.io/commands/json.get
          */
         get: (...args: CommandArgs<typeof JsonGetCommand>) => Pipeline<[...TCommands, Command<any, any>]>;
+        /**
+         * @see https://redis.io/commands/json.merge
+         */
+        merge: (key: string, path: string, value: string | number | unknown[] | Record<string, unknown>) => Pipeline<[...TCommands, Command<any, "OK" | null>]>;
         /**
          * @see https://redis.io/commands/json.mget
          */
@@ -2687,6 +2888,58 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
          */
         type: (key: string, path?: string | undefined) => Pipeline<[...TCommands, Command<any, string[]>]>;
     };
+    get functions(): {
+        /**
+         * @see https://redis.io/docs/latest/commands/function-load/
+         */
+        load: (args_0: {
+            code: string;
+            replace?: boolean;
+        }) => Pipeline<[...TCommands, Command<any, string>]>;
+        /**
+         * @see https://redis.io/docs/latest/commands/function-list/
+         */
+        list: (args?: {
+            libraryName?: string;
+            withCode?: boolean;
+        } | undefined) => Pipeline<[...TCommands, Command<any, {
+            libraryName: string;
+            engine: string;
+            functions: {
+                name: string;
+                description?: string;
+                flags: string[];
+            }[];
+            libraryCode?: string;
+        }[]>]>;
+        /**
+         * @see https://redis.io/docs/latest/commands/function-delete/
+         */
+        delete: (libraryName: string) => Pipeline<[...TCommands, Command<any, "OK">]>;
+        /**
+         * @see https://redis.io/docs/latest/commands/function-flush/
+         */
+        flush: () => Pipeline<[...TCommands, Command<any, "OK">]>;
+        /**
+         * @see https://redis.io/docs/latest/commands/function-stats/
+         */
+        stats: () => Pipeline<[...TCommands, Command<any, {
+            engines: {
+                [k: string]: {
+                    librariesCount: unknown;
+                    functionsCount: unknown;
+                };
+            };
+        }>]>;
+        /**
+         * @see https://redis.io/docs/latest/commands/fcall/
+         */
+        call: <TData = unknown>(fn: string, keys?: string[] | undefined, args?: string[] | undefined) => Pipeline<[...TCommands, Command<any, TData>]>;
+        /**
+         * @see https://redis.io/docs/latest/commands/fcall_ro/
+         */
+        callRo: <TData = unknown>(fn: string, keys?: string[] | undefined, args?: string[] | undefined) => Pipeline<[...TCommands, Command<any, TData>]>;
+    };
 }
 
 /**
@@ -2707,9 +2960,20 @@ declare class Pipeline<TCommands extends Command<any, any>[] = []> {
  */
 declare class Script<TResult = unknown> {
     readonly script: string;
-    readonly sha1: string;
+    /**
+     * @deprecated This property is initialized to an empty string and will be set in the init method
+     * asynchronously. Do not use this property immidiately after the constructor.
+     *
+     * This property is only exposed for backwards compatibility and will be removed in the
+     * future major release.
+     */
+    sha1: string;
     private readonly redis;
     constructor(redis: Redis, script: string);
+    /**
+     * Initialize the script by computing its SHA-1 hash.
+     */
+    private init;
     /**
      * Send an `EVAL` command to redis.
      */
@@ -2731,6 +2995,56 @@ declare class Script<TResult = unknown> {
     private digest;
 }
 
+/**
+ * Creates a new script.
+ *
+ * Scripts offer the ability to optimistically try to execute a script without having to send the
+ * entire script to the server. If the script is loaded on the server, it tries again by sending
+ * the entire script. Afterwards, the script is cached on the server.
+ *
+ * @example
+ * ```ts
+ * const redis = new Redis({...})
+ *
+ * const script = redis.createScript<string>("return ARGV[1];", { readOnly: true })
+ * const arg1 = await script.evalRo([], ["Hello World"])
+ * expect(arg1, "Hello World")
+ * ```
+ */
+declare class ScriptRO<TResult = unknown> {
+    readonly script: string;
+    /**
+     * @deprecated This property is initialized to an empty string and will be set in the init method
+     * asynchronously. Do not use this property immidiately after the constructor.
+     *
+     * This property is only exposed for backwards compatibility and will be removed in the
+     * future major release.
+     */
+    sha1: string;
+    private readonly redis;
+    constructor(redis: Redis, script: string);
+    private init;
+    /**
+     * Send an `EVAL_RO` command to redis.
+     */
+    evalRo(keys: string[], args: string[]): Promise<TResult>;
+    /**
+     * Calculates the sha1 hash of the script and then calls `EVALSHA_RO`.
+     */
+    evalshaRo(keys: string[], args: string[]): Promise<TResult>;
+    /**
+     * Optimistically try to run `EVALSHA_RO` first.
+     * If the script is not loaded in redis, it will fall back and try again with `EVAL_RO`.
+     *
+     * Following calls will be able to use the cached script
+     */
+    exec(keys: string[], args: string[]): Promise<TResult>;
+    /**
+     * Compute the sha1 hash of the script and return its hex representation.
+     */
+    private digest;
+}
+
 /**
  * Serverless redis client for upstash.
  */
@@ -2794,6 +3108,10 @@ declare class Redis {
          * @see https://redis.io/commands/json.get
          */
         get: <TData>(...args: CommandArgs<typeof JsonGetCommand>) => Promise<TData | null>;
+        /**
+         * @see https://redis.io/commands/json.merge
+         */
+        merge: (key: string, path: string, value: string | number | unknown[] | Record<string, unknown>) => Promise<"OK" | null>;
         /**
          * @see https://redis.io/commands/json.mget
          */
@@ -2849,6 +3167,60 @@ declare class Redis {
          */
         type: (key: string, path?: string | undefined) => Promise<string[]>;
     };
+    get functions(): {
+        /**
+         * @see https://redis.io/docs/latest/commands/function-load/
+         */
+        load: (args_0: {
+            code: string;
+            replace?: boolean;
+        }) => Promise<string>;
+        /**
+         * @see https://redis.io/docs/latest/commands/function-list/
+         */
+        list: (args?: {
+            libraryName?: string;
+            withCode?: boolean;
+        } | undefined) => Promise<{
+            libraryName: string;
+            engine: string;
+            functions: {
+                name: string;
+                description?: string;
+                flags: string[];
+            }[];
+            libraryCode?: string;
+        }[]>;
+        /**
+         * @see https://redis.io/docs/latest/commands/function-delete/
+         */
+        delete: (libraryName: string) => Promise<"OK">;
+        /**
+         * @see https://redis.io/docs/latest/commands/function-flush/
+         */
+        flush: () => Promise<"OK">;
+        /**
+         * @see https://redis.io/docs/latest/commands/function-stats/
+         *
+         * Note: `running_script` field is not supported and therefore not included in the type.
+         */
+        stats: () => Promise<{
+            engines: {
+                [k: string]: {
+                    librariesCount: unknown;
+                    functionsCount: unknown;
+                };
+            };
+        }>;
+        /**
+         * @see https://redis.io/docs/latest/commands/fcall/
+         */
+        call: <TData = unknown>(fn: string, keys?: string[] | undefined, args?: string[] | undefined) => Promise<TData>;
+        /**
+         * @see https://redis.io/docs/latest/commands/fcall_ro/
+         */
+        callRo: <TData = unknown>(fn: string, keys?: string[] | undefined, args?: string[] | undefined) => Promise<TData>;
+    };
     /**
      * Wrap a new middleware around the HTTP client.
      */
@@ -2857,7 +3229,37 @@ declare class Redis {
      * Technically this is not private, we can hide it from intellisense by doing this
      */
     protected addTelemetry: (telemetry: Telemetry) => void;
-    createScript(script: string): Script;
+    /**
+     * Creates a new script.
+     *
+     * Scripts offer the ability to optimistically try to execute a script without having to send the
+     * entire script to the server. If the script is loaded on the server, it tries again by sending
+     * the entire script. Afterwards, the script is cached on the server.
+     *
+     * @param script - The script to create
+     * @param opts - Optional options to pass to the script `{ readonly?: boolean }`
+     * @returns A new script
+     *
+     * @example
+     * ```ts
+     * const redis = new Redis({...})
+     *
+     * const script = redis.createScript<string>("return ARGV[1];")
+     * const arg1 = await script.eval([], ["Hello World"])
+     * expect(arg1, "Hello World")
+     * ```
+     * @example
+     * ```ts
+     * const redis = new Redis({...})
+     *
+     * const script = redis.createScript<string>("return ARGV[1];", { readonly: true })
+     * const arg1 = await script.evalRo([], ["Hello World"])
+     * expect(arg1, "Hello World")
+     * ```
+     */
+    createScript<TResult = unknown, TReadonly extends boolean = false>(script: string, opts?: {
+        readonly?: TReadonly;
+    }): TReadonly extends true ? ScriptRO<TResult> : Script<TResult>;
     /**
      * Create a new pipeline that allows you to send requests in bulk.
      *
@@ -2936,10 +3338,18 @@ declare class Redis {
      * @see https://redis.io/commands/echo
      */
     echo: (message: string) => Promise<string>;
+    /**
+     * @see https://redis.io/commands/eval_ro
+     */
+    evalRo: <TArgs extends unknown[], TData = unknown>(script: string, keys: string[], args: TArgs) => Promise<TData>;
     /**
      * @see https://redis.io/commands/eval
      */
     eval: <TArgs extends unknown[], TData = unknown>(script: string, keys: string[], args: TArgs) => Promise<TData>;
+    /**
+     * @see https://redis.io/commands/evalsha_ro
+     */
+    evalshaRo: <TArgs extends unknown[], TData = unknown>(sha1: string, keys: string[], args: TArgs) => Promise<TData>;
     /**
      * @see https://redis.io/commands/evalsha
      */
@@ -2955,11 +3365,11 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/expire
      */
-    expire: (key: string, seconds: number, option?: ("NX" | "nx" | "XX" | "xx" | "GT" | "gt" | "LT" | "lt") | undefined) => Promise<0 | 1>;
+    expire: (key: string, seconds: number, option?: ExpireOption | undefined) => Promise<0 | 1>;
     /**
      * @see https://redis.io/commands/expireat
      */
-    expireat: (key: string, unix: number) => Promise<0 | 1>;
+    expireat: (key: string, unix: number, option?: ExpireOption | undefined) => Promise<0 | 1>;
     /**
      * @see https://redis.io/commands/flushall
      */
@@ -3128,6 +3538,42 @@ declare class Redis {
      * @see https://redis.io/commands/hexists
      */
     hexists: (key: string, field: string) => Promise<number>;
+    /**
+     * @see https://redis.io/commands/hexpire
+     */
+    hexpire: (key: string, fields: string | number | (string | number)[], seconds: number, option?: ExpireOption | undefined) => Promise<(0 | 1 | 2 | -2)[]>;
+    /**
+     * @see https://redis.io/commands/hexpireat
+     */
+    hexpireat: (key: string, fields: string | number | (string | number)[], timestamp: number, option?: ExpireOption | undefined) => Promise<(0 | 1 | 2 | -2)[]>;
+    /**
+     * @see https://redis.io/commands/hexpiretime
+     */
+    hexpiretime: (key: string, fields: string | number | (string | number)[]) => Promise<number[]>;
+    /**
+     * @see https://redis.io/commands/httl
+     */
+    httl: (key: string, fields: string | number | (string | number)[]) => Promise<number[]>;
+    /**
+     * @see https://redis.io/commands/hpexpire
+     */
+    hpexpire: (key: string, fields: string | number | (string | number)[], milliseconds: number, option?: ExpireOption | undefined) => Promise<(0 | 1 | 2 | -2)[]>;
+    /**
+     * @see https://redis.io/commands/hpexpireat
+     */
+    hpexpireat: (key: string, fields: string | number | (string | number)[], timestamp: number, option?: ExpireOption | undefined) => Promise<(0 | 1 | 2 | -2)[]>;
+    /**
+     * @see https://redis.io/commands/hpexpiretime
+     */
+    hpexpiretime: (key: string, fields: string | number | (string | number)[]) => Promise<number[]>;
+    /**
+     * @see https://redis.io/commands/hpttl
+     */
+    hpttl: (key: string, fields: string | number | (string | number)[]) => Promise<number[]>;
+    /**
+     * @see https://redis.io/commands/hpersist
+     */
+    hpersist: (key: string, fields: string | number | (string | number)[]) => Promise<(1 | -2 | -1)[]>;
     /**
      * @see https://redis.io/commands/hget
      */
@@ -3279,11 +3725,11 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/pexpire
      */
-    pexpire: (key: string, milliseconds: number) => Promise<0 | 1>;
+    pexpire: (key: string, milliseconds: number, option?: ExpireOption | undefined) => Promise<0 | 1>;
     /**
      * @see https://redis.io/commands/pexpireat
      */
-    pexpireat: (key: string, unix: number) => Promise<0 | 1>;
+    pexpireat: (key: string, unix: number, option?: ExpireOption | undefined) => Promise<0 | 1>;
     /**
      * @see https://redis.io/commands/pfadd
      */
@@ -3304,7 +3750,10 @@ declare class Redis {
      * @see https://redis.io/commands/psetex
      */
     psetex: <TData>(key: string, ttl: number, value: TData) => Promise<string>;
-    psubscribe: (patterns: string | string[]) => Subscriber;
+    /**
+     * @see https://redis.io/commands/psubscribe
+     */
+    psubscribe: <TMessage>(patterns: string | string[]) => Subscriber<TMessage>;
     /**
      * @see https://redis.io/commands/pttl
      */
@@ -3344,7 +3793,10 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/scan
      */
-    scan: (cursor: string | number, opts?: ScanCommandOptions | undefined) => Promise<[string, string[]]>;
+    scan(cursor: string | number): Promise<ScanResultStandard>;
+    scan<TOptions extends ScanCommandOptions>(cursor: string | number, opts: TOptions): Promise<TOptions extends {
+        withType: true;
+    } ? ScanResultWithType : ScanResultStandard>;
     /**
      * @see https://redis.io/commands/scard
      */
@@ -3436,7 +3888,7 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/subscribe
      */
-    subscribe: (channels: string | string[]) => Subscriber;
+    subscribe: <TMessage>(channels: string | string[]) => Subscriber<TMessage>;
     /**
      * @see https://redis.io/commands/sunion
      */
@@ -3652,7 +4104,7 @@ declare class Redis {
     /**
      * @see https://redis.io/commands/zremrangebyscore
      */
-    zremrangebyscore: (key: string, min: number, max: number) => Promise<number>;
+    zremrangebyscore: (key: string, min: number | `(${number}` | "-inf" | "+inf", max: number | `(${number}` | "-inf" | "+inf") => Promise<number>;
     /**
      * @see https://redis.io/commands/zrevrank
      */
@@ -3675,22 +4127,28 @@ declare class Redis {
     zunionstore: (destination: string, numKeys: number, keys: string[], opts?: ZUnionStoreCommandOptions | undefined) => Promise<number>;
 }
 
+type UpstashErrorOptions = Pick<NonNullable<ConstructorParameters<typeof Error>[1]>, "cause">;
 /**
  * Result of a bad request to upstash
  */
 declare class UpstashError extends Error {
-    constructor(message: string);
+    constructor(message: string, options?: ErrorOptions);
 }
 declare class UrlError extends Error {
     constructor(url: string);
 }
+declare class UpstashJSONParseError extends UpstashError {
+    constructor(body: string, options?: UpstashErrorOptions);
+}
 
 type error_UpstashError = UpstashError;
 declare const error_UpstashError: typeof UpstashError;
+type error_UpstashJSONParseError = UpstashJSONParseError;
+declare const error_UpstashJSONParseError: typeof UpstashJSONParseError;
 type error_UrlError = UrlError;
 declare const error_UrlError: typeof UrlError;
 declare namespace error {
-  export { error_UpstashError as UpstashError, error_UrlError as UrlError };
+  export { error_UpstashError as UpstashError, error_UpstashJSONParseError as UpstashJSONParseError, error_UrlError as UrlError };
 }
 
 /**
@@ -3707,4 +4165,4 @@ declare class ZMScoreCommand<TData> extends Command<string[] | null, number[] |
     constructor(cmd: [key: string, members: TData[]], opts?: CommandOptions<string[] | null, number[] | null>);
 }
 
-export { HStrLenCommand as $, AppendCommand as A, BitCountCommand as B, CopyCommand as C, DBSizeCommand as D, EchoCommand as E, FlushAllCommand as F, GeoAddCommand as G, GetExCommand as H, GetRangeCommand as I, GetSetCommand as J, HDelCommand as K, HExistsCommand as L, HGetCommand as M, HGetAllCommand as N, HIncrByCommand as O, Pipeline as P, HIncrByFloatCommand as Q, type RedisOptions as R, HKeysCommand as S, HLenCommand as T, type UpstashRequest as U, HMGetCommand as V, HMSetCommand as W, HRandFieldCommand as X, HScanCommand as Y, HSetCommand as Z, HSetNXCommand as _, type RequesterConfig as a, type SetCommandOptions as a$, HValsCommand as a0, IncrCommand as a1, IncrByCommand as a2, IncrByFloatCommand as a3, JsonArrAppendCommand as a4, JsonArrIndexCommand as a5, JsonArrInsertCommand as a6, JsonArrLenCommand as a7, JsonArrPopCommand as a8, JsonArrTrimCommand as a9, LTrimCommand as aA, MGetCommand as aB, MSetCommand as aC, MSetNXCommand as aD, PersistCommand as aE, PExpireCommand as aF, PExpireAtCommand as aG, PingCommand as aH, PSetEXCommand as aI, PTtlCommand as aJ, PublishCommand as aK, RandomKeyCommand as aL, RenameCommand as aM, RenameNXCommand as aN, RPopCommand as aO, RPushCommand as aP, RPushXCommand as aQ, SAddCommand as aR, ScanCommand as aS, type ScanCommandOptions as aT, SCardCommand as aU, ScriptExistsCommand as aV, ScriptFlushCommand as aW, ScriptLoadCommand as aX, SDiffCommand as aY, SDiffStoreCommand as aZ, SetCommand as a_, JsonClearCommand as aa, JsonDelCommand as ab, JsonForgetCommand as ac, JsonGetCommand as ad, JsonMGetCommand as ae, JsonNumIncrByCommand as af, JsonNumMultByCommand as ag, JsonObjKeysCommand as ah, JsonObjLenCommand as ai, JsonRespCommand as aj, JsonSetCommand as ak, JsonStrAppendCommand as al, JsonStrLenCommand as am, JsonToggleCommand as an, JsonTypeCommand as ao, KeysCommand as ap, LIndexCommand as aq, LInsertCommand as ar, LLenCommand as as, LMoveCommand as at, LPopCommand as au, LPushCommand as av, LPushXCommand as aw, LRangeCommand as ax, LRemCommand as ay, LSetCommand as az, Redis as b, SetBitCommand as b0, SetExCommand as b1, SetNxCommand as b2, SetRangeCommand as b3, SInterCommand as b4, SInterStoreCommand as b5, SIsMemberCommand as b6, SMembersCommand as b7, SMIsMemberCommand as b8, SMoveCommand as b9, ZPopMaxCommand as bA, ZPopMinCommand as bB, ZRangeCommand as bC, type ZRangeCommandOptions as bD, ZRankCommand as bE, ZRemCommand as bF, ZRemRangeByLexCommand as bG, ZRemRangeByRankCommand as bH, ZRemRangeByScoreCommand as bI, ZRevRankCommand as bJ, ZScanCommand as bK, ZScoreCommand as bL, ZUnionCommand as bM, type ZUnionCommandOptions as bN, ZUnionStoreCommand as bO, type ZUnionStoreCommandOptions as bP, SPopCommand as ba, SRandMemberCommand as bb, SRemCommand as bc, SScanCommand as bd, StrLenCommand as be, SUnionCommand as bf, SUnionStoreCommand as bg, TimeCommand as bh, TouchCommand as bi, TtlCommand as bj, type Type as bk, TypeCommand as bl, UnlinkCommand as bm, XAddCommand as bn, XRangeCommand as bo, type ScoreMember as bp, type ZAddCommandOptions as bq, ZAddCommand as br, ZCardCommand as bs, ZCountCommand as bt, ZDiffStoreCommand as bu, ZIncrByCommand as bv, ZInterStoreCommand as bw, type ZInterStoreCommandOptions as bx, ZLexCountCommand as by, ZMScoreCommand 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 };
+export { HPersistCommand as $, AppendCommand as A, BitCountCommand as B, CopyCommand as C, DBSizeCommand as D, EchoCommand as E, FlushAllCommand as F, GeoAddCommand as G, type HttpClientConfig as H, GetCommand as I, GetBitCommand as J, GetDelCommand as K, GetExCommand as L, GetRangeCommand as M, GetSetCommand as N, HDelCommand as O, Pipeline as P, HExistsCommand as Q, type RedisOptions as R, HExpireCommand as S, HExpireAtCommand as T, type UpstashRequest as U, HExpireTimeCommand as V, HTtlCommand as W, HPExpireCommand as X, HPExpireAtCommand as Y, HPExpireTimeCommand as Z, HPTtlCommand as _, type RequesterConfig as a, RenameNXCommand as a$, HGetCommand as a0, HGetAllCommand as a1, HIncrByCommand as a2, HIncrByFloatCommand as a3, HKeysCommand as a4, HLenCommand as a5, HMGetCommand as a6, HMSetCommand as a7, HRandFieldCommand as a8, HScanCommand as a9, JsonStrLenCommand as aA, JsonToggleCommand as aB, JsonTypeCommand as aC, KeysCommand as aD, LIndexCommand as aE, LInsertCommand as aF, LLenCommand as aG, LMoveCommand as aH, LPopCommand as aI, LPushCommand as aJ, LPushXCommand as aK, LRangeCommand as aL, LRemCommand as aM, LSetCommand as aN, LTrimCommand as aO, MGetCommand as aP, MSetCommand as aQ, MSetNXCommand as aR, PersistCommand as aS, PExpireCommand as aT, PExpireAtCommand as aU, PingCommand as aV, PSetEXCommand as aW, PTtlCommand as aX, PublishCommand as aY, RandomKeyCommand as aZ, RenameCommand as a_, HSetCommand as aa, HSetNXCommand as ab, HStrLenCommand as ac, HValsCommand as ad, IncrCommand as ae, IncrByCommand as af, IncrByFloatCommand as ag, JsonArrAppendCommand as ah, JsonArrIndexCommand as ai, JsonArrInsertCommand as aj, JsonArrLenCommand as ak, JsonArrPopCommand as al, JsonArrTrimCommand as am, JsonClearCommand as an, JsonDelCommand as ao, JsonForgetCommand as ap, JsonGetCommand as aq, JsonMergeCommand as ar, JsonMGetCommand as as, JsonNumIncrByCommand as at, JsonNumMultByCommand as au, JsonObjKeysCommand as av, JsonObjLenCommand as aw, JsonRespCommand as ax, JsonSetCommand as ay, JsonStrAppendCommand as az, Redis as b, type ZUnionCommandOptions as b$, RPopCommand as b0, RPushCommand as b1, RPushXCommand as b2, SAddCommand as b3, ScanCommand as b4, type ScanCommandOptions as b5, SCardCommand as b6, ScriptExistsCommand as b7, ScriptFlushCommand as b8, ScriptLoadCommand as b9, UnlinkCommand as bA, XAddCommand as bB, XRangeCommand as bC, type ScoreMember as bD, type ZAddCommandOptions as bE, ZAddCommand as bF, ZCardCommand as bG, ZCountCommand as bH, ZDiffStoreCommand as bI, ZIncrByCommand as bJ, ZInterStoreCommand as bK, type ZInterStoreCommandOptions as bL, ZLexCountCommand as bM, ZMScoreCommand as bN, ZPopMaxCommand as bO, ZPopMinCommand as bP, ZRangeCommand as bQ, type ZRangeCommandOptions as bR, ZRankCommand as bS, ZRemCommand as bT, ZRemRangeByLexCommand as bU, ZRemRangeByRankCommand as bV, ZRemRangeByScoreCommand as bW, ZRevRankCommand as bX, ZScanCommand as bY, ZScoreCommand as bZ, ZUnionCommand as b_, SDiffCommand as ba, SDiffStoreCommand as bb, SetCommand as bc, type SetCommandOptions as bd, SetBitCommand as be, SetExCommand as bf, SetNxCommand as bg, SetRangeCommand as bh, SInterCommand as bi, SInterStoreCommand as bj, SIsMemberCommand as bk, SMembersCommand as bl, SMIsMemberCommand as bm, SMoveCommand as bn, SPopCommand as bo, SRandMemberCommand as bp, SRemCommand as bq, SScanCommand as br, StrLenCommand as bs, SUnionCommand as bt, SUnionStoreCommand as bu, TimeCommand as bv, TouchCommand as bw, TtlCommand as bx, type Type as by, TypeCommand as bz, type Requester as c, ZUnionStoreCommand as c0, type ZUnionStoreCommandOptions as c1, type UpstashResponse as d, error as e, BitOpCommand as f, BitPosCommand as g, DecrCommand as h, DecrByCommand as i, DelCommand as j, EvalROCommand as k, EvalCommand as l, EvalshaROCommand as m, EvalshaCommand as n, ExistsCommand as o, ExpireCommand as p, type ExpireOption as q, ExpireAtCommand as r, FlushDBCommand as s, type GeoAddCommandOptions as t, type GeoMember as u, GeoDistCommand as v, GeoHashCommand as w, GeoPosCommand as x, GeoSearchCommand as y, GeoSearchStoreCommand as z };