encore.dev 1.54.2 → 1.56.0

package/dist/storage/cache/expiry.js

@@ -0,0 +1,74 @@
+/**
+ * expireIn sets the cache entry to expire after the specified duration.
+ * @param ms - Duration in milliseconds
+ */
+export function expireIn(ms) {
+    return { type: "duration", durationMs: ms };
+}
+/**
+ * expireInSeconds sets the cache entry to expire after the specified seconds.
+ * @param seconds - Duration in seconds
+ */
+export function expireInSeconds(seconds) {
+    return { type: "duration", durationMs: seconds * 1000 };
+}
+/**
+ * expireInMinutes sets the cache entry to expire after the specified minutes.
+ * @param minutes - Duration in minutes
+ */
+export function expireInMinutes(minutes) {
+    return { type: "duration", durationMs: minutes * 60 * 1000 };
+}
+/**
+ * expireInHours sets the cache entry to expire after the specified hours.
+ * @param hours - Duration in hours
+ */
+export function expireInHours(hours) {
+    return { type: "duration", durationMs: hours * 60 * 60 * 1000 };
+}
+/**
+ * expireDailyAt sets the cache entry to expire at a specific time each day (UTC).
+ * @param hours - Hour (0-23)
+ * @param minutes - Minutes (0-59)
+ * @param seconds - Seconds (0-59)
+ */
+export function expireDailyAt(hours, minutes, seconds) {
+    return { type: "time", hours, minutes, seconds };
+}
+/**
+ * neverExpire sets the cache entry to never expire.
+ * Note: Redis may still evict the key based on the eviction policy.
+ */
+export const neverExpire = "never";
+/**
+ * keepTTL preserves the existing TTL when updating a cache entry.
+ * If the key doesn't exist, no TTL is set.
+ */
+export const keepTTL = "keep-ttl";
+/**
+ * Resolves an Expiry to a duration in milliseconds, "never", or "keep-ttl".
+ * @internal
+ */
+export function resolveExpiry(expiry) {
+    switch (expiry) {
+        case "never":
+            return "never";
+        case "keep-ttl":
+            return "keep-ttl";
+    }
+    switch (expiry.type) {
+        case "duration":
+            return expiry.durationMs;
+        case "time": {
+            const now = new Date();
+            const target = new Date(now);
+            target.setUTCHours(expiry.hours, expiry.minutes, expiry.seconds, 0);
+            // If target time has passed today, set for tomorrow
+            if (target.getTime() <= now.getTime()) {
+                target.setUTCDate(target.getUTCDate() + 1);
+            }
+            return target.getTime() - now.getTime();
+        }
+    }
+}
+//# sourceMappingURL=expiry.js.map

package/dist/storage/cache/expiry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expiry.js","sourceRoot":"","sources":["../../../storage/cache/expiry.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,OAAe,EACf,OAAe;IAEf,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAW,OAAO,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAW,UAAU,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,MAAM,CAAC,UAAU,CAAC;QAE3B,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAEpE,oDAAoD;YACpD,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACtC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7C,CAAC;YAED,OAAO,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/storage/cache/keyspace.d.ts

