@valkey/valkey-glide 2.0.0 → 2.1.0-rc2

package/build-ts/Batch.d.ts

@@ -8,7 +8,7 @@ ElementAndScore, ExpireOptions, FlushMode, FunctionListOptions, // eslint-disabl
 FunctionRestorePolicy, // eslint-disable-line @typescript-eslint/no-unused-vars
 GeoAddOptions, // eslint-disable-line @typescript-eslint/no-unused-vars
 GeoSearchResultOptions, GeoSearchShape, GeoSearchStoreResultOptions, GeoUnit, GeospatialData, // eslint-disable-line @typescript-eslint/no-unused-vars
-GlideRecord, GlideString, HScanOptions, HashDataType, InfoOptions, InsertPosition, KeyWeight, LPosOptions, ListDirection, LolwutOptions, // eslint-disable-line @typescript-eslint/no-unused-vars
+GlideRecord, GlideString, HExpireOptions, HGetExOptions, HScanOptions, HSetExOptions, HashDataType, InfoOptions, InsertPosition, KeyWeight, LPosOptions, ListDirection, LolwutOptions, // eslint-disable-line @typescript-eslint/no-unused-vars
 RangeByIndex, RangeByLex, RangeByScore, // eslint-disable-line @typescript-eslint/no-unused-vars
 RestoreOptions, Score, ScoreFilter, SearchOrigin, SetOptions, SortOptions, StreamAddOptions, StreamClaimOptions, StreamGroupOptions, StreamPendingOptions, StreamReadGroupOptions, StreamReadOptions, StreamTrimOptions, TimeUnit, ZAddOptions, ZScanOptions } from ".";
 import { command_request } from "../build-ts/ProtobufMessage";