@@ -0,0 +1,77 @@
+import { CacheCluster } from "./cluster.js";
+import { Expiry } from "./expiry.js";
+/**
+ * Configuration for a cache keyspace.
+ */
+export interface KeyspaceConfig<K> {
+    /**
+     * The pattern for generating cache keys.
+     * Use `:fieldName` to include a field from the key type.
+     *
+     * @example
+     * // For a simple key type (string, number)
+     * keyPattern: "user/:id"
+     *
+     * // For a struct key type
+     * keyPattern: "user/:userId/region/:region"
+     */
+    keyPattern: string;
+    /**
+     * Default expiry for cache entries in this keyspace.
+     * If not set, entries do not expire.
+     */
+    defaultExpiry?: Expiry;
+}
+/**
+ * Options for write operations.
+ */
+export interface WriteOptions {
+    /**
+     * Expiry for this specific write operation.
+     * Overrides the keyspace's defaultExpiry.
+     */
+    expiry?: Expiry;
+}
+/**
+ * Base class for all keyspace types (basic, list, set).
+ * Provides key mapping, TTL resolution, with(), and delete().
+ * @internal
+ */
+export declare abstract class Keyspace<K> {
+    protected readonly cluster: CacheCluster;
+    protected readonly config: KeyspaceConfig<K>;
+    protected readonly keyMapper: (key: K) => string;
+    private _effectiveExpiry?;
+    constructor(cluster: CacheCluster, config: KeyspaceConfig<K>);
+    /**
+     * Creates a key mapper by parsing the key pattern.
+     */
+    private createKeyMapper;
+    /**
+     * Maps a key to its Redis key string.
+     */
+    protected mapKey(key: K): string;
+    /**
+     * Resolves the TTL for a write operation.
+     * Returns i64 sentinel for NAPI: undefined=no config, -1=KeepTTL, -2=Persist/NeverExpire, >=0=ms
+     */
+    protected resolveTtl(options?: WriteOptions): number | undefined;
+    /**
+     * Returns a shallow clone of this keyspace with the specified write options applied.
+     * This allows setting expiry for a chain of operations.
+     *
+     * @example
+     * ```ts
+     * await myKeyspace.with({ expiry: expireIn(5000) }).set(key, value);
+     * ```
+     */
+    with(options: WriteOptions): this;
+    /**
+     * Deletes the specified keys.
+     * If a key does not exist it is ignored.
+     *
+     * @returns The number of keys that were deleted.
+     * @see https://redis.io/commands/del/
+     */
+    delete(...keys: K[]): Promise<number>;
+}

package/dist/storage/cache/keyspace.js