@@ -583,6 +583,212 @@ export declare class BaseBatch<T extends BaseBatch<T>> {
      *     If the hash does not exist or is empty, the response will be an empty `array`.
      */
     hrandfieldWithValues(key: GlideString, count: number): T;
+    /**
+     * Sets hash fields with expiration times and optional conditional changes.
+     *
+     * @param key - The key of the hash.
+     * @param fieldsAndValues - A map or array of field-value pairs to set.
+     * @param options - Optional parameters including field conditional changes and expiry settings.
+     *                  See {@link HSetExOptions}.
+     *
+     * @example
+     * ```typescript
+     * // Set fields with 60 second expiration, only if none exist
+     * batch.hsetex(
+     *     "myHash",
+     *     { field1: "value1", field2: "value2" },
+     *     {
+     *         fieldConditionalChange: HashFieldConditionalChange.ONLY_IF_NONE_EXIST,
+     *         expiry: { type: TimeUnit.Seconds, count: 60 }
+     *     }
+     * );
+     *
+     * // Set fields and keep existing TTL
+     * batch.hsetex(
+     *     "myHash",
+     *     { field3: "value3" },
+     *     { expiry: "KEEPTTL" }
+     * );
+     *
+     * // Set fields with Unix timestamp expiration
+     * batch.hsetex(
+     *     "myHash",
+     *     { field4: "value4" },
+     *     { expiry: { type: TimeUnit.UnixSeconds, count: Math.floor(Date.now() / 1000) + 3600 } }
+     * );
+     * ```
+     *
+     * Command Response - The number of fields that were added to the hash.
+     *
+     * @since Valkey 9.0.0
+     * @see https://valkey.io/commands/hsetex/
+     */
+    hsetex(key: GlideString, fieldsAndValues: HashDataType | Record<string, GlideString>, options?: HSetExOptions): T;
+    /**
+     * Gets hash fields and optionally sets their expiration.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The fields in the hash stored at `key` to retrieve from the database.
+     * @param options - Optional arguments for the HGETEX command. See {@link HGetExOptions}.
+     *
+     * @example
+     * ```typescript
+     * // Get fields without setting expiration
+     * batch.hgetex("myHash", ["field1", "field2"]);
+     *
+     * // Get fields and set 30 second expiration
+     * batch.hgetex(
+     *     "myHash",
+     *     ["field1", "field2"],
+     *     { expiry: { type: TimeUnit.Seconds, count: 30 } }
+     * );
+     *
+     * // Get fields and remove expiration (make persistent)
+     * batch.hgetex(
+     *     "myHash",
+     *     ["field1", "field2"],
+     *     { expiry: "PERSIST" }
+     * );
+     *
+     * // Get fields and set millisecond precision expiration
+     * batch.hgetex(
+     *     "myHash",
+     *     ["field3"],
+     *     { expiry: { type: TimeUnit.Milliseconds, count: 5000 } }
+     * );
+     * ```
+     *
+     * Command Response - An array of values associated with the given fields, in the same order as they are requested.
+     *     For every field that does not exist in the hash, a null value is returned.
+     *     If `key` does not exist, returns an array of null values.
+     *
+     * @since Valkey 9.0.0
+     * @see https://valkey.io/commands/hgetex/
+     */
+    hgetex(key: GlideString, fields: GlideString[], options?: HGetExOptions): T;
+    /**
+     * Sets expiration time for hash fields in seconds. Creates the hash if it doesn't exist.
+     * @see {@link https://valkey.io/commands/hexpire/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param seconds - The expiration time in seconds.
+     * @param fields - The fields to set expiration for.
+     * @param options - Optional arguments for the HEXPIRE command. See {@link HExpireOptions}.
+     *
+     * Command Response - An array of numbers indicating the result for each field:
+     *     - `1` if expiration was set successfully
+     *     - `0` if the specified condition (NX, XX, GT, LT) was not met
+     *     - `-2` if the field does not exist or the key does not exist
+     *     - `2` when called with 0 seconds (field deleted)
+     */
+    hexpire(key: GlideString, seconds: number, fields: GlideString[], options?: HExpireOptions): T;
+    /**
+     * Removes the expiration time associated with each specified field, causing them to persist.
+     * @see {@link https://valkey.io/commands/hpersist/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The fields in the hash to remove expiration from.
+     *
+     * Command Response - An array of numbers indicating the result for each field:
+     *     - `1` if the field's expiration was removed successfully.
+     *     - `-1` if the field exists but has no associated expiration.
+     *     - `-2` if the field does not exist or the key does not exist.
+     */
+    hpersist(key: GlideString, fields: GlideString[]): T;
+    /**
+     * Sets expiration time for hash fields in milliseconds. Creates the hash if it doesn't exist.
+     * @see {@link https://valkey.io/commands/hpexpire/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param milliseconds - The expiration time in milliseconds.
+     * @param fields - The fields to set expiration for.
+     * @param options - Optional arguments for the HPEXPIRE command. See {@link HExpireOptions}.
+     *
+     * Command Response - An array of boolean values indicating whether expiration was set for each field.
+     *     `true` if expiration was set, `false` if the field doesn't exist or the condition wasn't met.
+     */
+    hpexpire(key: GlideString, milliseconds: number, fields: GlideString[], options?: HExpireOptions): T;
+    /**
+     * Sets expiration time for hash fields using an absolute Unix timestamp in seconds. Creates the hash if it doesn't exist.
+     * @see {@link https://valkey.io/commands/hexpireat/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param unixTimestampSeconds - The expiration time as a Unix timestamp in seconds.
+     * @param fields - The fields to set expiration for.
+     * @param options - Optional arguments for the HEXPIREAT command. See {@link HExpireOptions}.
+     *
+     * Command Response - An array of numbers indicating the result for each field:
+     *     - `1` if expiration was set successfully
+     *     - `0` if the specified condition (NX, XX, GT, LT) was not met
+     *     - `-2` if the field does not exist or the key does not exist
+     *     - `2` when called with 0 seconds (field deleted)
+     */
+    hexpireat(key: GlideString, unixTimestampSeconds: number, fields: GlideString[], options?: HExpireOptions): T;
+    /**
+     * Sets expiration time for hash fields using an absolute Unix timestamp in milliseconds. Creates the hash if it doesn't exist.
+     * @see {@link https://valkey.io/commands/hpexpireat/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param unixTimestampMilliseconds - The expiration time as a Unix timestamp in milliseconds.
+     * @param fields - The fields to set expiration for.
+     * @param options - Optional arguments for the HPEXPIREAT command. See {@link HExpireOptions}.
+     *
+     * Command Response - An array of boolean values indicating whether expiration was set for each field.
+     *     `true` if expiration was set, `false` if the field doesn't exist or the condition wasn't met.
+     */
+    hpexpireat(key: GlideString, unixTimestampMilliseconds: number, fields: GlideString[], options?: HExpireOptions): T;
+    /**
+     * Returns the remaining time to live of hash fields that have a timeout, in seconds.
+     * @see {@link https://valkey.io/commands/httl/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The fields in the hash stored at `key` to retrieve the TTL for.
+     *
+     * Command Response - An array of TTL values in seconds for the specified fields.
+     *     - For fields with a timeout, returns the remaining time in seconds.
+     *     - For fields that exist but have no associated expire, returns -1.
+     *     - For fields that do not exist, returns -2.
+     */
+    httl(key: GlideString, fields: GlideString[]): T;
+    /**
+     * Returns the absolute Unix timestamp (in seconds) at which hash fields will expire.
+     * @see {@link https://valkey.io/commands/hexpiretime/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The list of fields to get the expiration timestamp for.
+     *
+     * Command Response - An array of expiration timestamps in seconds for the specified fields:
+     *     - For fields with a timeout, returns the absolute Unix timestamp in seconds.
+     *     - For fields without a timeout, returns -1.
+     *     - For fields that do not exist, returns -2.
+     */
+    hexpiretime(key: GlideString, fields: GlideString[]): T;
+    /**
+     * Returns the absolute Unix timestamp (in milliseconds) at which hash fields will expire.
+     * @see {@link https://valkey.io/commands/hpexpiretime/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The list of fields to get the expiration timestamp for.
+     *
+     * Command Response - An array of expiration timestamps in milliseconds for the specified fields:
+     *     - For fields with a timeout, returns the absolute Unix timestamp in milliseconds.
+     *     - For fields without a timeout, returns -1.
+     *     - For fields that do not exist, returns -2.
+     */
+    hpexpiretime(key: GlideString, fields: GlideString[]): T;
+    /**
+     * Returns the remaining time to live of hash fields that have a timeout, in milliseconds.
+     * @see {@link https://valkey.io/commands/hpttl/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The list of fields to get the TTL for.
+     *
+     * Command Response - An array of TTL values in milliseconds for the specified fields:
+     *     - For fields with a timeout, returns the remaining TTL in milliseconds.
+     *     - For fields without a timeout, returns -1.
+     *     - For fields that do not exist, returns -2.
+     */
+    hpttl(key: GlideString, fields: GlideString[]): T;
     /** Inserts all the specified values at the head of the list stored at `key`.
      * `elements` are inserted one after the other to the head of the list, from the leftmost element to the rightmost element.
      * If `key` does not exist, it is created as empty list before performing the push operations.
@@ -2867,6 +3073,14 @@ export declare class Batch extends BaseBatch<Batch> {
     /**
      * Change the currently selected database.
      *
+     * **WARNING**: This command is NOT RECOMMENDED for production use.
+     * Upon reconnection, the client will revert to the database_id specified
+     * in the client configuration (default: 0), NOT the database selected
+     * via this command.
+     *
+     * **RECOMMENDED APPROACH**: Use the `databaseId` parameter in client
+     * configuration instead of using SELECT in batch operations.
+     *
      * @see {@link https://valkey.io/commands/select/|valkey.io} for details.
      *
      * @param index - The index of the database to select.

package/build-ts/Batch.js

@@ -685,6 +685,234 @@ class BaseBatch {
     hrandfieldWithValues(key, count) {
         return this.addAndReturn((0, _1.createHRandField)(key, count, true));
     }
+    /**
+     * Sets hash fields with expiration times and optional conditional changes.
+     *
+     * @param key - The key of the hash.
+     * @param fieldsAndValues - A map or array of field-value pairs to set.
+     * @param options - Optional parameters including field conditional changes and expiry settings.
+     *                  See {@link HSetExOptions}.
+     *
+     * @example
+     * ```typescript
+     * // Set fields with 60 second expiration, only if none exist
+     * batch.hsetex(
+     *     "myHash",
+     *     { field1: "value1", field2: "value2" },
+     *     {
+     *         fieldConditionalChange: HashFieldConditionalChange.ONLY_IF_NONE_EXIST,
+     *         expiry: { type: TimeUnit.Seconds, count: 60 }
+     *     }
+     * );
+     *
+     * // Set fields and keep existing TTL
+     * batch.hsetex(
+     *     "myHash",
+     *     { field3: "value3" },
+     *     { expiry: "KEEPTTL" }
+     * );
+     *
+     * // Set fields with Unix timestamp expiration
+     * batch.hsetex(
+     *     "myHash",
+     *     { field4: "value4" },
+     *     { expiry: { type: TimeUnit.UnixSeconds, count: Math.floor(Date.now() / 1000) + 3600 } }
+     * );
+     * ```
+     *
+     * Command Response - The number of fields that were added to the hash.
+     *
+     * @since Valkey 9.0.0
+     * @see https://valkey.io/commands/hsetex/
+     */
+    hsetex(key, fieldsAndValues, options) {
+        return this.addAndReturn((0, _1.createHSetEx)(key, (0, _1.convertFieldsAndValuesToHashDataType)(fieldsAndValues), options));
+    }
+    /**
+     * Gets hash fields and optionally sets their expiration.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The fields in the hash stored at `key` to retrieve from the database.
+     * @param options - Optional arguments for the HGETEX command. See {@link HGetExOptions}.
+     *
+     * @example
+     * ```typescript
+     * // Get fields without setting expiration
+     * batch.hgetex("myHash", ["field1", "field2"]);
+     *
+     * // Get fields and set 30 second expiration
+     * batch.hgetex(
+     *     "myHash",
+     *     ["field1", "field2"],
+     *     { expiry: { type: TimeUnit.Seconds, count: 30 } }
+     * );
+     *
+     * // Get fields and remove expiration (make persistent)
+     * batch.hgetex(
+     *     "myHash",
+     *     ["field1", "field2"],
+     *     { expiry: "PERSIST" }
+     * );
+     *
+     * // Get fields and set millisecond precision expiration
+     * batch.hgetex(
+     *     "myHash",
+     *     ["field3"],
+     *     { expiry: { type: TimeUnit.Milliseconds, count: 5000 } }
+     * );
+     * ```
+     *
+     * Command Response - An array of values associated with the given fields, in the same order as they are requested.
+     *     For every field that does not exist in the hash, a null value is returned.
+     *     If `key` does not exist, returns an array of null values.
+     *
+     * @since Valkey 9.0.0
+     * @see https://valkey.io/commands/hgetex/
+     */
+    hgetex(key, fields, options) {
+        return this.addAndReturn((0, _1.createHGetEx)(key, fields, options));
+    }
+    /**
+     * Sets expiration time for hash fields in seconds. Creates the hash if it doesn't exist.
+     * @see {@link https://valkey.io/commands/hexpire/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param seconds - The expiration time in seconds.
+     * @param fields - The fields to set expiration for.
+     * @param options - Optional arguments for the HEXPIRE command. See {@link HExpireOptions}.
+     *
+     * Command Response - An array of numbers indicating the result for each field:
+     *     - `1` if expiration was set successfully
+     *     - `0` if the specified condition (NX, XX, GT, LT) was not met
+     *     - `-2` if the field does not exist or the key does not exist
+     *     - `2` when called with 0 seconds (field deleted)
+     */
+    hexpire(key, seconds, fields, options) {
+        return this.addAndReturn((0, _1.createHExpire)(key, seconds, fields, options));
+    }
+    /**
+     * Removes the expiration time associated with each specified field, causing them to persist.
+     * @see {@link https://valkey.io/commands/hpersist/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The fields in the hash to remove expiration from.
+     *
+     * Command Response - An array of numbers indicating the result for each field:
+     *     - `1` if the field's expiration was removed successfully.
+     *     - `-1` if the field exists but has no associated expiration.
+     *     - `-2` if the field does not exist or the key does not exist.
+     */
+    hpersist(key, fields) {
+        return this.addAndReturn((0, _1.createHPersist)(key, fields));
+    }
+    /**
+     * Sets expiration time for hash fields in milliseconds. Creates the hash if it doesn't exist.
+     * @see {@link https://valkey.io/commands/hpexpire/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param milliseconds - The expiration time in milliseconds.
+     * @param fields - The fields to set expiration for.
+     * @param options - Optional arguments for the HPEXPIRE command. See {@link HExpireOptions}.
+     *
+     * Command Response - An array of boolean values indicating whether expiration was set for each field.
+     *     `true` if expiration was set, `false` if the field doesn't exist or the condition wasn't met.
+     */
+    hpexpire(key, milliseconds, fields, options) {
+        return this.addAndReturn((0, _1.createHPExpire)(key, milliseconds, fields, options));
+    }
+    /**
+     * Sets expiration time for hash fields using an absolute Unix timestamp in seconds. Creates the hash if it doesn't exist.
+     * @see {@link https://valkey.io/commands/hexpireat/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param unixTimestampSeconds - The expiration time as a Unix timestamp in seconds.
+     * @param fields - The fields to set expiration for.
+     * @param options - Optional arguments for the HEXPIREAT command. See {@link HExpireOptions}.
+     *
+     * Command Response - An array of numbers indicating the result for each field:
+     *     - `1` if expiration was set successfully
+     *     - `0` if the specified condition (NX, XX, GT, LT) was not met
+     *     - `-2` if the field does not exist or the key does not exist
+     *     - `2` when called with 0 seconds (field deleted)
+     */
+    hexpireat(key, unixTimestampSeconds, fields, options) {
+        return this.addAndReturn((0, _1.createHExpireAt)(key, unixTimestampSeconds, fields, options));
+    }
+    /**
+     * Sets expiration time for hash fields using an absolute Unix timestamp in milliseconds. Creates the hash if it doesn't exist.
+     * @see {@link https://valkey.io/commands/hpexpireat/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param unixTimestampMilliseconds - The expiration time as a Unix timestamp in milliseconds.
+     * @param fields - The fields to set expiration for.
+     * @param options - Optional arguments for the HPEXPIREAT command. See {@link HExpireOptions}.
+     *
+     * Command Response - An array of boolean values indicating whether expiration was set for each field.
+     *     `true` if expiration was set, `false` if the field doesn't exist or the condition wasn't met.
+     */
+    hpexpireat(key, unixTimestampMilliseconds, fields, options) {
+        return this.addAndReturn((0, _1.createHPExpireAt)(key, unixTimestampMilliseconds, fields, options));
+    }
+    /**
+     * Returns the remaining time to live of hash fields that have a timeout, in seconds.
+     * @see {@link https://valkey.io/commands/httl/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The fields in the hash stored at `key` to retrieve the TTL for.
+     *
+     * Command Response - An array of TTL values in seconds for the specified fields.
+     *     - For fields with a timeout, returns the remaining time in seconds.
+     *     - For fields that exist but have no associated expire, returns -1.
+     *     - For fields that do not exist, returns -2.
+     */
+    httl(key, fields) {
+        return this.addAndReturn((0, _1.createHTtl)(key, fields));
+    }
+    /**
+     * Returns the absolute Unix timestamp (in seconds) at which hash fields will expire.
+     * @see {@link https://valkey.io/commands/hexpiretime/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The list of fields to get the expiration timestamp for.
+     *
+     * Command Response - An array of expiration timestamps in seconds for the specified fields:
+     *     - For fields with a timeout, returns the absolute Unix timestamp in seconds.
+     *     - For fields without a timeout, returns -1.
+     *     - For fields that do not exist, returns -2.
+     */
+    hexpiretime(key, fields) {
+        return this.addAndReturn((0, _1.createHExpireTime)(key, fields));
+    }
+    /**
+     * Returns the absolute Unix timestamp (in milliseconds) at which hash fields will expire.
+     * @see {@link https://valkey.io/commands/hpexpiretime/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The list of fields to get the expiration timestamp for.
+     *
+     * Command Response - An array of expiration timestamps in milliseconds for the specified fields:
+     *     - For fields with a timeout, returns the absolute Unix timestamp in milliseconds.
+     *     - For fields without a timeout, returns -1.
+     *     - For fields that do not exist, returns -2.
+     */
+    hpexpiretime(key, fields) {
+        return this.addAndReturn((0, _1.createHPExpireTime)(key, fields));
+    }
+    /**
+     * Returns the remaining time to live of hash fields that have a timeout, in milliseconds.
+     * @see {@link https://valkey.io/commands/hpttl/|valkey.io} for details.
+     *
+     * @param key - The key of the hash.
+     * @param fields - The list of fields to get the TTL for.
+     *
+     * Command Response - An array of TTL values in milliseconds for the specified fields:
+     *     - For fields with a timeout, returns the remaining TTL in milliseconds.
+     *     - For fields without a timeout, returns -1.
+     *     - For fields that do not exist, returns -2.
+     */
+    hpttl(key, fields) {
+        return this.addAndReturn((0, _1.createHPTtl)(key, fields));
+    }
     /** Inserts all the specified values at the head of the list stored at `key`.
      * `elements` are inserted one after the other to the head of the list, from the leftmost element to the rightmost element.
      * If `key` does not exist, it is created as empty list before performing the push operations.
@@ -3275,6 +3503,14 @@ class Batch extends BaseBatch {
     /**
      * Change the currently selected database.
      *
+     * **WARNING**: This command is NOT RECOMMENDED for production use.
+     * Upon reconnection, the client will revert to the database_id specified
+     * in the client configuration (default: 0), NOT the database selected
+     * via this command.
+     *
+     * **RECOMMENDED APPROACH**: Use the `databaseId` parameter in client
+     * configuration instead of using SELECT in batch operations.
+     *
      * @see {@link https://valkey.io/commands/select/|valkey.io} for details.
      *
      * @param index - The index of the database to select.

package/build-ts/Commands.d.ts

@@ -788,6 +788,173 @@ export declare enum ConditionalChange {
      */
     ONLY_IF_DOES_NOT_EXIST = "NX"
 }
+/**
+ * Field conditional change options for hash field expiration commands.
+ * Used with HSETEX command to control field setting behavior.
+ */
+export declare enum HashFieldConditionalChange {
+    /**
+     * Only set fields if all of them already exist. Equivalent to `FXX` in the Valkey API.
+     */
+    ONLY_IF_ALL_EXIST = "FXX",
+    /**
+     * Only set fields if none of them already exist. Equivalent to `FNX` in the Valkey API.
+     */
+    ONLY_IF_NONE_EXIST = "FNX"
+}
+/**
+ * Expiry set options for hash field expiration commands.
+ * Supports setting expiration time in various formats.
+ */
+export type ExpirySet = {
+    type: TimeUnit;
+    count: number;
+} | "KEEPTTL";
+/**
+ * Expiry options specifically for HSETEX command.
+ * Supports standard expiry options (EX/PX/EXAT/PXAT) and KEEPTTL, but excludes PERSIST.
+ *
+ * @example
+ * ```typescript
+ * // Set expiration to 60 seconds
+ * const expiry: HSetExExpiry = { type: TimeUnit.Seconds, count: 60 };
+ *
+ * // Keep existing TTL
+ * const keepTtl: HSetExExpiry = "KEEPTTL";
+ * ```
+ */
+export type HSetExExpiry = {
+    type: TimeUnit;
+    count: number;
+} | "KEEPTTL";
+/**
+ * Expiry options specifically for HGETEX command.
+ * Supports standard expiry options (EX/PX/EXAT/PXAT) and PERSIST, but excludes KEEPTTL.
+ *
+ * @example
+ * ```typescript
+ * // Set expiration to 30 seconds
+ * const expiry: HGetExExpiry = { type: TimeUnit.Seconds, count: 30 };
+ *
+ * // Remove expiration
+ * const persist: HGetExExpiry = "PERSIST";
+ * ```
+ */
+export type HGetExExpiry = {
+    type: TimeUnit;
+    count: number;
+} | "PERSIST";
+/**
+ * Optional arguments for the HSETEX command.
+ *
+ * @example
+ * ```typescript
+ * // Set fields with 60 second expiration, only if none exist
+ * const options: HSetExOptions = {
+ *     fieldConditionalChange: HashFieldConditionalChange.ONLY_IF_NONE_EXIST,
+ *     expiry: { type: TimeUnit.Seconds, count: 60 }
+ * };
+ *
+ * // Set fields and keep existing TTL
+ * const keepTtlOptions: HSetExOptions = {
+ *     expiry: "KEEPTTL"
+ * };
+ * ```
+ *
+ * See https://valkey.io/commands/hsetex/ for more details.
+ */
+export interface HSetExOptions {
+    /** Options for handling existing fields. See {@link HashFieldConditionalChange}. */
+    fieldConditionalChange?: HashFieldConditionalChange;
+    /** Expiry settings for the fields. See {@link HSetExExpiry}. */
+    expiry?: HSetExExpiry;
+}
+/**
+ * Optional arguments for the HGETEX command.
+ *
+ * @example
+ * ```typescript
+ * // Get fields and set 30 second expiration
+ * const options: HGetExOptions = {
+ *     expiry: { type: TimeUnit.Seconds, count: 30 }
+ * };
+ *
+ * // Get fields and remove expiration
+ * const persistOptions: HGetExOptions = {
+ *     expiry: "PERSIST"
+ * };
+ * ```
+ *
+ * See https://valkey.io/commands/hgetex/ for more details.
+ */
+export interface HGetExOptions {
+    /** Expiry settings for the fields. Can be a time-based expiry or "PERSIST" to remove expiration. */
+    expiry?: HGetExExpiry;
+}
+/**
+ * Expiration condition options for hash field expiration commands.
+ * Used with HEXPIRE, HPEXPIRE, HEXPIREAT, and HPEXPIREAT commands to control expiration setting behavior.
+ */
+export declare enum HashExpirationCondition {
+    /**
+     * Only set expiration when field has no expiration. Equivalent to `NX` in the Valkey API.
+     */
+    ONLY_IF_NO_EXPIRY = "NX",
+    /**
+     * Only set expiration when field has existing expiration. Equivalent to `XX` in the Valkey API.
+     */
+    ONLY_IF_HAS_EXPIRY = "XX",
+    /**
+     * Only set expiration when new expiration is greater than current. Equivalent to `GT` in the Valkey API.
+     */
+    ONLY_IF_GREATER_THAN_CURRENT = "GT",
+    /**
+     * Only set expiration when new expiration is less than current. Equivalent to `LT` in the Valkey API.
+     */
+    ONLY_IF_LESS_THAN_CURRENT = "LT"
+}
+/**
+ * Shared optional arguments for HEXPIRE, HPEXPIRE, HEXPIREAT, and HPEXPIREAT commands.
+ *
+ * This interface provides a unified way to specify expiration conditions for hash field
+ * expiration commands that support conditional expiration setting.
+ *
+ * @example
+ * ```typescript
+ * // Set expiration only if field has no existing expiration
+ * const options: HExpireOptions = {
+ *     condition: HashExpirationCondition.ONLY_IF_NO_EXPIRY
+ * };
+ *
+ * // Set expiration only if new expiration is greater than current
+ * const gtOptions: HExpireOptions = {
+ *     condition: HashExpirationCondition.ONLY_IF_GREATER_THAN_CURRENT
+ * };
+ *
+ * // Set expiration only if field has existing expiration
+ * const xxOptions: HExpireOptions = {
+ *     condition: HashExpirationCondition.ONLY_IF_HAS_EXPIRY
+ * };
+ *
+ * // Set expiration only if new expiration is less than current
+ * const ltOptions: HExpireOptions = {
+ *     condition: HashExpirationCondition.ONLY_IF_LESS_THAN_CURRENT
+ * };
+ * ```
+ *
+ * @see {@link https://valkey.io/commands/hexpire/|HEXPIRE}
+ * @see {@link https://valkey.io/commands/hpexpire/|HPEXPIRE}
+ * @see {@link https://valkey.io/commands/hexpireat/|HEXPIREAT}
+ * @see {@link https://valkey.io/commands/hpexpireat/|HPEXPIREAT}
+ */
+export interface HExpireOptions {
+    /**
+     * Condition for setting expiration. Controls when the expiration should be set
+     * based on the current state of the field's expiration.
+     * See {@link HashExpirationCondition} for available options.
+     */
+    condition?: HashExpirationCondition;
+}
 /**
  * Represents a geographic position defined by longitude and latitude.
  * The exact limits, as specified by `EPSG:900913 / EPSG:3785 / OSGEO:41001` are the