@@ -0,0 +1,100 @@
+import { getCurrentRequest } from "../../internal/reqtrack/mod.js";
+import { resolveExpiry } from "./expiry.js";
+/**
+ * Base class for all keyspace types (basic, list, set).
+ * Provides key mapping, TTL resolution, with(), and delete().
+ * @internal
+ */
+export class Keyspace {
+    cluster;
+    config;
+    keyMapper;
+    _effectiveExpiry;
+    constructor(cluster, config) {
+        this.cluster = cluster;
+        this.config = config;
+        this.keyMapper = this.createKeyMapper(config.keyPattern);
+    }
+    /**
+     * Creates a key mapper by parsing the key pattern.
+     */
+    createKeyMapper(pattern) {
+        const segments = pattern.split("/").map((seg) => {
+            if (seg.startsWith(":")) {
+                return { isLiteral: false, value: seg.slice(1), field: seg.slice(1) };
+            }
+            return { isLiteral: true, value: seg };
+        });
+        return (key) => {
+            return segments
+                .map((seg) => {
+                if (seg.isLiteral)
+                    return seg.value;
+                let val;
+                if (typeof key === "object" && key !== null && seg.field) {
+                    val = key[seg.field];
+                }
+                else {
+                    val = key;
+                }
+                // Escape forward slashes in string values
+                const str = String(val);
+                return str.replace(/\//g, "\\/");
+            })
+                .join("/");
+        };
+    }
+    /**
+     * Maps a key to its Redis key string.
+     */
+    mapKey(key) {
+        const mapped = this.keyMapper(key);
+        if (mapped.startsWith("__encore")) {
+            throw new Error('use of reserved key prefix "__encore"');
+        }
+        return mapped;
+    }
+    /**
+     * Resolves the TTL for a write operation.
+     * Returns i64 sentinel for NAPI: undefined=no config, -1=KeepTTL, -2=Persist/NeverExpire, >=0=ms
+     */
+    resolveTtl(options) {
+        const expiry = options?.expiry ?? this._effectiveExpiry ?? this.config.defaultExpiry;
+        if (!expiry)
+            return undefined;
+        const resolved = resolveExpiry(expiry);
+        if (resolved === "keep-ttl")
+            return -1; // KeepTTL
+        if (resolved === "never")
+            return -2; // NeverExpire → Persist
+        return resolved; // milliseconds
+    }
+    /**
+     * Returns a shallow clone of this keyspace with the specified write options applied.
+     * This allows setting expiry for a chain of operations.
+     *
+     * @example
+     * ```ts
+     * await myKeyspace.with({ expiry: expireIn(5000) }).set(key, value);
+     * ```
+     */
+    with(options) {
+        const clone = Object.create(Object.getPrototypeOf(this));
+        Object.assign(clone, this);
+        clone._effectiveExpiry = options.expiry ?? this._effectiveExpiry;
+        return clone;
+    }
+    /**
+     * Deletes the specified keys.
+     * If a key does not exist it is ignored.
+     *
+     * @returns The number of keys that were deleted.
+     * @see https://redis.io/commands/del/
+     */
+    async delete(...keys) {
+        const source = getCurrentRequest();
+        const mappedKeys = keys.map((k) => this.mapKey(k));
+        return await this.cluster.impl.delete(mappedKeys, source);
+    }
+}
+//# sourceMappingURL=keyspace.js.map

package/dist/storage/cache/keyspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyspace.js","sourceRoot":"","sources":["../../../storage/cache/keyspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAgC,aAAa,EAAE,MAAM,UAAU,CAAC;AAqCvE;;;;GAIG;AACH,MAAM,OAAgB,QAAQ;IACT,OAAO,CAAe;IACtB,MAAM,CAAoB;IAC1B,SAAS,CAAqB;IACzC,gBAAgB,CAAU;IAElC,YAAY,OAAqB,EAAE,MAAyB;QAC1D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAe;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC9C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAM,EAAE,EAAE;YAChB,OAAO,QAAQ;iBACZ,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACX,IAAI,GAAG,CAAC,SAAS;oBAAE,OAAO,GAAG,CAAC,KAAK,CAAC;gBAEpC,IAAI,GAAY,CAAC;gBACjB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;oBACzD,GAAG,GAAI,GAA+B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,GAAG,GAAG,GAAG,CAAC;gBACZ,CAAC;gBAED,0CAA0C;gBAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBACxB,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC,CAAC;iBACD,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,MAAM,CAAC,GAAM;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACO,UAAU,CAAC,OAAsB;QACzC,MAAM,MAAM,GACV,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QACxE,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAE9B,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,UAAU;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU;QAClD,IAAI,QAAQ,KAAK,OAAO;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,wBAAwB;QAC7D,OAAO,QAAQ,CAAC,CAAC,eAAe;IAClC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,OAAqB;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAS,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1B,KAAa,CAAC,gBAAgB,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,GAAG,IAAS;QACvB,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/storage/cache/list.d.ts

@@ -0,0 +1,249 @@
+/// <reference types="node" />
+import { CacheCluster } from "./cluster.js";
+import { Keyspace, KeyspaceConfig, WriteOptions } from "./keyspace.js";
+/**
+ * Position in a list (left/head or right/tail).
+ */
+export type ListPosition = "left" | "right";
+/**
+ * Base class for list keyspaces with all list operations.
+ * Subclasses provide typed serialization/deserialization.
+ * @internal
+ */
+declare abstract class ListKeyspace<K, V> extends Keyspace<K> {
+    constructor(cluster: CacheCluster, config: KeyspaceConfig<K>);
+    protected abstract serializeItem(value: V): Buffer;
+    protected abstract deserializeItem(data: Buffer): V;
+    /**
+     * Pushes one or more values at the head of the list stored at key.
+     * If the key does not already exist, it is first created as an empty list.
+     *
+     * If multiple values are given, they are inserted one after another,
+     * starting with the leftmost value. For instance,
+     * `pushLeft(key, "a", "b", "c")` will result in a list containing
+     * "c" as its first element, "b" as its second, and "a" as its third.
+     *
+     * @returns The length of the list after the operation.
+     * @see https://redis.io/commands/lpush/
+     */
+    pushLeft(key: K, ...values: V[]): Promise<number>;
+    /**
+     * Pushes one or more values at the tail of the list stored at key.
+     * If the key does not already exist, it is first created as an empty list.
+     *
+     * If multiple values are given, they are inserted one after another,
+     * starting with the leftmost value. For instance,
+     * `pushRight(key, "a", "b", "c")` will result in a list containing
+     * "a" as its first element, "b" as its second, and "c" as its third.
+     *
+     * @returns The length of the list after the operation.
+     * @see https://redis.io/commands/rpush/
+     */
+    pushRight(key: K, ...values: V[]): Promise<number>;
+    /**
+     * Pops a single element off the head of the list stored at key.
+     *
+     * @returns The popped value, or `undefined` if the key does not exist.
+     * @see https://redis.io/commands/lpop/
+     */
+    popLeft(key: K, options?: WriteOptions): Promise<V | undefined>;
+    /**
+     * Pops a single element off the tail of the list stored at key.
+     *
+     * @returns The popped value, or `undefined` if the key does not exist.
+     * @see https://redis.io/commands/rpop/
+     */
+    popRight(key: K, options?: WriteOptions): Promise<V | undefined>;
+    /**
+     * Returns the length of the list stored at key.
+     *
+     * Non-existing keys are considered as empty lists.
+     *
+     * @returns The list length.
+     * @see https://redis.io/commands/llen/
+     */
+    len(key: K): Promise<number>;
+    /**
+     * Trims the list stored at key to only contain the elements between the indices
+     * `start` and `stop` (inclusive). Both are zero-based indices.
+     *
+     * Negative indices can be used to indicate offsets from the end of the list,
+     * where -1 is the last element of the list, -2 the penultimate element, and so on.
+     *
+     * Out of range indices are valid and are treated as if they specify the start or end of the list,
+     * respectively. If `start` > `stop` the end result is an empty list.
+     *
+     * @param key - The cache key.
+     * @param start - Start index (inclusive).
+     * @param stop - Stop index (inclusive).
+     * @see https://redis.io/commands/ltrim/
+     */
+    trim(key: K, start: number, stop: number, options?: WriteOptions): Promise<void>;
+    /**
+     * Updates the list element at the given index.
+     *
+     * Negative indices can be used to indicate offsets from the end of the list,
+     * where -1 is the last element of the list, -2 the penultimate element, and so on.
+     *
+     * @param key - The cache key.
+     * @param index - Zero-based index of the element to update.
+     * @param value - The new value.
+     * @throws {Error} If the index is out of range.
+     * @see https://redis.io/commands/lset/
+     */
+    set(key: K, index: number, value: V, options?: WriteOptions): Promise<void>;
+    /**
+     * Returns the value of the list element at the given index.
+     *
+     * Negative indices can be used to indicate offsets from the end of the list,
+     * where -1 is the last element of the list, -2 the penultimate element, and so on.
+     *
+     * @param key - The cache key.
+     * @param index - Zero-based index of the element to retrieve.
+     * @returns The value at the index, or `undefined` if out of range or the key does not exist.
+     * @see https://redis.io/commands/lindex/
+     */
+    get(key: K, index: number): Promise<V | undefined>;
+    /**
+     * Returns all the elements in the list stored at key.
+     *
+     * If the key does not exist it returns an empty array.
+     *
+     * @returns All elements in the list.
+     * @see https://redis.io/commands/lrange/
+     */
+    items(key: K): Promise<V[]>;
+    /**
+     * Returns the elements in the list stored at key between `start` and `stop` (inclusive).
+     * Both are zero-based indices.
+     *
+     * Negative indices can be used to indicate offsets from the end of the list,
+     * where -1 is the last element of the list, -2 the penultimate element, and so on.
+     *
+     * If the key does not exist it returns an empty array.
+     *
+     * @param key - The cache key.
+     * @param start - Start index (inclusive).
+     * @param stop - Stop index (inclusive).
+     * @returns The elements in the specified range.
+     * @see https://redis.io/commands/lrange/
+     */
+    getRange(key: K, start: number, stop: number): Promise<V[]>;
+    /**
+     * Inserts `value` into the list stored at key, at the position just before `pivot`.
+     *
+     * If the list does not contain `pivot`, the value is not inserted and -1 is returned.
+     *
+     * @param key - The cache key.
+     * @param pivot - The existing element to insert before.
+     * @param value - The value to insert.
+     * @returns The new list length, or -1 if `pivot` was not found.
+     * @see https://redis.io/commands/linsert/
+     */
+    insertBefore(key: K, pivot: V, value: V, options?: WriteOptions): Promise<number>;
+    /**
+     * Inserts `value` into the list stored at key, at the position just after `pivot`.
+     *
+     * If the list does not contain `pivot`, the value is not inserted and -1 is returned.
+     *
+     * @param key - The cache key.
+     * @param pivot - The existing element to insert after.
+     * @param value - The value to insert.
+     * @returns The new list length, or -1 if `pivot` was not found.
+     * @see https://redis.io/commands/linsert/
+     */
+    insertAfter(key: K, pivot: V, value: V, options?: WriteOptions): Promise<number>;
+    /**
+     * Removes all occurrences of `value` in the list stored at key.
+     *
+     * If the list does not contain `value`, or the list does not exist, returns 0.
+     *
+     * @param key - The cache key.
+     * @param value - The value to remove.
+     * @returns The number of elements removed.
+     * @see https://redis.io/commands/lrem/
+     */
+    removeAll(key: K, value: V, options?: WriteOptions): Promise<number>;
+    /**
+     * Removes the first `count` occurrences of `value` in the list stored at key,
+     * scanning from head to tail.
+     *
+     * If the list does not contain `value`, or the list does not exist, returns 0.
+     *
+     * @param key - The cache key.
+     * @param count - Maximum number of occurrences to remove.
+     * @param value - The value to remove.
+     * @returns The number of elements removed.
+     * @see https://redis.io/commands/lrem/
+     */
+    removeFirst(key: K, count: number, value: V, options?: WriteOptions): Promise<number>;
+    /**
+     * Removes the last `count` occurrences of `value` in the list stored at key,
+     * scanning from tail to head.
+     *
+     * If the list does not contain `value`, or the list does not exist, returns 0.
+     *
+     * @param key - The cache key.
+     * @param count - Maximum number of occurrences to remove.
+     * @param value - The value to remove.
+     * @returns The number of elements removed.
+     * @see https://redis.io/commands/lrem/
+     */
+    removeLast(key: K, count: number, value: V, options?: WriteOptions): Promise<number>;
+    /**
+     * Atomically moves an element from the list stored at `src` to the list stored at `dst`.
+     *
+     * The value moved can be either the head (`srcPos === "left"`) or tail (`srcPos === "right"`)
+     * of the list at `src`. Similarly, the value can be placed either at the head (`dstPos === "left"`)
+     * or tail (`dstPos === "right"`) of the list at `dst`.
+     *
+     * If `src` and `dst` are the same list, the value is atomically rotated from one end to the other
+     * when `srcPos !== dstPos`, or if `srcPos === dstPos` nothing happens.
+     *
+     * @param src - Source list key.
+     * @param dst - Destination list key.
+     * @param srcPos - Position to pop from in the source list.
+     * @param dstPos - Position to push to in the destination list.
+     * @returns The moved element, or `undefined` if the source list does not exist.
+     * @see https://redis.io/commands/lmove/
+     */
+    move(src: K, dst: K, srcPos: ListPosition, dstPos: ListPosition, options?: WriteOptions): Promise<V | undefined>;
+}
+/**
+ * StringListKeyspace stores lists of string values.
+ *
+ * @example
+ * ```ts
+ * const recentViews = new StringListKeyspace<string>(cluster, {
+ *   keyPattern: "recent-views/:userId",
+ *   defaultExpiry: ExpireIn(86400000), // 24 hours
+ * });
+ *
+ * await recentViews.pushLeft("user1", "product-123", "product-456");
+ * const views = await recentViews.items("user1");
+ * ```
+ */
+export declare class StringListKeyspace<K> extends ListKeyspace<K, string> {
+    constructor(cluster: CacheCluster, config: KeyspaceConfig<K>);
+    protected serializeItem(value: string): Buffer;
+    protected deserializeItem(data: Buffer): string;
+}
+/**
+ * NumberListKeyspace stores lists of numeric values.
+ *
+ * @example
+ * ```ts
+ * const scores = new NumberListKeyspace<string>(cluster, {
+ *   keyPattern: "scores/:gameId",
+ * });
+ *
+ * await scores.pushRight("game1", 100, 200, 300);
+ * const allScores = await scores.items("game1");
+ * ```
+ */
+export declare class NumberListKeyspace<K> extends ListKeyspace<K, number> {
+    constructor(cluster: CacheCluster, config: KeyspaceConfig<K>);
+    protected serializeItem(value: number): Buffer;
+    protected deserializeItem(data: Buffer): number;
+}
+export {};